Ponika

Ponika is a Python library for interacting with the Teltonika devices.

Installation

You can install Ponika using pip:

bash pip install ponika

Usage

To use Ponika, you need to create an instance of PonikaClient with the appropriate parameters. Here's a basic example:

```python from ponika import PonikaClient

client = PonikaClient( host="192.168.1.1", username="yourusername", password="yourpassword", # port=80, # Optional, default is 443 if tls=True else 80 # tls=False, # Optional, default is True # verify_tls=False, # Optional, default is True ) ```

The library follows the structure of the Teltonika API endpoints. For example, to get the internet status from the endpoint /api/v1/internet_connection/status, you can do the following:

```python response = client.internetconnection.getstatus()

if response.success and response.data: print("Internet Status:") print("IPv4:", response.data.ipv4status) print("IPv6:", response.data.ipv6status) print("DNS: ", response.data.dns_status) else: print("Error:", response.errors) ```

[!NOTE] Not all endpoints are implemented. If you need a specific endpoint that's missing, the existing endpoints should be a good reference for how to implement new ones.

Examples

Get Internet Status

```python response = client.internetconnection.getstatus()

if response.success and response.data: print("Internet Status:") print("IPv4:", response.data.ipv4status) print("IPv6:", response.data.ipv6status) print("DNS: ", response.data.dns_status) else: print("Error:", response.errors) ```

Get GPS Position

```python response = client.gps.position.get_status()

if response.success and response.data: print("GPS Position:") print("Latitude:", response.data.latitude) print("Longitude:", response.data.longitude) print("Altitude:", response.data.altitude) else: print("Error:", response.errors) ```

Contributing

If you want to contribute to Ponika, feel free to open a pull request on the GitHub repository. Contributions are welcome!

The project is setup to use uv for development and requires prior installation. Once you've cloned the repository, you can set up the development environment by running:

bash uv sync

To run the tests, you can use the following command, updating the environment variables as needed:

```bash

Required variables

---------------------

export TELTONIKAHOST=192.168.1.1 export TELTONIKAUSERNAME=admin export TELTONIKA_PASSWORD=password

Optional variables

---------------------

Enables SMS sending tests

export MOBILE_NUMBER=441234567890

Run the tests

uv run pytest ```