Add an example on using SqliteCacheRequestsDocumentLoader with contextloader.

Author: mielvds

docs/examples/context_resolver_sqlite_cache.py

@@ -0,0 +1,21 @@
+import json
+from pathlib import Path
+
+from cachetools import LRUCache
+
+from pyld import ContextResolver, SqliteCacheRequestsDocumentLoader, jsonld
+
+loader = SqliteCacheRequestsDocumentLoader(
+    sqlite_file_path=Path("/tmp/pyld_example_context_cache.sqlite"),
+)
+resolver = ContextResolver(LRUCache(maxsize=1000), loader)
+
+doc = {
+    "@context": "https://schema.org/",
+    "name": "Example Person",
+}
+options = {"documentLoader": loader, "contextResolver": resolver}
+
+expanded = jsonld.expand(doc, options=options)
+
+print(json.dumps(expanded, indent=2))

docs/reference/context-resolver.md

@@ -16,6 +16,12 @@ documents, so pass the same loader with `documentLoader`.
 
 {{ example('context_resolver.py', output_syntax='json') }}
 
+Use the built-in `SqliteCacheRequestsDocumentLoader` when you want the resolver
+to combine PyLD's in-memory resolved-context cache with persistent HTTP caching
+for fetched remote contexts.
+
+{{ example('context_resolver_sqlite_cache.py', output_syntax='json') }}
+
 The `shared_cache` object must behave like a mutable mapping. PyLD uses
 `cachetools.LRUCache` by default, but applications can provide another mapping
 when they need a different eviction policy.