quicklooks 0.0.11__tar.gz

quicklooks-0.0.11/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Alex Breslav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

quicklooks-0.0.11/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include quicklooks/fonts *

quicklooks-0.0.11/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.1
+Name: quicklooks
+Version: 0.0.11
+Summary: quicklook is a Python package for visualizing data quickly using matplotlib.
+Home-page: https://www.linkedin.com/in/alexanderbreslav/
+Author: Alex Breslav
+Author-email: alexdsbreslav@gmail.com
+License: MIT
+Keywords: matplotlib,data-visualization,python
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+Requires-Dist: datetime
+Requires-Dist: seaborn
+
+![example_plot](https://github.com/alexdsbreslav/quicklook/assets/21344372/1eb05d0b-5712-4bda-8500-78a5aa76f110)
+
+# quicklooks
+quicklook is a Python package for visualizing data quickly.  
+Check out the documentation by clicking [here](https://github.com/alexdsbreslav/quicklook/tree/master/how_to_use_quicklook) or by navigating to the folder `how_to_use_quicklook`.
+
+## Why quicklooks?
+Creating attractive, ready-to-share data visualizations takes forever. quickook is a cut-and-paste Python package that does the design work for you and makes it easy to create beautifuly simple data visualizations.
+
+## Who is quicklooks best for?
+quicklook is for any data scientist, product manager, or researcher that knows a little bit of Python and is analyzing their data in a Jupyter Notebook. My goal in writing quicklook was to make data viz more efficient, but in the process, I've also created a package that is easy to use for beginners.
+
+## To install...
+Directions to come; I am currently overhauling the package and will upload to pip for easy installation.
+
+## Documentation
+The [documentation is here](https://github.com/alexdsbreslav/quicklook/tree/master/how_to_use_quicklook).
+
+## Acknowledgments
+quicklook is built using [Matplotlib](https://matplotlib.org/), [NumPy](https://numpy.org/), [Pandas](https://pandas.pydata.org/), [Coolors](https://coolors.co/), and [seaborn](https://seaborn.pydata.org/).
+

quicklooks-0.0.11/README.md

@@ -0,0 +1,21 @@
+![example_plot](https://github.com/alexdsbreslav/quicklook/assets/21344372/1eb05d0b-5712-4bda-8500-78a5aa76f110)
+
+# quicklooks
+quicklook is a Python package for visualizing data quickly.  
+Check out the documentation by clicking [here](https://github.com/alexdsbreslav/quicklook/tree/master/how_to_use_quicklook) or by navigating to the folder `how_to_use_quicklook`.
+
+## Why quicklooks?
+Creating attractive, ready-to-share data visualizations takes forever. quickook is a cut-and-paste Python package that does the design work for you and makes it easy to create beautifuly simple data visualizations.
+
+## Who is quicklooks best for?
+quicklook is for any data scientist, product manager, or researcher that knows a little bit of Python and is analyzing their data in a Jupyter Notebook. My goal in writing quicklook was to make data viz more efficient, but in the process, I've also created a package that is easy to use for beginners.
+
+## To install...
+Directions to come; I am currently overhauling the package and will upload to pip for easy installation.
+
+## Documentation
+The [documentation is here](https://github.com/alexdsbreslav/quicklook/tree/master/how_to_use_quicklook).
+
+## Acknowledgments
+quicklook is built using [Matplotlib](https://matplotlib.org/), [NumPy](https://numpy.org/), [Pandas](https://pandas.pydata.org/), [Coolors](https://coolors.co/), and [seaborn](https://seaborn.pydata.org/).
+

quicklooks-0.0.11/quicklooks/__init__.py

@@ -0,0 +1,28 @@
+'''
+PLACEHOLDER FOR INSTRUCTIONS
+'''
+
+# ---- chart skeleton
+from .chart_skeleton import chart_skeleton
+from .cs_attributes import chart_size
+from .cs_attributes import chart_xlabel
+from .cs_attributes import chart_ylabel
+from .cs_attributes import color_libraries
+from .cs_attributes import fonts
+
+# ---- plots
+from .bar_plot import bar_plot
+from .line_plot import line_plot
+from .dist_plot import distribution_plot
+from .scatter_plot import scatter_plot
+
+# ---- reference items
+from .reference_line import reference_line
+from .legend import legend
+from .text import text
+
+# ---- templates
+from .templates import templates
+
+# ---- save function
+from .save_chart import save_chart

quicklooks-0.0.11/quicklooks/bar_plot.py

@@ -0,0 +1,127 @@
+import numpy as np
+import matplotlib.pyplot as plt
+
+class bar_plot:
+    """
+    bar = ql.bar_plot(chart_skeleton,
+    xlabels = ,
+    y = ,
+    yerror = None, #If no values, None
+    bars_per_xlabel = 1,
+    bar_index = 0,
+    color = chart_skeleton.color_library.default,
+    opacity = 1,
+    label = '',
+    layer_order = 1)
+    """
+
+    def __init__(self, chart_skeleton, xlabels, y, yerror, bars_per_xlabel,
+                 bar_index, color, opacity, label, layer_order):
+
+        if not chart_skeleton.ax:
+            raise Exception('''The chart skeleton has not been built.
+            You must build a chart skeleton for each new plot that you want \
+            to create.''')
+
+        if chart_skeleton.xaxis_type == 'timeseries':
+            raise Exception('''The chart skeleton xtick_label is set to a
+                               timeseries (e.g., months, days). This is not
+                               compatible with a scatter plot.''')
+
+        if type(xlabels) in [str, int, float, bool]:
+            raise TypeError('''x is not properly defined.
+            x should be a 1 dimensional array of values.''')
+
+        if type(y) in [str, int, float, bool]:
+            raise TypeError('''y is not properly defined.
+            y should be a 1 dimensional array of values.''')
+
+        if type(yerror) in [str, int, float, bool]:
+            raise TypeError('''yerror is not properly defined. If you do not
+            need error represented on your line plot, set yerror = None.\n'
+            'If you need yerror on your line plot,
+            ensure that it is a 1 dimensional array of values.''')
+
+        if type(bar_index) is not int:
+            raise TypeError('''bar_index is not properly defined.
+            It must be an integer between 0 and bars_per_xlabel''')
+
+        if type(bars_per_xlabel) is not int or bars_per_xlabel < 1:
+            raise TypeError('''bars_per_xlabel is not properly defined.
+            It must be an integer >= 1''')
+
+        if bar_index >= bars_per_xlabel:
+            raise IndexError('''bar_index is not properly defined.
+            It must be an integer between 0 and bars_per_xlabel-1''')
+
+        # ---- check data shapes
+        if np.shape(np.shape(xlabels))[0] != 1:
+            raise ValueError('''x is not properly defined.; it is a {} x {} array.
+            x must be 1-dimensional array.'''.format(np.shape(xlabels)[0],
+                                                   np.shape(xlabels)[1]))
+        if np.shape(np.shape(y))[0] != 1:
+            raise ValueError('''y is not properly defined.; it is a {} x {} array.
+            y must be 1-dimensional array.'''.format(np.shape(y)[0],
+                                                   np.shape(y)[1]))
+        if np.shape(xlabels) != np.shape(y):
+            raise ValueError('''x and y are not the same shape. x has {} values
+            and y has {} values'''.format(np.shape(xlabels)[0], np.shape(y)[0]))
+
+        xlim = (-0.5,len(xlabels)-0.5)
+        plt.xlim(xlim[0], xlim[1]);
+        plt.xticks(ticks=range(len(xlabels)), labels=xlabels);
+        label_to_x = dict(zip(xlabels, chart_skeleton.ax.get_xticks()))
+
+        # ---- adjust for number of xlabels
+        width = 0.8 if len(xlabels) <= 2 else 0.8-(len(xlabels)*0.01)
+        # ---- adjust for number of bars at xlabel
+        width = width/bars_per_xlabel
+
+        # --- get offsets based on number of bars at xlabel
+        idx = [i for i in range(bars_per_xlabel)]
+        bar_offsets = [(i - np.median(idx))*1.1 for i in idx]
+        offset = bar_offsets[bar_index]*width
+
+        # ---- get x and y locs
+        ylim = chart_skeleton.ax.get_ylim()
+        x_loc = [label_to_x[i]+offset for i in xlabels]
+        bottom = np.array([(i/abs(i)) * ((ylim[1]-ylim[0])*0.002) for i in y])
+        height = y-bottom
+        zorder = 1
+
+        line = color[0]
+        fill = color[1]
+        edge = color[2]
+
+        bar = chart_skeleton.ax.bar(x=x_loc, width=width,
+                                 height=height, bottom=bottom,
+                                 color=fill,
+                                 edgecolor=edge,
+                                 linewidth=2,
+                                 joinstyle='round',
+                                 alpha=opacity,
+                                 label=label,
+                                 zorder = layer_order + 2)
+
+        if yerror is not None:
+            total_bars = bars_per_xlabel * len(x_loc)
+            if total_bars >= 30:
+                err_width = 2
+            elif total_bars >= 20:
+                err_width = 3
+            elif total_bars >= 10:
+                err_width = 4
+            else:
+                err_width = 5
+
+            for i in range(len(x_loc)):
+                chart_skeleton.ax.plot(np.full(10,x_loc[i]),
+                np.linspace(y[i]-yerror[i], y[i]+yerror[i],10),
+                linewidth=err_width, color=edge, alpha=opacity,
+                zorder = layer_order + 2+0.1, solid_capstyle='round');
+        else:
+            error = None
+
+        self.bar_obj = bar
+        self.xlim = xlim
+        self.zorder = layer_order + 2

quicklooks-0.0.11/quicklooks/chart_skeleton.py

@@ -0,0 +1,260 @@
+import matplotlib.pyplot as plt
+from .plot_and_text_styling import *
+from .cs_attributes import *
+from datetime import datetime
+from dateutil import relativedelta
+import matplotlib.dates as mdates
+
+class chart_skeleton:
+    """
+    chart_skeleton = ql.chart_skeleton(
+    size = ql.chart_size.notebook,
+    color_library = ql.color_libraries.skygrove,
+    font = ql.fonts.rubik,
+    title = '',
+    xlabel = '',
+    ylabel = '',
+    x_min_max = (0,1), y_min_max = (0,1),
+    xtick_interval = 0.25, ytick_interval = 0.25,
+    xtick_labels = ql.chart_xlabel.default,
+    ytick_labels = ql.chart_ylabel.default,
+    horizontal_gridlines_on = False,
+    vertical_gridlines_on = False);
+    """
+
+    def __init__(self, size, color_library, font, title, ylabel, xlabel, x_min_max,
+                 y_min_max, xtick_interval, ytick_interval, xtick_labels,
+                 ytick_labels, horizontal_gridlines_on, vertical_gridlines_on):
+
+        # ---- size
+        # ---- affects markersize for line and scatter plots
+        self.size = size
+
+        # ---- colors
+        self.color_library = color_library
+
+        # ---- font
+        self.font = font
+
+        # ---- title
+        if type(title) is not str:
+            raise AttributeError('title not properly define: must be a string \
+                                 (e.g., Daily Active Users)')
+
+        # ---- ylabel
+        if type(ylabel) is not str:
+            raise AttributeError('ylabel not properly define: must be a string \
+                                 (e.g., "Daily Active Users")')
+
+        # ---- xlabel
+        if type(xlabel) is not str:
+            raise AttributeError('xlabel not properly define: must be a string \
+                                 (e.g., "Date")')
+
+        # ---- y_min_max
+        # ---- req for reference_line
+        if type(y_min_max) is tuple and y_min_max[1] > y_min_max[0]:
+            self.y_min_max = y_min_max
+            yrange = y_min_max[1] - y_min_max[0]
+            self.yrange = yrange
+
+        else:
+            raise AttributeError('y_min_max must be a tuple (e.g., (0,1) where\
+                                  the second value is greater than the first')
+
+        # ---- xtick_labels
+        if type(xtick_labels) not in [str, list]:
+            raise Exception('xtick_labels not properly defined: xtick_labels \
+                             must be set to default, percents, or defined \
+                             as a list of strings.')
+
+        # ---- set xaxis_type (will overwrite if timeseries)
+        xaxis_type = 'default'
+
+        # ---- check that label type and min_max match
+        if xtick_labels in ['years', 'months', 'quarters', 'days']:
+            if type(x_min_max[0]) is not str or type(x_min_max[1]) is not str:
+                raise TypeError('''If xtick label is set to a timeseries,
+                x_min_max must be a tuple with two date strings in the format
+                YYYY-MM-DD''')
+            # ---- if they do, convert str to datetime
+            else:
+                x_min_max = (datetime.strptime(x_min_max[0], '%Y-%m-%d'),
+                             datetime.strptime(x_min_max[1], '%Y-%m-%d'))
+
+                xaxis_type = 'timeseries'
+
+        # ---- req for reference line
+        self.xaxis_type = xaxis_type
+
+        # ---- ytick_labels
+        if type(ytick_labels) not in [str, list]:
+            raise Exception('''ytick_labels not properly defined: ytick_labels
+                             must be set to default, percents, or defined as a
+                             list of strings.''')
+
+        # ---- check xtick labels
+        # ---- for timeseries
+        def_error = False
+        int_error = False
+
+        if xaxis_type == 'timeseries':
+            xrange = (x_min_max[1] - x_min_max[0]).days
+            rd = relativedelta.relativedelta(x_min_max[1], x_min_max[0])
+
+            if xtick_labels == 'days':
+                def_error = True if xtick_interval > xrange else False
+                int_error = True if 20*xtick_interval < xrange else False
+
+            elif xtick_labels == 'months':
+                if 2 > rd.years * 12 + rd.months:
+                    raise Exception('''xtick_interval not properly defined.
+                    Use days if the date range <= 3 months''')
+                elif 15 < rd.years * 12 + rd.months:
+                    raise Exception('''xtick_interval not properly defined.
+                    Use quarters if the date range > 15 months''')
+
+            elif xtick_labels == 'quarters':
+                if 9 > rd.years * 12 + rd.months:
+                    raise Exception('''xtick_interval not properly defined.
+                    Use months if the date range <= 9 months''')
+                elif 48 < rd.years * 12 + rd.months:
+                    raise Exception('''xtick_interval not properly defined.
+                    Use quarters if the date range > 16 quarters''')
+
+            elif xtick_labels == 'years':
+                def_error = True if xtick_interval > rd.years else False
+                int_error = True if 20*xtick_interval < rd.years else False
+
+        # ---- for everything else
+        else:
+            xrange = x_min_max[1] - x_min_max[0]
+            def_error = True if xtick_interval > xrange else False
+            int_error = True if 20*xtick_interval < xrange else False
+
+        if def_error:
+            raise Exception('''xtick_interval not properly defined.
+            Decrease the xtick_interval or change the xtick_labels''')
+        if int_error:
+            raise Exception('''xtick_interval is too small.
+            Increase the xtick_interval or change the xtick_labels''')
+
+
+        self.x_min_max = x_min_max
+        # ---- req for reference line
+        self.xrange = xrange
+
+        # ---- check ytick_labels
+        if ytick_interval > yrange:
+            raise Exception('''ytick_interval not properly defined;
+            decrease the ytick_interval''')
+
+        elif 20*ytick_interval < yrange:
+            raise Exception('''ytick_interval is too small;
+            increase the ytick_interval.''')
+
+        # ---- vertical gridlines
+        if type(vertical_gridlines_on) is not bool:
+            raise AttributeError('Vertical gridlines is not properly defined: \
+                                  vertical_gridlines_on must be set to \
+                                  True or False.')
+
+        # ---- horizontal gridlines
+        if type(horizontal_gridlines_on) is not bool:
+            raise AttributeError('Horizontal gridlines is not properly defined: \
+                                  horizontal_gridlines_on must be set to \
+                                  True or False.')
+
+        # ----------------------------------------------------------------------
+        # style the plot -------------------------------------------------------
+        # ----------------------------------------------------------------------
+        # ---- define plot style based on style and size choice
+        ps = chart_skeleton_style(size, ylabel)
+        fs = font_style(size, self)
+
+        # ---- req for legend and text
+        self.plot_style = ps
+        self.font_style = fs
+
+        # ---- create the plot
+        fig, ax = plt.subplots(nrows=1, figsize = ps.figsize)
+        self.ax = ax
+
+        # ---- add the title
+        ax.set_title(title, color = color_library.text,
+                     pad = ps.title_pad, fontproperties = fs.title)
+
+        # ---- create a patch to set the background color of the plot
+        ax.patch.set_xy((-0.16, -0.14))
+        ax.patch.set_height(1.2)
+        ax.patch.set_width(1.28)
+        ax.set_facecolor(color_library.background)
+
+        # ---- set facecolor of fig (around ax face)
+        fig.set_facecolor(color_library.background)
+
+        # ---- add grid lines if necessary
+        if horizontal_gridlines_on == True:
+            ax.yaxis.grid(which='major', linestyle=':',
+            linewidth = ps.linewidth, color = '0.8', zorder=1)
+
+        if vertical_gridlines_on == True:
+            ax.xaxis.grid(which='major', linestyle=':',
+            linewidth = ps.linewidth, color = '0.8', zorder=1)
+
+        # ---- style the axis lines
+        for spine in ['top', 'right']:
+            ax.spines[spine].set_visible(False)
+        for spine in ['bottom', 'left']:
+            ax.spines[spine].set_linewidth(ps.linewidth)
+            ax.spines[spine].set_color(color_library.text)
+            ax.spines[spine].set_zorder(2)
+
+        # ---- style the axis ticks
+        for i in range(2):
+            ax.tick_params(['x','y'][i],
+                           colors=color_library.text,
+                           width = ps.linewidth, pad = ps.tick_pad[i],
+                           length = ps.tick_length)
+
+        for tick in ax.get_xticklabels():
+            tick.set_font_properties(fs.label)
+        for tick in ax.get_yticklabels():
+            tick.set_font_properties(fs.label)
+
+        # ---- set the axis limits and number of ticks
+        ax.set_ylim(y_min_max)
+        ax.set_xlim(x_min_max)
+
+        # ---- set the number of ticks on the axes
+        ax.yaxis.set_major_locator(plt.MultipleLocator(ytick_interval))
+        if xaxis_type == 'default':
+            ax.xaxis.set_major_locator(plt.MultipleLocator(xtick_interval))
+        else:
+            if xtick_labels == 'years':
+                ax.xaxis.set_major_locator(mdates.YearLocator(base=1))
+                print('xtick_interval ignored when xtick_label = years\n')
+            elif xtick_labels == 'quarters':
+                ax.xaxis.set_major_locator(mdates.MonthLocator((1,4,7,10)))
+                print('xtick_interval ignored when xtick_label = quarters\n')
+            elif xtick_labels == 'months':
+                ax.xaxis.set_major_locator(mdates.MonthLocator(interval=1))
+                print('xtick_interval ignored when xtick_label = months\n')
+            elif xtick_labels == 'days':
+                ax.xaxis.set_major_locator(mdates.DayLocator(interval=xtick_interval))
+
+        # ---- label the y axis
+        ax.set_ylabel(ylabel, color=color_library.text,
+                      rotation = 90 if size == 'half_slide' else 0, labelpad = ps.label_pad[1],
+                      horizontalalignment = 'center',
+                      linespacing = 1.6, fontproperties = fs.label)
+
+        # ---- label the x axis
+        ax.set_xlabel(xlabel, color = color_library.text,
+                      labelpad = ps.label_pad[0], fontproperties = fs.label)
+
+        # ---- set the x and y tick labels
+        set_tick_labels(xtick_labels, 'x', ax, x_min_max)
+        set_tick_labels(ytick_labels, 'y', ax, y_min_max)
+
+        plt.tight_layout()

quicklooks-0.0.11/quicklooks/cs_attributes.py

@@ -0,0 +1,115 @@
+class chart_ylabel:
+    default = 'default'
+    percents = 'percents'
+    millions = '1m'
+    hundredK = '100k'
+    thousands = '1k'
+
+class chart_xlabel:
+    default = 'default'
+    percents = 'percents'
+    years = 'years'
+    quarters = 'quarters'
+    months = 'months'
+    days = 'days'
+
+class chart_size:
+    notebook = 'notebook'
+    half_slide = 'half_slide'
+    full_slide = 'full_slide'
+
+class fonts:
+    lato = 'lato'
+    montserrat = 'montserrat'
+    oswald = 'oswald'
+    roboto = 'roboto'
+    rubik = 'rubik'
+    source_sans = 'source_sans'
+    work_sans = 'work_sans'
+
+class color_libraries:
+    class mariglow:
+        default = ['#9AA7FE', '#4B64FE', '#203DFE'] #blue
+        background = '#ffffff'
+        text = '#000000'
+        color_list = ['orange', 'peach', 'navy', 'blue']
+        orange = ['#EF7B57', '#E94819', '#BB3911']
+        peach = ['#FAF3EF', '#ECCFC0', '#DEAB91']
+        navy = ['#2C4177', '#1A2747', '#0B101E']
+        blue = ['#9AA7FE', '#4B64FE', '#203DFE']
+        light_gray = ['#f1f3f5', '#e9ecef', '#dee2e6']
+        gray = ['#ced4da', '#adb5bd', '#868e96']
+        dark_gray = ['#495057', '#343a40', '#212529']
+        black = ['#000000', '#000000', '#000000']
+
+    class skygrove:
+        default = ['#6E80D8', '#3E56CC', '#2B3FA1'] #blue
+        background = '#ffffff'
+        text = '#000000'
+        color_list = ['blue', 'periwinkle', 'sea_green', 'green_tea']
+        blue = ['#6E80D8', '#3E56CC', '#2B3FA1']
+        periwinkle = ['#EBEFFF', '#ADBEFF', '#708DFF']
+        sea_green = ['#57B27C', '#3E885B', '#2D6242']
+        green_tea = ['#EAF0D1', '#D5E1A3', '#BFD274']
+        light_gray = ['#f1f3f5', '#e9ecef', '#dee2e6']
+        gray = ['#ced4da', '#adb5bd', '#868e96']
+        dark_gray = ['#495057', '#343a40', '#212529']
+        black = ['#000000', '#000000', '#000000']
+
+    class opencolor:
+        default = ['#4dabf7','#339af0','#228be6'] #blue
+        background = '#ffffff'
+        text = '#000000'
+        color_list = ['light_red', 'red', 'dark_red',
+                      'light_pink', 'pink', 'dark_pink',
+                      'light_grape', 'grape', 'dark_grape',
+                      'light_violet', 'violet', 'dark_violet',
+                      'light_indigo', 'indigo', 'dark_indigo',
+                      'light_blue', 'blue', 'dark_blue',
+                      'light_cyan', 'cyan', 'dark_cyan',
+                      'light_teal', 'teal', 'dark_teal',
+                      'light_green', 'green', 'dark_green',
+                      'light_lime', 'lime', 'dark_lime',
+                      'light_yellow', 'yellow', 'dark_yellow',
+                      'light_orange', 'orange', 'dark_orange']
+
+        light_red = ['#ffe3e3','#ffc9c9','#ffa8a8']
+        red = ['#ff8787','#ff6b6b','#fa5252']
+        dark_red = ['#f03e3e','#e03131','#c92a2a']
+        light_pink = ['#ffdeeb','#fcc2d7','#faa2c1']
+        pink = ['#f783ac','#f06595','#e64980']
+        dark_pink = ['#d6336c','#c2255c','#a61e4d']
+        light_grape = ['#f3d9fa','#eebefa','#e599f7']
+        grape = ['#da77f2','#cc5de8','#be4bdb']
+        dark_grape = ['#ae3ec9','#9c36b5','#862e9c']
+        light_violet = ['#e5dbff','#d0bfff','#b197fc']
+        violet = ['#9775fa','#845ef7','#7950f2']
+        dark_violet = ['#7048e8','#6741d9','#5f3dc4']
+        light_indigo = ['#dbe4ff','#bac8ff','#91a7ff']
+        indigo = ['#748ffc','#5c7cfa','#4c6ef5']
+        dark_indigo = ['#4263eb','#3b5bdb','#364fc7']
+        light_blue = ['#d0ebff','#a5d8ff','#74c0fc']
+        blue = ['#4dabf7','#339af0','#228be6']
+        dark_blue = ['#1c7ed6','#1971c2','#1864ab']
+        light_cyan = ['#c5f6fa','#99e9f2','#66d9e8']
+        cyan = ['#3bc9db','#22b8cf','#15aabf']
+        dark_cyan = ['#1098ad','#0c8599','#0b7285']
+        light_teal = ['#c3fae8','#96f2d7','#63e6be']
+        teal = ['#38d9a9','#20c997','#12b886']
+        dark_teal = ['#0ca678','#099268','#087f5b']
+        light_green = ['#d3f9d8','#b2f2bb','#8ce99a']
+        green = ['#69db7c','#51cf66','#40c057']
+        dark_green = ['#37b24d','#2f9e44','#2b8a3e']
+        light_lime = ['#e9fac8','#d8f5a2','#c0eb75']
+        lime = ['#a9e34b','#94d82d','#82c91e']
+        dark_lime = ['#74b816','#66a80f','#5c940d']
+        light_yellow = ['#fff3bf','#ffec99','#ffe066']
+        yellow = ['#ffd43b','#fcc419','#fab005']
+        dark_yellow = ['#f59f00','#f08c00','#e67700']
+        light_orange = ['#ffe8cc','#ffd8a8','#ffc078']
+        orange = ['#ffa94d','#ff922b','#fd7e14']
+        dark_orange = ['#f76707','#e8590c','#d9480f']
+        light_gray = ['#f1f3f5', '#e9ecef', '#dee2e6']
+        gray = ['#ced4da', '#adb5bd', '#868e96']
+        dark_gray = ['#495057', '#343a40', '#212529']
+        black = ['#000000', '#000000', '#000000']