csrbuilder

A Python library for creating and signing X.509 certificate signing requests (CSRs).

• Related Crypto Libraries
• Current Release
• Dependencies
• Installation
• License
• Documentation
• Continuous Integration
• Testing
• Development
• CI Tasks

Related Crypto Libraries

csrbuilder is part of the modularcrypto family of Python packages:

• asn1crypto
• oscrypto
• csrbuilder
• certbuilder
• crlbuilder
• ocspbuilder
• certvalidator

Current Release

0.10.1 - changelog

Dependencies

• asn1crypto
• oscrypto
• Python 2.6, 2.7, 3.2, 3.3, 3.4, 3.5, 3.6 or pypy

Installation

pip install csrbuilder

License

csrbuilder is licensed under the terms of the MIT license. See the LICENSE file for the exact license text.

Documentation

csrbuilder documentation

Continuous Integration

• Windows via AppVeyor
• OS X via CircleCI
• Linux via Travis CI
• Test Coverage via Codecov

Testing

Tests are written using unittest and require no third-party packages:

python run.py tests

To run only some tests, pass a regular expression as a parameter to tests.

python run.py tests build

Development

To install the package used for linting, execute:

pip install --user -r requires/lint

The following command will run the linter:

python run.py lint

Support for code coverage can be installed via:

pip install --user -r requires/coverage

Coverage is measured by running:

python run.py coverage

To install the packages requires to generate the API documentation, run:

pip install --user -r requires/api_docs

The documentation can then be generated by running:

python run.py api_docs

To install the necessary packages for releasing a new version on PyPI, run:

pip install --user -r requires/release

Releases are created by:

• Making a git tag in semver format

• Running the command:

  python run.py release

Existing releases can be found at https://pypi.python.org/pypi/csrbuilder.

CI Tasks

A task named deps exists to ensure a modern version of pip is installed, along with all necessary testing dependencies.

The ci task runs lint (if flake8 is avaiable for the version of Python) and coverage (or tests if coverage is not available for the version of Python). If the current directory is a clean git working copy, the coverage data is submitted to codecov.io.

python run.py deps
python run.py ci