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.


