Metadata-Version: 2.1
Name: Seeed-grove.py
Version: 0.1
Summary: Python library for Seeedstudio Grove devices
Home-page: https://github.com/seeed-studio/grove.py
Author: JunJie Chen
Author-email: hansen.chen@seeed.cc
License: MIT
Description: ![](https://user-images.githubusercontent.com/4081906/55451417-67559d00-5605-11e9-96b3-4c6bdd3e770c.png)
        
        grove.py
        ========
        
        [![Build Status](https://travis-ci.org/Seeed-Studio/grove.py.svg?branch=master)](https://travis-ci.org/Seeed-Studio/grove.py)
        [![](https://img.shields.io/pypi/v/grove.py.svg)](https://pypi.python.org/pypi/grove.py)
        
        Python library for Seeedstudio Grove Devices on embeded Linux platform, especially good on below platforms:
        - [Coral Dev Board](https://www.seeedstudio.com/Coral-Dev-Board-p-2900.html) [(Wiki)](http://wiki.seeedstudio.com/Grove_Base_Hat_for_Raspberry_Pi/#software)
        - [NVIDIA Jetson Nano](https://www.seeedstudio.com/NVIDIA-Jetson-Nano-Development-Kit-p-2916.html) [(Wiki)](http://wiki.seeedstudio.com/Grove_Base_Hat_for_Raspberry_Pi/#software)
        - [Raspberry Pi](https://www.seeedstudio.com/category/Boards-c-17.html) [(Wiki)](http://wiki.seeedstudio.com/Grove_Base_Hat_for_Raspberry_Pi/#software)
        
        <br><br>
        # Architecture
        To operate grove sensors, the grove.py depends many hardware interface libraries such as mraa/upm/smbus2. 
        
        <br>
        
        ![](images/grove-py-arch.png)
        
        <br><br>
        # Installation
        For beginner or library user only, please install with online method.<br>
        For developer or advanced user, please install [dependencies](doc/INSTALL.md#install-dependencies)
        and then install grove.py with [source code](#install-grovepy).
        
        ### Online install
        install/update all dependencies and latest grove.py
        ```shell
        curl -sL https://github.com/Seeed-Studio/grove.py/raw/master/install.sh | sudo bash -s -
        ```
        
        ### Install grove.py
        From source code
        ```shell
        git clone https://github.com/Seeed-Studio/grove.py
        cd grove.py
        # Python2
        sudo pip install .
        # Python3
        sudo pip3 install .
        ```
        
        <br><br>
        ## Usage
        Basic GPIO Input & Output demo
        ```python
        import time
        from grove.gpio import GPIO
        
        led = GPIO(12, GPIO.OUT)
        button = GPIO(22, GPIO.IN)
        
        while True:
            if button.read():
                led.write(1)
            else:
                led.write(0)
            time.sleep(0.1)
        ```
        See more [demos and how to run](doc/README.md)
        
        <br><br>
        ## API Documentation
        click [here](https://seeed-studio.github.io/grove.py)
        
        [how to update me](sphinx/README.md)
        
        <br><br>
        ## Contribution
        Check list for adding a new grove device, for simple, take [grove_led](grove/grove_led.py) as a example.
        - Add a Class in the python source file, and export with `__all__ =`
        - Code sytle [PEP8](https://www.python.org/dev/peps/pep-0008) is recommanded
        - The python source could run directly with `python <file>` and `python3 <file>`
        - Add demo code at the near top of source file
        - The demo code could run directly with someone python/python3 IDE.
        - Add document to class and it's member and show the result by refering to [API document](#api-documentation)
        - Add a command item in setup.py `console_scripts` list, take effect by [install again](#install-grovepy)
        - Add a item to command table in [Usage Doc](doc/README.md)
        - If the command need argument but not specified, please list available arguments.
        - If specified invalid argument, also output usage document then exit.
        
Keywords: grove,Seeed
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
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
Requires-Python: >=2.6, !=3.0.*, !=3.1.*, !=3.2.*, <4
Description-Content-Type: text/markdown
