webanno: added no_auto_context parameter for WebAnnoConfig

Author: proycon

src/annotation.rs

@@ -479,6 +479,7 @@ impl PyAnnotation {
     #[pyo3(signature = (kwargs=None))]
     fn webannotation<'py>(&self, kwargs: Option<&Bound<'py, PyDict>>) -> PyResult<String> {
         let mut config = WebAnnoConfig::default();
+        let mut auto_context = true;
         if let Some(kwargs) = kwargs {
             if let Ok(Some(v)) = kwargs.get_item("default_annotation_iri") {
                 config.default_annotation_iri = v.extract()?;
@@ -501,6 +502,10 @@ impl PyAnnotation {
             if let Ok(Some(v)) = kwargs.get_item("skip_context") {
                 config.skip_context = v.extract()?;
             }
+            if let Ok(Some(v)) = kwargs.get_item("no_auto_context") {
+                let no_auto_context = v.extract()?;
+                let auto_context = !no_auto_context;
+            }
             if let Ok(Some(v)) = kwargs.get_item("context_namespaces") {
                 config.context_namespaces = {
                     let mut namespaces = Vec::new();
@@ -518,7 +523,12 @@ impl PyAnnotation {
                 }
             }
         }
-        self.map(|annotation| Ok(annotation.to_webannotation(&config)))
+        self.map(|annotation| {
+            if auto_context {
+                config = config.auto_extra_context(annotation.store());
+            }
+            Ok(annotation.to_webannotation(&config))
+        })
     }
 
     fn test_textselection(

stam.pyi

@@ -859,15 +859,18 @@ class Annotation:
         `default_resource_iri`: `str`
             IRI prefix for Text Resources. Will be prepended if the resource public ID is not an IRI yet.
 
-        'extra_context`: `[str]`
+        `extra_context`: `[str]`
             Extra JSON-LD context to export, these must be URLs to JSONLD files. 
             The contexts you provide also double as possible STAM dataset IDs. 
             Any keys in these sets that are not full IRIs will
             be copied as-is to the output (as alias rather than joined with the set ID to form a
             full IRI ), leaving interpretation it up to the JSON-LD context.
 
-        'skip_context`: `bool`
+        `skip_context`: `bool`
             Do not output @context when outputting web annotations (useful if already done at an earlier stage) 
+
+        `no_auto_context`: `bool`
+            Do not automatically add any used STAM datasets ending in `.jsonld` or `.json` to the `extra_context` list. (default: false)
             
         `auto_generated`: `bool`
             Automatically add a 'generated' triple for each annotation, with the timestamp of serialisation