Sets metadata and returns self. This allows convenient metadata tagging when initializing the trait, such as: Examples -----

Append an item to a List

Raise a TraitError Parameters ---------- obj : HasTraits or None The instance which owns the trait. If not

Load a config from somewhere, return a :class:`Config` instance. Usually, this will cause self.config to be set and then returned. Ho

Parse the command line arguments.

merge another config object into this one

Like warnings.warn(), but category and stacklevel are required. You pretty much never want the default stacklevel of 1, so this helps encoura

Update either a set or dict

DEPRECATED: Setup a handler to be called when a trait changes. This is used to setup dynamic notifications of trait changes. Static

Extend a list

Run a test of trait.from_string

Mostly borrowed from argcomplete's unit tests Modified to take an application instead of an ArgumentParser Command is the current co

Returns a global instance of this class. This method create a new instance if none have previously been created and returns a previou

Get a ``dict`` of all the traits of this class. The dictionary is keyed on the name and the values are the TraitType objects. The Tr

r"""Context for use in testing to catch known warnings matching regexes Parameters ---------- matching : list of strings or compiled rege

Setup a handler to be called when a trait changes. This is used to setup dynamic notifications of trait changes. Parameters

Load config files by filename and path.

Get a ``dict`` of all the traits of this class. The dictionary is keyed on the name and the values are the TraitType objects. This m

unset _instance for this class and singleton parents.

Returns a description of the trait.

Has an instance been created?

Launch a global instance of this Application If a global instance already exists, this reinitializes and starts it

Get the help string for this class in ReST format. If `inst` is given, its current trait values will be used in place of class defaul

Get metadata values for trait by key.

Update config and load the new values

Returns a string of the value's type with an indefinite article. For example 'an Image' or 'a PlotValue'.

Return string that describes a value Parameters ---------- article : str or None A definite or indefinite article. If the article

Remove a trait change handler. This is used to unregister handlers to trait change notifications. Parameters ----------

Iterate through configurable classes, including configurable parents :param classes: The list of classes to iterate; if not set,

Yields only classes with configurable traits, and their subclasses. :param classes: The list of classes to iterate; if n

Check for collisions between two config objects. Returns a dict of the form {"Class": {"trait": "collision message"}}`, indicating wh

Import and return ``bar`` given the string ``foo.bar``. Calling ``bar = import_item("foo.bar")`` is the functional equivalent of executing th

Returns whether the given value is an instance or subclass of TraitType.

Context manager for bundling trait change notifications and cross validation. Use this when doing multiple trait assignments (init, c

like list.extend, but for the front

Get a list of all the names of this class' traits.

Wrap multiple paragraphs to fit a specified width. This is equivalent to textwrap.wrap, but with support for multiple paragraphs, as separate

Is a Config key a section name (does it start with a capital)?

Get the config section for this class. Parameters ---------- classes : list, optional The list of other classes i

Returns True if the object has a trait with the specified name.

Return a string representation of a value and its type for readable error messages.

Resolve a string supplied for a type into an actual object.

default transform: no-op

Validate that a number to be applied to a trait is between bounds. If value is not between min_bound and max_bound, this raises a TraitE

Returns the string with a prepended article. The input does not need to begin with a character. Parameters ---------- name : str

Grab the global logger instance. If a global Application is instantiated, grab its logger. Otherwise, grab the root logger.

Get stdout, stderr, and exit code from running a command

Load the config from a file and return it as a Config object.

Returns True if the specified trait has a value. This will return false even if ``getattr`` would return a dynamically generated defa

Returns a description of the trait choices (not none).

load traits from a Config object

Safely evaluate an expression Returns original string if eval fails. Use only where types are ambiguous.

Add an item to a set

Show deprecation warning about a magic method definition. Uses warn_explicit to bind warning to method definition instead of triggering code,

Yield the lines for alias part of the help.

Return the base logging configuration. The default is to log to stderr using a StreamHandler, if no default handler already exists.

Match the word to be completed against our Configurable classes Check if cword_prefix could potentially match against --{class}. for any clas

Notify observers of a change event

return section names as a list