Metadata-Version: 2.1
Name: ecomegane
Version: 1.0.0
Summary: Download data from Eco-Megane PV monitoring platform.
Home-page: https://github.com/dliberat/ecomegane
Author: Dan Liberatori
Author-email: daniel.liberatori@gmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/dliberat/ecomegane/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: lxml

# Eco-Megane Python Client

## About

The Eco-Megane online platform provides monitoring data for photovoltaic systems.
However, they do not offer an API or any convenient way of programmatically accessing the data. This client allows you to download certain data from the site using Python.

## Installation

To install the client using `pip`:

```
pip install ecomegane
```

## Getting Started

To begin downloading data, you will need to find your power plant's ID number on the Eco Megane site.

![Site ID](https://github.com/dliberat/ecomegane/raw/master/docs/img/site_id.png)

## Example Usage

For a complete sample, see `docs/sample.py`.

**Downloading hourly data**

```python
import datetime
from ecomegane import EcoMeganeClient

site_id = '00031234567'
today = datetime.date.today()

with EcoMeganeClient('username', 'password') as client:
    kwh = client.get_hourly_kwh(site_id, today)
    for timestamp, energy in kwh.items():
        print(timestamp, energy)
```


**Downloading daily data**

```python
import datetime
from ecomegane import EcoMeganeClient

site_id = '00031234567'
today = datetime.date.today()

with EcoMeganeClient('username', 'password') as client:
    # Download daily data for the current month.
    kwh = client.get_daily_kwh(site_id, today)
    for timestamp, energy in kwh.items():
        print(timestamp, energy)
```

## Contributing

PRs are welcome. Feel free to fork the repo, make your changes, and submit a PR. It is recommended that you create an Issue before starting work on your features.


