A cross-platform CLI utility to create .gitignore files using templates.
```sh
gitnr create gh:Rust tt:clion+all
gitnr search ```
Run any of the commands below in your terminal to get the latest version of gitnr.
Install system-wide
sh
curl -s https://raw.githubusercontent.com/reemus-dev/gitnr/main/scripts/install.sh | sudo bash -s
Install for current user
sh
curl -s https://raw.githubusercontent.com/reemus-dev/gitnr/main/scripts/install.sh | bash -s -- -u
On Linux this defaults to $HOME/.local/bin and on macOS to $HOME/bin. The script will fail if the directory doesn't exist or is not in your system path.
Install in specific directory
sh
curl -s https://raw.githubusercontent.com/reemus-dev/gitnr/main/scripts/install.sh | bash -s -- -d <dir>
Run the command below in a PowerShell terminal to install the latest version of gitnr.
powershell
Set-ExecutionPolicy Unrestricted -Scope Process; iex (iwr "https://raw.githubusercontent.com/reemus-dev/gitnr/main/scripts/install.ps1").Content
See the releases page to download a binary and then add it to a directory in your system path.
sh
git clone --depth=1 github.com/reemus-dev/gitnr
cd gitnr
cargo install --path .
Note: This requires that you have Rust and cargo installed on your system.
There are 3 commands available
| Command | Description |
|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| create | Create a .gitignore file and print the content to stdout or save it to a file |
| search | Interactive mode to search and select templates from the GitHub and TopTal collections. You can then copy the result to your clipboard or copy the relevant create command to generate your ignore file |
| help | Display the CLI help message with available flags & commands |
The create command accepts a list of templates to generate a .gitignore file with.
sh
gitnr create [FLAGS] [TEMPLATES]...
Templates can be provided to the CLI as: - Space separated or comma separated values - With or without their source prefix
The following template sources are available:
| Template Sources | Prefix |
|---------------------------------------------------------------------------------------|---------|
| URL | url: |
| File | file: |
| GitHub (a file from any public repo) | repo: |
| GitHub Templates | gh: |
| GitHub Community Templates | ghc: |
| GitHub Global Templates | ghg: |
| TopTal Templates | tt: |
For example:
```sh
gitnr create gh:Node
gitnr create Node
gitnr create gh:Node ghc:JavaScript/Vue tt:webstorm+all
gitnr create url:https://domain.com/template.gitignore file:path/to/local.template.gitignore
gitnr create repo:github/gitignore/main/Rust.gitignore ```
If you do not prefix the template, the CLI will try to automatically detect the template source. If it can't match the template name to a source, it defaults to checking the GitHub template collection. It's advised to be explicit about the source prefix to avoid any ambiguity.
Templates from the GitHub and TopTal collections do not need to have the .gitignore, .stack or .patch suffixes. Meaning you can use gh:Rust instead of gh:Rust.gitignore or tt:webstorm+all instead of tt:webstorm+all.patch.
The generated template will be created in the order of the template arguments supplied.
[!NOTE] The TopTal template collection includes
stacksandpatches. A stack specifies multiple ignore templates that are combined, e.g.Angular.stack. The patch extension add modifications to the original template from GitHub's collection.
By default, the resulting .gitignore template is printed to stdout. You can customize this behaviour using the CLI flags available:
| Flag | Short | Description |
|-----------------|-------------|---------------------------------------------------------------------------------------|
| --save | -s | Write template to .gitignore file in current directory (overwriting any exiting file) |
| --file <path> | -f <path> | Write template to the specified file path overwriting any exiting file |
| --refresh | -r | Refresh the template cache (templates are cached for 1 hour by default) |
The search command allows you to interactively browse, filter and select templates from the GitHub and Toptal collections.
bash
gitnr search
This is useful when you want to see what's available and preview different template combinations. You will be able to preview an individual template as well as preview a template combination.
The search command only has one flag, which is --refresh | -r. This allows you to refresh the template cache which by default caches the template collections for 1 hour. This is to avoid hitting the API rate-limits.
.gitignore files for all projects to keep things consistent..gitignore from multiple templates to keep things modularOpen a PR or create an issue with any suggestions. Given this is my first Rust application, veterans will probably spot a lot of things that can be improved, refactored or removed. So feel free to open a PR or issue with any suggestions.
Improve your software dev skills by learning from my programming struggles at https://reemus.dev