• Stars
    star
    224
  • Rank 177,792 (Top 4 %)
  • Language
    Rust
  • License
    Apache License 2.0
  • Created about 4 years ago
  • Updated over 1 year ago

Reviews

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

Repository Details

Cargo with less noise: warnings are skipped until errors are fixed, Neovim integration, etc.

cargo-limit

Crates.io Awesome

The continued development of cargo-limit is made possible thanks to the support of awesome backers ❀️

If you'd like to join them, please consider contributing with Crypto or Patreon.

Description

πŸš€ Cargo with less noise:

  • errors have highest priority
    • they never appear in the middle of warnings
    • warnings are skipped by default until errors are fixed
    • external path dependencies' warnings are skipped by default
  • all messages come in reversed order by default
    • to avoid extra scrolling
  • messages are grouped by filenames
  • number of messages can be limited
  • after encountering first error the rest of build time is limited by default
  • files can be automatically opened in your text editor on affected lines

This tool is especially useful in combination with cargo-watch.

Initially this project was just a workaround for this issue.

Check out πŸŽ™οΈ Rustacean Station podcast episode for more.

asciicast

Installation

From crates.io

cargo install cargo-limit

From git

cargo install --force --git https://github.com/alopatindev/cargo-limit

Usage

Run any of these in your project directory:

cargo lbench
cargo lbuild
cargo lcheck
cargo lclippy
cargo ldoc
cargo lfix
cargo lrun
cargo lrustc
cargo lrustdoc
cargo ltest

Also llcheck, llrun, etc. β€” these auto-open text editor for warnings as well, not just errors.

πŸ’‘ Environment Variables πŸ‘οΈ

CARGO_MSG_LIMIT

  • limit compiler messages number
  • 0 means no limit, which is default

CARGO_TIME_LIMIT

  • cargo execution time limit in seconds after encountering first compiling error
  • 1 is default
  • 0 means no limit

CARGO_ASC

  • show compiler messages in ascending order
  • false is default

CARGO_FORCE_WARN

  • show warnings even if errors still exist
  • false is default

CARGO_DEPS_WARN

  • show external path dependencies' warnings
  • false is default

CARGO_EDITOR

  • opens affected files in external app
  • empty ("") means don't run external app
  • "_cargo-limit-open-in-nvim" is default

Text Editor/IDE integrations

πŸ’‘ Neovim Plugin πŸ‘οΈ

Enable the plugin in your init.vim. For instance for vim-plug:

Plug 'alopatindev/cargo-limit', { 'do': 'cargo install cargo-limit nvim-send' }

and install it with

nvim +PlugInstall +UpdateRemotePlugins +qa

Optionally: F2 to save, F2 again to jump to next affected line

function! SaveAllFilesOrOpenNextLocation()
  let l:all_files_are_saved = 1
  for i in getbufinfo({'bufmodified': 1})
    if i.name != ''
      let l:all_files_are_saved = 0
      break
    endif
  endfor

  if l:all_files_are_saved
    call g:CargoLimitOpenNextLocation()
  else
    execute 'wa'
  endif
endfunction

nmap <F2> :call SaveAllFilesOrOpenNextLocation()<cr>
vmap <F2> <esc>:call SaveAllFilesOrOpenNextLocation()<cr>v
imap <F2> <esc>:call SaveAllFilesOrOpenNextLocation()<cr>i
πŸ’‘ Test the plugin! πŸ‘οΈ

  1. Open two terminals (or tmux windows, etc.)
  2. cd your/project/directory in both of them
  3. Run nvim in one of them
  4. Run cargo lrun in the other
  5. In case of compiling errors nvim opens new or existing tabs with the files on affected lines and columns
  6. Fix the error, save the file and nvim will jump to the next error location
  7. cargo llrun (cargo llcheck, etc.) will open them in case of warnings as well.

⚠️ Known Limitations! πŸ‘οΈ

1. Auto-jumps work only if

  • current mode is normal
  • current buffer is either empty or contains some existing and unmodified (saved) file

This is by design, in order to not disrupt from active text editing or file navigation process.

2. Auto-jump on each file save is currently imprecise

  • it may jump to a wrong line if it moved
  • it may not jump at all, if the next affected line is supposed to be modified already

For precise jump please rerun cargo ll{check,run,etc.}.

3. Before running nvim: Current Directory should be Project (sub)directory

  • that's required so cargo-limit could figure out which exact nvim instance should be controlled
  • only first nvim instance with current project (sub)directory will be controlled by cargo-limit.

Customizations

Add a custom open handler to your init.vim if you want other Neovim behavior.

πŸ’‘ See examples! πŸ‘οΈ

Open Files in Buffers Instead of Tabs

function! g:CargoLimitOpen(editor_data)
  let l:current_file = resolve(expand('%:p'))
  if l:current_file != '' && !filereadable(l:current_file)
    return
  endif
  for location in reverse(a:editor_data.files)
    let l:path = fnameescape(location.path)
    if mode() == 'n' && &l:modified == 0
      execute 'edit ' . l:path
      call cursor((location.line), (location.column))
    else
      break
    endif
  endfor
endfunction

Populate a QuickFix List

set errorformat =%f:%l:%c:%m

function! g:CargoLimitOpen(editor_data)
  let l:winnr = winnr()

  cgetexpr []
  for file in a:editor_data['files']
    caddexpr file['path'] . ':' . file['line'] . ':' . file['column'] . ':' . file['message']
  endfor

  if empty(a:editor_data['files'])
    cclose
  else
    copen
  endif

  if l:winnr !=# winnr()
    wincmd p
  endif
endfunction

πŸ’‘ Other Text Editors/IDEs πŸ‘οΈ

cargo-limit can run external app/script and provide affected locations to stdin in the following JSON format:

{
  "workspace_root": "/full/path/to/project",
  "files": [
    {
      "path": "/full/path/to/project/file.rs",
      "line": 4,
      "column": 1,
      "message": "unused import: `diagnostic::DiagnosticSpan`",
      "level": "warning"
    }
  ]
}

Theoretically this can be used for any text editor or IDE, especially if it supports client/server communication. To do that you need a wrapper app/script that parses the files and gives them to the text editor or IDE client.

πŸ’‘ Example: Gedit! πŸ‘οΈ

  1. Install jq
  2. Create open-in-gedit.sh:
#!/bin/bash

jq --raw-output '.files |= unique_by(.path) | .files[] | [
    "gedit",
    .path,
    "+" + (.line | tostring) + ":" + (.column | tostring),
    "&"
] | join(" ")' | bash
  1. chmod +x open-in-gedit.sh
  2. Set CARGO_EDITOR=/path/to/open-in-gedit.sh environment variable
  3. Run cargo lrun in your project directory
  4. In case of compiling errors open-in-gedit.sh will open files in gedit on affected lines and columns
  5. cargo llrun (cargo llcheck, etc.) will open them in case of warnings as well.

Similar Projects/Inspirations

  • bacon is a background rust code checker
  • cargo-firstpage shows only the first page of rustc output
  • ograc like cargo, but backwards

Support

Bitcoin πŸ‘οΈ

1Afgvdz1oPaugFcLgDaAzCYYdHexV6tTvH

TRON (TRX, USDT-TRC20, etc.) πŸ‘οΈ

TVxE2HyryNyNReMvw9HRQ3BkYePCszXSrc

Ethereum (ETH, DAI, etc.) πŸ‘οΈ

0xa879cdb1d7d859e6e425f8e50c4ee49f4b3a7b06

Patreon πŸ‘οΈ

https://www.patreon.com/checkout/alopatindev/9785189

Thank you for making 🌍 a better place by supporting Free/Libre and Open Source Software development! ❀️


Also thanks everyone for code contributions and bug reporting. Special thanks to Casey Rodarmor for providing VimL code for quickfix populator and Otavio Salvador for NixOS package!

Wanna Contribute?

Please check out issues and kanban board. You can also make a package for your favorite OS distribution.

License

MIT/Apache-2.0