pynudger

opennudge Python linter (naming conventions and other automated checks)

✨ Features 🚀 Quick start 📚 Documentation 🤝 Contribute 👍 Adopters 📜 Legal

Features

pynudger is an opinionated linter for Python projects, focused on naming conventions and making your code "more Pythonic".

• Length rules: Too long class/function names are flagged.
• Setters/getters: Discourages usage of setters/getters, encourages properties instead.
• No helpers/utils/commons/shared names: Incentivizes more descriptive and semantically coherent names for functionalities.

Table of contents

• Quick start
  • Installation
  • Usage
• Advanced
  • Configuration
  • Run as a pre-commit hook
  • Disable in code
  • Rules

Quick start

Installation

> pip install pynudger

Install pynudger[rich] for rich output, pynudger[mcp] for the MCP command, or pynudger[all] for both.

Usage

To check against the rules run the following from the command line:

> pynudger check

You can pass additional arguments to pynudger check, like files to check (by default all Python files in the current directory):

> pynudger check path/to/package single.py

Advanced

Configuration

You can configure individual pynudger rules in pyproject.toml (or .pynudger.toml in the root of your project, just remove the [tool.pynudger] prefix), for example:

[tool.pynudger.PYNUDGER44]
max_union_types = 4

Run as a pre-commit hook

pynudger can be used as a pre-commit hook, to add as a plugin:

repos:
-   repo: "https://github.com/open-nudge/pynudger"
    rev: ...  # select the tag or revision you want, or run `pre-commit autoupdate`
    hooks:
    -   id: "pynudger"

Disable in code

You can disable pynudger on a line-by-line basis (you have to specify exact code), e.g.:

def set_my_too_long_function_name():  # noqa: PYNUDGER0, PYNUDGER19
    pass

or a line span:

# noqa-start: PYNUDGER0, PYNUDGER19
def set_my_too_long_function_name():
    pass


def set_another_long_function():
    pass


# noqa-end: PYNUDGER0, PYNUDGER19


def set_will_error_out_this_time():
    pass

It is also possible to disable all checks in a file by placing the following somewhere in the file (preferably at the top):

# noqa-file: PYNUDGER0, PYNUDGER19

Rules

pynudger provides the following rules:

with the following configurable options (in pyproject.toml or .pynudger.toml):

Contribute

We welcome your contributions! Start here:

• Code of Conduct
• Contributing Guide
• Roadmap
• Changelog
• Report security vulnerabilities
• Open an Issue

Legal

• This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
• This project is copyrighted by open-nudge - the appropriate copyright notice is included in each file.