~naglis/aio_mpv_ipc

b7f054846394728dd22f87e3a4c5d63ff6a16c9b — Naglis Jonaitis 1 year, 11 months ago
Initialize repo
A  => .gitignore +484 -0
@@ 1,484 @@
### Python ###
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
.hypothesis/
.pytest_cache/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
.python-version

# celery beat schedule file
celerybeat-schedule

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

### Python Patch ###
.venv/

### Python.VirtualEnv Stack ###
# Virtualenv
# http://iamzed.com/2009/05/07/a-primer-on-virtualenv/
[Bb]in
[Ii]nclude
[Ll]ib
[Ll]ib64
[Ll]ocal
[Ss]cripts
pyvenv.cfg
pip-selfcheck.json

### Vim ###
# Swap
[._]*.s[a-v][a-z]
[._]*.sw[a-p]
[._]s[a-rt-v][a-z]
[._]ss[a-gi-z]
[._]sw[a-p]

# Session
Session.vim

# Temporary
.netrwhist
*~
# Auto-generated tag files
tags
# Persistent undo
[._]*.un~

### VisualStudio ###
## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.
##
## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore

# User-specific files
*.rsuser
*.suo
*.user
*.userosscache
*.sln.docstates

# User-specific files (MonoDevelop/Xamarin Studio)
*.userprefs

# Build results
[Dd]ebug/
[Dd]ebugPublic/
[Rr]elease/
[Rr]eleases/
x64/
x86/
bld/
[Bb]in/
[Oo]bj/
[Ll]og/

# Visual Studio 2015/2017 cache/options directory
.vs/
# Uncomment if you have tasks that create the project's static files in wwwroot
#wwwroot/

# Visual Studio 2017 auto generated files
Generated\ Files/

# MSTest test Results
[Tt]est[Rr]esult*/
[Bb]uild[Ll]og.*

# NUNIT
*.VisualState.xml
TestResult.xml

# Build Results of an ATL Project
[Dd]ebugPS/
[Rr]eleasePS/
dlldata.c

# Benchmark Results
BenchmarkDotNet.Artifacts/

# .NET Core
project.lock.json
project.fragment.lock.json
artifacts/

# StyleCop
StyleCopReport.xml

# Files built by Visual Studio
*_i.c
*_p.c
*_h.h
*.ilk
*.meta
*.obj
*.iobj
*.pch
*.pdb
*.ipdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.tmp_proj
*_wpftmp.csproj
*.vspscc
*.vssscc
.builds
*.pidb
*.svclog
*.scc

# Chutzpah Test files
_Chutzpah*

# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opendb
*.opensdf
*.sdf
*.cachefile
*.VC.db
*.VC.VC.opendb

# Visual Studio profiler
*.psess
*.vsp
*.vspx
*.sap

# Visual Studio Trace Files
*.e2e

# TFS 2012 Local Workspace
$tf/

# Guidance Automation Toolkit
*.gpState

# ReSharper is a .NET coding add-in
_ReSharper*/
*.[Rr]e[Ss]harper
*.DotSettings.user

# JustCode is a .NET coding add-in
.JustCode

# TeamCity is a build add-in
_TeamCity*

# DotCover is a Code Coverage Tool
*.dotCover

# AxoCover is a Code Coverage Tool
.axoCover/*
!.axoCover/settings.json

# Visual Studio code coverage results
*.coverage
*.coveragexml

# NCrunch
_NCrunch_*
.*crunch*.local.xml
nCrunchTemp_*

# MightyMoose
*.mm.*
AutoTest.Net/

# Web workbench (sass)
.sass-cache/

# Installshield output folder
[Ee]xpress/

# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html

# Click-Once directory
publish/

# Publish Web Output
*.[Pp]ublish.xml
*.azurePubxml
# Note: Comment the next line if you want to checkin your web deploy settings,
# but database connection strings (with potential passwords) will be unencrypted
*.pubxml
*.publishproj

# Microsoft Azure Web App publish settings. Comment the next line if you want to
# checkin your Azure Web App publish settings, but sensitive information contained
# in these scripts will be unencrypted
PublishScripts/

# NuGet Packages
*.nupkg
# The packages folder can be ignored because of Package Restore
**/[Pp]ackages/*
# except build/, which is used as an MSBuild target.
!**/[Pp]ackages/build/
# Uncomment if necessary however generally it will be regenerated when needed
#!**/[Pp]ackages/repositories.config
# NuGet v3's project.json files produces more ignorable files
*.nuget.props
*.nuget.targets

# Microsoft Azure Build Output
csx/
*.build.csdef

# Microsoft Azure Emulator
ecf/
rcf/

# Windows Store app package directories and files
AppPackages/
BundleArtifacts/
Package.StoreAssociation.xml
_pkginfo.txt
*.appx

# Visual Studio cache files
# files ending in .cache can be ignored
*.[Cc]ache
# but keep track of directories ending in .cache
!*.[Cc]ache/

# Others
ClientBin/
~$*
*.dbmdl
*.dbproj.schemaview
*.jfm
*.pfx
*.publishsettings
orleans.codegen.cs

# Including strong name files can present a security risk
# (https://github.com/github/gitignore/pull/2483#issue-259490424)
#*.snk

# Since there are multiple workflows, uncomment next line to ignore bower_components
# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
#bower_components/

# RIA/Silverlight projects
Generated_Code/

# Backup & report files from converting an old project file
# to a newer Visual Studio version. Backup files are not needed,
# because we have git ;-)
_UpgradeReport_Files/
Backup*/
UpgradeLog*.XML
UpgradeLog*.htm
ServiceFabricBackup/
*.rptproj.bak

# SQL Server files
*.mdf
*.ldf
*.ndf

# Business Intelligence projects
*.rdl.data
*.bim.layout
*.bim_*.settings
*.rptproj.rsuser

# Microsoft Fakes
FakesAssemblies/

# GhostDoc plugin setting file
*.GhostDoc.xml

# Node.js Tools for Visual Studio
.ntvs_analysis.dat
node_modules/

# Visual Studio 6 build log
*.plg

# Visual Studio 6 workspace options file
*.opt

# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
*.vbw

# Visual Studio LightSwitch build output
**/*.HTMLClient/GeneratedArtifacts
**/*.DesktopClient/GeneratedArtifacts
**/*.DesktopClient/ModelManifest.xml
**/*.Server/GeneratedArtifacts
**/*.Server/ModelManifest.xml
_Pvt_Extensions

# Paket dependency manager
.paket/paket.exe
paket-files/

# FAKE - F# Make
.fake/

# JetBrains Rider
.idea/
*.sln.iml

# CodeRush personal settings
.cr/personal

# Python Tools for Visual Studio (PTVS)
*.pyc

# Cake - Uncomment if you are using it
# tools/**
# !tools/packages.config

# Tabs Studio
*.tss

# Telerik's JustMock configuration file
*.jmconfig

# BizTalk build output
*.btp.cs
*.btm.cs
*.odx.cs
*.xsd.cs

# OpenCover UI analysis results
OpenCover/

# Azure Stream Analytics local run output
ASALocalRun/

# MSBuild Binary and Structured Log
*.binlog

# NVidia Nsight GPU debugger configuration file
*.nvuser

# MFractors (Xamarin productivity tool) working folder
.mfractor/

# Local History for Visual Studio
.localhistory/

.vscode

A  => .pre-commit-config.yaml +6 -0
@@ 1,6 @@
repos:
-   repo: https://github.com/ambv/black
    rev: stable
    hooks:
    - id: black
      language_version: python3.7

A  => LICENSE +68 -0
@@ 1,68 @@
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:

    You must give any other recipients of the Work or Derivative Works a copy of this License; and
    You must cause any modified files to carry prominent notices stating that You changed the files; and
    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
    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

A  => aio_mpv_ipc/__init__.py +16 -0
@@ 1,16 @@
"""
Asynchronous MPV IPC client.
"""

from ._client import IPC_ENCODING, MpvClient, start_mpv
from .exceptions import AioMpvIPCException, IPCException


__version__ = "0.0.1a2"
__all__ = (
    "MpvClient",
    "start_mpv",
    "AioMpvIPCException",
    "IPCException",
    "IPC_ENCODING",
)

A  => aio_mpv_ipc/_client.py +186 -0
@@ 1,186 @@
import asyncio
import collections
import contextlib
import json
import logging
import pathlib
import types
import typing
import uuid

from aio_mpv_ipc.exceptions import AioMpvIPCException, IPCException


logger = logging.getLogger("aio_mpv_ipc")

IPC_ENCODING = "utf-8"


def _json_serialize_default(o):
    if isinstance(o, (uuid.UUID, pathlib.Path)):
        return str(o)
    return o


def _default_json_loads(s: bytes):
    return json.loads(s.decode(encoding=IPC_ENCODING))


def _default_json_dumps(obj: typing.Any) -> str:
    return json.dumps(obj, default=_json_serialize_default)


@contextlib.asynccontextmanager
async def start_mpv(
    socket_path: typing.Union[pathlib.Path, str],
    *mpv_args: str,
    mpv_path: typing.Union[pathlib.Path, str] = "mpv",
    terminate: bool = False,
):
    if isinstance(socket_path, pathlib.Path):
        socket_path = str(socket_path.resolve(strict=False))
    mpv = await asyncio.create_subprocess_exec(
        mpv_path, "--input-ipc-server", socket_path, *mpv_args
    )
    logger.debug("Started mpv process with PID: %d", mpv.pid)
    try:
        yield mpv
    finally:
        if terminate:
            mpv.terminate()
        await mpv.wait()


class MpvClient:
    def __init__(
        self,
        socket_path: pathlib.Path,
        *,
        max_connect_attempts: int = 5,
        connect_sleep_timeout: float = 0.5,
        json_loads=_default_json_loads,
        json_dumps=_default_json_dumps,
        loop: typing.Optional[asyncio.AbstractEventLoop] = None,
    ) -> None:
        self._socket_path = socket_path
        self._reader, self._writer = None, None
        self._max_connect_attempts = max_connect_attempts
        self._connect_sleep_timeout = connect_sleep_timeout
        self._json_loads, self._json_dumps = json_loads, json_dumps
        self._loop = loop or asyncio.get_running_loop()
        self._poll_task = None

        self._futures: typing.Dict[str, asyncio.Future] = {}
        self._event_subscribers: typing.Dict[
            str, typing.Set[asyncio.Queue]
        ] = collections.defaultdict(set)

    def _generate_request_id(self) -> str:
        return uuid.uuid4().hex

    def subscribe(self, event_name: str, queue: asyncio.Queue):
        self._event_subscribers[event_name].add(queue)

    def unsubscribe(self, event_name: str, queue: asyncio.Queue):
        self._event_subscribers[event_name].remove(queue)

    async def __aenter__(self):
        attempt = 0
        while True:
            attempt += 1
            try:
                self._reader, self._writer = await asyncio.open_unix_connection(
                    self._socket_path, loop=self._loop
                )
                break
            except ConnectionRefusedError:
                if attempt >= self._max_connect_attempts:
                    raise
                logger.debug(
                    "%d connection attempt failed, will retry after %f seconds",
                    attempt,
                    self._connect_sleep_timeout,
                )
                await asyncio.sleep(self._connect_sleep_timeout, loop=self._loop)

        self._poll_task = self._loop.create_task(self._poll())

        return self

    async def __aexit__(
        self,
        exc_type: typing.Optional[typing.Type[BaseException]] = None,
        exc_value: typing.Optional[BaseException] = None,
        traceback: typing.Optional[types.TracebackType] = None,
    ):
        if self._writer is not None:
            self._writer.close()

        self._poll_task.cancel()
        try:
            await self._poll_task
        except asyncio.CancelledError:
            pass

    async def _poll(self):
        while True:
            data = await self._reader.readline()
            if data:
                response = self._json_loads(data.rstrip(b"\n"))

                logger.debug("Response from mpv: %r", response)

                event_name = response.get("event")
                if event_name is not None:
                    # This is an event notification, notify subscribers (if any).
                    if event_name in self._event_subscribers:
                        for queue in self._event_subscribers[event_name]:
                            queue.put_nowait(response)
                else:
                    status = response.get("error")
                    is_error = status and status != "success"
                    if is_error:
                        logger.error("mpv returned an error: %r", response)

                    request_id = response.get("request_id")
                    if request_id:
                        fut = self._futures.pop(request_id)
                        if is_error:
                            fut.set_exception(IPCException(status, response))
                        else:
                            fut.set_result(response.get("data"))

            if self._reader.at_eof():
                logger.debug("EOF received, stopping polling")
                break

    async def ipc(
        self,
        command_name: str,
        *params,
        nowait: bool = False,
        request_id: typing.Optional[str] = None,
    ) -> typing.Optional[typing.Any]:
        if self._writer is None:
            raise AioMpvIPCException("Socket writer was not initialized")

        payload = {"command": [command_name, *params]}

        fut = None
        if not nowait:
            request_id = (
                self._generate_request_id() if request_id is None else request_id
            )
            fut = self._loop.create_future()
            payload.update(request_id=request_id)
            self._futures.update({request_id: fut})

        logger.debug("mpv IPC payload (nowait=%r): %s", nowait, payload)

        data = self._json_dumps(payload)
        self._writer.write(data.encode(encoding=IPC_ENCODING))
        self._writer.write(b"\n")
        await self._writer.drain()

        if not nowait:
            return await fut

A  => aio_mpv_ipc/exceptions.py +10 -0
@@ 1,10 @@
class AioMpvIPCException(Exception):
    """Generic exception raised by aio_mpv_ipc."""


class IPCException(AioMpvIPCException):
    """Raised when an error is return by mpv on an IPC call."""

    def __init__(self, status: str, response) -> None:
        self.response = response
        super().__init__(status)

A  => pyproject.toml +38 -0
@@ 1,38 @@
[build-system]
requires = ["flit"]
build-backend = "flit.buildapi"

[tool.flit.metadata]
module = "aio_mpv_ipc"
author = "Naglis Jonaitis"
author-email = "hello@naglis.me"
home-page = "https://github.com/naglis/aio_mpv_ipc"
classifiers = [
    "Development Status :: 1 - Planning",
    "Framework :: AsyncIO",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: Apache Software License",
    "Programming Language :: Python :: 3.7",
    "Programming Language :: Python :: 3 :: Only",
]
requires-python="~=3.7"

[tool.flit.metadata.requires-extra]
test = [
    "pylint==2.3.1",
    "flake8==3.7.7",
    "pytest==4.5.0",
    "pytest-cov==2.7.1",
    "mypy==0.701",
    "flake8-comprehensions==2.1.0",
    "flake8-bugbear==19.3.0",
    "flake8-builtins==1.4.1",
    "flake8-tuple==0.3.1",
    "pycodestyle==2.5.0",
    "bandit==1.6.0",
    "pytest-asyncio==0.10.0",
]

dev = [
    "pre-commit==1.14.4",
]

A  => tests/test_client.py +108 -0
@@ 1,108 @@
import asyncio
import contextlib
import tempfile
import pathlib

import aio_mpv_ipc
import pytest


TEST_FILE_SILENCE = pathlib.Path(__file__).parent / "test_data" / "silence.ogg"

MPV_ARGS = [
    "--idle",  # Do not exit immediately.
    "--no-audio-display",
    "--no-input-terminal",  # Do not intercept keyboard input.
    "--no-input-cursor",
    "--no-terminal",  # No output to terminal.
    "--no-video",
    "--no-resume-playback",
    "--no-osc",
    "--ao",
    "null",
    "--vo",
    "null",
]


@contextlib.asynccontextmanager
async def temp_file(*args, **kwargs):
    """Awaitable version of :class:`tempfile.NamedTemporaryFile`."""
    with tempfile.NamedTemporaryFile(*args, **kwargs) as tmp:
        yield tmp


@pytest.fixture
def queue():
    yield asyncio.Queue()


@pytest.fixture
@pytest.mark.asyncio
async def mpv_client():
    async with contextlib.AsyncExitStack() as exit_stack:
        tmp_file = await exit_stack.enter_async_context(
            temp_file(prefix=f"veil.test.", suffix=".socket", delete=True)
        )
        socket_path = tmp_file.name

        mpv_ctx_mgr = aio_mpv_ipc.start_mpv(socket_path, *MPV_ARGS, terminate=True)
        await exit_stack.enter_async_context(mpv_ctx_mgr)

        client = await exit_stack.enter_async_context(
            aio_mpv_ipc.MpvClient(socket_path)
        )

        yield client


@pytest.mark.mpv
@pytest.mark.asyncio
async def test_loadfile(mpv_client):
    await mpv_client.ipc("loadfile", TEST_FILE_SILENCE, "append")
    count = await mpv_client.ipc("get_property", "playlist-count")
    assert count == 1


@pytest.mark.mpv
@pytest.mark.asyncio
async def test_unknown_command_ipc_exception_is_raised(mpv_client):
    with pytest.raises(aio_mpv_ipc.IPCException, match=r"^invalid parameter$"):
        await mpv_client.ipc("foobar")


@pytest.mark.mpv
@pytest.mark.asyncio
async def test_unknown_command_nowait_ipc_exception_is_not_raised(mpv_client):
    try:
        await mpv_client.ipc("foobar", nowait=True)
    except aio_mpv_ipc.IPCException:
        pytest.fail("IPCException was raised")


@pytest.mark.mpv
@pytest.mark.asyncio
async def test_ipc_exception_response_is_set(mpv_client):
    try:
        await mpv_client.ipc("foobar", request_id="check_exception_response")
    except aio_mpv_ipc.IPCException as exc:
        assert exc.response == {
            "request_id": "check_exception_response",
            "error": "invalid parameter",
        }
    else:
        pytest.fail("IPCException not raised")


@pytest.mark.mpv
@pytest.mark.asyncio
async def test_event_subscription(event_loop, mpv_client, queue):
    async def event_handler():
        event_data = await queue.get()
        queue.task_done()
        return event_data

    mpv_client.subscribe("file-loaded", queue)
    await mpv_client.ipc("loadfile", TEST_FILE_SILENCE)
    result = await asyncio.wait_for(event_handler(), timeout=1.0)
    assert result["event"] == "file-loaded"

A  => tests/test_data/silence.ogg +0 -0
A  => tox.ini +18 -0
@@ 1,18 @@
[tox]
isolated_build = True
envlist = py37, qa

[testenv]
deps = flit
passenv = FLIT_ROOT_INSTALL
commands_pre =
    flit install --deps all

[testenv:py37]
commands =
    pytest -vv --cov aio_mpv_ipc --cov-report term --cov-report xml

[testenv:qa]
commands =
    flake8 aio_mpv_ipc/ tests/
    bandit -r aio_mpv_ipc/