Merge remote-tracking branch 'origin/main' into scientific-notation-formatting

Author: Pierre-Sassoulas

.coveragerc

@@ -7,10 +7,7 @@ include =
     pylint/*
 omit =
     */test/*
-exclude_lines =
-    # Re-enable default pragma
-    pragma: no cover
-
+exclude_also =
     # Debug-only code
     def __repr__
 
@@ -20,3 +17,6 @@ exclude_lines =
 
     # Abstract methods are not executed during pytest runs
     raise NotImplementedError()
+
+    # Fallback cases which should never be executed
+    raise AssertionError

.github/copilot-instructions.md

@@ -0,0 +1,255 @@
+# Pylint Development Instructions
+
+Always follow these instructions first and fallback to additional search and context
+gathering only if the information in these instructions is incomplete or found to be in
+error.
+
+## Issue Label Guidelines
+
+Before attempting to fix any issue, check the GitHub issue labels using the GitHub API:
+
+- If an issue is labeled with "Astroid", "Needs astroid update", "Needs astroid
+  constraint", or "Needs astroid Brain 🧠", **ONLY** create regression tests
+- Do **NOT** attempt to fix astroid-related issues as you cannot modify astroid from
+  this repository
+- For astroid-related issues, focus on creating comprehensive regression tests that
+  reproduce the problem
+- All other issues can be fixed normally following the standard development workflow
+
+## Development Environment Setup
+
+### Basic Installation
+
+Clone and set up pylint development environment:
+
+- `git clone https://github.com/pylint-dev/pylint` -- clone repository
+- `cd pylint` -- enter directory
+- `python3 -m venv venv` -- create virtual environment
+- `source venv/bin/activate` -- activate virtual environment (Linux/Mac)
+- `pip install -r requirements_test_min.txt` -- install test dependencies (~30 seconds)
+- `pip install -e .` -- install pylint in editable mode (~30-60 seconds)
+
+### Optional Setup Steps
+
+- `pre-commit install` -- enable pre-commit hooks for autoformatting
+- `pip install pre-commit` -- install pre-commit separately if needed
+
+### Astroid Development (if needed)
+
+If working on astroid changes:
+
+- `git clone https://github.com/pylint-dev/astroid.git` -- clone astroid
+- `pip install -e astroid/` -- install astroid in editable mode
+- `cd astroid/ && git switch my-astroid-dev-branch` -- switch to development branch
+
+## Running Tests
+
+### Core Test Commands
+
+- `pytest tests/test_functional.py -k test_functional` -- run functional tests (~60
+  seconds, NEVER CANCEL, set timeout to 120+ seconds)
+- `pytest tests/` -- run all tests (several minutes, NEVER CANCEL, set timeout to 300+
+  seconds)
+- `python3 -m pytest` -- run tests with local python
+- `pytest tests/test_check_parallel.py -v` -- quick test file (~2 seconds)
+
+### Specific Test Types
+
+- **Functional tests:**
+  `pytest "tests/test_functional.py::test_functional[missing_kwoa_py3]"` -- single
+  functional test (~1 second)
+- **Unit tests:** Located in `/tests/` directory, test specific pylint functionality
+- **Configuration tests:** In `/tests/config/functional/` for testing configuration
+  loading
+- **Primer tests:** `pytest -m primer_stdlib --primer-stdlib` -- test on stdlib for
+  crashes
+
+### Test with Coverage
+
+- `pytest tests/message/ --cov=pylint.message` -- run with coverage
+- `coverage html` -- generate HTML coverage report
+
+### Tox Usage (Optional)
+
+- `python -m tox` -- run all tox environments
+- `python -m tox -epy313` -- run Python 3.13 suite only
+- `python -m tox -epylint` -- run pylint on pylint's codebase
+- `python -m tox -eformatting` -- run formatting checks
+- `python -m tox --recreate` -- recreate environments (recommended)
+- `python -m tox -e py310 -- -k test_functional` -- run specific tests in tox
+
+## Documentation
+
+### Building Documentation
+
+- `make -C doc/ install-dependencies` -- install doc dependencies (~10 seconds)
+- `make -C doc/ html` -- build documentation (~3 minutes, NEVER CANCEL, set timeout to
+  300+ seconds)
+- `make -C doc/ clean` -- clean build files when starting from scratch
+- `tox -e docs` -- alternative way to build docs
+
+**Network dependency:** Documentation build requires internet access to fetch external
+inventories.
+
+## Validation and Quality Checks
+
+### Running Pylint on Code
+
+- `pylint --help` -- verify pylint installation works
+- `pylint --disable=all --enable=E,F pylint/` -- run pylint on itself for errors only
+  (~20 seconds)
+- `pylint --rcfile=pylintrc --fail-on=I path/to/your/changes.py` -- standard pylint run
+- `pylint --disable=all --enable=E,F,W path/to/your/changes.py` -- focus on errors and
+  warnings
+
+### Pre-commit and Formatting
+
+- `pre-commit run --all-files` -- run all formatting checks (requires network for
+  initial setup)
+- **Network dependency:** pre-commit may fail in isolated environments due to hook
+  downloads
+
+### Validation Test Scenarios
+
+Always test your changes with these validation scenarios:
+
+- `echo "def badFunction(): pass" > /tmp/test_sample.py && pylint --enable=C0103 /tmp/test_sample.py`
+  -- should find naming issues
+- `pylint --help` and `pylint --list-msgs | head -10` -- verify CLI functionality
+- `pylint --help-msg=C0103` -- should show invalid-name help
+- `pylint --rcfile=pylintrc --fail-on=I pylint/__init__.py` -- should get 10.00/10
+  rating
+
+## Writing Tests
+
+### Functional Tests
+
+Located in `/tests/functional/`, consists of `.py` test files with corresponding `.txt`
+expected output files:
+
+- Annotate lines where messages are expected:
+  `a, b, c = 1 # [unbalanced-tuple-unpacking]`
+- Multiple messages on same line:
+  `a, b, c = 1.test # [unbalanced-tuple-unpacking, no-member]`
+- Use offset syntax for special cases: `# +1: [singleton-comparison]`
+- **Run and update:**
+  `python tests/test_functional.py --update-functional-output -k "test_functional[test_name]"`
+
+### Test File Organization
+
+- **New checkers:** Create `new_checker_message.py` in `/tests/functional/n/`
+- **Extensions:** Place in `/tests/functional/ext/extension_name/`
+- **Regression tests:** Place in `/tests/r/regression/` with `regression_` prefix
+- **Configuration tests:** Place in `/tests/config/functional/`
+
+### Configuration Test Files
+
+Create `.result.json` files with configuration differences from standard config:
+
+```json
+{
+  "functional_append": {
+    "disable": [["a-message-to-be-added"]]
+  },
+  "jobs": 10
+}
+```
+
+## Codebase Structure
+
+```
+pylint/                    # Main package
+├── checkers/             # All pylint checkers (rules implementation)
+├── config/               # Configuration handling and parsing
+├── message/              # Message system and formatting
+├── reporters/            # Output formatters (text, json, etc.)
+├── testutils/            # Testing utilities and helpers
+└── extensions/           # Optional extensions and plugins
+
+tests/                     # Test suite
+├── functional/           # Functional test files (.py + .txt expected output)
+├── config/functional/    # Configuration functional tests
+├── r/regression/         # Regression tests
+├── test_*.py            # Unit tests
+└── regrtest_data/       # Test data files
+
+doc/                      # Documentation
+├── user_guide/          # User documentation
+├── development_guide/   # Developer and contributor documentation
+│   ├── contributor_guide/    # Setup, testing, contribution guidelines
+│   ├── technical_reference/  # Technical implementation details
+│   └── how_tos/             # Guides for custom checkers, plugins
+└── additional_tools/    # Tools documentation
+
+script/                   # Development utility scripts
+```
+
+### Key Files
+
+- `pyproject.toml` -- Main configuration (dependencies, build, tools)
+- `tox.ini` -- Multi-environment testing configuration
+- `.pre-commit-config.yaml` -- Code quality checks configuration
+- `pylintrc` -- Pylint's own configuration
+- `requirements_test_min.txt` -- Minimal test dependencies
+- `.gitignore` do not add the 'venv' inside the .gitignore, don't commit the venv in the
+  first place (humans add it to their global gitignore)
+
+## Creating New Checkers
+
+### Getting Started
+
+- `python script/get_unused_message_id_category.py` -- get next available message ID
+- Study existing checkers in `pylint/checkers/` for patterns
+- Read technical reference documentation in `doc/development_guide/technical_reference/`
+- Use `astroid.extract_node` for AST manipulation
+
+### Workflow
+
+1. Create checker class in appropriate `pylint/checkers/` file
+2. Add functional tests in `tests/functional/`
+3. Search existing code for warning message to find where logic exists
+4. Test with sample code to ensure functionality works
+
+## Pull Request Guidelines
+
+### Before Submitting
+
+- Use Python 3.8+ for development (required for latest AST parser and pre-commit hooks)
+- Write comprehensive commit messages relating to tracker issues
+- Keep changes small and separate consensual from opinionated changes
+- Add news fragment: `towncrier create <IssueNumber>.<type>`
+- Always launch `pre-commit run -a` before committing
+
+### Documentation Changes
+
+- Document non-trivial changes
+- Generate docs with `tox -e docs`
+- Maintainers may label issues `skip-news` if no changelog needed
+
+### Contribution Credits
+
+- Add emails/names to `script/.contributors_aliases.json` if using multiple identities
+
+## Critical Timing Information
+
+- **NEVER CANCEL:** All operations that show "NEVER CANCEL" may take significant time
+- **Full test suite:** 60+ seconds (set timeout to 120+ seconds)
+- **Documentation build:** 180 seconds (set timeout to 300+ seconds)
+- **Functional tests:** 60 seconds (set timeout to 120+ seconds)
+- **Pylint self-check:** 20 seconds (set timeout to 60+ seconds)
+- **Individual test files:** 1-15 seconds
+- **Installation steps:** 30-60 seconds each
+
+## Environment Limitations and Workarounds
+
+- **Network connectivity required:** Documentation build and pre-commit setup require
+  internet access
+- **Tox failures:** In isolated environments, use direct pytest and pip commands instead
+  of tox
+- **Import errors in self-check:** Some import errors when running pylint on itself are
+  expected (git dependencies not installed)
+- **Build environments:** Use direct pip/pytest commands when tox environments fail to
+  build
+
+Always validate your changes by running pylint on sample code to ensure functionality
+works correctly.

.github/workflows/backport.yml

@@ -25,14 +25,16 @@ jobs:
         )
       )
     steps:
-      - uses: actions/create-github-app-token@df432ceedc7162793a195dd1713ff69aefc7379e # v2.0.6
+      - uses: actions/create-github-app-token@a8d616148505b5069dccd32f177bb87d7f39123b # v2.1.1
         id: app-token
         with:
-          app-id: ${{ vars.APP_ID }}
+          app-id: ${{ vars.BACKPORT_APP_ID }}
           private-key: ${{ secrets.PRIVATE_KEY }}
           permission-contents: write # push branch to Github
           permission-pull-requests: write # create PR / add comment for manual backport
           permission-workflows: write # modify files in .github/workflows
-      - uses: tibdex/backport@9565281eda0731b1d20c4025c43339fb0a23812e # v2.0.4
+      - uses: pylint-dev/backport@94367840595495e101f9a31415897c05da1f08d9 # v2.1.1
         with:
           github_token: ${{ steps.app-token.outputs.token }}
+          user_name: ${{ vars.BACKPORT_USER_NAME }}
+          user_email: ${{ vars.BACKPORT_USER_EMAIL }}

.github/workflows/changelog.yml

@@ -21,14 +21,14 @@ jobs:
     timeout-minutes: 10
     steps:
       - name: Check out code from GitHub
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v5.0.0
         with:
           # `towncrier check` runs `git diff --name-only origin/main...`, which
           # needs a non-shallow clone.
           fetch-depth: 0
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.6.0
+        uses: actions/setup-python@v6.0.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true
@@ -41,7 +41,7 @@ jobs:
           $GITHUB_OUTPUT
       - name: Restore Python virtual environment
         id: cache-venv
-        uses: actions/[email protected].3
+        uses: actions/[email protected].4
         with:
           path: venv
           key: >-