bdbarnett · Nov 4, 2026 · Nov 4, 2026 · Nov 4, 2026
diff --git a/.github/workflows/style.yml b/.github/workflows/style.yml
@@ -0,0 +1,16 @@
+# The mechanical house-style rules: SPDX header, no Sphinx roles in
+# docstrings, no link to the .github repo from a page, no README badges or
+# status banner. Pull requests check the changed files; a manual run checks
+# every file. Paths that aren't ours go in .style-exclude.
+name: Style
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  style:
+    uses: PyDevices/.github/.github/workflows/reusable-style-check.yml@publishing-v20
diff --git a/examples/bass_pedals_demo.py b/examples/bass_pedals_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the BassPedals: roar, tuba, pluck, fifths, octave bass, squelch, swell, glide, beat, thump and lead.
 

diff --git a/examples/clavichord_demo.py b/examples/clavichord_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Clavichord: classic funk riff, brilliant lead, warm chords, out-of-phase, muted plucks, and auto-wah.
 

diff --git a/examples/combo_organ_demo.py b/examples/combo_organ_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the ComboOrgan: Continental, Beat Group, Soft Flute, Reedy Lead, and New Wave.
 

diff --git a/examples/compact_organ_demo.py b/examples/compact_organ_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the CompactOrgan: Garage riff, Bright Strings, Soft Flutes, Trumpet lead, and Full Combo.
 

diff --git a/examples/demo_check.py b/examples/demo_check.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The check every demo runs on each of its sections.
 

diff --git a/examples/duosynth_demo.py b/examples/duosynth_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the DuoSynth: lead, sync sweep, thirds, ring bell, strings, pluck bass, S&H, trill, repeat pulse, wind, and FM clang.
 

diff --git a/examples/electric_grand70_demo.py b/examples/electric_grand70_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the ElectricGrand70: stage grand, bright rock, ballad, chorused and tremolo.
 

diff --git a/examples/electric_piano_demo.py b/examples/electric_piano_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the ElectricPiano: ballad, funk bark, glass tines, dark tonebar, fast pan and short damper.
 

diff --git a/examples/electronic_drums5_demo.py b/examples/electronic_drums5_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play ElectronicDrums5: five classic 1980s electronic drum patterns across its five patches.
 

diff --git a/examples/headless_synth.py b/examples/headless_synth.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Example: Headless Modular100 modular synthesizer in the rack.
 

diff --git a/examples/hmi_board.py b/examples/hmi_board.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The rack on a board, open to front panels over Wi-Fi, with its own screen.
 

diff --git a/examples/hmi_instrument.py b/examples/hmi_instrument.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play an instrument demo's phrase, live, with its patches and knobs open to panels.
 

diff --git a/examples/mono101_demo.py b/examples/mono101_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Mono101 through eleven sections, changing patch as a player would.
 

diff --git a/examples/mono_synth_demo.py b/examples/mono_synth_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the MonoSynth through eleven sections, changing patch as a player would.
 

diff --git a/examples/play_audio.py b/examples/play_audio.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Twenty short movements, one per instrument, rendered to WAV or played live.
 

diff --git a/examples/poly5_demo.py b/examples/poly5_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Poly5: brass, sync sweep, strings, bells, pluck, lead, keys, pad and wind.
 

diff --git a/examples/poly6_demo.py b/examples/poly6_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Poly6: strings, brass, pad, chord stab, unison bass, sub bass,
 tremolo keys, organ with effect switching, phaser sweep, vibrato lead, and noise surf.

diff --git a/examples/poly80_demo.py b/examples/poly80_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Poly80: swell brass, ribbon lead, strings, ring bells, EP, clav, organ, flute, wah, gliss pad, bass, init.
 

diff --git a/examples/poly8_demo.py b/examples/poly8_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Poly8: strings, brass, a sync lead, a cross-mod bell, a pad, a bass, plucks, wind.
 

diff --git a/examples/polya6_demo.py b/examples/polya6_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the PolyA6: Init chords, brass swell, PWM strings, huge pad, unison lead, sync sweep, ring bells, FM clang, series notch, pluck bass, S&H steps, and noise wind.
 

diff --git a/examples/polyxa_demo.py b/examples/polyxa_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the PolyXa: anthem stabs, brass, sync lead, strings, unison bass, plucks, steps, growl, glide pad, vibrato lead, and wind.
 

diff --git a/examples/rackview/__init__.py b/examples/rackview/__init__.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Front panels for a rack, on hmilink.
 

diff --git a/examples/rackview/layout.py b/examples/rackview/layout.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Eurorack front-panel layout specifications and geometry."""
 

diff --git a/examples/rackview/lvgl_panel.py b/examples/rackview/lvgl_panel.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """An LVGL front panel for a rack over hmilink: the device's own screen.
 

diff --git a/examples/rackview/lvgl_view.py b/examples/rackview/lvgl_view.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Decoupled LVGL touchscreen UI renderer with tap-to-patch interactive catenary cables."""
 

diff --git a/examples/reed_piano200a_demo.py b/examples/reed_piano200a_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the ReedPiano200A: soul ballad, tremolo chords, snarl riff, soft ballad, dry funk and overdriven.
 

diff --git a/examples/reed_piano_demo.py b/examples/reed_piano_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the ReedPiano: 1960s beat riff, snappy lead, soft plucks, wide arpeggios, and dead thud groove.
 

diff --git a/examples/rhythm606_demo.py b/examples/rhythm606_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Rhythm606: four classic analog drum patterns across its four patches.
 

diff --git a/examples/rhythm78_demo.py b/examples/rhythm78_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Rhythm78: four classic preset rhythm patterns across its four patches.
 

diff --git a/examples/rhythm808_demo.py b/examples/rhythm808_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Rhythm808: six classic drum patterns across its six patches.
 

diff --git a/examples/rhythm909_demo.py b/examples/rhythm909_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Rhythm909: five classic drum patterns across its five patches.
 

diff --git a/examples/soundfont_demo.py b/examples/soundfont_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play a short phrase on a SoundFont bank: drums first, then a piano comes in.
 

diff --git a/examples/string_ensemble_demo.py b/examples/string_ensemble_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the StringEnsemble: Init, Full Strings, Slow Swell, High Violins, Dark Violas,
 Dry Strings, Brass Section, Muted Horns, Strings and Brass, Bass Pedal, Everything,

diff --git a/examples/tonewheel3_demo.py b/examples/tonewheel3_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Tonewheel3: Full Gospel, Jazz Trio, Rock Drive, Ballad, Whistle, and Full Organ.
 

diff --git a/examples/vocoder330_demo.py b/examples/vocoder330_demo.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Play the Vocoder330 through its twelve sections: strings, choirs, the vocoder and the hold.
 

diff --git a/lib/audioinstruments/__init__.py b/lib/audioinstruments/__init__.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Synthesizers, organs and electric pianos, each one a patch on a virtual rack.
 

diff --git a/lib/audioinstruments/_names.py b/lib/audioinstruments/_names.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 # Generated by tools/make_faces.py from audioinstruments._rack.adapter: edit that, then run it again.
 """Which instruments the package has, written out so nothing lists a directory."""

diff --git a/lib/audioinstruments/_rack/__init__.py b/lib/audioinstruments/_rack/__init__.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The rack every instrument is built on: a virtual Eurorack modular synthesizer in portable Python."""
 

diff --git a/lib/audioinstruments/_rack/_component.py b/lib/audioinstruments/_rack/_component.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The audio component contract for instruments that are not a rack.
 

diff --git a/lib/audioinstruments/_rack/_gm.py b/lib/audioinstruments/_rack/_gm.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """General MIDI's names for the percussion keys this library uses.
 

diff --git a/lib/audioinstruments/_rack/_lazy.py b/lib/audioinstruments/_rack/_lazy.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Import a package's public names on first use.
 

diff --git a/lib/audioinstruments/_rack/_sf2.py b/lib/audioinstruments/_rack/_sf2.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """A SoundFont 2 (.sf2) reader, written from the SoundFont 2.04 specification.
 

diff --git a/lib/audioinstruments/_rack/adapter.py b/lib/audioinstruments/_rack/adapter.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """A polyphonic rack as an audio component.
 

diff --git a/lib/audioinstruments/_rack/core/__init__.py b/lib/audioinstruments/_rack/core/__init__.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The rack, its jacks and cables, the signal kernels and the audiodsp bridge."""
 

diff --git a/lib/audioinstruments/_rack/core/bridge.py b/lib/audioinstruments/_rack/core/bridge.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Run audiodsp nodes on the rack's float blocks.
 

diff --git a/lib/audioinstruments/_rack/core/cable.py b/lib/audioinstruments/_rack/core/cable.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Virtual patch cable connecting an OutputJack to an InputJack."""
 

diff --git a/lib/audioinstruments/_rack/core/graph.py b/lib/audioinstruments/_rack/core/graph.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """A rack compiled to one ``audiograph`` graph, rendered by one C call a block.
 

diff --git a/lib/audioinstruments/_rack/core/jack.py b/lib/audioinstruments/_rack/core/jack.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Eurorack Jack abstractions: InputJack with normaling, OutputJack with fan-out."""
 

diff --git a/lib/audioinstruments/_rack/core/module.py b/lib/audioinstruments/_rack/core/module.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Base class for rack modules."""
 

diff --git a/lib/audioinstruments/_rack/core/poly.py b/lib/audioinstruments/_rack/core/poly.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Polyphony: one voice patch replicated N times, an allocator, a shared section.
 

diff --git a/lib/audioinstruments/_rack/core/rack.py b/lib/audioinstruments/_rack/core/rack.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The rack: modules, cables, processing order and patch state."""
 

diff --git a/lib/audioinstruments/_rack/core/signal.py b/lib/audioinstruments/_rack/core/signal.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Signal conventions and in-place buffer kernels.
 

diff --git a/lib/audioinstruments/_rack/dsp/__init__.py b/lib/audioinstruments/_rack/dsp/__init__.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """The DSP cores the modules are built from.
 

diff --git a/lib/audioinstruments/_rack/dsp/amplifier.py b/lib/audioinstruments/_rack/dsp/amplifier.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Voltage-controlled amplifier with linear and exponential response."""
 

diff --git a/lib/audioinstruments/_rack/dsp/biquad.py b/lib/audioinstruments/_rack/dsp/biquad.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Linear two-pole filters on audiodsp: synthio.Biquad inside audiofilters.Filter.
 

diff --git a/lib/audioinstruments/_rack/dsp/blocks.py b/lib/audioinstruments/_rack/dsp/blocks.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Block helpers for control-voltage generators.
 

diff --git a/lib/audioinstruments/_rack/dsp/chorus.py b/lib/audioinstruments/_rack/dsp/chorus.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """A stereo bucket-brigade chorus: two short lines swept in opposite directions.
 

diff --git a/lib/audioinstruments/_rack/dsp/delay.py b/lib/audioinstruments/_rack/dsp/delay.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Bucket-brigade style delay on audiodsp's Echo."""
 

diff --git a/lib/audioinstruments/_rack/dsp/drums.py b/lib/audioinstruments/_rack/dsp/drums.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Shared analog drum synthesis cores.
 

diff --git a/lib/audioinstruments/_rack/dsp/ensemble.py b/lib/audioinstruments/_rack/dsp/ensemble.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """A string-machine ensemble: three short lines, each swept by two slow LFOs.
 

diff --git a/lib/audioinstruments/_rack/dsp/envelope.py b/lib/audioinstruments/_rack/dsp/envelope.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """ADSR envelope with exponential segments, rendered a segment at a time."""
 

diff --git a/lib/audioinstruments/_rack/dsp/function_generator.py b/lib/audioinstruments/_rack/dsp/function_generator.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Rise/fall function generators and the trapezoid shaper.
 

diff --git a/lib/audioinstruments/_rack/dsp/glide.py b/lib/audioinstruments/_rack/dsp/glide.py
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2026 Brad Barnett
+#
 # SPDX-License-Identifier: MIT
 """Portamento: a pitch CV that slides to each new note in a set time.