nivaria 0.11.0__tar.gz

nivaria-0.11.0/.editorconfig

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2026 René de Hesselle <dehesselle@web.de>
+#
+# SPDX-License-Identifier: 0BSD
+
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

nivaria-0.11.0/.gitattributes

@@ -0,0 +1,5 @@
+# SPDX-FileCopyrightText: 2026 René de Hesselle <dehesselle@web.de>
+#
+# SPDX-License-Identifier: 0BSD
+
+* text=auto eol=lf

nivaria-0.11.0/.github/workflows/build.yml

@@ -0,0 +1,157 @@
+# SPDX-FileCopyrightText: 2026 René de Hesselle <dehesselle@web.de>
+#
+# SPDX-License-Identifier: 0BSD
+
+name: Build
+on:
+  push:
+    branches: ["**"]
+    tags: ["v[0-9]*"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  #-----------------------------------------------------------------------------
+
+  Lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+
+      # keep aligned with [tool.ruff] in pyproject.toml
+      - name: Check formatting
+        run: uvx --from 'ruff~=0.16.0' ruff format --check .
+
+      - name: Lint
+        run: uvx --from 'ruff~=0.16.0' ruff check .
+
+      - name: Check REUSE compliance
+        run: uvx reuse lint
+
+      # Settings are in .markdownlint-cli2.yaml. This release bundles
+      # markdownlint-cli2 0.24.0; keep the pin in docs/DEVELOPMENT.md aligned.
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@696eb3f2509270d7b882d2aa68347bc676e7af34 # v25.0.0
+
+  #-----------------------------------------------------------------------------
+
+  Test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python: ["3.12"]
+        include:
+          - os: ubuntu-latest
+            python: "3.14"
+    runs-on: ${{ matrix.os }}
+    steps:
+      # full history for hatch-vcs
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        with:
+          python-version: ${{ matrix.python }}
+
+      # python -m puts the repository root on sys.path for tests.fakes
+      - name: Run tests
+        run: uv run --locked python -m pytest
+
+  #-----------------------------------------------------------------------------
+
+  Build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+
+      - name: Build project
+        run: uv build --no-sources
+
+      - name: Smoke-test wheel
+        run: |
+          uv run --isolated --no-project --with dist/*.whl python - <<'EOF'
+          import os
+          import nivaria
+          print(nivaria.__version__)
+          if os.environ["GITHUB_REF_TYPE"] == "tag":
+              expected = os.environ["GITHUB_REF_NAME"].removeprefix("v")
+              assert nivaria.__version__ == expected, (nivaria.__version__, expected)
+          EOF
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: dist/
+
+  #-----------------------------------------------------------------------------
+
+  Release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    needs:
+      - Lint
+      - Test
+      - Build
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create draft release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: >-
+          gh release create "$GITHUB_REF_NAME" dist/*
+          --repo "$GITHUB_REPOSITORY"
+          --draft
+          --verify-tag
+          --generate-notes
+
+  #-----------------------------------------------------------------------------
+
+  PyPI:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    needs:
+      - Build
+      - Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/nivaria
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3

nivaria-0.11.0/.gitignore

@@ -0,0 +1,24 @@
+# SPDX-FileCopyrightText: 2026 René de Hesselle <dehesselle@web.de>
+#
+# SPDX-License-Identifier: 0BSD
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+src/nivaria/version.py
+
+# Virtual environments
+.venv
+
+# Ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+
+# generated test-data from tools
+/tools/data

nivaria-0.11.0/.markdownlint-cli2.yaml

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: 2026 René de Hesselle <dehesselle@web.de>
+#
+# SPDX-License-Identifier: 0BSD
+
+config:
+  default: true
+  # Files wrap at different widths, and tables, links and code blocks run past
+  # any of them.
+  MD013: false
+
+globs:
+  - "**/*.md"
+
+ignores:
+  - LICENSE
+  - justfile
+
+gitignore: true

nivaria-0.11.0/.python-version

@@ -0,0 +1 @@
+3.12

nivaria-0.11.0/CLAUDE.md

@@ -0,0 +1,25 @@
+# nivaria
+
+A Textual TUI for browsing and searching Snowflake objects.
+
+## Documentation
+
+- Read `docs/DESIGN.md` before architectural changes and respect its core
+  principles; several are not obvious from the code and a change can silently
+  break them.
+- Usage, keys and settings: `docs/MANUAL.md`. Runtime behaviour, limits and
+  files: `docs/OPERATIONS.md`.
+- What each screen and trigger sends to Snowflake: `docs/data-retrieval.md`. Check
+  it before changing what is fetched, and when.
+- Live Snowflake findings: `docs/snowflake-behavior.md`. Timings:
+  `docs/measurements.md`.
+
+@docs/DEVELOPMENT.md
+
+## Rules
+
+- The README stays short. A change that affects design, usage or behaviour
+  updates the matching document in the same change. A change to what is fetched,
+  or when, updates `docs/data-retrieval.md`.
+- `docs/DESIGN.md` is kept current and carries no project history.
+- Commit only when asked.

nivaria-0.11.0/CONTRIBUTING.md

@@ -0,0 +1,3 @@
+# Contribution guidelines
+
+I'm open to receiving bug reports, but I'm not really interested in anything else at this point. You can still bring forward whatever you want to say, just manage your expectations accordingly.

nivaria-0.11.0/LICENSE

@@ -0,0 +1,5 @@
+Copyright (C) 2026 by René de Hesselle
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

nivaria-0.11.0/LICENSES/0BSD.txt

@@ -0,0 +1,5 @@
+Copyright (C) 2026 by René de Hesselle
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

nivaria-0.11.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.5
+Name: nivaria
+Version: 0.11.0
+Summary: A TUI for quickly browsing and searching Snowflake objects
+Author-email: René de Hesselle <dehesselle@web.de>
+License-Expression: 0BSD
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: platformdirs>=4.11.0
+Requires-Dist: snowflake-connector-python[secure-local-storage]<5,>=4.7.3
+Requires-Dist: tcoda<0.11,>=0.10.1
+Requires-Dist: textual<9,>=8.2.8
+Description-Content-Type: text/markdown
+
+# Nivaria
+
+![main screen](https://raw.githubusercontent.com/dehesselle/nivaria/master/docs/screenshot.svg)
+
+> __Nivarius, nivaria, nivarium__ · _Latin adjective_
+>
+> “Of snow”, “belonging to snow” or “snow-related”. _Nivaria_ is its feminine singular form.
+
+Nivaria is a [Textual](https://textual.textualize.io)-based TUI to browse and search objects in Snowflake: databases,
+schemas, tables, views, pipes, stages and tasks, with their columns, grants,
+tags, load and run history, and a preview of table data.
+
+It reads everything from a local cache and refreshes it in the background, so
+browsing and fuzzy search are instant even across thousands of objects. The
+object tree comes from `SHOW` commands, which need no running warehouse, and a
+small pool of connections is opened once, so an MFA-protected account prompts
+at login rather than on every query.
+
+## Install and run
+
+```sh
+uv tool install nivaria
+nivaria
+```
+
+Enter your account and user in the connect dialog, pick an authenticator
+(OAuth, browser SSO or password + MFA) and connect. `, a d` selects the
+databases to browse, `/` searches, and `,` followed by a pause lists all
+commands.
+
+## Caveats
+
+- The Data tab and the activity, history and tag columns run `SELECT`s on the
+  active warehouse, which consumes credits. The tree and object lists do not.
+
+## Documentation
+
+- [docs/MANUAL.md](https://github.com/dehesselle/nivaria/blob/master/docs/MANUAL.md) — connecting, keys, browsing, search, detail views and all settings.
+- [docs/OPERATIONS.md](https://github.com/dehesselle/nivaria/blob/master/docs/OPERATIONS.md) — Snowflake load, warehouse and privilege needs, limits, files on disk, troubleshooting.
+- [docs/DESIGN.md](https://github.com/dehesselle/nivaria/blob/master/docs/DESIGN.md) — architecture, core principles and the reasons behind them.
+- [docs/DEVELOPMENT.md](https://github.com/dehesselle/nivaria/blob/master/docs/DEVELOPMENT.md) — setup, tests, linting, conventions and live-account tools.
+- [docs/data-retrieval.md](https://github.com/dehesselle/nivaria/blob/master/docs/data-retrieval.md) — what each screen and trigger sends to Snowflake.
+- [docs/snowflake-behavior.md](https://github.com/dehesselle/nivaria/blob/master/docs/snowflake-behavior.md) — what live Snowflake accounts were observed to do.
+- [docs/measurements.md](https://github.com/dehesselle/nivaria/blob/master/docs/measurements.md) — timings and data volumes behind the design.
+
+## AI disclosure
+
+Substantial parts of this code were generated with Sonnet 5.x/Opus 5.x. Generated code was tested, but not every line was reviewed in detail.
+
+## License
+
+[0BSD](https://github.com/dehesselle/nivaria/blob/master/LICENSES/0BSD.txt)

nivaria-0.11.0/README.md

@@ -0,0 +1,52 @@
+# Nivaria
+
+![main screen](https://raw.githubusercontent.com/dehesselle/nivaria/master/docs/screenshot.svg)
+
+> __Nivarius, nivaria, nivarium__ · _Latin adjective_
+>
+> “Of snow”, “belonging to snow” or “snow-related”. _Nivaria_ is its feminine singular form.
+
+Nivaria is a [Textual](https://textual.textualize.io)-based TUI to browse and search objects in Snowflake: databases,
+schemas, tables, views, pipes, stages and tasks, with their columns, grants,
+tags, load and run history, and a preview of table data.
+
+It reads everything from a local cache and refreshes it in the background, so
+browsing and fuzzy search are instant even across thousands of objects. The
+object tree comes from `SHOW` commands, which need no running warehouse, and a
+small pool of connections is opened once, so an MFA-protected account prompts
+at login rather than on every query.
+
+## Install and run
+
+```sh
+uv tool install nivaria
+nivaria
+```
+
+Enter your account and user in the connect dialog, pick an authenticator
+(OAuth, browser SSO or password + MFA) and connect. `, a d` selects the
+databases to browse, `/` searches, and `,` followed by a pause lists all
+commands.
+
+## Caveats
+
+- The Data tab and the activity, history and tag columns run `SELECT`s on the
+  active warehouse, which consumes credits. The tree and object lists do not.
+
+## Documentation
+
+- [docs/MANUAL.md](https://github.com/dehesselle/nivaria/blob/master/docs/MANUAL.md) — connecting, keys, browsing, search, detail views and all settings.
+- [docs/OPERATIONS.md](https://github.com/dehesselle/nivaria/blob/master/docs/OPERATIONS.md) — Snowflake load, warehouse and privilege needs, limits, files on disk, troubleshooting.
+- [docs/DESIGN.md](https://github.com/dehesselle/nivaria/blob/master/docs/DESIGN.md) — architecture, core principles and the reasons behind them.
+- [docs/DEVELOPMENT.md](https://github.com/dehesselle/nivaria/blob/master/docs/DEVELOPMENT.md) — setup, tests, linting, conventions and live-account tools.
+- [docs/data-retrieval.md](https://github.com/dehesselle/nivaria/blob/master/docs/data-retrieval.md) — what each screen and trigger sends to Snowflake.
+- [docs/snowflake-behavior.md](https://github.com/dehesselle/nivaria/blob/master/docs/snowflake-behavior.md) — what live Snowflake accounts were observed to do.
+- [docs/measurements.md](https://github.com/dehesselle/nivaria/blob/master/docs/measurements.md) — timings and data volumes behind the design.
+
+## AI disclosure
+
+Substantial parts of this code were generated with Sonnet 5.x/Opus 5.x. Generated code was tested, but not every line was reviewed in detail.
+
+## License
+
+[0BSD](https://github.com/dehesselle/nivaria/blob/master/LICENSES/0BSD.txt)

nivaria-0.11.0/REUSE.toml

@@ -0,0 +1,16 @@
+version = 1
+
+# Files that can't carry an SPDX comment, or shouldn't: docs stay clean when
+# rendered, the about box is shown verbatim, the screenshot and uv.lock are
+# regenerated, JSON has no comments.
+[[annotations]]
+path = [
+    "**.md",
+    "docs/screenshot.svg",
+    "src/nivaria/ui/about.txt",
+    "tests/data/show_column_types.json",
+    "uv.lock",
+    ".python-version",
+]
+SPDX-FileCopyrightText = "2026 René de Hesselle <dehesselle@web.de>"
+SPDX-License-Identifier = "0BSD"