kikit 1.8.0__tar.gz

kikit-1.8.0/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Jan Mrázek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kikit-1.8.0/MANIFEST.in

@@ -0,0 +1,6 @@
+recursive-include kikit/resources *
+recursive-exclude kikit/resources package*.json src postcss.config.js tailwind.config.js
+prune kikit/resources/**/node_modules
+recursive-exclude doc *include versioneer.py
+include kikit/_version.py
+include versioneer.py

kikit-1.8.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.1
+Name: kikit
+Version: 1.8.0
+Summary: Automation for KiCAD boards
+Home-page: https://github.com/yaqwsx/KiKit
+Author: Jan Mrázek
+Author-email: email@honzamrazek.cz
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+License-File: LICENCE
+
+# KiKit – Automation for KiCAD
+
+![KiKit Logo](https://github.com/yaqwsx/KiKit/raw/master/kikit/resources/graphics/kikitIcon_64x64.png)
+
+KiKit is a Python library, KiCAD plugin and  a CLI tool to automate several
+tasks in a standard KiCAD workflow like:
+
+- panelization of both, regular and oddly shaped, boards (see
+  [examples](https://yaqwsx.github.io/KiKit/latest/panelization/examples/))
+- automated exporting manufacturing data based on manufacturer presets
+- multi-board project in KiCAD
+- building board presentation pages (see [an example presentation page generated
+  by KiKit](https://roboticsbrno.github.io/RB0002-BatteryPack))
+
+![KiKit Promo](https://github.com/yaqwsx/KiKit/blob/master/docs/resources/promo.jpg?raw=true)
+
+## Do You Enjoy KiKit or Does It Save You Time?
+
+Then definitely consider:
+
+- [**supporting me on GitHub Sponsors**](https://github.com/sponsors/yaqwsx)
+- or become my [Patreon](https://patreon.com/yaqwsx),
+- or buy me a coffee: [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/E1E2181LU)
+
+Your support will allow me to allocate time to properly maintain my projects
+like this.
+
+PS: Be sure to check out my other KiCAD & PCB related projects:
+
+- [Pinion](https://github.com/yaqwsx/Pinion/)
+- [PcbDraw](https://github.com/yaqwsx/PcbDraw/)
+- [JlcParts](https://github.com/yaqwsx/jlcparts)
+
+## Installation
+
+KiKit is available as a [PyPi package](https://pypi.org/project/KiKit/).
+However, due to packaging of KiCAD, installation on some platforms requires
+usage of specific Python interpreter.
+
+Please follow the detailed [installation
+guide](https://yaqwsx.github.io/KiKit/latest/installation/intro/) that covers
+installation based on the platform you use.
+
+## Why Should I Use It?
+
+Everything KiKit does, can also be done via Pcbnew in KiCAD. However, you have
+to do it manually. One of the common scenarios is the creation of panels. Most
+of the tutorials on the internet guide you to use the "append board"
+functionality of Pcbnew. However, this approach is labour-intensive, error-prone
+and whenever, you change the board, you have to do it again.
+
+With KiKit you just call a CLI command if you have a simple layout (e.g., a
+grid) or write few Python instructions like "place board here", "add bridge
+here", "separate boards via mouse bites/v-cuts" and you are done. The process is
+repeatable and actually much simpler than hand-drawing the panels. KiKit also
+allows you to easily export all the Gerbers in a single step.
+
+You can then write a Makefile and simply call `make` to get all your
+manufacturing data and board presentation pages.
+
+## Feature List
+
+- create panels by appending boards and pieces of substrate (bridges)
+- supports board with arbitrary shapes
+- easily create mouse-bites/V-CUTS
+- compared to hand-creation of panels, your panels will pass DRC (as tracks from
+  different instances of the same board have distinct nets when using KiKit)
+- if you have multiple boards in a single file, you can split them
+- simplifying [multi-board project in KiCAD](https://yaqwsx.github.io/KiKit/latest/multiboard/)
+- [automated export of gerbers and assembly data](https://yaqwsx.github.io/KiKit/latest/fabrication/intro/)
+- [3D printed self-registering solder paste stencils](https://yaqwsx.github.io/KiKit/upstream/latest/stencil/#3d-printed-stencils)
+- [steel stencils with alignment jig](https://yaqwsx.github.io/KiKit/latest/stencil/#steel-stencils)
+- create powerfull shell scrips or Makefiles which automates your workflow...
+- ...or invoke the functionality via [GUI in KiCAD](https://yaqwsx.github.io/KiKit/latest/panelization/gui/).
+
+## How To Use It?
+
+Start with reading the [panelization
+documentation](https://yaqwsx.github.io/KiKit/latest/panelization/intro/). This
+page will you guide through CLI, GUI and scripting usage. Also don't miss the
+[examples](https://yaqwsx.github.io/KiKit/latest/panelization/examples/).
+There is also a quick note on how to use [panelization action
+plugin](https://yaqwsx.github.io/KiKit/latest/panelization/gui/). If you are
+interested in generating solder paste stencils, see [Stencil
+documentation](https://yaqwsx.github.io/KiKit/latest/stencil/)
+
+## Acknowledgements
+
+The project is supported by:
+
+- [My GitHub sponsors](https://github.com/sponsors/yaqwsx) and
+- [<img src="https://nlnet.nl/logo/banner.svg" width="150"/>](https://nlnet.nl/project/KiKit/#ack)
+
+## KiKit Is Broken or Does Not Work as Expected
+
+Please, first check [FAQ](https://yaqwsx.github.io/KiKit/latest/faq/). If you have not found answer for your
+problem there, feel free to open an issue on GitHub.
+
+If you would like to have a feature in KiKit that is currently not on a roadmap,
+or if you need to prepare custom panelization script (e.g., multi-design panels,
+panels with specific arrangement), you can consider hiring me to do the job.
+Just reach out to me via e-mail and we can discuss further details.

kikit-1.8.0/README.md

@@ -0,0 +1,102 @@
+# KiKit – Automation for KiCAD
+
+![KiKit Logo](https://github.com/yaqwsx/KiKit/raw/master/kikit/resources/graphics/kikitIcon_64x64.png)
+
+KiKit is a Python library, KiCAD plugin and  a CLI tool to automate several
+tasks in a standard KiCAD workflow like:
+
+- panelization of both, regular and oddly shaped, boards (see
+  [examples](https://yaqwsx.github.io/KiKit/latest/panelization/examples/))
+- automated exporting manufacturing data based on manufacturer presets
+- multi-board project in KiCAD
+- building board presentation pages (see [an example presentation page generated
+  by KiKit](https://roboticsbrno.github.io/RB0002-BatteryPack))
+
+![KiKit Promo](https://github.com/yaqwsx/KiKit/blob/master/docs/resources/promo.jpg?raw=true)
+
+## Do You Enjoy KiKit or Does It Save You Time?
+
+Then definitely consider:
+
+- [**supporting me on GitHub Sponsors**](https://github.com/sponsors/yaqwsx)
+- or become my [Patreon](https://patreon.com/yaqwsx),
+- or buy me a coffee: [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/E1E2181LU)
+
+Your support will allow me to allocate time to properly maintain my projects
+like this.
+
+PS: Be sure to check out my other KiCAD & PCB related projects:
+
+- [Pinion](https://github.com/yaqwsx/Pinion/)
+- [PcbDraw](https://github.com/yaqwsx/PcbDraw/)
+- [JlcParts](https://github.com/yaqwsx/jlcparts)
+
+## Installation
+
+KiKit is available as a [PyPi package](https://pypi.org/project/KiKit/).
+However, due to packaging of KiCAD, installation on some platforms requires
+usage of specific Python interpreter.
+
+Please follow the detailed [installation
+guide](https://yaqwsx.github.io/KiKit/latest/installation/intro/) that covers
+installation based on the platform you use.
+
+## Why Should I Use It?
+
+Everything KiKit does, can also be done via Pcbnew in KiCAD. However, you have
+to do it manually. One of the common scenarios is the creation of panels. Most
+of the tutorials on the internet guide you to use the "append board"
+functionality of Pcbnew. However, this approach is labour-intensive, error-prone
+and whenever, you change the board, you have to do it again.
+
+With KiKit you just call a CLI command if you have a simple layout (e.g., a
+grid) or write few Python instructions like "place board here", "add bridge
+here", "separate boards via mouse bites/v-cuts" and you are done. The process is
+repeatable and actually much simpler than hand-drawing the panels. KiKit also
+allows you to easily export all the Gerbers in a single step.
+
+You can then write a Makefile and simply call `make` to get all your
+manufacturing data and board presentation pages.
+
+## Feature List
+
+- create panels by appending boards and pieces of substrate (bridges)
+- supports board with arbitrary shapes
+- easily create mouse-bites/V-CUTS
+- compared to hand-creation of panels, your panels will pass DRC (as tracks from
+  different instances of the same board have distinct nets when using KiKit)
+- if you have multiple boards in a single file, you can split them
+- simplifying [multi-board project in KiCAD](https://yaqwsx.github.io/KiKit/latest/multiboard/)
+- [automated export of gerbers and assembly data](https://yaqwsx.github.io/KiKit/latest/fabrication/intro/)
+- [3D printed self-registering solder paste stencils](https://yaqwsx.github.io/KiKit/upstream/latest/stencil/#3d-printed-stencils)
+- [steel stencils with alignment jig](https://yaqwsx.github.io/KiKit/latest/stencil/#steel-stencils)
+- create powerfull shell scrips or Makefiles which automates your workflow...
+- ...or invoke the functionality via [GUI in KiCAD](https://yaqwsx.github.io/KiKit/latest/panelization/gui/).
+
+## How To Use It?
+
+Start with reading the [panelization
+documentation](https://yaqwsx.github.io/KiKit/latest/panelization/intro/). This
+page will you guide through CLI, GUI and scripting usage. Also don't miss the
+[examples](https://yaqwsx.github.io/KiKit/latest/panelization/examples/).
+There is also a quick note on how to use [panelization action
+plugin](https://yaqwsx.github.io/KiKit/latest/panelization/gui/). If you are
+interested in generating solder paste stencils, see [Stencil
+documentation](https://yaqwsx.github.io/KiKit/latest/stencil/)
+
+## Acknowledgements
+
+The project is supported by:
+
+- [My GitHub sponsors](https://github.com/sponsors/yaqwsx) and
+- [<img src="https://nlnet.nl/logo/banner.svg" width="150"/>](https://nlnet.nl/project/KiKit/#ack)
+
+## KiKit Is Broken or Does Not Work as Expected
+
+Please, first check [FAQ](https://yaqwsx.github.io/KiKit/latest/faq/). If you have not found answer for your
+problem there, feel free to open an issue on GitHub.
+
+If you would like to have a feature in KiKit that is currently not on a roadmap,
+or if you need to prepare custom panelization script (e.g., multi-design panels,
+panels with specific arrangement), you can consider hiring me to do the job.
+Just reach out to me via e-mail and we can discuss further details.

kikit-1.8.0/kikit/__init__.py

@@ -0,0 +1,3 @@
+
+from . import _version
+__version__ = _version.get_versions()['version']

kikit-1.8.0/kikit/_version.py

@@ -0,0 +1,21 @@
+
+# This file was generated by 'versioneer.py' (0.29) from
+# revision-control system data, or from the parent directory name of an
+# unpacked source archive. Distribution tarballs contain a pre-generated copy
+# of this file.
+
+import json
+
+version_json = '''
+{
+ "date": "2026-04-12T12:10:08+0200",
+ "dirty": false,
+ "error": null,
+ "full-revisionid": "6eb4e7aed72165c0179af485a1a1de2d98abfe95",
+ "version": "1.8.0"
+}
+'''  # END VERSION_JSON
+
+
+def get_versions():
+    return json.loads(version_json)

kikit-1.8.0/kikit/actionPlugins/__init__.py

@@ -0,0 +1,26 @@
+from dataclasses import dataclass
+
+@dataclass
+class KiKitActionPlugin:
+    package: str
+    name: str
+    description: str
+
+availablePlugins = [
+    KiKitActionPlugin("hideReferences", "Show/hide references",
+        "Allows you to batch show or hide references based on regular expression"),
+    KiKitActionPlugin("panelize", "Panelize design",
+        "Allows you to specify panelization process via GUI")
+]
+
+def importAllPlugins():
+    """
+    Bring all plugins that KiKit offers into a the global namespace. This
+    function is impure as it modifies the global variable scope. The purpose
+    of this function is to allow the PCM proxy to operate.
+    """
+    import importlib
+
+    for plugin in availablePlugins:
+        module = importlib.import_module(f"kikit.actionPlugins.{plugin.package}")
+        module.plugin().register()

kikit-1.8.0/kikit/actionPlugins/common.py

@@ -0,0 +1,25 @@
+import wx
+import threading
+
+app = None
+
+def initDialog(initFn):
+    global app
+    try:
+        return initFn()
+    except Exception:
+        try:
+            # Some Linux distributions ship incompatible wxPhoenix version.
+            # So we start a custom wxApp loop
+            app = wx.App()
+            app.InitLocale()
+            t = threading.Thread(target=app.MainLoop)
+            t.daemon = True
+            t.start()
+            return initFn()
+        except Exception as e:
+            raise e from None
+
+def destroyDialog(dialog):
+    if dialog is not None:
+        dialog.Destroy()

kikit-1.8.0/kikit/actionPlugins/hideReferences.py

@@ -0,0 +1,302 @@
+import pcbnew
+import wx
+import re
+import os
+import kikit
+from kikit import modify
+from kikit.defs import Layer
+from kikit.common import PKG_BASE
+from .common import initDialog, destroyDialog
+
+class HideReferencesDialog(wx.Dialog):
+    def __init__(self, state, parent=None, board=None, action=None, updateState=None):
+        wx.Dialog.__init__(self,
+            parent,
+            title=f'Specify which components to hide (version {kikit.__version__})',
+            style=wx.RESIZE_BORDER | wx.DEFAULT_DIALOG_STYLE)
+        self.board = board
+        self.actionCallback = action
+        self.updateStatusCallback = updateState
+        self.text = ""
+        self.selectedItemOnly = False
+
+        self.Bind(wx.EVT_CLOSE, self.OnCancel, id=self.GetId())
+        self.Bind(wx.EVT_SIZE, self.OnSize)
+
+        self.SetMinSize(wx.Size(520, 620))
+
+        panel = self
+
+        vbox = wx.BoxSizer(wx.VERTICAL)
+        self.item_grid = wx.FlexGridSizer(0, 2, 3, 5)
+        self.item_grid.AddGrowableCol(1)
+
+        label = wx.StaticText(panel,
+            label="Apply to labels pattern:\n(regular expression)",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT)
+        label.Wrap(200)
+        self.item_grid.Add(label, 1, wx.ALIGN_CENTRE_VERTICAL)
+        self.pattern = wx.TextCtrl(panel, style=wx.TE_LEFT, value=state.get("pattern", ".*"),
+            size=wx.Size(350, -1))
+        self.Bind(wx.EVT_TEXT, self.OnPatternChange, id=self.pattern.GetId())
+        self.item_grid.Add(self.pattern, 0, wx.EXPAND)
+
+        label = wx.StaticText(panel, label="Only Selected items:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT)
+        label.Wrap(200)
+        self.item_grid.Add(label, 1, wx.ALIGN_CENTRE_VERTICAL)
+        self.selected_only = wx.CheckBox(panel, style=wx.CHK_2STATE)
+        self.Bind(wx.EVT_CHECKBOX, self.OnselectedItemOnlyChange)
+        self.selected_only.SetValue(self.selectedItemOnly)
+        self.item_grid.Add(self.selected_only, 0, wx.EXPAND)
+
+        label = wx.StaticText(panel, label="What to do:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT)
+        label.Wrap(200)
+        self.item_grid.Add(label, 1, wx.ALIGN_CENTRE_VERTICAL)
+        self.action = wx.Choice(panel, style=wx.CB_DROPDOWN,
+            choices=["Show", "Hide"])
+        self.action.SetSelection(state.get("action", 1))
+        self.item_grid.Add(self.action, 0, wx.EXPAND)
+
+        label = wx.StaticText(panel, label="Apply to:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT)
+        label.Wrap(200)
+        self.item_grid.Add(label, 1, wx.ALIGN_CENTRE_VERTICAL)
+        self.scope = wx.Choice(panel, style=wx.CB_DROPDOWN,
+            choices=["References only", "Values only", "References and values"])
+        self.scope.SetSelection(state.get("scope", 2))
+        self.item_grid.Add(self.scope, 0, wx.EXPAND)
+
+        label = wx.StaticText(panel, label="Layers to include:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT | wx.ALIGN_TOP)
+        label.Wrap(200)
+        self.item_grid.Add(label, 0, wx.ALIGN_CENTRE_VERTICAL)
+
+        self.layers = wx.CheckListBox(panel, choices=[str(Layer(l).name) for l in Layer.all()])
+        layerCheckState = state.get("layers", [True for _ in Layer.all()])
+        for l, checked in zip(Layer.all(), layerCheckState):
+            self.layers.Check(l, checked)
+        self.item_grid.Add(self.layers, 0, wx.EXPAND)
+
+        label = wx.StaticText(panel, label="Select layers:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT | wx.ALIGN_TOP)
+        label.Wrap(200)
+        self.item_grid.Add(label, 0, wx.ALIGN_CENTRE_VERTICAL)
+
+        buttonGrid = wx.FlexGridSizer(0, 2, 3, 5)
+        buttonGrid.AddGrowableCol(0)
+        buttonGrid.AddGrowableCol(1)
+        self.item_grid.Add(buttonGrid, 0, wx.EXPAND)
+
+        allLayersBtn = wx.Button(panel, label='All layers')
+        self.Bind(wx.EVT_BUTTON, self.OnAllLayers, id=allLayersBtn.GetId())
+        buttonGrid.Add(allLayersBtn, 1, wx.EXPAND)
+
+        noLayersBtn = wx.Button(panel, label='No layers')
+        self.Bind(wx.EVT_BUTTON, self.OnNoLayers, id=noLayersBtn.GetId())
+        buttonGrid.Add(noLayersBtn, 1, wx.EXPAND)
+
+        techLayersBtn = wx.Button(panel, label='Toggle technical layers')
+        self.Bind(wx.EVT_BUTTON, self.OnTechnicalLayers, id=techLayersBtn.GetId())
+        buttonGrid.Add(techLayersBtn, 1, wx.EXPAND)
+
+        silkLayersBtn = wx.Button(panel, label='Toggle silkscreen layers')
+        self.Bind(wx.EVT_BUTTON, self.OnSilkscreenLayers, id=silkLayersBtn.GetId())
+        buttonGrid.Add(silkLayersBtn, 1, wx.EXPAND)
+
+
+        label = wx.StaticText(panel,
+            label="Matching references:",
+            size=wx.Size(200, -1),
+            style=wx.ALIGN_RIGHT)
+        label.Wrap(200)
+        self.item_grid.Add(label, 1, wx.ALIGN_TOP)
+        self.matchingText = wx.StaticText(panel,
+            label="Matching references:",
+            size=wx.Size(350, 80),
+            style=wx.ALIGN_LEFT | wx.ST_ELLIPSIZE_END)
+        self.item_grid.Add(self.matchingText, 1, wx.EXPAND)
+        self.item_grid.AddGrowableRow(5)
+
+        button_box = wx.BoxSizer(wx.HORIZONTAL)
+
+        cancelButton = wx.Button(panel, label='Close')
+        self.Bind(wx.EVT_BUTTON, self.OnCancel, id=cancelButton.GetId())
+        button_box.Add(cancelButton, 1, wx.RIGHT, 10)
+
+        self.applyButton = wx.Button(panel, label='Apply')
+        self.Bind(wx.EVT_BUTTON, self.OnApply, id=self.applyButton.GetId())
+        button_box.Add(self.applyButton, 1)
+
+        vbox.Add(self.item_grid, 1, wx.EXPAND | wx.ALL, 10)
+        vbox.Add(button_box, 0, wx.ALIGN_RIGHT | wx.LEFT | wx.RIGHT | wx.BOTTOM, 20)
+
+        panel.SetSizer(vbox)
+        vbox.Fit(self)
+        self.Centre()
+        self.OnPatternChange(None)
+
+    def SetTextPreview(self, text = None):
+        if text is not None:
+            self.text = text
+        self.matchingText.SetLabel(self.text)
+        self.matchingText.Wrap(self.item_grid.GetColWidths()[1])
+
+    def Show(self):
+        self.OnPatternChange(None)
+        super().Show()
+
+    def OnSize(self, event):
+        self.SetTextPreview()
+        if event is not None:
+            event.Skip()
+
+    def OnCancel(self, event):
+        if self.updateStatusCallback is not None:
+            selectedLayers = self.GetActiveLayers()
+            self.updateStatusCallback({
+                "pattern": self.GetPattern(),
+                "scope": self.scope.GetSelection(),
+                "action": self.action.GetSelection(),
+                "layers": [l in selectedLayers for l in Layer.all()]
+            })
+        destroyDialog(self)
+
+    def OnApply(self, event):
+        if self.actionCallback is not None:
+            self.actionCallback(self)
+
+    def OnAllLayers(self, event):
+        for l in Layer.all():
+            self.layers.Check(l)
+
+    def OnNoLayers(self, event):
+        for l in Layer.all():
+            self.layers.Check(l, False)
+
+    def OnTechnicalLayers(self, event):
+        checked = set(self.layers.GetCheckedItems())
+        enable = not all(x in checked for x in Layer.allTech())
+        for l in Layer.allTech():
+            self.layers.Check(l, enable)
+
+    def OnSilkscreenLayers(self, event):
+        checked = set(self.layers.GetCheckedItems())
+        enable = not all(x in checked for x in Layer.allSilk())
+        for l in Layer.allSilk():
+            self.layers.Check(l, enable)
+
+    def GetShowLabels(self):
+        return self.action.GetSelection() == 0
+
+    def GetPattern(self):
+        return self.pattern.GetValue()
+
+    def GetActiveLayers(self):
+        return set(self.layers.GetCheckedItems())
+
+    def GetSelectedItemOnly(self):
+        return self.selectedItemOnly
+
+    def ModifyReferences(self):
+        return self.scope.GetSelection() in [0, 2]
+
+    def ModifyValues(self):
+        return self.scope.GetSelection() in [1, 2]
+
+    def OnselectedItemOnlyChange(self, event):
+        self.selectedItemOnly = not self.selectedItemOnly
+        self.OnPatternChange(None)
+
+    def OnPatternChange(self, event):
+        try:
+            regex = re.compile(self.pattern.GetValue())
+            self.applyButton.Enable()
+            if not self.board:
+                self.SetTextPreview("")
+            else:
+                refs = []
+                for footprint in self.board.GetFootprints():
+                    if self.selectedItemOnly and not footprint.IsSelected():
+                        continue
+
+                    if regex.match(footprint.GetReference()):
+                        refs.append(footprint.GetReference())
+                if len(refs) > 0:
+                    self.SetTextPreview(", ".join(refs))
+                else:
+                    self.SetTextPreview("None")
+        except re.error as e:
+            self.applyButton.Disable()
+            self.SetTextPreview(f"Invalid regular expression: {e}")
+        finally:
+            self.SendSizeEvent()
+
+
+class HideReferencesPlugin(pcbnew.ActionPlugin):
+    def defaults(self):
+        self.name = "KiKit: Show/hide references"
+        self.category = "KiKit"
+        self.description = "Show/hide references in the board based on regular expression"
+        self.icon_file_name = os.path.join(PKG_BASE, "resources", "graphics", "removeRefIcon_24x24.png")
+        self.show_toolbar_button = True
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._dialogState = {}
+
+    def error(self, msg):
+        wx.MessageBox(msg, "Error", wx.OK | wx.ICON_ERROR)
+
+    def action(self, dialog):
+        try:
+            if dialog.ModifyReferences():
+                modify.references(dialog.board, dialog.GetShowLabels(),
+                     dialog.GetPattern(), dialog.GetActiveLayers(),
+                     dialog.GetSelectedItemOnly())
+            if dialog.ModifyValues():
+                modify.values(dialog.board, dialog.GetShowLabels(),
+                    dialog.GetPattern(), dialog.GetActiveLayers(),
+                    dialog.GetSelectedItemOnly())
+            pcbnew.Refresh()
+        except Exception as e:
+            self.error(f"Cannot perform: {e}")
+
+    def updateState(self, newState):
+        self._dialogState = newState
+
+    def Run(self):
+        # Find the pcbnew main window
+        pcbnew_window = wx.FindWindowByName("PcbFrame")
+        if pcbnew_window is None:
+            # Something failed, abort
+            self.error("Failed to find pcbnew main window")
+            return
+        try:
+            dialog = initDialog(lambda: HideReferencesDialog(
+                                    state=self._dialogState,
+                                    board=pcbnew.GetBoard(),
+                                    action=lambda d: self.action(d),
+                                    updateState=lambda s: self.updateState(s),
+                                    parent=pcbnew_window))
+            dialog.Show()
+        except Exception as e:
+            self.error(f"Cannot perform: {e}")
+
+plugin = HideReferencesPlugin
+
+if __name__ == "__main__":
+    import sys
+
+    dialog = initDialog(lambda: HideReferencesDialog(
+                            {},
+                            board=pcbnew.LoadBoard(sys.argv[1]),
+                            updateState=print))
+    dialog.ShowModal()