X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=PLC%2FParameter.py;h=230748362f485bce551a7385099b361571fc7dbe;hb=7721c8aedf5db2d2fe135e92a61a2dfb20be7960;hp=1430b27012ef3e7e7e80cce0f01da3e63cdb6505;hpb=24d16d18acab3da7bccc3e09df4927e9cf2d3246;p=plcapi.git diff --git a/PLC/Parameter.py b/PLC/Parameter.py index 1430b27..2307483 100644 --- a/PLC/Parameter.py +++ b/PLC/Parameter.py @@ -4,9 +4,12 @@ # Mark Huang # Copyright (C) 2006 The Trustees of Princeton University # -# $Id$ +# $Id: Parameter.py,v 1.6 2006/11/08 22:10:00 mlhuang Exp $ # +from types import * +from PLC.Faults import * + class Parameter: """ Typed value wrapper. Use in accepts and returns to document method @@ -14,9 +17,36 @@ class Parameter: sub-parameters (i.e., dict fields). """ - def __init__(self, type, doc = "", optional = True, default = None): - (self.type, self.doc, self.optional, self.default) = \ - (type, doc, optional, default) + def __init__(self, type, doc = "", + min = None, max = None, + optional = None, + ro = False, + nullok = False): + # Basic type of the parameter. Must be a builtin type + # that can be marshalled by XML-RPC. + self.type = type + + # Documentation string for the parameter + self.doc = doc + + # Basic value checking. For numeric types, the minimum and + # maximum possible values, inclusive. For string types, the + # minimum and maximum possible UTF-8 encoded byte lengths. + self.min = min + self.max = max + + # Whether the sub-parameter is optional or not. If None, + # unknown whether it is optional. + self.optional = optional + + # Whether the DB field is read-only. + self.ro = ro + + # Whether the DB field can be NULL. + self.nullok = nullok + + def type(self): + return self.type def __repr__(self): return repr(self.type) @@ -29,3 +59,47 @@ class Mixed(tuple): def __new__(cls, *types): return tuple.__new__(cls, types) + + +def python_type(arg): + """ + Returns the Python type of the specified argument, which may be a + Python type, a typed value, or a Parameter. + """ + + if isinstance(arg, Parameter): + arg = arg.type + + if isinstance(arg, type): + return arg + else: + return type(arg) + +def xmlrpc_type(arg): + """ + Returns the XML-RPC type of the specified argument, which may be a + Python type, a typed value, or a Parameter. + """ + + arg_type = python_type(arg) + + if arg_type == NoneType: + return "nil" + elif arg_type == IntType or arg_type == LongType: + return "int" + elif arg_type == bool: + return "boolean" + elif arg_type == FloatType: + return "double" + elif arg_type in StringTypes: + return "string" + elif arg_type == ListType or arg_type == TupleType: + return "array" + elif arg_type == DictType: + return "struct" + elif arg_type == Mixed: + # Not really an XML-RPC type but return "mixed" for + # documentation purposes. + return "mixed" + else: + raise PLCAPIError, "XML-RPC cannot marshal %s objects" % arg_type