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
>>> webpage=""
>>> nb_rows = 5
>>> cvlnk = cavelink.Sensor(webpage, nb_rows)
>>> motiers = cvlnk.getJSON(datefmt='human')  # or datefmt='epoch'
>>> motiers_json = json.loads(motiers)
>>> for timestamp in motiers_json['measures']:
>>>    print('%s : %s %s' % (key,
>>>                           motiers_json['measures'][timestamp],
>>>                           motiers_json['sensor']['unit']))

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)

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.

Filename, size & hash SHA256 hash help File type Python version Upload date
cavelink-1.1.0-py3-none-any.whl (6.0 kB) Copy SHA256 hash SHA256 Wheel py3
cavelink-1.1.0.tar.gz (4.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page