FlyThings Client

Getting Started

To use this client is necesary:

• Install Python (>=2.7, !=3.0., !=3.1., !=3.2., !=3.3)
• Install pip
• To Install our library:

    $ pip install flythings   

And now start to test the flythings clients.

Documentation

Configuration File

The general properties configuration in Configuration.properties:

• user: (Optional) user email or identifier to login on the system.
• password: (Optional) the user password to login, is not recommended use this configuration.
• server: (Optional, Default beta.flythings.io/api) configure the server url to insert the data.
• token: (Optional) the user token to send data into flythings plataform.
• device: (Optional) the device which sends data.
• sensor: (Optional) the sensor wich sends data.
• login_type: (Optional) type of login to use.
• timeout: (Optional) request timeout in seconds.
• authorization: (Optional) authorization token.
• Example of configuration file

    SERVER:beta.flythings.io/api  
    USER:<put your username here>  
    PASSWORD:<put your password here>  
    DEVICE:Python  
    SENSOR:Client  
    LOGIN_TYPE:USER or DEVICE
    TIMEOUT: 1000
    AUTHORIZATION: <put your token here>   

To load the data from the file call this function:

• load_data_by_file(String file)
  Description: Loads data from the file.
  Return: Nothing.

Examples:

• Loads config data from a file.

  </code></pre>
  </li>
  </ul>
  <p>You can also introduce this general properties using the library methods.</p>
  <h3 id="user-content-general-module-configuration-methods">General Module Configuration Methods<a href="#user-content-general-module-configuration-methods" aria-label="Link to heading 'General Module Configuration Methods'" data-heading-content="General Module Configuration Methods" class="anchor"></a></h3>
  <ul>
  <li>
  <p><strong>set_server</strong>(String server)<br />
  <strong>Description</strong>: Sets the server to which the requests will be sent.<br />
  <strong>Return</strong>: Returns a string representing the server.</p>
  </li>
  <li>
  <p><strong>set_device</strong>(String device, (Optional) object=None, always_update=False)<br />
  <strong>Params</strong>:</p>
  <ul>
  <li>device: (Mandatory) Device name.</li>
  <li>object: (Optional) Object with extra device params.</li>
  <li>always_update: (Optional) Indicates if must send a request to create/update the device.
  <pre><code class="language-PYTHON">  object = {
      "type": "CUSTOM",
      "geom": {
      "type": "Point",
      "crs": "4326",
      "coordinates": [
      -19.323204, 27.611808
      ]
    } }
  

Description: Sets the device of the observation. Uses a file named .foiCache to get a fast access to most used devices.
Return: Returns a string representing the device.

Modules documentation

• InsertionModule
• RealTimeModule
• ActionModule
• PredictionModule
• SosModule
• UtilModule

Tests

In the test folder, after fill in the Configuration.Properties file write on bash:

    nosetests flythingsTest.py  

(Nose python library is needed)

Change log

• Change log

License

Developed by ITG