apiNG-plugin-github is a GitHub Data API v3 plugin for apiNG.

• Supported apiNG models: repo
• This plugin supports the get-native-data parameter
• This plugin may needs an access token ⚠️
• Used promise library: angular-github-api-factory (included in distribution files)

1. INSTALLATION
   1. Get file
   2. Include file
   3. Add dependency
   4. Add plugin
2. ACCESS TOKEN
   1. Generate your access_token
   2. Insert your access_token into aping-config.js
3. USAGE
   1. Models
   2. Requests
   3. Rate limit

a) Get file
b) Include file
c) Add dependency
d) Add the plugin

Install via either bower, npm, CDN (jsDelivr) or downloaded files:

• bower install apiNG-plugin-github --save
• npm install aping-plugin-github --save
• use CDN file
• download apiNG-plugin-github.zip

Include aping-plugin-github.min.js in your apiNG application

<!-- when using bower -->
<script src="bower_components/apiNG-plugin-github/dist/aping-plugin-github.min.js"></script>

<!-- when using npm -->
<script src="node_modules/aping-plugin-github/dist/aping-plugin-github.min.js"></script>

<!-- when using cdn file -->
<script src="//cdn.jsdelivr.net/npm/aping-plugin-github@latest/dist/aping-plugin-github.min.js"></script>

<!-- when using downloaded files -->
<script src="aping-plugin-github.min.js"></script>

Add the module jtt_aping_github as a dependency to your app module:

angular.module('app', ['jtt_aping', 'jtt_aping_github']);

Add the plugin's directive aping-github="[]" to your apiNG directive and configure your requests

<aping
    template-url="templates/repo.html"
    model="repo"
    items="20"
    aping-github="[{'user':'JohnnyTheTank'}]">
</aping>

1. Login on github.com
2. Open github.com/settings/tokens/new
   • Remove all scopes except public_repo
   • Generate your access_token

Create and open js/apiNG/aping-config.js in your application folder. It should be look like this snippet:

angular.module('jtt_aping').config(['$provide', function ($provide) {
    $provide.value("apingDefaultSettings", {
        apingApiKeys : {
            github: [
                {'access_token':'<YOUR_GITHUB_ACCESS_TOKEN>'}
            ],
            //...
        }
    });
}]);

⚠️ Replace <YOUR_GITHUB_ACCESS_TOKEN> with your github access_token

Supported apiNG models

support:

• full: the source platform provides a full list with usable results
  
• partly: the source platform provides just partly usable results

Every apiNG plugin expects an array of requests as html attribute.

Sample requests:

• [{'user':'JohnnyTheTank'}, {'user':'xremix', 'items':10}]
• [{'user':'JohnnyTheTank', 'repo':'apiNG'}]
• [{'user':'JohnnyTheTank'}]

Sample requests:

• [{'search':'apiNG', 'sort':'stars', 'order':'desc', 'items':50}]
• [{'search':'JohnnyTheTank', 'items':10}]

Visit the official GitHub Data API documentation

For requests using Basic Authentication or OAuth, you can make up to 5,000 requests per hour.

MIT