github-app-repl
A REPL (read–eval–print loop) for GitHub Apps
Last updated 2 months ago by swinton .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install github-app-repl 
SYNC missed versions from official npm registry.

GitHub-App-REPL

???? A REPL (read–eval–print loop) for GitHub Apps

Features

  1. Uses the Node repl module :repeat:
  2. With experimental await support enabled :ok_hand:
  3. Loads your GitHub App and exposes it as app in a REPL session :zap:
  4. So you can easily start playing around with it interactively :relaxed:

Why?

I like using a REPL to experiment with ideas and get comfortable with an API before delving into actual code. This removes some of the boilerplate code required to start working with GitHub Apps in a REPL.

Installation

npm install -D github-app-repl

Configuration

A couple of environment variables are required for configuration:

  1. APP_ID: This should be set to the ID of your GitHub App.
    • This is available from the settings page of your GitHub App, as App ID.
  2. PRIVATE_KEY_PATH: This should be set to a local filesystem path to a private key for your GitHub App.

These environment variables can either be set directly, or via a .env file that follows this example.

Usage

npx github-app-repl

API

  • app.id: GitHub App ID
  • app.name: GitHub App Name
  • app.description: GitHub App Description
  • app.octokit: Authenticated @octokit/rest instance, scoped to your GitHub App
  • app.installations(): Dictionary of GitHub App Installations, keyed by installation account login
  • installations: Pre-loaded dictionary of GitHub App Installations, keyed by installation account login
  • installations[:login].octokit: Authenticated @octokit/rest instance, scoped to a specific GitHub App installation
  • installations[:login].graphql: Authenticated @octokit/graphql instance, scoped to a specific GitHub App installation

Examples

Open a new issue

await installations[owner].octokit.issues.create({owner, repo, title})

Retrieve the last 3 issues from a repo

await installations[owner].graphql(`query lastIssues($owner: String!, $repo: String!, $num: Int = 3) {
    repository(owner:$owner, name:$repo) {
      issues(last:$num) {
        edges {
          node {
            title
          }
        }
      }
    }
  }`, {
    owner: 'octokit',
    repo: 'graphql.js'
  }
})

Credits

  1. Mastering the Node.js REPL (part 2) – Trabe – Medium

Current Tags

  • 0.8.1                                ...           latest (2 months ago)

5 Versions

  • 0.8.1                                ...           2 months ago
  • 0.8.0                                ...           6 months ago
  • 0.7.1                                ...           6 months ago
  • 0.7.0                                ...           6 months ago
  • 0.0.1                                ...           6 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 10
Last Day 0
Last Week 0
Last Month 0
Dependencies (6)
Dev Dependencies (10)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |