Skip to content

Commit 1ebf085

Browse files
authored
Enhance README with tool features and quick start
Expanded README with detailed tool description and highlights.
1 parent 14bc2a8 commit 1ebf085

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,20 @@
11
# ods2sql-python
22
One-file, pure-stdlib Python tool that converts instrumented LibreOffice .ods sheets into SQL for SQLite/Postgres/MySQL.
3+
4+
ods2sql-python is a single-file, dependency-free CLI that reads native LibreOffice Calc .ods files (via zipfile + xml.etree) and emits SQL you can pipe directly into your database. Instrument your sheet with a tiny first-column markup (sqltable, header, sqltype, comment) and get reproducible CREATE TABLE and INSERT statements—perfect for quick ETL, data audits, and sharing spreadsheet data as a real database.
5+
6+
## Highlights
7+
8+
- Pure standard library (no external deps)
9+
- Multiple sheets & tables per file
10+
- Column selection via header; types via sqltype (defaults to TEXT)
11+
- Dialects: SQLite (default), Postgres, MySQL (quoting + booleans)
12+
- Fast batched INSERTs; --schema-only, --data-only, --list, --table
13+
- Emits SQL on stdout; diagnostics on stderr (pipe-safe)
14+
15+
## Quick start
16+
17+
```bash
18+
./ods2sql.py data.ods | sqlite3 data.sqlite
19+
./ods2sql.py data.ods --dialect postgres --batch 1000 > load.sql
20+
```

0 commit comments

Comments
 (0)