Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tinchodias/menta-pharo-bot

A small GitHub App written in Pharo that can be the starting point for creating your own app
https://github.com/tinchodias/menta-pharo-bot

github-api github-app github-webhooks pharo

Last synced: 8 days ago
JSON representation

A small GitHub App written in Pharo that can be the starting point for creating your own app

Awesome Lists containing this project

README

        

# Menta

A small [Pharo](https://pharo.org/) example that can serve as a starting point to create your own GitHub App.

The example GH App shows how to react to new comments in a repository's issues by posting a Roassal2 visualization. The interaction with GitHub is done via their REST API and webhooks.

logo

## How to use

The `./server/build.sh ` script downloads a Pharo image, loads the code and it's dependencies.

Browse the code by starting the image with `./pharo-ui Pharo.image` in the `server/build` directory.

To interact with GitHub, you must setup your GitHub App with an ID and PEM private key. Read class comments of `MeGithubApp` and subclasses to learn about it.

Deploy on a server that can be accessed via two ports. The `./server/start.sh` script starts the Pharo image in headless mode with:
- HTTP server (port 3000 by default) to receive GH webhook requests.
- VNC server (port 5900 by default) to allow debugging on deploy environemt with a VNC client.

## CI status

![CI](https://github.com/tinchodias/menta-pharo-bot/workflows/CI/badge.svg)

## License

The code is licensed under [MIT](https://mit-license.org/).

The logo is licensed under [CC0 1.0 Universal (CC0 1.0)](https://openclipart.org/share). Thanks to https://openclipart.org/detail/192959/mint-two.