d&] d Z ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
m Z ddl m
Z
erddlmZ G d d
e
ZddZdS )z8Check for imports on private external modules and names. ) annotations)Path)
TYPE_CHECKING)nodes) BaseCheckerutils)HIGH)PyLinterc e Zd ZdZddiZd'dZ ej d d(d Z ej d d)d
Z d*dZ
e d+d Z d,dZ
d-dZd.d Zd/d Ze d0d# Ze d1d% Zd&S )2PrivateImportCheckerimport-private-nameC2701)zImported private %s (%s)r
zUsed when a private module or object prefixed with _ is imported. PEP8 guidance on Naming Conventions states that public attributes with leading underscores should be considered private.linterr
returnNonec L t j | | i | _ d| _ d S )NF)r __init__all_used_type_annotationspopulated_annotations)selfr s r/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/extensions/private_import.pyr z PrivateImportChecker.__init__! s- T6*** ;=&%*""" node nodes.Importc J t j | rd S d |j D }| | }| || }|rNt | dk rdnd}d | }| d|||ft d S d S )Nc g | ]
}|d S r ).0names r
z5PrivateImportChecker.visit_import.., s 000Ta000r modulesmodule, r
r args
confidence) r in_type_checking_blocknames_get_private_imports_get_type_annotation_nameslenjoin add_messager )r r r*
private_namesimported_identifierprivate_name_strings r visit_importz!PrivateImportChecker.visit_import( s ' - - F00TZ000 11%88
77mLL
/2=/A/AA/E/E))8 "&))M":": %)+>?
r nodes.ImportFromc B t j | rd S | ||j rd S d |j D }| || }|sd S | |j g }| || }|r(| d|d|d ft d S | | }|rNt | dk rdnd}d
| }| d|||ft d S d S )
Nc g | ]
}|d S r r )r ns r r! z9PrivateImportChecker.visit_importfrom..A s ***!1***r r
r$ r r& r" objectsobjectr% ) r r)
same_root_dirmodnamer* r, r+ r/ r r- r. )r r r* r0 private_module_importsr1 r2 s r visit_importfromz%PrivateImportChecker.visit_importfrom9 sy ' - - F dDL 1 1 F**tz*** 77eDD
F "&!:!:DL>!J!J !%!@!@ ("
"
" % 6q 9:
F 11-@@
/2=/A/AA/E/E))8 "&))M":": %)+>?
r r* list[str]c fd|D S )zDReturns the private names from input names by a simple string check.c > g | ]} | |S r )_name_is_private)r r r s r r! z=PrivateImportChecker._get_private_imports..e s, FFF$*?*?*E*EFFFFr r )r r* s ` r r+ z)PrivateImportChecker._get_private_importsc s FFFFFFFFr r strboolc t | o8| d dk o,t | dk p| d dk p
| dd dk S )zReturns true if the name exists, starts with `_`, and if len(name) > 4
it is not a dunder, i.e. it does not begin and end with two underscores.
r _ r" N__)rC r- )r s r rA z%PrivateImportChecker._name_is_privateg sU
JJ
HQ3
HTa F47c>FT"##Y$5F
r nodes.Import | nodes.ImportFromc |r; j s4 | j d _ fd|D S )zmRemoves from names any names that are used as type annotations with no other
illegal usages.
Tc R g | ]#}|j vs|j v j | !|$S r )r )r r7 r s r r! zCPrivateImportChecker._get_type_annotation_names..| sQ
666T333 6q9 4
433r )r _populate_type_annotationsrootr )r r r* s ` r r, z/PrivateImportChecker._get_type_annotation_namesr sk .3 . + +DIIKK9W X X X)-D &
r nodes.LocalsDictNodeNGr dict[str, bool]c |j D ]_}d}g }|j | D ].}t |t j rt |j t j t j f r|j }t |t j r6| | | |j j | }n/t |t j r| | t |t j
r| || t |t j r|
|| 0|| || ||< adS )zAdds to `all_used_type_annotations` all names ever used as a type annotation
in the node's (nested) scopes and whether they are only used as annotation.
N)locals
isinstancer
AssignNameparent AnnAssignAssignappend%_populate_type_annotations_annotation
annotation FunctionDef#_populate_type_annotations_functionLocalsDictNodeNGrL _assignments_call_private_name)r r r r private_namename_assignments
usage_node
assign_parents r rL z/PrivateImportChecker._populate_type_annotations s K X XD L " "k$ /
j%*:;;
?
% 'FA A
? %/$5M!- AA ?(//
>>>'+'Q'Q & - 8:S( ( $M5<@@ ?(//
>>> j%*;<< <<"$= j%*@AA 33"$= ' 778H,WW * ; X Xr nodes.FunctionDefc |j r1|j j r%|j j D ]}| || |j r | |j | dS dS )zAdds all names used as type annotation in the arguments and return type of
the function node into the dict `all_used_type_annotations`.
N)r' r rX returns)r r r rY s r r[ z8PrivateImportChecker._populate_type_annotations_function s 9 . "i 3
:: 9 < 6 6 7
r 5nodes.Attribute | nodes.Subscript | nodes.Name | None
str | Nonec x t |t j r|j |vrd||j < |j S t |t j r6| |j | | |j | S t |t j r| |j | S dS )zHandles the possibility of an annotation either being a Name, i.e. just type,
or a Subscript e.g. `Optional[type]` or an Attribute, e.g. `pylint.lint.linter`.
TN)
rR r Namer SubscriptrX slicevalue Attributeexpr)r r r s r rX z:PrivateImportChecker._populate_type_annotations_annotation s dEJ ' ' DI=V,V,V37 %di 09 dEO , , 6 6
5
==
5
dEO , , == 4
tr assignments$list[nodes.AnnAssign | nodes.Assign]r^ c t d | D rdS | D ]<}d}t |j t j r
|j j }nRt |j t j r|j }n+t |j t j r |j j }|st |t j t j f rht |t j r|j }t |t j s|j }t |t j t j f ht |t j r|j |k r dS >dS )z@Returns True if no assignments involve accessing `private_name`.c 3 & K | ] }|j V
d S N)rk )r
assignments r zFPrivateImportChecker._assignments_call_private_name.. s( BB
:##BBBBBBr FNT)
allrR rk r Callfuncrl rh r rm )rn r^ rs current_attributes r r] z3PrivateImportChecker._assignments_call_private_name s^
BBkBBB B B 5% J $ **EJ77
:$.$4$9!!J ,eo>>
:$.$4!!J ,ej99
:$.$4$9!$
. %*0MNN
? /<< ?(9(>%!"3UZ@@ ?(9(>% . %*0MNN
? ,ej99
%*l:: uutr import_mod_namec |sdS | j rdS | d d }|t | j j j v S )zGDoes the node's file's path contain the base name of `import_mod_name`?T.r )levelsplitr rM filerT parts)r ry base_import_packages r r: z"PrivateImportChecker.same_root_dir s]
4 : 4 - 3 3C 8 8 ;"d499;;+;&<&<&C&IIIr Nr r
r r )r r r r )r r4 r r )r* r> r r> )r rB r rC )r rI r* r> r r> )r rN r rO r r )r rb r rO r r )r re r rO r rf )rn ro r^ rB r rC )r rI ry rB r rC )__name__
__module__ __qualname__r msgsr r only_required_for_messagesr3 r= r+ staticmethodrA r, rL r[ rX r] r: r r r r r sn D
D+ + + + &U%&;<< =< &U%&;<<' ' ' =<'RG G G G
\
(%X %X %X %XN 8 \ < J J J \ J J Jr r r r
r r c J | t | d S rr )register_checkerr )r s r registerr s%
0 8 899999r Nr )__doc__
__future__r pathlibr typingr astroidr pylint.checkersr r pylint.interfacesr pylint.lint.pylinterr
r r r r r r s
? > " " " " " " . . . . . . . . " " " " " " .------oJ oJ oJ oJ oJ; oJ oJ oJd: : : : : :r