myBasis: A Python Toolkit

myBasis is a library built to provide a variety of useful doodads for high-level Python development of all kinds, with a special eye towards ergonomics, Unix-style composability, and thorough documentation & testing.

It’s aimed at Python developers of all kinds, but it’s especially worth a perusal if you’re…

• …iteratively modifying text files, e.g. while setting up a RAG corpus, converting files between formats, or cleaning up a dataset.

• …convinced Python has accidentally become the best functional language ever released, and thus always on the lookout for ways to write more readable, concise functional code.

• …building AI agents where “vibe” typing can save you thousands of tokens per slightly-mistaken tool call.

• …looking for a clean, easily-extensible way to interact with Google Sheets.

• …interested in generic caching mechanisms in order to satisfy the guilty pleasure of premature optimization.

• …looking for some code snippets to lift out of this repo directly, saving you an import!

The package is organized into seven subpackages, which are (in rough order from most- to least-general):

• 1. My Utilities
  • IterUtils: Iteration Utilities
  • TextUtils: Text Utilities
  • SystemUtils: System Utilities
  • SyntaxUtils: Syntax Utilities
  • SemanticUtils: Semantic Utilities
  • MetricUtils: Logging & Telemetry
• 2. Type Casting
  • Typist: Powerful, Varied Typing Utilities
  • MyType: A Powerful-yet-constrained Type Wrapper
  • AutocastModel: Advanced Coercion for Pydantic Models
  • cast: The Coercion Chamber
  • check: The Verification Chamber
  • match: The Comparison Chamber
  • Metatype: A Classifier for Special Forms
• 3. Useful Types
  • Buffer: A Performant, Mutable Text Buffer
  • Command: A Normalized, Programatically-defined Shell Command
  • MyEnum: AbstractBaseClass for Flexible Enumerations
  • Platform: An Enumeration of Supported Operating Systems
  • Predicate: A General, Highly-serializable Data Structure
  • Span: An Ergonomic Wrapper for tuple[int, int]
  • UniqueId: A Minimal Wrapper around uuid4
• 4. Regex Stores
  • Extended Regex Syntax in Python
  • RegexStore: Readable, Optimized Regular Expressions
  • MatchData: An Ergonomic, Parsed Regex Match
  • COMMON_RGXS: Some Useful Regular Expressions
  • RegexDebugger: Verbose, Step-by-Step Regex Debugging
  • my.regex.meta: Internal Regex Metatypes
• 5. Local Caches
  • Cache: Basic, Extensible In-Memory Caching
  • FileCache: Optimized Persistent Local Caching
  • NestedCache: Simple, Recursive In-Memory Caching
  • PickleCache: Basic Persistent Local Caching
• 6. API Wrappers
  • Environment: Ergonomic, Concise Shell Variable Interface
  • Filesystem: A Centralized Registry of Common Filesystem Paths
  • GoogleSheet: Simple, Remote Tabulation
• 7. File Formats
  • DocName: The Canonical creators__year__title Document Name
  • Markdown: A Hierarchically Indexed Markdown Document