mkdocstrings-github 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

{mkdocstrings_github-0.3.0.dist-info → mkdocstrings_github-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocstrings-github
-Version: 0.3.0
+Version: 0.4.0
 Summary: A GitHub Action handler for mkdocstrings
 Author-email: Mark Hu <watermarkhu@gmail.com>
 License: MIT
@@ -14,15 +14,15 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: <3.14,>=3.10
+Requires-Python: <3.15,>=3.10
 Requires-Dist: gitpython~=3.1.45
 Requires-Dist: mkdocstrings~=0.29
-Requires-Dist: pygithub~=2.8.1
 Requires-Dist: typing-extensions>=4.0; python_version < '3.11'
 Description-Content-Type: text/markdown
 
@@ -37,6 +37,7 @@ Description-Content-Type: text/markdown
 [![Qualify](https://github.com/watermarkhu/mkdocstrings-github/actions/workflows/qualify.yaml/badge.svg?branch=main)](https://github.com/watermarkhu/mkdocstrings-github/actions/workflows/qualify.yaml)
 [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://watermarkhu.nl/mkdocstrings-github)
 [![pypi version](https://img.shields.io/pypi/v/mkdocstrings-github.svg)](https://pypi.org/project/mkdocstrings-github/)
+[![codecov](https://codecov.io/github/watermarkhu/mkdocstrings-github/graph/badge.svg?token=M6XW8UeURE)](https://codecov.io/github/watermarkhu/mkdocstrings-github)
 
 <!-- --8<-- [end:header] -->
 <!-- --8<-- [start:install] -->

{mkdocstrings_github-0.3.0.dist-info → mkdocstrings_github-0.4.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 mkdocstrings_handlers/github/__init__.py,sha256=0WdFUIq4Xu2ZFtlZNIYCQSoqcx3Ot9Wv41_X_dwbFww,248
-mkdocstrings_handlers/github/config.py,sha256=IxD1AiaQf3wC2cRabi3wUriimZDOhFOmpWw5CB-jSb4,6277
-mkdocstrings_handlers/github/handler.py,sha256=KjZJAq_wELYhBTMZgkWugsaNhBJFlidmFe_9cddxCuo,11028
+mkdocstrings_handlers/github/config.py,sha256=pSjA6gU-kC_mXQqNIIGOYEOhtX5VzZDT0H1hRFlGaj8,6089
+mkdocstrings_handlers/github/handler.py,sha256=xRvBMbQexYB-qWivLzNMMSP87fzPM3cPYBi1qZNrVDw,7931
 mkdocstrings_handlers/github/objects.py,sha256=JDkY7mg_LGlIEwZHP2wSd8ZkB6RVtRsu_JEpwV-PikQ,7069
 mkdocstrings_handlers/github/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mkdocstrings_handlers/github/rendering.py,sha256=tJeAsSaijqSC2IkxYsIXq7d0lR2A3aB5PRUcFFTFpVU,2705
@@ -11,7 +11,7 @@ mkdocstrings_handlers/github/templates/material/outputs.html.jinja,sha256=jlzVF9
 mkdocstrings_handlers/github/templates/material/secrets.html.jinja,sha256=1lMJoxjjeiqetVu0mdLKmZ1faYRReeyjiYvYTZESots,2881
 mkdocstrings_handlers/github/templates/material/style.css,sha256=R2hh1RfHwJ6XNT4YQl_txNkNXcPBZJMCBZn5kQEMQ6M,962
 mkdocstrings_handlers/github/templates/material/workflow.html.jinja,sha256=E1VUi2w7_NDkpS9VNrWRV52hhyhQvnKUrjPbV_j0Qcg,3312
-mkdocstrings_github-0.3.0.dist-info/METADATA,sha256=MQyoPBfAXQXy8Lsc8PA_GSo1s1OQlWffozEo7Jx-M_k,3125
-mkdocstrings_github-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mkdocstrings_github-0.3.0.dist-info/licenses/LICENSE,sha256=5enZtJ4zSp0Ps3jTqFQ4kadcx62BhgTaDNPrXWb3g3E,1069
-mkdocstrings_github-0.3.0.dist-info/RECORD,,
+mkdocstrings_github-0.4.0.dist-info/METADATA,sha256=01wUyZdvlbDHBFUqUP8Qmobe61BfAS-_HsI_6nak4cQ,3309
+mkdocstrings_github-0.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mkdocstrings_github-0.4.0.dist-info/licenses/LICENSE,sha256=5enZtJ4zSp0Ps3jTqFQ4kadcx62BhgTaDNPrXWb3g3E,1069
+mkdocstrings_github-0.4.0.dist-info/RECORD,,

mkdocstrings_handlers/github/config.py

@@ -171,11 +171,6 @@ class GitHubOptions(BaseModel):
 class GitHubConfig(BaseModel):
     """Configuration options for the GitHub handler."""
 
-    hostname: str = Field(
-        default="github.com",
-        description="The hostname of the GitHub instance to use. This is only needed for GitHub Enterprise installations.",
-    )
-
     repo: str = Field(
         default="",
         description="""The GitHub repository in the format *owner/repo*.

mkdocstrings_handlers/github/handler.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 import os
 import re
-import subprocess
 import sys
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, ClassVar, Mapping
@@ -18,7 +17,6 @@ from mkdocstrings import (
     get_logger,
 )
 
-from github import Auth, Github
 from mkdocstrings_handlers.github import rendering
 from mkdocstrings_handlers.github.config import GitHubConfig, GitHubOptions
 from mkdocstrings_handlers.github.objects import Action, Workflow
@@ -108,82 +106,20 @@ class GitHubHandler(BaseHandler):
                 self.actions[action_file] = action
 
     def get_releases(self) -> None:
-        gh_host = os.environ.get("GH_HOST", self.config.hostname)
-        if gh_host.startswith(("http://", "https://")):
-            base_url = gh_host
-        elif "/api/" in gh_host:
-            # If protocol is missing, default to https
-            base_url = f"https://{gh_host}"
-        elif gh_host.startswith("api."):
-            base_url = f"https://{gh_host}"
-        else:
-            base_url = f"https://api.{gh_host}"
-
-        _logger.debug(f"Using GitHub API base URL: {base_url}")
+        # Get all tags from the local git repository
+        try:
+            tags = [tag.name for tag in self.repo.tags]
+        except Exception as e:
+            _logger.warning(f"Could not get git tags from repository: {e}")
+            return
 
-        if (token_key := "GH_TOKEN") in os.environ:
-            gh = Github(base_url=base_url, auth=Auth.Token(os.environ[token_key]))
-            _logger.debug(f"Using GitHub authentication from environment variable {token_key}")
-        elif (token_key := "GITHUB_TOKEN") in os.environ:
-            gh = Github(base_url=base_url, auth=Auth.Token(os.environ[token_key]))
-            _logger.debug(f"Using GitHub authentication from environment variable {token_key}")
-        else:
-            try:
-                gh = Github(base_url=base_url, auth=Auth.NetrcAuth())
-                _logger.debug("Using GitHub authentication from .netrc")
-            except RuntimeError:
-                try:
-                    token = subprocess.check_output(
-                        ["gh", "auth", "token"], text=True, env=os.environ
-                    ).strip()
-                    if token:
-                        gh = Github(base_url=base_url, auth=Auth.Token(token))
-                        _logger.debug("Using GitHub authentication from gh cli.")
-                    else:
-                        raise RuntimeError("No token from gh auth token")
-                except Exception:
-                    _logger.warning(
-                        "Could not authenticate with GitHub to get releases. "
-                        "Consider setting .netrc, environment variable GH_TOKEN, "
-                        "or using GitHub CLI (`gh auth login`) to get GitHub releases.",
-                    )
-                    gh = Github(base_url=base_url)
-
-        # Determine owner and repo name
-        if "/" in self.config.repo:
-            owner, repo_name = self.config.repo.split("/", 1)
-        else:
-            # Try each remote to find a valid GitHub owner/repo
-            owner = None
-            repo_name = None
-            for remote in self.repo.remotes:
-                for url in remote.urls:
-                    match = re.search(
-                        r"(?P<host>[\w\.-]+)[/:](?P<owner>[^/]+)/(?P<repo>[^/.]+?)(?:\.git)?$",
-                        url,
-                    )
-                    if match:
-                        owner = match.group("owner")
-                        repo_name = match.group("repo")
-                        break
-                if owner and repo_name:
-                    break
-            if not (owner and repo_name):
-                raise PluginError(
-                    f"Could not determine GitHub repository owner/name from config.repo='{self.config.repo}' or any git remote URL."
-                )
-            self.config.repo = f"{owner}/{repo_name}"
-
-        # Get releases
-        gh_repo = gh.get_repo(f"{owner}/{repo_name}")
-        releases = list(gh_repo.get_releases())
-        for release in releases:
-            tag = release.tag_name
+        # Find matching tags
+        for tag in tags:
             if not self.semver and SEMVER_PATTERN.match(tag):
-                _logger.info(f"Using GitHub release tag '{tag}' for semver.")
+                _logger.info(f"Using git tag '{tag}' for semver.")
                 self.semver = tag
             if not self.major and MAJOR_PATTERN.match(tag):
-                _logger.info(f"Using GitHub release tag '{tag}' for major.")
+                _logger.info(f"Using git tag '{tag}' for major.")
                 self.major = tag
             if self.semver and self.major:
                 break
@@ -196,8 +132,8 @@ class GitHubHandler(BaseHandler):
             else:  # not self.major
                 messages = ("'vX'", "'major'")
             _logger.warning(
-                f"Could not find suitable GitHub releases for repo '{self.config.repo}'. "
-                f"Make sure there are releases with tags matching {messages[0]}, "
+                f"Could not find suitable git tags in repository. "
+                f"Make sure there are tags matching {messages[0]}, "
                 f"if you wish to use option signature_version {messages[1]}.",
             )