Metadata-Version: 2.1
Name: pyaqua
Version: 0.0.1
Summary: Simple CLI for Aqualink API
Home-page: https://github.com/samapriya/pyaqua
Author: Samapriya Roy
Author-email: samapriya.roy@gmail.com
License: Apache 2.0
Description: # pyaqua: Simple CLI for Aqualink API
        
        [![Twitter URL](https://img.shields.io/twitter/follow/samapriyaroy?style=social)](https://twitter.com/intent/follow?screen_name=samapriyaroy)
        
        ## Table of contents
        * [Installation](#installation)
        * [Getting started](#getting-started)
        * [pyaqua Simple CLI for Aqualink API](#pyaqua-simple-cli-for-aqualink-api)
            * [site list](#site-list)
            * [site live](#site-live)
            * [site-daily](#site-daily)
            * [site-timeseries](#site-timeseries)
        
        ## Installation
        This assumes that you have native python & pip installed in your system, you can test this by going to the terminal (or windows command prompt) and trying
        
        ```python``` and then ```pip list```
        
        **pyaqua only support Python v3.4 or higher**
        
        To install **pyaqua: Simple CLI for Aqualink API** you can install using two methods.
        
        ```pip install pyaqua```
        
        or you can also try
        
        ```
        git clone https://github.com/samapriya/pyaqua.git
        cd pyaqua
        python setup.py install
        ```
        For Linux use sudo or try ```pip install pyaqua --user```.
        
        I recommend installation within a virtual environment. Find more information on [creating virtual environments here](https://docs.python.org/3/library/venv.html).
        
        ## Getting started
        
        As usual, to print help:
        
        ```
        usage: pyaqua [-h] {site-list,site-live,site-daily,site-timeseries} ...
        
        Simple CLI for Aqualink API
        
        positional arguments:
          {site-list,site-live,site-daily,site-timeseries}
            site-list           Print lists of Site Name and ID with spotters
            site-live           Get most recent/live info from a site
            site-daily          Print daily data info for a site
            site-timeseries     Print daily data info for a site
        
        optional arguments:
          -h, --help            show this help message and exit
        ```
        
        To obtain help for specific functionality, simply call it with _help_ switch, e.g.: `pyaqua site-live -h`. If you didn't install pyaqua, then you can run it just by going to *pyaqua* directory and running `python pyaqua.py [arguments go here]`
        
        ## pyaqua Simple CLI for [Aqualink API](aqualink.org)
        The tool is designed to interact with the Aqualink.org API, for now this is focused only on the spotter endpoints.
        
        ### site list
        This allows you to get existing sites with spotters attached and print Site Name and ID. These could be in different status of application including maintenance, deployed, lost, shipped and so on. The tool also applies a fuzzy search and allows you to look for a specific site to get site id.
        
        ![site_list](https://user-images.githubusercontent.com/6677629/145728096-dd15a9a1-e8c7-43ca-9884-0a6e7842b689.gif)
        
        
        ### site-live
        This allows to get the most updated/live information about a site based on a site ID from the idlist. The tool parses the output as an indent JSON object.
        
        ![site_live](https://user-images.githubusercontent.com/6677629/145728182-db54c3ce-3a4d-4b45-852b-5c1ae5a97376.gif)
        
        ### site daily
        This allows to get the most daily data for a site based on a site ID from the idlist. The tool parses the daily output as an indented JSON and you can specify months since today as well as data type like wind/wave/temp.
        
        ![site_daily](https://user-images.githubusercontent.com/6677629/145728380-11b0acaf-8a9c-4c90-904a-675f8364a5f6.gif)
        
        ### site timeseries
        This allows to get the most daily data for a site based on a site ID from the idlist. The tool exports the time series data for both NOAA and spotter datasets as CSV to a given folder. It attaches the site_id to the CSV filename **spotter_dhw_siteid** for example **spotter_dhw_1113**
        
        ![site_timeseries](https://user-images.githubusercontent.com/6677629/145728547-c724f911-4301-4887-a9e8-dbbce4b28174.gif)
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: GIS
Description-Content-Type: text/markdown
