Improved module path discovery when source-roots are not specified

.github/workflows/changelog.yml

@@ -28,7 +28,7 @@ jobs:
           fetch-depth: 0
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true

.github/workflows/checks.yaml

@@ -36,7 +36,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true
@@ -92,7 +92,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true
@@ -133,7 +133,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true
@@ -161,7 +161,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true

.github/workflows/primer-test.yaml

@@ -30,15 +30,15 @@ jobs:
     timeout-minutes: 5
     strategy:
       matrix:
-        python-version: [3.9, "3.10", "3.11", "3.12"]
+        python-version: [3.9, "3.10", "3.11", "3.12", "3.13-dev"]
     outputs:
       python-key: ${{ steps.generate-python-key.outputs.key }}
     steps:
       - name: Check out code from GitHub
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -72,13 +72,13 @@ jobs:
     needs: prepare-tests-linux
     strategy:
       matrix:
-        python-version: [3.9, "3.10", "3.11", "3.12"]
+        python-version: [3.9, "3.10", "3.11", "3.12", "3.13-dev"]
     steps:
       - name: Check out code from GitHub
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true

.github/workflows/primer_comment.yaml

@@ -33,7 +33,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true

.github/workflows/primer_run_main.yaml

@@ -37,7 +37,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -83,7 +83,7 @@ jobs:
           . venv/bin/activate
           python tests/primer/__main__.py prepare --clone
       - name: Upload commit string
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         if: matrix.batchIdx == 0
         with:
           name: primer_commitstring_${{ matrix.python-version }}
@@ -104,7 +104,7 @@ jobs:
           then echo "::warning ::$WARNINGS"
           fi
       - name: Upload output
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name:
             primer_output_main_${{ matrix.python-version }}_batch${{ matrix.batchIdx }}

.github/workflows/primer_run_pr.yaml

@@ -48,7 +48,7 @@ jobs:
           fetch-depth: 0
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -178,15 +178,15 @@ jobs:
           then echo "::warning ::$WARNINGS"
           fi
       - name: Upload output of PR
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name:
             primer_output_pr_${{ matrix.python-version }}_batch${{ matrix.batchIdx }}
           path:
             tests/.pylint_primer_tests/output_${{ matrix.python-version }}_pr_batch${{
             matrix.batchIdx }}.txt
       - name: Upload output of 'main'
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name:
             primer_output_main_${{ matrix.python-version }}_batch${{ matrix.batchIdx }}
@@ -199,7 +199,7 @@ jobs:
       - name: Upload PR number
         if:
           startsWith(steps.python.outputs.python-version, '3.9') && matrix.batchIdx == 0
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name: pr_number
           path: pr_number.txt

.github/workflows/release.yml

@@ -23,7 +23,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true

.github/workflows/tests.yaml

@@ -31,15 +31,15 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.9, "3.10", "3.11", "3.12"]
+        python-version: [3.9, "3.10", "3.11", "3.12", "3.13-dev"]
     outputs:
       python-key: ${{ steps.generate-python-key.outputs.key }}
     steps:
       - name: Check out code from GitHub
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -76,7 +76,7 @@ jobs:
           pip list | grep 'astroid\|pylint'
           python -m pytest -vv --minimal-messages-config tests/test_functional.py
       - name: Upload coverage artifact
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name: coverage-${{ matrix.python-version }}
           path: .coverage
@@ -91,7 +91,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python 3.12
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: "3.12"
           check-latest: true
@@ -131,7 +131,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -160,7 +160,7 @@ jobs:
         run: >-
           echo "datetime="$(date "+%Y%m%d_%H%M") >> $GITHUB_OUTPUT
       - name: Upload benchmark artifact
-        uses: actions/upload-artifact@v4.3.4
+        uses: actions/upload-artifact@v4.3.6
         with:
           name:
             benchmark-${{ runner.os }}-${{ matrix.python-version }}_${{
@@ -175,7 +175,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.9, "3.10", "3.11", "3.12"]
+        python-version: [3.9, "3.10", "3.11", "3.12", "3.13-dev"]
     steps:
       - name: Set temp directory
         run: echo "TEMP=$env:USERPROFILE\AppData\Local\Temp" >> $env:GITHUB_ENV
@@ -185,7 +185,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -231,7 +231,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true
@@ -275,7 +275,7 @@ jobs:
         uses: actions/checkout@v4.1.7
       - name: Set up Python ${{ matrix.python-version }}
         id: python
-        uses: actions/setup-python@v5.1.1
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
             doc/data/messages/m/missing-final-newline/bad/crlf.py
           )$
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.5.2"
+    rev: "v0.6.2"
     hooks:
       - id: ruff
         args: ["--fix"]
@@ -45,7 +45,7 @@ repos:
       - id: isort
         exclude: doc/data/messages/
   - repo: https://github.com/psf/black
-    rev: 24.4.2
+    rev: 24.8.0
     hooks:
       - id: black
         args: [--safe, --quiet]
@@ -127,9 +127,9 @@ repos:
       - id: rstcheck
         args: ["--report-level=warning"]
         files: ^(doc/(.*/)*.*\.rst)
-        additional_dependencies: [Sphinx==5.0.1]
+        additional_dependencies: [Sphinx==7.4.3]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.1
+    rev: v1.11.2
     hooks:
       - id: mypy
         name: mypy

.pyenchant_pylint_custom_dict.txt

@@ -249,6 +249,7 @@ paren
 parens
 passthru
 pathlib
+patternerror
 positionals
 png
 pragma

README.rst

@@ -12,7 +12,7 @@
     :target: https://codecov.io/gh/pylint-dev/pylint
 
 .. image:: https://img.shields.io/pypi/v/pylint.svg
-    :alt: Pypi Package version
+    :alt: PyPI Package version
     :target: https://pypi.python.org/pypi/pylint
 
 .. image:: https://readthedocs.org/projects/pylint/badge/?version=latest
@@ -81,7 +81,7 @@ It can also be integrated in most editors or IDEs. More information can be found
 What differentiates Pylint?
 ---------------------------
 
-Pylint is not trusting your typing and is inferring the actual value of nodes (for a
+Pylint is not trusting your typing and is inferring the actual values of nodes (for a
 start because there was no typing when pylint started off) using its internal code
 representation (astroid). If your code is ``import logging as argparse``, Pylint
 can check and know that ``argparse.error(...)`` is in fact a logging call and not an
@@ -123,7 +123,7 @@ ecosystem of existing plugins for popular frameworks and third-party libraries.
 .. _`plugins`: https://pylint.readthedocs.io/en/latest/development_guide/how_tos/plugins.html#plugins
 .. _`pylint-pydantic`: https://pypi.org/project/pylint-pydantic
 .. _`pylint-django`: https://github.com/pylint-dev/pylint-django
-.. _`pylint-sonarjson`: https://github.com/omegacen/pylint-sonarjson
+.. _`pylint-sonarjson`: https://github.com/cnescatlab/pylint-sonarjson-catlab
 
 Advised linters alongside pylint
 --------------------------------
@@ -135,7 +135,7 @@ mypy_, pyright_ / pylance or pyre_ (typing checks), bandit_ (security oriented c
 isort_ (auto-formatting), autoflake_ (automated removal of unused imports or variables), pyupgrade_
 (automated upgrade to newer python syntax) and pydocstringformatter_ (automated pep257).
 
-.. _ruff: https://github.com/charliermarsh/ruff
+.. _ruff: https://github.com/astral-sh/ruff
 .. _flake8: https://github.com/PyCQA/flake8
 .. _bandit: https://github.com/PyCQA/bandit
 .. _mypy: https://github.com/python/mypy

doc/data/messages/t/too-many-positional-arguments/bad.py

@@ -0,0 +1,5 @@
+class FiveArgumentMethods:
+    """The max positional arguments default is 5."""
+
+    def take_five_args(self, a, b, c, d, e):  # [too-many-positional-arguments]
+        pass

doc/data/messages/t/too-many-positional-arguments/details.rst

@@ -0,0 +1,10 @@
+Positional arguments work well for cases where the the use cases are
+self-evident, such as unittest's ``assertEqual(first, second, msg=None)``.
+Comprehensibility suffers beyond a handful of arguments, though, so for
+functions that take more inputs, require that additional arguments be
+passed by *keyword only* by preceding them with ``*``:
+
+.. code-block:: python
+
+    def make_noise(self, volume, *, color=noise.PINK, debug=True):
+        ...

doc/data/messages/t/too-many-positional-arguments/good.py

@@ -0,0 +1,5 @@
+class FiveArgumentMethods:
+    """The max positional arguments default is 5."""
+
+    def take_five_args(self, a, b, c, d, *, e=False):
+        pass

doc/data/messages/t/too-many-positional-arguments/pylintrc

@@ -0,0 +1,2 @@
+[MESSAGES CONTROL]
+disable=too-many-arguments

doc/data/messages/u/using-assignment-expression-in-unsupported-version/bad.py

@@ -0,0 +1,5 @@
+import random
+
+# +1: [using-assignment-expression-in-unsupported-version]
+if zero_or_one := random.randint(0, 1):
+    assert zero_or_one == 1

doc/data/messages/u/using-assignment-expression-in-unsupported-version/details.rst

@@ -0,0 +1 @@
+The assignment expression (walrus) operator (`:=`) was introduced in Python 3.8; to use it, please use a more recent version of Python.

doc/data/messages/u/using-assignment-expression-in-unsupported-version/good.py

@@ -0,0 +1,5 @@
+import random
+
+zero_or_one = random.randint(0, 1)
+if zero_or_one:
+    assert zero_or_one == 1

doc/data/messages/u/using-assignment-expression-in-unsupported-version/pylintrc

@@ -0,0 +1,2 @@
+[main]
+py-version=3.7

doc/data/messages/u/using-positional-only-args-in-unsupported-version/bad.py

@@ -0,0 +1,2 @@
+def add(x, y, /):  # [using-positional-only-args-in-unsupported-version]
+    return x + y

doc/data/messages/u/using-positional-only-args-in-unsupported-version/details.rst

@@ -0,0 +1 @@
+Positional-only arguments were introduced in Python 3.8; to use them, please use a more recent version of Python.

doc/data/messages/u/using-positional-only-args-in-unsupported-version/good.py

@@ -0,0 +1,3 @@
+# pylint: disable=missing-function-docstring, missing-module-docstring
+def add(x, y):
+    return x + y

doc/data/messages/u/using-positional-only-args-in-unsupported-version/pylintrc

@@ -0,0 +1,2 @@
+[main]
+py-version=3.7

doc/development_guide/contributor_guide/index.rst

@@ -12,5 +12,6 @@ The contributor guide will help you if you want to contribute to pylint itself.
    contribute
    tests/index
    profiling
+   oss_fuzz
    release
    governance