| 1 | = python-django.el = |
| 2 | |
| 3 | '''Status: actively maintained.''' |
| 4 | |
| 5 | '''Quick intro''': |
| 6 | http://from-the-cloud.com/en/emacs/2013/01/28_emacs-as-a-django-ide-with-python-djangoel.html |
| 7 | |
| 8 | Django project management package with the goodies you would |
| 9 | expect and then some. The project buffer workings is pretty much |
| 10 | inspired by the good ol' `magit-status` buffer. |
| 11 | |
| 12 | https://github.com/fgallina/python-django.el |
| 13 | |
| 14 | '''Note:''' This package relies heavily in fgallina's python.el |
| 15 | available in stock Emacs>=24.3 (or |
| 16 | https://github.com/fgallina/python.el). |
| 17 | |
| 18 | [[Image(https://code.djangoproject.com/attachment/wiki/Emacs/python-django-menu.png?format=raw)]] |
| 19 | |
| 20 | '''File navigation:''' After opening a project, a directory tree |
| 21 | for each installed app, the STATIC_ROOT, the MEDIA_ROOT and each |
| 22 | TEMPLATE_DIRS is created. Several commands are provided to work |
| 23 | with the current directory at point. |
| 24 | |
| 25 | '''Etags building:''' Provides a simple wrapper to create etags |
| 26 | for current opened project. |
| 27 | |
| 28 | '''Grep in project:''' Provides a simple way to grep relevant |
| 29 | project directories using `rgrep`. You can override the use of |
| 30 | `rgrep` by tweaking the `python-django-cmd-grep-function`. |
| 31 | |
| 32 | '''Quick jump:''' fast key bindings to jump to the settings |
| 33 | module, the project root, the current virtualenv and Django |
| 34 | official web docs are provided. |
| 35 | |
| 36 | '''Management commands:''' You can run any management command |
| 37 | from the project buffer via `python-django-mgmt-run-command` or |
| 38 | via the quick management commands accesible from the Django menu. |
| 39 | Completion is provided for all arguments and you can cycle |
| 40 | through opened management command process buffers very easily. |
| 41 | Another cool feature is that comint processes are spiced up with |
| 42 | special processing, for instance if are using runserver and get a |
| 43 | breakpoint via pdb or ipdb the pdb-tracking provided by |
| 44 | `python-mode` will trigger or if you enter dbshell the proper |
| 45 | `sql-mode` will be used. |
| 46 | |
| 47 | '''Quick management commands:''' This mode provides quick |
| 48 | management commands (management commands with sane defaults, |
| 49 | smart prompt completion and process extra processing) defined to |
| 50 | work with the most used Django built-in management commands like |
| 51 | syncdb, shell, runserver, test; several good ones from |
| 52 | django-extensions like shell_plus, clean_pyc; and south ones |
| 53 | like convert_to_south, migrate, schemamigration. You can define |
| 54 | new quick commands via the `python-django-qmgmt-define` and |
| 55 | define ways to handle when it's finished by defining a callback |
| 56 | function. |
| 57 | |