morebuiltins 0.0.1__tar.gz

morebuiltins-0.0.1/.github/workflows/pythonpackage.yml

@@ -0,0 +1,59 @@
+name: Python package
+
+on:
+    push:
+        branches:
+            - main
+            - master
+
+jobs:
+    test-linux:
+        runs-on: ubuntu-latest
+        strategy:
+            max-parallel: 3
+            matrix:
+                python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        timeout-minutes: 3
+        steps:
+            - uses: actions/checkout@v4
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v4
+              with:
+                  python-version: ${{ matrix.python-version }}
+            - name: Test
+              run: |
+                  python test.py
+
+    test-mac:
+        runs-on: macos-latest
+        strategy:
+            max-parallel: 3
+            matrix:
+                python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        timeout-minutes: 3
+        steps:
+            - uses: actions/checkout@v4
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v4
+              with:
+                  python-version: ${{ matrix.python-version }}
+            - name: Test
+              run: |
+                  python test.py
+
+    test-win32:
+        runs-on: windows-latest
+        strategy:
+            max-parallel: 3
+            matrix:
+                python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        timeout-minutes: 3
+        steps:
+            - uses: actions/checkout@v4
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v4
+              with:
+                  python-version: ${{ matrix.python-version }}
+            - name: Test
+              run: |
+                  python test.py

morebuiltins-0.0.1/.gitignore

@@ -0,0 +1,133 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# .vscode
+.vscode/
+temp*.py

morebuiltins-0.0.1/LICENSE

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

morebuiltins-0.0.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: morebuiltins
+Version: 0.0.1
+Summary: Things which I thought should be set in builtins.
+Author-email: ClericPy <clericpy@gmail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Project-URL: Home, https://github.com/ClericPy/morebuiltins
+
+# morebuiltins
+
+> I need much more built-ins
+
+## Purpose
+
+1. Collect commonly used code snippets to make up for the lack of built-in functions
+2. Provide some common ideas for beginners
+3. Stay Hungry, Stay Foolish
+
+## Doc
+
+---
+
+Module Docs - https://github.com/ClericPy/morebuiltins/blob/master/doc.md
+
+<!-- start -->
+## 1. morebuiltins.utils
+
+1.1 `ttime` - Converts a timestamp to a human-readable timestring formatted as %Y-%m-%d %H:%M:%S.
+
+1.2 `ptime` - Converts a timestring formatted as %Y-%m-%d %H:%M:%S back into a timestamp.
+
+1.3 `slice_into_pieces` - Divides a sequence into “n” segments, returning a generator that yields “n” pieces.
+
+1.4 `slice_by_size` - Slices a sequence into chunks of a specified “size”, returning a generator that produces tuples of chunks.
+
+1.5 `unique` - Removes duplicate elements from a sequence while preserving the original order efficiently.
+
+1.6 `retry` - A decorator that retries the decorated function up to “tries” times if the specified exceptions are raised.
+
+1.7 `guess_interval` - Analyzes a sequence of numbers and returns the median, calculating intervals only if they are greater than or equal to the specified accuracy.
+
+1.8 `get_hash` - Generates an MD5 hash string from the given input string.
+
+1.9 `find_jsons` - A generator that locates valid JSON strings, supporting only dictionaries and lists.
+
+1.10 `code_inline` - Minifies Python source code into a single line.
+
+1.11 `read_size` - Converts byte counts into a human-readable string. Setting shorten=True and precision=0.99 will trim unnecessary decimal places from the tail of floating-point numbers.
+
+1.12 `read_time` - Converts seconds into a more readable time duration string.
+
+1.13 `Validator` - Validator for dataclasses.
+
+1.14 `stagger_sort` - Ensures that identical groups are ordered and evenly distributed, mitigating data skew. The function does not alter the original list and returns a generator.
+
+1.15 `default_dict` - Initializes a dictionary with default zero values based on a subclass of TypedDict.
+
+1.16 `always_return_value` - Got a function always return the given value.
+
+1.17 `format_error` - Extracts frame information from an exception, with an option to filter out “site-packages” details by default.
+
+1.18 `Trie` - Transforms a standard dictionary into a trie structure that supports prefix matching.
+
+1.19 `GuessExt` - Determines whether the input bytes of a file prefix indicate a compressed file format.
+
+
+## 2. morebuiltins.functools
+
+2.1 `lru_cache_ttl` - A Least Recently Used (LRU) cache with a Time To Live (TTL) feature.
+
+2.2 `threads` - Quickly convert synchronous functions to be concurrency-able. (similar to madisonmay/Tomorrow)
+
+
+## 3. morebuiltins.ipc
+
+3.1 `IPCEncoder` - An abstract base class for all encoders; implementing the necessary communication protocol requires only the definition of two abstract methods. Be mindful that varying header lengths will impact the maximum packaging size.
+
+3.4 `SocketLogHandlerEncoder` - For a practical demonstration, refer to the test code: morebuiltins\ipc.py:_test_ipc_logging.
+
+3.5 `SocketServer` - To see an example in action, view the test code: morebuiltins\ipc.py:_test_ipc.
+
+
+## 4. morebuiltins.request
+
+4.1 `req` - A basic mock for requests, performant albeit simplistic.
+
+4.2 `DomainParser` - Extracts the Second-level domain (SLD) from a provided hostname or URL.
+
+4.3 `unparse_qsl` - Provides the inverse operation of parse_qsl, converting query string lists back into a URL-encoded string.
+
+4.4 `update_url` - Organizes the query arguments within a URL to standardize its format.
+
+
+<!-- end -->
+
+## On the way
+
+1. TimeSizeRotatingHandler of logging.handlers
+2. progress_bar
+3. http.server (upload)
+4. function parser (signature.parameters)
+5. time reaches
+6. quick tkinter
+7. http parser (request/response)
+8. asyncio free-flying tasks
+

morebuiltins-0.0.1/README.md

@@ -0,0 +1,97 @@
+# morebuiltins
+
+> I need much more built-ins
+
+## Purpose
+
+1. Collect commonly used code snippets to make up for the lack of built-in functions
+2. Provide some common ideas for beginners
+3. Stay Hungry, Stay Foolish
+
+## Doc
+
+---
+
+Module Docs - https://github.com/ClericPy/morebuiltins/blob/master/doc.md
+
+<!-- start -->
+## 1. morebuiltins.utils
+
+1.1 `ttime` - Converts a timestamp to a human-readable timestring formatted as %Y-%m-%d %H:%M:%S.
+
+1.2 `ptime` - Converts a timestring formatted as %Y-%m-%d %H:%M:%S back into a timestamp.
+
+1.3 `slice_into_pieces` - Divides a sequence into “n” segments, returning a generator that yields “n” pieces.
+
+1.4 `slice_by_size` - Slices a sequence into chunks of a specified “size”, returning a generator that produces tuples of chunks.
+
+1.5 `unique` - Removes duplicate elements from a sequence while preserving the original order efficiently.
+
+1.6 `retry` - A decorator that retries the decorated function up to “tries” times if the specified exceptions are raised.
+
+1.7 `guess_interval` - Analyzes a sequence of numbers and returns the median, calculating intervals only if they are greater than or equal to the specified accuracy.
+
+1.8 `get_hash` - Generates an MD5 hash string from the given input string.
+
+1.9 `find_jsons` - A generator that locates valid JSON strings, supporting only dictionaries and lists.
+
+1.10 `code_inline` - Minifies Python source code into a single line.
+
+1.11 `read_size` - Converts byte counts into a human-readable string. Setting shorten=True and precision=0.99 will trim unnecessary decimal places from the tail of floating-point numbers.
+
+1.12 `read_time` - Converts seconds into a more readable time duration string.
+
+1.13 `Validator` - Validator for dataclasses.
+
+1.14 `stagger_sort` - Ensures that identical groups are ordered and evenly distributed, mitigating data skew. The function does not alter the original list and returns a generator.
+
+1.15 `default_dict` - Initializes a dictionary with default zero values based on a subclass of TypedDict.
+
+1.16 `always_return_value` - Got a function always return the given value.
+
+1.17 `format_error` - Extracts frame information from an exception, with an option to filter out “site-packages” details by default.
+
+1.18 `Trie` - Transforms a standard dictionary into a trie structure that supports prefix matching.
+
+1.19 `GuessExt` - Determines whether the input bytes of a file prefix indicate a compressed file format.
+
+
+## 2. morebuiltins.functools
+
+2.1 `lru_cache_ttl` - A Least Recently Used (LRU) cache with a Time To Live (TTL) feature.
+
+2.2 `threads` - Quickly convert synchronous functions to be concurrency-able. (similar to madisonmay/Tomorrow)
+
+
+## 3. morebuiltins.ipc
+
+3.1 `IPCEncoder` - An abstract base class for all encoders; implementing the necessary communication protocol requires only the definition of two abstract methods. Be mindful that varying header lengths will impact the maximum packaging size.
+
+3.4 `SocketLogHandlerEncoder` - For a practical demonstration, refer to the test code: morebuiltins\ipc.py:_test_ipc_logging.
+
+3.5 `SocketServer` - To see an example in action, view the test code: morebuiltins\ipc.py:_test_ipc.
+
+
+## 4. morebuiltins.request
+
+4.1 `req` - A basic mock for requests, performant albeit simplistic.
+
+4.2 `DomainParser` - Extracts the Second-level domain (SLD) from a provided hostname or URL.
+
+4.3 `unparse_qsl` - Provides the inverse operation of parse_qsl, converting query string lists back into a URL-encoded string.
+
+4.4 `update_url` - Organizes the query arguments within a URL to standardize its format.
+
+
+<!-- end -->
+
+## On the way
+
+1. TimeSizeRotatingHandler of logging.handlers
+2. progress_bar
+3. http.server (upload)
+4. function parser (signature.parameters)
+5. time reaches
+6. quick tkinter
+7. http parser (request/response)
+8. asyncio free-flying tasks