@adobe/gatsby-source-github-file-contributors

A Gatsby source plugin to get contributors per file for a Github repo

Install

1npm install --save @adobe/gatsby-source-github-file-contributors

Example

1// In gatsby-config.js
2plugins: [
3  {
4    resolve: `@adobe/gatsby-source-github-file-contributors`,
5      options: {
6        pages: {
7          root: '', // root of the page paths (below) in the Github repo
8          paths: ['src/pages'], // relative path of the pages from the config
9          extensions: ['md'] // page extensions to filter for
10        },
11        repo: {
12          token: process.env.REPO_GITHUB_TOKEN, // Github Personal Access Token
13          owner: process.env.REPO_OWNER, // user or org name
14          name: process.env.REPO_NAME, 
15          branch: process.env.REPO_BRANCH, // defaults to 'main'
16          default_branch: process.env.REPO_DEFAULT_BRANCH // defaults to 'main'
17        }
18      }
19  }
20];

GraphQL

{
  allGithub {
    nodes {
      repository
      branch
      default_branch
      root
    }
  }    
  allGithubContributors {
    nodes {
      contributors {
        date
        login
        name
      }
      path
    }
  }        
}

Github Personal Access Token

Without a Github Personal Access Token, your requests will be rate-limited.

The GraphQL API v4 rate limit is 5,000 points per hour when authenticated, and 60 points per hour when anonymous.

The number of points in a GraphQL API call is returned in the metadata for the call.

Contributing

Contributions are welcome! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.