v3.2.2

Deprecation notice

The ynca.Receiver class has been deprecated and replaced with the ynca.Ynca class.
This is to better represent that this library is about the YNCA API.

The ynca.Ynca class is a direct replacement for the deprecated ynca.Receiver class except for the inputs attribute on the ynca.Receiver class. That attribute is not available as such in YNCA and therefore does not belong into a class representing the API. However since it is useful functionality that most clients will need it has been replaced with the ynca.get_all_zone_inputs helper function with takes a ynca.Ynca class as input and returns a dictionary like the inputs attribute did.

There is a backward compatibility ynca.Receiver class in place which still work as before, but logs a deprecation warning.

The ynca.Receiver backward compatibility class will be removed in the next major version (timeframe unknown).

Changes

• Introduced ynca.Ynca as replacement for ynca.Receiver which is now deprecated
• Added backward compatibility ynca.Receiver class
• Added ynca.get_all_zone_inputs helper function to replace the input attribute on ynca.Receiver
• Misc minor code cleanups
• Fixed issue with YNCA console import
• Renamed YNCA Console to YNCA terminal
• Updated README and example.py for all changes

Note

Version v3.2.0 and v3.2.1 have not been released or retracted as they had errors which have been fixed in v3.2.2

Full Changelog: v3.1.0...v3.2.2

v3.1.0

• Return copies of dictionaries instead of references to internal structures
• Include typing info in package

v3.0.2

This release fixes a few issues with v3.0.0/v3.0.1.

• Extend initialization timeout. Seems to be needed on slower/busier systems
• Don't leave open connection after failed initialize()
• Make it safe to call close() at any time or multiple times

Full Changelog: v3.0.1...v3.0.2

For the rest all notes about 3.0.0 still apply, see below

Breaking change:

The API changed to better represent the YNCA api and to be a little easier to work with.
Check example.py for a basic example.

Changes

A lot of changes, these are the highlights

• Detect connection loss (mainly useful for IP connections)
• Add more subunit functionality e.g.
  • Expose artist, album, song when available
  • Expose playback status and control when available
• Add typehints
• Add tests
• Fix bugs found by tests :P
• Update documentation

v3.0.1

This release fixes 2 minor issues with v3.0.0.

• Fix readme description type so upload to PyPi will work again
• Export Band enum from the library

For the rest all notes about 3.0.0 still apply, see below

Breaking change:

The API changed to better represent the YNCA api and to be a little easier to work with.
Check example.py for a basic example.

Changes

A lot of changes, these are the highlights

• Detect connection loss (mainly useful for IP connections)
• Add more subunit functionality e.g.
  • Expose artist, album, song when available
  • Expose playback status and control when available
• Add typehints
• Add tests
• Fix bugs found by tests :P
• Update documentation

v3.0.0

Breaking change:

The API changed to better represent the YNCA api and to be a little easier to work with.
Check example.py for a basic example.

Changes

A lot of changes, these are the highlights

• Detect connection loss (mainly useful for IP connections)
• Add more subunit functionality e.g.
  • Expose artist, album, song when available
  • Expose playback status and control when available
• Add typehints
• Add tests
• Fix bugs found by tests :P
• Update documentation

v2.0.0

Breaking change:

The (undocumented) feature of providing an IP address as port is not supported anymore. To get the same functionality use socket://ip:port. The socket:// syntax is a pyserial URL handler. All URL handlers can be used, e.g. hwgrep:// to select a specific USB serial dongle for cases where the path might change on reboots of the system.

Changes

• Add support for Straight
• Update docs
• Remove support for providing IP address as port

v1.0.0

Fix an issue with selecting the V-AUX input
Promoting it to Stable (it has been 2 years without issues ;)

v0.3.0

Added "on" attribute to receiver
Don't call on_update on the receiver for zone updates

v0.2.0

• Added inputs to YncaZone
• Added on_update_callback attribute on YncaZone
• Added min_volume attribute on YncaZone

v0.1.0

Initial release