Metadata-Version: 1.0
Name: exoline
Version: 0.0.24
Summary: Command line interface for Exosite platform.
Home-page: http://github.com/dweaver/exoline
Author: Dan Weaver
Author-email: danweaver@exosite.com
License: UNKNOWN
Description: Exoline: Command Line for Exosite
        =================================
        
        Exoline is a set of commands for accessing the Exosite [One Platform](http://exosite.com/products/onep) from the command line.
        
        - **exo** - command for the [RPC API](http://developers.exosite.com/display/OP/Remote+Procedure+Call+API)
        
        - **exodata** - command for the [HTTP Data Interface API](http://developers.exosite.com/display/OP/HTTP+Data+Interface+API)
        
        
        Installation 
        ------------
        
        To install the latest released version of exoline:
        
        ```bash
        
            $ pip install --upgrade exoline
        
        ```
        
        Alternatively, install straight from github:
        
        ```bash
        
            $ pip install -e git://github.com/dweaver/exoline#egg=exoline
        
        ```
        
        
        Environment Variables
        ---------------------
        
        For convenience, several command line options may be replaced by environment variables.
        
        * EXO\_HOST: host, e.g. m2.exosite.com. This supplies --host to exo and --url for exodata.
        
        
        Help 
        ----
        
        For help, run each command with -h from the command line.
        
        
        Test
        ----
        
        To run the tests, install the packages in test/requirements.txt, and then type:
        
        ```bash
        
            $ cd test
            $ nosetests --verbose
        
        ```
        
        Examples
        --------
        
        Here are some examples of common tasks with Exoline.
        
        * Upload a Lua script
        
        ```bash
        
            $ exo script translate_gps.lua e469e336ff9c8ed9176bc05ed7fa40d?????????     
            Updated script RID: 6c130838e14903f7e12d39b5e76c8e3?????????
        
        ```
        
        * Monitor output of a script
        
        ```bash
        
            $ exo read e469e336ff9c8ed9176bc05ed7fa40d????????? translate_gps.lua --follow 
            2013-07-09 11:57:45,line 2: Running translate_gps.lua...
            2013-07-09 12:00:17,"line 12: New 4458.755987,N,09317.538945,W
            line 23: Writing 4458.755987_-09317.538945"
            2013-07-09 12:15:41,"line 12: New 4458.755987,N,09317.538945,W
            line 23: Writing 4458.755987_-09317.538945"
        
        ```
        
        * Write raw data
        
        ```bash
        
            $ exo write e469e336ff9c8ed9176bc05ed7fa40d????????? gps-raw --value=4458.755987,N,09317.538945,W
        
        ```
        
        
        TODO
        ----
        
        - add sparklines output
        - add support for exporting datapoint intervals over a time range
        - add support for /provision/register to get vendor info from CIK
        - add support in read for multiple rids
        - add sparkchart instructions in readme
        - Make the info command take multiple rids (or stdin)
        - Make the script command take multiple rids (or stdin)
        - Add support for update command 
        - Add --watch flag to script upload so script loads automatically
        - Support binary datasource format
        - Add code coverage to tests
        - Combine drop and drop-all-children
        
        
        History
        =======
        
        0.0.24 (2013-7-12)
        ------------------
        
        - Added raw read format
        
        0.0.23 (2013-7-12)
        ------------------
        
        - Made <rid> optional for all commands
        - Added root node detail output to tree
        
        0.0.22 (2013-7-11)
        ------------------
        
        - Bumped up version requirement for pyonep
        
        0.0.21 (2013-7-11)
        ------------------
        
        - Fixed tree output for devices with expired status
        - Hide KeyboardInterrupt exception except when --debug set
        
        0.0.20 (2013-7-10)
        ------------------
        
        - Fixed script command
        
        0.0.19 (2013-7-10)
        ------------------
        
        - Fixed README.md
        
        0.0.18 (2013-7-10)
        ------------------
        
        - Help for individual commands, git style
        - Fixed regression in 0.0.17 affecting all commands taking <rid>
        - record-backdate is now record with --interval
        
        
        0.0.17 (2013-7-09)
        ------------------
        
        - Handle keyboard interrupt gracefully for read --follow
        - Added example usage in README.md
        - Fixed read --follow when dataport has no data
        
        0.0.16 (2013-7-08)
        ------------------
        
        - Support passing alias for <rid>
        - Make read return latest value by default
        
        0.0.15 (2013-7-08)
        ------------------
        
        - script upload
        
        0.0.14 (2013-7-07)
        ------------------
        
        - tests for create, read, write
        
        0.0.13 (2013-7-03)
        ------------------
        
        - record, unmap, lookup commands, better/stronger/faster tree 
        
        0.0.12 (2013-6-27)
        ------------------
        
        - Show OnePlatform library exceptions nicely
        
        0.0.11 (2013-6-27)
        ------------------
        
        - Changed defaults for tree
        
        0.0.10 (2013-6-27)
        ------------------
        
        - flush command
        
        0.0.9 (2013-6-26)
        -----------------
        
        - Added format to tree output
        
        
        0.0.8 (2013-6-26)
        -----------------
        
        - Added units to tree output, support writing negative numeric values
        
        0.0.7 (2013-6-23)
        -----------------
        
        - Time series data write and read commands, with --follow option
        
        
        0.0.6 (2013-6-23)
        -----------------
        
        - RID lookup and bulk drop commands
        
        
        0.0.5 (2013-6-21)
        -----------------
        
        - Install two command line scripts: exo, exodata
        
        
        0.0.4 (2013-6-18)
        -----------------
        
        - Complete Exosite Data API
        - Subset of Exosite RPC API
        
        
Keywords: exosite,onep,one platform,m2m
Platform: UNKNOWN
