really-good-things 0.1.0__tar.gz

really_good_things-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 J.Hu
+
+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.

really_good_things-0.1.0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: really-good-things
+Version: 0.1.0
+Summary: Relly Good Things.
+Author-email: "J.Hu" <joestarhu@163.com>
+License: MIT
+Project-URL: homepage, https://github.com/joestarhu/rgt
+Classifier: Environment :: Web Environment
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bcrypt>=5.0.0
+Requires-Dist: pycryptodomex>=3.23.0
+Requires-Dist: python-jose>=3.5.0
+Provides-Extra: security
+Requires-Dist: python-jose; extra == "security"
+Requires-Dist: bcrypt; extra == "security"
+Requires-Dist: pycryptodomex; extra == "security"
+Dynamic: license-file
+
+# rgt
+Really Good Things(RGT)

really_good_things-0.1.0/README.md

@@ -0,0 +1,2 @@
+# rgt
+Really Good Things(RGT)

really_good_things-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools >= 80.9.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "really-good-things"
+version = "0.1.0"
+description = "Relly Good Things."
+readme = "README.md"
+requires-python = ">=3.14"
+license = {text = "MIT"} 
+authors = [
+    {name = "J.Hu", email = "joestarhu@163.com"}
+]
+urls = {homepage = "https://github.com/joestarhu/rgt"}  # GitHub 链接作为主页
+classifiers = [
+    "Environment :: Web Environment",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Programming Language :: Python :: 3.14"
+]
+dependencies = [
+    "bcrypt>=5.0.0",
+    "pycryptodomex>=3.23.0",
+    "python-jose>=3.5.0",
+]
+
+
+[project.optional-dependencies]
+security = ["python-jose", "bcrypt", "pycryptodomex"]
+
+[tool.setuptools.packages.find]
+exclude = ["test", "examples", "script", "tutorials"]
+
+[tool.setuptools]
+zip-safe = true

really_good_things-0.1.0/really_good_things.egg-info/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: really-good-things
+Version: 0.1.0
+Summary: Relly Good Things.
+Author-email: "J.Hu" <joestarhu@163.com>
+License: MIT
+Project-URL: homepage, https://github.com/joestarhu/rgt
+Classifier: Environment :: Web Environment
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bcrypt>=5.0.0
+Requires-Dist: pycryptodomex>=3.23.0
+Requires-Dist: python-jose>=3.5.0
+Provides-Extra: security
+Requires-Dist: python-jose; extra == "security"
+Requires-Dist: bcrypt; extra == "security"
+Requires-Dist: pycryptodomex; extra == "security"
+Dynamic: license-file
+
+# rgt
+Really Good Things(RGT)

really_good_things-0.1.0/really_good_things.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+really_good_things.egg-info/PKG-INFO
+really_good_things.egg-info/SOURCES.txt
+really_good_things.egg-info/dependency_links.txt
+really_good_things.egg-info/requires.txt
+really_good_things.egg-info/top_level.txt
+really_good_things.egg-info/zip-safe
+rgt/__init__.py
+rgt/security/__init__.py
+rgt/security/cipher_utils.py
+rgt/security/hash_utils.py
+rgt/security/jwt_utils.py

really_good_things-0.1.0/really_good_things.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

really_good_things-0.1.0/really_good_things.egg-info/requires.txt

@@ -0,0 +1,8 @@
+bcrypt>=5.0.0
+pycryptodomex>=3.23.0
+python-jose>=3.5.0
+
+[security]
+python-jose
+bcrypt
+pycryptodomex

really_good_things-0.1.0/really_good_things.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+rgt

really_good_things-0.1.0/really_good_things.egg-info/zip-safe

@@ -0,0 +1 @@
+

really_good_things-0.1.0/rgt/security/__init__.py

@@ -0,0 +1,5 @@
+from .hash_utils import HashUtils
+from .jwt_utils import JWTManager
+from .cipher_utils import AESECBManager
+
+__all__ = ["HashUtils", "JWTManager", "AESECBManager"]

really_good_things-0.1.0/rgt/security/cipher_utils.py

@@ -0,0 +1,83 @@
+from base64 import b64decode, b64encode
+from Cryptodome.Cipher import AES
+from Cryptodome.Util.Padding import pad, unpad
+
+
+class AESECBManager:
+    def __init__(self, key: str) -> None:
+        """
+        Args:
+            key(str):秘钥,长度必须为 16,24,32
+        """
+
+        # ECB模式,加密结果固定
+        self._cipher = AES.new(key.encode(), AES.MODE_ECB)
+
+    @property
+    def cipher(self):
+        return self._cipher
+
+    def encrypt(self, plain_text: str) -> str:
+        """加密:pad->encrypt->b64encode
+        """
+
+        # 对明文进行补全至块大小的填充
+        padded_text = pad(plain_text.encode(), AES.block_size)
+
+        # 加密
+        ciphertext = self.cipher.encrypt(padded_text)
+
+        # 返回Base64编码的密文
+        return b64encode(ciphertext).decode()
+
+    def decrypt(self, encrypted_value: str) -> str:
+        """解密:b64decode->decrypt->unpad
+        """
+
+        # 将Base64编码的密文解码为字节
+        ciphertext = b64decode(encrypted_value)
+
+        # 解密
+        decrypted_text = unpad(self.cipher.decrypt(ciphertext), AES.block_size)
+
+        # 将解密后的字节串转换回字符串
+        return decrypted_text.decode()
+
+    def phone_encrypt(self, plain_text: str) -> str:
+        """加密手机号;手机号按照每3位组成一段密文,然后拼接而成;
+        如:18012345678,分为 180,801,012,123,......678;
+        使用AES ECB模式加密,保障同样的明文输出同样的密文,用于手机号的模糊匹配
+
+        Args:
+            plain_text:手机号明文,例如:18012345678
+
+        Returns:
+            str:加密后的手机号
+        """
+        if (length := len(plain_text)) == 0:
+            return ""
+
+        end_pos = max(length-3, 0)
+        return ",".join([self.encrypt(plain_text[i:i+3]) for i in range(end_pos+1)])
+
+    def phone_decrypt(self, encrypted_text: str, mask: bool = True) -> str:
+        """解密手机号
+
+        Args:
+            encrypted_text:加密的手机号
+            mask: 是否脱敏显示,比如180****5678        
+
+        Returns:
+            str:手机号明文
+        """
+        if not encrypted_text:
+            return ""
+
+        phone_array = [self.decrypt(v) for v in encrypted_text.split(",")]
+        phone = "".join([phone_array[i][0]
+                        for i in range(8)]) + phone_array[-1]
+
+        if mask:
+            phone = f"{phone[:3]}****{phone[7:]}"
+
+        return phone

really_good_things-0.1.0/rgt/security/hash_utils.py

@@ -0,0 +1,11 @@
+from bcrypt import hashpw, checkpw, gensalt
+
+
+class HashUtils:
+    @staticmethod
+    def hash(plain: str, rounds: int = 12) -> str:
+        return hashpw(plain.encode(), gensalt(rounds=rounds)).decode()
+
+    @staticmethod
+    def verify(plain: str, hashed: str) -> bool:
+        return checkpw(plain.encode(), hashed.encode())

really_good_things-0.1.0/rgt/security/jwt_utils.py

@@ -0,0 +1,67 @@
+from datetime import datetime, timedelta, timezone
+from typing import Dict, Any
+from uuid import uuid4
+from jose import jwt
+
+
+class JWTManager:
+    def __init__(self, key: str, exp_min: float, algorithm: str = "HS256") -> None:
+        """
+        实例化JWT的管理类
+
+        Args:
+            key(str):jwt加密用的秘钥,可通过openssl rand -base 32 生成
+            exp_min(float): jwt的过期时间(分钟)
+            algorithm(str): jwt加密算法,默认"HS256"
+        """
+        self._key = key
+        self._exp_min = exp_min
+        self._algorithm = algorithm
+
+    @property
+    def key(self) -> str:
+        return self._key
+
+    @property
+    def exp_min(self) -> float:
+        return self._exp_min
+
+    @property
+    def algorithm(self) -> str:
+        return self._algorithm
+
+    def encode(self, **kw) -> str:
+        """
+        JWT编码, 自动设置jti,iat,exp参数
+
+        Args:
+            **kw:payload参数
+        """
+        iat = datetime.now(tz=timezone.utc)
+        exp = iat + timedelta(minutes=self.exp_min)
+
+        payload = kw | {
+            "jti": uuid4().hex,
+            "iat": iat,
+            "exp": exp,
+        }
+
+        return jwt.encode(
+            claims=payload,
+            key=self.key,
+            algorithm=self.algorithm
+        )
+
+    def decode(self, token: str) -> Dict[str, Any]:
+        """
+        JWT解码
+
+        Args:
+            token(str):json web token字符串
+
+        """
+        return jwt.decode(
+            token=token,
+            key=self.key,
+            algorithms=self.algorithm
+        )

really_good_things-0.1.0/setup.cfg

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