v0.1.7, release, stable

Author: saner99

ctprint/ctprint/__init__.py

@@ -0,0 +1 @@
+from ctprint.ctprint import ctprint, ctp, ctdecode, cterr, ctlog

lib/tcprint.py ctprint/ctprint/ctprint.pylib/tcprint.py renamed to ctprint/ctprint/ctprint.py

@@ -1,12 +1,12 @@
-import sys
-import traceback  # for tcprint.err()
-# colorama определяет ansi-коды, изменяет output, добавляет синтаксис. кроссплатформенная
+import sys  # for ctprint.err()
+import traceback  # for ctprint.err()
+# colorama - makes ANSI escape character sequences (for producing colored terminal text and cursor positioning) work under MS Windows.
 from colorama import init, Fore, Back
-from help_message import help_message as h_m  # класс со стрингами
-# colorama autoreset автоматически возвращает к дефолтным системным параметрам
+from .help_message import h_m  # экземпляр класса со стрингами
+# colorama autoreset=True - automatically back to default color
 init(autoreset=True)
 
-# from tcprint import tcp, tdecode, terr, tlog # tcprint imports
+# from ctprint import ctp, ctdecode, cterr, ctlog # ctprint imports
 
 
 tags: dict[str, dict[str, str]] = {
@@ -29,15 +29,15 @@
 }
 
 
-class tcprint():
+class ctprint():
 
-    def __init__(self, string: str = None) -> None:
+    def __init__(self, *strings: str) -> None:
         self.tags = tags
 
-        if string:
-            print(self.decode(string))
+        if strings:
+            print(self.decode(*strings))
 
-    def decode(self, *strings: str) -> str:  # *args for tcprint.decode(string1, string2, string3)
+    def decode(self, *strings: str) -> str:  # *args for ctprint.decode(string1, string2, string3)
 
         result_string = ''
         for string in strings:
@@ -49,14 +49,14 @@ def decode(self, *strings: str) -> str:  # *args for tcprint.decode(string1, str
             result_string += string  # натягивает стринги друг на друга
         return result_string
 
-    def err(self, exception=None, comment:any='') -> None:
+    def err(self, exception=None, comment: any = '') -> None:
         if comment:
             comment = f" comment: {str(comment)} "
         exc_type, exc_value, exc_traceback = sys.exc_info()
         # берёт тб последней ошибки. хорошо бы добавить проверку по exception
         ex_tb = traceback.extract_tb(exc_traceback, limit=1)[0]
 
-        print(self.decode(  # exception не проходит через decode(), чтобы в exception были видны теги
+        print(self.decode(  # the exception is not decoded so that the tags are visible in it
             f"\n<bw>>>>>>>[Error]>>>> in: {ex_tb.name}    line: {ex_tb.lineno} -> />   <red>{ex_tb.line}   <bw>>{comment}<plain><white>"), str(exception), self.decode(f"\n<bg_white><black>[file]>> <plain>   {ex_tb.filename}"))
 
     def log(self, **vars) -> None:
@@ -66,44 +66,40 @@ def log(self, **vars) -> None:
 
     def help() -> None:
         help_msg = h_m.help_info + h_m.description + h_m.tags + h_m.methods
-        print(tcprint().decode(help_msg).replace(
-            'PRE', ''))  # PRE - разделяет теги
+        print(ctprint().decode(help_msg).replace(
+            'PRE', ''))  # PRE - separates the tags
 
-        if input(tdecode("""
+        if input(ctdecode("""
     <magenta>Press <bw> Y /><magenta> if u wanna see short live example: />""")).lower() == 'y':
 
-            print(tcprint().decode(h_m.test_example).replace('PRE', ''))
-            tcprint("<info> def test() output:/>\n")
+            print(ctprint().decode(h_m.test_example).replace('PRE', ''))
+            ctprint("<info> def test() output:/>\n")
             test()
 
-        tcprint(h_m.ending)
+        ctprint(h_m.ending)
 
 
 # for imports
-tcp = tcprint
-terr = tcp().err
-tdecode = tcp().decode
-tlog = tcp().log
+ctp = ctprint
+cterr = ctp().err
+ctdecode = ctp().decode
+ctlog = ctp().log
 
 # example:
 # ./test.py
-# from tcprint import tcp, terr, tdecode
+# from ctprint import ctp, cterr, ctdecode
 
-# tcp.help()  # print help message
+# ctp.help()  # print help message
 
 
 def test():  # usage example
 
     try:
 
-        tcp('<bw> b&w !!! /><magenta> magenta <plain> plain <green>green />etc')
+        ctp('<bw> b&w !!! /><magenta> magenta <plain> plain <green>green />etc')
         1/0  # for error's view example
 
     except Exception as _ex:
 
-        # terr(Exception, your_comment)
-        terr(_ex, [{'excepted': 3.1415926535}])
-
-
-if __name__ == '__main__':
-    tcp.help()
+        # cterr(Exception, your_comment)
+        cterr(_ex, [{'excepted': 3.1415926535}])

lib/help_message.py ctprint/ctprint/help_message.pylib/help_message.py renamed to ctprint/ctprint/help_message.py

@@ -1,15 +1,15 @@
-# from tcprint import tcp, tdecode, terr, tlog
+# from ctprint import ctp, ctdecode, cterr, ctlog
 
 
 class help_message():
 
     help_info: str = f"""
-<bw>>>>>>>[ tcprint.help() ]>>>> <plain><magenta> Help info: <plain>
+<bw>>>>>>>[ ctprint.help() ]>>>> <plain><magenta> Help info: <plain>
 <magenta>{'-'*40}/>"""
 
     description = f"""
-- All tcprint opening tags are always enclosed in angle brackets: '<magenta>< ><plain>'
-- tcprint have ONLY ONE CLOSING TAG - <magenta>/PRE>/> (reset all formating to sys default)
+- All ctprint opening tags are always enclosed in angle brackets: '<magenta>< ><plain>'
+- ctprint have ONLY ONE CLOSING TAG - <magenta>/PRE>/> (reset all formating to sys default)
 - for RESET FORMATING to default u can use tags <magenta><PREreset><plain> and <magenta><PREbg_reset><plain>.
 Also u can format text to white and background to black using <magenta><PREplain><plain>
 """
@@ -68,23 +68,23 @@ class help_message():
         """
     methods: str = f"""
     <magenta>{'-'*24}
-    Logging tcprint methods:
+    Logging ctprint methods:
     {'-'*24}/>
-    <magenta>from<red> tcprint <magenta>import<red> tcp/>, <red>tdecode/>, <red>terr/>, <red>tlog/> # for example
+    <magenta>from<red> ctprint <magenta>import<red> ctp/>, <red>ctdecode/>, <red>cterr/>, <red>ctlog/> # for example
         
-        <blue>tcp/>(<green>'<PREbw>text\t\PRE>'/>)/> output:
+        <blue>ctp/>(<green>'<PREbw>text\t\PRE>'/>)/> output:
         <bw>text\t/>
         
-        <blue>tdecode/>(<green>'<PREbw>text\t\PRE>'/>)/> return-> <bw>text\t/>
+        <blue>ctdecode/>(<green>'<PREbw>text\t\PRE>'/>)/> return-> <bw>text\t/>
         
-        <blue>terr/>(<yellow>Exception/>, <green>'your comment'/>)/> error message output:
+        <blue>cterr/>(<yellow>Exception/>, <green>'your comment'/>)/> error message output:
 <bw>>>>>>>[Error]>>>> in: <name>    line: <line index> ->/><red>    <the line's code>   <bw>> comment: your comment /> <excaption>
 <bw>[file]>> />   <path to file> 
 
         <red>var1/>=<yellow>0
         <red>var2/>=<green>'text'
         <red>var3/>="""+"""{<green>'dict_key','<PREbw>text/PRE>'/>}"""+"""
-        <blue>tlog/>(<red>var1 = <red>var1/>, <red>var2/> = <red>var2/> , <red>var3/> = <red>var3/>)/> log message output:
+        <blue>ctlog/>(<red>var1 = <red>var1/>, <red>var2/> = <red>var2/> , <red>var3/> = <red>var3/>)/> log message output:
  <bw>var1   :/> 0
  <bw>var2   :/> text
  <bw>var3_dict_key  :/> {'dict_key','<PREbw>text/PRE>'}
@@ -94,21 +94,23 @@ class help_message():
 
     test_example: str = """
 />#./test.py
-<magenta>from<red> tcprint <magenta>import<red> tcp/>, <red>tdecode/>, <red>terr/>, <red>tlog/>
+<magenta>from<red> ctprint <magenta>import<red> ctp/>, <red>ctdecode/>, <red>cterr/>, <red>ctlog/>
 
-# tcp.help()  # print help message
+# ctp.help()  # print help message
 
 <magenta>def/> <blue>test/>():
 
     <magenta>try/>:
     
-        <blue>tcp/>(<green>'<PREbw> b&w !!! /PRE><PREmagenta> magenta <PREplain> plain <PREgreen>green /PRE>etc'/>)
+        <blue>ctp/>(<green>'<PREbw> b&w !!! /PRE><PREmagenta> magenta <PREplain> plain <PREgreen>green /PRE>etc'/>)
         <yellow>1<blue>/<yellow>0/>  # for error's view example
         
     <magenta>except<yellow> Exception<magenta> as <red>_ex/>:
         
-        <blue>terr/>(<red>_ex/>, [{<green>'excepted'/>: <yellow>3.1415926535/>}]) # terr(Exception, your_comment)
+        <blue>cterr/>(<red>_ex/>, [{<green>'excepted'/>: <yellow>3.1415926535/>}]) # cterr(Exception, your_comment)
 
 
 <magenta>if <red>__name__ <blue>==<green> '__main__'/>:
     <blue>test/>()"""
+
+h_m = help_message()

ctprint/tests/__init__.py

@@ -0,0 +1,105 @@
+import sys  # for ctprint.err()
+import traceback  # for ctprint.err()
+# colorama - makes ANSI escape character sequences (for producing colored terminal text and cursor positioning) work under MS Windows.
+from colorama import init, Fore, Back
+from . import test_help_message as h_m  # класс со стрингами
+# colorama autoreset=True - automatically back to default color
+init(autoreset=True)
+
+# from ctprint import ctp, ctdecode, cterr, ctlog # ctprint imports
+
+
+tags: dict[str, dict[str, str]] = {
+
+    'simple_styles': {'<plain>': Fore.WHITE + Back.BLACK,  # white text on black background
+                      '<bw>': Fore.BLACK + Back.WHITE,  # black text on white background
+                      '/>': Fore.RESET + Back.RESET,
+                      '<info>': f'\n{Fore.YELLOW}{Back.BLACK}>>>>>>[Info]>>>>  ',
+                      '<err>': f'\n{Fore.RED}{Back.BLACK}>>>>>>[Error]>>>>  ',
+                      '<bw_info>': f'\n{Fore.BLACK}{Back.WHITE}>>>>>>[Info]>>>>  ',
+                      '<bw_err>': f'\n{Fore.BLACK}{Back.WHITE}>>>>>>[Error]>>>>  '},
+
+    'fore': {'<magenta>': Fore.MAGENTA, '<red>': Fore.RED, '<green>': Fore.GREEN,
+             '<yellow>': Fore.YELLOW, '<blue>': Fore.BLUE, '<cyan>': Fore.CYAN,
+             '<white>': Fore.WHITE, '<black>': Fore.BLACK, '<reset>': Fore.RESET},
+
+    'back': {'<bg_magenta>': Back.MAGENTA, '<bg_red>': Back.RED, '<bg_green>': Back.GREEN,
+             '<bg_yellow>': Back.YELLOW, '<bg_blue>': Back.BLUE, '<bg_cyan>': Back.CYAN,
+             '<bg_white>': Back.WHITE, '<bg_black>': Back.BLACK, '<bg_reset>': Back.RESET}
+}
+
+
+class ctprint():
+
+    def __init__(self, *strings: str) -> None:
+        self.tags = tags
+
+        if strings:
+            print(self.decode(*strings))
+
+    def decode(self, *strings: str) -> str:  # *args for ctprint.decode(string1, string2, string3)
+
+        result_string = ''
+        for string in strings:
+            for tags_dict in self.tags:
+                for tag in self.tags[tags_dict]:
+                    string = string.replace(
+                        tag, self.tags[tags_dict][tag])
+
+            result_string += string  # натягивает стринги друг на друга
+        return result_string
+
+    def err(self, exception=None, comment: any = '') -> None:
+        if comment:
+            comment = f" comment: {str(comment)} "
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        # берёт тб последней ошибки. хорошо бы добавить проверку по exception
+        ex_tb = traceback.extract_tb(exc_traceback, limit=1)[0]
+
+        print(self.decode(  # the exception is not decoded so that the tags are visible in it
+            f"\n<bw>>>>>>>[Error]>>>> in: {ex_tb.name}    line: {ex_tb.lineno} -> />   <red>{ex_tb.line}   <bw>>{comment}<plain><white>"), str(exception), self.decode(f"\n<bg_white><black>[file]>> <plain>   {ex_tb.filename}"))
+
+    def log(self, **vars) -> None:
+
+        for varname, varvalue in vars.items():
+            print(self.decode(f'<bw> {str(varname)} \t:'), str(varvalue))
+
+    def help() -> None:
+        help_msg = h_m.help_info + h_m.description + h_m.tags + h_m.methods
+        print(ctprint().decode(help_msg).replace(
+            'PRE', ''))  # PRE - separates the tags
+
+        if input(ctdecode("""
+    <magenta>Press <bw> Y /><magenta> if u wanna see short live example: />""")).lower() == 'y':
+
+            print(ctprint().decode(h_m.test_example).replace('PRE', ''))
+            ctprint("<info> def test() output:/>\n")
+            test()
+
+        ctprint(h_m.ending)
+
+
+# for imports
+ctp = ctprint
+cterr = ctp().err
+ctdecode = ctp().decode
+ctlog = ctp().log
+
+# example:
+# ./test.py
+# from ctprint import ctp, cterr, ctdecode
+
+# ctp.help()  # print help message
+
+
+def test():  # usage example
+
+    try:
+
+        ctp('<bw> b&w !!! /><magenta> magenta <plain> plain <green>green />etc')
+        1/0  # for error's view example
+
+    except Exception as _ex:
+
+        # cterr(Exception, your_comment)
+        cterr(_ex, [{'excepted': 3.1415926535}])