[REL] Add git archival support for setuptools-scm (#1609)

* Add git archival support

* Add a comment about export-subst

Author: mdboom

.git_archival.txt

@@ -0,0 +1,3 @@
+node: $Format:%H$
+node-date: $Format:%cI$
+ref-names: $Format:%D$

.gitattributes

@@ -1,5 +1,3 @@
-cuda/_version.py export-subst
-
 * text eol=lf
 *.cmd text eol=crlf
 
@@ -16,3 +14,9 @@ cuda_core/cuda/core/_cpp/*.hpp -binary text diff
 *.svg binary
 # SCM syntax highlighting & preventing 3-way merges
 pixi.lock merge=binary linguist-language=YAML linguist-generated=true
+
+# "export-subst" specifies that this file will get filled in with the current
+# commit and tag information when running `git archive`.  This allows
+# `setuptools-scm` to correctly determine the version when building from a git
+# archive.  See #1609.
+.git_archival.txt export-subst

.pre-commit-config.yaml

@@ -29,7 +29,7 @@ repos:
         language: python
         additional_dependencies:
           - https://files.pythonhosted.org/packages/cc/20/ff623b09d963f88bfde16306a54e12ee5ea43e9b597108672ff3a408aad6/pathspec-0.12.1-py3-none-any.whl
-        exclude: '.*pixi\.lock'
+        exclude: '(.*pixi\.lock)|(\.git_archival\.txt)'
         args: ["--fix"]
 
       - id: no-markdown-in-docs-source

cuda_bindings/.git_archival.txt

@@ -0,0 +1 @@
+../.git_archival.txt

cuda_core/.git_archival.txt

@@ -0,0 +1 @@
+../.git_archival.txt

cuda_pathfinder/.git_archival.txt

@@ -0,0 +1 @@
+../.git_archival.txt

cuda_python_test_helpers/.git_archival.txt

@@ -0,0 +1 @@
+../.git_archival.txt