Python client library for pushdata.io
Project description
Pushdata Python client library
Installation
pip install pushdata-io
Usage
import pushdata
# 1. Initialize with no authentication
# Initialize with our account email and time series name we want to use
pd = pushdata.Client(email="myemail@example.com", tsname="mytimeseries")
# 2. ...or initialize with authentication (for account with security=on)
pd = pushdata.Client(apikey="thd8JT73LsB8jah0F4d9", tsname="mytimeseries")
# Send a data point to the time series
pd.send(4711)
# Send to another time series by overriding tsname
pd.send(4711, tsname="myothertimeseries")
# Retrieve all data from the time series
response = pd.recv()
# Or from another time series
response = pd.recv(tsname="anothertimeseries")
# Retrieve data timestamped during the last week
import datetime
one_week_ago = datetime.datetime.now() - datetime.timedelta(days=7)
response = pd.recv(fromtime=one_week_ago)
# Retrieve data for one 24-hour period, one week ago
import datetime
one_week_ago = datetime.datetime.now() - datetime.timedelta(days=7)
one_week_ago_plus_24h = one_week_ago + datetime.timedelta(days=1)
response = pd.recv(fromtime=one_week_ago, totime=one_week_ago_plus_24h)
#
# Print time series data
#
# We get a Python Requests response object from recv(), which
# includes response code, raw HTTP response body, and more.
# We use the .json() method to parse the body text as JSON
# and get a dictionary:
tsdata = response.json()
#
# And then we print stuff:
print("Timeseries name: " + tsdata["name"])
print("First point recorded at : " + tsdata["first"]) # timestamp of first point in time series
print("Last point recorded at : " + tsdata["last"]) # timestamp of last point in time series
print("Total number of points : " + tsdata["total"]) # total number of points in timeseries
print("Number of points returned : " + tsdata["returned"]) # number of points returned in this call
print("---- Points ----")
for point in tsdata["points"]:
print("Time=%s value=%f" % (point["time"], point["value"]))
#
# tsdata (the decoded JSON response from pushdata.io) is
# a dictionary that looks like this:
# {
# "name": "mytimeseries",
# "first": "2019-02-15T07:43:31.546805Z",
# "last": "2019-03-05T11:21:06.20951Z",
# "total": 482,
# "returned: 482,
# "offset": 0,
# "limit": 10000,
# "points": [
# {
# "time": "2019-02-15T07:43:31.546805Z",
# "value": 4711.0
# },
# ...
# ]
# }
#
# See https://speca.io/ragnarlonn/pushdata-io#TimeSeriesData
#
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pushdata-io-0.0.9.tar.gz
(2.8 kB
view hashes)
Built Distribution
Close
Hashes for pushdata_io-0.0.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a69711d9a1e27993d7cecc0b5b432e6874dc0a06c823141b56ccbf222a86b08d |
|
MD5 | 5fea2cbf17c4d71dc3a5b43a159e2f37 |
|
BLAKE2b-256 | 62aadb5142ce2ac02969f65b882de4a0f04b88540e7e6ec3127bb084ed4bd67f |