The API by usefulness¶

Perhaps the most useful way to learn this API is to sort by “usefulness”. I measure usefulness as the number of times I’ve used a particular function in my own code (excluding ubelt itself).

Function name	Usefulness
`ubelt.urepr`	3542
`ubelt.Path`	1915
`ubelt.paragraph`	866
`ubelt.cmd`	654
`ubelt.ProgIter`	600
`ubelt.codeblock`	567
`ubelt.udict`	485
`ubelt.expandpath`	399
`ubelt.take`	305
`ubelt.ddict`	241
`ubelt.group_items`	228
`ubelt.flatten`	226
`ubelt.oset`	224
`ubelt.dzip`	210
`ubelt.ensuredir`	201
`ubelt.odict`	189
`ubelt.map_vals`	186
`ubelt.iterable`	185
`ubelt.peek`	184
`ubelt.NiceRepr`	179
`ubelt.NoParam`	178
`ubelt.hash_data`	145
`ubelt.Timer`	144
`ubelt.argflag`	143
`ubelt.grabdata`	135
`ubelt.dict_hist`	119
`ubelt.argval`	111
`ubelt.color_text`	103
`ubelt.IndexableWalker`	100
`ubelt.dict_isect`	100
`ubelt.augpath`	99
`ubelt.schedule_deprecation`	96
`ubelt.allsame`	92
`ubelt.identity`	86
`ubelt.named_product`	85
`ubelt.compress`	83
`ubelt.JobPool`	79
`ubelt.memoize`	79
`ubelt.hzcat`	75
`ubelt.dict_diff`	73
`ubelt.delete`	67
`ubelt.symlink`	60
`ubelt.dict_union`	58
`ubelt.unique`	57
`ubelt.indent`	57
`ubelt.hash_file`	55
`ubelt.WIN32`	55
`ubelt.ensure_app_cache_dir`	55
`ubelt.timestamp`	51
`ubelt.invert_dict`	49
`ubelt.find_exe`	47
`ubelt.find_duplicates`	46
`ubelt.iter_window`	45
`ubelt.highlight_code`	43
`ubelt.map_keys`	42
`ubelt.chunks`	40
`ubelt.import_module_from_name`	40
`ubelt.modname_to_modpath`	36
`ubelt.argsort`	36
`ubelt.dict_subset`	35
`ubelt.Cacher`	34
`ubelt.memoize_property`	32
`ubelt.CacheStamp`	29
`ubelt.sorted_vals`	28
`ubelt.argmax`	28
`ubelt.writeto`	28
`ubelt.import_module_from_path`	28
`ubelt.ChDir`	23
`ubelt.Executor`	23
`ubelt.compatible`	18
`ubelt.ensure_unicode`	17
`ubelt.sorted_keys`	17
`ubelt.touch`	16
`ubelt.memoize_method`	15
`ubelt.readfrom`	15
`ubelt.timeparse`	10
`ubelt.AutoDict`	10
`ubelt.modpath_to_modname`	8
`ubelt.argmin`	8
`ubelt.shrinkuser`	8
`ubelt.boolmask`	7
`ubelt.zopen`	7
`ubelt.download`	6
`ubelt.LINUX`	6
`ubelt.inject_method`	6
`ubelt.varied_values`	5
`ubelt.CaptureStdout`	5
`ubelt.NO_COLOR`	5
`ubelt.OrderedSet`	4
`ubelt.find_path`	4
`ubelt.DARWIN`	4
`ubelt.get_app_cache_dir`	4
`ubelt.UDict`	3
`ubelt.SetDict`	2
`ubelt.split_modpath`	1
`ubelt.map_values`	1
`ubelt.userhome`	1
`ubelt.argunique`	1
`ubelt.unique_flags`	1
`ubelt.split_archive`	0
`ubelt.sorted_values`	0
`ubelt.sdict`	0
`ubelt.platform_data_dir`	0
`ubelt.platform_config_dir`	0
`ubelt.platform_cache_dir`	0
`ubelt.indexable_allclose`	0
`ubelt.get_app_data_dir`	0
`ubelt.get_app_config_dir`	0
`ubelt.ensure_app_data_dir`	0
`ubelt.ensure_app_config_dir`	0
`ubelt.TempDir`	0
`ubelt.TeeStringIO`	0
`ubelt.ReprExtensions`	0
`ubelt.POSIX`	0
`ubelt.DownloadManager`	0
`ubelt.CaptureStream`	0
`ubelt.AutoOrderedDict`	0

usage stats = {
    'mean': 129.51282,
    'std': 385.23578,
    'min': 0.0,
    'max': 3542.0,
    'q_0.25': 5.0,
    'q_0.50': 36.0,
    'q_0.75': 100.0,
    'med': 36.0,
    'sum': np.int64(15153),
    'shape': (117,),
}

`ubelt.orderedset`¶

<ubelt.OrderedSet> <ubelt.oset>

`ubelt.progiter`¶

<ubelt.ProgIter>

`ubelt.util_arg`¶

<ubelt.argval> <ubelt.argflag>

`ubelt.util_cache`¶

<ubelt.Cacher> <ubelt.CacheStamp>

`ubelt.util_cmd`¶

`ubelt.util_colors`¶

<ubelt.NO_COLOR> <ubelt.FORCE_COLOR> <ubelt.highlight_code> <ubelt.color_text>

`ubelt.util_const`¶

<ubelt.NoParam>

`ubelt.util_deprecate`¶

<ubelt.schedule_deprecation>

`ubelt.util_download`¶

<ubelt.download> <ubelt.grabdata>

`ubelt.util_download_manager`¶

<ubelt.DownloadManager>

`ubelt.util_format`¶

<ubelt.repr2> <ubelt.urepr> <ubelt.FormatterExtensions>

`ubelt.util_func`¶

<ubelt.identity> <ubelt.inject_method> <ubelt.compatible>

`ubelt.util_futures`¶

<ubelt.Executor> <ubelt.JobPool>

`ubelt.util_hash`¶

<ubelt.hash_data> <ubelt.hash_file>

`ubelt.util_import`¶

<ubelt.split_modpath> <ubelt.modname_to_modpath> <ubelt.modpath_to_modname> <ubelt.import_module_from_name> <ubelt.import_module_from_path>

`ubelt.util_indexable`¶

<ubelt.Difference> <ubelt.IndexableWalker> <ubelt.indexable_allclose>

`ubelt.util_io`¶

<ubelt.readfrom> <ubelt.writeto> <ubelt.touch> <ubelt.delete>

`ubelt.util_links`¶

<ubelt.symlink>

`ubelt.util_list`¶

<ubelt.allsame> <ubelt.argmax> <ubelt.argmin> <ubelt.argsort> <ubelt.argunique> <ubelt.boolmask> <ubelt.chunks> <ubelt.compress> <ubelt.flatten> <ubelt.iter_window> <ubelt.iterable> <ubelt.peek> <ubelt.take> <ubelt.unique> <ubelt.unique_flags>

`ubelt.util_memoize`¶

<ubelt.memoize> <ubelt.memoize_method> <ubelt.memoize_property>

`ubelt.util_mixins`¶

<ubelt.NiceRepr>

`ubelt.util_path`¶

<ubelt.Path> <ubelt.TempDir> <ubelt.augpath> <ubelt.shrinkuser> <ubelt.userhome> <ubelt.ensuredir> <ubelt.expandpath> <ubelt.ChDir>

`ubelt.util_platform`¶

<ubelt.WIN32> <ubelt.LINUX> <ubelt.DARWIN> <ubelt.POSIX> <ubelt.find_exe> <ubelt.find_path> <ubelt.ensure_app_cache_dir> <ubelt.ensure_app_config_dir> <ubelt.ensure_app_data_dir> <ubelt.get_app_cache_dir> <ubelt.get_app_config_dir> <ubelt.get_app_data_dir> <ubelt.platform_cache_dir> <ubelt.platform_config_dir> <ubelt.platform_data_dir>

`ubelt.util_repr`¶

<ubelt.urepr> <ubelt.ReprExtensions>

`ubelt.util_str`¶

<ubelt.indent> <ubelt.codeblock> <ubelt.paragraph> <ubelt.hzcat> <ubelt.ensure_unicode>

`ubelt.util_stream`¶

<ubelt.TeeStringIO> <ubelt.CaptureStdout> <ubelt.CaptureStream>

`ubelt.util_time`¶

<ubelt.timestamp> <ubelt.timeparse> <ubelt.Timer>

`ubelt.util_zip`¶

<ubelt.zopen> <ubelt.split_archive>