Skip to main content

cli tool to verify and update requirements files

Project description

|Build Status| |Latest Version| |Python Support|

cireqs
======

Tool to expand and pin requirements files and verify that they are
complete.

install
-------

Install from pypi.

``pip install cireqs``

Cireqs needs a working install of docker locally.

usage
-----

Use cireqs to expand and pin down your dependencies.

You can then check in the resulting requirements file and stop worrying
about floating versions.

.. code:: bash

cireqs --dirpath /tmp expand_requirements input_requirements_filename output_requirements_filename

Use cireqs to verify that a requirements file is pinned down and
includes all requirements of requirements.

.. code:: bash

cireqs verify_requirements input_requirements

defaults
^^^^^^^^

Cireqs uses overridable defaults:

- **dirpath:** set to current working directory (``PWD``)
- **pythonversion:** set to ``3.5.2``
- **output\_requirements\_filename:** set to ``requirements.txt``
- **input\_requirements\_filename:** set to:
-

- ``requirements.txt`` in *verify\_requirements*

-

- ``requirements_to_expand.txt`` in *expand\_requirements*

continous integration
---------------------

Use it in your **CI** of choice!!!

**travis**

.. code:: yaml

services:
- docker

before_script:
- pip install cireqs

script:
- cireqs verify_requirements

cli
---

Cireqs includes the ``cireqs`` command:

::

o8o
`"'
.ooooo. oooo oooo d8b .ooooo. .ooooo oo .oooo.o
d88' `"Y8 `888 `888""8P d88' `88b d88' `888 d88( "8
888 888 888 888ooo888 888 888 `"Y88b.
888 .o8 888 888 888 .o 888 888 o. )88b
`Y8bod8P' o888o d888b `Y8bod8P' `V8bod888 8""888P'
888.
8P' v0.0.3

Usage: cireqs [OPTIONS] COMMAND [ARGS]...

Options:
--pythonversion TEXT python version to use for calculating dependencies
--dirpath TEXT path to directory containing requirement files,
defaults to PWD
-v, --verbosity LVL Either CRITICAL, ERROR, WARNING, INFO or DEBUG
--help Show this message and exit.

Commands:
expand_requirements Expand given requirements file by extending...
verify_requirements verifying that given requirements file is not...

.. |Build Status| image:: https://travis-ci.org/trustpilot/python-cireqs.svg?branch=master
:target: https://travis-ci.org/trustpilot/python-cireqs
.. |Latest Version| image:: https://img.shields.io/pypi/v/cireqs.svg
:target: https://pypi.python.org/pypi/cireqs
.. |Python Support| image:: https://img.shields.io/pypi/pyversions/cireqs.svg
:target: https://pypi.python.org/pypi/cireqs


=======
History
=======

0.0.1 (2017-08-09)
------------------

* git init


0.0.2 (2017-08-09)
------------------

* missing manifest file

0.0.3 (2017-08-10)
------------------

* readme changes
* cli splash changes
* make cireqs functions pass python version to docker_execute
* pass timeout param from cli to cireqs

0.0.4 (2017-08-10)
------------------

* tox testing for py27, py33, py34, py35, py36
* more thorough diffing of requirements files
* more tests
* use prospector for linting

0.1.2 (2017-08-11)
------------------

* single source version in setup.py and cli

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

cireqs-0.1.2.tar.gz (6.3 kB view details)

Uploaded Source

File details

Details for the file cireqs-0.1.2.tar.gz.

File metadata

  • Download URL: cireqs-0.1.2.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cireqs-0.1.2.tar.gz
Algorithm Hash digest
SHA256 2c6a7a326b37bb3b3e68082c724a8cbe02e8ab012ddebc51d3441a84d6174f98
MD5 67531db7cb5d8e457c58531ef23c8a87
BLAKE2b-256 d1757601a3fdb157be48421d9f1a7d3da2d13a8a2bd0391ac7bbd9df4b7e430f

See more details on using hashes here.

Provenance

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