././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8860593 mopidy_alsamixer-3.0.0/0000755000175100017510000000000015173001221014516 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/.copier-answers.yml0000644000175100017510000000040615173001212020260 0ustar00runnerrunner_commit: v2.2.0 _src_path: gh:mopidy/mopidy-ext-template author_email: stein.magnus@jodal.no author_full_name: Stein Magnus Jodal dist_name: mopidy-alsamixer ext_name: alsamixer github_username: mopidy short_description: Mopidy extension for ALSA volume control ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8815844 mopidy_alsamixer-3.0.0/.github/0000755000175100017510000000000015173001221016056 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8836966 mopidy_alsamixer-3.0.0/.github/workflows/0000755000175100017510000000000015173001221020113 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/.github/workflows/ci.yml0000644000175100017510000000300215173001212021224 0ustar00runnerrunnername: CI on: pull_request: push: branches: - main workflow_dispatch: jobs: build: name: Build runs-on: ubuntu-24.04 steps: - uses: actions/checkout@v6 - uses: hynek/build-and-inspect-python-package@v2 main: strategy: fail-fast: false matrix: include: - name: "pytest (3.13)" python: "3.13" tox: "3.13" - name: "pytest (3.14)" python: "3.14" tox: "3.14" coverage: true - name: "pyright" python: "3.14" tox: "pyright" - name: "ruff check" python: "3.14" tox: "ruff-check" - name: "ruff format" python: "3.14" tox: "ruff-format" name: ${{ matrix.name }} runs-on: ubuntu-24.04 container: ghcr.io/mopidy/ci:latest steps: - uses: actions/checkout@v6 - name: Fix home dir permissions to enable pip caching run: chown -R root /github/home - uses: actions/setup-python@v6 with: python-version: ${{ matrix.python }} cache: pip allow-prereleases: true - run: python -m pip install tox - run: python -m tox -e ${{ matrix.tox }} if: ${{ ! matrix.coverage }} - run: python -m tox -e ${{ matrix.tox }} -- --cov-report=xml if: ${{ matrix.coverage }} - uses: codecov/codecov-action@v5 if: ${{ matrix.coverage }} with: token: ${{ secrets.CODECOV_TOKEN }} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/.github/workflows/release.yml0000644000175100017510000000102315173001212022252 0ustar00runnerrunnername: Release on: release: types: [published] jobs: release: runs-on: ubuntu-24.04 environment: name: pypi url: https://pypi.org/project/mopidy-alsamixer/ permissions: id-token: write steps: - uses: actions/checkout@v6 - uses: hynek/build-and-inspect-python-package@v2 id: build - uses: actions/download-artifact@v4 with: name: ${{ steps.build.outputs.artifact-name }} path: dist - uses: pypa/gh-action-pypi-publish@release/v1 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/.gitignore0000644000175100017510000000012515173001212016504 0ustar00runnerrunner*.egg-info/ /*.lock /.*_cache/ /.coverage /.tox/ /.venv/ /build/ /dist/ __pycache__/ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/LICENSE0000644000175100017510000002613515173001212015532 0ustar00runnerrunner Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8860304 mopidy_alsamixer-3.0.0/PKG-INFO0000644000175100017510000001270715173001221015622 0ustar00runnerrunnerMetadata-Version: 2.4 Name: mopidy-alsamixer Version: 3.0.0 Summary: Mopidy extension for ALSA volume control Author-email: Stein Magnus Jodal License: Apache-2.0 Project-URL: Homepage, https://github.com/mopidy/mopidy-alsamixer Classifier: Environment :: No Input/Output (Daemon) Classifier: Intended Audience :: End Users/Desktop Classifier: License :: OSI Approved :: Apache Software License Classifier: Operating System :: OS Independent Classifier: Topic :: Multimedia :: Sound/Audio :: Players Requires-Python: >=3.13 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: mopidy>=4.0.0 Requires-Dist: pyalsaaudio>=0.10 Requires-Dist: pygobject>=3.50 Requires-Dist: pykka>=4.1 Dynamic: license-file # mopidy-alsamixer [![Latest PyPI version](https://img.shields.io/pypi/v/mopidy-alsamixer)](https://pypi.org/p/mopidy-alsamixer) [![CI build status](https://img.shields.io/github/actions/workflow/status/mopidy/mopidy-alsamixer/ci.yml)](https://github.com/mopidy/mopidy-alsamixer/actions/workflows/ci.yml) [![Test coverage](https://img.shields.io/codecov/c/gh/mopidy/mopidy-alsamixer)](https://codecov.io/gh/mopidy/mopidy-alsamixer) [Mopidy](https://mopidy.com) extension for ALSA volume control. ## Maintainer wanted mopidy-alsamixer is currently kept on life support by the Mopidy core developers. It is in need of a more dedicated maintainer. If you want to be the maintainer of mopidy-alsamixer, please: 1. Make 2-3 good pull requests improving any part of the project. 2. Read and get familiar with all of the project's open issues. 3. Send a pull request removing this section and adding yourself as the "Current maintainer" in the "Credits" section below. In the pull request description, please refer to the previous pull requests and state that you've familiarized yourself with the open issues. As a maintainer, you'll be given push access to the repo and the authority to make releases to PyPI when you see fit. ## Installation Install by running: ```sh python3 -m pip install mopidy-alsamixer ``` See https://mopidy.com/ext/alsamixer/ for alternative installation methods. ## Configuration To use mopidy-alsamixer the `audio/mixer` configuration value must be set to `alsamixer` in the Mopidy configuration file: ```ini [audio] mixer = alsamixer ``` The default mopidy-alsaMixer configuration will probably work for most use cases. If not, the following configuration values are available: - `alsamixer/device`: Which soundcard should be used, specified by its string alias. Defaults to `default`. - `alsamixer/card`: Which soundcard should be used, specified by its index. Numbered from 0 and up. If specified, `alsamixer/device` is ignored. - `alsamixer/control`: Which ALSA control should be used. Defaults to `Master`. Other typical values includes `PCM`. Run the command `amixer scontrols` to list available controls on your system. - `alsamixer/min_volume` and `alsamixer/max_volume`: Map the Mopidy volume control range to a different range. Values are in the range 0-100. Use this if the default range (0-100) is too wide, resulting in a small usable range for Mopidy's volume control. For example try `min_volume = 30` and `max_volume = 70` to map Mopidy's volume control to the middle of ALSA's volume range. - `alsamixer/volume_scale`: Either `linear`, `cubic`, or `log`. The cubic scale is the default as it is closer to how the human ear percieves volume, and matches the volume scale used in the `alsamixer` program. Example `alsamixer` section from the Mopidy configuration file: ```ini [alsamixer] card = 1 control = PCM min_volume = 0 max_volume = 100 volume_scale = cubic ``` ## Project resources - [Source code](https://github.com/mopidy/mopidy-alsamixer) - [Issues](https://github.com/mopidy/mopidy-alsamixer/issues) - [Releases](https://github.com/mopidy/mopidy-alsamixer/releases) ## Development ### Set up development environment Clone the repo using, e.g. using [gh](https://cli.github.com/): ```sh gh repo clone mopidy/mopidy-alsamixer ``` Enter the directory, and install dependencies using [uv](https://docs.astral.sh/uv/): ```sh cd mopidy-alsamixer/ uv sync ``` ### Running tests To run all tests and linters in isolated environments, use [tox](https://tox.wiki/): ```sh tox ``` To only run tests, use [pytest](https://pytest.org/): ```sh pytest ``` To format the code, use [ruff](https://docs.astral.sh/ruff/): ```sh ruff format . ``` To check for lints with ruff, run: ```sh ruff check . ``` To check for type errors, use [pyright](https://microsoft.github.io/pyright/): ```sh pyright . ``` ### Making a release To make a release to PyPI, go to the project's [GitHub releases page](https://github.com/mopidy/mopidy-alsamixer/releases) and click the "Draft a new release" button. In the "choose a tag" dropdown, select the tag you want to release or create a new tag, e.g. `v0.1.0`. Add a title, e.g. `v0.1.0`, and a description of the changes. Decide if the release is a pre-release (alpha, beta, or release candidate) or should be marked as the latest release, and click "Publish release". Once the release is created, the `release.yml` GitHub Action will automatically build and publish the release to [PyPI](https://pypi.org/project/mopidy-alsamixer/). ## Credits - Original author: [Stein Magnus Jodal](https://github.com/mopidy) - Current maintainer: None. Maintainer wanted, see section above. - [Contributors](https://github.com/mopidy/mopidy-alsamixer/graphs/contributors) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/README.md0000644000175100017510000001132715173001212016001 0ustar00runnerrunner# mopidy-alsamixer [![Latest PyPI version](https://img.shields.io/pypi/v/mopidy-alsamixer)](https://pypi.org/p/mopidy-alsamixer) [![CI build status](https://img.shields.io/github/actions/workflow/status/mopidy/mopidy-alsamixer/ci.yml)](https://github.com/mopidy/mopidy-alsamixer/actions/workflows/ci.yml) [![Test coverage](https://img.shields.io/codecov/c/gh/mopidy/mopidy-alsamixer)](https://codecov.io/gh/mopidy/mopidy-alsamixer) [Mopidy](https://mopidy.com) extension for ALSA volume control. ## Maintainer wanted mopidy-alsamixer is currently kept on life support by the Mopidy core developers. It is in need of a more dedicated maintainer. If you want to be the maintainer of mopidy-alsamixer, please: 1. Make 2-3 good pull requests improving any part of the project. 2. Read and get familiar with all of the project's open issues. 3. Send a pull request removing this section and adding yourself as the "Current maintainer" in the "Credits" section below. In the pull request description, please refer to the previous pull requests and state that you've familiarized yourself with the open issues. As a maintainer, you'll be given push access to the repo and the authority to make releases to PyPI when you see fit. ## Installation Install by running: ```sh python3 -m pip install mopidy-alsamixer ``` See https://mopidy.com/ext/alsamixer/ for alternative installation methods. ## Configuration To use mopidy-alsamixer the `audio/mixer` configuration value must be set to `alsamixer` in the Mopidy configuration file: ```ini [audio] mixer = alsamixer ``` The default mopidy-alsaMixer configuration will probably work for most use cases. If not, the following configuration values are available: - `alsamixer/device`: Which soundcard should be used, specified by its string alias. Defaults to `default`. - `alsamixer/card`: Which soundcard should be used, specified by its index. Numbered from 0 and up. If specified, `alsamixer/device` is ignored. - `alsamixer/control`: Which ALSA control should be used. Defaults to `Master`. Other typical values includes `PCM`. Run the command `amixer scontrols` to list available controls on your system. - `alsamixer/min_volume` and `alsamixer/max_volume`: Map the Mopidy volume control range to a different range. Values are in the range 0-100. Use this if the default range (0-100) is too wide, resulting in a small usable range for Mopidy's volume control. For example try `min_volume = 30` and `max_volume = 70` to map Mopidy's volume control to the middle of ALSA's volume range. - `alsamixer/volume_scale`: Either `linear`, `cubic`, or `log`. The cubic scale is the default as it is closer to how the human ear percieves volume, and matches the volume scale used in the `alsamixer` program. Example `alsamixer` section from the Mopidy configuration file: ```ini [alsamixer] card = 1 control = PCM min_volume = 0 max_volume = 100 volume_scale = cubic ``` ## Project resources - [Source code](https://github.com/mopidy/mopidy-alsamixer) - [Issues](https://github.com/mopidy/mopidy-alsamixer/issues) - [Releases](https://github.com/mopidy/mopidy-alsamixer/releases) ## Development ### Set up development environment Clone the repo using, e.g. using [gh](https://cli.github.com/): ```sh gh repo clone mopidy/mopidy-alsamixer ``` Enter the directory, and install dependencies using [uv](https://docs.astral.sh/uv/): ```sh cd mopidy-alsamixer/ uv sync ``` ### Running tests To run all tests and linters in isolated environments, use [tox](https://tox.wiki/): ```sh tox ``` To only run tests, use [pytest](https://pytest.org/): ```sh pytest ``` To format the code, use [ruff](https://docs.astral.sh/ruff/): ```sh ruff format . ``` To check for lints with ruff, run: ```sh ruff check . ``` To check for type errors, use [pyright](https://microsoft.github.io/pyright/): ```sh pyright . ``` ### Making a release To make a release to PyPI, go to the project's [GitHub releases page](https://github.com/mopidy/mopidy-alsamixer/releases) and click the "Draft a new release" button. In the "choose a tag" dropdown, select the tag you want to release or create a new tag, e.g. `v0.1.0`. Add a title, e.g. `v0.1.0`, and a description of the changes. Decide if the release is a pre-release (alpha, beta, or release candidate) or should be marked as the latest release, and click "Publish release". Once the release is created, the `release.yml` GitHub Action will automatically build and publish the release to [PyPI](https://pypi.org/project/mopidy-alsamixer/). ## Credits - Original author: [Stein Magnus Jodal](https://github.com/mopidy) - Current maintainer: None. Maintainer wanted, see section above. - [Contributors](https://github.com/mopidy/mopidy-alsamixer/graphs/contributors) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/pyproject.toml0000644000175100017510000000632115173001212017434 0ustar00runnerrunner[project] name = "mopidy-alsamixer" description = "Mopidy extension for ALSA volume control" readme = "README.md" requires-python = ">= 3.13" license = { text = "Apache-2.0" } authors = [{ name = "Stein Magnus Jodal", email = "stein.magnus@jodal.no" }] classifiers = [ "Environment :: No Input/Output (Daemon)", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Topic :: Multimedia :: Sound/Audio :: Players", ] dynamic = ["version"] dependencies = [ "mopidy >= 4.0.0", "pyalsaaudio >= 0.10", "pygobject >= 3.50", "pykka >= 4.1", ] [project.urls] Homepage = "https://github.com/mopidy/mopidy-alsamixer" [project.entry-points."mopidy.ext"] alsamixer = "mopidy_alsamixer:Extension" [build-system] requires = ["setuptools >= 78", "setuptools-scm >= 8.2"] build-backend = "setuptools.build_meta" [dependency-groups] dev = [ "tox", { include-group = "ruff" }, { include-group = "tests" }, { include-group = "typing" }, ] ruff = ["ruff"] tests = ["pytest", "pytest-cov"] typing = ["pyright"] [tool.coverage.paths] source = ["src/", "*/site-packages/"] [tool.coverage.run] source_pkgs = ["mopidy_alsamixer"] [tool.coverage.report] show_missing = true [tool.pyright] pythonVersion = "3.13" typeCheckingMode = "standard" # Not all dependencies have type hints: reportMissingTypeStubs = false # Already covered by ruff's flake8-self checks: reportPrivateImportUsage = false [tool.pytest.ini_options] filterwarnings = [ # By default, fail tests on warnings from our own code "error:::mopidy_alsamixer", # # Add any warnings you want to ignore here ] [tool.ruff] target-version = "py313" [tool.ruff.lint] select = ["ALL"] ignore = [ # Add rules you want to ignore here "D", # pydocstyle "D203", # one-blank-line-before-class "D213", # multi-line-summary-second-line "G004", # logging-f-string "TD002", # missing-todo-author "TD003", # missing-todo-link # # Conflicting with `ruff format` "COM812", # missing-trailing-comma "ISC001", # single-line-implicit-string-concatenation ] [tool.ruff.lint.per-file-ignores] "tests/*" = [ "ANN", # flake8-annotations "ARG", # flake8-unused-arguments "D", # pydocstyle "PLR2004", # magic-value-comparison # TODO "S101", # assert ] [tool.setuptools.package-data] "*" = ["*.conf"] [tool.setuptools_scm] # This section, even if empty, must be present for setuptools_scm to work [tool.tox] env_list = [ "3.13", "3.14", "pyright", "ruff-check", "ruff-format", ] [tool.tox.env_run_base] package = "wheel" wheel_build_env = ".pkg" dependency_groups = ["tests"] commands = [ [ "pytest", "--cov", "--basetemp={envtmpdir}", { replace = "posargs", extend = true }, ], ] [tool.tox.env.pyright] dependency_groups = ["typing"] commands = [["pyright", "{posargs:src}"]] [tool.tox.env.ruff-check] skip_install = true dependency_groups = ["ruff"] commands = [["ruff", "check", "{posargs:.}"]] [tool.tox.env.ruff-format] skip_install = true dependency_groups = ["ruff"] commands = [["ruff", "format", "--check", "--diff", "{posargs:.}"]] ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8863282 mopidy_alsamixer-3.0.0/setup.cfg0000644000175100017510000000004615173001221016337 0ustar00runnerrunner[egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8822906 mopidy_alsamixer-3.0.0/src/0000755000175100017510000000000015173001221015305 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8841462 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer/0000755000175100017510000000000015173001221020653 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer/__init__.py0000644000175100017510000000204615173001212022766 0ustar00runnerrunnerimport pathlib from importlib.metadata import version from mopidy import config, ext from mopidy.config import ConfigSchema __version__ = version("mopidy-alsamixer") class Extension(ext.Extension): dist_name = "mopidy-alsamixer" ext_name = "alsamixer" version = __version__ def get_default_config(self) -> str: return config.read(pathlib.Path(__file__).parent / "ext.conf") def get_config_schema(self) -> ConfigSchema: schema = super().get_config_schema() schema["device"] = config.String() schema["card"] = config.Integer(optional=True, minimum=0) schema["control"] = config.String() schema["min_volume"] = config.Integer(minimum=0, maximum=100) schema["max_volume"] = config.Integer(minimum=0, maximum=100) schema["volume_scale"] = config.String(choices=("linear", "cubic", "log")) return schema def setup(self, registry: ext.Registry) -> None: from mopidy_alsamixer.mixer import AlsaMixer # noqa: PLC0415 registry.add("mixer", AlsaMixer) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer/ext.conf0000644000175100017510000000017115173001212022321 0ustar00runnerrunner[alsamixer] enabled = true device = default card = control = Master min_volume = 0 max_volume = 100 volume_scale = cubic ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer/mixer.py0000644000175100017510000002013415173001212022351 0ustar00runnerrunnerimport logging import math import select import threading from collections.abc import Callable from typing import Literal, cast, override import alsaaudio import gi import pykka from mopidy.types import Percentage gi.require_version("GstAudio", "1.0") from gi.repository import GstAudio # noqa: E402, I001 # pyright: ignore[reportAttributeAccessIssue] from mopidy import exceptions, mixer # noqa: E402 logger = logging.getLogger(__name__) class AlsaMixer(pykka.ThreadingActor, mixer.Mixer): name = "alsamixer" @override def __init__(self, config: dict) -> None: super().__init__(config) self.config = config self.control = cast("str", self.config["alsamixer"]["control"]) self.device = cast("str", self.config["alsamixer"]["device"]) card = cast("int | None", self.config["alsamixer"]["card"]) self.min_volume = cast("Percentage", self.config["alsamixer"]["min_volume"]) self.max_volume = cast("Percentage", self.config["alsamixer"]["max_volume"]) self.volume_scale: Literal["linear", "cubic", "log"] = self.config["alsamixer"][ "volume_scale" ] self.device_title = f"device {self.device!r}" if card is not None: self.device = f"hw:{card:d}" self.device_title = f"card {card:d}" known_cards = alsaaudio.cards() try: known_controls = alsaaudio.mixers(device=self.device) except alsaaudio.ALSAAudioError as exc: msg = ( f"Could not find ALSA {self.device_title}. " "Known soundcards include: " f"{', '.join(known_cards)}" ) raise exceptions.MixerError(msg) from exc if self.control not in known_controls: msg = ( "Could not find ALSA mixer control " f"{self.control} on {self.device_title}. " f"Known mixers on {self.device_title} include: " f"{', '.join(known_controls)}" ) raise exceptions.MixerError(msg) self._last_volume = None self._last_mute = None logger.info( f"Mixing using ALSA, {self.device_title}, mixer control {self.control!r}." ) @override def on_start(self) -> None: self._observer = AlsaMixerObserver( device=self.device, control=self.control, callback=self.actor_ref.proxy().trigger_events_for_changed_values, ) self._observer.start() @property def _mixer(self) -> alsaaudio.Mixer: # The mixer must be recreated every time it is used to be able to # observe volume/mute changes done by other applications. return alsaaudio.Mixer( device=self.device, control=self.control, ) @override def get_volume(self) -> Percentage | None: channels = self._mixer.getvolume() if not channels: return None if channels.count(channels[0]) == len(channels): return self.mixer_volume_to_volume(channels[0]) # Not all channels have the same volume return None @override def set_volume(self, volume: Percentage) -> bool: self._mixer.setvolume(self.volume_to_mixer_volume(volume)) return True def mixer_volume_to_volume(self, mixer_volume: Percentage) -> Percentage: match self.volume_scale: case "cubic": return Percentage( int( GstAudio.StreamVolume.convert_volume( GstAudio.StreamVolumeFormat.CUBIC, GstAudio.StreamVolumeFormat.LINEAR, mixer_volume / 100.0, ) * 100.0 ) ) case "log": # Uses our own formula rather than GstAudio.StreamVolume. # convert_volume(GstAudio.StreamVolumeFormat.LINEAR, # GstAudio.StreamVolumeFormat.DB, mixer_volume / 100.0) # as the result is a DB value, which we can't work with as # self._mixer provides a percentage. return Percentage(int(math.pow(10, mixer_volume / 50.0))) case "linear": return Percentage( int( (mixer_volume - self.min_volume) * 100.0 / (self.max_volume - self.min_volume) ) ) def volume_to_mixer_volume(self, volume: Percentage) -> Percentage: mixer_volume = int( self.min_volume + volume * (self.max_volume - self.min_volume) / 100.0 ) match self.volume_scale: case "cubic": return Percentage( int( GstAudio.StreamVolume.convert_volume( GstAudio.StreamVolumeFormat.LINEAR, GstAudio.StreamVolumeFormat.CUBIC, mixer_volume / 100.0, ) * 100.0 ) ) case "log": # Uses our own formula rather than GstAudio.StreamVolume. # convert_volume(GstAudio.StreamVolumeFormat.LINEAR, # GstAudio.StreamVolumeFormat.DB, mixer_volume / 100.0) # as the result is a DB value, which we can't work with as # self._mixer wants a percentage. return Percentage(int(50 * math.log10(mixer_volume))) case "linear": return Percentage(mixer_volume) @override def get_mute(self) -> bool | None: try: channels_muted = self._mixer.getmute() except alsaaudio.ALSAAudioError as exc: logger.debug(f"Getting mute state failed: {exc}") return None if all(channels_muted): return True if not any(channels_muted): return False # Not all channels have the same mute state return None @override def set_mute(self, mute: bool) -> bool: try: self._mixer.setmute(int(mute)) except alsaaudio.ALSAAudioError as exc: logger.debug(f"Setting mute state failed: {exc}") return False else: return True def trigger_events_for_changed_values(self) -> None: old_volume, self._last_volume = self._last_volume, self.get_volume() old_mute, self._last_mute = self._last_mute, self.get_mute() if self._last_volume is not None and self._last_volume != old_volume: self.trigger_volume_changed(self._last_volume) if self._last_mute is not None and self._last_mute != old_mute: self.trigger_mute_changed(self._last_mute) class AlsaMixerObserver(threading.Thread): daemon = True name = "AlsaMixerObserver" def __init__( self, device: str, control: str, callback: Callable[[], None] | None = None, ) -> None: super().__init__() self.running = True # Keep the mixer instance alive for the descriptors to work self.mixer = alsaaudio.Mixer(device=device, control=control) descriptors = self.mixer.polldescriptors() if len(descriptors) != 1: msg = "Expected exactly one poll descriptor" raise AssertionError(msg) self.fd = descriptors[0][0] self.event_mask = descriptors[0][1] self.callback = callback def stop(self) -> None: self.running = False def run(self) -> None: poller = select.epoll() poller.register(self.fd, self.event_mask | select.EPOLLET) while self.running: try: events = poller.poll(timeout=1) if events and self.callback is not None: self.callback() except OSError as exc: # poller.poll() will raise an IOError because of the # interrupted system call when suspending the machine. logger.debug(f"Ignored IO error: {exc}") ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8856497 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/0000755000175100017510000000000015173001221022345 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/PKG-INFO0000644000175100017510000001270715173001220023450 0ustar00runnerrunnerMetadata-Version: 2.4 Name: mopidy-alsamixer Version: 3.0.0 Summary: Mopidy extension for ALSA volume control Author-email: Stein Magnus Jodal License: Apache-2.0 Project-URL: Homepage, https://github.com/mopidy/mopidy-alsamixer Classifier: Environment :: No Input/Output (Daemon) Classifier: Intended Audience :: End Users/Desktop Classifier: License :: OSI Approved :: Apache Software License Classifier: Operating System :: OS Independent Classifier: Topic :: Multimedia :: Sound/Audio :: Players Requires-Python: >=3.13 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: mopidy>=4.0.0 Requires-Dist: pyalsaaudio>=0.10 Requires-Dist: pygobject>=3.50 Requires-Dist: pykka>=4.1 Dynamic: license-file # mopidy-alsamixer [![Latest PyPI version](https://img.shields.io/pypi/v/mopidy-alsamixer)](https://pypi.org/p/mopidy-alsamixer) [![CI build status](https://img.shields.io/github/actions/workflow/status/mopidy/mopidy-alsamixer/ci.yml)](https://github.com/mopidy/mopidy-alsamixer/actions/workflows/ci.yml) [![Test coverage](https://img.shields.io/codecov/c/gh/mopidy/mopidy-alsamixer)](https://codecov.io/gh/mopidy/mopidy-alsamixer) [Mopidy](https://mopidy.com) extension for ALSA volume control. ## Maintainer wanted mopidy-alsamixer is currently kept on life support by the Mopidy core developers. It is in need of a more dedicated maintainer. If you want to be the maintainer of mopidy-alsamixer, please: 1. Make 2-3 good pull requests improving any part of the project. 2. Read and get familiar with all of the project's open issues. 3. Send a pull request removing this section and adding yourself as the "Current maintainer" in the "Credits" section below. In the pull request description, please refer to the previous pull requests and state that you've familiarized yourself with the open issues. As a maintainer, you'll be given push access to the repo and the authority to make releases to PyPI when you see fit. ## Installation Install by running: ```sh python3 -m pip install mopidy-alsamixer ``` See https://mopidy.com/ext/alsamixer/ for alternative installation methods. ## Configuration To use mopidy-alsamixer the `audio/mixer` configuration value must be set to `alsamixer` in the Mopidy configuration file: ```ini [audio] mixer = alsamixer ``` The default mopidy-alsaMixer configuration will probably work for most use cases. If not, the following configuration values are available: - `alsamixer/device`: Which soundcard should be used, specified by its string alias. Defaults to `default`. - `alsamixer/card`: Which soundcard should be used, specified by its index. Numbered from 0 and up. If specified, `alsamixer/device` is ignored. - `alsamixer/control`: Which ALSA control should be used. Defaults to `Master`. Other typical values includes `PCM`. Run the command `amixer scontrols` to list available controls on your system. - `alsamixer/min_volume` and `alsamixer/max_volume`: Map the Mopidy volume control range to a different range. Values are in the range 0-100. Use this if the default range (0-100) is too wide, resulting in a small usable range for Mopidy's volume control. For example try `min_volume = 30` and `max_volume = 70` to map Mopidy's volume control to the middle of ALSA's volume range. - `alsamixer/volume_scale`: Either `linear`, `cubic`, or `log`. The cubic scale is the default as it is closer to how the human ear percieves volume, and matches the volume scale used in the `alsamixer` program. Example `alsamixer` section from the Mopidy configuration file: ```ini [alsamixer] card = 1 control = PCM min_volume = 0 max_volume = 100 volume_scale = cubic ``` ## Project resources - [Source code](https://github.com/mopidy/mopidy-alsamixer) - [Issues](https://github.com/mopidy/mopidy-alsamixer/issues) - [Releases](https://github.com/mopidy/mopidy-alsamixer/releases) ## Development ### Set up development environment Clone the repo using, e.g. using [gh](https://cli.github.com/): ```sh gh repo clone mopidy/mopidy-alsamixer ``` Enter the directory, and install dependencies using [uv](https://docs.astral.sh/uv/): ```sh cd mopidy-alsamixer/ uv sync ``` ### Running tests To run all tests and linters in isolated environments, use [tox](https://tox.wiki/): ```sh tox ``` To only run tests, use [pytest](https://pytest.org/): ```sh pytest ``` To format the code, use [ruff](https://docs.astral.sh/ruff/): ```sh ruff format . ``` To check for lints with ruff, run: ```sh ruff check . ``` To check for type errors, use [pyright](https://microsoft.github.io/pyright/): ```sh pyright . ``` ### Making a release To make a release to PyPI, go to the project's [GitHub releases page](https://github.com/mopidy/mopidy-alsamixer/releases) and click the "Draft a new release" button. In the "choose a tag" dropdown, select the tag you want to release or create a new tag, e.g. `v0.1.0`. Add a title, e.g. `v0.1.0`, and a description of the changes. Decide if the release is a pre-release (alpha, beta, or release candidate) or should be marked as the latest release, and click "Publish release". Once the release is created, the `release.yml` GitHub Action will automatically build and publish the release to [PyPI](https://pypi.org/project/mopidy-alsamixer/). ## Credits - Original author: [Stein Magnus Jodal](https://github.com/mopidy) - Current maintainer: None. Maintainer wanted, see section above. - [Contributors](https://github.com/mopidy/mopidy-alsamixer/graphs/contributors) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/SOURCES.txt0000644000175100017510000000103315173001220024225 0ustar00runnerrunner.copier-answers.yml .gitignore LICENSE README.md pyproject.toml .github/workflows/ci.yml .github/workflows/release.yml src/mopidy_alsamixer/__init__.py src/mopidy_alsamixer/ext.conf src/mopidy_alsamixer/mixer.py src/mopidy_alsamixer.egg-info/PKG-INFO src/mopidy_alsamixer.egg-info/SOURCES.txt src/mopidy_alsamixer.egg-info/dependency_links.txt src/mopidy_alsamixer.egg-info/entry_points.txt src/mopidy_alsamixer.egg-info/requires.txt src/mopidy_alsamixer.egg-info/top_level.txt tests/__init__.py tests/test_extension.py tests/test_mixer.py././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/dependency_links.txt0000644000175100017510000000000115173001220026412 0ustar00runnerrunner ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/entry_points.txt0000644000175100017510000000006415173001220025642 0ustar00runnerrunner[mopidy.ext] alsamixer = mopidy_alsamixer:Extension ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/requires.txt0000644000175100017510000000007315173001220024744 0ustar00runnerrunnermopidy>=4.0.0 pyalsaaudio>=0.10 pygobject>=3.50 pykka>=4.1 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074832.0 mopidy_alsamixer-3.0.0/src/mopidy_alsamixer.egg-info/top_level.txt0000644000175100017510000000002115173001220025067 0ustar00runnerrunnermopidy_alsamixer ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1777074832.8855164 mopidy_alsamixer-3.0.0/tests/0000755000175100017510000000000015173001221015660 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/tests/__init__.py0000644000175100017510000000000015173001212017757 0ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/tests/test_extension.py0000644000175100017510000000120115173001212021277 0ustar00runnerrunnerfrom unittest import mock from mopidy_alsamixer import Extension, mixer def test_get_default_config(): ext = Extension() config = ext.get_default_config() assert "[alsamixer]" in config assert "enabled = true" in config assert "device = default" in config assert "card =" in config assert "control = Master" in config schema = ext.get_config_schema() assert "device" in schema assert "card" in schema assert "control" in schema def test_setup(): ext = Extension() registry = mock.Mock() ext.setup(registry) registry.add.assert_called_once_with("mixer", mixer.AlsaMixer) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1777074826.0 mopidy_alsamixer-3.0.0/tests/test_mixer.py0000644000175100017510000002646415173001212020431 0ustar00runnerrunnerimport copy import unittest from typing import Any, ClassVar from unittest import mock import alsaaudio import pytest from mopidy import exceptions from mopidy_alsamixer.mixer import AlsaMixer @mock.patch( "mopidy_alsamixer.mixer.alsaaudio", spec=alsaaudio, ALSAAudioError=alsaaudio.ALSAAudioError, ) class MixerTest(unittest.TestCase): default_config: ClassVar[dict[str, dict[str, Any]]] = { "alsamixer": { "device": "default", "card": None, "control": "Master", "min_volume": 0, "max_volume": 100, "volume_scale": "cubic", } } def get_mixer(self, alsa_mock=None, *, config=None, apply_default_config=True): if config is None: config = {"alsamixer": {"device": "default", "control": "Master"}} if alsa_mock is not None: alsa_mock.cards.return_value = ["PCH"] alsa_mock.mixers.return_value = ["Master"] if apply_default_config: actual_config = copy.deepcopy(MixerTest.default_config) actual_config["alsamixer"].update(config["alsamixer"]) else: actual_config = config return AlsaMixer(config=actual_config) def test_has_config(self, alsa_mock): config = {"alsamixer": {"device": "default", "control": "Master"}} actual_config = copy.deepcopy(MixerTest.default_config) actual_config["alsamixer"].update(config["alsamixer"]) mixer = self.get_mixer( alsa_mock, config=actual_config, apply_default_config=False ) assert mixer.config is actual_config def test_use_default_device_from_config(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Master"] config = {"alsamixer": {"control": "Master"}} mixer = self.get_mixer(config=config) mixer.get_volume() alsa_mock.Mixer.assert_called_once_with( device="default", control="Master", ) def test_use_device_from_config(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Master"] config = { "alsamixer": { "device": "PCH", "control": "Master", } } mixer = self.get_mixer(config=config) mixer.get_volume() alsa_mock.Mixer.assert_called_once_with(device="PCH", control="Master") def test_fails_if_device_is_unknown(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.side_effect = alsa_mock.ALSAAudioError( "No such file or directory [PCH2]" ) config = {"alsamixer": {"device": "PCH2", "control": "Master"}} with pytest.raises(exceptions.MixerError) as exc_info: self.get_mixer(config=config) assert "Could not find ALSA device" in str(exc_info.value) assert "include: PCH, SB" in str(exc_info.value) alsa_mock.mixers.assert_called_once_with(device="PCH2") def test_use_card_from_config(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Master"] config = {"alsamixer": {"card": 1, "control": "Master"}} mixer = self.get_mixer(config=config) mixer.get_volume() alsa_mock.Mixer.assert_called_once_with(device="hw:1", control="Master") def test_use_card_with_index_not_in_cards_list(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Master"] config = {"alsamixer": {"card": 2, "control": "Master"}} mixer = self.get_mixer(config=config) mixer.get_volume() alsa_mock.mixers.assert_called_once_with(device="hw:2") alsa_mock.Mixer.assert_called_once_with(device="hw:2", control="Master") def test_fails_if_card_is_unknown(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.side_effect = alsa_mock.ALSAAudioError( "No such file or directory [hw:2]" ) config = {"alsamixer": {"card": 2, "control": "Master"}} with pytest.raises(exceptions.MixerError) as exc_info: self.get_mixer(config=config) assert "Could not find ALSA card" in str(exc_info.value) assert "include: PCH, SB" in str(exc_info.value) alsa_mock.mixers.assert_called_once_with(device="hw:2") def test_use_control_from_config(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Speaker"] config = {"alsamixer": {"device": "PCH", "control": "Speaker"}} mixer = self.get_mixer(config=config) mixer.get_volume() alsa_mock.Mixer.assert_called_once_with(device="PCH", control="Speaker") def test_fails_if_control_is_unknown(self, alsa_mock): alsa_mock.cards.return_value = ["PCH", "SB"] alsa_mock.mixers.return_value = ["Headphone", "Master"] config = {"alsamixer": {"device": "PCH", "control": "Speaker"}} with pytest.raises(exceptions.MixerError) as exc_info: self.get_mixer(config=config) assert "Could not find ALSA mixer control" in str(exc_info.value) assert "include: Headphone, Master" in str(exc_info.value) def test_get_volume(self, alsa_mock): config = {"alsamixer": {"volume_scale": "linear"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [86] assert mixer.get_volume() == 86 mixer_mock.getvolume.assert_called_once_with() def test_get_volume_cubic(self, alsa_mock): config = {"alsamixer": {"volume_scale": "cubic"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [86] assert mixer.get_volume() == 63 mixer_mock.getvolume.assert_called_once_with() def test_get_volume_log(self, alsa_mock): config = {"alsamixer": {"volume_scale": "log"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [86] assert mixer.get_volume() == 52 mixer_mock.getvolume.assert_called_once_with() def test_get_volume_when_channels_are_different(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [86, 70] assert mixer.get_volume() is None mixer_mock.getvolume.assert_called_once_with() def test_get_volume_when_no_channels(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [] assert mixer.get_volume() is None mixer_mock.getvolume.assert_called_once_with() def test_set_volume(self, alsa_mock): config = {"alsamixer": {"volume_scale": "linear"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value assert mixer.set_volume(74) mixer_mock.setvolume.assert_called_once_with(74) def test_set_volume_cubic(self, alsa_mock): config = {"alsamixer": {"volume_scale": "cubic"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value assert mixer.set_volume(74) mixer_mock.setvolume.assert_called_once_with(90) def test_set_volume_log(self, alsa_mock): config = {"alsamixer": {"volume_scale": "log"}} mixer = self.get_mixer(alsa_mock, config=config) mixer_mock = alsa_mock.Mixer.return_value assert mixer.set_volume(74) mixer_mock.setvolume.assert_called_once_with(93) def test_get_mute_when_muted(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getmute.return_value = [1] assert mixer.get_mute() is True mixer_mock.getmute.assert_called_once_with() def test_get_mute_when_unmuted(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getmute.return_value = [0] assert mixer.get_mute() is False mixer_mock.getmute.assert_called_once_with() def test_get_mute_when_unsupported(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getmute.side_effect = alsa_mock.ALSAAudioError assert mixer.get_mute() is None mixer_mock.getmute.assert_called_once_with() def test_set_mute_to_muted(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value assert mixer.set_mute(True) mixer_mock.setmute.assert_called_once_with(1) def test_set_mute_when_unsupported(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.setmute.side_effect = alsa_mock.ALSAAudioError assert not mixer.set_mute(True) mixer_mock.setmute.assert_called_once_with(1) def test_get_mute_when_channels_are_different(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getmute.return_value = [0, 1] assert mixer.get_mute() is None mixer_mock.getmute.assert_called_once_with() def test_set_mute_to_unmuted(self, alsa_mock): mixer = self.get_mixer(alsa_mock) mixer_mock = alsa_mock.Mixer.return_value assert mixer.set_mute(False) mixer_mock.setmute.assert_called_once_with(0) def test_trigger_events_for_changed_values_when_no_change(self, alsa_mock): mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [70] mixer_mock.getmute.return_value = [0] mixer = self.get_mixer(alsa_mock) mixer.trigger_volume_changed = mock.Mock() mixer.trigger_mute_changed = mock.Mock() mixer.trigger_events_for_changed_values() alsa_mock.reset_mock() mixer.trigger_volume_changed.reset_mock() mixer.trigger_mute_changed.reset_mock() mixer.trigger_events_for_changed_values() mixer_mock.getvolume.assert_called_once_with() mixer_mock.getmute.assert_called_once_with() assert mixer.trigger_volume_changed.call_count == 0 assert mixer.trigger_mute_changed.call_count == 0 def test_trigger_events_for_changed_values_when_changes(self, alsa_mock): mixer_mock = alsa_mock.Mixer.return_value mixer_mock.getvolume.return_value = [75] mixer_mock.getmute.return_value = [1] config = {"alsamixer": {"volume_scale": "linear"}} mixer = self.get_mixer(alsa_mock, config=config) mixer.trigger_volume_changed = mock.Mock() mixer.trigger_mute_changed = mock.Mock() mixer.trigger_events_for_changed_values() mixer_mock.getvolume.assert_called_once_with() mixer_mock.getmute.assert_called_once_with() mixer.trigger_volume_changed.assert_called_once_with(75) mixer.trigger_mute_changed.assert_called_once_with(True) # noqa: FBT003