docs: clarify format example coverage
This commit is contained in:
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user