Implemented dictionary support for plot title kwarg. Allows user to modify title location, alignment, size, and weight.

Author: teddyrowan

src/mplfinance/_version.py

@@ -1,5 +1,5 @@
 
-version_info = (0, 12, 7, 'alpha', 0)
+version_info = (0, 12, 7, 'alpha', 1)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
 

src/mplfinance/plotting.py

@@ -148,10 +148,7 @@ def _valid_plot_kwargs():
                                         'Validator'   : lambda value: mcolors.is_color_like(value) },
 
         'title'                     : { 'Default'     : None, # Figure Title
-                                        'Validator'   : lambda value: isinstance(value,str) },
-
-        'title_lightweight'         : { 'Default'     : None, # Semibold or light title weight
-                                        'Validator'   : lambda value: isinstance(value,bool) },
+                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
 
         'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
                                         'Validator'   : lambda value: isinstance(value,str) },
@@ -627,21 +624,27 @@ def plot( data, **kwargs ):
         if external_axes_mode:
             volumeAxes.tick_params(axis='x',rotation=xrotation)
             volumeAxes.xaxis.set_major_formatter(formatter)
-
+    
     if config['title'] is not None:
         if config['tight_layout']:
             # IMPORTANT: 0.89 is based on the top of the top panel
             #            being at 0.18+0.7 = 0.88.  See _panels.py
             # If the value changes there, then it needs to change here.
-            if config['title_lightweight']:
-                fig.suptitle(config['title'],size='x-large',weight='light', va='bottom', y=0.89)
-            else:
-                fig.suptitle(config['title'],size='x-large',weight='semibold', va='bottom', y=0.89)
+            title_kwargs = dict(size='x-large',weight='semibold', va='bottom', y=0.89)
         else:
-            if config['title_lightweight']:
-                fig.suptitle(config['title'], size='x-large',weight='light', va='center')
+            title_kwargs = dict(size='x-large',weight='semibold', va='center')
+        if isinstance(config['title'],dict):
+            title_dict = config['title']
+            if 'title' not in title_dict:
+                raise ValueError('Must have "title" entry in title dict')
             else:
-                fig.suptitle(config['title'],size='x-large',weight='semibold', va='center')
+                title = title_dict['title']
+                del title_dict['title']
+            title_kwargs.update(title_dict)  # allows override default values set by mplfinance above
+        else:
+            title = config['title']      # config['title'] is a string
+        fig.suptitle(title,**title_kwargs)
+    
 
     if config['axtitle'] is not None:
         axA1.set_title(config['axtitle'])