Skip to main content

Generate requirements[-dev].txt from Pipfile using pipenv

Project description

https://travis-ci.org/Stibbons/pipenv-to-requirements.svg?branch=master Pypi package MIT licensed

Generate requirements[-dev].txt from Pipfile (using pipenv).

Rational

Pipfile and its sibling Pipfile.lock are clearly superior tools defining clear dependencies or a package. Pipfile is to be maintained by the package’s developer while Pipfile.lock represent a clear image of what is currently installed on the current system, guarantying full reproductibility of the setup. See more information about Pipfile format here. Most of the time, Pipfile.lock should be ignored (ie, not tracked in your git) for packages published on Pypi.

pipenv is a great tool to maintain Pipfile, but developers might be stuck with backward compatibility issues for tools and services that still use requirements.txt and does not know how to handle Pipfile or Pipfile.lock yet.

For examples:

  • ReadTheDocs

  • Pyup

  • pip install (if you install a package with pip that does not have a requirements.txt, its dependencies won’t be installed, even if you use Pipfile)

Usage

Just before building source/binary/wheel package of your python module, only of the following commands:

  • To generate requirements files (ie, dependencies are described eventually by range):

    pipenv run pipenv_to_requirements
  • To generate frozen requirements (ie, all dependencies have their version frozen):

    pipenv run pipenv_to_requirements -f

It will generate requirements.txt and, if applicable, requirements-dev.txt, in the current directory.

ReadTheDocs

Simply commit these files in your tree so that readthedocs, and ensure they are synchronized each time you change your Pipfile. Do not forget to ask ReadTheDocs to use requirements-dev.txt when building the documentation.

Contributing

Create your development environment with

$ make dev

Execute unit tests:

$ make test

Code formatter:

$ make style

Code Style Checks:

$ make check

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pipenv-to-requirements-0.2.3.tar.gz (15.3 kB view details)

Uploaded Source

Built Distribution

pipenv_to_requirements-0.2.3-py2.py3-none-any.whl (10.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pipenv-to-requirements-0.2.3.tar.gz.

File metadata

File hashes

Hashes for pipenv-to-requirements-0.2.3.tar.gz
Algorithm Hash digest
SHA256 30a4911356cd65dfc8ab0344e21f25e425581316c108a00497f6297b4e392dcf
MD5 173553c2e5de3d90405f898d74bfba13
BLAKE2b-256 1e1db746a882f20a70c5e2f2895d141dec142a917b08e6831d81226bcd8a4260

See more details on using hashes here.

File details

Details for the file pipenv_to_requirements-0.2.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pipenv_to_requirements-0.2.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 96124776bb96da02901c92c68eadb36c05edb11df88d672bd5d8fd5fce748792
MD5 0917a8d4b4dbbb74bc1510ecfa5b37f2
BLAKE2b-256 150417d77042471fff0a1057d13ca01443b76cdd9449a67dcf04044068f57254

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page