opuslib-next-bundled 0.1.0__tar.gz

opuslib_next_bundled-0.1.0/.github/workflows/wheels.yml

@@ -0,0 +1,89 @@
+name: Wheels
+
+on:
+  push:
+    branches: ["main"]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up QEMU
+        if: runner.os == 'Linux'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.20.0
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build frontend
+        run: python -m pip install build scikit-build-core
+
+      - name: Build sdist
+        run: python -m build --sdist --no-isolation
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: ./dist/*.tar.gz
+
+  publish:
+    name: Publish PyPI
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+
+      - name: Flatten artifacts
+        run: |
+          mkdir -p upload-dist
+          find dist -type f \( -name '*.whl' -o -name '*.tar.gz' \) -exec cp {} upload-dist/ \;
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: upload-dist

opuslib_next_bundled-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.venv/
+build/
+dist/
+.cache/
+CMakeUserPresets.json

opuslib_next_bundled-0.1.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/opus"]
+	path = vendor/opus
+	url = https://github.com/xiph/opus

opuslib_next_bundled-0.1.0/CMakeLists.txt

@@ -0,0 +1,34 @@
+cmake_minimum_required(VERSION 3.25)
+project(opuslib_next_bundled LANGUAGES C)
+
+include(GNUInstallDirs)
+
+set(OPUS_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/vendor/opus")
+if(NOT EXISTS "${OPUS_SOURCE_DIR}/CMakeLists.txt")
+  message(FATAL_ERROR "Missing vendored opus source at ${OPUS_SOURCE_DIR}. Populate vendor/opus before building.")
+endif()
+
+set(PY_NATIVE_DIR "opuslib_next/_native")
+set(CMAKE_INSTALL_LIBDIR "${PY_NATIVE_DIR}")
+set(CMAKE_INSTALL_BINDIR "${PY_NATIVE_DIR}")
+set(CMAKE_INSTALL_INCLUDEDIR "${PY_NATIVE_DIR}/include")
+
+option(OPUS_BUILD_SHARED_LIBRARY "Build shared libopus" ON)
+option(OPUS_BUILD_TESTING "Build opus tests" OFF)
+option(OPUS_BUILD_PROGRAMS "Build opus tools" OFF)
+option(OPUS_INSTALL_PKG_CONFIG_MODULE "Install pkg-config file" OFF)
+option(OPUS_INSTALL_CMAKE_CONFIG_MODULE "Install CMake package config" OFF)
+
+set(BUILD_SHARED_LIBS ON CACHE BOOL "Build shared libraries" FORCE)
+set(BUILD_TESTING OFF CACHE BOOL "Disable tests" FORCE)
+set(OPUS_STACK_PROTECTOR OFF CACHE BOOL "Disable stack protector toggles" FORCE)
+
+add_subdirectory("${OPUS_SOURCE_DIR}" "${CMAKE_CURRENT_BINARY_DIR}/vendor-opus")
+
+if(TARGET opus)
+  set(OPUS_TARGET opus)
+elseif(TARGET libopus)
+  set(OPUS_TARGET libopus)
+else()
+  message(FATAL_ERROR "Unable to find libopus target from vendored sources.")
+endif()

opuslib_next_bundled-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, samwell
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

opuslib_next_bundled-0.1.0/LICENSES/opus.txt

@@ -0,0 +1,44 @@
+Copyright 2001-2023 Xiph.Org, Skype Limited, Octasic,
+Jean-Marc Valin, Timothy B. Terriberry,
+CSIRO, Gregory Maxwell, Mark Borgerding,
+Erik de Castro Lopo, Mozilla, Amazon
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+- Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+- Neither the name of Internet Society, IETF or IETF Trust, nor the
+names of specific contributors, may be used to endorse or promote
+products derived from this software without specific prior written
+permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Opus is subject to the royalty-free patent licenses which are
+specified at:
+
+Xiph.Org Foundation:
+https://datatracker.ietf.org/ipr/1524/
+
+Microsoft Corporation:
+https://datatracker.ietf.org/ipr/1914/
+
+Broadcom Corporation:
+https://datatracker.ietf.org/ipr/1526/

opuslib_next_bundled-0.1.0/LICENSES/opuslib-next.txt

@@ -0,0 +1,24 @@
+Copyright (c) 2025, Kalicyh
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the SvartalF nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

opuslib_next_bundled-0.1.0/NOTICE

@@ -0,0 +1,10 @@
+This project includes code derived from:
+
+- opuslib-next, Copyright (c) 2025 Kalicyh,
+  available at https://github.com/kalicyh/opuslib-next
+- Opus codec sources from xiph/opus,
+  Copyright (c) 2001-2023 Xiph.Org and other contributors,
+  available at https://github.com/xiph/opus
+
+This project redistributes source and binary artifacts under the terms
+described in the included license files.

opuslib_next_bundled-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: opuslib-next-bundled
+Version: 0.1.0
+Summary: Python bindings to libopus with bundled shared libraries
+Keywords: audio,codec,libopus,opus
+Author: samwell
+License-Expression: BSD-3-Clause
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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 :: Implementation :: CPython
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Classifier: Topic :: Software Development :: Libraries
+Project-URL: Homepage, https://github.com/kiwi-data/opuslib-next-bundled
+Project-URL: Repository, https://github.com/kiwi-data/opuslib-next-bundled
+Project-URL: Issues, https://github.com/kiwi-data/opuslib-next-bundled/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# opuslib-next-bundled
+
+Python bindings to `libopus`, with the compiled shared library bundled inside
+platform wheels.
+
+## Goals
+
+- Support Python 3.9 and newer
+- Preserve the `opuslib-next` Python API as much as practical
+- Publish wheels that do not depend on a system-installed `libopus`
+- Keep source builds reproducible by vendoring `xiph/opus`
+
+## Installation
+
+```bash
+pip install opuslib-next-bundled
+```
+
+Wheels are intended to contain `libopus` directly. Source builds require a
+populated `vendor/opus` tree.
+
+## Usage
+
+```python
+import opuslib_next
+```
+
+By default the package loads the bundled shared library from
+`opuslib_next/_native`. To force use of a system library for debugging:
+
+```bash
+OPUSLIB_NEXT_USE_SYSTEM_LIB=1 python -c "import opuslib_next"
+```
+
+## Development
+
+```bash
+python -m pip install -U build
+python -m build
+pytest
+```
+
+The CMake build fails fast if `vendor/opus` is missing. Populate it before
+building wheels.
+
+If you clone the repository directly, initialize the submodule first:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Upstream Attribution
+
+This project is derived in part from:
+
+- [`kalicyh/opuslib-next`](https://github.com/kalicyh/opuslib-next), whose
+  Python binding layer provided the compatibility base
+- [`xiph/opus`](https://github.com/xiph/opus), whose codec implementation is
+  bundled into built wheels
+
+See `NOTICE` and `LICENSES/` for the preserved third-party notices.
+
+## Repository
+
+Source repository: <https://github.com/kiwi-data/opuslib-next-bundled>

opuslib_next_bundled-0.1.0/README.md

@@ -0,0 +1,65 @@
+# opuslib-next-bundled
+
+Python bindings to `libopus`, with the compiled shared library bundled inside
+platform wheels.
+
+## Goals
+
+- Support Python 3.9 and newer
+- Preserve the `opuslib-next` Python API as much as practical
+- Publish wheels that do not depend on a system-installed `libopus`
+- Keep source builds reproducible by vendoring `xiph/opus`
+
+## Installation
+
+```bash
+pip install opuslib-next-bundled
+```
+
+Wheels are intended to contain `libopus` directly. Source builds require a
+populated `vendor/opus` tree.
+
+## Usage
+
+```python
+import opuslib_next
+```
+
+By default the package loads the bundled shared library from
+`opuslib_next/_native`. To force use of a system library for debugging:
+
+```bash
+OPUSLIB_NEXT_USE_SYSTEM_LIB=1 python -c "import opuslib_next"
+```
+
+## Development
+
+```bash
+python -m pip install -U build
+python -m build
+pytest
+```
+
+The CMake build fails fast if `vendor/opus` is missing. Populate it before
+building wheels.
+
+If you clone the repository directly, initialize the submodule first:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Upstream Attribution
+
+This project is derived in part from:
+
+- [`kalicyh/opuslib-next`](https://github.com/kalicyh/opuslib-next), whose
+  Python binding layer provided the compatibility base
+- [`xiph/opus`](https://github.com/xiph/opus), whose codec implementation is
+  bundled into built wheels
+
+See `NOTICE` and `LICENSES/` for the preserved third-party notices.
+
+## Repository
+
+Source repository: <https://github.com/kiwi-data/opuslib-next-bundled>

opuslib_next_bundled-0.1.0/opuslib_next/__init__.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# OpusLib Python Module.
+
+"""
+OpusLib Python Module.
+~~~~~~~
+
+Python bindings to the libopus, IETF low-delay audio codec
+
+:author: kalicyh <kalicyh@qq.com>
+:copyright: Copyright (c) 2025, Kalicyh
+:license: BSD 3-Clause License
+:source: <https://github.com/kalicyh/opuslib-next>
+
+"""
+
+from .exceptions import OpusError  # NOQA
+
+from .constants import *  # NOQA
+
+from .constants import OK, APPLICATION_TYPES_MAP  # NOQA
+
+from .classes import (  # NOQA
+    Decoder,
+    Encoder,
+    MultiStreamDecoder,
+    MultiStreamEncoder,
+    ProjectionDecoder,
+    ProjectionEncoder,
+)
+
+__author__ = 'kalicyh <kalicyh@qq.com>'
+__copyright__ = 'Copyright (c) 2025, Kalicyh'
+__license__ = 'BSD 3-Clause License'

opuslib_next_bundled-0.1.0/opuslib_next/_loader.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+import ctypes
+import os
+import platform
+from pathlib import Path
+from typing import Final
+
+from ctypes.util import find_library
+
+_PACKAGE_DIR: Final[Path] = Path(__file__).resolve().parent
+_NATIVE_DIR: Final[Path] = _PACKAGE_DIR / "_native"
+_SYSTEM_LIB_ENV: Final[str] = "OPUSLIB_NEXT_USE_SYSTEM_LIB"
+
+
+class OpusLibraryNotFoundError(RuntimeError):
+    """Raised when no usable libopus binary can be found."""
+
+
+def _library_filename() -> str:
+    system_name = platform.system()
+    if system_name == "Darwin":
+        return "libopus.dylib"
+    if system_name == "Linux":
+        return "libopus.so"
+    if system_name == "Windows":
+        return "opus.dll"
+    raise OpusLibraryNotFoundError(f"Unsupported operating system: {system_name}")
+
+
+def _bundled_library_path() -> Path:
+    return _NATIVE_DIR / _library_filename()
+
+
+def _system_library_name() -> str:
+    system_name = platform.system()
+    if system_name == "Windows":
+        return "opus"
+    return "opus"
+
+
+def _load_bundled_library() -> ctypes.CDLL:
+    library_path = _bundled_library_path()
+    if not library_path.exists():
+        raise OpusLibraryNotFoundError(f"Bundled Opus library not found: {library_path}")
+    return ctypes.CDLL(os.fspath(library_path))
+
+
+def _load_system_library() -> ctypes.CDLL:
+    system_path = find_library(_system_library_name())
+    if system_path is None:
+        raise OpusLibraryNotFoundError("System libopus could not be found")
+    return ctypes.CDLL(system_path)
+
+
+def load_libopus() -> ctypes.CDLL:
+    if os.environ.get(_SYSTEM_LIB_ENV) == "1":
+        return _load_system_library()
+    return _load_bundled_library()

opuslib_next_bundled-0.1.0/opuslib_next/_native/.gitkeep

@@ -0,0 +1 @@
+

opuslib_next_bundled-0.1.0/opuslib_next/api/__init__.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+# pylint: disable=invalid-name
+#
+
+"""Opus library loading and common ctypes aliases."""
+
+import ctypes
+
+from opuslib_next._loader import load_libopus
+
+__author__ = "kalicyh <kalicyh@qq.com>"
+__copyright__ = "Copyright (c) 2025, Kalicyh"
+__license__ = "BSD 3-Clause License"
+
+
+libopus = load_libopus()
+
+c_int_pointer = ctypes.POINTER(ctypes.c_int)
+c_int16_pointer = ctypes.POINTER(ctypes.c_int16)
+c_float_pointer = ctypes.POINTER(ctypes.c_float)
+c_ubyte_pointer = ctypes.POINTER(ctypes.c_ubyte)