Metadata-Version: 2.1
Name: octopus_energy_api
Version: 0.7
Summary: Wrapper for communicating with the Octopus Energy API
Home-page: https://github.com/euanacampbell/octopus_energy_api
Author: Euan Campbell
Author-email: dev@euan.app
License: MIT
Download-URL: https://github.com/euanacampbell/octopus_energy_api/archive/refs/heads/master.tar.gz
Description: [![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/) [![GitHub license](https://img.shields.io/github/license/Naereen/StrapDown.js.svg)](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)
        
        GitHub: [github.com/euanacampbell/octopus_energy_api](https://github.com/euanacampbell/octopus_energy_api)
        
        PyPi: [pypi.org/project/octopus-energy-api](https://pypi.org/project/octopus-energy-api/)
        
        ## Installation
        
        ```bash
        pip install octopus-energy-api
        ```
        
        ## Import
        
        ```python
        from octopus_energy_api import oe_api
        ```
        
        ## Usage
        Two ways of creating an API instance.
        
        #### Load access details in manually - Can be found using this fantastic tutorial by Guy Lipman [guylipman.medium.com](https://guylipman.medium.com/accessing-your-octopus-smart-meter-data-3f3905ca8fec).
        
        ```python
        from octopus_energy_api import oe_api
        
        account_number = ""
        api_key = ""
        mpan = ""
        serial_number = ""
        
        energy_api = oe_api(account_number, api_key, mpan=mpan, serial_number=serial_number)
        ```
        
        #### Get mpan and serial numbers from account number + api key. (currently only works for single property accounts)
        
        ```python
        from octopus_energy_api import oe_api
        
        api_key = "value"
        account_number = "value"
        
        energy_api = oe_api(account_number, api_key)
        ```
        
        ## Account Details
        ```python
        energy_api.account_details()
        ```
        
        ## Consumption
        
        Getting all consumption data.
        ```python
        today = datetime.date.today() # setting end date to today
        start = today.replace(day=1) # setting start date to the beginning of the month
        
        energy_api.consumption(start, today)
        ```
        
        Getting calculated consumption data - total, mean, and median.
        ```python
        today = datetime.date.today() # setting end date to today
        start = today.replace(day=1) # setting start date to the beginning of the month
        
        energy_api.consumption_total(start, today)
        
        energy_api.consumption_mean(start, today)
        
        energy_api.consumption_median(start, today)
        ```
        
        Price of consumption.
        ```python
        today = datetime.today()
        start = today - timedelta(days=300)
        
        electric_rate = 2.73
        
        energy_api.consumption_cost(start, today, electric_rate)
        ```
        
        ## Products
        
        ```python
        energy_api.products()
        ```
        
        ## Meter Information
        
        ```python
        energy_api.meter_point()
        ```
Keywords: energy,api,requests
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
