ctek 0.0.2

Python library to interact with multiple CTEK products through their open API:s

ctek-py

About

This library provides a set of friendly classes and functions to interact with CTEK products through Python.

Currently supported devices

NANOGRID™ AIR - ✅

Installation

Simply install using pip

pip install ctek

Usage

Products can be interacted with through classes of the same name as the product

from ctek import NanogridAir

nanogrid_air = NanogridAir()

status = nanogrid_air.get_status()

Build and Test

The recommended way is to use the provided Dev Container, which will set up everything for you. This includes installing all the necessary dependencies, installing pre-commit hooks, and setting up the development environment with recommended tools and extensions, as well as environment variables. All source code will be mounted into the container automatically on start and config files such as .gitconfig will be inherited. You are up and running in no time. For more info see the dev container configuration file .devcontainer/devcontainer.json and the Dev Container documentation.

Dev Container (Recommended)

Required tools include:

• Visual Studio Code
• Docker
• Dev Containers extension

If on Windows, you will also need to install the Windows Subsystem for Linux 2 and a Linux distribution such as Ubuntu. It is recommended to clone the repository directly into WSL since this will increase the performance of the dev container. After cloning and cd'ing into the project folder, you can open the project in VS Code by running code . in the WSL terminal.

Open VS Code and you will be prompted with a notification in the bottom right corner of the window to reopen the project in a dev container.

Alternatively you can open the command palette (Ctrl+Shift+P) and run the Dev Containers: Reopen in Container or Dev Containers: Rebuild and Reopen in Container command.

PDM only (Alternative)

Required tools include:

• PDM

If you want to develop directly on your machine without depending on either Visual Studio Code or Docker you can straight up install PDM, the development dependencies and setup pre-commit by running the following command:

# git clone
# cd into the project folder
pdm sync -G dev && pdm run pre-commit install

Run all tests

To run testing, linting and building of the project you can run the following command:

pdm run all