vortex-cli 4.19.2__tar.gz → 4.20.0__tar.gz

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vortex_cli
-Version: 4.19.2
+Version: 4.20.0
 Summary: Vortex CLI
 Author-email: Jordan Amos <jordan.amos@gmail.com>
 License: MIT License
@@ -109,6 +109,7 @@ For a full list of commands see `--help`.
 ### Command Overview
 
 - `code`: Open the workspace in Visual Studio Code.
+- `use`: Set the default server so you don't need to pass `--server` on every command. e.g. `vortex use production`
 - `list` (or `ls`): List Puakma Applications on the server or cloned locally. (`ls` is an alias for `vortex list --local`)
 - `clone`: Clone Puakma Applications and their design objects into the workspace or in the .pmx format.
 - `watch`: Watch the workspace for changes to Design Objects and automatically upload them to the server.
@@ -117,9 +118,48 @@ For a full list of commands see `--help`.
 - `log`: View the server log.
 - `find`: Find Design Objects of cloned applications by name.
 - `grep`: Search the contents of cloned Design Objects using a Regular Expression.
-- `new`: Create new Design Objects, Applications, or Keywords. Use --update <ID> to update instead.
+- `new`: Create new Design Objects, Applications, or Keywords. Use `--update <ID>` to update instead. Run without flags to launch an interactive wizard.
 - `copy`: Copy a Design Object from one application to another.
 - `delete`: Delete Design Objects by ID.
 - `db`: Interact with Database Connections.
 - `docs`: Open the Tornado Server Blackbook.
 - `execute`: Execute a command on the server.
+
+### Switching Servers
+
+If you work with multiple servers, use `vortex use <server>` to set the default instead of passing `--server` on every command:
+
+```
+vortex use production
+vortex list
+vortex watch
+```
+
+### Interactive Wizards
+
+Run `vortex new object` or `vortex new app` without any flags to launch a step-by-step wizard:
+
+```
+vortex new object
+# → pick app from locally cloned list
+# → pick design type
+# → enter name
+# → enter content type (resource only)
+# → enter parent page, open action, save action (page only)
+# → preview and confirm
+
+vortex new app
+# → enter name
+# → pick from existing groups or enter a new one
+# → enter description (optional)
+# → preview and confirm
+```
+
+### Skipping Confirmation Prompts
+
+Pass `--yes` (or `-y`) to skip Y/y confirmation prompts, useful for scripting:
+
+```
+vortex --yes delete 123 456
+vortex -y new object --name MyAction --app-id 10 --type action
+```

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/README.md

@@ -67,6 +67,7 @@ For a full list of commands see `--help`.
 ### Command Overview
 
 - `code`: Open the workspace in Visual Studio Code.
+- `use`: Set the default server so you don't need to pass `--server` on every command. e.g. `vortex use production`
 - `list` (or `ls`): List Puakma Applications on the server or cloned locally. (`ls` is an alias for `vortex list --local`)
 - `clone`: Clone Puakma Applications and their design objects into the workspace or in the .pmx format.
 - `watch`: Watch the workspace for changes to Design Objects and automatically upload them to the server.
@@ -75,9 +76,48 @@ For a full list of commands see `--help`.
 - `log`: View the server log.
 - `find`: Find Design Objects of cloned applications by name.
 - `grep`: Search the contents of cloned Design Objects using a Regular Expression.
-- `new`: Create new Design Objects, Applications, or Keywords. Use --update <ID> to update instead.
+- `new`: Create new Design Objects, Applications, or Keywords. Use `--update <ID>` to update instead. Run without flags to launch an interactive wizard.
 - `copy`: Copy a Design Object from one application to another.
 - `delete`: Delete Design Objects by ID.
 - `db`: Interact with Database Connections.
 - `docs`: Open the Tornado Server Blackbook.
 - `execute`: Execute a command on the server.
+
+### Switching Servers
+
+If you work with multiple servers, use `vortex use <server>` to set the default instead of passing `--server` on every command:
+
+```
+vortex use production
+vortex list
+vortex watch
+```
+
+### Interactive Wizards
+
+Run `vortex new object` or `vortex new app` without any flags to launch a step-by-step wizard:
+
+```
+vortex new object
+# → pick app from locally cloned list
+# → pick design type
+# → enter name
+# → enter content type (resource only)
+# → enter parent page, open action, save action (page only)
+# → preview and confirm
+
+vortex new app
+# → enter name
+# → pick from existing groups or enter a new one
+# → enter description (optional)
+# → preview and confirm
+```
+
+### Skipping Confirmation Prompts
+
+Pass `--yes` (or `-y`) to skip Y/y confirmation prompts, useful for scripting:
+
+```
+vortex --yes delete 123 456
+vortex -y new object --name MyAction --app-id 10 --type action
+```

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "vortex_cli"
-version = "4.19.2"
+version = "4.20.0"
 description = "Vortex CLI"
 requires-python = ">=3.10"
 readme = { file = "README.md", content-type = "text/markdown" }

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/cli.py

@@ -90,11 +90,14 @@ def validate_args(
 ) -> None:
     if args.command == "new":
         msg = None
-        is_update_mode = bool(args.update_ids)
+        is_update_mode = bool(getattr(args, "update_ids", None))
         if args.subcommand == "object":
             missing_required_fields = not is_update_mode and not (
                 args.name and args.app_id and args.design_type
             )
+            # Allow wizard mode when all required fields are missing
+            has_any_required = args.name or args.app_id or args.design_type
+            wizard_mode = missing_required_fields and not has_any_required
             missing_content_type = (
                 args.design_type in (DesignType.RESOURCE, DesignType.DOCUMENTATION)
                 and not args.content_type
@@ -111,7 +114,7 @@ def validate_args(
                 or args.parent_page
                 or args.content_type
             )
-            if missing_required_fields:
+            if missing_required_fields and not wizard_mode:
                 msg = "--name, --app-id, and --type are required unless using --update"
             elif missing_content_type:
                 msg = (
@@ -123,13 +126,19 @@ def validate_args(
             elif update_is_missing_args:
                 msg = "Please specify an option to update"
         elif args.subcommand == "app":
-            if not is_update_mode and not (args.name and args.group):
+            has_any_app_required = args.name or args.group
+            app_wizard_mode = not is_update_mode and not has_any_app_required
+            if (
+                not is_update_mode
+                and not (args.name and args.group)
+                and not app_wizard_mode
+            ):
                 msg = "--name and --group are required when creating new applications."
         if msg:
             new_parser.error(msg)
 
     elif args.command == "clone" and not (args.app_ids or args.reclone):
-        clone_parser.error("Please specifiy the APP_ID[s] to clone or use '--reclone'")
+        clone_parser.error("Please specify the APP_ID[s] to clone or use '--reclone'")
     elif args.command == "db" and args.sql is not None:
         try:
             args.database = int(args.database)
@@ -250,7 +259,7 @@ def add_clone_parser(
     )
     clone_parser.add_argument(
         "--reclone",
-        help="Reclone locally cloned applictions",
+        help="Reclone locally cloned applications",
         action="store_true",
     )
     clone_parser.add_argument(
@@ -416,7 +425,7 @@ def add_log_parser(command_parser: _SubParsersAction[ArgumentParser]) -> None:
         type=_positive_int,
         help=(
             "Used only with --keep-alive. "
-            "The number of seconds betwen requests for new logs. Default is %(default)s"
+            "The number of seconds between requests for new logs. Default is %(default)s"
         ),
         default=5,
         metavar="SECONDS",
@@ -659,13 +668,13 @@ def add_db_parser(command_parser: _SubParsersAction[ArgumentParser]) -> Argument
         "--update",
         "-u",
         action="store_true",
-        help="Set this flag when running querys for altering/updating the database",
+        help="Set this flag when running queries for altering/updating the database",
     )
     return db_parser
 
 
 def add_docs_parser(command_parser: _SubParsersAction[ArgumentParser]) -> None:
-    command_parser.add_parser("docs", help="Open the Torndao Server Blackbook")
+    command_parser.add_parser("docs", help="Open the Tornado Server Blackbook")
 
 
 def add_execute_parser(command_parser: _SubParsersAction[ArgumentParser]) -> None:
@@ -710,6 +719,18 @@ def add_execute_parser(command_parser: _SubParsersAction[ArgumentParser]) -> Non
     _add_server_option(execute_parser)
 
 
+def add_use_parser(command_parser: _SubParsersAction[ArgumentParser]) -> None:
+    use_parser = command_parser.add_parser(
+        "use",
+        help="Set the default server definition to use",
+    )
+    use_parser.add_argument(
+        "server_name",
+        metavar="SERVER_NAME",
+        help="The name of the server definition in the config file",
+    )
+
+
 def add_import_parser(
     command_parser: _SubParsersAction[ArgumentParser],
 ) -> ArgumentParser:

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/commands/copy.py

@@ -40,7 +40,7 @@ async def _acopy_obj(
     to_app: PuakmaApplication,
     copy_params: bool,
 ) -> int:
-    _err_msg = f"Failed to copy {obj} to {obj.app.id}"
+    _err_msg = f"Failed to copy {obj} to {to_app.id}"
     try:
         # Copying to the same application, need a new name in that case
         if obj.app == to_app:
@@ -151,6 +151,8 @@ def copy_(
     obj_ids: list[int],
     to_app_id: int,
     copy_params: bool,
+    *,
+    yes: bool = False,
 ) -> int:
     to_app = workspace.lookup_app(server, to_app_id)
     objs = []
@@ -171,7 +173,7 @@ def copy_(
 
     print(f"The following Objects will be copied to {to_app}:\n")
     render_objects(objs, show_params=copy_params)
-    if input("\n[Y/y] to continue:") not in ["Y", "y"]:
+    if not yes and input("\n[Y/y] to continue:") not in ["Y", "y"]:
         return 1
 
     with (

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/commands/delete.py

@@ -38,6 +38,8 @@ def delete(
     workspace: Workspace,
     server: PuakmaServer,
     obj_ids: list[int],
+    *,
+    yes: bool = False,
 ) -> int:
     app_objs: dict[PuakmaApplication, list[DesignObject]] = collections.defaultdict(
         list
@@ -54,7 +56,7 @@ def delete(
     _deleted = Colour.colour("DELETED", Colour.RED)
     print(f"The following Design Objects will be {_deleted}:\n")
     render_objects(all_objs)
-    if input("\n[Y/y] to continue:") not in ["Y", "y"]:
+    if not yes and input("\n[Y/y] to continue:") not in ["Y", "y"]:
         logger.error("Operation Cancelled")
         return 1
 

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/commands/log.py

@@ -23,7 +23,7 @@ def log(
     server: PuakmaServer,
     limit: int,
     source_filter: str | None,
-    messsage_filter: str | None,
+    message_filter: str | None,
     errors_only: bool,
     info_only: bool,
     debug_only: bool,
@@ -35,7 +35,7 @@ def log(
             s.get_last_log_items,
             limit,
             source_filter,
-            messsage_filter,
+            message_filter,
             errors_only,
             info_only,
             debug_only,

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/commands/new.py

@@ -177,6 +177,8 @@ def _validate_update_objs(
     workspace: Workspace,
     server: PuakmaServer,
     design_obj_ids: list[int],
+    *,
+    yes: bool = False,
     **kwargs: Any,
 ) -> tuple[tuple[DesignObject, ...], bool]:
     _universal_keys = ("name", "design_type", "comment", "inherit_from")
@@ -213,7 +215,7 @@ def _validate_update_objs(
     _updated = Colour.colour("UPDATED", Colour.GREEN)
     print(f"The following Design Object(s) will be {_updated}:\n")
     print(tabulate.tabulate(rows, headers=row_headers))
-    if input("\n[Y/y] to continue:") not in ["Y", "y"]:
+    if not yes and input("\n[Y/y] to continue:") not in ["Y", "y"]:
         exit(1)
 
     return tuple(objs), recreate_params
@@ -223,11 +225,13 @@ def _update_objects(
     workspace: Workspace,
     server: PuakmaServer,
     design_obj_ids: list[int],
+    *,
+    yes: bool = False,
     **kwargs: Any,
 ) -> int:
     try:
         updated_objs, recreate_params = _validate_update_objs(
-            workspace, server, design_obj_ids, **kwargs
+            workspace, server, design_obj_ids, yes=yes, **kwargs
         )
     except (DesignObjectNotFound, DesignObjectAmbiguousError) as e:
         logger.error(e)
@@ -259,6 +263,8 @@ def _new_object(
     parent_page: str | None = None,
     open_action: str | None = None,
     save_action: str | None = None,
+    *,
+    yes: bool = False,
 ) -> int:
     if not _validate_args_for_type(
         design_type,
@@ -288,7 +294,7 @@ def _new_object(
     _created = Colour.colour("CREATED", Colour.GREEN)
     print(f"The following Design Object(s) will be {_created}:\n")
     render_objects(objs, show_params=_show_params)
-    if input("\n[Y/y] to continue:") not in ["Y", "y"]:
+    if not yes and input("\n[Y/y] to continue:") not in ["Y", "y"]:
         return 1
 
     recreate_params = True if parent_page or open_action or save_action else False
@@ -308,11 +314,13 @@ def _new_app(
     inherit_from: str | None,
     template_name: str | None,
     description: str | None,
+    *,
+    yes: bool = False,
 ) -> int:
     app = PuakmaApplication(-1, name, group, inherit_from, template_name, server.host)
     print("The following Application will be created:\n")
     render_apps([app], show_inherited=True)
-    if input("\n[Y/y] to continue:") not in ["Y", "y"]:
+    if not yes and input("\n[Y/y] to continue:") not in ["Y", "y"]:
         return 1
 
     with server as s:
@@ -342,13 +350,167 @@ def _new_keyword(
     return 0
 
 
+def _pick_from_list(prompt: str, options: list[str]) -> str:
+    print(f"\n{prompt}")
+    for i, option in enumerate(options, 1):
+        print(f"  {i}. {option}")
+    while True:
+        choice = input("Enter number: ").strip()
+        try:
+            idx = int(choice)
+            if 1 <= idx <= len(options):
+                return options[idx - 1]
+        except ValueError:
+            pass
+        print(f"Invalid choice. Please enter a number between 1 and {len(options)}.")
+
+
+def _new_object_wizard(
+    workspace: Workspace,
+    server: PuakmaServer,
+    *,
+    yes: bool = False,
+) -> int:
+    # Step 1: List locally cloned apps for user to pick from
+    print("Creating a new Design Object...\n")
+    apps = workspace.listapps(server)
+    if not apps:
+        logger.error(
+            "No locally cloned applications found. Run 'vortex clone <app_id>' first."
+        )
+        return 1
+
+    app_labels = [f"[{app.id}] {app}" for app in apps]
+    chosen_label = _pick_from_list("Select an application:", app_labels)
+    chosen_idx = app_labels.index(chosen_label)
+    chosen_app = apps[chosen_idx]
+
+    # Reload the app from local workspace to get design objects
+    app = workspace.lookup_app(server, chosen_app.id)
+
+    # Step 2: Pick design type
+    design_type_names = [t.name.lower() for t in DesignType if t != DesignType.ERROR]
+    chosen_type_name = _pick_from_list("Select a design type:", design_type_names)
+    design_type = DesignType.from_name(chosen_type_name)
+
+    # Step 3: Ask for name
+    name = ""
+    while not name.strip():
+        name = input("\nEnter object name: ").strip()
+        if not name:
+            print("Name cannot be empty.")
+
+    # Step 4: content_type — RESOURCE only (PAGE auto-sets text/html, others don't support it)
+    content_type = None
+    if design_type == DesignType.RESOURCE:
+        content_type = input(
+            "Enter content type (e.g. text/javascript, text/css): "
+        ).strip()
+        if not content_type:
+            logger.error("Content type is required for resource type.")
+            return 1
+
+    # Step 5: parent_page, open_action, save_action — PAGE only
+    parent_page = None
+    open_action = None
+    save_action = None
+    if design_type == DesignType.PAGE:
+        parent_page = (
+            input("Enter parent page (optional, press Enter to skip): ").strip() or None
+        )
+        open_action = (
+            input("Enter open action (optional, press Enter to skip): ").strip() or None
+        )
+        save_action = (
+            input("Enter save action (optional, press Enter to skip): ").strip() or None
+        )
+
+    return _new_object(
+        workspace,
+        server,
+        name=name,
+        app_id=app.id,
+        design_type=design_type,
+        content_type=content_type,
+        parent_page=parent_page,
+        open_action=open_action,
+        save_action=save_action,
+        yes=yes,
+    )
+
+
+def _new_app_wizard(
+    server: PuakmaServer,
+    *,
+    yes: bool = False,
+) -> int:
+    print("Creating a new Application...\n")
+
+    # Step 1: Ask for app name
+    name = ""
+    while not name.strip():
+        name = input("Enter application name: ").strip()
+        if not name:
+            print("Name cannot be empty.")
+
+    # Step 2: Ask for group (show existing groups if available)
+    # Note: Do NOT use 'with server as s:' here — the context manager closes the
+    # underlying httpx client on exit, which would break the subsequent _new_app() call.
+    try:
+        apps = server.fetch_all_apps([], [], [], False, False, False)
+        existing_groups = sorted({app.group for app in apps if app.group})
+        if existing_groups:
+            print("\nExisting groups:")
+            for i, group in enumerate(existing_groups, 1):
+                print(f"  {i}. {group}")
+            print(f"  {len(existing_groups) + 1}. (enter a new group)")
+            while True:
+                choice = input("Enter number or group name: ").strip()
+                try:
+                    idx = int(choice)
+                    if 1 <= idx <= len(existing_groups):
+                        group = existing_groups[idx - 1]
+                        break
+                    elif idx == len(existing_groups) + 1:
+                        group = input("Enter new group name: ").strip()
+                        break
+                except ValueError:
+                    group = choice
+                    break
+                print(
+                    f"Invalid choice. Please enter a number between "
+                    f"1 and {len(existing_groups) + 1}, or a group name."
+                )
+        else:
+            group = input("Enter application group: ").strip()
+    except Exception:
+        group = input("Enter application group: ").strip()
+
+    # Step 3: Ask for optional description
+    description = (
+        input("Enter description (optional, press Enter to skip): ").strip() or None
+    )
+
+    return _new_app(
+        server,
+        group,
+        name,
+        inherit_from=None,
+        template_name=None,
+        description=description,
+        yes=yes,
+    )
+
+
 def new(workspace: Workspace, server: PuakmaServer, args: argparse.Namespace) -> int:
+    yes = getattr(args, "yes", False)
     if args.subcommand in ("obj", "object"):
-        if args.update_ids:
+        if getattr(args, "update_ids", None):
             return _update_objects(
                 workspace,
                 server,
                 args.update_ids,
+                yes=yes,
                 name=args.name,
                 design_type=args.design_type,
                 content_type=args.content_type,
@@ -358,6 +520,8 @@ def new(workspace: Workspace, server: PuakmaServer, args: argparse.Namespace) ->
                 open_action=args.open_action,
                 save_action=args.save_action,
             )
+        elif not (args.name and args.app_id and args.design_type):
+            return _new_object_wizard(workspace, server, yes=yes)
         else:
             return _new_object(
                 workspace,
@@ -371,8 +535,11 @@ def new(workspace: Workspace, server: PuakmaServer, args: argparse.Namespace) ->
                 parent_page=args.parent_page,
                 open_action=args.open_action,
                 save_action=args.save_action,
+                yes=yes,
             )
     elif args.subcommand == "app":
+        if not (args.name and args.group):
+            return _new_app_wizard(server, yes=yes)
         return _new_app(
             server,
             args.group,
@@ -380,6 +547,7 @@ def new(workspace: Workspace, server: PuakmaServer, args: argparse.Namespace) ->
             args.inherit_from,
             args.template,
             args.description,
+            yes=yes,
         )
     elif args.subcommand in ("kw", "keyword"):
         return _new_keyword(

vortex_cli-4.20.0/vortex/commands/use.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import configparser
+import logging
+
+from vortex.workspace import Workspace
+
+logger = logging.getLogger("vortex")
+
+
+def use(workspace: Workspace, server_name: str) -> int:
+    config = configparser.ConfigParser()
+    config.read(workspace.server_config_file)
+
+    available_servers = config.sections()
+    if server_name not in available_servers:
+        logger.error(
+            f"Server '{server_name}' not found in config. "
+            f"Available servers: {available_servers}"
+        )
+        return 1
+
+    config.set(config.default_section, "default", server_name)
+    with open(workspace.server_config_file, "w") as f:
+        config.write(f)
+
+    logger.info(f"Default server set to '{server_name}'")
+    return 0

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/main.py

@@ -28,6 +28,7 @@ from vortex.commands.import_ import import_
 from vortex.commands.list import list_
 from vortex.commands.log import log
 from vortex.commands.new import new
+from vortex.commands.use import use
 from vortex.commands.watch import watch
 from vortex.logging import LoggingHandler
 from vortex.logging import logging_handler
@@ -47,7 +48,7 @@ def error_handler() -> Generator[None]:
     except KeyboardInterrupt:
         raise SystemExit(130) from None
     except Exception as e:
-        msg = f"An unexpected error occured. {e}".rstrip()
+        msg = f"An unexpected error occurred. {e}".rstrip()
         logger.critical(msg)
         LoggingHandler.log_to_file_and_exit(e, 3)
 
@@ -82,6 +83,12 @@ def main(argv: Sequence[str] | None = None) -> int:
         action="store_true",
         help="Initialise the workspace and config files, if they don't already exist",
     )
+    parser.add_argument(
+        "--yes",
+        "-y",
+        action="store_true",
+        help="Skip confirmation prompts and auto-confirm",
+    )
 
     command_parser = parser.add_subparsers(dest="command")
     cli.add_list_parser(command_parser)
@@ -97,6 +104,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     cli.add_execute_parser(command_parser)
     cli.add_export_parser(command_parser)
     cli.add_import_parser(command_parser)
+    cli.add_use_parser(command_parser)
 
     clone_parser = cli.add_clone_parser(command_parser)
     code_parser = cli.add_code_parser(command_parser)
@@ -135,6 +143,8 @@ def main(argv: Sequence[str] | None = None) -> int:
             return code(workspace, remaining_args)
         elif args.command == "docs":
             return docs()
+        elif args.command == "use":
+            return use(workspace, args.server_name)
 
         server = workspace.read_server_from_config(server_name)
         logger.debug(f"Using server {server}")
@@ -238,7 +248,7 @@ def main(argv: Sequence[str] | None = None) -> int:
                 )
             return new(workspace, server, args)
         elif args.command == "delete":
-            return delete(workspace, server, args.obj_ids)
+            return delete(workspace, server, args.obj_ids, yes=args.yes)
         elif args.command == "copy":
             return copy_(
                 workspace,
@@ -246,6 +256,7 @@ def main(argv: Sequence[str] | None = None) -> int:
                 args.ids,
                 to_app_id=args.app_id,
                 copy_params=args.copy_params,
+                yes=args.yes,
             )
         elif args.command == "db":
             return db(

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/models.py

@@ -269,7 +269,7 @@ class PuakmaServer:
         self,
         limit_items: int,
         source_filter: str | None,
-        messsage_filter: str | None,
+        message_filter: str | None,
         errors_only: bool,
         info_only: bool,
         debug_only: bool,
@@ -282,8 +282,8 @@ class PuakmaServer:
         where.write("WHERE 1=1")
         if source_filter:
             _and("source", source_filter)
-        if messsage_filter:
-            _and("logstring", messsage_filter)
+        if message_filter:
+            _and("logstring", message_filter)
         if last_log_item_id is not None and last_log_item_id > 0:
             where.write(f" AND logid > {last_log_item_id}")
         if errors_only:
@@ -329,7 +329,7 @@ class PuakmaApplication:
         self.id = id_
         self.name = name
         self.group = group
-        # Some apps dont have a group. Adding a palce holder will
+        # Some apps dont have a group. Adding a placeholder will
         # allow for consistent paths locally
         self.group_safe = group or "~"
         self.inherit_from = inherit_from

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex/soap.py

@@ -310,8 +310,8 @@ class ServerDesigner(_PuakmaSOAPService):
     name = "ServerDesigner"
 
     async def ainitiate_connection(self) -> str:
-        opertaion = "initiateConnection"
-        resp = await self._apost(opertaion)
+        operation = "initiateConnection"
+        resp = await self._apost(operation)
         logger.info(f"Connected to {self.server.host}...")
         return str(resp.text)
 

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vortex_cli
-Version: 4.19.2
+Version: 4.20.0
 Summary: Vortex CLI
 Author-email: Jordan Amos <jordan.amos@gmail.com>
 License: MIT License
@@ -109,6 +109,7 @@ For a full list of commands see `--help`.
 ### Command Overview
 
 - `code`: Open the workspace in Visual Studio Code.
+- `use`: Set the default server so you don't need to pass `--server` on every command. e.g. `vortex use production`
 - `list` (or `ls`): List Puakma Applications on the server or cloned locally. (`ls` is an alias for `vortex list --local`)
 - `clone`: Clone Puakma Applications and their design objects into the workspace or in the .pmx format.
 - `watch`: Watch the workspace for changes to Design Objects and automatically upload them to the server.
@@ -117,9 +118,48 @@ For a full list of commands see `--help`.
 - `log`: View the server log.
 - `find`: Find Design Objects of cloned applications by name.
 - `grep`: Search the contents of cloned Design Objects using a Regular Expression.
-- `new`: Create new Design Objects, Applications, or Keywords. Use --update <ID> to update instead.
+- `new`: Create new Design Objects, Applications, or Keywords. Use `--update <ID>` to update instead. Run without flags to launch an interactive wizard.
 - `copy`: Copy a Design Object from one application to another.
 - `delete`: Delete Design Objects by ID.
 - `db`: Interact with Database Connections.
 - `docs`: Open the Tornado Server Blackbook.
 - `execute`: Execute a command on the server.
+
+### Switching Servers
+
+If you work with multiple servers, use `vortex use <server>` to set the default instead of passing `--server` on every command:
+
+```
+vortex use production
+vortex list
+vortex watch
+```
+
+### Interactive Wizards
+
+Run `vortex new object` or `vortex new app` without any flags to launch a step-by-step wizard:
+
+```
+vortex new object
+# → pick app from locally cloned list
+# → pick design type
+# → enter name
+# → enter content type (resource only)
+# → enter parent page, open action, save action (page only)
+# → preview and confirm
+
+vortex new app
+# → enter name
+# → pick from existing groups or enter a new one
+# → enter description (optional)
+# → preview and confirm
+```
+
+### Skipping Confirmation Prompts
+
+Pass `--yes` (or `-y`) to skip Y/y confirmation prompts, useful for scripting:
+
+```
+vortex --yes delete 123 456
+vortex -y new object --name MyAction --app-id 10 --type action
+```

{vortex_cli-4.19.2 → vortex_cli-4.20.0}/vortex_cli.egg-info/SOURCES.txt

@@ -30,6 +30,7 @@ vortex/commands/import_.py
 vortex/commands/list.py
 vortex/commands/log.py
 vortex/commands/new.py
+vortex/commands/use.py
 vortex/commands/watch.py
 vortex/docs/Blackbook.pdf
 vortex/lib/puakma-6.0.40.jar