jorgenevens / sewer Goto Github PK

Sewer is a Let's Encrypt(ACME) client.
It's name is derived from Kenyan hip hop artiste, Kitu Sewer.

• The stable release is 0.8.4.
• More history (including notes on 0.8.5-to-be) in the CHANGELOG.

PYTHON compatibility: 3.5 is still supported, though I believe at least one driver contains incompatible code (I have no way to actually test it, and sometimes these new features have been backported in 3.x.later). As of 0.8.5 I'm still trying not to break 3.5, but that oldest officially supported version is probably going to take a bump. You already cannot run all the dev tests under 3.5 (black is one obvious one)...

I (maintainer @mmaney) loiter in channel ##sewer (on irc.freenode.net) for those who remember IRC. Don't ask to ask, but waiting is.

• 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

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

See the how to contribute documentation

• 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.