mpf 0.57.4.dev2__tar.gz → 0.80.0.dev1__tar.gz

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/.gitignore

@@ -25,7 +25,8 @@ venv/
 #  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
+# AVW: Going to include the spec at least for reference
+.spec
 
 # Installer logs
 pip-log.txt

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/.prospector.yaml

@@ -23,7 +23,6 @@ pylint:
   disable:
     - pointless-string-statement  # pointless statement, which is how our event docstrings are seen
     - too-few-public-methods
-    - too-many-positional-arguments  # many methods have many positional args
     - unsubscriptable-object    # broken on python 3.9
     # The following linter rules are disabled to make a refactor managable in chunks
     - consider-using-f-string  # temporarily disabling due to the 900+ instances to be replaced

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mpf
-Version: 0.57.4.dev2
+Version: 0.80.0.dev1
 Summary: The Mission Pinball Framework (MPF)
 Author-email: The Mission Pinball Framework Team <brian@missionpinball.org>
 License: MIT
@@ -31,7 +31,6 @@ Requires-Dist: psutil==5.9.8
 Requires-Dist: pyserial==3.5
 Requires-Dist: pyserial-asyncio==0.6
 Requires-Dist: ruamel.yaml==0.18.6
-Requires-Dist: setuptools~=72.2.0
 Requires-Dist: sortedcontainers==2.4.0
 Requires-Dist: terminaltables==3.1.10
 Requires-Dist: Pillow==9.5.0

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/mpf/_version.py

@@ -10,10 +10,10 @@ PyPI.
 
 """
 
-__version__ = '0.57.4.dev2'  # Also consider whether MPF-MC pyproject.toml should be updated
+__version__ = '0.80.0.dev1'  # Also consider whether MPF-MC pyproject.toml should be updated
 '''The full version of MPF.'''
 
-__short_version__ = '0.57'
+__short_version__ = '0.80'
 '''The major.minor version of MPF.'''
 
 __bcp_version__ = '1.1'

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/mpf/assets/show.py

@@ -521,7 +521,6 @@ class RunningShow:
     def _start_play(self):
         if self._stopped:
             return
-        self.machine.show_controller.debug_log("Starting show %s", self.show.name)
 
         self._total_steps = len(self.show_steps)
 
@@ -561,7 +560,6 @@ class RunningShow:
         """Stop show."""
         if self._stopped:
             return
-        self.machine.show_controller.debug_log("Stopping show %s", self.show.name)
 
         self._stopped = True
 
@@ -591,14 +589,12 @@ class RunningShow:
 
     def pause(self):
         """Pause show."""
-        self.machine.show_controller.debug_log("Pausing show %s", self.show.name)
         self._remove_delay_handler()
         if self.show_config.events_when_paused:
             self._post_events(self.show_config.events_when_paused)
 
     def resume(self):
         """Resume paused show."""
-        self.machine.show_controller.debug_log("Resuming show %s", self.show.name)
         self.next_step_time = self.machine.clock.get_time()
         self._run_next_step(post_events=self.show_config.events_when_resumed)
 

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/mpf/commands/game.py

@@ -160,10 +160,10 @@ class Command:
             if exception.errno != errno.EEXIST:
                 raise
 
-        full_logfile_path = os.path.join(machine_path, self.args.logfile)
+        self.args.full_logfile_path = os.path.join(machine_path, self.args.logfile)
 
         try:
-            os.remove(full_logfile_path)
+            os.remove(self.args.full_logfile_path)
         except OSError:
             pass
 
@@ -188,7 +188,7 @@ class Command:
         self.console_queue_listener.start()
 
         # initialize file log
-        file_log = logging.FileHandler(full_logfile_path)
+        file_log = logging.FileHandler(self.args.full_logfile_path)
         if self.args.jsonlogging:
             formatter = JSONFormatter()
         else:
@@ -273,8 +273,12 @@ class Command:
             logging.exception(exception)
 
         logging.shutdown()
-        self.console_queue_listener.stop()
-        self.file_queue_listener.stop()
+        if self.console_queue_listener:
+            self.console_queue_listener.stop()
+            self.console_queue_listener = None
+        if self.file_queue_listener:
+            self.file_queue_listener.stop()
+            self.file_queue_listener = None
 
         if self.args.pause:
             input('Press ENTER to continue...')     # nosec

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/mpf/config_players/plugin_player.py

@@ -80,6 +80,11 @@ class PluginPlayer(DeviceConfigPlayer):
 
     def play(self, settings, context, calling_context, priority=0, **kwargs):
         """Trigger remote player via BCP."""
+        # The triggering event's kwargs are passed through, and the triggering
+        # event may have come from BCP. Explicitly set _from_bcp=False so that
+        # this play event won't be swallowed.
+        if '_from_bcp' in kwargs:
+            del kwargs['_from_bcp']
         self.machine.bcp.interface.bcp_trigger(
             name='{}_play'.format(self.show_section),
             settings=settings, context=context, calling_context=calling_context,

mpf-0.80.0.dev1/mpf/config_players/slide_player.py

@@ -0,0 +1,36 @@
+"""Slide player for MPF to support GMC."""
+from functools import partial
+
+from mpf.config_players.plugin_player import PluginPlayer
+
+
+class SlidePlayer(PluginPlayer):
+
+    """Base class for part of the slide player which runs as part of MPF.
+
+    Note: This class is loaded by MPF and everything in it is in the context of
+    MPF, not the mc.
+    """
+
+    config_file_section = 'slide_player'
+    show_section = 'slides'
+
+    def _validate_config_item(self, device, device_settings):
+        # device is slide name, device_settings is configuration
+
+        device_settings = self.machine.config_validator.validate_config(
+            'slide_player', device_settings)
+
+        return_dict = dict()
+        return_dict[device] = device_settings
+
+        return return_dict
+
+    def _register_trigger(self, event, **kwargs):
+        """Register trigger via BCP for MC."""
+        del kwargs
+        client = self.machine.bcp.transport.get_named_client("local_display")
+        if client:
+            self.machine.bcp.interface.add_registered_trigger_event_for_client(client, event)
+        else:
+            self.machine.events.add_handler("bcp_clients_connected", partial(self._register_trigger, event))

mpf-0.80.0.dev1/mpf/config_players/sound_player.py

@@ -0,0 +1,39 @@
+"""Sound player plugin for MPF to support GMC."""
+from functools import partial
+from mpf.config_players.plugin_player import PluginPlayer
+
+
+class SoundPlayer(PluginPlayer):
+
+    """Base class for part of the sound player which runs as part of MPF.
+
+    Note: This class is loaded by MPF and everything in it is in the context of
+    MPF, not the mpf-mc. MPF finds this instance because the mpf-mc setup.py
+    has the following entry_point configured:
+
+        sound_player=mpfmc.config_players.sound_player:register_with_mpf
+
+    """
+
+    config_file_section = 'sound_player'
+    show_section = 'sounds'
+
+    def _validate_config_item(self, device, device_settings):
+        # device is slide name, device_settings is configuration
+
+        device_settings = self.machine.config_validator.validate_config(
+            'sound_player', device_settings)
+
+        return_dict = dict()
+        return_dict[device] = device_settings
+
+        return return_dict
+
+    def _register_trigger(self, event, **kwargs):
+        """Register trigger via BCP for MC."""
+        del kwargs
+        client = self.machine.bcp.transport.get_named_client("local_display")
+        if client:
+            self.machine.bcp.interface.add_registered_trigger_event_for_client(client, event)
+        else:
+            self.machine.events.add_handler("bcp_clients_connected", partial(self._register_trigger, event))

mpf-0.80.0.dev1/mpf/config_players/widget_player.py

@@ -0,0 +1,34 @@
+"""Widget player plugin for MPF to support GMC."""
+from functools import partial
+from mpf.config_players.plugin_player import PluginPlayer
+
+
+class WidgetPlayer(PluginPlayer):
+
+    """Widget Player in MPF.
+
+    Note: This class is loaded by MPF and everything in it is in the context of MPF.
+    """
+
+    config_file_section = 'widget_player'
+    show_section = 'widgets'
+
+    def _validate_config_item(self, device, device_settings):
+        # device is slide name, device_settings is configuration
+
+        device_settings = self.machine.config_validator.validate_config(
+            'widget_player', device_settings)
+
+        return_dict = dict()
+        return_dict[device] = device_settings
+
+        return return_dict
+
+    def _register_trigger(self, event, **kwargs):
+        """Register trigger via BCP for MC."""
+        del kwargs
+        client = self.machine.bcp.transport.get_named_client("local_display")
+        if client:
+            self.machine.bcp.interface.add_registered_trigger_event_for_client(client, event)
+        else:
+            self.machine.events.add_handler("bcp_clients_connected", partial(self._register_trigger, event))

{mpf-0.57.4.dev2 → mpf-0.80.0.dev1}/mpf/config_spec.yaml

@@ -115,7 +115,7 @@ autofire_coils:
     coil_overwrite: single|subconfig(coil_overwrites)|None
     switch_overwrite: dict|str:str|None
     ball_search_order: single|int|100
-    playfield: single|machine(playfields)|None
+    playfield: single|machine(playfields)|playfield
     timeout_watch_time: single|ms|0
     timeout_max_hits: single|int|0
     timeout_disable_time: single|ms|0
@@ -295,7 +295,8 @@ bonus_mode_settings:
     rounding_value: single|int|None
     rounding_direction: single|str|up
 bonus_entries:
-    event: single|event_posted|
+    entry: single|str|
+    text: single|str|None
     score: single|template_int|
     reset_player_score_entry: single|bool|false
     player_score_entry: single|str|None
@@ -493,12 +494,11 @@ drop_targets:
     reset_coil_max_wait_ms: single|ms|100ms
     knockdown_coil_max_wait_ms: single|ms|100ms
     ignore_switch_ms: single|ms|500ms
-    playfield: single|machine(playfields)|None
+    playfield: single|machine(playfields)|playfield
 drop_target_banks:
     __valid_in__: machine, mode
     __type__: device
     drop_targets: list|machine(drop_targets)|
-    ball_search_order: single|int|100
     max_reset_attempts: single|int|None
     reset_on_complete: single|ms|None
     reset_coil: single|machine(coils)|None
@@ -506,7 +506,6 @@ drop_target_banks:
     reset_coil_max_wait_ms: single|ms|100ms
     reset_events: event_handler|event_handler:ms|machine_reset_phase_3, ball_starting
     ignore_switch_ms: single|ms|500ms
-    playfield: single|machine(playfields)|playfield
 effects:
     common:
         type: single|str|
@@ -662,7 +661,6 @@ fast_exp_board:
     led_ports: list|subconfig(fast_led_port)|None
     led_fade_time: single|ms|0
     led_hz: single|float|30
-    ignore_led_errors: single|bool|false
 fast_breakout:
     port: single|enum(1,2,3)|
     model: single|str|
@@ -748,9 +746,6 @@ fast_servos:
     min_us: single|int|1000
     home_us: single|int|1500
     max_runtime: single|ms|2000  # 65535 max
-fast_stepper_settings:
-    __valid_in__: machine                 # todo add to validator
-    default_speed: single|int|600
 file_shows:
     __valid_in__: machine, mode                      # todo add to validator
     __type__: config_dict
@@ -839,7 +834,6 @@ high_score:
     award_slide_display_time: single|ms|4s
     categories: dict|str:list|
     defaults: dict|str:list|None
-    filler_initials: list|str|None
     enter_initials_timeout: single|secs|20s
     reverse_sort: list|str|None
     reset_high_scores_events: list|event_handler|high_scores_reset,factory_reset
@@ -1081,7 +1075,7 @@ magnets:
     release_time: single|ms|500ms
     fling_drop_time: single|ms|250ms
     fling_regrab_time: single|ms|50ms
-    playfield: single|machine(playfields)|None
+    playfield: single|machine(playfields)|playfield
     enable_events: event_handler|event_handler:ms|ball_started
     disable_events: event_handler|event_handler:ms|ball_will_end, service_mode_entered
     reset_events: event_handler|event_handler:ms|machine_reset_phase_3, ball_starting
@@ -1116,7 +1110,6 @@ mpf:
     core_modules: ignore
     config_players: ignore
     device_modules: ignore
-    min_mpf_version: single|str|None
     plugins: ignore
     platforms: ignore
     paths: ignore
@@ -1308,7 +1301,7 @@ player_vars:
 playfields:
     __valid_in__: machine
     __type__: device
-    enable_ball_search: single|template_bool|None
+    enable_ball_search: single|bool|None
     ball_search_timeout: single|ms|15s
     ball_search_interval: single|ms|150ms
     ball_search_phase_1_searches: single|int|3
@@ -1328,49 +1321,6 @@ playfield_transfers:
     transfer_events: event_handler|event_handler:ms|None
     eject_target: single|machine(ball_devices)|
     captures_from: single|machine(ball_devices)|
-playlist_player:
-    __valid_in__: machine, mode, show
-    __type__: config_player
-    __allow_others__:
-    action: single|enum(play,stop,advance,set_repeat)|play
-playlist_player_actions:
-    play:
-        action: ignore
-        playlist: single|str|
-        volume: single|gain|None
-        crossfade_mode: single|enum(use_track_setting,override,use_playlist_setting)|use_playlist_setting
-        crossfade_time: single|secs|None
-        shuffle: single|bool|None
-        repeat: single|bool|None
-        scope: single|enum(machine,player,use_playlist_setting)|use_playlist_setting
-        events_when_played: list|event_posted|use_playlist_setting
-        events_when_stopped: list|event_posted|use_playlist_setting
-        events_when_looping: list|event_posted|use_playlist_setting
-        events_when_sound_changed: list|event_posted|use_playlist_setting
-        events_when_sound_stopped: list|event_posted|use_playlist_setting
-    stop:
-        action: ignore
-        fade_out: single|secs|0
-    advance:
-        action: ignore
-        none: ignore
-    set_repeat:
-        action: ignore
-        repeat: single|bool|true
-playlists:
-    __valid_in__: machine, mode
-    __type__: config_dict
-    crossfade_mode: single|enum(use_track_setting,override)|use_track_setting
-    crossfade_time: single|secs|0
-    shuffle: single|bool|false
-    repeat: single|bool|false
-    scope: single|enum(machine,player)|machine
-    sounds: list|str|
-    events_when_played: list|event_posted|None
-    events_when_stopped: list|event_posted|None
-    events_when_looping: list|event_posted|None
-    events_when_sound_changed: list|event_posted|None
-    events_when_sound_stopped: list|event_posted|None
 plugins:
     __valid_in__: machine                      # todo add to validator
     __type__: list
@@ -1697,26 +1647,16 @@ slide_player:
     __valid_in__: machine, mode, show
     __type__: config_player
     target: single|str|None
-    background_color: single|kivycolor|000000ff
     priority: single|int_or_token|None               # todo should this be 0?
-    show: single|bool|true
-    force: single|bool|false
     transition: ignore
     transition_out: ignore
-    widgets: ignore
     expire: single|secs|None
     slide: single|str|None
     tokens: dict|str:str|None
-    action: single|enum(play,remove)|play
-slides:
-    __valid_in__: machine, mode
-    __type__: named_lists
-    debug: single|bool|false
-    expire: single|secs|None
-    background_color: single|kivycolor|000000ff
-    opacity: single|float|1.0
-    transition_out: ignore
-    __allow_others__:
+    action: single|enum(play,remove,method,update,preload,queue,queue_first,queue_immediate)|play
+    queue: single|str|None
+    max_queue_time: single|secs|None
+    method: single|str|None
 snux:
     __valid_in__: machine
     __type__: config
@@ -1738,71 +1678,13 @@ smart_virtual:
     simulate_manual_plunger_timeout: single|ms|10s
     console_log: single|enum(none,basic,full)|none
     file_log: single|enum(none,basic,full)|basic
-sound_loop_player:
-    __valid_in__: machine, mode, show
-    __type__: config_player
-    __allow_others__:
-    action: single|enum(play,stop,stop_looping,jump_to,play_layer,stop_layer,stop_looping_layer)|play
-sound_loop_player_actions:
-    play:
-        action: ignore
-        sound_loop_set: single|str|
-        volume: single|gain|None
-        fade_in: single|secs|None
-        fade_out: single|secs|None
-        start_at: single|secs|0
-        timing: single|enum(now,loop_end,next_beat_interval,next_time_interval)|loop_end
-        interval: single|float|1
-        synchronize: single|bool|false
-        events_when_played: list|event_posted|use_sound_loop_setting
-        events_when_stopped: list|event_posted|use_sound_loop_setting
-        events_when_looping: list|event_posted|use_sound_loop_setting
-        mode_end_action: single|enum(stop,stop_looping,use_sound_loop_setting)|use_sound_loop_setting
-    stop:
-        action: ignore
-        fade_out: single|secs|None
-    stop_looping:
-        action: ignore
-        none: ignore
-    jump_to:
-        action: ignore
-        time: single|secs|0
-    play_layer:
-        action: ignore
-        layer: single|int|
-        volume: single|gain|None
-        timing: single|enum(now,loop_end)|loop_end
-        fade_in: single|secs|0
-    stop_layer:
-        action: ignore
-        layer: single|int|
-        fade_out: single|secs|0
-    stop_looping_layer:
-        action: ignore
-        layer: single|int|
-sound_loop_sets:
-    __valid_in__: machine, mode
-    __type__: config_dict
-    sound: single|str|
-    volume: single|gain|None
-    tempo: single|float|60.0
-    layers:
-        sound: single|str|
-        volume: single|gain|None
-        initial_state: single|enum(play,stop)|play
-    events_when_played: list|event_posted|None
-    events_when_stopped: list|event_posted|None
-    events_when_looping: list|event_posted|None
-    fade_in: single|secs|0
-    fade_out: single|secs|0
-    mode_end_action: single|enum(stop,stop_looping)|stop
 sound_player:
     __valid_in__: machine, mode, show
     __type__: config_player
     block: single|bool|false
-    action: single|enum(play,stop,stop_looping,load,unload)|play
+    action: single|enum(play,replace,stop,stop_looping,load,unload)|play
     delay: single|secs|None
-    track: single|str|None
+    bus: single|str|None
     volume: single|gain|None
     ducking: single|subconfig(sound_ducking)|None
     pan: single|float_or_token|None
@@ -1813,73 +1695,18 @@ sound_player:
     fade_out: single|secs|None
     about_to_finish_time: single|secs|-1
     max_queue_time: single|secs|-1
-    events_when_played: list|event_posted|use_sound_setting
-    events_when_stopped: list|event_posted|use_sound_setting
-    events_when_looping: list|event_posted|use_sound_setting
-    events_when_about_to_finish: list|event_posted|use_sound_setting
-    mode_end_action: single|enum(stop,stop_looping,use_sound_setting)|use_sound_setting
-    key: single|str|use_sound_setting
-sound_pools:
-    __valid_in__: machine, mode                      # todo add to validator
-    __type__: config_dict
-    __allow_others__:
-sound_system:
-    __valid_in__: machine
-    __type__: config
-    enabled: single|bool|true
-    buffer: single|int|2048
-    frequency: single|int|44100
-    channels: single|int|1
-    tracks: dict|str:subconfig(sound_system_tracks)|
-sound_system_tracks:
-    type: single|enum(standard,sound_loop,playlist)|standard
-    volume: single|gain|0.5
-    label: single|str|None
-    events_when_played: list|event_posted|None
-    events_when_stopped: list|event_posted|None
-    events_when_paused: list|event_posted|None
-    events_when_resumed: list|event_posted|None
-    ducking: single|subconfig(sound_ducking)|None
-    simultaneous_sounds: single|int|8       # only standard
-    max_layers: single|int|8                # only sound_loop
-    crossfade_time: single|secs|0           # only playlist
-sounds:
-    __valid_in__: machine, mode
-    __type__: config_dict
-    file: single|str|None
-    track: single|str|None
-    volume: single|gain|0.5
-    pan: single|float|0
-    streaming: single|bool|false
-    loops: single|int|0
-    loop_start_at: single|secs|0
-    loop_end_at: single|secs|None
-    priority: single|int|0
-    start_at: single|secs|0
-    fade_in: single|secs|0
-    fade_out: single|secs|0
-    about_to_finish_time: single|secs|None
-    max_queue_time: single|secs|None
-    simultaneous_limit: single|int|None
-    stealing_method: single|enum(skip,oldest,newest)|oldest
     events_when_played: list|event_posted|None
     events_when_stopped: list|event_posted|None
     events_when_looping: list|event_posted|None
     events_when_about_to_finish: list|event_posted|None
-    mode_end_action: single|enum(stop,stop_looping)|stop_looping
     key: single|str|None
-    markers: list|subconfig(sound_marker)|None
-    ducking: single|subconfig(sound_ducking)|None
 sound_ducking:
-    target: list|str|
-    delay: single|secs|0
-    attack: single|secs|10ms
-    attenuation: single|gain|1.0
-    release_point: single|secs|0
-    release: single|secs|10ms
-sound_marker:
-    time: single|secs|
-    events: list|event_posted|
+    bus: single|str|None
+    attack: single|secs|
+    attenuation: single|float|
+    delay: single|secs|0.0
+    release_point: single|secs|
+    release: single|secs|
 speedometers:
     __valid_in__: machine, mode
     __type__: device
@@ -1936,7 +1763,6 @@ spinners:
     labels: list|str|None
     active_ms: single|ms|1000ms
     idle_ms: single|ms|None
-    max_events_per_second: single|int|-1
     playfield: single|machine(playfields)|playfield
     reset_when_inactive: single|bool|true
     enable_events: event_handler|event_handler:ms|None
@@ -1944,28 +1770,23 @@ spinners:
 steppers:
     __valid_in__: machine
     __type__: device
+    named_positions: dict|float:str|None
     home_events: event_handler|event_handler:ms|None
-    home_on_startup: single|bool|true
     homing_mode: single|enum(hardware,switch)|hardware
     homing_switch: single|machine(switches)|None
     homing_direction: single|enum(clockwise,counterclockwise)|clockwise
-    homing_speed: single|int|None
     pos_min: single|int|0
     pos_max: single|int|1000
     ball_search_min: single|int|0
     ball_search_max: single|int|1
     ball_search_wait: single|ms|5s
     include_in_ball_search: single|bool|true
-    relative_positions: dict|float:subconfig(stepper_position_settings)|None
+    relative_positions: dict|float:str|None
     reset_position: single|int|0
     reset_events: event_handler|event_handler:ms|machine_reset_phase_3, ball_starting, ball_will_end, service_mode_entered
-    named_positions: dict|float:subconfig(stepper_position_settings)|None
     number: single|str|
     platform: single|str|None
     platform_settings: single|dict|None
-stepper_position_settings:
-    event: single|str|
-    speed: single|int|None
 spike_stepper_settings:
     homing_speed: single|int|10
     speed: single|int|20
@@ -1998,7 +1819,7 @@ sequence_shots:
     delay_switch_list: dict|machine(switches):ms|None
     delay_event_list: event_handler|event_handler:ms|None
     sequence_timeout: single|ms|0
-    playfield: single|machine(playfields)|None
+    playfield: single|machine(playfields)|playfield
 switches:
     __valid_in__: machine
     __type__: device
@@ -2006,12 +1827,10 @@ switches:
     type: single|enum(NC,NO)|NO
     debounce: single|enum(auto,quick,normal)|auto
     ignore_window_ms: single|ms|0
-    ignore_during_ball_search: single|bool|false
     events_when_activated: list|event_posted|None
     events_when_deactivated: list|event_posted|None
     platform: single|str|None
     platform_settings: single|dict|None
-    playfield: single|machine(playfields)|playfield
     x: single|float|None
     y: single|float|None
     z: single|float|None
@@ -2084,12 +1903,6 @@ timer_control_events:  # subconfig for mode timers
     action: single|enum(add,subtract,jump,start,stop,reset,restart,pause,set_tick_interval,change_tick_interval,reset_tick_interval)|
     event: single|event_handler|
     value: single|template_float|None  # float for change_tick_interval, int for the rest
-track_player:
-    __valid_in__: machine, mode, show
-    __type__: config_player
-    action: single|enum(play,stop,pause,set_volume,stop_all_sounds)|
-    volume: single|gain|None
-    fade: single|secs|0.1sec
 transitions:
     push:
         type: single|str|
@@ -2178,11 +1991,16 @@ vpe:
 widget_player:
     __valid_in__: machine, mode, show
     __type__: config_player
+    priority: single|int_or_token|None
     slide: single|str|None
-    action: single|enum(add,remove,update)|add
+    action: single|enum(play,remove,update,preload,method)|play
+    method: ignore
     key: single|str|None
-    widget_settings: ignore
     target: single|str|None
+    expire: single|secs|None
+    tokens: dict|str:str|None
+    x: single|int|0
+    y: single|int|0
 widget_styles:
     __valid_in__: machine, mode
     __type__: config_dict