Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iyowei/fast-gitignore
从自定义模板库中获取 .gitignore 模板。
https://github.com/iyowei/fast-gitignore
generator gitignore iyowei nodejs
Last synced: about 7 hours ago
JSON representation
从自定义模板库中获取 .gitignore 模板。
- Host: GitHub
- URL: https://github.com/iyowei/fast-gitignore
- Owner: iyowei
- License: mit
- Created: 2021-12-06T11:07:00.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-01-02T13:14:40.000Z (almost 3 years ago)
- Last Synced: 2024-10-12T23:51:47.530Z (26 days ago)
- Topics: generator, gitignore, iyowei, nodejs
- Language: JavaScript
- Homepage:
- Size: 49.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @iyowei/fast-gitignore
> 从 [自定义模板库][github/gitignore] 中获取 .gitignore 模板。
引起不了注意的耗时，说 "只有不到 1 秒" 是完全不夸张的。显然，即使 [github/gitignore][github/gitignore] 已经帮忙节省了很多耗时，但为项目定制 ".gitignore" 的时间依然会分散注意力，因为是靠手动拷贝的方式，尤其是要创建多个项目时。更有甚者，更新 ".gitignore" 时，更加费时，我们使用的操作系统、软件，它们迭代的很快，总有些它们需要但不该被提交到自己项目中的文件冒出来，如果我们大半年都不更新一次 `.gitignore` ，难免日后会无意中污染了代码仓库。
**解决方案：[github/gitignore][github/gitignore] + 自动化的模板内容获取方式。**`await fastGitignore({ignore, templatesDir});` 是后者方式之一，其它方式参见 [相关](#相关)。
## 使用
### `fastGitignoreSync({topic, templatesDir, custom});`
- `templatesDir` { String } 模板库磁盘位置，**必供**；
- `topic` { String | Array } .gitignore 主题集合，**默认：** `[]`；
- `custom` { String | Array } 自定义规则，**默认** `undefined`，**选填**；
- 返回: {Object} 键是模板文件路径，值是模板内容。
```javascript
import { log } from 'console';
import path from 'path';
import { fastGitignoreSync } from '@iyowei/fast-gitignore';
const rslt = fastGitignoreSync({
topic: ['Windows', 'SVN'],
templatesDir: path.join(process.cwd(), 'templates'),
});
log(rslt);
/**
* {
* '~/Development/iyowei/fast-gitignore/templates/SVN.gitignore': '.svn/\n'
* '~/Development/iyowei/fast-gitignore/templates/Windows.gitignore': '# Windows thumbnail cache files\n' + 'Thumbs.db\n' + 'Thumbs.db:encryptable\n' + 'ehthumbs.db\n' + 'ehthumbs_vista.db\n' + '\n' + '# Dump file\n' + '*.stackdump\n' + '\n' + '# Folder config file\n' + '[Dd]esktop.ini\n' + '\n' + '# Recycle Bin used on file shares\n' + '$RECYCLE.BIN \n' + '\n' + '# Windows Installer files\n' + '*.cab\n' + '*.msi\n' + '*.msix\n' + '*.msm\n' + '*.msp\n' + '\n' + '# Windows shortcuts\n' + '*.lnk\n',
* ...
}*/
```
### `await fastGitignore({topic, templatesDir, custom});`
- `templatesDir` { String } 模板库磁盘位置，**必供**；
- `topic` { String | Array } .gitignore 主题集合，**默认：** `[]`；
- `custom` { String | Array } 自定义规则，**默认** `undefined`，**选填**；
- 返回: { `Promise` } 键是模板文件路径，值是模板内容。
```javascript
import { log } from 'console';
import path from 'path';
import { fastGitignore } from '@iyowei/fast-gitignore';
(async () => {
const rslt = await fastGitignore({
topic: ['Windows', 'SVN'],
templatesDir: path.join(process.cwd(), 'templates'),
});
log(rslt);
/**
* {
* '~/Development/iyowei/fast-gitignore/templates/SVN.gitignore': '.svn/\n'
* '~/Development/iyowei/fast-gitignore/templates/Windows.gitignore': '# Windows thumbnail cache files\n' + 'Thumbs.db\n' + 'Thumbs.db:encryptable\n' + 'ehthumbs.db\n' + 'ehthumbs_vista.db\n' + '\n' + '# Dump file\n' + '*.stackdump\n' + '\n' + '# Folder config file\n' + '[Dd]esktop.ini\n' + '\n' + '# Recycle Bin used on file shares\n' + '$RECYCLE.BIN \n' + '\n' + '# Windows Installer files\n' + '*.cab\n' + '*.msi\n' + '*.msix\n' + '*.msm\n' + '*.msp\n' + '\n' + '# Windows shortcuts\n' + '*.lnk\n',
* ...
}*/
})();
```
> @iyowei/fast-gitignore 并不会创建 ".gitignore" 文件，相关需求参见 [相关](#相关)。
## 安装
[![Node Version Badge][node version badge]][download node.js] ![esm][esm]
```shell
# 使用 Pnpm
$ pnpm add @iyowei/fast-gitignore
# 使用 NPM
$ npm i @iyowei/fast-gitignore
# 使用 Yarn
$ yarn add @iyowei/fast-gitignore
```
## 相关
- [`latest-gitignore`][latest-gitignore] - 从 `github/gitignore` 项目中获取最新模板。
## 指导
从主观心理的角度来看，存在是因为能够注意到，而能够注意到，前提是时间够慢、够长，或是代价够大、够有影响力，出现频率够高、够新鲜…… 想象下，电风扇转起来，肉眼是注意不到扇叶的，可以透过风扇看到其后的东西。
有时候，一些事情难以推进，原因就是成本太大，而成本太大的原因就是耗时，耗时面临着耗费人力、财力等，结合上述，也就是这些事的存在感十足。
因此，有一种降低成本，叫提升这件事的效率。
## 参与贡献
![PRs Welcome][prs welcome badge]
## 其它
"@iyowei/fast-gitignore" 使用 [@iyowei/create-esm][create-esm] 脚手架生成。
[github/gitignore]: https://github.com/github/gitignore
[latest-gitignore]: https://github.com/iyowei/latest-gitignore
[node version badge]: https://img.shields.io/badge/node.js-%3E%3D12.20.0-brightgreen?style=flat&logo=Node.js
[download node.js]: https://nodejs.org/en/download/
[esm]: https://img.shields.io/badge/ESM-brightgreen?style=flat
[prs welcome badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat
[create-esm]: https://github.com/iyowei/create-esm