Module Expr Str Import alias ImportFrom alias ImportFrom alias ImportFrom alias alias ImportFrom alias alias ClassDef bases NameLoad body Pass decorator_list ClassDef bases NameLoad body Pass decorator_list ClassDef bases NameLoad body Assign NameStore Call NameLoad NameLoad TupleLoad Dict Assign NameStore NameLoad FunctionDef arguments args NameParam defaults kwarg body Expr Str Assign NameStore Call AttributeLoad NameLoad attr Str NameLoad If CompareIsNot NameLoad NameLoad body Assign AttributeStore NameLoad attr NameLoad Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr NameLoad Assign AttributeStore NameLoad attr Call AttributeLoad AttributeLoad NameLoad attr attr decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults body Expr Str Assign NameStore Call AttributeLoad NameLoad attr keyword NameLoad Assign NameStore ListComp AttributeLoad NameLoad attr comprehension NameStore Call NameLoad AttributeLoad AttributeLoad NameLoad attr attr BoolOpAnd Call NameLoad NameLoad NameLoad Call NameLoad AttributeLoad NameLoad attr NameLoad For NameStore NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Assign NameStore SubscriptLoad NameLoad Index NameLoad For TupleStore NameStore NameStore Call AttributeLoad NameLoad attr body If BoolOpAnd CompareEq Call AttributeLoad SubscriptLoad NameLoad Index Num attr SubscriptLoad NameLoad Index Num UnaryOpNot Call AttributeLoad NameLoad attr Str body Raise Call NameLoad BinOpMod Str TupleLoad AttributeLoad AttributeLoad NameLoad attr attr NameLoad TryExcept body Assign NameStore SubscriptLoad NameLoad Index NameLoad handlers ExceptHandler type NameLoad body Pass orelse Expr Call NameLoad NameLoad NameLoad Call NameLoad NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad NameLoad attr keyword NameLoad Assign NameStore ListLoad Expr Call AttributeLoad NameLoad attr BinOpMod Str AttributeLoad NameLoad attr Expr Call AttributeLoad NameLoad attr BinOpMult Call NameLoad SubscriptLoad NameLoad Index Num Str For TupleStore NameStore NameStore Call AttributeLoad Call AttributeLoad NameLoad attr keyword NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr NameLoad Expr Call AttributeLoad NameLoad attr NameLoad Return Call AttributeLoad Str attr NameLoad decorator_list NameLoad FunctionDef arguments args NameParam NameParam defaults body Expr Str Assign NameStore ListLoad Assign NameStore BinOpMod Str TupleLoad AttributeLoad NameLoad attr AttributeLoad NameLoad attr AttributeLoad AttributeLoad NameLoad attr attr Expr Call AttributeLoad NameLoad attr NameLoad TryExcept body Assign NameStore Call NameLoad Call AttributeLoad NameLoad attr handlers ExceptHandler type NameLoad body Assign NameStore NameLoad If CompareIsNot NameLoad NameLoad body If CompareGt Call NameLoad NameLoad Num body Assign NameStore BinOpAdd SubscriptLoad NameLoad Slice Num Str Expr Call AttributeLoad NameLoad attr Call NameLoad BinOpMod Str NameLoad Num If CompareIn Str AttributeLoad AttributeLoad NameLoad attr attr body Expr Call AttributeLoad NameLoad attr Call NameLoad BinOpMod Str TupleLoad AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad NameLoad attr Str If CompareIsNot NameLoad NameLoad body Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Num Expr Call AttributeLoad NameLoad attr Call NameLoad NameLoad Num Return Call AttributeLoad Str attr NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Print Call AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Num Return BinOpAdd Str Call AttributeLoad NameLoad attr Str Str decorator_list Assign NameStore BinOpAdd Str BinOpMult Str Num Assign NameStore BinOpMod Str AttributeLoad NameLoad attr Assign NameStore ListLoad NameLoad NameLoad NameLoad Str Assign NameStore Call AttributeLoad Call AttributeLoad NameLoad attr attr Str If NameLoad body Assign NameStore AttributeLoad NameLoad attr orelse Assign NameStore Call NameLoad NameLoad Str Str If NameLoad body Expr Call AttributeLoad NameLoad attr Call NameLoad NameLoad Expr Call AttributeLoad NameLoad attr Str Assign NameStore ListLoad For NameStore Call AttributeLoad NameLoad attr body If BoolOpAnd Call NameLoad NameLoad NameLoad UnaryOpNot CompareIn NameLoad TupleLoad NameLoad NameLoad NameLoad body Expr Call AttributeLoad NameLoad attr NameLoad If NameLoad body Assign NameStore Call AttributeLoad Str attr ListComp AttributeLoad NameLoad attr comprehension NameStore NameLoad Expr Call AttributeLoad NameLoad attr Call NameLoad BinOpMod Str TupleLoad AttributeLoad NameLoad attr NameLoad Expr Call AttributeLoad NameLoad attr Str For TupleStore NameStore NameStore Call AttributeLoad Call AttributeLoad NameLoad attr keyword NameLoad attr body Assign NameStore BoolOpOr Call AttributeLoad NameLoad attr Str Str Expr Call AttributeLoad NameLoad attr Call NameLoad NameLoad Expr Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad AttributeLoad NameLoad attr NameLoad Call AttributeLoad NameLoad attr Expr Call AttributeLoad NameLoad attr Str Return Call AttributeLoad Str attr NameLoad decorator_list NameLoad decorator_list ClassDef bases NameLoad body Expr Str Assign NameStore NameLoad FunctionDef arguments args NameParam defaults body Expr Str For NameStore Call AttributeLoad NameLoad attr body If BoolOpAnd Call NameLoad NameLoad NameLoad Call NameLoad NameLoad NameLoad CompareNotEq NameLoad NameLoad body Expr Yield NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str If UnaryOpNot Call AttributeLoad NameLoad attr body Return For NameStore Call AttributeLoad NameLoad attr body If Call NameLoad AttributeLoad NameLoad attr NameLoad body Assign AttributeStore NameLoad attr NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults vararg kwarg body Expr Str If CompareIs AttributeLoad NameLoad attr NameLoad body Assign NameStore Call NameLoad NameLoad NameLoad For NameStore Call AttributeLoad NameLoad attr body Assign AttributeStore NameLoad attr NameLoad If Call NameLoad AttributeLoad NameLoad attr NameLoad body Return AttributeLoad NameLoad attr orelse Raise Call NameLoad BinOpMod Str AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return BoolOpAnd Call NameLoad NameLoad Str CompareIsNot AttributeLoad NameLoad attr NameLoad decorator_list NameLoad decorator_list ClassDef bases NameLoad body Expr Str Assign NameStore Call NameLoad Str FunctionDef arguments args NameParam defaults body ImportFrom alias Return AttributeLoad Call AttributeLoad NameLoad attr attr decorator_list decorator_list
N/A N/A 
A base class for objects that are configurable.

Authors:

* Brian Granger
* Fernando Perez
* Min RK
 N/A datetime copy deepcopy loader Config IPython.utils.traitlets HasTraits Instance IPython.utils.text indent wrap_paragraphs ConfigurableError N/A Exception N/A N/A N/A MultipleInstanceError N/A ConfigurableError N/A N/A N/A Configurable N/A HasTraits N/A N/A config N/A Instance Config N/A N/A N/A created None __init__ N/A N/A self N/A kwargs N/A N/A Create a configurable given a config config.

        Parameters
        ----------
        config : Config
            If this is empty, default values are used. If config is a 
            :class:`Config` instance, it will be used to configure the
            instance.
        
        Notes
        -----
        Subclasses of Configurable must call the :meth:`__init__` method of
        :class:`Configurable` *before* doing anything else and using 
        :func:`super`::
        
            class MyConfigurable(Configurable):
                def __init__(self, config=None):
                    super(MyConfigurable, self).__init__(config)
                    # Then any other code you need to finish initialization.

        This ensures that instances will be configured properly.
         N/A config N/A N/A kwargs pop config None N/A N/A config None N/A N/A N/A self config config N/A N/A N/A N/A super Configurable self __init__ kwargs N/A N/A self created N/A N/A N/A datetime datetime now N/A _config_changed N/A N/A self name old new N/A N/A N/A Update all the class traits having ``config=True`` as metadata.

        For any class trait with a ``config`` metadata attribute that is
        ``True``, we update the trait with the value of the corresponding
        config entry.
         N/A traits N/A N/A self traits config True N/A section_names N/A N/A cls __name__ N/A cls N/A reversed N/A N/A self __class__ __mro__ N/A N/A issubclass cls Configurable N/A issubclass N/A self __class__ cls N/A sname section_names N/A N/A N/A N/A new _has_section sname N/A N/A my_config N/A new N/A sname N/A N/A k v N/A N/A traits items N/A N/A N/A N/A N/A N/A N/A k N/A 0 upper N/A k N/A 0 N/A N/A N/A k startswith _ N/A N/A N/A ConfigurableError N/A Configurable traitlets with config=True must start with a lowercase so they are not confused with Config subsections: %s.%s N/A N/A N/A self __class__ __name__ k N/A N/A N/A config_value N/A my_config N/A k N/A N/A N/A KeyError N/A N/A N/A N/A N/A setattr self k N/A deepcopy config_value N/A class_get_help N/A N/A cls N/A N/A N/A Get the help string for this class in ReST format. N/A cls_traits N/A N/A cls class_traits config True N/A final_help N/A N/A N/A N/A final_help append N/A %s options N/A cls __name__ N/A N/A N/A final_help append N/A N/A len N/A final_help N/A 0 - N/A N/A k v N/A N/A N/A N/A cls class_traits config True items N/A N/A help N/A N/A cls class_get_trait_help v N/A N/A N/A final_help append help N/A N/A N/A join final_help N/A classmethod class_get_trait_help N/A N/A cls trait N/A N/A N/A Get the help string for a single trait. N/A lines N/A N/A header N/A --%s.%s=<%s> N/A N/A cls __name__ N/A trait name N/A N/A trait __class__ __name__ N/A N/A N/A lines append header N/A N/A N/A dvr N/A repr N/A N/A trait get_default_value N/A N/A N/A Exception N/A N/A dvr None N/A N/A dvr None N/A N/A N/A N/A len dvr 64 N/A N/A dvr N/A N/A dvr N/A 61 ... N/A N/A N/A lines append N/A indent N/A Default: %s dvr 4 N/A N/A Enum N/A N/A trait __class__ __name__ N/A N/A N/A N/A lines append N/A indent N/A Choices: %r N/A N/A trait values N/A help N/A N/A trait get_metadata help N/A N/A help None N/A N/A help N/A N/A join N/A wrap_paragraphs help 76 N/A N/A N/A lines append N/A indent help 4 N/A N/A N/A join lines N/A classmethod class_print_help N/A N/A cls N/A N/A N/A Get the help string for a single trait and print it. N/A N/A N/A cls class_get_help N/A classmethod class_config_section N/A N/A cls N/A N/A N/A Get the config class config section c N/A N/A s N/A N/A N/A return a commented, wrapped block. N/A s N/A N/A join N/A wrap_paragraphs s 78 N/A N/A #  N/A N/A s replace 
#  N/A N/A breaker N/A # N/A - 78 N/A s N/A # %s configuration N/A cls __name__ N/A lines N/A breaker s breaker N/A desc N/A N/A N/A N/A cls class_traits get description N/A desc N/A N/A desc N/A desc default_value N/A N/A desc N/A getattr cls __doc__ N/A desc N/A N/A N/A N/A lines append N/A c desc N/A N/A N/A lines append N/A parents N/A N/A parent N/A N/A cls mro N/A N/A N/A N/A issubclass parent Configurable N/A N/A parent N/A Configurable SingletonConfigurable cls N/A N/A N/A N/A parents append parent N/A parents N/A N/A pstr N/A N/A ,  join N/A N/A p __name__ N/A p parents N/A N/A N/A lines append N/A c N/A %s will inherit config from: %s N/A N/A cls __name__ pstr N/A N/A N/A lines append N/A N/A name trait N/A N/A N/A N/A cls class_traits config True items N/A N/A help N/A N/A N/A trait get_metadata help N/A N/A N/A lines append N/A c help N/A N/A N/A lines append N/A # c.%s.%s = %r N/A N/A cls __name__ name N/A N/A trait get_default_value N/A N/A N/A lines append N/A N/A N/A join lines N/A classmethod N/A SingletonConfigurable N/A Configurable N/A N/A A configurable that only allows one instance.

    This class is for classes that should only have one instance of itself
    or *any* subclass. To create and retrieve such a class use the
    :meth:`SingletonConfigurable.instance` method.
     N/A _instance None _walk_mro N/A N/A cls N/A N/A N/A Walk the cls.mro() for parent classes that are also singletons
        
        For use in instance()
         N/A subclass N/A N/A cls mro N/A N/A N/A N/A issubclass cls subclass N/A issubclass subclass SingletonConfigurable N/A subclass SingletonConfigurable N/A N/A N/A subclass N/A classmethod clear_instance N/A N/A cls N/A N/A N/A unset _instance for this class and singleton parents.
         N/A N/A N/A N/A cls initialized N/A N/A N/A subclass N/A N/A cls _walk_mro N/A N/A N/A isinstance N/A subclass _instance cls N/A N/A N/A subclass _instance None N/A classmethod instance N/A N/A cls N/A args kwargs N/A N/A Returns a global instance of this class.

        This method create a new instance if none have previously been created
        and returns a previously created instance is one already exists.

        The arguments and keyword arguments passed to this method are passed
        on to the :meth:`__init__` method of the class upon instantiation.

        Examples
        --------

        Create a singleton class using instance, and retrieve it::

            >>> from IPython.config.configurable import SingletonConfigurable
            >>> class Foo(SingletonConfigurable): pass
            >>> foo = Foo.instance()
            >>> foo == Foo.instance()
            True

        Create a subclass that is retrived using the base class instance::

            >>> class Bar(SingletonConfigurable): pass
            >>> class Bam(Bar): pass
            >>> bam = Bam.instance()
            >>> bam == Bar.instance()
            True
         N/A N/A N/A cls _instance None N/A N/A inst N/A cls args kwargs N/A subclass N/A N/A cls _walk_mro N/A N/A N/A subclass _instance inst N/A N/A isinstance N/A cls _instance cls N/A N/A N/A cls _instance N/A N/A N/A MultipleInstanceError N/A Multiple incompatible subclass instances of %s are being created. N/A cls __name__ N/A classmethod initialized N/A N/A cls N/A N/A N/A Has an instance been created? N/A N/A N/A hasattr cls _instance N/A N/A cls _instance None N/A classmethod N/A LoggingConfigurable N/A Configurable N/A N/A A parent class for Configurables that log.
    
    Subclasses have a log trait, and the default behavior
    is to get the logger from the currently running Application
    via Application.instance().log.
     N/A log N/A Instance logging.Logger _log_default N/A N/A self N/A N/A IPython.config.application Application N/A N/A N/A N/A Application instance log N/A N/A