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.2 2006/09/08 19:45:04 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 = True, default = 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 optional,
  34         # the default for the sub-parameter if not specified.
  35         self.optional = optional
  36         self.default = default
  37
  38         # Whether the DB field is read-only.
  39         self.ro = ro
  40
  41     def __repr__(self):
  42         return repr(self.type)
  43
  44 class Mixed(tuple):
  45     """
  46     A list (technically, a tuple) of types. Use in accepts and returns
  47     to document method parameters that may return mixed types.
  48     """
  49
  50     def __new__(cls, *types):
  51         return tuple.__new__(cls, types)