Refactor new-keyboard to be python3.7 compatible (#14707)
* Use copy_tree from distutils for python 3.7 support * Bump python version in docs * Changed new-keyboard to use printf-style format strings * Use username for manunfacturer / maintainer * Update lib/python/qmk/cli/new/keyboard.py Co-authored-by: Zach White <skullydazed@drpepper.org> Co-authored-by: Zach White <skullydazed@drpepper.org>
This commit is contained in:
		
							parent
							
								
									6437045166
								
							
						
					
					
						commit
						fefd7fdc51
					
				
					 13 changed files with 91 additions and 188 deletions
				
			
		| 
						 | 
				
			
			@ -1,19 +1,5 @@
 | 
			
		|||
/*
 | 
			
		||||
Copyright %YEAR% %YOUR_NAME%
 | 
			
		||||
 | 
			
		||||
This program is free software: you can redistribute it and/or modify
 | 
			
		||||
it under the terms of the GNU General Public License as published by
 | 
			
		||||
the Free Software Foundation, either version 2 of the License, or
 | 
			
		||||
(at your option) any later version.
 | 
			
		||||
 | 
			
		||||
This program is distributed in the hope that it will be useful,
 | 
			
		||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
			
		||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
			
		||||
GNU General Public License for more details.
 | 
			
		||||
 | 
			
		||||
You should have received a copy of the GNU General Public License
 | 
			
		||||
along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		||||
*/
 | 
			
		||||
// Copyright %(YEAR)s %(YOUR_NAME)s (@%(USER_NAME)s)
 | 
			
		||||
// SPDX-License-Identifier: GPL-2.0-or-later
 | 
			
		||||
 | 
			
		||||
#pragma once
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -23,8 +9,8 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		|||
#define VENDOR_ID    0xFEED
 | 
			
		||||
#define PRODUCT_ID   0x0000
 | 
			
		||||
#define DEVICE_VER   0x0001
 | 
			
		||||
#define MANUFACTURER %YOUR_NAME%
 | 
			
		||||
#define PRODUCT      %KEYBOARD%
 | 
			
		||||
#define MANUFACTURER %(USER_NAME)s
 | 
			
		||||
#define PRODUCT      %(KEYBOARD)s
 | 
			
		||||
 | 
			
		||||
/* key matrix size */
 | 
			
		||||
#define MATRIX_ROWS 2
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1,20 +1,20 @@
 | 
			
		|||
# %KEYBOARD%
 | 
			
		||||
# %(KEYBOARD)s
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
*A short description of the keyboard/project*
 | 
			
		||||
 | 
			
		||||
* Keyboard Maintainer: [%YOUR_NAME%](https://github.com/yourusername)
 | 
			
		||||
* Keyboard Maintainer: [%(YOUR_NAME)s](https://github.com/%(USER_NAME)s)
 | 
			
		||||
* Hardware Supported: *The PCBs, controllers supported*
 | 
			
		||||
* Hardware Availability: *Links to where you can find this hardware*
 | 
			
		||||
 | 
			
		||||
Make example for this keyboard (after setting up your build environment):
 | 
			
		||||
 | 
			
		||||
    make %KEYBOARD%:default
 | 
			
		||||
    make %(KEYBOARD)s:default
 | 
			
		||||
 | 
			
		||||
Flashing example for this keyboard:
 | 
			
		||||
 | 
			
		||||
    make %KEYBOARD%:default:flash
 | 
			
		||||
    make %(KEYBOARD)s:default:flash
 | 
			
		||||
 | 
			
		||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
							
								
								
									
										4
									
								
								data/templates/base/%(KEYBOARD)s.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										4
									
								
								data/templates/base/%(KEYBOARD)s.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,4 @@
 | 
			
		|||
// Copyright %(YEAR)s %(YOUR_NAME)s (@%(USER_NAME)s)
 | 
			
		||||
// SPDX-License-Identifier: GPL-2.0-or-later
 | 
			
		||||
 | 
			
		||||
#include "%(KEYBOARD)s.h"
 | 
			
		||||
							
								
								
									
										22
									
								
								data/templates/base/%(KEYBOARD)s.h
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										22
									
								
								data/templates/base/%(KEYBOARD)s.h
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,22 @@
 | 
			
		|||
// Copyright %(YEAR)s %(YOUR_NAME)s (@%(USER_NAME)s)
 | 
			
		||||
// SPDX-License-Identifier: GPL-2.0-or-later
 | 
			
		||||
 | 
			
		||||
#pragma once
 | 
			
		||||
 | 
			
		||||
#include "quantum.h"
 | 
			
		||||
 | 
			
		||||
/* This is a shortcut to help you visually see your layout.
 | 
			
		||||
 *
 | 
			
		||||
 * The first section contains all of the arguments representing the physical
 | 
			
		||||
 * layout of the board and position of the keys.
 | 
			
		||||
 *
 | 
			
		||||
 * The second converts the arguments into a two-dimensional array which
 | 
			
		||||
 * represents the switch matrix.
 | 
			
		||||
 */
 | 
			
		||||
#define LAYOUT( \
 | 
			
		||||
    k00, k01, k02, \
 | 
			
		||||
      k10,  k12    \
 | 
			
		||||
) { \
 | 
			
		||||
    { k00, k01,   k02 }, \
 | 
			
		||||
    { k10, KC_NO, k12 }  \
 | 
			
		||||
}
 | 
			
		||||
| 
						 | 
				
			
			@ -1,7 +1,7 @@
 | 
			
		|||
{
 | 
			
		||||
    "keyboard_name": "%KEYBOARD%",
 | 
			
		||||
    "keyboard_name": "%(KEYBOARD)s",
 | 
			
		||||
    "url": "",
 | 
			
		||||
    "maintainer": "%YOUR_NAME%",
 | 
			
		||||
    "maintainer": "%(USER_NAME)s",
 | 
			
		||||
    "layouts": {
 | 
			
		||||
        "LAYOUT": {
 | 
			
		||||
            "layout": [
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1,17 +0,0 @@
 | 
			
		|||
/* Copyright %YEAR% %YOUR_NAME%
 | 
			
		||||
 *
 | 
			
		||||
 * This program is free software: you can redistribute it and/or modify
 | 
			
		||||
 * it under the terms of the GNU General Public License as published by
 | 
			
		||||
 * the Free Software Foundation, either version 2 of the License, or
 | 
			
		||||
 * (at your option) any later version.
 | 
			
		||||
 *
 | 
			
		||||
 * This program is distributed in the hope that it will be useful,
 | 
			
		||||
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
			
		||||
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
			
		||||
 * GNU General Public License for more details.
 | 
			
		||||
 *
 | 
			
		||||
 * You should have received a copy of the GNU General Public License
 | 
			
		||||
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#include "%KEYBOARD%.h"
 | 
			
		||||
| 
						 | 
				
			
			@ -1,35 +0,0 @@
 | 
			
		|||
/* Copyright %YEAR% %YOUR_NAME%
 | 
			
		||||
 *
 | 
			
		||||
 * This program is free software: you can redistribute it and/or modify
 | 
			
		||||
 * it under the terms of the GNU General Public License as published by
 | 
			
		||||
 * the Free Software Foundation, either version 2 of the License, or
 | 
			
		||||
 * (at your option) any later version.
 | 
			
		||||
 *
 | 
			
		||||
 * This program is distributed in the hope that it will be useful,
 | 
			
		||||
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
			
		||||
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
			
		||||
 * GNU General Public License for more details.
 | 
			
		||||
 *
 | 
			
		||||
 * You should have received a copy of the GNU General Public License
 | 
			
		||||
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#pragma once
 | 
			
		||||
 | 
			
		||||
#include "quantum.h"
 | 
			
		||||
 | 
			
		||||
/* This is a shortcut to help you visually see your layout.
 | 
			
		||||
 *
 | 
			
		||||
 * The first section contains all of the arguments representing the physical
 | 
			
		||||
 * layout of the board and position of the keys.
 | 
			
		||||
 *
 | 
			
		||||
 * The second converts the arguments into a two-dimensional array which
 | 
			
		||||
 * represents the switch matrix.
 | 
			
		||||
 */
 | 
			
		||||
#define LAYOUT( \
 | 
			
		||||
    k00, k01, k02, \
 | 
			
		||||
      k10,  k12    \
 | 
			
		||||
) { \
 | 
			
		||||
    { k00, k01,   k02 }, \
 | 
			
		||||
    { k10, KC_NO, k12 }  \
 | 
			
		||||
}
 | 
			
		||||
| 
						 | 
				
			
			@ -1,18 +1,6 @@
 | 
			
		|||
/* Copyright %YEAR% %YOUR_NAME%
 | 
			
		||||
 *
 | 
			
		||||
 * This program is free software: you can redistribute it and/or modify
 | 
			
		||||
 * it under the terms of the GNU General Public License as published by
 | 
			
		||||
 * the Free Software Foundation, either version 2 of the License, or
 | 
			
		||||
 * (at your option) any later version.
 | 
			
		||||
 *
 | 
			
		||||
 * This program is distributed in the hope that it will be useful,
 | 
			
		||||
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
			
		||||
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
			
		||||
 * GNU General Public License for more details.
 | 
			
		||||
 *
 | 
			
		||||
 * You should have received a copy of the GNU General Public License
 | 
			
		||||
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		||||
 */
 | 
			
		||||
// Copyright %(YEAR)s %(YOUR_NAME)s (@%(USER_NAME)s)
 | 
			
		||||
// SPDX-License-Identifier: GPL-2.0-or-later
 | 
			
		||||
 | 
			
		||||
#include QMK_KEYBOARD_H
 | 
			
		||||
 | 
			
		||||
// Defines names for use in layer keycodes and the keymap
 | 
			
		||||
| 
						 | 
				
			
			@ -21,12 +9,6 @@ enum layer_names {
 | 
			
		|||
    _FN
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// Defines the keycodes used by our macros in process_record_user
 | 
			
		||||
enum custom_keycodes {
 | 
			
		||||
    QMKBEST = SAFE_RANGE,
 | 
			
		||||
    QMKURL
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
 | 
			
		||||
    /* Base */
 | 
			
		||||
    [_BASE] = LAYOUT(
 | 
			
		||||
| 
						 | 
				
			
			@ -34,29 +16,7 @@ const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
 | 
			
		|||
            KC_TAB,   KC_SPC
 | 
			
		||||
    ),
 | 
			
		||||
    [_FN] = LAYOUT(
 | 
			
		||||
        QMKBEST, QMKURL,  _______,
 | 
			
		||||
        _______, _______,  _______,
 | 
			
		||||
            RESET,    XXXXXXX
 | 
			
		||||
    )
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
bool process_record_user(uint16_t keycode, keyrecord_t *record) {
 | 
			
		||||
    switch (keycode) {
 | 
			
		||||
        case QMKBEST:
 | 
			
		||||
            if (record->event.pressed) {
 | 
			
		||||
                // when keycode QMKBEST is pressed
 | 
			
		||||
                SEND_STRING("QMK is the best thing ever!");
 | 
			
		||||
            } else {
 | 
			
		||||
                // when keycode QMKBEST is released
 | 
			
		||||
            }
 | 
			
		||||
            break;
 | 
			
		||||
        case QMKURL:
 | 
			
		||||
            if (record->event.pressed) {
 | 
			
		||||
                // when keycode QMKURL is pressed
 | 
			
		||||
                SEND_STRING("https://qmk.fm/\n");
 | 
			
		||||
            } else {
 | 
			
		||||
                // when keycode QMKURL is released
 | 
			
		||||
            }
 | 
			
		||||
            break;
 | 
			
		||||
    }
 | 
			
		||||
    return true;
 | 
			
		||||
}
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1 +1 @@
 | 
			
		|||
# The default keymap for %KEYBOARD%
 | 
			
		||||
# The default keymap for %(KEYBOARD)s
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1,19 +1,5 @@
 | 
			
		|||
/*
 | 
			
		||||
Copyright %YEAR% %YOUR_NAME%
 | 
			
		||||
 | 
			
		||||
This program is free software: you can redistribute it and/or modify
 | 
			
		||||
it under the terms of the GNU General Public License as published by
 | 
			
		||||
the Free Software Foundation, either version 2 of the License, or
 | 
			
		||||
(at your option) any later version.
 | 
			
		||||
 | 
			
		||||
This program is distributed in the hope that it will be useful,
 | 
			
		||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
			
		||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
			
		||||
GNU General Public License for more details.
 | 
			
		||||
 | 
			
		||||
You should have received a copy of the GNU General Public License
 | 
			
		||||
along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		||||
*/
 | 
			
		||||
// Copyright %(YEAR)s %(YOUR_NAME)s (@%(USER_NAME)s)
 | 
			
		||||
// SPDX-License-Identifier: GPL-2.0-or-later
 | 
			
		||||
 | 
			
		||||
#pragma once
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -23,8 +9,8 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
			
		|||
#define VENDOR_ID    0xFEED
 | 
			
		||||
#define PRODUCT_ID   0x0000
 | 
			
		||||
#define DEVICE_VER   0x0001
 | 
			
		||||
#define MANUFACTURER %YOUR_NAME%
 | 
			
		||||
#define PRODUCT      %KEYBOARD%
 | 
			
		||||
#define MANUFACTURER %(USER_NAME)s
 | 
			
		||||
#define PRODUCT      %(KEYBOARD)s
 | 
			
		||||
 | 
			
		||||
/* key matrix size */
 | 
			
		||||
#define MATRIX_ROWS 8
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1,20 +1,20 @@
 | 
			
		|||
# %KEYBOARD%
 | 
			
		||||
# %(KEYBOARD)s
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
*A short description of the keyboard/project*
 | 
			
		||||
 | 
			
		||||
* Keyboard Maintainer: [%YOUR_NAME%](https://github.com/yourusername)
 | 
			
		||||
* Keyboard Maintainer: [%(YOUR_NAME)s](https://github.com/yourusername)
 | 
			
		||||
* Hardware Supported: *The PCBs, controllers supported*
 | 
			
		||||
* Hardware Availability: *Links to where you can find this hardware*
 | 
			
		||||
 | 
			
		||||
Make example for this keyboard (after setting up your build environment):
 | 
			
		||||
 | 
			
		||||
    make %KEYBOARD%:default
 | 
			
		||||
    make %(KEYBOARD)s:default
 | 
			
		||||
 | 
			
		||||
Flashing example for this keyboard ([after setting up the bootloadHID flashing environment](https://docs.qmk.fm/#/flashing_bootloadhid))
 | 
			
		||||
 | 
			
		||||
    make %KEYBOARD%:default:flash
 | 
			
		||||
    make %(KEYBOARD)s:default:flash
 | 
			
		||||
 | 
			
		||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue