astrobasis 0.1.0

Pure mechanism layer for the Astro ecosystem — zero hard dependencies

astrobasis 天枢

Pure mechanism layer for the Astro ecosystem. Zero hard dependencies beyond Python 3.12 stdlib.

Install

pip install astrobasis

For JSON performance acceleration:

pip install astrobasis[fast]

Or from source:

pip install -e .

What's inside

Module	Purpose
_logging	Structured logfmt logging — mandatory event field, key=value output
_atomic	POSIX atomic file writes — mkstemp → fsync → os.replace
_json_compat	orjson / stdlib json compatibility layer with graceful fallback
_types	Shared protocols — AsyncCloseable for async resource lifecycle

Usage

Structured logging

from astrobasis import LogfmtLogger

logger = LogfmtLogger("my_module")
logger.info("request_complete", url="https://example.com", status=200)
# → ts=2026-07-17T... level=INFO logger=my_module event=request_complete url=https://example.com status=200

Atomic file writes

from astrobasis import atomic_write_json

data = {"key": "value", "nested": [1, 2, 3]}
atomic_write_json("/path/to/config.json", data)
# POSIX atomic: write to temp → fsync → os.replace. Concurrent reads always see complete data.

JSON compatibility

from astrobasis import _json_dumps

data = {"items": ["a", "b", "c"]}
result = _json_dumps(data)
# Uses orjson if installed (`pip install astrobasis[fast]`), stdlib json otherwise.

Async resource protocol

from astrobasis import AsyncCloseable

class MyResource(AsyncCloseable):
    async def aclose(self) -> None:
        await self._client.close()

License

Apache 2.0