Smart Citizen Connector
This is a connector written in python to get and post data from the Smart Citizen API. It can be used in conjunction with other scripts such as scdata.
Installation
Simply do:
pip install smartcitizen-connector
Development
Clone the repo and install in editable mode:
git clone git@github.com:fablabbcn/smartcitizen-connector.git
cd smartcitizen-connector
pip install -e .
Usage
See docs for examples. a basic usage is shown below:
- Device (create and get data):
from smartcitizen_connector import SCDevice
import asyncio
d = SCDevice(16549)
print (d.json.name)
print (d.json.owner)
await d.get_data(freq = '1Min') # returns pandas dataframe
print (d.data)
- Search (see docs)
from smartcitizen_connector import search_by_query
# Users whose username contains "osc"
search_by_query(endpoint = 'users', key="username", search_matcher="cont", value="osc")
# Devices in which
search_by_query(endpoint = 'devices', key="name", search_matcher="cont", value="air")
# Devices created after (date greater than) "2023-08-11"
search_by_query(endpoint = 'devices', key="created_at", search_matcher="gt", value="2023-08-11")
- Authentication
Set the following environment variable with your Smart Citizen API token:
SC_BEARER=xxxxx
1 maintainer
Metadata
1 maintainer
Release files for smartcitizen-connector 1.5.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| smartcitizen_connector-1.5.3.tar.gz | 31.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartcitizen_connector-1.5.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 68.0 kB
Release files / smartcitizen_connector-1.5.3.tar.gz
| Download URL | smartcitizen_connector-1.5.3.tar.gz |
|---|---|
| Size | 31.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
10bbb8c83a273f64b7aa4cabb6b8ee5ab9e451f1277a8d32bbdab8bcab1eace1
|
|
BLAKE2b-256 checksum How to use checksums |
ba1f5d26e50eb1b9d0fe74d238ab9afbc43b13a207c8674980cce5c7479878e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / smartcitizen_connector-1.5.3-py3-none-any.whl
| Download URL | smartcitizen_connector-1.5.3-py3-none-any.whl |
|---|---|
| Size | 36.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
658ffdb164f4cba3cfc03fb149a5be64328092f4470d341bfd4a683269c6c5dd
|
|
BLAKE2b-256 checksum How to use checksums |
a0068c97af7e0501cab3b97ca6fa8d91dea4e5e86e8f2fba60d62245b0741c39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
