Scripts, templates, and examples for managing KiCad projects.
Project description
kicad-helpers
Scripts, templates, and examples for managing KiCad projects.
Project goals:
- provide a sensible default project structure and scripts for managing KiCad projects with git
- automate anything that can be automated (update BOMs, produce manufacturing files, run tests, generate documentation, etc.)
- configure git and KiCad to play nicely together
- support customization via command line arguments, environment variables, etc.
- make everything easy to install/setup/use
- make awesome documentation
Install
pip install kicad_helpers
How to use
Navigate to the directory containing your KiCad project:
cd KICAD/PROJECT/PATH
Run the kh_update
script to update all project templates:
kh_update --help
usage: kh_update [-h] [--v] [--overwrite] [--root ROOT]
Update project templates from the `kicad_helpers/templates` directory (ignoring anything in the project's `.gitignore`
list).
optional arguments:
-h, --help show this help message and exit
--v verbose (default: False)
--overwrite overwrite existing templates (default: False)
--root ROOT project root directory (default: .)
The following templates are installed by default:
- .github/workflows/build.yml: a github workflow for updating the BOM, producing manufacturing files, running tests, generating documentation, etc.
- kitspace.yaml: metadata file for the kitspace service
- .kicad_helpers_config/config.kibot.yaml: configuration file for KiBot which allow automation of various KiCad actions
- .kicad_helpers_config/manufacturers/PCBWay.kibot.yaml: KiBot configuration to generate manufacturing files for PCBWay
To overwrite existing templates, run the command with the --overwrite
flag, e.g.:
kh_update --v --overwrite
kitspace.yaml already exists
Rendering kitspace.yaml template.
.github/workflows/build.yml already exists
Rendering .github/workflows/build.yml template.
.kicad_helpers_config/config.kibot.yaml already exists
Rendering .kicad_helpers_config/config.kibot.yaml template.
.kicad_helpers_config/manufacturers/PCBWay.kibot.yaml already exists
Rendering .kicad_helpers_config/manufacturers/PCBWay.kibot.yaml template.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kicad_helpers-0.6.1.tar.gz
(18.7 kB
view hashes)
Built Distribution
Close
Hashes for kicad_helpers-0.6.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82b34d89523a967822277fac03d6fbf3f1ee61e07ff766644a0658f843e6bf49 |
|
MD5 | eb5addd91062fbda6ea4ebb59342fe5f |
|
BLAKE2b-256 | 65ba10c250080ed3646d9b9ddab913e8ac65ebfea3fea7c60d58cae7354406ca |