Interactive data selection cursors for Matplotlib
=================================================

| |GitHub| |PyPI| |conda-forge| |Debian| |Fedora| |openSUSE|
| |Read the Docs| |Build| |CodeCov|

.. |GitHub|
   image:: https://img.shields.io/badge/github-anntzer%2Fmplcursors-brightgreen
   :target: https://github.com/anntzer/mplcursors
.. |PyPI|
   image:: https://img.shields.io/pypi/v/mplcursors.svg?color=brightgreen
   :target: https://pypi.python.org/pypi/mplcursors
.. |conda-forge|
   image:: https://img.shields.io/conda/v/conda-forge/mplcursors.svg?label=conda-forge&color=brightgreen
   :target: https://anaconda.org/conda-forge/mplcursors
.. |Debian|
   image:: https://repology.org/badge/version-for-repo/debian_testing/mplcursors.svg?header=Debian
   :target: https://packages.debian.org/sid/main/python3-mplcursors
.. |Fedora|
   image:: https://repology.org/badge/version-for-repo/fedora_rawhide/python:mplcursors.svg?header=Fedora
   :target: https://src.fedoraproject.org/rpms/python-mplcursors
.. |openSUSE|
   image:: https://repology.org/badge/version-for-repo/opensuse_tumbleweed/python:mplcursors.svg?header=openSUSE
   :target: https://software.opensuse.org/package/python3-mplcursors
.. |Read the Docs|
   image:: https://img.shields.io/readthedocs/mplcursors
   :target: http://mplcursors.readthedocs.io/en/latest/?badge=latest
.. |Build|
   image:: https://img.shields.io/github/workflow/status/anntzer/mplcursors/build
   :target: https://github.com/anntzer/mplcursors/actions
.. |CodeCov|
   image:: https://img.shields.io/codecov/c/github/anntzer/mplcursors
   :target: https://codecov.io/gh/anntzer/mplcursors

mplcursors provides interactive data selection cursors for Matplotlib_.  It is
inspired from mpldatacursor_, with a much simplified API.

mplcursors requires Matplotlib_\≥3.1.

Read the documentation on `readthedocs.org`_.

As usual, install using pip:

.. code-block:: sh

   $ pip install mplcursors  # from PyPI
   $ pip install git+https://github.com/anntzer/mplcursors  # from Github

or your favorite package manager.

Run tests with pytest_\≥3.7.1.

.. _Matplotlib: http://matplotlib.org
.. _mpldatacursor: https://github.com/joferkington/mpldatacursor
.. _pytest: http://pytest.org
.. _readthedocs.org: https://mplcursors.readthedocs.org
