88 lines
4.3 KiB
Org Mode
88 lines
4.3 KiB
Org Mode
|
#+TITLE: Python contribution layer for Spacemacs
|
||
|
[[file:img/django.png]]
|
||
|
|
||
|
* Table of Contents :TOC@4:
|
||
|
- [[#description][Description]]
|
||
|
- [[#install][Install]]
|
||
|
- [[#key-bindings][Key Bindings]]
|
||
|
- [[#fabric][Fabric]]
|
||
|
- [[#files][Files]]
|
||
|
- [[#interactive][Interactive]]
|
||
|
- [[#server][Server]]
|
||
|
- [[#southsyncdb][South/Syncdb]]
|
||
|
- [[#test][Test]]
|
||
|
|
||
|
* Description
|
||
|
|
||
|
This layer adds support for the Python [[https://www.djangoproject.com/][Django]] framework via [[https://github.com/davidmiller/pony-mode][pony-mode]].
|
||
|
|
||
|
* Install
|
||
|
|
||
|
To use this contribution add it to your =~/.spacemacs=
|
||
|
|
||
|
#+BEGIN_SRC emacs-lisp
|
||
|
(setq-default dotspacemacs-configuration-layers '(django))
|
||
|
#+END_SRC
|
||
|
|
||
|
* Key Bindings
|
||
|
|
||
|
Django related key bindings uses [[https://github.com/davidmiller/pony-mode][pony-mode]] and are behind the prefix ~SPC m j~.
|
||
|
|
||
|
Configuration options for pony-mode are documented at
|
||
|
[[http://www.deadpansincerity.com/docs/pony/configuration.html][deadpansincerity.com]]
|
||
|
|
||
|
Manage Django with ~SPC m j m~.
|
||
|
|
||
|
** Fabric
|
||
|
|
||
|
| Key Binding | Description |
|
||
|
|---------------+----------------------------------|
|
||
|
| ~SPC m j a f~ | Run a fabric command |
|
||
|
| ~SPC m j a d~ | Deploy project with =fab deploy= |
|
||
|
|
||
|
** Files
|
||
|
|
||
|
| Key Binding | Description |
|
||
|
|---------------+---------------------------------------------------------------|
|
||
|
| ~SPC m j f s~ | Open the =settings.py= 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) |
|
||
|
|
||
|
** 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 django_extras package installed, then use the excellent =shell_plus= command. Otherwise, fall back to =manage.py shell= |
|
||
|
|
||
|
** 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 django_extras/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 |
|
||
|
|
||
|
** 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 |
|
||
|
|
||
|
** 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 |
|