pinky-snowpark 0.1.0.dev1__tar.gz

pinky_snowpark-0.1.0.dev1/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Format check
+        run: ruff format --check src/ tests/
+
+      - name: Type check
+        run: mypy src/pinky_snowpark/
+
+      - name: Security scan
+        run: bandit -r src/pinky_snowpark/ -ll --skip B108
+
+      - name: Tests
+        run: pytest

pinky_snowpark-0.1.0.dev1/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.dev*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    permissions:
+      contents: read
+      id-token: write  # required for trusted publishing (OIDC)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pinky_snowpark-0.1.0.dev1/.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Read version
+        id: version
+        run: echo "version=$(grep '^version' pyproject.toml | cut -d'"' -f2)" >> $GITHUB_OUTPUT
+
+      - name: Guard — no .dev version on main
+        run: |
+          if [[ "${{ steps.version.outputs.version }}" == *".dev"* ]]; then
+            echo "❌ version .dev sur main — bumper la version avant de merger"
+            exit 1
+          fi
+
+      - name: Create tag
+        run: |
+          git tag "v${{ steps.version.outputs.version }}"
+          git push origin "v${{ steps.version.outputs.version }}"
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pinky_snowpark-0.1.0.dev1/.gitignore

@@ -0,0 +1,27 @@
+# MkDocs
+docs/assets/
+site/
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Environments
+.env
+.venv/
+env/
+
+# Pytest / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Mypy
+.mypy_cache/
+
+# Ruff
+.ruff_cache/

pinky_snowpark-0.1.0.dev1/.pre-commit-config.yaml

@@ -0,0 +1,107 @@
+---
+# =============================================================================
+# .pre-commit-config.yaml — pinky-snowpark
+# =============================================================================
+# Install:
+#   pip install pre-commit
+#   pre-commit install
+#   pre-commit install --hook-type commit-msg
+#
+# Update standard hooks:
+#   pre-commit autoupdate
+# =============================================================================
+default_install_hook_types: [pre-commit, commit-msg]
+
+repos:
+  # ── Formatting: trailing spaces + newline ─────────────────────────────────
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  # ── Formatting: Markdown ──────────────────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: mdformat
+        name: mdformat
+        entry: mdformat
+        language: system
+        files: ^README\.md$
+
+  # ── Security: secrets & forbidden files ──────────────────────────────────
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.30.0
+    hooks:
+      - id: gitleaks
+
+  # ── Security: alternative secret detection ────────────────────────────────
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ["--baseline", ".secrets.baseline"]
+        exclude: ^docs/
+
+  # ── Python: ruff lint + format ────────────────────────────────────────────
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.9
+    hooks:
+      - id: ruff-check
+        args: [--no-fix]
+      - id: ruff-format
+        args: [--check]
+
+  # ── Python: type checking ─────────────────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: mypy
+        language: system
+        types: [python]
+        args: [--ignore-missing-imports]
+        files: ^src/
+
+  # ── Python: security ─────────────────────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: bandit
+        name: bandit
+        entry: bandit
+        language: system
+        pass_filenames: false
+        args: [-r, src/, -ll, --skip, B108]
+
+  # ── Typed API guard ──────────────────────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: check-typed-api
+        name: "[TYPED-API] No raw dict/tuple/set in public annotations"
+        entry: python scripts/hooks/check_typed_api.py
+        language: system
+        types: [python]
+        files: ^src/
+
+  # ── Employer reference guard ──────────────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: check-forbidden-keywords
+        name: "[FORBIDDEN] Employer references"
+        entry: python scripts/hooks/check_forbidden_keywords.py
+        language: system
+        pass_filenames: true
+
+  # ── Snowpark / Core API conventions ──────────────────────────────────────
+  - repo: local
+    hooks:
+      - id: check-snowpark-api
+        name: "[SNOWPARK-API] No session.sql(), canonical method names"
+        entry: python scripts/hooks/check_snowpark_api.py
+        language: system
+        types: [python]
+        files: ^src/

pinky_snowpark-0.1.0.dev1/.secrets.baseline

@@ -0,0 +1,127 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-06-04T04:24:36Z"
+}

pinky_snowpark-0.1.0.dev1/CONTEXT.md

@@ -0,0 +1,16 @@
+# CONTEXT.md — pinky-snowpark
+*Update date : 2026-05-31 20:22*
+
+Single source of truth for naming in this repo. Variables, function names, module names, and documentation prose all follow this table.
+
+| Term (preferred) | Avoid | Definition |
+|---|---|---|
+| `session` | `connection`, `client` | A live Snowpark `Session` — the entry point to Snowflake compute |
+| `load_kwargs` | `load_args`, `load_params` | SP argument loader — reads CALL parameters from the Task context |
+| `sp_trace` | `trace_sp`, `sp_telemetry` | SP lifecycle trace emitter — writes a span to the EVENT_TABLE |
+| `stage_write` | `upload`, `export_to_stage` | Stage I/O helper — writes a DataFrame to a named stage with optional encryption |
+| `with_role` | `set_role`, `use_role`, `switch_role` | Context manager for temporary role elevation — restores the original role on exit |
+| `with_user` | `impersonate`, `set_user` | Context manager for temporary user impersonation — same pattern as `with_role` |
+| `EnvPattern` | `EnvMode`, `EnvStrategy` | Enum of strategies to derive the current environment from the Snowflake context |
+| `get_environment` | `detect_env`, `resolve_env` | Function that returns the current environment string using an `EnvPattern` |
+| `CELL_FORMATS` | `FORMATS`, `EXCEL_STYLES` | Dict of named Excel cell format presets in `excel.py` |

pinky_snowpark-0.1.0.dev1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pinky-and-co
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pinky_snowpark-0.1.0.dev1/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: pinky-snowpark
+Version: 0.1.0.dev1
+Summary: Snowpark session utilities, stage I/O, and telemetry for Snowflake stored procedures
+Project-URL: Homepage, https://github.com/pinky-and-co/pinky-snowpark
+Project-URL: Repository, https://github.com/pinky-and-co/pinky-snowpark
+Project-URL: Issues, https://github.com/pinky-and-co/pinky-snowpark/issues
+Author: pinky-and-co
+License: MIT License
+        
+        Copyright (c) 2026 pinky-and-co
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: data-engineering,snowflake,snowpark
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: openpyxl
+Requires-Dist: pinky-core
+Requires-Dist: snowflake-snowpark-python
+Provides-Extra: dev
+Requires-Dist: bandit; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.0; extra == 'dev'
+Requires-Dist: mkdocstrings[python]>=0.25; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: pgp
+Requires-Dist: pgpy; extra == 'pgp'
+Description-Content-Type: text/markdown
+
+# pinky-snowpark
+
+*Update date : 2026-06-04 00:00*
+
+Snowpark session utilities, stage I/O, and telemetry for Snowflake stored procedures.
+
+## Install
+
+```bash
+pip install pinky-snowpark
+```
+
+## Docs
+
+- [Design](docs/explanation/design.md) — architecture and decisions
+- [Features](docs/explanation/features.md) — feature list
+- [ADR](docs/adr/) — architecture decision records
+
+## License
+
+MIT

pinky_snowpark-0.1.0.dev1/README.md

@@ -0,0 +1,21 @@
+# pinky-snowpark
+
+*Update date : 2026-06-04 00:00*
+
+Snowpark session utilities, stage I/O, and telemetry for Snowflake stored procedures.
+
+## Install
+
+```bash
+pip install pinky-snowpark
+```
+
+## Docs
+
+- [Design](docs/explanation/design.md) — architecture and decisions
+- [Features](docs/explanation/features.md) — feature list
+- [ADR](docs/adr/) — architecture decision records
+
+## License
+
+MIT

pinky_snowpark-0.1.0.dev1/docs/adr/0001-sp-telemetry-flat-attrs.md

@@ -0,0 +1,31 @@
+# ADR-0001 — SP telemetry via flat span attributes, not SYSTEM$SET_RETURN_VALUE
+Status: accepted
+Date: 2026-05-31
+
+## Context
+
+Snowflake Tasks support `SYSTEM$SET_RETURN_VALUE` to pass data between task runs.
+Early SP implementations used it as the observability mechanism — the SP wrote a
+JSON payload as the return value, and monitoring queries parsed it.
+
+Two problems emerged:
+1. `SYSTEM$SET_RETURN_VALUE` couples the SP to the Task runtime — a SP called directly
+   (in tests, on-demand) has no Task context and the call fails or silently does nothing.
+2. JSON string payloads in QUERY_HISTORY / EVENT_TABLE require `PARSE_JSON()` at query
+   time — every monitoring query pays the parsing cost and becomes fragile against schema changes.
+
+## Decision
+
+SP observability uses `sp_trace()` with flat span attributes written to EVENT_TABLE.
+`SYSTEM$SET_RETURN_VALUE` is never called from SP code.
+
+DAG-to-SP data passing uses `load_kwargs()` on input and `v_return_values` dict on output —
+the Task wrapper layer reads `v_return_values` and calls `SYSTEM$SET_RETURN_VALUE` on behalf
+of the SP, keeping the SP decoupled.
+
+## Consequences
+
+- SPs are callable directly (tests, on-demand) without a Task context.
+- EVENT_TABLE span attributes are flat key-value pairs — queryable with `WHERE resource_attributes['key'] = 'value'`, no JSON parsing.
+- The Task wrapper is the only code that knows about `SYSTEM$SET_RETURN_VALUE` — one place to change if Snowflake evolves this API.
+- Monitoring dashboards are simpler and faster.

pinky_snowpark-0.1.0.dev1/docs/explanation/design.md

@@ -0,0 +1,39 @@
+# Design — pinky-snowpark
+*Update date : 2026-05-31 20:23*
+
+Snowpark session utilities, telemetry, and stage I/O for Snowpark stored procedures.
+The layer that makes SPs observable, testable, and production-grade — lifecycle tracing,
+encrypted stage writes, Excel exports — without coupling business logic to infra concerns.
+
+See [ADR-0001](../adr/0001-sp-telemetry-flat-attrs.md) for the SP telemetry design decision.
+
+---
+
+## Module inventory
+
+| Module | Description | Status |
+|--------|-------------|--------|
+| `snowpark.py` | Session helpers, SP lifecycle telemetry (`load_kwargs`, `sp_trace`), stage I/O, PGP, rotating filenames, `EnvPattern` | planned |
+| `excel.py` | `create_workbook_from_df()`, `parse_worksheet()`, 30+ `CELL_FORMATS` presets | planned |
+
+---
+
+## SP pattern — load_kwargs + sp_trace
+
+SPs are fully decoupled from Snowflake Tasks. Two functions form the contract:
+
+- **`load_kwargs(raw_args, required_keys, optional_keys)`** — normalises args whether called directly or via a Task DAG (`_TASK_NAME$key` → clean key). Emits `sp_start` telemetry automatically.
+- **`sp_trace(v_result, v_return_values, status)`** — called in the `finally` block. Emits `sp_end` with flat span attributes queryable in EVENT_TABLE without JSON parsing.
+
+The SP does not know it is inside a DAG. The DAG does not know the business logic.
+Full DAG wiring design: `snowflake-provider/provider_design.md`.
+
+---
+
+## Future directions
+
+- **SP test harness** — lightweight local Snowpark session mock for unit testing SPs without a live connection
+- **Registry UI** — Streamlit component reading the `stage_write()` registry table (stage inventory with metadata)
+- **Async stage write** — background thread upload for large DataFrames, returns a future
+- **Conditional cell formatting** — alternating row colors, threshold-based highlights in Excel workbooks
+- **Snowsight deep links** — extend `get_current_snowsight_url()` to direct links to query results / dashboards

pinky_snowpark-0.1.0.dev1/docs/explanation/features.md

@@ -0,0 +1,58 @@
+# Features — pinky-snowpark
+*Update date : 2026-05-31 20:23*
+
+Feature list ordered by priority. `stable` = in production. `planned` = not yet built, order = priority.
+
+---
+
+## Planned
+
+Ordered by priority — closest to implementation first.
+
+### MVP — migration from backup
+
+Both modules are production-ready in `_BACKUP/snowflake-kit-snowpark-bak`.
+MVP = clean migration into the pinky-snowpark repo structure + repo scaffold.
+
+**`snowpark.py`**
+
+| Feature | Description |
+|---------|-------------|
+| Session helpers | `collect_dicts()`, `execute_statements()`, `run_generated_sql()`, `validate_sql()` |
+| Role context manager | `with_role(session, role)` — temporary elevation, restores on exit |
+| SP lifecycle telemetry | `load_kwargs()`, `sp_trace()`, `to_telemetry_attrs()` (flat span attributes for EVENT_TABLE) |
+| Stage I/O | `stage_write()` — CSV / JSON / Parquet / Avro, optional PGP encryption, optional registry table append |
+| PGP helpers | `load_pgp_key()`, `decrypt_file()` with auto format detection |
+| Rotating filenames | `get_rotating_filename()` with 5 retention slots |
+| Environment derivation | `get_environment(session, EnvPattern)` + `EnvPattern` enum (ACCOUNT / DATABASE_SUFFIX / DATABASE_PREFIX / SCHEMA_SUFFIX / SCHEMA_PREFIX) |
+
+**`excel.py`**
+
+| Feature | Description |
+|---------|-------------|
+| Workbook generation | `create_workbook_from_df()` — DataFrame → formatted `.xlsx` |
+| Workbook parsing | `parse_worksheet()` — Excel → DataFrame |
+| Format presets | `CELL_FORMATS` — 30+ presets (FR/EN dates, currencies, numeric, styles) |
+
+### with_user — temporary user impersonation
+
+`with_user(session, username)` context manager — same pattern as `with_role()`.
+Use case: audit trails in multi-tenant SPs.
+
+### decrypt_file — in-memory mode
+
+Currently writes to `/tmp/`. Small files (<50 MB) should decrypt in-memory to avoid disk I/O inside Snowflake.
+
+### excel.py — conditional cell formatting
+
+Alternating row colors and threshold-based highlights. Extends existing `CELL_FORMATS` presets.
+
+### SP test harness
+
+Lightweight local Snowpark session mock for unit testing SPs without a live Snowflake connection.
+
+### Backlog
+
+- Async stage write — background thread upload, returns future
+- Registry UI — Streamlit component reading the `stage_write()` registry table
+- Snowsight deep links — direct links to query results / dashboards / worksheets

pinky_snowpark-0.1.0.dev1/docs/index.md

@@ -0,0 +1,17 @@
+# pinky-snowpark
+*Update date : 2026-06-01*
+
+Snowpark session utilities, stage I/O, and telemetry for Snowflake stored procedures.
+
+The layer that makes SPs observable, testable, and production-grade — lifecycle tracing,
+encrypted stage writes, Excel exports — without coupling business logic to infra concerns.
+
+---
+
+<!-- agent index — one line per file, what it covers and what NOT to put there -->
+
+- [explanation/design.md](explanation/design.md) — architecture, SP pattern (load_kwargs + sp_trace), module inventory, future directions. Not for: decisions (→ adr/), feature list (→ features.md)
+- [explanation/features.md](explanation/features.md) — feature list by priority: MVP migration + post-MVP backlog. Not for: design rationale (→ design.md)
+- [reference/generated/api/snowpark.md](reference/generated/api/snowpark.md) — API reference for snowpark module (session helpers, telemetry, stage I/O, PGP, rotating filenames). Not for: hand-written content — edit docstrings in src/
+- [reference/generated/api/excel.md](reference/generated/api/excel.md) — API reference for excel module (CellFormat, CELL_FORMATS, create_workbook_from_df, parse_worksheet). Not for: hand-written content — edit docstrings in src/
+- [adr/0001-sp-telemetry-flat-attrs.md](adr/0001-sp-telemetry-flat-attrs.md) — sp_trace flat attrs over SYSTEM$SET_RETURN_VALUE; SPs decoupled from Task runtime

pinky_snowpark-0.1.0.dev1/docs/reference/generated/api/excel.md

@@ -0,0 +1,5 @@
+::: pinky_snowpark.excel
+    options:
+      show_root_heading: true
+      show_root_full_path: false
+      heading_level: 1

pinky_snowpark-0.1.0.dev1/docs/reference/generated/api/snowpark.md

@@ -0,0 +1,5 @@
+::: pinky_snowpark.snowpark
+    options:
+      show_root_heading: true
+      show_root_full_path: false
+      heading_level: 1