G722-numpy 1.2.4__tar.gz

g722_numpy-1.2.4/G722_numpy.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: G722-numpy
+Version: 1.2.4
+Summary: Optional NumPy backend for G.722 module
+Home-page: https://github.com/sippy/libg722
+Author: Maksym Sobolyev
+Author-email: sobomax@sippysoft.com
+License: Public-Domain
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: G722==1.2.4
+Requires-Dist: numpy
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# libg722
+
+[![Build & Test](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml/badge.svg)](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml)
+
+## Introduction
+
+The G.722 module is a bit exact implementation of the ITU G.722 specification
+for all three specified bit rates - 64000bps, 56000bps and 48000bps. It passes
+the ITU tests.
+
+To allow fast and flexible interworking with narrow band telephony, the
+encoder and decoder support an option for the linear audio to be an 8k
+samples/second stream. In this mode the codec is considerably faster, and
+still fully compatible with wideband terminals using G.722.
+
+## History
+
+The code was originally written by Milton Anderson <milton@thumper.bellcore.com>
+from BELLCORE, and has been modified by the Chengxiang Lu and Alex Hauptmann
+from the Speech Group, School of Computer Science, Carnegie Mellon University,
+to be fairly fast and efficient, while retaining high fidelity.
+
+Steve Underwood <steveu@coppice.org> improved the code a lot later on and
+contributed it into several popular open source projects.
+
+Himanshu Soni <sonihimanshu@gmail.com> has adjusted some coefficients
+to avoid over/under-flows in the decoder.
+
+Phil Schatzmann <phil.schatzmann@gmail.com> has added cmake-glue and Arduino
+support.
+
+Librarized by Sippy Software, Inc.
+
+## Build and Install library:
+
+### MacOS & Linux
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build -S libg722
+make -C libg722/build clean all test install
+```
+
+**Note for macOS users:** The library will be installed to `~/Library/libg722` by default. If you prefer a different location, you can specify it with:
+```
+cmake -B libg722/build -S libg722 -DCMAKE_INSTALL_PREFIX=/your/preferred/path
+```
+
+After installation, you may need to add the library path to your environment:
+```
+export DYLD_LIBRARY_PATH="$HOME/Library/libg722/lib:$DYLD_LIBRARY_PATH"
+```
+
+### iOS
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build-ios-device -S libg722 \
+  -DCMAKE_SYSTEM_NAME=iOS \
+  -DCMAKE_OSX_ARCHITECTURES=arm64 \
+  -DCMAKE_OSX_SYSROOT=iphoneos \
+  -DCMAKE_OSX_DEPLOYMENT_TARGET=12.0
+make -C libg722/build-ios-device
+```
+
+## Install Python module from PyPy:
+
+```
+pip install G722
+```
+
+## Build and Install Python module from source code:
+
+```
+git clone https://github.com/sippy/libg722.git
+pip install libg722/
+```
+
+This builds the **core** package (`G722`) with no hard dependency on NumPy.
+To install NumPy decode support on demand:
+
+```
+pip install "G722[numpy]"
+```
+
+or:
+
+```
+pip install G722-numpy
+```
+
+`LIBG722_BUILD_MODE` controls build profile for the main `G722` extension:
+- `production`: build with optimization (`-O2`, or `/O2` on Windows).
+- `debug`: build with `-g3 -O0`.
+- `auto` (default): if `.` is a git repository, run `git diff v{version} -- .`; build in `debug` mode when it differs, otherwise `production`. If `.` is not a git repository, use `production`.
+
+`LIBG722_PACKAGE_VARIANT` controls which Python distribution is built from this repository:
+- `core` (default): builds/publishes `G722`.
+- `numpy-addon`: builds/publishes `G722-numpy` from `python/G722_numpy_mod.c`.
+
+`G722(sample_rate, bit_rate, use_numpy=None)` accepts an optional `use_numpy` flag:
+- `True`: return NumPy arrays from `decode()` (raises if `G722-numpy` is not installed).
+- `False`: return Python `array('h')` from `decode()`.
+- omitted: auto-detect the optional backend and use NumPy when available, otherwise `array('h')`.
+
+## Pull library into your Docker container:
+```
+ARG BASE_IMAGE=debian:sid-slim
+ARG LIBG722_IMAGE=sippylabs/libg722:latest-debian_sid-slim
+FROM ${LIBG722_IMAGE} AS libg722
+FROM ${BASE_IMAGE} AS build
+COPY --from=libg722 /usr/local/lib/libg722.* /usr/local/lib/
+COPY --from=libg722 /usr/local/include/g722* /usr/local/include/
+```
+
+## License
+
+This code is mostly Public Domain. Library test code is under BSD 2-clause
+license.
+
+See LICENSE for copyright details and each individual file for specifics.

g722_numpy-1.2.4/G722_numpy.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+LICENSE
+MANIFEST.in
+README.md
+g722.h
+g722_codec.h
+g722_common.h
+g722_decode.c
+g722_decoder.h
+g722_encode.c
+g722_encoder.h
+g722_private.h
+pyproject.toml
+setup.py
+G722_numpy.egg-info/PKG-INFO
+G722_numpy.egg-info/SOURCES.txt
+G722_numpy.egg-info/dependency_links.txt
+G722_numpy.egg-info/requires.txt
+G722_numpy.egg-info/top_level.txt
+build_tools/CheckVersion.py
+build_tools/__init__.py
+python/G722_mod.c
+python/G722_numpy_api.h
+python/G722_numpy_mod.c
+python/symbols.map
+tests/test_decode.py
+tests/test_encode.py
+tests/test_encode_decode.py

g722_numpy-1.2.4/G722_numpy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

g722_numpy-1.2.4/G722_numpy.egg-info/requires.txt

@@ -0,0 +1,2 @@
+G722==1.2.4
+numpy

g722_numpy-1.2.4/G722_numpy.egg-info/top_level.txt

@@ -0,0 +1 @@
+G722_numpy

g722_numpy-1.2.4/LICENSE

@@ -0,0 +1,46 @@
+*****
+* Copyright (c) CMU    1993
+*
+* Computer Science, Speech Group
+* Chengxiang Lu and Alex Hauptmann
+*
+* The Carnegie Mellon ADPCM program is Copyright (c) 1993 by Carnegie Mellon
+* University. Use of this program, for any research or commercial purpose, is
+* completely unrestricted. If you make use of or redistribute this material,
+* we would appreciate acknowlegement of its origin.
+*****
+
+*****
+* Copyright (C) 2005 Steve Underwood
+*
+* Despite my general liking of the GPL, I place my own contributions
+* to this code in the public domain for the benefit of all mankind -
+* even the slimy ones who might try to proprietize my work and use it
+* to my detriment.
+*****
+
+*****
+* Copyright (c) 2014-2025 Sippy Software, Inc., http://www.sippysoft.com
+* 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.
+*
+* THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
+*****

g722_numpy-1.2.4/MANIFEST.in

@@ -0,0 +1,4 @@
+include build_tools/__init__.py build_tools/CheckVersion.py
+include g722.h g722_codec.h g722_common.h g722_decoder.h g722_encoder.h g722_private.h
+include g722_decode.c g722_encode.c python/G722_mod.c python/G722_numpy_mod.c
+include python/symbols.map python/G722_numpy_api.h

g722_numpy-1.2.4/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: G722-numpy
+Version: 1.2.4
+Summary: Optional NumPy backend for G.722 module
+Home-page: https://github.com/sippy/libg722
+Author: Maksym Sobolyev
+Author-email: sobomax@sippysoft.com
+License: Public-Domain
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: G722==1.2.4
+Requires-Dist: numpy
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# libg722
+
+[![Build & Test](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml/badge.svg)](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml)
+
+## Introduction
+
+The G.722 module is a bit exact implementation of the ITU G.722 specification
+for all three specified bit rates - 64000bps, 56000bps and 48000bps. It passes
+the ITU tests.
+
+To allow fast and flexible interworking with narrow band telephony, the
+encoder and decoder support an option for the linear audio to be an 8k
+samples/second stream. In this mode the codec is considerably faster, and
+still fully compatible with wideband terminals using G.722.
+
+## History
+
+The code was originally written by Milton Anderson <milton@thumper.bellcore.com>
+from BELLCORE, and has been modified by the Chengxiang Lu and Alex Hauptmann
+from the Speech Group, School of Computer Science, Carnegie Mellon University,
+to be fairly fast and efficient, while retaining high fidelity.
+
+Steve Underwood <steveu@coppice.org> improved the code a lot later on and
+contributed it into several popular open source projects.
+
+Himanshu Soni <sonihimanshu@gmail.com> has adjusted some coefficients
+to avoid over/under-flows in the decoder.
+
+Phil Schatzmann <phil.schatzmann@gmail.com> has added cmake-glue and Arduino
+support.
+
+Librarized by Sippy Software, Inc.
+
+## Build and Install library:
+
+### MacOS & Linux
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build -S libg722
+make -C libg722/build clean all test install
+```
+
+**Note for macOS users:** The library will be installed to `~/Library/libg722` by default. If you prefer a different location, you can specify it with:
+```
+cmake -B libg722/build -S libg722 -DCMAKE_INSTALL_PREFIX=/your/preferred/path
+```
+
+After installation, you may need to add the library path to your environment:
+```
+export DYLD_LIBRARY_PATH="$HOME/Library/libg722/lib:$DYLD_LIBRARY_PATH"
+```
+
+### iOS
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build-ios-device -S libg722 \
+  -DCMAKE_SYSTEM_NAME=iOS \
+  -DCMAKE_OSX_ARCHITECTURES=arm64 \
+  -DCMAKE_OSX_SYSROOT=iphoneos \
+  -DCMAKE_OSX_DEPLOYMENT_TARGET=12.0
+make -C libg722/build-ios-device
+```
+
+## Install Python module from PyPy:
+
+```
+pip install G722
+```
+
+## Build and Install Python module from source code:
+
+```
+git clone https://github.com/sippy/libg722.git
+pip install libg722/
+```
+
+This builds the **core** package (`G722`) with no hard dependency on NumPy.
+To install NumPy decode support on demand:
+
+```
+pip install "G722[numpy]"
+```
+
+or:
+
+```
+pip install G722-numpy
+```
+
+`LIBG722_BUILD_MODE` controls build profile for the main `G722` extension:
+- `production`: build with optimization (`-O2`, or `/O2` on Windows).
+- `debug`: build with `-g3 -O0`.
+- `auto` (default): if `.` is a git repository, run `git diff v{version} -- .`; build in `debug` mode when it differs, otherwise `production`. If `.` is not a git repository, use `production`.
+
+`LIBG722_PACKAGE_VARIANT` controls which Python distribution is built from this repository:
+- `core` (default): builds/publishes `G722`.
+- `numpy-addon`: builds/publishes `G722-numpy` from `python/G722_numpy_mod.c`.
+
+`G722(sample_rate, bit_rate, use_numpy=None)` accepts an optional `use_numpy` flag:
+- `True`: return NumPy arrays from `decode()` (raises if `G722-numpy` is not installed).
+- `False`: return Python `array('h')` from `decode()`.
+- omitted: auto-detect the optional backend and use NumPy when available, otherwise `array('h')`.
+
+## Pull library into your Docker container:
+```
+ARG BASE_IMAGE=debian:sid-slim
+ARG LIBG722_IMAGE=sippylabs/libg722:latest-debian_sid-slim
+FROM ${LIBG722_IMAGE} AS libg722
+FROM ${BASE_IMAGE} AS build
+COPY --from=libg722 /usr/local/lib/libg722.* /usr/local/lib/
+COPY --from=libg722 /usr/local/include/g722* /usr/local/include/
+```
+
+## License
+
+This code is mostly Public Domain. Library test code is under BSD 2-clause
+license.
+
+See LICENSE for copyright details and each individual file for specifics.

g722_numpy-1.2.4/README.md

@@ -0,0 +1,121 @@
+# libg722
+
+[![Build & Test](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml/badge.svg)](https://github.com/sippy/libg722/actions/workflows/build_and_test.yml)
+
+## Introduction
+
+The G.722 module is a bit exact implementation of the ITU G.722 specification
+for all three specified bit rates - 64000bps, 56000bps and 48000bps. It passes
+the ITU tests.
+
+To allow fast and flexible interworking with narrow band telephony, the
+encoder and decoder support an option for the linear audio to be an 8k
+samples/second stream. In this mode the codec is considerably faster, and
+still fully compatible with wideband terminals using G.722.
+
+## History
+
+The code was originally written by Milton Anderson <milton@thumper.bellcore.com>
+from BELLCORE, and has been modified by the Chengxiang Lu and Alex Hauptmann
+from the Speech Group, School of Computer Science, Carnegie Mellon University,
+to be fairly fast and efficient, while retaining high fidelity.
+
+Steve Underwood <steveu@coppice.org> improved the code a lot later on and
+contributed it into several popular open source projects.
+
+Himanshu Soni <sonihimanshu@gmail.com> has adjusted some coefficients
+to avoid over/under-flows in the decoder.
+
+Phil Schatzmann <phil.schatzmann@gmail.com> has added cmake-glue and Arduino
+support.
+
+Librarized by Sippy Software, Inc.
+
+## Build and Install library:
+
+### MacOS & Linux
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build -S libg722
+make -C libg722/build clean all test install
+```
+
+**Note for macOS users:** The library will be installed to `~/Library/libg722` by default. If you prefer a different location, you can specify it with:
+```
+cmake -B libg722/build -S libg722 -DCMAKE_INSTALL_PREFIX=/your/preferred/path
+```
+
+After installation, you may need to add the library path to your environment:
+```
+export DYLD_LIBRARY_PATH="$HOME/Library/libg722/lib:$DYLD_LIBRARY_PATH"
+```
+
+### iOS
+
+```
+git clone https://github.com/sippy/libg722.git
+cmake -B libg722/build-ios-device -S libg722 \
+  -DCMAKE_SYSTEM_NAME=iOS \
+  -DCMAKE_OSX_ARCHITECTURES=arm64 \
+  -DCMAKE_OSX_SYSROOT=iphoneos \
+  -DCMAKE_OSX_DEPLOYMENT_TARGET=12.0
+make -C libg722/build-ios-device
+```
+
+## Install Python module from PyPy:
+
+```
+pip install G722
+```
+
+## Build and Install Python module from source code:
+
+```
+git clone https://github.com/sippy/libg722.git
+pip install libg722/
+```
+
+This builds the **core** package (`G722`) with no hard dependency on NumPy.
+To install NumPy decode support on demand:
+
+```
+pip install "G722[numpy]"
+```
+
+or:
+
+```
+pip install G722-numpy
+```
+
+`LIBG722_BUILD_MODE` controls build profile for the main `G722` extension:
+- `production`: build with optimization (`-O2`, or `/O2` on Windows).
+- `debug`: build with `-g3 -O0`.
+- `auto` (default): if `.` is a git repository, run `git diff v{version} -- .`; build in `debug` mode when it differs, otherwise `production`. If `.` is not a git repository, use `production`.
+
+`LIBG722_PACKAGE_VARIANT` controls which Python distribution is built from this repository:
+- `core` (default): builds/publishes `G722`.
+- `numpy-addon`: builds/publishes `G722-numpy` from `python/G722_numpy_mod.c`.
+
+`G722(sample_rate, bit_rate, use_numpy=None)` accepts an optional `use_numpy` flag:
+- `True`: return NumPy arrays from `decode()` (raises if `G722-numpy` is not installed).
+- `False`: return Python `array('h')` from `decode()`.
+- omitted: auto-detect the optional backend and use NumPy when available, otherwise `array('h')`.
+
+## Pull library into your Docker container:
+```
+ARG BASE_IMAGE=debian:sid-slim
+ARG LIBG722_IMAGE=sippylabs/libg722:latest-debian_sid-slim
+FROM ${LIBG722_IMAGE} AS libg722
+FROM ${BASE_IMAGE} AS build
+COPY --from=libg722 /usr/local/lib/libg722.* /usr/local/lib/
+COPY --from=libg722 /usr/local/include/g722* /usr/local/include/
+```
+
+## License
+
+This code is mostly Public Domain. Library test code is under BSD 2-clause
+license.
+
+See LICENSE for copyright details and each individual file for specifics.

g722_numpy-1.2.4/build_tools/CheckVersion.py

@@ -0,0 +1,24 @@
+import sys
+from distutils.core import Command
+
+class CheckVersion(Command):
+    description = "Check version number"
+    user_options = [
+        ('tag=', 't', 'git tag to compare against package version'),
+    ]
+    extra_compile_args = []
+    extra_link_args = []
+
+    def initialize_options(self):
+        self.tag = None
+
+    def finalize_options(self):
+        if not self.tag:
+            raise DistutilsOptionError("You must specify --tag")
+
+    def run(self):
+        pkg_version = self.distribution.get_version()
+        if self.tag == f'v{pkg_version}':
+            return
+        sys.stderr.write(f"❌ version {pkg_version} != tag {self.tag}\n")
+        sys.exit(1)

g722_numpy-1.2.4/g722.h

@@ -0,0 +1,55 @@
+/*
+ * SpanDSP - a series of DSP components for telephony
+ *
+ * g722.h - The ITU G.722 codec.
+ *
+ * Written by Steve Underwood <steveu@coppice.org>
+ *
+ * Copyright (C) 2005 Steve Underwood
+ *
+ *  Despite my general liking of the GPL, I place my own contributions
+ *  to this code in the public domain for the benefit of all mankind -
+ *  even the slimy ones who might try to proprietize my work and use it
+ *  to my detriment.
+ *
+ * Based on a single channel G.722 codec which is:
+ *
+ *****    Copyright (c) CMU    1993      *****
+ * Computer Science, Speech Group
+ * Chengxiang Lu and Alex Hauptmann
+ *
+ * $Id: g722.h,v 1.1 2012/08/07 11:33:45 sobomax Exp $
+ */
+
+
+/*! \file */
+
+#pragma once
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*! \page g722_page G.722 encoding and decoding
+\section g722_page_sec_1 What does it do?
+The G.722 module is a bit exact implementation of the ITU G.722 specification for all three
+specified bit rates - 64000bps, 56000bps and 48000bps. It passes the ITU tests.
+
+To allow fast and flexible interworking with narrow band telephony, the encoder and decoder
+support an option for the linear audio to be an 8k samples/second stream. In this mode the
+codec is considerably faster, and still fully compatible with wideband terminals using G.722.
+
+\section g722_page_sec_2 How does it work?
+???.
+*/
+
+enum
+{
+    G722_DEFAULT = 0x0000,
+    G722_SAMPLE_RATE_8000 = 0x0001,
+    G722_PACKED = 0x0002
+};
+
+#ifdef __cplusplus
+}
+#endif

g722_numpy-1.2.4/g722_codec.h

@@ -0,0 +1,15 @@
+/**
+ * @file g722_codec.h
+ * @author Phil Schatzmann
+ * @brief Include for encoder and decoder which supports C++
+ * @version 0.1
+ * @date 2022-05-08
+ *
+ * @copyright Copyright (c) 2022
+ *
+ */
+
+#pragma once
+
+#include "g722_encoder.h"
+#include "g722_decoder.h"