first commit

Author: mitchsayre

.gitignore

@@ -0,0 +1,11 @@
+.venv*/
+
+__pycache__/
+build/
+dist/
+python/wfloat.egg-info/
+python/wfloat/lib/*.so
+python/wfloat/lib/*.pyd
+python/wfloat/lib/*.dll
+python/wfloat/lib/*.dylib
+python/wfloat/lib/*.lib

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "files.watcherExclude": {
+        "**/.git/objects/**": true,
+        "**/.git/subtree-cache/**": true,
+        "**/node_modules/*/**": true,
+        "**/.venv*/**": true,
+    }
+}

MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+recursive-include _build_support *.py
+recursive-include python *.py

README.md

@@ -0,0 +1,34 @@
+# wfloat
+
+Low-level Python bindings for Wfloat TTS built from the modified `sherpa-onnx`
+source in this monorepo.
+
+This package intentionally exposes the native binding surface directly. Model
+download, filesystem cache management, and higher-level client APIs are out of
+scope for this package skeleton.
+
+## Scope
+
+- Native `OfflineTts` binding for Wfloat TTS
+- Low-level config objects
+- Text preparation helpers
+- Wave writing helpers
+
+## Build Notes
+
+This package builds against the sibling `sherpa-onnx` source tree in this repo.
+It is meant to produce platform-specific wheels that bundle the compiled native
+extension inside the `wfloat` package.
+
+```bash
+python3.12 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip setuptools wheel build cmake ninja
+
+# optional override: export WFLOAT_SHERPA_ONNX_SOURCE_DIR=/some/other/sherpa-onnx
+python -m build --wheel
+
+# Install the built wheel into the same venv for testing:
+python -m pip install dist/*.whl
+```
+

_build_support/__init__.py

@@ -0,0 +1 @@
+

_build_support/cmake_extension.py

@@ -0,0 +1,126 @@
+# Derived from sherpa-onnx/cmake/cmake_extension.py and adapted for the
+# standalone wfloat Python package.
+
+import os
+import platform
+import shlex
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+import setuptools
+from setuptools.command.build_ext import build_ext
+
+
+def is_windows() -> bool:
+    return platform.system() == "Windows"
+
+
+try:
+    from wheel.bdist_wheel import bdist_wheel as _bdist_wheel
+
+    class bdist_wheel(_bdist_wheel):
+        def finalize_options(self):
+            _bdist_wheel.finalize_options(self)
+            self.root_is_pure = False
+
+except ImportError:
+    bdist_wheel = None
+
+
+def cmake_extension(name, *args, **kwargs) -> setuptools.Extension:
+    kwargs["language"] = "c++"
+    return setuptools.Extension(name, sources=[], *args, **kwargs)
+
+
+def _get_repo_root() -> Path:
+    return Path(__file__).resolve().parents[3]
+
+
+def _get_sherpa_onnx_source_dir() -> Path:
+    env_dir = os.environ.get("WFLOAT_SHERPA_ONNX_SOURCE_DIR")
+    if env_dir:
+        source_dir = Path(env_dir).expanduser().resolve()
+    else:
+        source_dir = (_get_repo_root() / "sherpa-onnx").resolve()
+
+    if not source_dir.is_dir():
+        raise RuntimeError(
+            f"Could not find sherpa-onnx source tree at {source_dir}. "
+            "Set WFLOAT_SHERPA_ONNX_SOURCE_DIR to override."
+        )
+
+    return source_dir
+
+
+def _run(cmd):
+    print("Running:", " ".join(cmd))
+    subprocess.run(cmd, check=True)
+
+
+class BuildExtension(build_ext):
+    def build_extension(self, ext: setuptools.extension.Extension):
+        del ext
+
+        build_temp = Path(self.build_temp).resolve()
+        build_lib = Path(self.build_lib).resolve()
+        install_dir = build_lib / "wfloat"
+        source_dir = _get_sherpa_onnx_source_dir()
+
+        build_temp.mkdir(parents=True, exist_ok=True)
+        build_lib.mkdir(parents=True, exist_ok=True)
+
+        user_cmake_args = shlex.split(os.environ.get("SHERPA_ONNX_CMAKE_ARGS", ""))
+        default_cmake_args = [
+            "-DCMAKE_BUILD_TYPE=Release",
+            f"-DCMAKE_INSTALL_PREFIX={install_dir}",
+            "-DBUILD_SHARED_LIBS=ON",
+            "-DBUILD_PIPER_PHONMIZE_EXE=OFF",
+            "-DBUILD_PIPER_PHONMIZE_TESTS=OFF",
+            "-DBUILD_ESPEAK_NG_EXE=OFF",
+            "-DBUILD_ESPEAK_NG_TESTS=OFF",
+            "-DSHERPA_ONNX_ENABLE_C_API=OFF",
+            "-DSHERPA_ONNX_BUILD_C_API_EXAMPLES=OFF",
+            "-DSHERPA_ONNX_ENABLE_CHECK=OFF",
+            "-DSHERPA_ONNX_ENABLE_PYTHON=ON",
+            "-DSHERPA_ONNX_ENABLE_TTS=ON",
+            "-DSHERPA_ONNX_ENABLE_BINARY=OFF",
+            "-DSHERPA_ONNX_ENABLE_PORTAUDIO=OFF",
+        ]
+
+        if not any(arg.startswith("-DPYTHON_EXECUTABLE=") for arg in user_cmake_args):
+            default_cmake_args.append(f"-DPYTHON_EXECUTABLE={sys.executable}")
+
+        configure_cmd = [
+            "cmake",
+            *default_cmake_args,
+            *user_cmake_args,
+            "-B",
+            str(build_temp),
+            "-S",
+            str(source_dir),
+        ]
+
+        build_cmd = ["cmake", "--build", str(build_temp), "--target", "install"]
+        if is_windows():
+            build_cmd.extend(["--config", "Release"])
+
+        parallel_level = os.environ.get("CMAKE_BUILD_PARALLEL_LEVEL")
+        if parallel_level:
+            build_cmd.extend(["--parallel", parallel_level])
+        else:
+            build_cmd.extend(["--parallel", "4"])
+
+        _run(configure_cmd)
+        _run(build_cmd)
+
+        # Keep only the runtime files that belong inside the Python package.
+        for extra_dir in ("bin", "include", "share"):
+            candidate = install_dir / extra_dir
+            if candidate.is_dir():
+                shutil.rmtree(candidate)
+
+        pkgconfig_dir = install_dir / "lib" / "pkgconfig"
+        if pkgconfig_dir.is_dir():
+            shutil.rmtree(pkgconfig_dir)

out.wav

@@ -0,0 +1,4 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+

pyproject.toml

@@ -0,0 +1,30 @@
+from ._bindings import (
+    GeneratedAudio,
+    GenerationConfig,
+    OfflineTts,
+    OfflineTtsConfig,
+    OfflineTtsModelConfig,
+    OfflineTtsWfloatModelConfig,
+    WfloatPreparedText,
+    git_date,
+    git_sha1,
+    prepare_wfloat_text,
+    version,
+    write_wave,
+)
+
+__all__ = [
+    "GeneratedAudio",
+    "GenerationConfig",
+    "OfflineTts",
+    "OfflineTtsConfig",
+    "OfflineTtsModelConfig",
+    "OfflineTtsWfloatModelConfig",
+    "WfloatPreparedText",
+    "git_date",
+    "git_sha1",
+    "prepare_wfloat_text",
+    "version",
+    "write_wave",
+]
+

python/wfloat/__init__.py

@@ -0,0 +1,37 @@
+try:
+    from wfloat.lib._sherpa_onnx import (
+        GeneratedAudio,
+        GenerationConfig,
+        OfflineTts,
+        OfflineTtsConfig,
+        OfflineTtsModelConfig,
+        OfflineTtsWfloatModelConfig,
+        WfloatPreparedText,
+        git_date,
+        git_sha1,
+        prepare_wfloat_text,
+        version,
+        write_wave,
+    )
+except ImportError as exc:
+    raise ImportError(
+        "Failed to import the wfloat native extension. "
+        "Build the package from this repo or install a wheel for your platform."
+    ) from exc
+
+
+__all__ = [
+    "GeneratedAudio",
+    "GenerationConfig",
+    "OfflineTts",
+    "OfflineTtsConfig",
+    "OfflineTtsModelConfig",
+    "OfflineTtsWfloatModelConfig",
+    "WfloatPreparedText",
+    "git_date",
+    "git_sha1",
+    "prepare_wfloat_text",
+    "version",
+    "write_wave",
+]
+