Metadata-Version: 2.1
Name: gie-py
Version: 0.2.0
Summary: A python API wrapper for alsi.gie.eu and agsi.gie.eu
Home-page: https://github.com/fboerman/gie-py
Author: Frank Boerman
Author-email: frank@fboerman.nl
License: MIT
Keywords: GIE data api energy gas
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md

# gie-py
Python client for the API endpoints of gie.eu. Both ASGI for gas storage and ALSI for LNG terminals and lso's are supported

Using it requires an api key which you can get by registering an account [at the alsi website](https://alsi.gie.eu/#/api).
API keys are valid for both ASGI and ALSI if you set "access to" to "Both ALSI and AGSI+" when registering or later in account settings.

## Installation
`python3 -m pip install gie-py`

## Usage
The package comes with 2 clients:
- [`GieRawClient`](#GieRawClient): Returns data in its raw format direct from api, a list of dictionaries 
- [`GiePandasClient`](#GiePandasClient): Returns data parsed as a Pandas DataFrame

### Supported methods:
The same for both clients. Each method has same setup for arguments, a string to denominate the target 
and a start and end parameter which is either a pandas timestamp or a string
* ```query_gas_storage```
* ```query_gas_company```
* ```query_lng_terminal```
* ```query_lng_lso```

### Example
```python
from gie import GiePandasClient

client = GiePandasClient(api_key=<YOUR API KEY>)
df_terminal=client.query_lng_terminal('zeebrugge', start='2020-01-01', end='2022-07-10')
df_lso=client.query_lng_lso('fluxys_lng', start='2020-01-01', end='2022-07-10')
```

## meaning of dataframe columns
For the meaning of the columns in the resulting dataframes please consult the official [documentation](https://alsi.gie.eu/GIE_API_documentation_v004.pdf) chapter 2 page 5 and 6
