pylint-per-file-ignores 3.2.0
A pylint plugin to ignore error codes per file.
Requires Python: <4,>=3.10
Keywords: pylint, plugin, quality, linter

[![REUSE status](https://api.reuse.software/badge/github.com/SAP/pylint-per-file-ignores)](https://api.reuse.software/info/github.com/SAP/pylint-per-file-ignores)


# Pylint Per File Ignores
This pylint plugin will enable per-file-ignores in your project!

The project was initially created by [christopherpickering](https://github.com/christopherpickering).

## Install
```
pip install pylint-per-file-ignores
```

## Add to Pylint Settings

**.pylintrc**
```ini
[MAIN]
load-plugins =
    pylint_per_file_ignores
```

**setup.cfg**
```ini
[pylint.MASTER]
load-plugins =
    pylint_per_file_ignores
```

**pyproject.toml**
```toml
[tool.pylint.main]
load-plugins = [
    "pylint_per_file_ignores",
]
```

## Usage
Add list of patterns and codes you would like to ignore.
The patterns are matched using [globs](https://docs.python.org/3/library/glob.html).


> Prior to v2.0.0, `pylint-per-file-ignores` did not use globs but regex.
> When migrating, please check your configuration carefully.

**.pylintrc**
```ini
[MESSAGES CONTROL]
per-file-ignores =
  /folder_1/*:missing-function-docstring,W0621,W0240,C0115
  file.py:C0116,E0001
```

**setup.cfg**
```ini
[pylint.MESSAGES CONTROL]
per-file-ignores =
  /folder_1/*:missing-function-docstring,W0621,W0240,C0115
  file.py:C0116,E0001
```

**pyproject.toml**
```toml
[tool.pylint.'messages control']
per-file-ignores = [
    "/folder_1/*:missing-function-docstring,W0621,W0240,C0115",
    "file.py:C0116,E0001"
]
```

## Development
This project uses `uv`.
To setup a venv for development use
`python3.14 -m venv venv && pip install uv && uv sync --all-groups && rm -rf venv/`.
Then use `source .venv/bin/activate` to activate your venv.

## Build and Publish
Execute the release action with the proper version.

## Support, Feedback, Contributing

This project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/SAP/pylint-per-file-ignores/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).

## Security / Disclosure
If you find any bug that may be a security problem, please follow our instructions at [in our security policy](https://github.com/SAP/pylint-per-file-ignores/security/policy) on how to report it. Please do not create GitHub issues for security-related doubts or problems.

## Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/SAP/.github/blob/main/CODE_OF_CONDUCT.md) at all times.

## Licensing

Copyright 2025 SAP SE or an SAP affiliate company and pylint-per-file-ignores contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/SAP/pylint-per-file-ignores).