docs: clarify format example coverage

This commit is contained in:
SG Command
2026-10-03 05:09:00 +02:00
parent 54041228c9
commit 519ee4f6eb
+6 -5
View File
@@ -1,9 +1,10 @@
# Format Usage Examples # Format Usage Examples
Examples for `relspec convert` covering every reader and writer format. The Examples for `relspec convert` covering the file-based reader and writer
"Writers" and "Readers" sections below were run against `examples/test_schema.dbml`. formats. The "Writers" and "Readers" sections below were run against
The cross-format and live-database examples were not run; they follow the flags `examples/test_schema.dbml`. The cross-format and live-database examples were
shown in `relspec convert --help`. not run; they follow the flags shown in `relspec convert --help` and require
matching input files or reachable databases.
Any reader can be combined with any writer: pick `--from`/`--from-path` for the Any reader can be combined with any writer: pick `--from`/`--from-path` for the
source and `--to`/`--to-path` for the target. Add `--silent` to suppress progress source and `--to`/`--to-path` for the target. Add `--silent` to suppress progress
@@ -38,7 +39,7 @@ Notes:
`--flatten-schema` for other formats if the target has no schema support. `--flatten-schema` for other formats if the target has no schema support.
- `dctx` supports a single schema only; use `--schema <name>` to select one. - `dctx` supports a single schema only; use `--schema <name>` to select one.
## Readers: every format back to DBML ## Readers: file-based formats into DBML (or JSON where noted)
```bash ```bash
relspec convert --from json --from-path schema.json --to dbml --to-path out.dbml relspec convert --from json --from-path schema.json --to dbml --to-path out.dbml