pyutilities 2.5.2__tar.gz → 2.7.0__tar.gz

{pyutilities-2.5.2 → pyutilities-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyutilities
-Version: 2.5.2
+Version: 2.7.0
 Summary: PyUtilities :: Useful python 3+ utilities library for various use cases.
 License-Expression: MIT
 License-File: LICENSE
@@ -27,7 +27,7 @@ Requires-Dist: fake-useragent (>=2.0,<3.0)
 Requires-Dist: loguru (==0.7.3)
 Requires-Dist: markdown (>=3.7,<4.0)
 Requires-Dist: marshmallow (>=4.1,<5.0)
-Requires-Dist: openpyxl (==3.1.5)
+Requires-Dist: openpyxl (>=3.1,<4.0)
 Requires-Dist: paramiko (==5.*)
 Requires-Dist: pendulum (>=3.2,<4.0)
 Requires-Dist: prettytable (>=3.14,<4.0)
@@ -45,9 +45,9 @@ Requires-Dist: rich (>=15.0,<16.0)
 Requires-Dist: rich-pyfiglet (>=2.0,<3.0)
 Requires-Dist: ruamel.yaml (>=0.18,<1.0)
 Requires-Dist: urllib3 (>=2.6,<3.0)
-Requires-Dist: xlrd (>=2.0.1,<2.1.0)
+Requires-Dist: xlrd (>=2.0,<3.0)
 Requires-Dist: xlwings (>=0.35,<1.0)
-Requires-Dist: xlwt (==1.3.0)
+Requires-Dist: xlwt (>=1.3,<2.0)
 Project-URL: Bug Tracker, https://github.com/dmitry-ed-gusev/pyutilities/issues
 Project-URL: Documentation, https://github.com/dmitry-ed-gusev/pyutilities
 Project-URL: Homepage, https://pypi.org/project/pyutilities

{pyutilities-2.5.2 → pyutilities-2.7.0}/pyproject.toml

@@ -8,7 +8,7 @@
 #       - most of modules should be typed (used mypy stubs libraries)
 #
 #   Created:  Dmitrii Gusev, 30.05.2025
-#   Modified: Dmitrii Gusev, 27.05.2026
+#   Modified: Dmitrii Gusev, 09.07.2026
 #
 ####################################################################################################
 
@@ -20,7 +20,7 @@ build-backend = "poetry.core.masonry.api"
 # -- project / poetry utility meta-information
 [project]
 name = "pyutilities"
-version = "2.5.2"
+version = "2.7.0"
 description = "PyUtilities :: Useful python 3+ utilities library for various use cases."
 authors     = [
     {name = "Dmitrii Gusev", email = "dmitry.ed.gusev@gmail.com"},
@@ -56,10 +56,10 @@ dependencies = [
     "loguru==0.7.3",
 
     # -- ms word / ms excel libraries
-    "xlrd~=2.0.1",  # - allowed: >=2.0.1 <2.1.0
-    "xlwt==1.3.0",
-    "xlwings~=0.35",
-    "openpyxl==3.1.5",
+    "xlrd ~=2.0",
+    "xlwt ~=1.3",
+    "xlwings ~=0.35",
+    "openpyxl ~=3.1",
 
     # -- data validation and marshalling (JSON/YAML) --
     "pydantic (>=2.12.5,<3.0.0)",
@@ -102,10 +102,10 @@ dev = [
     "pytest-env ==1.*",
     "pytest-cov ==7.*",
     "pytest-mock ==3.*",
-    "pytest-pep8 ==1.0.6",
+    # "pytest-pep8 ==1.0.6",
     "pytest-flakes ==4.0.5",
     "pytest-isort ==4.0.0",
-    "pytest-black ==0.6.0",
+    # "pytest-black ==0.6.0",
     "pytest-variables[hjson,yaml,toml] ==3.1.0",
 
     # -- testing-related libraries --
@@ -118,7 +118,7 @@ dev = [
     "mypy ==2.*", # - typing library
     "types-six ==1.*",
     "types-mock ==5.*",
-    "types-paramiko ==4.*",
+    "types-paramiko ==5.*",
     "types-requests ==2.*",
     "types-markdown ==3.*",
     "types-PyYAML ==6.*",
@@ -152,7 +152,7 @@ dev = [
 
     # -- readline module depending on the platform
     "pyreadline3 ==3.* ; sys_platform == 'win32' or sys_platform == 'cygwin'",
-    "gnureadline ==8.2.13 ; sys_platform != 'win32'"
+    "gnureadline ==8.* ; sys_platform != 'win32'"
 
 ]
 
@@ -240,7 +240,7 @@ skips = ["B101", "B601"]
 # -- mypy tool
 [tool.mypy]
 mypy_path = "./"
-python_version = "3.10"
+python_version = "3.14"
 follow_imports = "silent"
 strict_optional = true
 warn_redundant_casts = true

{pyutilities-2.5.2 → pyutilities-2.7.0}/src/pyutilities/cli/fedit.py

@@ -23,7 +23,7 @@ CHECK_TYPE_CONTAINS = "contains"
 CHECK_TYPES = (CHECK_TYPE_STARTS, CHECK_TYPE_ENDS, CHECK_TYPE_CONTAINS)
 
 
-def check_str(args, check_type, source_str, test_str):
+def check_str(args, check_type, source_str: str, test_str: str) -> bool:
     """
     Check relation between string and test string, according to test type
     :param check_type: type of matching
@@ -32,14 +32,16 @@ def check_str(args, check_type, source_str, test_str):
     :return:
     """
 
-    if check_type == CHECK_TYPE_STARTS:
-        return source_str.startswith(test_str)
+    result: bool = False
 
-    if args.edit_type == CHECK_TYPE_ENDS:
-        return source_str.endswith(test_str)
+    if check_type == CHECK_TYPE_STARTS:
+        result = source_str.startswith(test_str)
+    elif args.edit_type == CHECK_TYPE_ENDS:
+        result = source_str.endswith(test_str)
+    elif args.edit_type == CHECK_TYPE_CONTAINS:
+        result = test_str in source_str
 
-    if args.edit_type == CHECK_TYPE_CONTAINS:
-        return test_str in source_str
+    return result
 
 
 def fedit():

{pyutilities-2.5.2 → pyutilities-2.7.0}/src/pyutilities/config/configuration.py

@@ -13,7 +13,7 @@ For more data - see docstring for Configuration class.
 02.01.2025 Logging refactoring and minor improvements.
 
 Created:  Gusev Dmitrii, 2017
-Modified: Gusev Dmitrii, 02.01.2025
+Modified: Gusev Dmitrii, 09.07.2026
 """
 
 import logging
@@ -182,10 +182,10 @@ class Configuration:
         try:
             result = self.__get_value(key, self.config_dict)
             return result
-        except KeyError:
+        except KeyError as e:
             if default is not None:
                 return default
-            raise ConfigError(f"Configuration entry [{key}] not found!")
+            raise ConfigError(f"Configuration entry [{key}] not found!") from e
 
     def set(self, key, value):
         """Sets config value, creating all the nested levels if necessary
@@ -257,6 +257,7 @@ VALUES_COLUMN = 1
 class ConfigurationXls(Configuration):
     """Extension for Configuration class for work with excel config files."""
 
+    # pylint: disable=too-many-arguments,too-many-positional-arguments
     def __init__(
         self,
         path_to_xls,

{pyutilities-2.5.2 → pyutilities-2.7.0}/src/pyutilities/io/io_utils.py

@@ -145,5 +145,50 @@ def file_size_str(file_path: str) -> str:
     return "unknown"
 
 
+def clear_directory_except_files(directory_path: str, files_to_keep: list[str], trace: bool = False) -> int:
+    """Cleanup folder <directory_path>, keeping files by list <files_to_keep>. Subdirectories are
+    not affected - they won't be removed (files in the subdirectories won't be touched as well).
+    Usage:
+        clear_directory_except_files("example_folder", ["keep_files.txt", "another_file.txt"])
+    """
+
+    if not os.path.exists(directory_path) or not os.path.isdir(directory_path):
+        log.debug("Path %s doesn't exist or not a directory!", directory_path)
+        return 0
+
+    counter: int = 0
+    for filename in os.listdir(directory_path):
+        file_path = os.path.join(directory_path, filename)
+        if os.path.isfile(file_path) and filename not in files_to_keep:
+            try:
+                os.remove(file_path)
+                counter += 1
+                if trace:
+                    log.debug("File %s deleted OK.", file_path)
+            except FileNotFoundError:
+                log.debug("File %s was already removed.", file_path)
+            except PermissionError:
+                log.error("Permission denied when trying to delete %s!", file_path)
+            except OSError as e:
+                log.exception("Error deleting file %s. Error: %s.", file_path, e)
+
+    return counter
+
+
+def clear_directory_except_files_recursive(directory_path, files_to_keep):
+    for root, _, files in os.walk(directory_path):
+        for filename in files:
+            file_path = os.path.join(root, filename)
+            if os.path.isfile(file_path) and filename not in files_to_keep:
+                try:
+                    os.remove(file_path)
+                    print(f"Файл {file_path} успешно удалён")
+                except Exception as e:
+                    print(f"Ошибка при удалении {file_path}: {e}")
+
+
+# Очистить папку `example_folder` от всех файлов, кроме `keep_files.txt` и `another_file.txt`, рекурсивно
+# clear_directory_except_files_recursive("example_folder", ["keep_files.txt", "another_file.txt"])
+
 if __name__ == "__main__":
     print(MSG_MODULE_ISNT_RUNNABLE)

pyutilities-2.7.0/src/pyutilities/utils/datetime_utils.py

@@ -0,0 +1,263 @@
+# -*- coding: utf-8 -*-
+
+"""
+Useful date/time utilities and functions.
+
+Created:  Dmitrii Gusev, 22.03.2026
+Modified: Dmitrii Gusev, 07.07.2026
+"""
+
+import calendar
+import logging
+from datetime import datetime, timedelta, timezone
+from functools import lru_cache
+
+from dateutil.relativedelta import relativedelta
+
+from pyutilities.defaults import MSG_MODULE_ISNT_RUNNABLE
+
+# DATETIME :: timezones defaults
+MSK_TIMEZONE_NAME: str = "Moscow TZ (GMT+3)"
+MSK_TIMEZONE: timezone = timezone(timedelta(hours=3), name=MSK_TIMEZONE_NAME)
+# - CACHE :: cache setup (size) for cached functions/methods
+LRU_CACHE_SIZE: int = 128
+
+
+log = logging.getLogger(__name__)
+log.addHandler(logging.NullHandler())
+
+
+# pylint: disable=too-many-arguments,too-many-positional-arguments
+def shift_timestamp(
+    base_timestamp: datetime,
+    delta_years: int = 0,
+    delta_months: int = 0,
+    delta_days: float = 0,
+    delta_hours: float = 0,
+    delta_minutes: float = 0,
+    delta_seconds: float = 0,
+    trace: bool = False,
+) -> datetime:
+    """Shifts the provided timestamp by the specified delta (in years / months / days / hours / minutes
+    / seconds). Return timestamp."""
+
+    if not base_timestamp:  # fast-check/fail-fast
+        raise ValueError("Provided empty datetime value!")
+
+    # using function relativedelta() solving the issue of incorrect days (example: 31 февраля) and
+    # does it atomic for years/months
+    result: datetime
+    try:
+        # 1. Смещаем года и месяцы
+        result = base_timestamp + relativedelta(years=delta_years, months=delta_months)
+
+        # 2. Смещаем дробные/стандартные дни, часы, минуты и секунды
+        result += timedelta(days=delta_days, hours=delta_hours, minutes=delta_minutes, seconds=delta_seconds)
+
+        # 3. Нормализуем таймзону (важно для DST границ)
+        if result.tzinfo is not None:
+            result = result.astimezone(result.tzinfo)
+
+    except (ValueError, OverflowError) as e:  # we won't 'silence' the issue
+        # Защита от выхода за пределы поддерживаемых дат Python (года 1-9999)
+        raise ValueError(f"Datetime value issue: {e}") from e
+
+    if trace:
+        log.debug("Generated from [%s] timestamp [%s].", base_timestamp, result)
+
+    return result
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+# pylint: disable=too-many-arguments,too-many-positional-arguments
+def shift_timestampc(
+    base_timestamp: datetime,
+    delta_years: int = 0,
+    delta_months: int = 0,
+    delta_days: float = 0,
+    delta_hours: float = 0,
+    delta_minutes: float = 0,
+    delta_seconds: float = 0,
+    trace: bool = False,
+) -> datetime:
+    """CASHED version of the shift_timestamp() method. Shifts the provided timestamp by the specified
+    delta (in years / months / days / hours / minutes / seconds). Return timestamp."""
+
+    return shift_timestamp(
+        base_timestamp,
+        delta_years,
+        delta_months,
+        delta_days,
+        delta_hours,
+        delta_minutes,
+        delta_seconds,
+        trace,
+    )
+
+
+# pylint: disable=too-many-arguments,too-many-positional-arguments
+def get_shifted_timestamp(
+    current_timezone: timezone = MSK_TIMEZONE,
+    delta_years: int = 0,
+    delta_months: int = 0,
+    delta_days: float = 0,
+    delta_hours: float = 0,
+    delta_minutes: float = 0,
+    delta_seconds: float = 0,
+    trace: bool = False,
+) -> datetime:
+    """Return the current timestamp with delta: now (in the default timezone) +/- the specified time delta
+    in years / months / days / hours / minutes / seconds. Default timezone can be changed by the function
+    argument."""
+
+    # generate the current timestamp
+    current_timestamp: datetime = datetime.now(current_timezone) if current_timezone else datetime.now()
+
+    return shift_timestamp(
+        current_timestamp,
+        delta_years,
+        delta_months,
+        delta_days,
+        delta_hours,
+        delta_minutes,
+        delta_seconds,
+        trace,
+    )
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+# pylint: disable=too-many-arguments,too-many-positional-arguments
+def get_shifted_timestampc(
+    current_timezone: timezone = MSK_TIMEZONE,
+    delta_years: int = 0,
+    delta_months: int = 0,
+    delta_days: float = 0,
+    delta_hours: float = 0,
+    delta_minutes: float = 0,
+    delta_seconds: float = 0,
+    trace: bool = False,
+) -> datetime:
+    """CACHED. Cached version of the get_timestamp() method."""
+
+    return get_shifted_timestamp(
+        current_timezone,
+        delta_years,
+        delta_months,
+        delta_days,
+        delta_hours,
+        delta_minutes,
+        delta_seconds,
+        trace,
+    )
+
+
+def get_str_month(
+    dt: datetime, month_number_prefix: bool = True, year_number_postfix: bool = False, delimiter: str = "."
+) -> str:
+    """Return string name of the month with variations, for utility usage (folders names etc.)"""
+
+    prefix: str = ""
+    postfix: str = ""
+    if month_number_prefix:
+        prefix = f"{dt.month:02d}{delimiter}"
+    if year_number_postfix:
+        postfix = f"{delimiter}{dt.year}"
+
+    return f"{prefix}{calendar.month_name[dt.month]}{postfix}"
+
+
+def get_str_current_month() -> str:
+    return get_str_month(datetime.now(tz=MSK_TIMEZONE))
+
+
+def get_str_prev_month() -> str:
+    return get_str_month(get_shifted_timestamp(delta_months=-1))
+
+
+def get_str_next_month() -> str:
+    return get_str_month(get_shifted_timestamp(delta_months=1))
+
+
+def get_dates_range_before_date(date: datetime, tzinfo: timezone) -> tuple[int, int]:
+    """Generates two dates range - date_from/date_to for the time period 'before today' - from the 1st day
+    of the current month till the today - 1 day (current month). In case today is 1st day - range for the
+    whole previous month, if today is 01.01.XXXX - range for 01.12.XXXX-1 - 31.12.XXXX-1.
+    """
+
+    if not isinstance(date, datetime):
+        raise ValueError("The 'date' argument must be a valid datetime object.")
+
+    log.debug("get_dates_range_before_date(): the date [%s].", date)
+
+    tstamp_from: int = 0
+    tstamp_to: int = 0
+
+    # - processing and calculating dates
+    if date.day == 1:  # today - 1st day of month, we need report for the previous month
+
+        if date.month == 1:  # we are at 01.01.XXXX - we need report for Dec.XXXX - 1
+            date_from = datetime(date.year - 1, 12, 1, tzinfo=tzinfo)  # from: 01 Dec Year-1 (prev. year)
+            date_to = datetime(date.year - 1, 12, 31, tzinfo=tzinfo)  # to: 31 Dec Year-1 (prev. year)
+
+        else:  # we are at 01.XX.XXXX - we need report for previous month
+            date_from = datetime(date.year, date.month - 1, 1, tzinfo=tzinfo)  # from: 01 Month-1 Year
+            _, last_day = calendar.monthrange(date.year, date.month - 1)  # last day of the previous month
+            date_to = datetime(date.year, date.month - 1, last_day, tzinfo=tzinfo)  # to: LastDay Month-1 Year
+
+    else:  # today isn't the 1st, we need report from 1st till yesterday
+
+        date_from = datetime(date.year, date.month, 1, tzinfo=tzinfo)  # from: 01 Month Year
+        date_to = datetime(date.year, date.month, date.day - 1, tzinfo=tzinfo)  # to: Day-1 Month Year
+
+    # - final date/time - date from: XX.XX.XX 00:00:00 - date to: XX.XX.XXXX 23:59:59
+    datetime_from = date_from.replace(hour=0, minute=0, second=0, microsecond=0)
+    datetime_to = date_to.replace(hour=23, minute=59, second=59, microsecond=0)
+    # timestamps from datetime objects
+    tstamp_from = int(datetime_from.timestamp())
+    tstamp_to = int(datetime_to.timestamp())
+
+    log.debug("Timestamps for [%s]: from [%s], to [%s].", date, tstamp_from, tstamp_to)
+
+    # - return the tuple of values
+    return (tstamp_from, tstamp_to)
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def get_dates_range_before_datec(date: datetime, tzinfo: timezone) -> tuple[int, int]:
+    """CACHED. Cached version of the get_dates_range_before_date()."""
+
+    return get_dates_range_before_date(date, tzinfo)
+
+
+def human_readable_duration_seconds(duration_seconds):
+    """Convert duration in seconds into human-readable string-duration."""
+
+    days = duration_seconds // (24 * 3600)
+    hours = (duration_seconds % (24 * 3600)) // 3600
+    minutes = (duration_seconds % (24 * 3600)) % 3600 // 60
+    seconds = duration_seconds % 3600 % 60
+
+    result = ""
+    if days > 0:
+        result += f"{days} д. "
+    if hours > 0:
+        result += f"{hours} ч. "
+    if minutes > 0:
+        result += f"{minutes:02d} мин. "
+    result += f"{seconds:02d} сек."
+    result = result.strip()
+
+    log.debug("Converted duration: [%s] into readable str: [%s].", duration_seconds, result)
+
+    return result
+
+
+@lru_cache(maxsize=LRU_CACHE_SIZE)
+def human_readable_duration_secondsc(duration_seconds):
+    """CACHED. Cached version of the human_readable_duration_seconds() method."""
+
+    return human_readable_duration_seconds(duration_seconds)
+
+
+if __name__ == "__main__":
+    print(MSG_MODULE_ISNT_RUNNABLE)

pyutilities-2.7.0/src/pyutilities/xls/xls_utils.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*-
+
+"""
+Useful Excel utilities for improving excel working in python.
+
+Created:  Dmitrii Gusev, 24.06.2026
+Modified: Dmitrii Gusev, 24.06.2026
+"""
+
+from openpyxl.cell.cell import Cell
+from openpyxl.styles import Alignment, Font  # type: ignore[attr-defined]
+from openpyxl.utils import get_column_letter  # type: ignore[attr-defined]
+from openpyxl.worksheet.worksheet import Worksheet
+
+from pyutilities.utils.string_utils import is_empty
+
+# - styling constants/defaults
+FONT: Font = Font()
+FONT_RED: Font = Font(color="FF0000")  # red font
+FONT_GREEN: Font = Font(color="00BB00")  # green font
+FONT_BOLD: Font = Font(bold=True)
+FONT_BOLD_RED: Font = Font(bold=True, color="FF0000")  # red font, bold
+FONT_BOLD_GREEN: Font = Font(bold=True, color="00BB00")  # green font, bold
+ALIGNMENT_CENTER: Alignment = Alignment(horizontal="center", vertical="center", wrapText=True)
+
+
+class XlsSheet:
+    """Utility class for working with openpyxl excel worksheet."""
+
+    def __init__(self, ws: Worksheet):
+        self.__ws = ws
+
+    # pylint: disable=too-many-arguments,too-many-positional-arguments
+    def init_cell(
+        self,
+        address: str,
+        value: str,
+        bold: bool = False,
+        aligned: bool = False,
+        color: str | None = None,
+        width: int = 0,
+    ) -> Cell:
+        """Simple yet powerful method for cell initialization. Can init essential cell parameters."""
+
+        cell: Cell = self.__ws[address]
+        cell.value = value
+
+        if bold:  # font boldness
+            cell.font = FONT_BOLD
+
+        if aligned:  # cell text alignment
+            cell.alignment = ALIGNMENT_CENTER
+
+        if not is_empty(color):  # cell font coloring/boldness
+            if color == "red":
+                if bold:
+                    cell.font = FONT_BOLD_RED
+                else:
+                    cell.font = FONT_RED
+            elif color == "green":
+                if bold:
+                    cell.font = FONT_BOLD_GREEN
+                else:
+                    cell.font = FONT_GREEN
+
+        if width > 0:  # column width
+            self.__ws.column_dimensions[cell.column_letter].width = width
+
+        return cell
+
+    def init_cell_bold(
+        self, address, value, aligned: bool = False, color: str | None = None, width: int = 0
+    ) -> Cell:
+        """TBD"""
+        return self.init_cell(
+            address=address, value=value, bold=True, aligned=aligned, color=color, width=width
+        )
+
+    # pylint: disable=too-many-arguments, too-many-positional-arguments
+    def init_cell_addr(
+        self,
+        row: int,
+        column: int,
+        value: str,
+        bold: bool = False,
+        aligned: bool = False,
+        color: str | None = None,
+        width: int = 0,
+    ) -> Cell:
+        """TBD"""
+
+        letter: str = get_column_letter(column)
+        return self.init_cell(
+            address=f"{letter}{row}", value=value, bold=bold, aligned=aligned, color=color, width=width
+        )
+
+    def set_column_width(self, column: str, width: int):
+        """TBD"""
+        self.__ws.column_dimensions[column].width = width

pyutilities-2.5.2/src/pyutilities/utils/datetime_utils.py

@@ -1,148 +0,0 @@
-# -*- coding: utf-8 -*-
-
-"""
-Useful date/time utilities and functions.
-
-Created:  Dmitrii Gusev, 22.03.2026
-Modified: Dmitrii Gusev, 25.05.2026
-"""
-
-import calendar
-import logging
-from datetime import datetime, timedelta, timezone
-from functools import lru_cache
-
-from pyutilities.defaults import MSG_MODULE_ISNT_RUNNABLE
-
-# DATETIME :: timezones defaults
-MSK_TIMEZONE: timezone = timezone(timedelta(hours=3), name="Moscow Timezone (GMT+3)")
-MSK_TIMEZONE_NAME: str = "Europe/Moscow"
-# - CACHE :: cache setup (size) for cached functions/methods
-LRU_CACHE_SIZE: int = 128
-
-
-log = logging.getLogger(__name__)
-log.addHandler(logging.NullHandler())
-
-
-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
-    )
-
-
-@lru_cache(maxsize=LRU_CACHE_SIZE)
-def get_timestampc(
-    current_timezone: timezone = MSK_TIMEZONE,
-    days: float = 0,
-    hours: float = 0,
-    minutes: float = 0,
-    seconds: float = 0,
-) -> datetime:
-    """CACHED. Cached version of the get_timestamp() method."""
-
-    return get_timestamp(current_timezone, days, hours, minutes, seconds)
-
-
-def get_dates_range_before_date(date: datetime, tzinfo: timezone) -> tuple[int, int]:
-    """Generates two dates range - date_from/date_to for the time period 'before today' - from the 1st day
-    of the current month till the today - 1 day (current month). In case today is 1st day - range for the
-    whole previous month, if today is 01.01.XXXX - range for 01.12.XXXX-1 - 31.12.XXXX-1.
-    """
-
-    log.debug("get_dates_range_before_date(): the date [%s].", date)
-
-    tstamp_from: int = 0
-    tstamp_to: int = 0
-
-    if date:  # if date is OK (not empty/None)
-
-        # - processing and calculating dates
-        if date.day == 1:  # today - 1st day of month, we need report for the previous month
-
-            if date.month == 1:  # we are at 01.01.XXXX - we need report for Dec.XXXX - 1
-
-                date_from = datetime(date.year - 1, 12, 1, tzinfo=tzinfo)  # from: 01 Dec Year-1 (prev. year)
-                date_to = datetime(date.year - 1, 12, 31, tzinfo=tzinfo)  # to: 31 Dec Year-1 (prev. year)
-
-            else:  # we are at 01.XX.XXXX - we need report for previous month
-
-                # from: 01 Month-1 Year
-                date_from = datetime(date.year, date.month - 1, 1, tzinfo=tzinfo)
-                # last day of the previous month
-                _, last_day = calendar.monthrange(date.year, date.month - 1)
-                # to: Last Day Month-1 Year
-                date_to = datetime(date.year, date.month - 1, last_day, tzinfo=tzinfo)
-
-        else:  # today isn't the 1st, we need report from 1st till yesterday
-
-            date_from = datetime(date.year, date.month, 1, tzinfo=tzinfo)  # from: 01 Month Year
-            date_to = datetime(date.year, date.month, date.day - 1, tzinfo=tzinfo)  # to: Day-1 Month Year
-
-        # - final date/time - date from: XX.XX.XX 00:00:00
-        tstamp_from = int(
-            datetime(
-                date_from.year, date_from.month, date_from.day, hour=0, minute=0, second=0, tzinfo=tzinfo
-            ).timestamp()
-        )
-        # - final date/time - # date to: XX.XX.XXXX 23:59:59
-        tstamp_to = int(
-            datetime(
-                date_to.year, date_to.month, date_to.day, hour=23, minute=59, second=59, tzinfo=tzinfo
-            ).timestamp()
-        )
-
-    log.debug("Timestamps for [%s]: from [%s], to [%s].", date, tstamp_from, tstamp_to)
-
-    # - return the tuple of values
-    return (tstamp_from, tstamp_to)
-
-
-@lru_cache(maxsize=LRU_CACHE_SIZE)
-def get_dates_range_before_datec(date: datetime, tzinfo: timezone) -> tuple[int, int]:
-    """CACHED. Cached version of the get_dates_range_before_date()."""
-
-    return get_dates_range_before_date(date, tzinfo)
-
-
-def human_readable_duration_seconds(duration_seconds):
-    """Convert duration in seconds into human-readable string-duration."""
-
-    days = duration_seconds // (24 * 3600)
-    hours = (duration_seconds % (24 * 3600)) // 3600
-    minutes = (duration_seconds % (24 * 3600)) % 3600 // 60
-    seconds = duration_seconds % 3600 % 60
-
-    result = ""
-    if days > 0:
-        result += f"{days} д. "
-    if hours > 0:
-        result += f"{hours} ч. "
-    if minutes > 0:
-        result += f"{minutes:02d} мин. "
-    result += f"{seconds:02d} сек."
-    result = result.strip()
-
-    log.debug("Converted duration: [%s] into readable str: [%s].", duration_seconds, result)
-
-    return result
-
-
-@lru_cache(maxsize=LRU_CACHE_SIZE)
-def human_readable_duration_secondsc(duration_seconds):
-    """CACHED. Cached version of the human_readable_duration_seconds() method."""
-
-    return human_readable_duration_seconds(duration_seconds)
-
-
-if __name__ == "__main__":
-    print(MSG_MODULE_ISNT_RUNNABLE)