Implements _LeObject.linked_together() and LeType.linked_subordinates() methods

leobject/leobject.py

@@ -154,8 +154,26 @@ class _LeObject(object):
                 raise AttributeError("A rel2type between a %s and a %s doesn't have an attribute %s"%(lesup.__class__.__name__, lesub.__class__.__name__))
             if not sup._linked_types[lesub.__class__][1].check(rel_attr[attr_name]):
                 raise ValueError("Wrong value '%s' for attribute %s"%(rel_attr[attr_name], attr_name))
-        return self._datasource.add_related(lesup, lesub, **rel_attr)
+        return cls._datasource.add_related(lesup, lesub, **rel_attr)
+    
+    ## @brief Get related objects
+    # @param leo LeType(instance) : LeType child class instance
+    # @param letype LeType(class) : the wanted LeType child class (not instance) 
+    # @param leo_is_superior bool : if True leo is the superior in the relation
+    # @return A dict with LeType child class instance as key and dict {rel_attr_name:rel_attr_value, ...}
+    # @throw LeObjectError if the relation is not possible
+    @classmethod
+    def linked_together(cls, leo, letype, leo_is_superior = True):
+        valid_link = letype in leo._linked_types.keys() if leo_is_superior else leo.__class__ in letype._linked_types.keys()
 
+        if not valid_link:
+            raise LeObjectError("Relation error : %s have no links with %s"%(
+                leo.__class__ if leo_is_superior else letype,
+                letype if leo_is_superior else leo.__class__
+            ))
+
+        return cls._datasource.get_related(leo, letype, leo_is_superior)
+    
     ## @brief Prepare a field_list
     # @param field_list list : List of string representing fields
     # @param letype LeType : LeType child class

leobject/letype.py

@@ -126,8 +126,17 @@ class LeType(object):
     # @throw LeObjectError if the link is not valid
     # @throw AttributeError if an non existing relation attribute is given as argument
     # @throw ValueError if the relation attrivute value check fails
+    # @see leobject.lefactory.LeFactory.link_together()
     def link(self, leo, **rel_attr):
-        leobject.lefactory.LeFactory.leobj_from_name('LeObject').link_together(self, leo, **rel_attr)
+        return leobject.lefactory.LeFactory.leobj_from_name('LeObject').link_together(self, leo, **rel_attr)
+    
+    ## @brief Returns linked subordinates in a rel2type given a wanted LeType child class
+    # @param letype LeType(class) : The wanted LeType of result
+    # @return A dict with LeType child class instance as key and dict {rel_attr_name:rel_attr_value, ...}
+    # @throw LeObjectError if the relation is not possible
+    # @see leobject.lefactory.LeFactory.linked_together()
+    def linked_subordinates(self, letype):
+        return leobject.lefactory.LeFactory.leobj_from_name('LeObject').linked_together(self, letype, True)
 
     ## @brief Remove a link bewteen this object and another
     # @param leo LeType : LeType child class instance