|
|
|
@ -4,14 +4,44 @@
|
|
|
|
|
This software is released under the MIT License.
|
|
|
|
|
https://opensource.org/licenses/MIT
|
|
|
|
|
-->
|
|
|
|
|
# [Python Poetry](https://github.com/python-poetry/poetry) in Docker
|
|
|
|
|
Robust, lightweight, configurable `python-poetry` Docker images for any use
|
|
|
|
|
case.
|
|
|
|
|
|
|
|
|
|
A robust, configurable `python-poetry` Docker image.
|
|
|
|
|
*NOTE: This repository is **not** an official project from the creators of
|
|
|
|
|
Python Poetry. Hopefully you find it useful anyway!*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Build
|
|
|
|
|
You can build this `python-poetry` image yourself using any version of Poetry
|
|
|
|
|
and Python.
|
|
|
|
|
## Quickstart
|
|
|
|
|
Most of the time, you will be using these images as a base image for your own
|
|
|
|
|
Dockerfiles (e.g. devcontainers, building Python applications, etc.)
|
|
|
|
|
```Dockerfile
|
|
|
|
|
FROM jhale1805/python-poetry
|
|
|
|
|
# Your build steps here.
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
However, you can also download and run the latest `python-poetry` Docker image
|
|
|
|
|
by pulling it from DockerHub.
|
|
|
|
|
```
|
|
|
|
|
docker pull jhale1805/python-poetry
|
|
|
|
|
docker run --rm jhale1805/python-poetry poetry --version
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
There are tagged images for all the latest stable versions of `python-poetry`
|
|
|
|
|
for all versions of Python that Poetry supports (>3.7). You can see the [full
|
|
|
|
|
tag list on DockerHub](https://hub.docker.com/r/jhale1805/python-poetry/tags).
|
|
|
|
|
|
|
|
|
|
## Build Your Own Image
|
|
|
|
|
This repo automatically builds images for the latest stable versions of
|
|
|
|
|
`python-poetry` for all supported versions of Python (>3.7).
|
|
|
|
|
- You can see the full build matrix in
|
|
|
|
|
[.github/workflows/docker-image.yml](.github/workflows/docker-image.yml)
|
|
|
|
|
|
|
|
|
|
However, if you need a combination that isn't automatically built, you can
|
|
|
|
|
easily create your own by modifying the command below to contain your preferred
|
|
|
|
|
values for `POETRY_VERSION` and `PYTHON_IMAGE_TAG`:
|
|
|
|
|
```bash
|
|
|
|
|
make build POETRY_VERSION="1.1.13" PYTHON_IMAGE_TAG="3.8.13-slim"
|
|
|
|
|
make build-version \
|
|
|
|
|
POETRY_VERSION="1.1.13" \
|
|
|
|
|
PYTHON_IMAGE_TAG="3.10-slim"
|
|
|
|
|
```
|
|
|
|
|