xaeian 0.3.0

Python utilities for files, strings, time, serial, structs, and database

xaeian

Python utilities. Zero dependencies for core. Optional extras for time, serial, media, database.

Install

pip install xaeian            # core
pip install xaeian[time]      # + pytz, tzlocal
pip install xaeian[serial]    # + pyserial
pip install xaeian[mf]        # + pypdf, PyMuPDF, Pillow
pip install xaeian[db]        # + pymysql, psycopg2
pip install xaeian[db-async]  # + aiomysql, asyncpg, aiosqlite
pip install xaeian[all]       # everything

Examples

from xaeian import FILE, JSON, CSV, logger, split_str, generate_password
from xaeian.xtime import Time
from xaeian.crc import crc16_modbus
from xaeian.db import Database

# Files: auto extension, context-based paths
JSON.save("config", {"debug": True, "port": 8080})
CSV.save("users", [{"name": "Jan", "age": 30}, {"name": "Anna", "age": 25}])

# Time: parse anything, arithmetic with strings
t = Time("2025-03-01") + "2w 3d"
t.round("w")  # Monday 00:00
t.to("iso")   # "2025-03-17T00:00:00+01:00"

# CRC: encode/decode with Modbus, ISO, custom
frame = crc16_modbus.encode(b"\x01\x03\x00\x00\x00\x0A")
assert crc16_modbus.decode(frame) is not None

# String tools
split_str('a,"b,c",d', sep=",")  # ['a', '"b,c"', 'd']
generate_password(16)            # 'aB3$xY9!mN2@pQ7&'

# Database: sqlite/mysql/postgres, sync/async
db = Database("sqlite", "app.db")
db.insert("users", {"name": "Jan", "settings": {"theme": "dark"}})
db.find("users", order="name", limit=10)
async with db.transaction():
  db.update("users", {"verified": True}, "id = ?", 42)

# Media: compress, strip metadata
from xaeian.mf.min import compress
compress("report.pdf")            # → report-min.pdf
compress("photos/", max_px=1280)  # → photos-min/ (recursive)

# Logging: colored, rotating
log = logger("app", file="app.log")
log.info("started")  # 2025-03-01 14:32:01 INF started

Modules

Module	Description	Docs
files	FILE, DIR, PATH, JSON, CSV, INI	xaeian/readme.md
files_async	Async wrappers via asyncio.to_thread()	xaeian/readme.md
table	Lightweight tabular ops on list[dict]	xaeian/readme.md
xstring	Split, replace, strip comments, passwords	xaeian/readme.md
xtime	Datetime parsing, arithmetic, rounding	xaeian/readme.md
colors	ANSI 256-color terminal codes	xaeian/readme.md
log	Colored logging with file rotation	xaeian/readme.md
crc	CRC-8/16/32 with predefined variants	xaeian/readme.md
cstruct	Binary struct serialization (C-like)	xaeian/readme.md
cmd	Shell command helpers	xaeian/readme.md
serial_port	Serial communication with colored output	xaeian/readme.md
cbash	Embedded device console protocol	xaeian/readme.md
mf	Compress, convert, strip metadata (PDF & images)	xaeian/mf/readme.md
db	Database abstraction (SQLite, MySQL, PostgreSQL)	xaeian/db/readme.md
eda	E-series, KiCad production export	xaeian/eda/readme.md
cli	tree, dupes, wifi scripts	xaeian/cli/readme.md