ka-uts-com 1.0.0.240823__py3-none-any.whl → 2.0.0.250407__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.
Files changed (59) hide show
  1. build/lib/ka_uts_com/__version__.py +1 -1
  2. build/lib/ka_uts_com/base/app_.py +50 -0
  3. build/lib/ka_uts_com/base/cfg_.py +35 -0
  4. build/lib/ka_uts_com/base/exit_.py +37 -0
  5. build/lib/ka_uts_com/base/log_.py +131 -0
  6. build/lib/ka_uts_com/com.py +91 -192
  7. build/lib/ka_uts_com/data/log.std.yml +107 -0
  8. build/lib/ka_uts_com/data/{log.standard.yml → log.usr.yml} +47 -27
  9. build/lib/ka_uts_com/decorators/dec.py +13 -0
  10. build/lib/ka_uts_com/fnc.py +29 -24
  11. build/lib/ka_uts_com/ioc/jinja2_.py +42 -0
  12. build/lib/ka_uts_com/ioc/yaml_.py +30 -0
  13. build/lib/ka_uts_com/log.py +48 -25
  14. build/lib/ka_uts_com/timer.py +24 -27
  15. build/lib/ka_uts_com/utils/aoeqstmt.py +37 -0
  16. build/lib/ka_uts_com/{date.py → utils/date.py} +4 -4
  17. build/lib/ka_uts_com/utils/doeq.py +99 -0
  18. build/lib/ka_uts_com/utils/pacmod.py +123 -0
  19. build/lib/ka_uts_com/{str.py → utils/str.py} +36 -39
  20. ka_uts_com/__version__.py +1 -1
  21. ka_uts_com/base/app_.py +50 -0
  22. ka_uts_com/base/cfg_.py +35 -0
  23. ka_uts_com/base/exit_.py +37 -0
  24. ka_uts_com/base/log_.py +131 -0
  25. ka_uts_com/com.py +91 -192
  26. ka_uts_com/data/log.std.yml +107 -0
  27. ka_uts_com/data/{log.standard.yml → log.usr.yml} +47 -27
  28. ka_uts_com/decorators/dec.py +13 -0
  29. ka_uts_com/fnc.py +29 -24
  30. ka_uts_com/ioc/jinja2_.py +42 -0
  31. ka_uts_com/ioc/yaml_.py +30 -0
  32. ka_uts_com/log.py +48 -25
  33. ka_uts_com/timer.py +24 -27
  34. ka_uts_com/utils/aoeqstmt.py +37 -0
  35. ka_uts_com/{date.py → utils/date.py} +4 -4
  36. ka_uts_com/utils/doeq.py +99 -0
  37. ka_uts_com/utils/pacmod.py +123 -0
  38. ka_uts_com/{str.py → utils/str.py} +36 -39
  39. ka_uts_com-2.0.0.250407.dist-info/METADATA +1611 -0
  40. ka_uts_com-2.0.0.250407.dist-info/RECORD +49 -0
  41. {ka_uts_com-1.0.0.240823.dist-info → ka_uts_com-2.0.0.250407.dist-info}/WHEEL +1 -1
  42. {ka_uts_com-1.0.0.240823.dist-info → ka_uts_com-2.0.0.250407.dist-info/licenses}/LICENSE.txt +1 -2
  43. build/lib/dist/ka_uts_com-1.0.0.240823-py3-none-any.whl +0 -0
  44. build/lib/dist/ka_uts_com-1.0.0.240823.tar.gz +0 -0
  45. build/lib/ka_uts_com/aeq.py +0 -87
  46. build/lib/ka_uts_com/argv.py +0 -49
  47. build/lib/ka_uts_com/data/log.personal.yml +0 -93
  48. build/lib/ka_uts_com/ioc.py +0 -57
  49. build/lib/ka_uts_com/pacmod.py +0 -111
  50. dist/ka_uts_com-1.0.0.240823-py3-none-any.whl +0 -0
  51. dist/ka_uts_com-1.0.0.240823.tar.gz +0 -0
  52. ka_uts_com/aeq.py +0 -87
  53. ka_uts_com/argv.py +0 -49
  54. ka_uts_com/data/log.personal.yml +0 -93
  55. ka_uts_com/ioc.py +0 -57
  56. ka_uts_com/pacmod.py +0 -111
  57. ka_uts_com-1.0.0.240823.dist-info/METADATA +0 -943
  58. ka_uts_com-1.0.0.240823.dist-info/RECORD +0 -41
  59. {ka_uts_com-1.0.0.240823.dist-info → ka_uts_com-2.0.0.250407.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,1611 @@
1
+ Metadata-Version: 2.4
2
+ Name: ka_uts_com
3
+ Version: 2.0.0.250407
4
+ Summary: Communication Class 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: Jinja2>=3.1.6
21
+ Requires-Dist: orjson>=3.10.16
22
+ Requires-Dist: psutil>=7.0.0
23
+ Requires-Dist: PyYAML>=6.0.2
24
+ Requires-Dist: simplejson>=3.20.1
25
+ Dynamic: license-file
26
+
27
+ ##########
28
+ ka_uts_com
29
+ ##########
30
+
31
+ Overview
32
+ ********
33
+
34
+ .. start short_desc
35
+
36
+ **Communication Utilities**
37
+
38
+ .. end short_desc
39
+
40
+ Installation
41
+ ************
42
+
43
+ .. start installation
44
+
45
+ The package ``ka_uts_com`` can be installed from PyPI or Anaconda.
46
+
47
+ To install with ``pip``:
48
+
49
+ .. code-block:: shell
50
+
51
+ $ python -m pip install ka_uts_com
52
+
53
+ To install with ``conda``:
54
+
55
+ .. code-block:: shell
56
+
57
+ $ conda install -c conda-forge ka_uts_com
58
+
59
+ .. end installation
60
+
61
+ Package logging
62
+ ***************
63
+
64
+ Standard or user specific Package logging of application package is defined
65
+ in the static logging class **Log_** of Base module log\_.py of the Communication
66
+ Package **ka_uts_com**.
67
+ The default Logging configuration is defined by the yaml files **log.std.yml**
68
+ for standard Logging or **log.usr.yml** for user Logging in the data directory
69
+ **/ka_uts_com/data** of the Communication package.
70
+ The Logging configuration could be overriden by yaml files with the same names in the
71
+ data directory **<application>/data** of the application packages.
72
+
73
+ Logging defines log file paths for the following log message types: .
74
+
75
+ #. *error*
76
+ #. *warning*
77
+ #. *info*
78
+ #. *log*
79
+ #. *debug*
80
+
81
+ .. Naming-conventions-for-logging-files-label:
82
+ .. table:: *Naming conventions for logging file*
83
+
84
+ +-------+--------------------------------------------+-------------------+
85
+ |Type |Directory |File |
86
+ +=======+============================================+===================+
87
+ |error |/data/<tenant>/RUN/<package>/<function>/errs|errs_<pid>_<ts>.log|
88
+ +-------+--------------------------------------------+-------------------+
89
+ |wnrning|/data/<tenant>/RUN/<package>/<function>/wrns|wrns_<pid>_<ts>.log|
90
+ +-------+--------------------------------------------+-------------------+
91
+ |info |/data/<tenant>/RUN/<package>/<function>/infs|infs_<pid>_<ts>.log|
92
+ +-------+--------------------------------------------+-------------------+
93
+ |log |/data/<tenant>/RUN/<package>/<function>/logs|logs_<pid>_<ts>.log|
94
+ +-------+--------------------------------------------+-------------------+
95
+ |debug |/data/<tenant>/RUN/<package>/<function>/debs|debs_<pid>_<ts>.log|
96
+ +-------+--------------------------------------------+-------------------+
97
+
98
+ .. Naming examples-of-logging-files-label:
99
+ .. table:: *Naming examples of logging file*
100
+
101
+ +-------+-------------------------------+------------------------+
102
+ |Type |Directory |File |
103
+ +=======+===============================+========================+
104
+ |error |/data/umh/RUN/umh_otec/srr/errs|errs_9470_1737118199.log|
105
+ +-------+-------------------------------+------------------------+
106
+ |warning|/data/umh/RUN/umh_otec/srr/wrns|wrns_9470_1737118199.log|
107
+ +-------+-------------------------------+------------------------+
108
+ |info |/data/umh/RUN/umh_otec/srr/infs|infs_9470_1737118199.log|
109
+ +-------+-------------------------------+------------------------+
110
+ |log |/data/umh/RUN/umh_otec/srr/logs|logs_9470_1737118199.log|
111
+ +-------+-------------------------------+------------------------+
112
+ |debug |/data/umh/RUN/umh_otec/srr/debs|debs_9470_1737118199.log|
113
+ +-------+-------------------------------+------------------------+
114
+
115
+ Package files
116
+ *************
117
+
118
+ Classification
119
+ ==============
120
+
121
+ The Files of Package ``ka_uts_com`` could be classified into the follwing file types:
122
+
123
+ #. *Special files*
124
+ #. *Dunder modules*
125
+ #. *Decorator modules*
126
+ #. *Package modules*
127
+ #. *Data files*
128
+
129
+ Special files
130
+ *************
131
+
132
+ .. Special-file-label:
133
+ .. table:: *Special-file*
134
+
135
+ +--------+--------+-------------------------------------------------------------+
136
+ |Name |Type |Description |
137
+ +========+========+=============================================================+
138
+ |py.typed|Type |The py.typed file is a marker file used in Python packages to|
139
+ | |checking|indicate that the package supports type checking. This is a |
140
+ | |marker |part of the PEP 561 standard, which provides a standardized |
141
+ | |file |way to package and distribute type information in Python. |
142
+ +--------+--------+-------------------------------------------------------------+
143
+
144
+ Dunder Modules
145
+ **************
146
+
147
+ .. Dunder-modules-label:
148
+ .. table:: *Dunder-Modules*
149
+
150
+ +--------------+---------+----------------------------------------------------+
151
+ |Name |Type |Description |
152
+ +==============+=========+====================================================+
153
+ |__init__.py |Package |The module is used to execute initialisation code or|
154
+ | |directory|mark the directory it contains as a package. The |
155
+ | |marker |Module enforces explicit imports and thus clear |
156
+ | |file |namespace use and call them with the dot notation. |
157
+ +--------------+---------+----------------------------------------------------+
158
+ |__version__.py|Version |The module consist of Assignment Statements for |
159
+ | |file |system Variables used in Versioning. |
160
+ +--------------+---------+----------------------------------------------------+
161
+
162
+ Decorator Modules
163
+ *****************
164
+
165
+ Overview
166
+ ========
167
+
168
+ .. Decorator Modules-label:
169
+ .. table:: *Decorator Modules*
170
+
171
+ +------+-----------------+
172
+ |Name |Decription |
173
+ +======+=================+
174
+ |dec.py|Decorators module|
175
+ +------+-----------------+
176
+
177
+ Data Files
178
+ **********
179
+
180
+ Overview
181
+ ========
182
+
183
+ .. Data-Files-label:
184
+ .. table:: *Data Files*
185
+
186
+ +-----------+-----------------------------------------+
187
+ |Name |Description |
188
+ +===========+=========================================+
189
+ |log.std.yml|Yaml definition file for standard logging|
190
+ +-----------+-----------------------------------------+
191
+ |log.usr.yml|Yaml definition file for user logging |
192
+ +-----------+-----------------------------------------+
193
+
194
+ Package Files
195
+ *************
196
+
197
+ Classification
198
+ ==============
199
+
200
+ The Modules of Package ``ka_uts_com`` could be classified into the following module types:
201
+
202
+ #. **Communication Modules**
203
+ #. **Base Modules**
204
+ #. **Utility Modules**
205
+ #. **I/O Control Modules**
206
+
207
+ Communication Modules
208
+ =====================
209
+
210
+ Overview
211
+ --------
212
+
213
+ .. Communication Modules-label:
214
+ .. table:: *Communication Modules*
215
+
216
+ +--------+-----------------------------+
217
+ |Name |Decription |
218
+ +========+=============================+
219
+ |com.py |Communication handling module|
220
+ +--------+-----------------------------+
221
+ |fnc.py |Function Management module |
222
+ +--------+-----------------------------+
223
+ |log.py |Logging management module |
224
+ +--------+-----------------------------+
225
+ |timer.py|Timer management module |
226
+ +--------+-----------------------------+
227
+
228
+ Communication module com.py
229
+ ===========================
230
+
231
+ The Communication Module ``com.py`` contains the single static class ``Com``.
232
+
233
+ Class Com
234
+ ---------
235
+
236
+ The static Class ``Com`` contains the subsequent variables and methods.
237
+
238
+ Variables
239
+ ^^^^^^^^^
240
+
241
+ .. Variables-of-class-Com-label:
242
+ .. table:: *Variables of class Com*
243
+
244
+ +--------+-----------+-------+-----------------------------------+
245
+ |Name |Type |Default|Description |
246
+ +========+===========+=======+===================================+
247
+ |cfg |TyDic |None |Configuration dictionary |
248
+ +--------+-----------+-------+-----------------------------------+
249
+ |d_pacmod|TyDic |{} |pacmod dictionary |
250
+ +--------+-----------+-------+-----------------------------------+
251
+ |pid |TyInt |None |Process id |
252
+ +--------+-----------+-------+-----------------------------------+
253
+ |sw_init |TyBool |None |Initialisation switch |
254
+ +--------+-----------+-------+-----------------------------------+
255
+ |ts |TnTimeStamp|None |Timestamp |
256
+ +--------+-----------+-------+-----------------------------------+
257
+ |ts_start|TnDateTime |None |start timestamp in date time format|
258
+ +--------+-----------+-------+-----------------------------------+
259
+ |ts_end |TnDateTime |None |end timestamp in date time format |
260
+ +--------+-----------+-------+-----------------------------------+
261
+ |ts_etime|TnDateTime |None |elapse Time |
262
+ +--------+-----------+-------+-----------------------------------+
263
+ |d_timer |TyDic |False |Timer dictionary |
264
+ +--------+-----------+-------+-----------------------------------+
265
+ |Log |TyLogger |False |Log class |
266
+ +--------+-----------+-------+-----------------------------------+
267
+ |App |TyAny |False |Application class |
268
+ +--------+-----------+-------+-----------------------------------+
269
+ |Exit |TyAny |False |Exit class |
270
+ +--------+-----------+-------+-----------------------------------+
271
+
272
+ Methods
273
+ ^^^^^^^
274
+
275
+ .. Methods-of-class-Com-label:
276
+ .. table:: *Methods-of-class-Com*
277
+
278
+ +---------+-------------------------------------------------------+
279
+ |Name |Description |
280
+ +=========+=======================================================+
281
+ |init |Initialise static variables if they are not initialized|
282
+ +---------+-------------------------------------------------------+
283
+ |sh_kwargs|Show keyword arguments |
284
+ +---------+-------------------------------------------------------+
285
+
286
+ Method init
287
+ ^^^^^^^^^^^
288
+
289
+ Parameter
290
+ """""""""
291
+
292
+ .. Parameter-of-method-init-label:
293
+ .. table:: *Parameter-of-method-init*
294
+
295
+ +---------+-----+-----------------+
296
+ |Name |Type |Description |
297
+ +=========+=====+=================+
298
+ |cls |class|current class |
299
+ +---------+-----+-----------------+
300
+ |\**kwargs|TyAny|keyword arguments|
301
+ +---------+-----+-----------------+
302
+
303
+ Method sh_kwargs
304
+ ^^^^^^^^^^^^^^^^
305
+
306
+ Parameter
307
+ """""""""
308
+
309
+ .. Parameter-of-method-sh_kwargs-label:
310
+ .. table:: *Parameter of method sh_kwargs*
311
+
312
+ +--------+-----+--------------------+
313
+ |Name |Type |Description |
314
+ +========+=====+====================+
315
+ |cls |class|current class |
316
+ +--------+-----+--------------------+
317
+ |root_cls|class|root lass |
318
+ +--------+-----+--------------------+
319
+ |d_parms |TyDic|parameter dictionary|
320
+ +--------+-----+--------------------+
321
+ |\*args |list |arguments array |
322
+ +--------+-----+--------------------+
323
+
324
+ Function Module fnc.py
325
+ ======================
326
+
327
+ The Module ``fnc.py`` contains the static class ``Fnc`` with I/O Control methods for log files;
328
+
329
+ Class Fnc
330
+ ---------
331
+
332
+ The static Class ``Fnc`` contains the subsequent methods
333
+
334
+ Methods
335
+ ^^^^^^^
336
+
337
+ .. Methods-of-class-Fnc-label:
338
+ .. table:: *Methods of class Fnc*
339
+
340
+ +--------+------+---------------------------------------------------------+
341
+ |Name |Type |Description |
342
+ +========+======+=========================================================+
343
+ |identity|static|Identity function for objects |
344
+ +--------+------+---------------------------------------------------------+
345
+ |sh |static|Show function localised in the given dictionary of |
346
+ | | |functions by the given key |
347
+ +--------+------+---------------------------------------------------------+
348
+ |ex |class |Execute the function localised by the show function of |
349
+ | | |class Fnc using the given key and dictionary of functions|
350
+ +--------+------+---------------------------------------------------------+
351
+
352
+ Method identity
353
+ ^^^^^^^^^^^^^^^
354
+
355
+ Parameter
356
+ """""""""
357
+
358
+ .. Parameter-of-method-identity-label:
359
+ .. table:: *Parameter of method identity*
360
+
361
+ +----+-----+-----------+
362
+ |Name|Type |Description|
363
+ +====+=====+===========+
364
+ |obj |TyAny|object |
365
+ +----+-----+-----------+
366
+
367
+ Return Value
368
+ """"""""""""
369
+
370
+ .. Return-values-of-method-identity-label:
371
+ .. table:: *Return values of method identity*
372
+
373
+ +----+-----+-----------+
374
+ |Name|Type |Description|
375
+ +====+=====+===========+
376
+ |obj |TyAny|object |
377
+ +----+-----+-----------+
378
+
379
+ Method ex
380
+ ^^^^^^^^^
381
+
382
+ Parameter
383
+ """""""""
384
+
385
+ .. Parameter-of-method-ex-label:
386
+ .. table:: *Parameter of method ex*
387
+
388
+ +-----------+--------+------------------------------+
389
+ |Name |Type |Description |
390
+ +===========+========+==============================+
391
+ |cls |class |current class |
392
+ +-----------+--------+------------------------------+
393
+ |doc |TnDoC |Dictionary of Callables |
394
+ +-----------+--------+------------------------------+
395
+ |key |TnDoc |key |
396
+ +-----------+--------+------------------------------+
397
+ |args_kwargs|TnArrDoc|arguments or keyword arguments|
398
+ +-----------+--------+------------------------------+
399
+
400
+ Return Value
401
+ """"""""""""
402
+
403
+ .. Return-value-of-method-ex-label:
404
+ .. table:: *Return value of method ex*
405
+
406
+ +----+----------+------------------------------------------+
407
+ |Name|Type |Description |
408
+ +====+==========+==========================================+
409
+ | |TyCallable|Value of Function for argument args_kwargs|
410
+ +----+----------+------------------------------------------+
411
+
412
+ Method sh
413
+ ^^^^^^^^^
414
+
415
+ Parameter
416
+ """""""""
417
+
418
+ .. Parameter-of-method-sh-label:
419
+ .. table:: *Parameter of method sh*
420
+
421
+ +----+-----+------------------------------+
422
+ |Name|Type |Description |
423
+ +====+=====+==============================+
424
+ |cls |class|current class |
425
+ +----+-----+------------------------------+
426
+ |doc |TnDoC|Dictionary of Callables |
427
+ +----+-----+------------------------------+
428
+ |key |TnDoc|key |
429
+ +----+-----+------------------------------+
430
+
431
+ Return Value
432
+ """"""""""""
433
+
434
+ .. Return-value-of-method-sh-label:
435
+ .. table:: *Return value of method sh*
436
+
437
+ +----+----------+-----------+
438
+ |Name|Type |Description|
439
+ +====+==========+===========+
440
+ |fnc |TyCallable|Function |
441
+ +----+----------+-----------+
442
+
443
+ Communicstion Module: log.py
444
+ ============================
445
+
446
+ The Module ``log.py`` contains the static class ``Log`` with I/O Control methods for log files;
447
+
448
+ Class Log
449
+ ---------
450
+
451
+ The static Class ``Log`` contains the subsequent sub classes and methods
452
+
453
+ Sub-Classes
454
+ ^^^^^^^^^^^
455
+
456
+ The Class ``Log`` contains the following sub-classes.
457
+
458
+ .. Static-sub-classes-of-class-Log-label:
459
+ .. table:: *Static sub classes of class Log label*
460
+
461
+ +----+----------------------------------------------------+
462
+ |Name|Description |
463
+ +====+====================================================+
464
+ |Eq |Log generated Equate messages |
465
+ +----+----------------------------------------------------+
466
+ |Dic |Log generated Equate messages for dictionary entries|
467
+ +----+----------------------------------------------------+
468
+
469
+ Sub class Eq
470
+ ^^^^^^^^^^^^
471
+
472
+ Methods
473
+ """""""
474
+
475
+ .. Methods-of-sub-class-Eq-label:
476
+ .. table:: *Methods-of-sub-class-Eq-label*
477
+
478
+ +-----+-----------------------------------------------------------------------+
479
+ |Name |Description |
480
+ +=====+=======================================================================+
481
+ |debug|Log generated equate message "<key> = <value>" to the debug destination|
482
+ +-----+-----------------------------------------------------------------------+
483
+ |error|Log generated equate message "<key> = <value>" to the error destination|
484
+ +-----+-----------------------------------------------------------------------+
485
+ |info |Log generated equate message "<key> = <value>" to the info destination |
486
+ +-----+-----------------------------------------------------------------------+
487
+ |debug|Log generated equate message "<key> = <value>" to the log destination |
488
+ +-----+-----------------------------------------------------------------------+
489
+
490
+ All Methods use the following Parameter:
491
+
492
+ Parameter
493
+ """""""""
494
+
495
+ .. Parameter-of-Methods-of-sub-class-Eq-label:
496
+ .. table:: *Parameter of Methods of sub class Eq*
497
+
498
+ +-----+-----+-------------+
499
+ |Name |Type |Description |
500
+ +=====+=====+=============+
501
+ |cls |class|current class|
502
+ +-----+-----+-------------+
503
+ |key |TyAny|Key |
504
+ +-----+-----+-------------+
505
+ |value|TyAny|Value |
506
+ +-----+-----+-------------+
507
+
508
+ Sub class Dic
509
+ ^^^^^^^^^^^^^
510
+
511
+ Methods
512
+ """""""
513
+
514
+ .. Methods-of-Sub-class-Dic-of-class-Log-label:
515
+ .. table:: *Methods of Sub class Dic of class Log*
516
+
517
+ +-----+---------------------------------------------------------------------------------+
518
+ |Name |Description |
519
+ +=====+=================================================================================+
520
+ |debug|Log generated equate messages for all dictionary entries to the debug destination|
521
+ +-----+---------------------------------------------------------------------------------+
522
+ |error|Log generated equate messages for all dictionary entries to the error destination|
523
+ +-----+---------------------------------------------------------------------------------+
524
+ |info |Log generated equate messages for all dictionary entries to the info destination |
525
+ +-----+---------------------------------------------------------------------------------+
526
+ |log |Log generated equate messages for all dictionary entries to the log destination |
527
+ +-----+---------------------------------------------------------------------------------+
528
+
529
+ All Methods of Sub class Dic of class Log use the following Parameters:
530
+
531
+ Parameter
532
+ """""""""
533
+
534
+ .. Methods-Parameter-of-Sub-class-Dic-of-class-Log-label:
535
+ .. table:: *Methods Parameter of Sub class Dic of class-Log*
536
+
537
+ +----+-----+-------------+
538
+ |Name|Type |Description |
539
+ +====+=====+=============+
540
+ |cls |class|current class|
541
+ +----+-----+-------------+
542
+ |dic |TyDic|Dictionary |
543
+ +----+-----+-------------+
544
+
545
+ Methods
546
+ ^^^^^^^
547
+
548
+ .. Methods-of-Sub-class-Dic-of-class-Log-label:
549
+ .. table:: *Methods of Sub class Dic of class Log*
550
+
551
+ +-------+-----------------------------------------------------------+
552
+ |Name |Description |
553
+ +=======+===========================================================+
554
+ |debug |Setup stacklevel and log message to the debug destination |
555
+ +-------+-----------------------------------------------------------+
556
+ |error |Setup stacklevel and log message to the error destination |
557
+ +-------+-----------------------------------------------------------+
558
+ |info |Setup stacklevel and log message to the info destination |
559
+ +-------+-----------------------------------------------------------+
560
+ |warning|Setup stacklevel and log message to the warning destination|
561
+ +-------+-----------------------------------------------------------+
562
+
563
+ Time management Module timer.py
564
+ ===============================
565
+
566
+ Classes
567
+ -------
568
+
569
+ The Module ``timer.py`` contains the following classes
570
+
571
+
572
+ .. Static-classes-of-module-timer.py-label:
573
+ .. table:: *Static classes of module timer.py*
574
+
575
+ +---------+------+---------------+
576
+ |Name |Type |Description |
577
+ +=========+======+===============+
578
+ |Timestamp|static|Timestamp class|
579
+ +---------+------+---------------+
580
+ |Timer |static|Timer class |
581
+ +---------+------+---------------+
582
+
583
+
584
+ Class Timer
585
+ -----------
586
+
587
+ Methods
588
+ ^^^^^^^
589
+
590
+ .. Methods-of-class-Timer-label:
591
+ .. table:: *Methods of class Timer*
592
+
593
+ +----------+------------------------------------+
594
+ |Name |Description |
595
+ +==========+====================================+
596
+ |sh_task_id|Show task id |
597
+ +----------+------------------------------------+
598
+ |start |Start Timer |
599
+ +----------+------------------------------------+
600
+ |end |End Timer and Log Timer info message|
601
+ +----------+------------------------------------+
602
+
603
+ Method sh_task_id
604
+ ^^^^^^^^^^^^^^^^^
605
+
606
+ Show task id, which is created by the concatination of the following items if they are defined:
607
+ #. package,
608
+ #. module,
609
+ #. class_name,
610
+ #. parms
611
+ The items package and module are get from the package-module directory;
612
+ The item class_name is the class_id if its a string, otherwise the attribute
613
+ __qualname__ is used.
614
+
615
+ Parameter
616
+ """""""""
617
+
618
+ .. Parameter-of-method-sh_task_id-label:
619
+ .. table:: *Parameter-of-method-sh_task_id*
620
+
621
+ +--------+-----+-----------------+
622
+ |Name |Type |Description |
623
+ +========+=====+=================+
624
+ |d_pacmod|TyDic|pacmod dictionary|
625
+ +--------+-----+-----------------+
626
+ |class_id|TyAny|Class Id |
627
+ +--------+-----+-----------------+
628
+ |parms |TnAny|Parameters |
629
+ +--------+-----+-----------------+
630
+ |sep |TyStr|Separator |
631
+ +--------+-----+-----------------+
632
+
633
+ Return Value
634
+ """"""""""""
635
+
636
+ .. Return-value-of-method-sh_task_id-label:
637
+ .. table:: *Return value of method sh_task_id*
638
+
639
+ +----+-----+-----------+
640
+ |Name|Type |Description|
641
+ +====+=====+===========+
642
+ | |TyStr|Task Id |
643
+ +----+-----+-----------+
644
+
645
+ Method start
646
+ ^^^^^^^^^^^^
647
+
648
+ Parameter
649
+ """""""""
650
+
651
+ .. Parameter-of-method-start-label:
652
+ .. table:: *Parameter of method start*
653
+
654
+ +--------+-----+-------------+
655
+ |Name |Type |Description |
656
+ +========+=====+=============+
657
+ |cls |class|current class|
658
+ +--------+-----+-------------+
659
+ |class_id|TyAny|Class Id |
660
+ +--------+-----+-------------+
661
+ |parms |TnAny|Parameter |
662
+ +--------+-----+-------------+
663
+ |sep |TyStr|Separator |
664
+ +--------+-----+-------------+
665
+
666
+ Method: end
667
+ ^^^^^^^^^^^
668
+
669
+ Parameter
670
+ """""""""
671
+
672
+ .. Parameter-of-end-method-label:
673
+ .. table:: *Parameter of end method*
674
+
675
+ +--------+-----+-------------+
676
+ |Name |Type |Description |
677
+ +========+=====+=============+
678
+ |cls |class|current class|
679
+ +--------+-----+-------------+
680
+ |class_id|TyAny|Class Id |
681
+ +--------+-----+-------------+
682
+ |parms |TnAny|Parameter |
683
+ +--------+-----+-------------+
684
+ |sep |TyStr|Separator |
685
+ +--------+-----+-------------+
686
+
687
+ Base Modules
688
+ ************
689
+
690
+ Overview
691
+ ========
692
+
693
+ .. Base Modules-label:
694
+ .. table:: *Base Modules*
695
+
696
+ +---------+----------------------------+
697
+ |Name |Decription |
698
+ +=========+============================+
699
+ |app\_.py |Application setup module |
700
+ +---------+----------------------------+
701
+ |cfg\_.py |Configuration setup module |
702
+ +---------+----------------------------+
703
+ |exit\_.py|Exit Manafement setup module|
704
+ +---------+----------------------------+
705
+ |log\_.py |Log management setup module |
706
+ +---------+----------------------------+
707
+
708
+ Application setup module: app\_.py
709
+ ==================================
710
+
711
+ The Module ``app.py`` contains a single static class ``App_``.
712
+
713
+ Class: App\_
714
+ ------------
715
+
716
+ The static class ``App_`` contains the subsequent static variables and methods
717
+
718
+ Static Variables
719
+ ^^^^^^^^^^^^^^^^
720
+
721
+ .. Static-variables-of-class-App_-label:
722
+ .. table:: *Static Variables of class App_*
723
+
724
+ +---------------+-------+-------+---------------------+
725
+ |Name |Type |Default|Description |
726
+ +===============+=======+=======+=====================+
727
+ |sw_init |TyBool |False |initialisation switch|
728
+ +---------------+-------+-------+---------------------+
729
+ |httpmod |TyDic |None |http modus |
730
+ +---------------+-------+-------+---------------------+
731
+ |sw_replace_keys|TnBool |False |replace keys switch |
732
+ +---------------+-------+-------+---------------------+
733
+ |keys |TnArr |None |Keys array |
734
+ +---------------+-------+-------+---------------------+
735
+ |reqs |TyDic |None |Requests dictionary |
736
+ +---------------+-------+-------+---------------------+
737
+ |app |TyDic |None |Appliction dictionary|
738
+ +---------------+-------+-------+---------------------+
739
+
740
+ Methods
741
+ ^^^^^^^
742
+
743
+ .. Methods-of-class-App_-label:
744
+ .. table:: *Methods of class App_*
745
+
746
+ +----+------+------------------------------------+
747
+ |Name|Type |Description |
748
+ +====+======+====================================+
749
+ |init|class |initialise static variables of class|
750
+ | | |if they are not allready initialized|
751
+ +----+------+------------------------------------+
752
+ |sh |class |show (return) class |
753
+ +----+------+------------------------------------+
754
+
755
+ Method: init
756
+ ^^^^^^^^^^^^
757
+
758
+ Parameter
759
+ """""""""
760
+
761
+ .. Parameter-of-method-init-label:
762
+ .. table:: *Parameter of method init*
763
+
764
+ +---------+-----+-----------------+
765
+ |Name |Type |Description |
766
+ +=========+=====+=================+
767
+ |cls |class|Current class |
768
+ +---------+-----+-----------------+
769
+ |\**kwargs|TyAny|Keyword arguments|
770
+ +---------+-----+-----------------+
771
+
772
+ Method: sh
773
+ ^^^^^^^^^^
774
+
775
+ .. Parameter-of-method-sh-label:
776
+ .. table:: *Parameter of method sh*
777
+
778
+ +---------+-----+-----------------+
779
+ |Name |Type |Description |
780
+ +=========+=====+=================+
781
+ |cls |class|Current class |
782
+ +---------+-----+-----------------+
783
+ |\**kwargs|TyAny|Keyword arguments|
784
+ +---------+-----+-----------------+
785
+
786
+ Return Value
787
+ """"""""""""
788
+
789
+ .. Return-values-of-method-sh-label:
790
+ .. table:: *Return values of method sh*
791
+
792
+ +----+--------+-----------+
793
+ |Name|Type |Description|
794
+ +====+========+===========+
795
+ |log |TyLogger|Logger |
796
+ +----+--------+-----------+
797
+
798
+ cfg\_.py
799
+ ========
800
+
801
+ The Base module cfg\_.py contains a single static class ``Cfg_``.
802
+
803
+ Class Cfg\_
804
+ -----------
805
+
806
+ The static class ``Cfg_`` contains the subsequent static variables and methods
807
+
808
+ Static Variables
809
+ ^^^^^^^^^^^^^^^^
810
+
811
+ .. Static-variables-of-Cfg_-label:
812
+ .. table:: *Static Variables of Cfg_*
813
+
814
+ +----+-----+-------+--------------------+
815
+ |Name|Type |Default|Description |
816
+ +====+=====+=======+====================+
817
+ |cfg |TyDic|None |Configuration object|
818
+ +----+-----+-------+--------------------+
819
+
820
+ Methods
821
+ ^^^^^^^
822
+
823
+ .. Methods-of-class-Cfg_-label:
824
+ .. table:: *Methods of class Cfg_*
825
+
826
+ +----+------+-----------------------------------+
827
+ |Name|Type |Description |
828
+ +====+======+===================================+
829
+ |sh |class |read pacmod yaml file into class |
830
+ | | |variable cls.dic and return cls.cfg|
831
+ +----+------+-----------------------------------+
832
+
833
+ Method: sh
834
+ ^^^^^^^^^^
835
+
836
+ Parameter
837
+ """""""""
838
+
839
+ .. Parameter-of-method-init-label:
840
+ .. table:: *Parameter of method sh*
841
+
842
+ +--------+--------+-----------------+
843
+ |Name |Type |Description |
844
+ +========+========+=================+
845
+ |cls |class |Current class |
846
+ +--------+--------+-----------------+
847
+ |log |TyLogger|Logger |
848
+ +--------+--------+-----------------+
849
+ |d_pacmod|TyDic |pacmod dictionary|
850
+ +--------+--------+-----------------+
851
+
852
+ Return Value
853
+ """"""""""""
854
+
855
+ .. Return-values-of-method-sh-label:
856
+ .. table:: *Return values of method sh*
857
+
858
+ +-------+-----+-----------+
859
+ |Name |Type |Description|
860
+ +=======+=====+===========+
861
+ |cls.cfg|TyDic| |
862
+ +-------+-----+-----------+
863
+
864
+ Base Modul exit\_.py
865
+ ====================
866
+
867
+ The Base module exit\_.py contains a single static class ``Exit_``.
868
+
869
+ class Exit\_
870
+ ------------
871
+
872
+ The static Class ``Exit_`` contains the subsequent static variables and methods.
873
+
874
+ Static Variables
875
+ ^^^^^^^^^^^^^^^^
876
+
877
+ .. Static variables-of-class-Exit_-label:
878
+ .. table:: *Static variables of class Exit_*
879
+
880
+ +--------------+------+-------+---------------------+
881
+ |Name |Type |Default|Description |
882
+ +==============+======+=======+=====================+
883
+ |sw_init |TyBool|False |initialisation switch|
884
+ +--------------+------+-------+---------------------+
885
+ |sw_critical |TyBool|False |critical switch |
886
+ +--------------+------+-------+---------------------+
887
+ |sw_stop |TyBool|False |stop switch |
888
+ +--------------+------+-------+---------------------+
889
+ |sw_interactive|TyBool|False |interactive switch |
890
+ +--------------+------+-------+---------------------+
891
+
892
+ Methods
893
+ ^^^^^^^
894
+
895
+ .. Methods-of-class-Exit_-label:
896
+ .. table:: *Methods of class Exit_*
897
+
898
+ +----+------+------------------------------------+
899
+ |Name|Method|Description |
900
+ +====+======+====================================+
901
+ |init|class |initialise static variables of class|
902
+ | | |if they are not allready initialized|
903
+ +----+------+------------------------------------+
904
+ |sh |class |show (return) class |
905
+ +----+------+------------------------------------+
906
+
907
+ Method: init
908
+ ^^^^^^^^^^^^
909
+
910
+ Parameter
911
+ """""""""
912
+
913
+ .. Parameter-of-method-init-label:
914
+ .. table:: *Parameter of method init*
915
+
916
+ +---------+-----+-----------------+
917
+ |Name |Type |Description |
918
+ +=========+=====+=================+
919
+ |cls |class|Current class |
920
+ +---------+-----+-----------------+
921
+ |\**kwargs|TyAny|Keyword arguments|
922
+ +---------+-----+-----------------+
923
+
924
+ Method: sh
925
+ ^^^^^^^^^^
926
+
927
+ Parameter
928
+ """""""""
929
+
930
+ .. Parameter-of-method-sh-label:
931
+ .. table:: *Parameter of method sh*
932
+
933
+ +---------+-----+-----------------+
934
+ |Name |Type |Description |
935
+ +=========+=====+=================+
936
+ |cls |class|Current class |
937
+ +---------+-----+-----------------+
938
+ |\**kwargs|TyAny|Keyword arguments|
939
+ +---------+-----+-----------------+
940
+
941
+ Return Value
942
+ """"""""""""
943
+
944
+ .. Return-values-of-method-sh-label:
945
+ .. table:: *Return values of method sh*
946
+
947
+ +----+-----+-------------+
948
+ |Name|Type |Description |
949
+ +====+=====+=============+
950
+ |cls |class|Current class|
951
+ +----+-----+-------------+
952
+
953
+ Module log\_.py
954
+ ===============
955
+
956
+ The Base module log\_.py contains a single static class ``Log_``.
957
+
958
+ Class Log\_
959
+ -----------
960
+
961
+ The static Class ``Log_`` contains the subsequent static variables and methods.
962
+
963
+ Static Variables
964
+ ^^^^^^^^^^^^^^^^
965
+
966
+ .. Static-variables-of-class-Log_-label:
967
+ .. table:: *Static variables of class Log_*
968
+
969
+ +--------+--------+---------------------------------+---------------------+
970
+ |Name |Type |Default |Description |
971
+ +========+========+=================================+=====================+
972
+ |sw_init |TyBool |False |initialisation switch|
973
+ +--------+--------+---------------------------------+---------------------+
974
+ |log |TyLogger|logging.getLogger('dummy_logger')|Logger |
975
+ +--------+--------+---------------------------------+---------------------+
976
+ |username|TyStr |psutil.Process().username() |current username |
977
+ +--------+--------+---------------------------------+---------------------+
978
+
979
+ Methods
980
+ ^^^^^^^
981
+
982
+ .. Methods-of-class-Log_-label:
983
+ .. table:: *Methods of class Log_*
984
+
985
+ +------+------+-------------------------------------+
986
+ |Name |Method|Description |
987
+ +======+======+=====================================+
988
+ |init |class |initialise static variables of class |
989
+ | | |if they are not allready initialized.|
990
+ +------+------+-------------------------------------+
991
+ |sh_cfg|class |Read configuration template into |
992
+ | | |configuration dictionary and return |
993
+ | | |changed configuration dictionary. |
994
+ +------+------+-------------------------------------+
995
+ |sh |class |show (return) current class |
996
+ +------+------+-------------------------------------+
997
+
998
+ Method: init
999
+ ^^^^^^^^^^^^
1000
+
1001
+ Parameter
1002
+ """""""""
1003
+
1004
+ .. Parameter-of-method-init-label:
1005
+ .. table:: *Parameter of method init*
1006
+
1007
+ +---------+-----+-------------------+
1008
+ |Name |Type |Description |
1009
+ +=========+=====+===================+
1010
+ |cls |class|Current class |
1011
+ +---------+-----+-------------------+
1012
+ |com |class|Communication class|
1013
+ +---------+-----+-------------------+
1014
+ |\**kwargs|TyAny|Keyword arguments |
1015
+ +---------+-----+-------------------+
1016
+
1017
+ Method sh_cfg
1018
+ ^^^^^^^^^^^^^
1019
+
1020
+ Parameter
1021
+ """""""""
1022
+
1023
+ .. Parameter-of-method-sh_cfg-label:
1024
+ .. table:: *Parameter of method sh_cfg*
1025
+
1026
+ +---------+-----+-------------------+
1027
+ |Name |Type |Description |
1028
+ +=========+=====+===================+
1029
+ |cls |class|Current class |
1030
+ +---------+-----+-------------------+
1031
+ |com |class|Communication class|
1032
+ +---------+-----+-------------------+
1033
+ |\**kwargs|TyAny|Keyword arguments |
1034
+ +---------+-----+-------------------+
1035
+
1036
+ Return Value
1037
+ """"""""""""
1038
+
1039
+ .. Return-values-of-method-sh-label:
1040
+ .. table:: *Return values of method sh*
1041
+
1042
+ +----+-----+-------------+
1043
+ |Name|Type |Description |
1044
+ +====+=====+=============+
1045
+ |cls |class|Current class|
1046
+ +----+-----+-------------+
1047
+
1048
+ sh (Method of class Log\_)
1049
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^
1050
+
1051
+ Parameter
1052
+ """""""""
1053
+
1054
+ .. Parameter-of-method-sh-label:
1055
+ .. table:: *Parameter of method sh*
1056
+
1057
+ +---------+-----+-----------------+
1058
+ |Name |Type |Description |
1059
+ +=========+=====+=================+
1060
+ |cls |class|Current class |
1061
+ +---------+-----+-----------------+
1062
+ |\**kwargs|TyAny|Keyword arguments|
1063
+ +---------+-----+-----------------+
1064
+
1065
+ Return Value
1066
+ """"""""""""
1067
+
1068
+ .. Return-values-of-method-sh-label:
1069
+ .. table:: *Return values of method sh*
1070
+
1071
+ +----+-----+-------------+
1072
+ |Name|Type |Description |
1073
+ +====+=====+=============+
1074
+ |cls |class|Current class|
1075
+ +----+-----+-------------+
1076
+
1077
+ Utility Modules
1078
+ ***************
1079
+
1080
+ Overview
1081
+ ========
1082
+
1083
+ .. Utility-Modules-label:
1084
+ .. table:: *Utility Modules*
1085
+
1086
+ +-----------+--------------------------------+
1087
+ |Name |Functionality |
1088
+ +===========+================================+
1089
+ |aoeqstmt.py|Manage array of equate statement|
1090
+ +-----------+--------------------------------+
1091
+ |date.py |Manage dates |
1092
+ +-----------+--------------------------------+
1093
+ |doeq.py |Manage dictionary of equates |
1094
+ +-----------+--------------------------------+
1095
+ |fnc.py |Manage functions |
1096
+ +-----------+--------------------------------+
1097
+ |pacmod.py |Manage Packages and Modules |
1098
+ +-----------+--------------------------------+
1099
+ |str.py |Manage strings |
1100
+ +-----------+--------------------------------+
1101
+
1102
+ Module aoeqstmt.py
1103
+ ==================
1104
+
1105
+ Classes
1106
+ -------
1107
+
1108
+ .. Classes-of-module-aoeqstmt.py-label:
1109
+ .. table:: *Classes of Module aoeqstmt.py*
1110
+
1111
+ +-------------------------------------------------------+
1112
+ |Static Class |
1113
+ +---------+---------------------------------------------+
1114
+ |Name |Description |
1115
+ +=========+=============================================+
1116
+ |AoEqStmt |Manage Commandline Arguments as Equate String|
1117
+ +---------+---------------------------------------------+
1118
+
1119
+ Class AoEqStmt
1120
+ --------------
1121
+
1122
+ The static Class ``AoEqStmt`` contains the subsequent variables and methods
1123
+
1124
+ Variables
1125
+ ^^^^^^^^^
1126
+
1127
+ .. Variables-of-class-AoEqStmt-label:
1128
+ .. table:: *Variables of class AoEqStmt*
1129
+
1130
+ +----------------------------------------------------+
1131
+ |Static Variables |
1132
+ +---------------+------+-------+---------------------+
1133
+ |Name |Type |Default|Description |
1134
+ +===============+======+=======+=====================+
1135
+ |sw_init |TyBool|False |initialisation switch|
1136
+ +---------------+------+-------+---------------------+
1137
+ |httpmod |TyDic |None |http modus |
1138
+ +---------------+------+-------+---------------------+
1139
+ |sw_replace_keys|TnBool|False |replace keys switch |
1140
+ +---------------+------+-------+---------------------+
1141
+ |keys |TnArr |None |Keys array |
1142
+ +---------------+------+-------+---------------------+
1143
+ |reqs |TyDic |None |Requests dictionary |
1144
+ +---------------+------+-------+---------------------+
1145
+ |app |TyDic |None |Appliction dictionary|
1146
+ +---------------+------+-------+---------------------+
1147
+
1148
+ Methods
1149
+ ^^^^^^^
1150
+
1151
+ .. Methods-of-class-AoEqStmt-label:
1152
+ .. table:: *Methods of class AoEqStmt*
1153
+
1154
+ +--------------+---------------------------------------------------------+
1155
+ |Name |Description |
1156
+ +==============+=========================================================+
1157
+ |_set_by_pacmod|set item "current pacmod dictionary" of equate dictionary|
1158
+ +--------------+---------------------------------------------------------+
1159
+ |_set_by_prof |set item "show profile" of equate dictionary |
1160
+ +--------------+---------------------------------------------------------+
1161
+ |sh |set and show (return) equate dictionary |
1162
+ +--------------+---------------------------------------------------------+
1163
+
1164
+ Method _set_pacmod_curr
1165
+ ^^^^^^^^^^^^^^^^^^^^^^^
1166
+
1167
+ Description
1168
+ """""""""""
1169
+
1170
+ Set item "pacmod_curr" of equate dictionary using item "tenant".
1171
+
1172
+ Parameter
1173
+ """""""""
1174
+
1175
+ .. Parameter-of-method-set_pacmod_curr-label:
1176
+ .. table:: *Parameter of method set_pacmod_curr*
1177
+
1178
+ +--------+-----+---------------------+
1179
+ |Name |Type |Description |
1180
+ +========+=====+=====================+
1181
+ |d_eq |TyDic|Dictionary of Equates|
1182
+ +--------+-----+---------------------+
1183
+ |root_cls|class|Root Class |
1184
+ +--------+-----+---------------------+
1185
+
1186
+ Method _set_sh_prof
1187
+ ^^^^^^^^^^^^^^^^^^^
1188
+
1189
+ Description
1190
+ """""""""""
1191
+
1192
+ Set item "sh_prof" of equate dictionary using profile initialiation function.
1193
+
1194
+ Parameter
1195
+ """""""""
1196
+
1197
+ .. Parameter-of-Method-set_sh_prof-label:
1198
+ .. table:: *Parameter of method set_sh_prof*
1199
+
1200
+ +-------+------+-------------------------------+
1201
+ |Name |Type |Description |
1202
+ +=======+======+===============================+
1203
+ |d_eq |TyDic |Dictionary of Equates |
1204
+ +-------+------+-------------------------------+
1205
+ |sh_prof|TyCall|Profile initialisation function|
1206
+ +-------+------+-------------------------------+
1207
+
1208
+ Method: sh
1209
+ ^^^^^^^^^^
1210
+
1211
+ Description
1212
+ """""""""""
1213
+
1214
+ Set and show (return) equate dictionary
1215
+
1216
+ Parameter
1217
+ """""""""
1218
+
1219
+ .. Parameter-of-method-sh-label:
1220
+ .. table:: *Parameter of method sh*
1221
+
1222
+ +-------+------+-------------------------------+
1223
+ |Name |Type |Description |
1224
+ +=======+======+===============================+
1225
+ |a_s_eq |TyDic |Dictionary of Equates |
1226
+ +-------+------+-------------------------------+
1227
+ |sh_prof|TyCall|Profile initialisation function|
1228
+ +-------+------+-------------------------------+
1229
+
1230
+ doeq.py
1231
+ =======
1232
+
1233
+ The Module ``doeq.py`` contains a single static class ``DoEq``.
1234
+
1235
+ Module doeq.py
1236
+ --------------
1237
+
1238
+ The static class ``DoEq`` is used to manage Commandline Arguments of Equate Strings.
1239
+
1240
+ Methods
1241
+ ^^^^^^^
1242
+
1243
+ .. Methods-of-class-DoEq-label:
1244
+ .. table:: *Methods of class DoEq*
1245
+
1246
+ +--------+--------------------------------------------------+
1247
+ |Name |Description |
1248
+ +========+==================================================+
1249
+ |sh_value|Show value of equate string provided by single |
1250
+ | |command line argument |
1251
+ +--------+--------------------------------------------------+
1252
+ |sh_d_eq |Show Dictionary created by parsing array of equate|
1253
+ | |strings provided by commandline arguments |
1254
+ +--------+--------------------------------------------------+
1255
+
1256
+ Method: sh_value
1257
+ ^^^^^^^^^^^^^^^^
1258
+
1259
+ Parameter
1260
+ """""""""
1261
+
1262
+ .. Parameter-of-method-sh_value-label:
1263
+ .. table:: *Parameter of method sh_value*
1264
+
1265
+ +-------------+-----+-------------------------------------+
1266
+ |Name |Type |Description |
1267
+ +=============+=====+=====================================+
1268
+ |cls |class|current class |
1269
+ +-------------+-----+-------------------------------------+
1270
+ |key |TyStr|Key of equate string |
1271
+ +-------------+-----+-------------------------------------+
1272
+ |value |TyAny|Value of equate string |
1273
+ +-------------+-----+-------------------------------------+
1274
+ |d_valid_parms|TnDic|Dictionary of valid keys (parameters)|
1275
+ +-------------+-----+-------------------------------------+
1276
+ |cls |class|current class |
1277
+ +-------------+-----+-------------------------------------+
1278
+ |a_s_eq |TyArr|array of equate strings |
1279
+ +-------------+-----+-------------------------------------+
1280
+ |d_valid_parms|TnDic|Dictionary of valid parameter-keys |
1281
+ +-------------+-----+-------------------------------------+
1282
+
1283
+ Return Values
1284
+ """""""""""""
1285
+
1286
+ .. Return-values-of-method-sh_value-label:
1287
+ .. table:: *Return values of method sh_value*
1288
+
1289
+ +-----+-----+----------------------+
1290
+ |Name |Type |Description |
1291
+ +=====+=====+======================+
1292
+ |value|Any |converted Value of the|
1293
+ | | |equate-string |
1294
+ | | |according Value type |
1295
+ | | |d_valid_parms |
1296
+ +-----+-----+----------------------+
1297
+ |d_eq |TnDic|Dictiony of parameter |
1298
+ | | |key, values |
1299
+ +-----+-----+----------------------+
1300
+
1301
+ Utility Module: pacmod.py
1302
+ =========================
1303
+
1304
+ The Utility module pacmod.py contains a single static class ``PacMod``.
1305
+
1306
+ Class PaMmod
1307
+ -------------
1308
+
1309
+ Methods
1310
+ ^^^^^^^
1311
+
1312
+ .. Methods-of-class-Pacmod-label:
1313
+ .. table:: *Methods of class Pacmod*
1314
+
1315
+ +-----------------+-------------------------------------------------+
1316
+ |Name |Description |
1317
+ +=================+=================================================+
1318
+ |sh_d_pacmod |create and show (return) pacmod dictionary |
1319
+ +-----------------+-------------------------------------------------+
1320
+ |sh_path_cfg_yaml |show pacmod file path of the yaml file |
1321
+ | |<pacmod module>.yaml in the data directory of the|
1322
+ | |current module of the current package |
1323
+ +-----------------+-------------------------------------------------+
1324
+ |sh_path_keys_yaml|show pacmod file path type for the yaml file |
1325
+ | |keys.yml in the data directory of the current |
1326
+ | |module of the current pacḱage |
1327
+ +-----------------+-------------------------------------------------+
1328
+ |sh_pacmod_type |show pacmod type directory path |
1329
+ +-----------------+-------------------------------------------------+
1330
+ |sh_file_path |show pacmod file path |
1331
+ +-----------------+-------------------------------------------------+
1332
+ |sh_pattern |show pacmod file path pattern |
1333
+ +-----------------+-------------------------------------------------+
1334
+ |sh_path_cfg_log |show file path of log configuration file |
1335
+ +-----------------+-------------------------------------------------+
1336
+ |sh_d_pacmod |show pacmod dictionary |
1337
+ +-----------------+-------------------------------------------------+
1338
+
1339
+ Method: sh_d_pacmod
1340
+ ^^^^^^^^^^^^^^^^^^^
1341
+
1342
+ Parameter
1343
+ """""""""
1344
+
1345
+ .. Parameter-of-module-sh_d_pacmod-label:
1346
+ .. table:: *Parameter of method sh_d_pacmod*
1347
+
1348
+ +--------+-----+-----------------+
1349
+ |Name |Type |Description |
1350
+ +========+=====+=================+
1351
+ |root_cls|class|root class |
1352
+ +--------+-----+-----------------+
1353
+ |tenant |Any | |
1354
+ +--------+-----+-----------------+
1355
+
1356
+ Method: sh_path_cfg_yaml
1357
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1358
+
1359
+ Parameter
1360
+ """""""""
1361
+
1362
+ .. Parameter-of-module-sh_path_cfg_yaml-of-class-Pacmod-label:
1363
+ .. table:: *Parameter of method sh_path_cfg_yaml*
1364
+
1365
+ +------+-----+-----------------+
1366
+ |Name |Type |Description |
1367
+ +======+=====+=================+
1368
+ |pacmod|TyDic| |
1369
+ +------+-----+-----------------+
1370
+
1371
+ Method: sh_path_cfg_yaml
1372
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1373
+
1374
+ Parameter
1375
+ """""""""
1376
+
1377
+
1378
+ +------+-----+-----------------+
1379
+ |Name |Type |Description |
1380
+ +======+=====+=================+
1381
+ |pacmod|TyDic| |
1382
+ +------+-----+-----------------+
1383
+ |type\_|Tystr| |
1384
+ +------+-----+-----------------+
1385
+
1386
+ Method: sh_path_cfg_yaml
1387
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1388
+
1389
+ Parameter
1390
+ """""""""
1391
+
1392
+ .. Parameter-of-module-sh_path_cfg_yaml-label:
1393
+ .. table:: *Parameter of method sh_path_cfg_yaml*
1394
+
1395
+ +------+-----+-----------------+
1396
+ |Name |Type |Description |
1397
+ +======+=====+=================+
1398
+ |pacmod|TyDic| |
1399
+ +------+-----+-----------------+
1400
+ |type\_|str | |
1401
+ +------+-----+-----------------+
1402
+
1403
+ Method: sh_path_cfg_yaml
1404
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1405
+
1406
+ Parameter
1407
+ """""""""
1408
+
1409
+ .. Parameter-of-module-sh_path_cfg_yaml-label:
1410
+ .. table:: *Parameter of method sh_path_cfg_yaml*
1411
+
1412
+ +---------+-----+-----------------+
1413
+ |Name |Type |Description |
1414
+ +=========+=====+=================+
1415
+ |cls |class|current class |
1416
+ +---------+-----+-----------------+
1417
+ |pacmod |TyDic| |
1418
+ +---------+-----+-----------------+
1419
+ |type\_ |TyStr| |
1420
+ +---------+-----+-----------------+
1421
+ |suffix |TyStr| |
1422
+ +---------+-----+-----------------+
1423
+ |pid |TyStr| |
1424
+ +---------+-----+-----------------+
1425
+ |ts |TyAny| |
1426
+ +---------+-----+-----------------+
1427
+ |\**kwargs|TyAny|keyword arguments|
1428
+ +---------+-----+-----------------+
1429
+
1430
+ Method: sh_path_cfg_yaml
1431
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1432
+
1433
+ Parameter
1434
+ """""""""
1435
+
1436
+ .. Parameter-of-method-sh_path_cfg_yaml-label:
1437
+ .. table:: *Parameter of method sh_path_cfg_yaml*
1438
+
1439
+ +---------+-----+-----------------+
1440
+ |Name |Type |Description |
1441
+ +=========+=====+=================+
1442
+ |pacmod |TyDic| |
1443
+ +---------+-----+-----------------+
1444
+ |type\_ |TyStr| |
1445
+ +---------+-----+-----------------+
1446
+ |suffix |TyStr| |
1447
+ +---------+-----+-----------------+
1448
+ |\**kwargs|TyAny|keyword arguments|
1449
+ +---------+-----+-----------------+
1450
+
1451
+ Method: sh_path_cfg_yaml
1452
+ ^^^^^^^^^^^^^^^^^^^^^^^^
1453
+
1454
+ Parameter
1455
+ """""""""
1456
+
1457
+ .. Parameter-of-method-sh_path_cfg_yaml-label:
1458
+ .. table:: *Parameter of method sh_path_cfg_yaml*
1459
+
1460
+ +--------+-----+-----------------+
1461
+ |Name |Type |Description |
1462
+ +========+=====+=================+
1463
+ |pacmod |TnDic| |
1464
+ +--------+-----+-----------------+
1465
+ |filename|TyStr| |
1466
+ +--------+-----+-----------------+
1467
+
1468
+ Method: sh_d_pacmod
1469
+ ^^^^^^^^^^^^^^^^^^^
1470
+
1471
+ Parameter
1472
+ """""""""
1473
+
1474
+ .. Parameter-of-method-sh_d_pacmod-label:
1475
+ .. table:: *Parameter of method sh_d_pacmod*
1476
+
1477
+ +---------+-----+-----------------+
1478
+ |Name |Type |Description |
1479
+ +=========+=====+=================+
1480
+ |cls |class|current class |
1481
+ +---------+-----+-----------------+
1482
+ |\**kwargs|TyAny|keyword arguments|
1483
+ +---------+-----+-----------------+
1484
+
1485
+ I/O Control Modules
1486
+ *******************
1487
+
1488
+ Module jinja2\_.py
1489
+ ==================
1490
+
1491
+ The Module ``jinja2_.py`` contains the single static class Jinja2
1492
+
1493
+ Class: Jinja2
1494
+ -------------
1495
+
1496
+ The static Class ``Jinja2`` provides I/O Control methods for Jinja2 files;
1497
+ it contains the subsequent methods.
1498
+
1499
+ Methods
1500
+ ^^^^^^^
1501
+
1502
+ .. Methods-of-class-Jinja2-label:
1503
+ .. table:: *Methods of class Jinja2*
1504
+
1505
+ +-------------+------------------------------+
1506
+ |Name |Description |
1507
+ +=============+==============================+
1508
+ |read |Read log file path with jinja |
1509
+ +-------------+------------------------------+
1510
+ |read_template|Read log file path with jinja2|
1511
+ +-------------+------------------------------+
1512
+
1513
+ Method: read
1514
+ ^^^^^^^^^^^^
1515
+
1516
+ Parameter
1517
+ """""""""
1518
+
1519
+ .. Parameter-of-method-read-label:
1520
+ .. table:: *Parameter of method read*
1521
+
1522
+ +--------+-----+---------------+
1523
+ |Name |Type |Description |
1524
+ +========+=====+===============+
1525
+ |pacmod |TnDic| |
1526
+ +--------+-----+---------------+
1527
+ |filename|str | |
1528
+ +--------+-----+---------------+
1529
+
1530
+ Method read_template
1531
+ ^^^^^^^^^^^^^^^^^^^^
1532
+
1533
+ Parameter
1534
+ """""""""
1535
+
1536
+ .. Parameter-of-method-read-template-label:
1537
+ .. table:: *Parameter of method read template*
1538
+
1539
+ +--------+-----+---------------+
1540
+ |Name |Type |Description |
1541
+ +========+=====+===============+
1542
+ |pacmod |TnDic| |
1543
+ +--------+-----+---------------+
1544
+ |filename|TnAny| |
1545
+ +--------+-----+---------------+
1546
+
1547
+ Module yaml\_.py
1548
+ ================
1549
+
1550
+ The Module ``yaml_.py`` contains one static class ``Yaml``
1551
+
1552
+ Class Yaml
1553
+ ----------
1554
+
1555
+ The static Class ``Yaml`` provides I/O Control functions for Yaml files;
1556
+ it contains the subsequent methods
1557
+
1558
+ Methods
1559
+ ^^^^^^^
1560
+
1561
+ .. Methods-of-class-Yaml-label:
1562
+ .. table:: *Methods of class Yaml*
1563
+
1564
+ +----+------------------------------------------------------+
1565
+ |Name|Description |
1566
+ +====+======================================================+
1567
+ |load|Load yaml string into any object using yaml loader. |
1568
+ | |Default is yaml.safeloader |
1569
+ +----+------------------------------------------------------+
1570
+ |read|Read yaml file path into any object using yaml loader.|
1571
+ | |Default loader is yaml.safeloader |
1572
+ +----+------------------------------------------------------+
1573
+
1574
+ Method load
1575
+ ^^^^^^^^^^^
1576
+
1577
+ Parameter
1578
+ """""""""
1579
+
1580
+ .. Parameter-of-method-load-label:
1581
+ .. table:: *Parameter of method load*
1582
+
1583
+ +------+-----+--------------+
1584
+ |Name |Type |Description |
1585
+ +======+=====+==============+
1586
+ |string|TyStr| |
1587
+ +------+-----+--------------+
1588
+ |loader|TyStr| |
1589
+ +------+-----+--------------+
1590
+
1591
+ Method read
1592
+ ^^^^^^^^^^^
1593
+
1594
+ Parameter
1595
+ """""""""
1596
+
1597
+ .. Parameter-of-method-read-label:
1598
+ .. table:: *Parameter of method read*
1599
+
1600
+ +------+-----+--------------+
1601
+ |Name |Type |Description |
1602
+ +======+=====+==============+
1603
+ |path |TyStr| |
1604
+ +------+-----+--------------+
1605
+ |loader|TyStr| |
1606
+ +------+-----+--------------+
1607
+
1608
+ Appendix
1609
+ ********
1610
+
1611
+ .. contents:: **Table of Content**