pyproject_patcher.tools
=======================

.. py:module:: pyproject_patcher.tools

.. autoapi-nested-parse::

   Tools (as in the `tool` section of a `pyproject.toml` file).



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/pyproject_patcher/tools/setuptools_git_versioning/index


Classes
-------

.. autoapisummary::

   pyproject_patcher.tools.SetuptoolsGitVersioning
   pyproject_patcher.tools.Tools


Package Contents
----------------

.. py:class:: SetuptoolsGitVersioning

   This class wraps a `pyproject.toml` model and provides
   methods to interact with the `tools.setuptools_git_versioning`
   part and other entries related to it.


   .. py:attribute:: patcher
      :type:  pyproject_patcher.patcher.PyprojectPatcher


   .. py:method:: remove()

      Removes all references to `setuptools-git-versioning` from
      this model.
      This includes removal of the `dynamic = ["version"]` entry
      and the entry in the `build-system.requires` section that
      requires the `setuptools-git-versioning` module.



   .. py:method:: template_ignore_dirty_git()

      Changes `dirty_template` so that it no longer contains a
      `.dirty` suffix.

      Useful for building system packages based on a VCS revision
      checked out with Git in cases where `pyproject.toml` has
      been modified before `setuptools_git_versioning` is run.
      In that case, having a `.dirty` suffix would be misleading.



.. py:class:: Tools

   Accessor for tools, such as `setuptools_git_versioning`.


   .. py:attribute:: patcher
      :type:  pyproject_patcher.patcher.PyprojectPatcher


   .. py:method:: setuptools_git_versioning()

      An object that provides methods to interact with the
      `tools.setuptools_git_versioning` part of `pyproject.toml`
      and other entries related to it.