From 15b513266da63d5d80605ce2e0768bb6ea5b534c Mon Sep 17 00:00:00 2001 From: Petr Date: Mon, 9 Mar 2026 13:11:36 +0100 Subject: [PATCH] Merge dev_scripts/ into scripts/ Move dev_run.py and test_sync.sh from dev_scripts/ to scripts/, eliminating the separate dev_scripts directory. Update scripts README with development scripts section. --- .gitignore | 2 +- dev_scripts/README.md | 25 ------------------------- scripts/README.md | 23 +++++++++++++++++++++++ {dev_scripts => scripts}/dev_run.py | 0 {dev_scripts => scripts}/test_sync.sh | 0 5 files changed, 24 insertions(+), 26 deletions(-) delete mode 100644 dev_scripts/README.md rename {dev_scripts => scripts}/dev_run.py (100%) rename {dev_scripts => scripts}/test_sync.sh (100%) diff --git a/.gitignore b/.gitignore index 4a42bdc..913d990 100644 --- a/.gitignore +++ b/.gitignore @@ -95,7 +95,7 @@ logs/ *.temp .cache/ prototypes/* -dev_scripts/metadata_writer/proposals/* +scripts/metadata_writer/proposals/* # Build outputs dist/ diff --git a/dev_scripts/README.md b/dev_scripts/README.md deleted file mode 100644 index bff152c..0000000 --- a/dev_scripts/README.md +++ /dev/null @@ -1,25 +0,0 @@ -# Development Scripts - -Development utilities for local testing without full production setup. - -## dev_run.py - -Flask development server with authentication bypass for local testing. - -**Usage:** -```bash -python3 dev_scripts/dev_run.py -``` - -**Features:** -- Bypasses Google OAuth (no client ID/secret needed) -- Direct catalog access: http://127.0.0.1:5000/dev-catalog -- Uses local `docs/metrics/` instead of `/data/docs/metrics` -- Debug mode enabled -- Hot reload on code changes - -**Quick Access:** -- Dashboard: http://127.0.0.1:5000/dev-login -- Direct to Catalog: http://127.0.0.1:5000/dev-catalog (recommended) - -**Note:** Only works in DEBUG mode (automatically enabled by script). diff --git a/scripts/README.md b/scripts/README.md index 5babb17..9079834 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -45,6 +45,29 @@ The script checks its own checksum before and after syncing scripts. If it detec **DuckDB corruption recovery:** If DuckDB file is corrupted (e.g., interrupted sync), it's automatically detected and recreated. All data is safe in parquet files - DuckDB only contains VIEW definitions. +## Development Scripts + +### `dev_run.py` + +Flask development server with authentication bypass for local testing. + +```bash +python3 scripts/dev_run.py +``` + +Starts a local Flask server at http://127.0.0.1:5000 with: +- Auth bypass routes (`/dev-login`, `/dev-catalog`) - no OAuth required +- Debug mode with hot reload + +### `test_sync.sh` + +Test rsync reliability with the data server. + +```bash +bash scripts/test_sync.sh # Full test sync +bash scripts/test_sync.sh --dry-run # Preview only +``` + ## Typical Workflow 1. **First time setup**: Follow bootstrap.yaml instructions diff --git a/dev_scripts/dev_run.py b/scripts/dev_run.py similarity index 100% rename from dev_scripts/dev_run.py rename to scripts/dev_run.py diff --git a/dev_scripts/test_sync.sh b/scripts/test_sync.sh similarity index 100% rename from dev_scripts/test_sync.sh rename to scripts/test_sync.sh