Metadata-Version: 2.0
Name: python-hologram-api
Version: 0.1.2
Summary: Python client for https://dashboard.hologram.io/api.
Home-page: https://github.com/vicyap/python-hologram-api
Author: Victor Yap
Author-email: victor@vicyap.com
License: MIT license
Description-Content-Type: UNKNOWN
Keywords: python_hologram_api
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
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
Requires-Dist: requests

===================
python-hologram-api
===================

Python client for https://dashboard.hologram.io/api.

.. image:: https://img.shields.io/pypi/v/python-hologram-api.svg
        :target: https://pypi.python.org/pypi/python-hologram-api

.. image:: https://img.shields.io/travis/vicyap/python-hologram-api.svg
        :target: https://travis-ci.org/vicyap/python-hologram-api

.. image:: https://readthedocs.org/projects/python-hologram-api/badge/?version=latest
        :target: https://python-hologram-api.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

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

``pip install python_hologram_api``

Documentation
-------------

* Documentation: https://python-hologram-api.readthedocs.io.

Usage
-----

``HologramClient`` is the main class you should use. Most of its methods are
sub-categorized based on the endpoint that the method interfaces with. For
example, user account management is under `client.user`.

To use python-hologram-api in a project::

    import os
    from python_hologram_api.client import HologramClient

    HOLOGRAM_API_KEY = os.environ.get('HOLOGRAM_API_KEY')
    client = HologramClient(HOLOGRAM_API_KEY)

Example Usages::

    # List Devices
    resp = client.devices.list()
    if resp.get('success'):
        devices = resp.get('data')

    # Get a Device
    device_id = 1234
    resp = client.devices.get(device_id)
    if resp.get('success'):
        device = resp.get('data')

    # Activate SIMs
    sims = ['99990000000012345678']
    plan = 73
    tier = 1
    resp = self.client.cell.activate_sims(sims, plan, tier)
    assert resp.get('success') is not None

The following submodules are available:

* Device Management

  * ``client.devices``
  * ``client.cell``
  * ``client.tags``
  * ``client.data_plans``

* Hologram Cloud

  * ``client.csr``
  * ``client.sms``
  * ``client.cloud``
  * ``client.spacebridge``

* Account Management

  * ``client.user``
  * ``client.org``

License
-------

* Free software: MIT license



=======
History
=======


0.1.2 (2017-10-23)
------------------

* First release on PyPI.
* Implemented a Python wrapper for https://hologram.io/docs/reference/cloud/http/

0.1.1 (2017-10-23)
------------------

* Travis Errors

0.1.0 (2017-10-20)
------------------

* Mistakes were made.


