twisted.python.reflect : API documentation

def fullyQualifiedName(obj): (source)

Return the fully qualified name of a module, class, method or function. Classes and functions need to be module level ones to be correctly qualified.

Returns (type: str.)

def prefixedMethods(obj, prefix=''): (source)

A list of methods with a given prefix on a given instance.

def accumulateMethods(obj, dict, prefix='', curClass=None): (source)

accumulateMethods(instance, dict, prefix) I recurse through the bases of instance.__class__, and add methods beginning with 'prefix' to 'dict', in the form of {'methodname':*instance*method_object}.

def prefixedMethodNames(classObj, prefix): (source)

A list of method names with a given prefix in a given class.

def addMethodNamesToDict(classObj, dict, prefix, baseClass=None): (source)

addMethodNamesToDict(classObj, dict, prefix, baseClass=None) -> dict this goes through 'classObj' (and its bases) and puts method names starting with 'prefix' in 'dict' with a value of 1. if baseClass isn't None, methods will only be added if classObj is-a baseClass

If the class in question has the methods 'prefix_methodname' and 'prefix_methodname2', the resulting dict should look something like: {"methodname": 1, "methodname2": 1}.

def namedModule(name): (source)

Return a module given its name.

def namedObject(name): (source)

Get a fully named module-global object.

def namedAny(name): (source)

Retrieve a Python object by its fully qualified name from the global Python module namespace. The first part of the name, that describes a module, will be discovered and imported. Each subsequent part of the name is treated as the name of an attribute of the object specified by all of the name which came before it. For example, the fully-qualified name of this object is 'twisted.python.reflect.namedAny'.

Parameters	name	The name of the object to return. (type: `str`)
Returns	the Python object identified by 'name'.
Raises	InvalidName	If the name is an empty string, starts or ends with a '.', or is otherwise syntactically incorrect.
	ModuleNotFound	If the name is syntactically correct but the module it specifies cannot be imported because it does not appear to exist.
	ObjectNotFound	If the name is syntactically correct, includes at least one '.', but the module it specifies cannot be imported because it does not appear to exist.
	AttributeError	If an attribute of an object along the way cannot be accessed, or a module along the way is not found.

def filenameToModuleName(fn): (source)

Convert a name in the filesystem to the name of the Python module it is.

This is aggressive about getting a module name back from a file; it will always return a string. Aggressive means 'sometimes wrong'; it won't look at the Python path or try to do any error checking: don't use this method unless you already know that the filename you're talking about is a Python module.

Parameters	fn	A filesystem path to a module or package; `bytes` on Python 2, `bytes` or `unicode` on Python 3.
Returns	A hopefully importable module name. (type: `str`)

def qual(clazz): (source)

Return full import path of a class.

def safe_str(o): (source)

Returns a string representation of an object, or a string containing a traceback, if that object's __str__ raised an exception.

Parameters	o	Any object.
Returns	(type: `str`)

def safe_repr(o): (source)

Returns a string representation of an object, or a string containing a traceback, if that object's __repr__ raised an exception.

Parameters	o	Any object.
Returns	(type: `str`)

def funcinfo(function): (source)

this is more documentation for myself than useful code.

def fullFuncName(func): (source)

Undocumented

def getcurrent(clazz): (source)

Undocumented

def getClass(obj): (source)

Return the class or type of object 'obj'. Returns sensible result for oldstyle and newstyle instances and types.

def isinst(inst, clazz): (source)

Undocumented

@deprecated(Version('Twisted', 11, 0, 0), 'inspect.getmro')
def allYourBase(classObj, baseClass=None): (source)

allYourBase(classObj, baseClass=None) -> list of all base classes that are subclasses of baseClass, unless it is None, in which case all bases will be added.

@deprecated(Version('Twisted', 11, 0, 0), 'inspect.getmro')
def accumulateBases(classObj, l, baseClass=None): (source)

Undocumented

def _accumulateBases(classObj, l, baseClass=None): (source)

Undocumented

def accumulateClassDict(classObj, attr, adict, baseClass=None): (source)

Accumulate all attributes of a given name in a class hierarchy into a single dictionary.

Assuming all class attributes of this name are dictionaries. If any of the dictionaries being accumulated have the same key, the one highest in the class heirarchy wins. (XXX: If "higest" means "closest to the starting class".)

Ex:

 class Soy:
   properties = {"taste": "bland"}

 class Plant:
   properties = {"colour": "green"}

 class Seaweed(Plant):
   pass

 class Lunch(Soy, Seaweed):
   properties = {"vegan": 1 }

 dct = {}

 accumulateClassDict(Lunch, "properties", dct)

 print dct

{"taste": "bland", "colour": "green", "vegan": 1}

def accumulateClassList(classObj, attr, listObj, baseClass=None): (source)

Accumulate all attributes of a given name in a class heirarchy into a single list.

Assuming all class attributes of this name are lists.

def isSame(a, b): (source)

Undocumented

def isLike(a, b): (source)

Undocumented

def modgrep(goal): (source)

Undocumented

def isOfType(start, goal): (source)

Undocumented

def findInstances(start, t): (source)

Undocumented

def objgrep(start, goal, eq=isLike, path='', paths=None, seen=None, showUnknowns=0, maxDepth=None): (source)

An insanely CPU-intensive process for finding stuff.

Function	fullyQualifiedName	Return the fully qualified name of a module, class, method or function. Classes and functions need to be module level ones to be correctly qualified.
Function	prefixedMethods	A list of methods with a given prefix on a given instance.
Function	accumulateMethods	No summary
Function	prefixedMethodNames	A list of method names with a given prefix in a given class.
Function	addMethodNamesToDict	No summary
Function	namedModule	Return a module given its name.
Function	namedObject	Get a fully named module-global object.
Class	InvalidName	The given name is not a dot-separated list of Python objects.
Class	ModuleNotFound	The module associated with the given name doesn't exist and it can't be imported.
Class	ObjectNotFound	The object associated with the given name doesn't exist and it can't be imported.
Function	namedAny	No summary
Function	filenameToModuleName	Convert a name in the filesystem to the name of the Python module it is.
Function	qual	Return full import path of a class.
Function	safe_str	Returns a string representation of an object, or a string containing a traceback, if that object's __str__ raised an exception.
Function	safe_repr	Returns a string representation of an object, or a string containing a traceback, if that object's __repr__ raised an exception.
Class	Settable	No summary
Class	AccessorType	Metaclass that generates properties automatically.
Class	PropertyAccessor	A mixin class for Python 2.2 that uses AccessorType.
Class	Accessor	No summary
Class	Summer	Extend from this class to get the capability to maintain 'related sums'. Have a tuple in your class like the following:
Class	QueueMethod	I represent a method that doesn't exist yet.
Function	funcinfo	this is more documentation for myself than useful code.
Function	fullFuncName	Undocumented
Function	getcurrent	Undocumented
Function	getClass	Return the class or type of object 'obj'. Returns sensible result for oldstyle and newstyle instances and types.
Function	isinst	Undocumented
Function	allYourBase	allYourBase(classObj, baseClass=None) -> list of all base classes that are subclasses of baseClass, unless it is None, in which case all bases will be added.
Function	accumulateBases	Undocumented
Function	accumulateClassDict	Accumulate all attributes of a given name in a class hierarchy into a single dictionary.
Function	accumulateClassList	Accumulate all attributes of a given name in a class heirarchy into a single list.
Function	isSame	Undocumented
Function	isLike	Undocumented
Function	modgrep	Undocumented
Function	isOfType	Undocumented
Function	findInstances	Undocumented
Function	objgrep	An insanely CPU-intensive process for finding stuff.
Function	_accumulateBases	Undocumented

t.p.reflect : module documentation