Things which I thought should be set in builtins.
Project description
morebuiltins
Project Overview:
This project enhances Python’s built-ins with extra functionality, prioritizing no third-party dependencies, performance, reusability, and MIT Licensing for flexible use.
- Minimal Dependencies: Designed to avoid third-party libraries for seamless integration, conflict prevention, and easy packaging via zipapp for pyz distribution.
- Performance-Driven: It prioritizes efficiency, ensuring enhanced built-ins maintain Python's performance standards.
- Self-Contained Modules: Functions and modules are standalone for simple reuse without dependencies.
- MIT Licensed: The open-source code is freely usable, modifiable, and distributable.
- Enhanced Built-ins: The project adds tools to Python's core functionality, simplifying and accelerating development.
Install
From pypi.org
pip install -U morebuiltins
Or use pyz
(pyz file may be downloaded from releases)
pip install zipapps
python -m zipapps -c -o morebuiltins.pyz morebuiltins
import sys
sys.path.insert(0, 'morebuiltins.pyz')
import morebuiltins
print(morebuiltins.__file__)
# morebuiltins.pyz\morebuiltins\__init__.py
Doc
Changelog comes after v0.0.6(2024-06-14)
Module Docs - https://github.com/ClericPy/morebuiltins/blob/master/doc.md
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.
1.20 xor_encode_decode
- Perform XOR encryption or decryption on the given data using a provided key.
1.21 is_running
- Check if the given process ID is running.
1.22 set_pid_file
- Sets a PID file to prevent multiple instances of a script or process from running concurrently.
1.23 get_paste
- This module offers a simple utility for retrieving text from the system clipboard with tkinter.
1.24 set_clip
- Copies the given text to the clipboard using a temporary file in a Windows environment.
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)
2.3 bg_task
- Avoid asyncio free-flying tasks, better to use the new asyncio.TaskGroup to avoid this in 3.11+. https://github.com/python/cpython/issues/91887
2.4 NamedLock
- Reusable named locks, support for timeouts, support for multiple concurrent locks.
2.5 FuncSchema
- Parse the parameters and types required by a function into a dictionary, and convert an incoming parameter into the appropriate type.
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.
3.7 find_free_port
- Finds and returns an available port number.
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.
4.6 make_response
- Generates an HTTP response based on the provided parameters.
4.7 custom_dns
- Custom the DNS of socket.getaddrinfo, only effect current thread.
5. morebuiltins.download_python
5.1 download_python
- Download python portable interpreter from https://github.com/indygreg/python-build-standalone/releases. python -m morebuiltins.download_python
On the way
- add zipapps as a submodule(https://github.com/ClericPy/zipapps) - v0.0.3
- asyncio free-flying tasks(bg_task) - v0.0.3
- named lock with timeout - v0.0.4
- functools.FuncSchema (parse function to get the query-dict) - v0.0.4
-
python -m morebuiltins.download_python
standalone python downloader - v0.0.4 -
from morebuiltins.zipapps import pip_install_target;pip_install_target("./mock_dir", ["six"], force=False, sys_path=0); import six;print(six.__file__)
- v0.0.5 - changelog.md
- progress_bar
- http.server (upload)
- time reach syntax
- quick tkinter
- http request/response parser
- TimeSizeRotatingHandler of logging.handlers
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for morebuiltins-0.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d45e0cc68872274ac437d78514ea4bb181059c2d3d4e052101e556c2a70e7435 |
|
MD5 | 88fbd9214269569ab9a9fdad788eb345 |
|
BLAKE2b-256 | 26802a93d9afc141e6eac68731ad6f5e19cab1a3db6ad38c596fc3e0105c775f |