dycw-utilities 0.150.7__tar.gz → 0.150.8__tar.gz

{dycw_utilities-0.150.7 → dycw_utilities-0.150.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.150.7
+Version: 0.150.8
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12

{dycw_utilities-0.150.7 → dycw_utilities-0.150.8}/pyproject.toml

@@ -103,7 +103,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.150.7"
+version = "0.150.8"
 
 [project.entry-points.pytest11]
 pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -136,7 +136,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.150.7"
+current_version = "0.150.8"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.150.7 → dycw_utilities-0.150.8}/src/tests/test_text.py

@@ -31,6 +31,7 @@ from utilities.text import (
     parse_bool,
     parse_none,
     repr_encode,
+    secret_str,
     snake_case,
     split_key_value_pairs,
     split_str,
@@ -105,6 +106,64 @@ class TestReprEncode:
         assert result == expected
 
 
+class TestSecretStr:
+    def test_main(self) -> None:
+        s = secret_str("text")
+        assert repr(s) == secret_str._REPR
+        assert str(s) == secret_str._REPR
+
+
+class TestSnakeCase:
+    @given(
+        case=sampled_from([
+            ("API", "api"),
+            ("APIResponse", "api_response"),
+            ("ApplicationController", "application_controller"),
+            ("Area51Controller", "area51_controller"),
+            ("FreeBSD", "free_bsd"),
+            ("HTML", "html"),
+            ("HTMLTidy", "html_tidy"),
+            ("HTMLTidyGenerator", "html_tidy_generator"),
+            ("HTMLVersion", "html_version"),
+            ("NoHTML", "no_html"),
+            ("One   Two", "one_two"),
+            ("One  Two", "one_two"),
+            ("One Two", "one_two"),
+            ("OneTwo", "one_two"),
+            ("One_Two", "one_two"),
+            ("One__Two", "one_two"),
+            ("One___Two", "one_two"),
+            ("Product", "product"),
+            ("SpecialGuest", "special_guest"),
+            ("Text", "text"),
+            ("Text123", "text123"),
+            ("_APIResponse_", "_api_response_"),
+            ("_API_", "_api_"),
+            ("__APIResponse__", "_api_response_"),
+            ("__API__", "_api_"),
+            ("__impliedVolatility_", "_implied_volatility_"),
+            ("_itemID", "_item_id"),
+            ("_lastPrice__", "_last_price_"),
+            ("_symbol", "_symbol"),
+            ("aB", "a_b"),
+            ("changePct", "change_pct"),
+            ("changePct_", "change_pct_"),
+            ("impliedVolatility", "implied_volatility"),
+            ("lastPrice", "last_price"),
+            ("memMB", "mem_mb"),
+            ("sizeX", "size_x"),
+            ("symbol", "symbol"),
+            ("testNTest", "test_n_test"),
+            ("text", "text"),
+            ("text123", "text123"),
+        ])
+    )
+    def test_main(self, *, case: tuple[str, str]) -> None:
+        text, expected = case
+        result = snake_case(text)
+        assert result == expected
+
+
 class TestSplitKeyValuePairs:
     @given(
         case=sampled_from([
@@ -237,57 +296,6 @@ class TestSplitAndJoinStr:
             _ = split_str("1,(22,333", brackets=[("(", ")")])
 
 
-class TestSnakeCase:
-    @given(
-        case=sampled_from([
-            ("API", "api"),
-            ("APIResponse", "api_response"),
-            ("ApplicationController", "application_controller"),
-            ("Area51Controller", "area51_controller"),
-            ("FreeBSD", "free_bsd"),
-            ("HTML", "html"),
-            ("HTMLTidy", "html_tidy"),
-            ("HTMLTidyGenerator", "html_tidy_generator"),
-            ("HTMLVersion", "html_version"),
-            ("NoHTML", "no_html"),
-            ("One   Two", "one_two"),
-            ("One  Two", "one_two"),
-            ("One Two", "one_two"),
-            ("OneTwo", "one_two"),
-            ("One_Two", "one_two"),
-            ("One__Two", "one_two"),
-            ("One___Two", "one_two"),
-            ("Product", "product"),
-            ("SpecialGuest", "special_guest"),
-            ("Text", "text"),
-            ("Text123", "text123"),
-            ("_APIResponse_", "_api_response_"),
-            ("_API_", "_api_"),
-            ("__APIResponse__", "_api_response_"),
-            ("__API__", "_api_"),
-            ("__impliedVolatility_", "_implied_volatility_"),
-            ("_itemID", "_item_id"),
-            ("_lastPrice__", "_last_price_"),
-            ("_symbol", "_symbol"),
-            ("aB", "a_b"),
-            ("changePct", "change_pct"),
-            ("changePct_", "change_pct_"),
-            ("impliedVolatility", "implied_volatility"),
-            ("lastPrice", "last_price"),
-            ("memMB", "mem_mb"),
-            ("sizeX", "size_x"),
-            ("symbol", "symbol"),
-            ("testNTest", "test_n_test"),
-            ("text", "text"),
-            ("text123", "text123"),
-        ])
-    )
-    def test_main(self, *, case: tuple[str, str]) -> None:
-        text, expected = case
-        result = snake_case(text)
-        assert result == expected
-
-
 class TestStrEncode:
     @given(n=integers())
     def test_main(self, *, n: int) -> None:

{dycw_utilities-0.150.7 → dycw_utilities-0.150.8}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.150.7"
+__version__ = "0.150.8"

{dycw_utilities-0.150.7 → dycw_utilities-0.150.8}/src/utilities/text.py

@@ -9,7 +9,7 @@ from re import IGNORECASE, Match, escape, search
 from textwrap import dedent
 from threading import get_ident
 from time import time_ns
-from typing import TYPE_CHECKING, Any, Literal, overload, override
+from typing import TYPE_CHECKING, Any, ClassVar, Literal, overload, override
 from uuid import uuid4
 
 from utilities.iterables import CheckDuplicatesError, check_duplicates, transpose
@@ -385,6 +385,24 @@ def _escape_separator(*, separator: str = DEFAULT_SEPARATOR) -> str:
 ##
 
 
+class secret_str(str):  # noqa: N801
+    """A string with an obfuscated representation."""
+
+    __slots__ = ()
+    _REPR: ClassVar[str] = "***"
+
+    @override
+    def __repr__(self) -> str:
+        return self._REPR
+
+    @override
+    def __str__(self) -> str:
+        return self._REPR
+
+
+##
+
+
 def str_encode(obj: Any, /) -> bytes:
     """Return the string representation of the object encoded as bytes."""
     return str(obj).encode()
@@ -424,6 +442,7 @@ __all__ = [
     "parse_bool",
     "parse_none",
     "repr_encode",
+    "secret_str",
     "snake_case",
     "split_key_value_pairs",
     "split_str",