npm install pip-requirements-js

A robust parser for requirements.txt files

More from Twixes

Twixes npm packages

Find the best node modules for your project.

Search npm

pip-requirements-js

A robust parser for requirements...

Read more

Dependencies

Core dependencies of this npm package and its dev dependencies.

ohm-js, @ohm-js/cli, @types/jest, @typescript-eslint/eslint-plugin, @typescript-eslint/parser, eslint, eslint-config-standard-with-typescript, eslint-plugin-import, eslint-plugin-n, eslint-plugin-promise, husky, jest, lint-staged, prettier, rimraf, ts-jest, typescript

Documentation

A README file for the pip-requirements-js code repository. View Code

pip-requirements-js

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).

API

Full extraction

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.

Loose extraction

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.

Internals

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.