
    X-Ph%                   ~   U d Z ddlmZ ddlmZmZmZ ddlmZ ddl	m
Z
mZmZmZmZ ddlmZmZ ddlmZmZ ddlmZ dd	lmZmZ dd
lmZmZ ddlm Z m!Z! ddl"m#Z# ddl$m%Z%m&Z&m'Z'm(Z(m)Z) ddl*m+Z+m,Z, ddl-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZemfZfmgZgmhZhmiZimjZjmkZkmlZlmmZmmnZnmoZompZpmqZqmrZrmsZsmtZtmuZumvZvmwZwmxZxmyZymzZzm{Z{m|Z|m}Z}m~Z~mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlmZ ddlmZmZmZmZmZmZmZmZ ddlmZmZmZmZ ddlmZ ddlmZmZmZmZmZmZmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZmZmZmZmZmZmZmZ ddlmZ ddlmZ ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlmZmZmZ ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z mZmZmZmZmZmZmZmZm	Z	m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlmZmZ dd lmZ dd!lm Z m!Z!m"Z"m#Z#m$Z$ dd"l%m&Z&  ed#          Z'd$d%d&d'd(d)d*d+d,d-d.
Z(d/e)d0<   g d1Z*d/e)d2<   dZ+d/e)d3<   d4Z,d/e)d5<   d6Z-d/e)d7<   d8Z.d/e)d9<   d:Z/d/e)d;<   e0Z1d<e)d=<    G d> d?e&d@         ee          Z2dxdFZ3dydLZ4dzdMZ5d{dQZ6d|dWZ7d}dYZ8 G dZ d[e          Z9d}d\Z: G d] d^e          Z;d~daZ<ddeZ=ddhZ>ddlZ?ddnZ@ddqZAddtZBddwZCd@S )a  The semantic analyzer.

Bind names to definitions and do various other simple consistency
checks.  Populate symbol tables.  The semantic analyzer also detects
special forms which reuse generic syntax such as NamedTuple and
cast().  Multiple analysis iterations may be needed to analyze forward
references and import cycles. Each iteration "fills in" additional
bindings and references until everything has been bound.

For example, consider this program:

  x = 1
  y = x

Here semantic analysis would detect that the assignment 'x = 1'
defines a new variable, the type of which is to be inferred (in a
later pass; type inference or type checking is not part of semantic
analysis).  Also, it would bind both references to 'x' to the same
module-level variable (Var) node.  The second assignment would also
be analyzed, and the type of 'y' marked as being inferred.

Semantic analysis of types is implemented in typeanal.py.

See semanal_main.py for the top-level logic.

Some important properties:

* After semantic analysis is complete, no PlaceholderNode and
  PlaceholderType instances should remain. During semantic analysis,
  if we encounter one of these, the current target should be deferred.

* A TypeInfo is only created once we know certain basic information about
  a type, such as the MRO, existence of a Tuple base class (e.g., for named
  tuples), and whether we have a TypedDict. We use a temporary
  PlaceholderNode node in the symbol table if some such information is
  missing.

* For assignments, we only add a non-placeholder symbol table entry once
  we know the sort of thing being defined (variable, NamedTuple, type alias,
  etc.).

* Every part of the analysis step must support multiple iterations over
  the same AST nodes, and each iteration must be able to fill in arbitrary
  things that were missing or incomplete in previous iterations.

* Changes performed by the analysis need to be reversible, since mypy
  daemon strips and reuses existing ASTs (to improve performance and/or
  reduce memory use).
    )annotations)
CollectionIterableIterator)contextmanager)AnyCallableFinalTypeVarcast)	TypeAlias	TypeGuard)
errorcodesmessage_registry)constant_fold_expr)PROPERTY_DECORATOR	ErrorCode)Errorsreport_internal_error)TypeTranslationErrorexpr_to_unanalyzed_type)ErrorMessage)SUGGESTED_TEST_FIXTURESTYPES_FOR_UNIMPORTED_HINTSMessageBuilderbest_matches
pretty_seq)MroErrorcalculate_mro)x	ARG_NAMEDARG_POS	ARG_STAR2CONTRAVARIANT	COVARIANTGDEFIMPLICITLY_ABSTRACT	INVARIANTIS_ABSTRACTLDEFMDEFNOT_ABSTRACTPARAM_SPEC_KINDREVEAL_LOCALSREVEAL_TYPERUNTIME_PROTOCOL_DECOSSYMBOL_FUNCBASE_TYPESTYPE_VAR_KINDTYPE_VAR_TUPLE_KINDVARIANCE_NOT_READYArgKind
AssertStmtAssertTypeExprAssignmentExprAssignmentStmt	AwaitExprBlock	BreakStmt	BytesExprCallExprCastExprClassDefComparisonExprComplexExprConditionalExprContextContinueStmtDataclassTransformSpec	DecoratorDelStmtDictExprDictionaryComprehensionEllipsisExprEnumCallExpr
ExpressionExpressionStmtFakeExpression	FloatExprForStmtFuncBaseFuncDefFuncItemGeneratorExpr
GlobalDeclIfStmtImport	ImportAll
ImportBase
ImportFrom	IndexExprIntExpr
LambdaExprListComprehensionListExprLvalue	MatchStmt
MemberExprMypyFileNamedTupleExprNameExprNodeNonlocalDeclOperatorAssignmentStmtOpExprOverloadedFuncDefOverloadPartParamSpecExprPassStmtPlaceholderNodePromoteExpr	RaiseStmtRefExpr
ReturnStmt
RevealExprSetComprehensionSetExpr	SliceExprStarExpr	StatementStrExpr	SuperExpr
SymbolNodeSymbolTableSymbolTableNodeTempNodeTryStmt	TupleExprr   TypeAliasExprTypeAliasStmtTypeApplicationTypedDictExprTypeInfo	TypeParamTypeVarExprTypeVarLikeExprTypeVarTupleExpr	UnaryExprVar	WhileStmtWithStmt	YieldExprYieldFromExprget_member_expr_fullnameget_nongen_builtinsimplicit_module_attrsis_final_nodetype_aliasestype_aliases_source_versionstyping_extensions_aliases)Options)	AsPatternClassPatternMappingPattern	OrPatternSequencePatternSingletonPatternStarredPatternValuePattern)ClassDefContextDynamicClassDefContextPluginSemanticAnalyzerPluginInterface)dataclasses)ALWAYS_FALSEALWAYS_TRUE
MYPY_FALSE	MYPY_TRUEinfer_condition_value"infer_reachability_of_if_statement%infer_reachability_of_match_statement)Scope)EnumCallAnalyzer)NamedTupleAnalyzer)NewTypeAnalyzer)	ALLOW_INCOMPATIBLE_OVERRIDEPRIORITY_FALLBACKSSemanticAnalyzerInterfacecalculate_tuple_fallbackfind_dataclass_transform_spechas_placeholder
parse_boolrequire_bool_literal_argumentset_callable_name)TypedDictAnalyzer)TypeVarLikeScope)SELF_TYPE_NAMESFindTypeVarVisitorTypeAnalyserTypeVarDefaultTranslatorTypeVarLikeListanalyze_type_aliascheck_for_explicit_anydetect_diverging_aliasfind_self_typefix_instancehas_any_from_unimported_typeno_subscript_builtin_aliastype_constructorsvalidate_instance)function_typeget_type_vars"try_getting_str_literals_from_type)0ASSERT_TYPE_NAMESDATACLASS_TRANSFORM_NAMESDEPRECATED_TYPE_NAMESFINAL_DECORATOR_NAMESFINAL_TYPE_NAMESIMPORTED_REVEAL_TYPE_NAMESNEVER_NAMESOVERLOAD_NAMESOVERRIDE_DECORATOR_NAMESPROTOCOL_NAMESREVEAL_TYPE_NAMESTPDICT_NAMESTYPE_ALIAS_NAMESTYPE_CHECK_ONLY_NAMESTYPE_VAR_LIKE_NAMESTYPED_NAMEDTUPLE_NAMESUNPACK_TYPE_NAMESAnyTypeCallableTypeFunctionLikeInstanceLiteralTypeNoneType
Overloaded
ParametersParamSpecTypePlaceholderType
ProperTypeTrivialSyntheticTypeTranslator	TupleTypeTypeTypeAliasTypeTypedDictType	TypeOfAnyTypeType	TypeVarIdTypeVarLikeTypeTypeVarTupleTypeTypeVarTypeUnboundType	UnionType
UnpackTypeget_proper_typeget_proper_typeshas_type_varsis_named_instanceremove_dupstype_vars_as_args)is_invalid_recursive_aliasstore_argument_type)fill_typevars)correct_relative_import	is_dundermodule_prefixunmangleunnamed_function)NodeVisitorTnested_scopes
generatorsdivisionabsolute_importwith_statementprint_functionunicode_literalsbarry_as_FLUFLgenerator_stopr   )
z__future__.nested_scopesz__future__.generatorsz__future__.divisionz__future__.absolute_importz__future__.with_statementz__future__.print_functionz__future__.unicode_literalsz__future__.barry_as_FLUFLz__future__.generator_stopz__future__.annotationsr
   FUTURE_IMPORTS)objectboolfunctionCORE_BUILTIN_CLASSESSCOPE_GLOBAL   SCOPE_CLASS   
SCOPE_FUNC   SCOPE_COMPREHENSION   SCOPE_ANNOTATION
_TypeAliasTagc                     e Zd ZU dZg dZded<   ded<   ded<   ded	<   d
ed<   ded<   ded<   dZded<   ded<   ded<   ded<   ded<   dZdZdZ	dZ
ded<   ded<   ded<   dZdZdZd ed!<   d"ed#<   d$ed%<   dZd&ed'<   i Zd(ed)<   dd.Zedd/            Zedd1            Zedd2            Zedd3            Zedd5            Ze	 ddd8            Zdd;Zdd>Zdd?Z	 dddDZddEZddFZddHZddIZ ddNZ!ddOZ"e	 dddP            Z#ddSZ$ddUZ%ddVZ&ddYZ'dd^Z(ddaZ)ddfZ*ddiZ+ddjZ,ddlZ-eddo            Z.ddpZ/ddqZ0e1ddu            Z2ddvZ3ddxZ4dd{Z5dd|Z6dd}Z7dd~Z8ddZ9ddZ:ddZ;ddZ<ddZ=ddZ>ddZ?ddZ@ddZAddZBddZCddZDddZEddZFddZGddZHddZIddZJddZKddZLddZMddZNddZOddZPddZQddZRddZSddZTddZUddZVddZW	 d̐ddZXddZYddZZddZ[ddĄZ\	 dҐddƄZ]ddǄZ^ddȄZ_ddʄZ`dd̄ZaddτZbddЄZcddфZd	 dddԄZeddՄZfddքZgddׄZhddلZidd݄ZjddZkddZlddZmddZn	 dߐddZoddZpddZqddZrddZsddZtddZuddZvddZwdddZxddZyddZzddd
Z{ddZ|ddZ}ddZ~ddZddZddZddZddZddZddZddZddZddZddZddZ	 	 	 	 ddd%Zdd&Zdd'Zdd)Zdd,Zdd1Z	 	 	 	 	 	 ddd9Zdd<Zdd?Zdd@ZddCZddDZdddFZddHZddJZddLZddMZddNZddPZddQZddRZddTZd dXZdd`ZdddddaddjZddkZddlZddmZddpZddsZddtZdduZddvZddwZd	d{Zdd|Zdd}Zdd~Zd
dZddZddZddZddZddZddZddZddZddZddZddZddZddZddZddZddZddZddZÐddZĐddZŐddZƐd dZǐd!dZȐd"dZɐd#dZʐd$dZːd%dZ̐d&dZ͐d'dZΐd(dZϐd)dZАd*dZѐd+dZҐd,dĄZӐd-dƄZԐd.dȄZՐd/dʄZ֐d/d˄Zאd0d̈́Zؐd1dτZِd2dфZڐd3dӄZېd4dՄZܐd5dׄZݐd6dلZސd7dۄZߐd8d݄Zd9d߄Zd:dZd:dZd;dZd<dZd=dZd>dZd?dZd@dZdAdZdBdZdCdZdDdZdEdZdFdZ	 ddGdZdHd ZdHdZdIdZdHdZdJdZdKdZ	 ddGdZdLd	ZdMd
ZdNdZdOdZdPdZdQdZdRdZdSdZdSdZ ddTdZddUdZdVdZdWdZ	 	 	 	 	 	 dXdYd ZdZd!Z	 	 	 	 	 d[d\d$Zd]d%Zd^d'Z	d_d)Z
d`d*Zdad+Zedbd-            ZdҐdcd0Zddd2Zded4Zdd5Z	 	 	 dfdgd7Zdhd8Z	 ddid9Zdjd:Zdkd;Zedld>            Zdd?Zdd@ZddAZddBZdmdCZ	 d̐dndDZddEZdodHZddpdJZ dqdNZ!	 ddrdOZ"	 ddrdPZ#ddQZ$ddRZ%	 ddddSdsdZZ&ddtd[Z'dud]Z(dvd^Z)	 	 	 	 	 	 dwdxdaZ*dydbZ+dddddddddddddcdzdkZ,dd{dlZ-dddddddddddddcd|dmZ.d}doZ/d~dsZ0ddtZ1dddwZ2	 dddzZ3dd{Z4dd|Z5dd~Z6dŐdZ7ddZ8ddZ9ddZ:ddZ;ddZ<ddZ=ddZ>ddZ?ddZ@ddZAddZBddZCddZDdS (  SemanticAnalyzerzSemantically analyze parsed mypy files.

    The analyzer binds names and does various consistency checks for an
    AST. Note that type checking is performed as a separate pass.
    )patchesoptionscur_mod_nodedict[str, MypyFile]modulesr|   globalszlist[set[str]]global_declsnonlocal_declszlist[SymbolTable | None]locals	list[int]scope_stackblock_depthNTypeInfo | None_typezlist[TypeInfo | None]
type_stackr   
tvar_scoper   r"  zlist[FuncItem]function_stackFmissing_names$list[tuple[int, Callable[[], None]]]r!  
loop_depth set[str]importsr   errorsr   pluginzStatement | None	statementzdict[FuncDef, Type]wrapped_coro_return_typesmissing_modulesincomplete_namespacesreturnNonec                   dg| _         t          g| _        i | _        t	                      | _        d| _        g | _        g | _        t                      | _
        g | _        dg| _        dg| _        || _        || _        t!          ||          | _        || _        t	                      g| _        || _        g | _        i | _        || _        d| _        t3                      | _        g | _        d| _        d| _        d| _        d| _        d| _         dS )a  Construct semantic analyzer.

        We reuse the same semantic analyzer instance across multiple modules.

        Args:
            modules: Global modules dictionary
            missing_modules: Modules that could not be imported encountered so far
            incomplete_namespaces: Namespaces that are being populated during semantic analysis
                (can contain modules and classes within the current SCC; mutated by the caller)
            errors: Report analysis errors using this instance
        Nr   TF)!r)  r  r+  saved_localssetr7  r.  r/  incomplete_type_stackr   r0  r1  r,  r4  r8  r%  r   msgr<  r2  r=  all_exports
export_mapr9  recurse_into_functionsr   scopedeferral_debug_contextbasic_type_applicationsallow_unbound_tvarscurrent_overload_iteminside_except_star_block$return_stmt_inside_except_star_block)selfr%  r<  r=  r8  r9  s         L/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/mypy/semanal.py__init__zSemanticAnalyzer.__init__  s   & f(>  	 uu
13"*,, 3#!&'22.!eeW &;"&(02 '+#WW
 >@# (-$
 $)  26" /4%:?111    c                    | j         S N)r.  rO  s    rP  typezSemanticAnalyzer.type  s
    zrR  r  c                    | j         S rT  )_is_stub_filerU  s    rP  is_stub_filezSemanticAnalyzer.is_stub_file  s    !!rR  c                    | j         S rT  )_is_typeshed_stub_filerU  s    rP  is_typeshed_stub_filez&SemanticAnalyzer.is_typeshed_stub_file  s    **rR  c                    | j         S rT  )_final_iterationrU  s    rP  final_iterationz SemanticAnalyzer.final_iteration  s    $$rR  Iterator[None]c              #  V   K   | j         }d| _         	 d V  || _         d S # || _         w xY wNTrK  )rO  olds     rP  allow_unbound_tvars_setz(SemanticAnalyzer.allow_unbound_tvars_set  sF      &#' 	+EEE'*D$$$sD$****s    	(valueentering_loopc              #     K   | j         }|| _         |s| j        }|| _        	 d V  || _         |s	|| _        d S d S # || _         |s|| _        w xY wrT  )rM  rN  )rO  rf  rg  rd  old_return_stmt_flags        rP  inside_except_star_block_setz-SemanticAnalyzer.inside_except_star_block_set  s       +(-%  	>#'#L 8=D5	QEEE,/D)  Q<P999Q Q -0D)  Q<P9PPPPs	   : A	file_noderc   c                D   d| j         v r(t          t          | j         d                   |j        d<   |j        dk    r|                     |           |j        dk    r|                     |t                     |j        dk    r|                     |t                     dS dS )z4Prepare a freshly parsed file for semantic analysis.builtins__builtins__typingtyping_extensionsN)	r%  r}   r%   namesfullnameprepare_builtins_namespaceprepare_typing_namespacer   r   )rO  rk  s     rP  prepare_filezSemanticAnalyzer.prepare_file'  s    %%.=dDLQ[D\.].]ION+++++I666)))))\BBB!444)))5NOOOOO 54rR  aliasesdict[str, str]c                <    dfd j                    dS )zRemove dummy alias definitions such as List = TypeAlias(object) from typing.

        They will be replaced with real aliases when corresponding targets are ready.
        defslist[Statement]r>  r?  c                   |                                  D ]}t          |t                    r6|j        D ]} |j                   |j        r |j        j                   t          |t
                    rkt          |j                  dk    rSt          |j        d         t                    r3j	         d|j        d         j
         v r|                     |           d S )Nr  r   .)copy
isinstancerV   body	else_bodyr8   lenlvaluesre   rr  nameremove)ry  stmtr  rv  rk  helpers      rP  r  z9SemanticAnalyzer.prepare_typing_namespace.<locals>.helper?  s    		 * *dF++ 4 $	 * *ty))))~ 4t~2333t^44*DL))Q.."4<?H== / $,EEt|A/CEEPPD)))* *rR  N)ry  rz  r>  r?  )ry  )rO  rk  rv  r  s    ``@rP  rt  z)SemanticAnalyzer.prepare_typing_namespace2  sG    	* 	* 	* 	* 	* 	* 	* 	*  	y~rR  c                b   |j         }t          D ]^}t          |t          g                     }t	          t                      |d          }d| |_        t          t          |          ||<   _|d         j	        }t          |t                    sJ t          |g           }dt                      fdt          t          j                  fdt          t          j                  fd|fd|fd	|fg}|D ]<\  }}	t!          ||	          }
d| |
_        t          t          |
          |j         |<   =d
S )zAdd certain special-cased definitions to the builtins module.

        Some definitions are too special or fundamental to be processed
        normally from the AST.
        rm  	builtins.r  r?  reveal_typereveal_localsTrueFalse	__debug__N)rq  r  r?   r:   r   r|   	_fullnamer}   r%   noder~  r   r   r   r   special_formr   )rO  rk  rq  r  cdefinfo	bool_info	bool_typespecial_var_typestypvs              rP  rs  z+SemanticAnalyzer.prepare_builtins_namespaceQ  sG     ) 	6 	6DD%)),,DKMM4<<D///DN)$55E$KK&M&	)X.....Y++	 XZZ  GI$:;;< gi&<==>Yi )$5
 + 	= 	=ID#D#A,d,,AK$3D!$<$<IOD!!	= 	=rR  r  &MypyFile | FuncDef | OverloadedFuncDefr_  active_typec                Z   || _         d| _        d| _        || _        t	                      | j        d<   |                     |||          5  t          |t                    r| 	                    |           nd| _
        |                     |           ddd           n# 1 swxY w Y   | ` dS )z8Refresh a stale target in fine-grained incremental mode.FTN)r!  deferred
incompleter^  rB  r2  file_contextr~  rc   refresh_top_levelrG  accept)rO  r  r!  r_  rk  r"  r  s          rP  refresh_partialz SemanticAnalyzer.refresh_partial{  s      /!$2y';?? 	" 	"$)) "&&t,,,,.2+D!!!	" 	" 	" 	" 	" 	" 	" 	" 	" 	" 	" 	" 	" 	" 	" LLLs   
ABB"%B"c                :   | j         j        rd| j         j        sXt          t	          t
          j                            }d|_        d|_        d|_	        d|_
        |                     d|           d| _        |                     |           |j        D ]}|                     |           |j        dk    r|                     |           |j        dk    r|                     |           |                                  | j        | j        | j        <   g | _        dS )zDReanalyze a stale module top-level in fine-grained incremental mode.r  r   zG--local-partial-types must be enabled if using --allow-redefinition-newFro  rp  N)r"  allow_redefinition_newlocal_partial_typesr~   r   r   r  linecolumnend_line
end_columnfailrG  add_implicit_module_attrsry  r  rr  add_builtin_aliasesadd_typing_extension_aliasesadjust_public_exportsrE  rF  
cur_mod_id)rO  rk  nds       rP  r  z"SemanticAnalyzer.refresh_top_level  s   <. 	dt|7W 	d!78899AAFAHAJALII_abccc&+#&&y111 	 	AKKNNNN))$$Y///!444--i888""$$$+/+;(rR  c           	        |                      d          }|t          d          }t          j                    D ]\  }}|dk    r|}n|dk    rZ|                                s+|                      d|g          }|(| j        r
J d            |                                   dS |}n/|dk    r\|                      d|t          t          j	                  g          }|(| j        r
J d	            |                                   dS |}n|d
k    r| j
        j        r|                      d          }n|                      d          }|@| j        r"|                      d          }|
J d            n|                                   dS |j        dk    r"t          j        |t                      g          }|}n|J d|             t          |          }|j                            |          }|t%          |j        t(                    s|                     |          }|rVt-          ||          }	|                     |          |	_        d|	_        |                     ||	t7                                 D|                     |t)          |                     |          |d          t7                                 dS )z;Manually add implicit definitions of module '__name__' etc.builtins.strN__doc____path__zbuiltins.listz)Cannot find builtins.list to add __path____annotations__builtins.dictz0Cannot find builtins.dict to add __annotations____spec__builtins.objectzimportlib.machinery.ModuleSpeczCannot find builtins.object__main__ztype should be specified for Tr  )named_type_or_noner   r   itemsis_package_init_filer_  deferr   r   r  r"  use_builtins_fixturesr  r   
make_unionr   rq  getr~  r  rn   	anal_typer   qualified_namer  is_ready
add_symboldummy_context)
rO  rk  str_typer  tr  instexistingan_typevars
             rP  r  z*SemanticAnalyzer.add_implicit_module_attrs  s
    $ 7 7 G G">22H,244 =	 =	GD!y  $## 5577  ..
KK<#3``5````JJLLLFF***..#h	8N0O0O%P  < 0J JIJ J J JJLLLFF##<5 U223DEEDD223STTD<+ #667HII#//1N////

>Z//$/xzz0BCCD}}&Ld&L&L}}}!!nn **400H#Jx}o,V,V#nnS))G 
$(( $ 3 3D 9 9#c=??;;;;#D$7$7$=$=y"MM!OO   s=	 =	rR  treec                `   |j         dk    sJ t          j                    D ]\  }}|t          v rt          |         | j        j        k    r*|                    d          d         }||j        v r&t          |j        |         j	        t                    st|                     ||||           dS )aa  Add builtin type aliases to typing module.

        For historical reasons, the aliases like `List = list` are not defined
        in typeshed stubs for typing module. Instead we need to manually add the
        corresponding nodes on the fly. We explicitly mark these aliases as normalized,
        so that a user can write `typing.List[int]`.
        ro  r|  r  N)rr  r   r  r   r"  python_versionsplitrq  r~  r  rn   create_aliasrO  r  aliastarget_namer  s        rP  r  z$SemanticAnalyzer.add_builtin_aliases  s     }(((("."4"6"6 
	> 
	>E;55507$,:UUU ;;s##B'Dtz!!*TZ5E5JO*\*\!dK====
	> 
	>rR  c                L   |j         dk    sJ t          j                    D ]\  }}|                    d          d         }||j        v r&t          |j        |         j        t                    rO|j                            |d           | 	                    ||||           dS )zTyping extensions module does contain some type aliases.

        We need to analyze them as such, because in typeshed
        they are just defined as `_Alias()` call.
        Which is not supported natively.
        rp  r|  r  N)
rr  r   r  r  rq  r~  r  r   popr  r  s        rP  r  z-SemanticAnalyzer.add_typing_extension_aliases  s     } 33333";"A"C"C 		> 		>E;;;s##B'Dtz!!jD1A1F	&R&R! JNN4&&& dK====		> 		>rR  r  strr  r  c                d   |                                  }|                     |          }|rt          |j        t                    r|                     ||           d S |                     |g           }|J t          || j        | j	        d| j
                   t          ||dddd          }|                     |||           d S |                     |          r|                     ||           d S ||j        v r1t          |j        |         j        t                    sJ |j        |= d S d S )NFdisallow_anyr"  r  T)r  r  no_args
normalized)track_incomplete_refslookup_fully_qualified_or_noner~  r  rn   mark_incompleter  r   r  noter"  r   r  found_incomplete_refrq  )	rO  r  r  r  r  tagr  target
alias_nodes	            rP  r  zSemanticAnalyzer.create_alias  sh   ((**//<< 	%!&/22 8$$T400000 00bAA)))DItyudl    ' #  
 j$77777&&s++ 	%  t,,,,, tz!!!$*T"2"7IIIIIJt$$$ "!rR  c                    d| j         v r>| j                                         D ]&\  }}|| j        v rd|_        d|_        d|_        %dS dS )z7Adjust the module visibility of globals due to __all__.__all__TFN)r&  r  rE  module_publicmodule_hidden)rO  r  gs      rP  r  z&SemanticAnalyzer.adjust_public_exports7  sk    $$<--// , ,a4+++&*AO&+AOO ',AOO %$, ,rR  c              #    K   | j         }|| _        | j                            |j        |j        ||           || _        |j        | _        |                    | j                  5  |j        	                                
                    d          | _        |                    |          | _        |j        | _        t!                      | _        t%          || | j                  | _        t+          || | j                  | _        t/          ||           | _        t3          || | j                  | _        d| _        |r|j                            dd          d         }d|v r=|                     |          }|r&t=          |j        t@                    r|j        | _!        | "                    |j#        j$        |j#                   | j%        &                    d           |'                    |           | '                    |j#        j(                   |j#        j)        D ]}| j        *                    |           dV  |rg|+                                 | +                                 d| _!        | j%        ,                                 | -                    |j#        j$                   ddd           n# 1 swxY w Y   | `dS )zConfigure analyzer for analyzing targets within a file/class.

        Args:
            file_node: target file
            options: options specific to the file
            active_type: must be the surrounding class to analyze method targets
        )rH  r"  z.pyir   r|  r  FN).rH  r"  r8  set_filepathrr  r#  r  module_scopelowerendswithrX  is_typeshed_filer[  rq  r&  r   r0  r   rD  named_tuple_analyzerr   typed_dict_analyzerr   enum_call_analyzerr   newtype_analyzernum_incomplete_refsrsplitr  r~  r  r   r.  push_type_argsdefn	type_argsrC  appendenter_classr  	type_varsbind_existingleave_classr  pop_type_args)rO  rk  r"  r  rH  enclosing_fullnameenclosing_nodetvars           rP  r  zSemanticAnalyzer.file_contextD  s      
Y^Y-?uV]^^^%#,00 #	? #	?!*!5!5!7!7!@!@!H!HD*3*D*DW*M*MD'$?DL.00DO(:7D$((S(SD%'8$'Q'QD$&6w&E&ED#$3GT48$L$LD! ()D$ 8%0%9%@%@a%H%H%K",,,%)%H%HI[%\%\N% 9*^5H(*S*S 9%3%8
##K$4$>@PQQQ*11%888!!+...  !1!6777',6 8 8DO11$7777EEE ?!!###  """!
*..000"";#3#=>>>G#	? #	? #	? #	? #	? #	? #	? #	? #	? #	? #	? #	? #	? #	? #	?H LLLs   &IJ77J;>J;r  rR   c                V   || _         |j        D ]#}|j        r|j                            |            $| j        d         dk    |_        |                     |j                  |_        | j	        rt          | j                  dk    r#|j        s|j        s|                     |           | j	        sd S | j                            |          5  |                     d          5  |                     |           d d d            n# 1 swxY w Y   d d d            d S # 1 swxY w Y   d S )Nr  r   F)rf  )r:  	argumentsinitializerr  r,  is_conditionalr  r  r  rG  r  r1  is_decoratedis_overloadadd_function_to_symbol_tablerH  function_scoperj  analyze_func_def)rO  r  args      rP  visit_func_defzSemanticAnalyzer.visit_func_def~  s    > 	- 	-C -&&t,,,".r2Q6 ,,TY77 * 	8c$2E.F.F.J.J$ 8T-= 811$777* 	FZ&&t,, 	, 	,222?? , ,%%d+++, , , , , , , , , , , , , , ,	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	, 	,s6   D$D:DD
	
DD
	DD"%D"rr  c                ,    | j         |S | d| j          S )N#rL  rO  rr  s     rP  function_fullnamez"SemanticAnalyzer.function_fullname  s'    %-O99T7999rR  c                n   |                      |j        |          |                     |           d S | j                            |           |j        r8t          |j        t                    sJ |                     |j        |          }nd}| j        	                                 | 
                                r| j        J | j        |_        |j        }|j        dv rtt          |j        t                    sJ t          t          |j        j                  t                    r,|j                            t#                                |_        |                     || j        |           |                     |j                  }|                     | j                            |                    5  |j        r|                     |j                   t          |j        t                    sJ |                                 }|                                 }|                    |j        d|          }|                     |          st;          |          r=|                     |           |                     |j                   	 d d d            d S t          |t>                    sJ t          |t                    r| 
                                o|j          }|j!        rNtD          |j#        |d          vr8| $                    d|tJ          j&                   |                    d           }|j'        rNtD          |j#        |d          vr8| $                    d|tJ          j&                   |                    d 	          }| (                    ||          }|r7| j        0| j        }|j)        "|j)        gtU          |j+                  z   |_+        ||_        | ,                    |j-                   | .                    |           t          |t^                    r6t          |j        t                    sJ ta          |j        |          |_        d d d            n# 1 swxY w Y   | 1                    |           | 2                    |           | 
                                r| j        J | j        j3        r]| j4        sVt          | j5        j6        tn                    r|j8        r0|j9        tt          k    r tw          |j<                  rtz          |_9        tw          |j<                  r| j4        s|j9        t|          k    rd
|_;        |j?        rt          |j        t                    r| j@        A                    |          |j        k    r|jB        rnwt          t          jD                  }	| E                    d|	|	|j        j        g          }
|

J d            |j                            |
          |_        |j        | j@        |<   |                     |j                   d S )NF)rQ  __init_subclass__)ret_type)nested	namespacez3TypeGuard functions must have a positional argumentcode)
type_guardz2"TypeIs" functions must have a positional argument)type_isTztyping.Coroutinez*Internal error: typing.Coroutine not found)Fr  r  r  r1  r  rV  r~  r   update_function_type_variablesr  is_class_scoper  r  r   r  r   copy_modifiedr   prepare_method_signaturer  rr  tvar_scope_framer0  method_framecheck_classvar_in_signaturetype_analyzerr  visit_callable_typer  r   r  r   	is_staticr  r!   	arg_kindsr  codes
VALID_TYPEr  remove_unpack_kwargs	self_typelist	variablesadd_type_alias_depsaliases_usedcheck_function_signaturerR   r   analyze_arg_initializersanalyze_function_bodyis_protocolrY  rH  r  rj   is_propertyabstract_statusr(   is_trivial_bodyr  r&   r+   is_coroutiner;  r  is_async_generatorr   r  r  )rO  r  has_self_typerr  analyzerr  result	skip_selfr  any_typer  s              rP  r
  z!SemanticAnalyzer.analyze_func_def  s   t~t44<JJtF""4(((9 	"di66666 ??	4PPMM!M!!!   	J9(((	DIy$6W)W)W!$)\:::::odi.@AA7KK M $	 7 7 7 L LDI))$	=III ))$-88""4?#?#?#I#IJJ ,	C ,	Cy +C00;;;!$)\:::::  --//0022!55diYa5bb,,S11 _V5L5L JJt$$$&&t~666,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C "&*55555fl33 Y $ 3 3 5 5 Ldn:LI( GWF<LYZZ<X-X-X		Q"!&!1 "    "(!5!5!5!F!F~ D'9I)**9U*U*U		P"!&!1 "   
 "(!5!5d!5!C!C!66tVDDF$ Y)>#y>504/?$vGWBXBX/XF,"	(()>???--d333dG,, C%di>>>>> 1$)T B BDIY,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C ,	C\ 	%%d+++""4(((   	,9((( 	%;); $DJ$79JKK; PTO_; (K77#DI.. 8 (;$	**,), (L88'+$ 	A49l33	A .22488DIEE& A #9#9::22&8TY=O(P   ++-Y+++ I33X3FF	7;y.t44>*****s   7CQ+GQ++Q/2Q/r  r   c                f   |j         r|j         d         t          j        ur|S |j        d         }t	          |t
                    s|S t          |j                  }t	          |t                    sV| 	                    d|           |j        d d         t          t          j                  gz   }|                    |          S t          |j                  t          |j                  z  }|                    |j        d                    |rxd                    d |D                       }| 	                    d| |           |j        d d         t          t          j                  gz   }|                    |          S |j        d d         |gz   }|                    |d          S )	Nr  z.Unpack item in ** argument must be a TypedDict	arg_typesz, c                    g | ]}d | d 	S )" .0r  s     rP  
<listcomp>z9SemanticAnalyzer.remove_unpack_kwargs.<locals>.<listcomp>#  s     #D#D#DDKKKK#D#D#DrR  z7Overlap between argument names and ** TypedDict items: T)r>  unpack_kwargs)r%  r4   r"   r>  r~  r   r   rV  r   r  r   r   
from_errorr  rB  	arg_namesr  discardjoin)rO  r  r  	last_typenew_arg_typesoverlap
overlappeds          rP  r(  z%SemanticAnalyzer.remove_unpack_kwargs  s   } 	b 19J J JJM"%	)Z00 	J#IN33	)]33 	>IIF	RRRM#2#.'):N2O2O1PPM$$}$===cm$$s9?';';;b)*** 	>#D#DG#D#D#DEEJII\PZ\\^bcccM#2#.'):N2O2O1PPM$$}$===crc*i[8  = MMMrR  funcr  r   r7  c                   |j         }|j        dk    rd|_        |j        r|j        dk    r|j        dv rd|_        |j        s|                     d|           dS t          |t                    rWt          |j	        d                   }t          |t                    rx|r"| j         | j         j        J | j         j        }nd|_        t          |          }|j        s|j        dk    r|                     |          }t          ||          |_         dS |rt          |j        t                    rt          t          |j        j	        d                   t                    sh|                     ||j        p
|j        dk              r$|                     d|t$          j                   dS |                     d	|           dS dS dS dS dS |r|                     d
|           dS dS )zICheck basic signature validity and tweak annotation of self/cls argument.__new__T)r  __class_getitem__zKMethod must have at least one argument. Did you forget the "self" argument?r   Nz9Redundant "Self" annotation for the first method argumentr  z9Method cannot have explicit self annotation and Self typez#Static methods cannot use Self type)rV  r  r$  is_classr  r  r~  r   r   r>  r   r)  is_trivial_selfr   
class_typereplace_implicit_first_typeunanalyzed_typeis_expected_self_typer&  REDUNDANT_SELF_TYPE)rO  rN  r  r7  functyper)  leading_types          rP  r  z)SemanticAnalyzer.prepare_method_signature+  sW    99	!!!DN~ %	Ci!7!7yFFF $>  		a     Hl33 +H,>q,ABB	i11 $ ;#y49L9X9X9X-1Y-@/3,'4T':':} E	Y(>(>'+|'D'D ;Hl S SDIII" z$2F'U'U %od6J6TUV6W&X&XZabb 55%t}'N	Y8N  
 !II [ $%*%> &      !II []a    3       	CII;TBBBBB	C 	CrR  r   is_classmethodc                   | j         J t          |          }|rt          |t                    r|                     |j        d          S t          |t                    r|                     |j        |d          }|k|j	        dk    s7|j	        dk    rU| j
        s%|                     d          s| j        j        d	k    r)|j        r"|                     |j        d
         d          S dS t          |t                    r|| j         j        k    S t          |t                    r/|                     |j        |d          }|duo|j	        t"          v S dS )zODoes this (analyzed or not) type represent the expected Self type for a method?NF)r[  Tsuppress_errorsztyping.Typebuiltins.typer   )r  	   r   )rV  r   r~  r   rW  itemr   lookup_qualifiedr  rr  rY  is_future_flag_setr"  r  argsr   r)  r   )rO  r  r[  syms       rP  rW  z&SemanticAnalyzer.is_expected_self_typeX  sv   y$$$c"" 	#x(( R11#(51QQQ#{++ Y++CHc4+PPO55LO;; $ 1 < $(#:#:=#I#I < $(<#>&#H#H 	 $I  55chqkRW5XXX5c;'' 	.$)---c;'' 	G''#t'LLCd?Fs|'FFurR  previousNode | NonenewFuncDef | Decoratorc                .   t          |t                    r|j        }t          |t          t          f          r*t	          |j                  rt	          |j                  rdS t          |t          t          t          f          r|j        r	||_        dS dS )a  If 'new' conditionally redefine 'previous', set 'previous' as original

        We reject straight redefinitions of functions, as they are usually
        a programming error. For example:

          def f(): ...
          def f(): ...  # Error: 'f' redefined
        TF)	r~  rF   rN  rR   r  r  r   r  original_def)rO  rf  rh  s      rP  set_original_defz!SemanticAnalyzer.set_original_defy  s     c9%% 	(Cx'9!566	 **	 !//	
 4h#y 9:: 	s?Q 	'C45rR  fun_typerS   c                0                          |j                  }                      j                            |                    5                                   }|                    ||          \  |_        }|r j         	                                 |j
        r]d |j        D             } fd|j
        D             }t          ||z
            }|r% j                            d |D             |           |cddd           S # 1 swxY w Y   dS )zMake any type variables in the signature of defn explicit.

        Update the signature of defn to contain type variable definitions
        if defn is generic. Return True, if the signature contains typing.Self
        type, or False otherwise.
        Nc                    h | ]	}|j         
S rA  rr  rC  r  s     rP  	<setcomp>zBSemanticAnalyzer.update_function_type_variables.<locals>.<setcomp>  s    "J"J"J!1:"J"J"JrR  c                D    h | ]}                     |j                  S rA  )r  r  )rC  prO  s     rP  rr  zBSemanticAnalyzer.update_function_type_variables.<locals>.<setcomp>  s)    %Z%Z%Zad&9&9!&&A&A%Z%Z%ZrR  c                D    g | ]}|                     d           d         S )r|  r  r  )rC  r  s     rP  rD  zCSemanticAnalyzer.update_function_type_variables.<locals>.<listcomp>  s'    999ab)999rR  )r  rr  r  r0  r   r"  bind_function_type_variablesr+  rV  setup_self_typer  sortedrD  "type_parameters_should_be_declared)	rO  rm  r  rr  ar7  bound_fullnamesdeclared_fullnamesextras	   `        rP  r  z/SemanticAnalyzer.update_function_type_variables  s{    ))$-88""4?#?#?#I#IJJ 	! 	!""$$A010N0NxY]0^0^-H '!6$$&&&~ "J"Jx7I"J"J"J%Z%Z%Z%Z4>%Z%Z%Z"1CCDD H??9959994   !	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	! 	!s   	B5DDDc           
     z   | j         J | j         }|j        Pt          |j        j                  r5|                     dd||j        j        t          |          k               ndS t          d|j         dt          d          g t          |          t          t          j                            |_        dS )zSetup a (shared) Self type variable for current class.

        We intentionally don't add it to the class symbol table,
        so it can be accessed only by mypy and will not cause
        clashes with user defined names.
        NzSelf upper boundforce_progressSelfz.Selfr   )idvaluesupper_bounddefault)rV  r)  r   r  process_placeholderr   r   rr  r   r   r   from_omitted_genericsrO  r  s     rP  rx  z SemanticAnalyzer.setup_self_type  s     y$$$y>%t~9:: 	((&#'>#=tATAT#T	 )     $}###||%d++I;<<
 
 
rR  rj   c                    || _         |                     |           | j        sd S | j                            |          5  |                     |           d d d            d S # 1 swxY w Y   d S rT  )r:  r  rG  rH  r	  analyze_overloaded_func_defrO  r  s     rP  visit_overloaded_func_defz*SemanticAnalyzer.visit_overloaded_func_def  s    ))$///* 	F Z&&t,, 	3 	3,,T222	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3s    A##A'*A'ra  
int | Nonec              #  H   K   || _         	 d V  d | _         d S # d | _         w xY wrT  r  )rO  ra  s     rP  overload_item_setz"SemanticAnalyzer.overload_item_set  s>      %)"	.EEE)-D&&&D&----s    	!c                V   |                      |j                  |_        |j                                        |_        |j        d         }d|_        |                     d          5  |                    |            d d d            n# 1 swxY w Y   d }dt          |t                    rr|j        j        rfdd|j        _        |                     |          }t          |j        |                     d                    }t          |t                     sJ |g}n|                     |          \  }}}||_        |r)|                     ||t)          |          dk               |&||j        d         u sJ |j        d d         |_        n|s|                     |           |rt-          fdt/          |j                  D                       sZt1          |          |_        |j        |j        _        t          |t                    r |r|d         |j        _        ||j        _        |j        s|j        s|j        d         |_        d S |                     |           |                     |           |                     |           |                      |           d S )Nr   TFbuiltins.function)some_overload_decoratorsr  c              3     K   | ]>\  }}t          |t                    o!t          |j                  |d k    ssdnd k    V  ?dS )r   r  N)r~  rF   r  
decorators)rC  iitr2  s      rP  	<genexpr>z?SemanticAnalyzer.analyze_overloaded_func_def.<locals>.<genexpr>  so       
 
 2 r9%% LBM""1q555aaK
 
 
 
 
 
rR  )!r  r  r  unanalyzed_itemsr}  r  r  r  r  r~  rF   rN  r2  +analyze_property_with_multi_part_definitionr   
named_typer   analyze_overload_sigs_and_implimpl"handle_missing_overload_decoratorsr  &handle_missing_overload_implementationany	enumerater   rV  r  r  setter_typeprocess_deprecated_overloadprocess_final_in_overload*process_static_or_class_method_in_overloadprocess_overload_impl)	rO  r  
first_itembare_setter_typer  typesr  non_overload_indexesr2  s	           @rP  r  z,SemanticAnalyzer.analyze_overloaded_func_def  s    ,,TY77*//11
Z]
!%
##A&& 	$ 	$d###	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$  j),, 	B1L 	BK*.JO'#OOPTUU
AT1U1UVVCc<00000EEE
 150S0STX0Y0Y-E4-DI# 77.UVW 8   
 tz"~----!Z_

) B;;DAAA 	> 
 
 
 
 #4:..
 
 
 
 
 	> #5))DI!YDIN *i00 >5E >&+Ah
#-=
*z 	 9 6 !1"5	F 	((...&&t,,,77===""4(((((s   (B

BBc                F   |j         rd S t          |j        x}t                    r@|j        j        x}2||_        |j        D ]#}t          |t                    r||j        _        $|j        D ]}d}t          |t                    r|j        D ]}|r1t          |t                    r| j
                            d|           5|                     |          x}Fd}t          |j        j        x}t                    rd| d}nd}d| d|j         d| |j        _        d S )NFz-@overload should be placed before @deprecatedT overloadzof function  is deprecated: )r2  r~  r  rF   rN  
deprecatedr  r  refers_to_fullnamer   rD  r  get_deprecatedrV  r   rr  )	rO  r  r  r  ra  deprecationr  r  typestrs	            rP  r  z,SemanticAnalyzer.process_deprecated_overload(  sm    	Fdi'd33 	69//Z<(DO
 6 6dI.. 6+5DI(J 	 	DK$	**   A" '9!^'L'L &UWXYYYY(,(;(;A(>(>>*K&*%TY^&;c\JJ *&0#jjjGG&)G,w , ,DM , ,), , 	,	 	rR  
expressionrL   
str | Nonec                    t          | t                    rXt          | j        t                    r>t          | j        x}          dk    r$t          |d         x}t                    r|j        S d S Nr  r   )	r~  r=   r  calleer   r  rd  ry   rf  )r  rd  r  s      rP  r  zSemanticAnalyzer.get_deprecatedE  ss     z8,,	$":#46KLL	$ Z_,T--22a0:':: 3 ##trR  c                P   |j         dS t          |j         t                    r|j         n|j         j        }t	          |j                  rU|                                 rC| j        s>| j        J | j        j	        rt          |_        |j        t          k    rd|_        dS dS dS dS dS )zSet flags for an overload implementation.

        Currently, this checks for a trivial body in protocols classes,
        where it makes the method implicitly abstract.
        NT)r  r~  rR   rN  r4  r  r  rY  rV  r1  r&   r3  r+   )rO  r  r  s      rP  r  z&SemanticAnalyzer.process_overload_implP  s     9F&ty'::Ntyy	49%% 	,$*=*=*?*? 	,HY 	,9(((y$ ;':$#|33'+$$$	, 	, 	, 	, 	, 	, 43rR  9tuple[list[CallableType], OverloadPart | None, list[int]]c                   g }g }d}t          |j                  D ]\  }}|dk    rfd|_        |                     |t	          |j                  dz
  k     r|nd          5  |                    |            ddd           n# 1 swxY w Y   t          |t                    rt          |j	        | 
                    d                    }t          |t                    sJ t          d |j        D                       s;|t	          |j                  dz
  k    r
| j        s|}nY|                    |           nCd|j	        _        |                    |           |j        j        r|                     d|           |xj        |j	        j        z  c_        ~t          |t(                    r;|t	          |j                  dz
  k    r| j        s|}|                    |           |||fS )zFind overload signatures, the implementation, and items with missing @overload.

        Assume that the first was already analyzed. As a side effect:
        analyzes remaining items and updates 'is_overload' flags.
        Nr   Tr  r  c              3  @   K   | ]}t          |t                    V  d S rT  )r  r   )rC  decs     rP  r  zBSemanticAnalyzer.analyze_overload_sigs_and_impl.<locals>.<genexpr>u  s-      ^^s-c>BB^^^^^^rR  z!An overload can not be a property)r  r  r  r  r  r  r~  rF   r   rN  r  r   r  r  rY  r  r  r2  r  is_explicit_overriderR   )rO  r  r  r  r  r  ra  callables           rP  r  z/SemanticAnalyzer.analyze_overload_sigs_and_impl`  s;    !$( ,, 	3 	3GAtAvv#' ++S__q5H1H1HAAdSS & &KK%%%& & & & & & & & & & & & & & & $	** 3(DOODW4X4XYY!(L99999^^do^^^^^ MC
OOa///8I/#
 -33A6666,0DI)LL***x+ M		"EtLLL ))TY-KK)))D'** 3DJ!+++D4E+DD(//222d000s    BB		B	r  r  c                   |rP|D ]L}| j         r"|                     d|j        |                    +|                     d|j        |                    Mnr|dd         D ]4}|                     |j        |j        |         |j        d                    5|j        r,|                     |j        |j        |j        d                    t          |          D ]
}|j        |= dS )zoGenerate errors for overload items without @overload.

        Side effect: remote non-overload items.
        zJAn implementation for an overloaded function is not allowed in a stub filez<The implementation for an overloaded function must come lastr  Nr   )rY  r  r  name_already_definedr  r  reversed)rO  r  r  r  idxs        rP  r  z3SemanticAnalyzer.handle_missing_overload_decorators  s    $ 	O+  $ 
II8
3    IIV
3    ,ABB/ U U))$)TZ_djQRmTTTTy O))$)TY
1NNN011 	  	 C
3	  	 rR  c                   | j         s| j        r_| j        j        rS|                                 s?|j        D ]5}t          |t                    rt          |j        _	        )t          |_	        6dS t          d |j        D                       rD|j        r;t          |j        d         t                    sJ d|j        d         j        _        dS dS |                     d|t          j                   dS dS )zFGenerate error about missing overload implementation (only if needed).c              3  j   K   | ].}t          |t                    o|j        j        t          k    V  /d S rT  )r~  rF   rN  r3  r(   rC  ra  s     rP  r  zJSemanticAnalyzer.handle_missing_overload_implementation.<locals>.<genexpr>  sO         4++X	0I[0X     rR  r   TzFAn overloaded function outside a stub file must have an implementationr  N)rY  rV  r1  is_func_scoper  r~  rF   r(   rN  r3  allr4  r  r&  NO_OVERLOAD_IMPL)rO  r  ra  s      rP  r  z7SemanticAnalyzer.handle_missing_overload_implementation  s5     	y TY2 4;M;M;O;O  !J ; ;D!$	22 ;4?	11/:,,	; ;
    J     
 : >%djmY?????9=DJqM&666> > 		\/      %	 	rR  c                   t          d |j        D                       rd|_        t          d |j        D                       }| j        s|                     d|           nbt          d |j        dd         D                       r<t          d |j        dd         D                       }|                     d	|           |j        |j        j        rd|_        dS dS dS )
zHDetect the @final status of an overloaded function (and perform checks).c              3  $   K   | ]}|j         V  d S rT  is_finalr  s     rP  r  z=SemanticAnalyzer.process_final_in_overload.<locals>.<genexpr>  s$      44t}444444rR  Tc              3  (   K   | ]}|j         	|V  d S rT  r  rC  ovs     rP  r  z=SemanticAnalyzer.process_final_in_overload.<locals>.<genexpr>  s)      DDBDRDDDDDDrR  z8@final should be applied only to overload implementationc              3  $   K   | ]}|j         V  d S rT  r  r  s     rP  r  z=SemanticAnalyzer.process_final_in_overload.<locals>.<genexpr>  s$      >>tT]>>>>>>rR  r  Nc              3  (   K   | ]}|j         	|V  d S rT  r  r  s     rP  r  z=SemanticAnalyzer.process_final_in_overload.<locals>.<genexpr>  s)       L L L L L L L L LrR  z@In a stub file @final must be applied only to the first overload)r  r  r  nextrY  r  r  )rO  r  	bad_finals      rP  r  z*SemanticAnalyzer.process_final_in_overload  s    4444444 	 DMDD$*DDDDDI$ 		TV_````>>tz!""~>>>>>   L Ldjn L L LLL			VXa   9 TY%7  DMMM !   rR  c                   g }g }|j         D ]}t          |t                    r|j        }n2t          |t                    r|}nJ dt          |                       |                    |j                   |                    |j                   |j	        t          |j	        t                    r|j	        j        }nAt          |j	        t                    r|j	        }nJ dt          |j	                               |                    |j                   |                    |j                   t          t          |                    dk    r| j                            d|           d S t          t          |                    dk    r| j                            d|           d S |d         |_        |d         |_        d S )NFz+The 'item' variable is an unexpected type: zUnexpected impl type: r  classmethodstaticmethodr   )r  r~  rF   rN  rR   rV  r  rR  r$  r  r  rB  rD  )overload_inconsistently_applies_decorator)rO  r  class_statusstatic_statusra  inners         rP  r  z;SemanticAnalyzer.process_static_or_class_method_in_overload  s   J 	2 	2D$	** Y	D'** YXXDQUJJXXXXX///  11119 $)Y// I	DIw// I	HHtDIHHHHH///  111s<  !!Q&&H>>}dSSSSS]##$$))H>>~tTTTTT(ODM*1-DNNNrR  CallableType | Nonec                t   d|_         |j        }|j        d         }t          |t                    sJ g }d}t	          |dd                   D ]y\  }}t          |t                    r!|j                            |            |j        r|j        d         }t          |t                    r|j	        dk    rcd|j
        _        |j        j        |j        _        t          |j        |                     d                    }	t          |	t                    sJ |	}|j	        dk    r|j        j        |j        _        |j        dd         D ]}
|
                    |            |                     d|j        j	         d	|           =|                     d
|j        j	         d|           |                    |dz              {t%          |          D ]}||= |dd         D ]O}t          |t                    r8|j        D ]0}|                     |          x}d|j         d| |j        _        1P|S )a.  Analyze a property defined using multiple methods (e.g., using @x.setter).

        Assume that the first method (@property) has already been analyzed.
        Return bare setter type (without any other decorators applied), this may be used
        by the caller for performance optimizations.
        Tr   Nr  setterr  deleterz!Only supported top decorator is @z.setterz$Unexpected definition for property "r@  	function r  )r2  r  r~  rF   r  rN  r  r  rb   r  r  is_settable_propertyr3  r   r  r   r  r  r  r  rr  r  )rO  r  r  r  deleted_itemsr  r  ra  
first_nodesetter_func_type
other_noder  r  s                rP  r  z<SemanticAnalyzer.analyze_property_with_multi_part_definition  s{     
Z]
*i00000 qrr++ 	, 	,GAt$	** ,	  &&&? !%!3J!*j99 %?h66BFJN?8B8WDI5/< $	4??;N+O+O0 0, $..>#M#MMMM/?,%?i778B8WDI5*./!""*= 4 4J&--d33334 		]
@T]]]_c   		XAUXXXZ^___$$QU++++-(( 	 	Aa!""I 	 	D$	**   A&*&9&9!&<&<<
ISSSzSS 	,  rR  FuncDef | OverloadedFuncDefc                    |                                  r| j        J | j        |_        |                     |j                  |_        |                     |j        ||           d S rT  )r  rV  r  r  r  r  r  )rO  rN  s     rP  r  z-SemanticAnalyzer.add_function_to_symbol_table0  sb       	"9(((	DI,,TY77	4.....rR  c                   |                      |j                  }|                     | j                            |                    5  |j        D ]#}|j        r|j                            |            $	 d d d            d S # 1 swxY w Y   d S rT  )r  rr  r  r0  r   r  r  r  )rO  r  rr  r  s       rP  r/  z)SemanticAnalyzer.analyze_arg_initializers7  s    ))$-88""4?#?#?#I#IJJ 	1 	1~ 1 1? 1O**40001	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1s   ,BB	Bc                   |                                  }|                     |j                  }|                     | j                            |                    5  |j        r|                                 }|j        }t          |t                    sJ |
                    ||           t          t          |j                            D ]}t          |||| j                   | j                            |           |                     |          5  |j        D ]}|                     |j        |           |rO|j        r|j        dk    r=|j        r6|j        sd|j        d         j        _        nd|j        d         j        _        |j                            |            d d d            n# 1 swxY w Y   | j                                         d d d            d S # 1 swxY w Y   d S )NrP  Tr   )r  r  rr  r  r0  r   rV  r"  r~  r   rw  ranger  r>  r   r  r1  r  enterr  	add_localvariabler$  r  rR  is_selfis_clsr  r  r  )rO  r  	is_methodrr  r{  r  r  r  s           rP  r0  z&SemanticAnalyzer.analyze_function_body?  sl   ''))	))$-88""4?#?#?#I#IJJ 	& 	&y G&&((i!#|44444..sD999s3=1122 G GA'adoFFFF&&t,,,D!! ' '> 7 7CNN3<6666
  Adn A	Y8N8NTXTb8N= A=Aq)2::<@q)29	  &&&' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ##%%%1	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	& 	&s8   B:G$BF3'G$3F7	7G$:F7	;G$$G(+G(r   c                T   t          |t                    r!|j        D ]}|                     |           d S t          |t                    sd S t          |j                  t          |j                  gz   D ]/}| 	                    |          r| 
                    |            d S 0d S rT  )r~  r   r  r!  r   r   r>  r   r  is_classvarfail_invalid_classvar)rO  r  r  s      rP  r!  z,SemanticAnalyzer.check_classvar_in_signature\  s    c:&& 	Y 4 4003333F#|,, 	F!#-00OCL4Q4Q3RR 	 	A"" **1---	 	rR  fdefc                   |j         }t          |t                    sJ t          |j                  t          |j                  k     rx|                     d|           t          |j                  t          |j                  z
  }t          t          j	                  g|z  }|j        
                    |           d S t          |j                  t          |j                  k    r|                     d|d           d S d S )Nz$Type signature has too few argumentsz%Type signature has too many argumentsTblocker)rV  r~  r   r  r>  r  r  r   r   rF  extend)rO  r  signum_extra_anys
extra_anyss        rP  r.  z)SemanticAnalyzer.check_function_signaturej  s    i#|,,,,,s}DN 3 333II<dCCC 003s}3E3EEN!)"6778>IJM  ,,,,,#dn"5"555II=tTIRRRRR 65rR  r  rF   c                   || _         |j                                        |_        | j        d         dk    |j        _        |j        s|                     |j	        ||           | 
                    |j	                  |j        _        | 
                    |j	                  |j        _        |j        D ]}|                    |            g }d}d}t          |j                  D ]\  }}t          |d          r=|                    |           t"          |j        _        |                     d|           St          |d          r"|                    |           d|j        _        t          |d          rD|                    |           d|j        _        d|j        _        |                     d	|           t          |d
          rE|                    |           d|j        _        d|j        _        |                     d|           .t          |t2                    r9|                    |           d|j        _        |                     d|           |t          |d          r|                    |           d|j        _        d|j        _        t          |d          rt"          |j        _        nt          |d          rd|j        _        |                     d|           t          |d          r't;          t<          j                  |j        _         d}Ft          |tB                    r| "                                rg| j         
J d            | j         j#        r| j$        %                    |           nd|j        _&        d|j        _&        |                    |           | '                    d|           t          |tP                    rd|j        _)        tU          |tV                    r;t          |j,        tZ                    r!| .                    |          |j        _/        a| 0                    |          x}d|j1         d| |j        _2        |j        j        sd}tg          |          D ]
}|j        |= |j        r|j        j        r$| j         r| j         |j        _4        d|j        _5        |s!| j6        r|j                            |            |r0|j        r)|j        j        r| '                    d|tn                     |j        j        s|j        j        r"|j        j        r| '                    d|           |j        j        t"          k    r0|j        j&        r$| '                    d|j        j	         d|           |j        j        r.|j        j        r$| '                    tp          j9        |           d S d S d S )Nr  r   Fzabc.abstractmethodabstractmethod)zasyncio.coroutines.coroutineztypes.coroutineTzbuiltins.staticmethodr  zbuiltins.classmethodr  override)zbuiltins.propertyabc.abstractpropertyfunctools.cached_propertyzenum.propertyztypes.DynamicClassAttributer  r   propertyztyping.no_type_checkzNo type set at class scopez/@final cannot be used with non-method functionsr  r  z0Decorators on top of @property are not supportedr  z5Only instance methods can be decorated with @propertyzMethod z is both abstract and final):r:  original_decoratorsr}  r  r,  rN  r  r  r  r  r  r  r  r  r  r  r  r(   r3  "check_decorated_function_is_methodis_awaitable_coroutiner$  is_staticmethodrR  r[  r   r  r2  r  r   r   r  rV  r   r  r1  rD  protocol_members_cant_be_finalr  r  r   is_type_check_onlyr~  r=   r  r   parse_dataclass_transform_specdataclass_transform_specr  rr  r  r  r  is_initialized_in_classrG  r   r   $CLASS_PATTERN_CLASS_OR_STATIC_METHOD)rO  r  r  removedno_type_checkcould_be_decorated_propertyr  r  s           rP  visit_decoratorz SemanticAnalyzer.visit_decoratorv  s   05577"&"22"6": 	0OOCHc3///!00:: //99 	 	AHHTNNNN&+#cn-- C	3 C	3DAq!!%9:: A3q!!!+6(778H#NNNN#A'Z[[ =3q!!!26//#A'>?? :3q!!!%)"*.'77LLLL#A'=>> 53q!!!$(!)-&77sKKKK#A'?@@ 03q!!!04-77
CHHHH#	 	 ,3 q!!!'+$&*#%a)?@@ 8/:CH,,'+FGG 837CG077
CHHHH#A'=>> 3&y'=>> $#A'<== 3&&(( 	T9002N000y, 0??BBBB,0)+/(NN1%%%%IIOQRSSSS#A'<== 3.2++Ax(( 	3-?3. . 	3 594W4WXY4Z4Z11 $ 3 3A 6 66*C&\#,&\&\PZ&\&\##W( 3 /3+'"" 	" 	"Aq!! 	337#6 	3DI 	39CGL.2CG+ 	"!< 	"HOOD!!!& 	3> 	cg>Q 	IIBCN`     H 	T#("3 	T9L 	TIIMsSSS8#{22sx7H2IIJJJJCPPP8 	R#("3 	RII&KSQQQQQ	R 	R 	R 	RrR  	decoratorcontextrC   c                t    | j         r|                                 r|                     d| d|           d S d S )Nr@  z" used with a non-method)rV  r  r  )rO  r  r  s      rP  r  z3SemanticAnalyzer.check_decorated_function_is_method  sS    y 	HD..00 	HII=)===wGGGGG	H 	HrR  r?   c                *   || _         | j                            |j                    |                     |j                  }|                     | j                            |                    5  | 	                    |j
        |          )|                     |j        |           	 d d d            d S |                     |           |                     |j
                   d d d            n# 1 swxY w Y   | j                                         d S rT  )r:  rC  r  r  r  r  r  r0  class_framer  r  r  analyze_classr  r  )rO  r  r  s      rP  visit_class_defz SemanticAnalyzer.visit_class_def  sV   "))di-888''	22	""4?#>#>y#I#IJJ 	/ 	/""4>488@$$TY555	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/
 t$$$t~...	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	/ 	"&&(((((s   /8C/4/C//C36C3r  list[TypeParam] | None(list[tuple[str, TypeVarLikeExpr]] | Nonec                   |sg S | j                             t                                 | j                            t                     g }|D ]9}|                     ||          }| d S |                    |j        |f           :|D ]O\  }}|                     |          r|                     d| d|           5| 	                    |||dd           P|S )Nr@  z%" already defined as a type parameterT)no_progress
type_param)
r)  r  r|   r+  r  analyze_type_paramr  is_defined_type_paramr  r  )rO  r  r  tvsrt  tvr  s          rP  r  zSemanticAnalyzer.push_type_args  s     	I;==))) 011113 	% 	%A((G44BzttJJ|$$$$ 	V 	VHD"))$// V		IdIII7SSSSb'tPTUUUU
rR  c                r    | j         D ].}|||v r%||         j        }t          |t                    r dS /dS NTF)r)  r  r~  r   )rO  r  rq  r  s       rP  r  z&SemanticAnalyzer.is_defined_type_param  sO    [ 	  	 E}u}}T{'dO44  44urR  r  r   TypeVarLikeExpr | Nonec           
     @   |                      |j                  }|j        r5|                     |j        d          }|t	          d g |j                  }nN|j        t          k    r*|                     d| 	                                g          }n| 	                                }|j
        r|                     |j
        ddd|j        t          k    |j        t          k    |j        t          k              }|t	          d g |j                  }n|j        t          k    r|                     ||j
                  }nq|j        t          k    r|                     ||j
                  }nE|j        t          k    r|                     ||j
                  }nt!          t"          j                  }|j        t          k    rg }|j        r|j        D ]}|                     |d          }|t	          d g |j                  }t)          |          rM|                     t,          j        |           |                    t!          t"          j                             |                    |           t5          |j        ||||t6          d|j                  S |j        t          k    rt9          |j        |||d|j                  S |j        t          k    sJ |                     d| 	                                g          }	t;          |j        |||	|d|j                  S )	NTallow_placeholderbuiltins.tupleF)r%  rK  report_invalid_typesallow_param_spec_literalsallow_tuple_literalallow_unpack)r  rr  r  r  r  varianceis_new_styler  )r  rr  r  r  r,  r  )r  rr  r  tuple_fallbackr  r,  r  )r  r  r  r  r   r  kindr2   r  object_typer  r,   r1   check_typevar_defaultcheck_paramspec_defaultcheck_typevartuple_defaultr   r   r  r  r   r  r    TYPE_VAR_GENERIC_CONSTRAINT_TYPEr  rF  r   r3   rl   r   )
rO  r  r  rr  r  r  r  rf  analyzedr-  s
             rP  r  z#SemanticAnalyzer.analyze_type_param  s"    &&z77! 	1..)?SW.XXK" .dBEE"555"oo.>AQAQASAS@TUU"..00 	?nn""&$(%**4/_*L$.O$F'_0CC %  G )$GLAAM1144Wj>PQQO3366w
@RSS$77799':CUVVi=>>G?m++!#F  	0'. 0 0E#~~et~LLH'#24W\#J#J$X.. 0		"2"SU\]]]gi.B&C&CDDDDh////_!'+!\	 	 	 	 _// _!'!\    ?&99999!__-=@P@P@R@R?STTN#_!'-!\   rR  c                r    |sd S | j                                          | j                                         d S rT  )r)  r  r+  )rO  r  s     rP  r  zSemanticAnalyzer.pop_type_args_  s<     	FrR  c                   |                      |j                  }|j        sK|                     |          s6t	          |||j        d          }|                     |j        ||d           |                                 }|j        	                    |j
                   |j
                                         |                     |           |j        }|                     |||          \  }}}|                     |           |D ]}t          |t                     r;t#          d |j        g|j        z   D                       r|                                  t+          |j                  r|                     |j        |            d S |                     |           |                     |          }	|	|                     |          r|                     |j        |           d S |	\  }
}t#          d |
D                       r|                     |j        |           d S |                     |j        |j                  \  }}}|s|                     |          r|                     |j        |           d S |                     |          r4|j        r+|                     ||           |                     |           d S |                      ||          rd S | !                    |           |                     ||           |rd|j        _"        |rd|j        _#        | j$        %                    |j                  5  | &                    ||
           ||j        _'        | (                    ||           d|j        _)        |j*        r2| j+        ,                                }| j-        ,                                 |j.        D ]}| /                    ||           |j*        r9| j+        0                    |           | j-        0                    tb                     | 2                    |           d d d            d S # 1 swxY w Y   d S )NTbecomes_typeinfoF)	can_deferr  c              3  4   K   | ]}t          |          V  d S rT  r   rC  r  s     rP  r  z1SemanticAnalyzer.analyze_class.<locals>.<genexpr>  s;       4 4'(""4 4 4 4 4 4rR  c              3  F   K   | ]\  }}t          |t                    V  d S rT  )r~  r   )rC  base_s      rP  r  z1SemanticAnalyzer.analyze_class.<locals>.<genexpr>  s0      KKWT1z$00KKKKKKrR  )3r  r  r  is_core_builtin_classrn   r  r  r  base_type_exprsr  removed_base_type_exprsclear-infer_metaclass_and_bases_from_compat_helpers'clean_up_bases_and_infer_type_variablescheck_type_alias_basesr~  r   r  r  r  r  r   r  r  analyze_class_keywordsanalyze_base_classesr  get_declared_metaclass	metaclassanalyze_typeddict_classdefsetup_type_varssetup_alias_type_varsanalyze_namedtuple_classdefprepare_class_deffallback_to_anymeta_fallback_to_anyrH  class_scopeconfigure_base_classesr1  recalculate_metaclassruntime_protocolr  r)  r  r+  r  analyze_class_decoratorr  r  analyze_class_body_common)rO  r  rr  placeholderr  bases	tvar_defsr1  tvdbases_result
base_types
base_errordeclared_metaclassshould_deferany_metatype_params_namesr  s                    rP  r  zSemanticAnalyzer.analyze_classe  s   &&ty11y 	K!;!;D!A!A 	K
 *(D$)VZ[[[KOODI{DEOJJJ((** 	##D$@AAA$**,,,::4@@@$(,(T(T% )U )
 )
%y+ 	##E*** 	 	C#{++  4 4-0_,=
,J4 4 4 1 1 
 

s{++  $$TY555	 	##D)))00774#<#<S#A#A  D111F!-
JKK
KKKKK 	   D111F595P5PIt~6
 6
2L(  	444S99 	  D111F**400 	y 1$$T9555**4000F++D)<< 	F 	t$$$T9--- 	-(,DI% 	2-1DI*Z##DI.. 	1 	1''j999$/DI!&&t-?@@@).DI&~ ' %)KOO$5$5! $$&&&!_ > >	,,T9====~ :""#4555 ''(8999**4000#	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1 	1s   C3QQ	Q	rZ  list[Expression]c                    |D ]o}t          |t                    r|j        }t          |t                    r<t          |j        t
                    r"|j        j        r|                     d|           pd S )NzAType alias defined using "type" statement not valid as base class)r~  r[   r?  rq   r  r   python_3_12_type_aliasr  )rO  rZ  r?  s      rP  rG  z'SemanticAnalyzer.check_type_alias_bases  s     
	 
	D$	** !y4))ty)44 I4
 		WY]  
	 
	rR  r[  list[TypeVarLikeType]c                ^    ||_         g |j        _         |j                                         d S rT  )r  r  add_type_vars)rO  r  r[  s      rP  rM  z SemanticAnalyzer.setup_type_vars  s-    " 		!!!!!rR  c                <   |j         j        J t          |j                  |j         j        _        t          |j                  D ]+\  }}t          |t                    r||j         j        _        ,|j         j        j	        }t          |t                    sJ t          |t                    r t          |j                  |j        _        d S t          |t                    r t          |j                  |j        _        d S J dt#          |                       )NFzUnexpected special alias type: )r  special_aliasr*  r  alias_tvarsr  r~  r   tvar_tuple_indexr  r   r   r   fallbackrd  r   partial_fallbackrV  )rO  r  r  r  r  s        rP  rN  z&SemanticAnalyzer.setup_alias_type_vars  s   y&222.24>.B.B	+ dn-- 	= 	=DAq!-.. =;<	'8(/&*-----fm,, 	K#4T^#D#DFO   	** 	K+<T^+L+LF#(((JJDLLJJJJJrR  c                4    | j         dk    o|j        t          v S Nrm  )r  r  r  r  s     rP  rA  z&SemanticAnalyzer.is_core_builtin_class  s    *,R>R1RRrR  c                .   |                      |j                   t          d |j        j        D                       r|                                  |j                            |            |                     |           |                                  dS )zHParts of class body analysis that are common to all kinds of class defs.c              3  (   K   | ]}|j         d uV  d S rT  )r)  )rC  bs     rP  r  z=SemanticAnalyzer.analyze_class_body_common.<locals>.<genexpr>  s)      >>1q{$&>>>>>>rR  N)	r  r  r  mrorx  ry  r  apply_class_plugin_hooksr  r  s     rP  rX  z*SemanticAnalyzer.analyze_class_body_common  s    ###>>	>>>>> 	#  """	%%d+++rR  c                   |j         r'|j         j        rt          |j         j                  sdS | j                            |          \  }}|rp|j        D ]0}|                    |            ||                     |||           1||                     |j	        |           n| 
                    ||d           dS dS )NTcustom_namesF)r  typeddict_typer   r  rL  r  r  analyze_class_decorator_commonr  r  rP  )rO  r  is_typeddictr  r  s        rP  rL  z+SemanticAnalyzer.analyze_typeddict_classdef  s    I		(	 $DI$<==	 4!5PPQUVVd 		!_ O O	  &&&#77dINNN|$$TY5555&&tT&EEE4urR  c                4   |j         r;|j         j        r/|j         j        r#t          |j         j                  s
d}|j         }n6| j                            || j        |                                           \  }}|r||                     |j	        |           n| 
                    ||d           |                     ||           |                     |           | j                            |j                   5  |j        D ]3}|                    |            |                     ||j         |           4| j                            |          5  |                     |           ddd           n# 1 swxY w Y   ddd           n# 1 swxY w Y   dS dS )z-Check if this class can define a named tuple.TNrx  F)r  is_named_tuple
tuple_typer   r  rO  rY  r  r  r  rP  rM  rN  rH  rS  r  r  r{  save_namedtuple_bodyrX  )rO  r  r[  r~  r  decos         rP  rO  z,SemanticAnalyzer.analyze_namedtuple_classdef
  s.   
 I		(	 	$	 $DI$899		 "N$(IDD#'#<#X#Xd'););)=)=$ $ ND  	|$$TY5555&&tT&EEE$$T9555**4000Z++DI66 = = $ S SD)));;D$)TRRRR2GGMM = =66t<<<= = = = = = = = = = = = = = =	= = = = = = = = = = = = = = = 4us7   <AFE4(F4E8	8F;E8	<FFFc                   |j         D ]l}|                     |          }|rS| j                            |          }|t	          |          rt
          j        }|r |t          |||                      m|j        rW|                     |j                  }|r;| j        	                    |          }|r |t          ||j        |                      |j
        D ]O}|                     |          }|r6| j                            |          }|r |t          |||                      Pt	          |          }|t          j        |j                   dS dS )zIApply a plugin hook that may infer a more precise definition for a class.N)r  get_fullname_for_hookr9  get_class_decorator_hookr   dataclasses_plugindataclass_tag_callbackr   rK  get_metaclass_hookrB  get_base_class_hookadd_dataclass_tagr  )	rO  r  r  decorator_namehookmetaclass_name	base_expr	base_namespecs	            rP  rv  z)SemanticAnalyzer.apply_class_plugin_hooks,  s     
	A 
	AI!77	BBN A{;;NKK <$A)$L$L<-DD ADy$??@@@> 	F!77GGN F{55nEE FDt~tDDEEE- 	A 	AI229==I A{66yAA ADy$??@@@ -T220;;;;; rR  exprc                D   t          |t                    r|                     |j                  S t          |t                    r|                     |j                  S t          |t                    r,|j        r|j        S |                     |          }|r|j        S d S rT  )	r~  r=   r  r  r[   r?  rq   rr  lookup_type_noderO  r  re  s      rP  r  z&SemanticAnalyzer.get_fullname_for_hookO  s    dH%% 	$--dk:::i(( 
	$--di888g&& 	$} %}$ ''--C $|#trR  c                h    |j                                         D ]}|                    |            d S rT  )keywordsr  r  )rO  r  rf  s      rP  rH  z'SemanticAnalyzer.analyze_class_keywords_  s>    ]))++ 	 	ELL	 	rR  c                x   | j                             | j                   | j                            d            | j                            t
                     | j                            d           | j                            d           || _        | j	                            t                                 d S )Nr  r   )r/  r  rV  r)  r+  r  r,  r4  r.  r2  rB  r  s     rP  r  zSemanticAnalyzer.enter_classc  s    ty)))4   ,,,###q!!!
!!#%%(((((rR  c                <   | j                                          | j                                         | j                                         | j                                         | j                                        | _        | j                                         dS )zRestore analyzer state.N)r,  r  r4  r)  r+  r/  r.  r2  rU  s    rP  r  zSemanticAnalyzer.leave_classm  s    _((**
     rR  c                   |                     |            |                     ||j        |           t          |t                    rB|j        t          v r2|j        j        rd|j        _        d S | 	                    d|           d S d S t          |t                    r;t          |j        t                    r#|                     |          |j        _        d S d S d S )NTz9@runtime_checkable can only be used with protocol classes)r  r{  r  r~  rq   rr  r/   r1  rV  r  r=   r  r  r   r  r	  )rO  r  r  s      rP  rW  z(SemanticAnalyzer.analyze_class_decoratorv  s    ++D$)YGGGi)) 		`!%;;;9( a15DI...IIY[_`````	 <;
 	8,, 	`1C72
 2
 	` 261T1TU^1_1_DI...	` 	` 	` 	`rR  c                    t          |t                    r	d|_        dS t          |t                    r	d|_        dS |                     |          x}d|j         d| |_        dS dS )zvCommon method for applying class decorators.

        Called on regular classes, typeddicts, and namedtuples.
        TNzclass r  )r  r   r  r   r  r  rr  r  )rO  r  r  r  r  s        rP  r{  z/SemanticAnalyzer.analyze_class_decorator_common  s     i)>?? 	S DMMM	+@AA 	S&*D### //	:::jGRt}RRjRRDOOO HGrR  rB  4tuple[list[Expression], list[TypeVarLikeType], bool]c                   g }g }d}|j         f|j         D ]^}|                     |j        |          }|J t          |j        t
                    sJ |                    |j        |j        f           _t          |          D ]h\  }	}
t          |
t                    rd|
_	        | 
                    |
           	 |                     |
          }n# t          $ r Y Zw xY w|                     |          }||d         }||d         z  }|rM|j         r0|r|                     d|           n-|                     d|           n|                     d|           |                    |	           |                    |           t          |t                     rR|                     |j        |          }|5|j        .|j        j        t&          v r|	|vr|                    |	           d}j|                     ||          }|r
t+          t-          |                    t+          |          k     r|j         s|                     d	|           t-          |          }t/          |                              t/          |                    s|j         rRt3          t/          |          t/          |          z
            }| j                            d
 |D             |           n|                     d|           t-          ||z             }n|}t9          |          D ]*}	|j                            |j        |	                    ||	= +|                     ||          }|||fS )a  Remove extra base classes such as Generic and infer type vars.

        For example, consider this class:

          class Foo(Bar, Generic[T]): ...

        Now we will remove Generic[T] from bases of Foo and infer that the
        type variable 'T' is a type argument of Foo.

        Note that this is performed *before* semantic analysis.

        Returns (remaining base expressions, inferred type variables, is protocol).
        FNTr   r  z/No arguments expected for "Protocol" base classz$Generic[...] base class is redundantz9Only single Generic[...] or Protocol[...] can be in basesz9Duplicate type variables in Generic[...] or Protocol[...]c                    g | ]
}|d          S r   rA  )rC  r  s     rP  rD  zLSemanticAnalyzer.clean_up_bases_and_infer_type_variables.<locals>.<listcomp>  s    4442A444rR  zMIf Generic[...] or Protocol[...] is present it should list all type variables) r  lookupr  r~  r  r   r  r  rw   validanalyze_type_exprr   r   !analyze_class_typevar_declarationr  r  r   rb  rr  r   get_all_bases_tvarsr  r   rB  issubsetry  rD  rz  r  rC  rB  tvar_defs_from_tvars)rO  r  rB  r  r  declared_tvarsr1  rt  r  r  r  r?  r9  tvarsre  	all_tvars
undeclaredr[  s                     rP  rF  z8SemanticAnalyzer.clean_up_bases_and_infer_type_variables  s      *,>%^ ; ;{{16733'''!$)_=====%%qvty&9::::%o66  	+  	+LAy)X.. '"&	""9---33I>>'    ;;DAAF!q	vay(! 	~ & W II&WY`aaaa II&LgVVVV		WY`   q!!!%%e,,,$,, +++DIt<<?sx';x(N::q?O?Oq)))&*,,_gFF	 	';~..//#n2E2EEEdnE		UW^___(88Ny>>**3~+>+>?? I> 
!'I^9L9L(L!M!MJH??44444g    II=   "-^i-G!H!H&N'"" 	# 	#A (//0DQ0GHHH""--ngFF		;66s   ;C
CCr?  #tuple[TypeVarLikeList, bool] | Nonec                z   t          |t                    sdS |}|                     |j        |          }||j        dS |j        j        dk    s|j        j        t          v r|j        r|j        j        dk    }g }d}|j        D ]}|                                 }| 	                    |          }	|	rLt          |	d         t                    r|r|                     d|           ad}|                    |	           y|                     |          s#|                     d|j        j        z  |           ||fS dS )zAnalyze type variables declared using Generic[...] or Protocol[...].

        Args:
            base: Non-analyzed base class

        Return None if the base class does not declare type variables. Otherwise,
        return the type variables.
        Nztyping.GenericFr  z.Can only use one type var tuple in a class defTz&Free type variable expected in %s[...])r~  r   rb  r  r  rr  r   rd  r  analyze_unbound_tvarr   r  r  r  )
rO  r?  unboundre  is_protor  have_type_var_tupler  r  r  s
             rP  r  z2SemanticAnalyzer.analyze_class_typevar_declaration  si    $,, 	4##GL'::;#(*4H!111x N22	 3 x(,<<H%'E"'| ^ ^00220055 ^!$q'+;<< 3. % II&VX\]]]$.2+LL&&&&22377 ^IIFVX\]]](?"trR  r  "tuple[str, TypeVarLikeExpr] | Nonec                   t          |t                    r6t          |j        t                    r|                     |j        d          S t          |t                    r{|                     |j        |          }|rI|j        t          v r;|j	        d         }t          |t                    r|                     |d          S d S |                     |          S d S )NT)is_unpackedr   )
r~  r   rV  r   analyze_unbound_tvar_implrb  r  rr  r   rd  )rO  r  re  inner_ts       rP  r  z%SemanticAnalyzer.analyze_unbound_tvar	  s    a$$ 	LAFK)H)H 	L11!&d1KKKa%% 	5''22C s|'888&)g{33 U99't9TTTt11!444trR  r   r  is_typealias_paramc                   |r|r
J d            |                      |j        |          }|r.t          |j        t                    r|                                  |sR|rPt          |j        t                    r6|j        r!| j        	                    |j                  sd S |j        |j        fS |s|rR|rPt          |j        t                    r6|j        r!| j        	                    |j                  sd S |j        |j        fS |t          |j        t                    r|rd S |j        r!| j        	                    |j                  sd S t          |j        t                    sJ |j        |j        fS )NzMutually exclusive conditions)rb  r  r~  r  rn   record_incomplete_refrl   rr  r0  allow_bindingr   r   )rO  r  r  r  re  s        rP  r  z*SemanticAnalyzer.analyze_unbound_tvar_impl	  s    Y&8YY:YYYY##AFA.. 	):ch88 	)&&((( 	$s 	$z#(M'J'J 	$| DO$A$A#,$O$O t638## 	$- 	$3 	$:chP`;a;a 	$| DO$A$A#,$O$O t638##;j;??;;;4\ 	$$/"?"?"M"M 	$4ch44444638##rR  r   c                d    t          | | j                  }|                    |           |j        S rT  )r   r0  r  type_var_likes)rO  r  visitors      rP  find_type_var_likesz$SemanticAnalyzer.find_type_var_likes9	  s.    $T4?;;	%%rR  r  c                    g }t          |          D ]Z\  }}||vrQ	 |                     |          }n# t          $ r Y ,w xY w|                     |          }|                    |           [t          |          S )z-Return all type variable references in bases.)r  r   r   r  r  r   )rO  rB  r  r  r  r  r?  
base_tvarss           rP  r  z$SemanticAnalyzer.get_all_bases_tvars>	  s     "$%o66 	) 	)LAy77	BBDD+   H "55d;;
Z(((5!!!s   2
??r  c                   g }d }|D ]\  }}|j                             t          | |j        |                    |_         | j                            ||          }|T|                                s@| j                            |j        ||           t          t          j                  |_         n|                                r|j        }|                    |           |S rT  )r  r  r   r  r0  bind_newhas_defaultrD  tvar_without_default_typer   r   rF  r  )rO  r  r  r[  last_tvar_name_with_defaultr  	tvar_exprtvar_defs           rP  r  z%SemanticAnalyzer.tvar_defs_from_tvarsN	  s     ,.	26#$ 	' 	'OD) ) 1 8 8(y~wGG! !I //i@@H*6x?S?S?U?U622M#>   $+9+?#@#@  %%'' <.6m+X&&&&rR  
type_exprsc                H   g }|D ]S}	 |                      |          }n# t          $ r Y %w xY w|                     |          }|                    |           Tt	          |          }g }|D ]5\  }}| j                            ||          }	|                    |	           6|S )a7  Return all type variable references in item type expressions.

        This is a helper for generic TypedDicts and NamedTuples. Essentially it is
        a simplified version of the logic we use for ClassDef bases. We duplicate
        some amount of code, because it is hard to refactor common pieces.
        )r   r   r  r  r   r0  r  r  )
rO  r  r  r  r?  r  r[  r  r  r  s
             rP  get_and_bind_all_tvarsz'SemanticAnalyzer.get_and_bind_all_tvarsb	  s     # 	% 	%I33I>>'    11$77JLL$$$$E""	$ 	' 	'OD)//i@@HX&&&&s   
++ry  c                L   |j         s|                     |j                  |_        |p|                     |          }||_         ||_        |s@|                                 s |                     |j                  |_        n|j        |_        |j        }d|v r|                    d          d         }| 	                    ||j         |           | 
                                rd|j         j        vr<|j         j        dz   t          |j                  z   }| j        dz   |z   |j         _        n|j         j        }|j         j        |_        |j         j        s|j         j        r|                     ||j                    dS t#          t$          |j                   | j        |<   dS dS )zPrepare for the analysis of a class definition.

        Create an empty TypeInfo and store it in a symbol table, or if the 'info'
        argument is provided, store it instead (used for magic type definitions).
        @r   r|  N)r  r  r  rr  make_empty_type_infor  r  r  r  r  is_nested_within_func_scoper  r  r  r~  rz  add_symbol_skip_localr}   r%   r&  )rO  r  r  ry  
local_nameglobal_names         rP  rP  z"SemanticAnalyzer.prepare_class_defy	  s    y 	/ //	::DM:444T::DDIDI / ))++ /%)%8%8%C%CDNN%)YDNY
*#))#..q1J
DIt444++-- 	M $)---"ins2S^^C&*o&;k&I	## #in I/DMy' M49+C M **;	BBBBB,;D$),L,L[)))'	M 	MrR  c                ,   |                                  rH| j        dk    r=|j        t          v r/| j        |j                 j        }t          |t                    sJ n7t          t                      || j                  }|	                    |           |S rq  )
is_module_scoper  r  r  r&  r  r~  r   r|   set_line)rO  r  r  s      rP  r  z%SemanticAnalyzer.make_empty_type_info	  s      ""	 :--	111
 <	*/DdH------KMM4AADMM$rR  c                B   t          |t                    r|j        S t          |t                    rt	          |          S t          |t
                    r|                     |j                  S t          |t                    r|                     |j	                  S dS )zQTry finding a short simplified textual representation of a base class expression.N)
r~  re   r  rb   r   r[   get_name_repr_of_exprr?  r=   r  rO  r  s     rP  r  z&SemanticAnalyzer.get_name_repr_of_expr	  s    dH%% 	9dJ'' 	2+D111dI&& 	9--di888dH%% 	;--dk:::trR  7tuple[list[tuple[ProperType, Expression]], bool] | Nonec                J   d}g }|D ]}t          |t                    r|j        t          t          z   v sBt          |t
                    r.t          |j        t                    r|j        j        t          v rq	 |                     |dd          }nb# t          $ rU | 	                    |          }t          |t
                    rd}nd}|r	|d| dz  }| 
                    ||           d}Y w xY w| dS t          |          }|                    ||f           ||fS )	a#  Analyze base class types.

        Return None if some definition was incomplete. Otherwise, return a tuple
        with these items:

         * List of (analyzed type, original expression) tuples
         * Boolean indicating whether one of the bases had a semantic analysis error
        FT)r%  allow_type_anyzUnsupported dynamic base classInvalid base class "r@  N)r~  rq   rr  r   r   r=   r  expr_to_analyzed_typer   r  r  r   r  )rO  rB  is_errorrZ  r  r?  r  rD  s           rP  rI  z%SemanticAnalyzer.analyze_base_classes	  ss    ( "	, "	,I9g..&*@<*OOO9h// P y/99 P $-== 11d 2   ( 
 
 
11)<<i22 /:CC.C (<<<<'C		#y)))
 |tt"4((DLL$	*++++hs   9BAC10C1#list[tuple[ProperType, Expression]]c                l   g }|j         }|D ]\  }}t          |t                    r-|                     ||          }|                    |           n%t          |t
                    r8|j        j        r|                     d|           |                    |           nt          |t                    rT| j
        j        r@t          |t          t          f          rd|j         d}nd}|                     ||           d|_        not          |t                     r|                    |j                   n?d}|                     |          }	|	r	|d|	 dz  }|                     ||           d|_        | j
        j        rTt)          |          rEt          |t          t          f          rd	|j         }
nd
}
| j                            |
||           t/          || j
        | j        | j        |           |s2|j        dk    r'|                    |                                            ||_        |                     |          s|                     |j                    dS |                     |          s|                     |j                    |                      || j                   dS )a
  Set up base classes.

        This computes several attributes on the corresponding TypeInfo defn.info
        related to the base classes: defn.info.bases, defn.info.mro, and
        miscellaneous others (at least tuple_type, fallback_to_any, and is_enum.)
        zCannot subclass "NewType"zClass cannot subclass "z" (has type "Any")z)Class cannot subclass value of type "Any"Tr  r  r@  z
Base type z	Base typer:  r  N)!r  r~  r   configure_tuple_base_classr  r   rV  
is_newtyper  r   r"  disallow_subclassing_anyre   rb   r  rQ  r   rn  r  disallow_any_unimportedr   rD  unimported_type_becomes_anyr   r\  rr  r/  rZ  verify_base_classesset_dummy_mroverify_duplicate_base_classesset_any_mrocalculate_class_mro)rO  r  rZ  r^  r  r?  r  actual_baserD  r  prefixs              rP  rT  z'SemanticAnalyzer.configure_base_classes	  s    &(
y$ !	 !	OD)$	** ,"==dDII!!+....D(++ ,9' AII94@@@!!$''''D'** ,<8 .!)h
-CDD JZ	ZZZIIIc9---'+$$D-00 ,!!$-0000*11)<< (<<<<'C		#y)))'+$|3 N8TUY8Z8Z Ni(J)?@@ ):).::FF(F44VT9MMM"dlD$>R[    
  	2dm/@@@d..00111
 ''-- 	ty)))F11$77 	( TY'''  t'788888rR  r   r   c                   |j         }|j        r<|j        k    r1t          |j                  s|                     d|           d|_        |j        r;t          |j        j                  r"|                     d d||j        k               |                               | 	                    |           j
        j        j        dk    r-t                    s|                     t          fd           j
        S )Nz3Class has two incompatible bases derived from tupleTz
tuple baser  r&  c                 "    t                     S rT  )r   )r?  s   rP  <lambda>z=SemanticAnalyzer.configure_tuple_base_class.<locals>.<lambda>F
  s    <TUY<Z<Z rR  )r  r  r   r  has_incompatible_baseclassrk  r  r  update_tuple_typerN  ro  rV  rr  schedule_patchr   )rO  r  r?  r  s     ` rP  r  z+SemanticAnalyzer.configure_tuple_base_class4
  s   y ? 	3t$66t?_?_6IIKTRRR.2D+ 	/$2D2K"L"L 	$$lD9P %    	t$$$""4((( %.2BBB?[_K`K`B  24Z4Z4Z4Z[[[$$rR  c                T    ||                                  j        g|_        d|_        d S rb  )r/  rV  ru  bad_mror  s     rP  r  zSemanticAnalyzer.set_dummy_mroJ
  s(    $**,,12rR  c                T    d|_         ||                                 j        g|_        d S rb  )rQ  r/  rV  ru  r  s     rP  r  zSemanticAnalyzer.set_any_mroO
  s)    #$**,,12rR  obj_typeCallable[[], Instance] | Nonec                j   	 t          |j        |           nI# t          $ r< |                     d|j         d|           |                     |j                   Y nw xY w|j        rI| j                            |j                  }|r* |t          |t                      |                      dS dS dS )zCalculate method resolution order for a class.

        `obj_type` exists just to fill in empty base class list in case of an error.
        z?Cannot determine consistent method resolution order (MRO) for "r@  N)r   r  r   r  r  r  rr  r9  get_customize_class_mro_hookr   rN   )rO  r  r  r  s       rP  r  z$SemanticAnalyzer.calculate_class_mroT
  s    	*$)X.... 	* 	* 	*II^RVR[^^^   ty)))))	* = 	D;;;DMJJD D_T>+;+;TBBCCCCC	D 	DD Ds    AAAc                   d}t          |j                  dk    r|j        d         }t          |t                    rt          |j        t
                    rz|                     |           |j        j        dv rWt          |j                  dk    r?t          d |j
        D                       r!|j        d         }|j        dd         |_        d}|j        D ]}t          |t                    rt          |j        t
                    rg|j                            |            |j        j        dk    r=t          |j                  dk    r%|j
        d         t          k    r|j        d         } n|j        ||hdhz
  }t          |          dk    rdS t          |          dk    r|                     d|           dS |                                |_        dS )a  Lookup for special metaclass declarations, and update defn fields accordingly.

        * six.with_metaclass(M, B1, B2, ...)
        * @six.add_metaclass(M)
        * future.utils.with_metaclass(M, B1, B2, ...)
        * past.utils.with_metaclass(M, B1, B2, ...)
        Nr  r   >   six.with_metaclasspast.utils.with_metaclassfuture.utils.with_metaclassc              3  ,   K   | ]}|t           k    V  d S rT  )r!   rC  r.  s     rP  r  zQSemanticAnalyzer.infer_metaclass_and_bases_from_compat_helpers.<locals>.<genexpr>
  s&      LLDGOLLLLLLrR  zsix.add_metaclasszMultiple metaclass definitions)r  rB  r~  r=   r  rq   r  rr  rd  r  r%  r  r  r!   rK  r  r  )rO  r  with_meta_exprr  add_meta_exprdec_exprmetass          rP  rE  z>SemanticAnalyzer.infer_metaclass_and_bases_from_compat_helpersj
  s    -1t#$$)),Q/I)X.. >:i>NPW3X3X >&&y111$-  IN++q00LL	8KLLLLL 1 &/^A%6N+4>!""+=D( ,0 		 		H(H-- *X_g2V2V &&t,,,O,0CCCHM**a// *1-88$,M!$4ME?4&Hu::??Fu::>>II6===FrR  c                    |j         }d}|j        D ]7}|j        }|                     ||          r|                     d|           d}8| S )NFzCycle in inheritance hierarchyT)r  rZ  rV  is_base_classr  )rO  r  r  cycler?  baseinfos         rP  r  z$SemanticAnalyzer.verify_base_classes
  sa    yJ 	 	DyH!!$11 		:DAAAyrR  c                    t          |j                                                  }|r|                     d|j         d|           | S )NzDuplicate base class "r@  )find_duplicater  direct_base_classesr  r  )rO  r  dups      rP  r  z.SemanticAnalyzer.verify_duplicate_base_classes
  sO    TY::<<== 	BII:sx:::DAAAwrR  sc                    |g}|h}|re|                                 }||k    rdS |j        D ]?}|j        |vr4|                    |j                   |                    |j                   @|edS )z9Determine if t is a base class of s (but do not use mro).TF)r  rZ  rV  r  add)rO  r  r	  worklistvisitednxtr?  s          rP  r  zSemanticAnalyzer.is_base_class
  s     3# 	+,,..Caxxt	 + +9G++OODI...KK	***  	+ urR  metaclass_exprExpression | None"tuple[Instance | None, bool, bool]c                (   d}|r	d}t          |t                    r|j        }n$t          |t                    rt	          |          }||                     d| d|           dS |                     ||          }|dS t          |j        t                    r^t          t          |j        j
                  t                    r2| j        j        r$|                     d|j        j         d|           dS t          |j        t                    rdS |j        }t          |j        t                    rM|j        j        sA|j        j        s5t          |j        j                  }t          |t&                    r|j
        }t          |t(                    r|j        |                     d| d|           d	S |                                s|                     d
|           d	S t/          |          }t          |t&                    sJ |}|ddfS )a  Get declared metaclass from metaclass expression.

        Returns a tuple of three values:
          * A metaclass instance or None
          * A boolean indicating whether we should defer
          * A boolean indicating whether we should set metaclass Any fallback
            (either for Any metaclass or invalid/dynamic metaclass).

        The two boolean flags can only be True if instance is None.
        Nz%Dynamic metaclass not supported for "r@  NFTzClass cannot use "z!" as a metaclass (has type "Any")r!  zInvalid metaclass ")NFFz8Metaclasses not inheriting from "type" are not supportedF)r~  re   r  rb   r   r  rb  r  r   r   rV  r   r"  r  rn   r   rf  rl  r  r   r   r  is_metaclassr   )	rO  r  r  r`  r  re  metaclass_infor  r  s	            rP  rJ  z'SemanticAnalyzer.get_declared_metaclass
  s?    " ,	&!N.(33 J!/!4NJ77 J!9.!I!I%		I$III>ZZZ((''GGC{((#(C(( )Z8V8VX_-`-` )<8 II]SX]]]]&   )(#(O44 )(( +.(N38Y//171 ,1
 )99fh// 1%+[Nnh77 *>;T;`		AAAA>RRR))!..00 *		NP^   *) 00DdH-----!%!5%//rR  r`  Instance | Nonec                   ||j         _        |j                                         |j         _        t	          d |j         j        D                       rJ|j         j        r|j         j        j        j        dk    r$|                     dg           }|||j         _        |j         j        rO|j         j        j        	                    d          r-d|j         _
        |j        r|                     d|           d S d S d S d S )Nc              3  $   K   | ]}|j         V  d S rT  )r1  )rC  r  s     rP  r  z9SemanticAnalyzer.recalculate_metaclass.<locals>.<genexpr>
  s%      ::Dt::::::rR  r_  zabc.ABCMetazenum.EnumMetaTzEnum class cannot be generic)r  r`  calculate_metaclass_typemetaclass_typer  ru  rV  rr  r  has_baseis_enumr  r  )rO  r  r`  abc_metas       rP  rU  z&SemanticAnalyzer.recalculate_metaclass
  s   '9	$#'9#E#E#G#G	 ::DIM::::: 		8I,89+09_LL  22="EE'/7DI,9# 	@	(@(E(N(N(_(_ 	@ $DI~ @		8$?????	@ 	@ 	@ 	@@ @rR  r  rW   c                   || _         |j        D ]\  }}| j         o| j        j        }||}|}|p||k    }n|                    d          d         }|}|}|| j        v ro| j        |         }|                                 rt          }	n| j	        t          }	nt          }	t          |	|||           }
|                     ||
|||            |                     |||||            d S )Nr|  r   r  r  r  r  r  )r  r  r  r  )r:  idsrY  r"  implicit_reexportr  r%  r  r)   rV  r*   r%   r}   add_imported_symboladd_unknown_imported_symbol)rO  r  r  as_iduse_implicit_reexportbase_idimported_idr  r  r.  symbols              rP  visit_importzSemanticAnalyzer.visit_import  sS    &	 &	IB )-(9$9$\dl>\! # 5 Du((3--*% 5$,&&|G,%%''  DDY*DDD($m}K\   (("/&3"3 )     00 '"/&3"3 1    A&	 &	rR  imprZ   c           
     h   || _         |                     |          }| j                            |          }|j        D ]\  }}|dz   |z   }|                     |           |d }n|| j        k    r*|| j        v r!t          t          | j        |                   }nJ||cxk    rdk    r#n n || j	        v r| j	        |         | j
        d d <   |j                            |          }d}|p|}	| j         o| j        j        }
|
p	|d uo||k    }|sL| j                            |          }|%|                                 }t          ||          }n|| j        v rd}|rT|sRd|j        v rI|dz   |z   }|                     |j        d         |	|          }|r|                     |	||||            q|rB|                     ||||	|||           |j        r|                     |||	|| |d           |r |s|                     |||	|| |	           |                     |	|||| 
           d S )Nr|  r  FT__getattr__r  r:  )r  r  r  r$  r  r  r  r  r  r  )r:  r   r%  r  rq  set_future_import_flagsr  r}   r%   rF  rE  rY  r"  r"  current_symbol_kindr<  create_getattr_varr  process_imported_symbolr  report_missing_module_attributer$  )rO  r+  	module_idmoduler  r%  rr  r  missing_submoduler(  r&  r  modr.  gvars                  rP  visit_import_fromz"SemanticAnalyzer.visit_import_from7  s&   0055	!!),, S	 S	IB 3+H((222~do--(dl2J2J 'tT\(-CDD++++)+++++	T_0L0L*./)*DD$QQQ'|''++ %+2K
 )-(9$9$\dl>\!1Xe46G6WBRWKM  -l&&x00?3355D*455DD!555(,% d }'D'D %s?R/..v|M/JKYabb OO#&3*7&7 $      ,,)RhWZ -    % 	88!#&3*7&7 #49 9      1 44"/&3"3 5     00 ("/&3"3 1    [S	 S	rR  r}   r5  r  r(  r  rY   c                ~   | oAt          |j        t                     p&|| j        vp|                    | j        dz              }t          |j        t                    rC| j        r|                     ||||||           d S | 	                    ||j        ||d           | 
                    |||||           d S )Nr|  r.  T)r  r  r8  r  )r~  r  rc   r%  
startswithr  rn   r_  r4  r  r#  )	rO  r  r5  r  r(  rr  r  r  r  s	            rP  r3  z(SemanticAnalyzer.process_imported_symbol  s    *) 
 49h/// >t|+> &&t'<=== 	 di11 	# 44"/"/# 5     $$I"/"/%) %    	  wmS` 	! 	
 	
 	
 	
 	
rR  T	import_id	source_idr  rf   r$  c                   |                      |          r|                     ||||           d S d| d| d}| j                            |          }	|	r||	j                                        v r|	j        |         j        s
d| d| d}nht          |	j                                                                      |h          }
t          ||
d          }|rdt          |d	           d
}|| z  }|                     ||t          j                   |r|                     ||d ||            |dk    rd|                                 }|                     |          &|t"          v r| j                            ||           d S | j                            d          }|r_||j        v rX| j                            d| d|t          j                   | j                            d|t          j                   d S d S d S d S )Nr  zModule "z" has no attribute "r@  z(" does not explicitly export attribute "r  )r  z; maybe or?r  r/  ro  r  rp  z#Use `from typing_extensions import z	` insteadzhSee https://mypy.readthedocs.io/en/stable/runtime_troubles.html#using-new-additions-to-the-typing-module)is_incomplete_namespacer  r%  r  rq  keysr  rB  
differencer   r   r  r&  ATTR_DEFINEDr$  r  r  r   rD  add_fixture_noter  )rO  r=  r>  r(  r  r  r  r$  messager6  alternativesmatches
suggestionrr  rp  s                  rP  r4  z0SemanticAnalyzer.report_missing_module_attribute  s    ''	22 	   WMQ^ !    FHYHHIHHH!!),, 
	/FL--////Y8O8]/^y^^R[^^^   #6<#4#4#6#677BBI;OO&y,!DDD /!HJw,E,E!H!H!HJ*.G		'7);	<<<& 	,, +"// -      69??#4#466H33H==E 777 ))(G<<<<<$(L$4$45H$I$I!$ 
6G6M)M)MHMMRiRRR"/ "   
 HMM C"/ "     # ! 
 
)M)MrR  existing_symbolmodule_symbolimport_nodec                4   |j         |j         u rdS |j        t          t          t          fv rt          |j         t          t          t          t          t          f          rt          |          }|j        |_        |j         |_         t          |          }|j        |_        |j         |_         t          |j         t                    rd|_        t          |g|          }|||fD ]}|                    |           |j                            |           dS dS r  )r  r.  r)   r%   r*   r~  r   rR   r   rF   r   re   is_alias_rvaluer8   r  assignmentsr  )	rO  r(  rK  rL  rM  lvaluervalue
assignmentr  s	            rP  !process_import_over_existing_namez2SemanticAnalyzer.process_import_over_existing_name  s    =#5555D$#555* 39i"P;
 ;
5
 k**F).FK).FKk**F',FK',FK&+y11 . *.&'&99J"FF2 + +k****#**:6664urR  ImportFrom | ImportAllc                    t          | j        |j        |j        | j                                                  \  }}|s|                     d|           |S )Nz*Relative import climbs too many namespaces)r   r  relativer  r#  r  r  )rO  r  r=  oks       rP  r   z(SemanticAnalyzer.correct_relative_import  sY    /OT]DGT5F5[5[5]5]
 
	2  	JIIBDIIIrR  rX   c                (   |                      |          }|| j        v r| j        |         }|                     |          r|                     d|           |j                                        D ]\  }}|dz   |z   }|                     |           |j        rv|                    d          r	d|j        v rXt          |j
        t                    r$| j                            |j
        j                   |                     |||dd           d S d S )N*r|  r@  r  TFr   )r   r%  rB  r  rq  r  r0  r  r<  r~  r  rc   r7  r  rr  r#  )rO  r  i_idmr  r  rr  s          rP  visit_import_allz!SemanticAnalyzer.visit_import_all'  s3   ++A..4<T"A++D11 - $$S!,,,gmmoo  
d#:,,,X666 % ts/C/C yTUT[G[G[!$)X66 =(();<<<,,dATQV -      DrR  r7   c                    |j                             |            |                                 r|                     |          sd S |                     |j        dd           d S )NT)escape_comprehensionshas_explicit_value)rf  r  r  check_valid_comprehensionanalyze_lvaluer  rO  r	  s     rP  visit_assignment_exprz&SemanticAnalyzer.visit_assignment_exprE  si    	t 	11!44 AHDUYZZZZZrR  c                   t          t          | j                            D ]d\  }}|t          k    rT|t	          | j                  dz
  k     r9| j        d|z
           '|                     d|t          j        dd            dS  nedS )zCheck that assignment expression is not nested within comprehension at class scope.

        class C:
            [(j := i) for i in [1, 2, 3]]
        is a syntax error that is not enforced by Python parser, but at later steps.
        r  r  NzKAssignment expression within a comprehension cannot be used in a class bodyT)r  seriousr  F)	r  r  r+  r  r  r)  r  r&  SYNTAX)rO  r	  r  
scope_types       rP  ra  z*SemanticAnalyzer.check_valid_comprehensionL  s     'x0@'A'ABB 	 	MAz000QT[9I9IA9M5M5M;rAv&.II:"\ $ $     !55trR  r8   c                   || _         |                     |          rd S |                                 }|                     |          r\| j        }d| _        |                                 5  |j                            |            d d d            n# 1 swxY w Y   || _        nv|                     |          rG|                                 5  |j                            |            d d d            n# 1 swxY w Y   n|j                            |            | 	                    |          s| 
                    |j                  r/t          |          D ]}|                     |j        |           d S |                     |          rF|                                 5  |j                            |            d d d            n# 1 swxY w Y   d}|                     |          r
d|_        d}nt!          |j        t"                    r|                     |          rd}n|                     |          rd}n||                     |          rd}nd|                     |          rd}nL|                     |          rd}n4| j                            |          rd}n|                     |          rd}|r|                     |           d S d|_        |                     |          |_        |                     |           |                     |           |                     |           |                      |           | !                    |           | "                    |           |j#        s!| $                    |j%        |j        |           | &                    |           | '                    |           | (                    |           d S r!  ))r:  "analyze_identity_global_assignmentr  can_possibly_be_type_formrJ  re  rR  r  'can_possibly_be_typevarlike_declarationr  should_wait_rhsnames_modified_by_assignmentr  r  check_and_set_up_type_aliasis_alias_defr~  r=   process_typevar_declarationprocess_paramspec_declaration process_typevartuple_declarationanalyze_namedtuple_assignanalyze_typeddict_assignr  process_newtype_declarationanalyze_enum_assignrecord_special_form_lvalueunwrap_finalis_final_defanalyze_lvaluescheck_final_implicit_defstore_final_statuscheck_classvarprocess_type_annotationapply_dynamic_class_hookrV  process_module_assignmentr  process__all__process__deletable__process__slots__)rO  r	  r  old_basic_type_applicationsr  r  s         rP  visit_assignment_stmtz&SemanticAnalyzer.visit_assignment_stmtb  s    22155 	F((** ))!,, 	"*.*F'+/D(--// & &%%%& & & & & & & & & & & & & & &+FD((99!<< 	"--// & &%%%& & & & & & & & & & & & & & & HOOD!!!$$S)) 	T-A-A!(-K-K 	 5Q77 6 6$$TY5555F))!,, 	& --// & &%%%& & & & & & & & & & & & & & & ++A.. 	$!ANLL(++ 	$//22 $#33A66 $#66q99 
$#//22 $#..q11 $#&BB1EE $#))!,, $# 	++A...F  **1--Q%%a((("""A$$Q'''%%a(((v 	C**19ahBBBA!!!$$$a     s6   *BBBC44C8;C8!GGGc                   t          |j        t                    rt          |j                  dk    rdS |j        d         }t          |t                    r|j        j        |j        k    rdS | j        |                                 rdS |j        }|                     ||          }|| j	        rdS | 
                                 dS |j        dS || j        vr|                     ||j        |           t          |j        t                    s5|j        |fD ]+}|j        |_        t          |_        |j        j        |_        ,dS )zSpecial case 'X = X' in global scope.

        This allows supporting some important use cases.

        Return true if special casing was applied.
        r  Fr   NT)r~  rR  re   r  r  r  rV  r  r  r_  r  r  r&  r  rn   r%   r.  rr  )rO  r	  rQ  r  re  r  s         rP  rj  z3SemanticAnalyzer.analyze_identity_global_assignment  s?    !(H-- 	QY11D1D51&(++ 	qx}/K/K59 D$6$6$8$8 5{kk$"";# u

txu4<''ch222ch88 6Hf, 6 6D #DI $DI$'H$5DMM4rR  rvc                   | j         rdS t          |t                    rF|                     |j        |          }|r(t          |j        t                    r|j        j        sdS nt          |t                    rTt          |          }|rB| 
                    ||d          }|r(t          |j        t                    r|j        j        sdS nt          |t                    r4t          |j        t                    r|                     |j                  S t          |t                    r4t          |j        t                    r|                     |j                  S dS )a  Can we already classify this r.h.s. of an assignment or should we wait?

        This returns True if we don't have enough information to decide whether
        an assignment is just a normal variable definition or a special form.
        Always return False if this is a final iteration. This will typically cause
        the lvalue to be classified as a variable plus emit an error.
        FTr]  )r_  r~  re   r  r  r  rn   r8  rb   r   rb  r[   r?  rq   rm  r=   r  )rO  r  r  fnames       rP  rm  z SemanticAnalyzer.should_wait_rhs  sS     	5b(## 	3BGR((A Z88 AX tJ'' 	3,R00E  ))%T)JJ  AFO<<  QVE\  4I&& 	3:bgw+G+G 	3''000H%% 	3*RY*H*H 	3 ''	222urR  
allow_nonec                   t          |t                    r|                     |d          rdS t          |t                    r|                     |j        d          rdS |                     |          rdS |r"t          |t                    r|j        dk    rdS t          |t                    rN|j	        dk    rC| j
        rdS |                     |j        d          r|                     |j        d          rdS dS )zIs this a valid r.h.s. for an alias definition?

        Note: this function should be only called for expressions where self.should_wait_rhs()
        returns False.
        T)bareFbuiltins.None|)r  )r~  rq   is_type_refr[   r?  is_none_aliasre   rr  ri   oprY  can_be_type_aliasleftright)rO  r  r  s      rP  r  z"SemanticAnalyzer.can_be_type_alias  s)    b'"" 	t'7'7'7'F'F 	4b)$$ 	)9)9"')9)N)N 	4b!! 	4 	*R22 	r{o7U7U4b&!! 	besll  t%%bg$%?? DDZDZT E[ E E  turR  c                   t          |j                  dk    rdS t          |j        t                    rBt          |j        j        t                    r#|j        j        j        }|t          v p|t          v S t          |j        d         t                    sdS |j        |                     |          sdS t          |j        t          t          f          sdS dS )a  Like can_be_type_alias(), but simpler and doesn't require fully analyzed rvalue.

        Instead, use lvalues/annotations structure to figure out whether this can potentially be
        a type alias definition, NamedTuple, or TypedDict. Another difference from above function
        is that we are only interested IndexExpr, CallExpr and OpExpr rvalues, since only those
        can be potentially recursive (things like `A = A` are never valid).
        r  Fr   NT)r  r  r~  rR  r=   r  rq   rr  r   r   re   rV  
is_pep_613r[   ri   rO  r	  refs      rP  rk  z*SemanticAnalyzer.can_possibly_be_type_form  s     qy>>A5ah)) 	Hj'.R.R 	H(/*C,&G#1G*GG!)A,11 	5(1C1C(5!(Y$788 	5trR  c                J   t          |j                  dk    s t          |j        d         t                    sdS t          |j        t
                    rt          |j        j        t                    sdS |j        j        }|                    |            |j        t          v S )z1Check if r.h.s. can be a TypeVarLike declaration.r  r   F)
r  r  r~  re   rR  r=   r  r  rr  r   r  s      rP  rl  z8SemanticAnalyzer.can_possibly_be_typevarlike_declaration*  s    qy>>Qj1x&H&H5!(H-- 	ZQY5Z5Z 	5ho

4|222rR  r  c                F   t          |t                    sdS t          |j        t                    r!|                     d|j         d|           dS |rh d}nt          }t          |j        t                    s	|j        |v rdS t          |j        t                    r|rdS |j        j	         S t          |j        t                    r|j        j        t          v S t          |t                    rF|                     |j        |          }|r(t          |j        t                    r|j        j        rdS nht          |t"                    rSt%          |          }|rB|                     ||d          }|r(t          |j        t                    r|j        j        rdS dS )a  Does this expression refer to a type?

        This includes:
          * Special forms, like Any or Union
          * Classes (except subscripted enums)
          * Other type aliases
          * PlaceholderNodes with becomes_typeinfo=True (these can be not ready class
            definitions, and not ready aliases).

        If bare is True, this is not a base of an index expression, so some special
        forms are not valid (like a bare Union).

        Note: This method should be only used in context of a type alias definition.
        This method can only return True for RefExprs, to check if C[int] is a valid
        target for type alias call this method on expr.base (i.e. on C in C[int]).
        See also can_be_type_alias().
        FzType variable "z%" is invalid as target for type alias>   typing.Tupletyping.Callable
typing.AnyTr]  )r~  rq   r  r   r  rr  r   r   r   r  r   r   re   r  r  rn   r8  rb   r   rb  )rO  r  r  
valid_refsr  r  s         rP  r  zSemanticAnalyzer.is_type_ref4  s   $ "g&& 	5bg// 	IIZZZZ\^___5 	+ KJJJJ*Jbgy)) 	R[J-F-F4bgx(( 	' tw&&bgs## 	37#{22b(## 	 BGR((A Z88 QV=T tJ'' 	 ,R00E   ))%T)JJ  AFO<<  AX  4urR  c                   t          |t                    rt          |j        t                    rt	          |j                  dk    rt          |j        d         t                    r|                     |j        j        |j                  }|                     |j        d         j        |j        d                   }|2|j        r+|j        j	        dk    r||j        r|j        j	        dk    rdS dS )zIs this a r.h.s. for a None alias?

        We special case the assignments like Void = type(None), to allow using
        Void in type annotations.
        r  r   Nr_  r  TF)
r~  r=   r  re   r  rd  rb  r  r  rr  )rO  r  callr  s       rP  r  zSemanticAnalyzer.is_none_aliask  s     dH%% 	 4;11 	NNa''ty|X66 ( ,,T[-=t{KK++DIaL,=ty|LL$	 %	*o== ()_<<4urR  c                   |j         d         }t          |t                    sJ d|_        |                                 t
          k    r|                     |j                  |_        |                                 |_	        dS )zRecord minimal necessary information about l.h.s. of a special form.

        This exists mostly for compatibility with the old semantic analyzer.
        r   TN)
r  r~  re   is_special_formr1  r%   r  r  rr  r.  )rO  r	  rQ  s      rP  rx  z+SemanticAnalyzer.record_special_form_lvalue  sr    
 1&(+++++!%##%%--"11&+>>FO..00rR  c                    t          |j        t                    r4t          |j        j        t                    r|                     |          S | j                            ||                                           S )zCheck if s defines an Enum.)	r~  rR  r=   r4  rK   _is_single_name_assignmentr  process_enum_callr  rc  s     rP  rw  z$SemanticAnalyzer.analyze_enum_assign  sg    ah)) 	6j9JL.Y.Y 	6 221555&88D<N<N<P<PQQQrR  c                N   t          |j        t                    rmt          |j        j        t                    rN|j        j        j        j        r8t          |j        j        j        j                  s|                     |          S t          |j
                  dk    s't          |j
        d         t          t          f          sdS |j
        d         }t          |t                    rqt          |j        t                    rUt          |j        j        t                    r6|j        j        j        }|dk    s	|t           v r|                     d|           dS |j        }|                     |          }|                     | j                            |                    5  | j                            |j        ||                                           \  }}}|	 ddd           dS ||k    rI|                     d                    ||          |j        t6          j                   	 ddd           d	S |s|                     ||d	
           n5|                     |j        |           |                      |j                   	 ddd           d	S # 1 swxY w Y   dS )z Check if s defines a namedtuple.r  r   Fzcollections.namedtuplez0NamedTuple type as an attribute is not supportedNz7First argument to namedtuple() should be "{}", not "{}"r  Tr7  )!r~  rR  r=   r4  rd   r  r  r   r  r  r  re   rb   r  rq   rr  r   r  r  r  r  r0  r  r  check_namedtupler  formatr&  
NAME_MATCHr  rM  r  rN  )	rO  r	  rQ  rr  r  r  internal_namer  r[  s	            rP  rt  z*SemanticAnalyzer.analyze_namedtuple_assign  s   ah)) 	:j9JN.[.[ 	:x %0 :!&1: : :
 66q999qy>>Qj1*?U&V&V51fj)) 	!(H-- Z*QX_g2V2V Z8?37778G];];]IIPRXYYY5{''--	""4?#>#>y#I#IJJ 	 	-1-F-W-W$ 2 2 4 4. .*M4 $	 	 	 	 	 	 	 	 $$		MTTm  H)     	 	 	 	 	 	 	 	   6$$T6D$IIII$$TY	:::**49555+	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	s    %;J-AJ<AJJ!Jc                   t          |j        t                    rmt          |j        j        t                    rN|j        j        j        j        r8t          |j        j        j        j                  s|                     |          S t          |j
                  dk    s't          |j
        d         t          t          f          sdS |j
        d         }|j        }|                     |          }|                     | j                            |                    5  | j                            |j        ||                                           \  }}}|s	 ddd           dS t          |t                    r$|                     d|           	 ddd           dS |s|                     ||d           n2|j        }|                     ||           |                     |           	 ddd           dS # 1 swxY w Y   dS )z Check if s defines a typed dict.r  r   FNz,TypedDict type as attribute is not supportedTr7  )r~  rR  r=   r4  r   r  rz  r   r  r  r  re   rb   r  r  r  r0  r  r  check_typeddictr  r  r  r  rM  rN  )	rO  r	  rQ  r  r  is_typed_dictr  r[  r  s	            rP  ru  z)SemanticAnalyzer.analyze_typeddict_assign  sl   ah)) 	:j9JM.Z.Z 	:x %4 :_!&5> > :
 66q999qy>>Qj1*?U&V&V51{''--	""4?#>#>y#I#IJJ 	 	-1-E-U-U$ 2 2 4 4. .*M4 ! 	 	 	 	 	 	 	 	 &*-- 		H&QQQ	 	 	 	 	 	 	 	  1$$T6D$IIIIy$$T9555**4000!	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	s   ;G;',G; AG;;G?G?c                r    t          |j                  dk    ot          |j        d         t                    S r  )r  r  r~  re   rc  s     rP  r  z+SemanticAnalyzer._is_single_name_assignment  s*    19~~"Iz!)A,'I'IIrR  c                X   |j         d u}|                     |j                   r*t          |j         t                    sJ |j         j        sd}|j        r+t          |j        t                    r|j        j         }nd}nd}|j        D ] }| 	                    |||j
        |           !d S )NFT)explicit_typer  r`  )rV  is_final_typer~  r   rd  rR  r~   no_rhsr  rb  rz  )rO  r	  explicitr`  lvals        rP  r{  z SemanticAnalyzer.analyze_lvalues  s    $D0a/00 	!a/=====$) ! 8 	'!(H-- *)*%8""%)""!&I 	 	D&#5	      	 	rR  c                    t          |j        t                    sd S d}|j        }	 t          |j        t                    r|j        j        }|st          |j        t                    r|j        j        }t          |t                    r!|j        r|j        j        }|j        dz   |z   }nt          |t                    rSt          |j
        t                    r9t          |j        t                    r|j        j        }|j
        j        dz   |z   }nt          |t                    r|}	 |sd S | j                            |          }|sd S |j        D ]7}t          |t                     s |t#          ||j        |                      8d S )Nr5  Tr|  )r~  rR  r=   r  rq   rr  rb   r  r  r[   r?  r4  r   r9  get_dynamic_class_hookr  re   r   )rO  r	  r  r  callee_exprmethod_namer  r  s           rP  r  z)SemanticAnalyzer.apply_dynamic_class_hook  s   !(H-- 	Fx	$+w// -, ZZ@@ "k.k733 8L "&+"2K'036DEE{I66
";#3W==
 #;#7II

 #'+"2K',5;kIEEX66 &D 	F{11%88 	FI 	@ 	@DdH-- D'di>>????	@ 	@rR  c                   |j         r|                     |j                   sdS t          |j         t                    sJ t	          |j         j                  dk    r|                     d|j                    d}|j         j        sYd|_        t          |j        t                    r7|j        j
        r+| j        r| j        j        sd}|                     d|           n|j         j        d         |_        |j        B| j        j        dk     r2|                     |j                  r|                     d	|           dS t	          |j                  dk    s t          |j        d         t                     s|                     d
|           dS |j        d         }t          |t                     sJ |j        r|j        du |_        | j        d         dk    r|                     d|           | j        r:| j        j        r.|                                 r| j                            |           t          |j        t                    rC|j        j
        r7| j        s0|                                 s|s| j                            |           dS )am  Strip Final[...] if present in an assignment.

        This is done to invoke type inference during type checking phase for this
        assignment. Also, Final[...] doesn't affect type in any way -- it is rather an
        access qualifier for given `Var`.

        Also perform various consistency checks.

        Returns True if Final[...] was present.
        Fr  z*Final[...] takes at most one type argumentNTzAType in Final[...] can only be omitted if there is an initializerr   )r     z=Variable should not be annotated with both ClassVar and FinalzInvalid final declarationr  zCannot use Final inside a loop)rV  r  r~  r   r  rd  r  rV  rR  r~   r  r~  r"  r  r  r  rq   
is_new_defis_inferred_defr4  r1  r  rD  r  rY  final_without_value)rO  r	  invalid_bare_finalr  s       rP  ry  zSemanticAnalyzer.unwrap_final#  s      	(:(:1;L(M(M 	5!+[99999q %&&**IIBADUVVV" % 	/AF18X..bHOb 	b (,y'?	b &*"		]_`aaa&+A.AF F+g55  (( 6 IIUWXYYY5qy>>Qj1w&G&GII115555y|$(((((
 ? 	2#$6T>D ?2""II6:::9 	;. 	;""$$ ;77:::qx**	0	0 %	0 ''))		0 & 0,,Q///trR  c                r   |j         sdS |j        d         }t          |t                    sJ t          |t                    rr|                     |          s|                     d|           d|_         dS | j        sJ | j        d         j        dk    r!|                     d|           d|_         dS dS dS )zDo basic checks for final declaration on self in __init__.

        Additional re-definition checks are performed by `analyze_lvalue`.
        Nr   z;Final can be only applied to a name or an attribute on selfFr  rQ  z<Can only declare a final attribute in class body or __init__)	rz  r  r~  rq   rb   is_self_member_refr  r1  r  )rO  r	  r  s      rP  r|  z)SemanticAnalyzer.check_final_implicit_defd  s    
 ~ 	Fy|$(((((dJ'' 
	**400 			WYZ[[[!&****&r*/:==II\^_```%*ANF
	 
	 >=rR  c                   |j         rt          |j                  dk    rt          |j        d         t                    r|j        d         j        }t          |t                    rtd|_        |j        rt          |j
        | j                  |_        |                                 r5t          |j
        t                    r|j
        j        rd|_        dS dS dS dS dS dS dS |                     |j                  D ]}t          |t$                    rt          | j        t&                    r| j        j        r| j        j                            |j        d          }|rkt          |j        t                    rQt          |j
        t                    r|j
        j        s+t1          |j        j                   x|j        _        |_         t          |t2                    r|                     |          r| j        s
J d            | j        j                            |j        d          }|rt          |j        t                    r~|j        j        rr| j        sJ | j        d         }|j        dk    rQ|j        j        rE|j        j        s9t          |j
        t                    r|j
        j        sd|j        _        d|_         dS )zRIf this is a locally valid final declaration, set the corresponding flag on `Var`.r  r   TNSelf member outside a classr  rQ  )rz  r  r  r~  rq   r  r   r  rV  r   rR  r  final_valuer  r~   r  final_unset_in_classflatten_lvaluesre   r   r  rq  r  r  r   rb   r  r1  final_set_in_init)rO  r	  r  r  cur_nodecurrent_functions         rP  r}  z#SemanticAnalyzer.store_final_statusy  s   > 7	219~~""z!)A,'H'H"y|(dC(( 9$(DMv Y+=ah+X+X(**,, 9"18X669;<8?9 59111 #"""9 99 9 9 9 9 9
 ,,QY77 +2 +2 tX..d"49h77d 	)d
  $y2249dCCH d&x}c::d ",AHh!?!?d EFHOd GPPXP]PbFcFcBcc.
 dJ// 2D4K4KD4Q4Q 29CC&CCCC#y2249dCCH 
2Jx}c$B$B 
2x}G] 
2#2222+/+>r+B(,1Z?? ( B @$,M$C @ &0(%C%C @ IJ @
 ?CHM;-1ANW+2 +2rR  r  c                    g }|D ]a}t          |t          t          f          r.|                    |                     |j                             L|                    |           b|S rT  )r~  r   r_   r  r  r  r  )rO  r  reslvs       rP  r  z SemanticAnalyzer.flatten_lvalues  sh     " 	 	B"y(344 

4//99::::

2
rR  c                   |j         r|j        d         }t          |t                    }|                     |j         |          }|t          |          r|                     |           dS ||_         | j         rm| j         j        rat          |t                    rLt          |j	        t                    r2|j	        j        r&t          |j        t                    rd|j        _        n,| j         rK| j         j        r?|                     |          r*|                                 s|                     d|           t%          |j                  dk    rt          |j        d         t&                    r|j        d         }d}| j         r^t          |t                    rIt%          | j         j                  dk    r,| j         j        d                             |j                  du }|r,|j        r%|                     |j	        |j                  |_         |j         r%|j        D ]}|                     ||j                    dS dS )z5Analyze type annotation or infer simple literal type.r  r)  NTz8All protocol members must have explicitly declared typesr  r   )rV  r  r~  r   r  r   r  r1  re   rR  r~   r  r  r   is_abstract_varis_annotated_protocol_memberr  r  r  rq   ru  r  r  r  analyze_simple_literal_typerz  store_declared_types)rO  r	  rQ  r)  r4  ref_exprsafe_literal_inferences          rP  r  z(SemanticAnalyzer.process_type_annotation  sN   6 #	XYr]F",VY"?"?~~afBU~VVH?8#<#<

1AF	7I)7 vx007 qx22	7
 HO7 fk3// 726FK/ 	YI)Y 55a88Y **,,	Y 		TVWXXX19~~""z!)A,'H'H"9Q<)-&9 YHh!?!? YC	DVDVYZDZDZ .2Y]1-=-A-A(--P-PTX-X*) Xh.F X!==ahWWAF6 	:) : :))&!&9999	: 	:: :rR  c                >    t          d |j        D                       S )zCheck whether a protocol member is annotated.

        There are some exceptions that can be left unannotated, like ``__slots__``.c              3  d   K   | ]+}t          |t                    o|j        d k    o|j        V  ,dS )	__slots__N)r~  re   r  r  )rC  r  s     rP  r  z@SemanticAnalyzer.is_annotated_protocol_member.<locals>.<genexpr>  sT       
 
 H%%W"'[*@WREW
 
 
 
 
 
rR  )r  r  rc  s     rP  r  z-SemanticAnalyzer.is_annotated_protocol_member  s4      
 
i
 
 
 
 
 	
rR  rR  r  Type | Nonec                   | j         rdS t          || j                  }|t          |t                    rdS t          |t
                    rd}nGt          |t                    rd}n/t          |t                    rd}nt          |t                    rd}| 	                    |          }|r'|r%|
                    t          ||                    S |S )zReturn builtins.int if rvalue is an int literal, etc.

        If this is a 'Final' context, we return "Literal[...]" instead.
        Nzbuiltins.boolzbuiltins.intr  zbuiltins.float)rf  rn  )last_known_value)r1  r   r  r~  complexr  intr  floatr  r  r   )rO  rR  r  rf  	type_namer  s         rP  r  z,SemanticAnalyzer.analyze_simple_literal_type  s    
  	
 4"64?;;=Jug66=4eT"" 	)'IIs## 	)&IIs## 	)&IIu%% 	)(I%%i00 	^8 	^$$kX[6\6\6\$]]]
rR  r%  declared_type_varsTypeVarLikeList | Noneall_declared_type_params_nameslist[str] | Nonerf  Dtuple[Type | None, list[TypeVarLikeType], set[str], list[str], bool]c                <   t          | j        o| j        d                                                   }| j         o| j         }	 t	          || j        | j        | j                  }	nE# t          $ r8 | 	                    d|t          j                   dg t                      g dfcY S w xY w|                     |	          }
g }|                     |          }||
n|}|                     | j                            |                    5  |                     ||	          }|rA|                                 5  |                    |            ddd           n# 1 swxY w Y   t+          |	| | j        | j        | j        | j        | j        ||||||          \  }}ddd           n# 1 swxY w Y   g }d}|D ]1}t3          |t4                    r|rd}|                    |           2d	 |D             }t3          |	t8                    r|	j        nd}|||||fS )
a  Check if 'rvalue' is a valid type allowed for aliasing (e.g. not a type variable).

        If yes, return the corresponding type, a list of
        qualified type variable names for generic aliases, a set of names the alias depends on,
        and a list of type variables if the alias is generic.
        A schematic example for the dependencies:
            A = int
            B = str
            analyze_alias(Dict[A, B])[2] == {'__main__.A', '__main__.B'}
        r  rb  z2Invalid type alias: expression is not a valid typer  NF)r%  in_dynamic_funcglobal_scopeallowed_alias_tvarsalias_type_params_namesrf  Tc                "    g | ]\  }}|j         S rA  rp  )rC  _namer  s      rP  rD  z2SemanticAnalyzer.analyze_alias.<locals>.<listcomp>S  s    LLL[UD4=LLLrR  )r  r1  
is_dynamicrV  r   r"  rY  rb  r   r  r&  r'  rB  r  r  r  r0  r  r  re  r  r   r9  r#  r\  r~  r   r  r   empty_tuple_index)rO  r  rR  r%  r  r  rf  dynamicr  r  found_type_varsr[  r  alias_type_varsr4  
depends_onnew_tvar_defsvariadictdqualified_tvarsr  s                        rP  analyze_aliaszSemanticAnalyzer.analyze_alias  s   & t*St/B2/F/Q/Q/S/STT9}@T-@)@	.)d&7$J_  CC $ 	. 	. 	.IIDfSXSc     SUUB----		. 22377+-	''--	-?-G//M_""4?#>#>y#I#IJJ 	 	11/3GGI% (1133 ( (MM$'''( ( ( ( ( ( ( ( ( ( ( ( ( ( ( $6!*"3 ')$-(F'=$ $ $ Hj	 	 	 	 	 	 	 	 	 	 	 	 	 	 	0  	% 	%B".//     $$$$LLOLLL5?[5Q5Q\C11W\
OEVVVsH   "A( (?B*)B*-F*9EF*E	F*"E	#;F**F.1F.c                    |j         Nt          |j         t                    r4|                     |j         j        |d          }|r|j        t          v rdS dS )NTr]  F)rV  r~  r   rb  r  rr  r   )rO  r	  r  s      rP  r  zSemanticAnalyzer.is_pep_613W  s]    (Z8I;-W-W(**1+<+A1VZ*[[F &/-===turR  c           
        |j         rdS |j        d         }t          |j                  dk    st          |t                    sdS |                     |          }|s	|j        dS |                     |j        |j	                  r2|j        j
        d         }d}|                     |j                  \  }}n|j        }d}d}d}t          |t                    r	|j        rdS |                                                     |j	                  }|rt          |j        t"                    sUt          |j        t$                    r|j        r4t          |j        t(                    rk|j        j        j        |j        k     rQt          |j        t$                    r5|j        s.|                     d                    |j	                  |           dS | j        p|                                 }	|s|st          |t4                    r|	rdS |s|s|                     |          sdS |r#t          |j        t(          t$          f          sdS d}
|                     |          r#t;                      }
g }t=                      }g }d}n|                                 }|                      |j	        |d||          \  }
}}}}|
sdS |                                 s+t          |
tB                    ot          |
tD                    }ntG          |
          }| $                    |          s|r| %                    |j	        |d	           dS | &                    |           | &                    |           tO          |
| j(        | j)        | j*        |
           tW          |
          }
| j(        j,        rIt[          |
          r:tG          |
          s+| j*        .                    d|
|           t_          |
          }
t          |
tB                    o"t          |
t`                    o|
j
         o| o| }t          |
tB                    rNt          |
t`                    r9tc          |
| j        |          s#te          |
| j        | j3        d| j(                   |                                 }t%          |
| 4                    |j	                  |j        |j5        ||||          }t          |j        tl          t          tn          f          rt          |tn                    r| j(        j8        dk    s| j9        ret          |j        j        tt                    stu          |          |j        _        |j        |j        j        _        |
j5        |j        j        _5        n&t          |j        t4                    rd|j        _;        |rd}t          |j        t$                    rC|j        j<        |
k    r2|
|j        _<        ||j        _=        ||j        _>        d}d|j        _?        n	||_        d}|r<| j@        r| A                    |j	        d|           dS | B                    |d           n| C                    |j	        ||           t          |t4                    r+t          |j        t$                    r|j        jD        |_D        |r|j        n|}t          |t$                    sJ | E                    |||j                   | F                                r`| j        J | j        jG        rK|                     d|           |j	        d         H                                s| 3                    d|           dS )a/  Check if assignment creates a type alias and set it up as needed.

        Return True if it is a type alias (even if the target is not ready),
        or False otherwise.

        Note: the resulting types for subscripted (including generic) aliases
        are also stored in rvalue.analyzed.
        Tr   r  FNr  zTCannot assign multiple types to name "{}" without an explicit "Type[...]" annotation)r%  r  r  r7  r:  Type alias targetr  rl  r  eagerrf  )r  
   r  r  z.Type aliases are prohibited in protocol bodiesz9Use variable annotation syntax to define protocol members)Iinvalid_recursive_aliasr  r  r~  re   r  rV  check_type_alias_type_callrR  r  rd  analyze_type_alias_type_paramsr=   r4  current_symbol_tabler  r  r   r   rp  rn   r  r  r  rV  r  rq   r  r  r   rB  r  r  r   r   r   r  r  r,  r   r"  r\  rD  make_any_non_explicitr  r   r  make_any_non_unimportedr   r   r   r  r  r  r[   ri   r  rY  r   rO  r  rl  r  _is_recursiver_  cannot_resolve_namer  r  r  !disable_invalid_recursive_aliasesr  r1  isupper)rO  r	  rQ  pep_613rR  pep_695type_paramsall_type_params_namesr  non_global_scoper  rl  r  r  r  r  incomplete_targetr  r  r  updatedcurrent_nodes                         rP  ro  z,SemanticAnalyzer.check_and_set_up_type_alias^  s    $ 	41qy>>AZ%A%A5//!$$ 	1,8 5 **18&+*FF 	)X]1%FG151T1TUVU]1^1^.K..XFGK$(!fh'' 	FO 	5,,..226;??  	x}c**	8=)44	=>^	 8=/::	 @H}?Q?VYZY_?_?_ (-33 AN 		BBH&BUBU  
 59<(:(:(<(< 	w 	:fg+F+F 	K[ 	 5 	w 	t/E/Ef/M/M 	5 	Jx}	6RSS 	5f%% 	**C13K#&55J)+O %,,..COSOaOa"&#./D Pb P PLCj/;L  u%%'' 9 %/sJ$?$? %JE E!! %4C$8$8!((-- 1B  $$V[&4$PPPt  ,,, 	  111 	sDL$2Ldh`abbbb $C((</ 	34PQT4U4U 	3"3'' 3445H#qQQQ-c22 sJ'' 3))H &%  	 c:&& 	b:c8+D+D 	b$S$)5FGG bS$)TYUTXT`aaaa ""$$,,FH##*	
 	
 	

 ahHf =>> 	,66**	,+w66$:K6 ah/?? >$1*$=$=!%&VAH"'*zAH$$'** 	,'+AH$ 	8G(-33 ='3.. ,/HM(0;HM-,3HM)"G26HM/ !+ 7' 7,,V[&!DDD4 JJqJ666OOFKQ777fg&& 	;:fk9+M+M 	;$*K$:J!(0@x}}j,	22222..q,III   	^9(((y$ ^		JANNN{1~--// ^IIY[\]]]trR  TypeGuard[CallExpr]c               H   t          |t                    sdS dg}| j        j        dk    r|                    d           t          |j        t          |                    sdS |                     |||          sdS |j	        
                    t                    dk    rdS dS )NFtyping_extensions.TypeAliasType)r     typing.TypeAliasTyper  T)r~  r=   r"  r  r  r  r  tuplecheck_typevarlike_namer%  countr!   )rO  rR  r  rq  s       rP  r  z+SemanticAnalyzer.check_type_alias_type_call0  s    &(++ 	523<&'11LL/000!&-u>> 	5**64@@ 	5!!'**a//5trR  r=   !tuple[TypeVarLikeList, list[str]]c                   d|j         v r\|j        |j                             d                   }t          |t                    s|                     d|           g g fS |j        }ng g fS g }g }d}|D ]	}t          |t                    rd|_        | 	                    |           	 | 
                    |          }n# t          $ r Y Ww xY wt          |t                    sq|                                 }	|                     |d          }
|
rEt          |
d         t                    r)|r%|                     d|t           j                   d}d}n|                     |	          s|                     |j        |          }|r:t          |j        t,                    r |                    |j        j                   nT|                     d	|t           j                   |r0|j        t2          v r"|                     d
|t           j                   |
|v r.|                     d|
d          d|t           j                   |
r0|                    |
d                    |                    |
           ||fS )zAnalyze type_params of TypeAliasType.

        Returns declared unbound type variable expressions and a list of all declared type
        variable names for error reporting.
        r
  zCTuple literal expected as the type_params argument to TypeAliasTypeFT)r  r  zFCan only use one TypeVarTuple in type_params argument to TypeAliasTyper  zDFree type variable expected in type_params argument to TypeAliasTypez*Don't Unpack type variables in type_paramszDuplicate type variable "r   z*" in type_params argument to TypeAliasType)rG  rd  indexr~  r   r  r  rw   r  r  r   r   r   r  r  r   r&  TYPE_VARr  rb  r  r  r   r  rr  r   r  )rO  rR  type_params_argr
  r  all_declared_tvar_namesr  tp_exprr?  r  r  re  s               rP  r   z/SemanticAnalyzer.analyze_type_alias_type_params@  s    F,,,$k&*:*@*@*O*OPOoy99 		Y#   2v)/KKr6M*,-/#" 0	, 0	,G'8,, & %""7+++33G<<'   dK00 ,,..C11$41PPD d1g'788 	/* !		d !& "   
 /3+ *.'..s33 ++DIt<< :ch@@ +2238=AAAAII^"^    
  s|/@@@		H$UZUc "    ~%%		cQccc    
  ,'..tAw777%%d+++666s   'B==
C
	C
AssignmentStmt | TypeAliasStmtr  r   ctxc                <   g }t          |j        t                    r-|j        j        |u r|                    d|j         d           nZt          |h|j                  rDt          t          |j                  t                    rdnd}|                    d| d           t          ||j        | j
        | j                  r|                    d           |r%t          t          j                  |_        d|_        |D ]}|                     ||           d	S )
zEProhibit and fix recursive type aliases that are invalid/unsupported.zCannot resolve name "z" (possible cyclic definition)r  unionzInvalid recursive alias: a z item of itselfzAInvalid recursive alias: type variable nesting on right hand sideTN)r~  r  r   r  r  r  r   r   r   r   rb  r0  r   r   rF  r  r  )rO  r	  r  r   messagesr  rD  s          rP  r  z2SemanticAnalyzer.disable_invalid_recursive_aliases  sK    |*M::	S#)\99 OOY(9YYY    (8KLL 	S%ol6I&J&JIVVc\c  OOQ&QQQRRR!,-t/Ddo
 
 	a OO_``` 	-"))*>"?"?L(,A% 	  	 CIIc3	  	 rR  r  r`   r  r  r_  r`  is_index_varc                   |rt          |t                    s
J d            t          |t                    r|                     ||||||           dS t          |t                    rK|                     ||||           |r-|                     |          s|                     d|           dS dS dS t          |t                    r/|r|                     d|           |                    |            dS t          |t                    r| 
                    ||           dS t          |t                    r8|r|                     |j        ||           dS |                     d|           dS |                     d|           dS )a  Analyze an lvalue or assignment target.

        Args:
            lval: The target lvalue
            nested: If true, the lvalue is within a tuple or list lvalue expression
            explicit_type: Assignment has type annotation
            escape_comprehensions: If we are inside a comprehension, set the variable
                in the enclosing scope instead. This implements
                https://www.python.org/dev/peps/pep-0572/#scope-of-the-target
            is_index_var: If lval is the index variable in a for loop
        z-assignment expression target must be NameExpr)r`  r$  z;Type cannot be declared in assignment to non-self attributezUnexpected type declarationz4Starred assignment target must be in a list or tupleInvalid assignment targetN)r~  re   analyze_name_lvaluerb   analyze_member_lvaluer  r  r[   r  r   analyze_tuple_or_list_lvaluerw   rb  r  )rO  r  r  r  r  r_  r`  r$  s           rP  rb  zSemanticAnalyzer.analyze_lvalue  s   * ! 	_dH--^^/^^^^dH%% 	9$$%#5) %      j)) 	9&&t]HFXYYY _T%<%<T%B%B _		WY]^^^^^_ _ _ _i(( 	9 ?		7>>>KKi(( 	9--dMBBBBBh'' 	9 X##DIv}EEEEE		PRVWWWWWII1488888rR  rQ  re   c                   |j         rdS |j        }|                     |          r<|r|                     d|           n#| j                            || j        du|           |                                 }|                     |          }	|		                    |          }
| 
                    |          }|t          k    rt          | j        t                    r| j        j        r|                    d          s|
Nt          |
j         t                     s4|                     d                    || j        j                  |           |r.|r,|                     d|           |                     d|           |
rt          |
j         t                     r|s|                     ||| ||          }|                     ||||          }|rd|_        d|_        ||_        ||_         |t0          k    r|j        |_        n|j        |_        |                                 rNt9          |          d	k    r;| j        j        s/t?          t@          j!                  }| "                    ||           |r.| #                    ||          r|                     d|           dS dS dS | $                    |||           dS )
znAnalyze an lvalue that targets a name expression.

        Arguments are similar to "analyze_lvalue".
        N)Cannot redefine an existing name as final)r_  __z;Attempted to reuse member name "{}" in Enum definition "{}"z%Enum members must be left unannotatedzLSee https://typing.readthedocs.io/en/latest/spec/enums.html#defining-membersTr@  )%r  r  is_alias_for_final_namer  rD  cant_assign_to_finalrV  r1  r  r  is_global_or_nonlocalr*   r~  r   r  r<  rn   r  r  make_name_lvalue_varr  r  r  r.  r%   r  rr  r  r  r"  r  r   r   r  r  is_final_redefinition&make_name_lvalue_point_to_existing_def)rO  rQ  r  r  r_  r`  r$  r  r.  rq  r  outerr  addedr  s                  rP  r'  z$SemanticAnalyzer.analyze_name_lvalue  s    ; 	F{''-- 	S S		EvNNNN--dDIT4I6RRR''))))@U)VV99T??**400DLL49h// 	!  OOD))  #Jx}o,V,V#		QXXdin  	    !3 		A6JJJ		b  
  	YJx}oFF 	YPU 	Y++-/1C\ C OOD#vMbOccE ?$(!)-&"!4<<&)mFOO&,kFO%%'' ?~~,,T\5X, &i&<==11&#>>> OD66tTBB O		EvNNNNNO O O O 77xXXXXXrR  r.  r  c                    |t           k    r+|                     |          o|                     |           S |t          k    r%| j        rt          |          dz   | j        j        v S dS )N'F)r%   is_mangled_globalis_initial_mangled_globalr*   rV  r  rq  )rO  r.  r  s      rP  r1  z&SemanticAnalyzer.is_final_redefinition(  sd    4<<))$//\8V8VW[8\8\4\\T\\di\D>>C'49?::urR  c                \   |                                  ru|                    d          sdS t          |          }| j        d         
J d            | j        d                             |          }|d uot          |j                  S | j        Qt          |          dz   }||k    rdS | j        j                            |          }|d uot          |j                  S t          |          dz   }||k    rdS | j	                            |          }|d uot          |j                  S )Nr6  Fr  zNo locals at function scope)
r  r  r  r)  r  r   r  rV  rq  r&  )rO  r  r  	orig_names       rP  r-  z(SemanticAnalyzer.is_alias_for_final_name/  s1    	I==%% uD>>D;r?..0M...{2**400H4'HM(-,H,HHY" ,Iy  uy**955H4'HM(-,H,HH ,Iy  u|''	22H4'HM(-,H,HHrR  inferredr   c                X   |j         }t          |          }|                    |           ||_        |t          k    r*| j        J | j        |_        d|_        |t          v |_	        |t          k    r|                     |          |_        n||_        d|_        ||_        ||_        |S )z:Return a Var node for an lvalue that is a name expression.NTF)r  r   r  is_inferredr*   rV  r  r
  r   allow_incompatible_overrider)   r  r  r  r`  r$  )rO  rQ  r.  r;  r`  r$  r  r  s           rP  r0  z%SemanticAnalyzer.make_name_lvalue_varE  s     {II	

6 4<<9(((YAF(,A%,04O,OA)4<<--d33AKK AK
1%rR  c                   |r|                      d|           |                     |j        |d          }|:| j        r3|                                 s| j                            |j                  }|r|                     |j        ||           dS |r|                     ||           n|                     |j        |           | 	                    |j
        |           dS )zUpdate an lvalue to point to existing definition in the same scope.

        Arguments are similar to "analyze_lvalue".

        Assume that an existing name exists.
        r+  Tr]  N)r  r  r  rV  r  r  r  bind_name_exprname_not_definedcheck_lvalue_validityr  )rO  r  r  r  rk  s        rP  r2  z7SemanticAnalyzer.make_name_lvalue_point_to_existing_defa  s      	IIIA4HHH{{49dD{IIDId6H6H6J6J9==33L 		8%%di|DDDDD  7##D,7777%%di666&&ty$77777rR  r   c                    |j         }d |D             }t          |          dk    r|                     d|           dS t          |          dk    rd|d         _        |D ]}|                     |d|d           dS )z?Analyze an lvalue or assignment target that is a list or tuple.c                <    g | ]}t          |t                    |S rA  )r~  rw   r  s     rP  rD  zASemanticAnalyzer.analyze_tuple_or_list_lvalue.<locals>.<listcomp>  s'    KKKt
40J0JKdKKKrR  r  z%Two starred expressions in assignmentTr   )r  r  r  r`  N)r  r  r  r  rb  )rO  r  r  r  
star_exprsr  s         rP  r)  z-SemanticAnalyzer.analyze_tuple_or_list_lvalue|  s    
KKuKKK
z??QII=tDDDDD:!##&*
1#  ##"/ (, $     rR  rb   c                   |j         rdS |                    |            |                     |          r| j        s
J d            | j        j                            |j                  }| j                            |j                  }|r|r|                     d|           |j         sF|rDt          |j         t                    r*|j         j
        r|r|                     |j        ||           | j        j        r*|r(|&t          |j         t                    rd|j         _        |.|&t          |j         t                    r|j         j        s||s|r| j        j        r||                     d|           nd|_        d|_        t          |j                  }|                    |           |                     |j                  |_        | j        |_        d|_        |p||_        ||_        ||_         t/          t0          |d          | j        j        |j        <   |                     |j         |           dS )zAnalyze lvalue that is a member expression.

        Arguments:
            lval: The target lvalue
            explicit_type: Assignment has type annotation
            is_final: Is the target final
        Nr  r+  Fz9Protocol members cannot be defined via assignment to selfT)implicit)r  r  r  rV  rq  r  r  r  r~  r   r=  attribute_already_definedr1  r  r  r  r  r  r  r  r  explicit_self_typedef_varr}   r*   rB  )rO  r  r  r  r`  r  r  r  s           rP  r(  z&SemanticAnalyzer.analyze_member_lvalue  sZ    9 	FD""4(( /	Y9;;;;;;y**4955H9==++D MH M		EtLLL IJJ x}c22J M-	J
 "J ..ty$IIIy$ :); :@T hmS11 :49HM1 $DIs)C)C$	Ha$ $-$8$9( YT\IIY[_```` '+DO+/D(DIAJJt$$$"&"5"5di"@"@AK!YAF!&AJ+8+DHA(#$DL !DI1@qSW1X1X1XDIODI.""49d33333rR  
memberexprc                    t          |j        t                    sdS |j        j        }t          |t                    o|j        S )z1Does memberexpr to refer to an attribute of self?F)r~  r  re   r  r   r  )rO  rK  r  s      rP  r  z#SemanticAnalyzer.is_self_member_ref  s<    */844 	5#$$$55rR  Expression | SymbolNode | Nonec                    t          |t                    r|                     d|           d S t          |t                    r"|                     t          j        |           d S d S )Nr&  )r~  r   r  r   r   CANNOT_ASSIGN_TO_TYPE)rO  r  r   s      rP  rB  z&SemanticAnalyzer.check_lvalue_validity  sm    dK(( 	CII1377777h'' 	CII&<cBBBBB	C 	CrR  c                Z   t          |t                    rd|_        t          |j        t                    rm|j        }||_        d|_        t          |          }|j        rDt          |t                    r1|j
        r,| j        r| j        j        s|j
        j        |_        d S d S d S d S d S d S t          |t                    rt          |          }t          |t                    rzt!          |j                  t!          |j                  k    r|                     d|           d S t'          |j        |j                  D ]\  }}|                     ||           d S |                     d|           d S t          |t*                    r|                     |j        |           d S d S )NFTz"Incompatible number of tuple itemsz*Tuple type expected for multiple variables)r~  rq   r  r  r   rV  r  r   r  r   r  r  rf  r  r   r   r  r  r  zipr  rw   r  )rO  rQ  r  r  ra  itemtypes         rP  r  z%SemanticAnalyzer.store_declared_types  s   fg&& 	%*F"&+s++ Ak#%c**LA"311A ,A "Y	A /3i.?	A '*&:&@COOOA A
A A A A A A A A 	** 	!#&&C#y)) Pv|$$CI66IIBFKKKF&)&,	&B&B > >ND(--dH====> > 		FOOOOO)) 	%%fk377777 DrR  c                
   |                      |d          }|sdS |                     ||          }|dS |j        dd                             t                    }|                     |j        dd|z                      }|                     |j        d|z   d         |j        d|z   d         |j        d|z   d         ||          }|dS |\  }}}	| 	                                
                    |          }
|
r^t          |
j        t                    sDt          |
j        t                    r|
j        |j        u s|                     d| d|           dS | j        j        rtt'          |d          D ]5\  }}t)          |          r!d| }| j                            |||           6t)          |          rd	}| j                            |||           |||	gz   D ]%}t/          || j        | j        | j        |
           &|r%| j        j        rt5          t6          j                  }|j        s=t          ||                     |          |||	|          }|j        |_        ||_        d}npt          |j        t                    sJ ||j        j        k    p||j        j         k    p|	|j        j!        k    }||j        _         ||j        _        |	|j        _!        tE          d |D                       r| #                    dd||           nQtI          |          r| #                    dd||           n(tI          |	          r| #                    dd||           | %                    ||j        |           dS )zCheck if s declares a TypeVar; it yes, store it in symbol table.

        Return True if this looks like a type variable declaration (but maybe
        with errors), otherwise return False.
        )ztyping.TypeVarztyping_extensions.TypeVarFNr  zCannot redefine "z" as a type variable)startzConstraint zUpper bound of type variabler:  Tc              3  4   K   | ]}t          |          V  d S rT  r<  rq  s     rP  r  z?SemanticAnalyzer.process_typevar_declaration.<locals>.<genexpr>L  s*      22aq!!222222rR  zTypeVar valuesr  zTypeVar upper boundzTypeVar default)&get_typevarlike_declarationextract_typevarlike_namer%  r  r!   analyze_value_typesrd  process_typevar_parametersrG  r  r  r~  r  rn   r   r4  r  r"  r  r  r   rD  r  r   r\  mypycr   r   implementation_artifactr  r  r  r  r  r  r  r   r  )rO  r	  r  r  n_valuesr  r  r+  r  r  r  r  
constraintr  r  type_varr  s                    rP  rq  z,SemanticAnalyzer.process_typevar_declaration  s     //3bcc 	5,,Q55<5 >!""%++G44))$)AH4D*EFF--Ia(lnn%N1x<>>*N1x<>>*
 
 ;5),&+w,,..22488 	x}o66	 {33		 9A8V8VIID$DDDaHHH5</ 	M#,V1#=#=#= P PZ/
;; P0300FH88QOOO+K88 M744V[!LLL;00 	 	A"4<!;TXq      	Edl( 	E!)"CDDK } 	,"d))$//gx H !IHM$DMGGdm[99999$-.. 4$-";;4dm33 
 )4DM%#)DM $+DM!22622222 	Y$$T+;Qw$WWWW[)) 	Y$$T+@!T[$\\\\W%% 	Y$$T+<aPW$XXXdmQ///trR  r  c                    t          |          }t          |t                    r;|j        r4|                     t
          j                            dd          |           |S )Nr   r  )r   r~  r   is_from_errorr  r   TYPEVAR_ARG_MUST_BE_TYPEr  rO  r  r  r  s       rP  r0  z&SemanticAnalyzer.check_typevar_defaultV  sa    g&&c7## 	(9 	II 9@@IVVX_   rR  c                   t          |          }t          |t                    r`t          |j                  D ]J\  }}t          |          }t          |t
                    r!|j        r|                     d| d|           Kngt          |t
                    r|j        st          |t
          t          f          s/|                     d|           t          t          j
                  }|S )Nz	Argument z$ of ParamSpec default must be a typezUThe default argument to ParamSpec must be a list expression, ellipsis, or a ParamSpec)r   r~  r   r  r>  r   r`  r  r   r   rF  )rO  r  r  r  r  arg_type	arg_ptypes          rP  r1  z(SemanticAnalyzer.check_paramspec_default^  s    g&&c:&& 	4(77 \ \8+H55	i11 \i6M \IIQ!QQQSZ[[[\
 sG$$		4!		4 cG[#9::		4
 IIg   i233GrR  c                    t          |          }t          |t                    s/|                     d|           t	          t
          j                  }|S )Nz>The default argument to TypeVarTuple must be an Unpacked tuple)r   r~  r   r  r   r   rF  rb  s       rP  r2  z+SemanticAnalyzer.check_typevartuple_defaultq  sL    g&&#z** 	4IIVX_```i233GrR  r  c                t   t          |          }t          |j        t                    sJ t          |j        t                    r|j        j        n|j        j        }t          |j                  dk     r| 	                    d| d|           dS t          |j        d         t                    r|j        d         t          k    r| 	                    | d|           dS |j        d         j        |k    r?d}| 	                    |                    |j        d         j        ||          |           dS dS )	zDChecks that the name of a TypeVar or ParamSpec matches its variable.r  zToo few arguments for z()Fr   z-() expects a string literal as first argumentzCString argument 1 "{}" to {}(...) does not match variable name "{}"T)r  r~  r  rq   re   r  rr  r  rd  r  ry   r%  r!   rf  r  )rO  r  r  r  typevarlike_typerD  s         rP  r  z'SemanticAnalyzer.check_typevarlike_namex  s&   ~~$+w///// *4; A A[DKt{G[ 	 ty>>AIIC/?CCCWMMM5$)A,00 	DN14E4P4PII)XXXZabbb5Yq\4''WCIIcjj1!35EtLLgVVV5trR  typevarlike_typestuple[str, ...]CallExpr | Nonec                   t          |j                  dk    s t          |j        d         t                    sdS t          |j        t
                    sdS |j        }|j        }t          |t                    sdS |j        |vrdS |S )zReturns the call expression if `s` is a declaration of `typevarlike_type`
        (TypeVar or ParamSpec), or None otherwise.
        r  r   N)	r  r  r~  re   rR  r=   r  rq   rr  )rO  r	  ri  r  r  s        rP  rV  z,SemanticAnalyzer.get_typevarlike_declaration  s     qy>>Qj1x&H&H4!(H-- 	4x&'** 	4?"3334rR  rd  rq  list[str | None]kindslist[ArgKind]
num_valuestuple[int, Type, Type] | Nonec                (   |dk    }d}d}|                                  }	t          t          j                  }
t	          |||          D ]\  }}}|                                s#|                     t          j        |            d S |dk    r`t          |t                    r|j        dv r|j        dk    }n|                     t          j                            d          |            d S |dk    r`t          |t                    r|j        dv r|j        dk    }|                     t          j                            d          |            d S |dk    r<|r|                     d|            d S |                     d	|||          }| d S |}	L|d
k    r7|                     d	|||d          }|pt          t          j                  }
|dk    r/|                     d|           |                     d|            d S |                     t          j         d| d|            d S |r|r|                     d|           d S |dk    r"|                     t          j        |           d S |rt"          }n|rt$          }nt&          }||	|
fS )Nr   F	covariant)r  r  r  contravariantboundz2TypeVar cannot have both values and an upper boundr   r  Trc  r  z'TypeVar "values" argument not supportedzAUse TypeVar('T', t, ...) instead of TypeVar('T', values=(t, ...))z: "r@  z2TypeVar cannot be both covariant and contravariantr  )r/  r   r   r  rQ  is_namedr  r   TYPEVAR_UNEXPECTED_ARGUMENTr~  re   r  TYPEVAR_VARIANCE_DEFr  get_typevarlike_argumentrF  "TYPE_VAR_TOO_FEW_CONSTRAINED_TYPESr$   r#   r'   )rO  rd  rq  rn  rp  r  
has_valuesrs  rt  r  r  param_value
param_name
param_kindtv_argr+  s                   rP  rY  z+SemanticAnalyzer.process_typevar_parameters  s	     !^
	 ,,..	 ?@@36tUE3J3J *	 *	/KZ&&(( 		*FPPPtt[((k844  9IM^9^9^ + 0F :IIII.CJJ;WWY`aaa44..k844  9IM^9^9^$/$4$>MMII(=DD_UUW^    44w&&  IIRT[\\\4466y*k[bcc>44$y((66z;UY 7   !AGI,@$A$Ax''		CWMMM		WY`   tt		'CUU
UUUW^   tt 	! 	!IIJGTTT41__II&I7SSS4 	! HH 	!$HH Hg--rR  )rK  r(  r*  report_invalid_typevar_argtypevarlike_namer}  r|  rK  r(  r*  r  ProperType | Nonec                  	 |                      |dd|||          }	|	t          d g |j                  }	t          |	          }
|rPt	          |
t
                    r;|
j        r4|                     t          j	        
                    ||          |           |
S # t          $ r: |r4|                     t          j	        
                    ||          |           Y d S w xY w)NTF)r%  r'  rK  r(  r*  )r  r   r  r   r~  r   r`  r  r   ra  r  r   )rO  r  r}  r|  r  rK  r(  r*  r  r4  r  s              rP  ry  z)SemanticAnalyzer.get_typevarlike_argument  s   "	 11"&%*$7*C) 2  H  +4W\BB!(++C) jg.F.F 3K\ 		$=DDEUWabb   J# 	 	 	) 		$=DDEUWabb   44	s   BB A CCc                    |sd S |j         d         }t          |t                    sJ |j        r|                     d|           d S |                     ||j        |          sd S |j        S )Nr   z9Cannot declare the type of a TypeVar or similar construct)r  r~  re   rV  r  r  r  )rO  r	  r  rQ  s       rP  rW  z)SemanticAnalyzer.extract_typevarlike_name  s~     	41&(+++++6 	IIQSTUUU4**4a@@ 	4{rR  c           
        |                      |d          }|sdS |                     ||          }|dS |j        dd                             t                    }|dk    r|                     d|           t          t          j                  }t          |j
        d|z   d         |j        d|z   d                   D ]o\  }}|dk    rN|                     d|||d	d	d
          }|pt          t          j                  }|                     ||          }Y|                     d|           p|j        sSt!          ||                     |          |                                 |t&                    }	|j        |	_        |	|_        d	}
n8t+          |j        t                     sJ ||j        j        k    }
||j        _        t/          |          r|                     dd||
           |                     ||j        |           d	S )ac  Checks if s declares a ParamSpec; if yes, store it in symbol table.

        Return True if this looks like a ParamSpec (maybe with errors), otherwise return False.

        In the future, ParamSpec may accept bounds and variance arguments, in which
        case more aggressive sharing of code with process_typevar_declaration should be pursued.
        )ztyping_extensions.ParamSpecztyping.ParamSpecFNr  r   z-Too many positional arguments for "ParamSpec"r  	ParamSpecT)rK  r(  r  zOThe variance and bound arguments to ParamSpec do not have defined semantics yetzParamSpec defaultr  )rV  rW  r%  r  r!   r  r   r   r  rQ  rd  rG  ry  rF  r1  r4  rl   r  r/  r'   r  r~  r  r   r  r  )rO  r	  r  r  r\  r  r|  r}  r  paramspec_varr  s              rP  rr  z.SemanticAnalyzer.process_paramspec_declaration"  s?    //B
 
  	5,,Q55<5>!""%++G44q==IIEqIII	 ?@@'*Ia(lnn%t~a(lnn'E(
 (
 	 	#K Y&&66(,.2/4 7   !AGI,@$A$A66wLL
 		e    } 
	,)d))$//1A1A1C1CWi M "&M)DMGGdm];;;;;!66G$+DM!7## 	[$$T+>RY$ZZZdmQ///trR  c           
     n   |                      |d          }|sdS |j        dd                             t                    }|dk    r|                     d|           t          t          j                  }t          |j	        d|z   d         |j
        d|z   d                   D ]s\  }}|dk    rN|                     d|||d	dd	
          }|pt          t          j                  }|                     ||          }Y|                     d| d|           t|                     ||          }|dS |j        s}|                     d|                                 g          }	t%          ||                     |          |	                                |	|t*                    }
|j        |
_        |
|_        d	}n8t/          |j        t$                    sJ ||j        j        k    }||j        _        t3          |          r|                     dd||           |                     ||j        |           d	S )zChecks if s declares a TypeVarTuple; if yes, store it in symbol table.

        Return True if this looks like a TypeVarTuple (maybe with errors), otherwise return False.
        )ztyping_extensions.TypeVarTupleztyping.TypeVarTupleFr  Nr   z0Too many positional arguments for "TypeVarTuple"r  TypeVarTupleT)rK  r  r*  zUnexpected keyword argument "z" for "TypeVarTuple"r&  zTypeVarTuple defaultr  )rV  r%  r  r!   r  r   r   r  rQ  rd  rG  ry  rF  r2  rW  r4  r  r/  r   r  r  r'   r  r~  r  r   r  r  )rO  r	  r  r\  r  r|  r}  r  r  r-  typevartuple_varr  s               rP  rs  z1SemanticAnalyzer.process_typevartuple_declarationf  so   
 //H
 
  	5>!""%++G44q==IIH!LLL	 ?@@'*Ia(lnn%t~a(lnn'E(
 (
 	_ 	_#K Y&&66"(,/4!% 7   !AGI,@$A$A99';OO		Z*ZZZ\]^^^^,,Q55<5 } 	,!__-=@P@P@R@R?STTN/##D)),,..    %)I!,DMGGdm-=>>>>>!66G$+DM!7## 	^$$T+A1U\$]]]dmQ///trR  basetype_or_fallbackr  c                2   |                                  r | j        sd|vr|dt          |          z   z  }t          |t	          g                     }|                                  r-| j        s&| j        dz   |                     |          z   |_        n|                     |          |_        t          t                      || j                  }||_
        |j        j        }|s |j        |                                 j        g}|g|z   |_        |g|_        |S )Nr  r|  )r  rV  r  r?   r:   r  r  rr  r   r|   r  ru  r/  rZ  )rO  r  r  r  	class_defr  ru  s          rP  basic_new_typeinfoz#SemanticAnalyzer.basic_new_typeinfo  s    	$	 	$cooC#d))O#DT599--	 	;	 	;
 "&3!69L9LT9R9R!RI!%!4!4T!:!:Iy$/BB	"'+ 	G',d.>.>.@.@.EFC6C<*+
rR  r  
list[Type]c                $   g }|D ]	}	 |                      |                     |          d          }|t          dg |j                  }t	          |          rM|                     t          j        |           |                    t          t          j                             n|                    |           # t          $ rF |                     d|           |                    t          t          j                             Y w xY w|S )zBAnalyze types from values expressions in type variable definition.Tr$  NzType expected)r  r   r   r  r   r  r   r3  r  r   r   rF  r   )rO  r  r9  r  r4  s        rP  rX  z$SemanticAnalyzer.analyze_value_types  s    	= 	=D=>>0066$ *   #  /tRCCH ** ,II.OQUVVVMM')*>"?"?@@@@MM(+++' = = =		/4000gi&:;;<<<<<= s   B3B==ADDc                   |j         d         }t          |j                   dk    st          |t                    sdS |j        r|                     |j                  sdS |                                 rt          |t                    r|j        }t          |t                    rd|_        | 
                    |j                  }| j        J |[t          t          |                    t          | j        j        j                  z  r |                     t           j        |           |N| j        j        t          |          v r5| j        j        j        r&|                     t           j        |           dS dS dS dS t          |t(                    r|                     |          r|                     |           dS dS )z-Check if assignment defines a class variable.r   r  NT)r  r  r~  rq   rV  r  r  re   r  r   r  rB  r   r  r  r  r   CLASS_VAR_WITH_TYPEVARSr)  CLASS_VAR_WITH_GENERIC_SELFrb   r  r  )rO  r	  rQ  r  r4  s        rP  r~  zSemanticAnalyzer.check_classvar  s   1qy>>Qj&A&AFv 	T--af55 	F   	/Z%A%A 	/;D$$$ (#' ~~af--H9(((#M(,C,C(D(Ds	(H H )# 		*BAFFF$I'=+B+BBBIN, C 		*FJJJJJ	 %$BBBB FJ// 	/43J3J63R3R 	/ &&v.....	/ 	/rR  c                    t          |t                    sdS |                     |j        |          }|r|j        sdS |j        j        dk    S )NFztyping.ClassVar)r~  r   rb  r  r  rr  rO  r  re  s      rP  r  zSemanticAnalyzer.is_classvar  sW    #{++ 	5##CHc22 	#( 	5x $555rR  c                    t          |t                    sdS |                     |j        |          }|r|j        sdS |j        j        t          v S NF)r~  r   rb  r  r  rr  r   r  s      rP  r  zSemanticAnalyzer.is_final_type  sW    #{++ 	5##CHc22 	#( 	5x $444rR  c                F    |                      t          j        |           d S rT  )r  r   CLASS_VAR_OUTSIDE_OF_CLASS)rO  r  s     rP  r  z&SemanticAnalyzer.fail_invalid_classvar  s     		"=wGGGGGrR  lvalslist[Lvalue]rvalc                   t          |t          t          f          rut          d |D                       r\t	          t
          t                   |          }t          |j        gd |D             R  }|D ]^}}|                     |||           dS t          |t                    r| 
                    |          }|rt          |j        t                    rw|D ]u}	t          |	t                    st          |	j        t                    r|	j        j        @t          |	t                    r-|                                                     |	j                  }
nYt          |	t&                    rC|                     |	          r.| j        J | j        j                            |	j                  }
n|
rt          |
j        t                    r\|
j        |j        urNt          |	t          t&          f          sJ |                     d                    |	j                  |           S|	j        r|j        J |j        |
_        qdS dS dS dS )a(  Propagate module references across assignments.

        Recursively handles the simple form of iterable unpacking; doesn't
        handle advanced unpacking with *rest, dictionary unpacking, etc.

        In an expression like x = y = z, z is the rval and lvals will be [x,
        y].

        c              3  @   K   | ]}t          |t                    V  d S rT  )r~  r   rq  s     rP  r  z=SemanticAnalyzer.process_module_assignment.<locals>.<genexpr>  s=       ;
 ;
)*Jq)$$;
 ;
 ;
 ;
 ;
 ;
rR  c                    g | ]	}|j         
S rA  )r  rq  s     rP  rD  z>SemanticAnalyzer.process_module_assignment.<locals>.<listcomp>+  s    7S7S7SA7S7S7SrR  NzZCannot assign multiple modules to name "{}" without explicit "types.ModuleType" annotation)r~  r   r_   r  r   r*  rQ  r  r  rq   r  r  rc   r   rV  re   r  r  r  rb   r  rq  r  r  r  )rO  r  r  r   	seq_lvalselementwise_assignmentsr  lvsrnoder  lnodes              rP  r  z*SemanticAnalyzer.process_module_assignment  s    dY122 :	4s ;
 ;
.3;
 ;
 ;
 8
 8
 :	4 T)_e44I$ '*$*&T7S7S7S7S7S&T&T&T#3 = =S..sB<<<<= =g&& 	4))$//E 4EJ99 4! 4 4D%dG44 ! !$)S11 !din6P  "$11 ! $ 9 9 ; ; ? ?	 J J#D*55 !$:Q:QRV:W:W !#y444 $	 3 3DI > >  4%ej(;; 
4
RWR\@\@\#-dXz4J#K#KKKK II!QQWQWX\XaQbQb #    "1 4#(:#9#9#9).EJ=	4 	44 4 4 44 4rR  c                l   t          |j                  dk    rt          |j        d         t                    ru|j        d         j        dk    ra|j        d         j        t          k    rHt          |j        t          t          f          r)| 
                    |j        j                   dS dS dS dS dS dS )z1Export names if argument is a __all__ assignment.r  r   r  N)r  r  r~  re   r  r.  r%   rR  r_   r   add_exportsr  rc  s     rP  r  zSemanticAnalyzer.process__all__N  s     	NNa19Q<22  	!!Y..	!!T))18h	%:;; * QX^,,,,,  ..))))rR  c                L   | j         j        sd S t          |j                  dk    rt	          |j        d         t
                    r|j        d         j        dk    r|j        d         j        t          k    r|j	        }t	          |t          t          f          s|                     d|           d S |j        }g }|D ]H}t	          |t                    s|                     d|           .|                    |j                   I| j        sJ || j        _        d S d S d S d S d S )Nr  r   __deletable__zC"__deletable__" must be initialized with a list or tuple expressionz5Invalid "__deletable__" item; string literal expected)r"  rZ  r  r  r~  re   r  r.  r*   rR  r_   r   r  r  ry   r  rf  rV  deletable_attributes)rO  r	  rR  r  attrsra  s         rP  r  z%SemanticAnalyzer.process__deletable__Y  s5   |! 	F	NNa19Q<22  	!!_44	!!T))XFfx&;<< 		_abcccLEE - -!$00 -IIUW[\\\\LL,,,,9-2DI***#  44))rR  c                   t          | j        t                    rt          |j                  dk    rt          |j        d         t
                    r|j        d         j        dk    r|j        d         j        t          k    rt          |j	        t          t          t          t          t          f          sdS t          d | j        j        dd         D                       rdS d}g }t          |j	        t                    r|                    |j	                   nut          |j	        t          t          t          f          r |                    |j	        j                   n.|j	        j        D ]!\  }}|r||                    |           d}"g }|D ]?}t          |t                    r&|j        d	k    r|                    |j                   =d}@|sdS | j        j        dd         D ]%}|j        J |                    |j                   &t-          |          | j        _        dS dS dS dS dS dS )
z
        Processing ``__slots__`` if defined in type.

        See: https://docs.python.org/3/reference/datamodel.html#slots
        r  r   r  Nc              3  (   K   | ]}|j         d u V  d S rT  )slotsrC  rt  s     rP  r  z4SemanticAnalyzer.process__slots__.<locals>.<genexpr>  s(      @@q17d?@@@@@@rR  r  TF__dict__)r~  rV  r   r  r  re   r  r.  r*   rR  ry   r_   r   ru   rH   r  ru  r  r  r  rf  r  rB  )	rO  r	  concrete_slotsrR  keyr@  r  ra  
super_types	            rP  r  z!SemanticAnalyzer.process__slots__p  sM    ty(++2	)AI!##19Q<22 $	!![00	!!T)) ah(IwPX(YZZ  @@DIM!B$,?@@@@@  !N')F!(G,, /ah''''AHxG&DEE 	/ahn----  hn / /FC% /#/c****).E + + dG,, +z1I1ILL,,,,%*NN!   #imAbD1 / /
!'333Z-....!%jjDIOOOe2	) 2	)####00))rR  rt  r:   c                    |j         rd S | j        dxx         dz  cc<   |j        D ]}|                     |           | j        dxx         dz  cc<   d S )Nr  r  )is_unreachabler,  r  r  )rO  rt  r	  s      rP  visit_blockzSemanticAnalyzer.visit_block  sx     	F! 	 	AKKNNNN!rR  Block | Nonec                8    |r|                      |           d S d S rT  )r  )rO  rt  s     rP  visit_block_maybez"SemanticAnalyzer.visit_block_maybe  s.     	 Q	  	 rR  rM   c                H    || _         |j                            |            d S rT  )r:  r  r  rc  s     rP  visit_expression_stmtz&SemanticAnalyzer.visit_expression_stmt  s#    	drR  rr   c                    || _         |                                 s|                     d|           | j        r|                     d|d           |j        r|j                            |            d S d S )Nz"return" outside functionz%"return" not allowed in except* blockTrf  )r:  r  r  rN  r  r  rc  s     rP  visit_return_stmtz"SemanticAnalyzer.visit_return_stmt  s    !!## 	6II115554 	PII=q$IOOO6 	 FMM$	  	 rR  rp   c                    || _         |j        r|j                            |            |j        r|j                            |            d S d S rT  )r:  r  r  	from_exprrc  s     rP  visit_raise_stmtz!SemanticAnalyzer.visit_raise_stmt  sW    6 	 FMM$; 	%Kt$$$$$	% 	%rR  r5   c                    || _         |j        r|j                            |            |j        r|j                            |            d S d S rT  )r:  r  r  rD  rc  s     rP  visit_assert_stmtz"SemanticAnalyzer.visit_assert_stmt  sU    6 	 FMM$5 	ELL	 	rR  rh   c                   || _         |j                            |            |j                            |            t	          |j        t
                    rg|j        j        dk    rY|j        j        t          k    rFt	          |j        t          t          f          r'|                     |j        j                   d S d S d S d S d S )Nr  )r:  rQ  r  rR  r~  re   r  r.  r%   r_   r   r  r  rc  s     rP  visit_operator_assignment_stmtz/SemanticAnalyzer.visit_operator_assignment_stmt  s    		qx**	-**%%18h	%:;; & QX^,,,,,	- 	-**%%%%rR  r   c                b   || _         |j                            |            | j        dxx         dz  cc<   |                     dd          5  |j                            |            d d d            n# 1 swxY w Y   | j        dxx         dz  cc<   |                     |j                   d S )Nr  r  FTrf  rg  )r:  r  r  r4  rj  r  r  r  rc  s     rP  visit_while_stmtz!SemanticAnalyzer.visit_while_stmt  s    	dq ..U$.OO 	  	 FMM$	  	  	  	  	  	  	  	  	  	  	  	  	  	  	 q q{+++++s   A55A9<A9rP   c                   |j         rR|                                 r| j        d         j        s,|                     t
          j        |t          j                   || _	        |j
                            |            |                     |j        |j        d ud           |j        r|                     |j                  r|                     |j                   t#          |j        t$                    }|                     |j        |          }|"|                     |j        |           ||_        | j        dxx         dz  cc<   |                     dd          5  |                     |j                   d d d            n# 1 swxY w Y   | j        dxx         dz  cc<   |                     |j                   d S )	Nr  r  T)r  r$  r  r  Fr  )is_asyncr  r1  r5  r  r   ASYNC_FOR_OUTSIDE_COROUTINEr&  rg  r:  r  r  rb  r  
index_typer  r  r~  r   r  r  r4  rj  r  r  r  r  )rO  r	  r)  r4  s       rP  visit_for_stmtzSemanticAnalyzer.visit_for_stmt  s   : 	^%%'' ^t/B2/F/S ^		*FPUP\	]]]	d 	AG1<t3KZ^___< 	(-- 4**17333",QWi"@"@~~alH[~\\H#))!'8<<<'q ..U$.OO 	% 	%QV$$$	% 	% 	% 	% 	% 	% 	% 	% 	% 	% 	% 	% 	% 	% 	%q q{+++++s    FFFr;   c                    || _         | j        d         dk    r|                     d|dd           | j        r|                     d|d           d S d S )Nr  r   z"break" outside loopTrf  r  z$"break" not allowed in except* blockr  r:  r4  r  rM  rc  s     rP  visit_break_stmtz!SemanticAnalyzer.visit_break_stmt  sm    ?2!##II,atILLL( 	OII<aINNNNN	O 	OrR  rD   c                    || _         | j        d         dk    r|                     d|dd           | j        r|                     d|d           d S d S )Nr  r   z"continue" outside loopTr  z'"continue" not allowed in except* blockr  r  rc  s     rP  visit_continue_stmtz$SemanticAnalyzer.visit_continue_stmt  sm    ?2!##II/D$IOOO( 	RII?DIQQQQQ	R 	RrR  rV   c                :   || _         t          || j                   t          t	          |j                            D ]B}|j        |                             |            |                     |j        |                    C| 	                    |j
                   d S rT  )r:  r   r"  r  r  r  r  r  r  r  r  )rO  r	  r  s      rP  visit_if_stmtzSemanticAnalyzer.visit_if_stmt  s    *1dl;;;s16{{## 	( 	(AF1IT"""QVAY''''q{+++++rR  r   c                @    || _         |                     ||            d S rT  )r:  analyze_try_stmtrc  s     rP  visit_try_stmtzSemanticAnalyzer.visit_try_stmt  s%    a&&&&&rR  r  NodeVisitor[None]c                   |j                             |           t          |j        |j        |j                  D ]\  }}}|r|                    |           |r|                     |           |                     | j        p|j	                  5  |                    |           d d d            n# 1 swxY w Y   |j
        r|j
                            |           |j        r|j                            |           d S d S rT  )r  r  rQ  r  varshandlersrb  rj  rM  is_starr  finally_body)rO  r	  r  rV  r  handlers         rP  r  z!SemanticAnalyzer.analyze_try_stmt  sL   	g"%agqvqz"B"B 	( 	(D#w %G$$$ )##C(((2243P3]TUT]^^ ( (w'''( ( ( ( ( ( ( ( ( ( ( ( ( ( (; 	(Kw'''> 	+N!!'*****	+ 	+s   B22B6	9B6	r   c                   || _         g }|j        rR|                                 r| j        d         j        s,|                     t          j        |t          j	                   |j
        rt          |j
        t                    sJ d |j        D             }t          |          dk    r|                     d|           nt          |          dk    r	|j
        g}nt          |j
        t                    r`t          |          t          |j
        j                  k    r|j
        j                                        }n-|                     d|           n|                     d|           g }t%          |j        |j                  D ]\  }}|                    |            |r|                     ||j
        d u	           |r|                    d          }|                     |          r|                     |           t          |t2                    }|                     ||
          }	|	+|                    |	           |                     ||	           ||_        |                     |j                   d S )Nr  r  c                    g | ]}||S rT  rA  r=  s     rP  rD  z4SemanticAnalyzer.visit_with_stmt.<locals>.<listcomp>6  s    CCCAQ]a]]]rR  r   z5Invalid type comment: "with" statement has no targetsr  z/Incompatible number of types for "with" targetsz3Multiple types expected for multiple "with" targets)r  r  ) r:  r  r  r1  r5  r  r   ASYNC_WITH_OUTSIDE_COROUTINEr&  rg  rV  r~  r   r  r  r   r  r}  rQ  r  r  rb  r  r  r  r   r  r  r  analyzed_typesr  r  )
rO  r	  r  actual_targets	new_typeser  r  r)  r4  s
             rP  visit_with_stmtz SemanticAnalyzer.visit_with_stmt,  s   : 	_%%'' _t/B2/F/S _		*GQVQ]	^^^ 	Ta/<<<<<CCCCCN>""a''		QSTUUUU^$$))*+A-y99 	T~&&#a.?.E*F*FFF-388::EE IIOQRSSSS 		OQRSSS "	)) 	? 	?DAqHHTNNN ?##AQ5Fd5R#SSS  	?		!A''** 6221555*4Q	*B*B'#~~aEX~YYH+!((22211!X>>>$     rR  rG   c                    || _         |j                            |            |                     |j                  s|                     d|           d S d S )NzInvalid delete target)r:  r  r  is_valid_del_targetr  rc  s     rP  visit_del_stmtzSemanticAnalyzer.visit_del_stmt^  sZ    	d''// 	2II-q11111	2 	2rR  c                     t          |t          t          t          f          rdS t          |t          t
          f          r t           fd|j        D                       S dS )NTc              3  B   K   | ]}                     |          V  d S rT  )r  )rC  ra  rO  s     rP  r  z7SemanticAnalyzer.is_valid_del_target.<locals>.<genexpr>h  s1      JJ$t//55JJJJJJrR  F)r~  r[   re   rb   r   r_   r  r  rc  s   ` rP  r  z$SemanticAnalyzer.is_valid_del_targetd  sb    a)Xz:;; 	4Ix011 	JJJJ!'JJJJJJ5rR  r  rU   c                    || _         |j        D ]K}|| j        d         v r|                     d| d|           | j        d                             |           Ld S )Nr  Name "" is nonlocal and global)r:  rq  r(  r  r'  r  )rO  r  r  s      rP  visit_global_declz"SemanticAnalyzer.visit_global_decll  sv    G 	, 	,Dt*2...		A4AAA1EEEb!%%d++++	, 	,rR  r  rg   c           	        || _         |                                 r|                     d|           d S |j        D ]"}t	          t          | j        d d                   t          | j        d d                             D ]2\  }}|+||v r'|t          k    r|                     d| d|            n3|                     d| d|           | j        d         8|| j        d         v r)|                     d	                    |          |           || j
        d         v r|                     d| d	|           | j        d                             |           $d S )
Nz0nonlocal declaration not allowed at module levelr  z1nonlocal binding not allowed for type parameter "r@  zNo binding for nonlocal "z" foundzGName "{}" is already defined in local scope before nonlocal declarationr  r  )r:  r  r  rq  rQ  r  r)  r+  r  r  r'  r(  r  )rO  r  r  tablerh  s        rP  visit_nonlocal_declz$SemanticAnalyzer.visit_nonlocal_decls  s   !! 	2IIH!LLLLL 2 2),T["-..9I#2#9N0O0O* * 
L 
L%E: (TU]]%)999 II [TX [ [ []^   IIG$GGGKKK;r?.44;r?3J3JII<<BF4LL   4,R000IIEtEEEqIII#B'++D1111-2 2rR  ra   c                   || _         t          || j                   |j                            |            t          t          |j                            D ]f}|j        |                             |            |j        |         }||                    |            | 	                    |j
        |                    gd S rT  )r:  r   r"  subjectr  r  r  patternsguardsr  bodies)rO  r	  r  guards       rP  visit_match_stmtz!SemanticAnalyzer.visit_match_stmt  s    -a>>>		s1:'' 	* 	*AJqM  &&&HQKE T"""QXa[))))	* 	*rR  r   c           
     
   |j         rd S || _        |                     |j        |          }||                     |           d S d |j        D             }	 |                                                     |j        j                  }|rt          |j	        t                    snt          |j	        t                    r|j	        j        |j        k    s?|                     |j        j        ||d           	 |                     |j                   d S |                                 }|                     |j        j        |j                                        d||d          \  }}}}	}
|st'          t(          j                  }|                                 s+t          |t.                    ot          |t0                    }nt3          |          }|                     |          s|rD|                     |j        j        |j        d           	 |                     |j                   d S |                     |           |                     |	           t;          || j        | j        | j         |           tC          |          }| j        j"        r:tG          |          r+| j         $                    d||           tK          |          }|                                 }t          |t.                    r8t          |tL                    r#tO          || j(        | j)        d| j        	           t          || *                    |j        j                  |j        |j+        |d|d
          }||_,        |rt          |j	        t          t          f          r|j	        j        |j        k    rd}t          |j	        t                    r+|j	        j-        |k    r||j	        _-        ||j	        _.        d}n	||_	        d}|r\| j/        r>| 0                    |j        j        d|           	 |                     |j                   d S |                     |d           n!| 1                    |j        j        ||           |r|j	        n|}t          |t                    sJ | 2                    |||j                   |j        3                    |            |                     |j                   d S # |                     |j                   w xY w)Nc                    g | ]	}|j         
S rA  r  r  s     rP  rD  z:SemanticAnalyzer.visit_type_alias_stmt.<locals>.<listcomp>  s     = = =A = = =rR  NameT)r%  r  r  rf  r7  r:  r  Fr  r  r  r  )4r  r:  r  r  r  r  r  r  r~  r  r   rn   r  already_definedr  r  r  rf  r  r   r   rF  r  r   r   r   r  r  r,  r   r"  r\  rD  r  r  r   r  r  r   r   r  r  r  r  r  r  rl  r_  r  r  r  r  )rO  r	  r
  r  r  r  r  rl  r  r  r  r  r  r  r  r  s                   rP  visit_type_alias_stmtz&SemanticAnalyzer.visit_type_alias_stmt  s"   $ 	F))!+q99JJqMMMF = = = = =e	,002266qv{CCH 8=)44x}o>>CK=CUYZY_C_C_$$QV[!XvFFF| q{+++++y ,,..COSOaOa"&#./D'+ Pb P PLCj/;L  4i233%%'' 9 %/sJ$?$? %JE E!! %4C$8$8!((-- 1B  $$QV[!'D$QQQD q{+++++A $$Z000 $$_555 #T\4#=txQR   
 (,,C|3 38TUX8Y8Y 3445H#qQQQ-c22&&((E#z** bz#x/H/H bS$)TYUTXT`aaaa"##AFK00''+	 	 	J &AL <x}	.JKK< M&!&00hmY77 
#}+s22 03,4?1"& %/HM"G ;+ ;00faHHH q{+++++ 

1T
:::Z;;;,4D8==*LlI66666221lAGLLLFMM$q{+++++Dq{++++s"   BS0 C=S0 ,G:S0 BS0 0Tc                p    |                      |j        |          }|r|                     ||           d S d S rT  )r  r  r@  )rO  r  r  s      rP  visit_name_exprz SemanticAnalyzer.visit_name_expr  sE    KK	4(( 	)a(((((	) 	)rR  re  c                z   t          |j        t                    rB| j                            |          r(| j        s!|                     d|j         d|           dS t          |j        t                    r| 	                    |j        d|           dS |j
        |_
        |j        |_        |j        pd|_        dS )z,Bind name expression to a symbol table node.r@  z3" is a type variable and only valid in type contextr  r5  N)r~  r  r   r0  get_bindingrK  r  r  rn   r  r.  rr  r  s      rP  r@  zSemanticAnalyzer.bind_name_expr  s     sx--	/++C00	/ ,	/
 IIX$)XXXZ^_____/22 	/$$TY=====DIDIL.BDMMMrR  rz   c                    | j         s$|j        j        s|                     d|           d S | j         |_        |j        j        D ]}|                    |            d S )Nz"super" used outside class)rV  r  rd  r  r  r  )rO  r  r  s      rP  visit_super_exprz!SemanticAnalyzer.visit_super_expr$  sl    y 	 	II2D999FI	9> 	 	CJJt	 	rR  c                |    |j         D ]3}t          |t                    rd|_        |                    |            4d S rb  r  r~  rw   r  r  rO  r  ra  s      rP  visit_tuple_exprz!SemanticAnalyzer.visit_tuple_expr,  K    J 	 	D$)) "!
KK	 	rR  r_   c                |    |j         D ]3}t          |t                    rd|_        |                    |            4d S rb  r  r  s      rP  visit_list_exprz SemanticAnalyzer.visit_list_expr2  r	  rR  ru   c                |    |j         D ]3}t          |t                    rd|_        |                    |            4d S rb  r  r  s      rP  visit_set_exprzSemanticAnalyzer.visit_set_expr8  r	  rR  rH   c                x    |j         D ]1\  }}||                    |            |                    |            2d S rT  )r  r  )rO  r  r  rf  s       rP  visit_dict_exprz SemanticAnalyzer.visit_dict_expr>  sM    * 	 	JC

4   LL	 	rR  rw   c                |    |j         s|                     d|d           d S |j                            |            d S )Nz!can't use starred expression hereTr  )r  r  r  r  r  s     rP  visit_star_exprz SemanticAnalyzer.visit_star_exprD  sG    z 	#II94INNNNNIT"""""rR  r  r   c                   |                                  s|                     d|dd           nn| j        d         t          k    r|                     d|dd           n>| j        d         j        r|                     d|dd           nd| j        d         _        |j        r|j                            |            d S d S )Nz"yield from" outside functionTr  r  z9"yield from" inside comprehension or generator expressionz"yield from" in async function)	r  r  r+  r  r1  r5  is_generatorr  r  rO  r  s     rP  visit_yield_from_exprz&SemanticAnalyzer.visit_yield_from_exprJ  s    !!## 	8II5q$PTIUUUUb!%888IIK	       $1 	8II64QUIVVVV37D#06 	 FMM$	  	 rR  c                   j                             |            t          j         d          r|                     dd          sdS 	 |                     j        d                   }n'# t          $ r |                     d           Y dS w xY wt          j        d         |          _	        j
        j	        _
        j        j	        _        j	                            |            dS t          j         t                    r|                     dd          sdS 	 |                     j        d                   }n'# t          $ r |                     d	           Y dS w xY wt          j        d         |          _	        j
        j	        _
        j        j	        _        j	                            |            dS t          j         t                    r|                     dd
          sdS d}|                     d
d          }|r*t!          |j        t$                    r|j        t(          v rd}t+          t,          j        d         |          _	        j
        j	        _
        j        j	        _        j	                            |            dS t          j         d          rg }|                                 r$d | j                                        D             }n|                                 r0| j        (d | j        j                                        D             }nH|                                 r4| j        -| j        d         }|d |                                D             }t+          t@          |          _	        j
        j	        _
        j        j	        _        j	                            |            dS t          j         d          r|                     d           dS t          j         d          r|                     dd          sdS 	 |                     j        d                   }n'# t          $ r |                     d           Y dS w xY wtC          |          _	        j
        j	        _
        j	                            |            dS t          j         d          r| "                              _	        dS t          j         d          rr|                     dd          sdS tG          dj        d         j        d                   _	        j
        j	        _
        j	                            |            dS t          j         d          rO| $                                5  j        D ]}|                    |            	 ddd           dS # 1 swxY w Y   dS j        D ]}|                    |            t!          j         tJ                    rNt!          j         j&        tN                    r0j         j&        j(        dk    rj         j&        j)        tT          k    rj         j(        dv rj         j(        d k    r)j        r"| +                    j        d                    dS j         j(        d!k    rUj        rNt!          j        d         tX          tZ          f          r'| +                    j        d         j                   dS j         j(        d"k    rKj        rFt!          j        d         t\                    r(fd#| j/        D             | _/        dS dS dS dS dS dS dS dS dS )$zAnalyze a call expression.

        Some call expressions are recognized as special forms, including
        cast(...).
        ztyping.castr  r   Nr   zCast target is not a typer  assert_typez assert_type() type is not a typer  FTr]  )r.  r  is_importedzbuiltins.reveal_localsc                    g | ]<\  }}t          |j        d d          t          |j        t                    5|j        =S )r=  F)getattrr  r~  r   )rC  r  r  s      rP  rD  z4SemanticAnalyzer.visit_call_expr.<locals>.<listcomp>  s[       aqv}e<< BLAFTWAXAXF  rR  c                P    g | ]#}t          |j        t                    |j        $S rA  r~  r  r   rC  sts     rP  rD  z4SemanticAnalyzer.visit_call_expr.<locals>.<listcomp>  s>     # # #$&jQSQXZ]F^F^## # #rR  r  c                P    g | ]#}t          |j        t                    |j        $S rA  r  r  s     rP  rD  z4SemanticAnalyzer.visit_call_expr.<locals>.<listcomp>  s>     ' ' '(*zRTRY[^G_G_'G' ' 'rR  )r.  local_nodesr  z;Any(...) is no longer supported. Use cast(Any, ...) insteadztyping._promote_promotez$Argument 1 to _promote is not a typer  zbuiltins.divmoddivmod)r  r  r  )r  r  r  r  r  r  c                @    g | ]}|j         d          j        k    |S r  )rd  rf  )rC  r  r  s     rP  rD  z4SemanticAnalyzer.visit_call_expr.<locals>.<listcomp>  s-    '_'_'_aqDIVWLL^G^G^G^G^G^rR  )0r  r  r  check_fixed_argsr   rd  r   r  r>   r4  r  r  r   r6   r   r  r~  r  r0   rr  r   rs   r.   r  r&  r  r  rV  rq  r  r  r)  r-   ro   translate_dict_callri   re  rb   r  re   r  r.  r%   r  r_   r   ry   rE  )rO  r  r  reveal_importedreveal_type_noder   symbol_tabler{  s    `      rP  visit_call_exprz SemanticAnalyzer.visit_call_expr[  s    	4   dk=99 F	`((q&99 55dilCC'   		5t<<<
 %TYq\6::DM!%DM#';DM M  &&&&&->?? v	`((q-@@ 55dilCC'   		<dCCC +49Q<@@DM!%DM#';DM M  &&&&&->?? i	`((q-@@ #O#{{=$PT{UU '/46KLL' %-1KKK"&& ty|  DM "&DM#';DM M  &&&&&-EFF X	` &(K##%%  #'<#5#5#7#7  
 $$&& 9(# #*.)/*@*@*B*B# # #K ##%% ;*#';r?L#/' '.:.A.A.C.C' ' ' 'M{SSSDM!%DM#';DM M  &&&&&\:: 7	`IISUYZZZZZ->?? 4	`((q*== 55dilCC'   		@$GGG (//DM!%DMM  &&&&&_== '	` 44T::DMMM->?? %	`((q(;; "8TYq\49Q<HHDM!%DMM  &&&&&KT
 
 	` --// # # # #AHHTNNNN## # # # # # # # # # # # # # # # # #
 Y   4;
33`t{/::` K$)Y66K$)T11K$(FFF;#x//DI/$$TYq\22222K$00	 1"49Q<(I1FGG 1 $$TYq\%788888K$00	 1"49Q<99 1 (`'_'_'_43C'_'_'_D$$$)` ` ` ` 7611FF 100000sH    A, , BB% E  E*)E*: Q  Q?>Q?$ WWWDictExpr | Nonec                :   t          d |j        D                       s!|j        D ]}|                    |            dS t	          d t          |j        |j                  D                       }|                    |           |                    |            |S )zTranslate 'dict(x=y, ...)' to {'x': y, ...} and 'dict()' to {}.

        For other variants of dict(...), return None.
        c              3  6   K   | ]}|t           t          fv V  d S rT  )r    r"   r  s     rP  r  z7SemanticAnalyzer.translate_dict_call.<locals>.<genexpr>  s,      MMd4Iy11MMMMMMrR  Nc                >    g | ]\  }}|t          |          nd |fS rT  )ry   )rC  r  rf  s      rP  rD  z8SemanticAnalyzer.translate_dict_call.<locals>.<listcomp>  s?       C "%dEB  rR  )r  r%  rd  r  rH   rQ  rG  r  )rO  r  r{  r  s       rP  r%  z$SemanticAnalyzer.translate_dict_call  s    
 MMdnMMMMM 	Y  4 "%dndi"@"@  
 
 	dDrR  numargsc                    d}|dk    rd}t          |j                  |k    r|                     d|||fz  |           dS |j        t          g|z  k    r!|                     d| d| d| |           dS d	S )
zsVerify that expr has specified number of positional args.

        Return True if the arguments are valid.
        r	  r  r5  z"%s" expects %d argument%sFr@  z" must be called with z positional argumentT)r  rd  r  r%  r!   )rO  r  r.  r  r	  s        rP  r$  z!SemanticAnalyzer.check_fixed_args  s    
 a<<Aty>>W$$II2dGQ5GGNNN5>gY000IIV$VVgVVSTVVX\]]]5trR  c                   |j         }|                    |            t          |t                    rt          |j        t
                    r|                     |j        |j                  }|r`t          |j        t                    r| 	                    |j        d|           d S |j
        |_
        |j        pd|_        |j        |_        d S d S t          |t                    rd }t          |j        t                    r	|j        }nt          |j        t                    ru| j        rn| j        rg| j        d         }|j        sRt          |j        t"                    r8|j                            |j        j                  }|r|j        dk    r| j        }nwt          |j        t(                    r]|j        j        rQt          |j        j        t.                    sJ t          |j        j        t0                    r|j        j        j        }|rv|j                            |j                  }|Wt          |j        t
          t          t(          f          r2|sd S |j
        |_
        |j        pd|_        |j        |_        d S d S d S d S d S )N	attributer5  r  r   )r  r  r~  rq   r  rc   get_module_symbolr  rn   r  r.  rr  r   r   rV  r1  r$  r   argument_by_nameposr   r  r  r   r   rq  r  )rO  r  r?  re  	type_infofunc_def
formal_argr  s           rP  visit_member_exprz"SemanticAnalyzer.visit_member_expr  si   yDdG$$ )	'DIx)H)H )	'((DI>>C %ch88 ,,TYTJJJFH	 # 2H			% % g&& 	' I$)X.. 6 I		DIs++ 
6	 
6d>Q 
6.r2) .j.U.U .!)!?!?	!O!OJ! .jn&9&9$(I	DIy11 6di6G 6!$)"2J?????di.99 6 $	 0 5I 'O''	22=Z8Y8W%X%X=  !DI$%J$4"DM !DIII?	' 	'0' ' ===rR  ri   c                   |j                             |            |j        dv rt          |j         | j                  }|t
          t          fv r|j        dk    s|t          t          fv r|j        dk    r	d|_	        d S |t          t          fv r|j        dk    s|t
          t          fv r|j        dk    rd|_
        |j                            |            d S )N)andr@  r:  r@  T)r  r  r  r   r"  r   r   r   r   right_unreachableright_alwaysr  )rO  r  r;  s      rP  visit_op_exprzSemanticAnalyzer.visit_op_expr<  s    	7m##,TYEEH\:66647e;K;K[)444D)-&{I66647e;K;K\:66647d??$(!
$rR  r@   c                D    |j         D ]}|                    |            d S rT  )operandsr  )rO  r  operands      rP  visit_comparison_exprz&SemanticAnalyzer.visit_comparison_exprM  s2    } 	! 	!GNN4    	! 	!rR  r   c                :    |j                             |            d S rT  r  r  r  s     rP  visit_unary_exprz!SemanticAnalyzer.visit_unary_exprQ  s    	rR  r[   c                   |j         }|                    |            t          |t                    rOt          |j        t
                    r5|j                                        s|j                            |            d S t          |t                    rt          |j        t                    st          |          r| 
                    |           d S |j                            |            d S rT  )r?  r  r~  rq   r  r   
is_genericr  r   refers_to_class_or_functionanalyze_type_application)rO  r  r?  s      rP  visit_index_exprz!SemanticAnalyzer.visit_index_exprT  s    yDtW%%	$49h//	$ I((**	$
 Jd#####tW%%	$*4TY	*J*J	$(..	$
 ))$/////Jd#####rR  c                (   |                      |          }|dS |j        }t          ||          |_        |j        |j        _        |j        |j        _        t          |t                    rt          |j        t                    r|j        }t          |j                  }t          |t                    rc|j        j        }|j        rR|t!          | j        j                  v r9| j        s4|j        s/|                     t-          |d          |           dS dS dS dS dS dS |                     |          }|rS|j        t!          | j        j                  v r5| j        s0|                     t-          |j        d          |           dS dS dS dS )zNAnalyze special form -- type application (either direct or via type aliasing).NF)propose_alt)analyze_type_application_argsr?  r   r4  r  r  r~  rq   r  r   r   r  r   rV  rr  r  r   r"  r  rY  r  r  r   r  )rO  r  r  r?  r  r  r  r  s           rP  rH  z)SemanticAnalyzer.analyze_type_applicationf  s   22488=Fy'e44!Y#{ dG$$ 	[DIy)I)I 	[IE$U\22F&(++ 	Y{+MY*4<+FGGH H -H ",H
 II85QQQSWXXXXX	Y 	YY YH H H H H H %%d++A[J"5dl6Q"R"RRR) S 		4QZUSSSUYZZZZZ[ [RRRRrR  list[Type] | Nonec                0   |j         }|                                 }|                     |           |                     |          rdS | j        rdS g }t          |t                    rl|j        }t          |j        t                    o|j        j
        dk    }|r8t          |          dk    r%t          |d         t                    r
|dd         }n|g}|j        }t          |t                    rit          |j        t                    rO|j        j        du}|j        }	t!          d |	j        D                       rd}
t          |	j                  }n|d}
d}nwt          |t                    r\t          |j        t$                    rB|j        j        p|j        j
        dk    }|j        j        }
t          |j        j                  }nd}d}
d}|D ]|}	 |                     |d          }n(# t.          $ r |                     d	|           Y  dS w xY w|                     || j        d|
|
          }| dS |                    |           }|r'|                                                     |          }|
r|dk    r|rt=          |d                   }t          |          dk    ot          |t>                    }|sRt!          d |D                       s9tA          |tB          gt          |          z  dgt          |          z            g}|S )zoAnalyze type arguments (index) in a type application.

        Return None if anything was incomplete.
        Nr&  r  r  c              3  @   K   | ]}t          |t                    V  d S rT  )r~  r   r=  s     rP  r  zASemanticAnalyzer.analyze_type_application_args.<locals>.<genexpr>  s,      KKA:a//KKKKKKrR  TFr*  zType expected within [...])rK  r%  r(  r*  r  r   c              3  N   K   | ] }t          |t          t          f          V  !d S rT  )r~  r   r   r=  s     rP  r  zASemanticAnalyzer.analyze_type_application_args.<locals>.<genexpr>  s2      %`%`UVjZ4O&P&P%`%`%`%`%`%`rR  )"r  r  r  r  rJ  r~  r   r  r?  rq   rr  r  rJ   r  r   rm  r  rl  r   has_type_var_tuple_typehas_param_spec_typer  r   r   r  r  rK  r  r"  check_unpacks_in_listr   r   r   r!   )rO  r  r  r  r  r  is_tupler?  r*  r  has_param_specnum_argsra  typeargr4  	first_arg
single_anys                    rP  rL  z.SemanticAnalyzer.analyze_type_application_args  sS   
 
((**u%%%$$S)) 	4' 	4eY'' 	KE!$)W55`$):LP`:`H #CJJ!OO
59l0S0SOcrc
GE ydG$$ 	DIy)I)I 	95TALIEKK9JKKKKK !%u011!&g&& 		:di+J+J 			1[TY5GK[5[  "Y:N49.//HH L"NH 	# 	#D66t$6OO'   		6===ttt ~~ %)$<"&*8) & 	 	H ttLL"""" 	F&&((>>uEEE 	Yh!mmm'a11IUqKZ	7-K-KJ Y#%`%`Z_%`%`%`"`"` Y#EG9s5zz+AD6CPUJJCVWWXs   G00 HHrv   c                    |j         r|j                             |            |j        r|j                            |            |j        r|j                            |            d S d S rT  )begin_indexr  	end_indexstrider  s     rP  visit_slice_exprz!SemanticAnalyzer.visit_slice_expr  st     	*##D)))> 	(N!!$'''; 	%Kt$$$$$	% 	%rR  r>   c                    |j                             |            |                     |j                  }|	||_        d S d S rT  r  r  r  rV  rO  r  r4  s      rP  visit_cast_exprz SemanticAnalyzer.visit_cast_expr  D    	>>$),, DIII  rR  r6   c                    |j                             |            |                     |j                  }|	||_        d S d S rT  ra  rb  s      rP  visit_assert_type_exprz'SemanticAnalyzer.visit_assert_type_expr  rd  rR  rs   c                p    |j         t          k    r%|j        |j                            |            d S d S d S rT  )r.  r.   r  r  r  s     rP  visit_reveal_exprz"SemanticAnalyzer.visit_reveal_expr  sB    9##y$	  &&&&& %$
 DrR  r   c                    |j                             |            t          t          |j                            D ].}|                     |j        |                   }|
||j        |<   /d S rT  )r  r  r  r  r  r  )rO  r  r  r4  s       rP  visit_type_applicationz'SemanticAnalyzer.visit_type_application  sj    	s4:'' 	) 	)A~~djm44H# (
1	) 	)rR  r^   c                   t          |j        j                  rR|                                 r| j        d         j        s,|                     t          j        |t          j
                   |j                            |            d S Nr  r  r  	generatorr  r  r1  r5  r  r   r  r&  rg  r  r  s     rP  visit_list_comprehensionz)SemanticAnalyzer.visit_list_comprehension  |    t~&'' 	a%%'' at/B2/F/S a		*FSXS_	```d#####rR  rt   c                   t          |j        j                  rR|                                 r| j        d         j        s,|                     t          j        |t          j
                   |j                            |            d S rl  rm  r  s     rP  visit_set_comprehensionz(SemanticAnalyzer.visit_set_comprehension  rp  rR  rI   c                   t          |j                  rR|                                 r| j        d         j        s,|                     t          j        |t          j	                   | 
                    |          5  |                     |           |j                            |            |j                            |            d d d            n# 1 swxY w Y   |                     |           d S rl  )r  r  r  r1  r5  r  r   r  r&  rg  r  analyze_comp_forr  r  rf  analyze_comp_for_2r  s     rP  visit_dictionary_comprehensionz/SemanticAnalyzer.visit_dictionary_comprehension  s   t} 	a%%'' at/B2/F/S a		*FSXS_	```ZZ 	$ 	$!!$'''HOOD!!!Jd###	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	%%%%%s   <A
CCCrT   c                    |                      |          5  |                     |           |j                            |            d d d            n# 1 swxY w Y   |                     |           d S rT  )r  rt  	left_exprr  ru  r  s     rP  visit_generator_exprz%SemanticAnalyzer.visit_generator_expr  s    ZZ 	( 	(!!$'''N!!$'''	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	( 	%%%%%s   0AAA'GeneratorExpr | DictionaryComprehensionc                   t          t          |j        |j        |j                            D ]S\  }\  }}}|dk    r|                    |            |                     |           |D ]}|                    |            TdS )zAnalyses the 'comp_for' part of comprehensions (part 1).

        That is the part after 'for' in (x for x in l if p). This analyzes
        variables and conditions which are analyzed in a local scope.
        r   N)r  rQ  indices	sequences	condlistsr  rb  )rO  r  r  r  sequence
conditionsconds          rP  rt  z!SemanticAnalyzer.analyze_comp_for  s     1:dndn==1
 1
 	" 	",A,x 1uu%%%&&&" " "D!!!!"	" 	"rR  c                F    |j         d                             |            dS )zAnalyses the 'comp_for' part of comprehensions (part 2).

        That is the part after 'for' in (x for x in l if p). This analyzes
        the 'l' part which is analyzed in the surrounding scope.
        r   N)r}  r  r  s     rP  ru  z#SemanticAnalyzer.analyze_comp_for_2&  s%     	q  &&&&&rR  r]   c                    |                      |           |                     dd          5  |                     |           d d d            d S # 1 swxY w Y   d S )NF)rg  )r/  rj  r0  r  s     rP  visit_lambda_exprz"SemanticAnalyzer.visit_lambda_expr.  s    %%d+++..uE.JJ 	- 	-&&t,,,	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	- 	-s   AAArB   c                    |j                             |            |j                            |            |j                            |            d S rT  )if_exprr  r  	else_exprr  s     rP  visit_conditional_exprz'SemanticAnalyzer.visit_conditional_expr3  sJ    D!!!	d#####rR  ro   c                    |                      |j                  }|(t          |t                    s
J d            ||_        d S d S )Nz&Cannot use type aliases for promotions)r  rV  r~  r   rb  s      rP  visit__promote_exprz$SemanticAnalyzer.visit__promote_expr8  sM    >>$),,h
33]]5]]]] DIII  rR  r   c                   |                                  s|                     d|dd           ny| j        d         t          k    r|                     d|dd           nI| j        d         j        r%d| j        d         _        d| j        d         _        nd| j        d         _        |j        r|j        	                    |            d S d S )Nz"yield" outside functionTr  r  z4"yield" inside comprehension or generator expression)
r  r  r+  r  r1  r5  r  r6  r  r  r  s     rP  visit_yield_exprz!SemanticAnalyzer.visit_yield_expr>  s    !!## 	8II0!T4IPPPPb!%888IIF	       $1 	837D#09=D#6637D#06 	 FMM$	  	 rR  r9   c                "   |                                  r| j        s$|                     d|dt          j                   n5| j        d         j        s#|                     d|dt          j                   |j                            |            d S )Nz"await" outside functionT)rf  r  r  z'"await" outside coroutine ("async def"))	r  r1  r  r&  TOP_LEVEL_AWAITr5  AWAIT_NOT_ASYNCr  r  r  s     rP  visit_await_exprz!SemanticAnalyzer.visit_await_exprP  s    !!## 	4+> 	 II0$5K`Iaaaa$R(5 	II9*	     		rR  rt  r   c                    |j         |j                             |            |j        |                     |j                   d S d S rT  )patternr  r  rb  rO  rt  s     rP  visit_as_patternz!SemanticAnalyzer.visit_as_patternc  sL    9 IT"""6''''' rR  r   c                D    |j         D ]}|                    |            d S rT  r  r  rO  rt  r  s      rP  visit_or_patternz!SemanticAnalyzer.visit_or_patterni  2    z 	! 	!GNN4    	! 	!rR  r   c                :    |j                             |            d S rT  rC  r  s     rP  visit_value_patternz$SemanticAnalyzer.visit_value_patternm  s    	drR  r   c                D    |j         D ]}|                    |            d S rT  r  r  s      rP  visit_sequence_patternz'SemanticAnalyzer.visit_sequence_patternp  r  rR  r   c                L    |j         |                     |j                    d S d S rT  )capturerb  r  s     rP  visit_starred_patternz&SemanticAnalyzer.visit_starred_patternt  s.    9 	***** ! rR  r   c                    |j         D ]}|                    |            |j        D ]}|                    |            |j        |                     |j                   d S d S rT  )rC  r  r  restrb  )rO  rt  r  rf  s       rP  visit_mapping_patternz&SemanticAnalyzer.visit_mapping_patternx  sz    6 	 	CJJtX 	 	ELL6''''' rR  r   c                    |j                             |            |j        D ]}|                    |            |j        D ]}|                    |            d S rT  )	class_refr  positionalskeyword_values)rO  rt  r4  r  s       rP  visit_class_patternz$SemanticAnalyzer.visit_class_pattern  sk    	4   = 	 	CJJt! 	 	AHHTNNNN	 	rR  r^  SymbolTableNode | Nonec                   d}|| j         d         v r0|| j        v r| j        |         S |s|                     ||           dS || j        d         v rIt	          | j        dd                   D ]}|||v r
||         c S |s|                     ||           dS | j        r\|                                 sH|| j        j        v r:| j        j        |         }|j	        s| 
                    |j                  r|S nd}|}| j        rM|                                 s9|dv r5t          t          t          ||                                                     S t	          | j                  D ]}|||v r
||         c S || j        v r| j        |         S | j                            dd          }|r{t#          |j        t$                    sJ |j        j        }||v rOt'          |          dk    r2|d         d	k    r&|d         d	k    r|s|                     ||           dS ||         }|S |s|s|                     ||           n|r|S dS )
a_  Look up an unqualified (no dots) name in all active namespaces.

        Note that the result may contain a PlaceholderNode. The caller may
        want to defer in that case.

        Generate an error if the name is not defined unless suppress_errors
        is true or the current namespace is incomplete. In the latter case
        defer.
        Fr  NT>   
__module____qualname__rn  r  r   r@  )r'  r&  rA  r(  r  r)  rV  r  rq  rG  is_active_symbol_in_class_bodyr  r}   r*   r   r  r  r~  rc   r  )	rO  r  r   r^  implicit_namer  r  implicit_nodert  s	            rP  r  zSemanticAnalyzer.lookup  s    4$R(((t|##|D))" 1%%dC00044&r***!$+crc"233 ' '$ ;&&&" 1%%dC00049 	%T//11 	%ddio6M6M9?4(D= %66tyAA  K  !% $9 	ET//11 	Ed>\6\6\"4T4==??)C)CDDDdk** 	# 	#E TU]]T{""" 4<<%%L^T22 		afh/////FLEu}}t99q==T!W^^Q3* 9--dC8884T{ 	%_ 	%!!$,,,, %$$trR  SymbolNode | Nonec                Z   | j         dS |/|                     |          s|                     |j                  sdS |                     |          rY|j        | j        vrdS | j        |j                 }|                     |j                  sdS |                     |j                   S dS )a/  Can a symbol defined in class body accessed at current statement?

        Only allow access to class attributes textually after
        the definition, so that it's possible to fall back to the
        outer scope. Example:

            class X: ...

            class C:
                X = X  # Initializer refers to outer scope

        Nested classes are an exception, since we want to support
        arbitrary forward references in type annotations. Also, we
        allow forward references to type aliases to support recursive
        types.
        NTF)	r:  is_textually_before_statementis_defined_in_current_modulerr  is_type_liker  r&  is_textually_before_classr  )rO  r  global_nodes      rP  r  z/SemanticAnalyzer.is_active_symbol_in_class_body  s    & >!4L11$77 44T]CC  4T"" 	; y,,t,ty1K11+2BCC t(()9::::urR  c                r    t          |t          t          f          pt          |t                    o|j        S rT  )r~  r   r   rn   r8  rO  r  s     rP  r  zSemanticAnalyzer.is_type_like  s3    $9 566 
t_--G$2G	
rR  r{   c                    | j         sJ | j         j        |j        z
  }|                     || j                   rdS t          |t                    r|j        s|t          |j                  k    S |dk    S )zCheck if a node is defined textually before the current statement

        Note that decorated functions' line number are the same as
        the top decorator.
        Fr   )r:  r  is_overloaded_itemr~  rF   r  r  r  )rO  r  	line_diffs      rP  r  z.SemanticAnalyzer.is_textually_before_statement  s     ~N'$)3	
 ""488 	!5i(( 	!1A 	!s4#;<<<<q= rR  c                P    | j         J |dS |j        | j         j        j        k     S )zFSimilar to above, but check if a node is defined before current class.NF)rV  r  r  r  s     rP  r  z*SemanticAnalyzer.is_textually_before_class  s.    y$$$<5y49>...rR  rx   c                    t          |t                    rft          |t                    rQ|d |j        D             v }|j        duo0t          |j        t
                    r||j        j        u p||j        u }|p|S dS )z=Check whether the function belongs to the overloaded variantsc                J    h | ] }t          |t                    r|j        n|!S rA  )r~  rF   rN  r  s     rP  rr  z6SemanticAnalyzer.is_overloaded_item.<locals>.<setcomp>  s:     % % %GKZi88B		d% % %rR  NF)r~  rj   rR   r  r  rF   rN  )rO  r  r:  in_itemsin_impls        rP  r  z#SemanticAnalyzer.is_overloaded_item  s    d-.. 	':i3Q3Q 	'  % %OSz% % % H it+ DIy11Qi49>6Q *	)  &w&urR  c                F    |sdS t          | j        |          | j        k    S r  )r  r%  r  r  s     rP  r  z-SemanticAnalyzer.is_defined_in_current_module#  s(     	5T\844GGrR  c                B   d|vr|                      |||          S |                    d          }| j        }|                      |d         ||          }|rt          dt	          |                    D ]}|j        }||         }	t          |t                    r|                    |	          }
n@t          |t                    r| 
                    ||	          }
|j        }nt          |t                    r|c S t          |t                    r`|j        rYt          |j        t                     sJ t          |j        t"                    r |j        j                            |	          }
nd}
n~t          |t&                    rKt)          |j                  }t          |t*                    r"|                     ||||d         |          c S t          |t.                    r|	dv r dS d}
|
r|
j        r|s|                     |||            dS |
}|S )aS  Lookup a qualified name in all activate namespaces.

        Note that the result may contain a PlaceholderNode. The caller may
        want to defer in that case.

        Generate an error if the name is not defined unless suppress_errors
        is true or the current namespace is incomplete. In the latter case
        defer.
        r|  r]  r   r  N)rd  kwargs)r  )r  r  r  r  r  r  r~  r   r  rc   r2  rr  rn   r   r  r  r   r   rV  r   r   r   implicit_symbolrl   r  rA  )rO  r  r   r^  partsr  re  r  r  partnextsymr  s               rP  rb  z!SemanticAnalyzer.lookup_qualified(  s4    d??;;tS/;JJJ

3O	kk%(CkII "	1c%jj)) ! !xQxdH-- #"hhtnnGGh// #"44T4@@G $IIo66 #JJJi00 #T\ #%dk:>>>>>!$+x88 '"&+"2"6"6t"<"<"&!$,, S-di88%c733 S#'#7#7T59c#R#RRRR "$66 $4CU;U;U#tt"G  '"7  * N--dC9-MMM44
rR  c                    	 |                      |          }n# t          $ r Y d S w xY wt          |t                    r|                     |j        |d          }|S d S NTr]  )r   r   r~  r   rb  r  )rO  r  r  r  s       rP  r  z!SemanticAnalyzer.lookup_type_node_  sv    	,,T22AA# 	 	 	44	a%% 	%%afdD%IIAHts    
&&c                D   |j         }|j        }|                    |          }|s|dz   |z   }|| j        v r!t	          t
          | j        |                   }n|                     |          r|                                  nd|v r5|                     |d         ||          }|rt	          t
          |          }ne| 	                    |          rFt          t          j                  }t          ||          }	||	_        t	          t
          |	          }n	|j        rd}|S )zcLook up a symbol from a module.

        Return None if no matching symbol could be bound.
        r|  r-  rV  N)rr  rq  r  r%  r}   r%   rB  r  r2  is_missing_moduler   r   from_unimported_typer   r  r  )
rO  r  r  r6  rq  re  rr  r9  var_typer  s
             rP  r2  z"SemanticAnalyzer.get_module_symboli  s,   
 
iioo 	|d*H4<''%dDL,BCC--f55 /**,,,,%''..u]/CT8TT 6)$55C''11 / #9#ABB8,,,&%dA.. 	C
rR  r6  c                    || j         v S rT  )r<  )rO  r6  s     rP  r  z"SemanticAnalyzer.is_missing_module  s    ---rR  r  	list[str]source_typer   c                   |j         d}n|j         j        }||}n|dz   d                    |          z   }t          t          j        |          }t          |d         |          }||_        t          t          |          S )z>Create symbol for a qualified name reference through Any type.Nr|  r  )
r  rr  rI  r   r   from_another_anyr   r  r}   r%   )	rO  re  r  r  r  basenamerr  r  r  s	            rP  r  z SemanticAnalyzer.implicit_symbol  s~     8HHx(HHH#~7H95{CC%)X&& tS)))rR  getattr_defn
Var | Nonec                (   t          |j        t          t          f          rpt	          |j        j                  }t          |t                    r|j        }nt          t          j
                  }t          ||          }||_        d|_        |S dS )a  Create a dummy variable using module-level __getattr__ return type.

        If not possible, return None.

        Note that multiple Var nodes can be created for a single name. We
        can use the from_module_getattr and the fullname attributes to
        check if two dummy Var nodes refer to the same thing. Reusing Var
        nodes would require non-local mutable state, which we prefer to
        avoid.
        r  TN)r~  r  rR   r   r   rV  r   r  r   r   rF  r  from_module_getattr)rO  r  r  rr  	node_typer  r  s          rP  r2  z#SemanticAnalyzer.create_getattr_var  s     l''388 		'(9(>??I)\22 4(i233Ds###A"AK$(A!HtrR  c                H    |                      |          }|
J |            |S rT  )r  )rO  rr  rets      rP  lookup_fully_qualifiedz'SemanticAnalyzer.lookup_fully_qualified  s)    11(;;
rR  c                   |                     dd          \  }}|| j        v rT| j        |         }|j                            |          }|)|                     |          r|                                  |S |                    d          }g }|rad                    |          | j        vrE|                    |	                                           |rd                    |          | j        vE|r|sdS |
                                 d                    |          }| j        |         }|j                            |d                   }|)|                     |          r|                                  |dd         D ]@}|:t          |j        t                    r |j        j                            |          }> dS |S )aT  Lookup a fully qualified name that refers to a module-level definition.

        Don't assume that the name is defined. This happens in the global namespace --
        the local module namespace is ignored. This does not dereference indirect
        refs.

        Note that this can't be used for names nested in class namespaces.
        r|  r  )maxsplitNr   )r  r%  rq  r  rB  r  r  rI  r  r  reverser~  r  r   )	rO  rr  r6  r  filenoder9  splitted_modulesrq  r  s	            rP  r  z/SemanticAnalyzer.lookup_fully_qualified_or_none  s     sQ77T\!! |F+H^''--F~$">">v"F"F~**,,,M  (~~c22E" 5sxx0@'A'A'U'U-1133444 # 5sxx0@'A'A'U'U $ 5 t MMOOOXX.//F|F+H^''a11F~$">">v"F"F~**,,,abb	    %*V[(*K*K%#[.22488FF44MrR  c                ,    |                      d          S )Nr  r  rU  s    rP  r/  zSemanticAnalyzer.object_type  s    0111rR  c                ,    |                      d          S )Nr  r  rU  s    rP  r  zSemanticAnalyzer.str_type  s    ~...rR  c                (   |                      |          }|s
J d            |j        }t          |t                    sJ |rt	          ||          S t	          |t          t          j                  gt          |j	        j
                  z            S )Nz3Internal error: attempted to construct unknown type)r  r  r~  r   r   r   r   r  r  r  r  rO  rr  rd  re  r  s        rP  r  zSemanticAnalyzer.named_type  s    ))(33IIIIIIx$))))) 	(D$'''wy'=>>?#diFYBZBZZ[[[rR  c                   |                      |          }|rt          |j        t                    rd S |j        }t          |t                    r(t          |j        t                    sJ |j        j        }t          |t                    s
J |            |t          ||          S t          |t          t          j                  gt          |j        j                  z            S rT  )r  r~  r  rn   r   r  r   rV  r   r   r   unannotatedr  r  r  r  s        rP  r  z#SemanticAnalyzer.named_type_or_none  s    11(;; 	j?;; 	4xdI&& 	$dk844444;#D$))//4///D$'''wy'<==>TYEXAYAYYZZZrR  fully_qualified_namec                ,    |                      |          S )z,Legacy function -- use named_type() instead.r  )rO  r  s     rP  builtin_typezSemanticAnalyzer.builtin_type	  s    3444rR  c                    | j         d          | j         d                             |          S | j        | j        j                            |          S | j                            |          S Nr  )r)  r  rV  rq  r&  rO  r  s     rP  lookup_current_scopez%SemanticAnalyzer.lookup_current_scope  s^    ;r?&;r?&&t,,,Y"9?&&t,,,<##D)))rR  r9  r  c
           	         |                                  rt          }
n| j        t          }
nt          }
t          |
|||          }|                     |||||||	          S )a  Add symbol to the currently active symbol table.

        Generally additions to symbol table should go through this method or
        one of the methods below so that kinds, redefinitions, conditional
        definitions, and skipped names are handled consistently.

        Return True if we actually added the symbol, or False if we refused to do so
        (because something is not ready).

        If can_defer is True, defer current target if adding a placeholder.
        Nr  )r  r)   rV  r*   r%   r}   add_symbol_table_node)rO  r  r  r  r  r  r9  r_  r  r  r.  r)  s               rP  r  zSemanticAnalyzer.add_symbol  s{    .  	DDY"DDD $m=
 
 
 ))&'9.C[R\
 
 	
rR  c                    | j         | j         j        }t          }n| j        }t          }t          ||          }|||<   dS )a  Same as above, but skipping the local namespace.

        This doesn't check for previous definition and is only used
        for serialization of method-level classes.

        Classes defined within methods can be exposed through an
        attribute type, but method-level symbol tables aren't serialized.
        This method can be used to add such classes to an enclosing,
        serialized symbol table.
        N)rV  rq  r*   r&  r%   r}   )rO  r  r  rq  r.  r)  s         rP  r  z&SemanticAnalyzer.add_symbol_skip_local=  sD     9 IOEDDLED t,,drR  r)  Context | Nonec                   |                      ||          }|                    |          }	t          |j        t                    r0|r.||                     |d|           n|                                  |	|t          |	|          s|	j        }
|j        }t          |t                    rdS t          |
|          st          |t          t          t          t          f          r|                     |||           t          |t          t          f          r|                     |
|          s|                     |||	           n.|| j        d         vrd| j        d         vr|||<   |sd| _        dS dS )a  Add symbol table node to the currently active symbol table.

        Return True if we actually added the symbol, or False if we refused
        to do so (because something is not ready or it was a no-op).

        Generate an error if there is an invalid redefinition.

        If context is None, unconditionally add node, since we can't report
        an error. Note that this is used by plugins to forcibly replace nodes!

        TODO: Prevent plugins from replacing nodes, as it could cause problems?

        Args:
            name: short name of symbol
            symbol: Node to add
            can_defer: if True, defer current target if adding a placeholder
            context: error context (see above about None value)
        )r_  r  Nr  Fr  rZ  T)r  r  r~  r  rn   r  r  is_valid_replacementis_same_symbolrR   rF   rj   r   add_redefinitionrl  r  r2  progress)rO  r  r)  r  r9  r_  r  r  rq  r  rd  rh  s               rP  r  z&SemanticAnalyzer.add_symbol_table_nodeS  s   8 ))"7J * 
 
 99T??fk?33 		 	"((vw???? 

 #(6:: $ -C+C#// u!#s++ GcGY8I8#TUU ?))%v>>>"3)(<== G$BWBWX[]`BaBa G--dGXFFF+B///Ct?QRT?U4U4U E$K % $4urR  c                    d}d|_         	 |dk    r| d}n| d| }|                    |          }||||<   dS |j        |j        u rdS |dz  }G)aO  Add a symbol table node that reflects a redefinition as a function or a class.

        Redefinitions need to be added to the symbol table so that they can be found
        through AST traversal, but they have dummy names of form 'name-redefinition[N]',
        where N ranges over 2, 3, ... (omitted for the first redefinition).

        Note: we always store redefinitions independently of whether they are valid or not
        (so they will be semantically analyzed), the caller should give an error for invalid
        redefinitions (such as e.g. variable redefined as a class).
        r  Tz-redefinitionN)no_serializer  r  )rO  rq  r  r)  r  new_namer  s          rP  r  z!SemanticAnalyzer.add_redefinition  s     
 #	Avv"111"4444yy**H"(h&+--FA	rR  !Var | FuncDef | OverloadedFuncDefc                |    |                                  sJ |j        }||_        |                     |||           dS )zAdd local variable or function.N)r  r  r  r  )rO  r  r  r  s       rP  r  zSemanticAnalyzer.add_local  sD    !!#####ydG,,,,,rR  symbol_nodec                @   |d S d }t           ||          t          t          t          f          rj|                                                     |          }|t           ||j                  t          t          t          f          rUt           ||j                   |t                              s" ||j                   ||          j        k    r|j        S t           ||          t          t          f          r0t          t          j
                  }|                     d|           n ||          j        }t          ||          }|                     |          |_        | j        J | j        |_        |j        |_        |j        |_        |S )Nc                    | S rT  rA  xs    rP  r  zDSemanticAnalyzer._get_node_for_class_scoped_import.<locals>.<lambda>  s    q rR  zUnsupported class scoped import)r~  rF   rQ   r   r  r  r  rV  r   r   rF  r  r  r  r  r  r  )rO  r  r  r  fr  r  s          rP  !_get_node_for_class_scoped_importz2SemanticAnalyzer._get_node_for_class_scoped_import  s    4
 &1[aanny(C&@AA 	0 002266t<<H $qq//)Xs1KLL % qq//7<< % q''11[>>+>>>  }$ !!K..8Y*?@@ * $+9+?#@#@		;WEEEEann)dC..K$($7$7$=$=K!9(((#yK&|K!(KrR  c                   |r|rJ |                      |          }|rNt          |j        t                    s4t          |j        t                    s|                     ||||          rdS |j        }|                                 r|                     |||          }t          |j        |||          }| 	                    |||           dS )z2Add an alias to an existing symbol through import.Nr  )
r  r~  r  rn   rT  r  r  r}   r.  r  )	rO  r  r  r  r  r  rK  r  r)  s	            rP  r#  z$SemanticAnalyzer.add_imported_symbol  s     !555533D99	3_EE	 ty/::	 55dOTSZ[[ )-   	]@@{T[\\K I{-}
 
 
 	""499999rR  c                   |                                                      |          }|r(t          |j        t                    r|j        j        rdS t	          |          }| j        j        r
|||_        nE| j	        r$| j	        j
        dz   |z   |_        | j	        |_        n|                     |          |_        d|_        t          t          j        |j                  }||_	        d|_        |                     |||||           dS )a  Add symbol that we don't know what it points to because resolving an import failed.

        This can happen if a module is missing, or it is present, but doesn't have
        the imported attribute. The `target_name` is the name of symbol in the namespace
        it is imported from. For example, for 'from mod import x as y' the target_name is
        'mod.x'. This is currently used only to track logical dependencies.
        Nr|  Tmissing_import_namer  )r  r  r~  r  r   is_suppressed_importr"  logical_depsr  rV  rr  r  r  r  r   r   r  r  )	rO  r  r  r  r  r  r  r  r;  s	            rP  r$  z,SemanticAnalyzer.add_unknown_imported_symbol  s    ,,..22488 	
8=#66 	8=;] 	F$ii<$ 
	6)@
 (CMMY 	6 I.4t;CMyCHH //55CM99s}]]]#' #wm= 	 	
 	
 	
 	
 	
rR  framec              #  <   K   | j         }|| _         d V  || _         d S rT  )r0  )rO  r  	old_scopes      rP  r  z!SemanticAnalyzer.tvar_scope_frame-  s(      O	#rR  debug_contextr  c                    | j         r
J d            |rd| _        d| _        |r|j        n| j        r| j        j        nd}| j                            | j        |f           dS )a]  Defer current analysis target to be analyzed again.

        This must be called if something in the current target is
        incomplete or has a placeholder node. However, this must *not*
        be called during the final analysis iteration! Instead, an error
        should be generated. Often 'process_placeholder' is a good
        way to either defer or generate an error.

        NOTE: Some methods, such as 'anal_type', 'mark_incomplete' and
              'record_incomplete_ref', call this implicitly, or when needed.
              They are usually preferable to a direct defer() call.
        z%Must not defer during final iterationTr  N)r_  r  r  r  r:  rI  r  r  )rO  r  r  r  s       rP  r  zSemanticAnalyzer.defer4  s     'PP)PPPP 	! !DM #0bMDN5bT^5H5H`b 	 	#**DOT+BCCCCCrR  r  c                    | j         S )zHReturn tag that can be used for tracking references to incomplete names.r  rU  s    rP  r  z&SemanticAnalyzer.track_incomplete_refsP  s    ''rR  r  c                    | j         |k    S )zDHave we encountered an incomplete reference since starting tracking?r  )rO  r  s     rP  r  z%SemanticAnalyzer.found_incomplete_refT  s    '3..rR  c                N    |                                   | xj        dz  c_        dS )zRRecord the encounter of an incomplete reference and defer current analysis target.r  N)r  r  rU  s    rP  r  z&SemanticAnalyzer.record_incomplete_refX  s)    

  A%    rR  r8  c                x   |                      |           |dk    rd| _        nv|                     |          sa|                     |          }| j        sJ t          ||| j        j        |          }|                     ||||t                                 | j	        d         
                    |           dS )a  Mark a definition as incomplete (and defer current analysis target).

        Also potentially mark the current namespace as incomplete.

        Args:
            name: The name that we weren't able to define (or '*' if the name is unknown)
            node: The node that refers to the name (definition or lvalue)
            becomes_typeinfo: Pass this to PlaceholderNode (used by special forms like
                named tuples that will create TypeInfos).
        rZ  Tr7  r.  r  N)r  r  r/  r  r:  rn   r  r  r  r2  r  )rO  r  r  r8  r  r  rr  rY  s           rP  r  z SemanticAnalyzer.mark_incomplete]  s    $ 	

43;;"DOO++D11 	**400H>!!!)$ 3FV  K OO++%     	2""4(((((rR  c                    || j         v S )zIs a module or class namespace potentially missing some definitions?

        If a name is missing from an incomplete namespace, we'll need to defer the
        current analysis target.
        )r=  r  s     rP  rB  z(SemanticAnalyzer.is_incomplete_namespace  s     4555rR  c                t    | j         r|                     |||           dS |                     ||           dS )a  Process a reference targeting placeholder node.

        If this is not a final iteration, defer current node,
        otherwise report an error.

        The 'kind' argument indicates if this a name or attribute expression
        (used for better error message).
        r  N)r_  r  r  )rO  r  r.  r   r  s        rP  r  z$SemanticAnalyzer.process_placeholder  sI      	;$$T455555JJs>J:::::rR  c                    |rd| dnd}|                      d| | d|           |                                 r|                     d|           d S d S )Nr  r@  r5  zCannot resolve z (possible cyclic definition)z1Recursive types are not allowed at function scope)r  r  r  )rO  r  r.  r   name_formats        rP  r  z$SemanticAnalyzer.cannot_resolve_name  sz    &*2l4llll		TDT+TTTVYZZZ 	PIII3OOOOO	P 	PrR  c                z    | j         | j         j        dz   |z   S |                                 r|S | j        dz   |z   S )Nr|  )rV  r  r  r  r  s     rP  r  zSemanticAnalyzer.qualified_name  sJ    9 9&,t33!! 	0K?S(4//rR  r  2FuncItem | GeneratorExpr | DictionaryComprehensionc              #  0  K   | j                             |t                                }| j                            |           t          |t          t          f          }| j                            |st          nt                     | j                            t                                 | j                            t                                 | j                            d           | j                            d           | j                            t                                 	 dV  | j                                         | j                                         | j                                         | j                                         | j                                         | j                                         | j                                         dS # | j                                         | j                                         | j                                         | j                                         | j                                         | j                                         | j                                         w xY w)z3Enter a function, generator or comprehension scope.r  r   N)rA  
setdefaultr|   r)  r  r~  rT   rI   r+  r  r  r'  rB  r(  r,  r4  r2  r  )rO  r  rq  is_comprehensions       rP  r  zSemanticAnalyzer.enter  s+     
 !,,X{}}EE5!!!%h@W0XYY2B [

H[\\\  '''""355)))###q!!!!!#%%(((		%EEEKOO  """!!#####%%%  """O!!!""$$$$$ KOO  """!!#####%%%  """O!!!""$$$$s   /G$ $B1Jc                l    | j         d         }|t          k    r| j         d         }|t          t          fv S )Nr  )r+  r  r  r  )rO  rh  s     rP  r  zSemanticAnalyzer.is_func_scope  s9    %b)
))))"-Jj*=>>>rR  c                >    t          d | j        D                       S )zJAre we underneath a function scope, even if we are in a nested class also?c              3  6   K   | ]}|t           t          fv V  d S rT  )r  r  )rC  r	  s     rP  r  z?SemanticAnalyzer.is_nested_within_func_scope.<locals>.<genexpr>  s-      TTa1%899TTTTTTrR  )r  r+  rU  s    rP  r  z,SemanticAnalyzer.is_nested_within_func_scope  s"    TT4CSTTTTTTrR  c                >    | j         d uo|                                  S rT  )rV  r  rU  s    rP  r  zSemanticAnalyzer.is_class_scope  s#    y$AT-?-?-A-A)AArR  c                T    |                                  p|                                  S rT  )r  r  rU  s    rP  r  z SemanticAnalyzer.is_module_scope  s(    ''))AT-?-?-A-ABBrR  c                    |                                  rt          }n#|                                 rt          }nt          }|S rT  )r  r*   r  r)   r%   )rO  r.  s     rP  r1  z$SemanticAnalyzer.current_symbol_kind  sB       	DD!! 	DDDrR  c                   |r)| j         d         t          k    r| j        d         }|J |S |                                 r| j         d         t          k    r| j        d         }n| j        d         }|J |rt	          | j                  t	          | j                   k    sJ t          t          | j                             D ]S\  }}|t          k    rC|t	          | j                  dz
  k    r| j        }n| j        d|z
           }|
J d            |} nTJ d            n|}|J n| j	        | j	        j
        }n| j        }|S )Nr  r  r  z)Escaping comprehension from invalid scopeFz0Should have at least one non-comprehension scope)r+  r  r)  r  r  r  r  r  r&  rV  rq  )rO  r_  r  r  r  rh  rq  names_candidates           rP  r  z%SemanticAnalyzer.current_symbol_table  s     !	!$*2.2BBBBA===H!! 	!#'777KOKO===$ 4;''3t/?+@+@@@@@%.x8H/I/I%J%J U UMAz!%888DK 0 01 444$(LEE.2k"q&.AO / ; ;J !< ; ;$3E 9 U"TTTT  $$$$Y"IOEELErR  c                f    |                                  o|| j        d         v p|| j        d         v S r  )r  r'  r(  r  s     rP  r/  z&SemanticAnalyzer.is_global_or_nonlocal  s=    !!## 
D%b))LTT5H5L-L	
rR  exp_or_exps!Iterable[Expression] | Expressionc                    t          |t                    r|gn|}|D ]6}t          |t                    r| j                            |j                   7d S rT  )r~  rL   ry   rE  r  rf  )rO  r(  expsexps       rP  r  zSemanticAnalyzer.add_exports  sa     *;
 C CT}} 	3 	3C#w'' 3 ''	222	3 	3rR  r  c                   |                      |p| j                  }|8| j        r1|                                 s| j        r| j        d         r	| j        sd}|r|                                  d S d| d}|                     ||t          j	                   d| t          v r5d| }|                     |          | j                            ||           d t          D             }d t          D             }|D ]y}	|	 d	|                                 }||vr d
                    |	||                             d	d          d                   }
|                     |
|t          j	                   zd S )Nr  Tr  z" is not definedr  r  c                F    h | ]}|                     d d          d         S )r|  r  r   rv  rB  s     rP  rr  z4SemanticAnalyzer.name_not_defined.<locals>.<setcomp>'  s8     )
 )
 )
&*DJJsAq!)
 )
 )
rR  c                8    i | ]}|                                 |S rA  )r  rB  s     rP  
<dictcomp>z5SemanticAnalyzer.name_not_defined.<locals>.<dictcomp>*  s"    PPPTdjjllDPPPrR  r|  zXDid you forget to import it from "{module}"? (Suggestion: "from {module} import {name}")r  )r6  r  )rB  r  rV  r  rC  r_  r  r  r&  NAME_DEFINEDr   r  rD  rF  r   r  r  r  r  )rO  r  r   r  r  rG  rr  modules_with_unimported_hints
lowercasedr6  hints              rP  rA  z!SemanticAnalyzer.name_not_defined  s   11)2NtOO
	 &&((  *  *2.	 
 (  J 	 &&(((F14111		'3U%7	888t!888)4))H228<<D))(C888)
 )
.H)
 )
 )
% QP5OPPP
3 		: 		:F ))4))//11Hz))?fFH)=)D)DS!)L)LR)PfQQ  IIdCe&8I9999		: 		:rR  original_ctx#SymbolTableNode | SymbolNode | Nonenounc                   t          |t                    r|j        }nt          |t                    r|}nd }t          |t                    rt          |j        t                    rd}n4|r0|j        dk    r%|                     |j                  rd|j         }nd}|                     | dt          |           d| |t          j                   d S )Nz (by an import)r  z	 on line z (possibly by an import)r  z" already definedr  )r~  r}   r  r{   rc   r  is_local_namerr  r  r  r&  NO_REDEF)rO  r  r   r5  r7  r  	extra_msgs          rP  r  z SemanticAnalyzer.already_defined6  s     lO44 	&2&7DDj11 	DDDlO44 
	3LDUW_9`9` 
	3 *II 	3di2oo$*<*<T]*K*Ko 0DI//II2I		CCx~~CC	CCSu~ 	 	
 	
 	
 	
 	
rR  c                8    |                      |||d           d S )Nr  r7  r  rO  r  r   r5  s       rP  r  z%SemanticAnalyzer.name_already_definedO  s'     	T36BBBBBrR  c                8    |                      |||d           d S )N	Attributer=  r>  r?  s       rP  rH  z*SemanticAnalyzer.attribute_already_definedT  s'     	T3;GGGGGrR  c                4    |                      |          pd|vS )zDDoes name look like reference to a definition in the current module?r|  )r  r  s     rP  r9  zSemanticAnalyzer.is_local_nameY  s    0066I#T/IrR  c                    | j         j        s| j        sdS t          | j                  dz
  }|dk    rB| j        |         }t	          |t
                    s|                                 S |dz  }|dk    BdS )zShould we type-check the current function?

        - Yes if --check-untyped-defs is set.
        - Yes outside functions.
        - Yes in annotated functions.
        - No otherwise.
        Tr  r   )r"  check_untyped_defsr1  r  r~  r]   r  )rO  current_indexcurrent_funcs      rP  in_checked_functionz$SemanticAnalyzer.in_checked_function]  s     <* 	$2E 	4D/0014q  .}=LlJ77 5'224444
 QM q   trR  )r  r  rD  str | ErrorMessagerf  r  ErrorCode | Noner  c          	        |s|                                  sd S |
J |            t          |t                    r||j        }|j        }| j                            |j        |j        ||||j	        |j
                   d S )N)r  r  r  r  )rG  r~  r   r  rf  r8  reportr  r  r  r  )rO  rD  r   rf  r  r  s         rP  r  zSemanticAnalyzer.failw  s      	t7799 	Fc<(( 	|x)CHJ\~ 	 	
 	
 	
 	
 	
rR  c                    |                                  sd S | j                            |j        |j        |d|           d S )Nr  )severityr  )rG  r8  rK  r  r  )rO  rD  r   r  s       rP  r  zSemanticAnalyzer.note  sF    '')) 	F38SZvDQQQQQrR  featurec                `    || j         j        vr|                     d| d| d|           dS dS )Nr@  z;" support is experimental, use --enable-incomplete-feature=z
 to enableFT)r"  enable_incomplete_featurer  )rO  rN  r   s      rP  incomplete_feature_enabledz+SemanticAnalyzer.incomplete_feature_enabled  s`    $,@@@IIHG H H4;H H H  
 5trR  c                    	 |                     |            d S # t          $ r7}t          || j        j        |j        | j        | j                   Y d }~d S d }~ww xY wrT  )r  	Exceptionr   r8  filer  r"  )rO  r  errs      rP  r  zSemanticAnalyzer.accept  sx    	_KK 	_ 	_ 	_!#t{'7DKQUQ]^^^^^^^^^	_s    
A,AAr'  r  c           	     B   t          |t                    r|                    |            | j                            |d |                                           \  }}	}
|
r,|                     d|           |                     d|           |t                      |	s| 	                    |           d S |	j
        s
J d            t          |	g           }t          |	j
        j        |          S |                     |          }|                     |||||||          S )Nz>Generic named tuples are not supported for legacy class syntaxz:Use either Python 3 class syntax, or the assignment syntaxzNamedTuple without tuple type)rn  )r'  r%  r  rK  r(  r*  )r~  r=   r  r  r  r  r  r  r   r  r  r   r   r  r   r  )rO  r  r'  r%  r  rK  r(  r*  r  r  r[  rn  r  s                rP  r  z&SemanticAnalyzer.expr_to_analyzed_type  sH    dH%% 	G KK-1-F-W-WdD..00. .*M4  ^		Z\`aaa		VX\]]]$ +,,, 

4   t?CC$CCCCb))HT_2XFFFF**400~~!5/) 3&?%  
 
 	
rR  c                    |                      t                                5  |                                 5  |                    |            d d d            n# 1 swxY w Y   d d d            d S # 1 swxY w Y   d S rT  )r  r   re  r  r  s     rP  r  z"SemanticAnalyzer.analyze_type_expr  s     ""#3#5#566 	 	8T8T8V8V 	 	KK	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	s4   A1AA1A	A1 A	!A11A58A5)r0  r)  rK  r%  allow_typed_dict_special_formsallow_finalr(  r*  r'  prohibit_self_type"prohibit_special_class_field_typesr  TypeVarLikeScope | Noner)  rX  rY  rZ  r[  r   c                  || j         }t          | || j        | j        | j        | j        |||	||||||
||          }t          | j        o| j        d                                                   |_	        | j
         o| j         |_        |S )N)rK  r)  r'  r%  rX  rY  r(  r*  rZ  r[  r  r  )r0  r   r9  r"  r#  r\  r  r1  r  r  rV  r  )rO  r0  r)  rK  r%  rX  rY  r(  r*  r'  rZ  r[  r  tpans                 rP  r"  zSemanticAnalyzer.type_analyzer  s      JKL& 3 3!5/+I#&?%1/Q)#
 
 
&  $D$7$`D<OPR<S<^<^<`<`aa $	ME$2E.ErR  c                <    t          || j        | j        |          S )NrP  )r   r"  rY  )rO  r  r*  s      rP  r   z(SemanticAnalyzer.expr_to_unanalyzed_type  s'    &$, 1
 
 
 	
rR  c               f    t           fd          }|r j        r|                                                       ||||||||	|
|||          }                                 }                    |                               |          rdS                      |j                   S )a  Semantically analyze a type.

        Args:
            typ: Type to analyze (if already analyzed, this is a no-op)
            allow_placeholder: If True, may return PlaceholderType if
                encountering an incomplete definition

        Return None only if some part of the type couldn't be bound *and* it
        referred to an incomplete namespace or definition. In this case also
        defer as needed. During a final iteration this won't return None;
        instead report an error if the type can't be analyzed and return
        AnyType.

        In case of other errors, report an error message and return AnyType.

        NOTE: The caller shouldn't defer even if this returns None or a
              placeholder type.
        c                4                         | d          S r  r  )r  rO  r  s    rP  r  z,SemanticAnalyzer.anal_type.<locals>.<lambda>-  s    d33D#t3TT rR  N)r0  rK  r)  r%  rX  rY  r(  r*  r'  rZ  r[  r  )	r   rV  rx  r"  r  r  r  r,  r-  )rO  r  r0  r)  rK  r%  rX  rY  r(  r*  r'  rZ  r[  r  r7  r{  r  s   ``               rP  r  zSemanticAnalyzer.anal_type	  s    F 'TTTTT
 
  	#TY 	#+=+E  """! 3 3/+I#&?%!51/Q)  
 
 ((**jjmm$$S)) 	4  000
rR  r)  c                *    t          j        |          S rT  )r   make_normalized)rO  r)  s     rP  rT  zSemanticAnalyzer.class_typeG  s    '	222rR  prioritypatchCallable[[], None]c                >    | j                             ||f           d S rT  )r!  r  )rO  rd  re  s      rP  r  zSemanticAnalyzer.schedule_patchJ  s#    Xu-.....rR  c                    t          d           | j        D ]\  }}t          d| d|            | j                            dddd           d S )NzDeferral trace:z    :r  zAINTERNAL ERROR: maximum semantic analysis iteration count reachedTr  )printrI  r8  rK  )rO  r8  r  s      rP  report_hangzSemanticAnalyzer.report_hangM  s~       4 	' 	'IC%%%t%%&&&&O	 	 	
 	
 	
 	
 	
rR  triggerr  c                    || j                                         }| j        j                            |t                                                    |           dS )zyAdd dependency from trigger to a target.

        If the target is not given explicitly, use the current target.
        N)rH  current_targetr#  plugin_depsr  rB  r  )rO  rl  r  s      rP  add_plugin_dependencyz&SemanticAnalyzer.add_plugin_dependencyX  sP    
 >Z..00F%00#%%@@DDVLLLLLrR  r-  Collection[str]c                    |sdS || j                                         }| j        j        |                             |           dS )zAdd full names of type aliases on which the current node depends.

        This is used by fine-grained incremental mode to re-check the corresponding nodes.
        If `target` is None, then the target node used will be the current scope.
        N)rH  rn  r#  
alias_depsupdate)rO  r-  r  s      rP  r,  z$SemanticAnalyzer.add_type_alias_depsa  sP      	 F>Z..00F$V,33LAAAAArR  c                4    t          |          dz   | j        v S Nr6  )r  r&  r  s     rP  r7  z"SemanticAnalyzer.is_mangled_globalq  s    ~~#t|33rR  c                .    |t          |          dz   k    S rv  )r  r  s     rP  r8  z*SemanticAnalyzer.is_initial_mangled_globalu  s    x~~+++rR  bool | Nonec                     t          |          S rT  )r   r  s     rP  r   zSemanticAnalyzer.parse_booly  s    $rR  c                    t          |t                    r|j        S t          |t                    r\t          |j        t
                    rB|j        j        6t          |j        j                  }|t          |          dk    r|d         S dS )zzAttempt to find the string literal value of the given expression. Returns `None` if no
        literal value can be found.Nr  r   )	r~  ry   rf  rq   r  r   rV  r   r  )rO  r  r  s      rP  parse_str_literalz"SemanticAnalyzer.parse_str_literal}  s     dG$$ 	:dG$$ 	!DIs)C)C 	!	Hb7	GGF!c&kkQ&6&6ay trR  module_namec                    |t           v r7| j        | j                 j                            t           |                    d S d S rT  )r  r%  r  future_import_flagsr  )rO  r|  s     rP  r0  z(SemanticAnalyzer.set_future_import_flags  sA    .((L)=AA.Q\B]^^^^^ )(rR  flagc                L    | j         | j                                     |          S rT  )r%  r  rc  )rO  r  s     rP  rc  z#SemanticAnalyzer.is_future_flag_set  s    |DO,??EEErR  rE   c                v   t                      }t          |j        |j                  D ]\  }}||dk    r|                     |          |_        )t          | ||          }|=|dk    r||_        K|dk    r||_        Y|dk    r||_	        g|dk    r||_
        u|                     d| d|           |S )	zqBuild a DataclassTransformSpec from the arguments passed to the given call to
        typing.dataclass_transform.Nfield_specifiers
eq_defaultorder_defaultkw_only_defaultfrozen_defaultz,Unrecognized dataclass_transform parameter "r@  )rE   rQ  rG  rd  *parse_dataclass_transform_field_specifiersr  r   r  r  r  r  r  )rO  r  
parametersr  rf  booleans         rP  r  z/SemanticAnalyzer.parse_dataclass_transform_spec  s    ,--
t~ty99 	X 	XKD% | ))).2.].]/ /
+ 3D%FFG|##(/
%%((+2
((***-4
**))),3
))		PPPPRVWWWWrR  r  c                "   t          |t                    s|                     d|           dS g }|j        D ]J}t          |t                    s|                     d|            dS |                    |j                   Kt          |          S )Nz3"field_specifiers" argument must be a tuple literalrA  z0"field_specifiers" must only contain identifiers)r~  r   r  r  rq   r  rr  r  )rO  r  rq  	specifiers       rP  r  z;SemanticAnalyzer.parse_dataclass_transform_field_specifiers  s    #y)) 	IIKSQQQ2 	- 	-Ii11 		LiXXXrrLL+,,,,U||rR  or\   c                   d S rT  rA  rO  r  s     rP  visit_int_exprzSemanticAnalyzer.visit_int_expr      trR  ry   c                   d S rT  rA  r  s     rP  visit_str_exprzSemanticAnalyzer.visit_str_expr  r  rR  r<   c                   d S rT  rA  r  s     rP  visit_bytes_exprz!SemanticAnalyzer.visit_bytes_expr  r  rR  rO   c                   d S rT  rA  r  s     rP  visit_float_exprz!SemanticAnalyzer.visit_float_expr  r  rR  rA   c                   d S rT  rA  r  s     rP  visit_complex_exprz#SemanticAnalyzer.visit_complex_expr  r  rR  rJ   c                   d S rT  rA  r  s     rP  visit_ellipsiszSemanticAnalyzer.visit_ellipsis  r  rR  r~   c                   d S rT  rA  r  s     rP  visit_temp_nodez SemanticAnalyzer.visit_temp_node  r  rR  rm   c                   d S rT  rA  r  s     rP  visit_pass_stmtz SemanticAnalyzer.visit_pass_stmt  r  rR  r   c                   d S rT  rA  r  s     rP  visit_singleton_patternz(SemanticAnalyzer.visit_singleton_pattern  r  rR  )r%  r$  r<  r6  r=  r6  r8  r   r9  r   r>  r?  )r>  r-  )r>  r  )r>  r`  )F)rf  r  rg  r  r>  r`  )rk  rc   r>  r?  )rk  rc   rv  rw  r>  r?  rT  )r  r  r!  r3  r_  r  rk  rc   r"  r   r  r-  r>  r?  )r  rc   r>  r?  )
r  rc   r  r  r  r  r  r  r>  r?  )r>  r?  )rk  rc   r"  r   r  r-  r>  r`  )r  rR   r>  r?  )rr  r  r>  r  )r  rR   r  r   r>  r   )rN  rR   r  r   r7  r  r>  r?  )r  r   r[  r  r>  r  )rf  rg  rh  ri  r>  r  )rm  r   r  rS   r>  r  )r  rj   r>  r?  )ra  r  r>  r`  )r  rL   r>  r  )r  rj   r>  r  )r  rj   r  r*  r  r  r>  r?  )r  rj   r>  r  )rN  r  r>  r?  )r  rS   r>  r?  )r  r   r>  r?  )r  rS   r>  r?  )r  rF   r>  r?  )r  r  r  rC   r>  r?  )r  r?   r>  r?  )r  r  r  rC   r>  r  )r  r  r>  r  )r  r   r  rC   r>  r"  )r  r  r>  r?  )rZ  rd  r>  r?  )r  r?   r[  rg  r>  r?  )r  r?   r>  r  )r  r?   r[  rg  r>  r  )r  rL   r>  r  )r  r   r>  r?  )r  r?   r  rL   r>  r?  )r  r?   r  r   r  rL   r>  r?  )r  r?   rB  rd  r  rC   r>  r  )r?  r   r>  r  )r  r   r>  r  )FF)r  r   r  r  r  r  r>  r  )r  r   r>  r   )rB  rd  r  r*  r>  r   )r  r   r  rC   r>  rg  )r  rd  r>  rg  r  )r  r?   r  r-  ry  r  r>  r?  )r  r?   r>  r   )rB  rd  r>  r  )r  r?   rZ  r  r>  r?  )r  r?   r?  r   r>  r   )r  r?   r  r  r>  r?  )r  r   r	  r   r>  r  )r  r  r  r  r>  r  )r  r?   r`  r  r>  r?  )r  rW   r>  r?  )r+  rZ   r>  r?  )r  r}   r5  r  r  r  r(  r  rr  r  r  r  r  rY   r>  r?  )T)r=  r  r>  r  r(  r  r  r  r  r  r  rf   r$  r  r>  r?  )
r(  r  rK  r}   rL  r}   rM  rY   r>  r  )r  rU  r>  r  )r  rX   r>  r?  )r	  r7   r>  r?  )r	  r7   r>  r  )r	  r8   r>  r?  )r	  r8   r>  r  )r  rL   r>  r  )r  rL   r  r  r>  r  )r  rL   r  r  r>  r  r  rL   r>  r  )r  rd  r>  rd  )rR  rL   r  r  r>  r  )FNNF)r  r  rR  rL   r%  r  r  r  r  r  rf  r  r>  r  )rR  rL   r  r  r>  r  )rR  r=   r>  r  )r	  r  r  r   r   rC   r>  r?  )FFFFFF)r  r`   r  r  r  r  r  r  r_  r  r`  r  r$  r  r>  r?  )rQ  re   r  r  r  r  r_  r  r`  r  r$  r  r>  r?  )r.  r  r  r  r>  r  )rQ  re   r.  r  r;  r  r`  r  r$  r  r>  r   )r  re   r  r  r  r  r>  r?  )r  r   r  r  r>  r?  )
r  rb   r  r  r  r  r`  r  r>  r?  )rK  rb   r>  r  )r  rM  r   rC   r>  r?  )rQ  r`   r  r   r>  r?  )r  r   r  rC   r>  r   )r  r=   r  r  r  rC   r>  r  )r	  r8   ri  rj  r>  rk  )rd  rd  rq  rm  rn  ro  rp  r  r  rC   r>  rq  )r  r  r}  r  r|  rL   r  rC   rK  r  r(  r  r*  r  r  r  r>  r  )r	  r8   r  r=   r>  r  )r  r  r  r   r  r  r>  r   )r  rd  r>  r  )r  r   r>  r  )r  r  r>  r  )r  rC   r>  r?  )r  r  r  rL   r   r8   r>  r?  )rt  r:   r>  r?  )rt  r  r>  r?  )r	  rM   r>  r?  )r	  rr   r>  r?  )r	  rp   r>  r?  )r	  r5   r>  r?  )r	  rh   r>  r?  )r	  r   r>  r?  )r	  rP   r>  r?  )r	  r;   r>  r?  )r	  rD   r>  r?  )r	  rV   r>  r?  )r	  r   r>  r?  )r	  r   r  r  r>  r?  )r	  r   r>  r?  )r	  rG   r>  r?  )r	  rL   r>  r  )r  rU   r>  r?  )r  rg   r>  r?  )r	  ra   r>  r?  )r	  r   r>  r?  )r  re   r>  r?  )r  re   re  r}   r>  r?  )r  rz   r>  r?  )r  r   r>  r?  )r  r_   r>  r?  )r  ru   r>  r?  )r  rH   r>  r?  )r  rw   r>  r?  )r  r   r>  r?  )r  r=   r>  r?  )r  r=   r>  r*  )r  r=   r.  r  r  r  r>  r  )r  rb   r>  r?  )r  ri   r>  r?  )r  r@   r>  r?  )r  r   r>  r?  )r  r[   r>  r?  )r  r[   r>  rM  )r  rv   r>  r?  )r  r>   r>  r?  )r  r6   r>  r?  )r  rs   r>  r?  )r  r   r>  r?  )r  r^   r>  r?  )r  rt   r>  r?  )r  rI   r>  r?  )r  rT   r>  r?  )r  rz  r>  r?  )r  r]   r>  r?  )r  rB   r>  r?  )r  ro   r>  r?  )r  r   r>  r?  )r  r9   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )rt  r   r>  r?  )r  r  r   rC   r^  r  r>  r  )r  r  r>  r  )r  r{   r>  r  )r  r{   r:  rx   r>  r  )rr  r  r>  r  )r  rL   r>  r  )r  rc   r  r  r>  r  )r6  r  r>  r  )
re  r}   r  r  r  r  r  r   r>  r}   )r  r}   r  r  rr  r  r>  r  )rr  r  r>  r}   )rr  r  r>  r  )r>  r   )rr  r  rd  rM  r>  r   )rr  r  rd  rM  r>  r  )r  r  r>  r   )r  r  r>  r  )TFTFFF)r  r  r  r{   r  rC   r  r  r  r  r9  r  r_  r  r  r  r  r  r>  r  )r  r  r  r{   r>  r?  )NTFFF)r  r  r)  r}   r  r  r9  r  r_  r  r  r  r  r  r>  r  )rq  r|   r  r  r)  r}   r>  r?  )r  r  r  rC   r>  r?  )r  r  r  r  r  rC   r>  r  )r  r  r  r}   r  rY   r  r  r  r  r>  r?  )r  r  r  rC   r  r  r  r  r  r  r>  r?  )r  r   r>  r`  )r  r  r  r  r>  r?  )r>  r  )r  r  r>  r  )FTF)r  r  r  rf   r8  r  r  r  r  r  r>  r?  )rr  r  r>  r  )
r  r  r.  r  r   rC   r  r  r>  r?  )r  r  r.  r  r   rC   r>  r?  )r  r  r>  r  )r  r  r>  r`  )r>  r  )r_  r  r  r  r>  r|   )r(  r)  r>  r?  )r  r  r   rC   r  r  r>  r?  )
r  r  r   rC   r5  r6  r7  r  r>  r?  )r  r  r   rC   r5  r6  r>  r?  )rD  rH  r   rC   rf  r  r  rI  r  r  r>  r?  )rD  r  r   rC   r  rI  r>  r?  )rN  r  r   rC   r>  r  )r  rf   r>  r?  )TFFFFF)r  rL   r'  r  r%  r  r  r  rK  r  r(  r  r*  r  r>  r  )r  rL   r>  r?  )r0  r\  r)  r  rK  r  r%  r  rX  r  rY  r  r(  r  r*  r  r'  r  rZ  r  r[  r  r  r  r>  r   )r  rL   r*  r  r>  r   )r  r   r0  r\  r)  r  rK  r  r%  r  rX  r  rY  r  r(  r  r*  r  r'  r  rZ  r  r[  r  r  r  r>  r  )r)  r   r>  r   )rd  r  re  rf  r>  r?  )rl  r  r  r  r>  r?  )r-  rq  r  r  r>  r?  )r  rL   r>  rx  )r|  r  r>  r?  )r  r  r>  r  )r  r=   r>  rE   )r  rL   r>  rj  )r  r\   r>  r?  )r  ry   r>  r?  )r  r<   r>  r?  )r  rO   r>  r?  )r  rA   r>  r?  )r  rJ   r>  r?  )r  r~   r>  r?  )r  rm   r>  r?  )r  r   r>  r?  (E  __name__r  r  r  r  r  r.  r  r  r  r^  r  rX  r[  r:  r;  rQ  r  rV  rY  r\  r_  r   re  rj  ru  rt  rs  r  r  r  r  r  r  r  r  r  r  r
  r(  r  rW  rl  r  rx  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r/  r0  r!  r.  r  r  r  r  r  r  r  r  rG  rM  rN  rA  rX  rL  rO  rv  r  rH  r  r  rW  r{  rF  r  r  r  r  r  r  r  rP  r  r  rI  rT  r  r  r  r  rE  r  r  r  rJ  rU  r*  r:  r3  r4  rT  r   r]  rd  ra  r  rj  rm  r  rk  rl  r  r  rx  rw  rt  ru  r  r{  r  ry  r|  r}  r  r  r  r  r  r  ro  r  r   r  rb  r'  r1  r-  r0  r2  r)  r(  r  rB  r  rq  r0  r1  r2  r  rV  rY  ry  rW  rr  rs  r  rX  r~  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   r@  r  r  r  r  r  r  r  r)  r%  r$  r8  r=  rA  rD  rI  rH  rL  r_  rc  rf  rh  rj  ro  rr  rv  ry  rt  ru  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  rb  r  r2  r  r  r2  r  r  r/  r  r  r  r  r  r  r  r  r  r  r  r#  r$  r  r  r  r  r  r  rB  r  r  r  r  r  r  r  r  r1  r  r/  r  rA  r  r  rH  r9  rG  r  r  rQ  r  r  r  r"  r   r  rT  r  rk  rp  r,  r7  r8  r   r{  r0  rc  r  r  r  r  r  r  r  r  r  r  r  rA  rR  rP  r   r   X  s          ;::M !       """"$$$$!E!!!!%%%%     #"""
 HHJ  "!!!1111JM" NNNNNN"&I&&&& 687777O@ O@ O@ O@f    X " " " X" + + + X+ % % % X% + + + ^+ 16Q Q Q Q ^Q,	P 	P 	P 	P   >$= $= $= $=b (,    0   *C C C CJ> > > >*> > > >(% % % %B, , , , TX3 3 3 3 ^3r, , , ,:: : : :
r+ r+ r+ r+hN N N N.+C +C +C +CZ   B   .! ! ! !.
 
 
 
:3 3 3 3 . . . ^.L) L) L) L)\   :    \, , , , +1 +1 +1 +1Z       B   4! ! ! !&. . . .>4  4  4  4 l/ / / /1 1 1 1& & & &:   
S 
S 
S 
SbR bR bR bRHH H H H) ) ) )   ,   N N N N`   ^1 ^1 ^1 ^1@   " " " "K K K K"S S S S      *       D!< !< !< !<F       ) ) ) )! ! ! !` ` ` `S S S SX7 X7 X7 X7t$ $ $ $L    UZ$ $ $ $ $4& & & &
" " " "    (   0 RW,M ,M ,M ,M ,M\    
 
 
 
0 0 0 0d=9 =9 =9 =9~% % % %,   
3 3 3 3 IMD D D D D,/% /% /% /%b         ;0 ;0 ;0 ;0z@ @ @ @,( ( ( (TW W W Wr,
 ,
 ,
 ,
l -1? ? ? ? ?B   @      <[ [ [ [   ,S! S! S! S!j' ' ' 'R   :    .   ,3 3 3 35 5 5 5 5n   2
1 
1 
1 
1R R R R) ) ) )V   @J J J J   2"@ "@ "@ "@H? ? ? ?B   *92 92 92 92v   ): ): ): ):V
 
 
 
   D #(59;?',FW FW FW FW FWP   P P P Pd    H7 H7 H7 H7T       @ #&+#("09 09 09 09 09dMY MY MY MY^   I I I I,   88 8 8 86    (>4 >4 >4 >4@6 6 6 6C C C C   BV V V Vp      &      &   $E. E. E. E.\ %**/"+/. . . . . .`   B B B BH= = = =~   .   ./ / / /@6 6 6 65 5 5 5H H H HF4 F4 F4 F4P	- 	- 	- 	-3 3 3 3.9) 9) 9) 9)~" " " "                 % % % %   
- 
- 
- 
-, , , ,, , , ,2O O O OR R R R, , , ,' ' ' '+ + + +0! 0! 0! 0!d2 2 2 2   , , , ,2 2 2 2:	* 	* 	* 	*o, o, o, o,j) ) ) )
/ / / /               # # # #       "M` M` M` M`^   (    ,' ,' ,' ,'\       "! ! ! !   $ $ $ $$ [  [  [  [DI I I IV% % % %! ! ! !! ! ! !   ) ) ) )$ $ $ $$ $ $ $	& 	& 	& 	&& & & &" " " " ' ' ' '- - - -
$ $ $ $
! ! ! !       $   &( ( ( (! ! ! !   ! ! ! !+ + + +( ( ( (    @EC C C C CJ% % % %N
 
 
 

! ! ! !&/ / / /   H H H H @E5 5 5 5 5n      :. . . .* * * *"   2   
1 1 1 1f2 2 2 2/ / / /\ \ \ \ \[ [ [ [ [5 5 5 5* * * *" ##&+! "
 "
 "
 "
 "
H   4 #'&+! > > > > >@   >- - - -( ( ( (T: : : :>%
 %
 %
 %
V $ $ $ ^$D D D D D8( ( ( (/ / / /& & & & "'"#") ") ") ") ")H6 6 6 6 QV; ; ; ; ; P P P P0 0 0 0 % % % ^%2? ? ? ?U U U UB B B BC C C C    GL% % % % %N
 
 
 

3 3 3 3(: (: (: (: (:T
 
 
 
4 \`C C C C C \`H H H H H
J J J J   < 	
 "&
 
 
 
 
 
6R R R R R
   _ _ _ _ &*"'$$)*/"(
 (
 (
 (
 (
T    /3$)$)"'/4!*/"%))-9=$' ' ' ' ' 'R
 
 
 
 
 /3$)$)"'/4!*/"%))-9=$< < < < < <|3 3 3 3/ / / /	
 	
 	
 	
M M M M M CGB B B B B 4 4 4 4, , , ,       	 	 	 	_ _ _ _F F F F! ! ! !F                                rR  r   Nr  r   rh  r   r>  c                   t          | t                    rAt          | j                  dk    r| S |                     g| j        dd          z             S t          | t
                    r t          fd| j        D                       S J )Nr   r  r=  c           	     V    g | ]%}t          t          t          |                    &S rA  )r   r   rU  )rC  r  rh  s     rP  rD  z/replace_implicit_first_type.<locals>.<listcomp>  s.    XXXT, ;As C CDDXXXrR  )r~  r   r  r>  r  r   r  )r  rh  s    `rP  rU  rU    s    #|$$ 	s}""J  C53=3D+D EEE	C	$	$ XXXXciXXX
 
 	
 	rR  r  rL   	fullnamesstr | tuple[str, ...]r  c                    t          |t                    s|f}t          | t                    sdS | j        |v rdS t          | j        t
                    rt          | j        j        |          S dS )z=Is node a name or member expression with the given full name?FT)r~  r  rq   rr  r  r   r   r  )r  r  s     rP  r  r    sr    i'' !L	dG$$ u}	!!t$)Y'' > !19===5rR  c                z    t          | t                    o&t          | j        t          t          t
          f          S )z1Does semantically analyzed node refer to a class?)r~  rq   r  r   rR   rj   )r  s    rP  rG  rG    s4    dG$$ 	Hg'89* * rR  r*  list[T]T | Nonec                ~    t          dt          |                     D ]}| |         | d|         v r
| |         c S dS )z[If the list has duplicates, return one of the duplicates.

    Otherwise, return None.
    r  N)r  r  )r*  r  s     rP  r  r    sQ    
 1c$ii    7d2A2h7NNN 4rR  rq  r|   r6  r  r?  c                    g }|                                  D ]Q\  }}|j        |j        j        }|d|                    d                   }||k    r|                    |           R|D ]}| |= dS )z<Remove all imported names from the symbol table of a module.Nr|  )r  r  rr  rfindr  )rq  r6  r  r  r  rr  r  s          rP  #remove_imported_names_from_symtabler  	  s    Gkkmm ! !
d99%/HNN3///0VNN4     $KK rR  r  c                D    |                      t                                S )zSReplace all Any types within in with Any that has attribute 'explicit' set to False)r  MakeAnyNonExplicitr  s    rP  r  r    s    88&(()))rR  c                      e Zd Zd	dZd
dZdS )r  r  r   r>  r   c                n    |j         t          j        k    r|                    t          j                  S |S rT  )type_of_anyr   r  r  r  rO  r  s     rP  	visit_anyzMakeAnyNonExplicit.visit_any  s,    =I...??9#9:::rR  r   c                R     |                      fd|j        D                       S )Nc                :    g | ]}|                               S rA  r  rC  r{  rO  s     rP  rD  z<MakeAnyNonExplicit.visit_type_alias_type.<locals>.<listcomp>#  #    $D$D$DQXXd^^$D$D$DrR  rd  r  rd  r  s   ` rP  visit_type_alias_typez(MakeAnyNonExplicit.visit_type_alias_type"  .    $D$D$D$DQV$D$D$DEEErR  Nr  r   r>  r   r  r   r>  r   r  r  r  r  r  rA  rR  rP  r  r    B           
F F F F F FrR  r  c                D    |                      t                                S )zLReplace all Any types that come from unimported types with special form Any.)r  MakeAnyNonUnimportedr  s    rP  r  r  &  s    88(**+++rR  c                      e Zd Zd	dZd
dZdS )r  r  r   r>  r   c                r    |j         t          j        k    r!|                    t          j        d           S |S )Nr  )r  r   r  r  r  r  s     rP  r  zMakeAnyNonUnimported.visit_any,  s0    =I:::??9#9t?TTTrR  r   c                R     |                      fd|j        D                       S )Nc                :    g | ]}|                               S rA  r  r  s     rP  rD  z>MakeAnyNonUnimported.visit_type_alias_type.<locals>.<listcomp>2  r  rR  r  r  r  s   ` rP  r  z*MakeAnyNonUnimported.visit_type_alias_type1  r  rR  Nr  r  r  rA  rR  rP  r  r  +  r  rR  r  r!  r3  c                N    t          | d           }|D ]\  }} |             dS )zeCall patch callbacks in the right order.

    This should happen after semantic analyzer pass 3.
    c                    | d         S )Nr   rA  r  s    rP  r  z1apply_semantic_analyzer_patches.<locals>.<lambda>:  s
    ! rR  )r  N)ry  )r!  patches_by_priorityrd  
patch_funcs       rP  apply_semantic_analyzer_patchesr  5  sD    
 !nn=== 3  *
 rR  r	  r8   list[NameExpr]c                B    g }| j         D ]}|t          |          z  }|S )zLReturn all unqualified (short) names assigned to in an assignment statement.)r  names_modified_in_lvalue)r	  r9  rQ  s      rP  rn  rn  ?  s2    F) 3 3*6222MrR  rQ  r`   c                    t          | t                    r| gS t          | t                    rt          | j                  S t          | t
          t          f          r g }| j        D ]}|t          |          z  }|S g S )z4Return all NameExpr assignment targets in an Lvalue.)r~  re   rw   r  r  r_   r   r  )rQ  r9  ra  s      rP  r  r  G  s    &(## x	FH	%	% '444	FXy1	2	2 !#L 	5 	5D.t444FFIrR  n1r  n2c                    t          | t                    o2| j        o+t          |t                    o|j        o| j        |j        k    S )zIDo n1 and n2 refer to the same Var derived from module-level __getattr__?)r~  r   r  rr  )r  r  s     rP  is_same_var_from_getattrr  U  sS     	2s 	'"	'r3	' "	' K2;&rR  rC   c                 N    t          t          t          j                            S rT  )r~   r   r   r  rA  rR  rP  r  r  `  s    GI233444rR  rd  r}   c                    t          | j        t                    r5t          |j        t                    r| j        j         o|j        j        S dS dS )zCan symbol table node replace an existing one?

    These are the only valid cases:

    1. Placeholder gets replaced with a non-placeholder
    2. Placeholder that isn't known to become type replaced with a
       placeholder that can become a type
    TF)r~  r  rn   r8  )rd  rh  s     rP  r  r  d  sN     #(O,, ch00 	x00NSX5NN45rR  r{  rt  c                    | |k    p9t          | t                    ot          |t                    pt          | |          S rT  )r~  rn   r  )r{  rt  s     rP  r  r  u  sA    	Q 	*q/**Mz!_/M/M	*#Aq))rR  blockr:   c                P   | j         }|sdS t          |d         t                    r/t          |d         j        t                    r| j         dd         }t          |          dk    rdS t          |          dk    rdS |d         }t          |t                    rG|j        }|dS t          |t                    r|j        }t          |t                    o
|j
        dk    S t          |t                    p.t          |t                    ot          |j        t                    S )aY  Returns 'true' if the given body is "trivial" -- if it contains just a "pass",
    "..." (ellipsis), or "raise NotImplementedError()". A trivial body may also
    start with a statement containing just a string (e.g. a docstring).

    Note: Functions that raise other kinds of exceptions do not count as
    "trivial". We use this function to help us determine when it's ok to
    relax certain checks on body, but functions that raise arbitrary exceptions
    are more likely to do non-trivial work. For example:

       def halt(self, reason: str = ...) -> NoReturn:
           raise MyCustomError("Fatal error: " + reason, self.line, self.context)

    A function that raises just NotImplementedError is much less likely to be
    this complex.

    Note: If you update this, you may also need to update
    mypy.fastparse.is_possible_trivial_body!
    Fr   r  NTzbuiltins.NotImplementedError)r  r~  rM   r  ry   r  rp   r=   r  re   rr  rm   rJ   )r  r  r  r  s       rP  r4  r4  }  s   & :D  u $q'>** z$q',/P/P z!""~
4yyA~~t	TQu7D$	"" ^y<5dH%% 	;D$))]dm?].]]dH%% 4((PZ	<-P-PrR  )r  r   rh  r   r>  r   )r  rL   r  r  r>  r  r  )r*  r  r>  r  )rq  r|   r6  r  r>  r?  )r  r   r>  r   )r!  r3  r>  r?  )r	  r8   r>  r  )rQ  r`   r>  r  )r  r  r  r  r>  r  )r>  rC   )rd  r}   rh  r}   r>  r  )r{  r  rt  r  r>  r  )r  r:   r>  r  (D  r  
__future__r   collections.abcr   r   r   
contextlibr   ro  r   r	   r
   r   r   rp  r   r  r   mypyr   r&  r   mypy.constant_foldr   mypy.errorcodesr   r   mypy.errorsr   r   mypy.exprtotyper   r   mypy.message_registryr   mypy.messagesr   r   r   r   r   mypy.mror   r   
mypy.nodesr    r!   r"   r#   r$   r%   r&   r'   r(   r)   r*   r+   r,   r-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rC   rD   rE   rF   rG   rH   rI   rJ   rK   rL   rM   rN   rO   rP   rQ   rR   rS   rT   rU   rV   rW   rX   rY   rZ   r[   r\   r]   r^   r_   r`   ra   rb   rc   rd   re   rf   rg   rh   ri   rj   rk   rl   rm   rn   ro   rp   rq   rr   rs   rt   ru   rv   rw   rx   ry   rz   r{   r|   r}   r~   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   mypy.optionsr   mypy.patternsr   r   r   r   r   r   r   r   mypy.pluginr   r   r   r   mypy.pluginsr   r  mypy.reachabilityr   r   r   r   r   r   r   
mypy.scoper   mypy.semanal_enumr   mypy.semanal_namedtupler   mypy.semanal_newtyper   mypy.semanal_sharedr   r   r   r   r   r   r   r   r   mypy.semanal_typeddictr   mypy.tvar_scoper   mypy.typeanalr   r   r   r   r   r   r   r   r   r   r   r   r   r   mypy.typeopsr   r   r   
mypy.typesr   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   mypy.types_utilsr   r   mypy.typevarsr   	mypy.utilr   r   r  r  r  mypy.visitorr  r  r  r  r  r  r  r  r  r  r  r  r   rU  r  rG  r  r  r  r  r  r  r  rn  r  r  r  r  r  r4  rA  rR  rP  <module>r     s  0 0 0d # " " " " " : : : : : : : : : : % % % % % % 6 6 6 6 6 6 6 6 6 6 6 6 6 6 @ @ @ @ @ @ @ @ 6 6 6 6 6 6 6 6 1 1 1 1 1 1 9 9 9 9 9 9 9 9 5 5 5 5 5 5 5 5 I I I I I I I I . . . . . .              - , , , , , , ,y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y yt !          	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	            ; : : : : :                        . . . . . . 6 6 6 6 6 6 0 0 0 0 0 0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 5 4 4 4 4 4 , , , , , ,                                 Z Y Y Y Y Y Y Y Y Y1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1d M L L L L L L L ' ' ' ' ' ' c c c c c c c c c c c c c c $ $ $ $ $ $GCLL !0)%"3!1!1#5!1!1+       =<<  < < < <         
                   Ar Ar Ar Ar Ar02QAr Ar ArHd
 
 
 
            * * * *
F F F F F7 F F F, , , ,
F F F F F9 F F F            5 5 5 5   "   0 0 0 0 0 0rR  