documentation and docstring updates
[tiramisu.git] / tiramisu / autolib.py
index ec95fd8..6c0080b 100644 (file)
 from tiramisu.error import PropertiesOptionError, ConfigError
 from tiramisu.i18n import _
 # ____________________________________________________________
-# automatic Option object
-#def special_owner_factory(name, owner, value,
-#                          callback, callback_params=None, config=None):
-#    # in case of an 'auto' and a 'fill' without a value,
-#    # we have to carry out a calculation
-#    return calc_factory(name, callback, callback_params, config)
 
+def carry_out_calculation(name,
+                          config,
+                          callback,
+                          callback_params,
+                          index=None):
+    """a function that carries out a calculation for an option's value
 
-def carry_out_calculation(name, config, callback, callback_params, index=None):
-    "a function that carries out a calculation for an option's value"
+    :param name: the option name (`opt._name`)
+    :param config: the context config in order to have
+                   the whole options available
+    :param callback: the name of the callback function
+    :type callback: str
+    :param callback_params: the callback's parameters
+                            (only keyword parameters are allowed)
+    :type callback_params: dict
+    :param index: if an option is multi, only calculates the nth value
+    :type index: int
+    """
     #callback, callback_params = option.getcallback()
     #if callback_params is None:
     #    callback_params = {}
@@ -121,6 +130,7 @@ def carry_out_calculation(name, config, callback, callback_params, index=None):
 
 
 def calculate(name, callback, params, tcparams):
+    # FIXME we don't need the option's name down there.
     """wrapper that launches the 'callback'
 
     :param callback: callback name