# rust-autocorrect
**Repository Path**: tinylab/rust-autocorrect
## Basic Information
- **Project Name**: rust-autocorrect
- **Description**: clone of https://github.com/huacnlee/autocorrect with static release of autocorrect-cli.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-09-16
- **Last Updated**: 2022-09-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# AutoCorrect
[](https://github.com/huacnlee/autocorrect/actions?query=workflow%3ACI)
[](https://github.com/huacnlee/autocorrect/releases)
[](https://hub.docker.com/r/huacnlee/autocorrect)
[](https://crates.io/crates/autocorrect)
[](https://badge.fury.io/js/%40huacnlee%2Fautocorrect)
[](https://docs.rs/autocorrect)
> 🎯 AutoCorrect 的愿景是提供一套标准化的文案较正方案。以便于在各类场景（例如：撰写书籍、文档、内容发布、项目源代码...）里面应用，让使用者轻松实现标准化、专业化的文案输出 / 校正。
A linter and formatter for help you improve copywriting, to correct spaces, words, punctuations between CJK (Chinese, Japanese, Korean).
Like Eslint, Rubocop, Gofmt ..., AutoCorrect allows us to check source code, and output as colorized diff with corrected suggest. You can integrating to CI (GitLab CI, GitHub Action, Travis CI....) for use to checking the contents in source code. Recognize the file name, and find out the strings and the comment part.
基于 Rust 编写的 CLI 工具，用于「自动纠正」或「检查并建议」文案，给 CJK（中文、日语、韩语）与英文混写的场景，补充正确的空格，纠正单词，同时尝试以安全的方式自动纠正标点符号等等。
类似 ESlint、Rubocop、Gofmt 等工具，AutoCorrect 可以用于 CI 环境，它提供 Lint 功能能便捷的检测出项目中有问题的文案，起到统一规范的作用。
支持各种类型源代码文件，能自动识别文件名，并准确找到字符串、注释做自动纠正。
> 此方案最早于 [2013 年](https://github.com/huacnlee/auto-correct/commit/688b7f492623baead3477b4cf0baa706777864d6) 出现于 Ruby China 的项目，并逐步完善规则细节，当前准确率较高（极少数异常情况），你可以放心用来辅助你完成自动纠正动作。
Other implements for programming:
- Rust - [autocorrect](https://github.com/huacnlee/autocorrect)
- Ruby - [auto-correct](https://github.com/huacnlee/auto-correct)
- Go - [go-auto-correct](https://github.com/huacnlee/go-auto-correct)
## Features
- Auto add spacing between CJK (Chinese, Japanese, Korean) and English words.
- Multiple file content support (HTML, YAML, Rust, Go, SQL, Ruby, Python, Objective-C, Swift, Java, Kotlin, Dart, JavaScript, CSharp ...).
- Fullwidth -> halfwidth (only for [a-zA-Z0-9], and `：` in time).
- Correct punctuations into Fullwidth near the CJK.
- Spellcheck and correct words by your own dictionary.
- Lint checking and output diff or JSON result, so you can integrate to everywhere (GitLab CI, GitHub Action, VS Code, Vim, Emacs...)
- Allows to use `.gitignore` or `.autocorrectignore` to ignore files that you want to ignore.
- [Desktop app](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-tauri) for macOS, (Windows, Linux WIP).
## Install
> 🍏 AutoCorrect 还为非技术人员提供了比较简单的桌面端版本，如有需要可访问 [Download](https://github.com/huacnlee/autocorrect/releases) 页面来下载。
```bash
$ curl -sSL https://git.io/JcGER | bash
```
After that, you will get `/usr/local/bin/autocorrect` command.
```bash
AutoCorrect 1.9.0
Jason Lee Special config file. [default: .autocorrectrc]
--format Choose an output formatter. [default: diff] [possible values: json, diff]
--threads Number of threads, 0 - use number of CPU. [default: 0]
ARGS:
... Target filepath or dir for format. [default: .]
SUBCOMMANDS:
help Prints this message or the help of the given subcommand(s)
init Init AutoCorrect config file.
update Update AutoCorrect to latest version.
```
## Upgrade
> After: 1.9.0
AutoCorrect allows you to upgrade itself by `autocorrect update` command.
```bash
$ autocorrect update
```
> NOTE: This command need you input your password, because it will install bin into `/usr/local/bin` directory.
## Usage
- [Using CLI](#using-cli)
- [Configuration](#configuration)
- [VS Code Extension](#vs-code-extension)
- [Use for JavaScript](#use-for-javascript)
- [Use for Node.js](#use-for-nodejs)
- [Use for Rust](#use-for-rust)
- [GitHub Action](#github-action)
- [GitLab CI](#gitlab-ci)
### Using CLI
```bash
$ autocorrect text.txt
你好 Hello 世界
$ autocorrect --fix text.txt
$ autocorrect --fix zh-CN.yml
$ autocorrect --fix
```
#### Lint
```bash
$ autocorrect --lint --format json text.txt
$ autocorrect --lint text.txt
```
```diff
--> text.txt:1:3
- 你好Hello世界
+ 你好 Hello 世界
```
You also can lint multiple files:
```bash
$ autocorrect --lint
```
### Configuration
```bash
$ autocorrect init
Fetching https://github.com/huacnlee/autocorrect/raw/main/.autocorrectrc.template
AutoCorrect init config: .autocorrectrc
```
> NOTE: You you download fail, try to use `autocorrect init --local` command again.
Now the `.autocorrectrc` file has created.
> .autocorrectrc is allows use YAML, JSON format.
Config file example:
```yml
# Config for Speelcheck
spellcheck:
# 0 - Disabled, 1 - Format and Lint, 2 - LintOnly
mode: 1
# Correct Words (Case insensitive) for by Spellcheck
words:
- GitHub
- App Store
# This means "appstore" into "App Store"
- AppStore = App Store
- Git
- Node.js
- nodejs = Node.js
- VIM
- DNS
- HTTP
- SSL
```
#### Ignore option
**Use `.autocorrectignore` to ignore files**
Sometimes, you may want to ignore some special files that not wants to check.
By default, the file matched `.gitignore` rule will be ignored.
You can also use `.autocorrectignore` to ignore other files, format like `.gitignore`.
**Disable with inline comment**
If you just want to disable some special lines in file, you can write a comment `autocorrect: false` or `autocorrect-disable`,
when AutoCorrect matched comment include that, it will disable temporary.
And then, you can use `autocorrect: true` or `autocorrect-enable` to reopen it again.
For example, in JavaScript:
```js
function hello() {
console.log('现在这行开始autocorrect会暂时禁用');
console.log('这行也是disable的状态');
// autocorrect: true
let a = '现在起autocorrect回到了启用的状态';
}
```
The output will:
```js
function hello() {
console.log('现在这行开始autocorrect会暂时禁用');
console.log('这行也是disable的状态');
// autocorrect: true
let a = '现在起 autocorrect 回到了启用的状态';
}
```
### VS Code Extension
[](https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct)
https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct
内置 Visual Studio Code 插件，安装后会将 AutoCorrect 和 Visual Studio Code 完整集成，可以达到「保存自动格式化」或「纠正提示」。
如下图：
### GitHub Action
https://github.com/marketplace/actions/huacnlee-autocorrect
Add to your `.github/workflows/ci.yml`
```yml
steps:
- name: Check source code
uses: actions/checkout@main
- name: AutoCorrect
uses: huacnlee/autocorrect-action@main
```
### GitLab CI
Add to your `.gitlab-ci.yml`, to use [huacnlee/autocorrect](https://hub.docker.com/r/huacnlee/autocorrect) Docker image to check.
```yml
autocorrect:
stage: build
image: huacnlee/autocorrect:latest
script:
- autocorrect --lint
# Enable allow_failure if you wants.
# allow_failure: true
```
### Use for JavaScript
AutoCorrect also provide a JavaScript module via WebAssembly, you can use it in your JavaScript project.
```bash
yarn add @huacnlee/autocorrect
```
And then:
```js
const autocorrect = import('@huacnlee/autocorrect');
const raw = `你好Hello世界
`;
autocorrect.then((autocorrect) => {
const out = autocorrect.formatHTML(raw);
// "你好 Hello 世界
"
});
```
### Use for Node.js
When you wants use AutoCorrect in Node.js, you must install `@huacnlee/autocorrect-node`.
```bash
yarn add @huacnlee/autocorrect-node
```
And then:
```js
const autocorrect = require('@huacnlee/autocorrect-node');
autocorrect.format("你好Hello世界");
// "你好 Hello 世界"
```
### Use for Rust
In your `Cargo.toml`
```toml
[dependencies]
autocorrect = "1.0.0"
```
Use `autocorrect::format` to format plain text.
````rust
extern crate autocorrect;
fn main() {
println!("{}", autocorrect::format("长桥LongBridge App下载"));
// => "长桥 LongBridge App 下载"
println!("{}", autocorrect::format("Ruby 2.7版本第1次发布"));
// => "Ruby 2.7 版本第 1 次发布"
println!("{}", autocorrect::format("于3月10日开始"));
// => "于 3 月 10 日开始"
println!("{}", autocorrect::format("包装日期为2013年3月10日"));
// => "包装日期为 2013 年 3 月 10 日"
println!("{}", autocorrect::format("全世界已有数百家公司在生产环境中使用Rust，以达到快速、跨平台、低资源占用的目的。"));
// => "全世界已有数百家公司在生产环境中使用 Rust，以达到快速、跨平台、低资源占用的目的。"
println!("{}", autocorrect::format("既に、世界中の数百という企業がRustを採用し、高速で低リソースのクロスプラットフォームソリューションを実現しています。"));
// => "既に、世界中の数百という企業が Rust を採用し、高速で低リソースのクロスプラットフォームソリューションを実現しています。"
println!("{}", autocorrect::format("전 세계 수백 개의 회사가 프로덕션 환경에서 Rust를 사용하여 빠르고, 크로스 플랫폼 및 낮은 리소스 사용량을 달성했습니다."));
// => "전 세계 수백 개의 회사가 프로덕션 환경에서 Rust 를 사용하여 빠르고, 크로스 플랫폼 및 낮은 리소스 사용량을 달성했습니다."
println!("{}", autocorrect::format("需要符号?自动转换全角字符、数字:我们将在１６：３２分出发去ＣＢＤ中心.")
// => "需要符号？自动转换全角字符、数字：我们将在 16:32 分出发去 CBD 中心。"
```
Use `autocorrect::format_html` to format HTML content.
```rust
extern crate autocorrect;
fn main() {
let html = r#"
这是Heading标题
"#;
println!("{}", autocorrect::format_html(html));
//
// 这是 Heading 标题
//
//
你好 Rust 世界Bold 文本
//
这是第二行 p 标签
//