dps-dial.vim: Extended increment/decrement plugin

（日本語版はこちら）

NOTICE: This plugin is work-in-progress yet. User interface is subject to
change without notice.

Extended increment/decrement plugin for
Vim/Neovim.
Written in Deno, using
denops.vim.

This plugin is a reimplementation of
dial.nvim plugin for the following
purposes:

• To support both Vim and Neovim
• For ease of development and debugging

Installation

This plugin depends on Deno and
denops.vim.

Plug 'vim-denops/denops.vim'
Plug 'monaqa/dps-dial.vim'

Usage

By adding the following description to the configuration file, you can change
the behavior of <C-a> and <C-x>:

nmap  <C-a>  <Plug>(dps-dial-increment)
nmap  <C-x>  <Plug>(dps-dial-decrement)
xmap  <C-a>  <Plug>(dps-dial-increment)
xmap  <C-x>  <Plug>(dps-dial-decrement)
xmap g<C-a> g<Plug>(dps-dial-increment)
xmap g<C-x> g<Plug>(dps-dial-decrement)

Features

Increment/Decrement/Toggle Non-Numeric Strings

You can perform string operations according to the following rules:

• Date Increase/Decrease

  • If you press 7<C-a> on 25 in 2021/08/25, you will get the date one
    week later, 2021/09/01.
  • For the same string as above, pressing 7<C-a> on 08, then you will get
    the date seven months later, 2022/03/25.

• Toggle between camelCase and snake_case

  • You can toggle the notation (camelCase, snake_case, etc.) of identifier
    under the cursor.
  • You need to tweak the configuration values such as g:dps_dial#augends.

• Switch arbitrary words

  • You can switch between words with a several number of candidates, such as
    ['true', 'false'] or [ 'Mon', 'Tue', ..., 'Sun' ].
  • You need to tweak the configuration values such as g:dps_dial#augends.

• User extension

  • You can create arbitrary rule with Vim script.

Dot-Repeat

Unlike the standard dot repeating in <C-a> / <C-x>, dps-dial.vim provides
dot repeating with a fixed increment/decrement rule. For example, suppose you
have a buffer like the following, and you want to move all due dates back one
month:

date: 2020/11/08
...
due date of 1st report: 2020/11/23
...
due date of 2nd report: 2020/12/21
...
date of exam: 2021/01/14

In dps-dial.vim, it can be achieved by the following simple operations:

1. Move the 11 in the first line 2020/11/08 and press <C-a> (this will
   change the date in the first line to 2020/12/08)
2. Search for date and jump to the third line at date
3. Do dot-repeat . (this will change the date in the third line to
   2020/12/23)
4. Do n.n. (the date will be incremented by one month for line 5 and 7 as
   well)

Note that if you press <C-a> at step3, the 1 part of 1st will be
incremented. Dot-repeat remembers that the previous operation was to increment
the month of the date by one, so you can skip the number 1st and just
increment the date.

Configure Augend Rules

The increment/decrement is done according to the rules set in
g:dps_dial#augends.

function! s:dps_dial_settings() abort
  let g:dps_dial#augends += ['boolean']
  call extend(g:dps_dial#aliases, {
  \   'boolean': {
  \     'kind': 'constant',
  \     'opts': {
  \       'elements': ['true', 'false'],
  \       'word': v:true,
  \       'cyclic': v:true,
  \     },
  \   },
  \ })
endfunction
autocmd User DenopsPluginPost:dial call <SID>dps_dial_settings()

Note that if there is a buffer-local variable b:dps_dial_augends, it will be
used as the configuration.

autocmd FileType python let b:dps_dial#augends = ['decimal', {'kind': 'constant', 'opts': {'elements': ['True', 'False']}}]

Specify Augend Rules with Register Name

• If you type "x<C-a> instead of <C-a>, the increment will be performed
  according to the rules written in g:dps_dial#augends#register#x instead of
  g:dps_dial#augends.
• If you type "1<C-a> instead of <C-a>, the behavior of subsequent
  dot-repeat will be cumulative. That is, each time a dot-repeat is executed,
  the addend is increased by one.
• If you type "X<C-a> instead of <C-a>, the increment will be performed
  according to the rules written in g:dps_dial#augends#register#x instead of
  g:dps_dial#augends, and the behavior of subsequent dot-repeat will be
  cumulative.

Other Features

See vim help for a list of augend and aliases (currently only Japanese).

:help dps-dial.txt

LICENSE

MIT