Metadata-Version: 2.1
Name: doctl
Version: 0.2.2
Summary: A Python wrapper for the Digital Ocean CLI utility — doctl.
Home-page: https://github.com/do-community/doctl
Author: Kenneth Reitz
Author-email: me@kennethreitz.org
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: maya
Requires-Dist: delegator.py


python-doctl
============

A Python wrapper for the excellent [doctl](https://github.com/slantview/doctl) command-line utility, from [Digital Ocean](https://digitalocean.com).

Usage
-----

    >>> import doctl

    >>> for droplet in doctl.compute.droplet.list():
    ...     print(droplet['name'])
    pypi.kennethreitz.org
    code.kennethreitz.org
    build.kennethreitz.org
    …

    >>> for key in doctl.compute.ssh_key.list():
    ...     print(key['name'])
    Blink (iPad)
    thoth
    macbook

Features
--------

- Automatically downloads `doctl`, if unavailable for your system (at runtime).
- All methods return Python data structures, includinging timezone–aware Datetime objects.

Notes
-----

Use of the `DIGITALOCEAN_ACCESS_TOKEN` environment variable is recommended.


Available Namespaces
--------------------

The entire API surface of **doctl** is covered by this library, so the following
namespaces are available for your use and enjoyment:

- `compute.account`
- `compute.action`
- `compute.certificate`
- `compute.domain`
- `compute.domain_records`
- `compute.droplet`
- `compute.firewall`
- `compute.floating_ip`
- `compute.image`
- `compute.image_action`
- `compute.load_balancer`
- `compute.plugin`
- `compute.region_list`
- `compute.size_list`
- `compute.snapshot`
- `compute.ssh_key`
- `compute.tag`
- `compute.volume`
- `compute.volume_action`


Installation
------------

    $ pipenv install doctl

✨🍰✨

