写一个命令行CLI,一键生成各种烦人的lint配置
发布于:2023年2月21日

字数:726 字

阅读时间:4 分钟

前言

写一个前端工程,要配置特别多的配置文件,大量的配置文件让我们很烦心,占用了大量写代码的时间。

就像上图,看着就头大。

每次要启动一个新的项目,都要从头配一遍。有人可能把这些文件当做模板保存下来,有需要的时候再复制粘贴。可是各个项目还是不尽相同,还是需要手动改动。

于是我决定写一个命令行工具来解决这件事。

create-lint-config

这个工具叫做 create-lint-config,一个一键创建所有的 lint 配置的 CLI 命令行工具。前端工程中特别多的配置文件例如 Eslint、Prettier 等让我们心烦意乱。我们的目标是快速而轻松地生成这些配置!

github 地址

npm 地址

使用

在你的项目根目录执行以下命令:

Terminal window
# npm
npm create lint-config@latest
# yarn
yarn create lint-config
# pnpm
pnpm create lint-config@latest

执行结果如下:

screenshot

这个命令,一次执行,创建了 Eslint、StyleLint、prettier、commitlint、husy、lint-staged 等所有配置文件。

现有功能

  • 生成 Eslint 配置。
  • 生成 prettier 配置。
  • 生成 stylelint 配置。
  • 生成 husky 配置。
  • 生成 commitlint 配置。
  • 自动安装依赖。
  • 期待更多。

源码解读

#!/usr/bin/env node
async function install({
pkgManager,
cwd,
_arguments,
}: {
pkgManager: string;
cwd: string;
arguments: array;
}) {}
async function init() {
// 拷贝配置文件基础模板,包括 Eslint、StyleLint、prettier、commitlint、husy、lint-staged
await spinner({
start: `Base template copying...`,
end: "Template copied",
while: () => {
try {
copy("base");
} catch (e) {
error("error", e);
process.exit(1);
}
},
});
// 安装 husky
await spinner({
start: `Husky installing...`,
end: "Husky installed",
while: () =>
install({
cwd: process.cwd(),
pkgManager: "npx",
_arguments: ["husky", "install"],
}).catch(e => {
error("error", e);
process.exit(1);
}),
});
// husky 写入 commit-msg 校验指令,使用 commitlint
await spinner({
start: `Adding commit-msg lint...`,
end: "Commit-msg lint added",
while: () =>
install({
cwd: process.cwd(),
pkgManager: "npx",
_arguments: [
"husky",
"add",
".husky/commit-msg",
'npx --no-install commitlint --edit ""',
],
}).catch(e => {
error("error", e);
process.exit(1);
}),
});
// husky 写入 pre-commit校验指令,使用 lint-staged 执行 elint 等
await spinner({
start: `Adding lint-staged...`,
end: "Lint-staged added",
while: () =>
install({
cwd: process.cwd(),
pkgManager: "npx",
_arguments: ["husky", "add", ".husky/pre-commit", "npx lint-staged"],
}).catch(e => {
error("error", e);
process.exit(1);
}),
});
// 安装依赖
await spinner({
start: `Dependencies installing with npm...`,
end: "Dependencies installed",
while: () =>
install({
cwd: process.cwd(),
pkgManager: "npm",
_arguments: ["install"],
}).catch(e => {
error("error", e);
process.exit(1);
}),
});
}
init().catch(e => {
console.error(e);
});

TODO

  • 支持通过--template标志来选择模板,创建更多的配置文件模板,包括 ts、vue、react、node 等等
  • 支持更灵活的交互式选项。现在只能一键生成默认的模板,有些配置可能是一些人不需要的,后续计划可以更灵活。

总结

这个包还在起步阶段,我希望有需求的同学可以来参与贡献。

  • 你可以贡献 feature
  • 提交你自己正在使用的模板,以后用这个工具一键生成
  • 你也可以 fork 或 clone 此项目,变成你自己的命令行工具
  • 你也可以发布到你们公司的私有 npm,今年的 KPI 不就有了么

欢迎来点个 star,感谢支持 github

npm

加我微信 liruifengv2333,进群交流,抱团取暖。
  • 新生代程序员群
  • Astro 学习交流群
关注公众号 SayHub,带来更多原创内容。
很高兴见到你,欢迎来玩儿~