1  =======
 2  Plugins
 3  =======
 4  
 5  Let's Encrypt client supports dynamic discovery of plugins through the
 6  `setuptools entry points`_. This way you can, for example, create a
 7  custom implementation of `~letsencrypt.interfaces.IAuthenticator` or
 8  the `~letsencrypt.interfaces.IInstaller` without having to merge it
 9  with the core upstream source code. An example is provided in
10  ``examples/plugins/`` directory.
11  
12  .. warning:: Please be aware though that as this client is still in a
13     developer-preview stage, the API may undergo a few changes. If you
14     believe the plugin will be beneficial to the community, please
15     consider submitting a pull request to the repo and we will update
16     it with any necessary API changes.
17  
18  .. _`setuptools entry points`:
19    https://pythonhosted.org/setuptools/setuptools.html#dynamic-discovery-of-services-and-plugins