libs/commands/list/src/lib/list-command.spec.ts - main - githubmirror/lerna

libs/commands/list/src/lib/list-command.spec.ts
337 строк11 KB
James Henry
chore(repo): migrate from jest to vitest (#4389)
13 июл 2026, 20:06
13 июл 2026, 20:061f7e109
import { collectProjectUpdates as _collectUpdates, output as _output } from "@lerna/core";
import {
  initFixtureFactory,
  commandRunner,
  tempDirSerializer,
  windowsPathSerializer,
} from "@lerna/test-helpers";

import command from "../command";

const initFixture = initFixtureFactory(__dirname);

// file under test

const lernaLs = commandRunner(command);

vi.mock("@lerna/core", async () => ({
  ...(await vi.importActual("@lerna/core")),
  ...(await import("@lerna/test-helpers/__mocks__/@lerna/core")),
}));

// ListCommand#execute() calls process.stdout.end(() => process.exit(0)); vitest (unlike jest)
// intercepts process.exit and treats it as an error, so prevent the stream from ending here.
vi.spyOn(process.stdout, "end").mockImplementation((() => process.stdout) as any);

// The mock modifies the exported symbols and therefore types
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const output = _output as any;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const collectUpdates = _collectUpdates as any;

// remove quotes around top-level strings
expect.addSnapshotSerializer({
  test(val) {
    return typeof val === "string";
  },
  serialize(val, config, indentation, depth) {
    // top-level strings don't need quotes, but nested ones do (object properties, etc)
    return depth ? `"${val}"` : val;
  },
});

// normalize temp directory paths in snapshots
expect.addSnapshotSerializer(windowsPathSerializer);
expect.addSnapshotSerializer(tempDirSerializer);

describe("lerna ls", () => {
  describe("in a basic repo", () => {
    let testDir: string;

    beforeAll(async () => {
      testDir = await initFixture("basic");
    });

    it("should list public packages", async () => {
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1
      package-2
      package-3
      package-4
      `);
    });

    it("should also list private packages with --all", async () => {
      await lernaLs(testDir)("--all");
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1
      package-2
      package-3
      package-4
      package-5 (PRIVATE)
      `);
    });

    it("lists public package versions and relative paths with --long", async () => {
      await lernaLs(testDir)("--long");
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1 v1.0.0 packages/package-1
      package-2 v1.0.0 packages/package-2
      package-3 v1.0.0 packages/package-3
      package-4 v1.0.0 packages/package-4
      `);
    });

    it("lists all package versions and relative paths with --long --all", async () => {
      await lernaLs(testDir)("-la");
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1 v1.0.0 packages/package-1
      package-2 v1.0.0 packages/package-2
      package-3 v1.0.0 packages/package-3
      package-4 v1.0.0 packages/package-4
      package-5 v1.0.0 packages/package-5 (PRIVATE)
      `);
    });

    it("lists public package locations with --parseable", async () => {
      await lernaLs(testDir)("--parseable");
      expect(output.logged()).toMatchInlineSnapshot(`
      __TEST_ROOTDIR__/packages/package-1
      __TEST_ROOTDIR__/packages/package-2
      __TEST_ROOTDIR__/packages/package-3
      __TEST_ROOTDIR__/packages/package-4
      `);
    });

    it("lists all package locations with --parseable --all", async () => {
      await lernaLs(testDir)("-pa");
      expect(output.logged()).toMatchInlineSnapshot(`
      __TEST_ROOTDIR__/packages/package-1
      __TEST_ROOTDIR__/packages/package-2
      __TEST_ROOTDIR__/packages/package-3
      __TEST_ROOTDIR__/packages/package-4
      __TEST_ROOTDIR__/packages/package-5
      `);
    });

    it("lists public package locations with --parseable --long", async () => {
      await lernaLs(testDir)("--parseable", "--long");
      expect(output.logged()).toMatchInlineSnapshot(`
      __TEST_ROOTDIR__/packages/package-1:package-1:1.0.0
      __TEST_ROOTDIR__/packages/package-2:package-2:1.0.0
      __TEST_ROOTDIR__/packages/package-3:package-3:1.0.0
      __TEST_ROOTDIR__/packages/package-4:package-4:1.0.0
      `);
    });

    it("lists all package locations with --parseable --long --all", async () => {
      await lernaLs(testDir)("-pal");
      expect(output.logged()).toMatchInlineSnapshot(`
      __TEST_ROOTDIR__/packages/package-1:package-1:1.0.0
      __TEST_ROOTDIR__/packages/package-2:package-2:1.0.0
      __TEST_ROOTDIR__/packages/package-3:package-3:1.0.0
      __TEST_ROOTDIR__/packages/package-4:package-4:1.0.0
      __TEST_ROOTDIR__/packages/package-5:package-5:1.0.0:PRIVATE
      `);
    });

    it("lists packages matching --scope", async () => {
      await lernaLs(testDir)("--scope", "package-1");
      expect(output.logged()).toMatchInlineSnapshot(`package-1`);
    });

    it("does not list packages matching --ignore", async () => {
      await lernaLs(testDir)("--ignore", "package-@(2|3|4|5)");
      expect(output.logged()).toMatchInlineSnapshot(`package-1`);
    });

    it("does not list private packages with --no-private", async () => {
      await lernaLs(testDir)("--no-private");
      expect(output.logged()).not.toMatch("package-5 v1.0.0 (private)");
    });

    // TODO: investigate this failure
    it.skip("does not emit empty stdout", async () => {
      collectUpdates.setUpdated(testDir);
      await lernaLs(testDir)("--since", "deadbeef");
      expect(output).not.toHaveBeenCalled();
      expect(collectUpdates).toHaveBeenLastCalledWith(
        expect.any(Array),
        expect.any(Map),
        expect.any(Object),
        expect.objectContaining({ since: "deadbeef" })
      );
    });
  });

  describe("in a repo with packages outside of packages/", () => {
    it("should list packages", async () => {
      const testDir = await initFixture("extra");
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
      package-3
      package-1
      package-2
      `);
    });
  });

  describe("--include-filtered-dependencies", () => {
    it("should list packages, including filtered ones", async () => {
      const testDir = await initFixture("include-filtered-dependencies");
      await lernaLs(testDir)("--scope", "@test/package-2", "--include-filtered-dependencies");
      expect(output.logged()).toMatchInlineSnapshot(`
      @test/package-2
      @test/package-1
      `);
    });
  });

  describe("--include-filtered-dependents", () => {
    it("should list packages, including filtered ones", async () => {
      const testDir = await initFixture("include-filtered-dependencies");
      await lernaLs(testDir)("--scope", "@test/package-1", "--include-filtered-dependents");
      expect(output.logged()).toMatchInlineSnapshot(`
      @test/package-1
      @test/package-2
      `);
    });
  });

  describe("with an undefined version", () => {
    it("replaces version with MISSING", async () => {
      const testDir = await initFixture("undefined-version");
      await lernaLs(testDir)("--long");
      expect(output.logged()).toMatchInlineSnapshot(`package-1 MISSING packages/package-1`);
    });

    it("appends MISSING flag to long parseable output", async () => {
      const testDir = await initFixture("undefined-version");
      await lernaLs(testDir)("--long", "--parseable");
      expect(output.logged()).toMatchInlineSnapshot(`__TEST_ROOTDIR__/packages/package-1:package-1:MISSING`);
    });
  });

  describe("--json", () => {
    it("should list packages as json objects", async () => {
      const testDir = await initFixture("basic");
      await lernaLs(testDir)("--json", "-a");

      // Output should be a parseable string
      const jsonOutput = JSON.parse(output.logged());
      expect(jsonOutput).toEqual([
        {
          location: expect.stringContaining("package-1"),
          name: "package-1",
          private: false,
          version: "1.0.0",
        },
        {
          location: expect.stringContaining("package-2"),
          name: "package-2",
          private: false,
          version: "1.0.0",
        },
        {
          location: expect.stringContaining("package-3"),
          name: "package-3",
          private: false,
          version: "1.0.0",
        },
        {
          location: expect.stringContaining("package-4"),
          name: "package-4",
          private: false,
          version: "1.0.0",
        },
        {
          location: expect.stringContaining("package-5"),
          name: "package-5",
          private: true,
          version: "1.0.0",
        },
      ]);
    });

    // TODO: investigate this failure
    it.skip("emits empty array with no results", async () => {
      const testDir = await initFixture("basic");

      collectUpdates.setUpdated(testDir);
      await lernaLs(testDir)("--since", "deadbeef", "--json");

      expect(JSON.parse(output.logged())).toEqual([]);
    });
  });

  describe("in a Yarn workspace", () => {
    it("should use package.json/workspaces setting", async () => {
      const testDir = await initFixture("yarn-workspaces");
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
    package-1
    package-2
    `);
    });
  });

  describe("with terribly complicated dependency cycles", () => {
    // for reference: 1->2, 1->3, 1->4, 2->4, 2->5, 3->4, 3->6, 4->1, 4->4,  5->4, 6->4, 7->4
    // We design the package tree in a very specific way. We want to test several different things
    // * A package depending on itself isn't added twice (package 4)
    // * A package being added twice in the same stage of the expansion isn't added twice (package 4)
    // * A package that has already been processed wont get added twice (package 1)
    it("should list all packages with no repeats", async () => {
      const testDir = await initFixture("cycles-and-repeated-deps");
      await lernaLs(testDir)("--scope", "package-1", "--include-filtered-dependencies");

      // should follow all transitive deps and pass all packages except 7 with no repeats
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1
      package-2
      package-3
      package-4
      package-5
      package-6
      `);
    });
  });

  describe("with fancy 'packages' configuration", () => {
    it("lists globstar-nested packages", async () => {
      const testDir = await initFixture("globstar");
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
      globstar
      package-2
      package-4
      package-1
      package-3
      package-5
      `);
    });
  });

  describe("with multiple packages folders", () => {
    it("should exclude packages in directories not included in the packages property", async () => {
      const testDir = await initFixture("exclude-packages");
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1
      package-2
      package-3
      `);
    });

    it("should exclude packages in directories not included in the workspaces configuration", async () => {
      const testDir = await initFixture("exclude-packages-workspaces");
      await lernaLs(testDir)();
      expect(output.logged()).toMatchInlineSnapshot(`
      package-1
      package-2
      package-3
      `);
    });
  });
});