pypomes-core 0.1.0__tar.gz

pypomes_core-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+.idea
+.env
+temp
+tmp
+**/__pycache__
+/dist
+/env
+.vscode
+*.py[cod]
+deploy.txt

pypomes_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 GT Nunes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pypomes_core-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.1
+Name: pypomes-core
+Version: 0.1.0
+Summary: A collection of Python pomes, pennyeach (core modules)
+Project-URL: Homepage, https://github.com/TheWiseCoder/PyPomes-Core
+Project-URL: Bug Tracker, https://github.com/TheWiseCoder/PyPomes-Core/issues
+Author-email: GT Nunes <wisecoder01@gmail.com>
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: flask>=2.3.2
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: setuptools>=68.0.0
+Requires-Dist: wheel>=0.40.0
+Requires-Dist: xmltodict3>=0.0.4

pypomes_core-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = [
+    "hatchling"
+]
+build-backend = "hatchling.build"
+
+[project]
+name = "pypomes-core"
+version = "0.1.0"
+authors = [
+  { name="GT Nunes", email="wisecoder01@gmail.com" },
+]
+description = "A collection of Python pomes, pennyeach (core modules)"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "Flask>=2.3.2",
+    "python-dateutil>=2.8.2",
+    "setuptools>=68.0.0",
+    "wheel>=0.40.0",
+    "xmltodict3>=0.0.4"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/TheWiseCoder/PyPomes-Core"
+"Bug Tracker" = "https://github.com/TheWiseCoder/PyPomes-Core/issues"

pypomes_core-0.1.0/src/pypomes-core/__init__.py

@@ -0,0 +1,71 @@
+from .datetime_pomes import (
+    DATE_FORMAT_STD, DATE_FORMAT_COMPACT, DATE_FORMAT_INV,
+    DATETIME_FORMAT_STD, DATETIME_FORMAT_COMPACT, DATETIME_FORMAT_INV,
+    date_reformat, date_parse, datetime_parse
+)
+from .dict_pomes import (
+    dict_has_key_chain, dict_get_value, dict_set_value, dict_reduce,
+    dict_listify, dict_transform, dict_merge, dict_coalesce, dict_get_key,
+    dict_get_keys, dict_from_object, dict_from_form, dict_from_list, dict_replace_value, dict_pop_value
+)
+from .email_pomes import (
+    EMAIL_ACCOUNT, EMAIL_PWD, EMAIL_PORT, EMAIL_SERVER, email_send,
+)
+from .encoding_pomes import (
+    encode_ascii_hex, decode_ascii_hex
+)
+from .env_pomes import (
+    APP_PREFIX, env_get_str, env_get_int, env_get_bool, env_get_float
+)
+from .exception_pomes import (
+    exc_format
+)
+from .file_pomes import (
+    file_from_request
+)
+from .json_pomes import (
+    jsonify_dict, jsonify_iterable
+)
+from .list_pomes import (
+    list_compare, list_flatten, list_unflatten,
+    list_find_coupled, list_elem_starting_with, list_transform,
+)
+from .str_pomes import (
+    str_between, str_split_on_mark, str_find_whitespace
+)
+from .xml_pomes import (
+    xml_to_dict, xml_normalize_keys
+)
+
+__all__ = [
+    # datetime_pomes
+    DATE_FORMAT_STD, DATE_FORMAT_COMPACT, DATE_FORMAT_INV,
+    DATETIME_FORMAT_STD, DATETIME_FORMAT_COMPACT, DATETIME_FORMAT_INV,
+    date_reformat, date_parse, datetime_parse,
+    # dict_pomes
+    dict_has_key_chain, dict_get_value, dict_set_value, dict_reduce,
+    dict_listify, dict_transform, dict_merge, dict_coalesce, dict_get_key,
+    dict_get_keys, dict_from_object, dict_from_form, dict_from_list, dict_replace_value, dict_pop_value,
+    # email_pomes
+    EMAIL_ACCOUNT, EMAIL_PWD, EMAIL_PORT, EMAIL_SERVER, email_send,
+    # encoding_pomes
+    encode_ascii_hex, decode_ascii_hex,
+    # env_pomes
+    APP_PREFIX, env_get_str, env_get_int, env_get_bool, env_get_float,
+    # exception_pomes
+    exc_format,
+    # file_pomes
+    file_from_request,
+    # json_pomes
+    jsonify_dict, jsonify_iterable,
+    # list_pomes
+    list_compare, list_flatten, list_unflatten,
+    list_find_coupled, list_elem_starting_with, list_transform,
+    # str_pomes
+    str_between, str_split_on_mark, str_find_whitespace,
+    # xml_pomes
+    xml_to_dict, xml_normalize_keys
+]
+
+__version__ = "0.1.0"
+__version_info__ = (0, 1, 0)

pypomes_core-0.1.0/src/pypomes-core/datetime_pomes.py

@@ -0,0 +1,62 @@
+from datetime import date, datetime
+from dateutil import parser
+from typing import Final
+
+# some useful date/datetime formats
+DATE_FORMAT_STD: Final[str] = "%m/%d/%Y"
+DATE_FORMAT_COMPACT: Final[str] = "%Y%m%d"
+DATE_FORMAT_INV: Final[str] = "%Y-%m-%d"
+DATETIME_FORMAT_STD: Final[str] = "%m/%d/%Y %H:%M:%S"
+DATETIME_FORMAT_COMPACT: Final[str] = "%Y%m%d%H%M%S"
+DATETIME_FORMAT_INV: Final[str] = "%Y-%m-%d %H:%M:%S"
+
+
+def date_reformat(dt_str: str, to_format: str, **kwargs: any) -> str:
+    """
+    Convert the date in *dt_str* to the format especified in *to_format*.
+    The argument *dt_str* must represent a valid date, with or without time-of-day information.
+    The argument *to_format* must be a valid format for *date* ou *datetime*.
+
+    :param dt_str: The date to convert.
+    :param to_format: The format for the conversion.
+    :param kwargs: Optional arguments for the parser in python-dateutil ('dayfirst' is a common argument).
+    :return:  The converted date.
+    """
+    result: str | None = None
+    ts: datetime = parser.parse(dt_str, **kwargs)
+    if ts is not None:
+        result = datetime.strftime(ts, to_format)
+
+    return result
+
+
+def date_parse(dt_str: str, **kwargs: any) -> date:
+    """
+    Obtain and return the *date* object corresponding to *dt_str*.
+    Return *None* se *dt_str* does not contain a valid date.
+
+    :param dt_str: The date, in a supported format.
+    :param kwargs: Optional arguments for the parser in python-dateutil ('dayfirst' is a common argument).
+    :return: The corresponding date object, or None.
+    """
+    result: date | None = None
+    if dt_str is not None:
+        result = parser.parse(dt_str, **kwargs).date()
+
+    return result
+
+
+def datetime_parse(dt_str: str, **kwargs: any) -> datetime:
+    """
+   Obtain and return the *datetime* object corresponding to *dt_str*.
+   Return *None* se *dt_str* does not contain a valid date.
+
+    :param dt_str: The date, in a supported format.
+    :param kwargs: Optional arguments for the parser in python-dateutil ('dayfirst' is a common argument).
+    :return: The corresponding datetime object, or None.
+    """
+    result: datetime | None = None
+    if dt_str is not None:
+        result = parser.parse(dt_str, **kwargs)
+
+    return result