GitHubKit 0.12.2__py3-none-any.whl → 0.12.3__py3-none-any.whl

githubkit/core.py

@@ -478,6 +478,11 @@ class GitHubCore(Generic[A]):
         response_model: Union[type[T], UnsetType] = UNSET,
         error_models: Optional[dict[str, type]] = None,
     ) -> Union[Response[T], Response[Any]]:
+        """Send a request.
+
+        Response will be checked and the request will be retried if necessary.
+        """
+
         retry_count: int = 0
         while True:
             try:
@@ -555,6 +560,11 @@ class GitHubCore(Generic[A]):
         response_model: Union[type[T], UnsetType] = UNSET,
         error_models: Optional[dict[str, type]] = None,
     ) -> Union[Response[T], Response[Any]]:
+        """Asynchronously send a request.
+
+        Response will be checked and the request will be retried if necessary.
+        """
+
         retry_count: int = 0
         while True:
             try:

githubkit/paginator.py

@@ -17,6 +17,8 @@ R = Union[
 
 
 class Paginator(Generic[RT]):
+    """Paginate through the responses of the rest api request."""
+
     @overload
     def __init__(
         self: "Paginator[RTS]",

githubkit/response.py

@@ -10,6 +10,8 @@ JT = TypeVar("JT", default=Any)
 
 
 class Response(Generic[MT, JT]):
+    """A wrapper around httpx.Response that provides data model validation."""
+
     def __init__(self, response: httpx.Response, data_model: type[MT]):
         self._response = response
         self._data_model = data_model
@@ -41,6 +43,33 @@ class Response(Generic[MT, JT]):
             else str(self.status_code)
         )
 
+    @property
+    def is_informational(self) -> bool:
+        return self._response.is_informational
+
+    @property
+    def is_success(self) -> bool:
+        return self._response.is_success
+
+    @property
+    def is_redirect(self) -> bool:
+        return self._response.is_redirect
+
+    @property
+    def is_client_error(self) -> bool:
+        return self._response.is_client_error
+
+    @property
+    def is_server_error(self) -> bool:
+        return self._response.is_server_error
+
+    @property
+    def is_error(self) -> bool:
+        return self._response.is_error
+
+    def raise_for_status(self) -> None:
+        self._response.raise_for_status()
+
     @property
     def headers(self) -> httpx.Headers:
         return self._response.headers

githubkit/rest/__init__.py

@@ -75,6 +75,9 @@ if TYPE_CHECKING:
     from githubkit.versions.v2022_11_28.models import (
         ApiOverviewPropDomains as ApiOverviewPropDomains,
     )
+    from githubkit.versions.v2022_11_28.models import (
+        ApiOverviewPropDomainsPropActionsInbound as ApiOverviewPropDomainsPropActionsInbound,
+    )
     from githubkit.versions.v2022_11_28.models import (
         ApiOverviewPropDomainsPropArtifactAttestations as ApiOverviewPropDomainsPropArtifactAttestations,
     )
@@ -276,6 +279,15 @@ if TYPE_CHECKING:
     from githubkit.versions.v2022_11_28.models import (
         CodeScanningAnalysisTool as CodeScanningAnalysisTool,
     )
+    from githubkit.versions.v2022_11_28.models import (
+        CodeScanningAutofix as CodeScanningAutofix,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        CodeScanningAutofixCommits as CodeScanningAutofixCommits,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        CodeScanningAutofixCommitsResponse as CodeScanningAutofixCommitsResponse,
+    )
     from githubkit.versions.v2022_11_28.models import (
         CodeScanningCodeqlDatabase as CodeScanningCodeqlDatabase,
     )
@@ -668,6 +680,27 @@ if TYPE_CHECKING:
     )
     from githubkit.versions.v2022_11_28.models import EmptyObject as EmptyObject
     from githubkit.versions.v2022_11_28.models import Enterprise as Enterprise
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdAttachPostBody as EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdAttachPostBody,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutBody as EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutBody,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutResponse200 as EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutResponse200,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBody as EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBody,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBodyPropDependencyGraphAutosubmitActionOptions as EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBodyPropDependencyGraphAutosubmitActionOptions,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsPostBody as EnterprisesEnterpriseCodeSecurityConfigurationsPostBody,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        EnterprisesEnterpriseCodeSecurityConfigurationsPostBodyPropDependencyGraphAutosubmitActionOptions as EnterprisesEnterpriseCodeSecurityConfigurationsPostBodyPropDependencyGraphAutosubmitActionOptions,
+    )
     from githubkit.versions.v2022_11_28.models import (
         EnterprisesEnterpriseSecretScanningAlertsGetResponse503 as EnterprisesEnterpriseSecretScanningAlertsGetResponse503,
     )
@@ -1087,6 +1120,12 @@ if TYPE_CHECKING:
     from githubkit.versions.v2022_11_28.models import (
         OrgMembershipPropPermissions as OrgMembershipPropPermissions,
     )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgPrivateRegistryConfiguration as OrgPrivateRegistryConfiguration,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgPrivateRegistryConfigurationWithSelectedRepositories as OrgPrivateRegistryConfigurationWithSelectedRepositories,
+    )
     from githubkit.versions.v2022_11_28.models import (
         OrgRepoCustomPropertyValues as OrgRepoCustomPropertyValues,
     )
@@ -1354,6 +1393,18 @@ if TYPE_CHECKING:
     from githubkit.versions.v2022_11_28.models import (
         OrgsOrgPersonalAccessTokensPostBody as OrgsOrgPersonalAccessTokensPostBody,
     )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgsOrgPrivateRegistriesGetResponse200 as OrgsOrgPrivateRegistriesGetResponse200,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgsOrgPrivateRegistriesPostBody as OrgsOrgPrivateRegistriesPostBody,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgsOrgPrivateRegistriesPublicKeyGetResponse200 as OrgsOrgPrivateRegistriesPublicKeyGetResponse200,
+    )
+    from githubkit.versions.v2022_11_28.models import (
+        OrgsOrgPrivateRegistriesSecretNamePatchBody as OrgsOrgPrivateRegistriesSecretNamePatchBody,
+    )
     from githubkit.versions.v2022_11_28.models import (
         OrgsOrgProjectsPostBody as OrgsOrgProjectsPostBody,
     )
@@ -9623,6 +9674,15 @@ else:
             "SimpleClassroomAssignment",
             "SimpleClassroom",
             "ClassroomAssignmentGrade",
+            "CodeSecurityConfiguration",
+            "CodeSecurityConfigurationPropDependencyGraphAutosubmitActionOptions",
+            "CodeSecurityConfigurationPropCodeScanningDefaultSetupOptions",
+            "CodeSecurityConfigurationPropSecretScanningDelegatedBypassOptions",
+            "CodeSecurityConfigurationPropSecretScanningDelegatedBypassOptionsPropReviewersItems",
+            "CodeScanningDefaultSetupOptions",
+            "CodeSecurityDefaultConfigurationsItems",
+            "SimpleRepository",
+            "CodeSecurityConfigurationRepositories",
             "DependabotAlertPackage",
             "DependabotAlertSecurityVulnerability",
             "DependabotAlertSecurityVulnerabilityPropFirstPatchedVersion",
@@ -9631,7 +9691,6 @@ else:
             "DependabotAlertSecurityAdvisoryPropCwesItems",
             "DependabotAlertSecurityAdvisoryPropIdentifiersItems",
             "DependabotAlertSecurityAdvisoryPropReferencesItems",
-            "SimpleRepository",
             "DependabotAlertWithRepository",
             "DependabotAlertWithRepositoryPropDependency",
             "OrganizationSecretScanningAlert",
@@ -9673,6 +9732,7 @@ else:
             "ApiOverview",
             "ApiOverviewPropSshKeyFingerprints",
             "ApiOverviewPropDomains",
+            "ApiOverviewPropDomainsPropActionsInbound",
             "ApiOverviewPropDomainsPropArtifactAttestations",
             "SecurityAndAnalysis",
             "SecurityAndAnalysisPropAdvancedSecurity",
@@ -9711,14 +9771,6 @@ else:
             "CodeScanningAlertLocation",
             "CodeScanningAlertInstancePropMessage",
             "CodeScanningOrganizationAlertItems",
-            "CodeSecurityConfiguration",
-            "CodeSecurityConfigurationPropDependencyGraphAutosubmitActionOptions",
-            "CodeSecurityConfigurationPropCodeScanningDefaultSetupOptions",
-            "CodeSecurityConfigurationPropSecretScanningDelegatedBypassOptions",
-            "CodeSecurityConfigurationPropSecretScanningDelegatedBypassOptionsPropReviewersItems",
-            "CodeScanningDefaultSetupOptions",
-            "CodeSecurityDefaultConfigurationsItems",
-            "CodeSecurityConfigurationRepositories",
             "CodespaceMachine",
             "Codespace",
             "CodespacePropGitStatus",
@@ -9782,6 +9834,7 @@ else:
             "OrganizationProgrammaticAccessGrantPropPermissionsPropOrganization",
             "OrganizationProgrammaticAccessGrantPropPermissionsPropRepository",
             "OrganizationProgrammaticAccessGrantPropPermissionsPropOther",
+            "OrgPrivateRegistryConfigurationWithSelectedRepositories",
             "Project",
             "CustomProperty",
             "CustomPropertySetPayload",
@@ -9992,6 +10045,9 @@ else:
             "CodeScanningAlertItems",
             "CodeScanningAlert",
             "CodeScanningAlertRule",
+            "CodeScanningAutofix",
+            "CodeScanningAutofixCommits",
+            "CodeScanningAutofixCommitsResponse",
             "CodeScanningAnalysis",
             "CodeScanningAnalysisDeletion",
             "CodeScanningCodeqlDatabase",
@@ -12455,6 +12511,13 @@ else:
             "ApplicationsClientIdTokenPatchBody",
             "ApplicationsClientIdTokenScopedPostBody",
             "EmojisGetResponse200",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsPostBody",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsPostBodyPropDependencyGraphAutosubmitActionOptions",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBody",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdPatchBodyPropDependencyGraphAutosubmitActionOptions",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdAttachPostBody",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutBody",
+            "EnterprisesEnterpriseCodeSecurityConfigurationsConfigurationIdDefaultsPutResponse200",
             "EnterprisesEnterpriseSecretScanningAlertsGetResponse503",
             "GistsPostBody",
             "GistsPostBodyPropFiles",
@@ -12559,6 +12622,11 @@ else:
             "OrgsOrgPersonalAccessTokenRequestsPatRequestIdPostBody",
             "OrgsOrgPersonalAccessTokensPostBody",
             "OrgsOrgPersonalAccessTokensPatIdPostBody",
+            "OrgsOrgPrivateRegistriesGetResponse200",
+            "OrgPrivateRegistryConfiguration",
+            "OrgsOrgPrivateRegistriesPostBody",
+            "OrgsOrgPrivateRegistriesPublicKeyGetResponse200",
+            "OrgsOrgPrivateRegistriesSecretNamePatchBody",
             "OrgsOrgProjectsPostBody",
             "OrgsOrgPropertiesSchemaPatchBody",
             "OrgsOrgPropertiesValuesPatchBody",

githubkit/retry.py

@@ -7,6 +7,8 @@ from .typing import RetryOption as RetryOption
 
 
 class RetryRateLimit:
+    """Retry decision function for rate limit exceeded."""
+
     __slots__ = ("max_retry",)
 
     def __init__(self, max_retry: int = 1) -> None:
@@ -30,6 +32,8 @@ RETRY_RATE_LIMIT = RetryRateLimit()
 
 
 class RetryServerError:
+    """Retry decision function for server error."""
+
     __slots__ = ("max_retry",)
 
     def __init__(self, max_retry: int = 3) -> None:
@@ -57,6 +61,8 @@ RETRY_SERVER_ERROR = RetryServerError()
 
 
 class RetryChainDecision:
+    """Chain multiple retry decision functions."""
+
     __slots__ = ("decision_funcs",)
 
     def __init__(self, *decision_funcs: RetryDecisionFunc) -> None:

githubkit/throttling.py

@@ -33,6 +33,8 @@ class BaseThrottler(abc.ABC):
 
 
 class LocalThrottler(BaseThrottler):
+    """Simple local throttler."""
+
     def __init__(self, max_concurrency: int) -> None:
         self.max_concurrency = max_concurrency
         self._semaphore: Optional[threading.Semaphore] = None