@cardstack/github-auth

0.14.38-patch.0 • Public • Published

@cardstack/github-auth

This README outlines the details of collaborating on this Ember addon.

Installation

  • git clone <repository-url> this repository
  • cd @cardstack/github-auth
  • npm install
  • bower install

Running

To run the demo app and interact with GitHub, you need to register your app via https://github.com/settings/developers and get a client ID & secret. Set them via the environment variables GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET. This allows this plugin to act as an OAuth2 client that speaks to GitHub on behalf of users who authorize it.

For the present, you also need a user token that the Hub can use to represent itself. You can use a Personal Access Token. Make sure that this token has repo and user scope, as well as push permissions on the GitHub repos that you configure to use with the github-auth plugin datasource. This allows the plugin to have sufficient privileges to be able to query the repo for collaborator permissions. Set is via the environment variable GITHUB_TOKEN.

Note that in order to get access to a github user's email address, the github user must set a public email address in their github profile settings. GitHub allows people to opt-in to having a public email, so that means by default, github users do not have a public email address.

Running Tests

  • npm test (Runs ember try:each to test your addon against multiple Ember versions)
  • ember test
  • ember test --server

Building

  • ember build

For more information on using ember-cli, visit https://ember-cli.com/.

Package Sidebar

Install

npm i @cardstack/github-auth

Weekly Downloads

2

Version

0.14.38-patch.0

License

MIT

Unpacked Size

15.1 kB

Total Files

13

Last publish

Collaborators

  • tintinthong
  • backspace
  • pcjun97
  • jurgen
  • burcunoyan
  • ef4
  • habdelra
  • lukemelia