8000 GitHub - tonyrt2/mini.nvim: Library of 40+ independent Lua modules improving overall Neovim (version 0.9 and higher) experience with minimal effort · GitHub
[go: up one dir, main page]
Skip to content
{"props":{"color_mode":"dark","logged_in":false,"marketing_page":false,"home_path":"/","login_path":"/login?return_to=https%3A%2F%2FgitHub.com%2Ftonyrt2%2Fmini.nvim","signup_path":"/signup?ref_cta=Sign+up\u0026ref_loc=header+logged+out\u0026ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E\u0026source=header-repo\u0026source_repo=tonyrt2%2Fmini.nvim","signup_enabled":true,"is_signup_controller":false,"show_search_and_nav":true,"hide_search":false,"private_mode_enabled":false,"should_use_dotcom_links":true,"auth_hydro_click":"{\"event_type\":\"authentication.click\",\"payload\":{\"location_in_page\":\"site header menu\",\"repository_id\":null,\"auth_type\":\"SIGN_UP\",\"originating_url\":\"https://gitHub.com/tonyrt2/mini.nvim\",\"user_id\":null}}","auth_hydro_click_hmac":"eea97d8a0de4621c98b2e8413d3f7b929b4e53d24f7c5eeb6122abb76847723e"}}
tonyrt2
mini.nvim
Public

About

Library of 40+ independent Lua modules improving overall Neovim (version 0.9 and higher) experience with minimal effort

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags
 
 

Repository files navigation

mini.nvim

GitHub license GitHub tag Current version

Library of 40+ independent Lua modules improving overall Neovim (version 0.9 and higher) experience with minimal effort. They all share same configuration approaches and general design principles.

Think about this project as "Swiss Army knife" among Neovim plugins: it has many different independent tools (modules) suitable for most common tasks. Each module can be used separately without any startup and usage overhead.

If you want to help this project grow but don't know where to start, check out contributing guides or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.

Table of contents

Installation

There are two branches to install from:

  • main (default, recommended) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
  • stable will be updated only upon releases with code tested during public beta-testing phase in main branch.

Here are code snippets for some common installation methods:

  • Manually with git clone (compatible with mini.deps):
-- Put this at the top of 'init.lua'
local path_package = vim.fn.stdpath('data') .. '/site'
local mini_path = path_package .. '/pack/deps/start/mini.nvim'
if not vim.loop.fs_stat(mini_path) then
  vim.cmd('echo "Installing `mini.nvim`" | redraw')
  local clone_cmd = {
    'git', 'clone', '--filter=blob:none',
    -- Uncomment next line to use 'stable' branch
    -- '--branch', 'stable',
    'https://github.com/echasnovski/mini.nvim', mini_path
  }
  vim.fn.system(clone_cmd)
  vim.cmd('packadd mini.nvim | helptags ALL')
  vim.cmd('echo "Installed `mini.nvim`" | redraw')
end
Branch Code snippet
Main { 'echasnovski/mini.nvim', version = false },
Stable { 'echasnovski/mini.nvim', version = '*' },
Branch Code snippet
Main Plug 'echasnovski/mini.nvim'
Stable Plug 'echasnovski/mini.nvim', { 'branch': 'stable' }
  • Every module is also distributed as a standalone Git repository. Check out module's information for more details.

Important: don't forget to call module's setup() (if required) to enable its functionality.

Note: if you are on Windows, there might be problems with too long file paths (like error: unable to create file <some file name>: Filename too long). Try doing one of the following:

  • Enable corresponding git global config value: git config --system core.longpaths true. Then try to reinstall.
  • Install plugin in other place with shorter path.

Modules

'mini.nvim' contains many modules which is slightly daunting at first. All of them can be used independently, one at a time. For easier exploration, here they are presented in groups based on module's primary functionality (although some modules can fit in several groups).

Text editing

These modules improve your text editing experience. Start with 'mini.ai', 'mini.operators', and 'mini.surround'.

Module Description Overview Details
mini.ai Extend and create a/i textobjects README Help file
mini.align Align text interactively README Help file
mini.comment Comment lines README Help file
mini.completion Completion and signature help README Help file
mini.keymap Special key mappings README Help file
mini.move Move any selection in any direction README Help file
mini.operators Text edit operators README Help file
mini.pairs Autopairs README Help file
mini.snippets Manage and expand snippets README Help file
mini.splitjoin Split and join arguments README Help file
mini.surround Surround actions README Help file

General workflow

These modules improve your general workflow. Start with 'mini.bracketed', 'mini.files', and 'mini.pick'.

Module Description Overview Details
mini.basics Common configuration presets README Help file
mini.bracketed Go forward/backward with square brackets README Help file
mini.bufremove Remove buffers README Help file
mini.clue Show next key clues README Help file
mini.deps Plugin manager README Help file
mini.diff Work with diff hunks README Help file
mini.extra Extra 'mini.nvim' functionality README Help file
mini.files Navigate and manipulate file system README Help file
mini.git Git integration README Help file
mini.jump Jump to next/previous single character README Help file
mini.jump2d Jump within visible lines README Help file
mini.misc Miscellaneous functions README Help file
mini.pick Pick anything README Help file
mini.sessions Session management README Help file
mini.visits Track and reuse file system visits README Help file

Appearance

These modules improve your Neovim appearance. Start with 'mini.hues', 'mini.icons', and 'mini.statusline'.

Module Description Overview Details
mini.animate Animate common Neovim actions README Help file
mini.base16 Base16 colorscheme creation README Help file
mini.colors Tweak and save any color scheme README Help file
mini.cursorword Autohighlight word under cursor README Help file
mini.hipatterns Highlight patterns in text README Help file
mini.hues Generate configurable color scheme README Help file
mini.icons Icon provider README Help file
mini.indentscope Visualize and work with indent scope README Help file
mini.map Window with buffer text overview README Help file
mini.notify Show notifications README Help file
mini.starter Start screen README Help file
mini.statusline Statusline README Help file
mini.tabline Tabline README Help file
mini.trailspace Trailspace (highlight and remove) README Help file

Other

These modules don't quite fit in any of the previous categories.

Module Description Overview Details
mini.doc Generate Neovim help files README Help file
mini.fuzzy Fuzzy matching README Help file
mini.test Test Neovim plugins README Help file

General principles

  • Design. Each module is designed to solve a particular problem targeting balance between feature-richness (handling as many edge-cases as possible) and simplicity of implementation/support. Granted, not all of them ended up with the same balance, but it is the goal nevertheless.

  • Independence. Modules are independent of each other and can be run without external dependencies. Although some of them may need dependencies for full experience.

  • Structure. Each module is a submodule for a placeholder "mini" module. So, for example, "surround" module should be referred to as "mini.surround". As later will be explained, this plugin can also be referred to as "MiniSurround".

  • Setup:

    • Each module you want to use should be enabled separately with require(<name of module>).setup({}). Possibly replace {} with your config table or omit altogether to use defaults. You can supply only parts of config, the rest will be inferred from defaults.

    • Call to module's setup() always creates a global Lua object with coherent camel-case name: require('mini.surround').setup() creates _G.MiniSurround. This allows for a simpler usage of plugin functionality: instead of require('mini.surround') use MiniSurround (or manually :lua MiniSurround.* in command line); available from v:lua like v:lua.MiniSurround. Considering this, "module" and "Lua object" names can be used interchangeably: 'mini.surround' and 'MiniSurround' will mean the same thing.

    • Each supplied config table is stored in config field of global object. Like MiniSurround.config.

    • Values of config which affect runtime activity can be changed on the fly to have effect. For example, MiniSurround.config.n_lines can be changed during runtime; but changing MiniSurround.config.mappings won't have any effect (as mappings are created once during setup()).

    • If module works best with some specific non-default option value, it is set during setup(). If the value is not essential to module's functionality, it is done only if user or another plugin hasn't set it beforehand (no matter the value).

  • Buffer local configuration. Each module can be additionally configured to use certain runtime config settings locally to buffer. See mini.nvim-buffer-local-config section in help file for more information.

  • Buffer names. All module-related buffers are named according to the following format: mini<module-name>://<buffer-number>/<useful-info> (forward slashes are used on any platform; <useful-info> may be empty). This structure allows creating identifiable, reasonably unique, and useful buffer names. For example, 'mini.files' buffers are created per displayed directory/file with names like minifiles://10/path/to/displayed/directory.

  • Disabling. Each module's core functionality can be disabled globally or locally to buffer. See "Disabling" section in module's help page for more details. See mini.nvim-disabling-recipes section in main help file for common recipes.

  • Silencing. Each module providing non-error feedback can be configured to not do that by setting config.silent = true (either inside setup() call or on the fly).

  • Highlighting. Appearance of module's output is controlled by certain set of highlight groups (see :h highlight-groups). By default they usually link to some semantically close built-in highlight group and are ensured to be defined after any color scheme takes effect. Use :highlight command or vim.api.nvim_set_hl() Lua function to customize highlighting. To see a more calibrated look, use 'mini.hues', 'mini.base16', or plugin's color scheme.

  • Stability. Each module upon release is considered to be relatively stable: both in terms of setup and functionality. Any non-bugfix backward-incompatible change will be released gradually as much as possible.

  • Not filetype/language specific. Including functionality which needs several filetype/language specific implementations is an explicit no-goal of this project. This is mostly due to the potential increase in maintenance to keep implementation up to date. However, any part which might need filetype/language specific tuning should be designed to allow it by letting user set proper buffer options and/or local configuration.

Plugin color schemes

This plugin comes with several color schemes (all have both dark and light variants). Activate any of them as a regular colorscheme (like :colorscheme miniwinter or vim.cmd.colorscheme('miniwinter')).

  • Based on 'mini.hues' (recommended):

    • miniwinter: "icy winter" palette with azure background.
    • minispring: "blooming spring" palette with green background.
    • minisummer: "hot summer" palette with brown/yellow background.
    • miniautumn: "cooling autumn" palette with purple background.
    • randomhue: random background and foreground of the same hue with medium saturation.

    You can see how they look in 'mini.hues' README.

  • Based on 'mini.base16':

    • minicyan: cyan and grey main colors with medium contrast and saturation palette.
    • minischeme: blue and yellow main colors with high contrast and saturation palette.

    You can see how they look in 'mini.base16' README.

Planned modules

This is the list of modules I currently intend to implement eventually (as my free time and dedication will allow), in alphabetical order:

  • 'mini.abbrev' - helper to manage/setup Insert mode abbreviations.
  • 'mini.cmdline' - improved Command line. Possibly with custom vim.ui.input implementation.
  • 'mini.cycle' - cycle through alternatives with pre-defined rules. Something like monaqa/dial.nvim and AndrewRadev/switch.vim
  • 'mini.folds' - more capable and user-friendly folds.
  • 'mini.repl' - extendable wrapper for REPLs with built-in support for R, Python, Julia, and maybe (just maybe) some AI tools.
  • 'mini.sendtext' - send text between buffers. In particular between regular and built-in terminal buffers.
  • 'mini.statuscolumn' - customizable 'statuscolumn'.
  • 'mini.terminals' - coherently manage interactive terminal buffers. Something like kassio/neoterm. Might also incorporate functionality to asynchronously run code in shell with post-processed results.
  • 'mini.quickfix' - more capable and user-friendly quickfix list. Possibly with preview and inline editing for search-and-replace workflow.
  • 'mini.windows' - window manager. Interactive picker, layout organizer, and maybe more.

About

Library of 40+ independent Lua modules improving overall Neovim (version 0.9 and higher) experience with minimal effort

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

0