ida-hcli 0.0.0__tar.gz

ida_hcli-0.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hex-Rays SA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ida_hcli-0.0.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: ida-hcli
+Version: 0.0.0
+Summary: HCLI - Hex-Rays CLI Utility.
+Author-email: Hex-Rays SA <support@hex-rays.com>
+License-Expression: MIT
+Project-URL: Homepage, https://hex-rays.com/
+Project-URL: Repository, https://github.com/HexRaysSA/ida-hcli
+Project-URL: Issues, https://github.com/HexRaysSA/ida-hcli/issues
+Keywords: ida,ida-pro,reverse-engineering,disassembler,binary-analysis,malware-analysis,security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: rich
+Requires-Dist: rich-click
+Requires-Dist: httpx
+Requires-Dist: supabase
+Requires-Dist: pydantic
+Requires-Dist: platformdirs
+Requires-Dist: packaging
+Requires-Dist: questionary
+Requires-Dist: ida-domain>=0.0.1.dev29
+Provides-Extra: dev
+Requires-Dist: mypy>=1.16.0; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: pre-commit>=4.2.0; extra == "dev"
+Requires-Dist: safety>=3.5.2; extra == "dev"
+Requires-Dist: python-semantic-release>=10.3.1; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Requires-Dist: pytest-httpx>=0.21.0; extra == "test"
+Requires-Dist: pexpect>=4.9.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material; extra == "docs"
+Requires-Dist: mkdocs-click>=0.9.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.20.0; extra == "docs"
+Requires-Dist: mkdocs-gen-files>=0.5.0; extra == "docs"
+Requires-Dist: mkdocs-include-markdown-plugin>=7.1.5; extra == "docs"
+Requires-Dist: mkdocs-literate-nav>=0.6.2; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.15; extra == "docs"
+Dynamic: license-file
+
+# IDA HCLI
+
+![](docs/assets/screenshot.png)
+
+change #1 : chore 
+change #2 : fix 
+change #3 : feature
+change #4 : fix: azeaze
+
+A modern command-line interface for managing IDA Pro licenses, plugins, ...
+
+[![PyPI version](https://badge.fury.io/py/ida-hcli.svg)](https://badge.fury.io/py/ida-hcli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+# Documentation
+
+See [https://hcli.docs.hex-rays.com/](hcli.docs.hex-rays.com/)
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to:
+
+- Report bugs and suggest features
+- Submit pull requests with proper testing
+- Set up your development environment with Hatch
+- Generate and update documentation automatically
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Issues and Support
+
+- **Bug Reports & Feature Requests**: [GitHub Issues](https://github.com/HexRaysSA/ida-hcli/issues)
+- **Questions & Discussions**: [Discussions](https://community.hex-rays.com/)
+- **Documentation**: Auto-generated from source code at build time
+- **Commercial Support**: Contact support@hex-rays.com
+- **Hex-Rays Website**: [hex-rays.com](https://hex-rays.com/)
+
+## Development
+
+### Prerequisites
+
+- Python 3.10 or higher
+- [uv](https://docs.astral.sh/uv/) package manager
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/HexRaysSA/ida-hcli.git
+cd ida-hcli
+
+# Install dependencies
+uv sync
+
+# Run in development mode
+uv run hcli --help
+```
+
+### Build System
+
+```bash
+# Install with development dependencies
+uv sync --extra dev 
+
+# Build package
+uv build 
+
+# Run development tools
+uv run ruff format
+uv run ruff check --fix
+uv run ruff check --select I --fix
+```
+
+### Documentation
+
+Documentation is **automatically generated** from source code:
+
+```bash
+# Build documentation
+uv run mkdocs build
+
+# Serve documentation locally
+uv run mkdocs serve
+
+# Documentation includes:
+# - CLI commands (from Click help text)
+# - API reference (from Python docstrings)
+# - Usage examples (auto-generated)
+```
+
+### Testing
+
+```bash
+# Run tests
+uv run pytest
+
+# Test CLI commands
+uv run hcli whoami
+uv run hcli plugin list
+```
+
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.

ida_hcli-0.0.0/README.md

@@ -0,0 +1,106 @@
+# IDA HCLI
+
+![](docs/assets/screenshot.png)
+
+change #1 : chore 
+change #2 : fix 
+change #3 : feature
+change #4 : fix: azeaze
+
+A modern command-line interface for managing IDA Pro licenses, plugins, ...
+
+[![PyPI version](https://badge.fury.io/py/ida-hcli.svg)](https://badge.fury.io/py/ida-hcli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+# Documentation
+
+See [https://hcli.docs.hex-rays.com/](hcli.docs.hex-rays.com/)
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to:
+
+- Report bugs and suggest features
+- Submit pull requests with proper testing
+- Set up your development environment with Hatch
+- Generate and update documentation automatically
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Issues and Support
+
+- **Bug Reports & Feature Requests**: [GitHub Issues](https://github.com/HexRaysSA/ida-hcli/issues)
+- **Questions & Discussions**: [Discussions](https://community.hex-rays.com/)
+- **Documentation**: Auto-generated from source code at build time
+- **Commercial Support**: Contact support@hex-rays.com
+- **Hex-Rays Website**: [hex-rays.com](https://hex-rays.com/)
+
+## Development
+
+### Prerequisites
+
+- Python 3.10 or higher
+- [uv](https://docs.astral.sh/uv/) package manager
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/HexRaysSA/ida-hcli.git
+cd ida-hcli
+
+# Install dependencies
+uv sync
+
+# Run in development mode
+uv run hcli --help
+```
+
+### Build System
+
+```bash
+# Install with development dependencies
+uv sync --extra dev 
+
+# Build package
+uv build 
+
+# Run development tools
+uv run ruff format
+uv run ruff check --fix
+uv run ruff check --select I --fix
+```
+
+### Documentation
+
+Documentation is **automatically generated** from source code:
+
+```bash
+# Build documentation
+uv run mkdocs build
+
+# Serve documentation locally
+uv run mkdocs serve
+
+# Documentation includes:
+# - CLI commands (from Click help text)
+# - API reference (from Python docstrings)
+# - Usage examples (auto-generated)
+```
+
+### Testing
+
+```bash
+# Run tests
+uv run pytest
+
+# Test CLI commands
+uv run hcli whoami
+uv run hcli plugin list
+```
+
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.

ida_hcli-0.0.0/pyproject.toml

@@ -0,0 +1,99 @@
+[project]
+name = "ida-hcli"
+version = "0.0.0"
+description = "HCLI - Hex-Rays CLI Utility."
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+keywords = ["ida", "ida-pro", "reverse-engineering", "disassembler", "binary-analysis", "malware-analysis", "security"]
+authors = [
+    { name = "Hex-Rays SA", email = "support@hex-rays.com" }
+]
+
+dependencies = [
+    "click",
+    "rich",
+    "rich-click",
+    "httpx",
+    "supabase",
+    "pydantic",
+    "platformdirs",
+    "packaging",
+    "questionary",
+    "ida-domain>=0.0.1.dev29",
+]
+
+
+[project.urls]
+Homepage = "https://hex-rays.com/"
+Repository = "https://github.com/HexRaysSA/ida-hcli"
+Issues = "https://github.com/HexRaysSA/ida-hcli/issues"
+
+[project.scripts]
+hcli = "hcli.main:cli"
+ida-hcli = "hcli.main:cli"
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project.optional-dependencies]
+dev = [
+    "mypy>=1.16.0",
+    "ruff",
+    "bandit",
+    "pre-commit>=4.2.0",
+    "safety>=3.5.2",
+    "python-semantic-release>=10.3.1",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-mock>=3.10.0",
+    "pytest-httpx>=0.21.0",
+    "pexpect>=4.9.0",
+]
+docs = [
+    "mkdocs-material",
+    "mkdocs-click>=0.9.0",
+    "mkdocstrings[python]>=0.20.0",
+    "mkdocs-gen-files>=0.5.0",
+    "mkdocs-include-markdown-plugin>=7.1.5",
+    "mkdocs-literate-nav>=0.6.2",
+    "pymdown-extensions>=10.15"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+fix = true
+
+[tool.mypy]
+check_untyped_defs = true
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]  # or wherever your version is
+version_variables = ["src/hcli/__init__.py:__version__"]  # update your actual path
+build_command = """
+    uv lock --upgrade-package "$PACKAGE_NAME"
+    git add uv.lock
+    uv build
+"""
+dist_path = "dist/"
+major_on_zero = false  # Stay in 0.x.x range
+allow_zero_version = true
+
+# Dev branch - development releases
+[tool.semantic_release.branches.main]
+match = "main"
+prerelease = true
+prerelease_token = "dev"
+
+# Release branch - stable releases
+[tool.semantic_release.branches.release]
+match = "release"
+prerelease = false
+

ida_hcli-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ida_hcli-0.0.0/src/hcli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.0.dev1"

ida_hcli-0.0.0/src/hcli/commands/__init__.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+import rich_click as click
+
+
+def register_commands(cli: click.Group) -> None:
+    """Register all commands to the CLI group."""
+    from .download import download
+    from .commands import commands
+    from .login import login
+    from .logout import logout
+    from .update import update
+    from .whoami import whoami
+    # placeholder for more commands
+
+    cli.add_command(login)
+    cli.add_command(logout)
+    cli.add_command(whoami)
+    cli.add_command(update)
+    cli.add_command(download)
+    cli.add_command(commands)
+
+    # groups
+    from .auth import auth
+    from .ida import ida
+    from .license import license
+    from .plugin import plugin
+    from .share import share
+    from .extension import extension
+
+    cli.add_command(auth)
+    cli.add_command(ida)
+    cli.add_command(plugin)
+    cli.add_command(share)
+    cli.add_command(license)
+    cli.add_command(extension)

ida_hcli-0.0.0/src/hcli/commands/auth/__init__.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import rich_click as click
+
+
+@click.group()
+def auth() -> None:
+    """Authentication commands."""
+    pass
+
+
+# Subcommands
+from .key import key  # noqa: E402
+from .list import list_credentials  # noqa: E402
+from .switch import switch_credentials  # noqa: E402
+from .default import set_default_credentials  # noqa: E402
+
+auth.add_command(key)
+auth.add_command(list_credentials)
+auth.add_command(switch_credentials)
+auth.add_command(set_default_credentials)

ida_hcli-0.0.0/src/hcli/commands/auth/default.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import rich_click as click
+
+from hcli.lib.auth import get_auth_service
+from hcli.lib.console import console
+
+
+@click.command(name="default")
+@click.argument("name", required=False)
+def set_default_credentials(name: str | None) -> None:
+    """Set or show the default credentials."""
+    auth_service = get_auth_service()
+    auth_service.init()
+
+    if name is None:
+        # Show current default
+        default_name = auth_service.get_default_credentials_name()
+        if default_name:
+            default_source = auth_service.get_current_credentials()
+            if default_source:
+                console.print(f"[green]Default credentials: {default_name}[/green]")
+                console.print(f"Email: {default_source.email}")
+                console.print(f"Type: {default_source.type.title()}")
+            else:
+                console.print(f"[yellow]Default set to '{default_name}' but source not found.[/yellow]")
+        else:
+            console.print("[yellow]No default credentials set.[/yellow]")
+
+        # Show all available sources
+        sources = auth_service.list_credentials()
+        if sources:
+            console.print(f"\nAvailable sources: {', '.join(s.name for s in sources)}")
+        return
+
+    # Set new default
+    sources = auth_service.list_credentials()
+
+    if not sources:
+        console.print("[yellow]No credentialss found.[/yellow]")
+        console.print("Use '[bold]hcli login[/bold]' or '[bold]hcli auth key install[/bold]' to add credentialss.")
+        return
+
+    # Check if source exists
+    source_names = [s.name for s in sources]
+    if name not in source_names:
+        console.print(f"[red]Credentials '{name}' not found.[/red]")
+        console.print(f"Available sources: {', '.join(source_names)}")
+        return
+
+    # Check if already default
+    current_default = auth_service.get_default_credentials_name()
+    if name == current_default:
+        console.print(f"[yellow]'{name}' is already the default credentials.[/yellow]")
+        return
+
+    # Set as default
+    if auth_service.set_default_credentials(name):
+        console.print(f"[green]Set '{name}' as the default credentials.[/green]")
+
+        # Show the updated auth info
+        console.print()
+        auth_service.show_login_info()
+    else:
+        console.print(f"[red]Failed to set '{name}' as default credentials.[/red]")

ida_hcli-0.0.0/src/hcli/commands/auth/key/__init__.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+import rich_click as click
+
+from hcli.commands.auth.key.create import create
+from hcli.commands.auth.key.install import install_key
+from hcli.commands.auth.key.list import list_keys
+from hcli.commands.auth.key.revoke import revoke
+from hcli.commands.auth.key.uninstall import uninstall_key
+
+
+@click.group()
+def key() -> None:
+    """API key management."""
+    pass
+
+
+key.add_command(create)
+key.add_command(list_keys, name="list")
+key.add_command(revoke)
+key.add_command(install_key)
+key.add_command(uninstall_key)

ida_hcli-0.0.0/src/hcli/commands/auth/key/create.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import sys
+
+import questionary
+import rich_click as click
+
+from hcli.commands.common import safe_ask_async
+from hcli.lib.api.keys import keys
+from hcli.lib.auth import get_auth_service
+from hcli.lib.commands import async_command, require_auth
+from hcli.lib.console import console
+
+
+@click.command()
+@click.argument("name", required=False)
+@require_auth
+@async_command
+async def create(name: str | None) -> None:
+    """Create a new API key."""
+    console.print("[yellow]The key will be displayed only once, so make sure to save it in a secure place.[/yellow]")
+
+    # Get the key name from argument or prompt
+    key_name = name or await safe_ask_async(questionary.text("Enter the name for this key", default="hcli"))
+    if not key_name:
+        console.print("[red]Key name is required[/red]")
+        return
+
+    try:
+        # Check if a key with the same name already exists
+        existing_keys = await keys.get_keys()
+        if any(k.name == key_name for k in existing_keys):
+            console.print(f"[red]An API key with name [underline]{key_name}[/underline] already exists.[/red]")
+            sys.exit(1)
+
+        # Confirm key creation
+        if not await safe_ask_async(questionary.confirm(f"Do you want to create a new API key {key_name}?")):
+            console.print("[yellow]Key creation cancelled.[/yellow]")
+            return
+
+        # Create the key
+        console.print(f"[blue]Creating API key '[bold]{key_name}[/bold]'...[/blue]")
+        token = await keys.create_key(key_name)
+        console.print(f"[green]API key created:[/green] [bold]{token}[/bold]")
+
+        # Ask if user wants to install this key for hcli
+        if await safe_ask_async(questionary.confirm("Do you want to use this key for hcli?")):
+            auth_service = get_auth_service()
+            auth_service.init()
+
+            console.print("[blue]Installing API key as credentials...[/blue]")
+            source = await auth_service.add_api_key_credentials(key_name, token)
+
+            if source:
+                sources_count_before = len(auth_service.list_credentials()) - 1
+
+                if sources_count_before == 0:
+                    # First credentials - simplified message
+                    console.print(f"[green]API key credentials installed for {source.email}[/green]")
+                else:
+                    # Additional credentials - detailed message
+                    console.print(f"[green]API key credentials '{source.name}' created successfully![/green]")
+                    console.print(f"Email: {source.email}")
+
+                    # Ask if user wants to set as default
+                    set_default = await safe_ask_async(
+                        questionary.confirm(f"Set '{source.name}' as the default credentials?", default=True)
+                    )
+                    if set_default:
+                        auth_service.set_default_credentials(source.name)
+                        console.print(f"[green]'{source.name}' set as default credentials.[/green]")
+            else:
+                console.print("[red]Failed to create credentials. The API key may be invalid.[/red]")
+
+    except Exception as e:
+        console.print(f"[red]Failed to create API key: {e}[/red]")
+        sys.exit(1)