xakki-log-python 0.4.0__tar.gz

xakki_log_python-0.4.0/.env_dist

@@ -0,0 +1,8 @@
+PYTHON_IMAGE=harbor.xakki.ru/external/python:3.13-slim
+TAG=pylog-py:3.13
+HOST=docker.io
+DOCKER_USER=xakki
+DOCKER_PASS=
+DOCKER_CPUS=2
+DOCKER_MEMORY=1g
+UV_PUBLISH_TOKEN=

xakki_log_python-0.4.0/.gitattributes

@@ -0,0 +1,16 @@
+.git export-ignore
+.github export-ignore
+.idea export-ignore
+.claude export-ignore
+tests export-ignore
+ruff.toml export-ignore
+mypy.ini export-ignore
+pytest.ini export-ignore
+Makefile export-ignore
+Dockerfile export-ignore
+.env_dist export-ignore
+uv.lock export-ignore
+poetry.lock export-ignore
+pdm.lock export-ignore
+Pipfile export-ignore
+Pipfile.lock export-ignore

xakki_log_python-0.4.0/.github/workflows/autotest.yml

@@ -0,0 +1,36 @@
+name: Autotest
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    name: Python ${{ matrix.python }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.11', '3.12', '3.13']
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install dependencies
+        run: pip install --no-cache-dir .[dev]
+
+      - name: Run CodeStyle check
+        run: |
+          ruff format --check .
+          ruff check .
+
+      - name: Run mypy
+        run: mypy
+
+      - name: Run pytest
+        run: pytest

xakki_log_python-0.4.0/.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+name: Publish to PyPI
+on:
+  push:
+    tags: ['v*']
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - name: Build sdist and wheel
+        run: pip install --no-cache-dir build && python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # Trusted Publishing (OIDC), no token stored
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # create the release and attach dist files
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: >
+          gh release create "$GITHUB_REF_NAME" dist/*
+          --repo "$GITHUB_REPOSITORY"
+          --title "$GITHUB_REF_NAME"
+          --generate-notes

xakki_log_python-0.4.0/.gitignore

@@ -0,0 +1,15 @@
+/.idea
+/.venv
+__pycache__/
+*.py[cod]
+/.env
+/dist
+/build
+*.egg-info
+.ruff_cache
+.mypy_cache
+.pytest_cache
+.coverage
+/.pdm-python
+/.claude/settings.local.json
+/.agents

xakki_log_python-0.4.0/AGENTS.md

@@ -0,0 +1,65 @@
+# AGENTS.md — xakki-log-python
+
+Python structured-logging library (dist `xakki-log-python`, import `log_python`,
+src-layout `src/log_python/`). Port of PHP/Laravel `xakki/log-laravel` at
+`/home/xakki/libs/log-laravel` — that repo is the normative reference for BOTH
+structure and semantics. Its `docs/LoggingRules.md` and
+`docs/ContextFieldNaming.md` are the language-agnostic spec this port must
+conform to; `docs/PhytonLog.md` covers the fluent-bit/Graylog ingestion path.
+The spec is read from there (linked from `Readme.md`) and is deliberately NOT
+copied into this repo — do not propose porting `docs/`.
+
+**Status: phases 0–9 implemented.** Core enrichment, formatters,
+`log_python.setup()`, exception hooks, context binding, Redis/SQLAlchemy extras and
+heartbeat are present. `TODO.md` is the release handoff and records remaining
+owner/operator actions. The historical `.claude/` plan is staged for deletion;
+do not unstage or re-add it without owner direction.
+
+## Docker-only — no bare-host toolchain
+
+Every operation goes through a `make` target — never invoke bare
+`python`/`pip`/`pytest`/`ruff`/`mypy`/`uv`/`poetry`/`pdm`/`pipenv` on the
+host. Missing target → add it to the Makefile, don't run the tool directly.
+Every `docker run`, including one-off containers, needs both `--cpus` and
+`--memory`.
+
+## Field-name/type stability contract
+
+A context field name must never emit two different JSON types across
+services — OpenSearch silently drops the whole document on a type mismatch.
+This is why the context type-coercion rules (suffix-driven `*_int` /
+`*_float` / `*_bool` escape hatches, whole-segment matching, snake_case)
+must be ported 1:1 from the reference, and are covered by a large
+parametrized test table. Do not "simplify" this logic.
+
+## Never grow a lint/type baseline
+
+mypy runs `--strict` with no baseline; ruff has no suppression file. Fix the
+code, don't silence the checker. Adding any baseline/ignore file requires
+explicit owner approval.
+
+## Secrets never get logged
+
+Redaction (see reference `src/Redactor.php`) is a security-critical code
+path. Any change to it needs tests proving the secret value never appears
+in output.
+
+## Before finishing
+
+`make test` green (cs-check + mypy + pytest). If packaging metadata changed,
+also run `make test-install`; before release also run `make build`.
+
+## Local skills
+
+Project-local skills live in `.agents/skills/<name>/SKILL.md` (gitignored, so
+present only in the owner's checkout). Read before the matching work:
+
+- `release-pypi` — cutting and verifying a release (`make release-publish`,
+  `make pypi-verify`, Trusted Publishing, PyPI index lag).
+- `agent-session-gotchas` — hook and Docker-only pitfalls when running commands.
+
+## No-touch
+
+`.env` (registry creds), the four lock files (`uv.lock`, `poetry.lock`,
+`pdm.lock`, `Pipfile.lock` — regenerate via `make lock`, never hand-edit),
+`LICENSE`.

xakki_log_python-0.4.0/Dockerfile

@@ -0,0 +1,11 @@
+ARG PYTHON_IMAGE=harbor.xakki.ru/external/python:3.13-slim
+FROM ${PYTHON_IMAGE}
+
+WORKDIR /app
+
+RUN pip install --no-cache-dir uv \
+    && rm -rf /root/.cache/pip
+
+STOPSIGNAL SIGKILL
+
+##CMD tail -f /var/log/*.log -n 5