repomatic.github package

GitHub integration: API clients, the gh wrapper and per-surface helpers.

Covers every GitHub surface repomatic touches (releases, issues, PRs, tokens, workflows). See each submodule’s docstring for its scope.

Submodules

• repomatic.github.ci_status module
  • TIP_HISTORY_DEPTH
  • STABLE_GLYPH
  • UNSTABLE_GLYPH
  • TERMINAL_STATUSES
  • CI_STATUS_HEADER_DEFS
  • LOG_NAME_RE
  • RUN_FIELDS
  • JobStatus
    • JobStatus.name
    • JobStatus.status
    • JobStatus.conclusion
    • JobStatus.job_id
    • JobStatus.unexpanded
    • JobStatus.required
    • JobStatus.failed
    • JobStatus.running
    • JobStatus.skipped
    • JobStatus.cancelled
  • RunStatus
    • RunStatus.workflow
    • RunStatus.run_id
    • RunStatus.head_sha
    • RunStatus.status
    • RunStatus.conclusion
    • RunStatus.jobs
    • RunStatus.failed_required
    • RunStatus.failed_probes
    • RunStatus.running_jobs
    • RunStatus.unexpanded_jobs
    • RunStatus.workflow_level_failure
    • RunStatus.blocking
    • RunStatus.cancelled_required
    • RunStatus.cancelled
    • RunStatus.skipped
    • RunStatus.inconclusive
    • RunStatus.verdict
    • RunStatus.cells()
    • RunStatus.findings()
  • CIStatus
    • CIStatus.branch
    • CIStatus.tip_sha
    • CIStatus.runs
    • CIStatus.skipped_on_tip
    • CIStatus.blocking
    • CIStatus.runs_on_tip
    • CIStatus.settled
  • workflow_files()
  • monitored_workflows()
  • latest_run()
  • read_ci_status()
  • write_failed_logs()
  • WatchState
    • WatchState.path
    • WatchState.seen
    • WatchState.load()
    • WatchState.record()
  • watch_ci_status()
• repomatic.github.dev_release module
  • DEV_ASSET_PATTERNS
  • RELEASE_LIST_LIMIT
  • sync_dev_release()
  • upload_release_assets()
  • cleanup_dev_releases()
  • delete_release_by_tag()
• repomatic.github.event module
  • WorkflowEvent
    • WorkflowEvent.branch_protection_rule
    • WorkflowEvent.check_run
    • WorkflowEvent.check_suite
    • WorkflowEvent.create
    • WorkflowEvent.delete
    • WorkflowEvent.deployment
    • WorkflowEvent.deployment_status
    • WorkflowEvent.discussion
    • WorkflowEvent.discussion_comment
    • WorkflowEvent.fork
    • WorkflowEvent.gollum
    • WorkflowEvent.issue_comment
    • WorkflowEvent.issues
    • WorkflowEvent.label
    • WorkflowEvent.merge_group
    • WorkflowEvent.milestone
    • WorkflowEvent.page_build
    • WorkflowEvent.project
    • WorkflowEvent.project_card
    • WorkflowEvent.project_column
    • WorkflowEvent.public
    • WorkflowEvent.pull_request
    • WorkflowEvent.pull_request_comment
    • WorkflowEvent.pull_request_review
    • WorkflowEvent.pull_request_review_comment
    • WorkflowEvent.pull_request_target
    • WorkflowEvent.push
    • WorkflowEvent.registry_package
    • WorkflowEvent.release
    • WorkflowEvent.repository_dispatch
    • WorkflowEvent.schedule
    • WorkflowEvent.status
    • WorkflowEvent.watch
    • WorkflowEvent.workflow_call
    • WorkflowEvent.workflow_dispatch
    • WorkflowEvent.workflow_run
  • extract_workflow_filename()
  • get_github_event()
  • get_event_pull_request()
  • get_event_subject()
  • get_default_author()
  • get_default_number()
  • get_default_branch()
  • is_pull_request()
• repomatic.github.gh module
  • GhCommandError
    • GhCommandError.stdout
    • GhCommandError.stderr
    • GhCommandError.status
  • GhOutputError
  • gh_executable()
  • resolve_gh_token()
  • api_headers()
  • gh_env()
  • run_gh_command()
  • parse_create_output()
  • gh_json()
  • gh_api_pages()
  • gh_api_json()
  • gh_graphql()
  • iter_graphql_nodes()
• repomatic.github.issue module
  • ISSUE_LIST_LIMIT
  • Triage
    • Triage.keep
    • Triage.keep_state
    • Triage.close
  • list_issues()
  • close_issue()
  • reopen_issue()
  • create_issue()
  • update_issue()
  • triage_issues()
  • manage_issue_lifecycle()
• repomatic.github.job_timings module
  • UNATTRIBUTED
  • JOB_TIMINGS_HEADER_DEFS
  • JobTiming
    • JobTiming.name
    • JobTiming.runner
    • JobTiming.seconds
  • match_runner()
  • fetch_job_timings()
  • RunnerReport
    • RunnerReport.runner
    • RunnerReport.job_count
    • RunnerReport.median_seconds
    • RunnerReport.slowest_job
    • RunnerReport.slowest_seconds
    • RunnerReport.cells()
  • summarize()
  • format_duration()
  • render_markdown()
• repomatic.github.labels module
  • DEFAULT_CONTENT_RULES
  • DEFAULT_FILE_RULES
  • CONTENT_PATTERN_RE
  • CONTENT_PATTERN_FLAGS
  • GLOB_FLAGS
  • INLINE_LABEL_FIELDS
  • resolve_content_rules()
  • resolve_file_rules()
  • compile_content_pattern()
  • match_content_rules()
  • match_file_rules()
  • labels_for_thread()
  • serialize_inline_labels()
  • EXTRA_LABELS_DIR
  • extra_label_filename()
  • LabelSource
    • LabelSource.path
    • LabelSource.text
    • LabelSource.profiles
  • label_sources()
  • LabelConfigError
  • declared_label_names()
  • apply_labels()
• repomatic.github.outputs module
  • MAX_STEP_OUTPUT_BYTES
  • AnnotationLevel
    • AnnotationLevel.ERROR
    • AnnotationLevel.WARNING
    • AnnotationLevel.NOTICE
    • AnnotationLevel.glyph
  • generate_delimiter()
  • trim_to_budget()
  • trim_to_byte_budget()
  • format_multiline_output()
  • write_output_file()
  • format_file_output()
  • read_file_output()
  • write_text_output()
  • emit_report()
  • emit_annotation()
  • add_problem_matcher()
  • remove_problem_matcher()
  • report_finding()
• repomatic.github.pr module
  • STALE_PR_COMMENT
  • STALE_BUMP_PR_COMMENT
  • TEMP_BRANCH_PREFIX
  • AUTOMATION_PR_LIMIT
  • OPEN_PR_LIMIT
  • PrOperation
    • PrOperation.CREATED
    • PrOperation.UPDATED
    • PrOperation.CLOSED
    • PrOperation.NONE
  • PrSyncResult
    • PrSyncResult.operation
    • PrSyncResult.branch
    • PrSyncResult.number
    • PrSyncResult.url
  • list_open_prs_by_branch()
  • automation_branches()
  • behind_by()
  • list_automation_prs()
  • release_pr()
  • list_changed_files()
  • close_pr()
  • close_open_prs_on_branch()
  • close_stale_bump_prs()
  • carry_pr_branch_paths()
  • upsert_pr()
• repomatic.github.pr_body module
  • GITHUB_BODY_MAX_CHARS
  • TemplateArgumentError
  • PrContent
    • PrContent.title
    • PrContent.body
    • PrContent.commit_message
  • generate_pr_metadata_block()
  • generate_refresh_tip()
  • build_pr_body()
  • fit_github_body()
  • temp_body_file()
  • render_pr()
• repomatic.github.release_sync module
  • build_expected_body()
  • build_pypi_body()
  • build_draft_body()
  • SyncRow
    • SyncRow.action
    • SyncRow.version
    • SyncRow.release_url
  • SyncResult
    • SyncResult.dry_run
    • SyncResult.rows
    • SyncResult.total
    • SyncResult.in_sync
    • SyncResult.drifted
    • SyncResult.updated
    • SyncResult.failed
    • SyncResult.missing_changelog
  • sync_github_releases()
  • render_sync_report()
• repomatic.github.releases module
  • GITHUB_API_RELEASES_URL
  • GITHUB_API_TAG_REF_URL
  • GITHUB_API_TAG_OBJECT_URL
  • RELEASES_PAGE_SIZE
  • RELEASE_TAGS_CACHE
  • RELEASE_NOT_FOUND_MARKER
  • GitHubReleasesUnavailable
  • GitHubRelease
    • GitHubRelease.date
    • GitHubRelease.body
  • ReleaseAsset
    • ReleaseAsset.name
    • ReleaseAsset.size
    • ReleaseAsset.sha256
    • ReleaseAsset.download_url
  • ReleaseWithAssets
    • ReleaseWithAssets.tag
    • ReleaseWithAssets.date
    • ReleaseWithAssets.draft
    • ReleaseWithAssets.prerelease
    • ReleaseWithAssets.assets
    • ReleaseWithAssets.html_url
  • get_release_tags()
  • get_github_releases()
  • get_releases_with_assets()
  • dev_release_url_and_previous_version()
  • release_review_steps()
  • resolve_tag_to_sha()
  • extract_version()
  • edit_release_notes()
  • release_exists()
  • create_release()
  • upload_release_files()
  • ReleaseNotesRequest
    • ReleaseNotesRequest.name
    • ReleaseNotesRequest.repo_url
    • ReleaseNotesRequest.old
    • ReleaseNotesRequest.new
    • ReleaseNotesRequest.tag_pattern
    • ReleaseNotesRequest.skip
  • in_bump_range()
  • fetch_github_release_notes()
• repomatic.github.runs module
  • RUN_LISTING_WINDOW
  • RUNS_PAGE_SIZE
  • LIVE_RUN_STATUSES
  • ANSI_ESCAPE_RE
  • runs_created_since()
  • workflow_runs()
  • commit_runs()
  • read_run()
  • job_log()
  • live_runs()
  • cancel_superseded_runs()
• repomatic.github.sponsor module
  • SPONSORS_QUERY
  • iter_sponsors()
  • is_sponsor()
• repomatic.github.status module
  • GITHUB_STATUS_SUMMARY_URL
  • GitHubStatus
    • GitHubStatus.indicator
    • GitHubStatus.description
    • GitHubStatus.is_incident
    • GitHubStatus.annotation()
  • get_github_status()
  • status_annotation()
  • with_status_annotation()
• repomatic.github.threads module
  • BOT_ISSUE_LABEL
  • LOCKED_CONVERSATION_MARKER
  • LOCK_INACTIVE_DAYS
  • LOCK_ISSUE_COMMENT
  • LOCK_PR_COMMENT
  • LOCK_REASONS
  • LOCK_REASON
  • LOCK_THREADS_HEADER_DEFS
  • LOCK_SEARCH_LIMIT
  • ThreadKind
    • ThreadKind.ISSUE
    • ThreadKind.PR
    • ThreadKind.of()
    • ThreadKind.label
  • repo_args()
  • add_labels()
  • search_stale_threads()
  • lock_thread()
  • lock_stale_threads()
  • unlock_thread()
  • run_unlocking()
• repomatic.github.token module
  • PatProbe
    • PatProbe.field
    • PatProbe.permission
    • PatProbe.endpoint
    • PatProbe.success
    • PatProbe.not_found
    • PatProbe.name
    • PatProbe.run()
  • PAT_PERMISSION_PROBES
  • PatPermissionResults
    • PatPermissionResults.failed()
  • check_all_pat_permissions()
  • PAT_SCOPE_PROBE
  • PAT_SCOPE_PROBE_LIMIT
  • check_pat_repository_scope()
  • validate_gh_token_env()
  • GITHUB_RATE_LIMIT_URL
  • validate_gh_api_access()
  • validate_classic_pat_scope()
  • validate_notifications_token()
• repomatic.github.unsubscribe module
  • GRAPHQL_PAGE_SIZE
  • NOTIFICATION_PAGE_SIZE
  • NOTIFICATION_SUBJECT_TYPES
  • SUBJECT_BATCH_SIZE
  • SUBJECT_STATES
  • REPORT_TEMPLATE
  • SUBJECT_URL_PATTERN
  • UNSUBSCRIBE_WORKFLOW
  • DetailRow
    • DetailRow.action
    • DetailRow.html_url
    • DetailRow.number
    • DetailRow.repo
    • DetailRow.title
    • DetailRow.updated_at
  • PhaseResult
    • PhaseResult.cutoff
    • PhaseResult.max_unsubscribes
    • PhaseResult.total
    • PhaseResult.unsubscribed
    • PhaseResult.failed
    • PhaseResult.deferred
    • PhaseResult.skipped_recent
    • PhaseResult.rows
    • PhaseResult.skipped
    • PhaseResult.skip_reason
    • PhaseResult.skip()
    • PhaseResult.act()
  • Phase1Result
    • Phase1Result.newest_updated
    • Phase1Result.oldest_updated
    • Phase1Result.skipped_open
    • Phase1Result.skipped_unknown
  • Phase2Result
    • Phase2Result.not_subscribed
    • Phase2Result.search_query
  • UnsubscribeResult
    • UnsubscribeResult.dry_run
    • UnsubscribeResult.months
    • UnsubscribeResult.phase1
    • UnsubscribeResult.phase2
  • render_report()
  • unsubscribe_threads()
• repomatic.github.urls module
  • GITHUB_REPO_RE
  • parse_github_repo()
  • split_slug()
  • repo_name()
• repomatic.github.workflow_files module
  • WORKFLOW_DIR
  • GITHUB_YAML_PATTERNS
  • WORKFLOW_SUFFIXES
  • github_yaml_paths()
  • workflow_paths()
  • read_workflow_texts()
  • load_workflow()
  • parse_workflow_texts()
  • load_workflows()
  • workflow_triggers()
  • jobs_of()
  • steps_of()
  • iter_jobs()
  • iter_steps()
  • literal_runners()
• repomatic.github.workflow_sync module
  • CALLER_INPUT_DEFAULTS
  • COOLDOWN_DOCS_URL
  • cooldown_env_block()
  • PERMISSION_RANK
  • DEFAULT_VERSION
  • WorkflowTriggerInfo
    • WorkflowTriggerInfo.name
    • WorkflowTriggerInfo.filename
    • WorkflowTriggerInfo.non_call_triggers
    • WorkflowTriggerInfo.call_inputs
    • WorkflowTriggerInfo.call_secrets
    • WorkflowTriggerInfo.has_workflow_call
    • WorkflowTriggerInfo.concurrency
    • WorkflowTriggerInfo.raw_concurrency
  • canonical_caller_permissions()
  • extract_trigger_info()
  • PathsSpec
    • PathsSpec.source_paths
    • PathsSpec.extra_paths
    • PathsSpec.ignore_paths
    • PathsSpec.workflow_paths
  • generate_thin_caller()
  • EXTRA_JOBS_SEPARATOR
  • render_thin_caller_for_target()
  • GENERATED_CALLER_JOBS
  • canonical_workflow()
  • identify_canonical_workflow()
  • extract_extra_jobs()
  • extras_define_jobs()
  • generate_workflow_header()