datex-studio-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/.gitignore

@@ -1,6 +1,7 @@
 exclude/
 exploration/
 reviews/
+.tap/
 
 # Environment
 .env

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datex-studio-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: CLI for Datex Studio low-code platform, designed for LLM-based AI agents
 Project-URL: Homepage, https://github.com/datex/datex-studio-cli
 Project-URL: Documentation, https://github.com/datex/datex-studio-cli
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1.0
+Requires-Dist: defusedxml>=0.7.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: markdownify>=0.13.0
 Requires-Dist: msal>=1.28.0
@@ -487,7 +488,7 @@ dxs crm metadata incident --relationships
 | Command | Description | Performance |
 |---------|-------------|-------------|
 | `search <keyword>` | Search entities by name (server-side filtered) | ~200 tokens, <1s |
-| `list` | List all entities in the model | ~5000 tokens, <1s |
+| `entities` | List all entities in the model | ~5000 tokens, <1s |
 | `enums` | List enumeration types | ~500 tokens, <1s |
 | `actions` | List server-side actions (POST operations) | ~300 tokens, <1s |
 | `functions` | List server-side functions (GET operations) | ~300 tokens, <1s |
@@ -498,8 +499,10 @@ dxs crm metadata incident --relationships
 
 | Command | Description | Performance |
 |---------|-------------|-------------|
-| `describe <entity>` | Show full entity schema (properties, types, navigation) | 1,000-50,000 tokens, <2s |
-| `relationships <entity>` | Show navigation properties and relationships | ~1000 tokens, <2s |
+| `describe-entity <entity>` | Show full entity schema (properties, types, navigation) | 1,000-50,000 tokens, <2s |
+| `describe-relationships <entity>` | Show navigation properties and relationships | ~1000 tokens, <2s |
+| `describe-properties <type> <prop>` | Show details for a specific property (by composite key) | ~100 tokens, <1s |
+| `describe-navigation-properties <type> <prop>` | Show details for a specific navigation property (by composite key) | ~100 tokens, <1s |
 | `describe-enum <enum>` | Show enum members and values | ~200 tokens, <1s |
 | `describe-action <action>` | Show action parameters and return type | ~300 tokens, <1s |
 | `describe-function <func>` | Show function parameters and return type | ~300 tokens, <1s |
@@ -519,10 +522,10 @@ dxs crm metadata incident --relationships
 dxs schema search "invoice" -c 1
 
 # 2. DESCRIBE structure (understand properties and keys)
-dxs schema describe Invoices -c 1 | grep -A 50 "navigation_properties:"
+dxs schema describe-entity Invoices -c 1 | grep -A 50 "navigation_properties:"
 
 # 3. EXPLORE relationships (find what can be expanded)
-dxs schema relationships Invoices -c 1
+dxs schema describe-relationships Invoices -c 1
 
 # 4. TEST queries incrementally (avoid 400 errors)
 dxs odata execute -c 1 -q "Invoices(123)?\$expand=InvoiceLines"
@@ -550,20 +553,20 @@ This nested expansion returns:
 
 ```bash
 # DON'T: List all entities (returns thousands)
-dxs schema list -c 1  # ~5000 tokens
+dxs schema entities -c 1  # ~5000 tokens
 
 # DO: Search for specific entities (returns ~20 matches)
 dxs schema search "order" -c 1  # ~200 tokens
 
 # Use --count flag for count-only queries (minimal tokens)
-dxs schema list --count -c 1        # Returns: count: 150
+dxs schema entities --count -c 1        # Returns: count: 150
 dxs schema search "invoice" --count -c 1  # Returns: count: 10
 
 # Filter large describe output with grep
-dxs schema describe EntityName -c 1 | grep -A 50 "navigation_properties:"
+dxs schema describe-entity EntityName -c 1 | grep -A 50 "navigation_properties:"
 
 # Save large schemas to file for analysis
-dxs schema describe EntityName -c 1 > schema.yaml 2>&1
+dxs schema describe-entity EntityName -c 1 > schema.yaml 2>&1
 ```
 
 **Query Building Best Practices:**
@@ -572,7 +575,7 @@ dxs schema describe EntityName -c 1 > schema.yaml 2>&1
 ✅ Test `$expand` incrementally: single → multiple → nested
 ✅ Use `$select` to limit fields: `Entity?$select=Id,Name,Date`
 ✅ Use bulk queries: `Entity?$filter=Id in (1,2,3)` vs one-by-one
-✅ Start with `schema search` (not `list`) when looking for entities
+✅ Start with `schema search` (not `entities`) when looking for entities
 
 See [Schema Discovery Guide](docs/schema-discovery-guide.md) for command reference and [Schema Discovery Examples](docs/schema-discovery-examples.md) for complete real-world walkthroughs.
 

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/README.md

@@ -443,7 +443,7 @@ dxs crm metadata incident --relationships
 | Command | Description | Performance |
 |---------|-------------|-------------|
 | `search <keyword>` | Search entities by name (server-side filtered) | ~200 tokens, <1s |
-| `list` | List all entities in the model | ~5000 tokens, <1s |
+| `entities` | List all entities in the model | ~5000 tokens, <1s |
 | `enums` | List enumeration types | ~500 tokens, <1s |
 | `actions` | List server-side actions (POST operations) | ~300 tokens, <1s |
 | `functions` | List server-side functions (GET operations) | ~300 tokens, <1s |
@@ -454,8 +454,10 @@ dxs crm metadata incident --relationships
 
 | Command | Description | Performance |
 |---------|-------------|-------------|
-| `describe <entity>` | Show full entity schema (properties, types, navigation) | 1,000-50,000 tokens, <2s |
-| `relationships <entity>` | Show navigation properties and relationships | ~1000 tokens, <2s |
+| `describe-entity <entity>` | Show full entity schema (properties, types, navigation) | 1,000-50,000 tokens, <2s |
+| `describe-relationships <entity>` | Show navigation properties and relationships | ~1000 tokens, <2s |
+| `describe-properties <type> <prop>` | Show details for a specific property (by composite key) | ~100 tokens, <1s |
+| `describe-navigation-properties <type> <prop>` | Show details for a specific navigation property (by composite key) | ~100 tokens, <1s |
 | `describe-enum <enum>` | Show enum members and values | ~200 tokens, <1s |
 | `describe-action <action>` | Show action parameters and return type | ~300 tokens, <1s |
 | `describe-function <func>` | Show function parameters and return type | ~300 tokens, <1s |
@@ -475,10 +477,10 @@ dxs crm metadata incident --relationships
 dxs schema search "invoice" -c 1
 
 # 2. DESCRIBE structure (understand properties and keys)
-dxs schema describe Invoices -c 1 | grep -A 50 "navigation_properties:"
+dxs schema describe-entity Invoices -c 1 | grep -A 50 "navigation_properties:"
 
 # 3. EXPLORE relationships (find what can be expanded)
-dxs schema relationships Invoices -c 1
+dxs schema describe-relationships Invoices -c 1
 
 # 4. TEST queries incrementally (avoid 400 errors)
 dxs odata execute -c 1 -q "Invoices(123)?\$expand=InvoiceLines"
@@ -506,20 +508,20 @@ This nested expansion returns:
 
 ```bash
 # DON'T: List all entities (returns thousands)
-dxs schema list -c 1  # ~5000 tokens
+dxs schema entities -c 1  # ~5000 tokens
 
 # DO: Search for specific entities (returns ~20 matches)
 dxs schema search "order" -c 1  # ~200 tokens
 
 # Use --count flag for count-only queries (minimal tokens)
-dxs schema list --count -c 1        # Returns: count: 150
+dxs schema entities --count -c 1        # Returns: count: 150
 dxs schema search "invoice" --count -c 1  # Returns: count: 10
 
 # Filter large describe output with grep
-dxs schema describe EntityName -c 1 | grep -A 50 "navigation_properties:"
+dxs schema describe-entity EntityName -c 1 | grep -A 50 "navigation_properties:"
 
 # Save large schemas to file for analysis
-dxs schema describe EntityName -c 1 > schema.yaml 2>&1
+dxs schema describe-entity EntityName -c 1 > schema.yaml 2>&1
 ```
 
 **Query Building Best Practices:**
@@ -528,7 +530,7 @@ dxs schema describe EntityName -c 1 > schema.yaml 2>&1
 ✅ Test `$expand` incrementally: single → multiple → nested
 ✅ Use `$select` to limit fields: `Entity?$select=Id,Name,Date`
 ✅ Use bulk queries: `Entity?$filter=Id in (1,2,3)` vs one-by-one
-✅ Start with `schema search` (not `list`) when looking for entities
+✅ Start with `schema search` (not `entities`) when looking for entities
 
 See [Schema Discovery Guide](docs/schema-discovery-guide.md) for command reference and [Schema Discovery Examples](docs/schema-discovery-examples.md) for complete real-world walkthroughs.
 

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "datex-studio-cli"
-version = "0.2.1"
+version = "0.3.0"
 description = "CLI for Datex Studio low-code platform, designed for LLM-based AI agents"
 readme = "README.md"
 license = "MIT"
@@ -33,6 +33,7 @@ dependencies = [
     "pydantic>=2.5.0",
     "pydantic-settings>=2.0.0",
     "pyyaml>=6.0",
+    "defusedxml>=0.7.0",
 ]
 
 [project.optional-dependencies]
@@ -125,6 +126,10 @@ plugins = ["pydantic.mypy"]
 module = ["msal.*"]
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = ["defusedxml.*"]
+ignore_missing_imports = true
+
 [[tool.mypy.overrides]]
 module = ["fastapi.*", "uvicorn.*"]
 ignore_missing_imports = true

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/src/dxs/__init__.py

@@ -1,4 +1,4 @@
 """Datex Studio CLI - Command-line interface for Datex Studio platform."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"
 __app_name__ = "dxs"

{datex_studio_cli-0.2.1 → datex_studio_cli-0.3.0}/src/dxs/cli.py

@@ -7,10 +7,14 @@ from typing import Any, TypeVar, cast
 import click
 
 from dxs import __app_name__, __version__
-from dxs.core.output import OutputFormat, format_error, format_output
+from dxs.context import DxsContext, pass_context  # re-exported for backward compat
+from dxs.core.output import OutputFormat, format_error
 from dxs.utils.config import get_settings
 from dxs.utils.errors import DxsError
 
+# Re-export so that existing `from dxs.cli import DxsContext, pass_context` still works
+__all__ = ["DxsContext", "pass_context"]
+
 F = TypeVar("F", bound=Callable[..., Any])
 
 # Fields to strip from author objects in concise mode
@@ -45,125 +49,6 @@ def _strip_concise(data: Any, parent_key: str | None = None) -> Any:
         return data
 
 
-class DxsContext:
-    """Shared context passed to all commands."""
-
-    def __init__(self) -> None:
-        self.output_format: OutputFormat = OutputFormat.YAML
-        self.verbose: bool = False
-        self.quiet: bool = False
-        self.concise: bool = True  # Concise output is default
-        self.org: str | None = None
-        self.env: str | None = None
-        self.branch: int | None = None
-        self.repo: int | None = None
-        self.save_path: str | None = None
-        self.force_overwrite: bool = False
-        self.explicit_output_format: bool = False
-
-    def output(self, data: Any, include_metadata: bool = True) -> None:
-        """Output data in the configured format.
-
-        Args:
-            data: Data to output.
-            include_metadata: Include timestamp and version metadata.
-        """
-        from dxs.core.output.formatter import detect_format_from_extension
-
-        # Determine format: --output flag > file extension > default
-        if self.save_path and not self.explicit_output_format:
-            output_format = detect_format_from_extension(self.save_path, self.output_format)
-        else:
-            output_format = self.output_format
-
-        formatted = format_output(data, output_format, include_metadata, self.concise)
-
-        # Save to file if requested (suppresses stdout)
-        if self.save_path:
-            self._save_to_file(formatted)
-            return
-
-        click.echo(formatted)
-
-    def _save_to_file(self, content: str) -> None:
-        """Save content to file with overwrite protection.
-
-        Args:
-            content: Formatted content to save.
-
-        Raises:
-            ValidationError: If file exists and force_overwrite is False.
-            DxsError: If file write fails.
-            RestrictedModeError: If restricted mode is enabled.
-        """
-        from pathlib import Path
-
-        from dxs.utils.config import is_restricted_mode
-        from dxs.utils.errors import RestrictedModeError, ValidationError
-
-        # Block file saving in restricted mode
-        if is_restricted_mode():
-            raise RestrictedModeError(
-                command_name="--save option",
-                reason="writes files to the filesystem",
-            )
-
-        assert self.save_path is not None  # Caller checks this
-        path = Path(self.save_path)
-
-        if path.exists() and not self.force_overwrite:
-            raise ValidationError(
-                message=f"File '{self.save_path}' already exists",
-                code="DXS-FILE-001",
-                suggestions=[
-                    "Use --force flag to overwrite the file",
-                    "Specify a different filename with --save",
-                ],
-            )
-
-        path.parent.mkdir(parents=True, exist_ok=True)
-
-        try:
-            path.write_text(content, encoding="utf-8")
-            self.debug(f"Output saved to: {self.save_path}")
-        except OSError as e:
-            raise DxsError(
-                code="DXS-FILE-002",
-                message=f"Failed to write file '{self.save_path}': {e}",
-            ) from e
-
-    def output_error(self, error: DxsError | Exception) -> None:
-        """Output an error in the configured format.
-
-        Args:
-            error: Error to output.
-        """
-        formatted = format_error(error, self.output_format)
-        click.echo(formatted, err=True)
-
-    def log(self, message: str) -> None:
-        """Log a message (respects quiet flag).
-
-        Args:
-            message: Message to log.
-        """
-        if not self.quiet:
-            click.echo(message, err=True)
-
-    def debug(self, message: str) -> None:
-        """Log a debug message (only in verbose mode).
-
-        Args:
-            message: Debug message to log.
-        """
-        if self.verbose:
-            click.echo(f"[DEBUG] {message}", err=True)
-
-
-# Create a pass decorator for the context
-pass_context = click.make_pass_decorator(DxsContext, ensure=True)
-
-
 # Global options shared across all commands
 CONTEXT_SETTINGS = {
     "help_option_names": ["-h", "--help"],
@@ -459,7 +344,6 @@ def register_commands() -> None:
         organization,
         proxy,
         report,
-        report_data,
         source,
         studio,
         user,
@@ -477,7 +361,6 @@ def register_commands() -> None:
     cli.add_command(organization.organization)
     cli.add_command(proxy.proxy)
     cli.add_command(report.report)
-    cli.add_command(report_data.report_data)
     cli.add_command(source.source)
     cli.add_command(studio.studio)
     cli.add_command(user.user)