Take new_command as a list of CLI tokens

Change deprecated_task_alias(new_command=...) from a free-form string
to a list[str], where each list entry is one whitespace-separated CLI
token. The factory joins the list with single spaces when forming the
DeprecationWarning body, so the user-facing warning text is unchanged
in shape (still quoted, one command).

The list form makes per-token diffs easier to scan at the gym.register
call sites: each --task / --agent / presets= entry is on its own
line instead of being lost inside a multi-line implicit string
concat. Call-site convention: --task=... first, --agent=... next
when present, presets=NAME selector at the end -- the warning body
reads in that order too.

Test fixtures reordered to match the new --task / --agent / presets=
sequence in the warning body. All 73 cartpole deprecation tests pass.

Author: hujc7

source/isaaclab_tasks/isaaclab_tasks/direct/cartpole/__init__.py

@@ -68,29 +68,14 @@ def call():
     return call
 
 
-gym.register(
-    id="Isaac-Cartpole-Camera-Presets-Direct-v0",
-    entry_point=f"{__name__}.cartpole_camera_presets_env:CartpoleCameraPresetsEnv",
-    disable_env_checker=True,
-    kwargs={
-        "env_cfg_entry_point": deprecated_task_alias(
-            old_task_id="Isaac-Cartpole-Camera-Presets-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0",
-            consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
-        ),
-        "rl_games_cfg_entry_point": f"{agents.__name__}:rl_games_camera_ppo_cfg.yaml",
-        "skrl_cfg_entry_point": f"{agents.__name__}:skrl_camera_ppo_cfg.yaml",
-    },
-)
-
 gym.register(
     id="Isaac-Cartpole-RGB-Camera-Direct-v0",
     entry_point=f"{__name__}.cartpole_camera_env:CartpoleCameraEnv",
     disable_env_checker=True,
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-RGB-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=rgb",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=rgb"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("rgb"),
         ),
@@ -106,7 +91,7 @@ def call():
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Albedo-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=albedo",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=albedo"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("albedo"),
         ),
@@ -122,7 +107,7 @@ def call():
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-SimpleShading-Constant-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=simple_shading_constant_diffuse",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=simple_shading_constant_diffuse"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("simple_shading_constant_diffuse"),
         ),
@@ -138,7 +123,7 @@ def call():
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-SimpleShading-Diffuse-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=simple_shading_diffuse_mdl",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=simple_shading_diffuse_mdl"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("simple_shading_diffuse_mdl"),
         ),
@@ -154,7 +139,7 @@ def call():
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-SimpleShading-Full-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=simple_shading_full_mdl",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=simple_shading_full_mdl"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("simple_shading_full_mdl"),
         ),
@@ -170,11 +155,26 @@ def call():
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Depth-Camera-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Camera-Direct-v0 presets=depth",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0", "presets=depth"],
             consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
             cfg_factory=_resolve_camera_variant("depth"),
         ),
         "rl_games_cfg_entry_point": f"{agents.__name__}:rl_games_camera_ppo_cfg.yaml",
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_camera_ppo_cfg.yaml",
     },
 )
+
+gym.register(
+    id="Isaac-Cartpole-Camera-Presets-Direct-v0",
+    entry_point=f"{__name__}.cartpole_camera_presets_env:CartpoleCameraPresetsEnv",
+    disable_env_checker=True,
+    kwargs={
+        "env_cfg_entry_point": deprecated_task_alias(
+            old_task_id="Isaac-Cartpole-Camera-Presets-Direct-v0",
+            new_command=["--task=Isaac-Cartpole-Camera-Direct-v0"],
+            consolidated_cfg_path=f"{__name__}.cartpole_camera_presets_env_cfg:CartpoleCameraPresetsEnvCfg",
+        ),
+        "rl_games_cfg_entry_point": f"{agents.__name__}:rl_games_camera_ppo_cfg.yaml",
+        "skrl_cfg_entry_point": f"{agents.__name__}:skrl_camera_ppo_cfg.yaml",
+    },
+)

source/isaaclab_tasks/isaaclab_tasks/direct/cartpole_showcase/cartpole/__init__.py

@@ -62,7 +62,7 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Box-Box-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Showcase-Direct-v0 presets=box_box",
+            new_command=["--task=Isaac-Cartpole-Showcase-Direct-v0", "presets=box_box"],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_box_box_ppo_cfg.yaml",
@@ -76,7 +76,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Box-Discrete-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Showcase-Direct-v0 presets=box_discrete --agent=skrl_box_discrete_cfg_entry_point",
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_box_discrete_cfg_entry_point",
+                "presets=box_discrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_box_discrete_ppo_cfg.yaml",
@@ -90,10 +94,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Box-MultiDiscrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=box_multidiscrete"
-                " --agent=skrl_box_multidiscrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_box_multidiscrete_cfg_entry_point",
+                "presets=box_multidiscrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_box_multidiscrete_ppo_cfg.yaml",
@@ -111,7 +116,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Discrete-Box-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Showcase-Direct-v0 presets=discrete_box --agent=skrl_discrete_box_cfg_entry_point",
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_discrete_box_cfg_entry_point",
+                "presets=discrete_box",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_discrete_box_ppo_cfg.yaml",
@@ -125,10 +134,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Discrete-Discrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=discrete_discrete"
-                " --agent=skrl_discrete_discrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_discrete_discrete_cfg_entry_point",
+                "presets=discrete_discrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_discrete_discrete_ppo_cfg.yaml",
@@ -142,10 +152,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Discrete-MultiDiscrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=discrete_multidiscrete"
-                " --agent=skrl_discrete_multidiscrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_discrete_multidiscrete_cfg_entry_point",
+                "presets=discrete_multidiscrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_discrete_multidiscrete_ppo_cfg.yaml",
@@ -163,10 +174,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-MultiDiscrete-Box-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=multidiscrete_box"
-                " --agent=skrl_multidiscrete_box_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_multidiscrete_box_cfg_entry_point",
+                "presets=multidiscrete_box",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_multidiscrete_box_ppo_cfg.yaml",
@@ -180,10 +192,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-MultiDiscrete-Discrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=multidiscrete_discrete"
-                " --agent=skrl_multidiscrete_discrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_multidiscrete_discrete_cfg_entry_point",
+                "presets=multidiscrete_discrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_multidiscrete_discrete_ppo_cfg.yaml",
@@ -197,10 +210,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-MultiDiscrete-MultiDiscrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=multidiscrete_multidiscrete"
-                " --agent=skrl_multidiscrete_multidiscrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_multidiscrete_multidiscrete_cfg_entry_point",
+                "presets=multidiscrete_multidiscrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_multidiscrete_multidiscrete_ppo_cfg.yaml",
@@ -218,7 +232,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Dict-Box-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Showcase-Direct-v0 presets=dict_box --agent=skrl_dict_box_cfg_entry_point",
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_dict_box_cfg_entry_point",
+                "presets=dict_box",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_dict_box_ppo_cfg.yaml",
@@ -232,10 +250,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Dict-Discrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=dict_discrete"
-                " --agent=skrl_dict_discrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_dict_discrete_cfg_entry_point",
+                "presets=dict_discrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_dict_discrete_ppo_cfg.yaml",
@@ -249,10 +268,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Dict-MultiDiscrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=dict_multidiscrete"
-                " --agent=skrl_dict_multidiscrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_dict_multidiscrete_cfg_entry_point",
+                "presets=dict_multidiscrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_dict_multidiscrete_ppo_cfg.yaml",
@@ -270,7 +290,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Tuple-Box-Direct-v0",
-            new_command="--task=Isaac-Cartpole-Showcase-Direct-v0 presets=tuple_box --agent=skrl_tuple_box_cfg_entry_point",
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_tuple_box_cfg_entry_point",
+                "presets=tuple_box",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_tuple_box_ppo_cfg.yaml",
@@ -284,10 +308,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Tuple-Discrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=tuple_discrete"
-                " --agent=skrl_tuple_discrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_tuple_discrete_cfg_entry_point",
+                "presets=tuple_discrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_tuple_discrete_ppo_cfg.yaml",
@@ -301,10 +326,11 @@
     kwargs={
         "env_cfg_entry_point": deprecated_task_alias(
             old_task_id="Isaac-Cartpole-Showcase-Tuple-MultiDiscrete-Direct-v0",
-            new_command=(
-                "--task=Isaac-Cartpole-Showcase-Direct-v0 presets=tuple_multidiscrete"
-                " --agent=skrl_tuple_multidiscrete_cfg_entry_point"
-            ),
+            new_command=[
+                "--task=Isaac-Cartpole-Showcase-Direct-v0",
+                "--agent=skrl_tuple_multidiscrete_cfg_entry_point",
+                "presets=tuple_multidiscrete",
+            ],
             consolidated_cfg_path=f"{__name__}.cartpole_env_cfg:CartpoleShowcasePresetsEnvCfg",
         ),
         "skrl_cfg_entry_point": f"{agents.__name__}:skrl_tuple_multidiscrete_ppo_cfg.yaml",