Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/sane-fmt/sane-fmt

Opinionated code formatter for TypeScript and JavaScript
https://github.com/sane-fmt/sane-fmt

aur deno dprint formatter javascript linux macos nodejs opinionated rust sane-fmt typescript wasi wasm webassembly windows

Last synced: 3 months ago
JSON representation

Opinionated code formatter for TypeScript and JavaScript

Host: GitHub
URL: https://github.com/sane-fmt/sane-fmt
Owner: sane-fmt
License: mit
Created: 2020-04-26T10:47:19.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-02-25T09:07:05.000Z (12 months ago)
Last Synced: 2024-04-24T05:19:38.145Z (10 months ago)
Topics: aur, deno, dprint, formatter, javascript, linux, macos, nodejs, opinionated, rust, sane-fmt, typescript, wasi, wasm, webassembly, windows
Language: Rust
Homepage:
Size: 1.2 MB
Stars: 27
Watchers: 2
Forks: 3
Open Issues: 4
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md

Awesome Lists containing this project

README

# sane-fmt

[![GitHub Actions Status](https://github.com/sane-fmt/sane-fmt/workflows/Test/badge.svg)](https://github.com/sane-fmt/sane-fmt/actions)
[![Travis Build Status](https://travis-ci.org/sane-fmt/sane-fmt.svg?branch=master)](https://travis-ci.org/sane-fmt/sane-fmt)

Opinionated code formatter for TypeScript and JavaScript.

## Rules

* Prefer single quotes.
* No semicolons.
* Trailing commas for multi-line.
* No function parentheses for arrow function with single argument.
* Multi-line union and intersection use consistent leading separator.

[Preview](https://git.io/JflcU).

Read [exports/sane-fmt.typescript.json](https://git.io/JmNWN), [src/rules.rs](https://git.io/JmNlv), and [tests/rules.rs](https://git.io/JflOp) for more information.

## Installation

### Download prebuilt binaries

Go to [the release page](https://github.com/sane-fmt/sane-fmt/releases).

### From [crates.io](https://crates.io)

```sh
cargo install sane-fmt
```

**Links:**
* https://crates.io/crates/sane-fmt/
* https://docs.rs/crate/sane-fmt/
* https://lib.rs/crates/sane-fmt/

### From [NPM](https://www.npmjs.com)

#### WASM (all platform)

```sh
npm i -g @sane-fmt/wasm32-wasi
```

**Links:**
* https://www.npmjs.com/package/@sane-fmt/wasm32-wasi

#### Native binaries

The WASM package while work on all platform, it is slow to start. For better speed, install one of the following packages instead:

**For Linux:**
* [@sane-fmt/x86_64-unknown-linux-gnu](https://www.npmjs.com/package/@sane-fmt/x86_64-unknown-linux-gnu)
* [@sane-fmt/x86_64-unknown-linux-musl](https://www.npmjs.com/package/@sane-fmt/x86_64-unknown-linux-musl)

**For macOS:**
* [@sane-fmt/x86_64-apple-darwin](https://www.npmjs.com/package/@sane-fmt/x86_64-apple-darwin)

**For Windows:**
* [@sane-fmt/x86_64-pc-windows-gnu](https://www.npmjs.com/package/@sane-fmt/x86_64-pc-windows-gnu)
* [@sane-fmt/x86_64-pc-windows-msvc](https://www.npmjs.com/package/@sane-fmt/x86_64-pc-windows-msvc)

### From [Deno Registry](https://deno.land/x)

**Links:**
* https://deno.land/x/sane_fmt/
* https://github.com/sane-fmt/deno/
* https://sane-fmt.github.io/deno/

### From [Arch User Repository](https://aur.archlinux.org)

#### Download source and compile

```sh
paru -S sane-fmt
```

**Links:**
* https://aur.archlinux.org/packages/sane-fmt/

#### Download prebuilt binary

```sh
paru -S sane-fmt-bin
```

**Links:**
* https://aur.archlinux.org/packages/sane-fmt-bin/

### Use with [Dprint](https://dprint.dev/)

If you already have Dprint, you can skip installing `sane-fmt` binary. Create a `dprint.json` file with the following content:

```json
{
"$schema": "https://dprint.dev/schemas/v0.json",
"projectType": "openSource",
"extends": "https://github.com/sane-fmt/sane-fmt/raw/master/exports/sane-fmt.dprint.json",
"includes": [
"**/*.js",
"**/*.ts"
],
"excludes": [
".git",
"node_modules"
],
"plugins": [
"https://plugins.dprint.dev/typescript-${DPRINT_TYPESCRIPT_VERSION}.wasm"
]
}
```

**Notes:**
* Replace `master` in the `"extends"` line above with appropriate sane-fmt version.
* Replace `${DPRINT_TYPESCRIPT_VERSION}` above with appropriate [dprint-plugin-typescript](https://github.com/dprint/dprint-plugin-typescript) version.

**See also:**
* [sane-fmt.dprint.json](https://github.com/sane-fmt/sane-fmt/blob/master/exports/sane-fmt.dprint.json): Dprint configuration with rules of sane-fmt.
* [sane-fmt.typescript.json](https://github.com/sane-fmt/sane-fmt/blob/master/exports/sane-fmt.typescript.json): Configuration of dprint-plugin-typescript with rules of sane-fmt.

## Usage

### Format all TypeScript and JavaScript files

```sh
sane-fmt --write
```

This command would reformat all TypeScript and JavaScript files.

### Check for all TypeScript and JavaScript files

```sh
sane-fmt
```

This command would check all TypeScript and JavaScript files.

### Format only some files

```sh
sane-fmt --write foo.ts bar.js
```

This command would only reformat `foo.ts` and `bar.js`.

### Format all TypeScript and JavaScript files in a directory

```sh
sane-fmt --write src/
```

This command would reformat all TypeScript and JavaScript files within `src/` directory.

### Check all TypeScript and JavaScript files in a list

Each line of `list.txt` is a path to a TypeScript/JavaScript file.

```sh
sane-fmt --include=list.txt
```

### Check all TypeScript and JavaScript files from a Git repo

```sh
git ls-files | grep -Ei '\.(js|ts)$' | sane-fmt --include=-
```

### GitHub Actions

`sane-fmt` also provides a convenient way to integrate with GitHub Actions. To use it, simply add `--log-format=github-actions`, like so:

```sh
sane-fmt --log-format=github-actions --details=diff
```

When this command is executed within a GitHub Actions runner, it will:
* Annotates unformatted files.
* Group diffs by file names (if `--details=diff`).
* Export `total`, `changed`, and `unchanged` as outputs.

_Recommendation:_ This [action](https://github.com/sane-fmt/action) will install `sane-fmt` and execute it for you.

### Print help message

```sh
sane-fmt --help
```

## Shell Completions

If you installed sane-fmt [via the AUR](#from-arch-user-repository), completions for bash, fish, and zsh are already installed for you.

Shell completion files are located in [./exports directory of this repo](https://github.com/sane-fmt/sane-fmt/tree/master/exports) or [the Release Page](https://github.com/sane-fmt/sane-fmt/releases) with name in form of `completion.` where `` is corresponding file extension of target language. Install them to appropriate locations in your filesystem to use.

## Become a Patron

[My Patreon Page](https://patreon.com/khai96_).

## Frequently Asked Questions

### What is this program?

`sane-fmt` is an opinionated code formatter for TypeScript and JavaScript powered by [dprint](https://dprint.dev/). You can think of it as a portable Dprint config file that is always up-to-date.

### What is the point of this program?

I want to apply a single, consistent formatting for all my codes regardless of environment without complex tooling.

I have considered using Prettier or Dprint, but that would mean having to set up Node.js even in non-Node.js environments. I also don't like copying my config files back-and-forth to update them.

On the other hand, setting up `sane-fmt` is simple: just download the binary.

### How to customize the rules?

Customization is antithetical to the purpose of this project, and as such, the `sane-fmt` command does not have customization capability.

However, if you still want a copy of `sane-fmt` with your own customized rules, do one of the following:
* Use [`sane-fmt`](https://docs.rs/sane-fmt) as a library crate.
* Fork this project.
* Just use [dprint](#use-with-dprint).

## License