06-github-winglibs.md

In this section, we will implement a GitHub app that listens to PRs and modifies the changed markdown files.

Prerequisites

Please make sure you have ngrok installed.

Install ngrok

The GitHub App

We will use the @winglibs/github module, which uses an API gateway and probot/probot framework to create an easy way to develop, test locally, and deploy GitHub applications to production.

To configure the app, you will need the webhook secret, app id, and private key pem file path available.

But first, let's start by installing it:

npm i -s @winglibs/github

Now, let's create a github-app.main.w file:

bring github;
bring fs;

class SimpleCredentialsSupplier impl github.IProbotAppCredentialsSupplier {
   
   pub inflight getId(): str {
    // TODO place app id
    return "app id";
   }

   pub inflight getWebhookSecret(): str {
    // TODO place webhook secret
    return "some-webhook-secret";
   }

   pub inflight getPrivateKey(): str {
    // TODO place path to private key
    return fs.readFile("/path/to/private-key.pem");
   }
}

let credentialsSupplier = new SimpleCredentialsSupplier();
let markdown = new github.ProbotApp(
  credentialsSupplier: credentialsSupplier,
  onPullRequestOpened: inflight () => {
    log("PR was Opened");
  },
  onPullRequestReopened: inflight () => {
    log("PR was Re-Opened");
  }
);

Once you run wing run github-app.main.w, you will notice that the Webhook URL that we initially set up to be "http://this-will-change.com" has changed to an ngrok-generated URL. You can observe this under your application configuration (see https://github.com/settings/apps).

This URL will constantly change on any new hot reload of the localhost application.

Let's See it in Action

Open a Pull Request in the connected Repo.

You should see the log notifying you that a PR was created in the Wing console.

Challenge

Follow the @winglibs/github README.md file to see how to replace all changed markdown files with an uppercase version of them.

🚀 Great, next we will use the anthropic.claude-v2:1 foundation model to make the correct commit. 🚀