taz17 / lite-formatters

Code formatters for https://github.com/rxi/lite and https://github.com/franko/lite-xl

Formatters for lite and lite-xl

List of formatters (Keep alphabetical)

• black python formatter: formatter_black.lua
• clang-format: formatter_clangformat.lua
• css-beautify: formatter_cssbeautify.lua
• esformatter: formatter_esformatter.lua
• gdformat: formatter_gdformat.lua
• goimports: formatter_golang.lua
• html-beautify: formatter_htmlbeautify.lua
• js-beautify: formatter_jsbeautify.lua
• luaformatter: formatter_luaformatter.lua
• zigfmt: 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:

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:

config.format_on_save = true

Adding a formatter

here is an example formatter:

-- 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