Skip to content

TsukiNi22/ai-utils / skills/python/python-project

python-project

Verified

Set up a new Python project in Tsukini's way - a script, an application in the layout of his MAGIC project (src/main.py + app.py + const.py, Class/, tool/, data/, requirements.txt) or an installable package (src layout, __init__.py with the version and the public API, __main__.py, const.py with frozen dataclasses, exception.py with error codes, main() returning the exit code, pyproject.toml with a console command, pytest tests) - generated by scripts/new_project.py with the Xartania headers, then README / license / CI / git with the other skills. Use whenever the user wants to create, bootstrap or scaffold a Python project, package, tool or script project.

templates/package/exception.py

View on GitHub
{{HEADER:exception.py:Exception of the project: an error code (Error.*) and a context}}

##### Import #####
# Import that can't be in the try
from .const import ERROR

##### Class #####
class ProjectError(Exception):
    """
        Error of the project, with the code to exit with and a context
    """

    def __init__(self, message: str, code: int = ERROR.ACTION, info: str = "[None]") -> None:
        super().__init__(message)
        self.code = code # ERROR.FATAL | ERROR.LOCAL | ERROR.ACTION
        self.info = info # Context of the error (file, value...)

    def formated(self) -> str:
        # [Error] message -> info (same reading as the libutils exceptions)
        kind = "Fatal" if self.code == ERROR.FATAL else "Error"
        return f"[{kind}] {self.args[0]}" + ("" if self.info == "[None]" else f" -> {self.info}")
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall