Implement version sourcing from SCM

This change integrates setuptools-scm for deriving the dist
version from Git tags

.flake8

@@ -57,6 +57,9 @@ per-file-ignores =
   # in-tree PEP517 build backend nees a lot of legit `noqa`s
   bin/pep517_backend.py: WPS402
 
+  # The package has imports exposing private things to the public:
+  src/pylibsshext/__init__.py: WPS412
+
   # Exclude errors that don't make sense for Cython
   # Examples:
   # * "E211 whitespace before '('" happening to "typedef int (*smth) ..."

.git_archival.txt

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

.gitattributes

@@ -0,0 +1,5 @@
+# Force LF line endings for text files
+* text=auto eol=lf
+
+# Needed for setuptools-scm-git-archive
+.git_archival.txt  export-subst

.gitignore

@@ -393,3 +393,6 @@ $RECYCLE.BIN/
 
 /.github/workflows/.tmp
 /.test-results
+
+# setuptools-scm write_to:
+/src/pylibsshext/_scm_version.py

build-scripts/build-manylinux-wheels.sh

@@ -276,8 +276,26 @@ from __future__ import print_function  # needed for file=sys.stderr
 import sys
 
 import ${IMPORTABLE_PKG}
-from ${IMPORTABLE_PKG}.version import LIBSSH_VERSION
-print('libssh version: {!s}\n'.format(LIBSSH_VERSION))
+from ${IMPORTABLE_PKG} import (
+    __full_version__, __libssh_version__,
+    __version__, __version_info__,
+)
+print(
+    'libssh version: {!s}\n'.format(__libssh_version__),
+    file=sys.stderr,
+)
+print(
+    'pylibsshext version: {!s}\n'.format(__version__),
+    file=sys.stderr,
+)
+print(
+    'pylibsshext version tuple: {!r}\n'.format(__version_info__),
+    file=sys.stderr,
+)
+print(
+    'combined pylibsshext version: {!s}\n'.format(__full_version__),
+    file=sys.stderr,
+)
 
 from ${IMPORTABLE_PKG}.channel import Channel
 from ${IMPORTABLE_PKG}.errors import LibsshSessionException

pyproject.toml

@@ -9,8 +9,8 @@ requires = [
   "expandvars",  # needed by in-tree build backend for env vars interpolation
 
   # Plugins
-  "setuptools_scm>=1.15",
-  "setuptools_scm_git_archive>=1.0",
+  "setuptools_scm[toml]>=3.5",
+  "setuptools_scm_git_archive>=1.1",
 ]
 backend-path = ["bin"]  # requires 'Pip>=20' or 'pep517>=0.6.0'
 build-backend = "pep517_backend"
@@ -58,3 +58,9 @@ keep-going = false
 [tool.local.cythonize.kwargs.options]
 # This section can contain cythonize options
 # NAME = "VALUE"
+
+# ATTENTION: the following section must be kept last in
+# `pyproject.toml` because the CI appends one line in
+# the end when publishing non-tagged versions.
+[tool.setuptools_scm]
+write_to = "src/pylibsshext/_scm_version.py"

setup.cfg

@@ -5,7 +5,6 @@ universal = 0
 
 [metadata]
 name = ansible-pylibssh
-version = 0.0.1.dev1
 url = https://github.com/ansible/pylibssh
 project_urls =
     Bug Tracker = https://github.com/ansible/pylibssh/issues

src/pylibsshext/__init__.py

@@ -1,3 +1,7 @@
 # -*- coding: utf-8 -*-
 
 """Python bindings for libssh."""
+
+from ._version import (  # noqa: F401, WPS300, WPS436
+    __full_version__, __libssh_version__, __version__, __version_info__,
+)

src/pylibsshext/_version.py

@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+
+"""Version definition."""
+
+from ._libssh_version import LIBSSH_VERSION as __libssh_version__  # noqa: N811, WPS300, WPS436
+
+try:
+    from ._scm_version import version as __version__  # noqa: WPS300, WPS433, WPS436
+except ImportError:
+    from pkg_resources import get_distribution as _get_dist  # noqa: WPS433
+    __version__ = _get_dist('ansible-pylibssh').version  # noqa: WPS440
+
+
+__full_version__ = (
+    '<pylibsshext v{wrapper_ver!s} with libssh v{backend_ver!s}>'.
+    format(wrapper_ver=__version__, backend_ver=__libssh_version__)
+)
+__version_info__ = __version__.split('.')