base-aux 0.0.1__tar.gz

base_aux-0.0.1/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2023 Andrei Starichenko
+
+IMPORTANT: SEE ADDITIONAL DEPENDANT LICENSES FROM LIST OF USED PROJECTS FROM REQUIREMENTS.TXT!
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

base_aux-0.0.1/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.1
+Name: base_aux
+Version: 0.0.1
+Summary: collect all my previous moduls in one package
+Home-page: https://github.com/centroid457/
+Author: Andrei Starichenko
+Author-email: centroid@mail.ru
+Project-URL: Source, https://github.com/centroid457/base_aux
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Typing :: Typed
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+![Ver/TestedPython](https://img.shields.io/pypi/pyversions/base_aux)
+![Ver/Os](https://img.shields.io/badge/os_development-Windows-blue)  
+![repo/Created](https://img.shields.io/github/created-at/centroid457/base_aux)
+![Commit/Last](https://img.shields.io/github/last-commit/centroid457/base_aux)
+![Tests/GitHubWorkflowStatus](https://github.com/centroid457/base_aux/actions/workflows/test_linux.yml/badge.svg)
+![Tests/GitHubWorkflowStatus](https://github.com/centroid457/base_aux/actions/workflows/test_windows.yml/badge.svg)  
+![repo/Size](https://img.shields.io/github/repo-size/centroid457/base_aux)
+![Commit/Count/t](https://img.shields.io/github/commit-activity/t/centroid457/base_aux)
+![Commit/Count/y](https://img.shields.io/github/commit-activity/y/centroid457/base_aux)
+![Commit/Count/m](https://img.shields.io/github/commit-activity/m/centroid457/base_aux)
+
+# base_aux (current v0.0.1/![Ver/Pypi Latest](https://img.shields.io/pypi/v/base_aux?label=pypi%20latest))
+
+## DESCRIPTION_SHORT
+collect all my previous moduls in one package
+
+## DESCRIPTION_LONG
+buses
+    --------------
+NOTE: IT SEEMS THIS IS OLD DATA! see tests for actual usage!
+    
+!. MOST APPROPRIATE COMMAND PROTOCOL
+other protocols mot recommended
+
+1. all cmds must be as params (preferred) in equipment or as special command
+2. [<CMD_NAME>] - read param value or run special command  
+    [IDN] - read value IDN  
+    [DUMP] - run special command 
+3. [<CMD_NAME> <VALUE>] - write value in parameter or run special cmd with param  
+    [VOUT 12.3] - set value into parameter VOUT  
+4. [<CMD_NAME> ?] - get available values to write into parameter  
+    [MODE ?] - return [0 1 2 3]
+5. all command sent must return answer  
+    [OK] - if no value was asked
+    [<VALUE>] - if asked some value, returned without measurement unit
+    [FAIL] - any common not specified error
+    [FAIL 0123] - any specified error without description
+    [FAIL 02 VALUE OUT OF RANGE] - any specified error with description (full variant)
+    
+    
+    
+    monitors
+    --------------
+    monitor exact data (urlTag/Email) and alert on changes by email/telegram (threading)
+    ## IMPORTANT!
+    NOT ALL WEBSITES WORKS! Sportmaster/Acra-rating/...
+
+    ## INSPIRATION
+    Suppose you wish to give blood to the Center.
+    So nowadays you need to make an appointment by website, BUT you can't do this while the Center actually don't need your group.
+    Group necessity shown on Center website and called DonorSvetofor.
+    And as result you need monitoring it manually, because there are no news, email notifications, subscriptions.
+    It's not difficult but if you do it as day routine (even once a day) its quite distracting.
+
+    So I created it first as Monitor_DonorSvetofor
+    
+    
+    
+    
+    TESTPLANS
+    --------------
+    designed to apply testplan for several DUTs
+
+## ПОНЯТИЯ
+    TC - TestCase
+    TP - TestPlan
+    DUT - Device Under Test - тестируемое устройство
+
+## АРХИТЕКТУРА
+- тестплан
+    - работает в потоке,
+    - может быть остановлен в любой момент terminate(), при этом завершает все запущенные тесткейсы
+    - имеет настройки которые принимаются всеми тесткейсами за базовые и могут быть перезаписаны ими для себя
+    - имеет списки классов TC и обьектов DUT (генерирует обьекты TC для каждого DUT)
+    - для себя не разделяет обьекты тесткейсов, работает строго с классом тесткейса,
+    - выполняет все тесткейсы в порядке их следования на списке DUT
+    - в один момент времени выполняется только один класс тесткейса
+- тесткейсы
+    - работают в потоке,
+    - может быть остановлен в любой момент terminate(), при этом завершаются безопасно (исполняются все teardown обьектов и глобальный классовый тесткейса), 
+    - представляет собой класс инициируемый с входным параметром DUT,
+    - выполняются тесткейсы строго по очереди,
+    - каждый тесткейс выполняется на всех устройствах либо асинхронно, либо синхронно в зависимости от настройки,
+    - работа тесткейса полностью управляется классом тесткейса на серии устройств (возможно выполнение парных тестов с выбором нужных пар внутри тесткейса),
+- результаты
+    - все результаты находятся в пока в обьекте тесткейса
+    - итогового (result)
+    - промежуточных результатов (details)
+- настройки
+    - управление
+        - SKIP всех возможных вариантов (полностью тесткейс для всех устройств, полностью DUT для всех TC, отдельный TC на отдельном DUT),
+        - выполнение тесткейса синхронно/асинхронно
+    - данные для использования в тесткейсах
+        - реализовано в файлах JSON
+        - для каждого тесткейса и общие для тестплана (кейсовые накладываются на плановые)
+- GUI тестплана
+    - запуск GUI опциональный,
+    - старт/стоп тестплана,
+    - отображение текущего тесткейса,
+    - отображение результата тескейса на каждом тестируемом устройстве,
+    - отображение промежуточных результатов (details)
+- API 
+    - минимальное API и запуск
+
+
+## Features
+1. cmp - apply for cmp object with others  
+2. getattr prefix  
+3. getattr echo  
+4. middle group  
+5. Number+NumberArithm - use class as number  
+6. Annotations - work with annotations +use special abilities+use nested classes  
+7. perfect singleton (maybe thread safe!)  
+8. collect all instances  
+9. check correct instantiating singletons in tree project  
+10. check requirements (systemOs), raise/bool if no match  
+11. create fuck(?)/source and is it for check for settings  
+12. [python PACKAGES/MODULES]:  
+	- upgrade  
+	- delete  
+	- version_get_installed  
+	- check_installed)  
+	- upgrade pip  
+13. [VERSION]:  
+	- parse  
+	- check  
+	- compare  
+14. send commands into OS terminal  
+15. check if cli commands are accessible (special utilities is installed)  
+16. access to standard parts of result in a simple ready-to-use form (stdout/stderr/retcode/full state)  
+17. use batch timeout for list  
+18. till_first_true  
+19. counter/counter_in_list  
+20. designed for common work with bitfields-like objects  
+21. Flags  
+22. Bits  
+23. 
+        Designed to use private data like username/pwd kept secure in OsEnvironment or Ini/Json-File for your several home projects at ones.  
+        And not open it in public.  
+    
+        **CAUTION:**  
+        in requirements for other projects use fixed version! because it might be refactored so you would get exception soon.
+          
+24. load values to instance attrs from:  
+	- Environment  
+	- IniFile  
+	- JsonFile  
+	- CsvFile  
+	- direct text instead of file  
+	- direct dict instead of file  
+25. attr access:  
+	- via any lettercase  
+	- by instance attr  
+	- like dict key on instance  
+26. work with dict:  
+	- apply  
+	- update  
+	- preupdate  
+27. update_dict as cumulative result - useful in case of settings result  
+28. use different managers for different funcs/methods if needed  
+29. use just one decorator to spawn threads from func / methods  
+30. keep all spawned threads in list by ThreadItem objects  
+31. ThreadItem keeps result/exx/is_alive attributes!  
+32. use wait_all/terminate_all()  
+33. [SERVERS]:  
+	- [aiohttp] (try not to use, as old)  
+	- [FastApi] (preferred)  
+34. client_requests item+stack  
+35. [SerialClient]:  
+	- keep all found ports in base class!  
+36. Serial:  
+	- Client+Server  
+	- connect with Type__AddressAutoAcceptVariant FIRST_FREE/FIRST_FREE__ANSWER_VALID  
+	- set/get params by SlashOrSpacePath addressing  
+	- handle BackSpace send manually from terminal  
+37. SerialServer values:  
+	- as Callable  
+	- ValueUnit  
+	- ValueVariants  
+	- list_results  
+38. SerialServer cmd:  
+	- NONE is equivalent for SUCCESS  
+	- no need params (like line_parsed as before)  
+	- help - for show all variants (Units/Variants/Callables)!  
+39. Threading each monitor  
+40. monitor:  
+	- website data changes (tag text/attribute)  
+	- email received with subject (by regexp) in exact folder  
+41. Email/Telegram alert if:  
+	- monitored data changed (from last state)  
+	- html structure was changed so parsing can't be finished  
+	- url became unreachable  
+42. send alert msgs:  
+	- emails  
+	- telegram  
+43. threading  
+44. pyqt help examples and some other useful objects (overloaded pyqt classes)  
+45. good template for TableView/Model/Signals  
+46. add Events for TM/TV/PTE/...  
+
+
+********************************************************************************
+## License
+See the [LICENSE](LICENSE) file for license rights and limitations (MIT).
+
+
+## Release history
+See the [HISTORY.md](HISTORY.md) file for release history.
+
+
+## Installation
+```commandline
+pip install base-aux
+```
+
+
+## Import
+```python
+from base_aux import *
+```
+
+
+********************************************************************************
+## USAGE EXAMPLES
+See tests, sourcecode and docstrings for other examples.  
+
+********************************************************************************

base_aux-0.0.1/README.md

@@ -0,0 +1,227 @@
+![Ver/TestedPython](https://img.shields.io/pypi/pyversions/base_aux)
+![Ver/Os](https://img.shields.io/badge/os_development-Windows-blue)  
+![repo/Created](https://img.shields.io/github/created-at/centroid457/base_aux)
+![Commit/Last](https://img.shields.io/github/last-commit/centroid457/base_aux)
+![Tests/GitHubWorkflowStatus](https://github.com/centroid457/base_aux/actions/workflows/test_linux.yml/badge.svg)
+![Tests/GitHubWorkflowStatus](https://github.com/centroid457/base_aux/actions/workflows/test_windows.yml/badge.svg)  
+![repo/Size](https://img.shields.io/github/repo-size/centroid457/base_aux)
+![Commit/Count/t](https://img.shields.io/github/commit-activity/t/centroid457/base_aux)
+![Commit/Count/y](https://img.shields.io/github/commit-activity/y/centroid457/base_aux)
+![Commit/Count/m](https://img.shields.io/github/commit-activity/m/centroid457/base_aux)
+
+# base_aux (current v0.0.1/![Ver/Pypi Latest](https://img.shields.io/pypi/v/base_aux?label=pypi%20latest))
+
+## DESCRIPTION_SHORT
+collect all my previous moduls in one package
+
+## DESCRIPTION_LONG
+buses
+    --------------
+NOTE: IT SEEMS THIS IS OLD DATA! see tests for actual usage!
+    
+!. MOST APPROPRIATE COMMAND PROTOCOL
+other protocols mot recommended
+
+1. all cmds must be as params (preferred) in equipment or as special command
+2. [<CMD_NAME>] - read param value or run special command  
+    [IDN] - read value IDN  
+    [DUMP] - run special command 
+3. [<CMD_NAME> <VALUE>] - write value in parameter or run special cmd with param  
+    [VOUT 12.3] - set value into parameter VOUT  
+4. [<CMD_NAME> ?] - get available values to write into parameter  
+    [MODE ?] - return [0 1 2 3]
+5. all command sent must return answer  
+    [OK] - if no value was asked
+    [<VALUE>] - if asked some value, returned without measurement unit
+    [FAIL] - any common not specified error
+    [FAIL 0123] - any specified error without description
+    [FAIL 02 VALUE OUT OF RANGE] - any specified error with description (full variant)
+    
+    
+    
+    monitors
+    --------------
+    monitor exact data (urlTag/Email) and alert on changes by email/telegram (threading)
+    ## IMPORTANT!
+    NOT ALL WEBSITES WORKS! Sportmaster/Acra-rating/...
+
+    ## INSPIRATION
+    Suppose you wish to give blood to the Center.
+    So nowadays you need to make an appointment by website, BUT you can't do this while the Center actually don't need your group.
+    Group necessity shown on Center website and called DonorSvetofor.
+    And as result you need monitoring it manually, because there are no news, email notifications, subscriptions.
+    It's not difficult but if you do it as day routine (even once a day) its quite distracting.
+
+    So I created it first as Monitor_DonorSvetofor
+    
+    
+    
+    
+    TESTPLANS
+    --------------
+    designed to apply testplan for several DUTs
+
+## ПОНЯТИЯ
+    TC - TestCase
+    TP - TestPlan
+    DUT - Device Under Test - тестируемое устройство
+
+## АРХИТЕКТУРА
+- тестплан
+    - работает в потоке,
+    - может быть остановлен в любой момент terminate(), при этом завершает все запущенные тесткейсы
+    - имеет настройки которые принимаются всеми тесткейсами за базовые и могут быть перезаписаны ими для себя
+    - имеет списки классов TC и обьектов DUT (генерирует обьекты TC для каждого DUT)
+    - для себя не разделяет обьекты тесткейсов, работает строго с классом тесткейса,
+    - выполняет все тесткейсы в порядке их следования на списке DUT
+    - в один момент времени выполняется только один класс тесткейса
+- тесткейсы
+    - работают в потоке,
+    - может быть остановлен в любой момент terminate(), при этом завершаются безопасно (исполняются все teardown обьектов и глобальный классовый тесткейса), 
+    - представляет собой класс инициируемый с входным параметром DUT,
+    - выполняются тесткейсы строго по очереди,
+    - каждый тесткейс выполняется на всех устройствах либо асинхронно, либо синхронно в зависимости от настройки,
+    - работа тесткейса полностью управляется классом тесткейса на серии устройств (возможно выполнение парных тестов с выбором нужных пар внутри тесткейса),
+- результаты
+    - все результаты находятся в пока в обьекте тесткейса
+    - итогового (result)
+    - промежуточных результатов (details)
+- настройки
+    - управление
+        - SKIP всех возможных вариантов (полностью тесткейс для всех устройств, полностью DUT для всех TC, отдельный TC на отдельном DUT),
+        - выполнение тесткейса синхронно/асинхронно
+    - данные для использования в тесткейсах
+        - реализовано в файлах JSON
+        - для каждого тесткейса и общие для тестплана (кейсовые накладываются на плановые)
+- GUI тестплана
+    - запуск GUI опциональный,
+    - старт/стоп тестплана,
+    - отображение текущего тесткейса,
+    - отображение результата тескейса на каждом тестируемом устройстве,
+    - отображение промежуточных результатов (details)
+- API 
+    - минимальное API и запуск
+
+
+## Features
+1. cmp - apply for cmp object with others  
+2. getattr prefix  
+3. getattr echo  
+4. middle group  
+5. Number+NumberArithm - use class as number  
+6. Annotations - work with annotations +use special abilities+use nested classes  
+7. perfect singleton (maybe thread safe!)  
+8. collect all instances  
+9. check correct instantiating singletons in tree project  
+10. check requirements (systemOs), raise/bool if no match  
+11. create fuck(?)/source and is it for check for settings  
+12. [python PACKAGES/MODULES]:  
+	- upgrade  
+	- delete  
+	- version_get_installed  
+	- check_installed)  
+	- upgrade pip  
+13. [VERSION]:  
+	- parse  
+	- check  
+	- compare  
+14. send commands into OS terminal  
+15. check if cli commands are accessible (special utilities is installed)  
+16. access to standard parts of result in a simple ready-to-use form (stdout/stderr/retcode/full state)  
+17. use batch timeout for list  
+18. till_first_true  
+19. counter/counter_in_list  
+20. designed for common work with bitfields-like objects  
+21. Flags  
+22. Bits  
+23. 
+        Designed to use private data like username/pwd kept secure in OsEnvironment or Ini/Json-File for your several home projects at ones.  
+        And not open it in public.  
+    
+        **CAUTION:**  
+        in requirements for other projects use fixed version! because it might be refactored so you would get exception soon.
+          
+24. load values to instance attrs from:  
+	- Environment  
+	- IniFile  
+	- JsonFile  
+	- CsvFile  
+	- direct text instead of file  
+	- direct dict instead of file  
+25. attr access:  
+	- via any lettercase  
+	- by instance attr  
+	- like dict key on instance  
+26. work with dict:  
+	- apply  
+	- update  
+	- preupdate  
+27. update_dict as cumulative result - useful in case of settings result  
+28. use different managers for different funcs/methods if needed  
+29. use just one decorator to spawn threads from func / methods  
+30. keep all spawned threads in list by ThreadItem objects  
+31. ThreadItem keeps result/exx/is_alive attributes!  
+32. use wait_all/terminate_all()  
+33. [SERVERS]:  
+	- [aiohttp] (try not to use, as old)  
+	- [FastApi] (preferred)  
+34. client_requests item+stack  
+35. [SerialClient]:  
+	- keep all found ports in base class!  
+36. Serial:  
+	- Client+Server  
+	- connect with Type__AddressAutoAcceptVariant FIRST_FREE/FIRST_FREE__ANSWER_VALID  
+	- set/get params by SlashOrSpacePath addressing  
+	- handle BackSpace send manually from terminal  
+37. SerialServer values:  
+	- as Callable  
+	- ValueUnit  
+	- ValueVariants  
+	- list_results  
+38. SerialServer cmd:  
+	- NONE is equivalent for SUCCESS  
+	- no need params (like line_parsed as before)  
+	- help - for show all variants (Units/Variants/Callables)!  
+39. Threading each monitor  
+40. monitor:  
+	- website data changes (tag text/attribute)  
+	- email received with subject (by regexp) in exact folder  
+41. Email/Telegram alert if:  
+	- monitored data changed (from last state)  
+	- html structure was changed so parsing can't be finished  
+	- url became unreachable  
+42. send alert msgs:  
+	- emails  
+	- telegram  
+43. threading  
+44. pyqt help examples and some other useful objects (overloaded pyqt classes)  
+45. good template for TableView/Model/Signals  
+46. add Events for TM/TV/PTE/...  
+
+
+********************************************************************************
+## License
+See the [LICENSE](LICENSE) file for license rights and limitations (MIT).
+
+
+## Release history
+See the [HISTORY.md](HISTORY.md) file for release history.
+
+
+## Installation
+```commandline
+pip install base-aux
+```
+
+
+## Import
+```python
+from base_aux import *
+```
+
+
+********************************************************************************
+## USAGE EXAMPLES
+See tests, sourcecode and docstrings for other examples.  
+
+********************************************************************************

base_aux-0.0.1/base_aux/_NEW/__init__.py

@@ -0,0 +1,22 @@
+# =====================================================================================================================
+# VERSION = (0, 0, 1)   # use import EXACT_OBJECTS! not *
+#   from .main import *                 # INcorrect
+#   from .main import EXACT_OBJECTS     # CORRECT
+# VERSION = (0, 0, 2)   # del blank lines
+# VERSION = (0, 0, 3)   # separate all types/exx into static.py!
+
+
+# =====================================================================================================================
+# TEMPLATE
+# from .static import (
+#     # TYPES
+#     # EXX
+# )
+# from .main import (
+#     # BASE
+#     # AUX
+# )
+# ---------------------------------------------------------------------------------------------------------------------
+
+
+# =====================================================================================================================

base_aux-0.0.1/base_aux/_NEW/main.py

@@ -0,0 +1,53 @@
+import pathlib
+from typing import *
+
+
+# =====================================================================================================================
+TYPE__PATH = Union[str, pathlib.Path]
+
+
+# =====================================================================================================================
+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
+    ---------
+
+    """
+    def meth(self):
+        """
+        CREATED SPECIALLY FOR
+        ---------------------
+        """
+        pass
+
+
+# =====================================================================================================================

base_aux-0.0.1/base_aux/alerts/__init__.py

@@ -0,0 +1,20 @@
+# =====================================================================================================================
+# VERSION = (0, 0, 1)   # use import EXACT_OBJECTS! not *
+#   from .main import *                 # INcorerct
+#   from .main import EXACT_OBJECTS     # CORERCT
+
+
+# =====================================================================================================================
+from .base import AlertBase
+from .smtp import SmtpAddress, SmtpServers, AlertSmtp
+from .telegram import RecipientTgID, AlertTelegram
+
+
+# =====================================================================================================================
+# FIXME: move to main!
+class AlertSelect:
+    SMTP_DEF = AlertSmtp
+    TELEGRAM_DEF = AlertTelegram
+
+
+# =====================================================================================================================