xsoar-cli 1.0.4__tar.gz → 1.0.6__tar.gz

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/.github/workflows/pull-request-open.yml

@@ -5,14 +5,18 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Python 3.12
+      - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
 
       - name: Create and activate virtual environment
         run: |
@@ -21,7 +25,6 @@ jobs:
 
       - name: Install requirements
         run: |
-          pip install -r requirements.txt
           pip install -r requirements_dev.txt
 
       - name: Install xsoar-cli

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/.gitignore

@@ -1,4 +1,5 @@
 **/__pycache__
+**/.DS_Store
 dist
 build
 venv

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xsoar-cli
-Version: 1.0.4
+Version: 1.0.6
 Project-URL: Documentation, https://github.com/tlium/xsoar-cli#readme
 Project-URL: Issues, https://github.com/tlium/xsoar-cli/issues
 Project-URL: Source, https://github.com/tlium/xsoar-cli
@@ -9,10 +9,12 @@ License-Expression: MIT
 License-File: LICENSE.txt
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.12
+Requires-Python: <3.13,>=3.10
 Requires-Dist: click==8.1.8
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: xsoar-client>=1.0.0
@@ -21,13 +23,13 @@ Description-Content-Type: text/markdown
 
 # xsoar-cli
 
-[![PyPI version](https://badge.fury.io/py/xsoar-cli.svg)](https://badge.fury.io/py/xsoar-cli) [![Python](https://img.shields.io/pypi/pyversions/xsoar-cli.svg)](https://pypi.org/project/xsoar-cli/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+![PyPI - Version](https://img.shields.io/pypi/v/xsoar-cli) [![Python](https://img.shields.io/pypi/pyversions/xsoar-cli.svg)](https://pypi.org/project/xsoar-cli/) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 A command-line interface for managing Palo Alto Networks XSOAR (Cortex XSOAR) that streamlines content development and deployment workflows.
 
 **Key Features:**
 - **Content Management**: Validate and deploy content packs with declarative manifests
-- **Case Operations**: Retrieve case details and clone cases between environments  
+- **Case Operations**: Retrieve case details and clone cases between environments
 - **Playbook Development**: Download playbooks for local editing and testing
 - **Dependency Analysis**: Generate visual graphs of content pack dependencies
 - **Plugin System**: Extend functionality with custom commands
@@ -163,7 +165,7 @@ For more information on a specific command execute `xsoar-cli <command> --help`.
 ### Commands
 
 - **[case](src/xsoar_cli/case/README.md)** - Retrieve case details and clone cases between environments
-- **[config](src/xsoar_cli/config/README.md)** - Create, validate, and manage CLI configuration files  
+- **[config](src/xsoar_cli/config/README.md)** - Create, validate, and manage CLI configuration files
 - **[graph](src/xsoar_cli/graph/README.md)** - Generate visual dependency graphs for content packs
 - **[manifest](src/xsoar_cli/manifest/README.md)** - Validate and deploy content using declarative manifests
 - **[pack](src/xsoar_cli/pack/README.md)** - Manage content pack operations and information

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/README.md

@@ -1,12 +1,12 @@
 # xsoar-cli
 
-[![PyPI version](https://badge.fury.io/py/xsoar-cli.svg)](https://badge.fury.io/py/xsoar-cli) [![Python](https://img.shields.io/pypi/pyversions/xsoar-cli.svg)](https://pypi.org/project/xsoar-cli/) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+![PyPI - Version](https://img.shields.io/pypi/v/xsoar-cli) [![Python](https://img.shields.io/pypi/pyversions/xsoar-cli.svg)](https://pypi.org/project/xsoar-cli/) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 A command-line interface for managing Palo Alto Networks XSOAR (Cortex XSOAR) that streamlines content development and deployment workflows.
 
 **Key Features:**
 - **Content Management**: Validate and deploy content packs with declarative manifests
-- **Case Operations**: Retrieve case details and clone cases between environments  
+- **Case Operations**: Retrieve case details and clone cases between environments
 - **Playbook Development**: Download playbooks for local editing and testing
 - **Dependency Analysis**: Generate visual graphs of content pack dependencies
 - **Plugin System**: Extend functionality with custom commands
@@ -142,7 +142,7 @@ For more information on a specific command execute `xsoar-cli <command> --help`.
 ### Commands
 
 - **[case](src/xsoar_cli/case/README.md)** - Retrieve case details and clone cases between environments
-- **[config](src/xsoar_cli/config/README.md)** - Create, validate, and manage CLI configuration files  
+- **[config](src/xsoar_cli/config/README.md)** - Create, validate, and manage CLI configuration files
 - **[graph](src/xsoar_cli/graph/README.md)** - Generate visual dependency graphs for content packs
 - **[manifest](src/xsoar_cli/manifest/README.md)** - Validate and deploy content using declarative manifests
 - **[pack](src/xsoar_cli/pack/README.md)** - Manage content pack operations and information

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/pyproject.toml

@@ -7,13 +7,15 @@ name = "xsoar-cli"
 dynamic = ["version"]
 description = ''
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.10, <3.13"
 license = "MIT"
 keywords = []
 authors = [{ name = "Torbjørn Lium", email = "torben@lium.org" }]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Programming Language :: Python",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/src/xsoar_cli/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2025-present Torbjørn Lium <torben@lium.org>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "1.0.4"
+__version__ = "1.0.6"

xsoar_cli-1.0.6/src/xsoar_cli/case/README.md

@@ -0,0 +1,57 @@
+# Case
+
+Various case/incident related commands for XSOAR.
+
+## Get
+
+Retrieve basic information about a single case. Returns raw JSON formatted with 4-space indentation.
+
+**Syntax:** `xsoar-cli case get [OPTIONS] CASENUMBER`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Examples:**
+```
+xsoar-cli case get 312412
+xsoar-cli case get --environment prod 312412
+```
+
+## Clone
+
+Clone a case from one environment to another. Useful for copying production cases to development environment for testing.
+
+**Syntax:** `xsoar-cli case clone [OPTIONS] CASENUMBER`
+
+**Options:**
+- `--source TEXT` - Source environment (default: prod)
+- `--dest TEXT` - Destination environment (default: dev)
+
+**Examples:**
+```
+xsoar-cli case clone 312412                           # Clone from prod to dev (defaults)
+xsoar-cli case clone --source dev --dest prod 312412  # Clone from dev to prod
+```
+
+## Create
+
+Create a new case in XSOAR with optional custom fields and case type.
+
+**Syntax:** `xsoar-cli case create [OPTIONS] [NAME] [DETAILS]`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+- `--casetype TEXT` - Case type (default: uses default case type from config)
+- `--custom-fields TEXT` - Additional fields in format "field1=value1,field2=value2" (useful when XSOAR has mandatory custom case fields configured)
+- `--custom-fields-delimiter TEXT` - Delimiter for custom fields (default: ",")
+
+**Arguments:**
+- `NAME` - Case title (default: "Test case created from xsoar-cli")
+- `DETAILS` - Case description (default: "Placeholder case details")
+
+**Examples:**
+```
+xsoar-cli case create
+xsoar-cli case create "Security Incident" "Suspicious network activity detected"
+xsoar-cli case create --casetype "Phishing" --custom-fields "severity=High,source=Email" "Phishing Email" "Suspicious email received"
+```

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/src/xsoar_cli/case/commands.py

@@ -3,7 +3,7 @@ from typing import TYPE_CHECKING
 
 import click
 
-from xsoar_cli.utilities import load_config, validate_environments
+from xsoar_cli.utilities import load_config, parse_string_to_dict, validate_environments
 
 if TYPE_CHECKING:
     from xsoar_client.xsoar_client import Client
@@ -15,11 +15,13 @@ def case() -> None:
 
 
 @click.argument("casenumber", type=int)
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.command(help="Get basic information about a single case in XSOAR")
 @click.pass_context
 @load_config
-def get(ctx: click.Context, casenumber: int, environment: str) -> None:
+def get(ctx: click.Context, casenumber: int, environment: str | None) -> None:
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     response = xsoar_client.get_case(casenumber)
     if response["total"] == 0 and not response["data"]:
@@ -31,15 +33,31 @@ def get(ctx: click.Context, casenumber: int, environment: str) -> None:
 @click.argument("casenumber", type=int)
 @click.option("--source", default="prod", show_default=True, help="Source environment")
 @click.option("--dest", default="dev", show_default=True, help="Destination environment")
+@click.option(
+    "--custom-fields",
+    default=None,
+    help='Additional fields on the form "myfield=my_value,anotherfield=another value". Use machine name for field names, e.g mycustomfieldname.',
+)
+@click.option("--custom-fields-delimiter", default=",", help='Delimiter when specifying additional fields. Default is ","')
 @click.command()
 @click.pass_context
 @load_config
-def clone(ctx: click.Context, casenumber: int, source: str, dest: str) -> None:
+def clone(  # noqa: PLR0913
+    ctx: click.Context,
+    casenumber: int,
+    source: str,
+    dest: str,
+    custom_fields: str | None,
+    custom_fields_delimiter: str,
+) -> None:
     """Clones a case from source to destination environment."""
     valid_envs = validate_environments(source, dest, ctx=ctx)
     if not valid_envs:
         click.echo(f"Error: cannot find environments {source} and/or {dest} in config")
         ctx.exit(1)
+    if custom_fields and "=" not in custom_fields:
+        click.echo('Malformed custom fields. Must be on the form "myfield=myvalue"')
+        ctx.exit(1)
     xsoar_source_client: Client = ctx.obj["server_envs"][source]["xsoar_client"]
     results = xsoar_source_client.get_case(casenumber)
     data = results["data"][0]
@@ -56,21 +74,42 @@ def clone(ctx: click.Context, casenumber: int, source: str, dest: str) -> None:
     data.pop("modified")
     # Ensure that playbooks run immediately when the case is created
     data["createInvestigation"] = True
+    if "CustomFields" in data:
+        data["CustomFields"] = data["CustomFields"] | parse_string_to_dict(custom_fields, custom_fields_delimiter)
 
     xsoar_dest_client: Client = ctx.obj["server_envs"][dest]["xsoar_client"]
     case_data = xsoar_dest_client.create_case(data=data)
     click.echo(json.dumps(case_data, indent=4))
 
 
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.option("--casetype", default="", show_default=True, help="Create case of specified type. Default type set in config file.")
+@click.option(
+    "--custom-fields",
+    default=None,
+    help='Additional fields on the form "myfield=my_value,anotherfield=another value". Use machine name for field names, e.g mycustomfieldname.',
+)
+@click.option("--custom-fields-delimiter", default=",", help='Delimiter when specifying additional fields. Default is ","')
 @click.argument("details", type=str, default="Placeholder case details")
 @click.argument("name", type=str, default="Test case created from xsoar-cli")
 @click.command()
 @click.pass_context
 @load_config
-def create(ctx: click.Context, environment: str, casetype: str, name: str, details: str) -> None:
+def create(  # noqa: PLR0913
+    ctx: click.Context,
+    environment: str | None,
+    casetype: str,
+    name: str,
+    custom_fields: str | None,
+    custom_fields_delimiter: str,
+    details: str,
+) -> None:
     """Creates a new case in XSOAR. If invalid case type is specified as a command option, XSOAR will default to using Unclassified."""
+    if custom_fields and "=" not in custom_fields:
+        click.echo('Malformed custom fields. Must be on the form "myfield=myvalue"')
+        ctx.exit(1)
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     if not casetype:
         casetype = ctx.obj["default_new_case_type"]
@@ -79,6 +118,7 @@ def create(ctx: click.Context, environment: str, casetype: str, name: str, detai
         "name": name,
         "type": casetype,
         "details": details,
+        "CustomFields": parse_string_to_dict(custom_fields, custom_fields_delimiter),
     }
     case_data = xsoar_client.create_case(data=data)
     case_id = case_data["id"]

xsoar_cli-1.0.6/src/xsoar_cli/config/README.md

@@ -0,0 +1,64 @@
+# Config
+
+Configuration management commands for XSOAR CLI.
+
+## Create
+
+Create a new configuration file based on a template. If the configuration file already exists, prompts for confirmation to overwrite.
+
+**Syntax:** `xsoar-cli config create`
+
+**Examples:**
+```
+xsoar-cli config create
+```
+
+## Show
+
+Display the current configuration file contents as formatted JSON. API keys are masked by default for security.
+
+**Syntax:** `xsoar-cli config show [OPTIONS]`
+
+**Options:**
+- `--unmask` - Show unmasked API keys in output
+
+**Examples:**
+```
+xsoar-cli config show
+xsoar-cli config show --unmask
+```
+
+## Validate
+
+Validate that the configuration file is properly formatted JSON and test connectivity to each XSOAR environment defined in the configuration.
+
+**Syntax:** `xsoar-cli config validate [OPTIONS]`
+
+**Options:**
+- `--only-test-environment TEXT` - Test connectivity for only the specified environment
+
+**Examples:**
+```
+xsoar-cli config validate
+xsoar-cli config validate --only-test-environment prod
+```
+
+## Set Credentials
+
+Update API credentials for a specific environment in the configuration file. Automatically sets server version based on whether a key ID is provided.
+
+**Syntax:** `xsoar-cli config set-credentials [OPTIONS] APITOKEN`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: dev)
+- `--key_id INTEGER` - API key ID for XSOAR 8 (sets server_version to 8, omit for XSOAR 6)
+
+**Arguments:**
+- `APITOKEN` - The API token to set for the environment
+
+**Examples:**
+```
+xsoar-cli config set-credentials your-api-token-here
+xsoar-cli config set-credentials --environment prod your-api-token-here
+xsoar-cli config set-credentials --environment prod --key_id 123 your-api-token-here
+```

xsoar_cli-1.0.6/src/xsoar_cli/manifest/README.md

@@ -0,0 +1,122 @@
+# Manifest
+
+Content pack deployment management commands using a declarative configuration file (`xsoar_config.json`).
+
+## Generate
+
+Generate a new manifest file from currently installed content packs. Assumes all packs are marketplace packs (no custom packs).
+
+**Syntax:** `xsoar-cli manifest generate [OPTIONS] MANIFEST_PATH`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Arguments:**
+- `MANIFEST_PATH` - Path where the new manifest file will be created
+
+**Examples:**
+```
+xsoar-cli manifest generate ./xsoar_config.json
+xsoar-cli manifest generate --environment prod ./xsoar_config.json
+```
+
+## Validate
+
+Validate manifest JSON syntax and verify all specified content packs are available. Tests connectivity to pack sources and checks local pack metadata for development packs.
+
+**Syntax:** `xsoar-cli manifest validate [OPTIONS] MANIFEST_PATH`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Arguments:**
+- `MANIFEST_PATH` - Path to the manifest file to validate
+
+**Examples:**
+```
+xsoar-cli manifest validate ./xsoar_config.json
+xsoar-cli manifest validate --environment staging ./xsoar_config.json
+```
+
+## Update
+
+Compare installed packs against available versions and update the manifest file with latest versions. Prompts for confirmation on each upgrade.
+
+**Syntax:** `xsoar-cli manifest update [OPTIONS] MANIFEST_PATH`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Arguments:**
+- `MANIFEST_PATH` - Path to the manifest file to update
+
+**Examples:**
+```
+xsoar-cli manifest update ./xsoar_config.json
+xsoar-cli manifest update --environment dev ./xsoar_config.json
+```
+
+## Diff
+
+Compare the manifest definition against what is actually installed on the XSOAR server. Shows packs that are missing or have version mismatches.
+
+**Syntax:** `xsoar-cli manifest diff [OPTIONS] MANIFEST_PATH`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Arguments:**
+- `MANIFEST_PATH` - Path to the manifest file to compare
+
+**Examples:**
+```
+xsoar-cli manifest diff ./xsoar_config.json
+xsoar-cli manifest diff --environment prod ./xsoar_config.json
+```
+
+## Deploy
+
+Install or update content packs on the XSOAR server according to the manifest. Only deploys packs that differ from current installation.
+
+**Syntax:** `xsoar-cli manifest deploy [OPTIONS] MANIFEST_PATH`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+- `--verbose` - Show detailed information about skipped packs
+- `--yes` - Skip confirmation prompt
+
+**Arguments:**
+- `MANIFEST_PATH` - Path to the manifest file to deploy
+
+**Examples:**
+```
+xsoar-cli manifest deploy ./xsoar_config.json
+xsoar-cli manifest deploy --environment prod --yes ./xsoar_config.json
+xsoar-cli manifest deploy --verbose ./xsoar_config.json
+```
+
+## Manifest File Structure
+
+The `xsoar_config.json` file defines content packs to be installed:
+
+```json
+{
+    "custom_packs": [
+        {
+            "id": "MyCustomPack",
+            "version": "1.0.0",
+            "_comment": "Optional documentation comment"
+        }
+    ],
+    "marketplace_packs": [
+        {
+            "id": "CommonScripts",
+            "version": "1.20.0"
+        }
+    ]
+}
+```
+
+- **custom_packs**: Organization-developed packs stored in artifact repositories
+- **marketplace_packs**: Official Palo Alto Networks content packs
+- **_comment**: Optional field for documentation (preserved during updates)

{xsoar_cli-1.0.4 → xsoar_cli-1.0.6}/src/xsoar_cli/manifest/commands.py

@@ -39,13 +39,42 @@ def manifest() -> None:
     """Various commands to interact/update/deploy content packs defined in the xsoar_config.json manifest."""
 
 
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
+@click.argument("manifest_path", type=str)
+@click.command()
+@click.pass_context
+@load_config
+def generate(ctx: click.Context, environment: str | None, manifest_path: str) -> None:
+    """Generate a new xsoar_config.json manifest from installed content packs.
+
+    This command assumes that you do not have any custom content packs uploaded to XSOAR.
+    All packs will be added as "marketplace_packs" in the manifest.
+    """
+    if not environment:
+        environment = ctx.obj["default_environment"]
+    xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
+    installed_packs = xsoar_client.get_installed_packs()
+    manifest_data = {
+        "marketplace_packs": [],
+    }
+    for item in installed_packs:
+        tmpobj = {
+            "id": item["id"],
+            "version": item["currentVersion"],
+        }
+        manifest_data["marketplace_packs"].append(tmpobj)
+    write_manifest(manifest_path, manifest_data)
+
+
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.argument("manifest", type=str)
 @click.command()
 @click.pass_context
 @load_config
-def update(ctx: click.Context, environment: str, manifest: str) -> None:
+def update(ctx: click.Context, environment: str | None, manifest: str) -> None:
     """Update manifest on disk with latest available content pack versions."""
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     manifest_data = load_manifest(manifest)
     click.echo("Fetching outdated packs from XSOAR server. This may take a minute...", nl=False)
@@ -81,14 +110,16 @@ def update(ctx: click.Context, environment: str, manifest: str) -> None:
     write_manifest(manifest, manifest_data)
 
 
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.argument("manifest", type=str)
 @click.command()
 @click.pass_context
 @load_config
-def validate(ctx: click.Context, environment: str, manifest: str) -> None:
+def validate(ctx: click.Context, environment: str | None, manifest: str) -> None:
     """Validate manifest JSON and all pack availability. Validates upstream pack availability by doing HTTP CONNECT.
     Custom pack availability is implementation dependant."""
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     manifest_data = load_manifest(manifest)
     click.echo("Manifest is valid JSON")
@@ -121,14 +152,16 @@ def validate(ctx: click.Context, environment: str, manifest: str) -> None:
     click.echo("Manifest is valid JSON and all packs are reachable.")
 
 
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.argument("manifest", type=str)
 @click.command()
 @click.pass_context
 @load_config
-def diff(ctx: click.Context, manifest: str, environment: str) -> None:
+def diff(ctx: click.Context, manifest: str, environment: str | None) -> None:
     """Prints out the differences (if any) between what is defined in the xsoar_config.json manifest and what is actually
     installed on the XSOAR server."""
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     manifest_data = load_manifest(manifest)
     installed_packs = xsoar_client.get_installed_packs()
@@ -147,14 +180,14 @@ def diff(ctx: click.Context, manifest: str, environment: str) -> None:
         click.echo("All packs up to date.")
 
 
-@click.option("--environment", default="dev", show_default=True, help="Environment as defined in config file")
+@click.option("--environment", default=None, help="Default environment set in config file.")
 @click.option("--verbose", is_flag=True, default=False)
 @click.option("--yes", is_flag=True, default=False)
 @click.command()
 @click.argument("manifest", type=str)
 @click.pass_context
 @load_config
-def deploy(ctx: click.Context, environment: str, manifest: str, verbose: bool, yes: bool) -> None:  # noqa: FBT001
+def deploy(ctx: click.Context, environment: str | None, manifest: str, verbose: bool, yes: bool) -> None:  # noqa: FBT001
     """
     Deploys content packs to the XSOAR server as defined in the xsoar_config.json manifest.
     The PATH argument expects the full or relative path to xsoar_config.json
@@ -169,7 +202,8 @@ def deploy(ctx: click.Context, environment: str, manifest: str, verbose: bool, y
         )
     if not should_continue:
         ctx.exit()
-
+    if not environment:
+        environment = ctx.obj["default_environment"]
     xsoar_client: Client = ctx.obj["server_envs"][environment]["xsoar_client"]
     manifest_data = load_manifest(manifest)
     click.echo("Fetching installed packs...", err=True)
@@ -198,3 +232,4 @@ manifest.add_command(deploy)
 manifest.add_command(diff)
 manifest.add_command(update)
 manifest.add_command(validate)
+manifest.add_command(generate)

xsoar_cli-1.0.6/src/xsoar_cli/pack/README.md

@@ -0,0 +1,36 @@
+# Pack
+
+Content pack management commands for XSOAR.
+
+## Delete
+
+Delete a content pack from the XSOAR server. Verifies the pack is installed before attempting deletion.
+
+**Syntax:** `xsoar-cli pack delete [OPTIONS] PACK_ID`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Arguments:**
+- `PACK_ID` - The ID of the content pack to delete
+
+**Examples:**
+```
+xsoar-cli pack delete MyCustomPack
+xsoar-cli pack delete --environment prod CommonScripts
+```
+
+## Get Outdated
+
+Display a list of outdated content packs showing current and latest available versions in table format.
+
+**Syntax:** `xsoar-cli pack get-outdated [OPTIONS]`
+
+**Options:**
+- `--environment TEXT` - Target environment (default: uses default environment from config)
+
+**Examples:**
+```
+xsoar-cli pack get-outdated
+xsoar-cli pack get-outdated --environment staging
+```