✨ support codeberg + gitlab . Add cli tool

Author: Platane

action.yml

@@ -24,7 +24,7 @@ inputs:
 
       - palette:      A preset of color, one of [github, github-dark, github-light]
       - color_snake:  Color of the snake
-      - color_dots:   Coma separated list of dots color. 
+      - color_dots:   Coma separated list of dots color.
                       The first one is 0 contribution, then it goes from the low contribution to the highest.
                       Exactly 5 colors are expected.
       example:

bun.lock

@@ -6,6 +6,7 @@
   "repository": "github:platane/snk",
   "devDependencies": {
     "@types/bun": "1.3.4",
+    "@types/node": "24.12.2",
     "prettier": "3.6.2",
     "typescript": "5.9.3"
   },
@@ -17,6 +18,7 @@
     "lint": "prettier -c '**/*.{ts,js,json,md,yml,yaml}' '!packages/*/dist/**' '!svg-only/dist/**'",
     "dev:demo": "( cd packages/demo ; npm run dev )",
     "build:demo": "( cd packages/demo ; npm run build )",
-    "build:action": "( cd packages/action ; npm run build )"
+    "build:action": "( cd packages/action ; npm run build )",
+    "build:lib": "( cd packages/generate-snake-animation ; npm run build )"
   }
 }

package.json

@@ -1,11 +1,15 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { parseOutputsOption } from "./outputsOptions";
+import { generateSnakeAnimation } from "generate-snake-animation/generateSnakeAnimation";
+import { parseOutputsOption } from "generate-snake-animation/outputsOptions";
 import * as githubAction from "./github-action";
 
 (async () => {
   try {
     const userName = githubAction.getInput("github_user_name");
+    const githubToken =
+      process.env.GITHUB_TOKEN ?? githubAction.getInput("github_token");
+
     const outputsRaw = [
       ...githubAction.getInput("outputs").split("\n"),
       //
@@ -17,15 +21,11 @@ import * as githubAction from "./github-action";
       .filter(Boolean);
 
     const outputs = parseOutputsOption(outputsRaw);
-    const githubToken =
-      process.env.GITHUB_TOKEN ?? githubAction.getInput("github_token");
 
-    const { generateContributionSnake } = await import(
-      "./generateContributionSnake"
+    const results = await generateSnakeAnimation(
+      { platform: "github", username: userName, githubToken },
+      outputs,
     );
-    const results = await generateContributionSnake(userName, outputs, {
-      githubToken,
-    });
 
     outputs.forEach((out, i) => {
       const result = results[i];

packages/action/generateContributionSnake.ts

@@ -3,11 +3,7 @@
   "version": "1.0.0",
   "dependencies": {
     "@actions/core": "1.11.1",
-    "@snk/gif-creator": "1.0.0",
-    "@snk/github-user-contribution": "1.0.0",
-    "@snk/solver": "1.0.0",
-    "@snk/svg-creator": "1.0.0",
-    "@snk/types": "1.0.0"
+    "generate-snake-animation": "1.0.0"
   },
   "devDependencies": {
     "@vercel/ncc": "0.38.4"

packages/action/index.ts

@@ -1,12 +1,12 @@
-import { parseEntry } from "@snk/action/outputsOptions";
-import { basePalettes } from "@snk/action/palettes";
-import { userContributionToGrid } from "@snk/action/userContributionToGrid";
 import {
   Options as DrawOptions,
   drawLerpWorld,
   getCanvasWorldSize,
 } from "@snk/draw/drawWorld";
 import type { Res } from "@snk/github-user-contribution";
+import { cellsToGrid } from "generate-snake-animation/cellsToGrid";
+import { parseEntry } from "generate-snake-animation/outputsOptions";
+import { basePalettes } from "generate-snake-animation/palettes";
 import { step } from "@snk/solver/step";
 import { createSvg } from "@snk/svg-creator";
 import { Color, copyGrid, Grid } from "@snk/types/grid";
@@ -312,7 +312,7 @@ const onSubmit = async (userName: string) => {
   );
   const cells = (await res.json()) as Res;
 
-  const grid = userContributionToGrid(cells);
+  const grid = cellsToGrid(cells);
 
   const chain = await getChain(grid);
 

packages/action/package.json

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "bun:test";
+import { getForgejoUserContribution } from "..";
+
+describe("getForgejoUserContribution", () => {
+  const promise = getForgejoUserContribution("Codeberg");
+
+  it("should resolve", async () => {
+    await promise;
+  });
+
+  it("should get around 365 cells", async () => {
+    const cells = await promise;
+
+    expect(cells.length).toBeGreaterThanOrEqual(365);
+    expect(cells.length).toBeLessThanOrEqual(365 + 7);
+  });
+
+  it("cells should cover a full 7-row grid with no gaps", async () => {
+    const cells = await promise;
+
+    expect(cells.length).toBeGreaterThan(300);
+
+    const maxX = Math.max(...cells.map((c) => c.x));
+
+    // every (x, y) pair from (0,0) to (maxX-1, 6) must be present
+    const missing = Array.from({ length: maxX }, (_, x) =>
+      Array.from({ length: 7 }, (_, y) => ({ x, y })),
+    )
+      .flat()
+      .filter(({ x, y }) => !cells.some((c) => c.x === x && c.y === y));
+
+    expect(missing).toEqual([]);
+  });
+
+  it("cells should have level between 0 and 4", async () => {
+    const cells = await promise;
+
+    for (const c of cells) {
+      expect(c.level).toBeGreaterThanOrEqual(0);
+      expect(c.level).toBeLessThanOrEqual(4);
+    }
+  });
+});