Adjust pre-release.yml to set the version before uploading to Test PyPI

Author: Ickerday

.github/workflows/pre-release.yml

@@ -1,11 +1,16 @@
-name: Publish SDK to Test PyPI
-on: [workflow_dispatch]
+name: Publish pre-release to Test PyPI
+on:
+  push:
+    branches:
+      - develop
+      - release/2.x
+  workflow_dispatch:
 
 env:
   PYTHON_VERSION: 3.13
 
 jobs:
-  publish-to-test-pypi:
+  publish-pre-release:
     runs-on: ubuntu-latest
     permissions:
       id-token: write
@@ -17,6 +22,13 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
           deps-group: release
+      - name: Set pre-release version
+        env:
+          RUN_NUMBER: ${{ github.run_number }}
+        run: |
+          SHA=$(git rev-parse --short HEAD)
+          BASE=$(uv version --short)
+          uv version --frozen "${BASE}.dev${RUN_NUMBER}+g${SHA}"
       - name: Build packages for distribution
         run: uv build
       - name: Publish packages to Test PyPI

docs/conf.py

@@ -9,10 +9,9 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import importlib.metadata
 from datetime import datetime
 
-import splunklib
-
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -40,17 +39,17 @@
 master_doc = "index"
 
 # General information about the project.
-project = "Splunk SDK for Python"
-copyright = f"{datetime.now().year}, Splunk Inc."
+package_name = "splunk-sdk"
+project = f"Splunk SDK for Python (f{package_name}/splunklib)"
+copyright = f"2011-{datetime.now().year} Splunk, Inc."
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = splunklib.__version__
-# The full version, including alpha/beta/rc tags.
-release = splunklib.__version__
+release = importlib.metadata.version(package_name)
+version = ".".join(release.split(".")[:2])
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

pyproject.toml

@@ -8,7 +8,7 @@ download = "https://github.com/splunk/splunk-sdk-python/releases/latest"
 
 [project]
 name = "splunk-sdk"
-dynamic = ["version"]
+version = "3.0.0"
 description = "Splunk Software Development Kit for Python"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -57,8 +57,7 @@ dev = [
 ]
 
 [build-system]
-# setuptools v61 introduces pyproject.toml support
-requires = ["setuptools>=61.0.0"]
+requires = ["setuptools>=82.0.1"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools]
@@ -71,9 +70,6 @@ packages = [
   "splunklib.ai.engines",
 ]
 
-[tool.setuptools.dynamic]
-version = { attr = "splunklib.__version__" }
-
 [tool.basedpyright]
 exclude = [".venv"]
 allowedUntypedLibraries = ["splunklib"]

splunklib/__init__.py

@@ -30,7 +30,3 @@ def setup_logging(
     level, log_format=DEFAULT_LOG_FORMAT, date_format=DEFAULT_DATE_FORMAT
 ):
     logging.basicConfig(level=level, format=log_format, datefmt=date_format)
-
-
-__version_info__ = (3, 0, 0)
-__version__ = ".".join(map(str, __version_info__))

splunklib/binding.py

@@ -24,6 +24,7 @@
 :mod:`splunklib.client` module.
 """
 
+import importlib.metadata
 import io
 import json
 import logging
@@ -34,14 +35,13 @@
 from contextlib import contextmanager
 from datetime import datetime
 from functools import wraps
-from io import BytesIO
-from urllib import parse
 from http import client
 from http.cookies import SimpleCookie
+from io import BytesIO
+from urllib import parse
 from xml.etree.ElementTree import XML, ParseError
-from .data import record
-from . import __version__
 
+from .data import record
 
 logger = logging.getLogger(__name__)
 
@@ -1787,9 +1787,11 @@ def connect(scheme, host, port):
     def request(url, message, **kwargs):
         scheme, host, port, path = _spliturl(url)
         body = message.get("body", "")
+
+        sdk_version = importlib.metadata.version("splunk-sdk")
         head = {
             "Content-Length": str(len(body)),
-            "User-Agent": "splunk-sdk-python/%s" % __version__,
+            "User-Agent": f"splunk-sdk-python/{sdk_version}",
             "Accept": "*/*",
             "Connection": "Close",
         }  # defaults