Metadata-Version: 1.1
Name: simp-le-client
Version: 0.6.1
Summary: Simple Let's Encrypt Client
Home-page: https://github.com/zenhack/simp_le
Author: Ian Denhardt
Author-email: ian@zenhack.net
License: GPLv3
Description-Content-Type: UNKNOWN
Description: simp\_le
        ========
        
        |Build Status|
        
        Simple `Let’s Encrypt`_ client.
        
        .. code:: shell
        
            simp_le --email you@example.com -f account_key.json \
              -f fullchain.pem -f key.pem \
              -d example.com -d www.example.com --default_root /var/www/html \
              -d example.net:/var/www/other_html
        
        For more info see ``simp_le --help``.
        
        N.B. this was originally a fork of https://github.com/kuba/simp\_le,
        which is unmaintained and has some breakage due to bitrot. Thanks to
        @kuba for the original implementation.
        
        Manifesto
        ---------
        
        1.  `UNIX philosophy`_: Do one thing and do it well!
        
        2.  ``simp_le --valid_min ${seconds?} -f cert.pem`` implies that
            ``cert.pem`` is valid for at at least ``valid_min`` (defaults to 2592000
            seconds / 30 days). Register new ACME CA account if necessary. Issue
            new certificate if no previous key/certificate/chain found. Renew only
            if necessary.
        
        3.  (Sophisticated) “manager” for
            ``${webroot?}/.well-known/acme-challenge`` only. No challenges other
            than ``http-01``. Existing web-server must be running already.
        
        4.  No magical webserver auto-configuration.
        
        5.  Owner of ``${webroot?}/.well-known/acme-challenge`` must be able to
            run the script, without privilege escalation (``sudo``, ``root``,
            etc.).
        
        6.  ``crontab`` friendly: fully automatable - no prompts, etc.
        
        7.  No configuration files. CLI flags as the sole interface! Users
            should write their own wrapper scripts or use shell aliases if
            necessary.
        
        8.  Support multiple domains with multiple roots. Always create single
            SAN certificate per ``simp_le`` run.
        
        9.  Flexible storage capabilities. Built-in
            ``simp_le -f fullchain.pem    -f key.pem``,
            ``simp_le -f chain.pem -f cert.pem -f key.pem``, etc. Extensions
            through ``simp_le -f external.sh``.
        
        10. Do not allow specifying output file paths. Users should symlink if
            necessary!
        
        11. No need to allow specifying an arbitrary command when renewal has
            happened, just check the exit code:
        
            -  ``0`` if certificate data was created or updated;
            -  ``1`` if renewal not necessary;
            -  ``2`` in case of errors.
        
        12. ``--server`` (support multiple CAs).
        
        13. Support for revocation.
        
        Installation
        ------------
        
        .. code:: shell
        
            sudo ./bootstrap.sh
            ./venv.sh
            export PATH=$PWD/venv/bin:$PATH
        
        Usage with Docker
        -----------------
        
        If you want to use simp_le with Docker, have a look at `simp\_le for Docker`_.
        
        Help
        ----
        
        Have a look into ``./examples/`` and
        https://github.com/zenhack/simp\_le/wiki/Examples.
        
        If you’re having problems you can chat with us on `IRC (#simp\_le at
        Freenode)`_
        
        .. _Let’s Encrypt: https://letsencrypt.org
        .. _UNIX philosophy: https://en.wikipedia.org/wiki/Unix_philosophy
        .. _IRC (#simp\_le at Freenode): http://webchat.freenode.net?randomnick=1&channels=%23simp_le&prompt=1
        .. _simp\_le for Docker: docker
        
        .. |Build Status| image:: https://travis-ci.org/zenhack/simp_le.svg?branch=master
           :target: https://travis-ci.org/zenhack/simp_le
        
        
        Change Log
        ----------
        
        Below is a summary of changes introduced in each release. Any user-visible
        changes *must* be recorded here. Note that the topmost entry sometimes
        represents the *next* (i.e. not yet released) version.
        
        0.6.1
        +++++
        
        * Update the hash for the letsencrypt TOS. The TOS changed on November 15th,
          which broke previous releases. Future releases will not hard-code the hash,
          which should avoid this sort of problem in the future.
        
        0.6.0
        +++++
        
        * Drop official support for Python 3.3.
        * Disable self-verification; this was highly unreliable and resulted in
          spurrious warnings.
        * Improve argument sanity-checks and error messages.
        * Save account_key.json, even on failures
        * Clean temporary challenge files.
        * Upgrade acme to 0.19.x
        
        0.5.1
        +++++
        
        * Add a workaround for some installation problems caused by a bug in pip
        
        0.5.0
        +++++
        
        * Upgrade acme to 0.17.x
        
        0.4.0
        +++++
        
        * Upgrade acme to 0.16.x
        
        0.3.0
        +++++
        
        * Fix a bug where the version number was incorrectly reported
        * Upgrade acme to 0.15.x
        
        0.2.0
        +++++
        
        * Upgrade to acme 0.11.x
        
        0.1.1
        +++++
        
        * Change the package name; the original maintainer owns the simp_le PyPI
          package, and hasn't responded to requests to transfer it, so the package name
          is now 'simp_le-client'.
        
        0.1.0
        +++++
        
        * First release
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
