Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/yudai-nkt/gh-form

Don't let malformed issue forms pushed to GitHub
https://github.com/yudai-nkt/gh-form

cli gh-extension github github-cli issue-forms rust

Last synced: 17 days ago
JSON representation

Don't let malformed issue forms pushed to GitHub

Awesome Lists containing this project

README

        

# gh-form

[![Badge for GitHub Releases](https://img.shields.io/github/v/release/yudai-nkt/gh-form)](https://github.com/yudai-nkt/gh-form/releases)
[![Badge for Cargo Registry](https://img.shields.io/crates/v/gh-form)](https://crates.io/crates/gh-form)
[![Unit test](https://github.com/yudai-nkt/gh-form/actions/workflows/test.yml/badge.svg)](https://github.com/yudai-nkt/gh-form/actions/workflows/test.yml)

Don't let malformed issue forms pushed to GitHub

## Overview

gh-form allows you to locally preview [YAML-formatted issue forms](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms) as HTML.

![Screenshot of gh-form's preview](./img/preview.png)

## Installation

There are several ways to install gh-form depending on which toolchain you are using.

### GitHub CLI users

gh-form is available as a GitHub CLI extension:

```console
gh extension install yudai-nkt/gh-form
```

### Rustaceans

gh-form is also available on crates.io:

```console
cargo install gh-form
```

### Others

Download a binary from GitHub Releases and put it in your PATH.

## Synopsis

```console
USAGE:
gh-form

OPTIONS:
-h, --help Print help information
-V, --version Print version information

SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
preview Start a local server to preview issue form
```

## License

This repository is licensed under the MIT License.
See [LICENSE.md]() for details.