chore: release 1.1.0

Author: lepture

docs/changelog.rst

@@ -12,12 +12,15 @@ Changelog
 .. module:: joserfc
     :noindex:
 
-Unreleased
-----------
+1.1.0
+-----
+
+**Released on May 24, 2025**
 
 - Use "import as" to prioritize the modules for editors.
 - Added parameter ``encoder_cls`` for ``jwt.encode`` and ``decoder_cls`` for ``jwt.decode``.
 - Added ``none`` algorithm for JWS.
+- Added ``jwk.import_key`` and ``jwk.generate_key`` aliases.
 
 **Breaking changes**:
 

docs/guide/jwk.rst

@@ -398,6 +398,14 @@ the key type manually:
     data = b"---- BEGIN RSA PRIVATE KEY ----\n..."
     key = JWKRegistry.import_key(data, "RSA")
 
+.. versionadded:: v1.1.0
+
+    You can use ``jwk.import_key`` directly. For example::
+
+        from joserfc.jwk import import_key
+        data = {"kty": "oct", "k": "..."}
+        key = import_key(data)
+
 Generate keys
 ~~~~~~~~~~~~~
 
@@ -419,6 +427,13 @@ For ``EC`` and ``OKP`` keys, the parameters are:
     key = JWKRegistry.generate_key("EC", "P-256")
     key = JWKRegistry.generate_key("OKP", "Ed25519")
 
+.. versionadded:: v1.1.0
+
+    You can use ``jwk.generate_key`` directly. For example::
+
+        from joserfc.jwk import generate_key
+        key = generate_key("oct", 256)
+
 Options
 -------
 

docs/locales/zh/LC_MESSAGES/api.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  joserfc\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-04-20 18:35+0900\n"
+"POT-Creation-Date: 2025-05-24 13:25+0900\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: zh\n"
@@ -500,19 +500,19 @@ msgstr ""
 "从字节、字符串和字典导入密钥的类方法。当 ``value`` 为字典时，此方法可以自动识别密钥类型，否则，开发人员应自行传递 "
 "``key_type``。"
 
-#: joserfc._keys.JWKRegistry.import_key:5 of
+#: joserfc._keys.JWKRegistry.import_key:5 joserfc.jwk.import_key:5 of
 msgid "the key data in bytes, string, or dict."
 msgstr "字节、字符串或字典形式的密钥数据。"
 
-#: joserfc._keys.JWKRegistry.import_key:6 of
+#: joserfc._keys.JWKRegistry.import_key:6 joserfc.jwk.import_key:6 of
 msgid "an optional key type in string."
 msgstr "可选的密钥类型字符串。"
 
-#: joserfc._keys.JWKRegistry.import_key:7 of
+#: joserfc._keys.JWKRegistry.import_key:7 joserfc.jwk.import_key:7 of
 msgid "extra key parameters"
 msgstr "额外的密钥参数"
 
-#: joserfc._keys.JWKRegistry.import_key:8 of
+#: joserfc._keys.JWKRegistry.import_key:8 joserfc.jwk.import_key:8 of
 msgid "OctKey, RSAKey, ECKey, or OKPKey"
 msgstr "OctKey、RSAKey、ECKey 或 OKPKey"
 
@@ -565,6 +565,17 @@ msgid ""
 "editor.org/rfc/rfc7518#section-6.3"
 msgstr "RSA 密钥注册表定义 https://www.rfc-editor.org/rfc/rfc7518#section-6.3"
 
+#: joserfc.jwk.generate_key:1 of
+#, fuzzy
+msgid ""
+"Generating key according to the given key type. When ``key_type`` is "
+"\"oct\" and \"RSA\", the second parameter SHOULD be a key size in bits. "
+"When ``key_type`` is \"EC\" and \"OKP\", the second parameter SHOULD be a"
+" \"crv\" string."
+msgstr ""
+"根据给定的密钥类型生成密钥的类方法。当 ``key_type`` 为 \"oct\" 和 \"RSA\" 时，第二个参数应为位大小。当 "
+"``key_type`` 为 \"EC\" 和 \"OKP\" 时，第二个参数应为 \"crv\" 字符串。"
+
 #: joserfc.jwk.guess_key:1 of
 msgid "Guess key from a various sources."
 msgstr "从各种来源猜测密钥。"
@@ -581,6 +592,16 @@ msgstr "具有 ``headers`` 和 ``set_kid`` 方法的协议"
 msgid "pick a random key from key set"
 msgstr "从密钥集中随机选择一个密钥"
 
+#: joserfc.jwk.import_key:1 of
+#, fuzzy
+msgid ""
+"Importing a key from bytes, string, and dict. When ``value`` is a dict, "
+"this method can tell the key type automatically, otherwise, developers "
+"SHOULD pass the ``key_type`` themselves."
+msgstr ""
+"从字节、字符串和字典导入密钥的类方法。当 ``value`` 为字典时，此方法可以自动识别密钥类型，否则，开发人员应自行传递 "
+"``key_type``。"
+
 #: ../../api/jws.rst:6
 msgid ""
 "This part of the documentation covers all the interfaces of "