import sys
import unittest.case
import unittest.suite
from collections.abc import Callable, Sequence
from re import Pattern
from types import ModuleType
from typing import Any, Final
from typing_extensions import TypeAlias, deprecated

_SortComparisonMethod: TypeAlias = Callable[[str, str], int]
_SuiteClass: TypeAlias = Callable[[list[unittest.case.TestCase]], unittest.suite.TestSuite]

VALID_MODULE_NAME: Final[Pattern[str]]

class TestLoader:
    errors: list[type[BaseException]]
    testMethodPrefix: str
    sortTestMethodsUsing: _SortComparisonMethod
    testNamePatterns: list[str] | None
    suiteClass: _SuiteClass
    def loadTestsFromTestCase(self, testCaseClass: type[unittest.case.TestCase]) -> unittest.suite.TestSuite: ...
    if sys.version_info >= (3, 12):
        def loadTestsFromModule(self, module: ModuleType, *, pattern: str | None = None) -> unittest.suite.TestSuite: ...
    else:
        def loadTestsFromModule(self, module: ModuleType, *args: Any, pattern: str | None = None) -> unittest.suite.TestSuite: ...

    def loadTestsFromName(self, name: str, module: ModuleType | None = None) -> unittest.suite.TestSuite: ...
    def loadTestsFromNames(self, names: Sequence[str], module: ModuleType | None = None) -> unittest.suite.TestSuite: ...
    def getTestCaseNames(self, testCaseClass: type[unittest.case.TestCase]) -> Sequence[str]: ...
    def discover(
        self, start_dir: str, pattern: str = "test*.py", top_level_dir: str | None = None
    ) -> unittest.suite.TestSuite: ...
    def _match_path(self, path: str, full_path: str, pattern: str) -> bool: ...

defaultTestLoader: TestLoader

if sys.version_info < (3, 13):
    if sys.version_info >= (3, 11):
        @deprecated("Deprecated since Python 3.11; removed in Python 3.13.")
        def getTestCaseNames(
            testCaseClass: type[unittest.case.TestCase],
            prefix: str,
            sortUsing: _SortComparisonMethod = ...,
            testNamePatterns: list[str] | None = None,
        ) -> Sequence[str]: ...
        @deprecated("Deprecated since Python 3.11; removed in Python 3.13.")
        def makeSuite(
            testCaseClass: type[unittest.case.TestCase],
            prefix: str = "test",
            sortUsing: _SortComparisonMethod = ...,
            suiteClass: _SuiteClass = ...,
        ) -> unittest.suite.TestSuite: ...
        @deprecated("Deprecated since Python 3.11; removed in Python 3.13.")
        def findTestCases(
            module: ModuleType, prefix: str = "test", sortUsing: _SortComparisonMethod = ..., suiteClass: _SuiteClass = ...
        ) -> unittest.suite.TestSuite: ...
    else:
        def getTestCaseNames(
            testCaseClass: type[unittest.case.TestCase],
            prefix: str,
            sortUsing: _SortComparisonMethod = ...,
            testNamePatterns: list[str] | None = None,
        ) -> Sequence[str]: ...
        def makeSuite(
            testCaseClass: type[unittest.case.TestCase],
            prefix: str = "test",
            sortUsing: _SortComparisonMethod = ...,
            suiteClass: _SuiteClass = ...,
        ) -> unittest.suite.TestSuite: ...
        def findTestCases(
            module: ModuleType, prefix: str = "test", sortUsing: _SortComparisonMethod = ..., suiteClass: _SuiteClass = ...
        ) -> unittest.suite.TestSuite: ...