• Stars
    star
    1,974
  • Rank 23,486 (Top 0.5 %)
  • Language
    Vim Script
  • License
    BSD 2-Clause "Sim...
  • Created over 8 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

✨ A (Neo)vim plugin for formatting code.

Neoformat Build Status

A (Neo)vim plugin for formatting code.

Neoformat uses a variety of formatters for many filetypes. Currently, Neoformat will run a formatter using the current buffer data, and on success it will update the current buffer with the formatted text. On a formatter failure, Neoformat will try the next formatter defined for the filetype.

By using getbufline() to read from the current buffer instead of file, Neoformat is able to format your buffer without you having to :w your file first. Also, by using setline(), marks, jumps, etc. are all maintained after formatting.

Neoformat supports both sending buffer data to formatters via stdin, and also writing buffer data to /tmp/ for formatters to read that do not support input via stdin.

Basic Usage

Format the entire buffer, or visual selection of the buffer

:Neoformat

Or specify a certain formatter (must be defined for the current filetype)

:Neoformat jsbeautify

Or format a visual selection of code in a different filetype

Note: you must use a ! and pass the filetype of the selection

:Neoformat! python

You can also pass a formatter to use

:Neoformat! python yapf

Or perhaps run a formatter on save

augroup fmt
  autocmd!
  autocmd BufWritePre * undojoin | Neoformat
augroup END

The undojoin command will put changes made by Neoformat into the same undo-block with the latest preceding change. See Managing Undo History.

Install

The best way to install Neoformat is with your favorite plugin manager for Vim, such as vim-plug:

Plug 'sbdchd/neoformat'

Current Limitation(s)

If a formatter is either not configured to use stdin, or is not able to read from stdin, then buffer data will be written to a file in /tmp/neoformat/, where the formatter will then read from

Config [Optional]

Define custom formatters.

Options:

name description default optional / required
exe the name the formatter executable in the path n/a required
args list of arguments [] optional
replace overwrite the file, instead of updating the buffer 0 optional
stdin send data to the stdin of the formatter 0 optional
stderr capture stderr output from formatter 0 optional
no_append do not append the path of the file to the formatter command, used when the path is in the middle of a command 0 optional
env list of environment variable definitions to be prepended to the formatter command [] optional
valid_exit_codes list of valid exit codes for formatters who do not respect common unix practices [0] optional
try_node_exe attempt to find exe in a node_modules/.bin directory in the current working directory or one of its parents (requires setting g:neoformat_try_node_exe) 0 optional

Example:

let g:neoformat_python_autopep8 = {
            \ 'exe': 'autopep8',
            \ 'args': ['-s 4', '-E'],
            \ 'replace': 1, " replace the file, instead of updating buffer (default: 0)
            \ 'stdin': 1, " send data to stdin of formatter (default: 0)
            \ 'env': ["DEBUG=1"], " prepend environment variables to formatter command
            \ 'valid_exit_codes': [0, 23],
            \ 'no_append': 1,
            \ }

let g:neoformat_enabled_python = ['autopep8']

Configure enabled formatters.

let g:neoformat_enabled_python = ['autopep8', 'yapf', 'docformatter']

Have Neoformat use &formatprg as a formatter

let g:neoformat_try_formatprg = 1

Enable basic formatting when a filetype is not found. Disabled by default.

" Enable alignment
let g:neoformat_basic_format_align = 1

" Enable tab to spaces conversion
let g:neoformat_basic_format_retab = 1

" Enable trimmming of trailing whitespace
let g:neoformat_basic_format_trim = 1

Run all enabled formatters (by default Neoformat stops after the first formatter succeeds)

let g:neoformat_run_all_formatters = 1

Above options can be activated or deactivated per buffer. For example:

    " runs all formatters for current buffer without tab to spaces conversion
    let b:neoformat_run_all_formatters = 1
    let b:neoformat_basic_format_retab = 0

Have Neoformat only msg when there is an error

let g:neoformat_only_msg_on_error = 1

When debugging, you can enable either of following variables for extra logging.

let g:neoformat_verbose = 1 " only affects the verbosity of Neoformat
" Or
let &verbose            = 1 " also increases verbosity of the editor as a whole

Have Neoformat look for a formatter executable in the node_modules/.bin directory in the current working directory or one of its parents (only applies to formatters with try_node_exe set to 1):

let g:neoformat_try_node_exe = 1

Adding a New Formatter

Note: you should replace everything {{ }} accordingly

  1. Create a file in autoload/neoformat/formatters/{{ filetype }}.vim if it does not already exist for your filetype.

  2. Follow the following format

See Config above for options

function! neoformat#formatters#{{ filetype }}#enabled() abort
    return ['{{ formatter name }}', '{{ other formatter name for filetype }}']
endfunction

function! neoformat#formatters#{{ filetype }}#{{ formatter name }}() abort
    return {
        \ 'exe': '{{ formatter name }}',
        \ 'args': ['-s 4', '-q'],
        \ 'stdin': 1
        \ }
endfunction

function! neoformat#formatters#{{ filetype }}#{{ other formatter name }}() abort
  return {'exe': {{ other formatter name }}
endfunction

Managing Undo History

If you use an autocmd to run Neoformat on save, and you have your editor configured to save automatically on CursorHold then you might run into problems reverting changes. Pressing u will undo the last change made by Neoformat instead of the change that you made yourself - and then Neoformat will run again redoing the change that you just reverted. To avoid this problem you can run Neoformat with the Vim undojoin command to put changes made by Neoformat into the same undo-block with the preceding change. For example:

augroup fmt
  autocmd!
  autocmd BufWritePre * undojoin | Neoformat
augroup END

When undojoin is used this way pressing u will "skip over" the Neoformat changes - it will revert both the changes made by Neoformat and the change that caused Neoformat to be invoked.

Supported Filetypes

More Repositories

1

squawk

🐘 linter for PostgreSQL, focused on migrations
Rust
576
star
2

celery-types

🌱 Type stubs for Celery and its related packages
Python
74
star
3

flake8-pie

πŸ• A flake8 extension that implements misc. lints
Python
61
star
4

codeowners

🐝 A Python library for codeowners files
Python
36
star
5

dhall-docker-compose

πŸ’¨ A library for writing Docker Compose files in Dhall.
Dhall
25
star
6

apple-music-to-slack

set your slack status to the current song playing in iTunes/Music
Rust
18
star
7

mongo-types

πŸ‚ Type stubs for mongoengine, pymongo, and bson
Python
18
star
8

vim-run

πŸƒ A Neovim plugin to run the current filetype.
Vim Script
10
star
9

vim-shebang

🀘 A simple plugin to insert the correct shebang of the file.
Vim Script
10
star
10

msgpack-types

πŸ“¦ Type stubs for msgpack
Python
8
star
11

macchanger

πŸ‘€ A Bash based MAC address changer.
Shell
5
star
12

poetry-to-requirements

Convert Poetry.lock to requirements.txt
Rust
5
star
13

squawk-action

Github Action for Linting Postgres Migrations with Squawk
5
star
14

instakeybinds

πŸ“° keybinds for Instapaper
JavaScript
5
star
15

.dotfiles

πŸ”§ My dotfiles & setup scripts
Shell
4
star
16

julia-set

πŸŒ‰ A rust implementation of the julia set
Rust
4
star
17

sleep-restart-shutdown-apps

πŸ’€ Some OSX shell scripts in app form.
Shell
3
star
18

nyc-dot-cameras

πŸ“Ή A website that loads images from NYC DOT cameras.
JavaScript
3
star
19

luis

A Lua parser in Rust
Rust
3
star
20

python-url-shortener

🍀 A simple python url shortener.
HTML
2
star
21

time-to-deploy

βŒ› Slack bot for Heroku deployments
TypeScript
2
star
22

blog

πŸ“„ A homepage.
SCSS
2
star
23

tiktoker

πŸ“Ή TikTok favorites scraper
Python
2
star
24

hilbert-curve

πŸ“ A Rust implementation of a Hilbert Curve
Rust
1
star
25

base-converter

πŸ”’ A simple reactive website for your base conversions
HTML
1
star
26

eslint-plugin-cake

🍰 Sweet rules for ESLint
TypeScript
1
star
27

indentline.vim

πŸŒ„ Sublime indent lines for vim
Vim Script
1
star
28

homebrew-skim

πŸ”Ž A Homebrew formula for skim - the fuzzy finder
Ruby
1
star
29

whisk-client

Node.js GRPC-web client to fetch recipe data from Whisk
JavaScript
1
star
30

django-channels-test-repo

Python
1
star