summaryrefslogtreecommitdiffstats
path: root/lib/python/qmk/cli/generate/keyboard_h.py
diff options
context:
space:
mode:
authorJoel Challis <git@zvecr.com>2021-05-01 02:00:04 +0100
committerGitHub <noreply@github.com>2021-05-01 02:00:04 +0100
commitfc2b51194c58140b096b4c953c703b7f3f6f1fbc (patch)
treec0594513f50a37881ee31d794aba29a053717376 /lib/python/qmk/cli/generate/keyboard_h.py
parent18dc12cd78448bffe4ad54aa15aa715ee959e64c (diff)
Allow <keyboard>.h to be optional when going data driven (#12706)
* Allow <keyboard>.h to be optional when going data driven * Remove stub files as no longer required * Rename function * Remove include of layouts.h for now * Take advantage of type=keyboard_folder * Take advantage of type=keyboard_folder - kb should still be mandatory
Diffstat (limited to 'lib/python/qmk/cli/generate/keyboard_h.py')
-rwxr-xr-xlib/python/qmk/cli/generate/keyboard_h.py60
1 files changed, 60 insertions, 0 deletions
diff --git a/lib/python/qmk/cli/generate/keyboard_h.py b/lib/python/qmk/cli/generate/keyboard_h.py
new file mode 100755
index 0000000000..5a2b3656ec
--- /dev/null
+++ b/lib/python/qmk/cli/generate/keyboard_h.py
@@ -0,0 +1,60 @@
+"""Used by the make system to generate keyboard.h from info.json.
+"""
+from milc import cli
+
+from qmk.decorators import automagic_keyboard, automagic_keymap
+from qmk.info import info_json
+from qmk.keyboard import keyboard_completer, keyboard_folder
+from qmk.path import is_keyboard, normpath
+
+
+def would_populate_layout_h(keyboard):
+ """Detect if a given keyboard is doing data driven layouts
+ """
+ # Build the info.json file
+ kb_info_json = info_json(keyboard)
+
+ for layout_name in kb_info_json['layouts']:
+ if kb_info_json['layouts'][layout_name]['c_macro']:
+ continue
+
+ if 'matrix' not in kb_info_json['layouts'][layout_name]['layout'][0]:
+ cli.log.debug('%s/%s: No matrix data!', keyboard, layout_name)
+ continue
+
+ return True
+
+ return False
+
+
+@cli.argument('-o', '--output', arg_only=True, type=normpath, help='File to write to')
+@cli.argument('-q', '--quiet', arg_only=True, action='store_true', help="Quiet mode, only output error messages")
+@cli.argument('-kb', '--keyboard', type=keyboard_folder, completer=keyboard_completer, required=True, help='Keyboard to generate keyboard.h for.')
+@cli.subcommand('Used by the make system to generate keyboard.h from info.json', hidden=True)
+@automagic_keyboard
+@automagic_keymap
+def generate_keyboard_h(cli):
+ """Generates the keyboard.h file.
+ """
+ has_layout_h = would_populate_layout_h(cli.config.generate_keyboard_h.keyboard)
+
+ # Build the layouts.h file.
+ keyboard_h_lines = ['/* This file was generated by `qmk generate-keyboard-h`. Do not edit or copy.' ' */', '', '#pragma once', '#include "quantum.h"']
+
+ if not has_layout_h:
+ keyboard_h_lines.append('#pragma error("<keyboard>.h is only optional for data driven keyboards - kb.h == bad times")')
+
+ # Show the results
+ keyboard_h = '\n'.join(keyboard_h_lines) + '\n'
+
+ if cli.args.output:
+ cli.args.output.parent.mkdir(parents=True, exist_ok=True)
+ if cli.args.output.exists():
+ cli.args.output.replace(cli.args.output.parent / (cli.args.output.name + '.bak'))
+ cli.args.output.write_text(keyboard_h)
+
+ if not cli.args.quiet:
+ cli.log.info('Wrote keyboard_h to %s.', cli.args.output)
+
+ else:
+ print(keyboard_h)