ruff_linter 0.15.19

This is an internal component crate of Ruff
Documentation 
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

use ruff_python_semantic::Exceptions;
use ruff_python_stdlib::builtins::version_builtin_was_added;

use crate::checkers::ast::Checker;
use crate::codes::Rule;
use crate::rules::pyflakes;

/// Run lint rules over all [`UnresolvedReference`] entities in the [`SemanticModel`].
pub(crate) fn unresolved_references(checker: &Checker) {
    if !checker.any_rule_enabled(&[Rule::UndefinedLocalWithImportStarUsage, Rule::UndefinedName]) {
        return;
    }

    for reference in checker.semantic.unresolved_references() {
        if reference.is_wildcard_import() {
            // F405
            checker.report_diagnostic_if_enabled(
                pyflakes::rules::UndefinedLocalWithImportStarUsage {
                    name: reference.name(checker.source()).to_string(),
                },
                reference.range(),
            );
        } else {
            // F821
            if checker.is_rule_enabled(Rule::UndefinedName) {
                if checker.semantic.in_no_type_check() {
                    continue;
                }

                // Avoid flagging if `NameError` is handled.
                if reference.exceptions().contains(Exceptions::NAME_ERROR) {
                    continue;
                }

                // Allow __path__.
                if checker.in_init_module() {
                    if reference.name(checker.source()) == "__path__" {
                        continue;
                    }
                }

                // Bare local annotations can be initialized through nested `nonlocal`
                // rebindings. If such a rebinding exists, skip F821.
                if let Some(annotation_binding_id) = reference.annotation_binding_id() {
                    if checker
                        .semantic
                        .rebinding_scopes(annotation_binding_id)
                        .is_some_and(|scopes| !scopes.is_empty())
                    {
                        continue;
                    }
                }

                let symbol_name = reference.name(checker.source());

                checker.report_diagnostic(
                    pyflakes::rules::UndefinedName {
                        name: symbol_name.to_string(),
                        minor_version_builtin_added: version_builtin_was_added(symbol_name),
                    },
                    reference.range(),
                );
            }
        }
    }
}