tha-wright-stuff 0.1.0

A Tabular Helper meta-package that bundles the full tha-* library family in a single install.

tha-wright-stuff

Install the entire Tabular Helper (tha-*) library family in one shot.

pip install tha-wright-stuff

---

What is this?

tha-wright-stuff serves two purposes at once:

1. Meta-package

One install pulls in every tha-* library and re-exports all of their public symbols from a single namespace. Instead of installing and importing from eight separate packages, you can just do:

from tha_wright_stuff import ThaCSV, ThaMap, ThaReq, ThaDict, ThaDdb, ThaEdfiBase, ThaSheets, ThaSnowflake

Every public class, function, and error type from all eight libraries is available at the top level.

2. Cross-family integration canary

uv.lock is intentionally not committed to this repo. That means every CI run resolves all eight libraries fresh from PyPI — no pinned snapshot. If any two libraries in the family ship incompatible dependency requirements, this repo's CI will fail, surfacing the conflict before users hit it.

---

Included libraries

Package	PyPI	GitHub	What it does
tha-csv-runner		tha-csv-runner	Read and write CSVs with progress bars, header validation, chunking, sort/filter, and an optional per-row validator callback.
tha-map-runner		tha-map-runner	Enrich and join dicts using dotted-path projection and O(n+m) index-based lookups. Supports left / inner / anti joins and DynamoDB result shapes.
tha-req-runner		tha-req-runner	Transport layer for API runners — session management, retries, safe_call, and a normalized parse_response dict. Supports both requests and httpx backends.
tha-aws-runner		tha-aws-runner	DynamoDB (ThaDdb), GSI queries (ThaGsi), S3 (ThaS3), SSM Parameter Store (ThaSSM), and a DdbCostTracker context manager that tallies RCU/WCU and USD cost per run.
tha-utils-helper		tha-utils-helper	Zero-dependency utilities: ThaStr (slugify, format), ThaNum (currency, parens-as-negative, cast), ThaDT (auto-detect date formats), ThaDict (pick, omit, rename), ThaList (chunk, flatten), ThaType (bool/int/float coercion). All include matching *_rows batch methods.
tha-edfi-runner		tha-edfi-runner	Ed-Fi ODS API client — OAuth client-credentials auth, pagination, and chunked parallel posting via ThreadPoolExecutor.
tha-google-runner		tha-google-runner	Google Sheets reader/writer (ThaSheets) using a service account — reads sheets to row dicts, writes row dicts back with optional header control.
tha-snowflake-runner		tha-snowflake-runner	Snowflake query runner (ThaSnowflake) — named connection profiles, query execution to row dicts, and chunked parallel inserts.

---

Requirements

• Python 3.10+

All eight libraries are installed automatically as dependencies. Optional extras from individual libraries (e.g. tha-csv-runner[excel], tha-req-runner[httpx]) are not pulled in by default — install them separately if needed.

---

License

MIT