Forcibly sets trait attribute, including read-only attributes.

Try to find the file by searching the paths.

Return default generator for a given trait Walk the MRO to resolve the correct default generator according to inheritance.

Returns a description of the trait.

Returns a description of the trait.

Returns a description of the trait.

Returns a description of the trait.

Notify observers of any event

Validate arguments for traitlet link functions

Walk the cls.mro() for parent classes that are also singletons For use in instance()

Dynamically add trait attributes to the HasTraits instance.

Generate rST documentation for this class' config options. Excludes traits defined on parent classes.

Get the helptext string for a single trait. :param inst: If given, its current trait values will be used in place of

Get a dict of all the traitlets defined on this class, not a parent. Works like `class_traits`, except for excluding traits from parents.

Yield lines with the application description.

Yield lines with the usage and examples. This usage string goes at the end of the command line help string and should contain example

Yield the lines for the flag part of the help.

Yield the lines for the options part of the help.

Yield the lines for the subcommand part of the help.

generate default config file from Configurables

Get the config object for the global Application instance, if there is one otherwise return an empty config object

DEPRECATED: Get a metadata value. Use .metadata[key] or .metadata.get(key, default) instead.

A safe version of inspect.getmembers that handles missing attributes. This is useful when there are descriptor based attributes that for some

Do the basic steps to configure me. Override in subclasses.

Add dummy arguments to our ArgumentParser for the traits of this class The argparse-based loader currently does not actually add any class tr

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

Convert the name argument to a list of names. Examples -------- >>> parse_notifier_name([]) [traitlets.All] >>> parse_notifier_na

Selects enum-value by using its number-constant.

DEPRECATED: Set a metadata key/value. Use .metadata[key] = value instead.

Add our own checks for too many deprecation warnings. Limit to once per package.

If argcomplete is enabled, allow triggering command-line autocompletion

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

self.parsed_data->self.config

Equivalent of textwrap.dedent that ignores unindented first line.

Get the class that defines a trait For reducing redundant help output in config files. Returns the current class if: - the tr

ensure that sub-dicts that should be Config objects are casts dicts that are under section keys to Config objects, which is necessary

execute self.config.<lhs> = <rhs> * expands ~ with expanduser * interprets value with trait if available

extract my config from a global Config object will construct a Config object of only the config values that apply to me based on my m

Get default argument value, given the trait default value.

Get `sys.argv` or equivalent from `argcomplete` `argcomplete`'s strategy is to call the python script with no arguments, so ``len(sys

Helper for `argcomplete` to recognize `traitlets` subcommands `argcomplete` does not know that `traitlets` has already consumed subcommands,

Handling for unrecognized alias arguments Probably a mistyped alias. By default just log a warning, but users can override this to ra

Load config files (py,json) by filename and path. yield each config object in turn.

update self.config from a flag, which can be a dict or Config

self.parser->self.parsed_data

Load the config file into self.config, with recursive loading.

Setup a handler to be called when a trait should be cross validated. This is used to setup dynamic notifications for cross-validation.

Context for use in testing to ensure that all warnings are raised. Examples -------- >>> import warnings >>> def foo(): ...

test that `python -m PKG --help-all` works

test that `python -m PKG [subcommand] -h` works

Generate rST documentation for this class' config options. Excludes traits defined on parent classes.

Get a list of all the names of this class' traits. This method is just like the :meth:`trait_names` method, but is unbound.

Generate rST format documentation for the config options this application Returns a multiline string.

Yield the help-lines for each Configurable class in self.classes. If classes=False (the default), only flags and aliases are printed.

Yield the very bottom lines of the help message. If classes=False (the default), print `--help-all` msg.

Expand $VARS and ~names in a string, like a shell :Examples: In [2]: os.environ['FOO']='test' In [3]: expand_path('variable FOO i

Find a file by looking through a sequence of paths. This iterates through a sequence of paths looking for a file and returns the full, absolu

Flatten flags and aliases for loaders, so cl-args override as expected. This prevents issues such as an alias pointing to InteractiveShell,

Return a dict from a list of config strings. This is where we parse CLI configuration. Each item should have the form ``"key=value"`

Retrieve the config data for the specified section. Returns the data as a dictionary, or an empty dictionary if the file doesn't exis

Get current words prior to completion point This is normally done in the `argcomplete.CompletionFinder` constructor, but is exposed here to a

construct the value from the initial one after applying any insert / extend / update changes