knitpkg-mt 1.0.0__tar.gz

knitpkg_mt-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Douglas Rechia
+
+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.

knitpkg_mt-1.0.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: knitpkg-mt
+Version: 1.0.0
+Summary: KnitPkg for MetaTrader – Professional package manager for MQL5/MQL4
+License: MIT
+License-File: LICENSE
+Author: Douglas Rechia
+Author-email: rechia@gmail.com
+Requires-Python: >=3.13,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: chardet (>=5.2.0,<6.0.0)
+Requires-Dist: click (>=8.3.1,<9.0.0)
+Requires-Dist: gitpython (>=3.1.45,<4.0.0)
+Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
+Requires-Dist: keyring (>=25.7.0,<26.0.0)
+Requires-Dist: packaging (>=25.0,<26.0)
+Requires-Dist: pydantic (>=2.12.5,<3.0.0)
+Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
+Requires-Dist: rich (>=14.2.0,<15.0.0)
+Requires-Dist: ruamel-yaml (>=0.19.1,<0.20.0)
+Requires-Dist: semver (>=3.0.4,<4.0.0)
+Requires-Dist: typer[all] (>=0.20.0,<0.21.0)
+Description-Content-Type: text/markdown
+
+# KnitPkg for MetaTrader (`kp`)
+
+**A modern package & project manager for MQL5/MQL4 — built for real-world MetaTrader development.**
+
+**KnitPkg** is a modern **package and project manager for MQL5/MQL4**, bringing an *npm-like* dependency workflow to real-world MetaTrader development.
+
+MetaTrader projects often evolve through manual copy/paste, ad-hoc folder sharing, and “it works on my machine” dependency drift. KnitPkg exists to fix that by making code reuse and collaboration **predictable, reproducible, and automated**—without changing how MQL developers already publish code (Git repos).
+
+- Home page: [knitpkg.dev](https://knitpkg.dev)  
+- Documentation: [docs.knitpkg.dev](https://docs.knitpkg.dev)
+- Registry: [registry.knitpkg.dev](https://registry.knitpkg.dev)
+
+---
+
+## What KnitPkg is
+
+KnitPkg is built around a **Git-first** model:
+
+- Your code lives in **Git repositories** (Mql5Forge, GitHub, GitLab, Bitbucket).
+- KnitPkg acts as a **metadata registry** that indexes projects via their manifests (it does **not** host your source or binaries).
+- A **CLI tool** installs dependencies, resolves versions (SemVer + ranges), generates reproducible installs via a lock file, and can automate compilation.
+
+The public registry API is available and currently operational.
+
+## Why developers use KnitPkg
+
+KnitPkg focuses on the pain points that show up fast in MQL development:
+
+- **Versioned dependencies** (SemVer + ranges like `^`, `~`, `<`, `>`, `*`, `!=`)
+- **Reproducible builds** with a lock file
+- **Composed packages** (dependency trees), including helpers like autocomplete and `@knitpkg:include`
+- **Safe ecosystem maintenance** with *yanked* versions (removed from range resolution without breaking history)
+- **Git-host login via OAuth** for publishing (no extra KnitPkg account); public installs need no auth
+
+---
+## Installation
+
+Follow the [Installation section](https://docs.knitpkg.dev/installation/) of KnitPkg Documentation.
+
+---
+
+## Explore Seed Projects (Examples by the Author)
+
+If you want real-world examples of how KnitPkg projects and reusable packages can be structured, you can explore the author’s public “seed” projects in the registry.
+
+### Option A) Search using the CLI
+
+**MQL5 seeds:**
+
+```bash
+kp search mql5 -o douglasrechia
+```
+
+**MQL4 seeds:**
+
+```bash
+kp search mql4 -o douglasrechia
+```
+
+From the results, you can inspect details with `kp info`, or fetch and compile a project locally with `kp get`. <br>
+
+### Option B) Browse the registry website
+
+As an alternative, you can browse the registry directly in your browser:
+
+- **MQL5 seeds:** [registry.knitpkg.dev/mql5?org=douglasrechia](https://registry.knitpkg.dev/mql5?org=douglasrechia)
+- **MQL4 seeds:** [registry.knitpkg.dev/mql4?org=douglasrechia](https://registry.knitpkg.dev/mql4?org=douglasrechia)
+
+
+See [Getting started](https://docs.knitpkg.dev/getting-started/) for a quick introduction and first steps using KnitPkg.
+
+
+---
+
+## Support the Project
+
+KnitPkg aims to strengthen the MQL ecosystem with better tooling. You can help keep the CLI and the **public registry** running by:
+
+- Giving the repo a **GitHub star**
+- Donating via **GitHub Sponsors / Donations** (not yet available)
+
+---
+
+**KnitPkg — The dependency manager MQL always needed**
+
+[Home page](https://knitpkg.dev/) - [Browse Registry](https://registry.knitpkg.dev/)
+
+[X/Twitter](https://x.com/knitpkg) - [GitHub](https://github.com/knitpkg-dev/knitpkg-mt.git) - [Join Discord](https://discord.gg/bWvWpjw5m4) - [contact@knitpkg.dev](mailto:contact@knitpkg.dev)
+
+MIT Licensed — Forever free for the community
+
+**KnitPkg – The future of MQL5 development.**
+
+---
+
+**DISCLAIMER:**  
+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.
+
+

knitpkg_mt-1.0.0/README.md

@@ -0,0 +1,98 @@
+# KnitPkg for MetaTrader (`kp`)
+
+**A modern package & project manager for MQL5/MQL4 — built for real-world MetaTrader development.**
+
+**KnitPkg** is a modern **package and project manager for MQL5/MQL4**, bringing an *npm-like* dependency workflow to real-world MetaTrader development.
+
+MetaTrader projects often evolve through manual copy/paste, ad-hoc folder sharing, and “it works on my machine” dependency drift. KnitPkg exists to fix that by making code reuse and collaboration **predictable, reproducible, and automated**—without changing how MQL developers already publish code (Git repos).
+
+- Home page: [knitpkg.dev](https://knitpkg.dev)  
+- Documentation: [docs.knitpkg.dev](https://docs.knitpkg.dev)
+- Registry: [registry.knitpkg.dev](https://registry.knitpkg.dev)
+
+---
+
+## What KnitPkg is
+
+KnitPkg is built around a **Git-first** model:
+
+- Your code lives in **Git repositories** (Mql5Forge, GitHub, GitLab, Bitbucket).
+- KnitPkg acts as a **metadata registry** that indexes projects via their manifests (it does **not** host your source or binaries).
+- A **CLI tool** installs dependencies, resolves versions (SemVer + ranges), generates reproducible installs via a lock file, and can automate compilation.
+
+The public registry API is available and currently operational.
+
+## Why developers use KnitPkg
+
+KnitPkg focuses on the pain points that show up fast in MQL development:
+
+- **Versioned dependencies** (SemVer + ranges like `^`, `~`, `<`, `>`, `*`, `!=`)
+- **Reproducible builds** with a lock file
+- **Composed packages** (dependency trees), including helpers like autocomplete and `@knitpkg:include`
+- **Safe ecosystem maintenance** with *yanked* versions (removed from range resolution without breaking history)
+- **Git-host login via OAuth** for publishing (no extra KnitPkg account); public installs need no auth
+
+---
+## Installation
+
+Follow the [Installation section](https://docs.knitpkg.dev/installation/) of KnitPkg Documentation.
+
+---
+
+## Explore Seed Projects (Examples by the Author)
+
+If you want real-world examples of how KnitPkg projects and reusable packages can be structured, you can explore the author’s public “seed” projects in the registry.
+
+### Option A) Search using the CLI
+
+**MQL5 seeds:**
+
+```bash
+kp search mql5 -o douglasrechia
+```
+
+**MQL4 seeds:**
+
+```bash
+kp search mql4 -o douglasrechia
+```
+
+From the results, you can inspect details with `kp info`, or fetch and compile a project locally with `kp get`. <br>
+
+### Option B) Browse the registry website
+
+As an alternative, you can browse the registry directly in your browser:
+
+- **MQL5 seeds:** [registry.knitpkg.dev/mql5?org=douglasrechia](https://registry.knitpkg.dev/mql5?org=douglasrechia)
+- **MQL4 seeds:** [registry.knitpkg.dev/mql4?org=douglasrechia](https://registry.knitpkg.dev/mql4?org=douglasrechia)
+
+
+See [Getting started](https://docs.knitpkg.dev/getting-started/) for a quick introduction and first steps using KnitPkg.
+
+
+---
+
+## Support the Project
+
+KnitPkg aims to strengthen the MQL ecosystem with better tooling. You can help keep the CLI and the **public registry** running by:
+
+- Giving the repo a **GitHub star**
+- Donating via **GitHub Sponsors / Donations** (not yet available)
+
+---
+
+**KnitPkg — The dependency manager MQL always needed**
+
+[Home page](https://knitpkg.dev/) - [Browse Registry](https://registry.knitpkg.dev/)
+
+[X/Twitter](https://x.com/knitpkg) - [GitHub](https://github.com/knitpkg-dev/knitpkg-mt.git) - [Join Discord](https://discord.gg/bWvWpjw5m4) - [contact@knitpkg.dev](mailto:contact@knitpkg.dev)
+
+MIT Licensed — Forever free for the community
+
+**KnitPkg – The future of MQL5 development.**
+
+---
+
+**DISCLAIMER:**  
+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.
+

knitpkg_mt-1.0.0/knitpkg/cli.py

@@ -0,0 +1,104 @@
+# knitpkg/cli.py
+"""
+Main CLI entry point for KnitPkg for MetaTrader.
+
+Automatically loads all commands from knitpkg.commands and extensions.
+"""
+
+import importlib
+import pkgutil
+from types import ModuleType
+
+import typer
+from rich.console import Console
+
+from knitpkg.core.cli_version import get_package_version
+
+
+app = typer.Typer(
+    name="KnitPkg for MetaTrader",
+    help="KnitPkg for MetaTrader - Professional package manager for MQL5/MQL4",
+    add_completion=False,
+    no_args_is_help=True,
+)
+
+loaded_commands = set()
+
+# -------------------------------------------------------------------
+# Dynamic command loading utilities
+# -------------------------------------------------------------------
+def _load_commands_from_package(package_name: str) -> None:
+    """
+    Import all submodules from a package and call register(app) on each module that defines it.
+    """
+    try:
+        pkg = importlib.import_module(package_name)
+    except ImportError:
+        return
+
+    # Register the package itself if it has a register function
+    _register_if_available(pkg)
+
+    # Register all submodules
+    for finder, mod_name, is_pkg in pkgutil.iter_modules(pkg.__path__, pkg.__name__ + "."):
+        if mod_name in loaded_commands:
+            continue
+        try:
+            mod = importlib.import_module(mod_name)
+        except ImportError:
+            continue
+        _register_if_available(mod)
+        loaded_commands.add(mod_name)
+
+
+def _register_if_available(mod: ModuleType) -> None:
+    """
+    Call register(app) on the module if the function exists.
+    """
+    register_func = getattr(mod, "register", None)
+    if callable(register_func):
+        register_func(app)
+
+
+# -------------------------------------------------------------------
+# Load optional PRO commands
+# -------------------------------------------------------------------
+_load_commands_from_package("knitpkg.commands.pro")
+
+# -------------------------------------------------------------------
+# Load standard commands
+# -------------------------------------------------------------------
+_load_commands_from_package("knitpkg.commands")
+
+# -------------------------------------------------------------------
+# Main callback (version)
+# -------------------------------------------------------------------
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-v",
+        help="Show the version of KnitPkg for MetaTrader and exit.",
+        callback=lambda value: _version_callback(value),
+        is_eager=True,
+    )
+):
+    """
+    KnitPkg for MetaTrader CLI.
+    """
+    pass
+
+
+def _version_callback(value: bool):
+    if value:
+        console = Console(log_path=False)
+        current_version = get_package_version()
+        console.print(
+            f"[bold green]KnitPkg for MetaTrader[/] version [cyan]{current_version}[/]"
+        )
+        raise typer.Exit()
+
+
+if __name__ == "__main__":
+    app()

knitpkg_mt-1.0.0/knitpkg/commands/add.py

@@ -0,0 +1,93 @@
+from typing import Optional
+from pathlib import Path
+import typer
+from rich.console import Console
+
+from knitpkg.core.registry import Registry
+from knitpkg.core.global_config import get_registry_url
+from knitpkg.core.project_manager import ProjectManager
+from knitpkg.core.exceptions import KnitPkgError, RegistryError
+
+# ==============================================================
+# COMMAND WRAPPER
+# ==============================================================
+
+def add_command(project_name: str, verspec: Optional[str], project_dir: Path, console: Console, verbose: bool):
+    """Command wrapper for add command."""
+
+    project_path = Path(project_dir).resolve()
+
+    registry_url = get_registry_url()
+    registry: Registry = Registry(registry_url, console=console, verbose=verbose)
+
+    project_manager: ProjectManager = ProjectManager(project_path, registry, console, True if verbose else False)
+    project_manager.add_dependency(project_name, verspec)
+
+
+def register(app):
+    """Register the add command with the main Typer app."""
+
+    @app.command()
+    def add(
+        project_name: str = typer.Argument(
+            ...,
+            help="Name of the project to add as a dependency"
+        ),
+        verspec: Optional[str] = typer.Option(
+            '*',
+            "--verspec",
+            "-v",
+            help="Version specifier for the dependency"
+        ),
+        project_dir: Optional[Path] = typer.Option(
+            None,
+            "--project-dir",
+            "-d",
+            help="Project directory (default: current directory)"
+        ),
+        verbose: Optional[bool] = typer.Option(
+            False,
+            "--verbose",
+            help="Show detailed output"
+        )
+    ):
+        """Add a dependency to the current project."""
+
+        console: Console = Console(log_path=False)
+
+        from knitpkg.core.console import ConsoleAware
+        console_awr = ConsoleAware(console=console, verbose=True if verbose else False)
+
+        try:
+            console_awr.print("")
+            project_dir = project_dir if project_dir is not None else Path.cwd()
+            add_command(project_name, verspec, project_dir,
+                       console=console,
+                       verbose=True if verbose else False)
+            from knitpkg.core.telemetry import print_telemetry_warning
+            print_telemetry_warning(project_dir)
+            console_awr.print("")
+
+        except KeyboardInterrupt:
+            console_awr.print("\n[bold yellow]⚠️  Add cancelled by user.[/bold yellow]")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+
+        except RegistryError as e:
+            console_awr.print(f"\n[bold red]❌ Registry error:[/bold red] {e}. Reason: {e.reason} ")
+            if verbose:
+                console_awr.log(f"  Status Code: {e.status_code}")
+                console_awr.log(f"  Error type: {e.error_type}")
+                console_awr.log(f"  Request URL: {e.request_url}")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+
+        except KnitPkgError as e:
+            console_awr.print(f"\n[bold red]❌ Add failed:[/bold red] {e}")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+
+        except Exception as e:
+            console_awr.print(f"\n[bold red]❌ Unexpected error:[/bold red] {e}")
+            console_awr.print("")
+            raise typer.Exit(code=1)

knitpkg_mt-1.0.0/knitpkg/commands/autocomplete.py

@@ -0,0 +1,87 @@
+# knitpkg/commands/autocomplete.py
+
+"""
+KnitPkg for MetaTrader autocomplete command — generates autocomplete files.
+
+This module handles the generation of MQL include files that provide
+autocomplete functionality for KnitPkg-managed packages within MetaEditor.
+"""
+from pathlib import Path
+from typing import Optional
+import typer
+from rich.console import Console
+
+from knitpkg.mql.autocomplete import AutocompleteTools
+from knitpkg.core.exceptions import KnitPkgError, RegistryError
+
+# ==============================================================
+# COMMAND WRAPPER
+# ==============================================================
+
+def autocomplete_command(project_dir: Path, console: Console, verbose: bool):
+    """Command wrapper"""
+    generator = AutocompleteTools(project_dir, console, verbose)
+    generator.generate_autocomplete()
+
+# ==============================================================
+# CLI REGISTRATION
+# ==============================================================
+
+def register(app):
+    """Register the autocomplete command with the Typer app."""
+
+    @app.command()
+    def autocomplete(
+        project_dir: Optional[Path] = typer.Option(
+            None,
+            "--project-dir",
+            "-d",
+            help="Project directory (default: current directory)"
+        ),
+        verbose: Optional[bool] = typer.Option(
+            False,
+            "--verbose",
+            help="Show detailed output"
+        )
+    ):
+        """Generate autocomplete.mqh for MetaEditor for package development."""
+        if project_dir is None:
+            project_dir = Path.cwd()
+        else:
+            project_dir = Path(project_dir).resolve()
+
+        console = Console(log_path=False)
+        
+        from knitpkg.core.console import ConsoleAware
+        console_awr = ConsoleAware(console=console, verbose=True if verbose else False)
+        
+        try:
+            console_awr.print("")
+            autocomplete_command(project_dir, console, True if verbose else False)
+            from knitpkg.core.telemetry import print_telemetry_warning
+            print_telemetry_warning(project_dir)
+            console_awr.print("")
+            
+        except KeyboardInterrupt:
+            console_awr.print("\n[bold yellow]⚠️  Autocomplete generation cancelled by user.[/bold yellow]")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+
+        except RegistryError as e:
+            console_awr.print(f"\n[bold red]❌ Registry error:[/bold red] {e}. Reason: {e.reason} ")
+            if verbose:
+                console_awr.log(f"  Status Code: {e.status_code}")
+                console_awr.log(f"  Error type: {e.error_type}")
+                console_awr.log(f"  Request URL: {e.request_url}")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+        
+        except KnitPkgError as e:
+            console_awr.print(f"\n[bold red]❌ Autocomplete generation failed:[/bold red] {e}")
+            console_awr.print("")
+            raise typer.Exit(code=1)
+        
+        except Exception as e:
+            console_awr.print(f"\n[bold red]❌ Unexpected error:[/bold red] {e}")
+            console_awr.print("")
+            raise typer.Exit(code=1)