Skip to content
This repository has been archived by the owner on May 14, 2024. It is now read-only.

Heroku buildpack that makes it possible to use Poetry with the official Python buildpack

License

Notifications You must be signed in to change notification settings

Cambly/python-poetry-buildpack

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Poetry Buildpack

A Heroku Buildpack for Poetry users.

How to use

The Python Poetry Buildpack prepares the build to be processed by a Python buildpack such as heroku/python by generating requirements.txt and runtime.txt from poetry.lock. With that said, your repo cannot have a requirements.txt, it will be exported from Poetry (for runtime.txt see below).

To set up the use of several buildpacks from the Heroku CLI use buildpacks:add:

heroku buildpacks:clear
heroku buildpacks:add https://github.com/moneymeets/python-poetry-buildpack.git
heroku buildpacks:add heroku/python

Configuration

Python

Python version can be forced by setting the PYTHON_RUNTIME_VERSION variable. Otherwise, it will be read from poetry.lock; for using Heroku default see below.

heroku config:set PYTHON_RUNTIME_VERSION=3.9.1

Poetry

Poetry version can be specified by setting POETRY_VERSION in Heroku config vars. Otherwise, it will default to a hardcoded version.

heroku config:set POETRY_VERSION=1.1.13

Generally all variables starting with POETRY_ are passed on to Poetry by this buildpack; see the corresponding Poetry documentation section for possible uses.

Exporting of development dependencies (e.g. to run tests in CI pipelines) can be optionally enabled by setting POETRY_EXPORT_DEV_REQUIREMENTS to 1:

heroku config:set POETRY_EXPORT_DEV_REQUIREMENTS=1

runtime.txt

Generation of the runtime.txt can be skipped by setting DISABLE_POETRY_CREATE_RUNTIME_FILE to 1:

heroku config:set DISABLE_POETRY_CREATE_RUNTIME_FILE=1

If DISABLE_POETRY_CREATE_RUNTIME_FILE is set, the required Python version can be specified in runtime.txt. Otherwise, if runtime.txt is present in the repository, the buildpack will prevent the app from being deployed in order to avoid possible ambiguities.

Contributing

To test your changes locally run the (TAP-compatible) test suite:

bash run_tests.sh

About

Heroku buildpack that makes it possible to use Poetry with the official Python buildpack

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%