Function resolveScope

packages/cli/src/git.ts:374–426

(options: ResolveScopeOptions = {})

}

export function resolveScope(options: ResolveScopeOptions = {}): ResolvedScope {
	const refs = options.refs === undefined ? [] : options.refs;
	if (refs.length > 2) {
		throw new Error("Expected at most two git ref arguments.");
	}
	if (refs.length > 0 && (options.base !== undefined || options.compare !== undefined)) {
		throw new Error("Cannot use --base/--compare with positional git ref arguments.");
	}
	if (refs.length > 0 && options.workingTreeRef !== undefined) {
		throw new Error("Cannot use --ref with positional git ref arguments.");
	}
	if (options.compare !== undefined && options.workingTreeRef !== undefined) {
		throw new Error("Cannot use --compare with --ref.");
	}

	if (options.compare !== undefined) {
		if (options.base === undefined) {
			throw new Error("--compare requires --base.");
		}
		return resolveCommittedComparison(options.base, options.compare);
	}

	if (refs.length === 2) {
		const left = refs[0];
		const right = refs[1];
		if (left === undefined || right === undefined) {
			throw new Error("Expected both base and compare refs.");
		}
		return resolveCommittedComparison(left, right);
	}

	if (refs.length === 1) {
		const ref = refs[0];
		if (ref === undefined) {
			throw new Error("Expected a git ref argument.");
		}

		const range = parseRefRange(ref);
		if (range) return resolveCommittedComparison(range.left, range.right);

		if (!canResolveRef(ref)) {
			const workingTreeRef = parseWorkingTreeRefArg(ref);
			if (workingTreeRef) {
				return resolveSingleRefScope(detectBaseRef(), workingTreeRef);
			}
		}

		return resolveSingleRefScope(ref);
	}

	const base = options.base === undefined ? detectBaseRef() : options.base;
	return resolveSingleRefScope(base, options.workingTreeRef);
}