DataComparerLibrary 0.843__tar.gz → 0.845__tar.gz

{datacomparerlibrary-0.843/src/DataComparerLibrary.egg-info → datacomparerlibrary-0.845}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: DataComparerLibrary
-Version: 0.843
-Summary: For comparing csv-files or 2d-array with csv-file.
+Version: 0.845
+Summary: For comparing csv-files, 2d-array with a csv-file or 2d-arrays. For comparing text-files, text variable with a text-file or text variables. Including a sorting module.
 Home-page: 
 Author: René Philip Zuijderduijn
 Author-email: datacomparerlibrary@outlook.com
@@ -15,8 +15,18 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: summary
 
 ===================
 DataComparerLibrary
@@ -106,8 +116,12 @@ The DataComparerLibrary can be used for:
   quotechar.
 
 
+Comparing Data
+--------------
+
+
 Examples of using the DataComparerLibrary for comparing data in Python
-----------------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there are some examples how to call the methods of the DataComparerLibrary in Python::
 
@@ -122,7 +136,7 @@ Below there are some examples how to call the methods of the DataComparerLibrary
 
 
 Examples of using the DataComparerLibrary keywords for comparing data in Robot Framework
-----------------------------------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there are some examples how to call the keywords of the DataComparerLibrary in Robot Framework::
 
@@ -146,7 +160,7 @@ Below there are some examples how to call the keywords of the DataComparerLibrar
 
 
 Examples comparing Actual Data with Expected Data
--------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there is an example of actual and expected data with some different cases.
 
@@ -185,6 +199,46 @@ Based on current datetime = 2023-09-06 19:04:00  (example):
 +--------------+----------+--------------+---------------------------------+---------+-------------+
 
 
+Comparing Text
+--------------
+
+Examples of using the DataComparerLibrary for comparing text in Python
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Below there are some examples how to call the methods of the DataComparerLibrary in Python::
+
+
+    a = DataComparer
+    a.compare_text_files(self, actual_file, expected_file)
+    a.compare_text_variable_with_text_file(self, actual_text_input, expected_file)
+    a.compare_text_file_with_text_variable(self, actual_file, expected_text_input)
+    a.compare_text_variables(self, actual_text_input, expected_text_input)
+
+
+Examples of using the DataComparerLibrary keywords for comparing text in Robot Framework
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Below there are some examples how to call the keywords of the DataComparerLibrary in Robot Framework::
+
+
+    *** Settings ***
+    Library     DataComparerLibrary
+
+    *** Test Cases ***
+    Testcase_DataComparer
+        Examples
+
+    *** Keywords ***
+    Examples
+        Run Keyword And Continue On Failure  DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Variable With File  ${actual_text_input}  C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text File With Text Variable  C:\\Users\\actual.txt  ${expected_text_input}
+        DataComparerLibrary.Compare Text Variables  ${actual_text_input}  ${expected_text_input}
+
+
 
 DataSorter
 ==========

datacomparerlibrary-0.843/PKG-INFO → datacomparerlibrary-0.845/README.rst

@@ -1,23 +1,3 @@
-Metadata-Version: 2.1
-Name: DataComparerLibrary
-Version: 0.843
-Summary: For comparing csv-files or 2d-array with csv-file.
-Home-page: 
-Author: René Philip Zuijderduijn
-Author-email: datacomparerlibrary@outlook.com
-License: Apache
-Keywords: robotframework testing test-automation datacompare
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: Microsoft :: Windows :: Windows 10
-Classifier: Operating System :: Microsoft :: Windows :: Windows 11
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-
 ===================
 DataComparerLibrary
 ===================
@@ -106,8 +86,12 @@ The DataComparerLibrary can be used for:
   quotechar.
 
 
+Comparing Data
+--------------
+
+
 Examples of using the DataComparerLibrary for comparing data in Python
-----------------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there are some examples how to call the methods of the DataComparerLibrary in Python::
 
@@ -122,7 +106,7 @@ Below there are some examples how to call the methods of the DataComparerLibrary
 
 
 Examples of using the DataComparerLibrary keywords for comparing data in Robot Framework
-----------------------------------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there are some examples how to call the keywords of the DataComparerLibrary in Robot Framework::
 
@@ -146,7 +130,7 @@ Below there are some examples how to call the keywords of the DataComparerLibrar
 
 
 Examples comparing Actual Data with Expected Data
--------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Below there is an example of actual and expected data with some different cases.
 
@@ -185,6 +169,46 @@ Based on current datetime = 2023-09-06 19:04:00  (example):
 +--------------+----------+--------------+---------------------------------+---------+-------------+
 
 
+Comparing Text
+--------------
+
+Examples of using the DataComparerLibrary for comparing text in Python
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Below there are some examples how to call the methods of the DataComparerLibrary in Python::
+
+
+    a = DataComparer
+    a.compare_text_files(self, actual_file, expected_file)
+    a.compare_text_variable_with_text_file(self, actual_text_input, expected_file)
+    a.compare_text_file_with_text_variable(self, actual_file, expected_text_input)
+    a.compare_text_variables(self, actual_text_input, expected_text_input)
+
+
+Examples of using the DataComparerLibrary keywords for comparing text in Robot Framework
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Below there are some examples how to call the keywords of the DataComparerLibrary in Robot Framework::
+
+
+    *** Settings ***
+    Library     DataComparerLibrary
+
+    *** Test Cases ***
+    Testcase_DataComparer
+        Examples
+
+    *** Keywords ***
+    Examples
+        Run Keyword And Continue On Failure  DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Files  C:\\Users\\actual.txt   C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text Variable With File  ${actual_text_input}  C:\\Users\\expected.txt
+        DataComparerLibrary.Compare Text File With Text Variable  C:\\Users\\actual.txt  ${expected_text_input}
+        DataComparerLibrary.Compare Text Variables  ${actual_text_input}  ${expected_text_input}
+
+
 
 DataSorter
 ==========

{datacomparerlibrary-0.843 → datacomparerlibrary-0.845}/setup.py

@@ -22,7 +22,7 @@ with open(join(this_directory, 'src', 'DataComparerLibrary', 'version.py')) as f
 def main():
     setup(name='DataComparerLibrary',
           version=VERSION,
-          description="For comparing csv-files or 2d-array with csv-file.",
+          description="For comparing csv-files, 2d-array with a csv-file or 2d-arrays. For comparing text-files, text variable with a text-file or text variables. Including a sorting module.",
           long_description=README,
           long_description_content_type="text/x-rst",
           url="",
@@ -38,6 +38,8 @@ def main():
               "Programming Language :: Python :: 3.9",
               "Programming Language :: Python :: 3.10",
               "Programming Language :: Python :: 3.11",
+              "Programming Language :: Python :: 3.12",
+              "Programming Language :: Python :: 3.13",                            
           ],
           keywords='robotframework testing test-automation datacompare',
           package_dir={'': 'src'},

datacomparerlibrary-0.845/src/DataComparerLibrary/arraycomparer.py

@@ -0,0 +1,206 @@
+import fnmatch
+import re
+
+from DataComparerLibrary.datetimehandler import DatetimeHandler
+from DataComparerLibrary.report import Report
+from DataComparerLibrary.tools import Tools
+
+class ArrayComparer:
+    def compare_data(self, actual_data, expected_data_including_templates, template_literals_dict):
+        difference_found = False
+        #
+        if actual_data and type(actual_data[0]) is not list:  # only a single row
+            actual_data = [actual_data,]  # add row to tuple of lenght 1
+        #
+        if expected_data_including_templates and type(expected_data_including_templates[0]) is not list:  # only a single row
+            expected_data_including_templates = [expected_data_including_templates,]  # add row to tuple of lenght 1
+
+        number_of_rows_actual_data = len(actual_data)
+        number_of_rows_expected_data = len(expected_data_including_templates)
+
+        number_of_rows = max(number_of_rows_actual_data, number_of_rows_expected_data)
+
+        Report.show_2d_array(self, "Actual data", actual_data, 20)
+        Report.show_2d_array(self, "Expected data", expected_data_including_templates, 20)
+
+        Report().show_header_differences_actual_and_expected_data()
+
+        for row_nr in range(number_of_rows):
+            if row_nr >= number_of_rows_actual_data:
+                difference_found = True
+                if len(expected_data_including_templates[row_nr]) == 0:
+                    Report.show_differences_comparation_result(self, row_nr, 0, "", "", "Row actual data is not PRESENT. Row expected data is EMPTY.")
+                else:
+                    Report.show_differences_comparation_result(self, row_nr, 0, "", expected_data_including_templates[row_nr][0], "Row actual data is not PRESENT.")
+                continue
+            #
+            if row_nr >= number_of_rows_expected_data:
+                difference_found = True
+                if len(actual_data[row_nr]) == 0:
+                    Report.show_differences_comparation_result(self, row_nr, 0, "", "", "Row actual data is EMPTY. Row expected data is not PRESENT.")
+                else:
+                    Report.show_differences_comparation_result(self, row_nr, 0, actual_data[row_nr][0], "", "Row expected data is not PRESENT.")
+                continue
+            #
+            number_of_columns_actual_data   = len(actual_data[row_nr])
+            number_of_columns_expected_data = len(expected_data_including_templates[row_nr])
+
+            number_of_columns = max(number_of_columns_actual_data, number_of_columns_expected_data)
+
+            for column_nr in range(number_of_columns):
+                expected_data_including_date_template = None
+                expected_data_with_wildcard = None
+                skip_exception_rule_used = False
+                #
+                if column_nr >= number_of_columns_actual_data:
+                    difference_found = True
+                    Report.show_differences_comparation_result(self, row_nr, column_nr, "", expected_data_including_templates[row_nr][column_nr], "Column actual data is not PRESENT.")
+                    continue
+                #
+                if column_nr >= number_of_columns_expected_data:
+                    difference_found = True
+                    Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], "", "Column expected data is not PRESENT.")
+                    continue
+                #
+                if actual_data[row_nr][column_nr] != expected_data_including_templates[row_nr][column_nr]:
+                    # Replace literal templates with fixed external strings.
+                    if template_literals_dict:
+                        for i in range(0, len(template_literals_dict)):
+#                           key = list(template_literals_dict.keys())[i]
+#                           value = list(template_literals_dict.values())[i]
+#                           print("key: ", key)
+#                           print("value: ", value)
+                            expected_data_including_templates[row_nr][column_nr] = expected_data_including_templates[row_nr][column_nr].replace(list(template_literals_dict.keys())[i], list(template_literals_dict.values())[i])
+#                           print("actual_data[row_nr][column_nr]: \n", actual_data[row_nr][column_nr])
+#                           print("expected_data_including_templates[row_nr][column_nr]: \n", expected_data_including_templates[row_nr][column_nr])
+
+
+                    # Verify if difference is a matter of string versus integer representation.
+                    if str(actual_data[row_nr][column_nr]) == str(expected_data_including_templates[row_nr][column_nr]):
+                        if isinstance(actual_data[row_nr][column_nr], int) and isinstance(expected_data_including_templates[row_nr][column_nr], str):
+                            difference_found = True
+                            Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "There is a difference between actual and expected data. Actual data is an integer while expected data is a string.")
+                        elif isinstance(actual_data[row_nr][column_nr], str) and isinstance(expected_data_including_templates[row_nr][column_nr], int):
+                            difference_found = True
+                            Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "There is a difference between actual and expected data. Actual data is a string while expected data is an integer.")
+                        continue
+                    #
+                    # If data in actual and expected field doesn't match, check if a template has been used in expected data.
+                    match expected_data_including_templates[row_nr][column_nr].upper():
+                        case "{PRESENT}":
+                            if not actual_data[row_nr][column_nr]:
+                                # No data is present in actual data field.
+                                difference_found = True
+                                Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "Actual data field is not PRESENT")
+                        #
+                        case "{EMPTY}":
+                            if actual_data[row_nr][column_nr]:
+                                # Actual data field is not empty.
+                                difference_found = True
+                                Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "Actual data field is not EMPTY")
+                        #
+                        case "{INTEGER}":
+                            if isinstance(actual_data[row_nr][column_nr], int):
+                                # A real integer.
+                                continue
+                            #
+                            # Verify if string is integer.
+                            if not actual_data[row_nr][column_nr].isdigit():
+                                # Not positive integer field.
+                                difference_found = True
+                                Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "Actual data field is not INTEGER.")
+                        #
+                        case "{SKIP}":
+                            pass
+                        case _:
+                            if "{SKIP}" in expected_data_including_templates[row_nr][column_nr].upper() or "{DATETIME_FORMAT():YYYYMMDDHHMMSSFF6}" in expected_data_including_templates[row_nr][column_nr].upper():
+                                if expected_data_including_templates[row_nr][column_nr].upper() == "{SKIP}":
+                                    # Complete actual data field will be skipped for verification.
+                                    pass
+                                else:
+                                    # Part(s) of the actual data field will be skipped for verification.
+                                    # Replace {SKIP}, ignoring cases, by wildcard *.
+                                    # compiled = re.compile(re.escape("{SKIP}"), re.IGNORECASE)
+                                    # expected_data_with_wildcard = compiled.sub("*", expected_data_including_templates[row_nr][column_nr])
+                                    compiled = re.compile(re.escape("{SKIP}"), re.IGNORECASE)
+                                    compiled2 = re.compile(re.escape("{DATETIME_FORMAT():YYYYMMDDHHMMSSFF6}"), re.IGNORECASE)
+                                    expected_data_with_wildcard = compiled2.sub("*", compiled.sub("*", expected_data_including_templates[row_nr][column_nr]))
+                                    #
+                                    if fnmatch.fnmatch(actual_data[row_nr][column_nr], expected_data_with_wildcard):
+                                        skip_exception_rule_used = True
+                                        continue
+                            #
+                            if expected_data_with_wildcard is None:
+                                # Wildcards not used.
+                                expected_data_including_date_template = expected_data_including_templates[row_nr][column_nr]
+                            else:
+                                expected_data_including_date_template = expected_data_with_wildcard
+                            #
+                            if "{NOW()" in expected_data_including_templates[row_nr][column_nr].upper():
+                                matches = ["{NOW():", "{NOW()+", "{NOW()-"]
+                                if all([x not in expected_data_including_templates[row_nr][column_nr].upper() for x in matches]):
+                                    difference_found = True
+                                    Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "NOW() has been found in expected data field, but format is incorrect.")
+                                    continue
+                                #
+                                expected_data = DatetimeHandler.replace_date_template_in_expected_data(self, expected_data_including_date_template)
+                                #
+                                if expected_data == -1:
+                                    difference_found = True
+                                    Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "NOW() has been found in expected data field, but format is incorrect.")
+                                else:
+                                    if not fnmatch.fnmatch(actual_data[row_nr][column_nr], expected_data):
+                                        # No match despite using of wildcard(s).
+                                        difference_found = True
+                                        Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "Date template format displayed. See also next message line.")
+                                        Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data, "There is a difference between actual and expected data.")
+                                continue
+                                #
+                            elif "{NOT(" in expected_data_including_templates[row_nr][column_nr].upper():
+                                try:
+                                    unwanted_expected_data = ArrayComparer.__get_unwanted_expected_data(self, expected_data_including_date_template)
+                                    #
+                                    if actual_data[row_nr][column_nr] == unwanted_expected_data:
+                                        # Unwanted match.
+                                        difference_found = True
+                                        Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "NOT() template format displayed. See also next message line.")
+                                        Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], unwanted_expected_data, "Actual and expected data are equal. However actual data should NOT be equal to the expected data!!!")
+                                except Exception as exception_message:
+                                    # print(f"An exception occurred: {exception_message}")
+                                    difference_found = True
+                                    Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "NOT() has been found in expected data field, but format is incorrect.")
+                                #
+                            else:
+                                if not skip_exception_rule_used:
+                                    # No exceptions.
+                                    difference_found = True
+                                    Report.show_differences_comparation_result(self, row_nr, column_nr, actual_data[row_nr][column_nr], expected_data_including_templates[row_nr][column_nr], "There is a difference between actual and expected data. No exception rule has been used.")
+                            #
+        if difference_found:
+            print("\n\n\n")
+            raise Exception("There is a difference between actual and expected data. See detail information.")
+        else:
+            print("There are no differences between actual and expected data found.")
+            print("\n\n\n")
+
+        #Report().show_footer_comparation_result()
+
+
+    def __get_unwanted_expected_data(self, expected_data_field_including_date_template):
+        position_open_brace = expected_data_field_including_date_template.find("{NOT(")
+        position_close_brace = expected_data_field_including_date_template.find(")}", position_open_brace)
+        #
+        if position_open_brace == -1:
+            #print("position_open_brace:", position_open_brace)
+            raise Exception()
+        #
+        if position_close_brace == -1:
+            #print("position_close_brace:", position_close_brace)
+            raise Exception()
+        #
+        unwanted_expected_data = expected_data_field_including_date_template[position_open_brace+5:position_close_brace]
+        #
+        if Tools.is_integer(self, unwanted_expected_data):
+            unwanted_expected_data = int(unwanted_expected_data)
+        return unwanted_expected_data
+

datacomparerlibrary-0.845/src/DataComparerLibrary/datacomparer.py

@@ -0,0 +1,135 @@
+# Script for comparing csv-files, 2d-array with a csv-file or 2d-arrays and for comparing text-files, text variable with a text-file or text variables.
+#
+import csv
+import os
+
+from DataComparerLibrary.arraycomparer import ArrayComparer
+
+
+class DataComparer:
+    def compare_data_2d_array_with_file(self, actual_data, expected_file, delimiter_expected_data=",", quotechar_expected_data='"', template_literals_dict=None):
+        self.__check_if_actual_data_is_present(actual_data)
+        self.__check_if_expected_file_is_present(expected_file)        
+        #
+        expected_data = self.__open_csv_input_file(expected_file, delimiter_expected_data, quotechar_expected_data)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_data_file_with_2d_array(self, actual_file, expected_data, delimiter_actual_data=",", quotechar_actual_data='"', template_literals_dict=None):
+        self.__check_if_actual_file_is_present(actual_file)      
+        self.__check_if_expected_data_is_present(expected_data)
+        #
+        actual_data = self.__open_csv_input_file(actual_file, delimiter_actual_data, quotechar_actual_data)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_data_2d_arrays(self, actual_data, expected_data, template_literals_dict=None):
+        self.__check_if_actual_data_is_present(actual_data)
+        self.__check_if_expected_data_is_present(expected_data) 
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_data_files(self, actual_file, expected_file, delimiter_actual_data=",", delimiter_expected_data=",", quotechar_actual_data='"', quotechar_expected_data='"', template_literals_dict=None):
+        self.__check_if_actual_file_is_present(actual_file) 
+        self.__check_if_expected_file_is_present(expected_file)            
+        #
+        actual_data = self.__open_csv_input_file(actual_file, delimiter_actual_data, quotechar_actual_data)
+        expected_data = self.__open_csv_input_file(expected_file, delimiter_expected_data, quotechar_expected_data)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_text_variable_with_text_file(self, actual_text, expected_file, template_literals_dict=None):
+        self.__check_if_actual_data_is_present(actual_text)
+        self.__check_if_expected_file_is_present(expected_file)        
+        #
+        actual_data = self.__split_text_into_textline_array(actual_text)
+        expected_data = self.__split_textfile_into_textline_array(expected_file)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_text_file_with_text_variable(self, actual_file, expected_text, template_literals_dict=None):
+        self.__check_if_actual_file_is_present(actual_file)      
+        self.__check_if_expected_data_is_present(expected_text)
+        #
+        actual_data = self.__split_textfile_into_textline_array(actual_file)
+        expected_data = self.__split_text_into_textline_array(expected_text)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_text_variables(self, actual_text, expected_text, template_literals_dict=None):
+        self.__check_if_actual_data_is_present(actual_text)
+        self.__check_if_expected_data_is_present(expected_text) 
+        #
+        actual_data = self.__split_text_into_textline_array(actual_text)
+        expected_data = self.__split_text_into_textline_array(expected_text)        
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+    def compare_text_files(self, actual_file, expected_file, template_literals_dict=None):
+        self.__check_if_actual_file_is_present(actual_file) 
+        self.__check_if_expected_file_is_present(expected_file)            
+        #
+        actual_data = self.__split_textfile_into_textline_array(actual_file)        
+        expected_data = self.__split_textfile_into_textline_array(expected_file)
+        #
+        ArrayComparer.compare_data(self, actual_data, expected_data, template_literals_dict)
+
+
+
+    def __check_if_actual_data_is_present(self, data):
+        if data == None:
+            raise Exception("Actual Input data unknown.")        
+
+
+    def __check_if_expected_data_is_present(self, data):
+        if data == None:
+            raise Exception("Expected Input data unknown.")        
+
+
+    def __check_if_actual_file_is_present(self, file):
+        if os.path.exists(file):
+            print("actual_file: ", file)
+        else:
+            raise Exception("Actual Input file doesn't exists: ", file)
+
+
+    def __check_if_expected_file_is_present(self, file):
+        if os.path.exists(file):
+            print("expected_file: ", file)    
+        else:
+            raise Exception("Expected Input file doesn't exists: ", file)  
+        
+
+    def __open_csv_input_file(self, input_file, delimiter_data=",", quotechar_data='"'):
+        with open(input_file, mode='rt', encoding='utf-8') as input_file:
+            if len(delimiter_data) == 1:
+                data = list(csv.reader(input_file, delimiter=delimiter_data, quotechar=quotechar_data))
+            else:
+                data = list(csv.reader((line.replace(delimiter_data, chr(255)) for line in input_file), delimiter=chr(255), quotechar=quotechar_data))
+        #
+        return data        
+    
+
+    def __split_text_into_textline_array(self, text):
+        data = []
+        for line in text.split('\n'):
+            data.append(line.strip('\n').split(chr(255)))
+        #
+        return data
+    
+
+    def __split_textfile_into_textline_array(self, input_file):
+        with open(input_file, mode='rt', encoding='utf-8') as input_file:
+            data = []
+            for line in input_file.readlines():
+                data.append(line.strip('\n').split(chr(255)))
+        #
+        return data
+