---

Ⅰ. 插件描述

yapf plugin for Vim

Ⅱ. 基本信息

创建日期：  2013-06-07 使用用户：  16 Github星：  47 插件作者：  Simon Walker

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'mindriot101/vim-yapf'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'mindriot101/vim-yapf'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'mindriot101/vim-yapf'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/mindriot101/vim-yapf

Ⅳ. 文档说明

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

vim-yapf

.. image:: https://badges.gitter.im/Join%20Chat.svg
:alt: Join the chat at https://gitter.im/mindriot101/vim-yapf
:target: https://gitter.im/mindriot101/vim-yapf?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

ATTENTION: you probably don't need this plugin! See Why you may not need this plugin_.

vim-yapf is a Vim plugin that applies yapf to your current file.
yapf automatically formats Python code, based on improved syntax styles.

Required

• yapf <https://pypi.python.org/pypi/yapf/>_

yapf can be installed either with pip:

::

pip install yapf

or by installing with conda (OSX and linux64 only) with my binstar channel:

::

conda install -c https://conda.binstar.org/srwalker101 yapf

Installation

Either use a plugin manager and add Plug[in] 'mindriot101/vim-yapf' to your vimrc, or use pathogen.

Bindings

The plugin does not create any bindings by default, this is left up to the user. An example could be:

::

:nnoremap <leader>y :call Yapf()<cr>

or

::

:nnoremap <leader>y :Yapf<cr>

Usage

call function

::

:Yapf

with arguments

::

:Yapf --style google

or

::

:call Yapf(" --style pep8")

Customization

The yapf style can be globally set, in your vimrc:

::

let g:yapf_style = "google"

or

::

let g:yapf_style = "pep8"

Why you may not need this plugin

The plugin itself is very simple. It handles user options granted, but at its core it uses ex commands to perform its magic. yapf behaves like a good unix command: it takes text on stdin and spits the altered result to stdout, which is exactly what vim expects.

At its core, this plugin runs the ex command:

::

0,$!yapf

This pipes the range 0,$ i.e. the whole file through a shell command yapf and replaces the range with the altered result.

Instead of installing this plugin, one could add a mapping e.g.:

::

autocmd FileType python nnoremap <leader>y :0,$!yapf<Cr><C-o>

Alternatively yapf can be configured to run on save:

::

autocmd BufWritePre *.py 0,$!yapf

Warning: yapf errors will overwrite your buffer. If you typed :w, you can
type :undo to get your old buffer back. If you typed :ZZ, there is no way
to get your old buffer back. Use this solution <https://gist.github.com/nepsilon/003dd7cfefc20ce1e894db9c94749755>_
to automatically make backups, so you don't lose too many edits.

Alternatively yapf could be set as the formatprg for the python filetype, and reformatting can be performed with the gq{motion}_ operator (e.g. with visual selection) to reformat a part of the file.
Alternatively alternatively yapf could be set as the equalprg:

::

setlocal equalprg=yapf

and reformat the whole file with gg=G or a single line with =.

.. _gq{motion}: https://github.com/vim/vim/blob/b182b40080a23ea1e1ffa28ea03b412174a236bb/runtime/doc/change.txt#L1299