https://github.com/tsaarni/python-certy

Python package for generating certificates for unit and integration tests.
https://github.com/tsaarni/python-certy

certificates crl pki python testing x509

Last synced: over 1 year ago
JSON representation

Python package for generating certificates for unit and integration tests.

• Host: GitHub
• URL: https://github.com/tsaarni/python-certy
• Owner: tsaarni
• License: apache-2.0
• Created: 2023-05-28T19:59:00.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-10-31T06:05:09.000Z (over 2 years ago)
• Last Synced: 2024-10-14T16:09:53.518Z (over 1 year ago)
• Topics: certificates, crl, pki, python, testing, x509
• Language: Python
• Homepage:
• Size: 2.67 MB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# python-certy

![](https://github.com/tsaarni/python-certy/workflows/unit-tests/badge.svg)

## Description

Certy provides a simple API for creating X509 certificates and certificate revocation lists on demand when running unit tests.

No more storing test certificates and private keys in the repository!

Python-certy is a version of similar tool for command line and Golang called [certyaml](https://github.com/tsaarni/certyaml) and [java-certy](https://github.com/tsaarni/java-certy/) for Java.

## Example

```python

from certy import Credential

ca = Credential().subject("CN=ca")

ca.write_certificates_as_pem("ca.pem")

cred = Credential().subject("CN=server").issuer(ca)

cred.write_certificates_as_pem("cert.pem")

cred.write_private_key_as_pem("key.pem")

```

## Documentation

The latest documentation is available [here](https://tsaarni.github.io/python-certy/).

See also [tests](tests) for more examples.

## Installation

Install certy from [PyPI](https://pypi.org/project/certy/):

```bash

pip install certy

```

## Development

Create virtual environment by running `python3 -m venv .venv`, then activate it `source .venv/bin/activate`.

Install dependencies by running `pip install -r dev-requirements.txt`.

Run tests with `pytest`.

To build wheel, run `flit build` and check the generated wheel in `dist` directory.

To find out coverage of tests, execute `coverage run -m pytest` and then `coverage html`.

The coverage report is generated to `htmlcov/index.html`.

Run `make html` on `docs` directory to generate documentation.

Open `docs/_build/html/index.html` to view the generated documentation.