feat: add issue create and comment (task 0004)
Introduce the first mutations, along with the shared machinery the later
issue and PR mutation slices reuse.
- `issue create` with --title/--body/--body-file/--assignee/--label/
--milestone/--fields, emitting `issue: { number, title, state, url }`
- `issue comment <n>`, echoing the created comment from the POST response
with the body cleaned and truncated at 800 chars
- body-source resolution (--body vs --body-file), label and milestone
name->ID lookup, repeatable flags, and the `joined`/`selectExtraFields`
field extractors
Label lookup pages until exhausted, since a repo with more labels than one
page would otherwise fail to resolve a valid name. The end-to-end tier seeds
a mixed-case label and milestone and passes both in a different case, so the
case-insensitive lookup is verified against live Gitea rather than only
against fixtures.
This commit was merged in pull request #3.
This commit is contained in:
353
test/issue-create.test.ts
Normal file
353
test/issue-create.test.ts
Normal file
@@ -0,0 +1,353 @@
|
||||
import { afterEach, describe, expect, it } from "vitest";
|
||||
import { startFixtureServer, type FixtureServer } from "./fixture-server.js";
|
||||
import { postedBody, runCliTest, tempFiles, testModeEnv } from "./harness.js";
|
||||
|
||||
const ISSUES_PATH = "/api/v1/repos/testowner/testrepo/issues";
|
||||
const LABELS_PATH = "/api/v1/repos/testowner/testrepo/labels";
|
||||
const MILESTONES_PATH = "/api/v1/repos/testowner/testrepo/milestones";
|
||||
|
||||
let server: FixtureServer;
|
||||
const files = tempFiles();
|
||||
|
||||
afterEach(async () => {
|
||||
await server.close();
|
||||
files.cleanup();
|
||||
});
|
||||
|
||||
function createdIssue(fields: Record<string, unknown> = {}): Record<string, unknown> {
|
||||
return {
|
||||
number: 7,
|
||||
title: "Fix the thing",
|
||||
state: "open",
|
||||
html_url: "http://127.0.0.1/testowner/testrepo/issues/7",
|
||||
user: { login: "alexion" },
|
||||
created_at: "2026-07-01T00:00:00Z",
|
||||
body: "",
|
||||
labels: [],
|
||||
assignees: [],
|
||||
...fields,
|
||||
};
|
||||
}
|
||||
|
||||
/** The single POST the CLI sent to the issues endpoint. */
|
||||
function postedIssue(): Record<string, unknown> {
|
||||
return postedBody(server, ISSUES_PATH);
|
||||
}
|
||||
|
||||
describe("issue create", () => {
|
||||
it("creates an issue and renders number, title, state, and url", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "Fix the thing"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(stdout).toContain("issue:");
|
||||
expect(stdout).toContain("number: 7");
|
||||
expect(stdout).toContain("title: Fix the thing");
|
||||
expect(stdout).toContain("state: open");
|
||||
// TOON quotes the URL because it contains the key/value separator.
|
||||
expect(stdout).toContain('url: "http://127.0.0.1/testowner/testrepo/issues/7"');
|
||||
expect(postedIssue()).toEqual({ title: "Fix the thing" });
|
||||
});
|
||||
|
||||
it("suggests viewing the issue it just created, with the real number", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { stdout } = await runCliTest(["issue", "create", "--title", "Fix the thing"], {
|
||||
env: testModeEnv(server.url),
|
||||
});
|
||||
|
||||
expect(stdout).toContain("issue view 7");
|
||||
});
|
||||
|
||||
it("sends the body from --body", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--body", "Some details."],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", body: "Some details." });
|
||||
});
|
||||
|
||||
it("reads the body from --body-file", async () => {
|
||||
const path = files.write("body.md", "From a file.\nSecond line.\n");
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--body-file", path],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", body: "From a file.\nSecond line.\n" });
|
||||
});
|
||||
|
||||
it("rejects --body and --body-file together before calling the API", async () => {
|
||||
const path = files.write("body.md", "x");
|
||||
server = await startFixtureServer([]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--body", "x", "--body-file", path],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(server.requests).toHaveLength(0);
|
||||
});
|
||||
|
||||
it("reports an unreadable --body-file as VALIDATION_ERROR", async () => {
|
||||
server = await startFixtureServer([]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--body-file", "/nonexistent/nope.md"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(server.requests).toHaveLength(0);
|
||||
});
|
||||
|
||||
it("rejects a missing --title before calling the API", async () => {
|
||||
server = await startFixtureServer([]);
|
||||
const { stdout, exitCode } = await runCliTest(["issue", "create"], {
|
||||
env: testModeEnv(server.url),
|
||||
});
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(stdout).toContain("--title");
|
||||
expect(server.requests).toHaveLength(0);
|
||||
});
|
||||
|
||||
it("resolves repeated --label names to ids, case-insensitively", async () => {
|
||||
server = await startFixtureServer([
|
||||
{
|
||||
method: "GET",
|
||||
path: LABELS_PATH,
|
||||
body: [
|
||||
{ id: 11, name: "bug" },
|
||||
{ id: 22, name: "Priority: High" },
|
||||
{ id: 33, name: "chore" },
|
||||
],
|
||||
},
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--label", "BUG", "--label", "priority: high"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", labels: [11, 22] });
|
||||
});
|
||||
|
||||
it("rejects an unknown --label name with VALIDATION_ERROR and creates nothing", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "GET", path: LABELS_PATH, body: [{ id: 11, name: "bug" }] },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--label", "nope"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(stdout).toContain("nope");
|
||||
expect(server.requests.some((request) => request.method === "POST")).toBe(false);
|
||||
});
|
||||
|
||||
it("finds a label that only appears on a later page of labels", async () => {
|
||||
const firstPage = Array.from({ length: 50 }, (_, index) => ({
|
||||
id: index + 1,
|
||||
name: `filler-${index}`,
|
||||
}));
|
||||
server = await startFixtureServer([
|
||||
{ method: "GET", path: LABELS_PATH, query: { page: "1" }, body: firstPage },
|
||||
{
|
||||
method: "GET",
|
||||
path: LABELS_PATH,
|
||||
query: { page: "2" },
|
||||
body: [{ id: 99, name: "needle" }],
|
||||
},
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--label", "needle"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", labels: [99] });
|
||||
});
|
||||
|
||||
it("surfaces a failure to list labels", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "GET", path: LABELS_PATH, status: 403, body: { message: "forbidden" } },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--label", "bug"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(1);
|
||||
expect(stdout).toContain("code: FORBIDDEN");
|
||||
expect(server.requests.some((request) => request.method === "POST")).toBe(false);
|
||||
});
|
||||
|
||||
it("surfaces a failure to list milestones", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "GET", path: MILESTONES_PATH, status: 403, body: { message: "forbidden" } },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--milestone", "v1.0"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(1);
|
||||
expect(stdout).toContain("code: FORBIDDEN");
|
||||
expect(server.requests.some((request) => request.method === "POST")).toBe(false);
|
||||
});
|
||||
|
||||
it("renders empty extra fields when the issue has no labels, assignees, or milestone", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue({ labels: null }) },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--fields", "labels,assignees,milestone"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(stdout).toContain('labels: ""');
|
||||
expect(stdout).toContain('assignees: ""');
|
||||
expect(stdout).toContain('milestone: ""');
|
||||
});
|
||||
|
||||
it("resolves --milestone to its id, case-insensitively", async () => {
|
||||
server = await startFixtureServer([
|
||||
{
|
||||
method: "GET",
|
||||
path: MILESTONES_PATH,
|
||||
query: { name: "v1.0" },
|
||||
body: [{ id: 5, title: "V1.0" }],
|
||||
},
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--milestone", "v1.0"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", milestone: 5 });
|
||||
});
|
||||
|
||||
it("rejects an unknown --milestone name with VALIDATION_ERROR and creates nothing", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "GET", path: MILESTONES_PATH, body: [] },
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--milestone", "ghost"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(stdout).toContain("ghost");
|
||||
expect(server.requests.some((request) => request.method === "POST")).toBe(false);
|
||||
});
|
||||
|
||||
it("passes --assignee through as an assignees list", async () => {
|
||||
server = await startFixtureServer([
|
||||
{ method: "POST", path: ISSUES_PATH, status: 201, body: createdIssue() },
|
||||
]);
|
||||
const { exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--assignee", "alexion"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(postedIssue()).toEqual({ title: "T", assignees: ["alexion"] });
|
||||
});
|
||||
|
||||
it("appends the extra fields named by --fields", async () => {
|
||||
server = await startFixtureServer([
|
||||
{
|
||||
method: "POST",
|
||||
path: ISSUES_PATH,
|
||||
status: 201,
|
||||
body: createdIssue({
|
||||
body: "The body.",
|
||||
labels: [{ id: 11, name: "bug" }, { id: 22, name: "chore" }],
|
||||
assignees: [{ login: "alexion" }],
|
||||
milestone: { id: 5, title: "v1.0" },
|
||||
}),
|
||||
},
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--fields", "labels,assignees,milestone,body"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
// TOON quotes the joined labels because they contain its list delimiter.
|
||||
expect(stdout).toContain('labels: "bug, chore"');
|
||||
expect(stdout).toContain("assignees: alexion");
|
||||
expect(stdout).toContain("milestone: v1.0");
|
||||
expect(stdout).toContain("body: The body.");
|
||||
// The default fields stay in place alongside the requested extras.
|
||||
expect(stdout).toContain("number: 7");
|
||||
});
|
||||
|
||||
it("rejects an unknown --fields name with VALIDATION_ERROR", async () => {
|
||||
server = await startFixtureServer([]);
|
||||
const { stdout, exitCode } = await runCliTest(
|
||||
["issue", "create", "--title", "T", "--fields", "nonsense"],
|
||||
{ env: testModeEnv(server.url) },
|
||||
);
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(stdout).toContain("nonsense");
|
||||
expect(server.requests).toHaveLength(0);
|
||||
});
|
||||
|
||||
it("surfaces a server-side rejection of the create", async () => {
|
||||
server = await startFixtureServer([
|
||||
{
|
||||
method: "POST",
|
||||
path: ISSUES_PATH,
|
||||
status: 422,
|
||||
body: { message: "title is empty" },
|
||||
},
|
||||
]);
|
||||
const { stdout, exitCode } = await runCliTest(["issue", "create", "--title", "T"], {
|
||||
env: testModeEnv(server.url),
|
||||
});
|
||||
|
||||
expect(exitCode).toBe(2);
|
||||
expect(stdout).toContain("code: VALIDATION_ERROR");
|
||||
expect(stdout).toContain("title is empty");
|
||||
});
|
||||
|
||||
it("prints help with --help without calling the API", async () => {
|
||||
server = await startFixtureServer([]);
|
||||
const { stdout, exitCode } = await runCliTest(["issue", "create", "--help"], {
|
||||
env: testModeEnv(server.url),
|
||||
});
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(stdout).toContain("usage: gitea-axi issue create");
|
||||
expect(server.requests).toHaveLength(0);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user