interface documentation

class twisted.protocols.amp.IArgumentType(Interface): (source)

Known implementations: twisted.protocols.amp.Argument

View In Hierarchy

An IArgumentType can serialize a Python object into an AMP box and deserialize information from an AMP box back into a Python object.

Present Since9.0
Method fromBox Given an argument name and an AMP box containing serialized values, extract one or more Python objects and add them to the objects dictionary.
Method toBox Given an argument name and a dictionary containing structured Python objects, serialize values into one or more strings and add them to the strings dictionary.
def fromBox(name, strings, objects, proto): (source)

Given an argument name and an AMP box containing serialized values, extract one or more Python objects and add them to the objects dictionary.

ParametersnameThe name associated with this argument. Most commonly this is the key which can be used to find a serialized value in strings. (type: bytes)
stringsThe AMP box from which to extract one or more values. (type: dict)
objectsThe output dictionary to populate with the value for this argument. The key used will be derived from name. It may differ; in Python 3, for example, the key will be a Unicode/native string. See _wireNameToPythonIdentifier. (type: dict)
protoThe protocol instance which received the AMP box being interpreted. Most likely this is an instance of AMP, but this is not guaranteed.
ReturnsNone
def toBox(name, strings, objects, proto): (source)

Given an argument name and a dictionary containing structured Python objects, serialize values into one or more strings and add them to the strings dictionary.

ParametersnameThe name associated with this argument. Most commonly this is the key in strings to associate with a bytes giving the serialized form of that object. (type: bytes)
stringsThe AMP box into which to insert one or more strings. (type: dict)
objectsThe input dictionary from which to extract Python objects to serialize. The key used will be derived from name. It may differ; in Python 3, for example, the key will be a Unicode/native string. See _wireNameToPythonIdentifier. (type: dict)
protoThe protocol instance which will send the AMP box once it is fully populated. Most likely this is an instance of AMP, but this is not guaranteed.
ReturnsNone
API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.