fix(ci): fix lib creds on ci

Author: kshitijrajsharma

README.md

@@ -1,118 +1,79 @@
 # osmsg
 
-OpenStreetMap stats generator. UTC-only, parquet-first, OAuth 2.0.
+Generate OpenStreetMap user stats from the command line. Point it at a time window, get back per-user counts of nodes/ways/relations created, modified, and deleted, in parquet, csv, json, markdown, or straight into Postgres.
 
 ## Install
 
 ```bash
 pip install osmsg
-# or
+# or, as a standalone CLI
 uv tool install osmsg
-# or
+# or, no install
 docker run --rm -v "$PWD:/work" -w /work ghcr.io/osgeonepal/osmsg:latest --last hour
 ```
 
-## Quick start (CLI)
+## Examples
 
 ```bash
-# Last hour, planet replication
+# What happened in the last hour, planet-wide
 osmsg --last hour
 
-# Country-level (live Geofabrik index lookup, OAuth 2.0)
-export OSM_USERNAME=... OSM_PASSWORD=...     # or use a .env
+# Yesterday's stats for a country (needs OSM credentials, see below)
 osmsg --country nepal --last day
 
-# Custom range + per-key tag totals + daily summary
-osmsg --start "2026-04-01 00:00:00" --end "2026-04-08 00:00:00" \
+# Custom range, with per-key tag breakdowns and a daily summary
+osmsg --start "2026-04-01" --end "2026-04-08" \
       --tags building --tags highway --summary
 
-# Long flag lists are easier as YAML; CLI args still override
-osmsg --config nepal.yaml --rows 50
+# Only changesets tagged #hotosm (substring by default; --exact-lookup for whole-word)
+osmsg --hashtags hotosm --last day
 
-# Cron-friendly: resume from where the last run left off
+# Cron-friendly: pick up where the last run left off
 osmsg --country nepal --update
 ```
 
-## Library usage
+YAML configs work too if your flag list gets long: `osmsg --config nepal.yaml`.
 
-```python
-from datetime import datetime, UTC
+## Output
 
-from osmsg import RunConfig, run, OsmsgError
+Every run writes `stats.duckdb` (or `<--name>.duckdb`) plus whatever formats you ask for via `-f parquet|csv|json|markdown|psql`. Parquet is the default. Open it with duckdb, polars, pandas, whatever.
 
-cfg = RunConfig(
-    name="nepal",
-    countries=["nepal"],
-    start_date=datetime(2026, 4, 25, tzinfo=UTC),
-    end_date=datetime(2026, 4, 26, tzinfo=UTC),
-    formats=["parquet", "psql"],
-    psql_dsn="host=localhost dbname=osm user=osm",
-)
-try:
-    result = run(cfg)  # OSM credentials picked up from OSM_USERNAME / OSM_PASSWORD
-except OsmsgError as exc:
-    ...
-
-print(result["files"]["parquet"])  # → 'nepal.parquet'
-print(result["rows"])              # → user count
-```
-
-Query a stored database (DuckDB file or Postgres) without re-running:
-
-```python
-from osmsg import connect, user_stats, daily_summary
-
-conn = connect("nepal.duckdb")
-top_10 = user_stats(conn, top_n=10)
-days   = daily_summary(conn)
+```bash
+duckdb stats.duckdb -c "SELECT username, SUM(nodes_created) AS n
+                        FROM users JOIN changeset_stats USING (uid)
+                        GROUP BY username ORDER BY n DESC LIMIT 10"
 ```
 
-Typed exceptions (`OsmsgError` base, plus `UnknownRegionError` / `CredentialsRequiredError` / `GeofabrikAuthError` / `NoDataFoundError`) are catchable by callers; the CLI maps them to exit codes (2 = config/auth, 1 = no data). The package ships a `py.typed` marker for `mypy` / `ty`.
-
-## Output formats
-
-`-f parquet` (default) `-f csv` `-f json` `-f markdown` `-f psql`
-
-Every run writes a portable `<name>.duckdb` (queryable with the duckdb CLI) plus the formats you asked for. Parquet is the canonical exchange format — open it directly with DuckDB / polars / pandas.
-
-```sql
--- Query the duckdb file from anywhere
-duckdb stats.duckdb -c "SELECT name, map_changes FROM (
-  SELECT u.username AS name, SUM(s.nodes_created+s.ways_created) AS map_changes
-  FROM users u JOIN changeset_stats s USING (uid) GROUP BY 1 ORDER BY 2 DESC LIMIT 10
-)"
-```
+The schema is the same in DuckDB and Postgres. Four tables: `users`, `changesets`, `changeset_stats`, and `state` (the resume marker for `--update`).
 
 ## Credentials
 
-`--country` and Geofabrik internal URLs need OSM credentials (OAuth 2.0; OAuth 1.0a was retired June 2024). Public planet replication (`--url minute|hour|day`) needs none. Resolution order:
+`--country` (and Geofabrik URLs) need an OSM account; public planet replication (`--url minute|hour|day`) doesn't.
 
-1. `--username` (CLI) + `--password-stdin` (one line on stdin), or `osm_username` / `osm_password` (`RunConfig`)
-2. `OSM_USERNAME` / `OSM_PASSWORD` env vars (auto-loaded from `.env`)
-3. Interactive `getpass` prompt — TTY only. Headless library callers raise `CredentialsRequiredError`.
+Set `OSM_USERNAME` and `OSM_PASSWORD` in your environment or a `.env` file. Or pass `--username` and pipe the password to `--password-stdin`. OAuth 2.0 happens behind the scenes.
 
-Passwords are not accepted as a plain CLI flag — they would leak into shell history and `ps` output.
+## Library
 
-## Schema
-
-Four tables, identical in DuckDB and PostgreSQL — write once, query anywhere.
+```python
+from datetime import datetime, UTC
+from osmsg import RunConfig, run
 
-| Table | Purpose |
-|---|---|
-| `users` | uid → username |
-| `changesets` | metadata: hashtags, editor, bbox |
-| `changeset_stats` | flat counts + nested `tag_stats` JSON |
-| `state` | resume marker — exactly one row per source_url (UPSERTed each run) |
+result = run(RunConfig(
+    name="nepal",
+    countries=["nepal"],
+    start_date=datetime(2026, 4, 25, tzinfo=UTC),
+    end_date=datetime(2026, 4, 26, tzinfo=UTC),
+))
+print(result["files"]["parquet"])
+```
 
-`map_changes` is computed at query time as the sum of the nine element columns (`{nodes,ways,rels}_{created,modified,deleted}`); POI counters are tracked separately and never folded in.
+That's the same pipeline the CLI runs. See [docs/Manual.md](./docs/Manual.md) for everything else.
 
-## Developer setup
+## Develop
 
 ```bash
 git clone https://github.com/osgeonepal/osmsg && cd osmsg
 uv sync
-uv run pytest -m "not network"
+uv run pytest
 uv run osmsg --help
 ```
-
-See [docs/Manual.md](./docs/Manual.md) for the flag reference and [docs/Installation.md](./docs/Installation.md) for environment notes.

pyproject.toml

@@ -15,6 +15,7 @@ dependencies = [
     "pyarrow>=24.0.0",
     "pydantic>=2.13.3",
     "python-dotenv>=1.2.2",
+    "pytz>=2024.1",
     "requests>=2.32.5",
     "rich>=13.0",
     "shapely>=2.1.2",