GI Gen - Gitignore File Generator
Table of Contents
GI Gen is an open source CLI to generate .gitignore files for most project types.
Simply run the command and follow the prompts, and your project will have a .gitignore file to
match it.
It is completely cross-platform, and standalone (no dependencies - other than git itself), so you
may literally use it for any project on any platform.
You can run this CLI program to create or append a .gitignore file from a chosen list of template
easily.
You may choose more than one template to generate.
Features
GI Gen supports the following features:
.gitignorediscovery:- Auto-discover any gitignore templates that might be related to your project
- Can confidently discover over 50 project languages using your project structure
- Can fall back on process of elimination using patterns in the templat
- Optionally list all available templates instead (see github/gitignore for the complete list of templates)
- Auto-discover any gitignore templates that might be related to your project
.gitignoreclean: Clean up results from any patterns that aren't in your project before outputting (optional)- Writes to
.gitignorefile in current directory (you may overwrite/skip/append if already exists)
Command Line Usage
Download the file for your platform in the Releases page.
Put it anywhere that you can run an executable from. It is completely portable to any directory, but
it is preferable you put it somewhere that is in your PATH.
Just run gi_gen in the directory you wish to add to and follow the prompts.
$ gi_gen
Command Line Flags
You may pass additional flags to gi_gen. These are the currently available flags:
| Usage | Description |
|---|---|
-languages | -l |
List the languages you want to use as templates. To add multiple templates, use commas as separators, e.g.: -languages Node,Python |
-clean-output | -c |
Perform cleanup on the output .gitignore file, removing any unused patterns |
-append | -a |
Append to .gitignore file if it already exists |
-overwrite | -w |
Overwrite .gitignore file if it already exists |
-clear-cache |
Clear the .gitignore cache directory, for troubleshooting or for removing trace files of this program. Exits after running, so other flags will be ignored. |
-help | -h |
Display help message |
Contribute
Credits to open-source-ideas for the idea for the tool.
Please feel free to open PRs or issues with bug fixes/reports, or feature requests.
This project was built using Go, and should run easily with the normal Go tools with no further configuration.
Testing was only done on Windows x386 and macOS ARM, so feel free to report any issues on your platform if you have any, or are missing your platform and cannot/don't want to build from source (I tried building for the most common platforms).
If you are feeling incredibly generous and appreciate the time & effort I put into developing this tool, kindly consider donating any amount to help me make up for the work hours. It is really very much appreciated! 🙏🏼
