Skip to main content

Fetch Cavelink data by parsing the webpage of sensors.

Project description

Build Status

What is this repository for?

This python module gather the data by parsing the webpage. You will then be able to display the data on your dashboard or store it to your own database. I also provide code samples to better explain this -see directory ‘samples’-.

How do I get set up?

To ensure a proper setup, I recommend the use of virtualenv (but optionnal).

sudo apt-get update && sudo apt-get install git python-pip –yes mkdir your-project cd your-project virtualenv venv source venv/bin/activate sudo pip install cavelink

Then you can use the module that way:

from cavelink import cavelink
nb_rows = 5
cvlnk = cavelink.Sensor(webpage, nb_rows)
motiers = cvlnk.getJSON(datefmt='human')  # or datefmt='epoch'

You will get a the measurements and the sensor details formatted in JSON.

   "measures": {
      "22.12.2018 16:00": 6.3,
      "22.12.2018 16:30": 5.67,
      "22.12.2018 17:00": 6.0,
      "22.12.2018 17:30": 5.45,
      "22.12.2018 18:00": 5.87
   "sensor": {
      "group": "10",
      "number": "1",
      "station": "142",
      "unit": "C"

You can also fetch additionnal information, also available from the page. Please note that the following data is provided in JSON object as well. This is:

>>> print(cvlnk.station)
>>> print(
>>> print(cvlnk.number)
>>> print(cvlnk.unit)

To parse the measures, you can use this sample:

import json

# convert the json-formatted string to a python dictionnay
motiers_json = json.loads(motiers)

# parse measures
for timestamp in motiers_json['measures']:
   print('%s -> %s %s' % (timestamp,

Contribution guidelines

Feel free to submit issue or better, some pull requests !


  • Sébastien Pittet (main contributor)
  • Loïc, Bruno and other friends at

Who do I talk to?

sebastien at pittet dot org

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cavelink, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size cavelink-1.1.1-py3-none-any.whl (6.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size cavelink-1.1.1.tar.gz (5.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page