arpakitlib 1.7.67__py3-none-any.whl → 1.7.68__py3-none-any.whl

arpakitlib/api_key_util.py

@@ -2,8 +2,20 @@ from uuid import uuid4
 
 from arpakitlib.ar_datetime_util import now_utc_dt
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 def generate_api_key() -> str:
     return (
         f"apikey{str(uuid4()).replace('-', '')}{str(now_utc_dt().timestamp()).replace('.', '')}"
     )
+
+
+def __example():
+    for i in range(5):
+        api_key = generate_api_key()
+        print(f"API-key: {api_key}")
+
+
+if __name__ == '__main__':
+    __example()

arpakitlib/ar_additional_model_util.py

@@ -3,6 +3,8 @@ from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 class BaseAM(BaseModel):
     model_config = ConfigDict(extra="forbid", arbitrary_types_allowed=True, from_attributes=True)
@@ -16,7 +18,22 @@ class BaseAM(BaseModel):
 
 
 def __example():
-    pass
+    class UserAM(BaseAM):
+        id: int
+        name: str
+        email: str
+
+        @property
+        def bus_data_age(self) -> int | None:
+            return self.bus_data.get("age")
+
+    user = UserAM(id=1, name="John Doe", email="john.doe@example.com")
+    print(user.name)  # John Doe
+
+    # bus_data
+    user.bus_data["age"] = 22
+    print(user.bus_data)  # {'age': '22'}
+    print(user.bus_data_age)  # 22
 
 
 if __name__ == '__main__':

arpakitlib/ar_arpakit_lib_module_util.py

@@ -144,7 +144,12 @@ def get_arpakit_lib_modules() -> ArpakitLibModules:
 
 
 def __example():
-    pass
+    for module_name, d in (
+            get_arpakit_lib_modules().module_name_to_module_version_and_module_has_errors().items()
+    ):
+        print(module_name)
+        print(d)
+        print()
 
 
 if __name__ == '__main__':

arpakitlib/ar_arpakit_schedule_uust_api_client_util.py

@@ -521,7 +521,28 @@ def __example():
 
 
 async def __async_example():
-    pass
+    client = ARPAKITScheduleUUSTAPIClient(api_key="TEST_API_KEY", use_cache=True)
+
+    healthcheck = await client.healthcheck()
+    print(f"Healthcheck: {healthcheck}")
+
+    auth_healthcheck = await client.auth_healthcheck()
+    print(f"Auth Healthcheck: {auth_healthcheck}")
+
+    current_week = await client.get_current_week()
+    print(f"Текущая неделя: {current_week.simple_json() if current_week else 'Не найдено'}")
+
+    current_semester = await client.get_current_semester()
+    print(f"Текущий семестр: {current_semester.simple_json() if current_semester else 'Не найдено'}")
+
+    groups = await client.get_groups()
+    print(f"Группы: {[group.simple_json() for group in groups]}")
+
+    teachers = await client.get_teachers()
+    print(f"Преподаватели: {[teacher.simple_json() for teacher in teachers]}")
+
+    weather = await client.get_weather_in_ufa()
+    print(f"Погода в Уфе: {weather.simple_json()}")
 
 
 if __name__ == '__main__':

arpakitlib/ar_arpakitlib_cli_util.py

@@ -7,6 +7,8 @@ from arpakitlib.ar_need_type_util import parse_need_type, NeedTypes
 from arpakitlib.ar_parse_command import parse_command
 from arpakitlib.ar_str_util import raise_if_string_blank
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 def execute_arpakitlib_cli(*, full_command: str | None = None):
     if full_command is None:

arpakitlib/ar_exception_util.py

@@ -1,5 +1,18 @@
 import traceback
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 def exception_to_traceback_str(exception: BaseException) -> str:
     return "".join(traceback.format_exception(type(exception), exception, exception.__traceback__))
+
+
+def __example():
+    try:
+        raise Exception()
+    except Exception as exception:
+        print(exception_to_traceback_str(exception))
+
+
+if __name__ == '__main__':
+    __example()

arpakitlib/ar_file_util.py

@@ -1,5 +1,7 @@
 import os
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 def raise_if_path_not_exists(path: str):
     if not os.path.exists(path):

arpakitlib/ar_need_type_util.py

@@ -56,7 +56,14 @@ def parse_need_type(value: Any, need_type: str, allow_none: bool = False) -> Any
 
 
 def __example():
-    pass
+    print(parse_need_type(value=123, need_type="int"))
+    print(parse_need_type(value="True", need_type="bool"))
+    print(parse_need_type(value=123.456, need_type="float"))
+    print(parse_need_type(value='[1, 2, 3]', need_type="list_of_int"))
+    print(parse_need_type(value='["a", "b", "c"]', need_type="list_of_str"))
+    print(parse_need_type(value='[1.1, 2.2, 3.3]', need_type="list_of_float"))
+    print(parse_need_type(value='{"key": "value"}', need_type="json"))
+    print(parse_need_type(value="hello world", need_type="str"))
 
 
 if __name__ == '__main__':

arpakitlib/ar_openai_api_client_util.py

@@ -49,11 +49,25 @@ class OpenAIAPIClient:
 
 
 def __example():
-    pass
+    open_ai = OpenAI(api_key="your-api-key")
+    client = OpenAIAPIClient(open_ai=open_ai)
+
+    print("Checking OpenAI API connection...")
+    if client.is_conn_good():
+        print("Connection to OpenAI API is good")
+    else:
+        print("Failed to connect to OpenAI API")
 
 
 async def __async_example():
-    pass
+    async_open_ai = AsyncOpenAI(api_key="your-api-key")
+    client = OpenAIAPIClient(async_open_ai=async_open_ai)
+
+    print("Checking OpenAI API async connection...")
+    if await client.async_is_conn_good():
+        print("Async connection to OpenAI API is good")
+    else:
+        print("Failed to async connect to OpenAI API")
 
 
 if __name__ == '__main__':

arpakitlib/ar_settings_util.py

@@ -8,6 +8,8 @@ from pydantic_settings import BaseSettings
 
 from arpakitlib.ar_enumeration_util import Enumeration
 
+_ARPAKIT_LIB_MODULE_VERSION = "3.0"
+
 
 def generate_env_example(settings_class: Union[BaseSettings, type[BaseSettings]]):
     res = ""
@@ -52,3 +54,11 @@ class SimpleSettings(BaseSettings):
         with open(filepath, mode="w") as f:
             f.write(env_example)
         return env_example
+
+
+def __example():
+    pass
+
+
+if __name__ == '__main__':
+    __example()

arpakitlib/ar_str_util.py

@@ -86,7 +86,36 @@ def raise_if_string_blank(string: str) -> str:
 
 
 def __example():
-    pass
+    print("str_in:")
+    print(str_in(string="hello", main_string="hello world"))  # True
+    print(str_in(string="bye", main_string="hello world"))  # False
+    print(str_in(string="hello", main_string="hello world", max_diff=6))  # True
+    print(str_in(string="hello", main_string="hello world", max_diff=1))  # False
+
+    print("\nbidirectional_str_in:")
+    print(bidirectional_str_in(string1="hello", string2="hello world"))  # True
+    print(bidirectional_str_in(string1="world", string2="hello world"))  # True
+
+    print("\nstr_startswith:")
+    print(str_startswith(string="hello", main_string="hello world"))  # True
+    print(str_startswith(string="world", main_string="hello world"))  # False
+
+    print("\nbidirectional_str_startswith:")
+    print(bidirectional_str_startswith(string1="hello", string2="hello world"))  # True
+    print(bidirectional_str_startswith(string1="world", string2="hello world"))  # False
+
+    print("\nmake blank_if_none:")
+    print(make_blank_if_none())  # ""
+    print(make_blank_if_none(string="test"))  # "test"
+
+    print("\nremove_html:")
+    print(remove_html(string="<div>Hello <b>World</b></div>"))  # "Hello World"
+
+    print("\nremove_tags:")
+    print(remove_tags(string="<div>Hello <b>World</b></div>"))  # "divHello bWorldbdiv"
+
+    print("\nremove_tags_and_html:")
+    print(remove_tags_and_html("<div>Hello <b>World</b></div>"))  # "Hello World"
 
 
 if __name__ == '__main__':

arpakitlib/ar_type_util.py

@@ -91,7 +91,58 @@ def raise_if_not_none(v: Any) -> Any:
 
 
 def __example():
-    pass
+    print("is_set:")
+    print(is_set(v=NotSet))  # False
+    print(is_set(v="hello world"))  # True
+
+    print("\nis_not_set:")
+    print(is_not_set(v=NotSet))  # True
+    print(is_not_set(v="hello world"))  # False
+
+    print("\nis_set_and_not_none:")
+    print(is_set_and_not_none(v=NotSet))  # False
+    print(is_set_and_not_none(v=None))  # False
+    print(is_set_and_not_none(v=1000))  # True
+
+    print("\nis_not_set_or_none:")
+    print(is_not_set_or_none(v=NotSet))  # True
+    print(is_not_set_or_none(v=None))  # True
+    print(is_not_set_or_none(v=100))  # False
+
+    print("\nmake_none_if_not_set:")
+    print(make_none_if_not_set(v=NotSet))  # None
+    print(make_none_if_not_set(v="hello world"))  # hello world
+
+    print("\nmake_none_to_false:")
+    print(make_none_to_false(v=None))  # False
+    print(make_none_to_false(v=True))  # True
+    print(make_none_to_false(v=100))  # 100
+
+    print("\nraise_if_set:")
+    try:
+        raise_if_set(v=100)  # raise
+    except ValueError as e:
+        print(e)
+
+    print("\nraise_if_set:")
+    try:
+        raise_if_not_set(v=NotSet)  # raise
+    except ValueError as e:
+        print(e)
+
+    print("\nraise_for_type:")
+    try:
+        raise_for_type(comparable="test", need_type=str)  # pass
+        raise_for_type(comparable=100, need_type=str)  # raise
+    except TypeError as e:
+        print(e)
+
+    print("\nraise_for_types:")
+    try:
+        raise_for_types(comparable="test", need_types=[str, int])  # pass
+        raise_for_types(comparable=100.5, need_types=[str, int], comment_for_error="Ooops")  # raise
+    except TypeError as e:
+        print(e)
 
 
 if __name__ == '__main__':

{arpakitlib-1.7.67.dist-info → arpakitlib-1.7.68.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: arpakitlib
-Version: 1.7.67
+Version: 1.7.68
 Summary: arpakitlib
 Home-page: https://github.com/ARPAKIT-Company/arpakitlib
 License: Apache-2.0

{arpakitlib-1.7.67.dist-info → arpakitlib-1.7.68.dist-info}/RECORD

@@ -110,13 +110,13 @@ arpakitlib/_arpakit_project_template/src/test_data/make_test_data_3.py,sha256=89
 arpakitlib/_arpakit_project_template/src/test_data/make_test_data_4.py,sha256=BlVvIhSFclBMQMHftETS57bRaFpkOdKPrZyxMbYJuDY,80
 arpakitlib/_arpakit_project_template/src/test_data/make_test_data_5.py,sha256=7ruCZevqJoLSdqL1OEJWUy3YPCOHQif7JqVTKxZ9acM,80
 arpakitlib/_arpakit_project_template/src/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arpakitlib/api_key_util.py,sha256=DtzREor5h70XlZOv1ounNoPHL5_cc0YA28SaHvlFaWs,224
-arpakitlib/ar_additional_model_util.py,sha256=tNzZhZtvtJ1qC6Cn4UnyoEL58HudfpCdQy5ftkCqyik,473
+arpakitlib/api_key_util.py,sha256=E84JlJXiDHtxLQmV8BNHvqNKu_G8-Dox0XxknYJQ37Q,422
+arpakitlib/ar_additional_model_util.py,sha256=GFg-glLCxH9X95R2bhTJsscVwv37FgE1qbaAAyXrnIE,917
 arpakitlib/ar_aiogram_util.py,sha256=5JPCDZpdBGTE-EIWPRez9amCZAX7XemFIVu5YrQK7Pw,12264
-arpakitlib/ar_arpakit_lib_module_util.py,sha256=V_mc3Ml73Tzz3arxmwEfIxruKMyrwbe8XZ9FfVDtUXY,5446
+arpakitlib/ar_arpakit_lib_module_util.py,sha256=NUMNT-AFE6cSmrd4wGKVoCBzfJZeNb7zNWn7aU7qybI,5632
 arpakitlib/ar_arpakit_project_template_util.py,sha256=AswzQvvb-zfUyrcP4EP0K756YL-oC8fA9VperlPf_d0,3699
-arpakitlib/ar_arpakit_schedule_uust_api_client_util.py,sha256=SYWWQDohPnw0qpBIu2hEvGZRVdaI4NUUQdEjnMnseo4,18237
-arpakitlib/ar_arpakitlib_cli_util.py,sha256=ZktW3T6YRSM4_IDjbVhO3erceiQ5N6Gab_O-LtglfAI,3117
+arpakitlib/ar_arpakit_schedule_uust_api_client_util.py,sha256=LG0-An6KgC_hew548cyWAfRkpBH2vlnYgTqnPC07Yvk,19215
+arpakitlib/ar_arpakitlib_cli_util.py,sha256=8lhEDxnwMSRX2PGV2xQtQru1AYKSA92SVolol5u7iBk,3154
 arpakitlib/ar_base64_util.py,sha256=aZkg2cZTuAaP2IWeG_LXJ6RO7qhyskVwec-Lks0iM-k,676
 arpakitlib/ar_base_worker_util.py,sha256=o7RksRG-f8Xf6xEhNFx-ddhnZfF_yq2OhhxHEI6_YJk,3760
 arpakitlib/ar_cache_file_util.py,sha256=Fo2pH-Zqm966KWFBHG_pbiySGZvhIFCYqy7k1weRfJ0,3476
@@ -125,7 +125,7 @@ arpakitlib/ar_dict_util.py,sha256=cF5LQJ6tLqyGoEXfDljMDZrikeZoWPw7CgINHIFGvXM,41
 arpakitlib/ar_dream_ai_api_client_util.py,sha256=QF9XK7xK5ny1fvkcG4e0pfCySNNFRNPy0x0cmxfsAak,2818
 arpakitlib/ar_encrypt_decrypt_util.py,sha256=GhWnp7HHkbhwFVVCzO1H07m-5gryr4yjWsXjOaNQm1Y,520
 arpakitlib/ar_enumeration_util.py,sha256=1dQUEVgJRp0nCO-IrCKv5GTK0QkSzM44M1lOWkmPk3w,2532
-arpakitlib/ar_exception_util.py,sha256=2Xd8TchZA46QRJgYN-S_9Xf-_gRvyHv-0WKkC_ccCbA,184
+arpakitlib/ar_exception_util.py,sha256=3hZKsj34TZVdmd4JAQz7w515smWqB8o3gTwAEjuMdnI,408
 arpakitlib/ar_fastapi_static/healthcheck,sha256=IIO7Wvjwlr2-LPSQ7Y8O35hcI6t0_s8zqITDxkYCO8I,11
 arpakitlib/ar_fastapi_static/redoc/redoc.standalone.js,sha256=WCuodUNv1qVh0oW5fjnJDwb5AwOue73jKHdI9z8iGKU,909365
 arpakitlib/ar_fastapi_static/swagger-ui/favicon-16x16.png,sha256=ryStYE3Xs7zaj5dauXMHX0ovcKQIeUShL474tjo-B8I,665
@@ -148,7 +148,7 @@ arpakitlib/ar_fastapi_static/swagger-ui/swagger-ui.js,sha256=ffrLZHHEQ_g84A-ul3y
 arpakitlib/ar_fastapi_static/swagger-ui/swagger-ui.js.map,sha256=9UhIW7MqCOZPAz1Sl1IKfZUuhWU0p-LJqrnjjJD9Xhc,1159454
 arpakitlib/ar_fastapi_util.py,sha256=eOErnvI8ujwC_yN0XGN2xHm2RUoDk103OCpIkFGJ8A4,24555
 arpakitlib/ar_file_storage_in_dir_util.py,sha256=D3e3rGuHoI6xqAA5mVvEpVVpOWY1jyjNsjj2UhyHRbE,3674
-arpakitlib/ar_file_util.py,sha256=07xCF7paAUP2JUyfpeX0l3N1oCSma7qAcBmrCIZVi3g,452
+arpakitlib/ar_file_util.py,sha256=GUdJYm1tUZnYpY-SIPRHAZBHGra8NKy1eYEI0D5AfhY,489
 arpakitlib/ar_hash_util.py,sha256=Iqy6KBAOLBQMFLWv676boI5sV7atT2B-fb7aCdHOmIQ,340
 arpakitlib/ar_http_request_util.py,sha256=Kp2wKU4wGPsJ6m5sLwCEKWMs3Uqa59SUxhBevU6Gk_s,4328
 arpakitlib/ar_ip_util.py,sha256=aEAa1Hvobh9DWX7cmBAPLqnXSTiKe2hRk-WJaiKMaI8,1009
@@ -159,25 +159,25 @@ arpakitlib/ar_list_of_dicts_to_xlsx.py,sha256=MyjEl4Jl4beLVZqLVQMMv0-XDtBD3Xh4Z_
 arpakitlib/ar_list_util.py,sha256=2woOAHAU8oTIiVjZ8GLnx15odEaoQUq3Q0JPxlufFF0,457
 arpakitlib/ar_logging_util.py,sha256=mx3H6CzX9dsh29ruFmYnva8lL6mwvdBXmeHH9E2tvu8,1678
 arpakitlib/ar_mongodb_util.py,sha256=2ECkTnGAZ92qxioL-fmN6R4yZOSr3bXdXLWTzT1C3vk,4038
-arpakitlib/ar_need_type_util.py,sha256=xq5bbAXJG-93CRVZUcLW0ZdM22rj-ZUW17C5hX_5grg,1699
-arpakitlib/ar_openai_api_client_util.py,sha256=dHUbfg1sVVCjsNl_fra3iCMEz1bR-Hk9fE-DdYbu7Wc,1215
+arpakitlib/ar_need_type_util.py,sha256=GETiREPMEYhch-yU6T--Bdawlbb04Jp1Qy7cOsUlIeA,2228
+arpakitlib/ar_openai_api_client_util.py,sha256=_XmlApvHFMSyjvZydPa_kASIt9LsFrZmSC7YEzIG8Bg,1806
 arpakitlib/ar_operation_execution_util.py,sha256=F3gX2ZaR-tMFEKjVptpmX2kBTwtyr9Wfp9qNS0DR0Gk,18049
 arpakitlib/ar_parse_command.py,sha256=-s61xcATIsfw1eV_iD3xi-grsitbGzSDoAFc5V0OFy4,3447
 arpakitlib/ar_postgresql_util.py,sha256=1AuLjEaa1Lg4pzn-ukCVnDi35Eg1k91APRTqZhIJAdo,945
 arpakitlib/ar_run_cmd_util.py,sha256=D_rPavKMmWkQtwvZFz-Io5Ak8eSODHkcFeLPzNVC68g,1072
 arpakitlib/ar_schedule_uust_api_client_util.py,sha256=rAIxrAwURes5kuviFi2MA1VgOaWCZQtqmqsTf0QlAvY,6634
-arpakitlib/ar_settings_util.py,sha256=gnuC8rs7IkyXkRWurrV-K0jObDMMxeH_1NdfJLkekHA,1473
+arpakitlib/ar_settings_util.py,sha256=EFRh5WrB_iaqwxy0rGAtnyGtA6JkNCan-Y_Y6XWb4UY,1583
 arpakitlib/ar_sleep_util.py,sha256=OaLtRaJQWMkGjfj_mW1RB2P4RaSWsAIH8LUoXqsH0zM,1061
 arpakitlib/ar_sqlalchemy_model_util.py,sha256=TFGOAgpxcnBV_u7yZrLCkf1ldlB4Of8vIRsyk9kyP5c,4987
 arpakitlib/ar_sqlalchemy_util.py,sha256=Hcg1THrDsSR_-8dsY1CG3NWPEv0FqCbkPXFXLtjlSJ0,4207
 arpakitlib/ar_ssh_runner_util.py,sha256=jlnss4V4pziBN1rBzoK_lDiWm6nMOqGXfa6NFJSKH-Y,6796
-arpakitlib/ar_str_util.py,sha256=oCEtQ_TTn35OEz9jCNLjbhopq76JmaifD_iYR-nEJJ4,2142
-arpakitlib/ar_type_util.py,sha256=e6Ch8I_B3FMJMj-fiZvTwtGde4hxSa48fGt5g8RlV6I,2301
+arpakitlib/ar_str_util.py,sha256=tFoGSDYoGpfdVHWor5Li9pEOFmDFlHkX-Z8iOy1LK7Y,3537
+arpakitlib/ar_type_util.py,sha256=46ZMuWls3uN0Re5T0sfEAmyNUDnxn9yvj6dHivSDZKs,3915
 arpakitlib/ar_yookassa_api_client_util.py,sha256=sh4fcUkAkdOetFn9JYoTvjcSXP-M1wU04KEY-ECLfLg,5137
 arpakitlib/ar_zabbix_api_client_util.py,sha256=Q-VR4MvoZ9aHwZeYZr9G3LwN-ANx1T5KFmF6pvPM-9M,6402
-arpakitlib-1.7.67.dist-info/LICENSE,sha256=GPEDQMam2r7FSTYqM1mm7aKnxLaWcBotH7UvQtea-ec,11355
-arpakitlib-1.7.67.dist-info/METADATA,sha256=lz6u3_p1zV29BPdLzNyaheJFFu0Cql9W5N9Ho4Z8SVQ,2824
-arpakitlib-1.7.67.dist-info/NOTICE,sha256=95aUzaPJjVpDsGAsNzVnq7tHTxAl0s5UFznCTkVCau4,763
-arpakitlib-1.7.67.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-arpakitlib-1.7.67.dist-info/entry_points.txt,sha256=36xqR3PJFT2kuwjkM_EqoIy0qFUDPKSm_mJaI7emewE,87
-arpakitlib-1.7.67.dist-info/RECORD,,
+arpakitlib-1.7.68.dist-info/LICENSE,sha256=GPEDQMam2r7FSTYqM1mm7aKnxLaWcBotH7UvQtea-ec,11355
+arpakitlib-1.7.68.dist-info/METADATA,sha256=9-WHEIAgTJKs9WgRVo6ZaHX-NtYxjER0bZdUIkVqqLY,2824
+arpakitlib-1.7.68.dist-info/NOTICE,sha256=95aUzaPJjVpDsGAsNzVnq7tHTxAl0s5UFznCTkVCau4,763
+arpakitlib-1.7.68.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+arpakitlib-1.7.68.dist-info/entry_points.txt,sha256=36xqR3PJFT2kuwjkM_EqoIy0qFUDPKSm_mJaI7emewE,87
+arpakitlib-1.7.68.dist-info/RECORD,,