PLC/Parameter.py

   1 #
   2 # Shared type definitions
   3 #
   4 # Mark Huang <mlhuang@cs.princeton.edu>
   5 # Copyright (C) 2006 The Trustees of Princeton University
   6 #
   7 # $Id: Parameter.py,v 1.3 2006/10/02 18:32:31 mlhuang Exp $
   8 #
   9
  10 class Parameter:
  11     """
  12     Typed value wrapper. Use in accepts and returns to document method
  13     parameters. Set the optional and default attributes for
  14     sub-parameters (i.e., dict fields).
  15     """
  16
  17     def __init__(self, type, doc = "",
  18                  min = None, max = None,
  19                  optional = None,
  20                  ro = False):
  21         # Basic type of the parameter. May be a builtin type or Mixed.
  22         self.type = type
  23
  24         # Documentation string for the parameter
  25         self.doc = doc
  26
  27         # Basic value checking. For numeric types, the minimum and
  28         # maximum possible values, inclusive. For string types, the
  29         # minimum and maximum possible UTF-8 encoded byte lengths.
  30         self.min = min
  31         self.max = max
  32
  33         # Whether the sub-parameter is optional or not. If None,
  34         # unknown whether it is optional.
  35         self.optional = optional
  36
  37         # Whether the DB field is read-only.
  38         self.ro = ro
  39
  40     def __repr__(self):
  41         return repr(self.type)
  42
  43 class Mixed(tuple):
  44     """
  45     A list (technically, a tuple) of types. Use in accepts and returns
  46     to document method parameters that may return mixed types.
  47     """
  48
  49     def __new__(cls, *types):
  50         return tuple.__new__(cls, types)