enge 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. enge-0.2.0/.github/workflows/test.yml +73 -0
  2. enge-0.2.0/.gitignore +223 -0
  3. enge-0.2.0/.python-version +1 -0
  4. enge-0.2.0/Cargo.lock +439 -0
  5. enge-0.2.0/Cargo.toml +20 -0
  6. enge-0.2.0/LICENSE +21 -0
  7. enge-0.2.0/PKG-INFO +312 -0
  8. enge-0.2.0/README.md +295 -0
  9. enge-0.2.0/conformance/fm-instrument.json +186 -0
  10. enge-0.2.0/conformance/noise-instrument.json +157 -0
  11. enge-0.2.0/conformance/noise-v1.json +63 -0
  12. enge-0.2.0/conformance/sampler-traversal.json +282 -0
  13. enge-0.2.0/doc/live-callback-audit.md +102 -0
  14. enge-0.2.0/doc/live-effects-benchmark.md +54 -0
  15. enge-0.2.0/enge/__init__.py +0 -0
  16. enge-0.2.0/enge/_native.pyi +387 -0
  17. enge-0.2.0/enge/control.py +114 -0
  18. enge-0.2.0/enge/effects.py +1241 -0
  19. enge-0.2.0/enge/filters.py +131 -0
  20. enge-0.2.0/enge/fm.py +887 -0
  21. enge-0.2.0/enge/lfo.py +159 -0
  22. enge-0.2.0/enge/live.py +293 -0
  23. enge-0.2.0/enge/midi.py +91 -0
  24. enge-0.2.0/enge/native.py +120 -0
  25. enge-0.2.0/enge/native_sample.py +94 -0
  26. enge-0.2.0/enge/noise.py +544 -0
  27. enge-0.2.0/enge/presets.py +262 -0
  28. enge-0.2.0/enge/py.typed +0 -0
  29. enge-0.2.0/enge/render.py +162 -0
  30. enge-0.2.0/enge/rubberband.py +136 -0
  31. enge-0.2.0/enge/sample_instrument.py +718 -0
  32. enge-0.2.0/enge/sample_regions.py +180 -0
  33. enge-0.2.0/enge/sampler.py +518 -0
  34. enge-0.2.0/enge/synth.py +4023 -0
  35. enge-0.2.0/enge/yamaha.py +331 -0
  36. enge-0.2.0/plan/a-new-view-of-lfos-and-envelopes.md +835 -0
  37. enge-0.2.0/plan/engine-execution.md +31 -0
  38. enge-0.2.0/plan/fm-synthesis.md +14 -0
  39. enge-0.2.0/plan/four-operator-fm.md +32 -0
  40. enge-0.2.0/plan/new-effects.md +350 -0
  41. enge-0.2.0/plan/new-engines.md +813 -0
  42. enge-0.2.0/plan/pint-units.md +320 -0
  43. enge-0.2.0/plan/roadmap.md +38 -0
  44. enge-0.2.0/plan/segments.md +100 -0
  45. enge-0.2.0/plan/yamaha-emulation.md +40 -0
  46. enge-0.2.0/pyproject.toml +42 -0
  47. enge-0.2.0/scripts/bach.py +47 -0
  48. enge-0.2.0/scripts/benchmark-effects.py +327 -0
  49. enge-0.2.0/scripts/benchmark_live.py +195 -0
  50. enge-0.2.0/scripts/bwv-578.md +97 -0
  51. enge-0.2.0/scripts/bwv-578.mid +0 -0
  52. enge-0.2.0/scripts/live-effects.py +167 -0
  53. enge-0.2.0/src/effects.rs +136 -0
  54. enge-0.2.0/src/filters.rs +142 -0
  55. enge-0.2.0/src/fm.rs +279 -0
  56. enge-0.2.0/src/granulator.rs +263 -0
  57. enge-0.2.0/src/lfo.rs +65 -0
  58. enge-0.2.0/src/lib.rs +201 -0
  59. enge-0.2.0/src/live.rs +1548 -0
  60. enge-0.2.0/src/noise.rs +72 -0
  61. enge-0.2.0/src/queue.rs +93 -0
  62. enge-0.2.0/src/rubberband.rs +341 -0
  63. enge-0.2.0/src/runtime.rs +4579 -0
  64. enge-0.2.0/src/sampler.rs +409 -0
  65. enge-0.2.0/test/conftest.py +16 -0
  66. enge-0.2.0/test/test_control.py +498 -0
  67. enge-0.2.0/test/test_dynamic_synth.py +442 -0
  68. enge-0.2.0/test/test_effects.py +498 -0
  69. enge-0.2.0/test/test_filter_demo.py +80 -0
  70. enge-0.2.0/test/test_filter_instrument.py +311 -0
  71. enge-0.2.0/test/test_filters.py +232 -0
  72. enge-0.2.0/test/test_fm.py +1009 -0
  73. enge-0.2.0/test/test_lfo.py +225 -0
  74. enge-0.2.0/test/test_lfo_demo.py +134 -0
  75. enge-0.2.0/test/test_lfo_instrument.py +2821 -0
  76. enge-0.2.0/test/test_live.py +723 -0
  77. enge-0.2.0/test/test_midi.py +95 -0
  78. enge-0.2.0/test/test_motion_latch.py +214 -0
  79. enge-0.2.0/test/test_motion_quantize.py +93 -0
  80. enge-0.2.0/test/test_motion_sample_hold.py +372 -0
  81. enge-0.2.0/test/test_motion_slew.py +223 -0
  82. enge-0.2.0/test/test_motion_threshold.py +290 -0
  83. enge-0.2.0/test/test_native.py +159 -0
  84. enge-0.2.0/test/test_native_sampler.py +211 -0
  85. enge-0.2.0/test/test_noise.py +492 -0
  86. enge-0.2.0/test/test_oscillator.py +55 -0
  87. enge-0.2.0/test/test_render.py +102 -0
  88. enge-0.2.0/test/test_rubberband.py +216 -0
  89. enge-0.2.0/test/test_runtime.py +1318 -0
  90. enge-0.2.0/test/test_sample_instrument.py +641 -0
  91. enge-0.2.0/test/test_sample_regions.py +170 -0
  92. enge-0.2.0/test/test_sampler.py +411 -0
  93. enge-0.2.0/test/test_synth.py +253 -0
  94. enge-0.2.0/test/test_synth_demo.py +145 -0
  95. enge-0.2.0/test/test_units.py +219 -0
  96. enge-0.2.0/test/test_voice.py +85 -0
  97. enge-0.2.0/test/test_yamaha.py +53 -0
  98. enge-0.2.0/uv.lock +472 -0
@@ -0,0 +1,73 @@
1
+ name: Cross-platform tests
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ release:
6
+ types: [published]
7
+
8
+ permissions:
9
+ contents: read
10
+
11
+ jobs:
12
+ test:
13
+ name: ${{ matrix.os }} / ${{ matrix.profile }}
14
+ runs-on: ${{ matrix.os }}
15
+ timeout-minutes: 45
16
+ strategy:
17
+ fail-fast: false
18
+ matrix:
19
+ os: [ubuntu-24.04, windows-2025, macos-15]
20
+ profile: [core, rubberband]
21
+ defaults:
22
+ run:
23
+ shell: bash
24
+ env:
25
+ RUSTUP_TOOLCHAIN: "1.85.0"
26
+ steps:
27
+ - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
28
+ - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
29
+ with:
30
+ python-version: "3.13"
31
+ - name: Install Rust tools
32
+ run: rustup toolchain install 1.85.0 --profile minimal --component clippy --component rustfmt
33
+ - name: Install FLAC on Linux
34
+ if: runner.os == 'Linux'
35
+ run: |
36
+ sudo apt-get update
37
+ sudo apt-get install --yes flac
38
+ - name: Install FLAC on macOS
39
+ if: runner.os == 'macOS'
40
+ run: brew install flac
41
+ - name: Install FLAC on Windows
42
+ if: runner.os == 'Windows'
43
+ shell: pwsh
44
+ run: |
45
+ Invoke-WebRequest https://downloads.xiph.org/releases/flac/flac-1.5.0-win.zip -OutFile "$env:RUNNER_TEMP\flac.zip"
46
+ Expand-Archive "$env:RUNNER_TEMP\flac.zip" -DestinationPath "$env:RUNNER_TEMP\flac"
47
+ "$env:RUNNER_TEMP\flac\flac-1.5.0-win\Win64" | Out-File -FilePath $env:GITHUB_PATH -Append
48
+ - name: Install libclang on Linux
49
+ if: runner.os == 'Linux' && matrix.profile == 'rubberband'
50
+ run: sudo apt-get install --yes libclang-dev
51
+ - name: Install libclang on macOS
52
+ if: runner.os == 'macOS' && matrix.profile == 'rubberband'
53
+ run: |
54
+ brew install llvm
55
+ printf 'LIBCLANG_PATH=%s/lib\n' "$(brew --prefix llvm)" >> "$GITHUB_ENV"
56
+ - name: Select libclang on Windows
57
+ if: runner.os == 'Windows' && matrix.profile == 'rubberband'
58
+ shell: pwsh
59
+ run: |
60
+ "LIBCLANG_PATH=$env:ProgramFiles\LLVM\bin" | Out-File -FilePath $env:GITHUB_ENV -Append
61
+ - name: Build and install
62
+ run: uv sync --frozen ${{ matrix.profile == 'rubberband' && '--config-settings-package enge:build-args=--features=rubberband' || '' }}
63
+ - name: Check Rust
64
+ run: |
65
+ cargo fmt --check
66
+ if ! uv run --no-sync cargo clippy --locked --all-targets --message-format=short ${{ matrix.profile == 'rubberband' && '--features rubberband' || '' }} -- -D warnings 2> "$RUNNER_TEMP/clippy.log"; then
67
+ sed -n '/error/s/^/::error::/p' "$RUNNER_TEMP/clippy.log"
68
+ exit 1
69
+ fi
70
+ - name: Check FLAC availability
71
+ run: flac --version
72
+ - name: Test both renderers
73
+ run: uv run --no-sync pytest ${{ matrix.profile == 'rubberband' && '--require-rubberband' || '' }}
enge-0.2.0/.gitignore ADDED
@@ -0,0 +1,223 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+ *.pyd
9
+
10
+ # Distribution / packaging
11
+ .Python
12
+ build/
13
+ develop-eggs/
14
+ dist/
15
+ downloads/
16
+ eggs/
17
+ .eggs/
18
+ lib/
19
+ lib64/
20
+ parts/
21
+ sdist/
22
+ var/
23
+ wheels/
24
+ share/python-wheels/
25
+ *.egg-info/
26
+ .installed.cfg
27
+ *.egg
28
+ MANIFEST
29
+
30
+ # PyInstaller
31
+ # Usually these files are written by a python script from a template
32
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
33
+ *.manifest
34
+ *.spec
35
+
36
+ # Installer logs
37
+ pip-log.txt
38
+ pip-delete-this-directory.txt
39
+
40
+ # Unit test / coverage reports
41
+ htmlcov/
42
+ .tox/
43
+ .nox/
44
+ .coverage
45
+ .coverage.*
46
+ .cache
47
+ nosetests.xml
48
+ coverage.xml
49
+ *.cover
50
+ *.py.cover
51
+ .hypothesis/
52
+ .pytest_cache/
53
+ cover/
54
+
55
+ # Translations
56
+ *.mo
57
+ *.pot
58
+
59
+ # Django stuff:
60
+ *.log
61
+ local_settings.py
62
+ db.sqlite3
63
+ db.sqlite3-journal
64
+
65
+ # Flask stuff:
66
+ instance/
67
+ .webassets-cache
68
+
69
+ # Scrapy stuff:
70
+ .scrapy
71
+
72
+ # Sphinx documentation
73
+ docs/_build/
74
+
75
+ # PyBuilder
76
+ .pybuilder/
77
+ target/
78
+
79
+ # Jupyter Notebook
80
+ .ipynb_checkpoints
81
+
82
+ # IPython
83
+ profile_default/
84
+ ipython_config.py
85
+
86
+ # pyenv
87
+ # For a library or package, you might want to ignore these files since the code is
88
+ # intended to run in multiple environments; otherwise, check them in:
89
+ # .python-version
90
+
91
+ # pipenv
92
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
93
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
94
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
95
+ # install all needed dependencies.
96
+ # Pipfile.lock
97
+
98
+ # UV
99
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
100
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
101
+ # commonly ignored for libraries.
102
+ # uv.lock
103
+
104
+ # poetry
105
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
106
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
107
+ # commonly ignored for libraries.
108
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
109
+ # poetry.lock
110
+ # poetry.toml
111
+
112
+ # pdm
113
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
114
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
115
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
116
+ # pdm.lock
117
+ # pdm.toml
118
+ .pdm-python
119
+ .pdm-build/
120
+
121
+ # pixi
122
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
123
+ # pixi.lock
124
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
125
+ # in the .venv directory. It is recommended not to include this directory in version control.
126
+ .pixi
127
+
128
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
129
+ __pypackages__/
130
+
131
+ # Celery stuff
132
+ celerybeat-schedule
133
+ celerybeat.pid
134
+
135
+ # Redis
136
+ *.rdb
137
+ *.aof
138
+ *.pid
139
+
140
+ # RabbitMQ
141
+ mnesia/
142
+ rabbitmq/
143
+ rabbitmq-data/
144
+
145
+ # ActiveMQ
146
+ activemq-data/
147
+
148
+ # SageMath parsed files
149
+ *.sage.py
150
+
151
+ # Environments
152
+ .env
153
+ .envrc
154
+ .venv
155
+ env/
156
+ venv/
157
+ ENV/
158
+ env.bak/
159
+ venv.bak/
160
+
161
+ # Spyder project settings
162
+ .spyderproject
163
+ .spyproject
164
+
165
+ # Rope project settings
166
+ .ropeproject
167
+
168
+ # mkdocs documentation
169
+ /site
170
+
171
+ # mypy
172
+ .mypy_cache/
173
+ .dmypy.json
174
+ dmypy.json
175
+
176
+ # Pyre type checker
177
+ .pyre/
178
+
179
+ # pytype static type analyzer
180
+ .pytype/
181
+
182
+ # Cython debug symbols
183
+ cython_debug/
184
+
185
+ # PyCharm
186
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
187
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
188
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
189
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
190
+ # .idea/
191
+
192
+ # Abstra
193
+ # Abstra is an AI-powered process automation framework.
194
+ # Ignore directories containing user credentials, local state, and settings.
195
+ # Learn more at https://abstra.io/docs
196
+ .abstra/
197
+
198
+ # Visual Studio Code
199
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
200
+ # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
201
+ # and can be added to the global gitignore or merged into this file. However, if you prefer,
202
+ # you could uncomment the following to ignore the entire vscode folder
203
+ # .vscode/
204
+ # Temporary file for partial code execution
205
+ tempCodeRunnerFile.py
206
+
207
+ # Ruff stuff:
208
+ .ruff_cache/
209
+
210
+ # PyPI configuration file
211
+ .pypirc
212
+
213
+ # Marimo
214
+ marimo/_static/
215
+ marimo/_lsp/
216
+ __marimo__/
217
+
218
+ # Streamlit
219
+ .streamlit/secrets.toml
220
+
221
+ # Generated long benchmark audio (the MIDI source is tracked).
222
+ /bwv-578.flac
223
+ /live-effects.flac
@@ -0,0 +1 @@
1
+ 3.13