Update for #88

CHANGES.rst

@@ -2,6 +2,9 @@
 ------------------
 
 - This library now requires skosprovider 1.1.0 (#86)
+- All current (2023-11-06) conceptschemes defines by heritagedata.org are now included
+  as skosprovider_heritagedata.utils.CONCEPTSCHEMES. Reusing them avoids a call to the
+  webservice just to get the conceptscheme loaded (#88)
 - Add support for Python 3.11
 
 1.1.0 (2022-08-17)

examples/period_cs.py

@@ -0,0 +1,36 @@
+#!/usr/bin/python
+'''
+This script demonstrates using the HeritagedataProvider with the
+eh_period conceptscheme already loaded.
+'''
+
+from skosprovider_heritagedata.providers import HeritagedataProvider
+from skosprovider_heritagedata.utils import CONCEPTSCHEMES
+
+cs_uri = 'http://purl.org/heritagedata/schemes/eh_period'
+
+periodprovider = HeritagedataProvider(
+    {'id': 'Heritagedata'},
+    scheme_uri=cs_uri,
+    concept_scheme = CONCEPTSCHEMES[cs_uri]
+)
+
+cs = periodprovider.concept_scheme
+
+print('Labels')
+print('------')
+for l in cs.labels:
+   print(l.language + ': ' + l.label + ' [' + l.type + ']')
+print()
+
+print('Notes')
+print('-----')
+for n in cs.notes:
+    print(n.language + ': ' + n.note + ' [' + n.type + ']')
+print()
+
+print('Sources')
+print('-------')
+for s in cs.sources:
+    print(s.citation)
+print()

skosprovider_heritagedata/providers.py

@@ -34,8 +34,8 @@ def __init__(self, metadata, **kwargs):
         :param kwargs: arguments defining the provider.
             * Typical argument is `scheme_uri`.
                 The `scheme_uri` is a composition of the `base_scheme_uri` and `scheme_id`
-            * The :class:`skosprovider_Heritagedata.providers.HeritagedataProvider`
-                is the default :class:`skosprovider_Heritagedata.providers.HeritagedataProvider`
+            * session: a custom requests Sesssion
+            * concept_scheme: the scheme all concepts belong to, avoids a call to the webservice
         """
         if not 'default_language' in metadata:
             metadata['default_language'] = 'en'