Search for config files in parent dirs

Author: Felixoid

.pyenchant_pylint_custom_dict.txt

@@ -252,6 +252,7 @@ pylint
 pylintdict
 pylintrc
 pylint's
+pyproject
 pypy
 pyreverse
 pytest
@@ -305,6 +306,8 @@ subtree
 supcls
 superclass
 symilar
+symlink
+symlinks
 sys
 tbump
 tempfile

doc/user_guide/usage/run.rst

@@ -87,6 +87,8 @@ configuration file in the following order and uses the first one it finds:
    in on the command line.
 #. ``setup.cfg`` in the current working directory,
    providing it has at least one ``pylint.`` section
+#. Pylint will search for the ``pyproject.toml`` file up the directories hierarchy
+   until the root and will use the first met. Usually it placed in the project repository.
 #. If the current working directory is in a Python package, Pylint searches \
    up the hierarchy of Python packages until it finds a ``pylintrc`` file. \
    This allows you to specify coding standards on a module-by-module \

pylint/config/find_default_config_files.py

@@ -20,6 +20,24 @@
 CONFIG_NAMES = RC_NAMES + (Path("pyproject.toml"), Path("setup.cfg"))
 
 
+def _find_config_in_tree(path: Path) -> Path:
+    """Search for file pyproject.toml in the parent directories recursively. It resolves
+    symlinks, so if there is any symlink up in the tree, it does not respect them"""
+    current_dir = Path.cwd().resolve()
+    is_root = False
+    while not is_root:
+        if (current_dir / path).is_file():
+            return current_dir / path
+        is_root = (
+            current_dir == current_dir.parent
+            or (current_dir / ".git").is_dir()
+            or (current_dir / ".hg").is_dir()
+        )
+        current_dir = current_dir.parent
+
+    return current_dir
+
+
 def _toml_has_config(path: Path | str) -> bool:
     with open(path, mode="rb") as toml_handle:
         try:
@@ -42,6 +60,7 @@ def _cfg_has_config(path: Path | str) -> bool:
 def find_default_config_files() -> Iterator[Path]:
     """Find all possible config files."""
     for config_name in CONFIG_NAMES:
+        config_name = _find_config_in_tree(config_name)
         if config_name.is_file():
             if config_name.suffix == ".toml" and not _toml_has_config(config_name):
                 continue