twisted.persisted.styles : API documentation

Function	pickleMethod	support function for copy_reg to pickle method refs
Function	unpickleMethod	Support function for copy_reg to unpickle method refs.
Function	pickleModule	support function for copy_reg to pickle module refs
Function	unpickleModule	support function for copy_reg to unpickle module refs
Function	pickleStringO	Reduce the given cStringO.
Function	unpickleStringO	Convert the output of `pickleStringO` into an appropriate type for the current python version. This may be called on Python 3 and will convert a cStringIO into an `io.StringIO`.
Function	pickleStringI	Reduce the given cStringI.
Function	unpickleStringI	Convert the output of `pickleStringI` into an appropriate type for the current Python version.
Class	Ephemeral	This type of object is never persisted; if possible, even references to it are eliminated.
Function	doUpgrade	Undocumented
Function	requireUpgrade	Require that a Versioned instance be upgraded completely first.
Class	Versioned	This type of object is persisted with versioning information.
Function	_methodFunction	Retrieve the function object implementing a method name given the class it's on and a method name.
Function	_pickleFunction	Reduce, in the sense of `pickle`'s `object.__reduce__` special method, a function object into its constituent parts.
Function	_unpickleFunction	Convert a function name into a function by importing it.
Function	_aybabtu	Get all of the parent classes of `c`, not including `c` itself, which are strict subclasses of `Versioned`.

def pickleMethod(method): (source)

support function for copy_reg to pickle method refs

def _methodFunction(classObject, methodName): (source)

Retrieve the function object implementing a method name given the class it's on and a method name.

Parameters	classObject	A class to retrieve the method's function from. (type: `type` or `types.ClassType`)
	methodName	The name of the method whose function to retrieve. (type: native `str`)
Returns	the function object corresponding to the given method name. (type: `types.FunctionType`)

def unpickleMethod(im_name, im_self, im_class): (source)

Support function for copy_reg to unpickle method refs.

Parameters	im_name	The name of the method. (type: native `str`)
	im_self	The instance that the method was present on. (type: `object`)
	im_class	The class where the method was declared. (type: `types.ClassType` or `type` or `None`)

def _pickleFunction(f): (source)

Reduce, in the sense of L{pickle}'s C{object.__reduce__} special method, a
function object into its constituent parts.

@param f: The function to reduce.
@type f: L{types.FunctionType}

@return: a 2-tuple of a reference to L{_unpickleFunction} and a tuple of
    its arguments, a 1-tuple of the function's fully qualified name.
@rtype: 2-tuple of C{(callable, native string}}

def _unpickleFunction(fullyQualifiedName): (source)

Convert a function name into a function by importing it.

This is a synonym for twisted.python.reflect.namedAny, but imported locally to avoid circular imports, and also to provide a persistent name that can be stored (and deprecated) independently of namedAny.

Parameters	fullyQualifiedName	The fully qualified name of a function. (type: native `str`)
Returns	A function object imported from the given location. (type: `types.FunctionType`)

def pickleModule(module): (source)

support function for copy_reg to pickle module refs

def unpickleModule(name): (source)

support function for copy_reg to unpickle module refs

def pickleStringO(stringo): (source)

Reduce the given cStringO.

This is only called on Python 2, because the cStringIO module only exists on Python 2.

Parameters stringo The string output to pickle. (type: cStringIO.OutputType)

def unpickleStringO(val, sek): (source)

Convert the output of pickleStringO into an appropriate type for the current python version. This may be called on Python 3 and will convert a cStringIO into an io.StringIO.

Parameters	val	The content of the file. (type: `bytes`)
	sek	The seek position of the file. (type: `int`)
Returns	a file-like object which you can write bytes to. (type: `cStringIO.OutputType` on Python 2, `io.StringIO` on Python 3.)

def pickleStringI(stringi): (source)

Reduce the given cStringI.

This is only called on Python 2, because the cStringIO module only exists on Python 2.

Parameters	stringi	The string input to pickle. (type: `cStringIO.InputType`)
Returns	a 2-tuple of (`unpickleStringI`, (bytes, pointer)) (type: 2-tuple of (function, (bytes, int)))

def unpickleStringI(val, sek): (source)

Convert the output of pickleStringI into an appropriate type for the current Python version.

This may be called on Python 3 and will convert a cStringIO into an io.StringIO.

Parameters	val	The content of the file. (type: `bytes`)
	sek	The seek position of the file. (type: `int`)
Returns	a file-like object which you can read bytes from. (type: `cStringIO.OutputType` on Python 2, `io.StringIO` on Python 3.)

def doUpgrade(): (source)

Undocumented

def requireUpgrade(obj): (source)

Require that a Versioned instance be upgraded completely first.

def _aybabtu(c): (source)

Get all of the parent classes of c, not including c itself, which are strict subclasses of Versioned.

The name comes from "all your base are belong to us", from the deprecated twisted.python.reflect.allYourBase function.

Parameters	c	a class
Returns	list of classes

twisted.persisted.styles module documentation

`twisted.persisted.styles` module documentation