Metadata-Version: 1.1
Name: devicecloud
Version: 0.1.1
Summary: Python API to the Device Cloud by Etherios
Home-page: https://github.com/etherios/python-devicecloud
Author: Etherios, Inc.
Author-email: paul.osborne@etherios.com
License: UNKNOWN
Description: Python Device Cloud Library
        ===========================
        
        |Build Status| |Coverage Status| |Latest Version| |Supported Python
        versions| |License|
        
        Be sure to check out the `full
        documentation <http://etherios.github.io/python-devicecloud>`__. A
        `Changelog <https://github.com/etherios/python-devicecloud/blob/master/CHANGELOG.md>`__
        is also available.
        
        Overview
        --------
        
        Python-devicecloud is a library providing simple, intuitive access to
        the `Device Cloud by
        Etherios <http://www.etherios.com/products/devicecloud/>`__ for clients
        written in Python.
        
        The library wraps the Device Cloud REST API and hides the details of
        forming HTTP requests in order to gain access to device information,
        file data, streams, and other features of the device cloud. The API
        wrapped can be found
        `here <http://ftp1.digi.com/support/documentation/90002008_redirect.htm>`__.
        
        The primary target audience for this library is individuals interfacing
        with the device cloud from the server side or developers writing tools
        to aid device development. For efficient connectivity from devices, we
        suggest that you first look at using the `Device Cloud
        Connector <http://www.etherios.com/products/devicecloud/connector>`__.
        That being said, this library could also be used on devices if deemed
        suitable.
        
        Example
        -------
        
        The library provides access to a wide array of features, but here is a
        couple quick examples to give you a taste of what the API looks like.
        
        .. code:: python
        
            from devicecloud import DeviceCloud
        
            dc = DeviceCloud('user', 'pass')
        
            # show the MAC address of all devices that are currently connected
            #
            # This is done using the device cloud DeviceCore functionality
            print "== Connected Devices =="
            for device in dc.devicecore.list_devices():
                if device.is_connected():
                    print device.get_mac()
        
            # get the name and current value of all data streams having values
            # with a floating point type
            #
            # This is done using the device cloud stream functionality
            for stream in dc.streams.get_streams():
                if stream.get_data_type().lower() in ('float', 'double'):
                    print "%s -> %s" % (stream.get_stream_id(), stream.get_current_value())
        
        For more examples and detailed documentation, be sure to checkout out
        the `Full API
        Documentation <https://etherios.github.io/python-devicecloud>`__.
        
        Installation
        ------------
        
        This library can be installed using
        `pip <https://github.com/pypa/pip>`__. Python versions 2.7+ (including
        Python 3) are supported by the library.
        
        .. code:: sh
        
            pip install python-devicecloud
        
        Supported Features
        ------------------
        
        Eventually, it is hoped that there will be complete feature parity
        between the device cloud API and this library. For now, however, that is
        not the case. The current features are supported by the library:
        
        -  Getting basic device information via DeviceCore
        -  Listing devices associated with a device cloud account
        -  Interacting with Device Cloud Data Streams
        -  Create Streams
        -  Get Stream (by id)
        -  List all streams
        -  Get metadata for a stream
        -  Write a single datapoint to a stream
        -  Write many datapoints to a stream (homogeneous bulk write)
        -  Write many datapoints to multiple streams (heterogeneous bulk write)
        -  Read data points from a stream (includes control over order of
           returned data set as well as allowing for retrieving data roll-ups,
           etc.)
        -  Support for accessing Device Cloud FileData store
        -  Get filedata matching a provided condition (path, file extension,
           size, etc.)
        -  Write files to filedata store
        -  Recursively walk filedata directory tree from some root location
        -  Get full metadata and contents of files and directories.
        -  Low level support for performing basic SCI commands with limited
           parsing of results and support for only a subset of available
           services/commands.
        
        The following features are *not* supported at this time. Feedback on
        which features should be highest priority is always welcome.
        
        -  Alarms
        -  Monitors
        -  Scheduled Operations
        -  Creating a TCP or HTTP monitor
        -  Asynchronous SCI requests
        -  High level access to many SCI/RCI operations
        -  DeviceMetaData
        -  DeviceVendor
        -  FileDataHistory
        -  Group Operations (CRUD)
        -  NetworkInterface support
        -  XBee specific support (XBeeCore)
        -  Device Provisioning
        -  Smart Energy APIs
        -  SMS Support
        -  Satellite/Iridium Support
        -  SM/UDP Support
        -  Carrier Information Access
        
        Contributing
        ------------
        
        Contributions to the library are very welcome in whatever form can be
        provided. This could include issue reports, bug fixes, or features
        additions. For issue reports, please `create an issue against the Github
        project <https://github.com/Etherios/python-devicecloud/issues>`__.
        
        For code changes, feel free to fork the project on Github and submit a
        pull request with your changes. Additional instructions for developers
        contributing to the project can be found in the `Developer's
        Guide <https://github.com/Etherios/python-devicecloud/blob/master/HACKING.md>`__.
        
        License
        -------
        
        This software is open-source software.
        
        Copyright (c) 2014, Etherios, Inc. All rights reserved. Etherios, Inc.
        is a Division of Digi International.
        
        This Source Code Form is subject to the terms of the Mozilla Public
        License, v. 2.0. If a copy of the MPL was not distributed with this
        file, you can obtain one at http://mozilla.org/MPL/2.0/.
        
        Digi, Digi International, the Digi logo, the Digi website, Etherios, the
        Etherios logo, the Etherios website, Device Cloud by Etherios, and
        Etherios Cloud Connector are trademarks or registered trademarks of Digi
        International, Inc. in the United States and other countries worldwide.
        All other trademarks are the property of their respective owners.
        
        THE SOFTWARE AND RELATED TECHNICAL INFORMATION IS PROVIDED "AS IS"
        WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
        LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
        PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL DIGI OR ITS SUBSIDIARIES
        BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
        ACTION IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE AND TECHNICAL INFORMATION HEREIN, INCLUDING
        ALL SOURCE AND OBJECT CODES, IRRESPECTIVE OF HOW IT IS USED. YOU AGREE
        THAT YOU ARE NOT PROHIBITED FROM RECEIVING THIS SOFTWARE AND TECHNICAL
        INFORMATION UNDER UNITED STATES AND OTHER APPLICABLE COUNTRY EXPORT
        CONTROL LAWS AND REGULATIONS AND THAT YOU WILL COMPLY WITH ALL
        APPLICABLE UNITED STATES AND OTHER COUNTRY EXPORT LAWS AND REGULATIONS
        WITH REGARD TO USE AND EXPORT OR RE-EXPORT OF THE SOFTWARE AND TECHNICAL
        INFORMATION.
        
        .. |Build Status| image:: https://travis-ci.org/Etherios/python-devicecloud.svg?branch=master
           :target: https://travis-ci.org/Etherios/python-devicecloud
        .. |Coverage Status| image:: https://img.shields.io/coveralls/Etherios/python-devicecloud.svg
           :target: https://coveralls.io/r/Etherios/python-devicecloud
        .. |Latest Version| image:: https://pypip.in/version/devicecloud/badge.svg
           :target: https://pypi.python.org/pypi/devicecloud/
        .. |Supported Python versions| image:: https://pypip.in/py_versions/devicecloud/badge.svg
           :target: https://pypi.python.org/pypi/devicecloud/
        .. |License| image:: https://pypip.in/license/devicecloud/badge.svg
           :target: https://pypi.python.org/pypi/devicecloud/
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries
Classifier: Operating System :: OS Independent
