[2/5] GiteaでCI/CDパイプラインを構築する アプリケーション構築編

$ npm create hono@latest cicd-example

> npx
> "create-hono" cicd-example

create-hono version 0.19.4
✔ Using target directory … cicd-example
✔ Which template do you want to use? nodejs
✔ Do you want to install project dependencies? Yes
✔ Which package manager do you want to use? npm
✔ Cloning the template
✔ Installing project dependencies
🎉 Copied project files
Get started with: cd cicd-example

# 作成したプロジェクトのディレクトリに移動する
$ cd cicd-example/

# gitを初期化する
$ git init

# リモートリポジトリとしてGiteaで作成したリポジトリを設定する
$ git remote add origin http://${Giteaホスト}/kkawaharanet/cicd-example.git

# 現時点のファイル全てをステージに追加する
$ git add -A

# コミットする
$ git commit -m "initial commit"

# プッシュする
$ git push --set-upstream origin main

/**
 * 足し算をする
 * @param a オペランド
 * @param b オペランド
 * @returns 足し算の結果
 */
export function sum(a: number, b: number): number {
  return a + b;
}

import { Hono } from "hono";
import { sum } from "./sum.js";

export const app = new Hono();

/**
 * 足し算API
 */
app.get("/sum", (c) => {
  return c.json({ result: sum(1, 1) });
});

import { serve } from "@hono/node-server";
import { app } from "./app.js";

serve(
  {
    fetch: app.fetch,
    port: 3000,
  },
  (info) => {
    console.log(`Server is running on http://localhost:${info.port}`);
  },
);

{
  "name": "cicd-example",
  "type": "module",
  "scripts": {
    "dev": "tsx watch src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js",
    "typecheck": "tsc --noemit"
  },
  "dependencies": {
    "@hono/node-server": "^1.19.14",
    "hono": "^4.12.17"
  },
  "devDependencies": {
    "@types/node": "^20.11.17",
    "tsx": "^4.7.1",
    "typescript": "^5.8.3"
  }
}

$ npm run typecheck

> typecheck
> tsc --noemit

$

$ npm run dev

> dev
> tsx watch src/index.ts

Server is running on http://localhost:3000

{ "result": 2 }

.
├── README.md
├── package-lock.json
├── package.json
├── src
│   ├── app.ts
│   ├── index.ts
│   └── sum.ts
└── tsconfig.json

$ npm i -D vitest

/// <reference types="vitest" />
import { defineConfig } from "vitest/config";

export default defineConfig({
  test: {
    exclude: ["dist/**", "node_modules/**"],
  },
});

テストコードを作成していく。

### 足し算をする処理のテストコードを作成する

`src/sum.test.ts`に`src/sum.ts`のテストコードを作成する。

```ts title="src/sum.test.ts"
import { describe, expect, test } from "vitest";
import { sum } from "./sum.js";

describe("sum", () => {
  test("足し算ができること", () => {
    expect(sum(1, 1)).toBe(2);
  });
});

import { describe, expect, test } from "vitest";
import { app } from "./app.js";

describe("足し算API", () => {
  test("正しい足し算の結果を得られること", async () => {
    const response = await app.request("/sum");

    // HTTPステータスコードが200であること
    expect(response.status).toBe(200);

    // 足し算の結果が期待値と一致すること
    const body = await response.json();
    expect(body).toEqual({ result: 2 });
  });
});

.
├── README.md
├── package-lock.json
├── package.json
├── src
│   ├── app.test.ts
│   ├── app.ts
│   ├── index.ts
│   ├── sum.test.ts
│   └── sum.ts
├── tsconfig.json
└── vitest.config.ts

$ npm run test

> test
> vitest


 DEV  v4.1.2 /path/to/cicd-example

 ✓ src/sum.test.ts (1 test) 2ms
 ✓ src/app.test.ts (1 test) 15ms

 Test Files  2 passed (2)
      Tests  2 passed (2)
   Start at  14:02:42
   Duration  129ms (transform 33ms, setup 0ms, import 58ms, tests 17ms, environment 0ms)

 PASS  Waiting for file changes...
       press h to show help, press q to quit

### Giteaへプッシュする

テストが通ったらコミットし、Giteaへプッシュしておこう。

```bash
$ git add -A
$ git commit -m "1+1の結果をユーザーに返す処理を作成した"
$ git push