contributions
v0.8.0
Published
GitHub Contribution Count
Downloads
190
Readme
GitHub Contributions
A TypeScript library for the GitHub Contribution Graph.
Usage
Get the contributions for a GitHub user, by name:
const contributions = await Contributions.forUser('ethomson');
Get the days in the contribution graph:
const days = contributions.getDays();
You can iterate and inspect the data in each day:
Get the date, a string in
YYYY-MM-DD
format:day.getDate();
Get the number of contributions on that day:
day.getCount();
Get the contribution intensity for the day, which is the number 0-4, where 0 indicates no contributions, and 4 is the most contributions. This maps to the color used to indicate the contribution count for the graph.
day.getIntensity();
Get the color, a string in hexadecimal
#xxxxxx
format, that GitHub used for displaying this day in the contribution graph (this maps directly to the "intensity" level for the day:
Example
Add the contributions
package (eg, npm install contributions
). Then:
const { Contributions } = require('contributions')
const contributions = await Contributions.forUser('ethomson');
const days = contributions.getDays();
for (let day of days) {
console.log(`${day.getDate()}: ${day.getIntensity()}`);
}
License
contributions is released under the MIT license.
See the license file for the full license text.