Adds args for intermediate objects

iiif_prezi3/helpers/annotation_helpers.py

@@ -5,20 +5,25 @@
 
 class AnnotationHelpers:
 
-    def add_annotation(self, annotation):
+    def add_annotation(self, annotation, anno_page_id=None):
         """Adds the annotation object to the (AnnotationPage object in the) annotations property.
 
+        Creates an AnnotationPage object if it doesn't exist.
+
         Args:
-          annotation (Annotation): the Annotation to add
+            annotation (Annotation): the Annotation to add
+            anno_page_id (str): An HTTP URL for the annotation page to which the annotation will be attached.
+
+        Returns:
+            annotation (Annotation): the Annotation attached to the AnnotationPage.
 
-        Creates an AnnotationPage object if it doesn't exist.
         """
         if not self.annotations:
             self.annotations = list()
 
         if len(self.annotations) == 0:
             # add empty AnnotationPage
-            anno_page = AnnotationPage(items=[])
+            anno_page = AnnotationPage(id=anno_page_id, items=[])
             self.annotations.append(anno_page)
         else:
             anno_page = self.annotations[0]

iiif_prezi3/helpers/create_canvas_from_iiif.py

@@ -7,11 +7,19 @@
 class CreateCanvasFromIIIF:
     # should probably be added to canvas helpers
 
-    def create_canvas_from_iiif(self, url, **kwargs):
+    def create_canvas_from_iiif(self, url, anno_id=None, anno_page_id=None, **kwargs):
         """Create a canvas from a IIIF Image URL.
 
-        Creates a canvas from a IIIF Image service passing any
-        kwargs to the Canvas. Returns a Canvas object
+        Creates a canvas from a IIIF Image service passing any kwargs to the Canvas.
+
+        Args:
+            url (str): An HTTP URL at which at a IIIF Image is available.
+            anno_id (str): An HTTP URL for the annotation to which the image will be attached.
+            anno_page_id (str): An HTTP URL for the annotation page to which the annotation will be attached.
+            **kwargs (): see Canvas
+
+        Returns:
+            canvas (Canvas): the Canvas created from the IIIF Image.
 
         """
         canvas = Canvas(**kwargs)
@@ -40,9 +48,9 @@ def create_canvas_from_iiif(self, url, **kwargs):
             body.id = f'{infoJson["id"]}/full/max/0/default.jpg'
             body.format = "image/jpeg"
 
-        annotation = Annotation(motivation='painting', body=body, target=canvas.id)
+        annotation = Annotation(id=anno_id, motivation='painting', body=body, target=canvas.id)
 
-        annotationPage = AnnotationPage()
+        annotationPage = AnnotationPage(id=anno_page_id)
         annotationPage.add_item(annotation)
 
         canvas.add_item(annotationPage)