Issue #1633 nox session for tagging

noxfile.py

@@ -180,3 +180,27 @@ def make(session: nox.Session):
         *(args.make_args or ("clean", "coredocs")),
     ]
     session.run("make", "-C", "docs/docsite", *make_args, external=True)
+
+
+@nox.session
+def tag(session: nox.Session):
+    """
+    Determine the missinlg ansible-core releases,
+    create corresponding tags for each release in the ansible-documentation repo,
+    and then push them
+    """
+    install(session, req="tag")
+
+    DEFAULT_REPO = "https://github.com/ansible/ansible"
+
+    args = list(session.posargs)
+    if not any(arg.startswith("--core") for arg in args):
+        tmpdir = session.create_tmp()
+        session.run("git", "clone", "--quiet", DEFAULT_REPO, tmpdir, external=True)
+        args.extend(["--core", tmpdir])
+
+    # If run without any commands, default to "tag"
+    if not any(arg.startswith(("hash", "mantag", "new-tags", "tag")) for arg in args):
+        args.append("tag")
+
+    session.run("python", "hacking/tagger/tag.py", *args)

tests/tag.in

@@ -0,0 +1,3 @@
+gitpython
+packaging
+typer

tests/tag.txt

@@ -0,0 +1,30 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile --allow-unsafe --output-file=tests/tag.txt --strip-extras tests/tag.in
+#
+click==8.1.7
+    # via typer
+gitdb==4.0.11
+    # via gitpython
+gitpython==3.1.43
+    # via -r tests/tag.in
+markdown-it-py==3.0.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==24.1
+    # via -r tests/tag.in
+pygments==2.18.0
+    # via rich
+rich==13.7.1
+    # via typer
+shellingham==1.5.4
+    # via typer
+smmap==5.0.1
+    # via gitdb
+typer==0.12.3
+    # via -r tests/tag.in
+typing-extensions==4.12.2
+    # via typer