datex-studio-cli 0.1.0__tar.gz

datex_studio_cli-0.1.0/.gitignore

@@ -0,0 +1,71 @@
+exclude/
+exploration/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# Documentation
+docs/_build/
+
+# Datex CLI config (for development)
+# Don't ignore ~/.datex/ as it's outside the repo
+
+# OS files
+.DS_Store
+Thumbs.db

datex_studio_cli-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: datex-studio-cli
+Version: 0.1.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
+Project-URL: Repository, https://github.com/datex/datex-studio-cli
+Author: Datex
+License-Expression: MIT
+Keywords: ai,cli,datex,llm,low-code
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+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: httpx>=0.27.0
+Requires-Dist: markdownify>=0.13.0
+Requires-Dist: msal>=1.28.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Datex Studio CLI (`dxs`)
+
+Command-line interface for Datex Studio low-code platform, designed for LLM-based AI agents.
+
+## Installation
+
+```bash
+# Using uv
+uv pip install datex-studio-cli
+
+# Using pip
+pip install datex-studio-cli
+```
+
+## Quick Start
+
+```bash
+# Authenticate with Azure Entra
+dxs auth login
+
+# View commit history
+dxs source log --repo 10
+
+# View configuration history
+dxs source history userGrid --branch 100
+
+# View current locks
+dxs source locks --repo 10
+```
+
+## Output Formats
+
+The CLI supports multiple output formats optimized for LLM consumption:
+
+```bash
+# YAML (default)
+dxs source log --repo 10
+
+# JSON
+dxs source log --repo 10 --output json
+
+# CSV
+dxs source log --repo 10 --output csv
+```
+
+## Configuration
+
+Configuration is stored in `~/.datex/config.yaml`. You can also use environment variables:
+
+```bash
+# Set via environment
+export DXS_API_BASE_URL=https://api.datex.io
+export DXS_DEFAULT_BRANCH=100
+export DXS_DEFAULT_REPO=10
+
+# Set via CLI
+dxs config set api_base_url https://api.datex.io
+dxs config set default_branch 100
+dxs config set default_repo 10
+
+# View configuration
+dxs config list
+```
+
+## Commands
+
+### Authentication
+
+- `dxs auth login` - Authenticate with Azure Entra
+- `dxs auth logout` - Clear stored credentials
+- `dxs auth status` - Show authentication status
+
+### Configuration
+
+- `dxs config get <key>` - Get a configuration value
+- `dxs config set <key> <value>` - Set a configuration value
+- `dxs config list` - List all configuration values
+
+### Source Control
+
+- `dxs source log` - Show commit history
+- `dxs source history <ref>` - Show configuration version history
+- `dxs source diff` - Show pending changes (draft vs last commit)
+- `dxs source changes` - Show pending changes in detail
+- `dxs source locks` - Show current lock status
+- `dxs source deps` - Show configuration dependencies
+- `dxs source compare` - Compare two branches
+
+### Exploration
+
+- `dxs source explore info` - Show application overview
+- `dxs source explore configs` - List all configurations
+- `dxs source explore config <ref>` - View a specific configuration
+- `dxs source explore summary <ref>` - Show structural summary
+- `dxs source explore trace <ref>` - Show configuration dependencies
+
+### Branch & Repository Management
+
+- `dxs source branch list` - List branches
+- `dxs source branch show <id>` - Show branch details
+- `dxs source repo list` - List repositories
+- `dxs source repo show <id>` - Show repository details
+
+### Integrations
+
+- `dxs devops workitem <id>` - Get Azure DevOps work item
+- `dxs crm case <id>` - Get Dynamics CRM case
+- `dxs organization list` - List organizations
+- `dxs marketplace list` - List marketplace applications
+- `dxs api <method> <url>` - Make raw API requests
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/datex/datex-studio-cli.git
+cd datex-studio-cli
+uv venv
+source .venv/bin/activate
+uv pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint and format
+ruff check .
+ruff format .
+
+# Type check
+mypy src/dxs
+```
+
+## License
+
+MIT

datex_studio_cli-0.1.0/README.md

@@ -0,0 +1,135 @@
+# Datex Studio CLI (`dxs`)
+
+Command-line interface for Datex Studio low-code platform, designed for LLM-based AI agents.
+
+## Installation
+
+```bash
+# Using uv
+uv pip install datex-studio-cli
+
+# Using pip
+pip install datex-studio-cli
+```
+
+## Quick Start
+
+```bash
+# Authenticate with Azure Entra
+dxs auth login
+
+# View commit history
+dxs source log --repo 10
+
+# View configuration history
+dxs source history userGrid --branch 100
+
+# View current locks
+dxs source locks --repo 10
+```
+
+## Output Formats
+
+The CLI supports multiple output formats optimized for LLM consumption:
+
+```bash
+# YAML (default)
+dxs source log --repo 10
+
+# JSON
+dxs source log --repo 10 --output json
+
+# CSV
+dxs source log --repo 10 --output csv
+```
+
+## Configuration
+
+Configuration is stored in `~/.datex/config.yaml`. You can also use environment variables:
+
+```bash
+# Set via environment
+export DXS_API_BASE_URL=https://api.datex.io
+export DXS_DEFAULT_BRANCH=100
+export DXS_DEFAULT_REPO=10
+
+# Set via CLI
+dxs config set api_base_url https://api.datex.io
+dxs config set default_branch 100
+dxs config set default_repo 10
+
+# View configuration
+dxs config list
+```
+
+## Commands
+
+### Authentication
+
+- `dxs auth login` - Authenticate with Azure Entra
+- `dxs auth logout` - Clear stored credentials
+- `dxs auth status` - Show authentication status
+
+### Configuration
+
+- `dxs config get <key>` - Get a configuration value
+- `dxs config set <key> <value>` - Set a configuration value
+- `dxs config list` - List all configuration values
+
+### Source Control
+
+- `dxs source log` - Show commit history
+- `dxs source history <ref>` - Show configuration version history
+- `dxs source diff` - Show pending changes (draft vs last commit)
+- `dxs source changes` - Show pending changes in detail
+- `dxs source locks` - Show current lock status
+- `dxs source deps` - Show configuration dependencies
+- `dxs source compare` - Compare two branches
+
+### Exploration
+
+- `dxs source explore info` - Show application overview
+- `dxs source explore configs` - List all configurations
+- `dxs source explore config <ref>` - View a specific configuration
+- `dxs source explore summary <ref>` - Show structural summary
+- `dxs source explore trace <ref>` - Show configuration dependencies
+
+### Branch & Repository Management
+
+- `dxs source branch list` - List branches
+- `dxs source branch show <id>` - Show branch details
+- `dxs source repo list` - List repositories
+- `dxs source repo show <id>` - Show repository details
+
+### Integrations
+
+- `dxs devops workitem <id>` - Get Azure DevOps work item
+- `dxs crm case <id>` - Get Dynamics CRM case
+- `dxs organization list` - List organizations
+- `dxs marketplace list` - List marketplace applications
+- `dxs api <method> <url>` - Make raw API requests
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/datex/datex-studio-cli.git
+cd datex-studio-cli
+uv venv
+source .venv/bin/activate
+uv pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint and format
+ruff check .
+ruff format .
+
+# Type check
+mypy src/dxs
+```
+
+## License
+
+MIT

datex_studio_cli-0.1.0/pyproject.toml

@@ -0,0 +1,126 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "datex-studio-cli"
+version = "0.1.0"
+description = "CLI for Datex Studio low-code platform, designed for LLM-based AI agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Datex" }
+]
+keywords = ["cli", "datex", "low-code", "llm", "ai"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "markdownify>=0.13.0",
+    "msal>=1.28.0",
+    "pydantic>=2.5.0",
+    "pydantic-settings>=2.0.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-httpx>=0.30.0",
+    "ruff>=0.4.0",
+    "mypy>=1.8.0",
+    "types-PyYAML>=6.0.0",
+]
+
+[project.scripts]
+dxs = "dxs.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/datex/datex-studio-cli"
+Documentation = "https://github.com/datex/datex-studio-cli"
+Repository = "https://github.com/datex/datex-studio-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dxs"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    ".claude/",
+    ".mypy_cache/",
+    ".pytest_cache/",
+    ".ruff_cache/",
+    ".serena/",
+    ".venv/",
+    ".gitignore",
+    "CLAUDE.md",
+    "documentation/",
+    "exploration/",
+    "exclude/",
+    "tests/",
+    "*.analysis.md",
+    "explore-*.md",
+    "uv.lock",
+]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["dxs"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+plugins = ["pydantic.mypy"]
+
+[[tool.mypy.overrides]]
+module = ["msal.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+
+[tool.coverage.run]
+source = ["src/dxs"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]

datex_studio_cli-0.1.0/src/dxs/__init__.py

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

datex_studio_cli-0.1.0/src/dxs/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running dxs as a module: python -m dxs"""
+
+from dxs.cli import cli
+
+if __name__ == "__main__":
+    cli()