DEV Community

Athul Cyriac
Athul Cyriac

Posted on • Updated on • Originally published at blog.athulcyriac.me

Make your First GitHub App with Probot

GitHub Apps with Probot

Ever see in any issues or Pull Request in GitHub where a bot comments on the PR/Issue or adds labels to the PR/Issue? If you have, they are generally termed as GitHub apps and can be made relatively easily.

Most of these apps are written in JavaScript (Node.js) using Probot, a framework for building apps for GitHub. Probot is written in Typescript, a superset of JavaScript. You can find more about on their website.


Here we'll make a Simple Issue and Pull Request commenter bot which is made and deployed on Glitch.

Prerequisites

  • GitHub account
  • An account on Glitch using GitHub
  • Basic JavaScript knowledge like variables and strings and functions

Making our App on Glitch

Glitch is a free online code-editing platform. It sets up our environment with all the necessary packages and stuff. All you need to do is click this button👇 and you'll get a full working environment for your "Remixing".

remix this

What Probot does is that it abstracts the authentication system that all GitHub Apps have to follow - letting you focus on writing API requests without worrying about API tokens or permissions.

Probot ships with an example of setting up an issue commentor bot in index.js.
We'll edit the index.js to the following

//index.js
 module.exports = app => {
  // Your code here
  app.log('Yay, the app was loaded!')
  app.on('issues.opened', async context =>({
    const issue=context.payload.issue //getting issue details
    const user=issue.login.user //Getting the username
    const message=`Thanks @${user} for opening this issue!:tada:
    You are awesome..`
    const params = context.issue({ message })
    return context.github.issues.createComment(params)
)
  })
}
Enter fullscreen mode Exit fullscreen mode

The above code is for a bot which comments on new issues. It mentions the user too. The "Robotic" characteristics start from the 4th line starting with app.on function the first argument passed is the action which the bot listens to. These are webhook events of GitHub - you can learn more about them from the Webhook Documentation.

Probot uses Node's async/await API for returning the data. We used the ` character to enclose the string/comment body because we won't need to use escape characters and we can also interpolate Template Literals.

Now we need to check if our app is working or not, we can do this clicking on a "sunglasses" button on Glitch which should look like this
Glitch Show

Then You'll see a Page like this Page
Click the Register GitHub App button and provide a name and install it in a repository.

Tip: Create a new private repository because we'll be making a lot of noise for the testing

Now, if you check the .env file you'll see the variable values auto-filled with the necessary data. Glitch automatically deploys our app and our app will be listening to the webhooks to be received.

Test the app by making a new issue in a test repo on GitHub.

It works right?

Congratulations 🎉🎉 You just made yourself a GitHub App👌👌

Redelivering Webhook⤴️

We can view all the webhooks of any event triggered by the Repository and we can redeliver them by going to Settings->Developer Settings->GitHub Apps->"Your app name"->Advanced Tab in your profile.

Commenting on PRs

We need to add an extra permission for our App to comment on PRs, we can provide that by going to Settings->Developer Settings-><Your_app_name> -> Permissions and Events -> Pull Requests Provide the read and Write Access.

Now we need to edit the index.js to add Support for Pull Request before the last '}'.

javascript
app.on('pull_request.opened', async context =>{
const pr =context.payload.pull_request
const user = pr.user.login //Collecting Details of the person who created the PR
const msg=context.issue({body:
Hey @${user} 👋, Thanks for the PR !!! You are Awesome.})
return context.github.issues.createComment(msg)
})

Here we add a new "robotic" characteristic by passing a webhook action called pull_request.opened. Now our app listens for PR webhook and once received it emits the context.issue({body}) to GitHub. You can see that we are still passing the body to the createComment function. This is because PRs are considered as another type of Issues in GitHub.
For testing if this works, make a new PR and check if the bot comments on that yes.


Congratulations on making a GitHub app. Since it is on Glitch we can install this in any repository and it will work any time too.

You can customise the comments with Images and Gifs but keep in mind that the comments render markdown.
You can always import these files to a GitHub repository through Glitch.

Now go forth, explore and make some exciting GitHub apps,❤️❤️

Thanks to

Originally Posted in my Personal Blog.

Top comments (1)

Collapse
 
rupeshiya profile image
Rupesh Krishna Jha • Edited

@athulcajay
Hey,
Can you please tell me how can I give the user the option to install this bot on a particular repo?
I know that there is an API to fetch all the repo of a user but how to take permission from the user and make them install this app on their particular repo?

The user(not developer) don't need to register the app and directly install the app?

Help, please.