Skip to content

Module isort.place

Contains all logic related to placing an import within a certain section.

None

View Source
"""Contains all logic related to placing an import within a certain section."""

import importlib

from fnmatch import fnmatch

from functools import lru_cache

from pathlib import Path

from typing import FrozenSet, Iterable, Optional, Tuple

from isort import sections

from isort.settings import DEFAULT_CONFIG, Config

from isort.utils import exists_case_sensitive

LOCAL = "LOCALFOLDER"

def module(name: str, config: Config = DEFAULT_CONFIG) -> str:

    """Returns the section placement for the given module name."""

    return module_with_reason(name, config)[0]

@lru_cache(maxsize=1000)

def module_with_reason(name: str, config: Config = DEFAULT_CONFIG) -> Tuple[str, str]:

    """Returns the section placement for the given module name alongside the reasoning."""

    return (

        _forced_separate(name, config)

        or _local(name, config)

        or _known_pattern(name, config)

        or _src_path(name, config)

        or (config.default_section, "Default option in Config or universal default.")

    )

def _forced_separate(name: str, config: Config) -> Optional[Tuple[str, str]]:

    for forced_separate in config.forced_separate:

        # Ensure all forced_separate patterns will match to end of string

        path_glob = forced_separate

        if not forced_separate.endswith("*"):

            path_glob = "%s*" % forced_separate

        if fnmatch(name, path_glob) or fnmatch(name, "." + path_glob):

            return (forced_separate, f"Matched forced_separate ({forced_separate}) config value.")

    return None

def _local(name: str, config: Config) -> Optional[Tuple[str, str]]:

    if name.startswith("."):

        return (LOCAL, "Module name started with a dot.")

    return None

def _known_pattern(name: str, config: Config) -> Optional[Tuple[str, str]]:

    parts = name.split(".")

    module_names_to_check = (".".join(parts[:first_k]) for first_k in range(len(parts), 0, -1))

    for module_name_to_check in module_names_to_check:

        for pattern, placement in config.known_patterns:

            if placement in config.sections and pattern.match(module_name_to_check):

                return (placement, f"Matched configured known pattern {pattern}")

    return None

def _src_path(

    name: str,

    config: Config,

    src_paths: Optional[Iterable[Path]] = None,

    prefix: Tuple[str, ...] = (),

) -> Optional[Tuple[str, str]]:

    if src_paths is None:

        src_paths = config.src_paths

    root_module_name, *nested_module = name.split(".", 1)

    new_prefix = prefix + (root_module_name,)

    namespace = ".".join(new_prefix)

    for src_path in src_paths:

        module_path = (src_path / root_module_name).resolve()

        if not prefix and not module_path.is_dir() and src_path.name == root_module_name:

            module_path = src_path.resolve()

        if nested_module and (

            namespace in config.namespace_packages

            or (

                config.auto_identify_namespace_packages

                and _is_namespace_package(module_path, config.supported_extensions)

            )

        ):

            return _src_path(nested_module[0], config, (module_path,), new_prefix)

        if (

            _is_module(module_path)

            or _is_package(module_path)

            or _src_path_is_module(src_path, root_module_name)

        ):

            return (sections.FIRSTPARTY, f"Found in one of the configured src_paths: {src_path}.")

    return None

def _is_module(path: Path) -> bool:

    return (

        exists_case_sensitive(str(path.with_suffix(".py")))

        or any(

            exists_case_sensitive(str(path.with_suffix(ext_suffix)))

            for ext_suffix in importlib.machinery.EXTENSION_SUFFIXES

        )

        or exists_case_sensitive(str(path / "__init__.py"))

    )

def _is_package(path: Path) -> bool:

    return exists_case_sensitive(str(path)) and path.is_dir()

def _is_namespace_package(path: Path, src_extensions: FrozenSet[str]) -> bool:

    if not _is_package(path):

        return False

    init_file = path / "__init__.py"

    if not init_file.exists():

        filenames = [

            filepath

            for filepath in path.iterdir()

            if filepath.suffix.lstrip(".") in src_extensions

            or filepath.name.lower() in ("setup.cfg", "pyproject.toml")

        ]

        if filenames:

            return False

    else:

        with init_file.open() as open_init_file:

            file_start = open_init_file.read(4096)

            if (

                "__import__('pkg_resources').declare_namespace(__name__)" not in file_start

                and '__import__("pkg_resources").declare_namespace(__name__)' not in file_start

                and "__path__ = __import__('pkgutil').extend_path(__path__, __name__)"

                not in file_start

                and '__path__ = __import__("pkgutil").extend_path(__path__, __name__)'

                not in file_start

            ):

                return False

    return True

def _src_path_is_module(src_path: Path, module_name: str) -> bool:

    return (

        module_name == src_path.name and src_path.is_dir() and exists_case_sensitive(str(src_path))

    )

Variables

LOCAL

Functions

module

def module(
    name: str,
    config: isort.settings.Config = Config(py_version='py3', force_to_top=frozenset(), skip=frozenset({'.pants.d', '_build', '.direnv', 'build', '__pypackages__', '.nox', '.eggs', '.hg', '.git', 'node_modules', 'venv', '.bzr', '.mypy_cache', 'dist', '.svn', '.venv', 'buck-out', '.tox'}), extend_skip=frozenset(), skip_glob=frozenset(), extend_skip_glob=frozenset(), skip_gitignore=False, line_length=79, wrap_length=0, line_ending='', sections=('FUTURE', 'STDLIB', 'THIRDPARTY', 'FIRSTPARTY', 'LOCALFOLDER'), no_sections=False, known_future_library=frozenset({'__future__'}), known_third_party=frozenset(), known_first_party=frozenset(), known_local_folder=frozenset(), known_standard_library=frozenset({'symtable', 'json', 'winreg', 'base64', 'parser', 'sysconfig', 'syslog', 'csv', 'fileinput', 'platform', 'doctest', 'posix', 'bz2', 'heapq', 'pwd', 'ast', 'msvcrt', 'ntpath', 'asynchat', 'email', 'importlib', 'binhex', 'tkinter', 'sunau', 'cProfile', 'filecmp', 'pprint', 'timeit', 'collections', 'pyclbr', 'curses', 'ensurepip', 'linecache', 'ipaddress', 'pickletools', 'tokenize', 'formatter', 'sre_compile', 'encodings', 'nntplib', 'contextvars', 'faulthandler', 'shelve', 'cmd', 'sre', 'telnetlib', 'concurrent', 'pathlib', 'keyword', 'cmath', 'fractions', 'textwrap', 'decimal', 'struct', 'fpectl', 'nis', 'sndhdr', 'bdb', 'spwd', 'getopt', 'locale', 'tarfile', 'asyncore', 'smtplib', 'xml', 'quopri', 'tempfile', 'configparser', 'unicodedata', 'mmap', 'compileall', 'zoneinfo', 'marshal', 'argparse', 'gc', 'fnmatch', 'winsound', 'aifc', 'uu', 'shlex', 'py_compile', 'functools', 'sys', 'select', 'dataclasses', 'wsgiref', 'webbrowser', 'glob', 'subprocess', 'warnings', 'tabnanny', 'mailbox', 'logging', 'pipes', 'lib2to3', 'colorsys', 'getpass', 'dummy_threading', 'numbers', 'dbm', 'pdb', 'builtins', 'symbol', 'smtpd', 'grp', 'optparse', 'hmac', 'secrets', 'io', 'site', 'pstats', 'lzma', 'statistics', 'pty', 'turtledemo', 'http', 'inspect', 'wave', 'socket', 'poplib', 'urllib', 'threading', 'msilib', 'abc', 'imaplib', 'itertools', 'pickle', 'sre_constants', 'operator', 'zipfile', 'crypt', 'zlib', 'gzip', 'ctypes', 'readline', 'datetime', 'hashlib', 'socketserver', 'zipapp', 'resource', 'pydoc', 'mimetypes', 'errno', 'sched', 'calendar', 'uuid', 'codeop', 'ssl', 'selectors', 'xmlrpc', 'contextlib', 'queue', 'typing', 'graphlib', 'dis', 'posixpath', 'shutil', 'audioop', 'binascii', 'multiprocessing', 'unittest', 'codecs', 'enum', 'imp', 'venv', 'fcntl', 'bisect', 'token', 'ftplib', 'pkgutil', 'xdrlib', '_dummy_thread', 'cgi', 'profile', 'html', 'code', 'rlcompleter', 'types', 'os', 'runpy', 'difflib', 'sqlite3', 'tty', 'turtle', 'gettext', 'traceback', '_thread', 'plistlib', 're', 'copyreg', 'distutils', 'imghdr', 'math', 'stringprep', 'cgitb', 'array', 'asyncio', 'weakref', 'chunk', 'copy', 'stat', 'time', 'test', 'random', 'modulefinder', 'reprlib', 'macpath', 'zipimport', 'trace', 'signal', 'tracemalloc', 'mailcap', 'atexit', 'netrc', 'ossaudiodev', 'string', 'termios', 'sre_parse'}), extra_standard_library=frozenset(), known_other={}, multi_line_output=<WrapModes.GRID: 0>, forced_separate=(), indent='    ', comment_prefix='  #', length_sort=False, length_sort_straight=False, length_sort_sections=frozenset(), add_imports=frozenset(), remove_imports=frozenset(), append_only=False, reverse_relative=False, force_single_line=False, single_line_exclusions=(), default_section='THIRDPARTY', import_headings={}, balanced_wrapping=False, use_parentheses=False, order_by_type=True, atomic=False, lines_after_imports=-1, lines_between_sections=1, lines_between_types=0, combine_as_imports=False, combine_star=False, include_trailing_comma=False, from_first=False, verbose=False, quiet=False, force_adds=False, force_alphabetical_sort_within_sections=False, force_alphabetical_sort=False, force_grid_wrap=0, force_sort_within_sections=False, lexicographical=False, group_by_package=False, ignore_whitespace=False, no_lines_before=frozenset(), no_inline_sort=False, ignore_comments=False, case_sensitive=False, sources=({'py_version': 'py3', 'force_to_top': frozenset(), 'skip': frozenset({'.pants.d', '_build', '.direnv', 'build', '__pypackages__', '.nox', '.eggs', '.hg', '.git', 'node_modules', 'venv', '.bzr', '.mypy_cache', 'dist', '.svn', '.venv', 'buck-out', '.tox'}), 'extend_skip': frozenset(), 'skip_glob': frozenset(), 'extend_skip_glob': frozenset(), 'skip_gitignore': False, 'line_length': 79, 'wrap_length': 0, 'line_ending': '', 'sections': ('FUTURE', 'STDLIB', 'THIRDPARTY', 'FIRSTPARTY', 'LOCALFOLDER'), 'no_sections': False, 'known_future_library': frozenset({'__future__'}), 'known_third_party': frozenset(), 'known_first_party': frozenset(), 'known_local_folder': frozenset(), 'known_standard_library': frozenset({'symtable', 'json', 'winreg', 'base64', 'parser', 'sysconfig', 'syslog', 'csv', 'fileinput', 'platform', 'doctest', 'posix', 'bz2', 'heapq', 'pwd', 'ast', 'msvcrt', 'ntpath', 'asynchat', 'email', 'importlib', 'binhex', 'tkinter', 'sunau', 'cProfile', 'filecmp', 'pprint', 'timeit', 'collections', 'pyclbr', 'curses', 'ensurepip', 'linecache', 'ipaddress', 'pickletools', 'tokenize', 'formatter', 'sre_compile', 'encodings', 'nntplib', 'contextvars', 'faulthandler', 'shelve', 'cmd', 'sre', 'telnetlib', 'concurrent', 'pathlib', 'keyword', 'cmath', 'fractions', 'textwrap', 'decimal', 'struct', 'fpectl', 'nis', 'sndhdr', 'bdb', 'spwd', 'getopt', 'locale', 'tarfile', 'asyncore', 'smtplib', 'xml', 'quopri', 'tempfile', 'configparser', 'unicodedata', 'mmap', 'compileall', 'zoneinfo', 'marshal', 'argparse', 'gc', 'fnmatch', 'winsound', 'aifc', 'uu', 'shlex', 'py_compile', 'functools', 'sys', 'select', 'dataclasses', 'wsgiref', 'webbrowser', 'glob', 'subprocess', 'warnings', 'tabnanny', 'mailbox', 'logging', 'pipes', 'lib2to3', 'colorsys', 'getpass', 'dummy_threading', 'numbers', 'dbm', 'pdb', 'builtins', 'symbol', 'smtpd', 'grp', 'optparse', 'hmac', 'secrets', 'io', 'site', 'pstats', 'lzma', 'statistics', 'pty', 'turtledemo', 'http', 'inspect', 'wave', 'socket', 'poplib', 'urllib', 'threading', 'msilib', 'abc', 'imaplib', 'itertools', 'pickle', 'sre_constants', 'operator', 'zipfile', 'crypt', 'zlib', 'gzip', 'ctypes', 'readline', 'datetime', 'hashlib', 'socketserver', 'zipapp', 'resource', 'pydoc', 'mimetypes', 'errno', 'sched', 'calendar', 'uuid', 'codeop', 'ssl', 'selectors', 'xmlrpc', 'contextlib', 'queue', 'typing', 'graphlib', 'dis', 'posixpath', 'shutil', 'audioop', 'binascii', 'multiprocessing', 'unittest', 'codecs', 'enum', 'imp', 'venv', 'fcntl', 'bisect', 'token', 'ftplib', 'pkgutil', 'xdrlib', '_dummy_thread', 'cgi', 'profile', 'html', 'code', 'rlcompleter', 'types', 'os', 'runpy', 'difflib', 'sqlite3', 'tty', 'turtle', 'gettext', 'traceback', '_thread', 'plistlib', 're', 'copyreg', 'distutils', 'imghdr', 'math', 'stringprep', 'cgitb', 'array', 'asyncio', 'weakref', 'chunk', 'copy', 'stat', 'time', 'test', 'random', 'modulefinder', 'reprlib', 'macpath', 'zipimport', 'trace', 'signal', 'tracemalloc', 'mailcap', 'atexit', 'netrc', 'ossaudiodev', 'string', 'termios', 'sre_parse'}), 'extra_standard_library': frozenset(), 'known_other': {}, 'multi_line_output': <WrapModes.GRID: 0>, 'forced_separate': (), 'indent': '    ', 'comment_prefix': '  #', 'length_sort': False, 'length_sort_straight': False, 'length_sort_sections': frozenset(), 'add_imports': frozenset(), 'remove_imports': frozenset(), 'append_only': False, 'reverse_relative': False, 'force_single_line': False, 'single_line_exclusions': (), 'default_section': 'THIRDPARTY', 'import_headings': {}, 'balanced_wrapping': False, 'use_parentheses': False, 'order_by_type': True, 'atomic': False, 'lines_after_imports': -1, 'lines_between_sections': 1, 'lines_between_types': 0, 'combine_as_imports': False, 'combine_star': False, 'include_trailing_comma': False, 'from_first': False, 'verbose': False, 'quiet': False, 'force_adds': False, 'force_alphabetical_sort_within_sections': False, 'force_alphabetical_sort': False, 'force_grid_wrap': 0, 'force_sort_within_sections': False, 'lexicographical': False, 'group_by_package': False, 'ignore_whitespace': False, 'no_lines_before': frozenset(), 'no_inline_sort': False, 'ignore_comments': False, 'case_sensitive': False, 'sources': (), 'virtual_env': '', 'conda_env': '', 'ensure_newline_before_comments': False, 'directory': '', 'profile': '', 'honor_noqa': False, 'src_paths': (), 'old_finders': False, 'remove_redundant_aliases': False, 'float_to_top': False, 'filter_files': False, 'formatter': '', 'formatting_function': None, 'color_output': False, 'treat_comments_as_code': frozenset(), 'treat_all_comments_as_code': False, 'supported_extensions': frozenset({'py', 'pyx', 'pxd', 'pyi'}), 'blocked_extensions': frozenset({'pex'}), 'constants': frozenset(), 'classes': frozenset(), 'variables': frozenset(), 'dedup_headings': False, 'only_sections': False, 'only_modified': False, 'combine_straight_imports': False, 'auto_identify_namespace_packages': True, 'namespace_packages': frozenset(), 'follow_links': True, 'indented_import_headings': True, 'honor_case_in_force_sorted_sections': False, 'sort_relative_in_force_sorted_sections': False, 'overwrite_in_place': False, 'reverse_sort': False, 'star_first': False, 'source': 'defaults'},), virtual_env='', conda_env='', ensure_newline_before_comments=False, directory='/home/tim/Projects/isort', profile='', honor_noqa=False, src_paths=(PosixPath('/home/tim/Projects/isort/src'), PosixPath('/home/tim/Projects/isort')), old_finders=False, remove_redundant_aliases=False, float_to_top=False, filter_files=False, formatter='', formatting_function=None, color_output=False, treat_comments_as_code=frozenset(), treat_all_comments_as_code=False, supported_extensions=frozenset({'py', 'pyx', 'pxd', 'pyi'}), blocked_extensions=frozenset({'pex'}), constants=frozenset(), classes=frozenset(), variables=frozenset(), dedup_headings=False, only_sections=False, only_modified=False, combine_straight_imports=False, auto_identify_namespace_packages=True, namespace_packages=frozenset(), follow_links=True, indented_import_headings=True, honor_case_in_force_sorted_sections=False, sort_relative_in_force_sorted_sections=False, overwrite_in_place=False, reverse_sort=False, star_first=False)
) -> str

Returns the section placement for the given module name.

View Source
def module(name: str, config: Config = DEFAULT_CONFIG) -> str:

    """Returns the section placement for the given module name."""

    return module_with_reason(name, config)[0]

module_with_reason

def module_with_reason(
    name: str,
    config: isort.settings.Config = Config(py_version='py3', force_to_top=frozenset(), skip=frozenset({'.pants.d', '_build', '.direnv', 'build', '__pypackages__', '.nox', '.eggs', '.hg', '.git', 'node_modules', 'venv', '.bzr', '.mypy_cache', 'dist', '.svn', '.venv', 'buck-out', '.tox'}), extend_skip=frozenset(), skip_glob=frozenset(), extend_skip_glob=frozenset(), skip_gitignore=False, line_length=79, wrap_length=0, line_ending='', sections=('FUTURE', 'STDLIB', 'THIRDPARTY', 'FIRSTPARTY', 'LOCALFOLDER'), no_sections=False, known_future_library=frozenset({'__future__'}), known_third_party=frozenset(), known_first_party=frozenset(), known_local_folder=frozenset(), known_standard_library=frozenset({'symtable', 'json', 'winreg', 'base64', 'parser', 'sysconfig', 'syslog', 'csv', 'fileinput', 'platform', 'doctest', 'posix', 'bz2', 'heapq', 'pwd', 'ast', 'msvcrt', 'ntpath', 'asynchat', 'email', 'importlib', 'binhex', 'tkinter', 'sunau', 'cProfile', 'filecmp', 'pprint', 'timeit', 'collections', 'pyclbr', 'curses', 'ensurepip', 'linecache', 'ipaddress', 'pickletools', 'tokenize', 'formatter', 'sre_compile', 'encodings', 'nntplib', 'contextvars', 'faulthandler', 'shelve', 'cmd', 'sre', 'telnetlib', 'concurrent', 'pathlib', 'keyword', 'cmath', 'fractions', 'textwrap', 'decimal', 'struct', 'fpectl', 'nis', 'sndhdr', 'bdb', 'spwd', 'getopt', 'locale', 'tarfile', 'asyncore', 'smtplib', 'xml', 'quopri', 'tempfile', 'configparser', 'unicodedata', 'mmap', 'compileall', 'zoneinfo', 'marshal', 'argparse', 'gc', 'fnmatch', 'winsound', 'aifc', 'uu', 'shlex', 'py_compile', 'functools', 'sys', 'select', 'dataclasses', 'wsgiref', 'webbrowser', 'glob', 'subprocess', 'warnings', 'tabnanny', 'mailbox', 'logging', 'pipes', 'lib2to3', 'colorsys', 'getpass', 'dummy_threading', 'numbers', 'dbm', 'pdb', 'builtins', 'symbol', 'smtpd', 'grp', 'optparse', 'hmac', 'secrets', 'io', 'site', 'pstats', 'lzma', 'statistics', 'pty', 'turtledemo', 'http', 'inspect', 'wave', 'socket', 'poplib', 'urllib', 'threading', 'msilib', 'abc', 'imaplib', 'itertools', 'pickle', 'sre_constants', 'operator', 'zipfile', 'crypt', 'zlib', 'gzip', 'ctypes', 'readline', 'datetime', 'hashlib', 'socketserver', 'zipapp', 'resource', 'pydoc', 'mimetypes', 'errno', 'sched', 'calendar', 'uuid', 'codeop', 'ssl', 'selectors', 'xmlrpc', 'contextlib', 'queue', 'typing', 'graphlib', 'dis', 'posixpath', 'shutil', 'audioop', 'binascii', 'multiprocessing', 'unittest', 'codecs', 'enum', 'imp', 'venv', 'fcntl', 'bisect', 'token', 'ftplib', 'pkgutil', 'xdrlib', '_dummy_thread', 'cgi', 'profile', 'html', 'code', 'rlcompleter', 'types', 'os', 'runpy', 'difflib', 'sqlite3', 'tty', 'turtle', 'gettext', 'traceback', '_thread', 'plistlib', 're', 'copyreg', 'distutils', 'imghdr', 'math', 'stringprep', 'cgitb', 'array', 'asyncio', 'weakref', 'chunk', 'copy', 'stat', 'time', 'test', 'random', 'modulefinder', 'reprlib', 'macpath', 'zipimport', 'trace', 'signal', 'tracemalloc', 'mailcap', 'atexit', 'netrc', 'ossaudiodev', 'string', 'termios', 'sre_parse'}), extra_standard_library=frozenset(), known_other={}, multi_line_output=<WrapModes.GRID: 0>, forced_separate=(), indent='    ', comment_prefix='  #', length_sort=False, length_sort_straight=False, length_sort_sections=frozenset(), add_imports=frozenset(), remove_imports=frozenset(), append_only=False, reverse_relative=False, force_single_line=False, single_line_exclusions=(), default_section='THIRDPARTY', import_headings={}, balanced_wrapping=False, use_parentheses=False, order_by_type=True, atomic=False, lines_after_imports=-1, lines_between_sections=1, lines_between_types=0, combine_as_imports=False, combine_star=False, include_trailing_comma=False, from_first=False, verbose=False, quiet=False, force_adds=False, force_alphabetical_sort_within_sections=False, force_alphabetical_sort=False, force_grid_wrap=0, force_sort_within_sections=False, lexicographical=False, group_by_package=False, ignore_whitespace=False, no_lines_before=frozenset(), no_inline_sort=False, ignore_comments=False, case_sensitive=False, sources=({'py_version': 'py3', 'force_to_top': frozenset(), 'skip': frozenset({'.pants.d', '_build', '.direnv', 'build', '__pypackages__', '.nox', '.eggs', '.hg', '.git', 'node_modules', 'venv', '.bzr', '.mypy_cache', 'dist', '.svn', '.venv', 'buck-out', '.tox'}), 'extend_skip': frozenset(), 'skip_glob': frozenset(), 'extend_skip_glob': frozenset(), 'skip_gitignore': False, 'line_length': 79, 'wrap_length': 0, 'line_ending': '', 'sections': ('FUTURE', 'STDLIB', 'THIRDPARTY', 'FIRSTPARTY', 'LOCALFOLDER'), 'no_sections': False, 'known_future_library': frozenset({'__future__'}), 'known_third_party': frozenset(), 'known_first_party': frozenset(), 'known_local_folder': frozenset(), 'known_standard_library': frozenset({'symtable', 'json', 'winreg', 'base64', 'parser', 'sysconfig', 'syslog', 'csv', 'fileinput', 'platform', 'doctest', 'posix', 'bz2', 'heapq', 'pwd', 'ast', 'msvcrt', 'ntpath', 'asynchat', 'email', 'importlib', 'binhex', 'tkinter', 'sunau', 'cProfile', 'filecmp', 'pprint', 'timeit', 'collections', 'pyclbr', 'curses', 'ensurepip', 'linecache', 'ipaddress', 'pickletools', 'tokenize', 'formatter', 'sre_compile', 'encodings', 'nntplib', 'contextvars', 'faulthandler', 'shelve', 'cmd', 'sre', 'telnetlib', 'concurrent', 'pathlib', 'keyword', 'cmath', 'fractions', 'textwrap', 'decimal', 'struct', 'fpectl', 'nis', 'sndhdr', 'bdb', 'spwd', 'getopt', 'locale', 'tarfile', 'asyncore', 'smtplib', 'xml', 'quopri', 'tempfile', 'configparser', 'unicodedata', 'mmap', 'compileall', 'zoneinfo', 'marshal', 'argparse', 'gc', 'fnmatch', 'winsound', 'aifc', 'uu', 'shlex', 'py_compile', 'functools', 'sys', 'select', 'dataclasses', 'wsgiref', 'webbrowser', 'glob', 'subprocess', 'warnings', 'tabnanny', 'mailbox', 'logging', 'pipes', 'lib2to3', 'colorsys', 'getpass', 'dummy_threading', 'numbers', 'dbm', 'pdb', 'builtins', 'symbol', 'smtpd', 'grp', 'optparse', 'hmac', 'secrets', 'io', 'site', 'pstats', 'lzma', 'statistics', 'pty', 'turtledemo', 'http', 'inspect', 'wave', 'socket', 'poplib', 'urllib', 'threading', 'msilib', 'abc', 'imaplib', 'itertools', 'pickle', 'sre_constants', 'operator', 'zipfile', 'crypt', 'zlib', 'gzip', 'ctypes', 'readline', 'datetime', 'hashlib', 'socketserver', 'zipapp', 'resource', 'pydoc', 'mimetypes', 'errno', 'sched', 'calendar', 'uuid', 'codeop', 'ssl', 'selectors', 'xmlrpc', 'contextlib', 'queue', 'typing', 'graphlib', 'dis', 'posixpath', 'shutil', 'audioop', 'binascii', 'multiprocessing', 'unittest', 'codecs', 'enum', 'imp', 'venv', 'fcntl', 'bisect', 'token', 'ftplib', 'pkgutil', 'xdrlib', '_dummy_thread', 'cgi', 'profile', 'html', 'code', 'rlcompleter', 'types', 'os', 'runpy', 'difflib', 'sqlite3', 'tty', 'turtle', 'gettext', 'traceback', '_thread', 'plistlib', 're', 'copyreg', 'distutils', 'imghdr', 'math', 'stringprep', 'cgitb', 'array', 'asyncio', 'weakref', 'chunk', 'copy', 'stat', 'time', 'test', 'random', 'modulefinder', 'reprlib', 'macpath', 'zipimport', 'trace', 'signal', 'tracemalloc', 'mailcap', 'atexit', 'netrc', 'ossaudiodev', 'string', 'termios', 'sre_parse'}), 'extra_standard_library': frozenset(), 'known_other': {}, 'multi_line_output': <WrapModes.GRID: 0>, 'forced_separate': (), 'indent': '    ', 'comment_prefix': '  #', 'length_sort': False, 'length_sort_straight': False, 'length_sort_sections': frozenset(), 'add_imports': frozenset(), 'remove_imports': frozenset(), 'append_only': False, 'reverse_relative': False, 'force_single_line': False, 'single_line_exclusions': (), 'default_section': 'THIRDPARTY', 'import_headings': {}, 'balanced_wrapping': False, 'use_parentheses': False, 'order_by_type': True, 'atomic': False, 'lines_after_imports': -1, 'lines_between_sections': 1, 'lines_between_types': 0, 'combine_as_imports': False, 'combine_star': False, 'include_trailing_comma': False, 'from_first': False, 'verbose': False, 'quiet': False, 'force_adds': False, 'force_alphabetical_sort_within_sections': False, 'force_alphabetical_sort': False, 'force_grid_wrap': 0, 'force_sort_within_sections': False, 'lexicographical': False, 'group_by_package': False, 'ignore_whitespace': False, 'no_lines_before': frozenset(), 'no_inline_sort': False, 'ignore_comments': False, 'case_sensitive': False, 'sources': (), 'virtual_env': '', 'conda_env': '', 'ensure_newline_before_comments': False, 'directory': '', 'profile': '', 'honor_noqa': False, 'src_paths': (), 'old_finders': False, 'remove_redundant_aliases': False, 'float_to_top': False, 'filter_files': False, 'formatter': '', 'formatting_function': None, 'color_output': False, 'treat_comments_as_code': frozenset(), 'treat_all_comments_as_code': False, 'supported_extensions': frozenset({'py', 'pyx', 'pxd', 'pyi'}), 'blocked_extensions': frozenset({'pex'}), 'constants': frozenset(), 'classes': frozenset(), 'variables': frozenset(), 'dedup_headings': False, 'only_sections': False, 'only_modified': False, 'combine_straight_imports': False, 'auto_identify_namespace_packages': True, 'namespace_packages': frozenset(), 'follow_links': True, 'indented_import_headings': True, 'honor_case_in_force_sorted_sections': False, 'sort_relative_in_force_sorted_sections': False, 'overwrite_in_place': False, 'reverse_sort': False, 'star_first': False, 'source': 'defaults'},), virtual_env='', conda_env='', ensure_newline_before_comments=False, directory='/home/tim/Projects/isort', profile='', honor_noqa=False, src_paths=(PosixPath('/home/tim/Projects/isort/src'), PosixPath('/home/tim/Projects/isort')), old_finders=False, remove_redundant_aliases=False, float_to_top=False, filter_files=False, formatter='', formatting_function=None, color_output=False, treat_comments_as_code=frozenset(), treat_all_comments_as_code=False, supported_extensions=frozenset({'py', 'pyx', 'pxd', 'pyi'}), blocked_extensions=frozenset({'pex'}), constants=frozenset(), classes=frozenset(), variables=frozenset(), dedup_headings=False, only_sections=False, only_modified=False, combine_straight_imports=False, auto_identify_namespace_packages=True, namespace_packages=frozenset(), follow_links=True, indented_import_headings=True, honor_case_in_force_sorted_sections=False, sort_relative_in_force_sorted_sections=False, overwrite_in_place=False, reverse_sort=False, star_first=False)
) -> Tuple[str, str]

Returns the section placement for the given module name alongside the reasoning.

View Source
@lru_cache(maxsize=1000)

def module_with_reason(name: str, config: Config = DEFAULT_CONFIG) -> Tuple[str, str]:

    """Returns the section placement for the given module name alongside the reasoning."""

    return (

        _forced_separate(name, config)

        or _local(name, config)

        or _known_pattern(name, config)

        or _src_path(name, config)

        or (config.default_section, "Default option in Config or universal default.")

    )