matplotlib
diff --git a/‎.flake8
-1 b/‎.flake8
-1
diff --git a/‎.git_archival.txt
+1 b/‎.git_archival.txt
+1
diff --git a/‎.gitattributes
+1-1 b/‎.gitattributes
+1-1
diff --git a/‎.github/workflows/tests.yml
+1-1 b/‎.github/workflows/tests.yml
+1-1
diff --git a/‎.gitignore
+2 b/‎.gitignore
+2
diff --git a/‎MANIFEST.in
-24 b/‎MANIFEST.in
-24
diff --git a/‎doc/conf.py
+1-1 b/‎doc/conf.py
+1-1
diff --git a/‎doc/devel/contributing.rst
+1-1 b/‎doc/devel/contributing.rst
+1-1
diff --git a/‎doc/devel/release_guide.rst
+5-5 b/‎doc/devel/release_guide.rst
+5-5
diff --git a/‎lib/matplotlib/__init__.py
+22-9 b/‎lib/matplotlib/__init__.py
+22-9
@@ -35,7 +35,6 @@ exclude =
     doc/gallery
     doc/tutorials
     # External files.
-    versioneer.py
     tools/gh_api.py
     tools/github_stats.py
     .tox
 
@@ -0,0 +1 @@
+ref-names: $Format:%D$
@@ -2,4 +2,4 @@
 *.ppm binary
 *.svg binary
 *.svg linguist-language=true
-lib/matplotlib/_version.py export-subst
+.git_archival.txt export-subst
@@ -140,7 +140,7 @@ jobs:
 
           # Install dependencies from PyPI.
           python -mpip install --upgrade $PRE \
-            cycler kiwisolver numpy pillow pyparsing python-dateutil \
+            cycler kiwisolver numpy pillow pyparsing python-dateutil setuptools-scm \
             -r requirements/testing/travis_all.txt \
             ${{ matrix.extra-requirements }}
 
 
@@ -42,6 +42,8 @@ pip-wheel-metadata/*
 # tox testing tool
 .tox
 setup.cfg
+# generated by setuptools_scm
+lib/matplotlib/_version.py
 
 # OS generated files #
 ######################
 
@@ -196,7 +196,7 @@ def _check_dependencies():
 try:
     SHA = subprocess.check_output(
         ['git', 'describe', '--dirty']).decode('utf-8').strip()
-# Catch the case where git is not installed locally, and use the versioneer
+# Catch the case where git is not installed locally, and use the setuptools_scm
 # version number instead
 except (subprocess.CalledProcessError, FileNotFoundError):
     SHA = matplotlib.__version__
 
@@ -323,7 +323,7 @@ New modules and files: installation
 
 * If you have added new files or directories, or reorganized existing
   ones, make sure the new files are included in the match patterns in
-  :file:`MANIFEST.in`, and/or in *package_data* in :file:`setup.py`.
+  in *package_data* in :file:`setupext.py`.
 
 C/C++ extensions
 ----------------
 
@@ -176,14 +176,12 @@ Finally, push the tag to GitHub::
 
 Congratulations, the scariest part is done!
 
-.. [#] The tarball that is provided by GitHub is produced using `git
-       archive <https://git-scm.com/docs/git-archive>`__.  We use
-       `versioneer <https://github.com/warner/python-versioneer>`__
-       which uses a format string in
+.. [#] The tarball that is provided by GitHub is produced using `git archive`_.
+       We use setuptools_scm_ which uses a format string in
        :file:`lib/matplotlib/_version.py` to have ``git`` insert a
        list of references to exported commit (see
        :file:`.gitattributes` for the configuration).  This string is
-       then used by ``versioneer`` to produce the correct version,
+       then used by ``setuptools_scm`` to produce the correct version,
        based on the git tag, when users install from the tarball.
        However, if there is a branch pointed at the tagged commit,
        then the branch name will also be included in the tarball.
@@ -195,6 +193,8 @@ Congratulations, the scariest part is done!
 
           git archive v2.0.0 -o matplotlib-2.0.0.tar.gz --prefix=matplotlib-2.0.0/
 
+.. _git archive: https://git-scm.com/docs/git-archive
+.. _setuptools_scm: https://github.com/pypa/setuptools_scm
 
 If this is a final release, also create a 'doc' branch (this is not
 done for pre-releases)::
 
@@ -102,20 +102,15 @@
 import tempfile
 import warnings
 
+import numpy
+
 # cbook must import matplotlib only within function
 # definitions, so it is safe to import from it here.
-from . import _api, cbook, docstring, rcsetup
+from . import _api, _version, cbook, docstring, rcsetup
 from matplotlib.cbook import MatplotlibDeprecationWarning, sanitize_sequence
 from matplotlib.cbook import mplDeprecation  # deprecated
 from matplotlib.rcsetup import validate_backend, cycler
 
-import numpy
-
-# Get the version from the _version.py versioneer file. For a git checkout,
-# this is computed based on the number of commits since the last tag.
-from ._version import get_versions
-__version__ = str(get_versions()['version'])
-del get_versions
 
 _log = logging.getLogger(__name__)
 
@@ -135,6 +130,25 @@
 }"""
 
 
+def __getattr__(name):
+    if name == "__version__":
+        import setuptools_scm
+        global __version__  # cache it.
+        # Only shell out to a git subprocess if really needed.
+        root = Path(__file__).resolve().parents[2]
+        if (root / ".git").exists():
+            __version__ = setuptools_scm.get_version(
+                root=root,
+                version_scheme="post-release",
+                local_scheme="node-and-date",
+                fallback_version=_version.version,
+            )
+        else:  # Get the version from the _version.py setuptools_scm file.
+            __version__ = _version.version
+        return __version__
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
 def _check_versions():
 
     # Quickfix to ensure Microsoft Visual C++ redistributable
@@ -1435,7 +1449,6 @@ def inner(ax, *args, data=None, **kwargs):
     return inner
 
 
-_log.debug('matplotlib version %s', __version__)
 _log.debug('interactive is %s', is_interactive())
 _log.debug('platform is %s', sys.platform)
 _log.debug('loaded modules: %s', list(sys.modules))