The Sage Command Line

The Sage Read-Eval-Print-Loop (REPL) is based on IPython. In this document, you’ll find how the IPython integration works. You should also be familiar with the documentation for IPython.

For more details about using the Sage command line, see the Sage tutorial.

• Invoking Sage
  • Command-line options for Sage
• Sage startup scripts
  • The sagerc shell script
  • The init.sage script
• Environment variables used by Sage
• Interactively tracing execution of a command
• Extra readline commands
• Sage’s IPython Modifications
  • SageTerminalApp
  • SageInteractiveShell
  • SageTerminalInteractiveShell
  • Interface Shell
• Sage’s IPython Extension
• Installing the Sage IPython Kernel
• The Sage ZMQ Kernel

Preparsing

Sage commands are “preparsed” to valid Python syntax. This allows for example to support the R.<x> = QQ[] syntax.

• The Sage Preparser

Loading and attaching files

Sage or Python files can be loaded (similar to Python’s execfile) in a Sage session. Attaching is similar, except that the attached file is reloaded whenever it is changed.

• Load Python, Sage, Cython, Fortran and Magma files in Sage
• Keep track of attached files

Pretty Printing

In addition to making input nicer, we also modify how results are printed. This again builds on how IPython formats output. Technically, this works using a modified displayhook in Python.

• IPython Displayhook Formatters
• The Sage pretty printer
• Representations of objects.
• Utility functions for pretty-printing

Display Backend Infrastructure

• Display Manager
• Display Preferences
• Output Buffer
• Basic Output Types
• Graphics Output Types
• Three-Dimensional Graphics Output Types
• Catalog of all available output container types.
• Base class for Backends
• Test Backend
• The backend used for doctests
• IPython Backend for the Sage Rich Output System
• SageNB Backend for the Sage Rich Output System

Miscellaneous

• Constructors that automatically inject variables into the global module scope
• HTML Generator for JSmol
• Sage Wrapper for Bitmap Images
• The Sage Input Hook
• Tests for the IPython integration

Indices and Tables

• Index
• Module Index
• Search Page