From ef19b432c7ea0f19b0aed249088911ced95fb3ee Mon Sep 17 00:00:00 2001
From: Wang Shidong <wsdjeg@outlook.com>
Date: Sun, 22 Sep 2019 22:04:25 +0800
Subject: [PATCH] Add lang#io layer (#3078)

---
 autoload/SpaceVim/layers/lang/io.vim | 36 +++++++++++++++++++
 docs/cn/layers/lang/io.md            | 50 ++++++++++++++++++++++++++
 docs/layers/lang/io.md               | 52 ++++++++++++++++++++++++++++
 3 files changed, 138 insertions(+)
 create mode 100644 autoload/SpaceVim/layers/lang/io.vim
 create mode 100644 docs/cn/layers/lang/io.md
 create mode 100644 docs/layers/lang/io.md

diff --git a/autoload/SpaceVim/layers/lang/io.vim b/autoload/SpaceVim/layers/lang/io.vim
new file mode 100644
index 000000000..86ca06e1f
--- /dev/null
+++ b/autoload/SpaceVim/layers/lang/io.vim
@@ -0,0 +1,36 @@
+"=============================================================================
+" io.vim --- io language support
+" Copyright (c) 2016-2019 Wang Shidong & Contributors
+" Author: Wang Shidong < wsdjeg@outlook.com >
+" URL: https://spacevim.org
+" License: GPLv3
+"=============================================================================
+
+function! SpaceVim#layers#lang#io#plugins() abort
+  let plugins = []
+  call add(plugins, ['wsdjeg/vim-iolang', { 'merged' : 0}])
+  return plugins
+endfunction
+
+function! SpaceVim#layers#lang#io#config() abort
+  call SpaceVim#plugins#repl#reg('io', 'io_static')
+  call SpaceVim#plugins#runner#reg_runner('io', 'io %s')
+  call SpaceVim#mapping#space#regesit_lang_mappings('io', function('s:language_specified_mappings'))
+endfunction
+
+function! s:language_specified_mappings() abort
+  call SpaceVim#mapping#space#langSPC('nmap', ['l','r'], 'call SpaceVim#plugins#runner#open()', 'execute current file', 1)
+  let g:_spacevim_mappings_space.l.s = {'name' : '+Send'}
+  call SpaceVim#mapping#space#langSPC('nmap', ['l','s', 'i'],
+        \ 'call SpaceVim#plugins#repl#start("io")',
+        \ 'start REPL process', 1)
+  call SpaceVim#mapping#space#langSPC('nmap', ['l','s', 'l'],
+        \ 'call SpaceVim#plugins#repl#send("line")',
+        \ 'send line and keep code buffer focused', 1)
+  call SpaceVim#mapping#space#langSPC('nmap', ['l','s', 'b'],
+        \ 'call SpaceVim#plugins#repl#send("buffer")',
+        \ 'send buffer and keep code buffer focused', 1)
+  call SpaceVim#mapping#space#langSPC('nmap', ['l','s', 's'],
+        \ 'call SpaceVim#plugins#repl#send("selection")',
+        \ 'send selection and keep code buffer focused', 1)
+endfunction
diff --git a/docs/cn/layers/lang/io.md b/docs/cn/layers/lang/io.md
new file mode 100644
index 000000000..f9d5fbaa0
--- /dev/null
+++ b/docs/cn/layers/lang/io.md
@@ -0,0 +1,50 @@
+---
+title: "SpaceVim lang#io 模块"
+description: "这一模块为 io 开发提供支持，包括交互式编程、一键运行等特性。"
+lang: cn
+---
+
+# [可用模块](../../) >> lang#io
+
+<!-- vim-markdown-toc GFM -->
+
+- [模块简介](#模块简介)
+- [启用模块](#启用模块)
+- [快捷键](#快捷键)
+  - [交互式编程](#交互式编程)
+  - [运行当前脚本](#运行当前脚本)
+
+<!-- vim-markdown-toc -->
+
+## 模块简介
+
+这一模块为在 SpaceVim 中进行 io 开发提供了支持。
+
+## 启用模块
+
+可通过在配置文件内加入如下配置来启用该模块：
+
+```toml
+[[layers]]
+  name = "lang#io"
+```
+
+## 快捷键
+
+### 交互式编程
+
+启动 `io` 交互进程，快捷键为： `SPC l s i`。
+
+将代码传输给 REPL 进程执行：
+
+| 快捷键      | 功能描述                |
+| ----------- | ----------------------- |
+| `SPC l s b` | 发送整个文件内容至 REPL |
+| `SPC l s l` | 发送当前行内容至 REPL   |
+| `SPC l s s` | 发送已选中的内容至 REPL |
+
+### 运行当前脚本
+
+在编辑 io 文件时，可通过快捷键 `SPC l r` 快速异步运行当前文件，运行结果会展示在一个独立的执行窗口内。
+
+
diff --git a/docs/layers/lang/io.md b/docs/layers/lang/io.md
new file mode 100644
index 000000000..c42d3d10b
--- /dev/null
+++ b/docs/layers/lang/io.md
@@ -0,0 +1,52 @@
+---
+title: "SpaceVim lang#io layer"
+description: "This layer is for io development, provide syntax checking, code runner and repl support for io file."
+---
+
+# [Available Layers](../../) >> lang#io
+
+<!-- vim-markdown-toc GFM -->
+
+- [Description](#description)
+- [Install](#install)
+- [Features](#features)
+- [Key bindings](#key-bindings)
+  - [Running current script](#running-current-script)
+  - [Inferior REPL process](#inferior-repl-process)
+
+<!-- vim-markdown-toc -->
+
+## Description
+
+This layer is for io development.
+
+## Install
+
+To use this configuration layer, update custom configuration file with:
+
+```toml
+[[layers]]
+  name = "lang#io"
+```
+## Features
+
+- repl support
+- code runner
+
+## Key bindings
+
+### Running current script
+
+To running a io file, you can press `SPC l r` to run current file without loss focus, and the result will be shown in a runner buffer.
+
+### Inferior REPL process
+
+Start a `io` inferior REPL process with `SPC l s i`.
+
+Send code to inferior process commands:
+
+| Key Bindings | Descriptions                                     |
+| ------------ | ------------------------------------------------ |
+| `SPC l s b`  | send buffer and keep code buffer focused         |
+| `SPC l s l`  | send line and keep code buffer focused           |
+| `SPC l s s`  | send selection text and keep code buffer focused |