kakoune/rc/windowing/repl/x11.kak

hook global ModuleLoaded x11 %{
    require-module x11-repl
}

provide-module x11-repl %{

# termcmd should already be set in x11.kak
define-command -docstring %{x11-repl [<arguments>]: create a new window for repl interaction
All optional parameters are forwarded to the new window} \
    -params .. \
    -shell-completion \
    x11-repl %{ evaluate-commands %sh{
        if [ -z "${kak_opt_termcmd}" ]; then
           echo 'fail termcmd option is not set'
           exit
        fi
        if [ $# -eq 0 ]; then cmd="${SHELL:-sh}"; else cmd="$@"; fi
        # The escape sequence in the printf command sets the terminal's title:
        setsid ${kak_opt_termcmd} "printf '\e]2;kak_repl_window\a' \
                && ${cmd}" < /dev/null > /dev/null 2>&1 &
}}

define-command x11-send-text -docstring "send the selected text to the repl window" %{
    nop %sh{
        printf %s\\n "${kak_selection}" | xsel -i
        wid=$(xdotool getactivewindow)
        xdotool search --name kak_repl_window windowactivate
        xdotool key --clearmodifiers "Shift+Insert"
        xdotool windowactivate $wid
    }
}

alias global repl x11-repl
alias global send-text x11-send-text

}
Rename ModuleLoad hook to ModuleLoaded This clarifies, that the hook is run after the module is loaded. 2019-06-25 17:48:24 +02:00			`hook global ModuleLoaded x11 %{`
Added modules to extra files 2019-03-13 22:00:59 +01:00			`require-module x11-repl`
			`}`

			`provide-module x11-repl %{`

Docs: fix docstrings in rc files `set-option` → `set` 2018-04-19 19:28:32 +02:00			`# termcmd should already be set in x11.kak`
rc: Don't use command aliases to highlight keywords properly 2017-11-03 08:34:41 +01:00			`define-command -docstring %{x11-repl [<arguments>]: create a new window for repl interaction`
Fix, complete and add docstring documentation to builtin commands Level out the builtin commands loaded at startup in terms of format and expressiveness. The following convention was followed: * commands that take more than one argument have to be described along with their parameters prior to the actual documentation, otherwise the docstring consists in a capitalized sentence e.g. `command <arg1>: do something` * optional arguments are enclosed in square brackets, to comply with the format used for hardcoded commands e.g. `cd [<directory>]` * describe the effects of the command in the documentation string and omit implementation details unless they are relevant. Usually command names include the name of the tool they use, so they don't need to be redundantly mentioned e.g. `tmux-new-pane <arguments>: open a new pane` * document the format the parameters to the commands, or list them if they are to be chosen among a list of static values (c.f. `spell.kak`) 2016-10-11 09:03:41 +02:00			`All optional parameters are forwarded to the new window} \`
			`-params .. \`
Added shell command completion support to define-command and prompt This commit also introduces a regression in that I decided that the best way to avoid overly long and confusing names was to rename the current shell-* switches to script-, and have the shell command completion be shell-completion. renamed script-{completion,candidates} to shell-script- Updated docs with new switch names Added -shell-completion switch to x11-repl and kitty-repl 2018-09-26 23:42:01 +02:00			`-shell-completion \`
Do not reparse %sh{...} strings Automatic reparsing of %sh{...}, while convenient in many cases, can be surprising as well, and can lead to security problems: 'echo %sh{ printf "foo\necho bar" }' runs 'echo foo', then 'echo bar'. we make this danger explicit, and we fix the 'nop %sh{...}' pattern. To reparse %sh{...} strings, they can be passed to evaluate-commands, which has been fixed to work in every cases where %sh{...} reparsing was used.. 2018-05-06 23:29:52 +02:00			`x11-repl %{ evaluate-commands %sh{`
split x11 repl functionality to x11-repl.kak 2016-01-26 14:05:35 +01:00			`if [ -z "${kak_opt_termcmd}" ]; then`
rc: Use the standard `fail` command to report errors Merely using `echo` with markup doesn't log errors in the debug buffers, and is also less readable. 2019-11-14 08:32:55 +01:00			`echo 'fail termcmd option is not set'`
split x11 repl functionality to x11-repl.kak 2016-01-26 14:05:35 +01:00			`exit`
			`fi`
rc: Use $SHELL instead of spawning `bash` arbitrarily 2017-04-30 12:38:32 +02:00			`if [ $# -eq 0 ]; then cmd="${SHELL:-sh}"; else cmd="$@"; fi`
Comment on the escape sequence for setting the terminal's title 2019-06-18 11:52:33 +02:00			`# The escape sequence in the printf command sets the terminal's title:`
Print escape sequence to set the window title Using xdotool was probably a little less portable, because it relied on the newly created window to be activated by the window manager. 2019-06-18 11:41:59 +02:00			`setsid ${kak_opt_termcmd} "printf '\e]2;kak_repl_window\a' \`
			`&& ${cmd}" < /dev/null > /dev/null 2>&1 &`
split x11 repl functionality to x11-repl.kak 2016-01-26 14:05:35 +01:00			`}}`

rc: Don't use command aliases to highlight keywords properly 2017-11-03 08:34:41 +01:00			`define-command x11-send-text -docstring "send the selected text to the repl window" %{`
Avoid interpretting eventual output in send-text implementations 2016-01-28 20:30:49 +01:00			`nop %sh{`
Pass a generic pattern to `printf` calls, use `echo` when possible 2016-04-23 07:47:01 +02:00			`printf %s\\n "${kak_selection}" \| xsel -i`
split x11 repl functionality to x11-repl.kak 2016-01-26 14:05:35 +01:00			`wid=$(xdotool getactivewindow)`
			`xdotool search --name kak_repl_window windowactivate`
			`xdotool key --clearmodifiers "Shift+Insert"`
			`xdotool windowactivate $wid`
			`}`
			`}`

			`alias global repl x11-repl`
			`alias global send-text x11-send-text`
Added modules to extra files 2019-03-13 22:00:59 +01:00
			`}`