Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shresht7/gh-gitignore

A GitHub CLI extension to generate .gitignore files 📄
https://github.com/shresht7/gh-gitignore

cli gh-extension gitignore

Last synced: 22 days ago
JSON representation

A GitHub CLI extension to generate .gitignore files 📄

Awesome Lists containing this project

README

        

# `gh-gitignore`

A GitHub CLI extension to generate `.gitignore` files.

The `.gitignore` templates are obtained from the GitHub API (https://docs.github.com/en/rest/gitignore).

---

## 📦 Installation

### Requirements

- [GitHub CLI](https://cli.github.com/)

### Install

```sh
gh extension install Shresht7/gh-gitignore
```

---

## 💻 Usage

Invoke the cli extension like so:

```sh
gh gitignore
```

To create a gitignore file:

```sh
gh gitignore create Node
```

![Usage Demonstration](docs/demo.gif)

[⬆️ Back to top][top]

## ⌨️ Commands

### `create`

Create a gitignore file

#### Alias

`new`, `add`, `init`, `clone`

#### Usage

```sh
gh-gitignore create [flags]
```

#### Flags

| Flag | Type | Description | Default |
| ----------------- | -------- | --------------------------------- | ---------- |
| `--dest, -d` | `string` | Destination of the gitignore file | .gitignore |
| `--overwrite, -o` | `bool` | Overwrite the gitignore file | false |

#### Examples

```sh
gh gitignore create Go
gh gitignore init Go Python
gh gitignore create Go Python -d .gitignore
```

[⬆️ Back to top][top]

### `list`

Lists all gitignore templates

#### Usage

```sh
gh-gitignore list
```

#### Examples

```sh
gh gitignore list
```

[⬆️ Back to top][top]

### `view`

View a gitignore file

#### Alias

`show`, `get`

#### Usage

```sh
gh-gitignore view
```

#### Examples

```sh
gh gitignore view Go
gh gitignore view Go Python
```

[⬆️ Back to top][top]

---

## 📜 License

This software is licensed under the [MIT License](). See the [LICENSE](./LICENSE) file for details.

[top]: #gh-gitignore