CodeQL library for Python
codeql/python-all 2.2.1-dev (changelog, source)
Search

Class PropertyInternal

A property object.

Import path

import semmle.python.objects.Descriptors

Direct supertypes

Indirect supertypes

Predicates

attribute

Holds if the result of getting the attribute name is value and that value comes from origin. Note this is not the same as class lookup. For example for an object x the attribute name (x.name) may refer to a bound-method, an attribute of the instance, or an attribute of the class.

attributesUnknown

Holds if the attributes of this object are wholly or partly unknowable

binds

Holds if attribute lookup on this object may “bind” instance to descriptor. Here “bind” means that instance is passed to the descriptor.__get__() method at runtime. The term “bind” is used as this most likely results in a bound-method.

booleanValue

Gets the boolean value of this object. This may be both true and false if the “object” represents a set of possible objects.

callResult

Holds if obj is the result of calling this and origin is the origin of obj.

callResult

Holds if obj is the result of calling this and origin is the origin of obj with callee context callee.

calleeAndOffset

Holds if the function scope is called when this object is called and paramOffset is the difference from the parameter position and the argument position. For a normal function paramOffset is 0. For classes and bound-methods it is 1. Used by points-to to help determine flow from arguments to parameters.

contextSensitiveCallee
descriptorGetClass

Holds if the result of attribute access on the class holding this descriptor is value, originating at origin For example, although T.__dict__['name'] = classmethod(f), T.name is a bound-method, binding f and T

descriptorGetInstance

Holds if the result of attribute access on an instance of a class holding this descriptor is value, originating at origin For example, with T.__dict__['name'] = classmethod(f), T().name is a bound-method, binding f and T

getBuiltin

Gets the Builtin for this object, if any. Objects (except unknown and undefined values) should attempt to return exactly one result for either this method or getOrigin().

getClass

Gets the class of this object.

getClassDeclaration

Gets the class declaration for this object, if it is a class with a declaration.

getDeleter

Gets the setter function of this property

getGetter

Gets the getter function of this property

getIterNext

Gets the ‘object’ resulting from iterating over this object. Used in the context for i in this:. The result is the ‘object’ assigned to i.

getName

Gets the name of this property

getOrigin

Gets a control flow node that represents the source origin of this object, if it has a meaningful location in the source code. This method exists primarily for providing backwards compatibility and locations for source objects. Source code objects should attempt to return exactly one result for this method.

getSetter

Gets the setter function of this property

intValue

Gets the integer value of things that have integer values and whose integer value is tracked. That is, some ints, mainly small numbers, and bools.

introducedAt

Holds if this object is introduced into the code base at node given the context This means that node, in context, points-to this object, but the object has not flowed there from anywhere else. Examples: * The object None is “introduced” by the keyword “None”. * A bound method would be “introduced” when relevant attribute on an instance is accessed. In x = X(); x.m x.m introduces the bound method.

isClass

True if this “object” is a class. That is, its class inherits from type

isDescriptor

Holds if this object is a descriptor. Holds, for example, for functions and properties and not for integers.

isNotSubscriptedType
length

Gets the length of the sequence that this “object” represents. Always returns a value for a sequence, will be -1 if the object has no fixed length.

notTestableForEquality

True if this “object” can be meaningfully analyzed to determine the boolean value of equality tests on it. For example, None or int can be, but int() or an unknown string cannot.

strValue

Gets the string value of things that have string values. That is, strings.

subscriptUnknown

Holds if the result of subscripting this object are wholly or partly unknowable

toString

Gets a textual representation of this element.

useOriginAsLegacyObject

Holds if this ‘object’ represents an entity that should be exposed to the legacy points_to API This should hold for almost all objects that do not have an underlying DB object representing their source, for example super objects and bound-method. This should not hold for objects that are inferred to exists by an import statements or the like, but which aren’t in the database.

Inherited predicates

functionAndOffset

Holds if the object function is called when this object is called and paramOffset is the difference from the parameter position and the argument position. For a normal function paramOffset is 0. For classes and bound-methods it is 1. This is used to implement the CallableValue public API.

from ObjectInternal
getSource

For backwards compatibility shim – Not all objects have a “source”. Objects (except unknown and undefined values) should attempt to return exactly one result for this method.

from ObjectInternal
hasAttribute

Holds if this value has the attribute name

from ObjectInternal
isBuiltinfrom ObjectInternal