none-shall-parse 0.4.1__tar.gz → 0.4.2__tar.gz

{none_shall_parse-0.4.1 → none_shall_parse-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: none-shall-parse
-Version: 0.4.1
+Version: 0.4.2
 Summary: Trinity Shared Python utilities.
 Author: Andries Niemandt, Jan Badenhorst
 Author-email: Andries Niemandt <andries.niemandt@trintel.co.za>, Jan Badenhorst <jan@trintel.co.za>

{none_shall_parse-0.4.1 → none_shall_parse-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "none-shall-parse"
-version = "0.4.1"
+version = "0.4.2"
 description = "Trinity Shared Python utilities."
 readme = "README.md"
 authors = [

none_shall_parse-0.4.2/src/none_shall_parse/__init__.py

@@ -0,0 +1,133 @@
+"""Trinity Shared Python utilities.
+
+A collection of shared utilities for Trinity projects.
+
+Originally intended to be parsing utilities, this grew to include
+other useful functions.
+
+Named for its author Andries Niemandt - whose surname loosely
+translates to "none". Combined this with our parsing intentions
+to create a name which nods to the Black Knight in Monty Python's Holy Grail.
+https://www.youtube.com/watch?v=zKhEw7nD9C4
+"""
+from __future__ import annotations
+from .dates import (
+    DateUtilsError, assert_week_start_date_is_valid,
+    assert_month_start_date_is_valid,
+    get_datetime_now, za_now,
+    za_ordinal_year_day_now,
+    za_ordinal_year_day_tomorrow, utc_epoch_start,
+    now_offset_n_minutes, now_offset_n_hours,
+    now_offset_n_days, get_datetime_tomorrow,
+    get_datetime_yesterday,
+    get_utc_datetime_offset_n_days,
+    epoch_to_datetime, epoch_to_utc_datetime,
+    is_office_hours_in_timezone,
+    get_datetime_from_ordinal_and_sentinel,
+    day_span, week_span, month_span, arb_span,
+    calendar_month_start_end, unix_timestamp,
+    sentinel_date_and_ordinal_to_date,
+    seconds_to_end_of_month, standard_tz_timestring,
+    get_notice_end_date, dt_to_za_time_string,
+    months_ago_selection, is_aware, make_aware,
+    unaware_to_utc_aware, timer_decorator, ZA_TZ,
+    UTC_TZ, keys_for_span_func,
+)
+from .imeis import (
+    get_luhn_digit,
+    is_valid_luhn,
+    is_valid_imei,
+    normalize_imei,
+    get_tac_from_imei,
+    decrement_imei,
+    increment_imei,
+)
+
+from .lists import (
+    flatten,
+    safe_list_get,
+)
+from .parse import (
+    str_to_bool,
+    is_true,
+    is_false,
+    str_to_strs_list,
+    int_to_bool,
+    int_or_none,
+    choices_code_to_string,
+    choices_string_to_code,
+    none_or_empty,
+)
+from .strings import (
+    slugify,
+    random_16,
+    to_human_string,
+    is_quoted_string,
+    is_numeric_string,
+    custom_slug,
+    b64_encode,
+    b64_decode,
+    calc_hash,
+    generate_random_password,
+)
+from .types import (
+    StringLike,
+    ChoicesType
+)
+
+__author__ = "Andries Niemandt, Jan Badenhorst"
+__email__ = "andries.niemandt@trintel.co.za, jan@trintel.co.za"
+__license__ = "MIT"
+
+__all__ = (
+    "DateUtilsError", "assert_week_start_date_is_valid",
+    "assert_month_start_date_is_valid",
+    "get_datetime_now", "za_now",
+    "za_ordinal_year_day_now",
+    "za_ordinal_year_day_tomorrow", "utc_epoch_start",
+    "now_offset_n_minutes", "now_offset_n_hours",
+    "now_offset_n_days", "get_datetime_tomorrow",
+    "get_datetime_yesterday",
+    "get_utc_datetime_offset_n_days",
+    "epoch_to_datetime", "epoch_to_utc_datetime",
+    "is_office_hours_in_timezone",
+    "get_datetime_from_ordinal_and_sentinel",
+    "day_span", "week_span", "month_span", "arb_span",
+    "calendar_month_start_end", "unix_timestamp",
+    "sentinel_date_and_ordinal_to_date",
+    "seconds_to_end_of_month", "standard_tz_timestring",
+    "get_notice_end_date", "dt_to_za_time_string",
+    "months_ago_selection", "is_aware", "make_aware",
+    "unaware_to_utc_aware", "timer_decorator", "ZA_TZ",
+    "UTC_TZ", "keys_for_span_func",
+    "get_luhn_digit",
+    "is_valid_luhn",
+    "is_valid_imei",
+    "normalize_imei",
+    "get_tac_from_imei",
+    "decrement_imei",
+    "increment_imei",
+    "flatten",
+    "safe_list_get",
+    "str_to_bool",
+    "is_true",
+    "is_false",
+    "str_to_strs_list",
+    "int_to_bool",
+    "int_or_none",
+    "choices_code_to_string",
+    "choices_string_to_code",
+    "none_or_empty",
+    "slugify",
+    "random_16",
+    "to_human_string",
+    "is_quoted_string",
+    "is_numeric_string",
+    "custom_slug",
+    "b64_encode",
+    "b64_decode",
+    "calc_hash",
+    "generate_random_password",
+    "StringLike",
+    "ChoicesType"
+)

{none_shall_parse-0.4.1 → none_shall_parse-0.4.2}/src/none_shall_parse/imeis.py

@@ -1,9 +1,8 @@
-from typing import Union
 
 LUHN_DOUBLES = [0, 2, 4, 6, 8, 1, 3, 5, 7, 9]
 
 
-def get_luhn_digit(n: Union[str, int]) -> int:
+def get_luhn_digit(n: str | int) -> int:
     """
     Calculates the Luhn checksum digit for a given number.
 
@@ -26,7 +25,7 @@ def get_luhn_digit(n: Union[str, int]) -> int:
     return divmod(check, 10)[1]
 
 
-def is_valid_luhn(n: Union[str, int]) -> bool:
+def is_valid_luhn(n: str | int) -> bool:
     """
     Determines if a given number, represented as a string or integer, adheres
     to the Luhn algorithm.
@@ -78,7 +77,7 @@ def is_valid_luhn(n: Union[str, int]) -> bool:
     return divmod(final, 10)[1] == 0
 
 
-def is_valid_imei(n: Union[str, int]) -> bool:
+def is_valid_imei(n: str | int) -> bool:
     """
     Determines whether the given number is a valid IMEI (International Mobile
     Equipment Identity) number.
@@ -98,7 +97,7 @@ def is_valid_imei(n: Union[str, int]) -> bool:
     return len(str(n)) == 15 and is_valid_luhn(n)
 
 
-def normalize_imei(c: Union[str, int]) -> str:
+def normalize_imei(c: str | int) -> str:
     """
     Normalizes the given IMEI number by extracting the first 14 digits and appending
     the calculated Luhn check digit to make it a valid IMEI.
@@ -131,7 +130,7 @@ def normalize_imei(c: Union[str, int]) -> str:
     return "%s%s" % (t, check_digit)
 
 
-def get_tac_from_imei(n: Union[str, int]) -> tuple[bool, str]:
+def get_tac_from_imei(n: str | int) -> tuple[bool, str]:
     """
     Determines the validity of an IMEI number and extracts its TAC if valid.
 
@@ -156,7 +155,7 @@ def get_tac_from_imei(n: Union[str, int]) -> tuple[bool, str]:
         return True, tac
 
 
-def decrement_imei(n: Union[str, int]) -> tuple[bool, str]:
+def decrement_imei(n: str | int) -> tuple[bool, str]:
     """
     Decrements the given IMEI number by one and normalizes it.
 
@@ -184,7 +183,7 @@ def decrement_imei(n: Union[str, int]) -> tuple[bool, str]:
         return True, result
 
 
-def increment_imei(n: Union[str, int]) -> tuple[bool, str]:
+def increment_imei(n: str | int) -> tuple[bool, str]:
     """
     Determines if a given IMEI number is valid and increments it by 1 if valid.
 

none_shall_parse-0.4.1/src/none_shall_parse/__init__.py

@@ -1,15 +0,0 @@
-"""Trinity Shared Python utilities.
-
-A collection of shared utilities for Trinity projects.
-
-Originally intended to be parsing utilities, this grew to include
-other useful functions.
-
-Named for its author Andries Niemandt - whose surname loosely
-translates to "none". Combined this with our parsing intentions
-to create a name which nods to the Black Knight in Monty Python's Holy Grail.
-https://www.youtube.com/watch?v=zKhEw7nD9C4
-"""
-
-__author__ = "Andries Niemandt, Jan Badenhorst"
-__email__ = "andries.niemandt@trintel.co.za, jan@trintel.co.za"