This is a small Python module for parsing Pip requirement files.

The goal is to parse everything in the Pip requirement file format spec.

pip install requirements-parser

or

poetry add requirements-parser

requirements-parser can parse a file-like object or a text string.

>>> import requirements
>>> with open('requirements.txt', 'r') as fd:
...     for req in requirements.parse(fd):
...         print(req.name, req.specs)
Django [('>=', '1.11'), ('<', '1.12')]
six [('==', '1.10.0')]

It can handle most (if not all) of the options in requirement files that do not involve traversing the local filesystem. These include:

• editables (-e git+https://github.com/toastdriven/pyelasticsearch.git]{.title-ref})
• version control URIs
• egg hashes and subdirectories ([\#egg=django-haystack&subdirectory=setup]{.title-ref})
• extras ([DocParser[PDF]]{.title-ref})
• URLs

View the documentation here.

We endeavour to support all functionality for all current actively supported Python versions. However, some features may not be possible/present in older Python versions due to their lack of support.

See our CHANGELOG.

Feel free to open issues, bugreports or pull requests.
See the CONTRIBUTING file for details.

requirements-parser was originally written by @davidfischer and is now maintained by @madpah. See Authors for full details.

Permission to modify and redistribute is granted under the terms of the Apache 2.0 license.

See the LICENSE file for the full license.