ddeutil 0.4.0

Data Developer & Engineer Core Utility Objects

Core Data Utility

The Core Data Utility package implements the data utility functions and objects that was created on sub-package namespace, ddeutil, design for independent installation.

I make this package able to extend with any sub-extension with this namespace. So, this namespace able to scale-out the requirement with folder level design. You can add any custom features and import it by import ddeutil.{extension}.

[!NOTE] This package provide the base utility functions and objects for any sub-namespace package.

:round_pushpin: Installation

pip install -U ddeutil

Python version supported:

Python Version	Installation	Support Fixed Bug
>=3.9,<3.14	pip install -U ddeutil	:heavy_check_mark:

[!NOTE] If you want to install all optional dependencies for this package, you can use pip install -U ddeutil[all]. I will install ujson and python-dateutil packages for some functions in this project such as hash.checksum, dtutils.next_date_with_freq.

:dart: Features

This core data package will implement all of utility functions and objects that does not re-create again because it is basic code but has a lot of using require.

Module	Name	Type	Description	Remark
base	isinstance_check	function
base.cache	memorize	function	Return a cachable function that keep all arguments and pass to string type for keeping it in the caching key.
	property_memorize	function
	clear_cache	function
base.checker	can_int	function
	is_int	function
base.convert
base.hash
base.merge
base.sorting
base.splitter
decorator
dtutils	replace_date	function
	next_date	function
	closest_quarter	function
	last_dom	function
	last_doq	function
	next_date_freq	function
	calc_data_freq	function
threader	ThreadWithControl	object	Threading object that can control maximum background agent and result after complete.

:beers: Usages

OnlyOne

from ddeutil.core import onlyone

assert 'a' == onlyone(['a', 'b'], ['a', 'b', 'c'])
assert 'c' == onlyone(('a', 'b'), ['c', 'e', 'f'])
assert onlyone(['a', 'b'], ['c', 'e', 'f'], default=False) is None

Instance Check

from ddeutil.core import isinstance_check
from typing import Union, Optional

assert isinstance_check("s", str)
assert isinstance_check(["s"], list[str])
assert isinstance_check(("s", "t"), tuple[str, ...])
assert not isinstance_check(("s", "t"), tuple[str])
assert isinstance_check({"s": 1, "d": "r"}, dict[str, Union[int, str]])
assert isinstance_check("s", Optional[str])
assert isinstance_check(1, Optional[Union[str, int]])
assert not isinstance_check("s", list[str])