Metadata-Version: 2.4
Name: my-meter-api
Version: 0.1.1
Summary: Get your electricity meter reading and usage data from compatible MyMeter sites.
Author-email: Tag Howard <tag@jthoward.dev>
License-Expression: MIT
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.13
Requires-Dist: requests>=2.32.3
Description-Content-Type: text/markdown

# MyMeter API

This API can be used to interact with the private API used by the MyMeter application used by some power companies to expose usage data to customers.

**NOTE**: This API is undocumented and could change or break at any time.

## Usage

All functionality is encapsulated within the `MyMeterApi` class. It requires four parameters: `baseUrl`, `rememberMeCookie`, `sidCookie`, and `cookieRequestVerificationToken`.

- `baseUrl` is simply the URL of your power company's MyMeter instance (i.e. "https://mymeter.example.com")
- `rememberMeCookie`, `sidCookie`, and `cookieRequestVerificationToken` are the values of your `MM_RememberMe`, `MM_SID`, and `__RequestVerificationToken` cookies respectively

Once you have an instance of `MyMeterApi`, just call `downloadUsage` with your meter number, the date range you want, and the interval you want to be returned. The API client will automatically perform the CSRF process, and then download and parse a usage CSV, returning an array of `MyMeterUsageValue` objects.
