pinky-core 0.1.0.dev5__tar.gz → 0.1.0.dev6__tar.gz

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/.github/workflows/ci.yml

@@ -11,6 +11,12 @@ jobs:
     runs-on: ubuntu-latest
     env:
       FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    # Explicite, alors que le défaut d'org est déjà `read` : ce défaut est un réglage
+    # d'organisation, invisible du fichier et modifiable sans toucher aucun repo. Le déclarer ici
+    # rend le workflow immunisé si ce défaut repasse un jour en `write` (règle CodeQL
+    # actions/missing-workflow-permissions, 14 alertes sur l'org au scan 2026-07-25).
+    permissions:
+      contents: read
 
     steps:
       - uses: actions/checkout@v4
@@ -43,6 +49,8 @@ jobs:
     # ADR-0023 pilot gate: hermetic pre-commit hooks must run on the brother's
     # machine (Windows, prek only, no toolchain) — this is the real gate, not the Mac.
     runs-on: windows-latest
+    permissions:
+      contents: read
     strategy:
       matrix:
         shell: [cmd, pwsh]

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/.pre-commit-config.yaml

@@ -52,6 +52,28 @@ repos:
         stages: [pre-commit]
         pass_filenames: false
 
+  # ── Test suite: the blocking quality gate ─────────────────────────────────
+  # Universal, NOT the `python` extra (moved 2026-07-25, same day it was introduced). The first
+  # placement rested on an unverified assumption — "the repos outside the python extra have no test
+  # suite". Measured: pinky-workspace, the engine itself, carries 25 test files / 264 tests, and
+  # pinky-studio carries tests with NO CI at all. Only assets/infra have no tests/ directory, and
+  # the hook's own `[ -d tests ]` guard makes those a real no-op.
+  #
+  # Before this hook, the only test execution at commit time was the one buried inside generate-docs
+  # feeding the coverage badge, whose failure printed a warning and returned 0 — a broken suite
+  # passed pre-commit. generate-docs keeps its own run for the badge data and stays non-blocking;
+  # this hook owns the verdict. See core/hooks/run-tests for why the two runs stay independent, and
+  # why an absent pytest warns instead of blocking.
+  - repo: local
+    hooks:
+      - id: run-tests
+        name: "[TESTS] Suite must pass"
+        entry: scripts/hooks/run-tests
+        language: script
+        files: ^(src|tests)/
+        pass_filenames: false
+        stages: [pre-commit]
+
   # ── Formatting: Markdown ──────────────────────────────────────────────────
   - repo: local
     hooks:

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pinky-core
-Version: 0.1.0.dev5
+Version: 0.1.0.dev6
 Summary: Shared Python utilities for Snowflake development
 Project-URL: Homepage, https://github.com/pinky-and-co/pinky-core
 Project-URL: Repository, https://github.com/pinky-and-co/pinky-core
@@ -159,7 +159,8 @@ pinky-core/
 │   │   ├── docs_identity.json
 │   │   ├── generate-docs
 │   │   ├── generate_ci_badges.py
-│   │   └── render_docs.py
+│   │   ├── render_docs.py
+│   │   └── run-tests
 │   └── deploy_validate_udfs.py
 ├── sql/
 │   └── deploy_udf_example.sql

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/README.md

@@ -99,7 +99,8 @@ pinky-core/
 │   │   ├── docs_identity.json
 │   │   ├── generate-docs
 │   │   ├── generate_ci_badges.py
-│   │   └── render_docs.py
+│   │   ├── render_docs.py
+│   │   └── run-tests
 │   └── deploy_validate_udfs.py
 ├── sql/
 │   └── deploy_udf_example.sql

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/docs/reference/generated/coverage_badge.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 84.34%"><title>coverage: 84.34%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">84.34%</text><text x="865" y="150" fill-opacity=".3" textLength="430">84.34%</text></g><text x="865" y="140" textLength="430">84.34%</text></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 84.32%"><title>coverage: 84.32%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">84.32%</text><text x="865" y="150" fill-opacity=".3" textLength="430">84.32%</text></g><text x="865" y="140" textLength="430">84.32%</text></g></g></svg>

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/docs/reference/generated/hooks_badge.svg

@@ -1,12 +1,12 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="81" height="20">
-  <title>generate-docs · mdformat · check-zws · check-forbidden-keywords · commit-msg-format · mypy · interrogate · darglint · check-typed-api · check-weak-assertions · check-snowpark-api</title>
+  <title>generate-docs · run-tests · mdformat · check-zws · check-forbidden-keywords · commit-msg-format · mypy · interrogate · darglint · check-typed-api · check-weak-assertions · check-snowpark-api</title>
   <rect width="81" height="20" rx="3" fill="#555"/>
   <rect x="50" width="31" height="20" rx="3" fill="#007ec6"/>
   <rect x="50" width="4" height="20" fill="#007ec6"/>
   <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
     <text x="25" y="15" fill="#010101" fill-opacity=".3">hooks</text>
     <text x="25" y="14">hooks</text>
-    <text x="65" y="15" fill="#010101" fill-opacity=".3">11</text>
-    <text x="65" y="14">11</text>
+    <text x="65" y="15" fill="#010101" fill-opacity=".3">12</text>
+    <text x="65" y="14">12</text>
   </g>
 </svg>

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pinky-core"
-version = "0.1.0.dev5"
+version = "0.1.0.dev6"
 description = "Shared Python utilities for Snowflake development"
 readme = "README.md"
 license = { file = "LICENSE" }

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/scripts/hooks/check_weak_assertions.py

@@ -29,10 +29,11 @@ CHANGED files, so main() builds the covered set by scanning every `.py` under th
 of the passed paths, not just argv. check_file() stays per-file (the testable unit of the AST
 scan); main() is the layer that applies the repo-wide covered set.
 
-Generators are matched BY NAME only (assumed hole, decided 2026-07-24): a badly-named generator
-escapes the ratchet — it is not blocked, merely unguarded. Widening to "returns markup" was
-rejected: it reopens the false positives the audit eliminated. (`html.py`'s `dl_card`/`task_table`
-were the audit's found instances — renamed `render_dl_card`/`render_task_table` to close the hole.)
+Generators are matched BY NAME only (assumed hole, decided 2026-07-24): a function that builds
+output but is named without a convention prefix/suffix escapes the ratchet — not blocked, merely
+unguarded. The intended fix is to NAME it as a generator (tests.md § generator oracle requires it),
+not to widen the matcher — widening to "returns markup" was rejected: it reopens the false positives
+the audit eliminated.
 
 Usage (pre-commit local hook):
   entry: python scripts/hooks/check_weak_assertions.py

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/scripts/hooks/generate-docs

@@ -23,6 +23,10 @@
 # `coverage run -m pytest --no-cov` (not pytest-cov's own instrumentation) — editable-install
 # path setups (multiple repos' src/ on sys.path at once) can make pytest-cov silently measure
 # nothing ("module-not-measured") with no visible error; wrapping externally sidesteps that.
+#
+# Coverage badge reliability fix #2 (2026-07-25): that 2026-07-12 pass fixed the *data* (stale
+# .coverage) but left the *tool* resolved off the bare PATH while $PY was resolved out of .venv —
+# same class of bug, one line lower. See the comment at the genbadge block below.
 # =============================================================================
 
 # 0. Interpréteur — résolu explicitement, jamais `python` nu (2026-07-22). `python` n'existe ni dans
@@ -73,14 +77,28 @@ if [ "$SRC_STAGED" -gt 0 ]; then
     COV_LOG=$(mktemp)
     if $PY -m coverage run -m pytest -q --no-cov > "$COV_LOG" 2>&1; then
         $PY -m coverage xml -o .cache/coverage/coverage.xml > /dev/null 2>&1
-        if command -v genbadge > /dev/null 2>&1; then
-            genbadge coverage -i .cache/coverage/coverage.xml -o docs/reference/generated/coverage_badge.svg > /dev/null 2>&1
+        # genbadge est un console-script : le chercher dans le venv du projet AVANT le PATH, même
+        # ladder que $PY plus haut (2026-07-25). Le lookup PATH nu a gelé le badge de pinky-connect
+        # six semaines à 77.03% alors que genbadge était bien installé dans .venv — c'est le PATH
+        # qui ne le portait pas. Il a fini par « marcher » par accident, l'env uv d'un repo sans
+        # rapport (pinky-airflow) s'étant retrouvé en tête de PATH : le vrai chiffre était 18.28%.
+        if [ -x .venv/bin/genbadge ]; then GB=".venv/bin/genbadge"                    # POSIX
+        elif [ -x .venv/Scripts/genbadge.exe ]; then GB=".venv/Scripts/genbadge.exe"  # Windows
+        elif command -v genbadge > /dev/null 2>&1; then GB="genbadge"
+        else GB=""
+        fi
+        if [ -n "$GB" ]; then
+            "$GB" coverage -i .cache/coverage/coverage.xml -o docs/reference/generated/coverage_badge.svg > /dev/null 2>&1
             git add docs/reference/generated/coverage_badge.svg 2>/dev/null
         else
-            echo "⚠ coverage_badge.svg not regenerated: 'genbadge' not installed — pip install -e '.[dev]'" >&2
+            echo "⚠ coverage_badge.svg not regenerated: 'genbadge' not found (.venv nor PATH) — uv sync --group dev" >&2
         fi
     else
-        echo "⚠ coverage_badge.svg not regenerated: test run failed, see $COV_LOG" >&2
+        # Depuis 2026-07-25 le verdict pass/fail appartient au hook run-tests (extra python), qui
+        # bloque le commit en amont — arriver ici veut dire que la suite passe en bare pytest mais
+        # casse sous instrumentation coverage, ou que run-tests n'est pas actif sur ce repo. On
+        # reste non bloquant (ce hook fait des docs, pas de la garde qualité) mais on le dit.
+        echo "⚠ coverage_badge.svg not regenerated: coverage run failed, see $COV_LOG" >&2
     fi
 
     $PY scripts/hooks/generate_ci_badges.py --noqa > /dev/null 2>&1

pinky_core-0.1.0.dev6/scripts/hooks/run-tests

@@ -0,0 +1,67 @@
+#!/bin/bash
+# =============================================================================
+# PRE-COMMIT HOOK — run-tests (2026-07-25)
+# =============================================================================
+# Distributed from pinky-workspace/core/hooks/ — do not edit in place. Declared in
+# core/pre-commit/base.yaml (universal, `files: ^(src|tests)/`), NOT in the `python` extra.
+#
+# An earlier version of this header claimed the opposite ("extra `python` only … NOT in base.yaml —
+# that one … would declare a pytest hook on studio/assets/infra/workspace, four repos with no test
+# suite at all"). Both halves were false and the second one bit: **10 of the 13 repos carry a
+# tests/ dir**, studio included — so the `[ -d tests ] || exit 0` guard below never fired for it,
+# and every studio commit touching src/ or tests/ was blocked (2026-07-25). Keep this header in
+# sync with base.yaml: a stale comment here is what justified the wrong placement in the first
+# place (see core/rules/base/verify-diagnosis.md — a written cause is a hypothesis).
+#
+# Why this hook exists separately from generate-docs: until now the ONLY execution of the test suite
+# at commit time was the one buried inside generate-docs to produce the coverage badge's data, and
+# its failure printed a warning on stderr then returned 0 — a commit touching src/ with a broken
+# suite passed pre-commit, the warning lost among ~20 other hooks' output. Separation of concerns:
+# generate-docs does docs (non-blocking, cosmetic output), run-tests guards quality (blocking).
+#
+# The two runs stay INDEPENDENT rather than sharing coverage data through a file. Measured
+# 2026-07-25: each suite takes 0-3s, so the double run costs ~3s at worst — far cheaper than the
+# risk of an inter-hook artifact going silently stale. That exact coupling (trusting a pre-existing
+# .coverage) is what froze pinky-connect's badge for six weeks; see the generate-docs header.
+# =============================================================================
+
+# Interpreter — resolved explicitly, never a bare `python`. Same ladder as generate-docs: the
+# project venv first (the test suite needs the repo's own dependencies, which a system python3
+# does not have), then the system fallbacks.
+if [ -x .venv/bin/python ]; then PY=".venv/bin/python"                    # POSIX
+elif [ -x .venv/Scripts/python.exe ]; then PY=".venv/Scripts/python.exe"  # Windows
+elif command -v python3 > /dev/null 2>&1; then PY="python3"
+elif command -v py > /dev/null 2>&1; then PY="py -3"
+else
+    echo "⚠ run-tests: aucun interpréteur Python (.venv / python3 / py) — tests non exécutés" >&2
+    exit 0
+fi
+
+# Pas de suite de tests → rien à garder. Cible « template light » du chantier 0001 : un repo cloné
+# sans tests ne doit pas voir ses commits bloqués par un hook qui n'a rien à exécuter.
+[ -d tests ] || exit 0
+
+# pytest indisponible → on ne bloque pas. Ce garde devient indispensable depuis que le hook est
+# déclaré dans base.yaml (2026-07-25) et non plus dans le seul extra `python` : un repo qui a un
+# dossier tests/ mais pas les extras dev verrait `$PY -m pytest` sortir non-zéro (« No module named
+# pytest ») et se retrouverait avec TOUS ses commits bloqués. Même posture permissive que le
+# fallback genbadge de generate-docs — un outil de dev absent est une machine mal équipée, pas un
+# test qui échoue.
+if ! $PY -c "import pytest" > /dev/null 2>&1; then
+    echo "⚠ run-tests: pytest non installé — tests non exécutés" >&2
+    exit 0
+fi
+
+# --no-cov : l'instrumentation coverage est le travail de generate-docs, pas le nôtre — ici on veut
+# le verdict pass/fail le plus rapide possible.
+# Pas de `-p no:cacheprovider` : les repos configurent déjà `cache_dir = ".cache/pytest"` en
+# pyproject, donc rien ne salit l'arbre — et désactiver le plugin rend ce réglage inconnu, ce qui
+# fait cracher un PytestConfigWarning à chaque commit (mesuré sur pinky-tools, 2026-07-25).
+if ! $PY -m pytest -q --no-cov; then
+    echo "" >&2
+    echo "✖ run-tests: la suite de tests échoue — commit bloqué." >&2
+    echo "  Corrige les tests, ou --no-verify si le WIP est délibéré." >&2
+    exit 1
+fi
+
+exit 0

pinky_core-0.1.0.dev6/src/pinky_core/__init__.py

@@ -0,0 +1,132 @@
+"""
+pinky_core
+=============
+Core Python utilities for Snowflake development.
+
+Modules
+-------
+files     File pattern normalization for S3 and MFT path analysis.
+finance   French accounting file formats (FEC parser).
+fmt       Pure formatting helpers (text, dates, numbers, FR addresses).
+html      HTML templating engine (emails, reports, mini-sites) — Outlook-safe.
+lint      Delegated tooling for pinky-provider's SQL/secret pre-flight — accessed
+          via ``pinky_core.lint`` directly, never top-level.
+schedule  Business-day calendar (FR) and cron utilities for SPs and DAGs.
+security  Path and identifier sanitisation for safe dynamic SQL.
+sql       SQL parsing helpers powered by sqlglot (Snowflake dialect).
+validate  French/international data validation (email, phone, SIRET, NIR, IBAN/BIC).
+warnings  PinkyDeprecationWarning — deprecated pinky APIs and UDFs.
+xml       XML utilities for Snowflake VARIANT — UDF handlers and helpers.
+
+No Snowflake connection required — importable in any context (CI, local, UDF).
+Optional deps for validate: email-validator, phonenumbers, python-stdnum.
+Optional deps for address:  usaddress.
+Optional deps for schedule: croniter (next_schedule, is_in_schedule).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+# name → module. Les imports sont RÉSOLUS À LA DEMANDE (PEP 562) : un `from pinky_core.security
+# import validate_identifier` exécutait tout ce fichier, donc `pinky_core.sql` → **sqlglot**, et
+# une SP Snowflake qui ne déclare pas ce paquet tombait à l'exécution. Le coût était payé par
+# TOUS les consommateurs — un handler qui veut une fonction de sanitisation n'a pas à embarquer
+# un parseur SQL. Garder ce fichier paresseux.
+_EXPORTS: dict[str, str] = {
+    "AddressComponents": "pinky_core.fmt",
+    "AfnorAddress": "pinky_core.fmt",
+    "EmailLang": "pinky_core.html",
+    "EmailResult": "pinky_core.validate",
+    "EmailTheme": "pinky_core.html",
+    "FecAmountSchema": "pinky_core.finance.fec",
+    "FecBalanceError": "pinky_core.finance.fec",
+    "FecEntry": "pinky_core.finance.fec",
+    "FecParseResult": "pinky_core.finance.fec",
+    "FecRowError": "pinky_core.finance.fec",
+    "FecSens": "pinky_core.finance.fec",
+    "FileDetection": "pinky_core.files",
+    "FrIdResult": "pinky_core.validate",
+    "IbanBicResult": "pinky_core.validate",
+    "NirResult": "pinky_core.validate",
+    "NumType": "pinky_core.fmt",
+    "PhoneResult": "pinky_core.validate",
+    "PinkyDeprecationWarning": "pinky_core.warnings",
+    "TaskRow": "pinky_core.html",
+    "VatResult": "pinky_core.validate",
+    "business_days_between": "pinky_core.schedule",
+    "check_fec_balance": "pinky_core.finance.fec",
+    "cron_to_human": "pinky_core.schedule",
+    "days_until_end_of_month": "pinky_core.schedule",
+    "deduplicate_headers": "pinky_core.fmt",
+    "detect_file_pattern": "pinky_core.files",
+    "extract_table_refs": "pinky_core.sql",
+    "first_business_day_of_month": "pinky_core.schedule",
+    "fiscal_quarter": "pinky_core.schedule",
+    "format_boolean": "pinky_core.fmt",
+    "format_date": "pinky_core.fmt",
+    "format_datetime": "pinky_core.fmt",
+    "format_duration": "pinky_core.fmt",
+    "format_fraction": "pinky_core.fmt",
+    "format_number": "pinky_core.fmt",
+    "format_period": "pinky_core.fmt",
+    "format_stars": "pinky_core.fmt",
+    "format_trend": "pinky_core.fmt",
+    "generate_html": "pinky_core.html",
+    "is_business_day": "pinky_core.schedule",
+    "is_eve_of_holiday": "pinky_core.schedule",
+    "is_even_week": "pinky_core.schedule",
+    "is_in_schedule": "pinky_core.schedule",
+    "is_odd_week": "pinky_core.schedule",
+    "iso3_to_iso2": "pinky_core.fmt",
+    "last_business_day_of_month": "pinky_core.schedule",
+    "next_business_day": "pinky_core.schedule",
+    "next_schedule": "pinky_core.schedule",
+    "normalize_city_fr": "pinky_core.fmt",
+    "normalize_text": "pinky_core.fmt",
+    "nth_business_day_of_month": "pinky_core.schedule",
+    "parse_address": "pinky_core.fmt",
+    "parse_fec": "pinky_core.finance.fec",
+    "period_to_date": "pinky_core.fmt",
+    "public_holidays_fr": "pinky_core.schedule",
+    "render_dl_card": "pinky_core.html",
+    "render_task_table": "pinky_core.html",
+    "resolve_query": "pinky_core.sql",
+    "safe_filepath": "pinky_core.security",
+    "slugify": "pinky_core.fmt",
+    "split_sql_statements": "pinky_core.sql",
+    "standardize_email": "pinky_core.validate",
+    "standardize_phone": "pinky_core.validate",
+    "statement_kind": "pinky_core.sql",
+    "to_camel_case": "pinky_core.fmt",
+    "to_upper_snake_case": "pinky_core.fmt",
+    "validate_iban_bic": "pinky_core.validate",
+    "validate_identifier": "pinky_core.security",
+    "validate_nir": "pinky_core.validate",
+    "validate_siret": "pinky_core.validate",
+    "validate_vat_eu": "pinky_core.validate",
+    "xml_path": "pinky_core.xml",
+    "xml_path_str": "pinky_core.xml",
+}
+
+__all__ = sorted(_EXPORTS)
+
+
+def __getattr__(name: str) -> Any:
+    """Import an export on first access (PEP 562).
+
+    Args:
+        name: The attribute being looked up.
+
+    Returns:
+        The requested object.
+
+    Raises:
+        AttributeError: If the name is not an export of this package.
+    """
+    module_path = _EXPORTS.get(name)
+    if module_path is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    from importlib import import_module
+
+    return getattr(import_module(module_path), name)

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/src/pinky_core/files.py

@@ -61,7 +61,7 @@ def detect_file_pattern(
     """Normalize a filename to a canonical pattern by replacing variable segments.
 
     Replaces dates, timestamps, UUIDs, ISO country codes, structured business
-    identifiers (SIRET, SIREN, IBAN, BIC, VAT), and generic numeric IDs with
+    identifiers (SIRET, SIREN, IBAN, VAT), and generic numeric IDs with
     named placeholders — enabling grouping of structurally similar filenames
     regardless of the specific value they carry.
 

{pinky_core-0.1.0.dev5 → pinky_core-0.1.0.dev6}/uv.lock

@@ -1072,7 +1072,7 @@ wheels = [
 
 [[package]]
 name = "pinky-core"
-version = "0.1.0.dev5"
+version = "0.1.0.dev6"
 source = { editable = "." }
 dependencies = [
     { name = "pydantic" },

pinky_core-0.1.0.dev5/src/pinky_core/__init__.py

@@ -1,221 +0,0 @@
-"""
-pinky_core
-=============
-Core Python utilities for Snowflake development.
-
-Modules
--------
-files     File pattern normalization for S3 and MFT path analysis.
-finance   French accounting file formats (FEC parser).
-fmt       Pure formatting helpers (text, dates, numbers, FR addresses).
-html      HTML templating engine (emails, reports, mini-sites) — Outlook-safe.
-lint      Delegated tooling for pinky-provider's SQL/secret pre-flight — accessed
-          via ``pinky_core.lint`` directly, never top-level.
-schedule  Business-day calendar (FR) and cron utilities for SPs and DAGs.
-security  Path and identifier sanitisation for safe dynamic SQL.
-sql       SQL parsing helpers powered by sqlglot (Snowflake dialect).
-validate  French/international data validation (email, phone, SIRET, NIR, IBAN/BIC).
-warnings  PinkyDeprecationWarning — deprecated pinky APIs and UDFs.
-xml       XML utilities for Snowflake VARIANT — UDF handlers and helpers.
-
-No Snowflake connection required — importable in any context (CI, local, UDF).
-Optional deps for validate: email-validator, phonenumbers, python-stdnum.
-Optional deps for address:  usaddress.
-Optional deps for schedule: croniter (next_schedule, is_in_schedule).
-"""
-
-from __future__ import annotations
-
-# files — pure file pattern normalization, always available
-from pinky_core.files import (
-    FileDetection,
-    detect_file_pattern,
-)
-
-# finance — pure FEC parsing, always available
-from pinky_core.finance.fec import (
-    FecAmountSchema,
-    FecBalanceError,
-    FecEntry,
-    FecParseResult,
-    FecRowError,
-    FecSens,
-    check_fec_balance,
-    parse_fec,
-)
-
-# fmt — pure formatting, always available
-from pinky_core.fmt import (
-    AddressComponents,
-    AfnorAddress,
-    NumType,
-    deduplicate_headers,
-    format_boolean,
-    format_date,
-    format_datetime,
-    format_duration,
-    format_fraction,
-    format_number,
-    format_period,
-    format_stars,
-    format_trend,
-    iso3_to_iso2,
-    normalize_city_fr,
-    normalize_text,
-    parse_address,
-    period_to_date,
-    slugify,
-    to_camel_case,
-    to_upper_snake_case,
-)
-
-# html — pure HTML templating, always available
-from pinky_core.html import (
-    EmailLang,
-    EmailTheme,
-    TaskRow,
-    generate_html,
-    render_dl_card,
-    render_task_table,
-)
-
-# schedule — pure calendar + cron, always available (croniter optional)
-from pinky_core.schedule import (
-    business_days_between,
-    cron_to_human,
-    days_until_end_of_month,
-    first_business_day_of_month,
-    fiscal_quarter,
-    is_business_day,
-    is_eve_of_holiday,
-    is_even_week,
-    is_in_schedule,
-    is_odd_week,
-    last_business_day_of_month,
-    next_business_day,
-    next_schedule,
-    nth_business_day_of_month,
-    public_holidays_fr,
-)
-
-# security — pure sanitisation, always available
-from pinky_core.security import (
-    safe_filepath,
-    validate_identifier,
-)
-
-# sql — pure SQL parsing, always available
-from pinky_core.sql import (
-    extract_table_refs,
-    resolve_query,
-    split_sql_statements,
-    statement_kind,
-)
-
-# validate — lazy optional deps (email-validator, phonenumbers, python-stdnum)
-from pinky_core.validate import (
-    EmailResult,
-    FrIdResult,
-    IbanBicResult,
-    NirResult,
-    PhoneResult,
-    VatResult,
-    standardize_email,
-    standardize_phone,
-    validate_iban_bic,
-    validate_nir,
-    validate_siret,
-    validate_vat_eu,
-)
-
-# warnings — pure deprecation warning, always available
-from pinky_core.warnings import PinkyDeprecationWarning
-
-# xml — XML/VARIANT navigation UDF handlers, always available (lxml optional for xml_path_str)
-from pinky_core.xml import xml_path, xml_path_str
-
-__all__ = [
-    # finance
-    "FecAmountSchema",
-    "FecBalanceError",
-    "FecEntry",
-    "FecParseResult",
-    "FecRowError",
-    "FecSens",
-    "check_fec_balance",
-    "parse_fec",
-    # files
-    "FileDetection",
-    "detect_file_pattern",
-    # fmt
-    "AddressComponents",
-    "AfnorAddress",
-    "NumType",
-    "deduplicate_headers",
-    "iso3_to_iso2",
-    "normalize_city_fr",
-    "normalize_text",
-    "format_boolean",
-    "format_date",
-    "format_datetime",
-    "format_duration",
-    "format_fraction",
-    "format_number",
-    "format_period",
-    "format_stars",
-    "format_trend",
-    "parse_address",
-    "period_to_date",
-    "slugify",
-    "to_camel_case",
-    "to_upper_snake_case",
-    # html
-    "EmailLang",
-    "EmailTheme",
-    "TaskRow",
-    "generate_html",
-    "render_dl_card",
-    "render_task_table",
-    # schedule
-    "public_holidays_fr",
-    "is_business_day",
-    "next_business_day",
-    "business_days_between",
-    "is_eve_of_holiday",
-    "last_business_day_of_month",
-    "first_business_day_of_month",
-    "nth_business_day_of_month",
-    "is_even_week",
-    "is_odd_week",
-    "fiscal_quarter",
-    "days_until_end_of_month",
-    "cron_to_human",
-    "next_schedule",
-    "is_in_schedule",
-    # security
-    "safe_filepath",
-    "validate_identifier",
-    # sql
-    "extract_table_refs",
-    "resolve_query",
-    "split_sql_statements",
-    "statement_kind",
-    # xml
-    "xml_path",
-    "xml_path_str",
-    # validate
-    "EmailResult",
-    "FrIdResult",
-    "IbanBicResult",
-    "NirResult",
-    "PhoneResult",
-    "standardize_email",
-    "standardize_phone",
-    "VatResult",
-    "validate_iban_bic",
-    "validate_nir",
-    "validate_siret",
-    "validate_vat_eu",
-    # warnings
-    "PinkyDeprecationWarning",
-]