Adding function to display kwarg table with descriptions

Author: lfenzo

src/mplfinance/_utils.py

@@ -63,6 +63,7 @@ def _check_input(opens, closes, highs, lows):
     if not same_missing:
         raise ValueError('O,H,L,C must have the same missing data!')
 
+
 def _check_and_convert_xlim_configuration(data, config):
     '''
     Check, if user entered `xlim` kwarg, if user entered dates
@@ -1391,6 +1392,31 @@ def _tline_lsq(dfslice,tline_use):
     return _construct_aline_collections(alines, dtix)
 
 
+def _display_formetted_kwargs_table(kwargs_dict: dict):
+    """
+    Displays through stdout the provided kwargs dict along with each
+    one of the discriptions and default values.
+
+    Parameters
+    --------------
+    kwargs_dict : dict
+        Dictionary containing the kwargs in the format (kwarg, default, description)
+    """
+
+    # TODO must be defined the best way to place it in the API 
+    # (either inside the 'plot' method or some other auxiliary
+    # method)
+
+    # prints header of the table
+    print('=' * 120)
+    print("{:<30} {:<15} {}".format('kwarg', 'Default', 'Description'))
+    print('=' * 120)
+
+    for kwarg, info in kwargs_dict.items():
+        print(f'{kwarg:30} {str(info["Default"]):15} {info["Description"]}')
+        print('-' * 120)
+
+
 from matplotlib.ticker import Formatter
 class IntegerIndexDateTimeFormatter(Formatter):
     """