ka-uts-com 3.0.0.250505__py3-none-any.whl → 3.0.2.250508__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
ka_uts_com/__version__.py CHANGED
@@ -1,7 +1,7 @@
1
1
  __title__ = 'ka_uts_com'
2
2
  __description__ = 'Communication Utilities.'
3
3
  __url__ = 'https://ka-ut-com.readthedocs.io/en/latest'
4
- __version__ = '3.0.0.250505'
4
+ __version__ = '3.0.2.250508'
5
5
  __build__ = 0x022200
6
6
  __author__ = 'Bernd Stroehle'
7
7
  __author_email__ = 'bernd.stroehle@gmail.com'
ka_uts_com/com.py CHANGED
@@ -5,7 +5,7 @@ import time
5
5
  import calendar
6
6
  from datetime import datetime
7
7
 
8
- from ka_uts_equ.equ import AoEqu
8
+ from ka_uts_arr.aoeq import AoEq
9
9
  from ka_uts_uts.utils.pacmod import PacMod
10
10
 
11
11
  from ka_uts_com.app import App
@@ -76,7 +76,7 @@ class Com:
76
76
  """
77
77
  show keyword arguments
78
78
  """
79
- _kwargs: TyDic = AoEqu.sh_d_eq(*args, d_parms=d_parms)
79
+ _kwargs: TyDic = AoEq.sh_d_eq(*args, d_parms=d_parms)
80
80
  _kwargs['cls_app'] = cls_app
81
81
  _kwargs['com'] = cls
82
82
 
@@ -0,0 +1,24 @@
1
+ Metadata-Version: 2.1
2
+ Name: ka-uts-com
3
+ Version: 3.0.2.250508
4
+ Summary: Communication and CLIs Utilities
5
+ Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
6
+ Maintainer-email: Bernd Stroehle <bernd.stroehle@gmail.com>
7
+ Project-URL: Source Code, https://github.com/bs29/ka_uts_com/tree/master
8
+ Project-URL: Homepage, https://kosakya.de/
9
+ Project-URL: Documentation, https://ka-com.readthedocs.io/en/latest
10
+ Project-URL: Apache-2.0 License, https://apache.org/licenses/LICENSE-2.0
11
+ Project-URL: GPLv3 License, https://www.gnu.org/licenses/gpl-3.0.en.html
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Natural Language :: English
17
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
18
+ Requires-Python: >=3.10
19
+ Description-Content-Type: text/x-rst
20
+ License-File: LICENSE.txt
21
+ Requires-Dist: ka-uts-arr>=3.0.1.250507
22
+ Requires-Dist: ka-uts-log>=3.0.0.250505
23
+ Requires-Dist: ka-uts-uts>=3.0.2.250507
24
+
@@ -1,14 +1,14 @@
1
1
  ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
- ka_uts_com/__version__.py,sha256=K84A6KetTw9bX0PB_o3yAAzHWB1cVpqWorpUM8NLzLY,365
2
+ ka_uts_com/__version__.py,sha256=6nh1rvCvZPhiDXbv8-IqXc77fGRLA3W8Bcit_j03-w8,365
3
3
  ka_uts_com/app.py,sha256=XrMhqQI9YHzw1XmC8zGgCJwrwxzkHtHDEQIo9gP07DI,1151
4
4
  ka_uts_com/cfg.py,sha256=RNWxOz3XtP0HgH0z1e6tAQA_L0alEh82_EOPOoyv3R4,768
5
- ka_uts_com/com.py,sha256=CQIsrDEe8soZ41PxW2YN1s1NvagVa3PUo8DgiczUQc0,1938
5
+ ka_uts_com/com.py,sha256=PmbQ46Ecneuh9DHuJ40yFcrwCJYfx_Uqlw4NyliVovY,1937
6
6
  ka_uts_com/exit.py,sha256=RIpFKwEGeBCBBPPQXIcLsrYeNY2dTF8BDlESe6UhdMo,791
7
7
  ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
8
8
  ka_uts_com/timer.py,sha256=hSNDh5qV6stSRLLEv-G_eMRoglsOU9N2HvRPUQ-s7yU,2153
9
9
  ka_uts_com/decorators/dec.py,sha256=NHerkpjOYpJXz2CIh9HlN3_YCyLv-SbyQL4ldyGUSpM,217
10
- ka_uts_com-3.0.0.250505.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
11
- ka_uts_com-3.0.0.250505.dist-info/METADATA,sha256=peLVb0R_1dcai_LZpPGqv9XaJapsYLfNT-z9ys2tQ18,31868
12
- ka_uts_com-3.0.0.250505.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
13
- ka_uts_com-3.0.0.250505.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
14
- ka_uts_com-3.0.0.250505.dist-info/RECORD,,
10
+ ka_uts_com-3.0.2.250508.dist-info/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
11
+ ka_uts_com-3.0.2.250508.dist-info/METADATA,sha256=H5kplnyF66eoLluuBDmYDD5VPncA4CFQllqG-gMK_DI,1068
12
+ ka_uts_com-3.0.2.250508.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
13
+ ka_uts_com-3.0.2.250508.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
14
+ ka_uts_com-3.0.2.250508.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (80.3.1)
2
+ Generator: bdist_wheel (0.45.1)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5
 
@@ -1,878 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: ka_uts_com
3
- Version: 3.0.0.250505
4
- Summary: Communication and CLIs Utilities
5
- Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
6
- Maintainer-email: Bernd Stroehle <bernd.stroehle@gmail.com>
7
- License-Expression: GPL-3.0-only WITH Classpath-exception-2.0 OR BSD-3-Clause
8
- Project-URL: Source Code, https://github.com/bs29/ka_uts_com/tree/master
9
- Project-URL: Homepage, https://kosakya.de/
10
- Project-URL: Documentation, https://ka-com.readthedocs.io/en/latest
11
- Classifier: Development Status :: 5 - Production/Stable
12
- Classifier: Intended Audience :: Developers
13
- Classifier: Operating System :: OS Independent
14
- Classifier: Programming Language :: Python :: 3.11
15
- Classifier: Natural Language :: English
16
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
17
- Requires-Python: >=3.10
18
- Description-Content-Type: text/x-rst
19
- License-File: LICENSE.txt
20
- Requires-Dist: ka_uts_equ>=2.2.0.250427
21
- Requires-Dist: ka_uts_log>=2.2.2.250430
22
- Requires-Dist: ka_uts_uts>=2.2.4.250502
23
- Dynamic: license-file
24
-
25
- ##########
26
- ka_uts_com
27
- ##########
28
-
29
- Overview
30
- ********
31
-
32
- .. start short_desc
33
-
34
- **Communication Utilities**
35
-
36
- .. end short_desc
37
-
38
- Installation
39
- ************
40
-
41
- .. start installation
42
-
43
- The package ``ka_uts_com`` can be installed from PyPI or Anaconda.
44
-
45
- To install with ``pip``:
46
-
47
- .. code-block:: shell
48
-
49
- $ python -m pip install ka_uts_com
50
-
51
- To install with ``conda``:
52
-
53
- .. code-block:: shell
54
-
55
- $ conda install -c conda-forge ka_uts_com
56
-
57
- .. end installation
58
-
59
- Package logging
60
- ***************
61
-
62
- (c.f.: **Appendix**: `Package Logging`)
63
-
64
- Package files
65
- *************
66
-
67
- Classification
68
- ==============
69
-
70
- The Package ``ka_uts_com`` consist of the following file types (c.f.: **Appendix**):
71
-
72
- #. **Special files:** (c.f.: **Appendix:** *Special python package files*)
73
-
74
- #. **Dunder modules:** (c.f.: **Appendix:** *Special python package modules*)
75
-
76
- #. **Decorator modules**
77
-
78
- a. *dec.py*
79
-
80
- #. **Modules**
81
-
82
- #. **Communication Modules**
83
-
84
- a. *com.py*
85
- #. *timer.py*
86
-
87
- #. **Base Modules**
88
-
89
- a. *app.py*
90
- #. *cfg.py*
91
- #. *exit.py*
92
-
93
- Decorator Modules
94
- *****************
95
-
96
- Overview
97
- ========
98
-
99
- .. Decorator Modules-label:
100
- .. table:: *Decorator Modules*
101
-
102
- +------+-----------------+
103
- |Name |Decription |
104
- +======+=================+
105
- |dec.py|Decorators module|
106
- +------+-----------------+
107
-
108
- Communication Modules
109
- *********************
110
-
111
- Overview
112
- ========
113
-
114
- .. Communication Modules-label:
115
- .. table:: *Communication Modules*
116
-
117
- +--------+-----------------------------+
118
- |Name |Decription |
119
- +========+=============================+
120
- |com.py |Communication handling module|
121
- +--------+-----------------------------+
122
- |timer.py|Timer management module |
123
- +--------+-----------------------------+
124
-
125
- Communication module: com.py
126
- ============================
127
-
128
- The Communication Module ``com.py`` contains the single static class ``Com``.
129
-
130
- com.py Class: Com
131
- -----------------
132
-
133
- The static Class ``Com`` contains the subsequent variables and methods.
134
-
135
- Com: Variables
136
- ^^^^^^^^^^^^^^
137
-
138
- .. Com-Variables-label:
139
- .. table:: *Com: Variables*
140
-
141
- +------------+-----------+-------+---------------------------------------+
142
- |Name |Type |Default|Description |
143
- +============+===========+=======+=======================================+
144
- |sw_init |TyBool |None |Initialisation switch |
145
- +------------+-----------+-------+---------------------------------------+
146
- |d_com_pacmod|TyDic |{} |Communication package module dictionary|
147
- +------------+-----------+-------+---------------------------------------+
148
- |d_app_pacmod|TyDic |{} |Application package module dictionary |
149
- +------------+-----------+-------+---------------------------------------+
150
- |**Timestamp fields** |
151
- +------------+-----------+-------+---------------------------------------+
152
- |ts |TnTimeStamp|None |Timestamp |
153
- +------------+-----------+-------+---------------------------------------+
154
- |ts_start |TnDateTime |None |start timestamp in date time format |
155
- +------------+-----------+-------+---------------------------------------+
156
- |ts_end |TnDateTime |None |end timestamp in date time format |
157
- +------------+-----------+-------+---------------------------------------+
158
- |ts_etime |TnDateTime |None |elapse Time |
159
- +------------+-----------+-------+---------------------------------------+
160
- |d_timer |TyDic |False |Timer dictionary |
161
- +------------+-----------+-------+---------------------------------------+
162
- |**Links to other Classes** |
163
- +------------+-----------+-------+---------------------------------------+
164
- |App |TyAny |False |Application class |
165
- +------------+-----------+-------+---------------------------------------+
166
- |cfg |TyDic |None |Configuration dictionary |
167
- +------------+-----------+-------+---------------------------------------+
168
- |Log |TyLogger |False |Log class |
169
- +------------+-----------+-------+---------------------------------------+
170
- |Exit |TyAny |False |Exit class |
171
- +------------+-----------+-------+---------------------------------------+
172
-
173
- Com: Methods
174
- ^^^^^^^^^^^^
175
-
176
- .. Com-Methods-label:
177
- .. table:: *Com Methods*
178
-
179
- +---------+-------------------------------------------------------+
180
- |Name |Description |
181
- +=========+=======================================================+
182
- |init |Initialise static variables if they are not initialized|
183
- +---------+-------------------------------------------------------+
184
- |sh_kwargs|Show keyword arguments |
185
- +---------+-------------------------------------------------------+
186
-
187
- Com Method: init
188
- ^^^^^^^^^^^^^^^^
189
-
190
- Parameter
191
- """""""""
192
-
193
- ..Com-Method-init-Parameter-label:
194
- .. table:: *Com Method init: Parameter*
195
-
196
- +---------+-----+-----------------+
197
- |Name |Type |Description |
198
- +=========+=====+=================+
199
- |cls |class|current class |
200
- +---------+-----+-----------------+
201
- |\**kwargs|TyAny|keyword arguments|
202
- +---------+-----+-----------------+
203
-
204
- Com Method: sh_kwargs
205
- ^^^^^^^^^^^^^^^^^^^^^
206
-
207
- Parameter
208
- """""""""
209
-
210
- .. Com-Method-sh_kwargs-Parameter-label:
211
- .. table:: *Com Method sh_kwargs: Parameter*
212
-
213
- +--------+-----+--------------------+
214
- |Name |Type |Description |
215
- +========+=====+====================+
216
- |cls |class|current class |
217
- +--------+-----+--------------------+
218
- |root_cls|class|root lass |
219
- +--------+-----+--------------------+
220
- |d_parms |TyDic|parameter dictionary|
221
- +--------+-----+--------------------+
222
- |\*args |list |arguments array |
223
- +--------+-----+--------------------+
224
-
225
- Communication module: timer.py
226
- ==============================
227
-
228
- timer.py: Classes
229
- -----------------
230
-
231
- The Module ``timer.py`` contains the following classes
232
-
233
-
234
- .. timer.py-Classes-label:
235
- .. table:: *timer.py classes*
236
-
237
- +---------+------+---------------+
238
- |Name |Type |Description |
239
- +=========+======+===============+
240
- |Timestamp|static|Timestamp class|
241
- +---------+------+---------------+
242
- |Timer |static|Timer class |
243
- +---------+------+---------------+
244
-
245
- timer.py Class: Timer
246
- ---------------------
247
-
248
- Timer: Methods
249
- ^^^^^^^^^^^^^^
250
-
251
- .. Timer-Methods-label:
252
- .. table:: *Timer Methods*
253
-
254
- +----------+------------------------------------+
255
- |Name |Description |
256
- +==========+====================================+
257
- |sh_task_id|Show task id |
258
- +----------+------------------------------------+
259
- |start |Start Timer |
260
- +----------+------------------------------------+
261
- |end |End Timer and Log Timer info message|
262
- +----------+------------------------------------+
263
-
264
- Timer Method: sh_task_id
265
- ^^^^^^^^^^^^^^^^^^^^^^^^
266
-
267
- Show task id, which is created by the concatination of the following items if they are defined:
268
- #. package,
269
- #. module,
270
- #. class_name,
271
- #. parms
272
- The items package and module are get from the package-module directory;
273
- The item class_name is the class_id if its a string, otherwise the attribute
274
- __qualname__ is used.
275
-
276
- Parameter
277
- """""""""
278
-
279
- .. Parameter-of-Timer-Method-sh_task_id-label:
280
- .. table:: *Parameter of: Timer Method sh_task_id*
281
-
282
- +--------+-----+-----------------+
283
- |Name |Type |Description |
284
- +========+=====+=================+
285
- |d_pacmod|TyDic|pacmod dictionary|
286
- +--------+-----+-----------------+
287
- |class_id|TyAny|Class Id |
288
- +--------+-----+-----------------+
289
- |parms |TnAny|Parameters |
290
- +--------+-----+-----------------+
291
- |sep |TyStr|Separator |
292
- +--------+-----+-----------------+
293
-
294
- Return Value
295
- """"""""""""
296
-
297
- .. Timer-Method-sh_task_id-Return-Value-label:
298
- .. table:: *Timer Method sh_task_id: Return Value*
299
-
300
- +----+-----+-----------+
301
- |Name|Type |Description|
302
- +====+=====+===========+
303
- | |TyStr|Task Id |
304
- +----+-----+-----------+
305
-
306
- Timer Method: start
307
- ^^^^^^^^^^^^^^^^^^^
308
-
309
- Parameter
310
- """""""""
311
-
312
- .. Parameter-of-Timer-Method-start-Parameter-label:
313
- .. table:: *Timer Method start: Parameter*
314
-
315
- +--------+-----+-------------+
316
- |Name |Type |Description |
317
- +========+=====+=============+
318
- |cls |class|current class|
319
- +--------+-----+-------------+
320
- |class_id|TyAny|Class Id |
321
- +--------+-----+-------------+
322
- |parms |TnAny|Parameter |
323
- +--------+-----+-------------+
324
- |sep |TyStr|Separator |
325
- +--------+-----+-------------+
326
-
327
- Timer Method: end
328
- ^^^^^^^^^^^^^^^^^
329
-
330
- Parameter
331
- """""""""
332
-
333
- .. Parameter-of-Timer-Method-end-label:
334
- .. table:: *Parameter of: Timer Method end*
335
-
336
- +--------+-----+-------------+
337
- |Name |Type |Description |
338
- +========+=====+=============+
339
- |cls |class|current class|
340
- +--------+-----+-------------+
341
- |class_id|TyAny|Class Id |
342
- +--------+-----+-------------+
343
- |parms |TnAny|Parameter |
344
- +--------+-----+-------------+
345
- |sep |TyStr|Separator |
346
- +--------+-----+-------------+
347
-
348
- Base Modules
349
- ************
350
-
351
- Overview
352
- ========
353
-
354
- .. Base Modules-label:
355
- .. table:: *Base Modules*
356
-
357
- +---------+----------------------------+
358
- |Name |Decription |
359
- +=========+============================+
360
- |app\_.py |Application setup module |
361
- +---------+----------------------------+
362
- |cfg\_.py |Configuration setup module |
363
- +---------+----------------------------+
364
- |exit\_.py|Exit Manafement setup module|
365
- +---------+----------------------------+
366
-
367
- Base module: app\_.py
368
- =====================
369
-
370
- The Module ``app.py`` contains a single static class ``App_``.
371
-
372
- Class: App\_
373
- ------------
374
-
375
- The static class ``App_`` contains the subsequent static variables and methods
376
-
377
- App\_: Static Variables
378
- ^^^^^^^^^^^^^^^^^^^^^^^
379
-
380
- .. Appl\_ Static-Variables-label:
381
- .. table:: *Appl\_ tatic Variables*
382
-
383
- +---------------+-------+-------+---------------------+
384
- |Name |Type |Default|Description |
385
- +===============+=======+=======+=====================+
386
- |sw_init |TyBool |False |initialisation switch|
387
- +---------------+-------+-------+---------------------+
388
- |httpmod |TyDic |None |http modus |
389
- +---------------+-------+-------+---------------------+
390
- |sw_replace_keys|TnBool |False |replace keys switch |
391
- +---------------+-------+-------+---------------------+
392
- |keys |TnArr |None |Keys array |
393
- +---------------+-------+-------+---------------------+
394
- |reqs |TyDic |None |Requests dictionary |
395
- +---------------+-------+-------+---------------------+
396
- |app |TyDic |None |Appliction dictionary|
397
- +---------------+-------+-------+---------------------+
398
-
399
- App\_: Methods
400
- ^^^^^^^^^^^^^^
401
-
402
- .. App\_-Methods-label:
403
- .. table:: *App\_ Methods*
404
-
405
- +----+------+------------------------------------+
406
- |Name|Type |Description |
407
- +====+======+====================================+
408
- |init|class |initialise static variables of class|
409
- | | |if they are not allready initialized|
410
- +----+------+------------------------------------+
411
- |sh |class |show (return) class |
412
- +----+------+------------------------------------+
413
-
414
- App\_ Method: init
415
- ^^^^^^^^^^^^^^^^^^
416
-
417
- Parameter
418
- """""""""
419
-
420
- .. Parameter-of-App\_-Method-init-label:
421
- .. table:: *Parameter of: App\_ Method init*
422
-
423
- +---------+-----+-----------------+
424
- |Name |Type |Description |
425
- +=========+=====+=================+
426
- |cls |class|Current class |
427
- +---------+-----+-----------------+
428
- |\**kwargs|TyAny|Keyword arguments|
429
- +---------+-----+-----------------+
430
-
431
- App\_ Method: sh
432
- ^^^^^^^^^^^^^^^^
433
-
434
- .. App\_-Method-sh-label:
435
- .. table:: *App\_ Method: sh*
436
-
437
- +---------+-----+-----------------+
438
- |Name |Type |Description |
439
- +=========+=====+=================+
440
- |cls |class|Current class |
441
- +---------+-----+-----------------+
442
- |\**kwargs|TyAny|Keyword arguments|
443
- +---------+-----+-----------------+
444
-
445
- Return Value
446
- """"""""""""
447
-
448
- .. App\_-Method-sh-Return-Value-label:
449
- .. table:: *App\_ Method sh: Return Value*
450
-
451
- +----+--------+-----------+
452
- |Name|Type |Description|
453
- +====+========+===========+
454
- |log |TyLogger|Logger |
455
- +----+--------+-----------+
456
-
457
- Base module: cfg\_.py
458
- =====================
459
-
460
- The Base module cfg\_.py contains a single static class ``Cfg_``.
461
-
462
- cfg\_.py Class Cfg\_
463
- ---------------------
464
-
465
- The static class ``Cfg_`` contains the subsequent static variables and methods
466
-
467
- Cfg\_Static Variables
468
- ^^^^^^^^^^^^^^^^^^^^^
469
-
470
- .. Cfg\_-Static-Variables-label:
471
- .. table:: *Cfg\_ Static Variables*
472
-
473
- +----+-----+-------+--------------------+
474
- |Name|Type |Default|Description |
475
- +====+=====+=======+====================+
476
- |cfg |TyDic|None |Configuration object|
477
- +----+-----+-------+--------------------+
478
-
479
- Cfg\_ Methods
480
- ^^^^^^^^^^^^^
481
-
482
- .. Cfg\_-Methods-label:
483
- .. table:: *Cfg\_ Methods*
484
-
485
- +----+------+-----------------------------------+
486
- |Name|Type |Description |
487
- +====+======+===================================+
488
- |sh |class |read pacmod yaml file into class |
489
- | | |variable cls.dic and return cls.cfg|
490
- +----+------+-----------------------------------+
491
-
492
- Cfg\_ Method: sh
493
- ^^^^^^^^^^^^^^^^
494
-
495
- Parameter
496
- """""""""
497
-
498
- .. Cfg\_-Method-sh-Parameter-label:
499
- .. table:: *Cfg\_ Method sh: Parameter*
500
-
501
- +--------+--------+-----------------+
502
- |Name |Type |Description |
503
- +========+========+=================+
504
- |cls |class |Current class |
505
- +--------+--------+-----------------+
506
- |log |TyLogger|Logger |
507
- +--------+--------+-----------------+
508
- |d_pacmod|TyDic |pacmod dictionary|
509
- +--------+--------+-----------------+
510
-
511
- Return Value
512
- """"""""""""
513
-
514
- .. Cfg\_-Method-sh-Return-Value-label:
515
- .. table:: *Cfg\_ Method sh: Return Value*
516
-
517
- +-------+-----+-----------+
518
- |Name |Type |Description|
519
- +=======+=====+===========+
520
- |cls.cfg|TyDic| |
521
- +-------+-----+-----------+
522
-
523
- Base Modul: exit\_.py
524
- =====================
525
-
526
- The Base module exit\_.py contains a single static class ``Ext_``.
527
-
528
- exit\_.py class: Exit\_
529
- -----------------------
530
-
531
- The static Class ``Exit_`` of Module exit\_.py contains the subsequent static variables and methods.
532
-
533
- Exit\_: Variables
534
- ^^^^^^^^^^^^^^^^^
535
-
536
- .. Exit\_-Variables-label:
537
- .. table:: *Exit\_ Variables*
538
-
539
- +--------------+------+-------+---------------------+
540
- |Name |Type |Default|Description |
541
- +==============+======+=======+=====================+
542
- |sw_init |TyBool|False |initialisation switch|
543
- +--------------+------+-------+---------------------+
544
- |sw_critical |TyBool|False |critical switch |
545
- +--------------+------+-------+---------------------+
546
- |sw_stop |TyBool|False |stop switch |
547
- +--------------+------+-------+---------------------+
548
- |sw_interactive|TyBool|False |interactive switch |
549
- +--------------+------+-------+---------------------+
550
-
551
- Exit\_: Methods
552
- ^^^^^^^^^^^^^^^
553
-
554
- .. Exit\_-Methods-label:
555
- .. table:: *Exit\_ Methods*
556
-
557
- +----+------+------------------------------------+
558
- |Name|Method|Description |
559
- +====+======+====================================+
560
- |init|class |initialise static variables of class|
561
- | | |if they are not allready initialized|
562
- +----+------+------------------------------------+
563
- |sh |class |show (return) class |
564
- +----+------+------------------------------------+
565
-
566
- Exit\_: Method: init
567
- ^^^^^^^^^^^^^^^^^^^^
568
-
569
- Parameter
570
- """""""""
571
-
572
- .. Exit\_-Method-init-Parameter:
573
- .. table:: *Exit\_ Method init: Parameter*
574
-
575
- +---------+-----+-----------------+
576
- |Name |Type |Description |
577
- +=========+=====+=================+
578
- |cls |class|Current class |
579
- +---------+-----+-----------------+
580
- |\**kwargs|TyAny|Keyword arguments|
581
- +---------+-----+-----------------+
582
-
583
- Exit\_: Method: sh
584
- ^^^^^^^^^^^^^^^^^^
585
-
586
- Parameter
587
- """""""""
588
-
589
- .. Exit\_-Method-sh-Parameter:
590
- .. table:: *Exit\_ Method sh: Parameter*
591
-
592
- +---------+-----+-----------------+
593
- |Name |Type |Description |
594
- +=========+=====+=================+
595
- |cls |class|Current class |
596
- +---------+-----+-----------------+
597
- |\**kwargs|TyAny|Keyword arguments|
598
- +---------+-----+-----------------+
599
-
600
- Return Value
601
- """"""""""""
602
-
603
- .. Exit\_-Method-sh-Return-Value:
604
- .. table:: *Exit\_ Method sh: Return Value*
605
-
606
- +----+-----+-------------+
607
- |Name|Type |Description |
608
- +====+=====+=============+
609
- |cls |class|Current class|
610
- +----+-----+-------------+
611
-
612
- Appendix
613
- ********
614
-
615
- Package Logging
616
- ===============
617
-
618
- Description
619
- -----------
620
-
621
- The Standard or user specifig logging is carried out by the log.py module of the logging
622
- package ka_uts_log using the configuration files **ka_std_log.yml** or **ka_usr_log.yml**
623
- in the configuration directory **cfg** of the logging package **ka_uts_log**.
624
- The Logging configuration of the logging package could be overriden by yaml files with
625
- the same names in the configuration directory **cfg** of the application packages.
626
-
627
- Log message types
628
- -----------------
629
-
630
- Logging defines log file path names for the following log message types: .
631
-
632
- #. *debug*
633
- #. *info*
634
- #. *warning*
635
- #. *error*
636
- #. *critical*
637
-
638
- Application parameter for logging
639
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
640
-
641
- .. Application-parameter-used-in-log-naming-label:
642
- .. table:: *Application parameter used in log naming*
643
-
644
- +-----------------+---------------------------+----------+------------+
645
- |Name |Decription |Values |Example |
646
- +=================+===========================+==========+============+
647
- |dir_dat |Application data directory | |/otev/data |
648
- +-----------------+---------------------------+----------+------------+
649
- |tenant |Application tenant name | |UMH |
650
- +-----------------+---------------------------+----------+------------+
651
- |package |Application package name | |otev_xls_srr|
652
- +-----------------+---------------------------+----------+------------+
653
- |cmd |Application command | |evupreg |
654
- +-----------------+---------------------------+----------+------------+
655
- |pid |Process ID | |æevupreg |
656
- +-----------------+---------------------------+----------+------------+
657
- |log_ts_type |Timestamp type used in |ts, |ts |
658
- | |logging files|ts, dt |dt | |
659
- +-----------------+---------------------------+----------+------------+
660
- |log_sw_single_dir|Enable single log directory|True, |True |
661
- | |or multiple log directories|False | |
662
- +-----------------+---------------------------+----------+------------+
663
-
664
- Log type and Log directories
665
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
666
-
667
- Single or multiple Application log directories can be used for each message type:
668
-
669
- .. Log-types-and-Log-directories-label:
670
- .. table:: *Log types and directoriesg*
671
-
672
- +--------------+---------------+
673
- |Log type |Log directory |
674
- +--------+-----+--------+------+
675
- |long |short|multiple|single|
676
- +========+=====+========+======+
677
- |debug |dbqs |dbqs |logs |
678
- +--------+-----+--------+------+
679
- |info |infs |infs |logs |
680
- +--------+-----+--------+------+
681
- |warning |wrns |wrns |logs |
682
- +--------+-----+--------+------+
683
- |error |errs |errs |logs |
684
- +--------+-----+--------+------+
685
- |critical|crts |crts |logs |
686
- +--------+-----+--------+------+
687
-
688
- Log files naming
689
- ^^^^^^^^^^^^^^^^
690
-
691
- Naming Conventions
692
- """"""""""""""""""
693
-
694
- .. Naming-conventions-for-logging-file-paths-label:
695
- .. table:: *Naming conventions for logging file paths*
696
-
697
- +--------+-------------------------------------------------------+-------------------------+
698
- |Type |Directory |File |
699
- +========+=======================================================+=========================+
700
- |debug |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
701
- +--------+-------------------------------------------------------+-------------------------+
702
- |info |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
703
- +--------+-------------------------------------------------------+-------------------------+
704
- |warning |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
705
- +--------+-------------------------------------------------------+-------------------------+
706
- |error |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
707
- +--------+-------------------------------------------------------+-------------------------+
708
- |critical|/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
709
- +--------+-------------------------------------------------------+-------------------------+
710
-
711
- Naming Examples
712
- """""""""""""""
713
-
714
- .. Naming-examples-for-logging-file-paths-label:
715
- .. table:: *Naming examples for logging file paths*
716
-
717
- +--------+--------------------------------------------+------------------------+
718
- |Type |Directory |File |
719
- +========+============================================+========================+
720
- |debug |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|debs_1737118199_9470.log|
721
- +--------+--------------------------------------------+------------------------+
722
- |info |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|infs_1737118199_9470.log|
723
- +--------+--------------------------------------------+------------------------+
724
- |warning |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|wrns_1737118199_9470.log|
725
- +--------+--------------------------------------------+------------------------+
726
- |error |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|errs_1737118199_9470.log|
727
- +--------+--------------------------------------------+------------------------+
728
- |critical|/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|crts_1737118199_9470.log|
729
- +--------+--------------------------------------------+------------------------+
730
-
731
- Python Terminology
732
- ==================
733
-
734
- Python packages
735
- ---------------
736
-
737
- .. Python packages-label:
738
- .. table:: *Python packages*
739
-
740
- +-----------+-----------------------------------------------------------------+
741
- |Name |Definition |
742
- +===========+==========+======================================================+
743
- |Python |Python packages are directories that contains the special module |
744
- |package |``__init__.py`` and other modules, packages files or directories.|
745
- +-----------+-----------------------------------------------------------------+
746
- |Python |Python sub-packages are python packages which are contained in |
747
- |sub-package|another pyhon package. |
748
- +-----------+-----------------------------------------------------------------+
749
-
750
- Python package Sub-directories
751
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
752
-
753
- .. Python package-Sub-directories-label:
754
- .. table:: *Python packages Sub-directories*
755
-
756
- +----------------------+-------------------------------+
757
- |Name |Definition |
758
- +======================+==========+====================+
759
- |Python package |Sub-directories are directories|
760
- |sub-directory |contained in python packages. |
761
- +----------------------+-------------------------------+
762
- |Special Python package|Python package sub-directories |
763
- |sub-directory |with a special meaning. |
764
- +----------------------+-------------------------------+
765
-
766
- Special python package Sub-directories
767
- """"""""""""""""""""""""""""""""""""""
768
-
769
- .. Special-python-package-Sub-directories-label:
770
- .. table:: *Special python Sub-directories*
771
-
772
- +-------+------------------------------------------+
773
- |Name |Description |
774
- +=======+==========================================+
775
- |bin |Directory for package scripts. |
776
- +-------+------------------------------------------+
777
- |cfg |Directory for package configuration files.|
778
- +-------+------------------------------------------+
779
- |data |Directory for package data files. |
780
- +-------+------------------------------------------+
781
- |service|Directory for systemd service scripts. |
782
- +-------+------------------------------------------+
783
-
784
- Python package files
785
- ^^^^^^^^^^^^^^^^^^^^
786
-
787
- .. Python-package-files-label:
788
- .. table:: *Python package files*
789
-
790
- +--------------+---------------------------------------------------------+
791
- |Name |Definition |
792
- +==============+==========+==============================================+
793
- |Python |Files within a python package. |
794
- |package files | |
795
- +--------------+---------------------------------------------------------+
796
- |Special python|Package files which are not modules and used as python |
797
- |package files |and used as python marker files like ``__init__.py``. |
798
- +--------------+---------------------------------------------------------+
799
- |Python package|Files with suffix ``.py``; they could be empty or contain|
800
- |module |python code; other modules can be imported into a module.|
801
- +--------------+---------------------------------------------------------+
802
- |Special python|Modules like ``__init__.py`` or ``main.py`` with special |
803
- |package module|names and functionality. |
804
- +--------------+---------------------------------------------------------+
805
-
806
- Special python package files
807
- """"""""""""""""""""""""""""
808
-
809
- .. Special-python-package-files-label:
810
- .. table:: *Special python package files*
811
-
812
- +--------+--------+---------------------------------------------------------------+
813
- |Name |Type |Description |
814
- +========+========+===============================================================+
815
- |py.typed|Type |The ``py.typed`` file is a marker file used in Python packages |
816
- | |checking|to indicate that the package supports type checking. This is a |
817
- | |marker |part of the PEP 561 standard, which provides a standardized way|
818
- | |file |to package and distribute type information in Python. |
819
- +--------+--------+---------------------------------------------------------------+
820
-
821
- Special python package modules
822
- """"""""""""""""""""""""""""""
823
-
824
- .. Special-Python-package-modules-label:
825
- .. table:: *Special Python package modules*
826
-
827
- +--------------+-----------+-----------------------------------------------------------------+
828
- |Name |Type |Description |
829
- +==============+===========+=================================================================+
830
- |__init__.py |Package |The dunder (double underscore) module ``__init__.py`` is used to |
831
- | |directory |execute initialisation code or mark the directory it contains as |
832
- | |marker |a package. The Module enforces explicit imports and thus clear |
833
- | |file |namespace use and call them with the dot notation. |
834
- +--------------+-----------+-----------------------------------------------------------------+
835
- |__main__.py |entry point|The dunder module ``__main__.py`` serves as an entry point for |
836
- | |for the |the package. The module is executed when the package is called by|
837
- | |package |the interpreter with the command **python -m <package name>**. |
838
- +--------------+-----------+-----------------------------------------------------------------+
839
- |__version__.py|Version |The dunder module ``__version__.py`` consist of assignment |
840
- | |file |statements used in Versioning. |
841
- +--------------+-----------+-----------------------------------------------------------------+
842
-
843
- Python elements
844
- ---------------
845
-
846
- .. Python elements-label:
847
- .. table:: *Python elements*
848
-
849
- +---------------------+--------------------------------------------------------+
850
- |Name |Description |
851
- +=====================+========================================================+
852
- |Python method |Python functions defined in python modules. |
853
- +---------------------+--------------------------------------------------------+
854
- |Special python method|Python functions with special names and functionalities.|
855
- +---------------------+--------------------------------------------------------+
856
- |Python class |Classes defined in python modules. |
857
- +---------------------+--------------------------------------------------------+
858
- |Python class method |Python methods defined in python classes |
859
- +---------------------+--------------------------------------------------------+
860
-
861
- Special python methods
862
- ^^^^^^^^^^^^^^^^^^^^^^
863
-
864
- .. Special-python-methods-label:
865
- .. table:: *Special python methods*
866
-
867
- +--------+------------+----------------------------------------------------------+
868
- |Name |Type |Description |
869
- +========+============+==========================================================+
870
- |__init__|class object|The special method ``__init__`` is called when an instance|
871
- | |constructor |(object) of a class is created; instance attributes can be|
872
- | |method |defined and initalized in the method. |
873
- +--------+------------+----------------------------------------------------------+
874
-
875
- Table of Contents
876
- =================
877
-
878
- .. contents:: **Table of Content**