IPython Documentation

Table Of Contents

Previous topic


Next topic


This Page


Module: core.splitinput

Inheritance diagram for IPython.core.splitinput:

Simple utility for splitting user input. This is used by both inputsplitter and prefilter.


  • Brian Granger
  • Fernando Perez


class IPython.core.splitinput.LineInfo(line, continue_prompt=False)

Bases: object

A single line of input and associated info.

Includes the following as properties:

The original, raw line
Is this line a continuation in a sequence of multiline input?
Any leading whitespace.
The escape character(s) in pre or the empty string if there isn’t one. Note that ‘!!’ and ‘??’ are possible values for esc. Otherwise it will always be a single character.
The ‘function part’, which is basically the maximal initial sequence of valid python identifiers and the ‘.’ character. This is what is checked for alias and magic transformations, used for auto-calling, etc. In contrast to Python identifiers, it may start with “%” and contain “*”.
Everything else on the line.
__init__(line, continue_prompt=False)

Do a full, attribute-walking lookup of the ifun in the various namespaces for the given IPython InteractiveShell instance.

Return a dict with keys: found,obj,ospace,ismagic

Note: can cause state changes because of calling getattr, but should only be run if autocall is on and if the line hasn’t matched any other, less dangerous handlers.

Does cache the results of the call, so can be called multiple times without worrying about further damaging state.

IPython.core.splitinput.split_user_input(line, pattern=None)

Split user input into initial whitespace, escape character, function part and the rest.