Sewer
Sewer is a Let's Encrypt(ACME) client.
It's name is derived from Kenyan hip hop artiste, Kitu Sewer.
PYTHON compatibility: 3.5 is nominally still supported, and with assistance from Github's multi-version Python linting I've repaired some issues. Even with the GH multi-version testing, there are parts of the drivers, especially, which I simply can't test (with 3.5) because the actual service provider interaction has to be mocked. Such issues will be fixed on a best-effort basis when reported for the life of 0.8.
I (maintainer @mmaney) loiter in channel ##sewer (on irc.freenode.net) for those who remember IRC. Don't ask to ask, but waiting is.
Features
- Obtain or renew SSL/TLS certificates from Let's Encrypt
- Supports acme version 2 (current RFC including post-as-get).
- Support for SAN certificates.
- Supports wildcard certificates.
- Bundling certificates.
- Support for both RSA and ECDSA for account and certificate keys.
- Supports DNS and HTTP challenges
- List of currently supported DNS services and BYO-service notes
- HTTP challenges are a new feature, no operational drivers in the tree yet. See usage and BYO-service notes
- sewer is both a command-line program and a Python library for custom use
- Well written(if I have to say so myself):
- Good test coverage
- Passing continuous integration
- High grade statically analyzed code
- type hinting to support mypy verification is a recently begun WIP
Installation
pip3 install sewer
# with All DNS Provider support, include aliyun, Hurricane Electric, Aurora, ACME ...
# pip3 install sewer[alldns]
# with Cloudflare support
# pip3 install sewer[cloudflare]
# with Aliyun support
# pip3 install sewer[aliyun]
# with HE DNS(Hurricane Electric DNS) support
# pip3 install sewer[hurricane]
# with Aurora DNS Support
# pip3 install sewer[aurora]
# with ACME DNS Support
# pip3 install sewer[acmedns]
# with Rackspace DNS Support
# pip3 install sewer[rackspace]
# with DNSPod DNS Support
# pip3 install sewer[dnspod]
# with DuckDNS DNS Support
# pip3 install sewer[duckdns]
# with ClouDNS DNS Support
# pip3 install sewer[cloudns]
# with AWS Route 53 DNS Support
# pip3 install sewer[route53]
# with PowerDNS DNS Support
# pip3 install sewer[powerdns]
sewer(since version 0.5.0) is now python3 only. To install the (now unsupported) python2 version:
pip install sewer==0.3.0
Sewer is in active development and it's API will change in backward incompatible ways. https://pypi.python.org/pypi/sewer
Development setup
See the how to contribute documentation
FAQ
- Why another ACME client?
I wanted an ACME client that I could use to programmatically(as a library) acquire/get certificates. However I could not find anything satisfactory for use in Python code. - Why is it called Sewer? I really like the Kenyan hip hop artiste going by the name of Kitu Sewer.
Release files for sewer 0.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sewer-0.8.4.tar.gz | 40.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sewer-0.8.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 89.8 kB
Release files / sewer-0.8.4.tar.gz
| Download URL | sewer-0.8.4.tar.gz |
|---|---|
| Size | 40.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b855d6d963ca58c6b5c86941c9a672ee4c1f76f2d267e1409d9edfa6f1406e8
|
|
BLAKE2b-256 checksum How to use checksums |
35691993952131260af82d2cfc62f14c824838840e68f1b1aee29dba4d8bfec5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.3
|
Release files / sewer-0.8.4-py3-none-any.whl
| Download URL | sewer-0.8.4-py3-none-any.whl |
|---|---|
| Size | 49.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d2f2741c146e13f3250affb77bb73b131f3372eb738626c1027386b5af3fab8
|
|
BLAKE2b-256 checksum How to use checksums |
bc8f5b87f56089f0e47796debf161408223b4f8d1c1a01abd84ad689bd2dcbd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.3
|