vl8 0.2.0__tar.gz → 0.3.0__tar.gz

vl8-0.3.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: vl8
+Version: 0.3.0
+Summary: 🔉 Perturbed audio 🔉
+Author: Tom Ritchford
+Author-email: Tom Ritchford <tom@swirly.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: abbrev>=1.0.1,<2
+Requires-Dist: graycode>=1.0.5,<2
+Requires-Dist: more-itertools>=9.0.0,<10
+Requires-Dist: numpy>=1.24.1,<2
+Requires-Dist: pydub>=0.25.1,<0.26
+Requires-Dist: pyyaml>=6.0,<7
+Requires-Dist: runs>=1.1.0,<2
+Requires-Dist: soundfile>=0.11.0,<0.12
+Requires-Dist: stroll>=1.1.0,<2
+Requires-Dist: tdir>=1.4.1,<2
+Requires-Dist: toml>=0.10.2,<0.11
+Requires-Dist: typeguard>=2.13.3,<3
+Requires-Dist: wavemap>=2.0.1,<3
+Requires-Dist: xmod>=1.3.2,<2
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# 🔉 vl8: Create derivative works that might not be copyright violations 🔉
+
+![vl8 logo](https://raw.githubusercontent.com/rec/vl8/master/vl8.png)
+
+Update: this is still in development - I got sidetracked by paying work.
+Most of this is working, it just needs to be packaged!
+
+------------------------------------------------------------------------
+
+A command line tool and Python library that (will soon be) like a Swiss
+Army Knife for audio.
+
+-   Create a myriad of mashups of your favorite audio effortlessly.
+-   Script mundane tasks like editing, scaling and stretching,
+    envelopes, playlists and more.
+-   Handle very large audio files using memory mapping, or very large
+    numbers of audio files using scripting.
+-   Write your own scripts for mashups or editing, or your own plug-ins,
+    and share them.
+-   Uses widely compatible, highly performant numpy arrays to represent
+    audio files within Python.

vl8-0.3.0/README.md

@@ -0,0 +1,21 @@
+# 🔉 vl8: Create derivative works that might not be copyright violations 🔉
+
+![vl8 logo](https://raw.githubusercontent.com/rec/vl8/master/vl8.png)
+
+Update: this is still in development - I got sidetracked by paying work.
+Most of this is working, it just needs to be packaged!
+
+------------------------------------------------------------------------
+
+A command line tool and Python library that (will soon be) like a Swiss
+Army Knife for audio.
+
+-   Create a myriad of mashups of your favorite audio effortlessly.
+-   Script mundane tasks like editing, scaling and stretching,
+    envelopes, playlists and more.
+-   Handle very large audio files using memory mapping, or very large
+    numbers of audio files using scripting.
+-   Write your own scripts for mashups or editing, or your own plug-ins,
+    and share them.
+-   Uses widely compatible, highly performant numpy arrays to represent
+    audio files within Python.

vl8-0.3.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "vl8"
+version = "0.3.0"
+description = "🔉 Perturbed audio 🔉"
+authors = [{ name = "Tom Ritchford", email = "tom@swirly.com" }]
+requires-python = ">=3.10"
+readme = "README.md"
+license = "MIT"
+classifiers = ["Programming Language :: Python :: 3", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", "Programming Language :: Python :: 3.14"]
+dependencies = [
+    "abbrev>=1.0.1,<2",
+    "graycode>=1.0.5,<2",
+    "more-itertools>=9.0.0,<10",
+    "numpy>=1.24.1,<2",
+    "pydub>=0.25.1,<0.26",
+    "pyyaml>=6.0,<7",
+    "runs>=1.1.0,<2",
+    "soundfile>=0.11.0,<0.12",
+    "stroll>=1.1.0,<2",
+    "tdir>=1.4.1,<2",
+    "toml>=0.10.2,<0.11",
+    "typeguard>=2.13.3,<3",
+    "wavemap>=2.0.1,<3",
+    "xmod>=1.3.2,<2",
+]
+
+[tool.doks]
+auto = true
+
+[tool.ruff]
+[dependency-groups]
+dev = [
+    "coverage>=7.1.0,<8",
+    "impall>=1.1.1,<2",
+    "pytest>=7.2.1,<8",
+    "pyupgrade>=3.21.2",
+    "ruff>=0.14.14",
+    "tdir>=1.4.1,<2",
+    "ty>=0.0.14",
+]
+
+[tool.uv]
+
+[tool.uv.build-backend]
+module-root = ""
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.10.0"]
+build-backend = "uv_build"
+[tool.coverage.run]
+branch = true
+source = "vl8"
+
+[tool.coverage.report]
+fail_under = "60"
+skip_covered = true
+exclude_lines = ["pragma: no cover", "if False:", "if __name__ == .__main__.:", "raise NotImplementedError"]
+

vl8-0.3.0/vl8/dsp/fix_gaps.py

@@ -0,0 +1,49 @@
+import math
+from typing import List, Optional, Union
+
+import xmod
+
+from old.vl8.util import error
+
+Number = Union[int, float]
+Gaps = Union[Number, List[Number]]
+
+
+@xmod
+def fix_gaps(
+    durations: List[int],
+    gaps: Gaps,
+    pre: float = 0,
+    post: float = 0,
+    sample_rate: Optional[int] = None,
+):
+    # TODO: fix_gaps should learn about durations amd ration
+    if pre < 0 or post < 0:
+        raise ValueError("pre and post cannot be negative")
+
+    if not isinstance(gaps, list):
+        gaps = [gaps]
+    elif not gaps:
+        raise ValueError("gap must be a non-empty list or an integer")
+
+    n = len(durations)
+    scale = math.ceil(n / len(gaps))
+    gaps = [pre] + (gaps * scale)[: n - 1] + [post]
+
+    if sample_rate:
+        gaps = [g * sample_rate for g in gaps]
+
+    gaps = [round(g) for g in gaps]
+
+    # Fix any fade gaps that are too long.
+    for i, gap in enumerate(gaps):
+        if i > 0:
+            gap = max(gap, -durations[i - 1])
+        if i < n:
+            gap = max(gap, -durations[i])
+        if gaps[i] != gap:
+            error(f"Gap {i}: {gap} was longer than the sample!")
+            gaps[i] = gap
+
+    assert len(gaps) == n + 1
+    return gaps

vl8-0.3.0/vl8/processor/catenate.py

@@ -0,0 +1,62 @@
+from dataclasses import dataclass
+
+from old.vl8.dsp import curve_cache
+from old.vl8.function.creator import Creator
+from vl8.dsp import fix_gaps
+
+
+@dataclass
+class Catenate(Creator):
+    curve: curve_cache.Curve = None
+    gap: fix_gaps.Gaps = 0
+    pre: int = 0
+    post: int = 0
+
+    def _prepare(self, src):
+        durations = [s.shape[1] for s in src]
+        self.gaps = fix_gaps(
+            durations, self.gap, self.pre, self.post, src[0].sample_rate
+        )
+        return sum(durations) + sum(self.gaps)
+
+    def _call(self, arr, *src):
+        """
+        gap: None, a number of seconds or a list of seconds
+        if a gap is negative, it's a fade
+        """
+
+        fader = curve_cache(self.curve, arr.dtype)
+
+        begin = end = 0
+        for i, s in enumerate(src):
+            begin = end + self.gaps[i]
+            end = begin + s.shape[-1]
+            fade_in, fade_out = -self.gaps[i], -self.gaps[i + 1]
+
+            b, e = begin, end
+            if fade_in > 0:
+                delta = fader(0, 1, fade_in) * s[:, :fade_in]
+                arr[:, b : b + fade_in] += delta
+                b += fade_in
+
+            if fade_out > 0:
+                delta = fader(1, 0, fade_out) * s[:, -fade_out:]
+                arr[:, e - fade_out : e] += delta
+                e -= fade_out
+
+            arr[:, b:e] += s[:, b - begin : e - end or None]
+
+
+"""
+# Should be elsewhere in a task
+
+overlap: None or any floating point numbers, referenced to the longest item.
+
+These next comments shoul
+
+0 means: all start together
+0.5 means: middles of all songs are at same time
+1 means: all end together
+
+Negative numbers and numbers bigger than one are possible!
+"""

vl8-0.2.0/PKG-INFO

@@ -1,22 +0,0 @@
-Metadata-Version: 1.1
-Name: vl8
-Version: 0.2.0
-Summary: 🔉 vl8: Sort audio granularly 🔉
-Home-page: https://github.com/rec/vl8
-Author: Tom Ritchford
-Author-email: tom@swirly.com
-License: MIT
-Description: 🔉 vl8: Create derivative works that might not be copyright violations 🔉
-        ----------------------------------------------------------------------------
-        
-        This is a tool to create derivative works of pieces of music.
-        
-Keywords: audio
-Platform: UNKNOWN
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License

vl8-0.2.0/README.rst

@@ -1,4 +0,0 @@
-🔉 vl8: Create derivative works that might not be copyright violations 🔉
-----------------------------------------------------------------------------
-
-This is a tool to create derivative works of pieces of music.

vl8-0.2.0/pyproject.toml

@@ -1,7 +0,0 @@
-[tool.black]
-line-length = 79
-skip-string-normalization = true
-target-version = ['py37']
-
-[tool.doks]
-auto = true

vl8-0.2.0/setup.cfg

@@ -1,7 +0,0 @@
-[metadata]
-description-file = README.rst
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

vl8-0.2.0/setup.py

@@ -1,38 +0,0 @@
-from pathlib import Path
-from setuptools import setup
-
-_classifiers = [
-    'Development Status :: 3 - Alpha',
-    'Programming Language :: Python :: 3.6',
-    'Programming Language :: Python :: 3.7',
-    'Programming Language :: Python :: 3.8',
-    'Programming Language :: Python :: 3.9',
-    'Intended Audience :: Developers',
-    'License :: OSI Approved :: MIT License',
-]
-
-
-def _version():
-    with open('vl8.py') as fp:
-        line = next(i for i in fp if i.startswith('__version__'))
-        return line.strip().split()[-1].strip("'")
-
-
-REQUIREMENTS = Path('requirements.txt').read_text().splitlines()
-
-
-if __name__ == '__main__':
-    setup(
-        name='vl8',
-        version=_version(),
-        author='Tom Ritchford',
-        author_email='tom@swirly.com',
-        url='https://github.com/rec/vl8',
-        py_modules=['vl8'],
-        description='🔉 vl8: Sort audio granularly 🔉',
-        long_description=open('README.rst').read(),
-        license='MIT',
-        classifiers=_classifiers,
-        keywords=['audio'],
-        install_requires=REQUIREMENTS,
-    )

vl8-0.2.0/vl8.egg-info/PKG-INFO

@@ -1,22 +0,0 @@
-Metadata-Version: 1.1
-Name: vl8
-Version: 0.2.0
-Summary: 🔉 vl8: Sort audio granularly 🔉
-Home-page: https://github.com/rec/vl8
-Author: Tom Ritchford
-Author-email: tom@swirly.com
-License: MIT
-Description: 🔉 vl8: Create derivative works that might not be copyright violations 🔉
-        ----------------------------------------------------------------------------
-        
-        This is a tool to create derivative works of pieces of music.
-        
-Keywords: audio
-Platform: UNKNOWN
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License

vl8-0.2.0/vl8.egg-info/SOURCES.txt

@@ -1,10 +0,0 @@
-README.rst
-pyproject.toml
-setup.cfg
-setup.py
-vl8.py
-vl8.egg-info/PKG-INFO
-vl8.egg-info/SOURCES.txt
-vl8.egg-info/dependency_links.txt
-vl8.egg-info/requires.txt
-vl8.egg-info/top_level.txt

vl8-0.2.0/vl8.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

vl8-0.2.0/vl8.egg-info/requires.txt

@@ -1,5 +0,0 @@
-aubio
-numpy
-pydub
-runs
-stroll

vl8-0.2.0/vl8.egg-info/top_level.txt

@@ -1 +0,0 @@
-vl8

vl8-0.2.0/vl8.py

@@ -1,81 +0,0 @@
-"""
-🏃 Run one or more commands 🏃
-------------------------------------------------------------------
-"""
-
-
-# import stroll
-from dataclasses import dataclass
-import numpy as np
-import util
-
-__all__ = 'vl8'
-__version__ = '0.2.0'
-INFILE = '/data/vl8/full.wav'
-MAX_FRAME = 4096
-SAMPLERATE = 44100
-GRAIN_SIZE = SAMPLERATE // 10
-
-
-def mean_square(granule):
-    return np.mean(granule * granule)
-
-
-@dataclass
-class Granulator:
-    filename: str
-    grain_size: int = GRAIN_SIZE
-    sort: bool = True
-    duration: int = 0
-
-    def __post_init__(self):
-        assert not (self.grain_size % 2)
-        self.buffer = util.read(self.filename, self.grain_size, self.duration)
-        self.duration = self.buffer.shape[1]
-
-    def run(self, function, outfile):
-        results = self.for_each_granule(function)
-        results.sort(1)
-        print('writing', outfile)
-        util.write(outfile, self.combine(results))
-
-    def for_each_granule(self, function):
-        half = self.grain_size // 2
-        granules = self.duration // half
-        granules = round(granules)
-
-        results = util.empty(granules).transpose()
-        for i in range(granules):
-            begin = half * i
-            end = begin + self.grain_size
-            value = function(self.buffer[:, begin:end])
-            results[i] = float(i), value
-
-        return results
-
-    def combine(self, results):
-        half = self.grain_size // 2
-        buf = self.buffer
-        out = util.zeros(buf.shape[1] + half)
-
-        fade_in = np.linspace(0, 1, half, dtype=util.FLOAT)
-        fade_out = np.flip(fade_in)
-
-        for out_index, (in_index, value) in enumerate(results):
-            i = round(in_index) * half
-            o = out_index * half
-            out[:, o : o + half] += buf[:, i : i + half] * fade_in
-
-            i += half
-            o += half
-            out[:, o : o + half] += buf[:, i : i + half] * fade_out
-
-        return out
-
-
-if __name__ == '__main__':
-    print('Reading', INFILE)
-    generator = Granulator(INFILE)
-
-    print('Running mean_square')
-    generator.run(mean_square, '/data/vl8/mean_square.wav')