chore: release 1.2.0

Author: lepture

README.md

@@ -53,7 +53,7 @@ It follows RFCs with extensible API. The module has implementations of:
 - RFC7797: [JSON Web Signature (JWS) Unencoded Payload Option](https://jose.authlib.org/en/dev/guide/jws/#rfc7797)
 - RFC8037: ``OKP`` Key and ``EdDSA`` algorithm
 - RFC8812: ``ES256K`` algorithm
-- RFC9278: [JWK Thumbprint URI](https://jose.authlib.org/en/api/jwk/#joserfc.jwk.thumbprint_uri)
+- RFC9278: [JWK Thumbprint URI](https://jose.authlib.org/en/guide/jwk/#thumbprint-uri)
 
 And draft RFCs implementation of:
 

docs/changelog.rst

@@ -15,10 +15,11 @@ Changelog
 1.2.0
 -----
 
-**Unreleased**
+**Released on July 7, 2025**
 
+- Added RFC9278 JWK Thumbprint URI ``thumbprint_uri``.
 - Show security warnings for ``none`` and ``RSA1_5`` algorithms.
-- Show security warnings for ``OctKey.generate_key`` and ``RSAKey.generate_key``
+- Show security warnings for ``OctKey.generate_key`` and ``RSAKey.generate_key``.
   when key size is too short, per `NIST SP 800-131A`_.
 
 .. _`NIST SP 800-131A`: https://csrc.nist.gov/publications/detail/sp/800-131a/rev-2/final
@@ -53,22 +54,22 @@ Changelog
 1.0.4
 -----
 
-**Released on Feb 28, 2025**
+**Released on February 28, 2025**
 
 - Use secrets module to generate random bytes.
 - Use warnings for possible unsafe ``OctKey`` instead of raising error, via :issue:`32`.
 
 1.0.3
 -----
 
-**Released on Feb 6, 2025**
+**Released on February 6, 2025**
 
 - Allow using sha256, sha384, sha512 hash functions in thumbprint (RFC7638).
 
 1.0.2
 -----
 
-**Released on Jan 20, 2025**
+**Released on January 20, 2025**
 
 - Support import key from a certificate pem file.
 

docs/guide/jwk.rst

@@ -297,14 +297,26 @@ Key methods
 ``thumbprint``
 ~~~~~~~~~~~~~~
 
-Call this method will generate the thumbprint with algorithm defined in RFC7638.
+Call this method will generate the thumbprint of the JWK, per RFC7638.
 
 .. code-block:: python
 
     >>> from joserfc.jwk import OctKey
     >>> key = OctKey.generate_key()
     >>> key.thumbprint()
-    'RltMKTBXPdfe_CssBuyDK0pz17m0lKVraYEGfSlS6Ow'
+    'DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
+
+You can also use the ``jwk.thumbprint`` method:
+
+.. code-block:: python
+
+    from joserfc import jwk
+    jwk.thumbprint({
+        'kty': 'oct',
+        'k': 'sTBpI_oCHSyW-n0exSwhzNHwU9FGRioPauxWA84bnRU',
+    })
+    # 'DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
+
 
 ``thumbprint_uri``
 ~~~~~~~~~~~~~~~~~~
@@ -318,7 +330,18 @@ Call this method will generate the JWK thumbprint URI, per RFC9278.
     >>> from joserfc.jwk import OctKey
     >>> key = OctKey.generate_key()
     >>> key.thumbprint_uri()
-    'urn:ietf:params:oauth:jwk-thumbprint:sha-256:RltMKTBXPdfe_CssBuyDK0pz17m0lKVraYEGfSlS6Ow'
+    'urn:ietf:params:oauth:jwk-thumbprint:sha-256:DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
+
+You can also use the ``jwk.thumbprint_uri`` method:
+
+.. code-block:: python
+
+    from joserfc import jwk
+    jwk.thumbprint_uri({
+        'kty': 'oct',
+        'k': 'sTBpI_oCHSyW-n0exSwhzNHwU9FGRioPauxWA84bnRU',
+    })
+    # 'urn:ietf:params:oauth:jwk-thumbprint:sha-256:DCdRGGDKvhAJgmVlCp6tosc2T9ELtd30S_15vn8bhrI'
 
 .. _ensure_kid:
 

docs/index.rst

@@ -51,6 +51,7 @@ It follows RFCs with extensible API. The module has implementations of:
 - RFC7638: ``thumbprint`` for JWK
 - RFC8037: :ref:`OKPKey` and ``EdDSA`` algorithm
 - RFC8812: ``ES256K`` algorithm
+- RFC9278: ``thumbprint_uri`` for JWK
 
 And draft RFCs implementation of:
 

src/joserfc/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 __homepage__ = "https://jose.authlib.org/en/"
 __author__ = "Hsiaoming Yang <[email protected]>"
 __license__ = "BSD-3-Clause"