visqol-python 3.3.3__tar.gz → 3.3.4__tar.gz

{visqol_python-3.3.3/visqol_python.egg-info → visqol_python-3.3.4}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: visqol-python
-Version: 3.3.3
+Version: 3.3.4
 Summary: ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)
-Home-page: https://github.com/talker93/visqol-python
 Author: Shan Jiang
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/talker93/visqol-python
+Project-URL: Changelog, https://github.com/talker93/visqol-python/blob/main/CHANGELOG.md
 Project-URL: Bug Reports, https://github.com/talker93/visqol-python/issues
 Project-URL: Source, https://github.com/talker93/visqol-python
 Project-URL: Original C++, https://github.com/google/visqol
@@ -14,7 +14,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -22,19 +21,24 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
 Classifier: Topic :: Scientific/Engineering
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.20
 Requires-Dist: scipy>=1.7
 Requires-Dist: soundfile>=0.10
 Requires-Dist: libsvm-official>=3.25
-Dynamic: home-page
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
 Dynamic: license-file
-Dynamic: requires-python
 
 # ViSQOL (Python)
 
+[![PyPI version](https://img.shields.io/pypi/v/visqol-python)](https://pypi.org/project/visqol-python/)
+[![CI](https://github.com/talker93/visqol-python/actions/workflows/ci.yml/badge.svg)](https://github.com/talker93/visqol-python/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/pypi/pyversions/visqol-python)](https://pypi.org/project/visqol-python/)
+[![License](https://img.shields.io/github/license/talker93/visqol-python)](LICENSE)
+
 A pure Python implementation of [Google's ViSQOL](https://github.com/google/visqol) (Virtual Speech Quality Objective Listener) v3.3.3 for objective audio/speech quality assessment.
 
 ViSQOL compares a reference audio signal with a degraded version and outputs a **MOS-LQO** (Mean Opinion Score - Listening Quality Objective) score on a scale of **1.0 – 5.0**.
@@ -52,10 +56,10 @@ ViSQOL compares a reference audio signal with a degraded version and outputs a *
 ## Installation
 
 ```bash
-pip install numpy scipy soundfile libsvm-official
+pip install visqol-python
 ```
 
-Or install as a package:
+Or install from source:
 
 ```bash
 git clone https://github.com/talker93/visqol-python.git
@@ -167,8 +171,8 @@ Measured on Apple M-series, Python 3.13:
 ```
 visqol-python/
 ├── visqol/                    # Main package
-│   ├── __init__.py            # Package exports
-│   ├── api.py                 # Public API
+│   ├── __init__.py            # Package exports & version
+│   ├── api.py                 # Public API (VisqolApi)
 │   ├── visqol_manager.py      # Pipeline orchestrator
 │   ├── visqol_core.py         # Core algorithm
 │   ├── audio_utils.py         # Audio I/O & SPL normalization
@@ -180,14 +184,18 @@ visqol-python/
 │   ├── alignment.py           # Global alignment via cross-correlation
 │   ├── nsim.py                # NSIM similarity metric
 │   ├── quality_mapper.py      # SVR & exponential quality mapping
-│   └── __main__.py            # CLI entry point
-├── model/                     # Bundled SVR model
-│   └── libsvm_nu_svr_model.txt
-├── tests/                     # Conformance tests
-│   ├── test_conformance.py
-│   └── test_quick.py
-├── setup.py
-├── requirements.txt
+│   ├── __main__.py            # CLI entry point
+│   └── model/                 # Bundled SVR model
+│       └── libsvm_nu_svr_model.txt
+├── tests/                     # Tests (pytest)
+│   ├── conftest.py            # Shared fixtures & CLI options
+│   ├── test_quick.py          # Smoke tests (no external data needed)
+│   └── test_conformance.py    # Full conformance tests (needs testdata)
+├── .github/workflows/
+│   ├── ci.yml                 # CI: test on Python 3.9–3.13
+│   └── publish.yml            # Auto-publish to PyPI on tag push
+├── pyproject.toml             # Package metadata & build config
+├── CHANGELOG.md
 ├── LICENSE
 └── README.md
 ```

{visqol_python-3.3.3 → visqol_python-3.3.4}/README.md

@@ -1,5 +1,10 @@
 # ViSQOL (Python)
 
+[![PyPI version](https://img.shields.io/pypi/v/visqol-python)](https://pypi.org/project/visqol-python/)
+[![CI](https://github.com/talker93/visqol-python/actions/workflows/ci.yml/badge.svg)](https://github.com/talker93/visqol-python/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/pypi/pyversions/visqol-python)](https://pypi.org/project/visqol-python/)
+[![License](https://img.shields.io/github/license/talker93/visqol-python)](LICENSE)
+
 A pure Python implementation of [Google's ViSQOL](https://github.com/google/visqol) (Virtual Speech Quality Objective Listener) v3.3.3 for objective audio/speech quality assessment.
 
 ViSQOL compares a reference audio signal with a degraded version and outputs a **MOS-LQO** (Mean Opinion Score - Listening Quality Objective) score on a scale of **1.0 – 5.0**.
@@ -17,10 +22,10 @@ ViSQOL compares a reference audio signal with a degraded version and outputs a *
 ## Installation
 
 ```bash
-pip install numpy scipy soundfile libsvm-official
+pip install visqol-python
 ```
 
-Or install as a package:
+Or install from source:
 
 ```bash
 git clone https://github.com/talker93/visqol-python.git
@@ -132,8 +137,8 @@ Measured on Apple M-series, Python 3.13:
 ```
 visqol-python/
 ├── visqol/                    # Main package
-│   ├── __init__.py            # Package exports
-│   ├── api.py                 # Public API
+│   ├── __init__.py            # Package exports & version
+│   ├── api.py                 # Public API (VisqolApi)
 │   ├── visqol_manager.py      # Pipeline orchestrator
 │   ├── visqol_core.py         # Core algorithm
 │   ├── audio_utils.py         # Audio I/O & SPL normalization
@@ -145,14 +150,18 @@ visqol-python/
 │   ├── alignment.py           # Global alignment via cross-correlation
 │   ├── nsim.py                # NSIM similarity metric
 │   ├── quality_mapper.py      # SVR & exponential quality mapping
-│   └── __main__.py            # CLI entry point
-├── model/                     # Bundled SVR model
-│   └── libsvm_nu_svr_model.txt
-├── tests/                     # Conformance tests
-│   ├── test_conformance.py
-│   └── test_quick.py
-├── setup.py
-├── requirements.txt
+│   ├── __main__.py            # CLI entry point
+│   └── model/                 # Bundled SVR model
+│       └── libsvm_nu_svr_model.txt
+├── tests/                     # Tests (pytest)
+│   ├── conftest.py            # Shared fixtures & CLI options
+│   ├── test_quick.py          # Smoke tests (no external data needed)
+│   └── test_conformance.py    # Full conformance tests (needs testdata)
+├── .github/workflows/
+│   ├── ci.yml                 # CI: test on Python 3.9–3.13
+│   └── publish.yml            # Auto-publish to PyPI on tag push
+├── pyproject.toml             # Package metadata & build config
+├── CHANGELOG.md
 ├── LICENSE
 └── README.md
 ```

{visqol_python-3.3.3 → visqol_python-3.3.4}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "visqol-python"
-version = "3.3.3"
+dynamic = ["version"]
 description = "ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)"
 readme = "README.md"
 license = "Apache-2.0"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 authors = [
     {name = "Shan Jiang"},
 ]
@@ -21,7 +21,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -37,8 +36,12 @@ dependencies = [
     "libsvm-official>=3.25",
 ]
 
+[project.optional-dependencies]
+test = ["pytest>=7.0"]
+
 [project.urls]
 Homepage = "https://github.com/talker93/visqol-python"
+Changelog = "https://github.com/talker93/visqol-python/blob/main/CHANGELOG.md"
 "Bug Reports" = "https://github.com/talker93/visqol-python/issues"
 Source = "https://github.com/talker93/visqol-python"
 "Original C++" = "https://github.com/google/visqol"
@@ -46,8 +49,14 @@ Source = "https://github.com/talker93/visqol-python"
 [project.scripts]
 visqol = "visqol.__main__:main"
 
+[tool.setuptools.dynamic]
+version = {attr = "visqol.__version__"}
+
 [tool.setuptools.packages.find]
 exclude = ["tests*"]
 
 [tool.setuptools.package-data]
 visqol = ["model/*.txt"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

visqol_python-3.3.4/tests/test_conformance.py

@@ -0,0 +1,125 @@
+"""
+ViSQOL Python conformance tests.
+
+Requires the official ViSQOL testdata directory. Provide it via:
+    pytest tests/test_conformance.py --testdata /path/to/visqol/testdata
+
+The testdata directory should contain:
+    conformance_testdata_subset/  (audio test WAV files)
+    clean_speech/                 (speech test WAV files)
+
+You can obtain these from the official ViSQOL repository:
+    https://github.com/google/visqol
+"""
+
+import os
+
+import pytest
+
+from visqol import VisqolApi
+
+
+# ── Fixtures ──
+
+@pytest.fixture(scope="session")
+def testdata_dir(request):
+    """Resolve testdata directory from --testdata or auto-detect."""
+    td = request.config.getoption("--testdata")
+    if td and os.path.isdir(td):
+        return td
+    # Fallback: look relative to this file (when inside the original visqol repo)
+    candidate = os.path.join(os.path.dirname(__file__), "..", "..", "testdata")
+    if os.path.isdir(candidate):
+        return candidate
+    pytest.skip("testdata directory not found — use --testdata /path/to/visqol/testdata")
+
+
+@pytest.fixture(scope="session")
+def conf_dir(testdata_dir):
+    return os.path.join(testdata_dir, "conformance_testdata_subset")
+
+
+@pytest.fixture(scope="session")
+def speech_dir(testdata_dir):
+    return os.path.join(testdata_dir, "clean_speech")
+
+
+@pytest.fixture(scope="session")
+def audio_api():
+    api = VisqolApi()
+    api.create(mode="audio")
+    return api
+
+
+@pytest.fixture(scope="session")
+def speech_api():
+    api = VisqolApi()
+    api.create(mode="speech")
+    return api
+
+
+# ── Test data ──
+
+TOLERANCE = 0.05
+
+AUDIO_CASES = [
+    ("strauss48_stereo.wav", "strauss48_stereo_lp35.wav",
+     1.3888791489130758, "strauss_lp35"),
+    ("steely48_stereo.wav", "steely48_stereo_lp7.wav",
+     2.2501683734385183, "steely_lp7"),
+    ("sopr48_stereo.wav", "sopr48_stereo_256kbps_aac.wav",
+     4.68228969737946, "sopr_256aac"),
+    ("ravel48_stereo.wav", "ravel48_stereo_128kbps_opus.wav",
+     4.465141897255348, "ravel_128opus"),
+    ("moonlight48_stereo.wav", "moonlight48_stereo_128kbps_aac.wav",
+     4.684292801646114, "moonlight_128aac"),
+    ("harpsichord48_stereo.wav", "harpsichord48_stereo_96kbps_mp3.wav",
+     4.22374532766003, "harpsichord_96mp3"),
+    ("guitar48_stereo.wav", "guitar48_stereo_64kbps_aac.wav",
+     4.349722308064298, "guitar_64aac"),
+    ("glock48_stereo.wav", "glock48_stereo_48kbps_aac.wav",
+     4.332452943882108, "glock_48aac"),
+    ("contrabassoon48_stereo.wav", "contrabassoon48_stereo_24kbps_aac.wav",
+     2.346868205375293, "contrabassoon_24aac"),
+    ("castanets48_stereo.wav", "castanets48_stereo.wav",
+     4.732101253042348, "castanets_identity"),
+]
+
+SPEECH_CASES = [
+    ("CA01_01.wav", "transcoded_CA01_01.wav",
+     3.374505555111911, "CA01_transcoded"),
+]
+
+
+# ── Audio mode tests ──
+
+@pytest.mark.parametrize(
+    "ref_name, deg_name, expected_mos, test_id",
+    AUDIO_CASES,
+    ids=[c[3] for c in AUDIO_CASES],
+)
+def test_audio_conformance(audio_api, conf_dir, ref_name, deg_name, expected_mos, test_id):
+    ref_path = os.path.join(conf_dir, ref_name)
+    deg_path = os.path.join(conf_dir, deg_name)
+    result = audio_api.measure(ref_path, deg_path)
+    diff = abs(result.moslqo - expected_mos)
+    assert diff < TOLERANCE, (
+        f"[{test_id}] MOS={result.moslqo:.6f}, expected={expected_mos:.6f}, diff={diff:.6f}"
+    )
+
+
+# ── Speech mode tests ──
+
+@pytest.mark.parametrize(
+    "ref_name, deg_name, expected_mos, test_id",
+    SPEECH_CASES,
+    ids=[c[3] for c in SPEECH_CASES],
+)
+def test_speech_conformance(speech_api, speech_dir, ref_name, deg_name, expected_mos, test_id):
+    ref_path = os.path.join(speech_dir, ref_name)
+    deg_path = os.path.join(speech_dir, deg_name)
+    result = speech_api.measure(ref_path, deg_path)
+    diff = abs(result.moslqo - expected_mos)
+    assert diff < TOLERANCE, (
+        f"[{test_id}] MOS={result.moslqo:.6f}, expected={expected_mos:.6f}, diff={diff:.6f}"
+    )

visqol_python-3.3.4/tests/test_quick.py

@@ -0,0 +1,89 @@
+"""
+Quick smoke tests for ViSQOL Python.
+
+These tests verify basic API functionality without requiring external testdata.
+"""
+
+import numpy as np
+import pytest
+
+from visqol import VisqolApi
+
+
+class TestApiCreation:
+    """Test that VisqolApi can be created in different modes."""
+
+    def test_create_audio_mode(self):
+        api = VisqolApi()
+        api.create(mode="audio")
+
+    def test_create_speech_mode(self):
+        api = VisqolApi()
+        api.create(mode="speech")
+
+    def test_create_default_mode(self):
+        """Default mode (no argument) should work as audio mode."""
+        api = VisqolApi()
+        api.create()
+
+
+class TestMeasureFromArrays:
+    """Test measure_from_arrays with synthetic signals."""
+
+    def test_identical_signal_high_score(self):
+        """Identical signals should produce a high MOS score."""
+        api = VisqolApi()
+        api.create(mode="speech")
+        sr = 16000
+        duration = 3.0
+        t = np.linspace(0, duration, int(sr * duration), endpoint=False)
+        signal = 0.5 * np.sin(2 * np.pi * 440 * t)
+        result = api.measure_from_arrays(signal, signal, sample_rate=sr)
+        assert result.moslqo >= 4.0, (
+            f"Identical signal should give MOS >= 4.0, got {result.moslqo:.4f}"
+        )
+
+    def test_degraded_signal_lower_score(self):
+        """Adding noise to a signal should produce a lower MOS score."""
+        api = VisqolApi()
+        api.create(mode="speech")
+        sr = 16000
+        duration = 3.0
+        t = np.linspace(0, duration, int(sr * duration), endpoint=False)
+        ref = 0.5 * np.sin(2 * np.pi * 440 * t)
+        rng = np.random.default_rng(42)
+        deg = ref + 0.3 * rng.standard_normal(len(ref))
+        result = api.measure_from_arrays(ref, deg, sample_rate=sr)
+        assert 1.0 <= result.moslqo <= 5.0, (
+            f"MOS should be in [1, 5], got {result.moslqo:.4f}"
+        )
+
+
+class TestResultFields:
+    """Test that SimilarityResult has all expected fields."""
+
+    def test_result_has_expected_fields(self):
+        api = VisqolApi()
+        api.create(mode="speech")
+        sr = 16000
+        duration = 3.0
+        t = np.linspace(0, duration, int(sr * duration), endpoint=False)
+        signal = 0.5 * np.sin(2 * np.pi * 440 * t)
+        result = api.measure_from_arrays(signal, signal, sample_rate=sr)
+        assert hasattr(result, "moslqo")
+        assert hasattr(result, "vnsim")
+        assert hasattr(result, "fvnsim")
+        assert hasattr(result, "fstdnsim")
+        assert hasattr(result, "fvdegenergy")
+        assert hasattr(result, "patch_sims")
+
+
+class TestVersion:
+    """Test package version is accessible."""
+
+    def test_version_string(self):
+        import visqol
+        assert hasattr(visqol, "__version__")
+        assert isinstance(visqol.__version__, str)
+        parts = visqol.__version__.split(".")
+        assert len(parts) >= 2, "Version should have at least major.minor"

{visqol_python-3.3.3 → visqol_python-3.3.4}/visqol/__init__.py

@@ -13,7 +13,7 @@ Usage:
     print(f"MOS-LQO: {result.moslqo}")
 """
 
-__version__ = "3.3.3"
+__version__ = "3.3.4"
 
 from visqol.api import VisqolApi
 

{visqol_python-3.3.3 → visqol_python-3.3.4/visqol_python.egg-info}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: visqol-python
-Version: 3.3.3
+Version: 3.3.4
 Summary: ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)
-Home-page: https://github.com/talker93/visqol-python
 Author: Shan Jiang
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/talker93/visqol-python
+Project-URL: Changelog, https://github.com/talker93/visqol-python/blob/main/CHANGELOG.md
 Project-URL: Bug Reports, https://github.com/talker93/visqol-python/issues
 Project-URL: Source, https://github.com/talker93/visqol-python
 Project-URL: Original C++, https://github.com/google/visqol
@@ -14,7 +14,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -22,19 +21,24 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
 Classifier: Topic :: Scientific/Engineering
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.20
 Requires-Dist: scipy>=1.7
 Requires-Dist: soundfile>=0.10
 Requires-Dist: libsvm-official>=3.25
-Dynamic: home-page
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
 Dynamic: license-file
-Dynamic: requires-python
 
 # ViSQOL (Python)
 
+[![PyPI version](https://img.shields.io/pypi/v/visqol-python)](https://pypi.org/project/visqol-python/)
+[![CI](https://github.com/talker93/visqol-python/actions/workflows/ci.yml/badge.svg)](https://github.com/talker93/visqol-python/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/pypi/pyversions/visqol-python)](https://pypi.org/project/visqol-python/)
+[![License](https://img.shields.io/github/license/talker93/visqol-python)](LICENSE)
+
 A pure Python implementation of [Google's ViSQOL](https://github.com/google/visqol) (Virtual Speech Quality Objective Listener) v3.3.3 for objective audio/speech quality assessment.
 
 ViSQOL compares a reference audio signal with a degraded version and outputs a **MOS-LQO** (Mean Opinion Score - Listening Quality Objective) score on a scale of **1.0 – 5.0**.
@@ -52,10 +56,10 @@ ViSQOL compares a reference audio signal with a degraded version and outputs a *
 ## Installation
 
 ```bash
-pip install numpy scipy soundfile libsvm-official
+pip install visqol-python
 ```
 
-Or install as a package:
+Or install from source:
 
 ```bash
 git clone https://github.com/talker93/visqol-python.git
@@ -167,8 +171,8 @@ Measured on Apple M-series, Python 3.13:
 ```
 visqol-python/
 ├── visqol/                    # Main package
-│   ├── __init__.py            # Package exports
-│   ├── api.py                 # Public API
+│   ├── __init__.py            # Package exports & version
+│   ├── api.py                 # Public API (VisqolApi)
 │   ├── visqol_manager.py      # Pipeline orchestrator
 │   ├── visqol_core.py         # Core algorithm
 │   ├── audio_utils.py         # Audio I/O & SPL normalization
@@ -180,14 +184,18 @@ visqol-python/
 │   ├── alignment.py           # Global alignment via cross-correlation
 │   ├── nsim.py                # NSIM similarity metric
 │   ├── quality_mapper.py      # SVR & exponential quality mapping
-│   └── __main__.py            # CLI entry point
-├── model/                     # Bundled SVR model
-│   └── libsvm_nu_svr_model.txt
-├── tests/                     # Conformance tests
-│   ├── test_conformance.py
-│   └── test_quick.py
-├── setup.py
-├── requirements.txt
+│   ├── __main__.py            # CLI entry point
+│   └── model/                 # Bundled SVR model
+│       └── libsvm_nu_svr_model.txt
+├── tests/                     # Tests (pytest)
+│   ├── conftest.py            # Shared fixtures & CLI options
+│   ├── test_quick.py          # Smoke tests (no external data needed)
+│   └── test_conformance.py    # Full conformance tests (needs testdata)
+├── .github/workflows/
+│   ├── ci.yml                 # CI: test on Python 3.9–3.13
+│   └── publish.yml            # Auto-publish to PyPI on tag push
+├── pyproject.toml             # Package metadata & build config
+├── CHANGELOG.md
 ├── LICENSE
 └── README.md
 ```

{visqol_python-3.3.3 → visqol_python-3.3.4}/visqol_python.egg-info/SOURCES.txt

@@ -3,7 +3,6 @@ MANIFEST.in
 README.md
 pyproject.toml
 requirements.txt
-setup.py
 tests/test_conformance.py
 tests/test_quick.py
 visqol/__init__.py

{visqol_python-3.3.3 → visqol_python-3.3.4}/visqol_python.egg-info/requires.txt

@@ -2,3 +2,6 @@ numpy>=1.20
 scipy>=1.7
 soundfile>=0.10
 libsvm-official>=3.25
+
+[test]
+pytest>=7.0

visqol_python-3.3.3/setup.py

@@ -1,58 +0,0 @@
-from setuptools import setup, find_packages
-import os
-
-here = os.path.abspath(os.path.dirname(__file__))
-
-with open(os.path.join(here, "README.md"), encoding="utf-8") as f:
-    long_description = f.read()
-
-setup(
-    name="visqol-python",
-    version="3.3.3",
-    description="ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/talker93/visqol-python",
-    author="Shan Jiang",
-    license="Apache-2.0",
-    packages=find_packages(exclude=["tests"]),
-    python_requires=">=3.8",
-    install_requires=[
-        "numpy>=1.20",
-        "scipy>=1.7",
-        "soundfile>=0.10",
-        "libsvm-official>=3.25",
-    ],
-    entry_points={
-        "console_scripts": [
-            "visqol=visqol.__main__:main",
-        ],
-    },
-    package_data={
-        "visqol": ["model/*.txt"],
-    },
-    include_package_data=True,
-    keywords=[
-        "audio-quality", "speech-quality", "MOS", "PESQ", "POLQA",
-        "visqol", "objective-metric", "perceptual-quality",
-    ],
-    classifiers=[
-        "Development Status :: 4 - Beta",
-        "Intended Audience :: Developers",
-        "Intended Audience :: Science/Research",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Programming Language :: Python :: 3.13",
-        "Topic :: Multimedia :: Sound/Audio :: Analysis",
-        "Topic :: Scientific/Engineering",
-    ],
-    project_urls={
-        "Bug Reports": "https://github.com/talker93/visqol-python/issues",
-        "Source": "https://github.com/talker93/visqol-python",
-        "Original C++": "https://github.com/google/visqol",
-    },
-)

visqol_python-3.3.3/tests/test_conformance.py

@@ -1,173 +0,0 @@
-#!/usr/bin/env python3
-"""
-ViSQOL Python conformance tests.
-
-Usage:
-    python tests/test_conformance.py --testdata /path/to/visqol/testdata
-
-The testdata directory should contain:
-    conformance_testdata_subset/  (audio test WAV files)
-    clean_speech/                 (speech test WAV files)
-
-You can obtain these from the official ViSQOL repository:
-    https://github.com/google/visqol
-"""
-
-import argparse
-import time
-import sys
-import os
-
-# Add project root for imports
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
-
-from visqol.api import VisqolApi
-
-
-def _get_testdata_dir():
-    parser = argparse.ArgumentParser(add_help=False)
-    parser.add_argument('--testdata', default=None)
-    args, _ = parser.parse_known_args()
-    if args.testdata:
-        return args.testdata
-    # Fallback: look relative to this file (when inside the original visqol repo)
-    candidate = os.path.join(os.path.dirname(__file__), '..', '..', 'testdata')
-    if os.path.isdir(candidate):
-        return candidate
-    print("ERROR: testdata directory not found.")
-    print("Usage: python tests/test_conformance.py --testdata /path/to/visqol/testdata")
-    sys.exit(1)
-
-
-TD = _get_testdata_dir()
-CONF = os.path.join(TD, 'conformance_testdata_subset')
-SPEECH = os.path.join(TD, 'clean_speech')
-
-TOLERANCE = 0.05
-
-AUDIO_TESTS = [
-    ('strauss48_stereo.wav', 'strauss48_stereo_lp35.wav',
-     1.3888791489130758, 'strauss_lp35'),
-    ('steely48_stereo.wav', 'steely48_stereo_lp7.wav',
-     2.2501683734385183, 'steely_lp7'),
-    ('sopr48_stereo.wav', 'sopr48_stereo_256kbps_aac.wav',
-     4.68228969737946, 'sopr_256aac'),
-    ('ravel48_stereo.wav', 'ravel48_stereo_128kbps_opus.wav',
-     4.465141897255348, 'ravel_128opus'),
-    ('moonlight48_stereo.wav', 'moonlight48_stereo_128kbps_aac.wav',
-     4.684292801646114, 'moonlight_128aac'),
-    ('harpsichord48_stereo.wav', 'harpsichord48_stereo_96kbps_mp3.wav',
-     4.22374532766003, 'harpsichord_96mp3'),
-    ('guitar48_stereo.wav', 'guitar48_stereo_64kbps_aac.wav',
-     4.349722308064298, 'guitar_64aac'),
-    ('glock48_stereo.wav', 'glock48_stereo_48kbps_aac.wav',
-     4.332452943882108, 'glock_48aac'),
-    ('contrabassoon48_stereo.wav', 'contrabassoon48_stereo_24kbps_aac.wav',
-     2.346868205375293, 'contrabassoon_24aac'),
-    ('castanets48_stereo.wav', 'castanets48_stereo.wav',
-     4.732101253042348, 'castanets_identity'),
-]
-
-SPEECH_TESTS = [
-    ('CA01_01.wav', 'transcoded_CA01_01.wav',
-     3.374505555111911, 'CA01_transcoded_exp'),
-]
-
-
-def run_audio_tests():
-    print("=" * 70)
-    print("AUDIO MODE CONFORMANCE TESTS")
-    print("=" * 70)
-
-    api = VisqolApi()
-    api.create(mode="audio")
-
-    pass_count = 0
-    fail_count = 0
-    total_time = 0
-
-    for ref, deg, expected, name in AUDIO_TESTS:
-        ref_path = os.path.join(CONF, ref)
-        deg_path = os.path.join(CONF, deg)
-
-        t0 = time.time()
-        result = api.measure(ref_path, deg_path)
-        elapsed = time.time() - t0
-        total_time += elapsed
-
-        diff = abs(result.moslqo - expected)
-        passed = diff < TOLERANCE
-        status = "PASS" if passed else "FAIL"
-
-        if passed:
-            pass_count += 1
-        else:
-            fail_count += 1
-
-        print(f"  {status} {name:30s} "
-              f"MOS={result.moslqo:.4f} "
-              f"exp={expected:.4f} "
-              f"diff={diff:.6f} "
-              f"({elapsed:.1f}s)")
-
-    print(f"\nAudio: {pass_count}/{len(AUDIO_TESTS)} passed "
-          f"(total: {total_time:.1f}s)")
-    return fail_count
-
-
-def run_speech_tests():
-    print("\n" + "=" * 70)
-    print("SPEECH MODE CONFORMANCE TESTS (exponential mapping)")
-    print("=" * 70)
-
-    api = VisqolApi()
-    api.create(mode="speech")
-
-    pass_count = 0
-    fail_count = 0
-    total_time = 0
-
-    for ref, deg, expected, name in SPEECH_TESTS:
-        ref_path = os.path.join(SPEECH, ref)
-        deg_path = os.path.join(SPEECH, deg)
-
-        t0 = time.time()
-        result = api.measure(ref_path, deg_path)
-        elapsed = time.time() - t0
-        total_time += elapsed
-
-        diff = abs(result.moslqo - expected)
-        passed = diff < TOLERANCE
-        status = "PASS" if passed else "FAIL"
-
-        if passed:
-            pass_count += 1
-        else:
-            fail_count += 1
-
-        print(f"  {status} {name:30s} "
-              f"MOS={result.moslqo:.4f} "
-              f"exp={expected:.4f} "
-              f"diff={diff:.6f} "
-              f"({elapsed:.1f}s)")
-
-    print(f"\nSpeech: {pass_count}/{len(SPEECH_TESTS)} passed "
-          f"(total: {total_time:.1f}s)")
-    return fail_count
-
-
-if __name__ == "__main__":
-    audio_fails = run_audio_tests()
-    speech_fails = run_speech_tests()
-
-    total_tests = len(AUDIO_TESTS) + len(SPEECH_TESTS)
-    total_fails = audio_fails + speech_fails
-
-    print("\n" + "=" * 70)
-    if total_fails == 0:
-        print(f"ALL {total_tests} CONFORMANCE TESTS PASSED!")
-    else:
-        print(f"FAILED: {total_fails}/{total_tests} tests")
-    print("=" * 70)
-
-    sys.exit(total_fails)

visqol_python-3.3.3/tests/test_quick.py

@@ -1,81 +0,0 @@
-#!/usr/bin/env python3
-"""
-Quick ViSQOL conformance tests (subset of 3 audio + 1 speech).
-
-Usage:
-    python tests/test_quick.py --testdata /path/to/visqol/testdata
-"""
-import argparse
-import time
-import sys
-import os
-
-# Add project root for imports
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
-
-from visqol.api import VisqolApi
-
-
-def _get_testdata_dir():
-    parser = argparse.ArgumentParser(add_help=False)
-    parser.add_argument('--testdata', default=None)
-    args, _ = parser.parse_known_args()
-    if args.testdata:
-        return args.testdata
-    candidate = os.path.join(os.path.dirname(__file__), '..', '..', 'testdata')
-    if os.path.isdir(candidate):
-        return candidate
-    print("ERROR: testdata directory not found.")
-    print("Usage: python tests/test_quick.py --testdata /path/to/visqol/testdata")
-    sys.exit(1)
-
-
-TD = _get_testdata_dir()
-CONF = os.path.join(TD, 'conformance_testdata_subset')
-SPEECH = os.path.join(TD, 'clean_speech')
-
-# Test 3 audio + 1 speech
-api_audio = VisqolApi()
-api_audio.create(mode="audio")
-
-tests = [
-    (CONF, 'guitar48_stereo.wav', 'guitar48_stereo_64kbps_aac.wav',
-     4.349722, 'guitar_64aac'),
-    (CONF, 'strauss48_stereo.wav', 'strauss48_stereo_lp35.wav',
-     1.388879, 'strauss_lp35'),
-    (CONF, 'castanets48_stereo.wav', 'castanets48_stereo.wav',
-     4.732101, 'castanets_id'),
-]
-
-all_pass = True
-for td, ref, deg, expected, name in tests:
-    t0 = time.time()
-    r = api_audio.measure(os.path.join(td, ref), os.path.join(td, deg))
-    dt = time.time() - t0
-    d = abs(r.moslqo - expected)
-    ok = d < 0.05
-    if not ok:
-        all_pass = False
-    print(f"{'PASS' if ok else 'FAIL'} {name:20s} "
-          f"MOS={r.moslqo:.4f} exp={expected:.4f} "
-          f"diff={d:.6f} ({dt:.1f}s)")
-    sys.stdout.flush()
-
-# Speech test
-api_speech = VisqolApi()
-api_speech.create(mode="speech")
-t0 = time.time()
-r = api_speech.measure(
-    os.path.join(SPEECH, 'CA01_01.wav'),
-    os.path.join(SPEECH, 'transcoded_CA01_01.wav'))
-dt = time.time() - t0
-d = abs(r.moslqo - 3.374506)
-ok = d < 0.05
-if not ok:
-    all_pass = False
-print(f"{'PASS' if ok else 'FAIL'} {'speech_CA01':20s} "
-      f"MOS={r.moslqo:.4f} exp=3.3745 "
-      f"diff={d:.6f} ({dt:.1f}s)")
-
-print(f"\n{'ALL PASS' if all_pass else 'SOME FAILED'}")
-sys.exit(0 if all_pass else 1)