How sxperfect/gunz-utils works
Gunz Utils is a dependency-free Python library of reusable primitives, not an application with one fixed user-to-result pipeline. Developers select individual utilities for configuration and data handling, concurrency and resilience, I/O and security, reproducible workflows, or experiments and statistics. The graph groups these capabilities and shows only documented or indexed module relationships. Benchmarking is a documented capability, but its package path is absent from the supplied tree; unsampled modules are included without speculative call edges.
Main entry points: content_store.py Content store · provenance.py Provenance · collections.py Collections · io.py I/O and streaming
Components 25
Data and configuration
- Collections
src/gunz_utils/collections.py - Configuration and parsing
src/gunz_utils/config.py - Stdlib validation
src/gunz_utils/ext/validation_stdlib.py
Concurrency and resilience
- Caching
src/gunz_utils/cache.py - Concurrency
src/gunz_utils/concurrency.py - Retry
src/gunz_utils/retry.py - Resilience and limits
src/gunz_utils/resilience.py - Rate limits and leases
src/gunz_utils/rate_limit.py
I/O and security
- I/O and streaming
src/gunz_utils/io.py - Serialization
src/gunz_utils/serialization.py - Hashing
src/gunz_utils/hashing.py - Content store
src/gunz_utils/content_store.py - Security and redaction
src/gunz_utils/security.py - Encrypted secure store
src/gunz_utils/ext/secure_store.py - Process execution
src/gunz_utils/subprocess.py - Streaming
src/gunz_utils/streaming.py - Redaction
src/gunz_utils/redaction.py
Reproducibility and workflows
- Workflow DAG
src/gunz_utils/dag.py - Provenance
src/gunz_utils/provenance.py - Provenance graph
src/gunz_utils/provenance_graph.py - Versioning and partitions
src/gunz_utils/versioning.py
Experiments and statistics
- Experiment utilities
src/gunz_utils/experiments.py - Sampling and statistics
src/gunz_utils/sampling.py - Data structures
src/gunz_utils/structures.py
Other components
- Library developer
Connections 17
- Library developer → Collections: uses utilities
README.md - Library developer → Configuration and parsing: configures
README.md - Library developer → Caching: uses utilities
README.md - Library developer → I/O and streaming: handles I/O
README.md - Library developer → Security and redaction: uses utilities
README.md - Library developer → Workflow DAG: executes workflows
README.md - Library developer → Experiment utilities: runs experiments
README.md - Caching → Collections: uses
src/gunz_utils/cache.py - Content store → Hashing: hashes files
src/gunz_utils/content_store.py - Content store → I/O and streaming: uses I/O
src/gunz_utils/content_store.py - Content store → Streaming: uses streaming
src/gunz_utils/content_store.py - Streaming → Serialization: uses
src/gunz_utils/streaming.py - Workflow DAG → Hashing: fingerprints stages
src/gunz_utils/dag.py - Provenance → I/O and streaming: uses I/O
src/gunz_utils/provenance.py - Provenance → Data structures: uses structures
src/gunz_utils/provenance.py - Provenance → Redaction: uses redaction
src/gunz_utils/provenance.py - Data structures → Collections: uses
src/gunz_utils/structures.py