alex-c-line 2.6.2 → 2.7.1

package/dist/configs/index.cjs

@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 require("@alextheman/utility");
 let zod = require("zod");
-zod = __toESM(zod);
+zod = __toESM(zod, 1);
 let _alextheman_utility_internal = require("@alextheman/utility/internal");
 //#region src/configs/helpers/preCommit/definePreCommitConfig.ts
 const preCommitStepOptionsSchema = zod.default.strictObject({ arguments: zod.default.array(zod.default.string()).optional() });

package/dist/index.cjs

@@ -22,17 +22,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let commander = require("commander");
-let _alextheman_utility = require("@alextheman/utility");
+let _alextheman_utility_v6 = require("@alextheman/utility/v6");
 let chalk = require("chalk");
-chalk = __toESM(chalk);
+chalk = __toESM(chalk, 1);
 let boxen = require("boxen");
-boxen = __toESM(boxen);
+boxen = __toESM(boxen, 1);
 let figlet = require("figlet");
-figlet = __toESM(figlet);
+figlet = __toESM(figlet, 1);
 let env_paths = require("env-paths");
-env_paths = __toESM(env_paths);
+env_paths = __toESM(env_paths, 1);
 let node_path = require("node:path");
-node_path = __toESM(node_path);
+node_path = __toESM(node_path, 1);
+let _alextheman_utility = require("@alextheman/utility");
 let _inquirer_prompts = require("@inquirer/prompts");
 let node_fs_promises = require("node:fs/promises");
 let dotenv = require("dotenv");
@@ -40,15 +41,16 @@ let execa = require("execa");
 let node_url = require("node:url");
 let _alextheman_utility_internal = require("@alextheman/utility/internal");
 let zod = require("zod");
-zod = __toESM(zod);
+zod = __toESM(zod, 1);
 let node_module = require("node:module");
+let toml = require("toml");
 let gray_matter = require("gray-matter");
-gray_matter = __toESM(gray_matter);
+gray_matter = __toESM(gray_matter, 1);
 let _alextheman_utility_node = require("@alextheman/utility/node");
 let axios = require("axios");
-axios = __toESM(axios);
+axios = __toESM(axios, 1);
 let supports_color = require("supports-color");
-supports_color = __toESM(supports_color);
+supports_color = __toESM(supports_color, 1);
 let node_crypto = require("node:crypto");
 let semver = require("semver");
 //#region src/utility/miscellaneous/centerLine.ts
@@ -82,7 +84,7 @@ async function createAlexCLineArtwork(options) {
 //#region src/cli/commands/artwork/log.ts
 function artworkLog(program) {
 	program.command("log").description("Log the alex-c-line artwork to the console.").option("--subtitle-text <subtitleText>", "Customise the subtitle text.").option("--subtitle-color <subtitleColor>", "Customise the subtitle color.").action(async ({ subtitleText, subtitleColor = "green" }) => {
-		if (subtitleColor !== "green" && subtitleColor !== "white") throw new _alextheman_utility.DataError({ subtitleColor }, "INVALID_SUBTITLE_COLOR", "Subtitle color must either be green or white.");
+		if (subtitleColor !== "green" && subtitleColor !== "white") throw new _alextheman_utility_v6.DataError({ subtitleColor }, "INVALID_SUBTITLE_COLOR", "Subtitle color must either be green or white.");
 		const chalkColour = {
 			green: chalk.default.green,
 			white: chalk.default.white
@@ -120,8 +122,8 @@ function cache(program) {
 	loadCommands(program.command("cache").description("Commands related to the alex-c-line cache"), { cachePath });
 }
 //#endregion
-//#region src/utility/constants/errorPrefix.ts
-const errorPrefix = "❌ ERROR:";
+//#region src/utility/constants/ERROR_PREFIX.ts
+const ERROR_PREFIX = "❌ ERROR:";
 //#endregion
 //#region src/utility/envFile/upsertDotenvFile.ts
 async function upsertDotenvFile(contents, envFilePath) {
@@ -132,14 +134,14 @@ async function upsertDotenvFile(contents, envFilePath) {
 async function addVariable(program, envFileContents, file) {
 	const newVariableName = await (0, _inquirer_prompts.input)({ message: "Please enter the name of the environment variable you would like to add." });
 	if (newVariableName in envFileContents) program.error(`
-            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
+            ${ERROR_PREFIX} Error with chosen environment variable name ${newVariableName}.
             Variable name already exists. If you wish to edit this variable, please select it from the initial menu instead.
             `, {
 		exitCode: 2,
 		code: "DUPLICATE_ENVIRONMENT_VARIABLE_NAME"
 	});
 	if (/[ \t\r\n]/.test(newVariableName)) program.error(_alextheman_utility.normaliseIndents`
-            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
+            ${ERROR_PREFIX} Error with chosen environment variable name ${newVariableName}.
             Environment variables are not allowed to have whitespace.
             `, {
 		exitCode: 2,
@@ -274,7 +276,7 @@ function checkLockfileVersionDiscrepancy(program) {
 		const { version: packageVersion } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.resolve(process.cwd(), "package-lock.json"), "utf-8"));
 		if (packageVersion !== packageLockVersion) {
-			console.error(`${errorPrefix} package.json and package-lock.json out of sync. Please run \`npm install\` to fix this.`);
+			console.error(`${ERROR_PREFIX} package.json and package-lock.json out of sync. Please run \`npm install\` to fix this.`);
 			process.exitCode = 1;
 			return;
 		}
@@ -287,7 +289,7 @@ function gitPostMergeCleanup(program) {
 	program.command("git-post-merge-cleanup").alias("git-cleanup").description("Run after merging into a given branch to quickly clean up").argument("[branch]", "The branch you want to merge into", "main").option("--rebase", "Enable if your repository mainly rebases into main", true).action(async (branch, { rebase }) => {
 		console.info(`Running git-post-merge-cleanup in ${rebase ? "rebase" : "merge"} mode...`);
 		const { stdout: currentBranch } = await execa.execa`git branch --show-current`;
-		if (currentBranch === branch) program.error(`${errorPrefix} Cannot run cleanup on ${branch} branch!`, {
+		if (currentBranch === branch) program.error(`${ERROR_PREFIX} Cannot run cleanup on ${branch} branch!`, {
 			exitCode: 1,
 			code: "INVALID_BRANCH"
 		});
@@ -303,7 +305,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: changes } = await execa.execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa.execa`git checkout ${currentBranch}`;
-				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
+				program.error(`${ERROR_PREFIX} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -313,7 +315,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: branchDeletedMessage, exitCode } = await (0, execa.execa)({ reject: false })`git branch --delete ${currentBranch}`;
 			if (exitCode !== 0) {
 				await execa.execa`git checkout ${currentBranch}`;
-				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
+				program.error(`${ERROR_PREFIX} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -323,8 +325,8 @@ function gitPostMergeCleanup(program) {
 	});
 }
 //#endregion
-//#region src/utility/constants/warningPrefix.ts
-const warningPrefix = "WARNING:";
+//#region src/utility/constants/WARNING_PREFIX.ts
+const WARNING_PREFIX = "WARNING:";
 //#endregion
 //#region src/utility/fileSystem/readdirSafe.ts
 async function readdirSafe(path) {
@@ -361,7 +363,7 @@ function internalMediaGenerate(program) {
 				if (resolution) return await runManimCommand`manim -qh -r ${resolution} ${file}`;
 				return await runManimCommand`manim -qh ${file}`;
 			} catch (error) {
-				if (error instanceof execa.ExecaError) program.error(`${errorPrefix} An error has occurred with Manim while rendering ${relativePath}.`, {
+				if (error instanceof execa.ExecaError) program.error(`${ERROR_PREFIX} An error has occurred with Manim while rendering ${relativePath}.`, {
 					exitCode: error.exitCode ?? 1,
 					code: "MANIM_ERROR"
 				});
@@ -380,7 +382,7 @@ function internalMediaGenerate(program) {
 		const statResult = await (0, node_fs_promises.stat)(target);
 		if (statResult.isFile()) await renderFile(target);
 		else if (statResult.isDirectory()) await readDirectory(target);
-		else console.warn(`${warningPrefix} Not a file or directory.`);
+		else console.warn(`${WARNING_PREFIX} Not a file or directory.`);
 	});
 }
 //#endregion
@@ -401,10 +403,10 @@ async function findPackageRoot(startDirectory, packageName) {
 		if (parent === directory) break;
 		directory = parent;
 	}
-	throw new _alextheman_utility.DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
+	throw new _alextheman_utility_v6.DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
 }
 //#endregion
-//#region src/utility/constants/alexCLinePackageRoot.ts
+//#region src/utility/constants/ALEX_C_LINE_PACKAGE_ROOT.ts
 const __filename$3 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
 const ALEX_C_LINE_PACKAGE_ROOT = findPackageRoot(node_path.default.dirname(__filename$3), "alex-c-line");
 //#endregion
@@ -583,16 +585,16 @@ async function findTgzFile(packagePath, packageManager) {
 	const tgzFiles = (await (0, node_fs_promises.readdir)(packagePath)).filter((fileName) => {
 		return fileName.endsWith(".tgz");
 	});
-	if (tgzFiles.length === 0) throw new _alextheman_utility.DataError({ tgzFiles }, "TGZ_FILE_NOT_FOUND", "Could not find any .tgz files");
+	if (tgzFiles.length === 0) throw new _alextheman_utility_v6.DataError({ tgzFiles }, "TGZ_FILE_NOT_FOUND", "Could not find any .tgz files");
 	const expectedTgzFileName = await (0, _alextheman_utility_internal.getExpectedTgzName)(packagePath, packageManager);
 	const amountOfMatchingFiles = tgzFiles.filter((fileName) => {
 		return fileName === expectedTgzFileName;
 	}).length;
-	if (amountOfMatchingFiles === 0) throw new _alextheman_utility.DataError({
+	if (amountOfMatchingFiles === 0) throw new _alextheman_utility_v6.DataError({
 		expectedTgzFileName,
 		amountOfMatchingFiles
 	}, "EXPECTED_FILE_NOT_FOUND", "Could not find a .tgz file with the expected file name.");
-	if (amountOfMatchingFiles > 1) throw new _alextheman_utility.DataError({
+	if (amountOfMatchingFiles > 1) throw new _alextheman_utility_v6.DataError({
 		expectedTgzFileName,
 		amountOfMatchingFiles
 	}, "AMBIGUOUS_RESOLUTION", "There are too many .tgz files with the expected file name.");
@@ -618,27 +620,27 @@ function localPackageUse(program) {
 			PrivateConfigFileName.ES_MODULES_JAVASCRIPT,
 			PrivateConfigFileName.STANDARD_JAVASCRIPT
 		]);
-		if (!configPath) throw new _alextheman_utility.DataError({ configPath }, "ALEX_C_LINE_PRIVATE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line private config file (should be `.alex-c-line.private.config.js`). Does it exist?");
+		if (!configPath) throw new _alextheman_utility_v6.DataError({ configPath }, "ALEX_C_LINE_PRIVATE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line private config file (should be `.alex-c-line.private.config.js`). Does it exist?");
 		const { localPackage: { enableCache, localPackages } } = await loadAlexCLinePrivateConfig(configPath);
 		const localPackage = localPackages[packageName];
-		if (!localPackage) throw new _alextheman_utility.DataError({
+		if (!localPackage) throw new _alextheman_utility_v6.DataError({
 			packageName,
 			configPath
 		}, "PACKAGE_NOT_FOUND", `Could not find ${packageName} in your private config.`);
 		const { packageManager, prepareScript = "build", dependencyGroup = "dependencies", keepOldTarballs } = localPackage;
 		const packageInfo = await (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
-		if (packageInfo === null) throw new _alextheman_utility.DataError({ currentDirectory: process.cwd() }, "MISSING_CURRENT_REPOSITORY_PACKAGE_JSON", "Could not find package.json in the current location");
+		if (packageInfo === null) throw new _alextheman_utility_v6.DataError({ currentDirectory: process.cwd() }, "MISSING_CURRENT_REPOSITORY_PACKAGE_JSON", "Could not find package.json in the current location");
 		const dependencies = (0, _alextheman_utility_internal.getDependenciesFromGroup)(packageInfo, dependencyGroup);
-		if (!(packageName in dependencies) && packageName !== "alex-c-line") throw new _alextheman_utility.DataError({
+		if (!(packageName in dependencies) && packageName !== "alex-c-line") throw new _alextheman_utility_v6.DataError({
 			packageName,
 			dependencyGroup,
 			packagePath: process.cwd()
 		}, "PACKAGE_NOT_FOUND", `Could not find ${packageName} in the ${dependencyGroup} of your package.json.`);
 		const localPackagePath = node_path.default.resolve(process.cwd(), localPackage.path);
 		const localPackageInfo = await (0, _alextheman_utility_internal.getPackageJsonContents)(localPackagePath);
-		if (localPackageInfo === null) throw new _alextheman_utility.DataError({ localPackagePath }, "MISSING_PACKAGE_REPOSITORY_PACKAGE_JSON", "Could not find package.json in the package repository.");
+		if (localPackageInfo === null) throw new _alextheman_utility_v6.DataError({ localPackagePath }, "MISSING_PACKAGE_REPOSITORY_PACKAGE_JSON", "Could not find package.json in the package repository.");
 		const localPackageRepositoryName = (0, _alextheman_utility.parseZodSchema)(zod.default.string(), localPackageInfo.name);
-		if (localPackageRepositoryName !== packageName) throw new _alextheman_utility.DataError({
+		if (localPackageRepositoryName !== packageName) throw new _alextheman_utility_v6.DataError({
 			providedPackageName: packageName,
 			localPackagePath,
 			localPackageRepositoryName
@@ -655,7 +657,7 @@ function localPackageUse(program) {
 				stdio: "inherit",
 				reject: false
 			});
-			if (exitCode !== 0) program.error(`${errorPrefix} An error occurred during the local \`alex-c-line\` run.`, {
+			if (exitCode !== 0) program.error(`${ERROR_PREFIX} An error occurred during the local \`alex-c-line\` run.`, {
 				exitCode,
 				code: "LOCAL_ALEX_C_LINE_ERROR"
 			});
@@ -718,6 +720,43 @@ function localPackage(program) {
 	loadCommands(program.command("local-package").description("Manage the use of local packages in your JavaScript project."), { localPackageUse });
 }
 //#endregion
+//#region src/utility/constants/SUCCESS_PREFIX.ts
+const SUCCESS_PREFIX = chalk.default.green("✓");
+//#endregion
+//#region src/cli/commands/pyproject/check/preferExactDependencyVersions.ts
+const pyprojectSchema = zod.default.object({
+	project: zod.default.object({ dependencies: zod.default.array(zod.default.string()).optional() }),
+	"dependency-groups": zod.default.object({ dev: zod.default.array(zod.default.string()).optional() })
+}).partial();
+async function preferExactDependencyVersions(program) {
+	const data = (0, _alextheman_utility.parseZodSchema)(pyprojectSchema, (0, toml.parse)(await (0, node_fs_promises.readFile)("pyproject.toml", "utf-8")));
+	const sections = [data.project?.dependencies ?? [], data["dependency-groups"]?.dev ?? []];
+	const violations = [];
+	for (const dependencies of sections) for (const dependency of dependencies) if (!dependency.includes("==")) violations.push(dependency);
+	if (violations.length !== 0) program.error(`${ERROR_PREFIX} Non-exact dependencies found:\n\n${violations.join("\n")}`, {
+		code: "NON_EXACT_DEPENDENCIES_FOUND",
+		exitCode: 2
+	});
+	console.info(`${SUCCESS_PREFIX} All dependencies are exactly pinned`);
+}
+//#endregion
+//#region src/cli/commands/pyproject/check/index.ts
+const RuleName$1 = { PREFER_EXACT_DEPENDENCY_VERSIONS: "prefer-exact-dependency-versions" };
+function pyprojectCheck(program) {
+	program.command("check").description("Run checks on your pyproject.toml file").option("--rules <rules>", "The name of the rule to check", (rawRules) => {
+		const rawRuleNamesArray = rawRules.split(",");
+		return (0, _alextheman_utility.parseZodSchema)(zod.default.array(zod.default.enum(RuleName$1)), rawRuleNamesArray);
+	}).action(async ({ rules }) => {
+		if (rules?.includes("prefer-exact-dependency-versions")) await preferExactDependencyVersions(program);
+		console.info(`${SUCCESS_PREFIX} Success! All checks passed!`);
+	});
+}
+//#endregion
+//#region src/cli/commands/pyproject/index.ts
+function pyproject(program) {
+	loadCommands(program.command("pyproject").description("Manage the pyproject.toml file."), { pyprojectCheck });
+}
+//#endregion
 //#region src/cli/commands/root/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = (0, execa.execa)({
 	stdio: "inherit",
@@ -755,7 +794,7 @@ function createStepRunner(program) {
 //#endregion
 //#region src/cli/commands/root/pre-commit/getCommandArguments.ts
 function getCommandArguments(program, script, scripts, args) {
-	if (!(script in (scripts ?? {}))) program.error(`${errorPrefix} Could not find script \`${script}\` in package.json.`, {
+	if (!(script in (scripts ?? {}))) program.error(`${ERROR_PREFIX} Could not find script \`${script}\` in package.json.`, {
 		exitCode: 1,
 		code: "SCRIPT_NOT_FOUND"
 	});
@@ -779,16 +818,16 @@ async function loadAlexCLineConfig(filePath) {
 function preCommit(program) {
 	program.command("pre-commit").description("Run the pre-commit scripts specified in the alex-c-line config (v2 experiment).").option("--allow-no-staged-changes", "Run even if nothing is staged").option("--no-update-index").option("--update-index", "Update the git index after the run").action(async (options) => {
 		const configPath = await findAlexCLineConfig(process.cwd());
-		if (!configPath) throw new _alextheman_utility.DataError({ configPath }, "ALEX_C_LINE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line config file. Does it exist?");
+		if (!configPath) throw new _alextheman_utility_v6.DataError({ configPath }, "ALEX_C_LINE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line config file. Does it exist?");
 		const { preCommit: preCommitConfig } = await loadAlexCLineConfig(configPath);
-		if (!preCommitConfig) throw new _alextheman_utility.DataError({
+		if (!preCommitConfig) throw new _alextheman_utility_v6.DataError({
 			configPath,
 			preCommitConfig
 		}, "PRE_COMMIT_CONFIG_NOT_FOUND", "Could not find the pre-commit config in alex-c-line config.");
 		const { allowNoStagedChanges = options?.allowNoStagedChanges, updateIndex = options?.updateIndex } = preCommitConfig;
 		const { exitCode: diffExitCode } = await (0, execa.execa)({ reject: false })`git diff --cached --quiet`;
 		switch (diffExitCode) {
-			case 128: program.error(`${errorPrefix} Not currently in a Git repository`, {
+			case 128: program.error(`${ERROR_PREFIX} Not currently in a Git repository`, {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -799,7 +838,7 @@ function preCommit(program) {
 		}
 		const { packageManager: packagePackageManager, scripts } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(process.cwd(), "package.json"), "utf8"));
 		const rawPackageManager = preCommitConfig.packageManager ?? (typeof packagePackageManager === "string" ? packagePackageManager.split("@")[0] : void 0);
-		const packageManager = (0, _alextheman_utility.parseZodSchema)(zod.default.enum(_alextheman_utility_internal.PackageManager), rawPackageManager, new _alextheman_utility.DataError({ packageManager: rawPackageManager }, "UNSUPPORTED_PACKAGE_MANAGER", `This package manager is not currently supported. Only the following are supported: ${Object.values(_alextheman_utility_internal.PackageManager).join(", ")}`));
+		const packageManager = (0, _alextheman_utility.parseZodSchema)(zod.default.enum(_alextheman_utility_internal.PackageManager), rawPackageManager, new _alextheman_utility_v6.DataError({ packageManager: rawPackageManager }, "UNSUPPORTED_PACKAGE_MANAGER", `This package manager is not currently supported. Only the following are supported: ${Object.values(_alextheman_utility_internal.PackageManager).join(", ")}`));
 		const stepRunner = createStepRunner(program);
 		for (const step of preCommitConfig.steps) if (typeof step === "function") await step(stepRunner);
 		else if (typeof step === "string") await stepRunner(packageManager, getCommandArguments(program, step, scripts));
@@ -843,7 +882,7 @@ async function createPullRequestTemplatesFromTemplates(config) {
 	const templateVariables = getTemplateVariables$1(config);
 	const { category } = config;
 	const templatesPath = node_path.default.join(await findPackageRoot(node_path.default.dirname(__filename$2), "alex-c-line"), "templates", "pullRequest");
-	if (!(await (0, node_fs_promises.readdir)(templatesPath)).includes(category)) throw new _alextheman_utility.DataError({ category }, "CATEGORY_NOT_FOUND", "Category folder not found in the templates folder.");
+	if (!(await (0, node_fs_promises.readdir)(templatesPath)).includes(category)) throw new _alextheman_utility_v6.DataError({ category }, "CATEGORY_NOT_FOUND", "Category folder not found in the templates folder.");
 	const categoryPath = node_path.default.join(templatesPath, category);
 	const allCategoryTemplateNames = (await (0, node_fs_promises.readdir)(categoryPath)).filter((name) => {
 		return name.endsWith(".md");
@@ -855,7 +894,7 @@ async function createPullRequestTemplatesFromTemplates(config) {
 		const placeholders = (0, _alextheman_utility.parseZodSchema)(zod.default.array(zod.default.string()).default([]), data.placeholders);
 		let finalContent = content;
 		for (const placeholder of placeholders) {
-			if (!(placeholder in templateVariables)) throw new _alextheman_utility.DataError({ placeholder }, "INVALID_PLACEHOLDER", "The placeholder found in frontmatter can not be found in the metadata.");
+			if (!(placeholder in templateVariables)) throw new _alextheman_utility_v6.DataError({ placeholder }, "INVALID_PLACEHOLDER", "The placeholder found in frontmatter can not be found in the metadata.");
 			finalContent = finalContent.replaceAll(`{{${placeholder}}}`, templateVariables[placeholder]);
 		}
 		allTemplates[templateName] = finalContent;
@@ -874,7 +913,7 @@ function templatePullRequestCreate(program) {
 		const { template: { pullRequest: config } = {} } = configPath ? await loadAlexCLineConfig(configPath) : {};
 		const packageInfo = await (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
 		const { name: projectName } = commandLineOptions.projectName || config?.projectName ? { name: commandLineOptions.projectName ?? config?.projectName } : (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.string() }), packageInfo);
-		if (!projectName) throw new _alextheman_utility.DataError({ projectName }, "PROJECT_NAME_NOT_FOUND", "Could not resolve project name.");
+		if (!projectName) throw new _alextheman_utility_v6.DataError({ projectName }, "PROJECT_NAME_NOT_FOUND", "Could not resolve project name.");
 		const parsedOptions = parseTemplatePullRequestConfig((0, _alextheman_utility.removeUndefinedFromObject)({
 			category: commandLineOptions.category ?? config?.category ?? "general",
 			projectType: commandLineOptions.projectType ?? (config?.category === "general" ? config?.projectType : void 0),
@@ -900,12 +939,9 @@ function templatePullRequest(program) {
 	loadCommands(program.command("pull-request").description("Manage the pull request templates."), { templatePullRequestCreate });
 }
 //#endregion
-//#region src/utility/constants/successPrefix.ts
-const successPrefix = chalk.default.green("✓");
-//#endregion
 //#region src/utility/errors/convertDataErrorToProgramError.ts
 function convertDataErrorToProgramError(dataError, program, options) {
-	program.error(`${errorPrefix} ${dataError.message}`, {
+	program.error(`${ERROR_PREFIX} ${dataError.message}`, {
 		exitCode: options?.exitCode ?? 1,
 		code: dataError.code
 	});
@@ -920,7 +956,7 @@ const ReleaseStatus = {
 //#region src/utility/markdownTemplates/releaseNote/parseReleaseStatus.ts
 function parseReleaseStatus(data) {
 	const normalisedStringifiedData = (typeof data === "string" ? data : String(data)).toUpperCase().replaceAll(" ", "_");
-	if (!Object.keys(ReleaseStatus).includes(normalisedStringifiedData)) new _alextheman_utility.DataError({ data }, "INVALID_RELEASE_STATUS", "Invalid release status. The release status must be one of \"In progress\" or \"Released\"");
+	if (!Object.keys(ReleaseStatus).includes(normalisedStringifiedData)) new _alextheman_utility_v6.DataError({ data }, "INVALID_RELEASE_STATUS", "Invalid release status. The release status must be one of \"In progress\" or \"Released\"");
 	return ReleaseStatus[normalisedStringifiedData];
 }
 //#endregion
@@ -953,7 +989,7 @@ function normaliseMarkdown(markdownString) {
 //#region src/utility/markdownTemplates/releaseNote/getReleaseStatus.ts
 function getReleaseStatus(content) {
 	const releaseStatus = getMarkdownBlock(content, ...getMarkdownCommentPair("alex-c-line-release-status"));
-	if (releaseStatus === null) throw new _alextheman_utility.DataError({ releaseStatus }, "RELEASE_STATUS_NOT_FOUND", "Could not find release status in document.");
+	if (releaseStatus === null) throw new _alextheman_utility_v6.DataError({ releaseStatus }, "RELEASE_STATUS_NOT_FOUND", "Could not find release status in document.");
 	return (0, _alextheman_utility.parseZodSchema)(zod.default.enum(ReleaseStatus), normaliseMarkdown(releaseStatus.split(":")[1]));
 }
 //#endregion
@@ -962,14 +998,14 @@ const __filename$1 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__
 async function validateReleaseDocument(projectName, version, content, allowedReleaseStatus = ["In progress", "Released"]) {
 	if (!normaliseMarkdown(content).startsWith(normaliseMarkdown(_alextheman_utility.normaliseIndents`
             # ${version} (${(0, _alextheman_utility.kebabToCamel)(version.type, { startWithUpper: true })} Release)
-            `))) throw new _alextheman_utility.DataError({ heading: content.split("\n").slice(0, 3).join("\n") }, "INVALID_HEADING", _alextheman_utility.normaliseIndents`
+            `))) throw new _alextheman_utility_v6.DataError({ heading: content.split("\n").slice(0, 3).join("\n") }, "INVALID_HEADING", _alextheman_utility.normaliseIndents`
                 Expected heading to be:
 
                 # ${version} (${(0, _alextheman_utility.kebabToCamel)(version.type, { startWithUpper: true })} Release)
               `);
 	const releaseStatus = getReleaseStatus(content);
 	const allowedReleaseStatuses = (0, _alextheman_utility.removeDuplicates)(Array.isArray(allowedReleaseStatus) ? allowedReleaseStatus : [allowedReleaseStatus]);
-	if (!allowedReleaseStatuses.includes(releaseStatus)) throw new _alextheman_utility.DataError({ releaseStatus }, "INVALID_RELEASE_STATUS", _alextheman_utility.normaliseIndents`
+	if (!allowedReleaseStatuses.includes(releaseStatus)) throw new _alextheman_utility_v6.DataError({ releaseStatus }, "INVALID_RELEASE_STATUS", _alextheman_utility.normaliseIndents`
         Invalid release status.
         Current: "${releaseStatus}"
         Expected: ${allowedReleaseStatuses.length === 1 ? `"${allowedReleaseStatus}"` : `one of: ${allowedReleaseStatuses.map((status) => {
@@ -979,19 +1015,19 @@ async function validateReleaseDocument(projectName, version, content, allowedRel
 	const summary = getMarkdownBlock(content, ...releaseSummaryHeaders);
 	const templateContent = await (0, node_fs_promises.readFile)(node_path.default.join(await findPackageRoot(node_path.default.dirname(__filename$1), "alex-c-line"), "templates", "releases", `${version.type}.md`), "utf-8");
 	const templateSummary = getMarkdownBlock(templateContent, ...releaseSummaryHeaders)?.replaceAll(`{{projectName}}`, projectName);
-	if (!templateSummary) throw new _alextheman_utility.DataError({ templateContent }, "SUMMARY_NOT_FOUND", "Expected to find a release summary but it was not found.");
-	if (!summary) throw new _alextheman_utility.DataError({ content }, "SUMMARY_NOT_FOUND", _alextheman_utility.normaliseIndents`
+	if (!templateSummary) throw new _alextheman_utility_v6.DataError({ templateContent }, "SUMMARY_NOT_FOUND", "Expected to find a release summary but it was not found.");
+	if (!summary) throw new _alextheman_utility_v6.DataError({ content }, "SUMMARY_NOT_FOUND", _alextheman_utility.normaliseIndents`
       Expected to find a release summary but it was not found. Expected release summary to be:
 
       ${templateSummary}
       `);
-	if (normaliseMarkdown(summary) !== normaliseMarkdown(templateSummary)) throw new _alextheman_utility.DataError({ summary }, "INVALID_SUMMARY", _alextheman_utility.normaliseIndents`
+	if (normaliseMarkdown(summary) !== normaliseMarkdown(templateSummary)) throw new _alextheman_utility_v6.DataError({ summary }, "INVALID_SUMMARY", _alextheman_utility.normaliseIndents`
       Summary does not match what was expected. Expected release summary to be:
 
       ${templateSummary}
       `);
-	if (!content.includes("## Description of Changes")) throw new _alextheman_utility.DataError({ content }, "DESCRIPTION_NOT_FOUND", "Expected to find a description of changes but it was not found.");
-	if (version.type === "major" && !content.includes("## Migration Notes")) throw new _alextheman_utility.DataError({ content }, "MIGRATION_NOTES_NOT_FOUND", "Major version notes must have migration notes as major versions are expected to be breaking changes that require users to migrate and refactor their code.");
+	if (!content.includes("## Description of Changes")) throw new _alextheman_utility_v6.DataError({ content }, "DESCRIPTION_NOT_FOUND", "Expected to find a description of changes but it was not found.");
+	if (version.type === "major" && !content.includes("## Migration Notes")) throw new _alextheman_utility_v6.DataError({ content }, "MIGRATION_NOTES_NOT_FOUND", "Major version notes must have migration notes as major versions are expected to be breaking changes that require users to migrate and refactor their code.");
 }
 //#endregion
 //#region src/cli/commands/template/releaseNote/check.ts
@@ -1006,9 +1042,9 @@ function templateReleaseNoteCheck(program) {
 		}).join("."));
 		try {
 			await validateReleaseDocument(name, documentVersion, fileContents, expectedReleaseStatus);
-			console.info(`${successPrefix} Release document is valid!`);
+			console.info(`${SUCCESS_PREFIX} Release document is valid!`);
 		} catch (error) {
-			if (_alextheman_utility.DataError.check(error)) convertDataErrorToProgramError(error, program, { exitCode: 2 });
+			if (_alextheman_utility_v6.DataError.check(error)) convertDataErrorToProgramError(error, program, { exitCode: 2 });
 			else throw error;
 		}
 	});
@@ -1031,7 +1067,7 @@ function replaceMarkdownPlaceholders(rawContent, templateVariables) {
 	const placeholders = (0, _alextheman_utility.parseZodSchema)(zod.default.array(zod.default.string()).default([]), data.placeholders);
 	let finalContent = content;
 	for (const placeholder of placeholders) {
-		if (!(placeholder in templateVariables)) throw new _alextheman_utility.DataError({ placeholder }, "INVALID_PLACEHOLDER", "The placeholder found in frontmatter can not be found in the metadata.");
+		if (!(placeholder in templateVariables)) throw new _alextheman_utility_v6.DataError({ placeholder }, "INVALID_PLACEHOLDER", "The placeholder found in frontmatter can not be found in the metadata.");
 		finalContent = finalContent.replaceAll(`{{${placeholder}}}`, templateVariables[placeholder]);
 	}
 	return finalContent;
@@ -1082,7 +1118,7 @@ function templateReleaseNoteCreate(program) {
 		try {
 			return new _alextheman_utility.VersionNumber(rawValue);
 		} catch (error) {
-			if (_alextheman_utility.DataError.check(error) && error.code === "INVALID_VERSION") return (0, _alextheman_utility.parseVersionType)(rawValue);
+			if (_alextheman_utility_v6.DataError.check(error) && error.code === "INVALID_VERSION") return (0, _alextheman_utility.parseVersionType)(rawValue);
 			throw error;
 		}
 	}).description("Create release notes based on the current version in package.json.").action(async (target) => {
@@ -1098,7 +1134,7 @@ function templateReleaseNoteCreate(program) {
 			await (0, node_fs_promises.mkdir)(node_path.default.dirname(releaseNotePath), { recursive: true });
 			await (0, node_fs_promises.writeFile)(releaseNotePath, releaseNoteTemplate, { flag: "wx" });
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error(`${errorPrefix} Release notes already exist.`, {
+			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error(`${ERROR_PREFIX} Release notes already exist.`, {
 				exitCode: 1,
 				code: "RELEASE_NOTE_EXISTS"
 			});
@@ -1126,8 +1162,8 @@ function templateReleaseNotePath(program) {
 function templateReleaseNoteSetStatus(program) {
 	program.command("set-status").description("Change the release status on a given release document initially generated from the `create-release-note` command.").argument("<documentPath>", "The path to the document").argument("[status]", "The status to set the document to", parseReleaseStatus, ReleaseStatus.RELEASED).action(async (documentPath, status) => {
 		const packageInfo = await (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
-		const { name } = (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.string() }), packageInfo, new _alextheman_utility.DataError({ name: packageInfo?.name }, "INVALID_PACKAGE_JSON", "Invalid package.json - expected package.json to contain a `name` property."));
-		if (!documentPath.endsWith("md")) throw new _alextheman_utility.DataError({ documentPath }, "INVALID_FILE_PATH", "Invalid file path. Path must lead to a .md file.");
+		const { name } = (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.string() }), packageInfo, new _alextheman_utility_v6.DataError({ name: packageInfo?.name }, "INVALID_PACKAGE_JSON", "Invalid package.json - expected package.json to contain a `name` property."));
+		if (!documentPath.endsWith("md")) throw new _alextheman_utility_v6.DataError({ documentPath }, "INVALID_FILE_PATH", "Invalid file path. Path must lead to a .md file.");
 		const versionNumber = new _alextheman_utility.VersionNumber(node_path.default.basename(documentPath).split(".").filter((part) => {
 			return part !== "md";
 		}).join("."));
@@ -1136,7 +1172,7 @@ function templateReleaseNoteSetStatus(program) {
 		await validateReleaseDocument(name, versionNumber, initialDocument);
 		const [userEditableSectionStart, userEditableSectionEnd] = getMarkdownCommentPair("user-editable-section");
 		const editableSection = getMarkdownBlock(initialDocument, userEditableSectionStart, userEditableSectionEnd);
-		if (editableSection === null) throw new _alextheman_utility.DataError({
+		if (editableSection === null) throw new _alextheman_utility_v6.DataError({
 			startMarker: userEditableSectionStart,
 			endMarker: userEditableSectionEnd
 		}, "EDITABLE_SECTION_NOT_FOUND", "Could not find editable section in the provided document.");
@@ -1168,7 +1204,7 @@ function template(program) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version$1 = "2.6.2";
+var version$1 = "2.7.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 //#endregion
 //#region src/utility/updates/checkUpdate.ts
@@ -1237,7 +1273,7 @@ function parseZodSchemaForProgram(program, schema, data) {
 	try {
 		return (0, _alextheman_utility.parseZodSchema)(schema, data);
 	} catch (error) {
-		if (_alextheman_utility.DataError.check(error)) convertDataErrorToProgramError(error, program);
+		if (_alextheman_utility_v6.DataError.check(error)) convertDataErrorToProgramError(error, program);
 		throw error;
 	}
 }
@@ -1317,12 +1353,12 @@ async function noFileDependencies(program) {
 	};
 	if (Object.keys(allFileDependencies.dependencies ?? {}).length === 0) delete allFileDependencies.dependencies;
 	if (Object.keys(allFileDependencies.devDependencies ?? {}).length === 0) delete allFileDependencies.devDependencies;
-	if (Object.keys(allFileDependencies).length !== 0) program.error(`${errorPrefix} File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
+	if (Object.keys(allFileDependencies).length !== 0) program.error(`${ERROR_PREFIX} File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
           `, {
 		exitCode: 2,
 		code: "FILE_DEPENDENCIES_FOUND"
 	});
-	console.info(`${successPrefix} No file dependencies found!`);
+	console.info(`${SUCCESS_PREFIX} No file dependencies found!`);
 }
 //#endregion
 //#region src/cli/commands/package-json/check/noPreReleaseDependencies.ts
@@ -1340,7 +1376,7 @@ async function noPreReleaseDependencies(program) {
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(dependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDependencies[dependencyName] = dependencyVersionRange;
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(devDependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDevDependencies[dependencyName] = dependencyVersionRange;
 	if (Object.keys(preReleaseDependencies).length !== 0 || Object.keys(preReleaseDevDependencies).length !== 0) program.error(_alextheman_utility.normaliseIndents`
-            ${errorPrefix} Pre-release version pinning is not allowed. Found the following violations:
+            ${ERROR_PREFIX} Pre-release version pinning is not allowed. Found the following violations:
 
         ` + JSON.stringify({
 		dependencies: preReleaseDependencies,
@@ -1349,7 +1385,7 @@ async function noPreReleaseDependencies(program) {
 		exitCode: 2,
 		code: "UNEXPECTED_PRE_RELEASE_VERSION"
 	});
-	console.info(`${successPrefix} No pre-release versions found!`);
+	console.info(`${SUCCESS_PREFIX} No pre-release versions found!`);
 }
 //#endregion
 //#region src/cli/commands/package-json/check/index.ts
@@ -1364,7 +1400,7 @@ function packageJsonCheck(program) {
 	}).action(async ({ rules }) => {
 		if (rules?.includes("no-pre-release-dependencies")) await noPreReleaseDependencies(program);
 		if (rules?.includes("no-file-dependencies")) await noFileDependencies(program);
-		console.info(`${successPrefix} Success! All checks passed!`);
+		console.info(`${SUCCESS_PREFIX} Success! All checks passed!`);
 	});
 }
 //#endregion
@@ -1382,6 +1418,7 @@ function createCommands(program) {
 		internal,
 		localPackage,
 		packageJson,
+		pyproject,
 		root,
 		template,
 		update,
@@ -1393,7 +1430,7 @@ function createCommands(program) {
 //#region src/utility/errors/formatError.ts
 function formatError(error) {
 	if (error instanceof execa.ExecaError) {
-		const dataError = new _alextheman_utility.DataError({
+		const dataError = new _alextheman_utility_v6.DataError({
 			cwd: error.cwd,
 			command: error.command,
 			exitCode: error.exitCode,

package/dist/index.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { Command } from "commander";
-import { DataError, ONE_DAY_IN_MILLISECONDS, VersionNumber, fillArray, getStringsAndInterpolations, interpolate, isTemplateStringsArray, kebabToCamel, normaliseIndents, omitProperties, parseBoolean, parseVersionType, parseZodSchema, parseZodSchemaAsync, removeDuplicates, removeUndefinedFromObject, stringifyDotenv } from "@alextheman/utility";
+import { DataError } from "@alextheman/utility/v6";
 import chalk from "chalk";
 import boxen from "boxen";
 import figlet from "figlet";
 import envPaths from "env-paths";
 import path from "node:path";
+import { ONE_DAY_IN_MILLISECONDS, VersionNumber, fillArray, getStringsAndInterpolations, interpolate, isTemplateStringsArray, kebabToCamel, normaliseIndents, omitProperties, parseBoolean, parseVersionType, parseZodSchema, parseZodSchemaAsync, removeDuplicates, removeUndefinedFromObject, stringifyDotenv } from "@alextheman/utility";
 import { confirm, input, password, select } from "@inquirer/prompts";
 import { access, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import { parse } from "dotenv";
@@ -14,6 +15,7 @@ import { ExecaError, execa } from "execa";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { DependencyGroup, PackageManager, getDependenciesFromGroup, getExpectedTgzName, getPackageJsonContents, packageJsonNotFoundError } from "@alextheman/utility/internal";
 import z from "zod";
+import { parse as parse$1 } from "toml";
 import matter from "gray-matter";
 import { parseFilePath } from "@alextheman/utility/node";
 import axios from "axios";
@@ -89,8 +91,8 @@ function cache(program) {
 	loadCommands(program.command("cache").description("Commands related to the alex-c-line cache"), { cachePath });
 }
 //#endregion
-//#region src/utility/constants/errorPrefix.ts
-const errorPrefix = "❌ ERROR:";
+//#region src/utility/constants/ERROR_PREFIX.ts
+const ERROR_PREFIX = "❌ ERROR:";
 //#endregion
 //#region src/utility/envFile/upsertDotenvFile.ts
 async function upsertDotenvFile(contents, envFilePath) {
@@ -101,14 +103,14 @@ async function upsertDotenvFile(contents, envFilePath) {
 async function addVariable(program, envFileContents, file) {
 	const newVariableName = await input({ message: "Please enter the name of the environment variable you would like to add." });
 	if (newVariableName in envFileContents) program.error(`
-            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
+            ${ERROR_PREFIX} Error with chosen environment variable name ${newVariableName}.
             Variable name already exists. If you wish to edit this variable, please select it from the initial menu instead.
             `, {
 		exitCode: 2,
 		code: "DUPLICATE_ENVIRONMENT_VARIABLE_NAME"
 	});
 	if (/[ \t\r\n]/.test(newVariableName)) program.error(normaliseIndents`
-            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
+            ${ERROR_PREFIX} Error with chosen environment variable name ${newVariableName}.
             Environment variables are not allowed to have whitespace.
             `, {
 		exitCode: 2,
@@ -243,7 +245,7 @@ function checkLockfileVersionDiscrepancy(program) {
 		const { version: packageVersion } = JSON.parse(await readFile(path.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse(await readFile(path.resolve(process.cwd(), "package-lock.json"), "utf-8"));
 		if (packageVersion !== packageLockVersion) {
-			console.error(`${errorPrefix} package.json and package-lock.json out of sync. Please run \`npm install\` to fix this.`);
+			console.error(`${ERROR_PREFIX} package.json and package-lock.json out of sync. Please run \`npm install\` to fix this.`);
 			process.exitCode = 1;
 			return;
 		}
@@ -256,7 +258,7 @@ function gitPostMergeCleanup(program) {
 	program.command("git-post-merge-cleanup").alias("git-cleanup").description("Run after merging into a given branch to quickly clean up").argument("[branch]", "The branch you want to merge into", "main").option("--rebase", "Enable if your repository mainly rebases into main", true).action(async (branch, { rebase }) => {
 		console.info(`Running git-post-merge-cleanup in ${rebase ? "rebase" : "merge"} mode...`);
 		const { stdout: currentBranch } = await execa`git branch --show-current`;
-		if (currentBranch === branch) program.error(`${errorPrefix} Cannot run cleanup on ${branch} branch!`, {
+		if (currentBranch === branch) program.error(`${ERROR_PREFIX} Cannot run cleanup on ${branch} branch!`, {
 			exitCode: 1,
 			code: "INVALID_BRANCH"
 		});
@@ -272,7 +274,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: changes } = await execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa`git checkout ${currentBranch}`;
-				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
+				program.error(`${ERROR_PREFIX} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -282,7 +284,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: branchDeletedMessage, exitCode } = await execa({ reject: false })`git branch --delete ${currentBranch}`;
 			if (exitCode !== 0) {
 				await execa`git checkout ${currentBranch}`;
-				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
+				program.error(`${ERROR_PREFIX} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -292,8 +294,8 @@ function gitPostMergeCleanup(program) {
 	});
 }
 //#endregion
-//#region src/utility/constants/warningPrefix.ts
-const warningPrefix = "WARNING:";
+//#region src/utility/constants/WARNING_PREFIX.ts
+const WARNING_PREFIX = "WARNING:";
 //#endregion
 //#region src/utility/fileSystem/readdirSafe.ts
 async function readdirSafe(path) {
@@ -330,7 +332,7 @@ function internalMediaGenerate(program) {
 				if (resolution) return await runManimCommand`manim -qh -r ${resolution} ${file}`;
 				return await runManimCommand`manim -qh ${file}`;
 			} catch (error) {
-				if (error instanceof ExecaError) program.error(`${errorPrefix} An error has occurred with Manim while rendering ${relativePath}.`, {
+				if (error instanceof ExecaError) program.error(`${ERROR_PREFIX} An error has occurred with Manim while rendering ${relativePath}.`, {
 					exitCode: error.exitCode ?? 1,
 					code: "MANIM_ERROR"
 				});
@@ -349,7 +351,7 @@ function internalMediaGenerate(program) {
 		const statResult = await stat(target);
 		if (statResult.isFile()) await renderFile(target);
 		else if (statResult.isDirectory()) await readDirectory(target);
-		else console.warn(`${warningPrefix} Not a file or directory.`);
+		else console.warn(`${WARNING_PREFIX} Not a file or directory.`);
 	});
 }
 //#endregion
@@ -373,7 +375,7 @@ async function findPackageRoot(startDirectory, packageName) {
 	throw new DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
 }
 //#endregion
-//#region src/utility/constants/alexCLinePackageRoot.ts
+//#region src/utility/constants/ALEX_C_LINE_PACKAGE_ROOT.ts
 const __filename$2 = fileURLToPath(import.meta.url);
 const ALEX_C_LINE_PACKAGE_ROOT = findPackageRoot(path.dirname(__filename$2), "alex-c-line");
 //#endregion
@@ -624,7 +626,7 @@ function localPackageUse(program) {
 				stdio: "inherit",
 				reject: false
 			});
-			if (exitCode !== 0) program.error(`${errorPrefix} An error occurred during the local \`alex-c-line\` run.`, {
+			if (exitCode !== 0) program.error(`${ERROR_PREFIX} An error occurred during the local \`alex-c-line\` run.`, {
 				exitCode,
 				code: "LOCAL_ALEX_C_LINE_ERROR"
 			});
@@ -687,6 +689,43 @@ function localPackage(program) {
 	loadCommands(program.command("local-package").description("Manage the use of local packages in your JavaScript project."), { localPackageUse });
 }
 //#endregion
+//#region src/utility/constants/SUCCESS_PREFIX.ts
+const SUCCESS_PREFIX = chalk.green("✓");
+//#endregion
+//#region src/cli/commands/pyproject/check/preferExactDependencyVersions.ts
+const pyprojectSchema = z.object({
+	project: z.object({ dependencies: z.array(z.string()).optional() }),
+	"dependency-groups": z.object({ dev: z.array(z.string()).optional() })
+}).partial();
+async function preferExactDependencyVersions(program) {
+	const data = parseZodSchema(pyprojectSchema, parse$1(await readFile("pyproject.toml", "utf-8")));
+	const sections = [data.project?.dependencies ?? [], data["dependency-groups"]?.dev ?? []];
+	const violations = [];
+	for (const dependencies of sections) for (const dependency of dependencies) if (!dependency.includes("==")) violations.push(dependency);
+	if (violations.length !== 0) program.error(`${ERROR_PREFIX} Non-exact dependencies found:\n\n${violations.join("\n")}`, {
+		code: "NON_EXACT_DEPENDENCIES_FOUND",
+		exitCode: 2
+	});
+	console.info(`${SUCCESS_PREFIX} All dependencies are exactly pinned`);
+}
+//#endregion
+//#region src/cli/commands/pyproject/check/index.ts
+const RuleName$1 = { PREFER_EXACT_DEPENDENCY_VERSIONS: "prefer-exact-dependency-versions" };
+function pyprojectCheck(program) {
+	program.command("check").description("Run checks on your pyproject.toml file").option("--rules <rules>", "The name of the rule to check", (rawRules) => {
+		const rawRuleNamesArray = rawRules.split(",");
+		return parseZodSchema(z.array(z.enum(RuleName$1)), rawRuleNamesArray);
+	}).action(async ({ rules }) => {
+		if (rules?.includes("prefer-exact-dependency-versions")) await preferExactDependencyVersions(program);
+		console.info(`${SUCCESS_PREFIX} Success! All checks passed!`);
+	});
+}
+//#endregion
+//#region src/cli/commands/pyproject/index.ts
+function pyproject(program) {
+	loadCommands(program.command("pyproject").description("Manage the pyproject.toml file."), { pyprojectCheck });
+}
+//#endregion
 //#region src/cli/commands/root/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = execa({
 	stdio: "inherit",
@@ -724,7 +763,7 @@ function createStepRunner(program) {
 //#endregion
 //#region src/cli/commands/root/pre-commit/getCommandArguments.ts
 function getCommandArguments(program, script, scripts, args) {
-	if (!(script in (scripts ?? {}))) program.error(`${errorPrefix} Could not find script \`${script}\` in package.json.`, {
+	if (!(script in (scripts ?? {}))) program.error(`${ERROR_PREFIX} Could not find script \`${script}\` in package.json.`, {
 		exitCode: 1,
 		code: "SCRIPT_NOT_FOUND"
 	});
@@ -757,7 +796,7 @@ function preCommit(program) {
 		const { allowNoStagedChanges = options?.allowNoStagedChanges, updateIndex = options?.updateIndex } = preCommitConfig;
 		const { exitCode: diffExitCode } = await execa({ reject: false })`git diff --cached --quiet`;
 		switch (diffExitCode) {
-			case 128: program.error(`${errorPrefix} Not currently in a Git repository`, {
+			case 128: program.error(`${ERROR_PREFIX} Not currently in a Git repository`, {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -869,12 +908,9 @@ function templatePullRequest(program) {
 	loadCommands(program.command("pull-request").description("Manage the pull request templates."), { templatePullRequestCreate });
 }
 //#endregion
-//#region src/utility/constants/successPrefix.ts
-const successPrefix = chalk.green("✓");
-//#endregion
 //#region src/utility/errors/convertDataErrorToProgramError.ts
 function convertDataErrorToProgramError(dataError, program, options) {
-	program.error(`${errorPrefix} ${dataError.message}`, {
+	program.error(`${ERROR_PREFIX} ${dataError.message}`, {
 		exitCode: options?.exitCode ?? 1,
 		code: dataError.code
 	});
@@ -975,7 +1011,7 @@ function templateReleaseNoteCheck(program) {
 		}).join("."));
 		try {
 			await validateReleaseDocument(name, documentVersion, fileContents, expectedReleaseStatus);
-			console.info(`${successPrefix} Release document is valid!`);
+			console.info(`${SUCCESS_PREFIX} Release document is valid!`);
 		} catch (error) {
 			if (DataError.check(error)) convertDataErrorToProgramError(error, program, { exitCode: 2 });
 			else throw error;
@@ -1067,7 +1103,7 @@ function templateReleaseNoteCreate(program) {
 			await mkdir(path.dirname(releaseNotePath), { recursive: true });
 			await writeFile(releaseNotePath, releaseNoteTemplate, { flag: "wx" });
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error(`${errorPrefix} Release notes already exist.`, {
+			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error(`${ERROR_PREFIX} Release notes already exist.`, {
 				exitCode: 1,
 				code: "RELEASE_NOTE_EXISTS"
 			});
@@ -1137,7 +1173,7 @@ function template(program) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version$1 = "2.6.2";
+var version$1 = "2.7.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 //#endregion
 //#region src/utility/updates/checkUpdate.ts
@@ -1286,12 +1322,12 @@ async function noFileDependencies(program) {
 	};
 	if (Object.keys(allFileDependencies.dependencies ?? {}).length === 0) delete allFileDependencies.dependencies;
 	if (Object.keys(allFileDependencies.devDependencies ?? {}).length === 0) delete allFileDependencies.devDependencies;
-	if (Object.keys(allFileDependencies).length !== 0) program.error(`${errorPrefix} File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
+	if (Object.keys(allFileDependencies).length !== 0) program.error(`${ERROR_PREFIX} File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
           `, {
 		exitCode: 2,
 		code: "FILE_DEPENDENCIES_FOUND"
 	});
-	console.info(`${successPrefix} No file dependencies found!`);
+	console.info(`${SUCCESS_PREFIX} No file dependencies found!`);
 }
 //#endregion
 //#region src/cli/commands/package-json/check/noPreReleaseDependencies.ts
@@ -1309,7 +1345,7 @@ async function noPreReleaseDependencies(program) {
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(dependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDependencies[dependencyName] = dependencyVersionRange;
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(devDependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDevDependencies[dependencyName] = dependencyVersionRange;
 	if (Object.keys(preReleaseDependencies).length !== 0 || Object.keys(preReleaseDevDependencies).length !== 0) program.error(normaliseIndents`
-            ${errorPrefix} Pre-release version pinning is not allowed. Found the following violations:
+            ${ERROR_PREFIX} Pre-release version pinning is not allowed. Found the following violations:
 
         ` + JSON.stringify({
 		dependencies: preReleaseDependencies,
@@ -1318,7 +1354,7 @@ async function noPreReleaseDependencies(program) {
 		exitCode: 2,
 		code: "UNEXPECTED_PRE_RELEASE_VERSION"
 	});
-	console.info(`${successPrefix} No pre-release versions found!`);
+	console.info(`${SUCCESS_PREFIX} No pre-release versions found!`);
 }
 //#endregion
 //#region src/cli/commands/package-json/check/index.ts
@@ -1333,7 +1369,7 @@ function packageJsonCheck(program) {
 	}).action(async ({ rules }) => {
 		if (rules?.includes("no-pre-release-dependencies")) await noPreReleaseDependencies(program);
 		if (rules?.includes("no-file-dependencies")) await noFileDependencies(program);
-		console.info(`${successPrefix} Success! All checks passed!`);
+		console.info(`${SUCCESS_PREFIX} Success! All checks passed!`);
 	});
 }
 //#endregion
@@ -1351,6 +1387,7 @@ function createCommands(program) {
 		internal,
 		localPackage,
 		packageJson,
+		pyproject,
 		root,
 		template,
 		update,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "2.6.2",
+  "version": "2.7.1",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -34,13 +34,13 @@
     "templates"
   ],
   "dependencies": {
-    "@alextheman/utility": "5.11.0",
+    "@alextheman/utility": "5.13.0",
     "@inquirer/prompts": "8.4.1",
     "axios": "1.15.0",
     "boxen": "8.0.1",
     "chalk": "5.6.2",
     "commander": "14.0.3",
-    "dotenv": "17.4.1",
+    "dotenv": "17.4.2",
     "dotenv-stringify": "3.0.1",
     "env-paths": "4.0.0",
     "execa": "9.6.1",
@@ -48,10 +48,11 @@
     "gray-matter": "4.0.3",
     "semver": "7.7.4",
     "supports-color": "10.2.2",
+    "toml": "4.1.1",
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "5.12.0",
+    "@alextheman/eslint-plugin": "5.13.0",
     "@commander-js/extra-typings": "14.0.0",
     "@types/eslint": "9.6.1",
     "@types/node": "25.6.0",
@@ -59,16 +60,16 @@
     "@types/update-notifier": "6.0.8",
     "cross-env": "10.1.0",
     "dotenv-cli": "11.0.0",
-    "eslint": "10.2.0",
+    "eslint": "10.2.1",
     "husky": "9.1.7",
     "markdownlint-cli2": "0.22.0",
-    "prettier": "3.8.2",
+    "prettier": "3.8.3",
     "tempy": "3.2.0",
     "ts-node": "10.9.2",
-    "tsdown": "0.21.7",
-    "typescript": "6.0.2",
-    "typescript-eslint": "8.58.1",
-    "vite-tsconfig-paths": "6.1.1",
+    "tsdown": "0.21.9",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.58.2",
+    "vite": "8.0.8",
     "vitest": "4.1.4"
   },
   "engines": {