github-events 0.1.0__py3-none-any.whl

github_events/_registry.py

@@ -0,0 +1,485 @@
+"""Event name/type registry. GENERATED by scripts/generate_models.py (octokit/webhooks-schemas 7.6.1)."""
+
+from types import UnionType
+from typing import Literal
+
+from github_events import _models as m
+
+EventName = Literal[
+    'branch_protection_configuration',
+    'branch_protection_rule',
+    'check_run',
+    'check_suite',
+    'code_scanning_alert',
+    'commit_comment',
+    'create',
+    'custom_property',
+    'custom_property_values',
+    'delete',
+    'dependabot_alert',
+    'deploy_key',
+    'deployment',
+    'deployment_protection_rule',
+    'deployment_review',
+    'deployment_status',
+    'discussion',
+    'discussion_comment',
+    'fork',
+    'github_app_authorization',
+    'gollum',
+    'installation',
+    'installation_repositories',
+    'installation_target',
+    'issue_comment',
+    'issues',
+    'label',
+    'marketplace_purchase',
+    'member',
+    'membership',
+    'merge_group',
+    'meta',
+    'milestone',
+    'org_block',
+    'organization',
+    'package',
+    'page_build',
+    'ping',
+    'project',
+    'project_card',
+    'project_column',
+    'projects_v2_item',
+    'public',
+    'pull_request',
+    'pull_request_review',
+    'pull_request_review_comment',
+    'pull_request_review_thread',
+    'push',
+    'registry_package',
+    'release',
+    'repository',
+    'repository_dispatch',
+    'repository_import',
+    'repository_vulnerability_alert',
+    'secret_scanning_alert',
+    'secret_scanning_alert_location',
+    'security_advisory',
+    'sponsorship',
+    'star',
+    'status',
+    'team',
+    'team_add',
+    'watch',
+    'workflow_dispatch',
+    'workflow_job',
+    'workflow_run',
+]
+
+EVENT_NAMES: tuple[str, ...] = ('branch_protection_configuration', 'branch_protection_rule', 'check_run', 'check_suite', 'code_scanning_alert', 'commit_comment', 'create', 'custom_property', 'custom_property_values', 'delete', 'dependabot_alert', 'deploy_key', 'deployment', 'deployment_protection_rule', 'deployment_review', 'deployment_status', 'discussion', 'discussion_comment', 'fork', 'github_app_authorization', 'gollum', 'installation', 'installation_repositories', 'installation_target', 'issue_comment', 'issues', 'label', 'marketplace_purchase', 'member', 'membership', 'merge_group', 'meta', 'milestone', 'org_block', 'organization', 'package', 'page_build', 'ping', 'project', 'project_card', 'project_column', 'projects_v2_item', 'public', 'pull_request', 'pull_request_review', 'pull_request_review_comment', 'pull_request_review_thread', 'push', 'registry_package', 'release', 'repository', 'repository_dispatch', 'repository_import', 'repository_vulnerability_alert', 'secret_scanning_alert', 'secret_scanning_alert_location', 'security_advisory', 'sponsorship', 'star', 'status', 'team', 'team_add', 'watch', 'workflow_dispatch', 'workflow_job', 'workflow_run')
+
+EVENT_TYPES: dict[str, object] = {
+    'branch_protection_configuration': m.BranchProtectionConfigurationEvent,
+    'branch_protection_rule': m.BranchProtectionRuleEvent,
+    'check_run': m.CheckRunEvent,
+    'check_suite': m.CheckSuiteEvent,
+    'code_scanning_alert': m.CodeScanningAlertEvent,
+    'commit_comment': m.CommitCommentEvent,
+    'create': m.CreateEvent,
+    'custom_property': m.CustomPropertyEvent,
+    'custom_property_values': m.CustomPropertyValuesEvent,
+    'delete': m.DeleteEvent,
+    'dependabot_alert': m.DependabotAlertEvent,
+    'deploy_key': m.DeployKeyEvent,
+    'deployment': m.DeploymentEvent,
+    'deployment_protection_rule': m.DeploymentProtectionRuleEvent,
+    'deployment_review': m.DeploymentReviewEvent,
+    'deployment_status': m.DeploymentStatusEvent,
+    'discussion': m.DiscussionEvent,
+    'discussion_comment': m.DiscussionCommentEvent,
+    'fork': m.ForkEvent,
+    'github_app_authorization': m.GitHubAppAuthorizationEvent,
+    'gollum': m.GollumEvent,
+    'installation': m.InstallationEvent,
+    'installation_repositories': m.InstallationRepositoriesEvent,
+    'installation_target': m.InstallationTargetEvent,
+    'issue_comment': m.IssueCommentEvent,
+    'issues': m.IssuesEvent,
+    'label': m.LabelEvent,
+    'marketplace_purchase': m.MarketplacePurchaseEvent,
+    'member': m.MemberEvent,
+    'membership': m.MembershipEvent,
+    'merge_group': m.MergeGroupEvent,
+    'meta': m.MetaEvent,
+    'milestone': m.MilestoneEvent,
+    'org_block': m.OrgBlockEvent,
+    'organization': m.OrganizationEvent,
+    'package': m.PackageEvent,
+    'page_build': m.PageBuildEvent,
+    'ping': m.PingEvent,
+    'project': m.ProjectEvent,
+    'project_card': m.ProjectCardEvent,
+    'project_column': m.ProjectColumnEvent,
+    'projects_v2_item': m.ProjectsV2ItemEvent,
+    'public': m.PublicEvent,
+    'pull_request': m.PullRequestEvent,
+    'pull_request_review': m.PullRequestReviewEvent,
+    'pull_request_review_comment': m.PullRequestReviewCommentEvent,
+    'pull_request_review_thread': m.PullRequestReviewThreadEvent,
+    'push': m.PushEvent,
+    'registry_package': m.RegistryPackageEvent,
+    'release': m.ReleaseEvent,
+    'repository': m.RepositoryEvent,
+    'repository_dispatch': m.RepositoryDispatchEvent,
+    'repository_import': m.RepositoryImportEvent,
+    'repository_vulnerability_alert': m.RepositoryVulnerabilityAlertEvent,
+    'secret_scanning_alert': m.SecretScanningAlertEvent,
+    'secret_scanning_alert_location': m.SecretScanningAlertLocationEvent,
+    'security_advisory': m.SecurityAdvisoryEvent,
+    'sponsorship': m.SponsorshipEvent,
+    'star': m.StarEvent,
+    'status': m.StatusEvent,
+    'team': m.TeamEvent,
+    'team_add': m.TeamAddEvent,
+    'watch': m.WatchEvent,
+    'workflow_dispatch': m.WorkflowDispatchEvent,
+    'workflow_job': m.WorkflowJobEvent,
+    'workflow_run': m.WorkflowRunEvent,
+}
+
+ACTION_EVENTS: frozenset[str] = frozenset({
+    'branch_protection_configuration',
+    'branch_protection_rule',
+    'check_run',
+    'check_suite',
+    'code_scanning_alert',
+    'commit_comment',
+    'custom_property',
+    'custom_property_values',
+    'dependabot_alert',
+    'deploy_key',
+    'deployment',
+    'deployment_protection_rule',
+    'deployment_review',
+    'deployment_status',
+    'discussion',
+    'discussion_comment',
+    'github_app_authorization',
+    'installation',
+    'installation_repositories',
+    'installation_target',
+    'issue_comment',
+    'issues',
+    'label',
+    'marketplace_purchase',
+    'member',
+    'membership',
+    'merge_group',
+    'meta',
+    'milestone',
+    'org_block',
+    'organization',
+    'package',
+    'project',
+    'project_card',
+    'project_column',
+    'projects_v2_item',
+    'pull_request',
+    'pull_request_review',
+    'pull_request_review_comment',
+    'pull_request_review_thread',
+    'registry_package',
+    'release',
+    'repository',
+    'repository_vulnerability_alert',
+    'secret_scanning_alert',
+    'secret_scanning_alert_location',
+    'security_advisory',
+    'sponsorship',
+    'star',
+    'team',
+    'watch',
+    'workflow_job',
+    'workflow_run',
+})
+
+ACTION_TYPES: dict[tuple[str, str], type | UnionType] = {
+    ('branch_protection_configuration', 'disabled'): m.BranchProtectionConfigurationDisabledEvent,
+    ('branch_protection_configuration', 'enabled'): m.BranchProtectionConfigurationEnabledEvent,
+    ('branch_protection_rule', 'created'): m.BranchProtectionRuleCreatedEvent,
+    ('branch_protection_rule', 'deleted'): m.BranchProtectionRuleDeletedEvent,
+    ('branch_protection_rule', 'edited'): m.BranchProtectionRuleEditedEvent,
+    ('check_run', 'completed'): m.CheckRunCompletedEvent,
+    ('check_run', 'created'): m.CheckRunCreatedEvent,
+    ('check_run', 'requested_action'): m.CheckRunRequestedActionEvent,
+    ('check_run', 'rerequested'): m.CheckRunRerequestedEvent,
+    ('check_suite', 'completed'): m.CheckSuiteCompletedEvent,
+    ('check_suite', 'requested'): m.CheckSuiteRequestedEvent,
+    ('check_suite', 'rerequested'): m.CheckSuiteRerequestedEvent,
+    ('code_scanning_alert', 'appeared_in_branch'): m.CodeScanningAlertAppearedInBranchEvent,
+    ('code_scanning_alert', 'closed_by_user'): m.CodeScanningAlertClosedByUserEvent,
+    ('code_scanning_alert', 'created'): m.CodeScanningAlertCreatedEvent,
+    ('code_scanning_alert', 'fixed'): m.CodeScanningAlertFixedEvent,
+    ('code_scanning_alert', 'reopened'): m.CodeScanningAlertReopenedEvent,
+    ('code_scanning_alert', 'reopened_by_user'): m.CodeScanningAlertReopenedByUserEvent,
+    ('commit_comment', 'created'): m.CommitCommentCreatedEvent,
+    ('custom_property', 'created'): m.CustomPropertyCreatedEvent,
+    ('custom_property', 'deleted'): m.CustomPropertyDeletedEvent,
+    ('custom_property_values', 'updated'): m.CustomPropertyValuesUpdatedEvent,
+    ('dependabot_alert', 'created'): m.DependabotAlertCreatedEvent,
+    ('dependabot_alert', 'dismissed'): m.DependabotAlertDismissedEvent,
+    ('dependabot_alert', 'fixed'): m.DependabotAlertFixedEvent,
+    ('dependabot_alert', 'reintroduced'): m.DependabotAlertReintroducedEvent,
+    ('dependabot_alert', 'reopened'): m.DependabotAlertReopenedEvent,
+    ('deploy_key', 'created'): m.DeployKeyCreatedEvent,
+    ('deploy_key', 'deleted'): m.DeployKeyDeletedEvent,
+    ('deployment', 'created'): m.DeploymentCreatedEvent,
+    ('deployment_protection_rule', 'requested'): m.DeploymentProtectionRuleRequestedEvent,
+    ('deployment_review', 'approved'): m.DeploymentReviewApprovedEvent,
+    ('deployment_review', 'rejected'): m.DeploymentReviewRejectedEvent,
+    ('deployment_review', 'requested'): m.DeploymentReviewRequestedEvent,
+    ('deployment_status', 'created'): m.DeploymentStatusCreatedEvent,
+    ('discussion', 'answered'): m.DiscussionAnsweredEvent,
+    ('discussion', 'category_changed'): m.DiscussionCategoryChangedEvent,
+    ('discussion', 'created'): m.DiscussionCreatedEvent,
+    ('discussion', 'deleted'): m.DiscussionDeletedEvent,
+    ('discussion', 'edited'): m.DiscussionEditedEvent,
+    ('discussion', 'labeled'): m.DiscussionLabeledEvent,
+    ('discussion', 'locked'): m.DiscussionLockedEvent,
+    ('discussion', 'pinned'): m.DiscussionPinnedEvent,
+    ('discussion', 'transferred'): m.DiscussionTransferredEvent,
+    ('discussion', 'unanswered'): m.DiscussionUnansweredEvent,
+    ('discussion', 'unlabeled'): m.DiscussionUnlabeledEvent,
+    ('discussion', 'unlocked'): m.DiscussionUnlockedEvent,
+    ('discussion', 'unpinned'): m.DiscussionUnpinnedEvent,
+    ('discussion_comment', 'created'): m.DiscussionCommentCreatedEvent,
+    ('discussion_comment', 'deleted'): m.DiscussionCommentDeletedEvent,
+    ('discussion_comment', 'edited'): m.DiscussionCommentEditedEvent,
+    ('github_app_authorization', 'revoked'): m.GitHubAppAuthorizationRevokedEvent,
+    ('installation', 'created'): m.InstallationCreatedEvent,
+    ('installation', 'deleted'): m.InstallationDeletedEvent,
+    ('installation', 'new_permissions_accepted'): m.InstallationNewPermissionsAcceptedEvent,
+    ('installation', 'suspend'): m.InstallationSuspendEvent,
+    ('installation', 'unsuspend'): m.InstallationUnsuspendEvent,
+    ('installation_repositories', 'added'): m.InstallationRepositoriesAddedEvent,
+    ('installation_repositories', 'removed'): m.InstallationRepositoriesRemovedEvent,
+    ('installation_target', 'renamed'): m.InstallationTargetRenamedEvent,
+    ('issue_comment', 'created'): m.IssueCommentCreatedEvent,
+    ('issue_comment', 'deleted'): m.IssueCommentDeletedEvent,
+    ('issue_comment', 'edited'): m.IssueCommentEditedEvent,
+    ('issues', 'assigned'): m.IssuesAssignedEvent,
+    ('issues', 'closed'): m.IssuesClosedEvent,
+    ('issues', 'deleted'): m.IssuesDeletedEvent,
+    ('issues', 'demilestoned'): m.IssuesDemilestonedEvent,
+    ('issues', 'edited'): m.IssuesEditedEvent,
+    ('issues', 'labeled'): m.IssuesLabeledEvent,
+    ('issues', 'locked'): m.IssuesLockedEvent,
+    ('issues', 'milestoned'): m.IssuesMilestonedEvent,
+    ('issues', 'opened'): m.IssuesOpenedEvent,
+    ('issues', 'pinned'): m.IssuesPinnedEvent,
+    ('issues', 'reopened'): m.IssuesReopenedEvent,
+    ('issues', 'transferred'): m.IssuesTransferredEvent,
+    ('issues', 'unassigned'): m.IssuesUnassignedEvent,
+    ('issues', 'unlabeled'): m.IssuesUnlabeledEvent,
+    ('issues', 'unlocked'): m.IssuesUnlockedEvent,
+    ('issues', 'unpinned'): m.IssuesUnpinnedEvent,
+    ('label', 'created'): m.LabelCreatedEvent,
+    ('label', 'deleted'): m.LabelDeletedEvent,
+    ('label', 'edited'): m.LabelEditedEvent,
+    ('marketplace_purchase', 'cancelled'): m.MarketplacePurchaseCancelledEvent,
+    ('marketplace_purchase', 'changed'): m.MarketplacePurchaseChangedEvent,
+    ('marketplace_purchase', 'pending_change'): m.MarketplacePurchasePendingChangeEvent,
+    ('marketplace_purchase', 'pending_change_cancelled'): m.MarketplacePurchasePendingChangeCancelledEvent,
+    ('marketplace_purchase', 'purchased'): m.MarketplacePurchasePurchasedEvent,
+    ('member', 'added'): m.MemberAddedEvent,
+    ('member', 'edited'): m.MemberEditedEvent,
+    ('member', 'removed'): m.MemberRemovedEvent,
+    ('membership', 'added'): m.MembershipAddedEvent,
+    ('membership', 'removed'): m.MembershipRemovedEvent,
+    ('merge_group', 'checks_requested'): m.MergeGroupChecksRequestedEvent,
+    ('merge_group', 'destroyed'): m.MergeGroupDestroyedEvent,
+    ('meta', 'deleted'): m.MetaDeletedEvent,
+    ('milestone', 'closed'): m.MilestoneClosedEvent,
+    ('milestone', 'created'): m.MilestoneCreatedEvent,
+    ('milestone', 'deleted'): m.MilestoneDeletedEvent,
+    ('milestone', 'edited'): m.MilestoneEditedEvent,
+    ('milestone', 'opened'): m.MilestoneOpenedEvent,
+    ('org_block', 'blocked'): m.OrgBlockBlockedEvent,
+    ('org_block', 'unblocked'): m.OrgBlockUnblockedEvent,
+    ('organization', 'deleted'): m.OrganizationDeletedEvent,
+    ('organization', 'member_added'): m.OrganizationMemberAddedEvent,
+    ('organization', 'member_invited'): m.OrganizationMemberInvitedEvent,
+    ('organization', 'member_removed'): m.OrganizationMemberRemovedEvent,
+    ('organization', 'renamed'): m.OrganizationRenamedEvent,
+    ('package', 'published'): m.PackagePublishedEvent,
+    ('package', 'updated'): m.PackageUpdatedEvent,
+    ('project', 'closed'): m.ProjectClosedEvent,
+    ('project', 'created'): m.ProjectCreatedEvent,
+    ('project', 'deleted'): m.ProjectDeletedEvent,
+    ('project', 'edited'): m.ProjectEditedEvent,
+    ('project', 'reopened'): m.ProjectReopenedEvent,
+    ('project_card', 'converted'): m.ProjectCardConvertedEvent,
+    ('project_card', 'created'): m.ProjectCardCreatedEvent,
+    ('project_card', 'deleted'): m.ProjectCardDeletedEvent,
+    ('project_card', 'edited'): m.ProjectCardEditedEvent,
+    ('project_card', 'moved'): m.ProjectCardMovedEvent,
+    ('project_column', 'created'): m.ProjectColumnCreatedEvent,
+    ('project_column', 'deleted'): m.ProjectColumnDeletedEvent,
+    ('project_column', 'edited'): m.ProjectColumnEditedEvent,
+    ('project_column', 'moved'): m.ProjectColumnMovedEvent,
+    ('projects_v2_item', 'archived'): m.ProjectsV2ItemArchivedEvent,
+    ('projects_v2_item', 'converted'): m.ProjectsV2ItemConvertedEvent,
+    ('projects_v2_item', 'created'): m.ProjectsV2ItemCreatedEvent,
+    ('projects_v2_item', 'deleted'): m.ProjectsV2ItemDeletedEvent,
+    ('projects_v2_item', 'edited'): m.ProjectsV2ItemEditedEvent,
+    ('projects_v2_item', 'reordered'): m.ProjectsV2ItemReorderedEvent,
+    ('projects_v2_item', 'restored'): m.ProjectsV2ItemRestoredEvent,
+    ('pull_request', 'assigned'): m.PullRequestAssignedEvent,
+    ('pull_request', 'auto_merge_disabled'): m.PullRequestAutoMergeDisabledEvent,
+    ('pull_request', 'auto_merge_enabled'): m.PullRequestAutoMergeEnabledEvent,
+    ('pull_request', 'closed'): m.PullRequestClosedEvent,
+    ('pull_request', 'converted_to_draft'): m.PullRequestConvertedToDraftEvent,
+    ('pull_request', 'demilestoned'): m.PullRequestDemilestonedEvent,
+    ('pull_request', 'dequeued'): m.PullRequestDequeuedEvent,
+    ('pull_request', 'edited'): m.PullRequestEditedEvent,
+    ('pull_request', 'enqueued'): m.PullRequestEnqueuedEvent,
+    ('pull_request', 'labeled'): m.PullRequestLabeledEvent,
+    ('pull_request', 'locked'): m.PullRequestLockedEvent,
+    ('pull_request', 'milestoned'): m.PullRequestMilestonedEvent,
+    ('pull_request', 'opened'): m.PullRequestOpenedEvent,
+    ('pull_request', 'ready_for_review'): m.PullRequestReadyForReviewEvent,
+    ('pull_request', 'reopened'): m.PullRequestReopenedEvent,
+    ('pull_request', 'review_request_removed'): m.PullRequestReviewRequestRemovedEvent,
+    ('pull_request', 'review_requested'): m.PullRequestReviewRequestedEvent,
+    ('pull_request', 'synchronize'): m.PullRequestSynchronizeEvent,
+    ('pull_request', 'unassigned'): m.PullRequestUnassignedEvent,
+    ('pull_request', 'unlabeled'): m.PullRequestUnlabeledEvent,
+    ('pull_request', 'unlocked'): m.PullRequestUnlockedEvent,
+    ('pull_request_review', 'dismissed'): m.PullRequestReviewDismissedEvent,
+    ('pull_request_review', 'edited'): m.PullRequestReviewEditedEvent,
+    ('pull_request_review', 'submitted'): m.PullRequestReviewSubmittedEvent,
+    ('pull_request_review_comment', 'created'): m.PullRequestReviewCommentCreatedEvent,
+    ('pull_request_review_comment', 'deleted'): m.PullRequestReviewCommentDeletedEvent,
+    ('pull_request_review_comment', 'edited'): m.PullRequestReviewCommentEditedEvent,
+    ('pull_request_review_thread', 'resolved'): m.PullRequestReviewThreadResolvedEvent,
+    ('pull_request_review_thread', 'unresolved'): m.PullRequestReviewThreadUnresolvedEvent,
+    ('registry_package', 'published'): m.RegistryPackagePublishedEvent,
+    ('registry_package', 'updated'): m.RegistryPackageUpdatedEvent,
+    ('release', 'created'): m.ReleaseCreatedEvent,
+    ('release', 'deleted'): m.ReleaseDeletedEvent,
+    ('release', 'edited'): m.ReleaseEditedEvent,
+    ('release', 'prereleased'): m.ReleasePrereleasedEvent,
+    ('release', 'published'): m.ReleasePublishedEvent,
+    ('release', 'released'): m.ReleaseReleasedEvent,
+    ('release', 'unpublished'): m.ReleaseUnpublishedEvent,
+    ('repository', 'archived'): m.RepositoryArchivedEvent,
+    ('repository', 'created'): m.RepositoryCreatedEvent,
+    ('repository', 'deleted'): m.RepositoryDeletedEvent,
+    ('repository', 'edited'): m.RepositoryEditedEvent,
+    ('repository', 'privatized'): m.RepositoryPrivatizedEvent,
+    ('repository', 'publicized'): m.RepositoryPublicizedEvent,
+    ('repository', 'renamed'): m.RepositoryRenamedEvent,
+    ('repository', 'transferred'): m.RepositoryTransferredEvent,
+    ('repository', 'unarchived'): m.RepositoryUnarchivedEvent,
+    ('repository_vulnerability_alert', 'create'): m.RepositoryVulnerabilityAlertCreateEvent,
+    ('repository_vulnerability_alert', 'dismiss'): m.RepositoryVulnerabilityAlertDismissEvent,
+    ('repository_vulnerability_alert', 'reopen'): m.RepositoryVulnerabilityAlertReopenEvent,
+    ('repository_vulnerability_alert', 'resolve'): m.RepositoryVulnerabilityAlertResolveEvent,
+    ('secret_scanning_alert', 'created'): m.SecretScanningAlertCreatedEvent,
+    ('secret_scanning_alert', 'reopened'): m.SecretScanningAlertReopenedEvent,
+    ('secret_scanning_alert', 'resolved'): m.SecretScanningAlertResolvedEvent,
+    ('secret_scanning_alert', 'revoked'): m.SecretScanningAlertRevokedEvent,
+    ('secret_scanning_alert_location', 'created'): m.SecretScanningAlertLocationCreatedEvent,
+    ('security_advisory', 'performed'): m.SecurityAdvisoryPerformedEvent,
+    ('security_advisory', 'published'): m.SecurityAdvisoryPublishedEvent,
+    ('security_advisory', 'updated'): m.SecurityAdvisoryUpdatedEvent,
+    ('security_advisory', 'withdrawn'): m.SecurityAdvisoryWithdrawnEvent,
+    ('sponsorship', 'cancelled'): m.SponsorshipCancelledEvent,
+    ('sponsorship', 'created'): m.SponsorshipCreatedEvent,
+    ('sponsorship', 'edited'): m.SponsorshipEditedEvent,
+    ('sponsorship', 'pending_cancellation'): m.SponsorshipPendingCancellationEvent,
+    ('sponsorship', 'pending_tier_change'): m.SponsorshipPendingTierChangeEvent,
+    ('sponsorship', 'tier_changed'): m.SponsorshipTierChangedEvent,
+    ('star', 'created'): m.StarCreatedEvent,
+    ('star', 'deleted'): m.StarDeletedEvent,
+    ('team', 'added_to_repository'): m.TeamAddedToRepositoryEvent,
+    ('team', 'created'): m.TeamCreatedEvent,
+    ('team', 'deleted'): m.TeamDeletedEvent,
+    ('team', 'edited'): m.TeamEditedEvent,
+    ('team', 'removed_from_repository'): m.TeamRemovedFromRepositoryEvent,
+    ('watch', 'started'): m.WatchStartedEvent,
+    ('workflow_job', 'completed'): m.WorkflowJobCompletedEvent,
+    ('workflow_job', 'in_progress'): m.WorkflowJobInProgressEvent,
+    ('workflow_job', 'queued'): m.WorkflowJobQueuedEvent,
+    ('workflow_job', 'waiting'): m.WorkflowJobWaitingEvent,
+    ('workflow_run', 'completed'): m.WorkflowRunCompletedEvent,
+    ('workflow_run', 'in_progress'): m.WorkflowRunInProgressEvent,
+    ('workflow_run', 'requested'): m.WorkflowRunRequestedEvent,
+}
+
+WebhookEvent = (
+    m.BranchProtectionConfigurationEvent
+    | m.BranchProtectionRuleEvent
+    | m.CheckRunEvent
+    | m.CheckSuiteEvent
+    | m.CodeScanningAlertEvent
+    | m.CommitCommentEvent
+    | m.CreateEvent
+    | m.CustomPropertyEvent
+    | m.CustomPropertyValuesEvent
+    | m.DeleteEvent
+    | m.DependabotAlertEvent
+    | m.DeployKeyEvent
+    | m.DeploymentEvent
+    | m.DeploymentProtectionRuleEvent
+    | m.DeploymentReviewEvent
+    | m.DeploymentStatusEvent
+    | m.DiscussionEvent
+    | m.DiscussionCommentEvent
+    | m.ForkEvent
+    | m.GitHubAppAuthorizationEvent
+    | m.GollumEvent
+    | m.InstallationEvent
+    | m.InstallationRepositoriesEvent
+    | m.InstallationTargetEvent
+    | m.IssueCommentEvent
+    | m.IssuesEvent
+    | m.LabelEvent
+    | m.MarketplacePurchaseEvent
+    | m.MemberEvent
+    | m.MembershipEvent
+    | m.MergeGroupEvent
+    | m.MetaEvent
+    | m.MilestoneEvent
+    | m.OrgBlockEvent
+    | m.OrganizationEvent
+    | m.PackageEvent
+    | m.PageBuildEvent
+    | m.PingEvent
+    | m.ProjectEvent
+    | m.ProjectCardEvent
+    | m.ProjectColumnEvent
+    | m.ProjectsV2ItemEvent
+    | m.PublicEvent
+    | m.PullRequestEvent
+    | m.PullRequestReviewEvent
+    | m.PullRequestReviewCommentEvent
+    | m.PullRequestReviewThreadEvent
+    | m.PushEvent
+    | m.RegistryPackageEvent
+    | m.ReleaseEvent
+    | m.RepositoryEvent
+    | m.RepositoryDispatchEvent
+    | m.RepositoryImportEvent
+    | m.RepositoryVulnerabilityAlertEvent
+    | m.SecretScanningAlertEvent
+    | m.SecretScanningAlertLocationEvent
+    | m.SecurityAdvisoryEvent
+    | m.SponsorshipEvent
+    | m.StarEvent
+    | m.StatusEvent
+    | m.TeamEvent
+    | m.TeamAddEvent
+    | m.WatchEvent
+    | m.WorkflowDispatchEvent
+    | m.WorkflowJobEvent
+    | m.WorkflowRunEvent
+)

github_events/dispatch.py

@@ -0,0 +1,138 @@
+"""Framework-free GitHub webhook dispatch: verify, parse, validate, route.
+
+Works with any HTTP framework (or none) — you bring the raw request body and
+headers, WebhookDispatcher does the rest. github_events.fastapi wraps this for
+FastAPI apps.
+"""
+
+from __future__ import annotations
+
+import hashlib
+import hmac
+import inspect
+import json
+from collections.abc import Callable
+from typing import Any, TypeVar
+
+__all__ = ["SignatureVerificationError", "WebhookDispatcher", "WebhookError"]
+
+Handler = TypeVar("Handler", bound=Callable[..., Any])
+
+
+class WebhookError(Exception):
+    """Base class for dispatch failures."""
+
+
+class SignatureVerificationError(WebhookError):
+    """X-Hub-Signature-256 was missing or didn't match the body."""
+
+
+class WebhookDispatcher:
+    """Handler registry keyed by (event, action), with signature verification.
+
+    @hook.on("issues", action="opened")  -> called with an IssuesOpenedEvent payload
+    @hook.on("issues")                   -> called with every issues action
+    @hook.on_any                         -> called with (event_name, payload) for all deliveries
+
+    Handlers may be sync or async. With validate=True (the default, requires
+    pydantic) payloads are checked against the generated TypedDicts before
+    dispatch; events GitHub adds after generation pass through unvalidated.
+    """
+
+    def __init__(self, secret: str | bytes | None = None, *, validate: bool = True) -> None:
+        if isinstance(secret, str):
+            secret = secret.encode()
+        self._secret = secret
+        self._handlers: dict[tuple[str, str | None], list[Callable[..., Any]]] = {}
+        self._any_handlers: list[Callable[..., Any]] = []
+        self._validate: Callable[[str, str | None, Any], Any]
+        if validate:
+            from github_events.validation import validate_payload
+
+            self._validate = validate_payload
+        else:
+            self._validate = lambda _event, _action, data: data
+
+    def on(
+        self, event: str, action: str | list[str] | None = None
+    ) -> Callable[[Handler], Handler]:
+        """Register a handler for one event, optionally narrowed to one action
+        or a list of actions (the handler fires for any of them)."""
+        actions: list[str | None]
+        if action is None:
+            actions = [None]
+        elif isinstance(action, str):
+            actions = [action]
+        else:
+            actions = list(dict.fromkeys(action))  # dedupe, keep order
+            if not actions:
+                raise ValueError("action list must not be empty")
+
+        def register(fn: Handler) -> Handler:
+            for a in actions:
+                self._handlers.setdefault((event, a), []).append(fn)
+            return fn
+
+        return register
+
+    def on_any(self, fn: Handler) -> Handler:
+        """Register a handler called with (event_name, payload) for every delivery."""
+        self._any_handlers.append(fn)
+        return fn
+
+    def verify_signature(self, body: bytes, signature_256: str | None) -> None:
+        """Constant-time HMAC-SHA256 check. No-op unless a secret is configured."""
+        if self._secret is None:
+            return
+        if not signature_256:
+            raise SignatureVerificationError("missing X-Hub-Signature-256 header")
+        expected = "sha256=" + hmac.new(self._secret, body, hashlib.sha256).hexdigest()
+        if not hmac.compare_digest(expected, signature_256):
+            raise SignatureVerificationError("X-Hub-Signature-256 mismatch")
+
+    async def dispatch(
+        self,
+        event: str,
+        body: bytes | str | dict[str, Any],
+        *,
+        signature_256: str | None = None,
+    ) -> Any:
+        """Verify, parse, validate and route one delivery; returns the payload.
+
+        Raises SignatureVerificationError (a secret is configured and the
+        signature is missing/wrong), json.JSONDecodeError (malformed body), and
+        — with validation enabled — pydantic.ValidationError when a field that
+        is present has the wrong type.
+        """
+        if isinstance(body, dict):
+            if self._secret is not None:
+                raise ValueError(
+                    "cannot verify a signature against a pre-parsed body; pass raw bytes"
+                )
+            data = body
+        else:
+            raw = body.encode() if isinstance(body, str) else body
+            self.verify_signature(raw, signature_256)
+            data = json.loads(raw)
+        action = data.get("action") if isinstance(data, dict) else None
+        payload = self._validate(event, action if isinstance(action, str) else None, data)
+        # dict.fromkeys dedupes (action-less events would otherwise route twice)
+        for key in dict.fromkeys(((event, action), (event, None))):
+            for fn in self._handlers.get(key, []):
+                if inspect.isawaitable(result := fn(payload)):
+                    await result
+        for fn in self._any_handlers:
+            if inspect.isawaitable(result := fn(event, payload)):
+                await result
+        return payload
+
+    def as_fastapi_router(self, *, path: str = "/") -> Any:
+        """Build a FastAPI APIRouter with a POST endpoint wired to this dispatcher.
+
+        Requires fastapi (github-events[fastapi]). Returns fastapi.APIRouter.
+        """
+        from github_events.fastapi import create_router
+
+        # Suppression needed because the .pyi stub shadows this module, so
+        # `self`'s impl type doesn't unify with the stub's WebhookDispatcher.
+        return create_router(self, path=path)  # ty: ignore[invalid-argument-type]