cubicweb: comparison vregistry.py

equal deleted inserted replaced

-:ece5bbed3cd2
+:8d3dbe577d3a
 result += objs
 return result
 # dynamic selection methods ################################################
-@deprecated('use select instead of object_by_id')
+@deprecated('[3.5] use select instead of object_by_id')
 def object_by_id(self, oid, *args, **kwargs):
 """return object with the given oid. Only one object is expected to be
 found.
 raise `ObjectNotFound` if not object with id <oid> in <registry>
 """
 try:
 return self.select(oid, *args, **kwargs)
 except (NoSelectableObject, ObjectNotFound):
 return None
-select_object = deprecated('use select_or_none instead of select_object'
+select_object = deprecated('[3.5] use select_or_none instead of select_object'
 )(select_or_none)
 def possible_objects(self, *args, **kwargs):
 """return an iterator on possible objects in this registry for the given
 context
 raise Exception('select ambiguity, args: %s\nkwargs: %s %s'
 % (args, kwargs.keys(),
 [repr(v) for v in winners]))
 # return the result of calling the appobject
 return winners[0](*args, **kwargs)
-select_best = deprecated('select_best is now private')(_select_best)
+select_best = deprecated('[3.5] select_best is now private')(_select_best)
 class VRegistry(dict):
 """class responsible to register, propose and select the various
 elements used to build the web interface. Currently, we have templates,
 views, actions and components.
 except KeyError:
 raise RegistryNotFound(name), None, sys.exc_info()[-1]
 # dynamic selection methods ################################################
-@deprecated('use vreg[registry].object_by_id(oid, *args, **kwargs)')
+@deprecated('[3.4] use vreg[registry].object_by_id(oid, *args, **kwargs)')
 def object_by_id(self, registry, oid, *args, **kwargs):
 """return object in <registry>.<oid>
 raise `ObjectNotFound` if not object with id <oid> in <registry>
 raise `AssertionError` if there is more than one object there
 """
 return self[registry].object_by_id(oid)
-@deprecated('use vreg[registry].select(oid, *args, **kwargs)')
+@deprecated('[3.4] use vreg[registry].select(oid, *args, **kwargs)')
 def select(self, registry, oid, *args, **kwargs):
 """return the most specific object in <registry>.<oid> according to
 the given context
 raise `ObjectNotFound` if not object with id <oid> in <registry>
 raise `NoSelectableObject` if not object apply
 """
 return self[registry].select(oid, *args, **kwargs)
-@deprecated('use vreg[registry].select_or_none(oid, *args, **kwargs)')
+@deprecated('[3.4] use vreg[registry].select_or_none(oid, *args, **kwargs)')
 def select_object(self, registry, oid, *args, **kwargs):
 """return the most specific object in <registry>.<oid> according to
 the given context, or None if no object apply
 """
 return self[registry].select_or_none(oid, *args, **kwargs)
-@deprecated('use vreg[registry].possible_objects(*args, **kwargs)')
+@deprecated('[3.4] use vreg[registry].possible_objects(*args, **kwargs)')
 def possible_objects(self, registry, *args, **kwargs):
 """return an iterator on possible objects in <registry> for the given
 context
 """
 return self[registry].possible_objects(*args, **kwargs)
 # XXX bw compat functions #####################################################
 from cubicweb.appobject import objectify_selector, AndSelector, OrSelector, Selector
-objectify_selector = deprecated('objectify_selector has been moved to appobject module')(objectify_selector)
+objectify_selector = deprecated('[3.4] objectify_selector has been moved to appobject module')(objectify_selector)
 Selector = class_moved(Selector)
-@deprecated('use & operator (binary and)')
+@deprecated('[3.4] use & operator (binary and)')
 def chainall(*selectors, **kwargs):
 """return a selector chaining given selectors. If one of
 the selectors fail, selection will fail, else the returned score
 will be the sum of each selector'score
 """
 selector = AndSelector(*selectors)
 if 'name' in kwargs:
 selector.__name__ = kwargs['name']
 return selector
-@deprecated('use | operator (binary or)')
+@deprecated('[3.4] use | operator (binary or)')
 def chainfirst(*selectors, **kwargs):
 """return a selector chaining given selectors. If all
 the selectors fail, selection will fail, else the returned score
 will be the first non-zero selector score
 """

changeset 2788	8d3dbe577d3a
parent 2771	8074dd88e21b
child 2820	66b31686d92b