denonavr 0.11.6__tar.gz → 1.0.1__tar.gz

denonavr-1.0.1/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.1
+Name: denonavr
+Version: 1.0.1
+Summary: Automation Library for Denon AVR receivers
+Author-email: Oliver Goetz <scarface@mywoh.de>
+License: MIT
+Project-URL: Homepage, https://github.com/ol-iver/denonavr
+Project-URL: Source, https://github.com/ol-iver/denonavr
+Project-URL: Tracker, https://github.com/ol-iver/denonavr/issues
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Home Automation
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown; charset=UTF-8
+License-File: LICENSE
+Requires-Dist: asyncstdlib>=3.10.2
+Requires-Dist: attrs>=21.2.0
+Requires-Dist: defusedxml>=0.7.1
+Requires-Dist: ftfy>=6.1.1
+Requires-Dist: httpx>=0.23.1
+Requires-Dist: netifaces>=0.11.0
+Requires-Dist: async-timeout>=4.0.2; python_version < "3.11"
+Provides-Extra: testing
+Requires-Dist: pydocstyle; extra == "testing"
+Requires-Dist: pylint; extra == "testing"
+Requires-Dist: pytest; extra == "testing"
+Requires-Dist: pytest-cov; extra == "testing"
+Requires-Dist: pytest-timeout; extra == "testing"
+Requires-Dist: pytest-asyncio; extra == "testing"
+Requires-Dist: pytest-httpx; extra == "testing"
+Requires-Dist: flake8-docstrings; extra == "testing"
+Requires-Dist: flake8; extra == "testing"
+
+# denonavr
+[![Release](https://img.shields.io/github/v/release/ol-iver/denonavr?sort=semver)](https://github.com/ol-iver/denonavr/releases/latest)
+[![Build Status](https://github.com/ol-iver/denonavr/actions/workflows/python-tests.yml/badge.svg)](https://github.com/ol-iver/denonavr/actions/workflows/python-tests.yml)
+[![PyPi](https://img.shields.io/pypi/v/denonavr.svg)](https://pypi.org/project/denonavr)
+[![License](https://img.shields.io/github/license/ol-iver/denonavr.svg)](LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+Automation Library for Denon AVR receivers
+
+## Installation
+
+Use pip:
+
+```$ pip install denonavr```
+
+or 
+
+```$ pip install --use-wheel denonavr```
+  
+## Usage with `async`
+
+Writing `async` and `await` methods are outside the scope of the documentation.  You can test `async` usage from the Python REPL.  In a terminal run:
+
+`python3 -m asyncio`
+
+The `asyncio` library should automatically be imported in the REPL.  Import the `denonavr` library and set up your receiver.  If you know the  IP address, enter it below replacing `192.168.1.119`.
+
+```
+>>> import asyncio
+>>> import denonavr
+>>> d = denonavr.DenonAVR("192.168.1.119")
+>>> await d.async_setup()
+>>> await d.async_update()
+>>> print(d.volume)
+-36.5
+```
+
+### Monitoring with telnet
+In addition to retrieving the current device status via HTTP calls, `denonavr` library also has the ability to setup a task that will connect to the receiver via telnet on TCP port 23 and listen for real-time events to notify of status changes.
+This provides instant updates via a callback when the device status changes. Receivers support only one active telnet connection.
+
+```
+>>> import asyncio
+>>> import denonavr
+>>> d = denonavr.DenonAVR("192.168.1.119")
+>>> await d.async_setup()
+>>> await d.async_telnet_connect()
+>>> await d.async_update()
+>>> async def update_callback(zone, event, parameter):
+>>>>>> print("Zone: " + zone + " Event: " + event + " Parameter: " + parameter)
+>>> d.register_callback("ALL", update_callback)
+```
+
+### Power & Input
+```
+>>> await d.async_power_on()
+>>> await d.async_update()
+>>> d.power
+'ON'
+
+>>> await d.async_power_off()
+>>> await d.async_update()
+>>> d.power
+'OFF'
+
+>>> d.input_func
+'Tuner'
+>>> await d.async_set_input_func("Phono")
+>>> d.input_func
+'Phono'
+```
+### Sound
+```
+>>> await d.async_mute(True)
+>>> await d.async_mute(False)
+```
+
+### Other methods
+
+Other `async` methods available include:
+
+* `d.async_bass_down`
+* `d.async_bass_up`
+* `d.async_treble_down`
+* `d.async_treble_up`
+* `d.async_volume_down`
+* `d.async_volume_up`
+* `d.async_set_volume(50)`
+
+## Collection of HTTP calls
+For a collection of HTTP calls for Denon receivers please have a look at the `doc` folder.
+
+## License
+MIT
+
+## Author
+@ol-iver: https://github.com/ol-iver
+
+## Contributors
+@soldag: https://github.com/soldag  
+@shapiromatron: https://github.com/shapiromatron  
+@glance-: https://github.com/glance-  
+@p3dda: https://github.com/p3dda  
+@russel: https://github.com/russell  
+@starkillerOG: https://github.com/starkillerOG  
+@andrewsayre: https://github.com/andrewsayre  
+@JPHutchins: https://github.com/JPHutchins  
+@MarBra: https://github.com/MarBra  
+@dcmeglio: https://github.com/dcmeglio  
+@bdraco: https://github.com/bdraco  
+
+## Users
+Home Assistant: https://github.com/home-assistant/home-assistant/  
+denonavr-cli: https://pypi.org/project/denonavr-cli/

denonavr-1.0.1/README.md

@@ -0,0 +1,114 @@
+# denonavr
+[![Release](https://img.shields.io/github/v/release/ol-iver/denonavr?sort=semver)](https://github.com/ol-iver/denonavr/releases/latest)
+[![Build Status](https://github.com/ol-iver/denonavr/actions/workflows/python-tests.yml/badge.svg)](https://github.com/ol-iver/denonavr/actions/workflows/python-tests.yml)
+[![PyPi](https://img.shields.io/pypi/v/denonavr.svg)](https://pypi.org/project/denonavr)
+[![License](https://img.shields.io/github/license/ol-iver/denonavr.svg)](LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+Automation Library for Denon AVR receivers
+
+## Installation
+
+Use pip:
+
+```$ pip install denonavr```
+
+or 
+
+```$ pip install --use-wheel denonavr```
+  
+## Usage with `async`
+
+Writing `async` and `await` methods are outside the scope of the documentation.  You can test `async` usage from the Python REPL.  In a terminal run:
+
+`python3 -m asyncio`
+
+The `asyncio` library should automatically be imported in the REPL.  Import the `denonavr` library and set up your receiver.  If you know the  IP address, enter it below replacing `192.168.1.119`.
+
+```
+>>> import asyncio
+>>> import denonavr
+>>> d = denonavr.DenonAVR("192.168.1.119")
+>>> await d.async_setup()
+>>> await d.async_update()
+>>> print(d.volume)
+-36.5
+```
+
+### Monitoring with telnet
+In addition to retrieving the current device status via HTTP calls, `denonavr` library also has the ability to setup a task that will connect to the receiver via telnet on TCP port 23 and listen for real-time events to notify of status changes.
+This provides instant updates via a callback when the device status changes. Receivers support only one active telnet connection.
+
+```
+>>> import asyncio
+>>> import denonavr
+>>> d = denonavr.DenonAVR("192.168.1.119")
+>>> await d.async_setup()
+>>> await d.async_telnet_connect()
+>>> await d.async_update()
+>>> async def update_callback(zone, event, parameter):
+>>>>>> print("Zone: " + zone + " Event: " + event + " Parameter: " + parameter)
+>>> d.register_callback("ALL", update_callback)
+```
+
+### Power & Input
+```
+>>> await d.async_power_on()
+>>> await d.async_update()
+>>> d.power
+'ON'
+
+>>> await d.async_power_off()
+>>> await d.async_update()
+>>> d.power
+'OFF'
+
+>>> d.input_func
+'Tuner'
+>>> await d.async_set_input_func("Phono")
+>>> d.input_func
+'Phono'
+```
+### Sound
+```
+>>> await d.async_mute(True)
+>>> await d.async_mute(False)
+```
+
+### Other methods
+
+Other `async` methods available include:
+
+* `d.async_bass_down`
+* `d.async_bass_up`
+* `d.async_treble_down`
+* `d.async_treble_up`
+* `d.async_volume_down`
+* `d.async_volume_up`
+* `d.async_set_volume(50)`
+
+## Collection of HTTP calls
+For a collection of HTTP calls for Denon receivers please have a look at the `doc` folder.
+
+## License
+MIT
+
+## Author
+@ol-iver: https://github.com/ol-iver
+
+## Contributors
+@soldag: https://github.com/soldag  
+@shapiromatron: https://github.com/shapiromatron  
+@glance-: https://github.com/glance-  
+@p3dda: https://github.com/p3dda  
+@russel: https://github.com/russell  
+@starkillerOG: https://github.com/starkillerOG  
+@andrewsayre: https://github.com/andrewsayre  
+@JPHutchins: https://github.com/JPHutchins  
+@MarBra: https://github.com/MarBra  
+@dcmeglio: https://github.com/dcmeglio  
+@bdraco: https://github.com/bdraco  
+
+## Users
+Home Assistant: https://github.com/home-assistant/home-assistant/  
+denonavr-cli: https://pypi.org/project/denonavr-cli/

{denonavr-0.11.6 → denonavr-1.0.1}/denonavr/__init__.py

@@ -10,8 +10,6 @@ Automation Library for Denon AVR receivers.
 # Set default logging handler to avoid "No handler found" warnings.
 import logging
 
-from .decorators import run_async_synchronously
-
 # Import denonavr module
 from .denonavr import DenonAVR
 from .ssdp import async_identify_denonavr_receivers
@@ -19,7 +17,7 @@ from .ssdp import async_identify_denonavr_receivers
 logging.getLogger(__name__).addHandler(logging.NullHandler())
 
 __title__ = "denonavr"
-__version__ = "0.11.6"
+__version__ = "1.0.1"
 
 
 async def async_discover():
@@ -33,17 +31,6 @@ async def async_discover():
     return await async_identify_denonavr_receivers()
 
 
-@run_async_synchronously(async_func=async_discover)
-def discover():
-    """
-    Discover all Denon AVR devices in LAN zone.
-
-    Returns a list of dictionaries which includes all discovered Denon AVR
-    devices with keys "host", "modelName", "friendlyName", "presentationURL".
-    By default SSDP broadcasts are sent once with a 2 seconds timeout.
-    """
-
-
 async def async_init_all_receivers():
     """
     Initialize all discovered Denon AVR receivers in LAN zone.
@@ -58,13 +45,3 @@ async def async_init_all_receivers():
         init_receiver = DenonAVR(receiver["host"])
         init_receivers.append(init_receiver)
     return init_receivers
-
-
-@run_async_synchronously(async_func=async_init_all_receivers)
-def init_all_receivers():
-    """
-    Initialize all discovered Denon AVR receivers in LAN zone.
-
-    Returns a list of created Denon AVR instances.
-    By default SSDP broadcasts are sent up to 3 times with a 2 seconds timeout.
-    """