Swap versioneer for scm_setuptools

Author: adamtheturtle

.git_archival.txt

@@ -0,0 +1 @@
+ref-names: $Format:%D$

.gitattributes

@@ -1 +1 @@
-src/vws_auth_tools/_version.py export-subst
+.git_archival.txt  export-subst

.gitignore

@@ -102,3 +102,6 @@ venv.bak/
 
 # mypy
 .mypy_cache/
+
+# setuptools_scm
+src/*/_setuptools_scm_version.txt

docs/source/conf.py

@@ -32,7 +32,8 @@
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 version = vws_auth_tools.__version__
-release = version.split('+')[0]
+_month, _day, _year, *_ = version.split('.')
+release = f'{_month}.{_day}.{_year}'
 
 substitutions = [
     ('|release|', release),

lint.mk

@@ -7,22 +7,20 @@ yapf:
 	yapf \
 	    --diff \
 	    --recursive \
-	    --exclude versioneer.py  \
-	    --exclude src/*/_version.py \
+	    --exclude .eggs \
 	    .
 
 .PHONY: fix-yapf
 fix-yapf:
 	yapf \
 	    --in-place \
 	    --recursive \
-	    --exclude versioneer.py  \
-	    --exclude src/*/_version.py \
+	    --exclude .eggs \
 	    .
 
 .PHONY: mypy
 mypy:
-	mypy *.py src/ tests/ docs/source/
+	mypy *.py src/ tests/ docs/source/ admin
 
 .PHONY: check-manifest
 check-manifest:
@@ -58,7 +56,7 @@ pyroma:
 
 .PHONY: vulture
 vulture:
-	vulture --min-confidence 100 --exclude _vendor .
+	vulture --min-confidence 100 --exclude _vendor --exclude .eggs .
 
 .PHONY: linkcheck
 linkcheck:
@@ -80,7 +78,7 @@ autoflake:
 	    --remove-all-unused-imports \
 	    --remove-unused-variables \
 	    --expand-star-imports \
-	    --exclude _vendor,src/*/_version.py,versioneer.py,release \
+	    --exclude _vendor,release \
 	    .
 
 .PHONY: pydocstyle

requirements.txt

@@ -0,0 +1 @@
+setuptools_scm==3.3.3

setup.cfg

@@ -21,6 +21,7 @@ ignore =
           doc8.ini
           docs
           docs/*
+          .git_archival.txt
           minidcos.rb
           LICENSE
           Makefile
@@ -61,15 +62,8 @@ warn_return_any = True
 warn_unused_configs = True
 warn_unused_ignores = True
 
-[mypy-vws_auth_tools/_version]
-ignore_errors = true
-
-[mypy-versioneer]
-ignore_errors = True
-
 [flake8]
-exclude=./versioneer.py,
-        ./src/vws_auth_tools/_version.py,
+exclude=./.eggs,
         ./build/,
 
 [isort]
@@ -80,15 +74,14 @@ include_trailing_comma=true
 branch = True
 omit =
     *_vendor*
-    src/*/_version.py
 
 [yapf]
 DEDENT_CLOSING_BRACKETS = true
 BLANK_LINE_BEFORE_NESTED_CLASS_OR_DEF = true
 
 [doc8]
 max-line-length = 2000
-ignore-path = ./node_modules,./src/*.egg-info/,./docs/build/spelling/output.txt
+ignore-path = ./node_modules,./src/*.egg-info/,./docs/build/spelling/output.txt,./.eggs,./src/*/_setuptools_scm_version.txt,./docs/build
 
 [pydocstyle]
 # No summary lines
@@ -114,18 +107,6 @@ ignore-path = ./node_modules,./src/*.egg-info/,./docs/build/spelling/output.txt
 # punctuation
 #   - D415
 ignore = D200,D202,D203,D205,D212,D400,D406,D407,D413,D301,D401,D415
-match=(?!.*(versioneer|_version)).*\.py
-
-# See the docstring in versioneer.py for instructions. Note that you must
-# re-run 'versioneer.py setup' after changing this section, and commit the
-# resulting files.
-[versioneer]
-VCS = git
-style = pep440
-versionfile_source = src/vws_auth_tools/_version.py
-versionfile_build = vws_auth_tools/_version.py
-tag_prefix =
-parentdir_prefix = vws_auth_tools
 
 [bdist_wheel]
 universal = 1

setup.py

@@ -7,8 +7,6 @@
 
 from setuptools import setup
 
-import versioneer
-
 
 def _get_dependencies(requirements_file: Path) -> List[str]:
     """
@@ -30,8 +28,10 @@ def _get_dependencies(requirements_file: Path) -> List[str]:
 )
 
 setup(
-    version=versioneer.get_version(),  # type: ignore
-    cmdclass=versioneer.get_cmdclass(),  # type: ignore
+    use_scm_version={
+        'write_to': 'src/vws_auth_tools/_setuptools_scm_version.txt',
+    },
+    setup_requires=['setuptools_scm', 'setuptools_scm_git_archive'],
     install_requires=INSTALL_REQUIRES,
     extras_require={'dev': DEV_REQUIRES},
 )

src/vws_auth_tools/__init__.py

@@ -6,8 +6,9 @@
 import email.utils
 import hashlib
 import hmac
+from pathlib import Path
 
-from ._version import get_versions
+from setuptools_scm import get_version
 
 
 def _compute_hmac_base64(key: bytes, data: bytes) -> bytes:
@@ -86,5 +87,11 @@ def authorization_header(  # pylint: disable=too-many-arguments
     return auth_header
 
 
-__version__ = get_versions()['version']  # type: ignore
-del get_versions
+try:
+    __version__ = get_version(root='..', relative_to=Path(__file__).parent)
+except LookupError:  # pragma: no cover
+    # When pkg_resources and git tags are not available,
+    # for example in a PyInstaller binary,
+    # we write the file ``_setuptools_scm_version.py`` on ``pip install``.
+    _VERSION_FILE = Path(__file__).parent / '_setuptools_scm_version.txt'
+    __version__ = _VERSION_FILE.read_text()