soco-cli 0.4.63__tar.gz → 0.4.64__tar.gz

{soco-cli-0.4.63/soco_cli.egg-info → soco-cli-0.4.64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: soco-cli
-Version: 0.4.63
+Version: 0.4.64
 Summary: Sonos command line control utility, based on SoCo
 Author-email: Avantrec Ltd <soco_cli@avantrec.com>
 Project-URL: Homepage, https://github.com/avantrec/soco-cli

{soco-cli-0.4.63 → soco-cli-0.4.64}/README.md

@@ -473,7 +473,8 @@ The following operate on the stations in TuneIn's 'My Radio Stations' list.
 
 ### Grouping and Stereo Pairing
 
-- **`group <master_speaker>`(or `g`)**: Groups the speaker with `<master_speaker>`.
+- **`group <master_speaker>`(or `g`)**: Groups the speaker with `<master_speaker>`, which acts as the coordinator.
+- **`multi_group <slave_speaker> [<slave_speaker> ...]`**: Groups one or more speakers with the target speaker, which acts as the coordinator.
 - **`pair <right_hand_speaker>`**: Creates a stereo pair, where the target speaker becomes the left-hand speaker of the pair and `<right_hand_speaker>` becomes the right-hand of the pair. Can be used to pair dissimilar Sonos devices (e.g., to stereo-pair a Play:1 with a One). The left-hand speaker becomes the coordinator speaker, and the stereo pair will adopt its name.
 - **`party_mode` (or `party`)**: Adds all speakers in the system into a single group. The target speaker becomes the group coordinator. Remove speakers individually using `ungroup`, or use `ungroup_all`.
 - **`transfer_playback <target_speaker>` (or `transfer_to`, `transfer`)**: Transfers playback to <target_speaker>. This is achieved by grouping and ungrouping the speakers, and swapping the group coordinator. It's a convenience shortcut for `speaker1 group speaker2 : speaker1 ungroup`.

{soco-cli-0.4.63 → soco-cli-0.4.64}/soco_cli/__init__.py

@@ -10,4 +10,4 @@ server, to control Sonos via HTTP requests.
 For more information, please see: https://github.com/avantrec/soco-cli
 """
 
-__version__ = "0.4.63"
+__version__ = "0.4.64"

{soco-cli-0.4.63 → soco-cli-0.4.64}/soco_cli/action_processor.py

@@ -939,6 +939,33 @@ def group_or_pair(speaker, action, args, soco_function, use_local_speaker_list):
     return True
 
 
+@one_or_more_parameters
+def multi_group(speaker, action, args, soco_function, use_local_speaker_list):
+    """
+    Group one or more speakers with a coordinator speaker. Note: reverses the usual
+    order; the target speaker is the coordinator, not the speaker to be grouped.
+    """
+    logging.info("Grouping speakers '{}' with '{}'".format(args, speaker.player_name))
+    for index in range(len(args)):
+        target_speaker = get_speaker(args[index], use_local_speaker_list)
+        if not target_speaker:
+            error_report("Speaker '{}' not found".format(args[index]))
+            continue
+        logging.info(
+            "Grouping speaker '{}' with coordinator '{}'".format(
+                target_speaker.player_name, speaker.player_name
+            )
+        )
+        group_or_pair(
+            target_speaker,
+            action,
+            [speaker.player_name],
+            soco_function,
+            use_local_speaker_list,
+        )
+    return True
+
+
 @zero_parameters
 def operate_on_all(speaker, action, args, soco_function, use_local_speaker_list):
     zones = speaker.all_zones
@@ -2847,6 +2874,8 @@ actions = {
     "sleep": SonosFunction(sleep_timer, "sleep_timer", True),
     "group": SonosFunction(group_or_pair, "join"),
     "g": SonosFunction(group_or_pair, "join"),
+    "multi_group": SonosFunction(multi_group, "join"),
+    "mg": SonosFunction(multi_group, "join"),
     "ungroup": SonosFunction(no_args_no_output, "unjoin"),
     "ug": SonosFunction(no_args_no_output, "unjoin"),
     "u": SonosFunction(no_args_no_output, "unjoin"),

{soco-cli-0.4.63 → soco-cli-0.4.64/soco_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: soco-cli
-Version: 0.4.63
+Version: 0.4.64
 Summary: Sonos command line control utility, based on SoCo
 Author-email: Avantrec Ltd <soco_cli@avantrec.com>
 Project-URL: Homepage, https://github.com/avantrec/soco-cli