Table of Contents

Django layer

Table of ContentsClose


1. Description

This layer adds support for the Python web framework Django to Spacemacs.

1.1. Features:

  • Test execution directly from emacs
  • Starting/stopping of the Django test server
  • Starting of an interactive Python shell in the current project for debugging
  • Fixed commands to open various Django specific settings files
  • Automatic deployment with Fabric directly from emacs
  • Control of South database migration tool

2. Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add django to the existing dotspacemacs-configuration-layers list in this file.

3. Key bindings

Django related key bindings uses pony-mode and are behind the prefix SPC m j in Python-mode.

3.1. General Managment

Key binding Description
SPC m j m Start a pony-mode managment session

3.2. Fabric

Key binding Description
SPC m j a f Run a fabric command
SPC m j a d Deploy project with fab deploy

3.3. Files

Key binding Description
SPC m j f s Open the for this project
SPC m j f c Interactively display a setting value in the minibuffer
SPC m j f t Jump to template at point
SPC m j f r Jump to the view file that the URL resolves to (experimental)

3.4. Interactive

Key binding Description
SPC m j i d Run interpreter for this project's default database as an inferior process
SPC m j i s Open a Python shell with the current pony project's context loaded.
  If the project has the djangoextras package installed, then use the
  excellent shell_plus command. Otherwise, fall back to shell

3.5. Server

Key binding Description
SPC m j r d Stop the dev server
SPC m j r o Open a tab at the dev server
SPC m j r r Restart the dev server (works better with djangoextras/werkzeug)
SPC m j r u Start or open the dev server
SPC m j r t Open a second server with a "throwaway" host/port

3.6. South/Syncdb

Key binding Description
SPC m j s c Convert an existing app to south
SPC m j s h Create migration for modification
SPC m j s i Run the initial south migration for an app
SPC m j s m Migrate an app
SPC m j s s Run syncdb on the current project

3.7. Test

Key binding Description
SPC m j t d Move down the traceback one level
SPC m j t e Go to the file and line of the last stack trace in a test buffer
SPC m j t o Open the file in a traceback at the line specified
SPC m j t t Run the test(s) given by command
SPC m j t u Move up the traceback one level

Author: root

Created: 2024-04-03 Wed 19:39