utils/music_theory/music_theory/__init__.py
Krzysztof kuhy Rudnicki d5b3f2cff3 music_theory: music theory from first principles, as code you can hear
New subproject porting Luke Haas's "Music Theory for Programmers" section
by section into typed Python: pitch (MIDI <-> Hz), tuning (harmonic
series, the Pythagorean comma, brute-forced "why twelve"), scales as step
arrays with modes as rotations, chords stacked in thirds with Roman
numerals and the V7 -> I resolution, named progressions, a numpy synth
(waveforms, ADSR, low-pass), a bar-exact sequencer, and a seeded Recipe ->
WAV composer. `degrade` is the same piece ruined by a 0..1 amount, so an
ending can be the opening destroyed on the same seed; filtering runs LAST
because filtering first measured brighter than the clean render.

17 demos (`python -m music_theory demo all`) each print the article's
numbers -- the comma is 1.013643, the tempered fifth is 0.113 % flat,
twelve is the first acceptable division -- and the FFT of the render, so
the claims are tested rather than asserted. 157 tests, 100 % branch
coverage, ruff ALL, mypy strict, pylint 10.

Consumed next by roadside-assistance for its three world-state beds.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VC17zymxkeiUcHrMvt8W5W
2026-09-11 18:29:13 +02:00

18 lines
688 B
Python

# Copyright (c) 2026 Krzysztof Rudnicki
"""Music theory from first principles, as code.
Follows Luke Haas's "Music Theory for Programmers"
(https://runjs.app/blog/music-theory-for-programmers) section by section:
a sound is a number changing over time, pitch is multiplicative, the tuning
everyone wants cannot exist, so equal temperament trades purity for a
system that works in every key. Scales, chords and progressions are then
plain arrays of integers on top of that.
Every module is pure and typed; ``synth``/``sequencer``/``compose`` turn
the integers into audio with numpy so each idea can be heard, not just read.
"""
from __future__ import annotations
__version__ = "0.1.0"