233 lines
9.2 KiB
TypeScript
233 lines
9.2 KiB
TypeScript
import { execFileSync } from 'node:child_process'
|
|
import { mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from 'node:fs'
|
|
import { tmpdir } from 'node:os'
|
|
import { dirname, join } from 'node:path'
|
|
import { afterEach, describe, expect, it } from 'vitest'
|
|
|
|
import { writeChangeScope } from './change-scope.ts'
|
|
|
|
interface Report {
|
|
formatVersion: number
|
|
repository: { root: string; branch: string | null; upstream: string | null }
|
|
input: { base: string; head: string }
|
|
resolved: { baseSha: string; headSha: string; mergeBaseSha: string }
|
|
paths: { committed: string[]; staged: string[]; unstaged: string[]; untracked: string[] }
|
|
}
|
|
|
|
interface Fixture {
|
|
container: string
|
|
root: string
|
|
origin: string
|
|
}
|
|
|
|
const fixtureRoots: string[] = []
|
|
|
|
afterEach(() => {
|
|
for (const root of fixtureRoots.splice(0)) rmSync(root, { recursive: true, force: true })
|
|
})
|
|
|
|
function git(cwd: string, args: string[], input?: string): string {
|
|
return execFileSync('git', ['-C', cwd, ...args], {
|
|
encoding: 'utf8',
|
|
env: { ...process.env, LANG: 'C', LC_ALL: 'C' },
|
|
input,
|
|
stdio: ['pipe', 'pipe', 'pipe'],
|
|
}).trim()
|
|
}
|
|
|
|
function write(path: string, content: string): void {
|
|
mkdirSync(dirname(path), { recursive: true })
|
|
writeFileSync(path, content)
|
|
}
|
|
|
|
function fixture(worktreeName = 'worktree'): Fixture {
|
|
const container = mkdtempSync(join(tmpdir(), 'dsh-change-scope-'))
|
|
fixtureRoots.push(container)
|
|
const origin = join(container, 'origin.git')
|
|
const root = join(container, worktreeName)
|
|
const hooks = join(container, 'hooks')
|
|
mkdirSync(hooks)
|
|
git(container, ['init', '--bare', '--initial-branch=master', origin])
|
|
git(container, ['init', '--initial-branch=master', root])
|
|
git(root, ['config', 'user.email', 'change-scope@example.com'])
|
|
git(root, ['config', 'user.name', 'Change Scope Tests'])
|
|
git(root, ['config', 'commit.gpgsign', 'false'])
|
|
git(root, ['config', 'core.hooksPath', hooks])
|
|
write(join(root, 'README.md'), '# Fixture\n')
|
|
git(root, ['add', 'README.md'])
|
|
git(root, ['commit', '-m', 'initial'])
|
|
git(root, ['remote', 'add', 'origin', origin])
|
|
git(root, ['push', '--set-upstream', 'origin', 'master'])
|
|
return { container, root, origin }
|
|
}
|
|
|
|
function commit(root: string, path: string, content: string): string {
|
|
write(join(root, path), content)
|
|
git(root, ['add', '--', path])
|
|
git(root, ['commit', '-m', `add ${path}`])
|
|
return git(root, ['rev-parse', 'HEAD'])
|
|
}
|
|
|
|
function invoke(root: string, args: string[]): string {
|
|
const output: string[] = []
|
|
writeChangeScope(args, root, chunk => output.push(chunk))
|
|
expect(output).toHaveLength(1)
|
|
return output[0] as string
|
|
}
|
|
|
|
function jsonReport(root: string, base: string, head?: string): Report {
|
|
const args = ['--base', base, '--json']
|
|
if (head !== undefined) args.push('--head', head)
|
|
return JSON.parse(invoke(root, args)) as Report
|
|
}
|
|
|
|
function formatHumanFromJson(report: Report): string {
|
|
const value = (input: string | null): string => JSON.stringify(input) ?? 'null'
|
|
const paths = (label: string, entries: string[]): string[] => [
|
|
`${label} (${entries.length}):`,
|
|
...(entries.length === 0 ? [' (none)'] : entries.map(entry => ` - ${value(entry)}`)),
|
|
]
|
|
return [
|
|
`Format version: ${report.formatVersion}`,
|
|
`Repository root: ${value(report.repository.root)}`,
|
|
`Branch: ${value(report.repository.branch)}`,
|
|
`Upstream: ${value(report.repository.upstream)}`,
|
|
`Base ref: ${value(report.input.base)}`,
|
|
`Head ref: ${value(report.input.head)}`,
|
|
`Base commit: ${report.resolved.baseSha}`,
|
|
`Head commit: ${report.resolved.headSha}`,
|
|
`Merge base: ${report.resolved.mergeBaseSha}`,
|
|
...paths('Committed paths', report.paths.committed),
|
|
...paths('Staged paths', report.paths.staged),
|
|
...paths('Unstaged paths', report.paths.unstaged),
|
|
...paths('Untracked paths', report.paths.untracked),
|
|
'',
|
|
].join('\n')
|
|
}
|
|
|
|
function repositoryState(root: string): Record<string, string> {
|
|
const status = git(root, ['status', '--porcelain=v2', '--branch', '-z'])
|
|
return {
|
|
status,
|
|
head: git(root, ['rev-parse', 'HEAD']),
|
|
refs: git(root, ['for-each-ref', '--format=%(refname) %(objectname)']),
|
|
index: readFileSync(join(root, '.git/index')).toString('base64'),
|
|
config: readFileSync(join(root, '.git/config')).toString('base64'),
|
|
}
|
|
}
|
|
|
|
describe('change-scope', () => {
|
|
it('uses an explicit base on a fresh branch without a same-name remote and after its first push', () => {
|
|
const { root } = fixture()
|
|
git(root, ['switch', '-c', 'feature'])
|
|
git(root, ['branch', '--set-upstream-to=origin/master'])
|
|
const headSha = commit(root, 'feature.txt', 'feature\n')
|
|
|
|
const fresh = jsonReport(root, 'origin/master')
|
|
expect(fresh.repository).toEqual({ root: realpathSync(root), branch: 'feature', upstream: 'origin/master' })
|
|
expect(fresh.resolved).toEqual({
|
|
baseSha: git(root, ['rev-parse', 'origin/master']),
|
|
headSha,
|
|
mergeBaseSha: git(root, ['rev-parse', 'origin/master']),
|
|
})
|
|
expect(fresh.paths).toEqual({ committed: ['feature.txt'], staged: [], unstaged: [], untracked: [] })
|
|
expect(git(root, ['for-each-ref', '--format=%(refname)', 'refs/remotes/origin/feature'])).toBe('')
|
|
|
|
git(root, ['push', '--set-upstream', 'origin', 'feature'])
|
|
const pushed = jsonReport(root, 'origin/master')
|
|
expect(pushed.repository.upstream).toBe('origin/feature')
|
|
expect(pushed.paths.committed).toEqual(['feature.txt'])
|
|
})
|
|
|
|
it.skipIf(process.platform === 'win32')('preserves trailing spaces in the worktree path', () => {
|
|
const { root } = fixture('worktree ')
|
|
const report = jsonReport(root, 'HEAD')
|
|
|
|
expect(report.repository.root).toBe(realpathSync(root))
|
|
expect(report.paths).toEqual({ committed: [], staged: [], unstaged: [], untracked: [] })
|
|
})
|
|
|
|
it('reports an exact head above a non-master stacked base while dirty paths remain worktree-local', () => {
|
|
const { root } = fixture()
|
|
git(root, ['switch', '-c', 'foundation'])
|
|
const baseSha = commit(root, 'foundation.txt', 'foundation\n')
|
|
git(root, ['switch', '-c', 'topic'])
|
|
const headSha = commit(root, 'topic.txt', 'topic\n')
|
|
commit(root, 'later.txt', 'later\n')
|
|
write(join(root, 'current-worktree.txt'), 'current worktree\n')
|
|
|
|
const report = jsonReport(root, 'foundation', headSha)
|
|
expect(report.input).toEqual({ base: 'foundation', head: headSha })
|
|
expect(report.resolved).toEqual({ baseSha, headSha, mergeBaseSha: baseSha })
|
|
expect(report.paths.committed).toEqual(['topic.txt'])
|
|
expect(report.paths.untracked).toEqual(['current-worktree.txt'])
|
|
})
|
|
|
|
it('keeps committed, staged, unstaged, and untracked paths independent and does not mutate state', () => {
|
|
const { root } = fixture()
|
|
commit(root, 'unstaged.txt', 'before\n')
|
|
const baseSha = git(root, ['rev-parse', 'HEAD'])
|
|
commit(root, 'committed.txt', 'committed\n')
|
|
write(join(root, 'staged.txt'), 'staged\n')
|
|
write(join(root, 'mixed.txt'), 'staged part\n')
|
|
git(root, ['add', 'staged.txt', 'mixed.txt'])
|
|
write(join(root, 'mixed.txt'), 'staged part\nunstaged part\n')
|
|
write(join(root, 'unstaged.txt'), 'unstaged\n')
|
|
write(join(root, 'untracked.txt'), 'untracked\n')
|
|
const before = repositoryState(root)
|
|
|
|
const report = jsonReport(root, baseSha)
|
|
|
|
expect(report.paths).toEqual({
|
|
committed: ['committed.txt'],
|
|
staged: ['mixed.txt', 'staged.txt'],
|
|
unstaged: ['mixed.txt', 'unstaged.txt'],
|
|
untracked: ['untracked.txt'],
|
|
})
|
|
expect(repositoryState(root)).toEqual(before)
|
|
})
|
|
|
|
it('rejects missing, ambiguous, and non-commit refs before writing output', () => {
|
|
const { root } = fixture()
|
|
git(root, ['branch', 'collision'])
|
|
git(root, ['tag', 'collision'])
|
|
write(join(root, 'blob.txt'), 'blob\n')
|
|
const blobSha = git(root, ['hash-object', '-w', 'blob.txt'])
|
|
git(root, ['tag', 'blob-ref', blobSha])
|
|
|
|
for (const { args, message } of [
|
|
{ args: ['--base', 'missing'], message: /base ref .* does not resolve to a commit/u },
|
|
{ args: ['--base', 'collision'], message: /base ref .* is ambiguous/u },
|
|
{ args: ['--base', 'blob-ref'], message: /base ref .* does not resolve to a commit/u },
|
|
{ args: ['--base', 'HEAD', '--head', 'missing'], message: /head ref .* does not resolve to a commit/u },
|
|
]) {
|
|
const output: string[] = []
|
|
expect(() => {
|
|
writeChangeScope(args, root, (chunk) => {
|
|
output.push(chunk)
|
|
})
|
|
}).toThrow(message)
|
|
expect(output).toEqual([])
|
|
}
|
|
})
|
|
|
|
it('renders deterministic human and JSON forms with the same facts', () => {
|
|
const { root } = fixture()
|
|
git(root, ['switch', '-c', 'format'])
|
|
commit(root, 'zeta.txt', 'zeta\n')
|
|
commit(root, 'alpha.txt', 'alpha\n')
|
|
|
|
const json = invoke(root, ['--base', 'origin/master', '--json'])
|
|
const repeatedJson = invoke(root, ['--base', 'origin/master', '--json'])
|
|
const human = invoke(root, ['--base', 'origin/master'])
|
|
const repeatedHuman = invoke(root, ['--base', 'origin/master'])
|
|
const report = JSON.parse(json) as Report
|
|
|
|
expect(json).toBe(repeatedJson)
|
|
expect(report.formatVersion).toBe(1)
|
|
expect(report.paths.committed).toEqual(['alpha.txt', 'zeta.txt'])
|
|
expect(human).toBe(repeatedHuman)
|
|
expect(human).toBe(formatHumanFromJson(report))
|
|
})
|
|
})
|