Update docs

Author: cthoyt

docs/source/converter_with_preprocessing.rst

@@ -1,8 +1,29 @@
 Converter with Preprocessing
 ============================
 
-When simple expansion and contraction aren't enough, and you want to
-inject global or context-specific rewrite rules, you can wrap a :class:`curies.Converter`
-and preprocessing rules encoded in an instance of :class:`curies.PreprocessingRules` inside
+When simple expansion and contraction aren't enough, and you want to inject global or
+context-specific rewrite rules, you can wrap a :class:`curies.Converter` and
+preprocessing rules encoded in an instance of :class:`curies.PreprocessingRules` inside
 a :class:`curies.PreprocessingConverter`.
 
+For example, you always want to fix legacy references to the ``OBO_REL`` namespace:
+
+.. code-block:: python
+
+    import curies
+    from curies import PreprocessingRules, PreprocessingConverter
+    from curies.wrapped import Rewrites
+
+    rules = PreprocessingRules(
+        rewrites=Rewrites(
+            full={"OBO_REL:is_a": "rdfs:subClassOf"}
+        )
+    )
+
+    converter = curies.get_obo_converter()
+    converter = PreprocessingConverter.from_converter(
+        converter, rules=rules
+    )
+
+    >>> converter.parse_curie("OBO_REL:is_a")
+    ReferenceTuple('rdfs', 'subClassOf')

src/curies/mapping_service/__init__.py

@@ -87,12 +87,12 @@
 
     import requests
 
-    sparql = '''
+    sparql = """
         SELECT ?s ?o WHERE {
             VALUES ?s { <http://purl.obolibrary.org/obo/CHEBI_2> }
             ?s owl:sameAs ?o
         }
-    '''
+    """
     res = requests.get("http://localhost:8764/sparql", params={"query": sparql})
 
 Test a request using a service, e.g. with :meth:`rdflib.Graph.query`

src/curies/wrapped.py

@@ -191,7 +191,8 @@ def __init__(
 
         :param args: Positional arguments passed to :func:`Converter.__init__`
         :param rules: A set of rules
-        :param reference_cls: The reference class to use. Defaults to :class:`curies.Reference`.
+        :param reference_cls: The reference class to use. Defaults to
+            :class:`curies.Reference`.
         :param kwargs: Keyword arguments passed to :func:`Converter.__init__`
         """
         super().__init__(*args, **kwargs)