emfitapi-python 0.2.3

Python wrapper for the Emfit QS API

EmfitAPI Python Wrapper

Overview

EmfitAPI is a Python wrapper for the Emfit QS API. It provides methods to authenticate, fetch user and device data, and retrieve various metrics such as presence, trends, and timeline data from Emfit devices.

Installation

You can install the EmfitAPI wrapper using uv:

uv add emfitapi-python

Or from source:

git clone https://github.com/harperreed/emfitapi-python.git
cd emfitapi-python
uv sync

Development Installation

For development, clone the repository and install with dev dependencies:

git clone https://github.com/harperreed/emfitapi-python.git
cd emfitapi-python
uv sync

Running Tests

uv run pytest

Code Quality

# Run linting
uv run ruff check .

# Run formatting
uv run ruff format .

# Run security checks
uv run bandit -r emfit/
uv run safety check

Usage

Initializing the API

To start using the EmfitAPI, you need to instantiate the class:

from emfit.api import EmfitAPI

api = EmfitAPI(token="your_token_here")

If you don't have a token, you can obtain one by logging in:

api = EmfitAPI()
response = api.login("your_username", "your_password")

Making Requests

After authentication, you can use various methods to interact with the API:

• get_user(): Fetches user information.
• get_device_status(device_id): Retrieves the status of a specific device.
• get_device_info(device_id): Fetches information of a specific device.
• get_latest_presence(device_id): Gets the latest presence information for a device.
• get_presence(device_id, presence_id): Retrieves presence information for a specific device and presence ID.
• get_trends(device_id, start_date, end_date): Fetches trend data for a device within a specified date range.
• get_timeline(device_id, start_date, end_date): Retrieves timeline data for a device within a specified date range.
• get_notification_settings(device_id): Gets the notification settings for a specific device.

Example

# Retrieve and print user information
user_info = api.get_user()
print(user_info)

# Fetch and print device status
device_status = api.get_device_status("device_id_here")
print(device_status)

Running the Example

The repository includes an example script that demonstrates basic usage:

# Set up environment variables
export EMFIT_USERNAME="your_username"
export EMFIT_PASSWORD="your_password"

# Run the example
uv run example.py

Logging

EmfitAPI uses Python's logging module to log information, warnings, and errors. Configure the logging level as needed.

Exception Handling

The wrapper raises exceptions when API requests fail. Ensure to handle these exceptions in your application.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.