potato-util 0.1.0__tar.gz → 0.2.0__tar.gz

{potato_util-0.1.0/src/potato_util.egg-info → potato_util-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: potato_util
-Version: 0.1.0
+Version: 0.2.0
 Summary: 'potato_util' is collection of simple useful utils package for python.
 Author-email: Batkhuu Byambajav <batkhuu10@gmail.com>
 Project-URL: Homepage, https://github.com/bybatkhuu/module-python-utils
@@ -21,6 +21,8 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <4.0,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Requires-Dist: toml>=0.10.2; python_version < "3.11"
+Requires-Dist: PyYAML<7.0.0,>=6.0.2
 Requires-Dist: python-dotenv<2.0.0,>=1.0.1
 Requires-Dist: pydantic[email,timezone]<3.0.0,>=2.0.3
 Requires-Dist: pydantic-settings<3.0.0,>=2.2.1

{potato_util-0.1.0 → potato_util-0.2.0}/requirements.txt

@@ -1,3 +1,5 @@
+toml>=0.10.2; python_version < "3.11"
+PyYAML>=6.0.2,<7.0.0
 python-dotenv>=1.0.1,<2.0.0
 pydantic[email,timezone]>=2.0.3,<3.0.0
 pydantic-settings>=2.2.1,<3.0.0

potato_util-0.2.0/src/potato_util/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{potato_util-0.1.0 → potato_util-0.2.0}/src/potato_util/io/_async.py

@@ -1,7 +1,21 @@
+import sys
+import json
 import errno
 import hashlib
 import logging
+import configparser
+from pathlib import Path
+from typing import Any
 
+_binary_toml = False
+if sys.version_info >= (3, 11):
+    import tomllib  # type: ignore
+
+    _binary_toml = True
+else:
+    import toml as tomllib  # type: ignore
+
+import yaml
 import aioshutil
 import aiofiles.os
 from pydantic import validate_call
@@ -276,6 +290,195 @@ async def async_get_file_checksum(
     return _file_checksum
 
 
+@validate_call
+async def async_read_yaml_file(file_path: str | Path) -> dict[str, Any]:
+    """Asynchronous read YAML file.
+
+    Args:
+        file_path (str | Path, required): YAML file path.
+
+    Raises:
+        FileNotFoundError: If YAML file is not found.
+        Exception        : If failed to read YAML file.
+
+    Returns:
+        dict[str, Any]: YAML file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not await aiofiles.os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' YAML file!")
+
+    try:
+        async with aiofiles.open(file_path, "r", encoding="utf-8") as _file:
+            _content = await _file.read()
+            _data = yaml.safe_load(_content) or {}
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' YAML file!")
+        raise
+
+    return _data
+
+
+@validate_call
+async def async_read_json_file(file_path: str | Path) -> dict[str, Any]:
+    """Asynchronous read JSON file.
+
+    Args:
+        file_path (str | Path, required): JSON file path.
+
+    Raises:
+        FileNotFoundError: If JSON file is not found.
+        Exception        : If failed to read JSON file.
+
+    Returns:
+        dict[str, Any]: JSON file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not await aiofiles.os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' JSON file!")
+
+    try:
+        async with aiofiles.open(file_path, "r", encoding="utf-8") as _file:
+            _content = await _file.read()
+            _data = json.loads(_content) or {}
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' JSON file!")
+        raise
+
+    return _data
+
+
+@validate_call
+async def async_read_toml_file(file_path: str | Path) -> dict[str, Any]:
+    """Asynchronous read TOML file.
+
+    Args:
+        file_path (str | Path, required): TOML file path.
+
+    Raises:
+        FileNotFoundError: If TOML file is not found.
+        Exception        : If failed to read TOML file.
+
+    Returns:
+        dict[str, Any]: TOML file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not await aiofiles.os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' TOML file!")
+
+    try:
+        _content: str = ""
+        if _binary_toml:
+            async with aiofiles.open(file_path, "rb") as _file:
+                _content = await _file.read()  # type: ignore
+                _data = tomllib.load(_content) or {}
+        else:
+            async with aiofiles.open(file_path, "r", encoding="utf-8") as _file:
+                _content = await _file.read()  # type: ignore
+                _data = tomllib.loads(_content) or {}
+
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' TOML file!")
+        raise
+
+    return _data
+
+
+@validate_call
+async def async_read_ini_file(file_path: str | Path) -> dict[str, Any]:
+    """Asynchronous read INI config file.
+
+    Args:
+        file_path (str | Path, required): INI config file path.
+
+    Raises:
+        FileNotFoundError: If INI config file is not found.
+        Exception        : If failed to read INI config file.
+
+    Returns:
+        dict[str, Any]: INI config file data as dictionary.
+    """
+
+    _config: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not await aiofiles.os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' INI config file!")
+
+    try:
+        _content: str = ""
+        async with aiofiles.open(file_path, "r", encoding="utf-8") as _file:
+            _content = await _file.read()
+
+        _config_parser = configparser.ConfigParser()
+        _config_parser.read_string(_content)
+        for _section in _config_parser.sections():
+            _config[_section] = dict(_config_parser.items(_section))
+
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' INI config file!")
+        raise
+
+    return _config
+
+
+@validate_call
+async def async_read_config_file(config_path: str | Path) -> dict[str, Any]:
+    """Asynchronous read config file (YAML, JSON, TOML, INI).
+
+    Args:
+        config_path (str | Path, required): Config file path.
+
+    Raises:
+        FileNotFoundError: If config file is not found.
+        ValueError        : If config file format is not supported.
+
+    Returns:
+        dict[str, Any]: Config file data as dictionary.
+    """
+
+    _config: dict[str, Any] = {}
+
+    if isinstance(config_path, str):
+        config_path = Path(config_path)
+
+    if not await aiofiles.os.path.isfile(config_path):
+        raise FileNotFoundError(f"Not found '{config_path}' config file!")
+
+    _suffix = config_path.suffix.lower()
+    if _suffix in (".yaml", ".yml"):
+        _config = await async_read_yaml_file(config_path)
+    elif _suffix == ".json":
+        _config = await async_read_json_file(config_path)
+    elif _suffix == ".toml":
+        _config = await async_read_toml_file(config_path)
+    elif _suffix in (".ini", ".cfg"):
+        _config = await async_read_ini_file(config_path)
+    else:
+        raise ValueError(
+            f"Unsupported config file format '{_suffix}' for '{config_path}'!"
+        )
+
+    return _config
+
+
 __all__ = [
     "async_create_dir",
     "async_remove_dir",
@@ -283,4 +486,9 @@ __all__ = [
     "async_remove_file",
     "async_remove_files",
     "async_get_file_checksum",
+    "async_read_yaml_file",
+    "async_read_json_file",
+    "async_read_toml_file",
+    "async_read_ini_file",
+    "async_read_config_file",
 ]

{potato_util-0.1.0 → potato_util-0.2.0}/src/potato_util/io/_sync.py

@@ -1,11 +1,28 @@
+# noqa: E402
+
 import os
+import sys
+import json
 import errno
 import shutil
 import hashlib
 import logging
+import configparser
+from pathlib import Path
+from typing import Any
+
+_binary_toml = False
+if sys.version_info >= (3, 11):
+    import tomllib  # type: ignore
+
+    _binary_toml = True
+else:
+    import toml as tomllib  # type: ignore
 
+import yaml
 from pydantic import validate_call
 
+
 from ..constants import WarnEnum, HashAlgoEnum, MAX_PATH_LENGTH
 
 
@@ -270,6 +287,185 @@ def get_file_checksum(
     return _file_checksum
 
 
+@validate_call
+def read_yaml_file(file_path: str | Path) -> dict[str, Any]:
+    """Read YAML file.
+
+    Args:
+        file_path (str | Path, required): YAML file path.
+
+    Raises:
+        FileNotFoundError: If YAML file is not found.
+        Exception        : If failed to read YAML file.
+
+    Returns:
+        dict[str, Any]: YAML file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' YAML file!")
+
+    try:
+        with open(file_path, encoding="utf-8") as _file:
+            _data = yaml.safe_load(_file) or {}
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' YAML file!")
+        raise
+
+    return _data
+
+
+@validate_call
+def read_json_file(file_path: str | Path) -> dict[str, Any]:
+    """Read JSON file.
+
+    Args:
+        file_path (str | Path, required): JSON file path.
+
+    Raises:
+        FileNotFoundError: If JSON file is not found.
+        Exception        : If failed to read JSON file.
+
+    Returns:
+        dict[str, Any]: JSON file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' JSON file!")
+
+    try:
+        with open(file_path, encoding="utf-8") as _file:
+            _data = json.load(_file) or {}
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' JSON file!")
+        raise
+
+    return _data
+
+
+@validate_call
+def read_toml_file(file_path: str | Path) -> dict[str, Any]:
+    """Read TOML file.
+
+    Args:
+        file_path (str | Path, required): TOML file path.
+
+    Raises:
+        FileNotFoundError: If TOML file is not found.
+        Exception        : If failed to read TOML file.
+
+    Returns:
+        dict[str, Any]: TOML file data as dictionary.
+    """
+
+    _data: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' TOML file!")
+
+    try:
+        if _binary_toml:
+            with open(file_path, "rb") as _file:
+                _data = tomllib.load(_file) or {}  # type: ignore
+        else:
+            with open(file_path, encoding="utf-8") as _file:
+                _data = tomllib.load(_file) or {}  # type: ignore
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' TOML file!")
+        raise
+
+    return _data
+
+
+@validate_call
+def read_ini_file(file_path: str | Path) -> dict[str, Any]:
+    """Read INI config file.
+
+    Args:
+        file_path (str | Path, required): INI config file path.
+
+    Raises:
+        FileNotFoundError: If INI config file is not found.
+        Exception        : If failed to read INI config file.
+
+    Returns:
+        dict[str, Any]: INI config file data as dictionary.
+    """
+
+    _config: dict[str, Any] = {}
+
+    if isinstance(file_path, str):
+        file_path = Path(file_path)
+
+    if not os.path.isfile(file_path):
+        raise FileNotFoundError(f"Not found '{file_path}' INI config file!")
+
+    try:
+        _config_parser = configparser.ConfigParser()
+        _config_parser.read(file_path)
+        for _section in _config_parser.sections():
+            _config[_section] = dict(_config_parser.items(_section))
+
+    except Exception:
+        logger.error(f"Failed to read '{file_path}' INI config file!")
+        raise
+
+    return _config
+
+
+@validate_call
+def read_config_file(config_path: str | Path) -> dict[str, Any]:
+    """Read config file (YAML, JSON, TOML, INI).
+
+    Args:
+        config_path (str | Path, required): Config file path.
+
+    Raises:
+        FileNotFoundError: If config file is not found.
+        ValueError       : If config file format is not supported.
+
+    Returns:
+        dict[str, Any]: Config file data as dictionary.
+    """
+
+    _config: dict[str, Any] = {}
+
+    if isinstance(config_path, str):
+        config_path = Path(config_path)
+
+    if not os.path.isfile(config_path):
+        raise FileNotFoundError(f"Not found '{config_path}' config file!")
+
+    _suffix = config_path.suffix.lower()
+    if _suffix in (".yaml", ".yml"):
+        _config = read_yaml_file(file_path=config_path)
+    elif _suffix == ".json":
+        _config = read_json_file(file_path=config_path)
+    elif _suffix == ".toml":
+        _config = read_toml_file(file_path=config_path)
+    elif _suffix in (".ini", ".cfg"):
+        _config = read_ini_file(file_path=config_path)
+    else:
+        raise ValueError(
+            f"Unsupported config file format '{config_path.suffix}' for '{config_path}'!"
+        )
+
+    return _config
+
+
 __all__ = [
     "create_dir",
     "remove_dir",
@@ -277,4 +473,9 @@ __all__ = [
     "remove_file",
     "remove_files",
     "get_file_checksum",
+    "read_yaml_file",
+    "read_json_file",
+    "read_toml_file",
+    "read_ini_file",
+    "read_config_file",
 ]

{potato_util-0.1.0 → potato_util-0.2.0/src/potato_util.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: potato_util
-Version: 0.1.0
+Version: 0.2.0
 Summary: 'potato_util' is collection of simple useful utils package for python.
 Author-email: Batkhuu Byambajav <batkhuu10@gmail.com>
 Project-URL: Homepage, https://github.com/bybatkhuu/module-python-utils
@@ -21,6 +21,8 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <4.0,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Requires-Dist: toml>=0.10.2; python_version < "3.11"
+Requires-Dist: PyYAML<7.0.0,>=6.0.2
 Requires-Dist: python-dotenv<2.0.0,>=1.0.1
 Requires-Dist: pydantic[email,timezone]<3.0.0,>=2.0.3
 Requires-Dist: pydantic-settings<3.0.0,>=2.2.1

{potato_util-0.1.0 → potato_util-0.2.0}/src/potato_util.egg-info/requires.txt

@@ -1,7 +1,11 @@
+PyYAML<7.0.0,>=6.0.2
 python-dotenv<2.0.0,>=1.0.1
 pydantic[email,timezone]<3.0.0,>=2.0.3
 pydantic-settings<3.0.0,>=2.2.1
 
+[:python_version < "3.11"]
+toml>=0.10.2
+
 [all]
 aiofiles<26.0.0,>=24.1.0
 aioshutil<2.0.0,>=1.5

potato_util-0.1.0/src/potato_util/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"