index.rst

meson-python

meson-python is a Python build backend built on top of the Meson build-system. It enables you to use Meson for your Python packages.

Want to look at examples in real projects? Check out our curated list of meson-python projects :ref:`here <projects-using-meson-python>`.

Where to start?

If you are new to Python packaging, we recommend you check our :ref:`tutorial-introduction` tutorial, which walks you through creating and releasing your first Python package.

If you are already familiar with Python packaging, we recommend you check our :ref:`how-to-guides-first-project` guide, which shows you how to quickly setup a meson-python project.

How to reach us?

meson-python is an open source project, so all support is at a best-effort capacity, but we are happy to help where we can.

If you have a general question feel free to start a discussion on Github. If you want to report a bug, request a feature, or propose an improvement, feel free to open an issue on our bugtracker.

Search first!

Before starting a discussion, please try searching our bugtracker and discussion page first.

.. toctree::
   :caption: Tutorials
   :hidden:

   tutorials/introduction
   tutorials/entrypoints

.. toctree::
   :caption: How to guides
   :hidden:

   how-to-guides/first-project
   how-to-guides/editable-installs
   how-to-guides/config-settings
   how-to-guides/meson-args
   how-to-guides/debug-builds
   projects-using-meson-python

.. toctree::
   :caption: Reference
   :hidden:

   reference/config-settings
   reference/pyproject-settings
   reference/environment-variables
   explanations/default-options
   reference/limitations
   reference/meson-compatibility

.. toctree::
   :caption: Project
   :hidden:

   changelog
   about
   contributing/index
   Source Code <https://github.com/mesonbuild/meson-python>
   Issue Tracker <https://github.com/mesonbuild/meson-python/issues>