antkit 0.0.1__tar.gz → 0.0.2__tar.gz

antkit-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lqxnjk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

antkit-0.0.2/PKG-INFO

@@ -0,0 +1,59 @@
+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

@@ -0,0 +1,39 @@
+# 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/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "antkit"
+version = "0.0.2"
+description = "Cryptographically secure tokens and passwords."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "lqxnjk" }]
+keywords = ["token", "password", "secrets", "random", "security"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/lqxnjk/antkit"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/antkit"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/antkit", "tests", "README.md", "LICENSE"]

antkit-0.0.2/src/antkit/__init__.py

@@ -0,0 +1,68 @@
+"""
+Author: lqxnjk <lqxnjk@qq.com>
+Created: 2026-10-23 10:25
+Modified: 2026-10-23 10:25
+Python Version: 3.10
+Secure random tokens and passwords.
+"""
+
+from __future__ import annotations
+
+import secrets
+import string
+
+__all__ = ["token", "password"]
+
+_LOWER = string.ascii_lowercase
+_UPPER = string.ascii_uppercase
+_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.
+
+    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.
+    """
+    if m_bytes < 1:
+        raise ValueError(f"m_bytes must be >= 1, got {m_bytes}")
+    if n_urlsafe:
+        return secrets.token_urlsafe(m_bytes)
+    return secrets.token_hex(m_bytes)
+
+
+def password(
+    m_length: int = 16,
+    n_lower: bool = True,
+    n_upper: bool = True,
+    n_digits: bool = True,
+    n_symbols: bool = True,
+) -> str:
+    """Return a random password that is guaranteed to use every enabled class.
+
+    At least one character from each enabled class is always present, then the
+    result is shuffled with :func:`secrets.randbelow` so the guaranteed
+    characters are not stuck at the front.
+    """
+    pools: list[str] = []
+    if n_lower:
+        pools.append(_LOWER)
+    if n_upper:
+        pools.append(_UPPER)
+    if n_digits:
+        pools.append(_DIGITS)
+    if n_symbols:
+        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)")
+
+    alphabet = "".join(pools)
+    chars = [secrets.choice(pool) for pool in pools]
+    chars.extend(secrets.choice(alphabet) for _ in range(m_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]
+    return "".join(chars)

antkit-0.0.2/tests/test_antkit.py

@@ -0,0 +1,54 @@
+"""
+Author: lqxnjk <lqxnjk@qq.com>
+Created: 2026-10-23 10:25
+Modified: 2026-10-23 10:25
+Python Version: 3.10
+"""
+
+import string
+
+import pytest
+
+from antkit import password, token
+
+
+def test_token_length_and_charset() -> None:
+    value = token(16)
+    assert len(value) >= 16
+    assert all(char in string.ascii_letters + string.digits + "-_" for char in value)
+
+
+def test_token_uniqueness() -> None:
+    assert len({token() for _ in range(200)}) == 200
+
+
+def test_token_hex() -> None:
+    value = token(8, n_urlsafe=False)
+    assert len(value) == 16
+    int(value, 16)
+
+
+def test_password_uses_all_classes() -> None:
+    value = password(16)
+    assert any(char in string.ascii_lowercase for char in value)
+    assert any(char in string.ascii_uppercase for char in value)
+    assert any(char in string.digits for char in value)
+    assert any(not char.isalnum() for char in value)
+
+
+def test_password_respects_disabled_classes() -> None:
+    value = password(12, n_symbols=False)
+    assert value.isalnum()
+
+
+def test_password_length() -> None:
+    assert len(password(24)) == 24
+
+
+def test_impossible_requests() -> None:
+    with pytest.raises(ValueError):
+        password(4, n_lower=False, n_upper=False, n_digits=False, n_symbols=False)
+    with pytest.raises(ValueError):
+        password(1)
+    with pytest.raises(ValueError):
+        token(0)

antkit-0.0.1/MANIFEST.in

@@ -1 +0,0 @@
-include requirements.txt

antkit-0.0.1/PKG-INFO

@@ -1,59 +0,0 @@
-Metadata-Version: 2.4
-Name: antkit
-Version: 0.0.1
-Summary: A Python package for intelligent information bagging system
-Home-page: https://github.com/lqxnjk/antkit
-Author: lqxnjk
-Author-email: lqxnjk@qq.com
-License: MIT
-Project-URL: Bug Reports, https://github.com/lqxnjk/antkit/issues
-Project-URL: Source, https://github.com/lqxnjk/antkit
-Keywords: ii,etls,lqxnjk,data
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3.7
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Scientific/Engineering
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: typing-extensions; python_version < "3.8"
-Provides-Extra: dev
-Provides-Extra: plot
-Provides-Extra: gpu
-Provides-Extra: all
-Requires-Dist: antkit[dev]; extra == "all"
-Requires-Dist: antkit[plot]; extra == "all"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-python
-Dynamic: summary
-
-## 构建依赖包
-
-```基础命令
-python -m pip install twine  -i https://mirrors.tencent.com/pypi/simple
-pip install wheel setuptools -i https://mirrors.tencent.com/pypi/simple
-python setup.py sdist bdist_wheel
-python -m build
-pip install .
-pip install -e .
-pip install -e .[dev]
-```
-
-```shell 构建命令
-#rm -rf './dist'
-#python -m build
-python setup.py sdist bdist_wheel
-python -m twine upload dist/*
-```

antkit-0.0.1/README.md

@@ -1,18 +0,0 @@
-## 构建依赖包
-
-```基础命令
-python -m pip install twine  -i https://mirrors.tencent.com/pypi/simple
-pip install wheel setuptools -i https://mirrors.tencent.com/pypi/simple
-python setup.py sdist bdist_wheel
-python -m build
-pip install .
-pip install -e .
-pip install -e .[dev]
-```
-
-```shell 构建命令
-#rm -rf './dist'
-#python -m build
-python setup.py sdist bdist_wheel
-python -m twine upload dist/*
-```

antkit-0.0.1/antkit/__init__.py

@@ -1,5 +0,0 @@
-"""
-lqxnjk lqxnjk@qq.com
-"""
-__version__ = "0.0.1"
-__all__ = []

antkit-0.0.1/antkit.egg-info/PKG-INFO

@@ -1,59 +0,0 @@
-Metadata-Version: 2.4
-Name: antkit
-Version: 0.0.1
-Summary: A Python package for intelligent information bagging system
-Home-page: https://github.com/lqxnjk/antkit
-Author: lqxnjk
-Author-email: lqxnjk@qq.com
-License: MIT
-Project-URL: Bug Reports, https://github.com/lqxnjk/antkit/issues
-Project-URL: Source, https://github.com/lqxnjk/antkit
-Keywords: ii,etls,lqxnjk,data
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3.7
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Scientific/Engineering
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: typing-extensions; python_version < "3.8"
-Provides-Extra: dev
-Provides-Extra: plot
-Provides-Extra: gpu
-Provides-Extra: all
-Requires-Dist: antkit[dev]; extra == "all"
-Requires-Dist: antkit[plot]; extra == "all"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-python
-Dynamic: summary
-
-## 构建依赖包
-
-```基础命令
-python -m pip install twine  -i https://mirrors.tencent.com/pypi/simple
-pip install wheel setuptools -i https://mirrors.tencent.com/pypi/simple
-python setup.py sdist bdist_wheel
-python -m build
-pip install .
-pip install -e .
-pip install -e .[dev]
-```
-
-```shell 构建命令
-#rm -rf './dist'
-#python -m build
-python setup.py sdist bdist_wheel
-python -m twine upload dist/*
-```

antkit-0.0.1/antkit.egg-info/SOURCES.txt

@@ -1,11 +0,0 @@
-MANIFEST.in
-README.md
-requirements.txt
-setup.py
-antkit/__init__.py
-antkit.egg-info/PKG-INFO
-antkit.egg-info/SOURCES.txt
-antkit.egg-info/dependency_links.txt
-antkit.egg-info/entry_points.txt
-antkit.egg-info/requires.txt
-antkit.egg-info/top_level.txt

antkit-0.0.1/antkit.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

antkit-0.0.1/antkit.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[hello]
-antkit_version = antkit.__init__:version

antkit-0.0.1/antkit.egg-info/requires.txt

@@ -1,13 +0,0 @@
-
-[:python_version < "3.8"]
-typing-extensions
-
-[all]
-antkit[dev]
-antkit[plot]
-
-[dev]
-
-[gpu]
-
-[plot]

antkit-0.0.1/antkit.egg-info/top_level.txt

@@ -1 +0,0 @@
-antkit

antkit-0.0.1/requirements.txt

@@ -1,5 +0,0 @@
---extra-index-url https://mirrors.tencent.com/pypi/simple
-# python 3.7.9
-# pip install -r ./requirements.txt -i https://mirrors.tencent.com/pypi/simple
-#  --default-timeout=100
-#------------------------------------------------------------------------------------------------------------

antkit-0.0.1/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

antkit-0.0.1/setup.py

@@ -1,190 +0,0 @@
-import os.path
-
-from setuptools import setup, find_packages
-from pathlib import Path
-import re
-
-# ========== Configuration Variables ==========
-# Basic package info
-ROOT_DIR = Path(__file__).absolute().parent
-PACKAGE_NAME = Path(__file__).absolute().parent.name.split("_")[-1].split("-")[-1]
-
-AUTHOR = "lqxnjk"
-AUTHOR_EMAIL = "lqxnjk@qq.com"
-DESCRIPTION = "A Python package for intelligent information bagging system"
-LICENSE = "MIT"
-PYTHON_REQUIRES = ">=3.7"
-URL = f"https://github.com/lqxnjk/{PACKAGE_NAME}"
-PROJECT_URLS = {
-    'Bug Reports': f'{URL}/issues',
-    'Source': URL,
-}
-
-# Package discovery
-PACKAGE_EXCLUDES = ['tests*', 'docs*', 'examples*']
-
-# Classifiers
-CLASSIFIERS = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Science/Research",
-    "Programming Language :: Python :: 3.7",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Scientific/Engineering",
-]
-
-# Keywords
-KEYWORDS = ["ii", "etls", "lqxnjk", "data"]
-
-# Package data
-PACKAGE_DATA = {
-    PACKAGE_NAME: ['data/*.json', 'data/*.csv'],
-}
-# Entry points
-ENTRY_POINTS = {
-    'hello': [
-        f'{PACKAGE_NAME}_version = {PACKAGE_NAME}.__init__:version',
-    ],
-}
-
-
-# ========== Dynamic Value Functions ==========
-def get_long_description():
-    """Read README.md content as long description."""
-    with open('README.md', 'r', encoding='utf-8') as f:
-        return f.read()
-
-
-def get_version():
-    """Read version from package __init__.py file."""
-    init_file = f"./{PACKAGE_NAME}/__init__.py"
-    if not os.path.exists(init_file):
-        init_file = f"./demo/__init__.py"
-    with open(init_file, 'r', encoding='utf-8') as f:
-        version_match = re.search(r"^__version__ = ['\"]([^'\"]*)['\"]", f.read(), re.M)
-        if version_match:
-            return version_match.group(1)
-        raise RuntimeError("Unable to find version string.")
-
-
-def get_requirements():
-    """Read requirements from requirements.txt."""
-    with open(ROOT_DIR / 'requirements.txt', 'r', encoding='utf-8') as f:
-        return [
-            line.strip() for line in f
-            if line.strip()
-               and not line.startswith('#')
-               and not line.startswith('--')
-        ]
-
-
-REQUIREMENTS = get_requirements()
-
-# Optional dependencies
-EXTRAS_REQUIRE = {
-    ':python_version < "3.8"': ['typing-extensions'],
-    'dev': [
-        # 'pytest>=6.0',
-        # 'pytest-cov>=2.0',
-        # 'flake8>=3.9',
-        # 'mypy>=0.910',
-        # 'sphinx>=4.0',
-    ],
-    'plot': [
-        # 'matplotlib>=3.0',
-        # 'seaborn>=0.11',
-    ],
-    'gpu': [
-        # 'cupy>=10.0'
-    ],
-    'all': [f'{PACKAGE_NAME}[dev]', f'{PACKAGE_NAME}[plot]']
-}
-
-# ========== Setup Configuration ==========
-setup(
-    name=PACKAGE_NAME,
-    version=get_version(),
-    packages=find_packages(exclude=PACKAGE_EXCLUDES),
-    install_requires=REQUIREMENTS,
-    extras_require=EXTRAS_REQUIRE,
-    include_package_data=True,
-    package_data=PACKAGE_DATA,
-    author=AUTHOR,
-    author_email=AUTHOR_EMAIL,
-    description=DESCRIPTION,
-    long_description=get_long_description(),
-    long_description_content_type='text/markdown',
-    url=URL,
-    project_urls=PROJECT_URLS,
-    classifiers=CLASSIFIERS,
-    python_requires=PYTHON_REQUIRES,
-    entry_points=ENTRY_POINTS,
-    license=LICENSE,
-    keywords=KEYWORDS,
-)
-
-
-# ========== Pyproject.toml Generation ==========
-def generate_pyproject_toml():
-    """Generate pyproject.toml from extracted variables."""
-    # Format project URLs for TOML
-    urls_toml = "\n".join(
-        f'{key.replace(" ", "-").lower()} = "{value}"'
-        for key, value in PROJECT_URLS.items()
-    )
-
-    # Format extras_require for TOML
-    extras_toml = []
-    for key, deps in EXTRAS_REQUIRE.items():
-        if key.startswith(':python_version'):
-            # Handle conditional dependencies
-            condition = key.split('"')[1]
-            extras_toml.append(
-                f'python_version_lt_{condition.replace(".", "_")} = {deps}'
-            )
-        else:
-            extras_toml.append(f'{key} = {deps}')
-    extras_toml_str = "\n".join(extras_toml)
-    PACKAGE_DATA_STR = "{" + ",\n".join([f'"{k}" = {v}' for k, v in PACKAGE_DATA.items()]) + "}"
-    pyproject_content = f"""[build-system]
-requires = ["setuptools>=42", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "{PACKAGE_NAME}"
-version = "{get_version()}"
-description = "{DESCRIPTION}"
-readme = "README.md"
-requires-python = "{PYTHON_REQUIRES}"
-authors = [
-    {{ name = "{AUTHOR}", email = "{AUTHOR_EMAIL}" }},
-]
-license = {{ text = "{LICENSE}" }}
-keywords = {KEYWORDS}
-classifiers = {CLASSIFIERS}
-dependencies = {REQUIREMENTS}
-
-[project.urls]
-homepage = "{URL}"
-{urls_toml}
-
-[project.optional-dependencies]
-{extras_toml_str}
-
-[tool.setuptools]
-packages = {find_packages(exclude=PACKAGE_EXCLUDES)}
-package-data = {PACKAGE_DATA_STR}
-include-package-data = true
-
-[tool.setuptools.dynamic]
-version = {{ attr = "{PACKAGE_NAME}.__version__" }}
-readme = {{ file = ["README.md"] }}
-"""
-
-    with open("pyproject.toml", "w", encoding="utf-8") as f:
-        f.write(pyproject_content)
-    print("pyproject.toml generated successfully!")
-
-# generate_pyproject_toml()