Allow passing arguments if epylint entry point is used as function (

#5616)

ChangeLog

@@ -90,7 +90,7 @@ Release date: TBA
 
   Closes #5504
 
-* When invoking ``pylint``, ``symilar`` or ``pyreverse`` by importing them in a python file
+* When invoking ``pylint``, ``epylint``, ``symilar`` or ``pyreverse`` by importing them in a python file
   you can now pass an ``arguments`` keyword besides patching ``sys.argv``.
 
   Closes #5320

doc/whatsnew/2.13.rst

@@ -121,7 +121,7 @@ Other Changes
 
   Closes #5557
 
-* When invoking ``pylint``, ``symilar`` or ``pyreverse`` by importing them in a python file
+* When invoking ``pylint``, ``epylint``, ``symilar`` or ``pyreverse`` by importing them in a python file
   you can now pass an ``arguments`` keyword besides patching ``sys.argv``.
 
   Closes #5320

pylint/__init__.py

@@ -31,10 +31,14 @@ def run_pylint(argv: Optional[Sequence[str]] = None):
         sys.exit(1)
 
 
-def run_epylint():
+def run_epylint(argv: Optional[Sequence[str]] = None):
+    """Run epylint
+
+    argv can be a list of strings normally supplied as arguments on the command line
+    """
     from pylint.epylint import Run as EpylintRun
 
-    EpylintRun()
+    EpylintRun(argv)
 
 
 def run_pyreverse(argv: Optional[Sequence[str]] = None):

pylint/epylint.py

@@ -64,6 +64,7 @@
 import sys
 from io import StringIO
 from subprocess import PIPE, Popen
+from typing import Optional, Sequence
 
 
 def _get_env():
@@ -185,15 +186,17 @@ def py_run(command_options="", return_std=False, stdout=None, stderr=None):
         return None
 
 
-def Run():
-    if len(sys.argv) == 1:
+def Run(argv: Optional[Sequence[str]] = None):
+    if not argv and len(sys.argv) == 1:
         print(f"Usage: {sys.argv[0]} <filename> [options]")
         sys.exit(1)
-    elif not os.path.exists(sys.argv[1]):
-        print(f"{sys.argv[1]} does not exist")
+
+    argv = argv or sys.argv[1:]
+    if not os.path.exists(argv[0]):
+        print(f"{argv[0]} does not exist")
         sys.exit(1)
     else:
-        sys.exit(lint(sys.argv[1], sys.argv[2:]))
+        sys.exit(lint(argv[0], argv[1:]))
 
 
 if __name__ == "__main__":

tests/test_pylint_runners.py

@@ -23,7 +23,9 @@ def test_runner(runner: Callable, tmpdir: LocalPath) -> None:
             assert err.value.code == 0
 
 
-@pytest.mark.parametrize("runner", [run_pylint, run_pyreverse, run_symilar])
+@pytest.mark.parametrize(
+    "runner", [run_epylint, run_pylint, run_pyreverse, run_symilar]
+)
 def test_runner_with_arguments(runner: Callable, tmpdir: LocalPath) -> None:
     """Check the runners with arguments as parameter instead of sys.argv"""
     filepath = os.path.abspath(__file__)