Metadata-Version: 2.1
Name: wappstoiot
Version: 0.5.4
Summary: Simple Wappsto Python user-interface to Wappsto IoT
Home-page: https://github.com/Wappsto/python-wappstoiot
Author: Seluxit A/S
Author-email: support@seluxit.com
License: Apache-2.0
Description: Wappsto IoT
        ===============================================================================
        
        [![Build Status](https://travis-ci.com/Wappsto/python-wappsto-iot.svg?branch=master)](https://travis-ci.com/Wappsto/python-wappsto-iot)
        [![Coverage Status](https://coveralls.io/repos/github/Wappsto/python-wappsto-iot/badge.svg?branch=master)](https://coveralls.io/github/Wappsto/python-wappsto-iot?branch=master)
        
        The wappstoiot module provide a simple python interface to [wappsto.com](https://wappsto.com/) for easy prototyping.
        
        
        ## Prerequisites
        
        A [wappsto.com](https://wappsto.com/) Account, that the unit can connect to.
        
        The wappsto module requires a set of certificates for authentication. The certificates can be downloaded from [wappsto.com](https://wappsto.com/), or with the build-in CLI tool: `python3 -m wappstoiot`.
        The certificates provides the unit with the secure connection to wappsto.com.
        
        To read more about how the Wappsto IoT inner workings, go [here](https://documentation.wappsto.com).
        
        ## The Basics
        
        To understand how to use Wappsto IoT, there is some terms that need to be known.
        * Control
            - Change request value.
        * Report
            - The current value.
        * Refresh
            - Value Update request.
        * Delete
            - inform that a delete have happened.
        * network -> device -> value
            - ...
        
        ## Getting Started
        
        Working examples of usage can be found in the [example folder](./example).
        
        The needed certificates can be downloaded with: `python -m wappstoiot --path echo`
        Where path is the path to the config-folder, given in the following code example.
        
        ### Echo example
        
        The following explains the example code found in [echo.py](./example/echo.py).
        
        
        ```python
        network = wappstoiot.config(
            config_Folder="echo"
        )
        ```
        
        ```python
        network = wappstoiot.createNetwork(
            name="echo",
        )
        ```
        
        ```python
        device = network.createDevice(
            name="EchoDevice"
        )
        ```
        
        ```python
        value = device.createValue(
            name="Moeller",
            permission=wappstoiot.PermissionType.READWRITE,
            value_type=wappstoiot.ValueType.STRING
        )
        ```
        
        ```python
        value.onControl(
            callback=lambda obj, new_value: obj.report(new_value)
        )
        ```
        
        ```python
        value.onRefresh(
            callback=lambda obj: obj.report(f"{obj.data} Refreshed!")
        )
        ```
        
        ```python
        try:
            while True:
                time.sleep(0.5)
        except KeyboardInterrupt:
            pass
        finally:
            wappstoiot.close()
        ```
        
        
        ## Installation using pip
        
        The wappsto module can be installed using PIP (Python Package Index) as follows:
        
        ```bash
        $ pip install -U wappstoiot
        ```
        
        ## License
        
        This project is licensed under the Apache License 2.0 - see the [LICENSE.md](LICENSE.md) file for details.
        
        
        
        v0.5.4 (Dec 21 2021)
        ===============================================================================
        
        ## Added
        
         * New Default Value-Types. (CO2, Humidity & Pressure Pascal).
        
        
        ## Changed
        
         * The createValue, are now split into 5. `createValue` that uses the predefined ValueType given, and 1 for each base value types, for when a custom is needed. 
         * `permission` is now required.
         * `onControl`, `onReport`, `getControlData` & `getReportData` provides a float if the value was set to be a number.
        
        
        ## Fixed
        
         * offline_Storage warnings now fixed.
         * A issue where the `type`-value inside value where not set.
         * A issue where the step was set to a int, not a float.
         * `wappstoiot.onStatus` should not be working correctly.
        
        
        v0.5.3 (Dec 9, 2021)
        ===============================================================================
        
        ## Added
        
         * Groove Examples for Raspberry Pi.
         * Checks of naming, so it reuses the object based on the name. (Naming are mandatory now.)
         * `wappstoiot.config` have been added to handle all the configs.
         * `wappstoiot.createNetwork` have been added to streamline the flow.
         * `value.getReportTimestamp()`, `value.getControlTimestamp()` have been added to make the timestamp for the last given value accessible.
         * `value.getControlData()` have been added to make the control data accessible.
        
        ## Removed
        
         * Remove the Module ids. (The Names are now the unique identifier.)
         * Remove `Rich` dependency.
        
        ## Changed
        
         * The names & naming convention to fix the other Wappsto Libraries.
         * All the connections & general configs are moved from the Network, to wappstoiot.
         * `value.data` have been changed to `value.getReportData()`
        
        ## Fixed
        
         * Fix the naming to fit the naming convention.
        
        
        v0.5.2 (Nov 25, 2021)
        ===============================================================================
        
        ## Added
        
         * HTTP Proxy support. (Pulls #259, #353)
        
        ## Fixed
        
         * Make WappstoIoT python3.6 compatible.
         * Fix a Path issue that make the code not able to find the certificates in ipython.
        
        
        v0.5.1 (Nov 23, 2021)
        ===============================================================================
        
        ## Added
        
         * Pip release.
        
        ## Fixed
        
         * Fix the name to fit the naming convention.
        
        
        v0.5.0 (September 20, 2021)
        ===============================================================================
        
        ## Added
        
         * First Release.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
