Преговор

• Базова употреба на git: commit, push/pull, log/diff, submodules
• Vim плъгини по лесния начин: vim-plug

Преговор

• Базова употреба на git: commit, push/pull, log/diff, submodules
• Vim плъгини по лесния начин: vim-plug
• Vim плъгини по трудните начини: submodules, packages

Довършване на defaults.vim

Безинтересни за мен, но какво значат?

• :help gq, :help Ex-mode
• :help i_CTRL-U, :help i_CTRL-G_u

Kind of интересно:

• DiffOrig

Autocmd: дебъгване

• :help autocmd-define
• :set verbose=9, но бъдете готови за много output

Autocmd: дебъгване

• :help autocmd-define
• :set verbose=9, но бъдете готови за много output
• :set verbosefile=some_file_path.txt -- редиректва целия output във файл, но пак е много

Autocmd: дебъгване

• :help autocmd-define
• :set verbose=9, но бъдете готови за много output
• :set verbosefile=some_file_path.txt -- редиректва целия output във файл, но пак е много
• autocmd CursorMoved

Ftplugin

• Може да е добра идея да ползвате setlocal (:help local-options), но рядко е задължително. Просто никога не е грешно.
• Локални мапинги: map <buffer>
• Локални команди: command! -buffer
• Локални променливи: let b:some_value = ...

Ftplugin

• Зареждат се:
  • ftplugin/<filetype>.vim
  • ftplugin/<filetype>_<каквото и да е>.vim
  • ftplugin/<filetype>/<каквото и да е>.vim
• Примерно:
  • ftplugin/ruby.vim
  • ftplugin/ruby_settings.vim
  • ftplugin/ruby/commands.vim

Statusline: за да виждаме filetype-а

:help statusline

• Тонове опции, само ще добавим filetype и ще ги оставим за после
• Default:
  • set statusline=%<%f\ %h%m%r%=%-14.(%l,%c%V%)\ %P
• Малко тунингован (s/%h/%y):
  • set statusline=%<%f\ %y%m%r%=%-14.(%l,%c%V%)\ %P

Statusline: за да виждаме filetype-а

:help statusline

• Тонове опции, само ще добавим filetype и ще ги оставим за после
• Default:
  • set statusline=%<%f\ %h%m%r%=%-14.(%l,%c%V%)\ %P
• Малко тунингован (s/%h/%y):
  • set statusline=%<%f\ %y%m%r%=%-14.(%l,%c%V%)\ %P
• Повече customization -- по-нататък.
  • Примерно: set statusline=Here\ is\ the\ time:%=%{CurrentTime()}%=Amazing,\ right\ 🤯
  • Някои хора overengineer-ват statusline-а до космически нива

Vimscript в повече детайли

• :help expression -- пълния reference към Vimscript-ските изрази
• :help function-list -- пълен списък на всички функции
• Редовете се парсят един по един
• Всеки ред е команда
  • не foo = "bar", а let foo = "bar"
  • не function_call(), а call function_call() или echo function_call() или let x = function_call()

Vimscript в повече детайли

• :help expression -- пълния reference към Vimscript-ските изрази
• :help function-list -- пълен списък на всички функции
• Редовете се парсят един по един
• Всеки ред е команда
  • не foo = "bar", а let foo = "bar"
  • не function_call(), а call function_call() или echo function_call() или let x = function_call()
• Събиране на редове: | между команди, let a = 1 | let b = 2
• Разбиване на редове: \ в началото

Vimscript: числа

• Number: -123, 0x10, 0o177, 0b1011
• Float: 123.456, 1.15e-6, -1.1e3
• string(3.14) -> "3.14"

Vimscript: числа

• Number: -123, 0x10, 0o177, 0b1011
• Float: 123.456, 1.15e-6, -1.1e3
• string(3.14) -> "3.14"
• str2nr("3.14") -> 3
• str2float("3.14") -> 3.14
• str2float("foobar") -> 0

Vimscript: числа

• Number: -123, 0x10, 0o177, 0b1011
• Float: 123.456, 1.15e-6, -1.1e3
• string(3.14) -> "3.14"
• str2nr("3.14") -> 3
• str2float("3.14") -> 3.14
• str2float("foobar") -> 0
• Оператори: + - * / % << >>
• (И унарен + -)

Vimscript: Низове

:help string-functions

• strlen(), strcharlen()
• strwidth(), strdisplaywidth()

Vimscript: Низове

:help string-functions

• strlen(), strcharlen()
• strwidth(), strdisplaywidth()
• strpart(), strcharpart()

Vimscript: Низове

:help string-functions

• strlen(), strcharlen()
• strwidth(), strdisplaywidth()
• strpart(), strcharpart()
• trim(), repeat()

Vimscript: Низове

:help string-functions

• strlen(), strcharlen()
• strwidth(), strdisplaywidth()
• strpart(), strcharpart()
• trim(), repeat()
• И една купчина неща с регекси, които оставяме за по-нататък
• :help repeat( или каквато и да е функция за детайли

Vimscript: Булеви стойности

• Лъжа: 0
• Истина: 1 или каквото и да е ненулево число
• ||, &&, !
• !8 -> 0, !!8 -> 1

Vimscript: Булеви стойности

• Лъжа: 0
• Истина: 1 или каквото и да е ненулево число
• ||, &&, !
• !8 -> 0, !!8 -> 1
• 1 > 2 -- лъжа
• 4 >= 3 -- истина
• и т.н.

Vimscript: If-ове

if 2 + 2 == 4 && 2 > 1
  echo "Right, that all makes sense"
elseif 2 <= 1
  echo "No, no, that's incorrect"
else
  echo "Now this is completely unexpected"
endif

Има и тернарен оператор: 2 > 1 ? "ok" : "not okay"

Vimscript: If-ове

if 2 + 2 == 4 && 2 > 1
  echo "Right, that all makes sense"
elseif 2 <= 1
  echo "No, no, that's incorrect"
else
  echo "Now this is completely unexpected"
endif

Има и тернарен оператор: 2 > 1 ? "ok" : "not okay"
Има и "falsy" оператор: search(...) ?? line('.') (v8.2.1831)

Vimscript: Сравнения (уф)

• 1 == "1" -- истина :)

Vimscript: Сравнения (уф)

• 1 == "1" -- истина :)
• 1 is 1 -- истина,
• 1 is "1" -- лъжа…

Vimscript: Сравнения (уф)

• 1 == "1" -- истина :)
• 1 is 1 -- истина,
• 1 is "1" -- лъжа…
• но това е "идентичност", не равенство -- [] is [] е лъжа, защото са различни обекти в паметта. Така че е полезно горе-долу само за числа

Vimscript: Сравнения (уф)

• 1 == "1" -- истина :)
• 1 is 1 -- истина,
• 1 is "1" -- лъжа…
• но това е "идентичност", не равенство -- [] is [] е лъжа, защото са различни обекти в паметта. Така че е полезно горе-долу само за числа
• (Във vim9script, типовете на две стойности трябва да match-ват за да се сравняват)

Vimscript: Сравнения (уф)

• 1 == "1" -- истина :)
• 1 is 1 -- истина,
• 1 is "1" -- лъжа…
• но това е "идентичност", не равенство -- [] is [] е лъжа, защото са различни обекти в паметта. Така че е полезно горе-долу само за числа
• (Във vim9script, типовете на две стойности трябва да match-ват за да се сравняват)
• (ако не сте гледали WAT, гледайте: https://www.destroyallsoftware.com/talks/wat)

Vimscript: Сравнения (уфффф)

• "abc" == "abc" -- истина, но…

Vimscript: Сравнения (уфффф)

• "abc" == "abc" -- истина, но…
• "abc" == "ABC"?

Vimscript: Сравнения (уфффф)

• "abc" == "abc" -- истина, но…
• "abc" == "ABC"?
• Зависи дали имаме :set ignorecase 🙃

Vimscript: но защо???

• Представете си, че search-ваме за /Foo (или доста по-сложен регекс) и намерим резултат. Ако сега вземем този регекс и го ползваме някъде като getline('.') =~ 'Foo'… Ще работи ли?

Vimscript: но защо???

• Представете си, че search-ваме за /Foo (или доста по-сложен регекс) и намерим резултат. Ако сега вземем този регекс и го ползваме някъде като getline('.') =~ 'Foo'… Ще работи ли?
• Ако кажем "регексите трябва да работят консистентно", защо =~, а не ==?

Vimscript: но защо???

• Представете си, че search-ваме за /Foo (или доста по-сложен регекс) и намерим резултат. Ако сега вземем този регекс и го ползваме някъде като getline('.') =~ 'Foo'… Ще работи ли?
• Ако кажем "регексите трябва да работят консистентно", защо =~, а не ==?
• Неочевиден проблем е, който други езици нямат нужда да решават, защото нямат "editor UI"

Vimscript: решения?

• 1 == "1"? Просто не правете грешки, problem solved
• За числа, 1 is 1, 2 isnot 3 ще сработи

Vimscript: решения?

• 1 == "1"? Просто не правете грешки, problem solved
• За числа, 1 is 1, 2 isnot 3 ще сработи
• ==# винаги е case-sensitive
• ==? винаги е case-insensitive
• == зависи от конфигурацията (и съответно е подходящо за лични скриптове)

Vimscript: решения?

• 1 == "1"? Просто не правете грешки, problem solved
• За числа, 1 is 1, 2 isnot 3 ще сработи
• ==# винаги е case-sensitive
• ==? винаги е case-insensitive
• == зависи от конфигурацията (и съответно е подходящо за лични скриптове)
• moving on…

Vimscript: Списъци

• Квадратни скобки: [1, 2, 3]
• Индексиране some_list[3]
• let some_list = [1, 2, 3]
• let some_list[1] = 4
• let some_list[-1] = 8 -- последния елемент
• let some_list[10] = 5 -- грешка!
• echo some_list[20] -- грешка!

Vimscript: Slice-ване

:help sublist

let some_list = [1, 2, 3, 4]

let endlist   = some_list[2:]  " от третия елемент нататък: [3, 4]
let shortlist = some_list[2:2] " само третия елемент [3]
let otherlist = some_list[:]   " копие на списъка
let startlist = some_list[:-2] " без последния елемент: [1, 2, 3]

Ако втория индекс е твърде голям, просто се взема списъка до края
Fun fact: тези работят и за низове, но работят по байтове, което може да е рисковано.

Vimscript: Промяна на списъци

:help list-modification

• call add(list, "new_item") -- добавя елемент накрая
• call extend(list, [1, 2]) -- добавя друг списък накрая
• let value = remove(list, 3) -- маха стойността, връща я

Vimscript: Промяна на списъци

:help list-modification

• call add(list, "new_item") -- добавя елемент накрая
• call extend(list, [1, 2]) -- добавя друг списък накрая
• let value = remove(list, 3) -- маха стойността, връща я
• call sort(list)
• call reverse(list)
• call uniq(sort(list))

Vimscript: Промяна на списъци

:help list-modification

• call add(list, "new_item") -- добавя елемент накрая
• call extend(list, [1, 2]) -- добавя друг списък накрая
• let value = remove(list, 3) -- маха стойността, връща я
• call sort(list)
• call reverse(list)
• call uniq(sort(list))
• Всички операции са на място (мутират списъка)!
• Всички операции освен това връщат (reference към) списъка. Т.е. let l = sort(l) ще работи, но също и само call sort(l)
• let sorted_l = sort(copy(l))

Vimscript: Речници

:help Dict

let stuff = { 'foo': 1, 'bar': 2, 'baz': 3 }

let stuff = {
      \ 'foo': 1,
      \ 'bar': 2,
      \ 'baz': 3,
      \ }

Vimscript: Речници

:help Dict

let stuff = { 'foo': 1, 'bar': 2, 'baz': 3 }

let stuff = {
      \ 'foo': 1,
      \ 'bar': 2,
      \ 'baz': 3,
      \ }

Важно! Ключа винаги е низ:

let stuff = { 1: 'foo', 3.14: 'bar' }
echomsg string(stuff)
" {'1': 'foo', '3.14': 'bar'}

Vimscript: Речници

Ключа също така е "expression":

let f = "foo"
let stuff = { f: 1, 'bar': 2, 'baz': 3 }

Ако искаме низове без кавички, може да използваме #{

let stuff = #{ foo: 1, bar: 2, baz: 3 }

let stuff = #{
      \ foo: 1,
      \ bar: 2,
      \ baz: 3,
      \ }

Vimscript: Функции за речници

• has_key(stuff, 'foo') -- доста важно, защото непознати ключове ще гръмнат
• get(stuff, 'foo', 'default_value')
• Впрочем, get([1, 2, 3], 10, 'default_value') -- също работи

Vimscript: Извикване на функции

call Add(1, 2)
call call('Add', [1, 2])

let Plus = function('Add')
call Plus(1, 2)
call call(Plus, [1, 2])

Vimscript: Извикване на функции

call Add(1, 2)
call call('Add', [1, 2])

let Plus = function('Add')
call Plus(1, 2)
call call(Plus, [1, 2])

echomsg string(Plus)
" function('Add')

Vimscript: Засега толкоз

Има още много, но това би трябвало да ви стигне, за да:

• Разгледате сорса на Undoquit: https://github.com/AndrewRadev/undoquit.vim

Vimscript: Засега толкоз

Има още много, но това би трябвало да ви стигне, за да:

• Разгледате сорса на Undoquit: https://github.com/AndrewRadev/undoquit.vim
• Решите някои простички упражнения в Exercism: https://exercism.org/tracks/vimscript/exercises