Skip to content
/ genvi Public

πŸπŸ§™ A sadistic Python project wizard

License

Notifications You must be signed in to change notification settings

ruksi/genvi

Repository files navigation

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.

About

πŸπŸ§™ A sadistic Python project wizard

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published