### Navigation

- index
- modules |
- next |
- previous |
- IPython v0.10.1 documentation »
- The IPython API »

# OInspect

## Module: `OInspect`

Inheritance diagram for `IPython.OInspect`:

Tools for inspecting Python objects.

Uses syntax highlighting for presenting the various information elements.

Similar in spirit to the inspect module, but all calls take a name argument to reference the name under which an object is being read.

## Classes

### `Inspector`

class `IPython.OInspect.``Inspector`(color_table, code_color_table, scheme, str_detail_level=0)
  `__init__`()
  `noinfo`()

    Generic message when no information is found.

  `pdef`()

    Print the definition header for any callable object.

    If the object is a class, print the constructor information.

  `pdoc`()

    Print the docstring for any object.

    Optional: -formatter: a function to run the docstring through for specially formatted docstrings.

  `pfile`()

    Show the whole file where an object was defined.

  `pinfo`()

    Show detailed information about an object.

    Optional arguments:

    - oname: name of the variable pointing to the object.
    - formatter: special formatter for docstrings (see pdoc)
    - info: a structure with some information fields which may have been

    precomputed already.

    - detail_level: if set to 1, more information is given.
  `psearch`()

    Search namespaces with wildcards for objects.

    Arguments:

    - pattern: string containing shell-like wildcards to use in namespace

    searches and optionally a type specification to narrow the search to objects of that type.

    - ns_table: dict of name->namespaces for search.

    Optional arguments:

    > - ns_search: list of namespace names to include in search.
    > - ignore_case(False): make the search case-insensitive.
    > - show_all(False): show all names, including those starting with

    > underscores.

  `psource`()

    Print the source code for an object.

  `set_active_scheme`()

### `myStringIO`

class `IPython.OInspect.``myStringIO`(buf='')

  Bases: `StringIO.StringIO`

  Adds a writeln method to normal StringIO.

  `__init__`()
  `writeln`()

    Does a write() and then a write(‘ ‘)

## Functions

`IPython.OInspect.``getargspec`()

  Get the names and default values of a function’s arguments.

  A tuple of four things is returned: (args, varargs, varkw, defaults). ‘args’ is a list of the argument names (it may contain nested lists). ‘varargs’ and ‘varkw’ are the names of the * and ** arguments or None. ‘defaults’ is an n-tuple of the default values of the last n arguments.

  Modified version of inspect.getargspec from the Python Standard Library.

`IPython.OInspect.``getdoc`()

  Stable wrapper around inspect.getdoc.

  This can’t crash because of attribute problems.

  It also attempts to call a getdoc() method on the given object. This allows objects which provide their docstrings via non-standard mechanisms (like Pyro proxies) to still be inspected by ipython’s ? system.

`IPython.OInspect.``getsource`()

  Wrapper around inspect.getsource.

  This can be modified by other projects to provide customized source extraction.

  Inputs:

  - obj: an object whose source code we will attempt to extract.

  Optional inputs:

  - is_binary: whether the object is known to come from a binary source.

  This implementation will skip returning any output for binary objects, but custom extractors may know how to meaningfully process them.

### Navigation

- index
- modules |
- next |
- previous |
- IPython v0.10.1 documentation »
- The IPython API »