Hetzner Cloud Python
====================
.. image:: https://github.com/hetznercloud/hcloud-python/workflows/Unit%20Tests/badge.svg
:target: https://github.com/hetznercloud/hcloud-cloud-controller-manager/actions
.. image:: https://github.com/hetznercloud/hcloud-python/workflows/Code%20Style/badge.svg
:target: https://github.com/hetznercloud/hcloud-cloud-controller-manager/actions
.. image:: https://readthedocs.org/projects/hcloud-python/badge/?version=latest
:target: https://hcloud-python.readthedocs.io
.. image:: https://img.shields.io/pypi/pyversions/hcloud.svg
:target: https://pypi.org/project/hcloud/
Official Hetzner Cloud python library
The library's documentation is available at `ReadTheDocs`_, the public API documentation is available at https://docs.hetzner.cloud.
.. _ReadTheDocs: https://hcloud-python.readthedocs.io
Usage example
-------------
After the documentation has been created, click on `Usage` section
Or open `docs/usage.rst`
You can find some more examples under `examples/`.
Supported Python versions
-------------------------
We support python versions until `end-of-life`_.
.. _end-of-life: https://devguide.python.org/#status-of-python-branches
Development
-----------
Setup Dev Environment
---------------------
1) `mkvirtualenv hcloud-python`
2) `pip install -e .` or `pip install -e .[docs]` to be able to build docs
Run tests
---------
* `tox .`
* You can specify environment e.g `tox -e py36`
* You can test the code style with `tox -e flake8`
Create Documentation
--------------------
Run `make docs`. This will also open a documentation in a tab in your default browser.
Style Guide
-------------
* **Type Hints**: If the type hint line is too long use inline hinting. Maximum inline type hint line should be 150 chars.
License
-------------
The MIT License (MIT). Please see `License File`_ for more information.
.. _License File: https://github.com/hetznercloud/hcloud-python/blob/master/LICENSE