Skip to content

komuw/sewer

Repository files navigation

Sewer

Codacy Badge CircleCI codecov Code style: black

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.

Features

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.