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.
This commit is contained in:
Petr 2026-03-09 13:11:36 +01:00
parent 2d3f127e58
commit 15b513266d
5 changed files with 24 additions and 26 deletions

2
.gitignore vendored
View file

@ -95,7 +95,7 @@ logs/
*.temp
.cache/
prototypes/*
dev_scripts/metadata_writer/proposals/*
scripts/metadata_writer/proposals/*
# Build outputs
dist/

View file

@ -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).

View file

@ -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