present-me

A tool to view/show a PR as a presentation / slide-show.

See https://prme.stanistan.com for a demo.

Why

Sometimes you make a PR that is too large for folks to read/parse top-to-bottom and it would be useful to annotate it to desribe and show your team how to read and parse the changeset. What's important, what's superfluous, what's incidental to this change?

Present-me uses GitHub's Review Comments as a persistence layer (and write UI) to generate something that can be, well, presented!

How to use it

1. Create your PR as you would normally... pr
2. Start commenting on your own PR! But instead of individual comments, start a review!
3. Prefix your comments with a number to set the order that it'll show up
4. Grab the permalink of the review.
5. Go to https://prme.stanistan.com/
6. Paste the permalink into the box
7. Hit GO! rendered

Development

This project uses hermit for dependency management, if you have the shell hooks this will automatically work, otherwise you can use bin/prmectl.

Bootstrap

bin/prmectl boostrap

Make sure you've run this before anything else!

.env

This assumes you have a .env in the project directory.

PORT=8080
GH_APP_ID=0
GH_INSTALLATION_ID=0
LOG_OUTPUT=console
DISK_CACHE_ENABLED=true
DISK_CACHE_BASE_PATH=data
DISK_CACHE_MAX_SIZE=10000

N.B. Not having the ID, InstallationID, and PK file will use the public GH API and be subject to those rate limits. Enabling the DISK_CACHE helps alleviate those. You can check out the cached files in data/ to see what the responses look like.

Full options:

# go run ./cmd/veun --help
Usage: present-me --log-output="json" --gh-app_id=INT-64 --gh-installation_id=INT-64 <command>

Flags:
  -h, --help                              Show context-sensitive help.
      --port="8080"                       ($PORT)
      --hostname="localhost"              ($HOSTNAME)
      --server-read-timeout=5s
      --server-write-timeout=10s
      --debug                             ($DEBUG)
      --environment="dev"                 ($ENV)
      --log-output="json"                 ($LOG_OUTPUT)
      --disk-cache-enabled                ($DISK_CACHE_ENABLED)
      --disk-cache-base-path=STRING       ($DISK_CACHE_BASE_PATH)
      --disk-cache-cache-max-size=1024    ($DISK_CACHE_MAX_SIZE_KB)
      --gh-app_id=INT-64                  ($GH_APP_ID)
      --gh-installation_id=INT-64         ($GH_INSTALLATION_ID)
      --gh-pk-file=STRING                 ($GH_PK_FILE)

Commands:
  version --log-output="json" --gh-app_id=INT-64 --gh-installation_id=INT-64

  serve --log-output="json" --gh-app_id=INT-64 --gh-installation_id=INT-64

Development

bin/prmectl dev

• http://localhost:8080