Inheritance diagram for IPython.config.application:
A base class for a configurable application.
Authors:
Bases: IPython.config.configurable.SingletonConfigurable
A singleton application with full configuration support.
An instance of a Python dict.
Get the config class config section
Get the help string for this class in ReST format.
If inst is given, it’s current trait values will be used in place of class defaults.
Get the help string for a single trait.
If inst is given, it’s current trait values will be used in place of the class default.
Get the help string for a single trait and print it.
Get a list of all the names of this classes traits.
This method is just like the trait_names() method, but is unbound.
Get a list of all the traits of this class.
This method is just like the traits() method, but is unbound.
The TraitTypes returned don’t know anything about the values that the various HasTrait’s instances are holding.
This follows the same algorithm as traits does and does not allow for any simple way of specifying merely that a metadata name exists, but has any value. This is because get_metadata returns None if a metadata key doesn’t exist.
An instance of a Python list.
unset _instance for this class and singleton parents.
A trait whose value must be an instance of a specified class.
The value can also be an instance of a subclass of the specified class.
A trait for unicode strings.
A trait for unicode strings.
An instance of a Python list.
An instance of a Python dict.
flatten flags and aliases, so cl-args override as expected.
This prevents issues such as an alias pointing to InteractiveShell, but a config file setting the same trait in TerminalInteraciveShell getting inappropriate priority over the command-line arg.
Only aliases with exactly one descendent in the class list will be promoted.
generate default config file from Configurables
Start logging for this application.
The default is to log to stdout using a StreaHandler. The log level starts at loggin.WARN, but this can be adjusted by setting the log_level attribute.
Do the basic steps to configure me.
Override in subclasses.
Initialize a subcommand with argv.
Has an instance been created?
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 __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
A trait for unicode strings.
Load a .py based config file by filename and path.
An enum that whose value must be in a given sequence.
A trait for unicode strings.
Setup a handler to be called when a trait changes.
This is used to setup dynamic notifications of trait changes.
Static handlers can be created by creating methods on a HasTraits subclass with the naming convention ‘_[traitname]_changed’. Thus, to create static handler for the trait ‘a’, create the method _a_changed(self, name, old, new) (fewer arguments can be used, see below).
Parameters : | handler : callable
name : list, str, None
remove : bool
|
---|
A trait for unicode strings.
Parse the command line arguments.
Print the alias part of the help.
Print the application description.
Print usage and examples.
This usage string goes at the end of the command line help string and should contain examples of the application’s usage.
Print the flag part of the help.
Print the help for each Configurable class in self.classes.
If classes=False (the default), only flags and aliases are printed.
Print the subcommand part of the help.
Print the version string.
Start the app mainloop.
Override in subclasses.
A trait whose value must be an instance of a specified class.
The value can also be an instance of a subclass of the specified class.
A trait for unicode strings.
An instance of a Python dict.
Get metadata values for trait by key.
Get a list of all the names of this classes traits.
Get a list of all the traits of this class.
The TraitTypes returned don’t know anything about the values that the various HasTrait’s instances are holding.
This follows the same algorithm as traits does and does not allow for any simple way of specifying merely that a metadata name exists, but has any value. This is because get_metadata returns None if a metadata key doesn’t exist.
Fire the traits events when the config is updated.
A trait for unicode strings.
Helper for building basic –trait, –no-trait flags.
Parameters : | name : str
configurable : str
set_help : unicode
unset_help : unicode
|
---|---|
Returns : | cfg : dict
|
Method decorator for catching invalid config (Trait/ArgumentErrors) during init.
On a TraitError (generally caused by bad config), this will print the trait’s message, and exit the app.
For use on init methods, to prevent invoking excepthook on invalid input.