Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vincens2005/lite-formatters
Code formatters for https://github.com/rxi/lite and https://github.com/franko/lite-xl
https://github.com/vincens2005/lite-formatters
formatter-plugin formatters lite lite-xl lua plugin
Last synced: 4 months ago
JSON representation
Code formatters for https://github.com/rxi/lite and https://github.com/franko/lite-xl
- Host: GitHub
- URL: https://github.com/vincens2005/lite-formatters
- Owner: vincens2005
- License: mit
- Created: 2021-04-28T20:54:08.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-22T16:38:21.000Z (7 months ago)
- Last Synced: 2024-05-22T16:34:13.231Z (6 months ago)
- Topics: formatter-plugin, formatters, lite, lite-xl, lua, plugin
- Language: Lua
- Homepage:
- Size: 49.8 KB
- Stars: 20
- Watchers: 1
- Forks: 12
- Open Issues: 6
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# Formatters for [lite](https://github.com/rxi/lite) and [lite-xl](https://github.com/franko/lite-xl)
## List of formatters (Keep alphabetical)
- [autoflake python formatter](https://pypi.org/project/autoflake/): `formatter_autoflake.lua`
- [black python formatter](https://pypi.org/project/black/): `formatter_black.lua`
- [clang-format](https://clang.llvm.org/docs/ClangFormat.html): `formatter_clangformat.lua`
- [cljfmt](https://github.com/weavejester/cljfmt): `formatter_cljfmt.lua`
- [cmake-format](https://github.com/cheshirekow/cmake_format): `formatter_cmakeformat.lua`
- [crystal](https://man.archlinux.org/man/crystal.1.en): `formatter_crystal.lua`
- [css-beautify](https://www.npmjs.com/package/js-beautify): `formatter_cssbeautify.lua`
- [dartformat](https://dart.dev/tools/dart-format): `formatter_dartformat.lua`
- [dfmt](https://github.com/dlang-community/dfmt): `formatter_dfmt.lua`
- [elixir](https://hexdocs.pm/mix/main/Mix.Tasks.Format.html): `formatter_elixir.lua`
- [elm-format](https://github.com/avh4/elm-format): `formatter_elmformat.lua`
- [esformatter](https://github.com/millermedeiros/esformatter/): `formatter_esformatter.lua`
- [gdformat](https://github.com/Scony/godot-gdscript-toolkit): `formatter_gdformat.lua`
- [google-java-format](https://github.com/google/google-java-format): `formatter_googlejavaformat.lua`
- [goimports](https://pkg.go.dev/golang.org/x/tools/cmd/goimports): `formatter_golang.lua`
- [html-beautify](https://www.npmjs.com/package/js-beautify): `formatter_htmlbeautify.lua`
- [isort python formatter](https://pypi.org/project/isort/): `formatter_isort.lua`
- [js-beautify](https://www.npmjs.com/package/js-beautify): `formatter_jsbeautify.lua`
- [luaformatter](https://github.com/Koihik/LuaFormatter): `formatter_luaformatter.lua`
- [ormolu](https://github.com/tweag/ormolu): `formatter_ormolu.lua`
- [perltidy](https://github.com/perltidy/perltidy): `formatter_perltidy.lua`
- [ocp-indent](https://github.com/OCamlPro/ocp-indent): `formatter_ocpindent.lua`
- [qmlformat](https://github.com/qt/qtdeclarative): `formatter_qml.lua`
- [rubocop](https://github.com/rubocop/rubocop): `formatter_rubocop.lua`
- [rustfmt](https://github.com/rust-lang/rustfmt): `formatter_rustfmt.lua`
- [shfmt](https://github.com/mvdan/sh): `formatter_shfmt.lua`
- [vfmt](https://github.com/vlang/v): `formatter_vfmt.lua`
- [sql-formatter](https://github.com/sql-formatter-org/sql-formatter): `formatter_sqlformatter.lua`
- [zigfmt](https://ziglang.org): `formatter_zigfmt.lua`
## Installation instructions
1. Copy the `formatter.lua` file into the lite/lite-xl `data/plugins` folder
2. To install any specific formatter, copy the corresponding file into the `data/plugins` folder. List of formatters is at the top of this file.
3. Make sure you have the command that formatter uses installed, or it won't work.
4. Extra configuration:
If you want to customize the cli arguments for a specific formatter, you can do this from your `init.lua` script.
Example:
```lua
config.jsbeautify_args = {"-r", "-s 4", "-p", "-b end-expand"} -- set jsBeautify arguments to indent with spaces.
```
## using the formatter
the default keymap to format the current doc is `alt+shift+f`
the command is `formatter:format-doc`
to format a document at each save add the following config to
your user `init.lua` as shown:
```lua
config.format_on_save = true
```
## Adding a formatter
here is an example formatter:
```lua
-- mod-version:1 lite-xl 2.00
-- ^^^ lite-xl version tag ^^^
-- for JS Beautify fortmatter
local config = require "core.config"
local formatter = require "plugins.formatter"
config.jsbeautify_args = {"-r", "-q", "-s 1", "-t", "-p", "-b end-expand"} -- make sure to keep -r arg if you change this
formatter.add_formatter {
name = "JS Beautifier",
file_patterns = {"%.js$"},
command = "js-beautify $ARGS $FILENAME",
args = config.jsbeautify_args
}
```
### a few things to keep in mind
- make sure to add the lite-xl version tag at the top
- make sure to keep the arguments inside `config.yourformatter_args`
- make sure to set a name
- make sure to add it to the list in readme.md (and keep it alphabetical)
### Then, submit a pull request