Metadata-Version: 2.0
Name: helen-electricity-usage
Version: 0.1.0
Summary: Small library for scraping electricity usage information from Helsingin Energia website
Home-page: https://github.com/ojarva/python-helen-electricity-usage
Author: Olli Jarva
Author-email: olli@jarva.fi
License: BSD
Keywords: electricity helen
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: beautifulsoup4 (>=4.4.1)
Requires-Dist: requests (>=2.5.1)
Provides-Extra: dev
Requires-Dist: twine; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'

Helsingin Energia electricity usage scraper
===========================================

This small script fetches per-hour electricity usage from Helsingin
Energia (Helen) website. This is unofficial implementation which may
break at any time, if Helen changes their website or implements any
additional validations.

Installation:

::

  pip install helen_electricity_usage

Usage:

::

  import helen_electricity_usage
  helen = helen_electricity_usage.Helen(username, password, metering_point_number)
  helen.login()
  print helen.get_date("20141225")

To obtain username and password, register using `web interface
<https://www2.helen.fi/raportointi/>`_ (Flash and paper invoice is
required). After registering and signing in, metering point number is
available on the top-right corner.

Sample output (python dictionary):

::

  [ {
    "milestones" : [ ],
    "month" : 12,
    "value" : 0.22999,
    "year" : 2014,
    "day" : 25,
    "hour" : 0
  }, {
    "milestones" : [ ],
    "month" : 12,
    "value" : 0.15,
    "year" : 2014,
    "day" : 25,
    "hour" : 1
  }...
  ]

There is no way to check whether data for specific date is available. If
data is not available, all fields are provided, but values are 0.0.
There is no way to distinct between missing data and hours with no
electricity consumption. Usually the data is available next day, but
that is not guaranteed.


