queelius/dotsuite: v0.9.1-beta: Fix CLIs, documentation, and tests

Read full text
Authors: Alex Towell
Cited by: 0

Abstract

Beta release following v0.9.1b0. Primarily a documentation and polish release; no breaking changes to the public API of any tool's __init__.py exports. Documentation Comprehensive overhaul to align docs with the actual four-pillar structure: Migrated all top-level docs (README.md, philosophy.md, dot-formalism.md, dot-notation-universe.md, ecosystem.md, getting-started.md, index.md, proposal-collections-pillar.md) from three-pillar framing to four-pillar (Depth, Truth, Shape, Collections). Fixed fabricated/stale API references in examples: dotrelate.join(on=...) → real left_join(..., left_on=..., right_on=...); Q(level="error", ...) → real Q("path").equals(...) fluent builder; shape.dotpipe.pipe() → real Pipeline; filter_docs(string) → real filter_docs(callable). Fixed dotmod stdin CLI examples to require explicit - (argparse parses subcommand as data_file otherwise). Fixed dotpath segment imports (Key/Index live in depth.dotpath.segments, not the package root). Added known-issue callouts for the dotselect import bug and the collections/ vs Python-stdlib package-name collision. Updated mkdocs.yml version (0.1.0 → 0.9.1b1) and index.md test count (435 → 468). Marked proposal-collections-pillar.md as ADOPTED (retained for historical reference). Source changes src/collections/dotrelate/__init__.py: was empty; now exports left_join, inner_join, project, union, set_difference. Programmatic imports now work (subject to the known collections/ stdlib collision). src/truth/dotany/core.py, src/truth/dotall/core.py: simplified any_match/all_match to generator expressions; unified check() scaffolding, hoisted str(value) out of the loop, removed dead try/except around get(). Renamed check() parameter equals=None → value (dropped the ambiguous default). The CLI-level behavior (string-coercion fallback for --equals) is unchanged. src/truth/dotall/cli.py, src/truth/dotany/cli.py: replaced broad except Exception with the specific tuple (json.JSONDecodeError, yaml.YAMLError, TypeError, ValueError) per project convention. Testing All 464 tests pass. mkdocs build --strict succeeds. Added CLI smoke tests in previous release (v0.9.1b0) remain green. Install pip install dotsuite==0.9.1b1 PyPI: https://pypi.org/project/dotsuite/0.9.1b1/

Fields of Study & Subjects

Scientific Computing and Data Management Advanced Database Systems and Queries Computational Physics and Python Applications

Publication details

Journal / source
Zenodo (CERN European Organization for Nuclear Research)
Publication date
4 March 2026
Language
EN