Merge pull request #35 from iluvcapra/maint-poetry

Change build system to Poetry

.gitignore

@@ -110,3 +110,5 @@ venv_docs/
 .DS_Store
 
 .vscode/
+
+poetry.lock

docs/source/references.rst

@@ -36,6 +36,11 @@ iXML
 * `Gallery Software iXML Specification <http://www.gallery.co.uk/ixml/>`_
 
 
+Sampler Metadata
+----------------
+
+* `RecordingBlogs.com — Sample chunk (of a Wave file)<https://www.recordingblogs.com/wiki/sample-chunk-of-a-wave-file>`_
+
 RIFF Metadata
 -------------
 * `1991. Multimedia Programming Interface and Data Specifications 1.0 <https://www.aelius.com/njh/wavemetatools/doc/riffmci.pdf>`_

examples/demo.ipynb

@@ -46,6 +46,7 @@
     "  * `adm`: EBU Audio Defintion Model metadata, as used by Dolby Atmos.\n",
     "  * `cues`: Cue marker metadata, including labels and notes \n",
     "  * `dolby`: Dolby recorder and playback metadata\n",
+    "  * `smpl`: Sampler midi note and loop metadata\n",
     "\n",
     "Each of these is an attribute of a `WavInfoReader` object.\n",
     "\n",
@@ -304,7 +305,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.5"
+   "version": "3.12.5"
   }
  },
  "nbformat": 4,

pyproject.toml

@@ -1,13 +1,16 @@
+# https://python-poetry.org/docs/pyproject/
+
 [build-system]
-requires = ["flit_core >=3.2,<4"]
-build-backend = "flit_core.buildapi"
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
 
-[project]
+[tool.poetry]
 name = "wavinfo"
-authors = [{name = "Jamie Hardt", email = "[email protected]"}]
+version = "3.0.1"
+description = "Probe WAVE files for all metadata"
+authors = ["Jamie Hardt <[email protected]>"]
+license = "MIT" 
 readme = "README.md"
-dynamic = ["version", "description"]
-requires-python = "~=3.8"
 classifiers = [
     'Development Status :: 5 - Production/Stable',
     'License :: OSI Approved :: MIT License',
@@ -20,9 +23,10 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13"
 ]
-dependencies = [
-    "lxml ~= 5.3.0"
-]
+homepage = "https://github.com/iluvcapra/wavinfo"
+repository = "https://github.com/iluvcapra/wavinfo.git"
+documentation = "https://wavinfo.readthedocs.io/"
+urls.Tracker = 'https://github.com/iluvcapra/wavinfo/issues' 
 keywords = [
     'waveform', 
     'metadata', 
@@ -35,29 +39,17 @@ keywords = [
     'broadcast' 
 ]
 
-[tool.flit.module]
-name = "wavinfo"
+[tool.poetry.extras]
+doc = ['sphinx', 'sphinx_rtd_theme']
 
-[project.optional-dependencies]
-doc = [
-    'sphinx >= 5.3.0',
-    'sphinx_rtd_theme >= 1.1.1',
-]
-
-[project.urls]
-Home = "https://github.com/iluvcapra/wavinfo"
-Documentation = "https://wavinfo.readthedocs.io/"
-Source = "https://github.com/iluvcapra/wavinfo.git"
-Issues = 'https://github.com/iluvcapra/wavinfo/issues' 
-
-[project.entry_points.console_scripts]
+[tool.poetry.scripts]
 wavinfo = 'wavinfo.__main__:main'
 
-[project.scripts]
-wavinfo = "wavinfo.__main__:main"
-
-[tool.flit.external-data]
-directory = "data"
+[tool.poetry.dependencies]
+python = "^3.8"
+lxml = "~= 5.3.0"
+sphinx_rtd_theme = {version= '>= 1.1.1', optional=true}
+sphinx = {version= '>= 5.3.0', optional=true}
 
 [tool.pyright]
 typeCheckingMode = "basic"

tests/test_smpl.py

@@ -0,0 +1,15 @@
+from unittest import TestCase
+from glob import glob
+
+import wavinfo
+
+class TestSmpl(TestCase):
+    def setUp(self) -> None:
+        self.test_files = glob("tests/test_files/smpl/*.wav")
+        return super().setUp()
+
+    def test_each(self):
+        for file in self.test_files:
+            w = wavinfo.WavInfoReader(file)
+            d = w.walk()
+            self.assertIsNotNone(d)

wavinfo/__init__.py

@@ -4,6 +4,3 @@
 
 from .wave_reader import WavInfoReader
 from .riff_parser import WavInfoEOFError
-
-__version__ = '3.0.0'
-__short_version__ = '3.0.0'

wavinfo/__main__.py

@@ -1,17 +1,21 @@
-import datetime
 from . import WavInfoReader
-from . import __version__
 
+import datetime
 from optparse import OptionParser
 import sys
+import os
 import json
 from enum import Enum
+import importlib.metadata
+from base64 import b64encode
 
 
 class MyJSONEncoder(json.JSONEncoder):
     def default(self, o):
         if isinstance(o, Enum):
             return o._name_
+        elif isinstance(o, bytes):
+            return b64encode(o).decode('ascii')
         else:
             return super().default(o)
 
@@ -21,10 +25,22 @@ class MissingDataError(RuntimeError):
 
 
 def main():
+    version = importlib.metadata.version('wavinfo')
+    manpath = os.path.dirname(__file__) + "/man"
     parser = OptionParser()
 
     parser.usage = 'wavinfo (--adm | --ixml) <FILE> +'
 
+    # parser.add_option('--install-manpages',
+    #                   help="Install manual pages for wavinfo",
+    #                   default=False,
+    #                   action='store_true')
+
+    parser.add_option('--man',
+                      help="Read the manual and exit.",
+                      default=False,
+                      action='store_true')
+
     parser.add_option('--adm', dest='adm',
                       help='Output ADM XML',
                       default=False,
@@ -36,6 +52,26 @@ def main():
                       action='store_true')
 
     (options, args) = parser.parse_args(sys.argv)
+
+    # if options.install_manpages:
+    #     print("Installing manpages...")
+    #     print(f"Docfiles at {__file__}")
+    #     return
+
+    if options.man:
+        import shlex
+        print("Which man page?")
+        print("1) wavinfo usage")
+        print("7) General info on Wave file metadata")
+        m = input("?> ")
+
+        args = ["man", "-M", manpath, "1", "wavinfo"]
+        if m.startswith("7"):
+            args[3] = "7"
+
+        os.system(shlex.join(args))
+        return
+
     for arg in args[1:]:
         try:
             this_file = WavInfoReader(path=arg)
@@ -53,9 +89,9 @@ def main():
                 ret_dict = {
                     'filename': arg,
                     'run_date': datetime.datetime.now().isoformat(),
-                    'application': "wavinfo " + __version__,
+                    'application': f"wavinfo {version}",
                     'scopes': {}
-                    }
+                }
                 for scope, name, value in this_file.walk():
                     if scope not in ret_dict['scopes'].keys():
                         ret_dict['scopes'][scope] = {}

data/share/man/man1/wavinfo.1 → wavinfo/man/man1/wavinfo.1

@@ -17,7 +17,7 @@ With no options,
 will emit a JSON (Javascript Object Notation) object containing all 
 detected metadata.
 .IP "\-\-adm"
-Output any Audio Definition Model (ADM) metadata in 
+Output Audio Definition Model (ADM) XML metadata in 
 .BR FILE .
 .IP "\-\-ixml"
 Output any iXML metdata in 

wavinfo/wave_reader.py

@@ -5,16 +5,19 @@
 
 import pathlib
 
+
 from .riff_parser import parse_chunk, ChunkDescriptor, ListChunkDescriptor
 from .wave_ixml_reader import WavIXMLFormat
 from .wave_bext_reader import WavBextReader
 from .wave_info_reader import WavInfoChunkReader
 from .wave_adm_reader import WavADMReader
 from .wave_dbmd_reader import WavDolbyMetadataReader
 from .wave_cues_reader import WavCuesReader
-
+from .wave_smpl_reader import WavSmplReader
 
 #: Calculated statistics about the audio data.
+
+
 class WavDataDescriptor(NamedTuple):
     byte_count: int
     frame_count: int
@@ -80,6 +83,9 @@ def __init__(self, path, info_encoding='latin_1', bext_encoding='ascii'):
         #: RIFF cues markers, labels, and notes.
         self.cues: Optional[WavCuesReader] = None
 
+        #: Sampler `smpl` metadata
+        self.smpl: Optional[WavSmplReader] = None
+
         if hasattr(path, 'read'):
             self.get_wav_info(path)
             self.url = 'about:blank'
@@ -110,6 +116,7 @@ def get_wav_info(self, wavfile):
         self.info = self._get_info(wavfile, encoding=self.info_encoding)
         self.dolby = self._get_dbmd(wavfile)
         self.cues = self._get_cue(wavfile)
+        self.smpl = self._get_sampler_loops(wavfile)
         self.data = self._describe_data()
 
     def _find_chunk_data(self, ident, from_stream,
@@ -203,18 +210,23 @@ def _get_cue(self, f):
         return WavCuesReader.read_all(f, cue, labls, ltxts, notes,
                                       fallback_encoding=self.info_encoding)
 
+    def _get_sampler_loops(self, f):
+        sampler_data = self._find_chunk_data(b'smpl', f, default_none=True)
+        return WavSmplReader(sampler_data) if sampler_data else None
+
     # FIXME: this should probably be named "iter()"
     def walk(self) -> Generator[str, str, Any]:
         """
         Walk all of the available metadata fields.
 
         :yields: tuples of the *scope*, *key*, and *value* of
             each metadatum. The *scope* value will be one of
-            "fmt", "data", "ixml", "bext", "info", "dolby", "cues" or "adm".
+            "fmt", "data", "ixml", "bext", "info", "dolby", "cues", "adm" or
+            "smpl".
         """
 
         scopes = ('fmt', 'data', 'ixml', 'bext', 'info', 'adm', 'cues',
-                  'dolby')
+                  'dolby', 'smpl')
 
         for scope in scopes:
             if scope in ['fmt', 'data']:
@@ -223,10 +235,10 @@ def walk(self) -> Generator[str, str, Any]:
                     yield scope, field, attr.__getattribute__(field)
 
             else:
-                dict = self.__getattribute__(scope).to_dict(
+                mdict = self.__getattribute__(scope).to_dict(
                 ) if self.__getattribute__(scope) else {}
-                for key in dict.keys():
-                    yield scope, key, dict[key]
+                for key in mdict.keys():
+                    yield scope, key, mdict[key]
 
     def __repr__(self):
         return 'WavInfoReader({}, {}, {})'.format(self.path,