pyutilities 2.1.1__tar.gz → 2.4.0.dev1__tar.gz

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: pyutilities
-Version: 2.1.1
-Summary: PyUtilities :: Useful python 3 utilities library for various use cases.
+Version: 2.4.0.dev1
+Summary: PyUtilities :: Useful python 3+ utilities library for various use cases.
 License-Expression: MIT
 License-File: LICENSE
-Keywords: Python Utilities,Useful Functions,String Utilities,CLI Functions,toolset,library,System Utilities
+Keywords: Python Utilities,Useful Functions,String Utilities,CLI Functions,toolset,library,System Utilities,Useful Decorators,IO Functions
 Author: Dmitrii Gusev
 Author-email: dmitry.ed.gusev@gmail.com
 Requires-Python: >=3.10,<4
@@ -13,10 +13,16 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 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: Programming Language :: Python :: 3.14
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
+Requires-Dist: click (>=8.3,<9.0)
 Requires-Dist: fake-useragent (>=2.0,<3.0)
 Requires-Dist: loguru (==0.7.3)
 Requires-Dist: markdown (>=3.7,<4.0)
@@ -25,9 +31,9 @@ Requires-Dist: paramiko (==4.*)
 Requires-Dist: prettytable (>=3.14,<4.0)
 Requires-Dist: pyyaml (==6.*)
 Requires-Dist: requests (>=2.32,<3.0)
-Requires-Dist: urllib3 (>=2.3,<3.0)
+Requires-Dist: urllib3 (>=2.6,<3.0)
 Requires-Dist: xlrd (>=2.0.1,<2.1.0)
-Requires-Dist: xlwings (>=0.33.9,<0.34.0)
+Requires-Dist: xlwings (>=0.35,<1.0)
 Requires-Dist: xlwt (==1.3.0)
 Project-URL: Bug Tracker, https://github.com/dmitry-ed-gusev/pyutilities/issues
 Project-URL: Documentation, https://github.com/dmitry-ed-gusev/pyutilities
@@ -37,8 +43,8 @@ Description-Content-Type: text/markdown
 
 # Python Utilities Library
 
-Version 2.1.1, 2018 - 2025, Dmitrii Gusev  
-*Last update: 25.11.2025*
+Version 2.2.0, 2018 - 2026, Dmitrii Gusev  
+*Last update: XX.XX.2026*
 
 ## Project Description
 
@@ -46,11 +52,18 @@ Useful utilities functions for various needs for the python 3.10+. Containing 'g
 
 ## Versions history
 
-### 2.1.1
+### 2.2.0
+
+Added new functions:
+
+- func1()
+- func2()
+
+### 2.1.2
 
 Major release with complete set of useful 'general purpose' functions. Documentation 'is coming'...
 
-**Warning! Version 2.1.0 is intended only for the python version = 3.10 and may be installed only for it!**
+**Warning! Versions 2.1.0, 2.1.1 are intended only for the python version = 3.10 and may be installed only for it!**
 
 ### Versions before 2.x.x
 

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/docs/README-PUB.md

@@ -1,7 +1,7 @@
 # Python Utilities Library
 
-Version 2.1.1, 2018 - 2025, Dmitrii Gusev  
-*Last update: 25.11.2025*
+Version 2.2.0, 2018 - 2026, Dmitrii Gusev  
+*Last update: XX.XX.2026*
 
 ## Project Description
 
@@ -9,11 +9,18 @@ Useful utilities functions for various needs for the python 3.10+. Containing 'g
 
 ## Versions history
 
-### 2.1.1
+### 2.2.0
+
+Added new functions:
+
+- func1()
+- func2()
+
+### 2.1.2
 
 Major release with complete set of useful 'general purpose' functions. Documentation 'is coming'...
 
-**Warning! Version 2.1.0 is intended only for the python version = 3.10 and may be installed only for it!**
+**Warning! Versions 2.1.0, 2.1.1 are intended only for the python version = 3.10 and may be installed only for it!**
 
 ### Versions before 2.x.x
 

pyutilities-2.4.0.dev1/pyproject.toml

@@ -0,0 +1,291 @@
+####################################################################################################
+#
+#   Main configuration file for the [pyutilities] library. The whole project configuration (any
+#   setting) should be put here. Also configuration for dependencies and all code quality tools.
+#
+#   Notes (code quality, etc.):
+#       - project line length = 110 symbols (black, flake8)
+#       - most of modules should be typed (used mypy stubs libraries)
+#
+#   Created:  Dmitrii Gusev, 30.05.2025
+#   Modified: Dmitrii Gusev, 19.04.2026
+#
+####################################################################################################
+
+# -- build system information
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+# -- project / poetry utility meta-information
+[project]
+name = "pyutilities"
+version = "2.4.0dev1"
+description = "PyUtilities :: Useful python 3+ utilities library for various use cases."
+authors     = [
+    {name = "Dmitrii Gusev", email = "dmitry.ed.gusev@gmail.com"},
+]
+license  = "MIT"
+readme   = "docs/README-PUB.md"
+requires-python = ">=3.10,<4"
+keywords    = [
+    "Python Utilities", "Useful Functions", "String Utilities", "CLI Functions", "toolset", "library",
+    "System Utilities", "Useful Decorators", "IO Functions"
+]
+classifiers = [
+    "Development Status :: 6 - Mature",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Topic :: Utilities",
+    "Typing :: Typed"
+]
+
+# - project runtime dependencies
+dependencies = [
+
+    "xlrd~=2.0.1",  # - allowed: >=2.0.1 <2.1.0
+    "xlwt==1.3.0",
+    "xlwings~=0.35",
+    "loguru==0.7.3",
+    "pyyaml==6.*",
+    "openpyxl==3.1.5",
+    "urllib3~=2.6",  # - allowed: >=2.3.0 <3.0.0
+    "paramiko==4.*",
+    "requests~=2.32",  # - allowed: >=2.32.0 <3.0.0
+    "markdown~=3.7",  # - allowed: >=3.7.0 <4.0.0
+    "prettytable~=3.14",  # - allowed: >=3.14.0 <4.0.0
+    "fake-useragent~=2.0",  # - allowed: >=2.0.0 <3.0.0
+    "click~=8.3"
+
+]
+
+# -- additional dependencies groups (test/research/etc. - not runtime)
+[dependency-groups]
+
+dev = [
+
+    # -- pytest library and extensions --
+    "pytest ==9.*",  # - allowed any version < 10.0.0
+    "pytest-env ==1.*",
+    "pytest-cov ==7.*",
+    "pytest-mock ==3.*",
+    "pytest-pep8 ==1.0.6",
+    "pytest-flakes ==4.0.5",
+    "pytest-isort ==4.0.0",
+    "pytest-black ==0.6.0",
+    "pytest-variables[hjson,yaml,toml] ==3.1.0",
+
+    # -- testing-related libraries --
+    "mock ==5.*",
+    "mockito ~=2",
+    "nose2 ==0.*",
+    "hypothesis ==6.*",
+
+    # -- typing libraries + typing stubs for runtime dependencies --
+    "mypy ==1.*", # - typing library
+    "types-six ==1.*",
+    "types-mock ==5.*",
+    "types-paramiko ==4.*",
+    "types-requests ==2.*",
+    "types-markdown ==3.*",
+    "types-PyYAML ==6.*",
+    "types-flake8-bugbear ==25.*",
+
+    # -- code quality control libraries
+    "flake8 ==7.*",
+    "flake8-pyproject ~=1.2",
+    "flake8-bandit ~=4.1",
+    "flake8-bugbear ==25.*",
+    "black ~=26.0", # - code formatter
+    "pylint ~=4.0",
+    "pre-commit ~=4.0", # - pre-commit hook
+    "bandit ==1.9.*",
+    "isort[requirements_deprecated_finder,pipfile_deprecated_finder] ==8.*",
+    "pyflakes ~=3.4",
+    "codeaudit ~=1.4", # - SAST local analysis
+
+    # -- profiling/debugging libraries
+    "snakeviz ==2.2.2",
+    "memory-profiler ==0.61.0",
+    "py-spy ==0.4.1",
+    "viztracer ==1.1.1",
+
+    # -- development-related process libraries
+    "sphinx ==8.* ; python_version == '3.10'", # - docs lib - for python == 3.10
+    "sphinx ==9.* ; python_version >= '3.11' and python_version < '4.0'", # - docs lib - for python > 3.10
+
+    "watchdog ==6.0.0", # - file monitor and auto-reloader
+    "responses ==0.*", # - used by many testing/code quality libraries
+
+    # -- readline module depending on the platform
+    "pyreadline3 ==3.5.4 ; sys_platform == 'win32' or sys_platform == 'cygwin'",
+    "gnureadline ==8.2.13 ; sys_platform != 'win32'"
+
+]
+
+research = [ # - research dependencies (Jupyter, etc.)
+
+    "notebook~=7.5"  # allowed < 8.0.0
+
+]
+
+[tool.poetry]
+packages = [{include = "pyutilities", from = "src"}]
+
+# -- poetry :: source repositories setup
+[[tool.poetry.source]]
+name = "severstal_repo"
+url = "https://repo.severstal.severstalgroup.com/artifactory/api/pypi/pypi/simple/"
+# priority = "primary" # - primary packages source
+priority = "supplemental" # - packages source will be used when primary is not available...
+
+[tool.poetry.dependencies]
+python = ">=3.10,<4"
+
+[project.urls]
+Homepage = "https://pypi.org/project/pyutilities"
+Repository = "https://github.com/dmitry-ed-gusev/pyutilities"
+Documentation = "https://github.com/dmitry-ed-gusev/pyutilities"
+"Bug Tracker" = "https://github.com/dmitry-ed-gusev/pyutilities/issues"
+
+[project.scripts]
+pyutils = 'pyutilities.cli.pyutils:pyutils'
+
+# -- flake8 tool
+[tool.flake8]
+# - list of ignored issues for the flake8 tool
+# - (E501 - long line, F401 - unused import, E203 - whitespace before ':' - black puts it)
+ignore = ['F401']
+# - max cognitive complexity for statements
+max-complexity = 10
+# - line length aligned with same setting for [black] (88 chars by default) -> project value = 110
+max-line-length = 110
+# - ignored violations, specific per files
+per-file-ignores = [
+    'tests/**:S101, S311',
+]
+
+# -- pylint tool
+[tool.pylint.MASTER]
+disable = [
+    'C0114', # missing-module-docstring
+    'C0115', # missing-class-docstring
+    'C0116', # missing-function-docstring
+]
+
+[tool.pylint.FORMAT]
+max-line-length=110
+max-module-lines=1000
+
+# -- isort tool
+[tool.isort]
+profile = 'black'
+multi_line_output = 3
+line_length = 110
+include_trailing_comma = true
+skip_gitignore = true
+skip_glob = ["**/migrations/*", "**/settings/*"]
+# src_paths = ["./", "src/"]
+src_paths = ["./src/"]
+
+# -- black tool configuration
+[tool.black]
+line_length = 110
+target-version = ['py310']
+extend-exclude = '''
+(
+    migrations   # Alembic DB migrations
+)
+'''
+
+# -- bandit tool
+[tool.bandit]
+exclude_dirs = ["tests"]
+tests = ["B201", "B301"]
+skips = ["B101", "B601"]
+
+# -- mypy tool
+[tool.mypy]
+mypy_path = "./"
+python_version = "3.10"
+follow_imports = "silent"
+strict_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_any_generics = true
+check_untyped_defs = true
+no_implicit_reexport = true
+allow_untyped_defs = true
+# disallow_untyped_defs = true
+# - mypy will ignore missing types defs imports
+ignore_missing_imports = true
+# - force mypy to analyze as best as its can module without types defs
+follow_untyped_imports = true
+
+# [[tool.mypy.overrides]]
+# module = "pyutilities.web.http_client"
+# disable_error_code = ["R0913", "too-many-arguments", "unused-argument"]
+
+# -- pytest tool
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = """
+--cov=./src/pyutilities --verbose --cov-report=html --cov-report=xml --cov-report=json --cov-report=annotate --capture=sys -rx --durations=0 --full-trace --color=auto
+"""
+testpaths = [
+    "tests/",
+    "integration/",
+]
+mock_use_standalone_module = true
+mock_traceback_monkeypatch = false
+
+# - tests markers - tests can be grouped and executed by them
+markers = [
+
+    "functional: these tests are significantly slower as they run the whole CLI script",
+
+]
+
+# -- env variables for tests in pytest
+[tool.pytest_env]
+# MY_VARIABLE = "my_value"
+PYTHONTRACEMALLOC = 20
+
+# -- coverage tool configuration (coveragerc)
+[tool.coverage.run]
+branch = true
+data_file = ".coverage/.coverage"
+omit = [
+        '*__init__*',
+        '*temp*',
+        '*tests\*'
+]
+
+[tool.coverage.report]
+show_missing = true
+# - show 2 decimal digits for coverage report values
+precision = 2
+# skip_covered = true
+
+[tool.coverage.html]
+directory = ".coverage/htmlcoverage"
+title = "Python Utilities :: Tests Coverage Report."
+
+[tool.coverage.xml]
+output = ".coverage/coverage.xml"
+
+# -- this setting is used by coverage.py, ignored by pytest-cov
+[tool.coverage.json]
+output = ".coverage/coverage.json"
+pretty_print = true

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/__init__.py

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+
 # This code should be put in <your_package_name>/__init__.py or <your_package_name>/_version.py
 # The library version now is programmatically accessible (from code).
 

pyutilities-2.4.0.dev1/src/pyutilities/cli/pyutils.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+
+"""
+Cmd line module for th pyutilities library - integration with CLI.
+
+Created:  Dmitrii Gusev, 17.04.2026
+Modified: Dmitrii Gusev, 17.04.2026
+"""
+
+import click
+
+from pyutilities import __version__
+
+MSG_VERSION = f"\nPy Utilities, version: {__version__}, (C) Dmitrii Gusev, 2018-2026.\n"
+
+
+@click.group()
+@click.help_option("-h", "--help")
+@click.version_option(__version__, "-v", "--version", message=MSG_VERSION)
+@click.pass_context
+def pyutils(ctx):
+    """Module [Py Utilities], (C) Dmitrii Gusev, 2018-2026."""
+    click.echo("")
+
+
+@pyutils.command("version")
+def version():
+    click.echo(__version__ + "\n")

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/config/configuration.py

@@ -321,7 +321,8 @@ class ConfigurationXls(Configuration):
                 dictionary[name] = value
 
         elif path_to_xls.endswith("xlsx"):  # load from excel file - format xlsx
-            excel_book = openpyxl.load_workbook(path_to_xls)  # workbook
+            # load workbook by the given path
+            excel_book = openpyxl.load_workbook(path_to_xls)  # type: ignore
             excel_sheet = excel_book[config_sheet_name]  # specified sheet by name
             self.log.debug("Loaded XLSX config. Found [%s] row(s). Loading.", excel_sheet.max_row)
             for rownumber in range(excel_sheet.max_row):

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/io/io_utils.py

@@ -4,7 +4,7 @@
 IO Utilities module.
 
 Created:  Dmitrii Gusev, 04.04.2017
-Modified: Dmitrii Gusev, 25.11.2025
+Modified: Dmitrii Gusev, 17.04.2026
 """
 
 import errno
@@ -83,7 +83,7 @@ def str_2_file(filename: str, content: str, overwrite: bool = False, encoding: s
         f.write(content)
 
 
-def file2str(filename: str, encoding: str = DEFAULT_ENCODING) -> str:
+def file_2_str(filename: str, encoding: str = DEFAULT_ENCODING) -> str:
     """Read content from the provided file as string/text."""
 
     log.debug("file2str(): reading content from file: [%s].", filename)
@@ -123,8 +123,20 @@ def compress_file(input_file, output_file):
             shutil.copyfileobj(f_in, f_out)
 
 
-def file_size(file_path: str) -> str:
-    """Function will return the file size in readable format with the highest size mark - KB/MB/GB/TB."""
+def file_str(file_path: str) -> int:
+    """Function will return the file size in bytes. In case file doesn't exist/not a file/other
+    issues - the function will return -1 (negative value)."""
+
+    if os.path.isfile(file_path):
+        file_info = os.stat(file_path)
+        return file_info.st_size
+
+    return -1
+
+
+def file_size_str(file_path: str) -> str:
+    """Function will return the file size in a human-readable format with the highest size
+    mark - KB/MB/GB/TB."""
 
     if os.path.isfile(file_path):
         file_info = os.stat(file_path)

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/utils/common_utils.py

@@ -149,5 +149,15 @@ def dict_2_csv(dicts_list: List[Dict[str, str]], filename: str, overwrite_file:
         dict_writer.writerows(dicts_list)
 
 
+def get_value_safely(dictionary: dict[str, str | None], key: str, default_value: Any) -> Any:
+    """Safely retrieves a value from a dictionary, handling both a potential None dictionary and a
+    missing key."""
+
+    if dictionary:
+        return dictionary.get(key, default_value)  # The .get() method handles the missing key gracefully
+
+    return default_value  # If the dictionary itself is None, return the default value
+
+
 if __name__ == "__main__":
     print(MSG_MODULE_ISNT_RUNNABLE)

pyutilities-2.4.0.dev1/src/pyutilities/utils/datetime_utils.py

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+
+"""
+Useful date/time utilities and functions.
+
+Created:  Dmitrii Gusev, 22.03.2026
+Modified: Dmitrii Gusev, 22.03.2026
+"""
+
+from datetime import datetime, timedelta, timezone
+
+from pyutilities.defaults import MSG_MODULE_ISNT_RUNNABLE
+
+MSK_TIMEZONE: timezone = timezone(timedelta(hours=3), name="Moscow Timezone (Russia)")
+
+
+def get_timestamp(
+    current_timezone: timezone = MSK_TIMEZONE,
+    days: float = 0,
+    hours: float = 0,
+    minutes: float = 0,
+    seconds: float = 0,
+) -> datetime:
+    """Return timestamp: now (in the default timezone) +/- the specified time delta in hours / minutes /
+    seconds. Default timezone can be changed by the function argument."""
+
+    return datetime.now(current_timezone) + timedelta(
+        days=days, hours=hours, minutes=minutes, seconds=seconds
+    )
+
+
+if __name__ == "__main__":
+    print(MSG_MODULE_ISNT_RUNNABLE)

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/utils/decorators.py

@@ -84,5 +84,37 @@ def log_execution(func):
     return wrapper
 
 
+def check_not_none(*arg_names):
+    """
+    A decorator that checks if specified arguments are not None.
+
+    Args:
+        *arg_names: Variable number of strings representing the names of
+                    arguments to check for None values.
+    """
+
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            # Get the argument names from the function signature
+            func_arg_names = func.__code__.co_varnames[: func.__code__.co_argcount]
+
+            # Map positional arguments to their names
+            arg_map = dict(zip(func_arg_names, args))
+            # Add keyword arguments
+            arg_map.update(kwargs)
+
+            for name in arg_names:
+                if name not in arg_map:
+                    raise TypeError(f"Argument '{name}' not found in function signature.")
+                if arg_map[name] is None:
+                    raise ValueError(f"Argument '{name}' cannot be None.")
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
 if __name__ == "__main__":
     print(MSG_MODULE_ISNT_RUNNABLE)

{pyutilities-2.1.1 → pyutilities-2.4.0.dev1}/src/pyutilities/utils/string_utils.py

@@ -10,11 +10,11 @@ in 'fast' executing code, where logging will just add additional complexity and
 Also most of the functions use LRU feature of the python language.
 
 Created:  Dmitrii Gusev, 15.04.2019
-Modified: Dmitrii Gusev, 23.11.2025
+Modified: Dmitrii Gusev, 17.04.2026
 """
 
 import logging
-from functools import cache
+from functools import lru_cache
 from re import match as re_match
 from typing import Any, Dict, Iterable, Tuple
 
@@ -38,10 +38,13 @@ REGEX_FLOAT_2 = "^\\d+?\\.\\d+?$"  # original regex with fixed warnings
 REGEX_FLOAT_3 = "^[+-]?([0-9]*[.])?[0-9]+$"  # simplified regex, matches: 123/123.456/.456
 REGEX_FLOAT_4 = "^[+-]?([0-9]+([.][0-9]*)?|[.][0-9]+)$"  # matches as previous plus: 123.
 
+# cache setup (size) for cached functions/methods
+LRU_CACHE_SIZE: int = 128
+
 
-@cache
 def trim_2_none(string: str | None, trace: bool = False) -> str | None:
-    """Trim the provided string to None (if empty) or just strip leading/trailing whitespaces."""
+    """NOT CACHED. Trim the provided string to None (if it is None or empty - only spaces) or just strip
+    leading/trailing whitespaces and return the string."""
 
     if string and string.strip():  # string isn't empty - trimming whitespaces
         result = string.strip()
@@ -54,9 +57,15 @@ def trim_2_none(string: str | None, trace: bool = False) -> str | None:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def trimc_2_none(string: str | None, trace: bool = False) -> str | None:
+    """CACHED version of the trim_2_none()."""
+    return trim_2_none(string, trace)
+
+
 def trim_2_empty(string: str | None, trace: bool = False) -> str:
-    """Trim the provided string to empty string - '' or "" - (if empty) or just strip whitespaces."""
+    """NOT CACHED. Trim the provided string to empty string - ''/"" - (if empty or None) or just
+    strip whitespaces and return the string."""
 
     if string and string.strip():  # string isn't empty - trimming whitespaces
         result = string.strip()
@@ -69,10 +78,16 @@ def trim_2_empty(string: str | None, trace: bool = False) -> str:
     return result
 
 
-@cache
-def filter_str(string: str | None, trace: bool = False):
-    """Filter out all unnecessary/unwanted symbols from string (clear string) except letters, numbers,
-    spaces, commas. By default, decode input string in unicode (utf-8)."""
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def trimc_2_empty(string: str | None, trace: bool = False) -> str:
+    """CACHED version of the trim_2_empty()."""
+    return trim_2_empty(string, trace)
+
+
+def filter_str(string: str | None, trace: bool = False) -> str | None:
+    """NOT CACHED. Filter out all unnecessary/unwanted symbols from string (clear string) except
+    letters, numbers, spaces, commas. By default, decode input string in unicode (utf-8).
+    Accepted symbols are: letters, numbers, space, ALL_SYMBOLS (see above)."""
 
     def accepted(char) -> bool:  # internal function
         """Simple internal helper function."""
@@ -89,7 +104,13 @@ def filter_str(string: str | None, trace: bool = False):
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def filterc_str(string: str | None, trace: bool = False) -> str | None:
+    """CACHED version of the filter_str()."""
+    return filter_str(string, trace)
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def process_url(
     url: str, postfix: str = "", format_values: Tuple[str] | None = None, trace: bool = False
 ) -> str:
@@ -123,7 +144,7 @@ def process_url(
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def process_urls(
     urls: Dict[str, str], postfix: str = "", format_values: Tuple[str] | None = None, trace: bool = False
 ) -> Dict[str, str]:
@@ -141,7 +162,7 @@ def process_urls(
     return processed
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def get_str_ending(string: str, symbol: str = "/", trace: bool = False) -> str:
     """Returns the last right part of the string after the symbol (not including the symbol itself). It is
     most right part of the string, after the last right symbol (if there are multiple symbols).
@@ -160,7 +181,7 @@ def get_str_ending(string: str, symbol: str = "/", trace: bool = False) -> str:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def is_number(value: str, trace: bool = False) -> bool:
     """Returns True if string is a number. String is checked 'as is' - no trailing/leading spaces cut, no
     any other transformations."""
@@ -228,9 +249,8 @@ def iter_2_str(values: Iterable[Any], braces: bool = True, trace: bool = False)
     return resulting_value  # returning result
 
 
-@cache
 def coalesce(*args, trace: bool = False) -> str:
-    """Return first not None and not empty value from provided args list."""
+    """NOT CACHED. Return first not None and not empty value from provided args list."""
 
     result: str = ""
 
@@ -252,7 +272,13 @@ def coalesce(*args, trace: bool = False) -> str:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def coalescec(*args, trace: bool = False) -> str:
+    """CACHED version of the coalesce()."""
+    return coalesce(*args, trace)
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def one_of_2_str(string1: str | None, string2: str | None, trace: bool = False) -> str | None:
     """Function returning one of two strings, if other is empty. If both are empty or filled in - method
     returns None (empty value)."""
@@ -271,7 +297,7 @@ def one_of_2_str(string1: str | None, string2: str | None, trace: bool = False)
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def convert_bytes(num: float, trace: bool = False) -> str:
     """Function will convert bytes to MB.... GB... etc. for readability."""
 
@@ -288,7 +314,7 @@ def convert_bytes(num: float, trace: bool = False) -> str:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def str_2_bool(string: str | None, trace: bool = False) -> bool:
     """Convert string to bool. If empty string - return False. If string is not empty - return if string,
     converted to lower case, contains in the list: 'true', '1', 't', 'y', 'yes', 'yeah', 'yup', 'certainly',
@@ -316,7 +342,7 @@ def str_2_bool(string: str | None, trace: bool = False) -> bool:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def str_2_int(string: str | None, trace: bool = False) -> int:
     """Convert string to integer number. Empty string or string with non-digit symbols will return 0,
     otherwise will return int(string)."""
@@ -340,7 +366,7 @@ def str_2_int(string: str | None, trace: bool = False) -> int:
     return result
 
 
-@cache
+@lru_cache(maxsize=LRU_CACHE_SIZE)
 def str_2_float(string: str | None, trace: bool = False) -> float:
     """Convert string to float number. Empty string or string with non-digit symbols
     will return 0, otherwise will return float(string)."""

pyutilities-2.1.1/pyproject.toml

@@ -1,241 +0,0 @@
-####################################################################################################
-#
-#   Main configuration file for the [pyutilities] library. The whole project configuration (any
-#   setting) should be put here. Also configuration for dependencies and all code quality tools.
-#
-#   Notes (code quality, etc.):
-#       - project line length = 110 symbols (black, flake8)
-#       - most of modules should be typed (used mypy stubs libraries)
-#
-#   Created:  Dmitrii Gusev, 30.05.2025
-#   Modified: Dmitrii Gusev, 28.11.2025
-#
-####################################################################################################
-
-# -- build system information
-[build-system]
-requires = ["poetry-core>=2.0.0,<3.0.0"]
-build-backend = "poetry.core.masonry.api"
-
-# -- project / poetry utility meta-information
-[project]
-name = "pyutilities"
-version = "2.1.1"
-description = "PyUtilities :: Useful python 3 utilities library for various use cases."
-authors     = [
-    {name = "Dmitrii Gusev", email = "dmitry.ed.gusev@gmail.com"},
-]
-license  = "MIT"
-readme   = "docs/README-PUB.md"
-requires-python = ">=3.10,<4"
-keywords    = ["Python Utilities", "Useful Functions", "String Utilities", "CLI Functions", "toolset", "library", "System Utilities"]
-classifiers = [
-    "Development Status :: 6 - Mature",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "License :: OSI Approved :: MIT License",
-    "Intended Audience :: Developers",
-    "Topic :: Utilities",
-    "Typing :: Typed"
-]
-
-# - main project dependencies
-dependencies = [
-    "xlrd~=2.0.1",  # allowed: >=2.0.1 <2.1.0
-    "xlwt==1.3.0",
-    "xlwings~=0.33.9",  # allowed: >=0.33.9 <0.34.0
-    "loguru==0.7.3",
-    "pyyaml==6.*",
-    "openpyxl==3.1.5",
-    "urllib3~=2.3",  # allowed: >=2.3.0 <3.0.0
-    "paramiko==4.*",
-    "requests~=2.32",  # allowed: >=2.32.0 <3.0.0
-    "markdown~=3.7",  # allowed: >=3.7.0 <4.0.0
-    "prettytable~=3.14",  # allowed: >=3.14.0 <4.0.0
-    "fake-useragent~=2.0"  # allowed: >=2.0.0 <3.0.0
-]
-
-[project.urls]
-homepage = "https://pypi.org/project/pyutilities"
-repository = "https://github.com/dmitry-ed-gusev/pyutilities"
-documentation = "https://github.com/dmitry-ed-gusev/pyutilities"
-"Bug Tracker" = "https://github.com/dmitry-ed-gusev/pyutilities/issues"
-
-# [project.scripts]
-# my_package_cli = 'my_package.console:run'
-
-[tool.poetry]
-packages = [{include = "pyutilities", from = "src"}]
-
-# -- poetry 'test' dependencies (group)
-[tool.poetry.group.test.dependencies]
-# -- main pytest libraries
-pytest = "9.*"  # allowed any version < 10.0.0
-pytest-env = "1.*"
-pytest-cov = "7.*"
-pytest-mock = "3.*"
-pytest-pep8 = "1.0.6"
-pytest-flakes = "4.0.5"
-pytest-isort = "4.0.0"
-pytest-black = "0.6.0"
-pytest-variables = {version = "3.1.0", extras = ["hjson", "yaml", "toml"]}
-# -- testing-related libraries
-mock = "5.*"
-mockito = "1.*"
-nose2 = "0.15.1"
-hypothesis = "6.*"
-# -- typing libraries
-mypy = "1.*"
-types-six = "1.*"
-types-mock = "5.*"
-types-paramiko = "4.*"
-types-requests = "2.*"
-types-markdown = "3.*"
-types-PyYAML = "6.*"
-types-flake8-bugbear = "25.*"
-# -- code quality libraries
-flake8 = "7.*"
-flake8-pyproject = "1.2.3"
-flake8-bandit = "4.1.1"
-flake8-bugbear = "25.*"
-black = "25.*"
-pylint = "4.*"
-pre-commit = "4.*"
-bandit = "1.9.*"
-isort = {version = "7.*", extras = ["requirements_deprecated_finder", "pipfile_deprecated_finder"]}
-# -- other
-responses = "0.*"
-sphinx = "8.1.3"
-notebook = "7.*"
-
-# -- flake8 tool
-[tool.flake8]
-# - list of ignored issues (E501 - too long line, F401 - imported but unused, E203 - whitespace before ':' - black formatter puts it - ???)
-ignore = ['F401']
-# - max cognitive complexity for statements
-max-complexity = 10
-# - line length aligned with same setting for [black] (88 chars by default) -> project value = 110
-max-line-length = 110
-# - ignored violations, specific per files
-per-file-ignores = [
-    'tests/**:S101, S311',
-]
-
-# -- pylint tool
-[tool.pylint.MASTER]
-disable = [
-    'C0114', # missing-module-docstring
-    'C0115', # missing-class-docstring
-    'C0116', # missing-function-docstring
-]
-
-[tool.pylint.FORMAT]
-max-line-length=110
-max-module-lines=1000
-
-# -- isort tool
-[tool.isort]
-profile = 'black'
-multi_line_output = 3
-line_length = 110
-include_trailing_comma = true
-skip_gitignore = true
-skip_glob = ["**/migrations/*", "**/settings/*"]
-#src_paths = ["./", "src/"]
-src_paths = ["./src/"]
-
-# -- black tool configuration
-[tool.black]
-line_length = 110
-target-version = ['py310']
-extend-exclude = '''
-(
-    migrations   # Alembic DB migrations
-)
-'''
-
-# -- bandit tool
-[tool.bandit]
-exclude_dirs = ["tests"]
-tests = ["B201", "B301"]
-skips = ["B101", "B601"]
-
-# -- mypy tool
-[tool.mypy]
-mypy_path = "./"
-python_version = "3.10"
-follow_imports = "silent"
-strict_optional = true
-warn_redundant_casts = true
-warn_unused_ignores = true
-warn_return_any = true
-warn_unused_configs = true
-disallow_any_generics = true
-check_untyped_defs = true
-no_implicit_reexport = true
-allow_untyped_defs = true
-# disallow_untyped_defs = true
-# - mypy will ignore missing types defs imports
-ignore_missing_imports = true
-# - force mypy to analyze as best as its can module without types defs
-# follow_untyped_imports = true
-# plugins = ["pydantic.mypy"]
-
-# [[tool.mypy.overrides]]
-# module = "pyutilities.web.http_client"
-# disable_error_code = ["R0913", "too-many-arguments", "unused-argument"]
-
-# -- mypy extra configuration (for pydantic)
-# [tool.pydantic-mypy]
-# init_forbid_extra = true
-# init_typed = true
-# warn_required_dynamic_aliases = true
-
-# -- pytest tool
-[tool.pytest.ini_options]
-minversion = "6.0"
-addopts = """
---cov=./src/pyutilities --verbose --cov-report=html --cov-report=xml --cov-report=json --cov-report=annotate
- --capture=sys --durations=0 --full-trace --color=auto
-"""
-testpaths = [
-    "tests/",
-    "integration/",
-]
-# - tests markers - tests can be grouped and executed by them
-markers = [
-    "functional: these tests are significantly slower as they run the whole CLI script",
-]
-
-# -- env variables for tests in pytest
-[tool.pytest_env]
-MY_VARIABLE = "my_value"
-
-# -- coverage tool configuration (coveragerc)
-[tool.coverage.run]
-branch = true
-data_file = ".coverage/.coverage"
-omit = [
-        '*__init__*',
-        '*temp*',
-        '*tests\*'
-]
-
-[tool.coverage.report]
-show_missing = true
-# - show 2 decimal digits for coverage report values
-precision = 2
-# skip_covered = true
-
-[tool.coverage.html]
-directory = ".coverage/htmlcoverage"
-title = "Python Utilities :: Tests Coverage Report."
-
-[tool.coverage.xml]
-output = ".coverage/coverage.xml"
-
-[tool.coverage.json]
-output = ".coverage/coverage.json"
-pretty_print = true