mirror of https://github.com/ivuorinen/nvim-shellspec.git synced 2026-01-26 03:24:00 +00:00

Files

Ismo Vuorinen ce620cd035 feat: add first-class Neovim support with enhanced formatting

- Add modern Lua implementation with modular architecture
- Implement HEREDOC preservation and smart comment indentation
- Create dual implementation (Neovim Lua + VimScript fallback)
- Add comprehensive health check and configuration system
- Enhance formatting engine with state machine for context awareness
- Update documentation with Lua configuration examples
- Add memory files for development workflow and conventions

2025-09-09 21:13:38 +03:00

3.9 KiB

Raw Permalink Blame History

Neovim ShellSpec DSL Support

Advanced language support and formatter for ShellSpec DSL testing framework with first-class Neovim support.

Installation

With lazy.nvim

{
  "ivuorinen/nvim-shellspec",
  ft = "shellspec",
  config = function()
    require("shellspec").setup({
      auto_format = true,
      indent_size = 2,
      indent_comments = true,
    })
  end,
}

With vim-plug

Plug 'ivuorinen/nvim-shellspec'

Manual Installation

git clone https://github.com/ivuorinen/nvim-shellspec.git ~/.config/nvim/pack/plugins/start/nvim-shellspec

Features

🚀 First-class Neovim support with modern Lua implementation
🎨 Syntax highlighting for all ShellSpec DSL keywords
📐 Smart indentation for block structures
📄 Enhanced filetype detection for *_spec.sh, *.spec.sh, spec/*.sh, and test/*.sh
✨ Advanced formatting with HEREDOC and comment support
⚡ Async formatting to prevent blocking (Neovim 0.7+)
🔄 Backward compatibility with Vim and older Neovim versions

Advanced Formatting Features

HEREDOC Preservation: Maintains original formatting within <<EOF, <<'EOF', <<"EOF", and <<-EOF blocks
Smart Comment Indentation: Comments are indented to match surrounding code level
Context-Aware Formatting: State machine tracks formatting context for accurate indentation

Usage

Commands

:ShellSpecFormat - Format entire buffer
:ShellSpecFormatRange - Format selected lines

File Types

Plugin activates for files matching:

*_spec.sh
*.spec.sh
spec/*.sh
test/*.sh
Files in nested spec/ directories

Configuration

Neovim (Lua Configuration) - Recommended

require("shellspec").setup({
  -- Auto-format on save
  auto_format = true,

  -- Indentation settings
  indent_size = 2,
  use_spaces = true,

  -- Comment indentation (align with code level)
  indent_comments = true,

  -- HEREDOC patterns (customizable)
  heredoc_patterns = {
    "<<[A-Z_][A-Z0-9_]*",  -- <<EOF, <<DATA, etc.
    "<<'[^']*'",           -- <<'EOF'
    '<<"[^"]*"',           -- <<"EOF"  
    "<<-[A-Z_][A-Z0-9_]*", -- <<-EOF
  },

  -- Other options
  preserve_empty_lines = true,
  max_line_length = 160,
})

-- Custom keybindings
vim.keymap.set('n', '<leader>sf', '<cmd>ShellSpecFormat<cr>', { desc = 'Format ShellSpec buffer' })
vim.keymap.set('v', '<leader>sf', '<cmd>ShellSpecFormatRange<cr>', { desc = 'Format ShellSpec selection' })

Vim/Legacy Configuration

" Enable auto-formatting on save
let g:shellspec_auto_format = 1

" Enable comment indentation (default: 1)
let g:shellspec_indent_comments = 1

" Custom keybindings
autocmd FileType shellspec nnoremap <buffer> <leader>f :ShellSpecFormat<CR>
autocmd FileType shellspec vnoremap <buffer> <leader>f :ShellSpecFormatRange<CR>

Examples

HEREDOC Formatting

The formatter intelligently handles HEREDOC blocks:

Describe "HEREDOC handling"
  It "preserves original formatting within HEREDOC"
    When call cat <<EOF
      This indentation is preserved
        Even nested indentation
    And this too
EOF
    The output should equal expected
  End
End

Comment Indentation

Comments are properly aligned with surrounding code:

Describe "Comment handling"
  # This comment is indented to match the block level
  It "should handle comments correctly"
    # This comment matches the It block indentation
    When call echo "test"
    The output should equal "test"
  End
  # Back to Describe level indentation
End

Contributing

Contributions welcome! Please open issues and pull requests at: https://github.com/ivuorinen/nvim-shellspec

License

MIT License - see repository for details.

ShellSpec - BDD testing framework for shell scripts

3.9 KiB Raw Permalink Blame History