A pure JavaScript/TypeScript parser for pip requirements files. Process requirements.txt, constraints.txt, or pip-tools' requirements.in – all without ever leaving JavaScript.
pip-requirements-js strictly adheres to pip's documentation of the requirements file format, along with PEP 508 – Dependency specification for Python Software Packages. You can sleep well knowing that no dependency will be misinterpreted (if that ever keeps you up at night).
Full extractions means complete requirement info, such as spec-conforming version constraints and complete validation of the environment marker tree.
To extract all the requirements from a given file, use
parsePipRequirementsFile(fileContent: string): Requirement[]To extract a requirement from a given line, use
parsePipRequirementsLine(lineContent: string): Requirement | null(null is returned for lines validly lacking a requirement, e.g. empty or comment-only)
In both cases a RequirementsSyntaxError will be thrown if the provided content contains invalid syntax.
To make use of the resulting data, look up what Requirement is made up of in types.ts.
There is also a loose mode, which is oriented for processing partially-written requirements. This is useful when handling live code editor input.
parsePipRequirementsFileLoosely and parsePipRequirementsLineLoosely work the same as their full versions, except they return LooseProjectNameRequirement in place of Requirement. This means that URL-based requirements are skipped, as are requirements/constraints files.
pip-requirements-js is built with the robust parser generator Ohm.js – the core of this library is the pep-508.ohm grammar, which is an Ohm port of PEP 508's complete dependency specification grammar (originally defined for Parsley), with some pip-specific additions (such as the -r extra-requirements.txt syntax). This ensures the greatest possible compatibility with what pip itself does.
This library was built as a backend for the PyPI Assistant VS Code extension.