Metadata-Version: 2.4
Name: certscout
Version: 0.1.0
Summary: Corporate certificate acquisition and lifecycle management
License-Expression: MPL-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-cov>=7.0; extra == "test"
Requires-Dist: jsonschema>=4.20; extra == "test"
Requires-Dist: setuptools>=77; extra == "test"
Provides-Extra: validate
Requires-Dist: jsonschema>=4.20; extra == "validate"
Provides-Extra: color
Requires-Dist: colorlog>=6.8; extra == "color"
Provides-Extra: dev
Requires-Dist: black>=24.0; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: check-jsonschema>=0.31; extra == "dev"
Requires-Dist: jsonschema>=4.20; extra == "dev"
Requires-Dist: types-jsonschema>=4.20; extra == "dev"
Requires-Dist: mypy>=1.8; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=7.0; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: setuptools>=77; extra == "dev"
Requires-Dist: setuptools-scm>=10.3; extra == "dev"
Requires-Dist: types-setuptools>=77; extra == "dev"
Requires-Dist: yamllint>=1.35; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=7.2; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=2.0; extra == "docs"
Dynamic: license-file

# Cert Scout

Cert Scout retrieves, validates, deduplicates, and selects CA certificates and
CRLs from file, directory, Git, and TLS sources. It writes trust material for
downstream consumers; consumers handle installation into system trust stores.

## Install

Use Python 3.11 or newer with OpenSSL installed. Git is required for Git sources.
PyPI hosts the authoritative releases:

```sh
python3 -m pip install certscout
```

Optional extras: `certscout[color]` for colored logs and `certscout[validate]`
for offline configuration validation. Options can be combined in a comma
separated list (e.g., `certscout[color,validate]`).

## Retrieve certificates

Copy [the example configuration](examples/certscout.toml), replace its placeholder
locations, and remove sources you do not need. The [example guide](examples/README.md)
explains all four source types.

```sh
cp examples/certscout.toml certscout.toml
certscout --config certscout.toml
```

Output defaults to `certs/` and `crls/` relative to the configuration file.
Retrieval fails if no CA certificates pass selection.

- [Usage, builds, and air-gapped deployment](USING.md)
- [Configuration reference](docs/configuration.rst)
- [Contributing](CONTRIBUTING.md)
- [CI and releases](CI.md)

## License

[Mozilla Public License 2.0](LICENSE).
