v4.0.0 alpha 1

(release notes are a work in progress)

Todo

• Move modelinfo
• Move server into package
• test terminal and server or exclude from coverage
• test connection??
• Update readme

What is new

(expand on lines below)
This is a breaking change
Easier to extend with more features
Mention API design guidelines with examples

• function name is attribute name in lowercase
• write only functions are methods
• actions are methods
• map function names directly, no magic
  Mention quicks document

Full Changelog: v3.11.0...v4.0.0a1

v3.11.0

What's Changed

• Add "RX-V475" modelinfo

Full Changelog: v3.10.0...v3.11.0

v3.10.0

What's Changed

• Add "5ch Stereo" soundprg

Full Changelog: v3.9.0...v3.10.0

v3.9.0

What's Changed

• Log all responses in communication_log_items, including error responses like UNDEFINED and RESTRICTED
• Add send_raw() method to enable sending of raw YNCA commands
• Fix misc typing info related issues

Full Changelog: v3.8.0...v3.9.0

v3.8.0

What's Changed

• Renaming of volume related attributes to match YNCA API naming, see deprecations section below for details.
• min_volume has been removed as it is not provided by the YNCA API

Deprecations

The old attributse will be removed in the next major version, until then backward compatibility code is available.
The following attributes have been renamed to better match the naming in the YNCA protocol.

• max_volume has been renamed to maxvol
• volume has been renamed to vol
• volume_up has been renamed to vol_up
• volume_down has been renamed to vol_down
• min_volume has been removed as it is not provided by the YNCA API

For more deprecation notices see older release notes

Full Changelog: v3.7.0...v3.8.0

v3.7.0

What's Changed

• Added optional communication logging (useful for debugging)
• Improve ynca_server responses (allows for better testing without real receiver)
• Added get_inputinfo_list which replaces get_all_zone_inputs

Deprecations

The following attributes have been renamed to better match the naming in the YNCA protocol.
The old attributse will be removed in the next major version, until then backward compatibility code is available.

• input has been renamed to inp
• get_inputinfo_list replaces get_all_zone_inputs

For more deprecation notices see older release notes

Full Changelog: v3.6.0...v3.7.0

v3.6.0

What's Changed

• More robust protocol handling
• Added get_modelinfo to get supported features for a specific receiver that can not be deduced from the YNCA protocol.
• get_all_zone_inputs now returns a list of all known inputs if a list of specific inputs for the connected receiver could not be determined
• Extended SoundPrg list

Deprecations

The following attributes have been renamed to better match the naming in the YNCA protocol.
The old attributse will be removed in the next major version, until then backward compatibility code is available.

• inputs has been renamed to inp_names
• name has been renamed to zonename
• scenes has been renamed to scenenames

For more deprecation notices see older release notes

Full Changelog: v3.5.0...v3.6.0

v3.5.0

Changes

• Add "9ch Stereo" sound program
• Fix "The Bottom Line" sound program

Full Changelog: v3.4.0...v3.5.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

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).

v3.4.0

Changes

• Make it safe to call connection.close() at any time
• Avoid exception when connection gets closed while connection

Full Changelog: v3.3.0...v3.4.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

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).

v3.3.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

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

• Catch error that could sometimes occur during initialization.
• Reorganize some interals
• Improved README
• Updated example.py to better match the README

Full Changelog: v3.2.2...v3.3.0