seecr-stdlib 0.6.4__tar.gz

seecr_stdlib-0.6.4/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+# Publishes when a MAJOR.MINOR.PATCH tag (e.g. 0.6.4) is pushed. The tag
+# becomes the package version via setuptools_scm.
+on:
+  push:
+    tags: ["[0-9]+.[0-9]+.[0-9]+"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/seecr-stdlib/
+    permissions:
+      id-token: write  # PyPI trusted publishing, no API token needed
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

seecr_stdlib-0.6.4/.github/workflows/test.yml

@@ -0,0 +1,22 @@
+name: Tests
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0  # setuptools_scm needs the tags
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e .
+      - run: python -m pytest

seecr_stdlib-0.6.4/.gitignore

@@ -0,0 +1,5 @@
+env/
+*.egg-info/
+dist/
+__pycache__/
+.pytest_cache/

seecr_stdlib-0.6.4/CLAUDE.md

@@ -0,0 +1,30 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+`seecr-stdlib` is a small Python (>=3.11) utility library shared across Seecr projects: `Dict` (attribute-access dict), `first`, `Config` (dotted-path JSON config access), `time` helpers (UTC/local conversion), and `format.format_date` (date formatting styles, usable as a Jinja filter). Runtime dependencies are only `python-dateutil` and `pytest`.
+
+## Commands
+
+A virtualenv lives in `env/`.
+
+```sh
+env/bin/python -m pytest                                          # all tests
+env/bin/python -m pytest seecr_stdlib/config_test.py              # one file
+env/bin/python -m pytest seecr_stdlib/dict_test.py::test_dict     # one test
+```
+
+Formatting follows black (isort is configured with `profile = "black"`).
+
+## Conventions
+
+- Tests sit next to the module they test as `<module>_test.py` (not in a separate `tests/` dir), written as plain pytest functions, often with `@pytest.mark.parametrize`.
+- Every source file starts with the GPLv3 `## begin license ## ... ## end license ##` header (template data in `doc/license.conf`). Copy it into new files and keep the copyright year(s) current.
+- Versions come from git tags via `setuptools_scm` (tags like `0.6.3`); `seecr_stdlib/_version.py` is generated and git-ignored — don't edit it.
+- Pushing a version tag to GitHub publishes that version to PyPI (`.github/workflows/publish.yml`), and PyPI never accepts a version twice. Don't push tags unless asked.
+- Only `Dict` and `first` are re-exported from the package root; other modules are imported by path (`seecr_stdlib.config`, `seecr_stdlib.time`, `seecr_stdlib.format`).
+- `format_date` dispatches through the `styles` dict in `format/date.py`; add new styles (and their short aliases like `nl-t`) there. Unknown styles fall back to ISO date. Dutch styles convert aware datetimes to `Europe/Amsterdam` when showing time.
+- `Config(path)` is deprecated in favour of `Config.read(path, ...)`; `Config.get` resolves dotted keys including list indices (`"a.values.0"`), returning `default` for missing/`None` values.
+- `Dict` deliberately never lets keys shadow dict methods and refuses attribute-assignment of method names; preserve that behaviour.