spacemacs/contrib/lang/python

Python contribution layer for Spacemacs

Table of Contents

• Python contribution layer for Spacemacs
  • Description
  • Install
  • Key Bindings
    • Inferior REPL process
    • Testing in Python
    • Other Python commands

Description

This layer adds support for the Python language.

Features:

• Auto-completion using anaconda-mode
• Code Navigation using anaconda-mode
• Documentation Lookup using anaconda-mode and pylookup
• Test Runner using nose.el
• Virtual Environment using pyvenv
• semantic mode is enabled

Install

To use this contribution add it to your ~/.spacemacs

(setq-default dotspacemacs-configuration-layers '(python)
  "List of contribution to load."
)

Key Bindings

Inferior REPL process

Start an (i)Python inferior REPL process with <SPC> m i. If ipython is available in system executable search paths, ipython will be used to launch python shell; otherwise, default python interpreter will be used. You may change your system executable search path by activating a virtual environment.

Send code to inferior process commands:

Key Binding   |                 Description

------------------|------------------------------------------------------------ <SPC> m b | send buffer and keep code buffer focused <SPC> m B | send buffer and switch to REPL in insert mode <SPC> m f | send function and keep code buffer focused <SPC> m F | send function and switch to REPL in insert mode <SPC> m r | send region and keep code buffer focused <SPC> m R | send region and switch to REPL in insert mode CTRL+j | next item in REPL history CTRL+k | previous item in REPL history

Testing in Python

Spacemacs uses nose as a test runner. An improved version of nose.el is shipped with Spacemacs, this version adds:

• windows support
• test suite support

The root of the project is detected with a .git directory or a setup.cfg file.

Test commands (start with m t or m T):

No Debug      |                 Description

------------------|------------------------------------------------------------ m t a | launch all tests of the project m t b | launch all tests of the current buffer (same as module) m t m | launch all tests of the current module m t s | launch all tests of the current suite m t t | launch the current test (function)

 Debug        |                 Description

------------------|------------------------------------------------------------ m T a | launch all tests of the project in debug mode m T b | launch all tests of the current buffer (module) in debug mode m T m | launch all tests of the current module in debug mode m T s | launch all tests of the current suite in debug mode m T t | launch the current test (function) in debug mode

Other Python commands

Key Binding   |                 Description

------------------|------------------------------------------------------------ <SPC> m d | quick documentation using anaconda <SPC> m D | open documentation in firefox using pylookup <SPC> m g | go to definition using anaconda-mode-goto (C-o to jump back) <SPC> m t b | toggle a breakpoint <SPC> m v | activate a virtual environment with pyvenv