.. include:: links.rst

Taste: Creating plots fast
==========================

Taste is a Python_ package wrapping Matplotlib_ APIs into a set of common most
used plots across multiple various applications or reporting tools via clean
and intuitive classes adhering to |zen|_.

It tries to completely isolate itself from the global Matplotlib_ context
which can be hard to understand for a complete newbie and can cause too much
unnecessary struggle.

It is easy and intuitive to use:

.. code:: python

    from taste.plots import HorizontalBarPlot

    # create a plot with desired properties
    plot = HorizontalBarPlot(
        caption="Plot caption",
        title="Figure title",
        bars=[0, 1, 2, 3, 4],
        values=[9, 9, 5, 8, 2],
        bar_label="Here I can label the bars",
        value_label="And here I label the values",
        bar_axis_labels=["Tom", "Dick", "Harry", "Slim", "Jim"],
        value_axis_labels=["L0", "L1", "L2", "L3", "L4"]
    )

    # explicitly ask to draw the plot in Jupyter notebook
    plot.figure  # MPL figure object

.. image:: _static/example-index.png

.. note::
   Although it doesn't explicitly forbid Python_ 3.6 due to compatibility with
   some older Jupyter_ notebooks, it aspires to run on higher versions (3.7+).
   Updating is *highly* recommended.

Quick Installation
------------------

Taste is available on PyPI_, simply issue this command in your terminal and
you're good to go::

  pip install taste

For more descriptive steps in various environments check :doc:`install`.

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   :hidden:

   getting-started
   install
   examples

.. toctree::
   :caption: Modules:
   :hidden:

   modules

.. toctree::
   :caption: Indices and tables:
   :hidden:

   genindex
   py-modindex