Metadata-Version: 2.3
Name: mkdf
Version: 0.1.2
Summary: Make Directories and Files - Professional Project Creator with Rich CLI and Web UI
License: AGPL-3.0
Keywords: cli,project-generator,docker,templates,development,rich,rainbow,web-ui
Author: Fassih Belmokhtar
Author-email: contact@fassih.ch
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: System :: Software Distribution
Requires-Dist: click (==8.1.7)
Requires-Dist: fastapi (>=0.104.0,<0.105.0)
Requires-Dist: psutil (>=5.9.5,<6.0.0)
Requires-Dist: pydantic (>=2.5.0,<3.0.0)
Requires-Dist: pydantic-settings (>=2.0.0,<3.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: rich (>=13.0.0,<14.0.0)
Requires-Dist: sqlmodel (>=0.0.14,<0.0.15)
Requires-Dist: typer (==0.9.0)
Requires-Dist: uvicorn[standard] (>=0.24.0,<0.25.0)
Project-URL: Bug Tracker, https://github.com/Noziop/mkdf-py/issues
Project-URL: Changelog, https://github.com/Noziop/mkdf-py/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/Noziop/mkdf#readme
Project-URL: Homepage, https://github.com/Noziop/mkdf
Project-URL: Repository, https://github.com/Noziop/mkdf
Description-Content-Type: text/markdown

# MKDF – Make Directories and Files

![PyPI](https://img.shields.io/pypi/v/mkdf)
![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue)
![Poetry](https://img.shields.io/badge/poetry-managed-blue)
![FastAPI](https://img.shields.io/badge/fastapi-async-green)
![SQLite](https://img.shields.io/badge/sqlite-embedded-lightgrey)
![AGPL](https://img.shields.io/badge/license-AGPL-blue)
![Release](https://img.shields.io/github/v/release/Noziop/mkdf?include_prereleases)
![Issues](https://img.shields.io/github/issues/Noziop/mkdf)
![Cherish your git flow or perish](https://img.shields.io/badge/Cherish%20your%20gitflow-or%20perish-red)
![Survived rm -rf *](https://img.shields.io/badge/SURVIVED-rm%20--rf%20*-red)

---

> **One command to create them all,  
> one command to find all ports & subnet,  
> and in the docker-compose bind them.**

---

## Why mkdf?

**You’re tired of boilerplate.**  
So was I.  
MKDF exists because we’re done wasting life on project scaffolding.  
Folders, files, docker combos: all automated.

_TL;DR: Type, hit enter, and mkdf does in milliseconds what took you hours. No bs, no fluff, no time to waste._

---

### New here? Start fast

```
mkdf --help
mkdf
mkdf create
```
And follow the prompts.

---

### Features (yes, already works)

- **CLI-first:** Type, hit enter, done.
- **Docker combos:** Auto port/subnet, compose-ready.
- **Templates:** React, Vue, FastAPI, Flask, Express, Laravel (+ soon).
- **Brace expansion:**  
  ```
  mkdf {api,utils}/test_{a,b}.py
  tree my-app
  ```
  (forests, not trees)

- **"God mode":**  
  ```
  mkdf create my-app fastapi vue redis traefik --backend-port 8080 --frontend-port 3000
  ```

---

## ⚡️ Status (v0.1.1 alpha)

- **Stable:** CLI, templates, docker combos, brace expansion.
- **WIP:** .env, backend, web UI (FastAPI+Vue).
- **Next:** Smart DB config, plugin system, cloud, PRs welcome.

---

## 🚀 Install

```
pip install mkdf
```

---

## 🛠 Usage

```
mkdf create my-f-api fastapi
mkdf my-app/{src/{api,models,services},docs/{README.md,INSTALL.md},tests/test_api.py,.env}
mkdf create my-stack docker fastapi vue redis traefik --backend-port 8080 --frontend-port 3000
tree -h my-stack
```

---

## Contribution & Feedback

- Bugs or 🚀 ideas? [Open an issue](https://github.com/Noziop/mkdf/issues).
- Use. Break. Contribute. PR. Fork. Yell.
- This is a tool *from a dev for devs*.  
  Feedback welcome (I’m done with solo rants).

---

## Docs

**WIP** — I’m rewriting all docs to reflect latest features.
*You want to help? Open a PR or hit me by issues!*

---

## License

[GNU AGPL v3.0](LICENSE) — Free as in freedom, not as in SaaS-taking.  
Commercial/SaaS use? [license@buildme.it](mailto:license@buildme.it)

---

> **Get shit done. Fast. Survive your next rm -rf.  
> mkdf — built by the person who needed it most.**

