ghapi 2.1.4__tar.gz → 2.1.5__tar.gz

{ghapi-2.1.4/ghapi.egg-info → ghapi-2.1.5}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ghapi
-Version: 2.1.4
+Version: 2.1.5
 Summary: A python client for the GitHub API
 Author-email: Jeremy Howard <info@fast.ai>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Repository, https://github.com/fastai/ghapi
 Project-URL: Documentation, https://ghapi.fast.ai/
 Keywords: github,api
@@ -28,6 +28,7 @@ Requires-Dist: pyyaml; extra == "dev"
 Requires-Dist: pysym2md>=0.0.6; extra == "dev"
 Requires-Dist: llms-txt>=0.0.6; extra == "dev"
 Requires-Dist: pyskills>=0.0.30; extra == "dev"
+Requires-Dist: pycachy>=0.0.21; extra == "dev"
 Dynamic: license-file
 
 # ghapi

{ghapi-2.1.4 → ghapi-2.1.5}/ghapi/__init__.py

@@ -5,4 +5,4 @@ Modules:
 - `ghapi.graphql`: Query GitHub's GraphQL API with schema-aware chaining, batched requests and raw GraphQL
 - `ghapi.skill`: GitHub REST and GraphQL access, plus local git operations. Read before working with GitHub issues, PRs, CI, releases, branches, or gists, and before repo-local git operations."""
 
-__version__ = "2.1.4"
+__version__ = "2.1.5"

{ghapi-2.1.4 → ghapi-2.1.5}/ghapi/_modidx.py

@@ -22,7 +22,6 @@ d = { 'settings': { 'branch': 'main',
                                'ghapi.actions.github_token': ('actions.html#github_token', 'ghapi/actions.py'),
                                'ghapi.actions.set_git_user': ('actions.html#set_git_user', 'ghapi/actions.py'),
                                'ghapi.actions.user_repo': ('actions.html#user_repo', 'ghapi/actions.py')},
-            'ghapi.all': {},
             'ghapi.auth': { 'ghapi.auth.GhDeviceAuth': ('auth.html#ghdeviceauth', 'ghapi/auth.py'),
                             'ghapi.auth.GhDeviceAuth.__init__': ('auth.html#ghdeviceauth.__init__', 'ghapi/auth.py'),
                             'ghapi.auth.GhDeviceAuth._getattr': ('auth.html#ghdeviceauth._getattr', 'ghapi/auth.py'),
@@ -91,6 +90,7 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core._dur': ('core.html#_dur', 'ghapi/core.py'),
                             'ghapi.core._filter_diff': ('core.html#_filter_diff', 'ghapi/core.py'),
                             'ghapi.core._fmt_replies': ('core.html#_fmt_replies', 'ghapi/core.py'),
+                            'ghapi.core._fold_groups': ('core.html#_fold_groups', 'ghapi/core.py'),
                             'ghapi.core._include': ('core.html#_include', 'ghapi/core.py'),
                             'ghapi.core._listed': ('core.html#_listed', 'ghapi/core.py'),
                             'ghapi.core._load_tmpl': ('core.html#_load_tmpl', 'ghapi/core.py'),
@@ -99,6 +99,7 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.core._pr_mark': ('core.html#_pr_mark', 'ghapi/core.py'),
                             'ghapi.core._reduce_ctx': ('core.html#_reduce_ctx', 'ghapi/core.py'),
                             'ghapi.core._run_subp': ('core.html#_run_subp', 'ghapi/core.py'),
+                            'ghapi.core._step_lines': ('core.html#_step_lines', 'ghapi/core.py'),
                             'ghapi.core._transdeps': ('core.html#_transdeps', 'ghapi/core.py'),
                             'ghapi.core.call_gh': ('core.html#call_gh', 'ghapi/core.py'),
                             'ghapi.core.check_status': ('core.html#check_status', 'ghapi/core.py'),
@@ -153,8 +154,6 @@ d = { 'settings': { 'branch': 'main',
                              'ghapi.event._want_evt': ('event.html#_want_evt', 'ghapi/event.py'),
                              'ghapi.event.load_sample_events': ('event.html#load_sample_events', 'ghapi/event.py'),
                              'ghapi.event.save_sample_events': ('event.html#save_sample_events', 'ghapi/event.py')},
-            'ghapi.gh_spec': {},
-            'ghapi.gql_spec': {},
             'ghapi.graphql': { 'ghapi.graphql.GhGql': ('graphql.html#ghgql', 'ghapi/graphql.py'),
                                'ghapi.graphql.GhGql.__init__': ('graphql.html#ghgql.__init__', 'ghapi/graphql.py'),
                                'ghapi.graphql.GhGql.repo': ('graphql.html#ghgql.repo', 'ghapi/graphql.py')},
@@ -175,6 +174,4 @@ d = { 'settings': { 'branch': 'main',
                             'ghapi.page.pages': ('page.html#pages', 'ghapi/page.py'),
                             'ghapi.page.parse_link_hdr': ('page.html#parse_link_hdr', 'ghapi/page.py'),
                             'ghapi.page.sync_paged': ('page.html#sync_paged', 'ghapi/page.py'),
-                            'ghapi.page.sync_pages': ('page.html#sync_pages', 'ghapi/page.py')},
-            'ghapi.skill': {},
-            'ghapi.templates': {}}}
+                            'ghapi.page.sync_pages': ('page.html#sync_pages', 'ghapi/page.py')}}}

{ghapi-2.1.4 → ghapi-2.1.5}/ghapi/core.py

@@ -232,9 +232,7 @@ async def create_gist(self:GhApi, description, content, filename='gist.txt', pub
 @patch
 def load_gist(self:GhApi, gist_id:str):
     "Retrieve a gist by id, or by `user/id` (as it appears in gist URLs); coro if async client"
-    if '/' in gist_id: *_,user,gist_id = gist_id.split('/')
-    else: user = None
-    return self.gists.get(gist_id, user=user)
+    return self.gists.get(gist_id.split('/')[-1])
 
 @patch
 def gist_file(self:GhApi, gist_id:str):
@@ -420,9 +418,10 @@ async def enable_pages(self:GhApi, branch=None, path="/"):
     r = await self.repos.get()
     branch = branch or r.default_branch
     source = {"branch": branch, "path": path}
-    if r.has_pages: return # await self.repos.update_information_about_pages_site(source=source)
     if len(await self.list_branches(branch))==0: await self.create_branch_empty(branch)
-    return await self.repos.create_pages_site(source=source)
+    if not r.has_pages: return await self.repos.create_pages_site(source=source)
+    await self.repos.update_information_about_pages_site(source=source)
+    return await self.repos.get_pages()
 
 # %% ../nbs/00_core.ipynb #519ec71c
 class _IssueInfo(AttrDict):
@@ -647,20 +646,47 @@ async def pr_status(self:GhApi, pull_number:int):
     "Combined status and check-run results for a PR's head commit"
     return await self.check_status((await self.pulls.get(pull_number)).head.sha)
 
+# %% ../nbs/00_core.ipynb #40f5c88a
+def _step_lines(zf, job, s):
+    "Timestamped log lines for step `s` of `job`. They come from the step's own archive file, or else from the job's combined log, cut to the step's time window and its last `##[error]` line."
+    names = zf.namelist()
+    if name := first(n for n in names if n.startswith(f'{job.name}/{s.number}_')): return zf.read(name).decode().splitlines()
+    name = first(n for n in names if re.fullmatch(rf'\d+_{re.escape(job.name)}\.txt', n))
+    lines = [l for l in zf.read(name).decode('utf-8-sig').splitlines() if s.started_at[:19] <= l[:19] <= s.completed_at[:19]]
+    last = max((i for i,l in enumerate(lines) if l.split(' ', 1)[-1].startswith('##[error]')), default=len(lines)-1)
+    return lines[:last+1]
+
+# %% ../nbs/00_core.ipynb #fd5e2942
+def _fold_groups(lines, n=20):
+    "Fold each finished `##[group]` of more than `n` lines, unless it holds an error or warning. An unfinished group stays whole, since the step died inside it."
+    res, start = [], None
+    for l in lines:
+        res.append(l)
+        if l.startswith('##[group]'): start = len(res)
+        elif l.startswith('##[endgroup]') and start is not None:
+            body = res[start:-1]
+            if len(body) > n and not any(o.startswith(('##[error]', '##[warning]')) for o in body): res[start:-1] = [f'… {len(body)} lines folded']
+            start = None
+    return res
+
 # %% ../nbs/00_core.ipynb #569864f5
 @gh_patch
-async def failed_step_log(self:GhApi, job_id:int):
+async def failed_step_log(
+    self:GhApi,
+    job_id:int, # Workflow job id, which is also its check run id
+    fold:bool=True, # Fold long finished `##[group]` blocks that hold no error or warning?
+):
     """Return the failed steps' log sections, each headed by its step name.
 
-    An Actions check run's id is its job id. Pass that id from `check_status` or `pr_status`. The returned text's display is truncated at 8,000 characters. GitHub can expire or delete stored logs.
+    An Actions check run's id is its job id. Pass that id from `check_status` or `pr_status`. The returned text's display is truncated at 8,000 characters. Long finished `##[group]` blocks with no error or warning are folded to a line count. GitHub can expire or delete stored logs.
     """
     job = await self.actions.get_job_for_workflow_run(job_id=job_id)
     zf = zipfile.ZipFile(io.BytesIO(await self.actions.download_workflow_run_logs(run_id=job.run_id)))
     res = []
     for s in job.steps:
         if s.conclusion!='failure': continue
-        name = first(n for n in zf.namelist() if n.startswith(f'{job.name}/{s.number}_'))
-        lines = [strip_ansi(l.split(' ', 1)[-1]) for l in zf.read(name).decode().splitlines()]
+        lines = [strip_ansi(l.split(' ', 1)[-1]) for l in _step_lines(zf, job, s)]
+        if fold: lines = _fold_groups(lines)
         res.append(f'# {s.name}\n' + '\n'.join(lines))
     return TruncatedString('\n\n'.join(res), 8_000)
 

{ghapi-2.1.4 → ghapi-2.1.5}/ghapi/gh_spec.py

@@ -737,7 +737,7 @@ spec = {'base_url': 'https://api.github.com',
                                    'API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'after': 'A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For more information, see "[Using pagination in the REST '
                                   'API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
-                         'status': 'A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: `all`, `attached`, `attaching`, `removed`, `enforced`, `failed`, `updating`, `removed_by_enterprise`'},
+                         'status': 'A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: `all`, `attached`, `attaching`, `removed`, `enforced`, `failed`, `updating`, `removed_by_enterprise`, `enterprise_enforced`'},
           'docs_url': 'https://docs.github.com/rest/code-security/configurations#get-repositories-associated-with-an-enterprise-code-security-configuration'},
          {'group': 'copilot',
           'name': 'copilot_enterprise_one_day_usage_metrics',
@@ -2463,6 +2463,76 @@ spec = {'base_url': 'https://api.github.com',
           'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'default_workflow_permissions': 'The default workflow permissions granted to the GITHUB_TOKEN when running workflows.', 'can_approve_pull_request_reviews': 'Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.'},
           'body_examples': {'default': {'summary': 'Give read-only permission, and allow approving PRs.', 'value': {'default_workflow_permissions': 'read', 'can_approve_pull_request_reviews': True}}},
           'docs_url': 'https://docs.github.com/rest/actions/permissions#set-default-workflow-permissions-for-an-organization'},
+         {'group': 'actions',
+          'name': 'get_org_actions_policies',
+          'path': '/orgs/{org}/actions/policies',
+          'verb': 'GET',
+          'summary': 'List organization Actions policies',
+          'route_params': ['org'],
+          'query_params': ['per_page', 'page', 'has_parents'],
+          'required_params': ['org'],
+          'param_types': {'org': 'str', 'per_page': 'int', 'page': 'int', 'has_parents': 'bool'},
+          'param_defaults': {'per_page': 30, 'page': 1, 'has_parents': True},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'has_parents': 'Include policies configured at higher levels that apply to this organization'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#list-organization-actions-policies'},
+         {'group': 'actions',
+          'name': 'create_org_actions_policy',
+          'path': '/orgs/{org}/actions/policies',
+          'verb': 'POST',
+          'summary': 'Create an organization Actions policy',
+          'route_params': ['org'],
+          'body_params': ['name', 'enforcement', 'conditions', 'rules'],
+          'request_content_type': 'application/json',
+          'required_params': ['enforcement', 'name', 'org'],
+          'param_types': {'org': 'str', 'name': 'str', 'enforcement': 'str', 'conditions': 'dict', 'rules': 'list'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'name': 'The name of the policy.',
+                         'enforcement': 'The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights on the Rule Insights page (`evaluate` is only available with GitHub Enterprise).',
+                         'conditions': 'Conditions for an organization Actions policy. The conditions object should contain one of `repository_name`, `repository_id`, or `repository_property`, and may also contain `workflow_path`.',
+                         'rules': 'An array of rules within the policy.'},
+          'body_examples': {'default': {'summary': '', 'value': {'name': 'Require approved actors', 'enforcement': 'active', 'rules': [{'type': 'restrict_actions_actors', 'parameters': {'allowed_actors': [{'id': 1234, 'type': 'Team'}]}}]}}},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#create-an-organization-actions-policy'},
+         {'group': 'actions',
+          'name': 'get_org_actions_policy',
+          'path': '/orgs/{org}/actions/policies/{policy_id}',
+          'verb': 'GET',
+          'summary': 'Get an organization Actions policy',
+          'route_params': ['org', 'policy_id'],
+          'required_params': ['org', 'policy_id'],
+          'param_types': {'org': 'str', 'policy_id': 'int'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'policy_id': 'The ID of the policy.'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#get-an-organization-actions-policy'},
+         {'group': 'actions',
+          'name': 'update_org_actions_policy',
+          'path': '/orgs/{org}/actions/policies/{policy_id}',
+          'verb': 'PUT',
+          'summary': 'Update an organization Actions policy',
+          'route_params': ['org', 'policy_id'],
+          'body_params': ['name', 'enforcement', 'conditions', 'rules'],
+          'request_content_type': 'application/json',
+          'required_params': ['org', 'policy_id'],
+          'param_types': {'org': 'str', 'policy_id': 'int', 'name': 'str', 'enforcement': 'str', 'conditions': 'dict', 'rules': 'list'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'policy_id': 'The ID of the policy.',
+                         'name': 'The name of the policy.',
+                         'enforcement': 'The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights on the Rule Insights page (`evaluate` is only available with GitHub Enterprise).',
+                         'conditions': 'Conditions for an organization Actions policy. The conditions object should contain one of `repository_name`, `repository_id`, or `repository_property`, and may also contain `workflow_path`.',
+                         'rules': 'An array of rules within the policy.'},
+          'body_examples': {'default': {'summary': '', 'value': {'name': 'Updated policy name', 'enforcement': 'active'}}},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#update-an-organization-actions-policy'},
+         {'group': 'actions',
+          'name': 'delete_org_actions_policy',
+          'path': '/orgs/{org}/actions/policies/{policy_id}',
+          'verb': 'DELETE',
+          'summary': 'Delete an organization Actions policy',
+          'route_params': ['org', 'policy_id'],
+          'required_params': ['org', 'policy_id'],
+          'param_types': {'org': 'str', 'policy_id': 'int'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'policy_id': 'The ID of the policy.'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#delete-an-organization-actions-policy'},
          {'group': 'actions',
           'name': 'list_self_hosted_runner_groups_for_org',
           'path': '/orgs/{org}/actions/runner-groups',
@@ -3607,6 +3677,30 @@ spec = {'base_url': 'https://api.github.com',
           'param_types': {'org': 'str', 'campaign_number': 'int'},
           'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'campaign_number': 'The campaign number.'},
           'docs_url': 'https://docs.github.com/rest/campaigns/campaigns#delete-a-campaign-for-an-organization'},
+         {'group': 'code_scanning',
+          'name': 'get_ai_scan_enablement_for_org',
+          'path': '/orgs/{org}/code-scanning/ai-scan',
+          'verb': 'GET',
+          'summary': 'Get the AI Scan setting for an organization',
+          'route_params': ['org'],
+          'required_params': ['org'],
+          'param_types': {'org': 'str'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.'},
+          'docs_url': 'https://docs.github.com/rest/code-scanning/code-scanning#get-the-ai-scan-setting-for-an-organization'},
+         {'group': 'code_scanning',
+          'name': 'update_ai_scan_enablement_for_org',
+          'path': '/orgs/{org}/code-scanning/ai-scan',
+          'verb': 'PATCH',
+          'summary': 'Update the AI Scan setting for an organization',
+          'route_params': ['org'],
+          'body_params': ['pr_scan'],
+          'request_content_type': 'application/json',
+          'required_params': ['org'],
+          'param_types': {'org': 'str', 'pr_scan': 'str'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.',
+                         'pr_scan': 'Whether AI Scan is enabled for the organization. Organization respects enterprise policy. Disabled organizations prevent repositories from enabling AI Scan. Enabled organizations enable AI Scan for their repositories, but individual repositories can opt out.'},
+          'body_examples': {'default': {'summary': '', 'value': {'pr_scan': 'enabled'}}},
+          'docs_url': 'https://docs.github.com/rest/code-scanning/code-scanning#update-the-ai-scan-setting-for-an-organization'},
          {'group': 'code_scanning',
           'name': 'list_alerts_for_org',
           'path': '/orgs/{org}/code-scanning/alerts',
@@ -3940,7 +4034,7 @@ spec = {'base_url': 'https://api.github.com',
                                    'API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
                          'after': 'A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For more information, see "[Using pagination in the REST '
                                   'API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
-                         'status': 'A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: `all`, `attached`, `attaching`, `detached`, `removed`, `enforced`, `failed`, `updating`, `removed_by_enterprise`'},
+                         'status': 'A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: `all`, `attached`, `attaching`, `detached`, `removed`, `enforced`, `failed`, `updating`, `removed_by_enterprise`, `enterprise_enforced`'},
           'docs_url': 'https://docs.github.com/rest/code-security/configurations#get-repositories-associated-with-a-code-security-configuration'},
          {'group': 'codespaces',
           'name': 'list_in_organization',
@@ -5148,12 +5242,12 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'PATCH',
           'summary': 'Update pull request creation cap for an org',
           'route_params': ['org'],
-          'body_params': ['enabled', 'max_open_pull_requests'],
+          'body_params': ['enabled', 'max_open_pull_requests', 'include_drafts'],
           'request_content_type': 'application/json',
           'required_params': ['enabled', 'org'],
-          'param_types': {'org': 'str', 'enabled': 'bool', 'max_open_pull_requests': 'int'},
-          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'enabled': 'Whether the pull request creation cap is enabled', 'max_open_pull_requests': 'The maximum number of open pull requests a user can have at one time'},
-          'body_examples': {'default': {'summary': 'Example request body', 'value': {'enabled': True, 'max_open_pull_requests': 1}}},
+          'param_types': {'org': 'str', 'enabled': 'bool', 'max_open_pull_requests': 'int', 'include_drafts': 'bool'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'enabled': 'Whether the pull request creation cap is enabled', 'max_open_pull_requests': 'The maximum number of open pull requests a user can have at one time', 'include_drafts': 'Whether draft pull requests count toward the pull request creation cap'},
+          'body_examples': {'default': {'summary': 'Example request body', 'value': {'enabled': True, 'max_open_pull_requests': 1, 'include_drafts': True}}},
           'docs_url': 'https://docs.github.com/rest/interactions/orgs#update-pull-request-creation-cap-for-an-org'},
          {'group': 'orgs',
           'name': 'list_pending_invitations',
@@ -6898,7 +6992,7 @@ spec = {'base_url': 'https://api.github.com',
           'request_content_type': 'application/json',
           'required_params': ['org', 'patterns'],
           'param_types': {'org': 'str', 'patterns': 'list'},
-          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create.'},
+          'param_docs': {'org': 'The organization name. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create (maximum 100).'},
           'body_examples': {'default': {'summary': '', 'value': {'patterns': [{'name': 'Example Custom Pattern', 'pattern': '[a-z]+_token_[0-9]+'}, {'name': 'Another Custom Pattern', 'pattern': 'prefix_[a-zA-Z0-9]{32}', 'start_delimiter': '\\b', 'end_delimiter': '\\b', 'must_match': ['^prefix_prod'], 'must_not_match': ['test']}]}}},
           'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-create-organization-custom-patterns'},
          {'group': 'secret_scanning',
@@ -7992,6 +8086,79 @@ spec = {'base_url': 'https://api.github.com',
                          'can_approve_pull_request_reviews': 'Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.'},
           'body_examples': {'default': {'summary': 'Give read-only permission, and allow approving PRs.', 'value': {'default_workflow_permissions': 'read', 'can_approve_pull_request_reviews': True}}},
           'docs_url': 'https://docs.github.com/rest/actions/permissions#set-default-workflow-permissions-for-a-repository'},
+         {'group': 'actions',
+          'name': 'get_repo_actions_policies',
+          'path': '/repos/{owner}/{repo}/actions/policies',
+          'verb': 'GET',
+          'summary': 'List repository Actions policies',
+          'route_params': ['owner', 'repo'],
+          'query_params': ['per_page', 'page', 'has_parents'],
+          'required_params': ['owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'per_page': 'int', 'page': 'int', 'has_parents': 'bool'},
+          'param_defaults': {'per_page': 30, 'page': 1, 'has_parents': True},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'per_page': 'The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'page': 'The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."',
+                         'has_parents': 'Include policies configured at higher levels that apply to this repository'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#list-repository-actions-policies'},
+         {'group': 'actions',
+          'name': 'create_repo_actions_policy',
+          'path': '/repos/{owner}/{repo}/actions/policies',
+          'verb': 'POST',
+          'summary': 'Create a repository Actions policy',
+          'route_params': ['owner', 'repo'],
+          'body_params': ['name', 'enforcement', 'conditions', 'rules'],
+          'request_content_type': 'application/json',
+          'required_params': ['enforcement', 'name', 'owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'name': 'str', 'enforcement': 'str', 'conditions': 'dict', 'rules': 'list'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'name': 'The name of the policy.',
+                         'enforcement': 'The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights on the Rule Insights page (`evaluate` is only available with GitHub Enterprise).',
+                         'conditions': 'Conditions for a repository Actions policy. The object may be empty to preserve or use the default workflow targeting, or contain only `workflow_path`.',
+                         'rules': 'An array of rules within the policy.'},
+          'body_examples': {'default': {'summary': '', 'value': {'name': 'Require approved actors', 'enforcement': 'active', 'rules': [{'type': 'restrict_actions_actors', 'parameters': {'allowed_actors': [{'id': 1234, 'type': 'Team'}]}}]}}},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#create-a-repository-actions-policy'},
+         {'group': 'actions',
+          'name': 'get_repo_actions_policy',
+          'path': '/repos/{owner}/{repo}/actions/policies/{policy_id}',
+          'verb': 'GET',
+          'summary': 'Get a repository Actions policy',
+          'route_params': ['owner', 'repo', 'policy_id'],
+          'required_params': ['owner', 'policy_id', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'policy_id': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'policy_id': 'The ID of the policy.'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#get-a-repository-actions-policy'},
+         {'group': 'actions',
+          'name': 'update_repo_actions_policy',
+          'path': '/repos/{owner}/{repo}/actions/policies/{policy_id}',
+          'verb': 'PUT',
+          'summary': 'Update a repository Actions policy',
+          'route_params': ['owner', 'repo', 'policy_id'],
+          'body_params': ['name', 'enforcement', 'conditions', 'rules'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'policy_id', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'policy_id': 'int', 'name': 'str', 'enforcement': 'str', 'conditions': 'dict', 'rules': 'list'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
+                         'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
+                         'policy_id': 'The ID of the policy.',
+                         'name': 'The name of the policy.',
+                         'enforcement': 'The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights on the Rule Insights page (`evaluate` is only available with GitHub Enterprise).',
+                         'conditions': 'Conditions for a repository Actions policy. The object may be empty to preserve or use the default workflow targeting, or contain only `workflow_path`.',
+                         'rules': 'An array of rules within the policy.'},
+          'body_examples': {'default': {'summary': '', 'value': {'name': 'Updated policy name', 'enforcement': 'active'}}},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#update-a-repository-actions-policy'},
+         {'group': 'actions',
+          'name': 'delete_repo_actions_policy',
+          'path': '/repos/{owner}/{repo}/actions/policies/{policy_id}',
+          'verb': 'DELETE',
+          'summary': 'Delete a repository Actions policy',
+          'route_params': ['owner', 'repo', 'policy_id'],
+          'required_params': ['owner', 'policy_id', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'policy_id': 'int'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'policy_id': 'The ID of the policy.'},
+          'docs_url': 'https://docs.github.com/rest/actions/policies#delete-a-repository-actions-policy'},
          {'group': 'actions',
           'name': 'list_self_hosted_runners_for_repo',
           'path': '/repos/{owner}/{repo}/actions/runners',
@@ -9788,6 +9955,29 @@ spec = {'base_url': 'https://api.github.com',
                          'ai_findings_option': 'Whether AI findings run for Code Quality on this repository.'},
           'body_examples': {'default': {'summary': '', 'value': {'state': 'configured', 'languages': ['javascript-typescript', 'python', 'ruby']}}},
           'docs_url': 'https://docs.github.com/rest/code-quality/code-quality#update-a-code-quality-setup-configuration'},
+         {'group': 'code_scanning',
+          'name': 'get_ai_scan_enablement',
+          'path': '/repos/{owner}/{repo}/code-scanning/ai-scan',
+          'verb': 'GET',
+          'summary': 'Get AI Scan enablement for a repository',
+          'route_params': ['owner', 'repo'],
+          'required_params': ['owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.'},
+          'docs_url': 'https://docs.github.com/rest/code-scanning/code-scanning#get-ai-scan-enablement-for-a-repository'},
+         {'group': 'code_scanning',
+          'name': 'update_ai_scan_enablement',
+          'path': '/repos/{owner}/{repo}/code-scanning/ai-scan',
+          'verb': 'PATCH',
+          'summary': 'Update AI Scan enablement for a repository',
+          'route_params': ['owner', 'repo'],
+          'body_params': ['pr_scan'],
+          'request_content_type': 'application/json',
+          'required_params': ['owner', 'repo'],
+          'param_types': {'owner': 'str', 'repo': 'str', 'pr_scan': 'str'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'pr_scan': 'Whether to enable or disable AI Scan for the repository.'},
+          'body_examples': {'default': {'summary': 'Enable AI Scan', 'value': {'pr_scan': 'enabled'}}},
+          'docs_url': 'https://docs.github.com/rest/code-scanning/code-scanning#update-ai-scan-enablement-for-a-repository'},
          {'group': 'code_scanning',
           'name': 'list_alerts_for_repo',
           'path': '/repos/{owner}/{repo}/code-scanning/alerts',
@@ -10319,7 +10509,7 @@ spec = {'base_url': 'https://api.github.com',
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'username': 'The handle for the GitHub user account.',
-                         'permission': 'The permission to grant the collaborator. **Only valid on organization-owned repositories.** We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any.'},
+                         'permission': 'The permission to grant the collaborator. **Only valid on organization-owned repositories.** We accept the following permissions to be set: `pull`, `triage`, `triage_plus`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any.'},
           'body_examples': {'new-invitation-is-created': {'summary': 'Add a collaborator with triage permissions', 'value': {'permission': 'triage'}}},
           'docs_url': 'https://docs.github.com/rest/collaborators/collaborators#add-a-repository-collaborator'},
          {'group': 'repos',
@@ -12047,15 +12237,16 @@ spec = {'base_url': 'https://api.github.com',
           'verb': 'PATCH',
           'summary': 'Update pull request creation cap for a repository',
           'route_params': ['owner', 'repo'],
-          'body_params': ['enabled', 'max_open_pull_requests'],
+          'body_params': ['enabled', 'max_open_pull_requests', 'include_drafts'],
           'request_content_type': 'application/json',
           'required_params': ['enabled', 'owner', 'repo'],
-          'param_types': {'owner': 'str', 'repo': 'str', 'enabled': 'bool', 'max_open_pull_requests': 'int'},
+          'param_types': {'owner': 'str', 'repo': 'str', 'enabled': 'bool', 'max_open_pull_requests': 'int', 'include_drafts': 'bool'},
           'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.',
                          'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.',
                          'enabled': 'Whether the pull request creation cap is enabled',
-                         'max_open_pull_requests': 'The maximum number of open pull requests a user can have at one time'},
-          'body_examples': {'default': {'summary': 'Example request body', 'value': {'enabled': True, 'max_open_pull_requests': 1}}},
+                         'max_open_pull_requests': 'The maximum number of open pull requests a user can have at one time',
+                         'include_drafts': 'Whether draft pull requests count toward the pull request creation cap'},
+          'body_examples': {'default': {'summary': 'Example request body', 'value': {'enabled': True, 'max_open_pull_requests': 1, 'include_drafts': True}}},
           'docs_url': 'https://docs.github.com/rest/interactions/repos#update-pull-request-creation-cap-for-a-repository'},
          {'group': 'repos',
           'name': 'list_invitations',
@@ -14409,7 +14600,7 @@ spec = {'base_url': 'https://api.github.com',
           'request_content_type': 'application/json',
           'required_params': ['owner', 'patterns', 'repo'],
           'param_types': {'owner': 'str', 'repo': 'str', 'patterns': 'list'},
-          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create.'},
+          'param_docs': {'owner': 'The account owner of the repository. The name is not case sensitive.', 'repo': 'The name of the repository without the `.git` extension. The name is not case sensitive.', 'patterns': 'The list of custom patterns to create (maximum 100).'},
           'body_examples': {'default': {'summary': '', 'value': {'patterns': [{'name': 'Example Custom Pattern', 'pattern': '[a-z]+_token_[0-9]+'}, {'name': 'Another Custom Pattern', 'pattern': 'prefix_[a-zA-Z0-9]{32}', 'start_delimiter': '\\b', 'end_delimiter': '\\b', 'must_match': ['^prefix_prod'], 'must_not_match': ['test']}]}}},
           'docs_url': 'https://docs.github.com/rest/secret-scanning/custom-patterns#bulk-create-repository-custom-patterns'},
          {'group': 'secret_scanning',