vimlrs 0.1.2

Faithful Rust port of the Vimscript (VimL) interpreter, from the Neovim C eval engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

" varargs.vim — variadic functions (a:000 / a:0) and :unlet, with unit tests.
"
" Demonstrates `...` varargs (all extra args collect into a:000, with a:0 their
" count) — both alone and after fixed parameters — and deleting variables with
" :unlet. Self-checks and exits non-zero on failure.
"
"   vimlrs examples/varargs.vim

" ── a function that takes only varargs ──
function! Sum(...) abort
  let total = 0
  for x in a:000
    let total += x
  endfor
  return total
endfunction

call assert_equal(0, Sum())
call assert_equal(10, Sum(1, 2, 3, 4))
call assert_equal(3, Sum(10, 20, 30) / 10 * 1)

" ── fixed params then varargs: a:000 holds only the extras ──
function! Tag(label, ...) abort
  return a:label . ': ' . a:0 . ' items'
endfunction

call assert_equal('x: 0 items', Tag('x'))
call assert_equal('y: 3 items', Tag('y', 1, 2, 3))

" ── a vararg function works as a lambda body's callee, too ──
call assert_equal([1, 3, 6], map([1, 2, 3], {i, v -> Sum(v, i * v)}))

" ── :unlet removes variables (single, multiple, and :unlet!) ──
let g:tmp = 99
call assert_true(exists('g:tmp'))
unlet g:tmp
call assert_false(exists('g:tmp'))

let g:a = 1 | let g:b = 2
unlet g:a g:b
call assert_false(exists('g:a'))
call assert_false(exists('g:b'))

" :unlet! does not error on a missing name.
let g:keep = 5
unlet! g:missing g:keep
call assert_false(exists('g:keep'))

" ── demo ──
echo 'Sum(1..5) =' Sum(1, 2, 3, 4, 5)
echo 'Tag(file, a, b) =' Tag('file', 'a', 'b')

" ── self-test epilogue ──
if !empty(v:errors)
  for e in v:errors
    echo 'FAIL:' e
  endfor
  throw len(v:errors) . ' assertion(s) failed'
endif
echo 'OK: varargs assertions passed'