Add snippets.
[librarian.git] / src / librarian / document.py
index 0dbb14f..d4063c5 100644 (file)
@@ -20,6 +20,8 @@ class WLDocument:
 
         self.provider = provider if provider is not None else DirDocProvider('.')
 
 
         self.provider = provider if provider is not None else DirDocProvider('.')
 
+        self.tree.getroot().validate()
+
     @property
     def meta(self):
         # Allow metadata of the master element as document meta.
     @property
     def meta(self):
         # Allow metadata of the master element as document meta.
@@ -31,14 +33,40 @@ class WLDocument:
     def children(self):
         for part_uri in self.meta.parts or []:
             yield type(self)(
     def children(self):
         for part_uri in self.meta.parts or []:
             yield type(self)(
-                filename=self.provider.by_uri(part_uri),
+                filename=self.provider.by_slug(part_uri.slug),
                 provider=self.provider
             )
                 provider=self.provider
             )
-            
     
     
-    def build(self, builder, **kwargs):
-        return builder().build(self, **kwargs)
+    def build(self, builder, base_url=None, **kwargs):
+        return builder(base_url=base_url).build(self, **kwargs)
+
+    def assign_ids(self, existing=None):
+        # Find all existing IDs.
+        existing = existing or set()
+        que = [self.tree.getroot()]
+        while que:
+            item = que.pop(0)
+            try:
+                item.normalize_insides()
+            except AttributeError:
+                pass
+            existing.add(item.attrib.get('id'))
+            que.extend(item)
 
 
+        i = 1
+        que = [self.tree.getroot()]
+        while que:
+            item = que.pop(0)
+            que.extend(item)
+            if item.attrib.get('id'):
+                continue
+            if not getattr(item, 'SHOULD_HAVE_ID', False):
+                continue
+            while f'e{i}' in existing:
+                i += 1
+            item.attrib['id'] = f'e{i}'
+            i += 1
+    
     def _compat_assign_ordered_ids(self):
         """
         Compatibility: ids in document order, to be roughly compatible with legacy
     def _compat_assign_ordered_ids(self):
         """
         Compatibility: ids in document order, to be roughly compatible with legacy
@@ -81,9 +109,11 @@ class WLDocument:
     def editors(self):
         persons = set(self.meta.editors
                       + self.meta.technical_editors)
     def editors(self):
         persons = set(self.meta.editors
                       + self.meta.technical_editors)
-        #for child in self.parts():
-        #    persons.update(child.editors())
-        #if None in persons:
-        #    persons.remove(None)
+        for child in self.children:
+            persons.update(child.editors())
+        if None in persons:
+            persons.remove(None)
         return persons
 
         return persons
 
+    def references(self):
+        return self.tree.findall('.//ref')