GitHubApps 1.1.0

GitHub Apps .NET (Core)

The GitHub Apps Core is a component that allows the creation of GitHub Apps using .NET.

A GitHub App is a service that receives a post request from GitHub when certain actions are executed.

This component exposes a GitHubAppBase class that must be extended to implement your own Git Hub App.

Refer to the API Documentation to have a better understanding of each class and how to use it.

In this repository

• Usage
  • Creating your own GitHub App
  • Current Events
• Links

Usage

Add the nuget package GitHubApps into your project. This package is compatible with netstandard1.0, netstandard1.3, netstandard2.0, net45, net46, net461, and net6.0. If your project target any framework higher than those, it will work fine.

If you are planning to implement a ASP.NET Core Web Application using this component, install the GitHubApps.AspNetCore package instead. This package offers a MVC Controller that handles the POST request made by GitHub.

Creating your own GitHub App

In order to create your own GitHub App, create a class and extend from the GitHubAppBase class.

using GitHubApps;

public class MyGitHubApp: GitHubAppBase
{
   //TODO: Override the virtual methods for each event
}

This class contains several virtual methods that can be overwritten to handle the proper event and action. For example, to handle the GitHub event installation with action created, you can override the OnEventInstallationCreated() method.

using GitHubApps;

public class MyGitHubApp: GitHubAppBase
{
   public override EventResult OnEventInstallationCreated(GitHubDelivery<GitHubEventInstallation> payload)
   {
      // Your code goes here...
   }
}

The method should always return an EventResult object.

If an event/action that is not handled yet is called, it will call the method OnEventActionUnhandled().

If an event without action that is not handled yet is called, it will call the method OnEventUnhandled().

When implementing the GitHubApps package only, it is necessary to manually implement the ProcessRequest() call. This function is going to route the event to the proper method, which has to be overwritten.

Current Events

This list contains the events that are currently implemented by this component.

If you need to handle an event that is not implement yet, you can do it by overwriting the method OnEventUnhandled() or OnEventActionUnhandled().

All of the GitHub events that are not in this list are going to be implemented at some point. Check the Project Roadmap on the Links section to see when it is likely to be delivered. Feel free to place an issue with your request in order to expedite its delivery.

Links

This section contains links that are relevant to this repository.