Skip to content

Latest commit

 

History

History
97 lines (73 loc) · 3.02 KB

README.md

File metadata and controls

97 lines (73 loc) · 3.02 KB

workflow: ci license: MIT pre-commit: enabled code style: ruff class: wizard alignment: chaotic evil


genvi logo

O generation of vipers, how can ye, being evil, speak good things?
- Matthew 12:34


genvi — A sadistic Python project wizard 🐍🧙


⚡️ TL;DR: ⚡️

curl -fSL https://raw.githubusercontent.com/ruksi/genvi/main/magic/conjure.sh | bash
# and follow the instructions

Requirements

python>=3.8, git and make.

What?

"I would sacrifice anything for some good quality code." by Anonymous Principal Engineer 👩‍💻

genvi (generation of vipers 🐍) is a hyper-opinionated tool for creating Python projects. It's strict, maybe too strict, borderline evil.

Each new project is configured with:

🐈‍⬛ eery ruff format as the code style, single quoted
🪝 sadistic pre-commit hooks to enforce conventions
🪄 automagical GitHub actions to verify incoming pull requests
🧙 bewitching testing setup with pytest with 100% coverage requirement
✴️ occult project management though make for development
🫴 plethora of style and type checkers included in ruff and mypy

Why?

"Who would want to manage a project like this?" by Anonymous Gnu 🐃

Scratching my own itch, see ABOUT.md to learn more

Quick Setup

curl -fSL https://raw.githubusercontent.com/ruksi/genvi/main/magic/conjure.sh | bash

Manual Setup

  1. Choose a combined project/package name

  2. Clone this repository

    git clone git@github.com:ruksi/genvi.git artproject
    cd artproject
  3. Run the wizard and follow instruction

    python -m magic --name="artproject" --author="Arthur" --email="arthur@example.com"

License

This project is released under the MIT License.

Contributions

Sure, the README template should get you started as genvi itself works like the projects it generates.