base-aux 0.3.11__py3-none-any.whl

base_aux/_0_EXAMPLES_EXPLORE/_explore.py

@@ -0,0 +1,16 @@
+import pandas as pd
+from base_aux.base_types.m2_info import ObjectInfo
+
+
+series_a = pd.DataFrame([1, 2, 3])
+print(type(series_a))   # <class 'pandas.core.series.Series'>
+# ObjectInfo(series_a).print()
+
+# print(series_a)
+"""
+a    NaN
+b    6.0
+c    8.0
+d    NaN
+dtype: float64
+"""

base_aux/_0_EXAMPLES_EXPLORE/main.py

@@ -0,0 +1,61 @@
+import pathlib
+from typing import *
+
+
+# =====================================================================================================================
+TYPE__EXAMPLE = Union[str, Any]
+
+
+# =====================================================================================================================
+class NEW_CLASS____:
+    """
+    NOTE
+    ----
+
+    GOAL
+    ----
+
+    USEFUL IDEAS
+    ------------
+
+    CREATED SPECIALLY FOR 
+    ---------------------
+    REPLACE:
+
+    CONSTRAINTS
+    -----------
+
+    BEST USAGE
+    ----------
+
+    SAME AS/OTHER VARIANTS
+    ----------------------
+    DIFFERENCE:
+
+    WHY NOT: 1?
+    ----------
+
+    WHY NOT: 2?
+    ----------
+
+    REFERENCE
+    ---------
+
+    REASON EXAMPLE
+    --------------
+
+    """
+    def meth(self):
+        """
+        CREATED SPECIALLY FOR
+        ---------------------
+        """
+        pass
+
+
+# =====================================================================================================================
+if __name__ == '__main__':
+    pass
+
+
+# =====================================================================================================================

base_aux/_0_EXAMPLES_EXPLORE/test_0_operations.py

@@ -0,0 +1,72 @@
+from base_aux.base_lambdas.m1_lambda import *
+from base_aux.base_nest_dunders.m7_cmp import *
+import operator
+
+# =====================================================================================================================
+class Victim(NestCmp_GLET_DigitAccuracy):
+    def __init__(self, source: float | int, **kwargs):
+        self.SOURCE = source
+        super().__init__(**kwargs)
+
+    @property
+    def CMP_VALUE(self) -> TYPING.DIGIT_FLOAT_INT:
+        return self.SOURCE
+
+
+# =====================================================================================================================
+class Test_CmpDigit:
+    @pytest.mark.parametrize(
+        argnames="source, accuracy_value, other, _EXPECTED",
+        argvalues=[
+            (1, None, 1, (True, False, True, False)),
+            (1, None, "hello", (Exception, Exception, Exception, Exception)),
+        ]
+    )
+    def test__cmp_glet(
+            self,
+            source: float | int,
+            accuracy: float | None,
+            other: float | int,
+            _EXPECTED: bool | Exception,
+    ):
+        # -----------------------------------------------
+        victim = Victim(source=source, cmp_accuracy_value=accuracy)
+
+        Lambda(victim.cmp_ge, other=other).check_expected__assert(_EXPECTED[0])
+        Lambda(victim.cmp_gt, other=other).check_expected__assert(_EXPECTED[1])
+        Lambda(victim.cmp_le, other=other).check_expected__assert(_EXPECTED[2])
+        Lambda(victim.cmp_lt, other=other).check_expected__assert(_EXPECTED[3])
+
+        # -----------------------------------------------
+        victim = Victim(source=source)
+
+        Lambda(victim.cmp_ge, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[0])
+        Lambda(victim.cmp_gt, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[1])
+        Lambda(victim.cmp_le, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[2])
+        Lambda(victim.cmp_lt, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[3])
+
+        # -----------------------------------------------
+        victim = Victim(source=source, cmp_accuracy_value=accuracy)
+
+        Lambda(victim.cmp_ge, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[0])
+        Lambda(victim.cmp_gt, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[1])
+        Lambda(victim.cmp_le, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[2])
+        Lambda(victim.cmp_lt, other=other, accuracy=accuracy).check_expected__assert(_EXPECTED[3])
+
+        # -----------------------------------------------
+        # try:      # NOTE: USE OPERATOR instead!!!
+        #     result = victim >= other
+        # except Exception as exc:
+        #     TypeAux(exc).check__subclassed_or_isinst__from_cls_or_inst(_EXPECTED[0])
+        # else:
+        #     assert result is _EXPECTED[0]
+
+        victim = Victim(source=source, cmp_accuracy_value=accuracy)
+
+        Lambda(operator.ge, victim, other).check_expected__assert(_EXPECTED[0])
+        Lambda(operator.gt, victim, other).check_expected__assert(_EXPECTED[1])
+        Lambda(operator.le, victim, other).check_expected__assert(_EXPECTED[2])
+        Lambda(operator.lt, victim, other).check_expected__assert(_EXPECTED[3])
+
+
+# =====================================================================================================================

base_aux/_0_EXAMPLES_EXPLORE/test_1_funcs.py

@@ -0,0 +1,50 @@
+from typing import *
+import pytest
+from pytest import mark
+
+from base_aux.base_lambdas.m1_lambda import *
+
+
+# =====================================================================================================================
+def func_example(arg1: Any, arg2: Any) -> str:
+    return f"{arg1}{arg2}"
+
+
+# =====================================================================================================================
+@pytest.mark.parametrize(argnames="func_link", argvalues=[int, float])
+@pytest.mark.parametrize(
+    argnames="args, _EXPECTED",
+    argvalues=[
+        (("1", ), 1),
+        (("hello", ), Exception),
+    ]
+)
+def test__short_variant(func_link, args, _EXPECTED):
+    Lambda(func_link, args).check_expected__assert(_EXPECTED)
+
+
+# =====================================================================================================================
+@pytest.mark.parametrize(
+    argnames="args, kwargs, _EXPECTED, _MARK, _COMMENT",
+    argvalues=[
+        # TRIVIAL -------------
+        ((1, None), {}, "1None", None, "ok"),
+        ((1, 2), {}, "12", None, "ok"),
+
+        # LIST -----------------
+        ((1, []), {}, "1[]", None, "ok"),
+
+        # MARKS -----------------
+        ((1, 2), {}, None, mark.skip, "skip"),
+        ((1, 2), {}, None, mark.skipif(True), "skip"),
+        ((1, 2), {}, "12", mark.skipif(False), "ok"),
+        ((1, 2), {}, None, mark.xfail, "ok"),
+        # ((1, 2), {}, "12", mark.xfail, "SHOULD BE FAIL!"),
+    ]
+)
+@pytest.mark.parametrize(argnames="func_link", argvalues=[func_example, ])
+def test__long_variant(func_link, args, kwargs, _EXPECTED, _MARK, _COMMENT):
+    Lambda(func_link, args, kwargs).check_expected__assert(_EXPECTED, _MARK, _COMMENT)
+
+
+# =====================================================================================================================

base_aux/_0_EXAMPLES_EXPLORE/test_2_cls.py

@@ -0,0 +1,54 @@
+import pytest
+
+from base_aux.base_lambdas.m1_lambda import *
+
+
+# =====================================================================================================================
+class Test__New:
+    # Victim: type[NEW_CLASS____]
+    # victim: NEW_CLASS____
+
+    @classmethod
+    def setup_class(cls):
+        pass
+        # cls.Victim = type("VICTIM", (NEW_CLASS____,), {})
+
+    @classmethod
+    def teardown_class(cls):
+        pass
+
+    def setup_method(self, method):
+        pass
+
+    def teardown_method(self, method):
+        pass
+
+    # -----------------------------------------------------------------------------------------------------------------
+    def test__1_direct(self):
+        assert True
+
+    # -----------------------------------------------------------------------------------------------------------------
+    @pytest.mark.parametrize(
+        argnames="args, _EXPECTED",
+        argvalues=[
+            (("1",), 1),
+            (("hello",), Exception),
+        ]
+    )
+    def test__2_parametrized_by_one_func(self, args, _EXPECTED):
+        Lambda(int, args).check_expected__assert(_EXPECTED)
+
+    # -----------------------------------------------------------------------------------------------------------------
+    @pytest.mark.parametrize(argnames="func_link", argvalues=[int, float, ])
+    @pytest.mark.parametrize(
+        argnames="args, _EXPECTED",
+        argvalues=[
+            (("1",), 1),
+            (("hello",), Exception),
+        ]
+    )
+    def test__3_parametrized_by_several_funcs(self, func_link, args, _EXPECTED):
+        Lambda(func_link, args).check_expected__assert(_EXPECTED)
+
+
+# =====================================================================================================================

base_aux/_0_EXAMPLES_EXPLORE/test_3_aio.py

@@ -0,0 +1,43 @@
+from typing import *
+import pytest
+import asyncio
+from pytest import mark
+
+from base_aux.base_lambdas.m1_lambda import *
+
+
+# =====================================================================================================================
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    argnames="func_link, args, _EXPECTED",
+    argvalues=[
+        (asyncio.sleep, (0.1, 1), 1),
+        (asyncio.sleep, ("hello",), TypeError),
+    ]
+)
+async def test__aio(func_link, args, _EXPECTED):
+    try:
+        result = await func_link(*args)
+    except BaseException as exc:
+        result = type(exc)
+
+    assert result == _EXPECTED
+
+"""
+Testing started at 18:19 ...
+Launching pytest with arguments test0_tasks1_cm.py::test__aio --no-header --no-summary -q in C:\__STARICHENKO_Element\PROJECTS\abc=aio_testplan\aio_tp2
+
+============================= test session starts =============================
+collecting ... collected 2 items
+
+test0_tasks1_cm.py::test__aio[sleep-args0-1] 
+test0_tasks1_cm.py::test__aio[sleep-args1-TypeError] 
+
+============================== 2 passed in 0.16s ==============================
+PASSED                      [ 50%]PASSED              [100%]sys:1: RuntimeWarning: coroutine 'sleep' was never awaited
+
+Process finished with exit code 0
+"""
+
+
+# =====================================================================================================================

base_aux/alerts/_PROJECT.py

@@ -0,0 +1,23 @@
+# =====================================================================================================================
+class PROJECT:
+    KEYWORDS: list[str] = [
+        "alerts", "notifications",
+        "email alerts", "smtp", "mail", "email",
+        "telegram alerts", "telegram",
+    ]
+    DESCRIPTION_SHORT: str = "All abilities (mail/telegram) to send alert msgs (threading)"
+    FEATURES: list[str] = [
+        ["send alert msgs", "emails", "telegram", ],
+        "threading",
+    ]
+
+    # HISTORY -----------------------------------------------
+    TODO: list[str] = [
+        "test multyStart by one object (QThread)"
+    ]
+    FIXME: list[str] = [
+        "NEED SOLVE ABILITY to work without PV.FILE!!! as just a http client"
+    ]
+
+
+# =====================================================================================================================

base_aux/alerts/_examples.py

@@ -0,0 +1,99 @@
+# =========================================================================================
+### 0. BEST PRACTICE
+from base_aux.alerts.m2_select import *
+from base_aux.alerts.m1_alerts1_smtp import *
+from base_aux.alerts.m1_alerts2_telegram import *
+from base_aux.aux_attr.m4_kits import AttrKit_AddrPort
+
+
+class AlertADX(AlertSelect.TELEGRAM_DEF):
+    pass
+
+AlertADX("hello")
+AlertADX("World")
+AlertADX.threads_wait_all()
+
+# =========================================================================================
+# =========================================================================================
+# =========================================================================================
+### AlertSmtp
+#### 1. add new server if not exists
+
+
+class SmtpServersMOD(SmtpServers):
+    EXAMPLE_RU: AttrKit_AddrPort = AttrKit_AddrPort("smtp.EXAMPLE.ru", 123)
+
+
+class AlertSmtpMOD(AlertSmtp):
+    CONN_ADDRESS: AttrKit_AddrPort = SmtpServersMOD.EXAMPLE_RU  # or direct =AttrKit_AddrPort("smtp.EXAMPLE.ru", 123)
+
+# =========================================================================================
+#### 2. change authorisation data (see `privates` for details)
+from base_aux.privates.m1_privates import *
+
+
+class AlertSmtpMOD(AlertSmtp):
+    CONN_AUTH: AttrKit_AuthNamePwd = PvLoaderIni(target=AttrKit_AuthNamePwd, keypath=("AUTH_EMAIL_MOD",))
+
+
+# =========================================================================================
+#### 3. change other settings (see source for other not mentioned)
+
+
+class AlertSmtpMOD(AlertSmtp):
+    RECONNECT_PAUSE: int = 60
+    RECONNECT_LIMIT: int = 10
+    TIMEOUT_RATELIMIT: int = 600
+    RECIPIENT: str = "my_address_2@mail.ru"
+
+# =========================================================================================
+#### 4. send
+# if no mods
+
+AlertSmtp(_subj_name="Hello", body="World!")
+
+# with mods
+
+
+class AlertSmtpMOD(AlertSmtp):
+    pass  # changed
+
+
+AlertSmtpMOD(_subj_name="Hello", body="World!")
+
+# =========================================================================================
+#### 5. using in class with saving alert object
+
+class AlertSmtpMOD(AlertSmtp):
+    pass    # changed
+
+class MyMonitor:
+    ALERT = AlertSmtpMOD
+
+monitor = MyMonitor()
+monitor.ALERT("Hello")
+
+# =========================================================================================
+# =========================================================================================
+### AlertTelegram
+# All idea is similar to AlertSmtp.
+
+# add auth data
+# add pv.json or do smth else (for details see privates.PrivateJsonTgBotAddress)
+# json
+{
+    "TG_ID": {"MyTgID": 1234567890},
+    "TGBOT_DEF": {
+        "LINK_ID": "@my_bot_20230916",
+        "NAME": "my_bot",
+        "TOKEN": "9876543210xxxxxxxxxxxxxxxxxxxxxxxxx"
+    }
+}
+
+# =========================================================================================
+
+class MyMonitor:
+    ALERT = AlertTelegram
+
+monitor = MyMonitor()
+monitor.ALERT("Hello")

base_aux/alerts/_test__1_alerts.py

@@ -0,0 +1,71 @@
+from base_aux.alerts.m1_alerts1_smtp import *
+from base_aux.alerts.m1_alerts2_telegram import *
+from base_aux.base_lambdas.m1_lambda import *
+
+
+# =====================================================================================================================
+# TODO: separate by base class and use victimCls as attr!
+
+@pytest.mark.skip
+@pytest.mark.skipif(Lambda(AlertSmtp.CONN_AUTH).check_raised__bool(), reason="no file")
+class Test__1:
+    @pytest.mark.parametrize(argnames="cls", argvalues=[
+        AlertSmtp,
+        AlertTelegram,
+    ])
+    def test__send_single(self, cls):
+        victim = cls()
+        victim.send_msg("single")
+        assert victim.wait()
+
+    @pytest.mark.parametrize(argnames="victim", argvalues=[
+        # AlertSmtp,
+        # AlertTelegram,
+    ])
+    @pytest.mark.parametrize(argnames="subject, msg, _subtype", argvalues=[
+        (None, "zero", None),
+        ("", "plain123", "plain123"),
+        ("plain", "plain", "plain"),
+        ("html", "<p><font color='red'>html(red)</font></p>", "html")
+    ])
+    def test__send_single__parametrized(self, victim, subject, msg, _subtype):
+        victim = victim()
+        victim.send_msg(subject=subject, body=msg, _subtype=_subtype)
+        assert victim.result_sent_all is not True
+        victim.wait()
+        assert victim.result_sent_all is True
+
+    @pytest.mark.parametrize(argnames="victim", argvalues=[
+        AlertSmtp,
+        # AlertTelegram
+    ])
+    def test__send_multy__result_wait(self, victim):
+        pass
+        # assert victim("multy1").wait() is True
+        # assert victim("multy2").wait() is True
+
+    @pytest.mark.parametrize(argnames="victim", argvalues=[
+        AlertSmtp,
+        # AlertTelegram
+    ])
+    def test__send_multy__wait_join(self, victim):
+        return
+
+        thread1 = victim("thread1")
+        thread2 = victim("thread2")
+
+        thread1.wait()
+        thread2.wait()
+
+        assert thread1._result is True
+        assert thread2._result is True
+
+
+# =====================================================================================================================
+# class Test_AlertHttp:
+#     Victim = AlertHttp
+#     def test__send_single(self, victim):
+#         assert self.Victim({}).result_wait() is True
+
+
+# =====================================================================================================================