Skip to main content

MKDF – Make Directories and Files

PyPI Python 3.10+ Poetry FastAPI SQLite AGPL Release Issues Cherish your git flow or perish Survived rm -rf *


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.
  • 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 — Free as in freedom, not as in SaaS-taking.
Commercial/SaaS use? license@buildme.it


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

Metadata

Release files for mkdf 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mkdf 0.1.2
File Size Uploaded
mkdf-0.1.2.tar.gz 71.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mkdf 0.1.2
File Interpreter ABI Platform
mkdf-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 205.8 kB

Release files / mkdf-0.1.2.tar.gz

Download URL mkdf-0.1.2.tar.gz
Size 71.2 kB
Tags Source
SHA-256 checksum
How to use checksums
813de66286acf71a2ac00c624ca45b3dade48c849a4a791b51c16cccc7fcabdb
BLAKE2b-256 checksum
How to use checksums
69d9881dd43ebd0161de0c3ece5194a73ab4719dcf9441d1f5d27c9ac11262b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.10.12 Linux/6.6.87.2-microsoft-standard-WSL2

Release files / mkdf-0.1.2-py3-none-any.whl

Download URL mkdf-0.1.2-py3-none-any.whl
Size 134.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
04fe4779b6b4eeeae7e26d454b68e6cd0b13713678e7777d4f9c21eebfbc4ae0
BLAKE2b-256 checksum
How to use checksums
20b125a3faf422c2216af16179830aca46c366e2dc601ca07a4a117765efe4b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.10.12 Linux/6.6.87.2-microsoft-standard-WSL2

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page