Module python

Holds if the Container c should be the preferred file or folder for the given name when performing imports. Trivially true for any container if it is the only one with its name. However, if there are several modules with the same name, then this is the module most likely to be imported under that name.

the Python major version number

the Python micro version number

the Python minor version number

Gets the name of the module that c resolves to, if any.

Holds if n is a named constant (True, False, or None) with name id.

An add (+) binary operator

INTERNAL: See the class Add for further information.

An alias in an import statement, the mod as name part of import mod as name. May be artificial; import x is transformed into import x as x

A list of aliases in an import statement

INTERNAL: See the class AliasList for further information.

INTERNAL: See the class Alias for further information.

An and boolean operator

INTERNAL: See the class And for further information.

An annotated assignment statement, such as x: int = 0

INTERNAL: See the class AnnAssign for further information.

An annotation, such as the int part of x: int

A use of a variable as an argument, foo(v), which might modify the object referred to.

The default values and annotations (type hints) for the arguments in a function definition.

The parent of an Arguments node. Internal implementation class

INTERNAL: See the class ArgumentsParent for further information.

INTERNAL: See the class Arguments for further information.

An assert statement, such as assert a == b, "A is not equal to b"

INTERNAL: See the class Assert for further information.

A statement that includes a binding (except imports)

An assignment expression, such as x := y

INTERNAL: See the class AssignExpr for further information.

An assignment statement

INTERNAL: See the class Assign for further information.

An assignment to a variable v = val

A control flow node corresponding to an assignment expression such as lhs := rhs.

A syntactic node (Class, Function, Module, Expr, Stmt or Comprehension) corresponding to a flow node

INTERNAL: See the class AstNode for further information.

An asynchronous for statement, such as async for varname in Expr: ...

An asynchronous with statement, such as async with varname as Expr: ...

A control flow corresponding to an attribute expression, such as value.attr

An attribute expression, such as value.attr

An assignment of an attribute obj.attr = val

INTERNAL: See the class Attribute for further information.

An augmented assignment statement, such as x += y

INTERNAL: See the class AugAssign for further information.

The context of an augmented load. This is an artifact of the Python grammar which includes an AugLoad context, even though it is never used.

INTERNAL: See the class AugLoad for further information.

The augmented store context, the context of var in var += 1

INTERNAL: See the class AugStore for further information.

An await expression such as await coro.

INTERNAL: See the class Await for further information.

A basic block (ignoring exceptional flow edges to scope exit)

A binary expression, such as x + y

A control flow node corresponding to a binary expression, such as x + y

INTERNAL: See the class BinaryExpr for further information.

A bitwise and (&) binary operator

INTERNAL: See the class BitAnd for further information.

A bitwise or (|) binary operator

INTERNAL: See the class BitOr for further information.

A bitwise exclusive-or (^) binary operator

INTERNAL: See the class BitXor for further information.

A boolean shortcut (and/or) operation

A control flow node corresponding to a boolean shortcut (and/or) operation

INTERNAL: See the class BoolExpr for further information.

INTERNAL: See the class BoolParent for further information.

A boolean named constant, either True or False

A short circuit boolean operator, and/or

INTERNAL: See the class Boolop for further information.

A break statement

INTERNAL: See the class Break for further information.

A bytes constant, such as b'ascii'. Note that unadorned string constants such as "hello" are treated as Bytes for Python2, but Unicode for Python3.

INTERNAL: See the class BytesOrStr for further information.

INTERNAL: See the class Bytes for further information.

A call expression, such as func(...)

A control flow node corresponding to a call expression, such as func(...)

INTERNAL: See the class Call for further information.

An expression that generates a callable object, either a function expression or a lambda

An implicit (possible) definition of an escaping variable at a call-site

A case statement

INTERNAL: See the class Case for further information.

The scope of a class. This is the scope of all the statements within the class definition

A class statement. Note that ClassDef extends Assign as a class definition binds the newly created class

An (artificial) expression corresponding to a class definition. It is recommended to use ClassDef instead.

INTERNAL: See the class ClassExpr for further information.

INTERNAL: See the class Class for further information.

A comparison operator

A list of comparison operators in a comparison

INTERNAL: See the class CmpopList for further information.

INTERNAL: See the class Cmpop for further information.

A source code comment

A block of consecutive comments

The base class for list, set and dictionary comprehensions, and generator expressions.

A comparison operation, such as x<y

A control flow node corresponding to a comparison operation, such as x<y

INTERNAL: See the class Compare for further information.

A comprehension part, the ‘for a in seq’ part of [ a * a for a in seq ]

A list of Comprehensions (for generating parts of a set, list or dictionary comprehension)

INTERNAL: See the class ComprehensionList for further information.

INTERNAL: See the class Comprehension for further information.

A basic block which terminates in a condition, splitting the subsequent control flow

A container is an abstract representation of a file system object that can hold elements of interest.

A continue statement

INTERNAL: See the class Continue for further information.

A control flow node. Control flow nodes have a many-to-one relation with syntactic nodes, although most syntactic nodes have only one corresponding control flow node. Edges between control flow nodes include exceptional as well as normal control flow.

A control flow node corresponding to a definition, that is a control flow node where a value is assigned to this node. Includes control flow nodes for the targets of assignments, simple or augmented, and nodes implicitly assigned in class and function definitions and imports.

The delete context, the context of var in del var

INTERNAL: See the class Del for further information.

A delete statement, such as del x[-1]

INTERNAL: See the class Delete for further information.

A deletion of a variable del v

A control flow node corresponding to a deletion statement, such as del x. There can be multiple DeletionNodes for each Delete such that each target has own DeletionNode. The CFG for del a, x.y looks like: NameNode('a') -> DeletionNode -> NameNode('b') -> AttrNode('y') -> DeletionNode.

A dictionary expression, such as {'key':'value'}

A dictionary comprehension, such as { k:v for k, v in enumerate("0123456789") }

INTERNAL: See the class DictComp for further information.

INTERNAL: See the class DictItemListParent for further information.

INTERNAL: See the class DictItemList for further information.

INTERNAL: See the class DictItem for further information.

A control flow node corresponding to a dictionary literal, such as { 'a': 1, 'b': 2 }

A double-starred expression in a call or dict literal.

INTERNAL: See the class DictUnpacking for further information.

INTERNAL: See the class Dict for further information.

An (true) divide (/) binary operator

INTERNAL: See the class Div for further information.

An ellipsis expression, such as ...

INTERNAL: See the class Ellipsis for further information.

An encoding error. Note that if there is an encoding error in a module, much information about that module will be lost

An equals (==) comparison operator

INTERNAL: See the class Eq for further information.

A deletion of an attribute del obj.attr.

A definition of an extended-SSA (ESSA) variable. There is exactly one definition for each variable, and exactly one variable for each definition.

An ESSA definition corresponding to an edge refinement of the underlying variable. For example, the edges leaving a test on a variable both represent refinements of that variable. On one edge the test is true, on the other it is false.

A definition of an ESSA variable that is not directly linked to another ESSA variable.

A definition of an ESSA variable that takes another ESSA variable as an input.

An (enhanced) SSA variable derived from SsaSourceVariable.

The ControlFlowNode for an ‘except’ statement.

The ControlFlowNode for an ‘except*’ statement.

An except group statement (part of a try statement), such as except* IOError as err:

INTERNAL: See the class ExceptGroupStmt for further information.

An except statement (part of a try statement), such as except IOError as err:

INTERNAL: See the class ExceptStmt for further information.

A capture of a raised exception except ExceptionType as ex:

A capture of a raised exception group except* ExceptionType as ex:

An exception handler such as an except or an except* statement in a try statement.

An exec statement

INTERNAL: See the class Exec for further information.

An expression

A context in which an expression used

The parent of an ExprContext. Internal implementation class

INTERNAL: See the class ExprContextParent for further information.

INTERNAL: See the class ExprContext for further information.

A list of expressions

The parent of an ExprList. Internal implementation class

INTERNAL: See the class ExprListParent for further information.

INTERNAL: See the class ExprList for further information.

INTERNAL: See the class ExprOrStmt for further information.

The parent of an Expr. Internal implementation class

INTERNAL: See the class ExprParent for further information.

An expression statement, such as len(x) or yield y

INTERNAL: See the class ExprStmt for further information.

INTERNAL: See the class Expr for further information.

The boolean named constant False

A local variable that uses “load fast” semantics, for lookup: If the variable is undefined, then raise an exception.

A function that uses ‘fast’ locals, stored in the frame not in a dictionary.

A file

INTERNAL: See the class Filter for further information.

A floating point numeric constant, such as 0.4 or 4e3

An floor divide (//) binary operator

INTERNAL: See the class FloorDiv for further information.

A folder (directory)

A for statement, such as for x in y: print(x)

A flow node for a for statement.

INTERNAL: See the class For for further information.

A formatted value (within a formatted string literal). For example, in the string f'hello {world!s}' the formatted value is world!s.

INTERNAL: See the class FormattedValue for further information.

A formatted string literal expression, such as f'hello {world!s}'

INTERNAL: See the class Fstring for further information.

A function, independent of defaults and binding. It is the syntactic entity that is compiled to a code object.

A def statement. Note that FunctionDef extends Assign as a function definition binds the newly created function

An (artificial) expression corresponding to a function definition.

INTERNAL: See the class FunctionExpr for further information.

The parent of a Function. Internal implementation class

INTERNAL: See the class FunctionParent for further information.

INTERNAL: See the class Function for further information.

A generator expression, such as (var for var in iterable)

INTERNAL: See the class GeneratorExp for further information.

A global statement, such as global var

An SSA variable that is backed by a global variable

A global (module-level) variable

INTERNAL: See the class Global for further information.

A greater than (>) comparison operator

A greater than or equals (>=) comparison operator

INTERNAL: See the class GtE for further information.

INTERNAL: See the class Gt for further information.

A guard in a case statement

INTERNAL: See the class Guard for further information.

An if statement, such as if eggs: print("spam")

A conditional expression such as, body if test else orelse

INTERNAL: See the class IfExp for further information.

A control flow node corresponding to a conditional expression such as, body if test else orelse

INTERNAL: See the class If for further information.

An imaginary numeric constant, such as 3j

An immutable literal expression (except tuples). Consists of string (both unicode and byte) literals and numeric literals.

An implicit definition of the names of sub-modules in a package. Although the interpreter does not pre-define these names, merely populating them as they are imported, this is a good approximation for static analysis.

An import statement

An artificial expression representing an import

A control flow node corresponding to an artificial expression representing an import

INTERNAL: See the class ImportExpr for further information.

A from ... import ... expression

A control flow node corresponding to a from ... import ... expression

INTERNAL: See the class ImportMember for further information.

An import * statement

A control flow node corresponding to a from ... import * statement

A possible redefinition of variable via from ... import *

INTERNAL: See the class ImportStar for further information.

INTERNAL: See the class Import for further information.

A statement that imports a module. This can be any statement that includes the import keyword, such as import sys, from sys import version or from sys import *.

An in comparison operator

INTERNAL: See the class In for further information.

An integer numeric constant, such as 7 or 0x9

An invert (~) unary operator

INTERNAL: See the class Invert for further information.

An is comparison operator

An is not comparison operator

INTERNAL: See the class IsNot for further information.

INTERNAL: See the class Is for further information.

A control flow node corresponding to an iterable literal. Currently does not include dictionaries, use DictNode directly instead.

An (implicitly) concatenated list of template strings.

INTERNAL: See the class JoinedTemplateString for further information.

INTERNAL: See the class KeyValuePair for further information.

A keyword argument in a call. For example arg=expr in foo(0, arg=expr)

INTERNAL: See the class Keyword for further information.

A left shift (<<) binary operator

INTERNAL: See the class LShift for further information.

A lambda expression, such as lambda x: x+1

INTERNAL: See the class Lambda for further information.

A non-empty line in the source code

A list expression, such as [ 1, 3, 5, 7, 9 ]

A list comprehension, such as [ chr(x) for x in range(ord('A'), ord('Z')+1) ]

INTERNAL: See the class ListComp for further information.

A control flow node corresponding to a list expression, such as [ 1, 3, 5, 7, 9 ]

INTERNAL: See the class List for further information.

The load context, the context of var in len(var)

INTERNAL: See the class Load for further information.

A local (function or class) variable

INTERNAL: See the class LocationParent for further information.

A less than (<) comparison operator

A less than or equals (<=) comparison operator

INTERNAL: See the class LtE for further information.

INTERNAL: See the class Lt for further information.

A matrix multiplication (@) binary operator

INTERNAL: See the class MatMult for further information.

An as-pattern in a match statement: <subpattern> as alias

INTERNAL: See the class MatchAsPattern for further information.

A capture pattern in a match statement: var

INTERNAL: See the class MatchCapturePattern for further information.

A class pattern in a match statement: Circle(radius = 3)

INTERNAL: See the class MatchClassPattern for further information.

A double star pattern in a match statement: {..., **}

INTERNAL: See the class MatchDoubleStarPattern for further information.

A key-value pattern inside a mapping pattern: a: var

INTERNAL: See the class MatchKeyValuePattern for further information.

A keyword pattern inside a class pattern: radius = 3

INTERNAL: See the class MatchKeywordPattern for further information.

A literal pattern in a match statement: 42

INTERNAL: See the class MatchLiteralPattern for further information.

A mapping pattern in a match statement: {'a': var}

INTERNAL: See the class MatchMappingPattern for further information.

An or-pattern in a match statement: (<pattern1>|<pattern2>)

INTERNAL: See the class MatchOrPattern for further information.

A sequence pattern in a match statement <p1>, <p2>

INTERNAL: See the class MatchSequencePattern for further information.

A star pattern in a match statement: (..., *)

INTERNAL: See the class MatchStarPattern for further information.

A match statement

INTERNAL: See the class MatchStmt for further information.

A value pattern in a match statement: Http.OK

INTERNAL: See the class MatchValuePattern for further information.

A wildcard pattern in a match statement: _

INTERNAL: See the class MatchWildcardPattern for further information.

An implicit (possible) modification of the object referred at a method call

A modulo (%) binary operator, which includes string formatting

INTERNAL: See the class Mod for further information.

A module. This is the top level element in an AST, corresponding to a source file. It is also a Scope; the scope of global variables.

INTERNAL: See the class Module for further information.

A multiplication (*) binary operator

INTERNAL: See the class Mult for further information.

An assignment to a variable as part of a multiple assignment ..., v, ... = val

A (plain variable) name expression, such as var. None, True and False are excluded.

A named constant, one of None, True or False

A control flow node corresponding to a named constant, one of None, True or False.

A local variable that uses “load name” semantics, for lookup: If the variable is undefined, then lookup the value in globals().

A control flow node corresponding to a (plain variable) name expression, such as var. None, True and False are excluded.

INTERNAL: See the class Name for further information.

The None constant.

A nonlocal statement, such as nonlocal var

INTERNAL: See the class Nonlocal for further information.

A not unary operator

A not equals (!=) comparison operator

INTERNAL: See the class NotEq for further information.

An not in comparison operator

INTERNAL: See the class NotIn for further information.

INTERNAL: See the class Not for further information.

A numerical constant expression, such as 7 or 4.2

INTERNAL: See the class Num for further information.

The base class for operators

INTERNAL: See the class Operator for further information.

An or boolean operator

INTERNAL: See the class Or for further information.

The parameter context, the context of var in def f(var): pass

A param spec parameter, such as **T1 in type T[**T1] = T2.

INTERNAL: See the class ParamSpec for further information.

INTERNAL: See the class Param for further information.

A parameter. Either a Tuple or a Name (always a Name for Python 3)

A definition of a variable by declaring it as a parameter

A parameter list

INTERNAL: See the class Parameter for further information.

A pass statement

INTERNAL: See the class Pass for further information.

A pattern in a match statement

A definition of a variable via a pattern alias

A definition of a variable via a capture pattern

A list of patterns

The parent of a PatternList. Internal implementation class

INTERNAL: See the class PatternListParent for further information.

INTERNAL: See the class PatternList for further information.

The parent of a Pattern. Internal implementation class

INTERNAL: See the class PatternParent for further information.

INTERNAL: See the class Pattern for further information.

A Phi-function as specified in classic SSA form.

INTERNAL: See the class PlaceHolder for further information.

A power (**) binary operator

INTERNAL: See the class Pow for further information.

A print statement (Python 2 only), such as print 0

INTERNAL: See the class Print for further information.

A Python specific sub-class of generic EssaEdgeRefinement

A right shift (>>) binary operator

INTERNAL: See the class RShift for further information.

A raise statement, such as raise CompletelyDifferentException()

A flow node for a raise statement

INTERNAL: See the class Raise for further information.

A repr (backticks) expression, such as `value`

INTERNAL: See the class Repr for further information.

A return statement, such as return None

INTERNAL: See the class Return for further information.

A Scope. A scope is the lexical extent over which all identifiers with the same name refer to the same variable. Modules, Classes and Functions are all Scopes. There are no other scopes. The scopes for expressions that create new scopes, lambdas and comprehensions, are handled by creating an anonymous Function.

A definition of variable at the entry of a scope. Usually this represents the transfer of a global or non-local variable from one scope to another.

INTERNAL: See the class Scope for further information.

An implicit (possible) modification of self at a method call

A control flow node corresponding to a sequence (tuple or list) literal

A set expression such as { 1, 3, 5, 7, 9 }

A set comprehension such as { v for v in "0123456789" }

INTERNAL: See the class SetComp for further information.

A control flow node corresponding to a set expression, such as { 1, 3, 5, 7, 9 }

INTERNAL: See the class Set for further information.

A pi-node (guard) with only one successor.

A slice. E.g 0:1 in the expression x[0:1]

INTERNAL: See the class Slice for further information.

INTERNAL: See the class SpecialOperation for further information.

A source language variable, to be converted into a set of SSA variables.

A single static assignment variable. An SSA variable is a variable which is only assigned once (statically). SSA variables can be defined as normal variables or by a phi node which can occur at joins in the flow graph. Definitions without uses do not have a SSA variable.

A starred expression, such as the *rest in the assignment first, *rest = seq

A control flow node corresponding to a starred expression, *a.

INTERNAL: See the class Starred for further information.

A statement

A list of statements

The parent of a StmtList. Internal implementation class

INTERNAL: See the class StmtListParent for further information.

INTERNAL: See the class StmtList for further information.

INTERNAL: See the class Stmt for further information.

The store context, the context of var in var = 0

INTERNAL: See the class Store for further information.

The parent of a StrList. Internal implementation class

INTERNAL: See the class StrListParent for further information.

INTERNAL: See the class StrParent for further information.

INTERNAL: See the class Str for further information.

A list of strings (the primitive type string not Bytes or Unicode)

INTERNAL: See the class StringList for further information.

A string constant.

A part of a string literal formed by implicit concatenation. For example the string literal “abc” expressed in the source as "a" "b" "c" would be composed of three StringParts.

INTERNAL: See the class StringPartList for further information.

INTERNAL: See the class StringPart for further information.

A subtract (-) binary operator

INTERNAL: See the class Sub for further information.

A subscript expression, such as value[slice]

A control flow node corresponding to a subscript expression, such as value[slice]

INTERNAL: See the class Subscript for further information.

A syntax error. Note that if there is a syntax error in a module, much information about that module will be lost

INTERNAL: See the class TemplateDottedNotation for further information.

A template string literal.

A list of template strings.

INTERNAL: See the class TemplateStringList for further information.

INTERNAL: See the class TemplateStringPart for further information.

INTERNAL: See the class TemplateString for further information.

A plain text used in a template is wrapped in a TemplateWrite statement

INTERNAL: See the class TemplateWrite for further information.

The boolean named constant True

A try statement

INTERNAL: See the class Try for further information.

A tuple expression such as ( 1, 3, 5, 7, 9 )

A control flow node corresponding to a tuple expression such as ( 1, 3, 5, 7, 9 )

INTERNAL: See the class Tuple for further information.

A type alias statement, such as type T[T1,T2] = T3.

INTERNAL: See the class TypeAlias for further information.

A type-hint comment. Any comment that starts with # type:

A generic type parameter, as seen in function, class, and type alias definitions.

A list of type parameters

A parent of a TypeParameterList. Internal implementation class.

INTERNAL: See the class TypeParameterListParent for further information.

INTERNAL: See the class TypeParameterList for further information.

INTERNAL: See the class TypeParameter for further information.

A type variable, with an optional bound, such as T1 and T2 in type T[T1, T2: T3] = T4.

A type var tuple parameter, such as *T1 in type T[*T1] = T2.

INTERNAL: See the class TypeVarTuple for further information.

INTERNAL: See the class TypeVar for further information.

A positive (+) unary operator

INTERNAL: See the class UAdd for further information.

A negation (-) unary operator

INTERNAL: See the class USub for further information.

A unary expression: (+x), (-x) or (~x)

A control flow node corresponding to a unary expression: (+x), (-x) or (~x)

INTERNAL: See the class UnaryExpr for further information.

A unary operator: +, -, ~ or not

INTERNAL: See the class Unaryop for further information.

A unicode string expression, such as u"\u20ac". Note that unadorned string constants such as “hello” are treated as Bytes for Python2, but Unicode for Python3.

The trivial type with a single element.

A variable, either a global or local variable (including parameters)

INTERNAL: See the class VariableParent for further information.

A while statement, such as while parrot_resting():

INTERNAL: See the class While for further information.

A with statement such as with f as open("file"): text = f.read()

A definition of a variable in a with statement

INTERNAL: See the class With for further information.

A yield expression, such as yield value

A yield expression, such as yield from value

INTERNAL: See the class YieldFrom for further information.

INTERNAL: See the class Yield for further information.

DEPRECATED. Use StringLiteral instead.

DEPRECATED. Use StringLiteral instead.