Metadata-Version: 2.1
Name: ripple-energy
Version: 2.0.0
Summary: Python Module For Ripple Energy
Project-URL: Documentation, https://github.com/danieledwardgeorgehitchcock/ripple-energy#readme
Project-URL: Issues, https://github.com/danieledwardgeorgehitchcock/ripple-energy/issues
Project-URL: Source, https://github.com/danieledwardgeorgehitchcock/ripple-energy
Author-email: Daniel Hitchcock <daniel.edward.george.hitchcock@gmail.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.7
Requires-Dist: py-graphql-mapper~=1.1.2
Requires-Dist: requests~=2.31.0
Requires-Dist: typing
Description-Content-Type: text/markdown

# Ripple Energy

[![PyPI - Version](https://img.shields.io/pypi/v/ripple-energy.svg)](https://pypi.org/project/ripple-energy)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ripple-energy.svg)](https://pypi.org/project/ripple-energy)

-----

**Table of Contents**

 - [Known Bugs And Issues](#known-bugs-and-issues)
 - [To-Do](#to-do)  
 - [Installation](#installation)
 - [Example](#example)
 - [License](#license)

## Known Bugs And Issues

 - ~~Any (all?) GraphQL query functions fail~~ solved by dapalex/py-graphql-mapper#25
 - ~~list_Date type clash warning~~ solved by dapalex/py-graphql-mapper#25
 - ~~Unsure of header format for token auth~~ now confirmed working
 - insightsChartData optional in response but mandatory in framework

## To-Do

 - Complete function wrappers for all GraphQL queries
 - Complete function wrappers for all GraphQL mutations
 - Create function exceptions
 - ~~Put functions into classes~~
 - Add linting
 - Create tests
 - Create build pipeline 
 - Publish to PyPi 
 - Make Async?

## Installation

At present, this package has not been published to PyPi - You will therefore need to clone this repository to use it.  

```console
git clone https://github.com/danieledwardgeorgehitchcock/ripple-energy.git
```
This project leverages the use of [Hatch](https://hatch.pypa.io/latest/) for project management - please follow the installation instructions there before continuing.

Once the above has completed, enter in to the project directory

```console
cd ripple-energy
```
As this package is managed by Hatch, you can start an environment which automatically pulls the project dependencies
  
  ```console
hatch shell start
```

You should then be able to use the package from within this environment.

## Example
Me:
  ```python
from  ripple_energy  import RippleEnergy

ripple  = RippleEnergy(email  =  "YOUR_RIPPLE_EMAIL", password  =  "YOUR_RIPPLE_PASSWORD")

data = ripple.me()

print(data)
```

## License

`ripple-energy` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.