Ⅰ. 插件描述

Send commands from text to interactive programs

Ⅱ. 基本信息

创建日期： 2018-05-25

使用用户： 1

Github星： 27

插件作者： Will Handley

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'williamjameshandley/vimteractive'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'williamjameshandley/vimteractive'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'williamjameshandley/vimteractive'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/williamjameshandley/vimteractive

Ⅳ. 文档说明

============

Vimteractive

:vimteractive: send commands from text files to interactive programs via vim
:Author: Will Handley
:Version: 2.3.1
:Homepage: https://github.com/williamjameshandley/vimteractive
:Documentation: :help vimteractive

Vimteractive was inspired by the workflow of the
vim-ipython <https://github.com/ivanov/vim-ipython>__ plugin.

This plugin is designed to extend a subset of the functionality of vim-ipython
to other interpreters (including ipython). It is based around the unix
philosophy of "do one thing and do it well" <https://en.wikipedia.org/wiki/Unix_philosophy#Do_One_Thing_and_Do_It_Well>__.
Vimteractive aims to provide a robust and simple link between text files and
interactive interpreters. Vimteractive will never aim to do things like
autocompletion, leaving that to other, more developed tools such as
YouCompleteMe <https://github.com/Valloric/YouCompleteMe>__ or
TabNine <https://tabnine.com>`.

The activating commands are

ipython :Iipython
julia :Ijulia
maple :Imaple
bash :Ibash
zsh :Izsh
python :Ipython
clojure :Iclojure
apl :Iapl
autodetect based on filetype :Iterm

Commands may be sent from a text file to the chosen terminal using CTRL-S.
If there is no terminal, CTRL-S will automatically open one for you using
:Iterm.

Note: it's highly recommended to use IPython as your default Python

You can set it like this:

.. code:: vim

let g:vimteractive_default_shells = { 'python': 'ipython' }

Installation

Since this package leverages the native vim interactive terminal, vimteractive
is only compatible with vim 8 or greater.

To use the key-bindings, you should first disable the CTRL-S
default, which is a terminal command to freeze the output. You can
disable this by putting

.. code:: bash

stty -ixon

into your .bashrc (or equivalent shell profile file).

Installation should be relatively painless via
the usual routes <https://vimawesome.com/plugin/vimteractive>_ such as
Vundle <https://github.com/VundleVim/Vundle.vim>__,
Pathogen <https://github.com/tpope/vim-pathogen>__ or the vim 8 native
package manager (:help packages).
If you're masochistic enough to use
Arch <https://wiki.archlinux.org/index.php/Arch_Linux>__/Manjaro <https://manjaro.org/>__,
you can install vimteractive via the
aur <https://aur.archlinux.org/packages/vim-vimteractive>__.
For old-school users, there is also a package on the `vim
repo https://www.vim.org/scripts/script.php?script_id=5687`__.
Depending on your package manager, you may need to run :helptags <path/to/repo/docs> to install the help documentation.

Motivation

IPython and Jupyter <https://ipython.org/>__ are excellent tools for
exploratory analyses in python. They leverage the interactivity of the python
kernel to allow you to keep results of calculations in memory whilst developing
further code to process them.

However, I can't stand typing into anything other than vim. Anywhere else, my
screen fills with hjklEB, or worse, I close the window with a careless
<C-w>. I want a technique that allows me to operate on plain text files,
but still be able to work interactively with the interpreter with minimal
effort.

Many Projects <#similar-projects>__ achieve this with a varying level of

Vimteractive aims to create the simplest tool for sending things
text to interpreter, and making it easy to add additional interpreters. In

particular, my main aim in starting this was to get a vim-ipython like
interface to the command line maple <https://www.maplesoft.com/>__.

Usage

Example usage:


|example_usage|

Create a python file ``test.py`` with the following content:

.. code:: python

   import matplotlib.pyplot as plt
   import numpy

   fig, ax = plt.subplots()
   x = numpy.linspace(-2,2,1000)
   y = x**3-x
   ax.plot(x, y)
   ax.set_xlabel('$x$')
   ax.set_ylabel('$y$')

Now start an ipython interpreter in vim with ``:Iipython``. You should see a
preview window open above with your ipython prompt. Position your cursor over
the first line of ``test.py``, and press ``CTRL-S``. You should see this line
now appear in the first prompt of the preview window. Do the same with the
second and fourth lines. At the fourth line, you should see a figure appear
once it's constructed with ``plt.subplots()``. Continue by sending lines to the
interpreter. You can send multiple lines by doing a visual selection and
pressing ``CTRL-S``.

If you switch windows with ``CTRL-W+k``, you will see the terminal buffer
switch to a more usual looking normal-mode buffer, from which you can perform
traditional normal mode commands. However, if you try to insert, you will enter
the terminal, and be able to enter commands interactively into the prompt as if
you had run it in the command line.  You can save this buffer if you wish to a
new file if it contains valuable output

You may want to send lines to one terminal from two buffers. To achieve that,
run ``:Iconn <buffer_name>`` where ``<buffer_name>`` is a name of buffer
containing terminal. If there is only one terminal, you can use just
``:Iconn``.

Supported terminals

:Iipython Activate an ipython terminal
:Ijulia Activate a julia terminal
:Imaple Activate a maple terminal
:Ibash Activate a bash terminal
:Izsh Activate a zsh terminal
:Ipython Activate a python terminal
:Iclojure Activate a clojure terminal
:Iapl Activate an apl terminal
:Iterm Activate default terminal for this filetype

Sending commands


``CTRL-S`` sends lines of text to the interpreter in a mode-dependent manner:

In Normal mode, ``CTRL-S`` sends the line currently occupied by the cursor the
terminal.

In Insert mode, ``CTRL-S`` sends the line currently being edited, and then
returns to insert mode at the same location.

In Visual mode, ``CTRL-S`` sends the current selection to the terminal.

``ALT-S`` sends all lines from the start to the current line.

Connecting to an existing terminal

:Iconn [{buffer] connects current buffer to REPL in {buffer}. You can
connect any number of buffers to one REPL. {buffer} can be omitted if there
is only one terminal.

Common issues

Bracketed paste


If you see strange symbols like ``^[[200~`` when sending lines to your new
interpreter, you may be on an older system which does not have bracketed paste
enabled, or have other shell misbehaviour issues. You can change the default
setting with 

.. code:: vim

    let g:vimteractive_bracketed_paste_default = 0


Options
-------
These options can be put in your ``.vimrc``, or run manually as desired:

.. code:: vim

    let g:vimteractive_vertical = 1        " Vertically split terminals
    let g:vimteractive_autostart = 0       " Don't start terminals by default

Extending functionality
-----------------------

This project is very much in an beta phase, so if you have any issues
that arise on your system, feel free to `leave an issue <https://github.com/williamjameshandley/vimteractive/issues/new>`__ or create a `fork and pull
request <https://gist.github.com/Chaser324/ce0505fbed06b947d962>`__ with
your proposed changes

You can easily add your interpreter to Vimteractive, using the following code
in your ``.vimrc``:

.. code:: vim

    " Mapping from Vimterpreter command to shell command
    " This would give you :Iasyncpython command
    let g:vimteractive_commands = {
        \ 'asyncpython': 'python3 -m asyncio'
        \ }

    " If you see strange symbols like ^[[200~ when sending lines
    " to your new interpreter, disable bracketed paste for it.
    " You can also try it when your shell is misbehaving some way.
    " It's needed for any standard Python REPL including
    " python3 -m asyncio
    let g:vimteractive_bracketed_paste = {
        \ 'asyncpython': 0
        \ }

    " If you want to set interpreter as default (used by :Iterm),
    " map filetype to it. If not set, :Iterm will use interpreter
    " named same with filetype.
    let g:vimteractive_default_shells = {
        \ 'python': 'asyncpython'
        \ }

    " If your interpreter startup time is big, you may want to
    " wait before sending commands. Set time in milliseconds in
    " this dict to do it. This is not needed for python3, but
    " can be useful for other REPLs like Clojure.
    let g:vimteractive_slow_prompt = {
        \ 'asyncpython': 200
        \ }


Similar projects
----------------

-  `vim-ipython <https://github.com/ivanov/vim-ipython>`__
-  `vim-notebook <https://github.com/baruchel/vim-notebook>`__
-  `conque <https://code.google.com/archive/p/conque/>`__
-  `vim-slime <https://github.com/jpalardy/vim-slime>`__
-  `tslime_ipython <https://github.com/eldridgejm/tslime_ipython>`__
-  `vipy <https://github.com/johndgiese/vipy>`__

.. |example_usage| image:: https://raw.githubusercontent.com/williamjameshandley/vimteractive/master/images/example_usage.gif

Changelist
----------
:v2.2: `Vertical splitting option <https://github.com/williamjameshandley/vimteractive/pull/21>`__
:v2.1: `Visual selection improvement <https://github.com/williamjameshandley/vimteractive/pull/15>`__
:v2.0: `Multiple terminal functionality <https://github.com/williamjameshandley/vimteractive/pull/9>`__
:v1.7: `Autodetection of terminals <https://github.com/williamjameshandley/vimteractive/pull/5>`__
:v1.6: CtrlP `bugfix <https://github.com/williamjameshandley/vimteractive/pull/4>`__
:v1.5: Added julia support
:v1.4: `Buffer rename <https://github.com/williamjameshandley/vimteractive/pull/3>`_
:v1.3: Added zsh support
:v1.2:
   - no line numbers in terminal window
:v1.1:
   -  `Bracketed paste <https://cirw.in/blog/bracketed-paste>`__ seems
      to fix most of ipython issues.

Vim插件网

vimteractive

Ⅰ. 插件描述

Ⅱ. 基本信息

Ⅲ. 安装方法

使用Vundle管理器安装

使用NeoBundle管理器安装

使用VimPlug管理器安装

使用Pathogen管理器安装

Ⅳ. 文档说明

Vimteractive

Installation

Motivation

Usage

Common issues

添加新评论