qsu 0.1.0__tar.gz

qsu-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+.pytest_cache/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/

qsu-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 CDGet <jooy2.contact@gmail.com> (https://cdget.com).
+
+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

qsu-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: qsu
+Version: 0.1.0
+Summary: qsu is a utility library that contains useful and frequently used functions. Start with your preferred language and the modern development environment.
+Project-URL: Homepage, https://qsu.cdget.com
+Project-URL: Repository, https://github.com/jooy2/qsu
+Project-URL: Bug Tracker, https://github.com/jooy2/qsu/issues
+Project-URL: Changelog, https://qsu.cdget.com/changelog/python
+Author-email: CDGet <jooy2.contact@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2021-2026 CDGet <jooy2.contact@gmail.com> (https://cdget.com).
+        
+        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
+License-File: LICENSE
+Keywords: array,date,format,helper,math,string,tool,toolkit,util,utility,verify
+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.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Requires-Dist: cryptography>=42.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# qsu - Quick & Simple Utility (Python)
+
+**qsu** is a library that collects frequently used utility functions.
+
+## Installation
+
+**qsu** requires `Python 3.8` or later.
+
+```bash
+$ pip install qsu
+```
+
+## How to use
+
+```python
+from qsu import capitalizeFirst, strCount
+
+print(capitalizeFirst('abcd'))  # 'Abcd'
+print(strCount('123412341234', '1'))  # 3
+```
+
+For more information on all supported functions, see the [Reference](https://qsu.cdget.com/reference) documentation.
+
+## License
+
+Please see the [LICENSE](LICENSE) file for more information.

qsu-0.1.0/README.md

@@ -0,0 +1,26 @@
+# qsu - Quick & Simple Utility (Python)
+
+**qsu** is a library that collects frequently used utility functions.
+
+## Installation
+
+**qsu** requires `Python 3.8` or later.
+
+```bash
+$ pip install qsu
+```
+
+## How to use
+
+```python
+from qsu import capitalizeFirst, strCount
+
+print(capitalizeFirst('abcd'))  # 'Abcd'
+print(strCount('123412341234', '1'))  # 3
+```
+
+For more information on all supported functions, see the [Reference](https://qsu.cdget.com/reference) documentation.
+
+## License
+
+Please see the [LICENSE](LICENSE) file for more information.

qsu-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "qsu"
+version = "0.1.0"
+description = "qsu is a utility library that contains useful and frequently used functions. Start with your preferred language and the modern development environment."
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "CDGet", email = "jooy2.contact@gmail.com" }]
+requires-python = ">=3.8"
+dependencies = ["cryptography>=42.0"]
+keywords = [
+    "util",
+    "utility",
+    "tool",
+    "toolkit",
+    "helper",
+    "array",
+    "string",
+    "date",
+    "math",
+    "verify",
+    "format",
+]
+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.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://qsu.cdget.com"
+Repository = "https://github.com/jooy2/qsu"
+"Bug Tracker" = "https://github.com/jooy2/qsu/issues"
+Changelog = "https://qsu.cdget.com/changelog/python"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["qsu"]
+
+[tool.hatch.build.targets.sdist]
+include = ["qsu", "README.md", "LICENSE"]

qsu-0.1.0/qsu/__init__.py

@@ -0,0 +1,56 @@
+"""qsu - Quick & Simple Utility.
+
+A utility library that collects frequently used functions.
+This package mirrors the JavaScript implementation of qsu.
+
+Unlike the JavaScript package (where filesystem/OS/network/crypto helpers live
+under `qsu/node`), Python has no browser/runtime split, so every function is
+importable directly from the top-level `qsu` package.
+"""
+
+from . import (
+	array,
+	crypto,
+	date,
+	file,
+	format,
+	math,
+	misc,
+	net,
+	object,
+	os,
+	string,
+	verify,
+	web,
+)
+from .array import *  # noqa: F401,F403
+from .crypto import *  # noqa: F401,F403
+from .date import *  # noqa: F401,F403
+from .file import *  # noqa: F401,F403
+from .format import *  # noqa: F401,F403
+from .math import *  # noqa: F401,F403
+from .misc import *  # noqa: F401,F403
+from .net import *  # noqa: F401,F403
+from .object import *  # noqa: F401,F403
+from .os import *  # noqa: F401,F403
+from .string import *  # noqa: F401,F403
+from .verify import *  # noqa: F401,F403
+from .web import *  # noqa: F401,F403
+
+__version__ = '0.1.0'
+
+__all__ = [
+	*array.__all__,
+	*crypto.__all__,
+	*date.__all__,
+	*file.__all__,
+	*format.__all__,
+	*math.__all__,
+	*misc.__all__,
+	*net.__all__,
+	*object.__all__,
+	*os.__all__,
+	*string.__all__,
+	*verify.__all__,
+	*web.__all__,
+]

qsu-0.1.0/qsu/array/__init__.py

@@ -0,0 +1,29 @@
+from .arrCount import arrCount
+from .arrGroupByMaxCount import arrGroupByMaxCount
+from .arrMove import arrMove
+from .arrPick import arrPick
+from .arrRepeat import arrRepeat
+from .arrShuffle import arrShuffle
+from .arrTo1dArray import arrTo1dArray
+from .arrUnique import arrUnique
+from .arrWithDefault import arrWithDefault
+from .arrWithNumber import arrWithNumber
+from .average import average
+from .sortByObjectKey import sortByObjectKey
+from .sortNumeric import sortNumeric
+
+__all__ = [
+	'arrCount',
+	'arrGroupByMaxCount',
+	'arrMove',
+	'arrPick',
+	'arrRepeat',
+	'arrShuffle',
+	'arrTo1dArray',
+	'arrUnique',
+	'arrWithDefault',
+	'arrWithNumber',
+	'average',
+	'sortByObjectKey',
+	'sortNumeric',
+]

qsu-0.1.0/qsu/array/arrCount.py

@@ -0,0 +1,8 @@
+def arrCount(array: list) -> dict:
+	result = {}
+
+	for item in array:
+		key = str(item)
+		result[key] = result.get(key, 0) + 1
+
+	return result

qsu-0.1.0/qsu/array/arrGroupByMaxCount.py

@@ -0,0 +1,15 @@
+def arrGroupByMaxCount(array: list, maxLengthPerGroup: int = 1) -> list:
+	result = []
+	tempArray = []
+
+	for item in array:
+		if len(tempArray) == maxLengthPerGroup:
+			result.append(tempArray)
+			tempArray = []
+
+		tempArray.append(item)
+
+	if len(tempArray) > 0:
+		result.append(tempArray)
+
+	return result

qsu-0.1.0/qsu/array/arrMove.py

@@ -0,0 +1,9 @@
+def arrMove(array: list, fromIndex: int, to: int) -> list:
+	arrayLength = len(array)
+
+	if arrayLength <= fromIndex or arrayLength <= to:
+		raise Exception('Invalid move params')
+
+	array.insert(to, array.pop(fromIndex))
+
+	return array

qsu-0.1.0/qsu/array/arrPick.py

@@ -0,0 +1,8 @@
+import random
+
+
+def arrPick(array: list):
+	if not array or not isinstance(array, list) or len(array) < 1:
+		return None
+
+	return array[int(random.random() * len(array))]

qsu-0.1.0/qsu/array/arrRepeat.py

@@ -0,0 +1,17 @@
+from ..verify.isObject import isObject
+
+
+def arrRepeat(array, count: int) -> list:
+	if not array or count < 1 or not isinstance(array, (list, tuple, dict)):
+		return []
+
+	isObj = isObject(array)
+	result = []
+
+	for _ in range(count):
+		if isObj:
+			result.append(array)
+		else:
+			result.extend(array)
+
+	return result

qsu-0.1.0/qsu/array/arrShuffle.py

@@ -0,0 +1,15 @@
+import math
+import random
+
+
+def arrShuffle(array: list):
+	if len(array) == 1:
+		return array[0]
+
+	newArray = array
+
+	for i in range(len(array) - 1, 0, -1):
+		j = math.floor(random.random() * (i + 1))
+		newArray[i], newArray[j] = array[j], array[i]
+
+	return newArray

qsu-0.1.0/qsu/array/arrTo1dArray.py

@@ -0,0 +1,18 @@
+from ..verify.is2dArray import is2dArray
+
+
+def arrTo1dArray(array: list) -> list:
+	def convert1dArray(arr: list) -> list:
+		tempArr = []
+
+		for item in arr:
+			if not isinstance(item, (list, tuple)):
+				tempArr.append(item)
+			elif is2dArray(item):
+				tempArr.extend(convert1dArray(item))
+			else:
+				tempArr.extend(item)
+
+		return tempArr
+
+	return convert1dArray(array)

qsu-0.1.0/qsu/array/arrUnique.py

@@ -0,0 +1,28 @@
+import json
+
+from ..verify.is2dArray import is2dArray
+
+
+def arrUnique(array: list) -> list:
+	if is2dArray(array):
+		seen = set()
+		result = []
+
+		for item in array:
+			key = json.dumps(item, separators=(',', ':'))
+
+			if key not in seen:
+				seen.add(key)
+				result.append(json.loads(key))
+
+		return result
+
+	seen = []
+	result = []
+
+	for item in array:
+		if not any(existing is item or (type(existing) is type(item) and existing == item) for existing in seen):
+			seen.append(item)
+			result.append(item)
+
+	return result

qsu-0.1.0/qsu/array/arrWithDefault.py

@@ -0,0 +1,5 @@
+def arrWithDefault(defaultValue, length: int = 0) -> list:
+	if length < 1:
+		return []
+
+	return [defaultValue] * length

qsu-0.1.0/qsu/array/arrWithNumber.py

@@ -0,0 +1,5 @@
+def arrWithNumber(start: int, end: int) -> list:
+	if start > end:
+		raise Exception('`end` is greater than `start`.')
+
+	return list(range(start, end + 1))

qsu-0.1.0/qsu/array/average.py

@@ -0,0 +1,2 @@
+def average(array: list) -> float:
+	return sum(array) / len(array)

qsu-0.1.0/qsu/array/sortByObjectKey.py

@@ -0,0 +1,20 @@
+from .sortNumeric import _naturalKey
+
+
+def sortByObjectKey(
+	array: list,
+	key: str,
+	descending: bool = False,
+	numerically: bool = False,
+) -> list:
+	if numerically:
+		array.sort(key=lambda item: _naturalKey(item[key]))
+
+		if descending:
+			array.reverse()
+
+		return array
+
+	array.sort(key=lambda item: item[key], reverse=descending)
+
+	return array

qsu-0.1.0/qsu/array/sortNumeric.py

@@ -0,0 +1,16 @@
+import re
+
+
+def _naturalKey(value: str):
+	parts = re.split(r'(\d+)', str(value))
+
+	return [(0, int(part)) if part.isdigit() else (1, part) for part in parts if part != '']
+
+
+def sortNumeric(array: list, descending: bool = False) -> list:
+	array.sort(key=_naturalKey)
+
+	if descending:
+		array.reverse()
+
+	return array

qsu-0.1.0/qsu/crypto/__init__.py

@@ -0,0 +1,23 @@
+from .decodeBase64 import decodeBase64
+from .decrypt import decrypt
+from .encodeBase64 import encodeBase64
+from .encrypt import encrypt
+from .md5Hash import md5Hash
+from .numberHash import numberHash
+from .objectId import objectId
+from .sha1Hash import sha1Hash
+from .sha256Hash import sha256Hash
+from .sha512Hash import sha512Hash
+
+__all__ = [
+	'decodeBase64',
+	'decrypt',
+	'encodeBase64',
+	'encrypt',
+	'md5Hash',
+	'numberHash',
+	'objectId',
+	'sha1Hash',
+	'sha256Hash',
+	'sha512Hash',
+]

qsu-0.1.0/qsu/crypto/decodeBase64.py

@@ -0,0 +1,5 @@
+import base64
+
+
+def decodeBase64(encodedStr: str) -> str:
+	return base64.b64decode(encodedStr).decode('utf-8')

qsu-0.1.0/qsu/crypto/decrypt.py

@@ -0,0 +1,34 @@
+import base64
+
+from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
+
+
+def decrypt(
+	str: str,
+	secret: str,
+	algorithm: str = 'aes-256-cbc',
+	toBase64: bool = False,
+) -> str:
+	if not str or len(str) < 1:
+		return ''
+
+	arrStr = str.split(':')
+	iv_part = arrStr.pop(0)
+	enc_part = ':'.join(arrStr)
+
+	if toBase64:
+		iv = base64.b64decode(iv_part)
+		enc = base64.b64decode(enc_part)
+	else:
+		iv = bytes.fromhex(iv_part)
+		enc = bytes.fromhex(enc_part)
+
+	cipher = Cipher(algorithms.AES(secret.encode('utf-8')), modes.CBC(iv))
+	decryptor = cipher.decryptor()
+	decrypted = decryptor.update(enc) + decryptor.finalize()
+
+	# Remove PKCS7 padding.
+	pad_len = decrypted[-1]
+	decrypted = decrypted[:-pad_len]
+
+	return decrypted.decode('utf-8')

qsu-0.1.0/qsu/crypto/encodeBase64.py

@@ -0,0 +1,5 @@
+import base64
+
+
+def encodeBase64(str: str) -> str:
+	return base64.b64encode(str.encode('utf-8')).decode('utf-8')

qsu-0.1.0/qsu/crypto/encrypt.py

@@ -0,0 +1,35 @@
+import base64
+import os
+
+from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
+
+
+def encrypt(
+	str: str,
+	secret: str,
+	algorithm: str = 'aes-256-cbc',
+	ivSize: int = 16,
+	toBase64: bool = False,
+) -> str:
+	if not str or len(str) < 1:
+		return ''
+
+	iv = os.urandom(ivSize)
+	cipher = Cipher(algorithms.AES(secret.encode('utf-8')), modes.CBC(iv))
+	encryptor = cipher.encryptor()
+
+	data = str.encode('utf-8')
+	block_size = 16
+	pad_len = block_size - (len(data) % block_size)
+	padded = data + bytes([pad_len]) * pad_len
+
+	enc = encryptor.update(padded) + encryptor.finalize()
+
+	if toBase64:
+		iv_str = base64.b64encode(iv).decode('ascii')
+		enc_str = base64.b64encode(enc).decode('ascii')
+	else:
+		iv_str = iv.hex()
+		enc_str = enc.hex()
+
+	return f'{iv_str}:{enc_str}'

qsu-0.1.0/qsu/crypto/md5Hash.py

@@ -0,0 +1,19 @@
+import base64
+import hashlib
+from typing import Optional
+
+
+def md5Hash(str: str, encoding: Optional[str] = None) -> str:
+	digest = hashlib.md5(str.encode('utf-8')).digest()
+	enc = encoding or 'hex'
+
+	if enc == 'hex':
+		return digest.hex()
+	if enc == 'base64':
+		return base64.b64encode(digest).decode('ascii')
+	if enc == 'base64url':
+		return base64.urlsafe_b64encode(digest).decode('ascii').rstrip('=')
+	if enc == 'binary':
+		return digest.decode('latin-1')
+
+	raise ValueError(f'Unsupported encoding: {encoding}')

qsu-0.1.0/qsu/crypto/numberHash.py

@@ -0,0 +1,14 @@
+def numberHash(str: str) -> int:
+	if not str:
+		return 0
+
+	hash = 0
+
+	for ch in str:
+		hash = (hash << 5) - hash + ord(ch)
+		# Emulate JS `hash |= 0`: keep low 32 bits and interpret as signed.
+		hash &= 0xFFFFFFFF
+		if hash >= 0x80000000:
+			hash -= 0x100000000
+
+	return hash

qsu-0.1.0/qsu/crypto/objectId.py

@@ -0,0 +1,9 @@
+import secrets
+import time
+
+
+def objectId() -> str:
+	timestamp = format(int(time.time()), 'x')
+	random_hex = ''.join(format(secrets.randbelow(16), 'x') for _ in range(16))
+
+	return timestamp + random_hex

qsu-0.1.0/qsu/crypto/sha1Hash.py

@@ -0,0 +1,19 @@
+import base64
+import hashlib
+from typing import Optional
+
+
+def sha1Hash(str: str, encoding: Optional[str] = None) -> str:
+	digest = hashlib.sha1(str.encode('utf-8')).digest()
+	enc = encoding or 'hex'
+
+	if enc == 'hex':
+		return digest.hex()
+	if enc == 'base64':
+		return base64.b64encode(digest).decode('ascii')
+	if enc == 'base64url':
+		return base64.urlsafe_b64encode(digest).decode('ascii').rstrip('=')
+	if enc == 'binary':
+		return digest.decode('latin-1')
+
+	raise ValueError(f'Unsupported encoding: {encoding}')

qsu-0.1.0/qsu/crypto/sha256Hash.py

@@ -0,0 +1,19 @@
+import base64
+import hashlib
+from typing import Optional
+
+
+def sha256Hash(str: str, encoding: Optional[str] = None) -> str:
+	digest = hashlib.sha256(str.encode('utf-8')).digest()
+	enc = encoding or 'hex'
+
+	if enc == 'hex':
+		return digest.hex()
+	if enc == 'base64':
+		return base64.b64encode(digest).decode('ascii')
+	if enc == 'base64url':
+		return base64.urlsafe_b64encode(digest).decode('ascii').rstrip('=')
+	if enc == 'binary':
+		return digest.decode('latin-1')
+
+	raise ValueError(f'Unsupported encoding: {encoding}')