diff --git a/doc/source/conf.py b/doc/source/conf.py index 721f940e..f91b4561 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -18,6 +18,8 @@ from importlib.metadata import version from pathlib import Path +import requests + # 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 Path().resolve() to make it absolute, like shown here. @@ -68,6 +70,25 @@ # |version| and |release|, also used in various other places throughout the # built documents. + +def _get_latest_release_from_github(org: str, repo_name: str) -> str: + """Get the highest version release (including prereleases) from GitHub + repository.""" + url = f"https://api.github.com/repos/{org}/{repo_name}/releases" + response = requests.get(url) + releases = response.json() + valid_releases = [release for release in releases if "tag_name" in release] + if not valid_releases: + return "No valid releases found" + latest_version_release = valid_releases[0]["tag_name"] + return latest_version_release + + +# Get the latest release version from GitHub repository +org = "diffpy" +repo_name = "diffpy.utils" +latest_verion_from_github = _get_latest_release_from_github(org, repo_name) + fullversion = version(project) # The short X.Y version. version = "".join(fullversion.split(".post")[:1]) diff --git a/news/docs-version-tag.rst b/news/docs-version-tag.rst new file mode 100644 index 00000000..d093b158 --- /dev/null +++ b/news/docs-version-tag.rst @@ -0,0 +1,23 @@ +**Added:** + +* + +**Changed:** + +* Method to retrieve the latest package version from GitHub's release page in the official documentation. The latest release on GitHub is used to retrieve the latest version of the package instead of a tag. + +**Deprecated:** + +* + +**Removed:** + +* + +**Fixed:** + +* + +**Security:** + +*