antkit 0.0.2__tar.gz → 0.0.4__tar.gz

antkit-0.0.4/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.5
+Name: antkit
+Version: 0.0.4
+Summary: 密码学安全的随机 token 与口令生成。
+Project-URL: Homepage, https://pypi.org/project/antkit/
+Author-email: lqxnjk <lqxnjk@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: password,random,secrets,security,token
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# antkit
+
+[English](#english) | 中文
+
+密码学安全的随机 token 与口令生成。
+
+## 安装
+
+```console
+pip install antkit
+```
+
+## 用法
+
+```python
+from antkit import password, token
+
+token()                       # 22 字符，16 字节熵
+token(n_bytes=32)
+token(n_urlsafe=False)        # hex
+
+password()                    # 16 位，四类字符全用
+password(24, n_symbols=False)
+password(12, n_lower=False, n_upper=False)
+```
+
+## 说明
+
+全部基于 `secrets`，不用 `random`（它的种子可预测，不能用于任何不该被猜到的值）。口令保证每个启用的字符类至少出现一次，然后整体打乱，避免保底字符堆在开头。请求不可能满足时抛 `ValueError`。
+
+## 许可证
+
+MIT
+
+---
+
+<a id="english"></a>
+## English
+
+Cryptographically secure tokens and passwords.
+
+## Install
+
+```console
+pip install antkit
+```
+
+## Usage
+
+```python
+from antkit import password, token
+
+token()                       # 22 字符，16 字节熵
+token(n_bytes=32)
+token(n_urlsafe=False)        # hex
+
+password()                    # 16 位，四类字符全用
+password(24, n_symbols=False)
+password(12, n_lower=False, n_upper=False)
+```
+
+## Notes
+
+Built on `secrets`, never `random`. Passwords always contain at least one character from every enabled class, then get shuffled so the guaranteed characters are not stuck at the front. Impossible requests raise `ValueError`.
+
+## License
+
+MIT

antkit-0.0.4/README.md

@@ -0,0 +1,68 @@
+# antkit
+
+[English](#english) | 中文
+
+密码学安全的随机 token 与口令生成。
+
+## 安装
+
+```console
+pip install antkit
+```
+
+## 用法
+
+```python
+from antkit import password, token
+
+token()                       # 22 字符，16 字节熵
+token(n_bytes=32)
+token(n_urlsafe=False)        # hex
+
+password()                    # 16 位，四类字符全用
+password(24, n_symbols=False)
+password(12, n_lower=False, n_upper=False)
+```
+
+## 说明
+
+全部基于 `secrets`，不用 `random`（它的种子可预测，不能用于任何不该被猜到的值）。口令保证每个启用的字符类至少出现一次，然后整体打乱，避免保底字符堆在开头。请求不可能满足时抛 `ValueError`。
+
+## 许可证
+
+MIT
+
+---
+
+<a id="english"></a>
+## English
+
+Cryptographically secure tokens and passwords.
+
+## Install
+
+```console
+pip install antkit
+```
+
+## Usage
+
+```python
+from antkit import password, token
+
+token()                       # 22 字符，16 字节熵
+token(n_bytes=32)
+token(n_urlsafe=False)        # hex
+
+password()                    # 16 位，四类字符全用
+password(24, n_symbols=False)
+password(12, n_lower=False, n_upper=False)
+```
+
+## Notes
+
+Built on `secrets`, never `random`. Passwords always contain at least one character from every enabled class, then get shuffled so the guaranteed characters are not stuck at the front. Impossible requests raise `ValueError`.
+
+## License
+
+MIT

{antkit-0.0.2 → antkit-0.0.4}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "antkit"
-version = "0.0.2"
-description = "Cryptographically secure tokens and passwords."
+version = "0.0.4"
+description = "密码学安全的随机 token 与口令生成。"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
-authors = [{ name = "lqxnjk" }]
+authors = [{ name = "lqxnjk", email = "lqxnjk@qq.com" }]
 keywords = ["token", "password", "secrets", "random", "security"]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -24,7 +24,7 @@ classifiers = [
 dependencies = []
 
 [project.urls]
-Homepage = "https://github.com/lqxnjk/antkit"
+Homepage = "https://pypi.org/project/antkit/"
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]

{antkit-0.0.2 → antkit-0.0.4}/src/antkit/__init__.py

@@ -1,11 +1,10 @@
 """
 Author: lqxnjk <lqxnjk@qq.com>
-Created: 2026-10-23 10:25
-Modified: 2026-10-23 10:25
+Created: 2026-10-23 10:55
+Modified: 2026-10-23 11:49
 Python Version: 3.10
 Secure random tokens and passwords.
 """
-
 from __future__ import annotations
 
 import secrets
@@ -19,21 +18,21 @@ _DIGITS = string.digits
 _SYMBOLS = "!@#$%^&*()-_=+[]{};:,.?"
 
 
-def token(m_bytes: int = 16, n_urlsafe: bool = True) -> str:
-    """Return a URL-safe token carrying ``m_bytes`` of entropy.
+def token(n_bytes: int = 16, n_urlsafe: bool = True) -> str:
+    """Return a URL-safe token carrying ``n_bytes`` of entropy.
 
     Built on :mod:`secrets`, so it is suitable for session IDs, API keys and
-    reset links. Length is longer than ``m_bytes`` because base64 expands.
+    reset links. Length is longer than ``n_bytes`` because base64 expands.
     """
-    if m_bytes < 1:
-        raise ValueError(f"m_bytes must be >= 1, got {m_bytes}")
+    if n_bytes < 1:
+        raise ValueError(f"n_bytes must be >= 1, got {n_bytes}")
     if n_urlsafe:
-        return secrets.token_urlsafe(m_bytes)
-    return secrets.token_hex(m_bytes)
+        return secrets.token_urlsafe(n_bytes)
+    return secrets.token_hex(n_bytes)
 
 
 def password(
-    m_length: int = 16,
+    n_length: int = 16,
     n_lower: bool = True,
     n_upper: bool = True,
     n_digits: bool = True,
@@ -56,12 +55,12 @@ def password(
         pools.append(_SYMBOLS)
     if not pools:
         raise ValueError("at least one character class must be enabled")
-    if m_length < len(pools):
-        raise ValueError(f"m_length must be >= {len(pools)} for {len(pools)} class(es)")
+    if n_length < len(pools):
+        raise ValueError(f"n_length must be >= {len(pools)} for {len(pools)} class(es)")
 
     alphabet = "".join(pools)
     chars = [secrets.choice(pool) for pool in pools]
-    chars.extend(secrets.choice(alphabet) for _ in range(m_length - len(chars)))
+    chars.extend(secrets.choice(alphabet) for _ in range(n_length - len(chars)))
     for index in range(len(chars) - 1, 0, -1):
         swap = secrets.randbelow(index + 1)
         chars[index], chars[swap] = chars[swap], chars[index]

{antkit-0.0.2 → antkit-0.0.4}/tests/test_antkit.py

@@ -1,10 +1,9 @@
 """
 Author: lqxnjk <lqxnjk@qq.com>
-Created: 2026-10-23 10:25
-Modified: 2026-10-23 10:25
+Created: 2026-10-23 10:55
+Modified: 2026-10-23 11:49
 Python Version: 3.10
 """
-
 import string
 
 import pytest

antkit-0.0.2/PKG-INFO

@@ -1,59 +0,0 @@
-Metadata-Version: 2.5
-Name: antkit
-Version: 0.0.2
-Summary: Cryptographically secure tokens and passwords.
-Project-URL: Homepage, https://github.com/lqxnjk/antkit
-Author: lqxnjk
-License: MIT
-License-File: LICENSE
-Keywords: password,random,secrets,security,token
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
-# antkit
-
-Generate tokens and passwords with `secrets` — never with `random`.
-
-## Install
-
-```console
-pip install antkit
-```
-
-## Usage
-
-```python
-from antkit import password, token
-
-token()                       # 22-char URL-safe string, 16 bytes of entropy
-token(m_bytes=32)             # longer
-token(n_urlsafe=False)        # hex instead
-
-password()                    # 16 chars, all four classes
-password(24, n_symbols=False)
-password(12, n_lower=False, n_upper=False)   # digits + symbols only
-```
-
-## Guarantees
-
-| Function | Guarantee |
-| --- | --- |
-| `token` | `secrets`-backed, URL-safe by default |
-| `password` | at least one character from every enabled class |
-| `password` | order shuffled, guaranteed chars are not prefix-stuck |
-| both | `ValueError` on impossible requests |
-
-`random` is not used anywhere: it is seeded predictably and is the wrong tool
-for anything a user must not guess.
-
-## License
-
-MIT

antkit-0.0.2/README.md

@@ -1,39 +0,0 @@
-# antkit
-
-Generate tokens and passwords with `secrets` — never with `random`.
-
-## Install
-
-```console
-pip install antkit
-```
-
-## Usage
-
-```python
-from antkit import password, token
-
-token()                       # 22-char URL-safe string, 16 bytes of entropy
-token(m_bytes=32)             # longer
-token(n_urlsafe=False)        # hex instead
-
-password()                    # 16 chars, all four classes
-password(24, n_symbols=False)
-password(12, n_lower=False, n_upper=False)   # digits + symbols only
-```
-
-## Guarantees
-
-| Function | Guarantee |
-| --- | --- |
-| `token` | `secrets`-backed, URL-safe by default |
-| `password` | at least one character from every enabled class |
-| `password` | order shuffled, guaranteed chars are not prefix-stuck |
-| both | `ValueError` on impossible requests |
-
-`random` is not used anywhere: it is seeded predictably and is the wrong tool
-for anything a user must not guess.
-
-## License
-
-MIT