Issue #764: Add custom year

api/index.js

@@ -20,6 +20,7 @@ export default async (req, res) => {
     hide_rank,
     show_icons,
     include_all_commits,
+    year,
     line_height,
     title_color,
     ring_color,
@@ -75,6 +76,7 @@ export default async (req, res) => {
         showStats.includes("prs_merged_percentage"),
       showStats.includes("discussions_started"),
       showStats.includes("discussions_answered"),
+      parseInt(year, 10),
     );
 
     let cacheSeconds = clampValue(
@@ -102,6 +104,7 @@ export default async (req, res) => {
         card_width: parseInt(card_width, 10),
         hide_rank: parseBoolean(hide_rank),
         include_all_commits: parseBoolean(include_all_commits),
+        year: parseInt(year, 10),
         line_height,
         title_color,
         ring_color,

readme.md

@@ -167,6 +167,14 @@ You can pass a query parameter `&show=` to show any specific additional stats wi
 ![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage)
 ```
 
+### Specifying Year
+
+You can specify a year and fetch only the commits that were made in that year by passing `&year=YYYY` to the parameter.
+
+```md
+![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&year=2020)
+```
+
 ### Showing icons
 
 To enable icons, you can pass `&show_icons=true` in the query param, like so:
@@ -383,6 +391,7 @@ If we don't support your language, please consider contributing! You can find mo
 | `ring_color` | Color of the rank circle. | string (hex color) | `2f80ed` |
 | `number_format` | Switches between two available formats for displaying the card values `short` (i.e. `6.6k`) and `long` (i.e. `6626`). | enum | `short` |
 | `show` | Shows [additional items](#showing-additional-individual-stats) on stats card (i.e. `reviews`, `discussions_started`, `discussions_answered`, `prs_merged` or `prs_merged_percentage`). | string (comma-separated values) | `null` |
+| `year` | Count commits of the entire year | interger _(YYYY)_ | `<current year> (one year to date)`.
 
 > [!NOTE]\
 > When hide\_rank=`true`, the minimum card width is 270 px + the title length and padding.

src/cards/stats-card.js

@@ -222,6 +222,7 @@ const renderStatsCard = (stats, options = {}) => {
     card_width,
     hide_rank = false,
     include_all_commits = false,
+    year,
     line_height = 25,
     title_color,
     ring_color,
@@ -274,7 +275,11 @@ const renderStatsCard = (stats, options = {}) => {
   STATS.commits = {
     icon: icons.commits,
     label: `${i18n.t("statcard.commits")}${
-      include_all_commits ? "" : ` (${new Date().getFullYear()})`
+      include_all_commits 
+      ? "" 
+      : year 
+        ? ` (${year})`
+        : ` (${new Date().getFullYear()})`
     }`,
     value: totalCommits,
     id: "commits",
@@ -517,7 +522,7 @@ const renderStatsCard = (stats, options = {}) => {
     .map((key) => {
       if (key === "commits") {
         return `${i18n.t("statcard.commits")} ${
-          include_all_commits ? "" : `in ${new Date().getFullYear()}`
+          include_all_commits ? "" : year ? ` (${year})` : ` (last year)`
         } : ${totalStars}`;
       }
       return `${STATS[key].label}: ${STATS[key].value}`;

src/cards/types.d.ts

@@ -20,6 +20,7 @@ export type StatCardOptions = CommonOptions & {
   card_width: number;
   hide_rank: boolean;
   include_all_commits: boolean;
+  year?: number;
   line_height: number | string;
   custom_title: string;
   disable_animations: boolean;

src/fetchers/stats-fetcher.js

@@ -40,11 +40,11 @@ const GRAPHQL_REPOS_QUERY = `
 `;
 
 const GRAPHQL_STATS_QUERY = `
-  query userInfo($login: String!, $after: String, $includeMergedPullRequests: Boolean!, $includeDiscussions: Boolean!, $includeDiscussionsAnswers: Boolean!) {
+  query userInfo($login: String!, $after: String, $includeMergedPullRequests: Boolean!, $includeDiscussions: Boolean!, $includeDiscussionsAnswers: Boolean!, $startTime: DateTime) {
     user(login: $login) {
       name
       login
-      contributionsCollection {
+      contributionsCollection (from: $startTime) {
         totalCommitContributions,
         totalPullRequestReviewContributions
       }
@@ -109,6 +109,7 @@ const fetcher = (variables, token) => {
  * @param {boolean} variables.includeMergedPullRequests Include merged pull requests.
  * @param {boolean} variables.includeDiscussions Include discussions.
  * @param {boolean} variables.includeDiscussionsAnswers Include discussions answers.
+ * @param {string|undefined} variables.startTime Time to start the count of total commits.
  * @returns {Promise<AxiosResponse>} Axios response.
  *
  * @description This function supports multi-page fetching if the 'FETCH_MULTI_PAGE_STARS' environment variable is set to true.
@@ -118,6 +119,7 @@ const statsFetcher = async ({
   includeMergedPullRequests,
   includeDiscussions,
   includeDiscussionsAnswers,
+  startTime,
 }) => {
   let stats;
   let hasNextPage = true;
@@ -130,8 +132,10 @@ const statsFetcher = async ({
       includeMergedPullRequests,
       includeDiscussions,
       includeDiscussionsAnswers,
+      startTime,
     };
     let res = await retryer(fetcher, variables);
+
     if (res.data.errors) {
       return res;
     }
@@ -217,6 +221,7 @@ const totalCommitsFetcher = async (username) => {
  * @param {boolean} include_merged_pull_requests Include merged pull requests.
  * @param {boolean} include_discussions Include discussions.
  * @param {boolean} include_discussions_answers Include discussions answers.
+ * @param {number|undefined} year Year to count total commits
  * @returns {Promise<StatsData>} Stats data.
  */
 const fetchStats = async (
@@ -226,6 +231,7 @@ const fetchStats = async (
   include_merged_pull_requests = false,
   include_discussions = false,
   include_discussions_answers = false,
+  year = undefined,
 ) => {
   if (!username) {
     throw new MissingParamError(["username"]);
@@ -251,6 +257,7 @@ const fetchStats = async (
     includeMergedPullRequests: include_merged_pull_requests,
     includeDiscussions: include_discussions,
     includeDiscussionsAnswers: include_discussions_answers,
+    startTime: year ? `${year}-01-01T00:00:00Z` : undefined,
   });
 
   // Catch GraphQL errors.

tests/fetchStats.test.js

@@ -38,6 +38,9 @@ const data_stats = {
   },
 };
 
+const data_year2003 = JSON.parse(JSON.stringify(data_stats));
+data_year2003.data.user.contributionsCollection.totalCommitContributions = 428;
+
 const data_repo = {
   data: {
     user: {
@@ -88,12 +91,28 @@ const error = {
 
 const mock = new MockAdapter(axios);
 
+/**
+ * Mocks the GraphQL API based on certain conditions.
+ *
+ * @param {*} config Axios config object.
+ * @returns Axios response object.
+ */
+
 beforeEach(() => {
   process.env.FETCH_MULTI_PAGE_STARS = "false"; // Set to `false` to fetch only one page of stars.
   mock.onPost("https://api.github.com/graphql").reply((cfg) => {
+    let req = JSON.parse(cfg.data);
+
+    if (
+      req.variables &&
+      req.variables.startTime &&
+      req.variables.startTime.startsWith("2003")
+    ) {
+      return [200, data_year2003];
+    }
     return [
       200,
-      cfg.data.includes("contributionsCollection") ? data_stats : data_repo,
+      req.query.includes("contributionsCollection") ? data_stats : data_repo,
     ];
   });
 });
@@ -409,4 +428,42 @@ describe("Test fetchStats", () => {
       rank,
     });
   });
+
+  it("should get commits of provided year", async () => {
+    let stats = await fetchStats(
+      "anuraghazra",
+      false,
+      [],
+      false,
+      false,
+      false,
+      2003,
+    );
+
+    const rank = calculateRank({
+      all_commits: false,
+      commits: 428,
+      prs: 300,
+      reviews: 50,
+      issues: 200,
+      repos: 5,
+      stars: 300,
+      followers: 100,
+    });
+
+    expect(stats).toStrictEqual({
+      contributedTo: 61,
+      name: "Anurag Hazra",
+      totalCommits: 428,
+      totalIssues: 200,
+      totalPRs: 300,
+      totalPRsMerged: 0,
+      mergedPRsPercentage: 0,
+      totalReviews: 50,
+      totalStars: 300,
+      totalDiscussionsStarted: 0,
+      totalDiscussionsAnswered: 0,
+      rank,
+    });
+  });
 });