Ticket #14187: bpython-14187.diff

django/core/management/commands/shell.py

@@ -11 +11 @@
 
     requires_model_validation = False
 
+    def ipython(self):
+        import IPython
+        # Explicitly pass an empty list as arguments, because otherwise IPython
+        # would use sys.argv from this script.
+        shell = IPython.Shell.IPShell(argv=[])
+        shell.mainloop()
+
+    def bpython(self):
+        import bpython
+        bpython.embed()
+
+    def smart_shell(self):
+        shells = ('ipython', 'bpython')
+        for shell in shells:
+            try:
+                return getattr(self, shell)()
+            except ImportError:
+                pass
+        raise ImportError
+
     def handle_noargs(self, **options):
         # XXX: (Temporary) workaround for ticket #1796: force early loading of all
         # models from installed apps.
@@ -23 +43 @@
             if use_plain:
                 # Don't bother loading IPython, because the user wants plain Python.
                 raise ImportError
-            import IPython
-            # Explicitly pass an empty list as arguments, because otherwise IPython
-            # would use sys.argv from this script.
-            shell = IPython.Shell.IPShell(argv=[])
-            shell.mainloop()
+            self.smart_shell()
         except ImportError:
             import code
             # Set up a dictionary to serve as the environment for the shell, so

docs/man/django-admin.1

@@ -65 +65 @@
 Starts a lightweight Web server for development.
 .TP
 .BI "shell [" "\-\-plain" "]"
-Runs a Python interactive interpreter. Tries to use IPython, if it's available.
+Runs a Python interactive interpreter. Tries to use IPython or bpython if either is available.
 The
 .BI \-\-plain
-option forces the use of the standard Python interpreter even when IPython is
+option forces the use of the standard Python interpreter even if IPython or bpython is
 installed.
 .TP
 .BI "sql [" "appname ..." "]"
@@ -131 +131 @@
 e.g. "/home/djangoprojects/myproject".
 .TP
 .I \-\-plain
-Use plain Python, not IPython, for the "shell" command.
+Use plain Python, not IPython or bpython, for the "shell" command.
 .TP
 .I \-\-noinput
 Do not prompt the user for input.

docs/ref/django-admin.txt

@@ -623 +623 @@
 
 Starts the Python interactive interpreter.
 
-Django will use IPython_, if it's installed. If you have IPython installed and
-want to force use of the "plain" Python interpreter, use the ``--plain``
-option, like so::
+Django will use IPython_ or bpython_ if either is installed. If you have a
+rich shell installed but want to force use of the "plain" Python interpreter,
+use the ``--plain`` option, like so::
 
     django-admin.py shell --plain
 
 .. _IPython: http://ipython.scipy.org/
+.. _bpython: http://bpython-interpreter.org/
 
 sql <appname appname ...>
 -------------------------