xaeian 0.2.0

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

xaeian

Python utilities for files, strings, time, serial, structs, media, PDF, and database. Zero dependencies for core modules. Optional extras for time, serial, media, PDF, and database backends.

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[pdf]       # + reportlab, svglib, Pillow
pip install xaeian[db]        # + pymysql, psycopg2
pip install xaeian[db-async]  # + aiomysql, asyncpg, aiosqlite
pip install xaeian[all]       # everything

Modules

Module	Description	Docs
files	FILE, DIR, PATH, JSON, CSV, INI	xaeian/files.py
files_async	Async wrappers via asyncio.to_thread()	xaeian/files_async.py
xstring	split, replace, strip comments, passwords	xaeian/xstring.py
xtime	Datetime parsing, arithmetic, rounding	xaeian/xtime.py
colors	ANSI 256-color terminal codes	xaeian/colors.py
log	Colored logging with file rotation	xaeian/log.py
crc	CRC-8/16/32 with predefined variants	xaeian/crc.py
cstruct	Binary struct serialization (C-like)	xaeian/cstruct.py
cmd	Shell command helpers	xaeian/cmd.py
mf	Compress, convert, strip metadata (PDF & images)	xaeian/mf/
pdf	PDF generation with fluent API	xaeian/pdf/
serial_port	Serial communication with colored output	xaeian/serial_port.py
cbash	Embedded device console protocol	xaeian/cbash.py
db	Database abstraction (SQLite, MySQL, PostgreSQL)	xaeian/db/

Quick Start

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

# File operations
config = JSON.load("config")
CSV.save("export", [{"name": "Jan", "score": 95}, {"name": "Anna", "score": 88}])
# Time arithmetic
deadline = Time("2025-03-01") + "2w" # + 2 weeks
if Time() > deadline:
  print("Overdue!")
# CRC protection
frame = crc16_modbus.encode(b"\x01\x03\x00\x00\x00\x0A")
if crc16_modbus.decode(frame):
  print("Valid Modbus frame")
# Colored logging
log = logger("app", file="app.log", color=True)
log.info(f"New password: {generate_password(16)}")

Media files:

from xaeian.mf.min import compress
from xaeian.mf.meta import scrub_metadata

compress("report.pdf")              # → report-min.pdf
compress("photo.jpg", max_px=1280)  # → photo-min.jpg
scrub_metadata("photo.jpg")         # → photo-nometa.jpg

PDF generation:

from xaeian.pdf import PDF

with PDF("output.pdf") as pdf:
  pdf.font("Helvetica", 16, "Bold")
  pdf.text("Hello World")
  pdf.enter()
  pdf.font(size=12, mode="Regular")
  pdf.text("Second line of text.")

Database example:

from xaeian.db import Database

db = Database("sqlite", "app.db")
db.insert("users", {"name": "Jan", "email": "[e-mail]"})
user = db.find_one("users", name="Jan")
users = db.find("users", order="name", limit=10)
with db.transaction():
  db.update("users", {"verified": True}, "id = ?", user["id"])
  db.insert("logs", {"action": "verify", "user_id": user["id"]})