umt-python 0.2.0__tar.gz → 0.3.0__tar.gz

{umt_python-0.2.0 → umt_python-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: umt_python
-Version: 0.2.0
+Version: 0.3.0
 Summary: A collection of useful utility functions for various tasks in Python, focusing on string manipulation and formatting.
 Author-email: riya-amemiya <riyaamemiya@gmail.com>
 License-Expression: MIT
@@ -101,6 +101,14 @@ print(encoded)  # "SGVsbG8gV29ybGQ="
 |----------|------|-------------|---------|
 | `has_no_letters` | `(text: str) -> bool` | Check if string contains no letters (only numbers, emojis, special chars) | `has_no_letters("123!@#")  # True` / `has_no_letters("abc123")  # False` |
 
+### Number Functions
+
+| Function | Type | Description | Example |
+|----------|------|-------------|---------|
+| `format_number` | `(value: float \| int, *, locale: str \| None = None, minimum_fraction_digits: int \| None = None, maximum_fraction_digits: int \| None = None, style: Literal["decimal", "currency", "percent"] = "decimal", currency: str \| None = None) -> str` | Format a number with locale-aware separators, fraction-digit controls, and decimal/percent/currency styles. Mirrors `Intl.NumberFormat` from the TypeScript source. | `format_number(1234567.89)  # "1,234,567.89"` / `format_number(1234567.89, locale="de-DE")  # "1.234.567,89"` / `format_number(0.75, style="percent")  # "75%"` / `format_number(1234.5, style="currency", currency="USD")  # "$1,234.50"` |
+| `to_ordinal` | `(value: int \| float) -> str` | Convert a number to its English ordinal string (handles 11th/12th/13th specially) | `to_ordinal(1)  # "1st"` / `to_ordinal(11)  # "11th"` / `to_ordinal(21)  # "21st"` |
+| `to_percentage` | `(value: float \| int, total: float \| int, decimals: int = 2) -> float` | Calculate the percentage of a value relative to a total (returns 0 when total is 0) | `to_percentage(1, 3)  # 33.33` / `to_percentage(25, 100)  # 25.0` |
+
 ## Constants
 
 - `DEFAULT_RANDOM_STRING_CHARS`: Default character pool for random string generation (ASCII letters + digits)

{umt_python-0.2.0 → umt_python-0.3.0}/README.md

@@ -78,6 +78,14 @@ print(encoded)  # "SGVsbG8gV29ybGQ="
 |----------|------|-------------|---------|
 | `has_no_letters` | `(text: str) -> bool` | Check if string contains no letters (only numbers, emojis, special chars) | `has_no_letters("123!@#")  # True` / `has_no_letters("abc123")  # False` |
 
+### Number Functions
+
+| Function | Type | Description | Example |
+|----------|------|-------------|---------|
+| `format_number` | `(value: float \| int, *, locale: str \| None = None, minimum_fraction_digits: int \| None = None, maximum_fraction_digits: int \| None = None, style: Literal["decimal", "currency", "percent"] = "decimal", currency: str \| None = None) -> str` | Format a number with locale-aware separators, fraction-digit controls, and decimal/percent/currency styles. Mirrors `Intl.NumberFormat` from the TypeScript source. | `format_number(1234567.89)  # "1,234,567.89"` / `format_number(1234567.89, locale="de-DE")  # "1.234.567,89"` / `format_number(0.75, style="percent")  # "75%"` / `format_number(1234.5, style="currency", currency="USD")  # "$1,234.50"` |
+| `to_ordinal` | `(value: int \| float) -> str` | Convert a number to its English ordinal string (handles 11th/12th/13th specially) | `to_ordinal(1)  # "1st"` / `to_ordinal(11)  # "11th"` / `to_ordinal(21)  # "21st"` |
+| `to_percentage` | `(value: float \| int, total: float \| int, decimals: int = 2) -> float` | Calculate the percentage of a value relative to a total (returns 0 when total is 0) | `to_percentage(1, 3)  # 33.33` / `to_percentage(25, 100)  # 25.0` |
+
 ## Constants
 
 - `DEFAULT_RANDOM_STRING_CHARS`: Default character pool for random string generation (ASCII letters + digits)

{umt_python-0.2.0 → umt_python-0.3.0}/pyproject.toml

@@ -24,7 +24,7 @@ license = "MIT"
 name = "umt_python"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "0.2.0"
+version = "0.3.0"
 
 [project.urls]
 "Bug Tracker" = "https://github.com/riya-amemiya/UMT/issues"
@@ -33,10 +33,10 @@ version = "0.2.0"
 
 [dependency-groups]
 dev = [
-  "pyright==1.1.408",
-  "pytest==9.0.2",
-  "pytest-cov==7.0.0",
-  "ruff==0.15.4",
+  "pyright==1.1.410",
+  "pytest==9.0.3",
+  "pytest-cov==7.1.0",
+  "ruff==0.15.15",
 ]
 
 [tool.ruff.lint]
@@ -67,3 +67,4 @@ ignore = ["E501", "FBT003", "A005", "PLR2004", "PLR0911","PLR0912","PLR0913"]
 [tool.ruff.lint.per-file-ignores]
 "tests/**/*.py" = ["ALL"]
 "src/string/to_half_width.py" = ["RUF"]
+"src/string/to_full_width.py" = ["RUF"]

{umt_python-0.2.0 → umt_python-0.3.0}/src/__init__.py

@@ -1,3 +1,6 @@
+from .advance import (
+    range_advance,
+)
 from .array import (
     ValidatedSortRange,
     apply_insertion_sort_if_needed,
@@ -33,6 +36,21 @@ from .array import (
     zip_arrays,
     zip_longest,
 )
+from .async_util import (
+    AbortSignal,
+    DebouncedAsyncFunction,
+    Deferred,
+    SettledResult,
+    ThrottledAsyncFunction,
+    debounce_async,
+    defer,
+    p_settled,
+    parallel,
+    sleep,
+    throttle_async,
+    timeout,
+    wait_for,
+)
 from .color import (
     cmyk_to_rgba,
     hexa_to_rgba,
@@ -57,6 +75,7 @@ from .consts import (
     HttpInformationalStatus,
     HttpRedirectionStatus,
     HttpServerErrorStatus,
+    HttpStatus,
     HttpSuccessStatus,
 )
 from .crypto import (
@@ -68,30 +87,55 @@ from .crypto import (
     encode_base58,
 )
 from .data_structure import (
+    LRUCache,
     PriorityQueue,
+    TTLCache,
 )
 from .date import (
     DAY_LIST,
+    add_duration,
     birthday,
     date_format,
     date_now,
     date_range,
     day_of_week,
+    diff,
+    end_of,
+    format_relative,
     get_day,
     get_timezone_offset_string,
+    is_business_day,
     is_leap_year,
+    is_same_day,
+    is_weekend,
+    ms_by_unit,
     new_date_int,
     new_date_string,
+    start_of,
+    sub_duration,
 )
 from .error import (
     Error,
     Result,
     Success,
+    error_function,
+    flat_map_result,
+    map_result,
+    match_result,
     retry,
     safe_execute,
+    success_function,
 )
 from .function import (
+    DebouncedFunction,
+    MemoizedFunction,
+    OnceFunction,
+    ThrottledFunction,
     curry,
+    debounce,
+    memoize,
+    once,
+    throttle,
 )
 from .ip import (
     cidr_to_long,
@@ -110,6 +154,10 @@ from .iterator import (
     lazy_map,
     lazy_take,
 )
+from .map import (
+    group_by_to_map,
+    zip_to_map,
+)
 from .math import (
     PrimeFactor,
     ProbabilityFraction,
@@ -117,6 +165,11 @@ from .math import (
     addition,
     average,
     bitwise,
+    calculator,
+    calculator_core,
+    calculator_initialization,
+    clamp,
+    convert_currency,
     correlation_coefficient,
     deg_to_rad,
     deviation_value,
@@ -126,11 +179,13 @@ from .math import (
     flexible_number_conversion,
     gcd,
     get_decimal_length,
+    in_range,
     is_double,
     is_perfect_square,
     is_prime_number,
     lcm,
     linear_congruential_generator,
+    literal_expression,
     math_converter,
     math_separator,
     max_value,
@@ -153,26 +208,66 @@ from .math import (
     solve_equation,
     standard_deviation,
     subtraction,
+    sum_precise,
     to_base_n,
     uuidv7,
     value_swap,
     xoshiro256,
 )
 from .number import (
+    format_number,
     to_ordinal,
+    to_percentage,
 )
 from .object import (
+    deep_clone,
+    flatten_object,
+    get_objects_common,
+    get_objects_diff,
+    invert,
+    map_keys,
+    object_get,
     object_has,
     object_is_empty,
+    object_is_plain,
+    object_key_by,
     object_map_values,
     object_merge,
     object_merge_deep,
     object_omit,
     object_pick,
     object_pick_deep,
+    object_set,
+    omit_by,
+    path_segments,
+    pick_by,
+    remove_prototype,
+    remove_prototype_deep,
+    remove_prototype_map,
+    remove_prototype_map_deep,
+    unflatten_object,
 )
 from .predicate import (
     every,
+    is_not_nullish,
+    is_nullish,
+    matches,
+    not_,
+    some,
+)
+from .random import (
+    WeightedItem,
+    random_boolean,
+    random_choice,
+    random_float,
+    random_uuid,
+    seeded_random,
+    weighted_choice,
+)
+from .simple.date import (
+    birthday_simple,
+    day_of_week_simple,
+    now_simple,
 )
 from .simple.math import (
     deviation_value_simple,
@@ -181,30 +276,60 @@ from .string import (
     DEFAULT_RANDOM_STRING_CHARS,
     HTML_ESCAPE_MAP,
     HTML_UNESCAPE_MAP,
+    Formatter,
     FuzzySearchResult,
+    apply_formatter,
     camel_case,
+    capitalize,
+    capitalize_word,
+    constant_case,
+    count_occurrences,
+    deburr,
+    dedent,
+    default_formatters,
     delete_spaces,
+    detect_mode,
+    ensure_prefix,
+    ensure_suffix,
     escape_html,
     format_string,
     from_base64,
     fuzzy_search,
+    get_value,
     has_no_letters,
+    js_string,
     kebab_case,
     levenshtein_distance,
+    mask,
+    normalize_whitespace,
     pad_end,
     pad_start,
+    pascal_case,
     random_string,
     random_string_initialization,
+    remove_prefix,
+    remove_suffix,
     reverse_string,
+    sanitize_string,
     slugify,
+    snake_case,
+    split_by_length,
     string_similarity,
+    strip_ansi,
+    strip_tags,
+    swap_case,
+    title_case,
     to_base64,
+    to_full_width,
     to_half_width,
     trim_characters,
     trim_end_characters,
     trim_start_characters,
     truncate,
+    uncapitalize,
     unescape_html,
+    word_count,
+    words,
 )
 from .time import (
     convert_time,
@@ -214,8 +339,10 @@ from .tool import (
     Pipe,
     Pipeline,
     create_pipeline,
+    escape_regexp,
     parse_json,
     pipe,
+    unwrap,
 )
 from .ua import (
     extract_browser_from_user_agent,
@@ -229,24 +356,64 @@ from .unit import (
     unit_converter_initialization,
 )
 from .url import (
+    build_url,
     is_absolute_url,
     join_path,
+    parse_query_string,
 )
 from .validate import (
+    AnyReturnType,
+    ArrayOfReturnType,
+    BigIntReturnType,
+    BigIntRule,
+    DateReturnType,
     EmailParts,
+    FileReturnType,
+    FunctionReturnType,
+    FunctionSchema,
+    FunctionValidator,
+    InstanceOfReturnType,
     IsDeepEqualOptions,
+    MapReturnType,
+    NeverReturnType,
+    NumberReturnType,
+    NumberRule,
     ParseEmailLevel,
     ParseEmailOptions,
     ParseEmailResult,
+    SetOfReturnType,
+    StringReturnType,
+    StringRule,
+    TemplateLiteralReturnType,
+    UnknownReturnType,
+    any_validator,
+    array_of,
+    bigint,
+    date,
+    file,
+    func,
+    instance_of,
     is_array,
+    is_boolean,
+    is_browser,
+    is_bun,
     is_deep_equal,
     is_dictionary_object,
     is_equal,
+    is_node,
+    is_node_webkit,
     is_not_empty,
     is_number,
     is_string,
     is_value_nan,
+    map_validator,
+    never_validator,
+    number,
     parse_email,
+    set_of,
+    string,
+    template_literal,
+    unknown_validator,
 )
 
 __all__ = [
@@ -265,15 +432,38 @@ __all__ = [
     "ONE_WEEK_MS",
     "ONE_YEAR_MS",
     "ONE_YEAR_MS_366",
+    "AbortSignal",
+    "AnyReturnType",
+    "ArrayOfReturnType",
+    "BigIntReturnType",
+    "BigIntRule",
+    "DateReturnType",
+    "DebouncedAsyncFunction",
+    "DebouncedFunction",
+    "Deferred",
     "EmailParts",
     "Error",
+    "FileReturnType",
+    "Formatter",
+    "FunctionReturnType",
+    "FunctionSchema",
+    "FunctionValidator",
     "FuzzySearchResult",
     "HttpClientErrorStatus",
     "HttpInformationalStatus",
     "HttpRedirectionStatus",
     "HttpServerErrorStatus",
+    "HttpStatus",
     "HttpSuccessStatus",
+    "InstanceOfReturnType",
     "IsDeepEqualOptions",
+    "LRUCache",
+    "MapReturnType",
+    "MemoizedFunction",
+    "NeverReturnType",
+    "NumberReturnType",
+    "NumberRule",
+    "OnceFunction",
     "ParseEmailLevel",
     "ParseEmailOptions",
     "ParseEmailResult",
@@ -284,56 +474,104 @@ __all__ = [
     "ProbabilityFraction",
     "ReducedFraction",
     "Result",
+    "SetOfReturnType",
+    "SettledResult",
+    "StringReturnType",
+    "StringRule",
     "Success",
+    "TTLCache",
+    "TemplateLiteralReturnType",
+    "ThrottledAsyncFunction",
+    "ThrottledFunction",
+    "UnknownReturnType",
     "ValidatedSortRange",
+    "WeightedItem",
+    "add_duration",
     "addition",
+    "any_validator",
+    "apply_formatter",
     "apply_insertion_sort_if_needed",
+    "array_of",
     "array_sum",
     "arrays_join",
     "average",
+    "bigint",
     "binary_search",
     "birthday",
+    "birthday_simple",
     "bitwise",
+    "build_url",
+    "calculator",
+    "calculator_core",
+    "calculator_initialization",
     "camel_case",
+    "capitalize",
+    "capitalize_word",
     "check_flag_alignment",
     "chunk",
     "cidr_to_long",
     "cidr_to_subnet_mask",
+    "clamp",
     "cmyk_to_rgba",
     "compact",
     "compare_function_default",
+    "constant_case",
+    "convert_currency",
     "convert_time",
     "correlation_coefficient",
+    "count_occurrences",
     "create_pipeline",
     "curry",
+    "date",
     "date_format",
     "date_now",
     "date_range",
     "day_of_week",
+    "day_of_week_simple",
+    "debounce",
+    "debounce_async",
+    "deburr",
     "decode_base32",
     "decode_base32_to_string",
     "decode_base58",
     "decode_base58_to_string",
+    "dedent",
+    "deep_clone",
+    "default_formatters",
+    "defer",
     "deg_to_rad",
     "delete_spaces",
+    "detect_mode",
     "deviation_value",
     "deviation_value_simple",
+    "diff",
     "division",
     "drop",
     "dual_pivot_quick_sort",
     "encode_base32",
     "encode_base58",
+    "end_of",
+    "ensure_prefix",
+    "ensure_suffix",
+    "error_function",
     "escape_html",
+    "escape_regexp",
     "every",
     "extract_browser_from_user_agent",
     "extract_device_from_user_agent",
     "extract_os_from_user_agent",
     "factorial",
     "factorize",
+    "file",
     "first",
+    "flat_map_result",
+    "flatten_object",
     "flexible_number_conversion",
+    "format_number",
+    "format_relative",
     "format_string",
     "from_base64",
+    "func",
     "fuzzy_search",
     "gcd",
     "generate_number_array",
@@ -343,31 +581,49 @@ __all__ = [
     "get_decimal_length",
     "get_ip_class",
     "get_network_address",
+    "get_objects_common",
+    "get_objects_diff",
     "get_timezone_offset_string",
+    "get_value",
     "group_by",
+    "group_by_to_map",
     "has_no_letters",
     "hexa_to_rgba",
     "hsla_to_rgba",
+    "in_range",
     "insertion_sort",
     "insertion_sort_range",
+    "instance_of",
+    "invert",
     "ip_to_binary_string",
     "ip_to_long",
     "is_absolute_url",
     "is_array",
+    "is_boolean",
+    "is_browser",
+    "is_bun",
+    "is_business_day",
     "is_deep_equal",
     "is_dictionary_object",
     "is_double",
     "is_equal",
     "is_in_range",
     "is_leap_year",
+    "is_node",
+    "is_node_webkit",
     "is_not_empty",
+    "is_not_nullish",
+    "is_nullish",
     "is_number",
     "is_perfect_square",
     "is_prime_number",
     "is_private_ip",
+    "is_same_day",
     "is_string",
     "is_value_nan",
+    "is_weekend",
     "join_path",
+    "js_string",
     "kebab_case",
     "key_by",
     "lazy_filter",
@@ -376,48 +632,85 @@ __all__ = [
     "lcm",
     "levenshtein_distance",
     "linear_congruential_generator",
+    "literal_expression",
     "long_to_ip",
+    "map_keys",
+    "map_result",
+    "map_validator",
+    "mask",
+    "match_result",
+    "matches",
     "math_converter",
     "math_separator",
     "max_value",
     "median",
+    "memoize",
     "merge_sort",
     "min_value",
     "mode",
+    "ms_by_unit",
     "multiples",
     "multiplication",
     "n_cr",
     "n_hr",
     "n_pr",
+    "never_validator",
     "new_date_int",
     "new_date_string",
     "normalize_time_unit",
+    "normalize_whitespace",
+    "not_",
+    "now_simple",
+    "number",
+    "object_get",
     "object_has",
     "object_is_empty",
+    "object_is_plain",
+    "object_key_by",
     "object_map_values",
     "object_merge",
     "object_merge_deep",
     "object_omit",
     "object_pick",
     "object_pick_deep",
+    "object_set",
+    "omit_by",
+    "once",
+    "p_settled",
     "pad_end",
     "pad_start",
+    "parallel",
     "parse_email",
     "parse_json",
+    "parse_query_string",
     "parse_user_agent",
+    "pascal_case",
+    "path_segments",
     "percentile",
+    "pick_by",
     "pipe",
     "pop",
     "prime_factorization",
     "quick_sort",
     "quotient",
     "rad_to_deg",
+    "random_boolean",
+    "random_choice",
+    "random_float",
     "random_int",
     "random_select",
     "random_string",
     "random_string_initialization",
+    "random_uuid",
+    "range_advance",
     "range_array",
     "reduce_fraction",
+    "remove_prefix",
+    "remove_prototype",
+    "remove_prototype_deep",
+    "remove_prototype_map",
+    "remove_prototype_map_deep",
+    "remove_suffix",
     "repeated_trial",
     "retry",
     "reverse_string",
@@ -426,34 +719,65 @@ __all__ = [
     "rgba_to_hsla",
     "round_of",
     "safe_execute",
+    "sanitize_string",
+    "seeded_random",
+    "set_of",
     "shuffle",
     "shuffle_2d_array",
+    "sleep",
     "slugify",
+    "snake_case",
     "solve_equation",
+    "some",
+    "split_by_length",
     "standard_deviation",
+    "start_of",
+    "string",
     "string_similarity",
+    "strip_ansi",
+    "strip_tags",
+    "sub_duration",
     "subnet_mask_to_cidr",
     "subtraction",
+    "success_function",
+    "sum_precise",
+    "swap_case",
+    "template_literal",
+    "throttle",
+    "throttle_async",
     "tim_sort",
+    "timeout",
+    "title_case",
     "to_base64",
     "to_base_n",
     "to_celsius",
+    "to_full_width",
     "to_half_width",
     "to_kelvin",
     "to_ordinal",
+    "to_percentage",
     "trim_characters",
     "trim_end_characters",
     "trim_start_characters",
     "truncate",
     "ultra_number_sort",
+    "uncapitalize",
     "unescape_html",
+    "unflatten_object",
     "uniq_by",
     "unique",
     "unit_converter_initialization",
+    "unknown_validator",
+    "unwrap",
     "uuidv7",
     "validate_range",
     "value_swap",
+    "wait_for",
+    "weighted_choice",
+    "word_count",
+    "words",
     "xoshiro256",
     "zip_arrays",
     "zip_longest",
+    "zip_to_map",
 ]

{umt_python-0.2.0 → umt_python-0.3.0}/umt_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: umt_python
-Version: 0.2.0
+Version: 0.3.0
 Summary: A collection of useful utility functions for various tasks in Python, focusing on string manipulation and formatting.
 Author-email: riya-amemiya <riyaamemiya@gmail.com>
 License-Expression: MIT
@@ -101,6 +101,14 @@ print(encoded)  # "SGVsbG8gV29ybGQ="
 |----------|------|-------------|---------|
 | `has_no_letters` | `(text: str) -> bool` | Check if string contains no letters (only numbers, emojis, special chars) | `has_no_letters("123!@#")  # True` / `has_no_letters("abc123")  # False` |
 
+### Number Functions
+
+| Function | Type | Description | Example |
+|----------|------|-------------|---------|
+| `format_number` | `(value: float \| int, *, locale: str \| None = None, minimum_fraction_digits: int \| None = None, maximum_fraction_digits: int \| None = None, style: Literal["decimal", "currency", "percent"] = "decimal", currency: str \| None = None) -> str` | Format a number with locale-aware separators, fraction-digit controls, and decimal/percent/currency styles. Mirrors `Intl.NumberFormat` from the TypeScript source. | `format_number(1234567.89)  # "1,234,567.89"` / `format_number(1234567.89, locale="de-DE")  # "1.234.567,89"` / `format_number(0.75, style="percent")  # "75%"` / `format_number(1234.5, style="currency", currency="USD")  # "$1,234.50"` |
+| `to_ordinal` | `(value: int \| float) -> str` | Convert a number to its English ordinal string (handles 11th/12th/13th specially) | `to_ordinal(1)  # "1st"` / `to_ordinal(11)  # "11th"` / `to_ordinal(21)  # "21st"` |
+| `to_percentage` | `(value: float \| int, total: float \| int, decimals: int = 2) -> float` | Calculate the percentage of a value relative to a total (returns 0 when total is 0) | `to_percentage(1, 3)  # 33.33` / `to_percentage(25, 100)  # 25.0` |
+
 ## Constants
 
 - `DEFAULT_RANDOM_STRING_CHARS`: Default character pool for random string generation (ASCII letters + digits)