Repository files navigation

<p align="center">

<img width="150" height="150" src="https://vignette.wikia.nocookie.net/sqmegapolis/images/4/42/Warning-2-256.png/revision/latest?cb=20130403220740">

</p>

*Important*: From 2017-11-19 onwards python-mode uses submodules instead ofhard coding 3rd party libraries into its codebase. Please issue the command:git submodule update --init --recursiveinside your python-mode folder.

If you are a new user please clone the repos using the recursive flag:git clone --recursivehttps://github.com/python-mode/python-mode

For clean and straightforward install instructions, please visit:https://github.com/python-mode/python-mode#how-to-install

The project needs contributors

Python-mode is a vim plugin that helps you to create python code very quicklyby utilizing libraries includingpylint,rope,pydoc,pyflakes,pep8,autopep8,pep257 andmccabefor features like static analysis, refactoring, folding, completion,documentation, and more.

The plugin contains all you need to develop python applications in Vim.

There is no need to installpylint,ropeor any otherPython Libraries on your system.

• Support Python version 2.6+ and 3.2+
• Syntax highlighting
• Virtualenv support
• Run python code (<leader>r)
• Add/remove breakpoints (<leader>b)
• Improved Python indentation
• Python folding
• Python motions and operators (]],3[[,]]M,vaC,viM,daC,ciM, ...)
• Code checking (pylint,pyflakes,pylama, ...) that can be runsimultaneously (:PymodeLint)
• Autofix PEP8 errors (:PymodeLintAuto)
• Search in python documentation (K)
• Code refactoring <rope refactoring library> (rope)
• Strong code completion (rope)
• Go to definition (<C-c>g for :RopeGotoDefinition)
• And more, more ...

See (very old) screencast here:http://www.youtube.com/watch?v=67OZNp9Z0CQ(sorry for quality, this is my first screencast) Another old presentation here:http://www.youtube.com/watch?v=YhqsjUUHj6g

To read python-mode documentation in Vim, see:help pymode

• VIM >= 7.3 (mostly features needed +python or +python3 support)(also--with-features=big if you wantg:pymode_lint_signs)

% cd ~/.vim% mkdir -p bundle && cd bundle% git clone https://github.com/python-mode/python-mode.git

• Enablepathogenin your~/.vimrc:

  " Pathogen loadfiletype offcall pathogen#infect()call pathogen#helptags()filetype plugin indent onsyntax on

% git clone https://github.com/python-mode/python-mode.git% cd python-mode% cp -R * ~/.vim

Then rebuildhelptags in vim:

:helptags ~/.vim/doc/

|Repository URL:https://klen.github.io/python-mode/deb/

Install with commands:

add-apt-repository https://klen.github.io/python-mode/deb mainapt-get updateapt-get install vim-python-mode

If you are getting the message: "The following signatures couldn't be verified because the public key is not available":

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys B5DF65307000E266

vim-python-mode using vim-addons, so after installation just enablepython-mode with command:

vim-addons install python-mode

If your python-mode doesn't work:

1. Load Vim with only python-mode enabled (use debug.vim from pymode):

   vim -u <path_to_pymode>/debug.vim

And try to repeat your case. If no error occurs, seems like problem isn't in theplugin.

2. Type :PymodeTroubleshooting

And fix any warnings or copy the output and send it to me. (For example, bycreating anew github issueif one does not already exist for the problem).

You can override the default key bindings by redefining them in your .vimrc, for example:

" Override go-to.definition key shortcut to Ctrl-]let g:pymode_rope_goto_definition_bind = "<C-]>"" Override run current python file key shortcut to Ctrl-Shift-elet g:pymode_run_bind = "<C-S-e>"" Override view python doc key shortcut to Ctrl-Shift-dlet g:pymode_doc_bind = "<C-S-d>"

Read this section before opening an issue on the tracker.

By default python-mode uses python 2 syntax checking. To enable python 3syntax checking (e.g. for async) add:

let g:pymode_python = 'python3'

To your vimrc or exrc file

Documentation is available in your vim:help pymode

If you have any suggestions, bug reports orannoyances please report them to the issue trackerathttps://github.com/python-mode/python-mode/issues

• Kirill Klenov (horneds@gmail.com)
• Bryce Guinta (https://github.com/brycepg)

Also see the AUTHORS file.

Development of python-mode happens at github:https://github.com/python-mode/python-mode

Please make a pull request to development branch and add yourself toAUTHORS.

• doc/pymode.txt--:help pymode
• plugin/pymode.vim-- python-mode VIM plugin
• syntax/python.vim-- python-modepython.vim VIM syntax
• syntax/pyrex.vim--pyrex.vim VIM syntax (pyrex, Cython)
• t/--*.vim more python-mode VIM configuration
• pymode/--*.py -- python-mode Python module
• pymode/libs/--*.py --Python Libraries

Vendored Python modules are locatedmostly inpymode/libs/.

Vendored Vim modules are located mostly int/.

Copyright © 2013-2015 Kirill Klenov (klen)

Licensed under aGNU lesser general public license.

If you like this plugin, I would very appreciated if you kindly send me a postcard :)My address is here: "Russia, 143500, MO, Istra, pos. Severny 8-3" to "Kirill Klenov".Thanks for support!