docs: update docstring for thumbprint and thumbprint_uri

Author: lepture

src/joserfc/_rfc7638/__init__.py

@@ -9,6 +9,18 @@ def calculate_thumbprint(
     value: t.Dict[str, t.Any],
     digest_method: t.Literal["sha256", "sha384", "sha512"] = "sha256",
 ) -> str:
+    """Calculate the thumbprint value of a Key, per RFC 7638.
+
+    .. code-block:: python
+
+        from joserfc import jwk
+
+        jwk.thumbprint({
+            'kty': 'oct',
+            'k': 'sTBpI_oCHSyW-n0exSwhzNHwU9FGRioPauxWA84bnRU',
+        })
+        # 'DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
+    """
     sorted_fields = sorted(value.keys())
     data = OrderedDict()
     for k in sorted_fields:

src/joserfc/_rfc9278/__init__.py

@@ -8,7 +8,18 @@ def calculate_thumbprint_uri(
     value: t.Dict[str, t.Any],
     digest_method: t.Literal["sha256", "sha384", "sha512"] = "sha256",
 ) -> str:
-    """Calculate JWK thumbprint URI, defined by RFC9278."""
+    """Calculate JWK thumbprint URI, defined by RFC9278.
+
+    .. code-block:: python
+
+        from joserfc import jwk
+
+        jwk.thumbprint({
+            'kty': 'oct',
+            'k': 'sTBpI_oCHSyW-n0exSwhzNHwU9FGRioPauxWA84bnRU',
+        })
+        # 'urn:ietf:params:oauth:jwk-thumbprint:sha-256:DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
+    """
     thumbprint = calculate_thumbprint(value, digest_method=digest_method)
     return concat_thumbprint_uri(thumbprint, digest_method=digest_method)
 

src/joserfc/jwk.py

@@ -12,6 +12,7 @@
 from ._rfc7518.ec_key import ECKey as ECKey
 from ._rfc8037.okp_key import OKPKey as OKPKey
 from ._rfc8812 import register_secp256k1
+from ._rfc7638 import calculate_thumbprint as thumbprint
 from ._rfc9278 import calculate_thumbprint_uri as thumbprint_uri
 from .registry import Header
 
@@ -37,6 +38,7 @@
     "guess_key",
     "import_key",
     "generate_key",
+    "thumbprint",
     "thumbprint_uri",
 ]