summaryrefslogtreecommitdiff
path: root/isort/api.py
blob: c2c2c78d435a68668c676248eeb3ba6c6914c769 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
import re
from pathlib import Path
from typing import Any, NamedTuple, Optional, Tuple, TextIO

from . import output, parse
from .exceptions import (
    ExistingSyntaxErrors,
    FileSkipComment,
    FileSkipSetting,
    IntroducedSyntaxErrors,
    UnableToDetermineEncoding,
)
from .format import remove_whitespace, show_unified_diff
from .io import File
from .settings import DEFAULT_CONFIG, FILE_SKIP_COMMENT, Config

IMPORT_START_IDENTIFIERS = ("from ", "from.import", "import ", "import*")


def _config(
    path: Optional[Path] = None, config: Config = DEFAULT_CONFIG, **config_kwargs
) -> Config:
    if path:
        if (
            config is DEFAULT_CONFIG
            and "settings_path" not in config_kwargs
            and "settings_file" not in config_kwargs
        ):
            config_kwargs["settings_path"] = path

    if config_kwargs and config is not DEFAULT_CONFIG:
        raise ValueError(
            "You can either specify custom configuration options using kwargs or "
            "passing in a Config object. Not Both!"
        )
    elif config_kwargs:
        config = Config(**config_kwargs)

    return config


def sorted_imports(
    file_contents: str,
    extension: str = "py",
    config: Config = DEFAULT_CONFIG,
    file_path: Optional[Path] = None,
    disregard_skip: bool = False,
    **config_kwargs,
) -> str:
    config = _config(config=config, **config_kwargs)
    content_source = str(file_path or "Passed in content")
    if not disregard_skip:
        if FILE_SKIP_COMMENT in file_contents:
            raise FileSkipComment(content_source)

        elif file_path and config.is_skipped(file_path):
            raise FileSkipSetting(content_source)

    if config.atomic:
        try:
            compile(file_contents, content_source, "exec", 0, 1)
        except SyntaxError:
            raise ExistingSyntaxErrors(content_source)

    parsed_output = output.sorted_imports(
        parse.file_contents(file_contents, config=config), config, extension
    )
    if config.atomic:
        try:
            compile(file_contents, content_source, "exec", 0, 1)
        except SyntaxError:
            raise IntroducedSyntaxErrors(content_source)
    return parsed_output


def check_imports(
    file_contents: str,
    show_diff: bool = False,
    extension: str = "py",
    config: Config = DEFAULT_CONFIG,
    file_path: Optional[Path] = None,
    disregard_skip: bool = False,
    **config_kwargs,
) -> bool:
    config = _config(config=config, **config_kwargs)

    sorted_output = sorted_imports(
        file_contents=file_contents,
        extension=extension,
        config=config,
        file_path=file_path,
        disregard_skip=disregard_skip,
        **config_kwargs,
    )
    if config.ignore_whitespace:
        line_separator = config.line_ending or parse._infer_line_separator(file_contents)
        compare_in = remove_whitespace(file_contents, line_separator=line_separator).strip()
        compare_out = remove_whitespace(sorted_output, line_separator=line_separator).strip()
    else:
        compare_in = file_contents.strip()
        compare_out = sorted_output.strip()

    if compare_out == compare_in:
        if config.verbose:
            print(f"SUCCESS: {file_path or ''} Everything Looks Good!")
        return True
    else:
        print(f"ERROR: {file_path or ''} Imports are incorrectly sorted.")
        if show_diff:
            show_unified_diff(
                file_input=file_contents, file_output=sorted_output, file_path=file_path
            )
        return False


def sorted_file(filename: str, config: Config = DEFAULT_CONFIG, **config_kwargs) -> str:
    file_data = File.read(filename)
    config = _config(path=file_data.path.parent, config=config)
    return sorted_imports(
        file_contents=file_data.contents,
        extension=file_data.extension,
        config=config,
        file_path=file_data.path,
        **config_kwargs,
    )


def sort_imports(
    input_stream: TextIO, output_stream: TextIO, extension: str = "py", config: Config = DEFAULT_CONFIG,
) -> None:
    """Parses stream identifying sections of contiguous imports and sorting them

    Code with unsorted imports is read from the provided `input_stream`, sorted and then
    outputted to the specified output_stream.

    - `input_stream`: Text stream with unsorted import sections.
    - `output_stream`: Text stream to output sorted inputs into.
    - `config`: Config settings to use when sorting imports. Defaults settings.DEFAULT_CONFIG.
    """
    import_section: str = ""
    in_quote: str = ""
    first_comment_index_start: int = -1
    first_comment_index_end: int = -1
    contains_imports: bool = False
    for index, line in enumerate(input_stream):
        if '"' in line or "'" in line:
            char_index = 0
            if first_comment_index_start == -1 and (line.startswith('"') or line.startswith("'")):
                first_comment_index_start = index
            while char_index < len(line):
                if line[char_index] == "\\":
                    char_index += 1
                elif in_quote:
                    if line[char_index : char_index + len(in_quote)] == in_quote:
                        in_quote = ""
                        if first_comment_index_end < first_comment_index_start:
                            first_comment_index_end = index
                elif line[char_index] in ("'", '"'):
                    long_quote = line[char_index : char_index + 3]
                    if long_quote in ('"""', "'''"):
                        in_quote = long_quote
                        char_index += 2
                    else:
                        in_quote = line[char_index]
                elif line[char_index] == "#":
                    break
                char_index += 1

        not_imports = bool(in_quote)
        if not in_quote:
            stripped_line = line.strip()
            if not stripped_line or stripped_line.startswith("#"):
                import_section += line
            elif stripped_line.startswith(IMPORT_START_IDENTIFIERS):
                import_section += line
                if "(" in stripped_line and not ")" in stripped_line:
                    nested_line = line
                    nested_stripped_line = nested_line.strip().split("#")[0]
                    while not ")" in nested_stripped_line:
                        nested_line = input_stream.readline()
                        nested_stripped_line = nested_line.strip()
                        import_section += nested_line

                if stripped_line.endswith("\\"):
                    nested_line = line
                    nested_stripped_line = nested_line.strip()
                    while nested_line and nested_stripped_line.endswith("\\"):
                        nested_line = input_stream.readline()
                        nested_stripped_line = nested_line.strip()
                        import_section += nested_line

                contains_imports = True
            else:
                not_imports = True

        if not_imports:
            if import_section:
                import_section += line
                if not contains_imports:
                    output_stream.write(import_section)
                else:
                    output_stream.write(output.sorted_imports(
                        parse.file_contents(import_section, config=config), config, extension
                    ))
                contains_imports = False
                import_section = ""
            else:
                output_stream.write(line)
                not_imports = False