pip-split-requirements

Split a pip requirement files according to regular expression patterns rules.

Table of Contents

• pip-split-requirements
  • Installation
  • Quick start
  • CLI Usage
  • Usage as a pre-commit hook
  • License

Installation

pipx install pip-split-requirements

Quick start

Assume the following requirements.txt:

--find-links wheelhouse
pkga
git+https://github.com/some/project
pkgb

Running

pip-split-requirements -g slow:git requirements.txt

Will create requirementsgroup-slow.txt:

--find-links wheelhouse
git+https://github.com/some/project

and requirementsgroup-other.txt:

--find-links wheelhouse
pkga
pkgb

CLI Usage

Usage: pip-split-requirements [OPTIONS] REQUIREMENTS_FILE...

  Split a pip requirements file into multiple files according to patterns.

  Patterns are regular expressions against which requirement lines are
  searched to determine if they belong to a group. Group specs are evaluated
  in order, and the first match determines in which group the line goes.

  Comment lines are ignored.

  Option lines are emitted in all groups.

Arguments:
  REQUIREMENTS_FILE...  [required]

Options:
  -g, --group-spec TEXT           Group specifications in form name:pattern.
  -p, --prefix TEXT               Each requirements group file will be named
                                  {prefix}-{group_name}.txt. The prefix can
                                  contain path separators, to generate files
                                  into a chosen directory.  [default:
                                  requirementsgroup]
  --default-group / --no-default-group
                                  Automatically append a group named 'other',
                                  matching all lines not matched by other
                                  groups.  [default: default-group]
  --remove-empty / --no-remove-empty
                                  Remove empty requirements group files.
                                  [default: no-remove-empty]
  --help                          Show this message and exit.

Usage as a pre-commit hook

The following section of .pre-commit-config.yaml will split requirements.txt and requirements-test.txt into a group named vcs with requirements containing the word git+https or git+ssh and another group with everything else, as build/reqgroup-*.txt.

  - repo: https://github.com/sbidoul/pip-split-requirements
    rev: v0.1.0
    hooks:
      - id: pip-split-requirements
        files: ^requirements.*.txt$
        args:
          - --prefix=build/reqgroup
          - --group-spec=vcs:git.(https|ssh)
          - requirements.txt
          - requirements-test.txt

License

pip-split-requirements is distributed under the terms of the MIT license.