Metadata-Version: 2.0
Name: doapi
Version: 0.1.1
Summary: DigitalOcean API library & CLI
Home-page: https://github.com/jwodder/doapi
Author: John Thorvald Wodder II
Author-email: doapi@varonathe.org
License: MIT
Keywords: DigitalOcean
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: System :: Systems Administration
Requires-Dist: pyRFC3339 (>=1.0,<2)
Requires-Dist: requests (>=2.2.0,<3)
Requires-Dist: six (>=1.5.0,<2)

doapi — DigitalOcean API Python library & CLI
=============================================

.. |pypi| image:: https://img.shields.io/pypi/v/doapi.svg
    :target: https://pypi.python.org/pypi/doapi

.. |repostatus| image:: http://www.repostatus.org/badges/latest/wip.svg
    :target: http://www.repostatus.org/#wip
    :alt: Project Status: WIP - Initial development is in progress, but there
          has not yet been a stable, usable release suitable for the public.

.. |RTD| image:: https://readthedocs.org/projects/doapi/badge/?version=latest
    :target: http://doapi.readthedocs.org/en/latest/?badge=latest
    :alt: Documentation Status

.. |license| image:: https://img.shields.io/github/license/jwodder/doapi.svg
    :alt: MIT License

|pypi| |repostatus| |RTD| |license|

*(Until v1.0 is released, backwards compatibility will be broken at will.)*

As yet another Python wrapper library for version 2 of the `DigitalOcean
<https://www.digitalocean.com>`_ `API
<https://developers.digitalocean.com/documentation/v2/>`_, ``doapi`` offers:

- Individual methods for every operation listed in the API docs plus methods
  for making arbitrary "freeform" requests or actions
- Methods for waiting for multiple droplets to come up or multiple actions to
  complete in parallel (and if you get tired of waiting, you can hit Cntrl-C to
  make the methods return immediately)
- Connection pooling via `requests' <http://www.python-requests.org>`_ `Session
  objects
  <http://www.python-requests.org/en/master/user/advanced/#session-objects>`_
- Paginated results are returned as generators that make requests when
  necessary, so your account's entire action history isn't fetched all at once
- A command-line interface to all of the above that outputs JSON objects in the
  same format as used by the API (perfect for massaging with `jq
  <https://stedolan.github.io/jq/>`_!)
- When creating droplets from the command line, new SSH public keys can be
  specified without having to register them explicitly beforehand.


