Skip to main content

ackmetton

A base library for robotics, unmanned vehicles, and automation — compatible with Python and MicroPython.

ackmetton provides a modular, reusable foundation of math primitives, control algorithms, logging, and platform abstraction designed to run the same code across CPython and MicroPython environments with minimal friction.

Features

Math Library (ackmetton.mathlib)

Component Description
clamp, map, deadzone, low_pass, amplitude_impedance Utility functions for signal conditioning and filtering
sin, cos, acos Convenience wrappers around math
Vector2 2D vector with arithmetic, magnitude, normal, unit, dot, cross
Vector3 3D vector with arithmetic, magnitude, normal, unit, dot, cross
Basis Orthonormal basis container (3×3)
Quaternion Full quaternion algebra — multiplication, conjugation, rotation, axis-angle construction, Euler angles, rotation matrix, basis extraction
PID Proportional-Integral-Derivative controller with integral clamping, set-point tracking, and reset

Utilities (ackmetton.utils)

Component Description
TimeStamp High-resolution timing with configurable unit mask, delta measurement

Base Classes (ackmetton.base)

Component Description
Base Root class with name attribute shared by all library classes
Logger File-based logging with leveled output, auto-rotating directory creation
LogWrap Proxy that forwards log calls scoped to an object name
Printer Timestamped console printer with configurable output level
Logged Combined logging + printing class that bridges Logger and Printer

Platform Abstraction (ackmetton.platform)

Function Description
is_micropython() Detect MicroPython runtime
is_python() Detect CPython on Linux

Enums (ackmetton.enums)

Enum Description
FEED_LEVELS Log/print severity levels (NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL)

Requirements

  • Python ≥ 3.14 or MicroPython (any version)
  • No external dependencies

Installation

pip install ackmetton

Or copy src/ackmetton/ directly into your project for embedded/MicroPython targets.

Installing from source

git clone https://github.com/<your-org>/ackmetton.git
cd ackmetton
pip install .

Quick Start

from ackmetton.mathlib import Vector3, Quaternion, PID, clamp

# Vector math
v = Vector3(1, 2, 3) + Vector3(4, 5, 6)
print(v.normal())

# Quaternion rotation
q = Quaternion.from_axis_angle(90, Vector3(0, 1, 0))

# PID control
pid = PID(kp=2.0, ki=0.1, kd=0.05, set_point=100)
output = pid.update(measured_value=85, dt=0.01)

MicroPython Compatibility

ackmetton is designed for cross-platform use. Modules that rely on CPython stdlib (notably Logger which uses logging) raise a clear ImportError when imported on MicroPython. All other modules — mathlib, utils, platform, enums, and the core Base/Printer classes — work unchanged on MicroPython.

Project Structure

src/
└── ackmetton/
    ├── __init__.py
    ├── base.py        # Base, Logger, LogWrap, Printer
    ├── enums.py       # FEED_LEVELS
    ├── mathlib.py     # Math utilities, vectors, quaternions, PID
    ├── platform.py    # is_micropython(), is_python()
    └── utils.py       # TimeStamp

License

MIT

Metadata

Release files for ackmetton 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ackmetton 0.1.1
File Size Uploaded Provenance Actions
ackmetton-0.1.1.tar.gz 11.8 kB With provenance Details for ackmetton-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ackmetton 0.1.1
File Interpreter ABI Platform Actions
ackmetton-0.1.1-py3-none-any.whl Python 3 none any Details for ackmetton-0.1.1-py3-none-any.whl

Total release size: 23.3 kB

Release files / ackmetton-0.1.1.tar.gz

Download URL ackmetton-0.1.1.tar.gz
Size 11.8 kB
Tags Source
SHA-256 checksum
How to use checksums
11e470806b2d3ae328f91b4e7e8c30a3e446f7af7e6fe9caae94907428f19506
BLAKE2b-256 checksum
How to use checksums
90486c9aba6a944661a58ed35628ad89b7955d884f4939bffe255621c538485b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 2, 2026.

Transparency log

Release files / ackmetton-0.1.1-py3-none-any.whl

Download URL ackmetton-0.1.1-py3-none-any.whl
Size 11.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f0dab786232299a10beb563c2cb22224a528a2b13142e8660a40d1df225a4bc9
BLAKE2b-256 checksum
How to use checksums
e7d81b010f7ad51cc7e79ba42016703d527af8315ba30991f9f22d74b66d7982
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 2, 2026.

Transparency log

Security for ackmetton 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ackmetton-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page