diff options
author | Cody Bender <50554676+cfbender@users.noreply.github.com> | 2019-11-12 21:55:41 -0700 |
---|---|---|
committer | skullydazed <skullydazed@users.noreply.github.com> | 2019-11-12 20:55:41 -0800 |
commit | 7329c2d02d38f40a23d38f789de34057fd2acd42 (patch) | |
tree | bb4e0640164b71d60714b964a72025517c2ade61 /docs/cli.md | |
parent | 00fb1bd1f0550645997b61870d7d092494265a60 (diff) | |
download | qmk_firmware-7329c2d02d38f40a23d38f789de34057fd2acd42.tar.gz qmk_firmware-7329c2d02d38f40a23d38f789de34057fd2acd42.zip |
Add cli convert subcommand, from raw KLE to JSON (#6898)
* Add initial pass at KLE convert
* Add cli log on convert
* Move kle2xy, add absolute filepath arg support
* Add overwrite flag, and context sensitive conversion
* Update docs/cli.md
* Fix converter.py typo
* Add convert unit test
* Rename to kle2qmk
* Rename subcommand
* Rename subcommand to kle2json
* Change tests to cover rename
* Rename in __init__.py
* Update CLI docs with new subcommand name
* Fix from suggestions in PR #6898
* Help with cases of case sensitivity
* Update cli.md
* Use angle brackets to indicate required option
* Make the output text more accurate
Diffstat (limited to 'docs/cli.md')
-rw-r--r-- | docs/cli.md | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/cli.md b/docs/cli.md index e655b0ee8..fb7d17d2a 100644 --- a/docs/cli.md +++ b/docs/cli.md | |||
@@ -135,6 +135,28 @@ Creates a keymap.c from a QMK Configurator export. | |||
135 | qmk json-keymap [-o OUTPUT] filename | 135 | qmk json-keymap [-o OUTPUT] filename |
136 | ``` | 136 | ``` |
137 | 137 | ||
138 | ## `qmk kle2json` | ||
139 | |||
140 | This command allows you to convert from raw KLE data to QMK Configurator JSON. It accepts either an absolute file path, or a file name in the current directory. By default it will not overwrite `info.json` if it is already present. Use the `-f` or `--force` flag to overwrite. | ||
141 | |||
142 | **Usage**: | ||
143 | |||
144 | ``` | ||
145 | qmk kle2json [-f] <filename> | ||
146 | ``` | ||
147 | |||
148 | **Examples**: | ||
149 | |||
150 | ``` | ||
151 | $ qmk kle2json kle.txt | ||
152 | ☒ File info.json already exists, use -f or --force to overwrite. | ||
153 | ``` | ||
154 | |||
155 | ``` | ||
156 | $ qmk kle2json -f kle.txt -f | ||
157 | Ψ Wrote out to info.json | ||
158 | ``` | ||
159 | |||
138 | ## `qmk list-keyboards` | 160 | ## `qmk list-keyboards` |
139 | 161 | ||
140 | This command lists all the keyboards currently defined in `qmk_firmware` | 162 | This command lists all the keyboards currently defined in `qmk_firmware` |