From 360f015ce869d084fd129ef9a91d1680bcff9d3c Mon Sep 17 00:00:00 2001
From: joncrall <erotemic@gmail.com>
Date: Sat, 4 Nov 2023 17:03:34 -0400
Subject: [PATCH] Update usefulness

---
 README.rst                          | 183 ++++++++++++-------------
 dev/maintain/count_usage_freq.py    |   7 +-
 dev/maintain/gen_api_for_docs.py    |   2 +-
 docs/source/function_usefulness.rst | 198 ++++++++++++++--------------
 4 files changed, 199 insertions(+), 191 deletions(-)
 mode change 100644 => 100755 dev/maintain/gen_api_for_docs.py

diff --git a/README.rst b/README.rst
index 3e3e1e4c..494d58b9 100644
--- a/README.rst
+++ b/README.rst
@@ -128,8 +128,8 @@ Ubelt is small. Its top-level API is defined using roughly 40 lines:
     from ubelt.util_indexable import (IndexableWalker, indexable_allclose,)
     from ubelt.util_memoize import (memoize, memoize_method, memoize_property,)
     from ubelt.util_mixins import (NiceRepr,)
-    from ubelt.util_path import (Path, TempDir, augpath, ensuredir, expandpath,
-                                 shrinkuser, userhome,)
+    from ubelt.util_path import (ChDir, Path, TempDir, augpath, ensuredir,
+                                 expandpath, shrinkuser, userhome,)
     from ubelt.util_platform import (DARWIN, LINUX, POSIX, WIN32, find_exe,
                                      find_path, platform_cache_dir,
                                      platform_config_dir, platform_data_dir,)
@@ -141,6 +141,7 @@ Ubelt is small. Its top-level API is defined using roughly 40 lines:
     from ubelt.progiter import (ProgIter,)
 
 
+
 Installation:
 =============
 
@@ -187,102 +188,105 @@ project. Note: this measure is biased towards older functions.
 ================================================================================================================================================ ================
  Function name                                                                                                                                         Usefulness
 ================================================================================================================================================ ================
-`ubelt.urepr <https://ubelt.readthedocs.io/en/latest/ubelt.util_repr.html#ubelt.util_repr.urepr>`__                                                          2893
-`ubelt.Path <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.Path>`__                                                             992
-`ubelt.ProgIter <https://ubelt.readthedocs.io/en/latest/ubelt.progiter.html#ubelt.progiter.ProgIter>`__                                                       544
-`ubelt.paragraph <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.paragraph>`__                                                     482
-`ubelt.take <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.take>`__                                                             387
-`ubelt.codeblock <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.codeblock>`__                                                     358
-`ubelt.expandpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.expandpath>`__                                                 331
-`ubelt.cmd <https://ubelt.readthedocs.io/en/latest/ubelt.util_cmd.html#ubelt.util_cmd.cmd>`__                                                                 302
-`ubelt.udict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.udict>`__                                                           271
-`ubelt.ensuredir <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.ensuredir>`__                                                   256
-`ubelt.odict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.odict>`__                                                           253
-`ubelt.iterable <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.iterable>`__                                                     252
-`ubelt.ddict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.ddict>`__                                                           238
-`ubelt.NiceRepr <https://ubelt.readthedocs.io/en/latest/ubelt.util_mixins.html#ubelt.util_mixins.NiceRepr>`__                                                 221
-`ubelt.NoParam <https://ubelt.readthedocs.io/en/latest/ubelt.util_const.html#ubelt.util_const.NoParam>`__                                                     216
-`ubelt.map_vals <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_vals>`__                                                     215
-`ubelt.flatten <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.flatten>`__                                                       214
-`ubelt.dzip <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dzip>`__                                                             200
-`ubelt.oset <https://ubelt.readthedocs.io/en/latest/ubelt.orderedset.html#ubelt.orderedset.oset>`__                                                           198
-`ubelt.peek <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.peek>`__                                                             196
-`ubelt.argflag <https://ubelt.readthedocs.io/en/latest/ubelt.util_arg.html#ubelt.util_arg.argflag>`__                                                         177
-`ubelt.group_items <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.group_items>`__                                               171
-`ubelt.hash_data <https://ubelt.readthedocs.io/en/latest/ubelt.util_hash.html#ubelt.util_hash.hash_data>`__                                                   165
-`ubelt.grabdata <https://ubelt.readthedocs.io/en/latest/ubelt.util_download.html#ubelt.util_download.grabdata>`__                                             131
-`ubelt.argval <https://ubelt.readthedocs.io/en/latest/ubelt.util_arg.html#ubelt.util_arg.argval>`__                                                           125
-`ubelt.Timer <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.Timer>`__                                                           120
-`ubelt.dict_isect <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_isect>`__                                                 113
-`ubelt.dict_hist <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_hist>`__                                                   111
-`ubelt.augpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.augpath>`__                                                       106
-`ubelt.identity <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.identity>`__                                                     106
-`ubelt.ensure_app_cache_dir <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.ensure_app_cache_dir>`__                     105
-`ubelt.allsame <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.allsame>`__                                                       102
-`ubelt.memoize <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize>`__                                                  99
-`ubelt.color_text <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.color_text>`__                                              98
-`ubelt.dict_diff <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_diff>`__                                                    95
-`ubelt.delete <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.delete>`__                                                              89
-`ubelt.hzcat <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.hzcat>`__                                                              88
-`ubelt.schedule_deprecation <https://ubelt.readthedocs.io/en/latest/ubelt.util_deprecate.html#ubelt.util_deprecate.schedule_deprecation>`__                    87
-`ubelt.named_product <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.named_product>`__                                            85
-`ubelt.compress <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.compress>`__                                                      85
-`ubelt.IndexableWalker <https://ubelt.readthedocs.io/en/latest/ubelt.util_indexable.html#ubelt.util_indexable.IndexableWalker>`__                              74
-`ubelt.indent <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.indent>`__                                                            68
-`ubelt.JobPool <https://ubelt.readthedocs.io/en/latest/ubelt.util_futures.html#ubelt.util_futures.JobPool>`__                                                  67
-`ubelt.unique <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.unique>`__                                                          63
-`ubelt.dict_union <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_union>`__                                                  57
-`ubelt.map_keys <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_keys>`__                                                      49
-`ubelt.invert_dict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.invert_dict>`__                                                48
-`ubelt.iter_window <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.iter_window>`__                                                46
-`ubelt.timestamp <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.timestamp>`__                                                    46
-`ubelt.argsort <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argsort>`__                                                        44
-`ubelt.Cacher <https://ubelt.readthedocs.io/en/latest/ubelt.util_cache.html#ubelt.util_cache.Cacher>`__                                                        43
-`ubelt.find_exe <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.find_exe>`__                                              41
-`ubelt.symlink <https://ubelt.readthedocs.io/en/latest/ubelt.util_links.html#ubelt.util_links.symlink>`__                                                      41
-`ubelt.dict_subset <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_subset>`__                                                41
-`ubelt.writeto <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.writeto>`__                                                            40
-`ubelt.find_duplicates <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.find_duplicates>`__                                        39
-`ubelt.chunks <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.chunks>`__                                                          38
-`ubelt.hash_file <https://ubelt.readthedocs.io/en/latest/ubelt.util_hash.html#ubelt.util_hash.hash_file>`__                                                    37
-`ubelt.modname_to_modpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.modname_to_modpath>`__                              37
-`ubelt.ensure_unicode <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.ensure_unicode>`__                                            33
-`ubelt.memoize_property <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize_property>`__                                33
-`ubelt.highlight_code <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.highlight_code>`__                                      33
-`ubelt.sorted_vals <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.sorted_vals>`__                                                32
-`ubelt.CacheStamp <https://ubelt.readthedocs.io/en/latest/ubelt.util_cache.html#ubelt.util_cache.CacheStamp>`__                                                30
-`ubelt.WIN32 <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.WIN32>`__                                                    28
-`ubelt.import_module_from_name <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.import_module_from_name>`__                    27
-`ubelt.argmax <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argmax>`__                                                          27
+`ubelt.urepr <https://ubelt.readthedocs.io/en/latest/ubelt.util_repr.html#ubelt.util_repr.urepr>`__                                                          4327
+`ubelt.Path <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.Path>`__                                                            2125
+`ubelt.paragraph <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.paragraph>`__                                                    1349
+`ubelt.ProgIter <https://ubelt.readthedocs.io/en/latest/ubelt.progiter.html#ubelt.progiter.ProgIter>`__                                                       747
+`ubelt.cmd <https://ubelt.readthedocs.io/en/latest/ubelt.util_cmd.html#ubelt.util_cmd.cmd>`__                                                                 657
+`ubelt.codeblock <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.codeblock>`__                                                     611
+`ubelt.udict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.udict>`__                                                           603
+`ubelt.expandpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.expandpath>`__                                                 508
+`ubelt.take <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.take>`__                                                             462
+`ubelt.oset <https://ubelt.readthedocs.io/en/latest/ubelt.orderedset.html#ubelt.orderedset.oset>`__                                                           342
+`ubelt.ddict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.ddict>`__                                                           341
+`ubelt.iterable <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.iterable>`__                                                     313
+`ubelt.flatten <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.flatten>`__                                                       303
+`ubelt.group_items <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.group_items>`__                                               287
+`ubelt.NiceRepr <https://ubelt.readthedocs.io/en/latest/ubelt.util_mixins.html#ubelt.util_mixins.NiceRepr>`__                                                 270
+`ubelt.ensuredir <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.ensuredir>`__                                                   267
+`ubelt.map_vals <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_vals>`__                                                     265
+`ubelt.peek <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.peek>`__                                                             262
+`ubelt.NoParam <https://ubelt.readthedocs.io/en/latest/ubelt.util_const.html#ubelt.util_const.NoParam>`__                                                     248
+`ubelt.dzip <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dzip>`__                                                             239
+`ubelt.odict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.odict>`__                                                           236
+`ubelt.hash_data <https://ubelt.readthedocs.io/en/latest/ubelt.util_hash.html#ubelt.util_hash.hash_data>`__                                                   200
+`ubelt.argflag <https://ubelt.readthedocs.io/en/latest/ubelt.util_arg.html#ubelt.util_arg.argflag>`__                                                         184
+`ubelt.grabdata <https://ubelt.readthedocs.io/en/latest/ubelt.util_download.html#ubelt.util_download.grabdata>`__                                             161
+`ubelt.dict_hist <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_hist>`__                                                   156
+`ubelt.identity <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.identity>`__                                                     156
+`ubelt.dict_isect <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_isect>`__                                                 152
+`ubelt.Timer <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.Timer>`__                                                           145
+`ubelt.memoize <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize>`__                                                 142
+`ubelt.argval <https://ubelt.readthedocs.io/en/latest/ubelt.util_arg.html#ubelt.util_arg.argval>`__                                                           134
+`ubelt.allsame <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.allsame>`__                                                       133
+`ubelt.color_text <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.color_text>`__                                             129
+`ubelt.schedule_deprecation <https://ubelt.readthedocs.io/en/latest/ubelt.util_deprecate.html#ubelt.util_deprecate.schedule_deprecation>`__                   123
+`ubelt.augpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.augpath>`__                                                       120
+`ubelt.dict_diff <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_diff>`__                                                   117
+`ubelt.IndexableWalker <https://ubelt.readthedocs.io/en/latest/ubelt.util_indexable.html#ubelt.util_indexable.IndexableWalker>`__                             116
+`ubelt.compress <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.compress>`__                                                     116
+`ubelt.JobPool <https://ubelt.readthedocs.io/en/latest/ubelt.util_futures.html#ubelt.util_futures.JobPool>`__                                                 107
+`ubelt.named_product <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.named_product>`__                                           104
+`ubelt.hzcat <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.hzcat>`__                                                              90
+`ubelt.delete <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.delete>`__                                                              88
+`ubelt.unique <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.unique>`__                                                          84
+`ubelt.WIN32 <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.WIN32>`__                                                    78
+`ubelt.dict_union <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_union>`__                                                  76
+`ubelt.symlink <https://ubelt.readthedocs.io/en/latest/ubelt.util_links.html#ubelt.util_links.symlink>`__                                                      76
+`ubelt.indent <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.indent>`__                                                            69
+`ubelt.ensure_app_cache_dir <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.ensure_app_cache_dir>`__                      67
+`ubelt.iter_window <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.iter_window>`__                                                62
+`ubelt.invert_dict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.invert_dict>`__                                                58
+`ubelt.memoize_property <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize_property>`__                                57
+`ubelt.import_module_from_name <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.import_module_from_name>`__                    56
+`ubelt.argsort <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argsort>`__                                                        55
+`ubelt.timestamp <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.timestamp>`__                                                    54
+`ubelt.modname_to_modpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.modname_to_modpath>`__                              53
+`ubelt.find_duplicates <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.find_duplicates>`__                                        53
+`ubelt.hash_file <https://ubelt.readthedocs.io/en/latest/ubelt.util_hash.html#ubelt.util_hash.hash_file>`__                                                    51
+`ubelt.find_exe <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.find_exe>`__                                              50
+`ubelt.map_keys <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_keys>`__                                                      50
+`ubelt.dict_subset <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.dict_subset>`__                                                50
+`ubelt.Cacher <https://ubelt.readthedocs.io/en/latest/ubelt.util_cache.html#ubelt.util_cache.Cacher>`__                                                        49
+`ubelt.chunks <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.chunks>`__                                                          47
+`ubelt.sorted_vals <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.sorted_vals>`__                                                40
+`ubelt.CacheStamp <https://ubelt.readthedocs.io/en/latest/ubelt.util_cache.html#ubelt.util_cache.CacheStamp>`__                                                38
+`ubelt.highlight_code <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.highlight_code>`__                                      37
+`ubelt.argmax <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argmax>`__                                                          36
+`ubelt.writeto <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.writeto>`__                                                            36
+`ubelt.ensure_unicode <https://ubelt.readthedocs.io/en/latest/ubelt.util_str.html#ubelt.util_str.ensure_unicode>`__                                            32
+`ubelt.sorted_keys <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.sorted_keys>`__                                                30
+`ubelt.memoize_method <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize_method>`__                                    29
+`ubelt.compatible <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.compatible>`__                                                  24
+`ubelt.import_module_from_path <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.import_module_from_path>`__                    24
+`ubelt.Executor <https://ubelt.readthedocs.io/en/latest/ubelt.util_futures.html#ubelt.util_futures.Executor>`__                                                23
 `ubelt.readfrom <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.readfrom>`__                                                          23
-`ubelt.import_module_from_path <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.import_module_from_path>`__                    22
-`ubelt.compatible <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.compatible>`__                                                  17
+`ubelt.modpath_to_modname <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.modpath_to_modname>`__                              17
+`ubelt.AutoDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.AutoDict>`__                                                      17
 `ubelt.touch <https://ubelt.readthedocs.io/en/latest/ubelt.util_io.html#ubelt.util_io.touch>`__                                                                17
-`ubelt.Executor <https://ubelt.readthedocs.io/en/latest/ubelt.util_futures.html#ubelt.util_futures.Executor>`__                                                16
-`ubelt.memoize_method <https://ubelt.readthedocs.io/en/latest/ubelt.util_memoize.html#ubelt.util_memoize.memoize_method>`__                                    16
-`ubelt.sorted_keys <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.sorted_keys>`__                                                14
-`ubelt.AutoDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.AutoDict>`__                                                      11
+`ubelt.inject_method <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.inject_method>`__                                            14
+`ubelt.timeparse <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.timeparse>`__                                                    13
+`ubelt.ChDir <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.ChDir>`__                                                            11
 `ubelt.shrinkuser <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.shrinkuser>`__                                                  11
-`ubelt.inject_method <https://ubelt.readthedocs.io/en/latest/ubelt.util_func.html#ubelt.util_func.inject_method>`__                                            10
+`ubelt.argmin <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argmin>`__                                                          10
 `ubelt.varied_values <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.varied_values>`__                                             9
 `ubelt.split_modpath <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.split_modpath>`__                                         8
-`ubelt.modpath_to_modname <https://ubelt.readthedocs.io/en/latest/ubelt.util_import.html#ubelt.util_import.modpath_to_modname>`__                               8
-`ubelt.get_app_cache_dir <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.get_app_cache_dir>`__                             8
-`ubelt.zopen <https://ubelt.readthedocs.io/en/latest/ubelt.util_zip.html#ubelt.util_zip.zopen>`__                                                               7
-`ubelt.LINUX <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.LINUX>`__                                                     7
+`ubelt.LINUX <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.LINUX>`__                                                     8
+`ubelt.download <https://ubelt.readthedocs.io/en/latest/ubelt.util_download.html#ubelt.util_download.download>`__                                               7
+`ubelt.NO_COLOR <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.NO_COLOR>`__                                                   7
+`ubelt.OrderedSet <https://ubelt.readthedocs.io/en/latest/ubelt.orderedset.html#ubelt.orderedset.OrderedSet>`__                                                 6
+`ubelt.zopen <https://ubelt.readthedocs.io/en/latest/ubelt.util_zip.html#ubelt.util_zip.zopen>`__                                                               6
 `ubelt.CaptureStdout <https://ubelt.readthedocs.io/en/latest/ubelt.util_stream.html#ubelt.util_stream.CaptureStdout>`__                                         6
-`ubelt.download <https://ubelt.readthedocs.io/en/latest/ubelt.util_download.html#ubelt.util_download.download>`__                                               5
-`ubelt.timeparse <https://ubelt.readthedocs.io/en/latest/ubelt.util_time.html#ubelt.util_time.timeparse>`__                                                     5
 `ubelt.DARWIN <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.DARWIN>`__                                                   5
-`ubelt.argmin <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argmin>`__                                                           5
+`ubelt.boolmask <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.boolmask>`__                                                       4
 `ubelt.find_path <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.find_path>`__                                             4
-`ubelt.indexable_allclose <https://ubelt.readthedocs.io/en/latest/ubelt.util_indexable.html#ubelt.util_indexable.indexable_allclose>`__                         4
-`ubelt.boolmask <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.boolmask>`__                                                       3
-`ubelt.map_values <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_values>`__                                                   2
+`ubelt.get_app_cache_dir <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.get_app_cache_dir>`__                             4
+`ubelt.indexable_allclose <https://ubelt.readthedocs.io/en/latest/ubelt.util_indexable.html#ubelt.util_indexable.indexable_allclose>`__                         3
+`ubelt.UDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.UDict>`__                                                             3
+`ubelt.SetDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.SetDict>`__                                                         2
 `ubelt.AutoOrderedDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.AutoOrderedDict>`__                                         2
 `ubelt.argunique <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.argunique>`__                                                     2
-`ubelt.NO_COLOR <https://ubelt.readthedocs.io/en/latest/ubelt.util_colors.html#ubelt.util_colors.NO_COLOR>`__                                                   2
-`ubelt.UDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.UDict>`__                                                             1
+`ubelt.map_values <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.map_values>`__                                                   1
 `ubelt.unique_flags <https://ubelt.readthedocs.io/en/latest/ubelt.util_list.html#ubelt.util_list.unique_flags>`__                                               1
 `ubelt.userhome <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.userhome>`__                                                       0
 `ubelt.split_archive <https://ubelt.readthedocs.io/en/latest/ubelt.util_zip.html#ubelt.util_zip.split_archive>`__                                               0
@@ -297,15 +301,14 @@ project. Note: this measure is biased towards older functions.
 `ubelt.ensure_app_config_dir <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.ensure_app_config_dir>`__                     0
 `ubelt.TempDir <https://ubelt.readthedocs.io/en/latest/ubelt.util_path.html#ubelt.util_path.TempDir>`__                                                         0
 `ubelt.TeeStringIO <https://ubelt.readthedocs.io/en/latest/ubelt.util_stream.html#ubelt.util_stream.TeeStringIO>`__                                             0
-`ubelt.SetDict <https://ubelt.readthedocs.io/en/latest/ubelt.util_dict.html#ubelt.util_dict.SetDict>`__                                                         0
 `ubelt.ReprExtensions <https://ubelt.readthedocs.io/en/latest/ubelt.util_repr.html#ubelt.util_repr.ReprExtensions>`__                                           0
 `ubelt.POSIX <https://ubelt.readthedocs.io/en/latest/ubelt.util_platform.html#ubelt.util_platform.POSIX>`__                                                     0
-`ubelt.OrderedSet <https://ubelt.readthedocs.io/en/latest/ubelt.orderedset.html#ubelt.orderedset.OrderedSet>`__                                                 0
 `ubelt.DownloadManager <https://ubelt.readthedocs.io/en/latest/ubelt.util_download_manager.html#ubelt.util_download_manager.DownloadManager>`__                 0
 `ubelt.CaptureStream <https://ubelt.readthedocs.io/en/latest/ubelt.util_stream.html#ubelt.util_stream.CaptureStream>`__                                         0
 ================================================================================================================================================ ================
 
 
+
 Examples
 ========
 
diff --git a/dev/maintain/count_usage_freq.py b/dev/maintain/count_usage_freq.py
index 0ead0636..6c3c76df 100755
--- a/dev/maintain/count_usage_freq.py
+++ b/dev/maintain/count_usage_freq.py
@@ -1,4 +1,4 @@
-
+#!/usr/bin/env python
 
 import scriptconfig as scfg
 
@@ -19,11 +19,14 @@ def count_ubelt_usage():
     import glob
     from os.path import join
     names = [
-        'xdoctest', 'netharn', 'xdev', 'xinspect', 'ndsampler',
+        'xdoctest', 'netharn', 'xdev', 'xinspect', 'xcookie', 'ndsampler',
         'kwarray', 'kwimage', 'kwplot', 'kwcoco',
         'scriptconfig', 'vimtk',
         'mkinit', 'futures_actors', 'graphid',
 
+        'kwutil', 'git_well', 'line_profiler', 'delayed_image', 'simple_dvc',
+        'pypogo',
+
         'ibeis', 'plottool_ibeis', 'guitool_ibeis', 'utool', 'dtool_ibeis',
         'vtool_ibeis', 'hesaff', 'torch_liberator', 'liberator',
     ] + config['extra_modnames']
diff --git a/dev/maintain/gen_api_for_docs.py b/dev/maintain/gen_api_for_docs.py
old mode 100644
new mode 100755
index 5dd382cc..8714deb7
--- a/dev/maintain/gen_api_for_docs.py
+++ b/dev/maintain/gen_api_for_docs.py
@@ -1,3 +1,4 @@
+#!/usr/bin/env python
 
 def count_ubelt_usage():
     """
@@ -12,7 +13,6 @@ def count_ubelt_usage():
     # Reorgnaize data to contain more information
     rows = []
     unseen = usage.copy()
-    import ubelt as ub
     for attrname in ub.__all__:
         member = getattr(ub, attrname)
         submembers = getattr(member, '__all__', None)
diff --git a/docs/source/function_usefulness.rst b/docs/source/function_usefulness.rst
index 58cfb880..79762a14 100644
--- a/docs/source/function_usefulness.rst
+++ b/docs/source/function_usefulness.rst
@@ -1,7 +1,7 @@
 The API by usefulness
 =====================
 
-.. to help generate python ~/code/ubelt/dev/gen_api_for_docs.py --extra_modname=bioharn,watch --remove_zeros=False
+.. to help generate python ~/code/ubelt/dev/maintain/gen_api_for_docs.py --extra_modname=bioharn,watch --remove_zeros=False
 
 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
@@ -11,102 +11,105 @@ my own code (excluding ubelt itself).
 ================================================================================= ================
  Function name                                                                          Usefulness
 ================================================================================= ================
-:func:`ubelt.urepr<ubelt.util_repr.urepr>`                                                    2893
-:func:`ubelt.Path<ubelt.util_path.Path>`                                                       992
-:func:`ubelt.ProgIter<ubelt.progiter.ProgIter>`                                                544
-:func:`ubelt.paragraph<ubelt.util_str.paragraph>`                                              482
-:func:`ubelt.take<ubelt.util_list.take>`                                                       387
-:func:`ubelt.codeblock<ubelt.util_str.codeblock>`                                              358
-:func:`ubelt.expandpath<ubelt.util_path.expandpath>`                                           331
-:func:`ubelt.cmd<ubelt.util_cmd.cmd>`                                                          302
-:func:`ubelt.udict<ubelt.util_dict.udict>`                                                     271
-:func:`ubelt.ensuredir<ubelt.util_path.ensuredir>`                                             256
-:func:`ubelt.odict<ubelt.util_dict.odict>`                                                     253
-:func:`ubelt.iterable<ubelt.util_list.iterable>`                                               252
-:func:`ubelt.ddict<ubelt.util_dict.ddict>`                                                     238
-:func:`ubelt.NiceRepr<ubelt.util_mixins.NiceRepr>`                                             221
-:func:`ubelt.NoParam<ubelt.util_const.NoParam>`                                                216
-:func:`ubelt.map_vals<ubelt.util_dict.map_vals>`                                               215
-:func:`ubelt.flatten<ubelt.util_list.flatten>`                                                 214
-:func:`ubelt.dzip<ubelt.util_dict.dzip>`                                                       200
-:func:`ubelt.oset<ubelt.orderedset.oset>`                                                      198
-:func:`ubelt.peek<ubelt.util_list.peek>`                                                       196
-:func:`ubelt.argflag<ubelt.util_arg.argflag>`                                                  177
-:func:`ubelt.group_items<ubelt.util_dict.group_items>`                                         171
-:func:`ubelt.hash_data<ubelt.util_hash.hash_data>`                                             165
-:func:`ubelt.grabdata<ubelt.util_download.grabdata>`                                           131
-:func:`ubelt.argval<ubelt.util_arg.argval>`                                                    125
-:func:`ubelt.Timer<ubelt.util_time.Timer>`                                                     120
-:func:`ubelt.dict_isect<ubelt.util_dict.dict_isect>`                                           113
-:func:`ubelt.dict_hist<ubelt.util_dict.dict_hist>`                                             111
-:func:`ubelt.augpath<ubelt.util_path.augpath>`                                                 106
-:func:`ubelt.identity<ubelt.util_func.identity>`                                               106
-:func:`ubelt.ensure_app_cache_dir<ubelt.util_platform.ensure_app_cache_dir>`                   105
-:func:`ubelt.allsame<ubelt.util_list.allsame>`                                                 102
-:func:`ubelt.memoize<ubelt.util_memoize.memoize>`                                               99
-:func:`ubelt.color_text<ubelt.util_colors.color_text>`                                          98
-:func:`ubelt.dict_diff<ubelt.util_dict.dict_diff>`                                              95
-:func:`ubelt.delete<ubelt.util_io.delete>`                                                      89
-:func:`ubelt.hzcat<ubelt.util_str.hzcat>`                                                       88
-:func:`ubelt.schedule_deprecation<ubelt.util_deprecate.schedule_deprecation>`                   87
-:func:`ubelt.named_product<ubelt.util_dict.named_product>`                                      85
-:func:`ubelt.compress<ubelt.util_list.compress>`                                                85
-:func:`ubelt.IndexableWalker<ubelt.util_indexable.IndexableWalker>`                             74
-:func:`ubelt.indent<ubelt.util_str.indent>`                                                     68
-:func:`ubelt.JobPool<ubelt.util_futures.JobPool>`                                               67
-:func:`ubelt.unique<ubelt.util_list.unique>`                                                    63
-:func:`ubelt.dict_union<ubelt.util_dict.dict_union>`                                            57
-:func:`ubelt.map_keys<ubelt.util_dict.map_keys>`                                                49
-:func:`ubelt.invert_dict<ubelt.util_dict.invert_dict>`                                          48
-:func:`ubelt.iter_window<ubelt.util_list.iter_window>`                                          46
-:func:`ubelt.timestamp<ubelt.util_time.timestamp>`                                              46
-:func:`ubelt.argsort<ubelt.util_list.argsort>`                                                  44
-:func:`ubelt.Cacher<ubelt.util_cache.Cacher>`                                                   43
-:func:`ubelt.find_exe<ubelt.util_platform.find_exe>`                                            41
-:func:`ubelt.symlink<ubelt.util_links.symlink>`                                                 41
-:func:`ubelt.dict_subset<ubelt.util_dict.dict_subset>`                                          41
-:func:`ubelt.writeto<ubelt.util_io.writeto>`                                                    40
-:func:`ubelt.find_duplicates<ubelt.util_dict.find_duplicates>`                                  39
-:func:`ubelt.chunks<ubelt.util_list.chunks>`                                                    38
-:func:`ubelt.hash_file<ubelt.util_hash.hash_file>`                                              37
-:func:`ubelt.modname_to_modpath<ubelt.util_import.modname_to_modpath>`                          37
-:func:`ubelt.ensure_unicode<ubelt.util_str.ensure_unicode>`                                     33
-:func:`ubelt.memoize_property<ubelt.util_memoize.memoize_property>`                             33
-:func:`ubelt.highlight_code<ubelt.util_colors.highlight_code>`                                  33
-:func:`ubelt.sorted_vals<ubelt.util_dict.sorted_vals>`                                          32
-:func:`ubelt.CacheStamp<ubelt.util_cache.CacheStamp>`                                           30
-:func:`ubelt.WIN32<ubelt.util_platform.WIN32>`                                                  28
-:func:`ubelt.import_module_from_name<ubelt.util_import.import_module_from_name>`                27
-:func:`ubelt.argmax<ubelt.util_list.argmax>`                                                    27
+:func:`ubelt.urepr<ubelt.util_repr.urepr>`                                                    4327
+:func:`ubelt.Path<ubelt.util_path.Path>`                                                      2125
+:func:`ubelt.paragraph<ubelt.util_str.paragraph>`                                             1349
+:func:`ubelt.ProgIter<ubelt.progiter.ProgIter>`                                                747
+:func:`ubelt.cmd<ubelt.util_cmd.cmd>`                                                          657
+:func:`ubelt.codeblock<ubelt.util_str.codeblock>`                                              611
+:func:`ubelt.udict<ubelt.util_dict.udict>`                                                     603
+:func:`ubelt.expandpath<ubelt.util_path.expandpath>`                                           508
+:func:`ubelt.take<ubelt.util_list.take>`                                                       462
+:func:`ubelt.oset<ubelt.orderedset.oset>`                                                      342
+:func:`ubelt.ddict<ubelt.util_dict.ddict>`                                                     341
+:func:`ubelt.iterable<ubelt.util_list.iterable>`                                               313
+:func:`ubelt.flatten<ubelt.util_list.flatten>`                                                 303
+:func:`ubelt.group_items<ubelt.util_dict.group_items>`                                         287
+:func:`ubelt.NiceRepr<ubelt.util_mixins.NiceRepr>`                                             270
+:func:`ubelt.ensuredir<ubelt.util_path.ensuredir>`                                             267
+:func:`ubelt.map_vals<ubelt.util_dict.map_vals>`                                               265
+:func:`ubelt.peek<ubelt.util_list.peek>`                                                       262
+:func:`ubelt.NoParam<ubelt.util_const.NoParam>`                                                248
+:func:`ubelt.dzip<ubelt.util_dict.dzip>`                                                       239
+:func:`ubelt.odict<ubelt.util_dict.odict>`                                                     236
+:func:`ubelt.hash_data<ubelt.util_hash.hash_data>`                                             200
+:func:`ubelt.argflag<ubelt.util_arg.argflag>`                                                  184
+:func:`ubelt.grabdata<ubelt.util_download.grabdata>`                                           161
+:func:`ubelt.dict_hist<ubelt.util_dict.dict_hist>`                                             156
+:func:`ubelt.identity<ubelt.util_func.identity>`                                               156
+:func:`ubelt.dict_isect<ubelt.util_dict.dict_isect>`                                           152
+:func:`ubelt.Timer<ubelt.util_time.Timer>`                                                     145
+:func:`ubelt.memoize<ubelt.util_memoize.memoize>`                                              142
+:func:`ubelt.argval<ubelt.util_arg.argval>`                                                    134
+:func:`ubelt.allsame<ubelt.util_list.allsame>`                                                 133
+:func:`ubelt.color_text<ubelt.util_colors.color_text>`                                         129
+:func:`ubelt.schedule_deprecation<ubelt.util_deprecate.schedule_deprecation>`                  123
+:func:`ubelt.augpath<ubelt.util_path.augpath>`                                                 120
+:func:`ubelt.dict_diff<ubelt.util_dict.dict_diff>`                                             117
+:func:`ubelt.IndexableWalker<ubelt.util_indexable.IndexableWalker>`                            116
+:func:`ubelt.compress<ubelt.util_list.compress>`                                               116
+:func:`ubelt.JobPool<ubelt.util_futures.JobPool>`                                              107
+:func:`ubelt.named_product<ubelt.util_dict.named_product>`                                     104
+:func:`ubelt.hzcat<ubelt.util_str.hzcat>`                                                       90
+:func:`ubelt.delete<ubelt.util_io.delete>`                                                      88
+:func:`ubelt.unique<ubelt.util_list.unique>`                                                    84
+:func:`ubelt.WIN32<ubelt.util_platform.WIN32>`                                                  78
+:func:`ubelt.dict_union<ubelt.util_dict.dict_union>`                                            76
+:func:`ubelt.symlink<ubelt.util_links.symlink>`                                                 76
+:func:`ubelt.indent<ubelt.util_str.indent>`                                                     69
+:func:`ubelt.ensure_app_cache_dir<ubelt.util_platform.ensure_app_cache_dir>`                    67
+:func:`ubelt.iter_window<ubelt.util_list.iter_window>`                                          62
+:func:`ubelt.invert_dict<ubelt.util_dict.invert_dict>`                                          58
+:func:`ubelt.memoize_property<ubelt.util_memoize.memoize_property>`                             57
+:func:`ubelt.import_module_from_name<ubelt.util_import.import_module_from_name>`                56
+:func:`ubelt.argsort<ubelt.util_list.argsort>`                                                  55
+:func:`ubelt.timestamp<ubelt.util_time.timestamp>`                                              54
+:func:`ubelt.modname_to_modpath<ubelt.util_import.modname_to_modpath>`                          53
+:func:`ubelt.find_duplicates<ubelt.util_dict.find_duplicates>`                                  53
+:func:`ubelt.hash_file<ubelt.util_hash.hash_file>`                                              51
+:func:`ubelt.find_exe<ubelt.util_platform.find_exe>`                                            50
+:func:`ubelt.map_keys<ubelt.util_dict.map_keys>`                                                50
+:func:`ubelt.dict_subset<ubelt.util_dict.dict_subset>`                                          50
+:func:`ubelt.Cacher<ubelt.util_cache.Cacher>`                                                   49
+:func:`ubelt.chunks<ubelt.util_list.chunks>`                                                    47
+:func:`ubelt.sorted_vals<ubelt.util_dict.sorted_vals>`                                          40
+:func:`ubelt.CacheStamp<ubelt.util_cache.CacheStamp>`                                           38
+:func:`ubelt.highlight_code<ubelt.util_colors.highlight_code>`                                  37
+:func:`ubelt.argmax<ubelt.util_list.argmax>`                                                    36
+:func:`ubelt.writeto<ubelt.util_io.writeto>`                                                    36
+:func:`ubelt.ensure_unicode<ubelt.util_str.ensure_unicode>`                                     32
+:func:`ubelt.sorted_keys<ubelt.util_dict.sorted_keys>`                                          30
+:func:`ubelt.memoize_method<ubelt.util_memoize.memoize_method>`                                 29
+:func:`ubelt.compatible<ubelt.util_func.compatible>`                                            24
+:func:`ubelt.import_module_from_path<ubelt.util_import.import_module_from_path>`                24
+:func:`ubelt.Executor<ubelt.util_futures.Executor>`                                             23
 :func:`ubelt.readfrom<ubelt.util_io.readfrom>`                                                  23
-:func:`ubelt.import_module_from_path<ubelt.util_import.import_module_from_path>`                22
-:func:`ubelt.compatible<ubelt.util_func.compatible>`                                            17
+:func:`ubelt.modpath_to_modname<ubelt.util_import.modpath_to_modname>`                          17
+:func:`ubelt.AutoDict<ubelt.util_dict.AutoDict>`                                                17
 :func:`ubelt.touch<ubelt.util_io.touch>`                                                        17
-:func:`ubelt.Executor<ubelt.util_futures.Executor>`                                             16
-:func:`ubelt.memoize_method<ubelt.util_memoize.memoize_method>`                                 16
-:func:`ubelt.sorted_keys<ubelt.util_dict.sorted_keys>`                                          14
-:func:`ubelt.AutoDict<ubelt.util_dict.AutoDict>`                                                11
+:func:`ubelt.inject_method<ubelt.util_func.inject_method>`                                      14
+:func:`ubelt.timeparse<ubelt.util_time.timeparse>`                                              13
+:func:`ubelt.ChDir<ubelt.util_path.ChDir>`                                                      11
 :func:`ubelt.shrinkuser<ubelt.util_path.shrinkuser>`                                            11
-:func:`ubelt.inject_method<ubelt.util_func.inject_method>`                                      10
+:func:`ubelt.argmin<ubelt.util_list.argmin>`                                                    10
 :func:`ubelt.varied_values<ubelt.util_dict.varied_values>`                                       9
 :func:`ubelt.split_modpath<ubelt.util_import.split_modpath>`                                     8
-:func:`ubelt.modpath_to_modname<ubelt.util_import.modpath_to_modname>`                           8
-:func:`ubelt.get_app_cache_dir<ubelt.util_platform.get_app_cache_dir>`                           8
-:func:`ubelt.zopen<ubelt.util_zip.zopen>`                                                        7
-:func:`ubelt.LINUX<ubelt.util_platform.LINUX>`                                                   7
+:func:`ubelt.LINUX<ubelt.util_platform.LINUX>`                                                   8
+:func:`ubelt.download<ubelt.util_download.download>`                                             7
+:func:`ubelt.NO_COLOR<ubelt.util_colors.NO_COLOR>`                                               7
+:func:`ubelt.OrderedSet<ubelt.orderedset.OrderedSet>`                                            6
+:func:`ubelt.zopen<ubelt.util_zip.zopen>`                                                        6
 :func:`ubelt.CaptureStdout<ubelt.util_stream.CaptureStdout>`                                     6
-:func:`ubelt.download<ubelt.util_download.download>`                                             5
-:func:`ubelt.timeparse<ubelt.util_time.timeparse>`                                               5
 :func:`ubelt.DARWIN<ubelt.util_platform.DARWIN>`                                                 5
-:func:`ubelt.argmin<ubelt.util_list.argmin>`                                                     5
+:func:`ubelt.boolmask<ubelt.util_list.boolmask>`                                                 4
 :func:`ubelt.find_path<ubelt.util_platform.find_path>`                                           4
-:func:`ubelt.indexable_allclose<ubelt.util_indexable.indexable_allclose>`                        4
-:func:`ubelt.boolmask<ubelt.util_list.boolmask>`                                                 3
-:func:`ubelt.map_values<ubelt.util_dict.map_values>`                                             2
+:func:`ubelt.get_app_cache_dir<ubelt.util_platform.get_app_cache_dir>`                           4
+:func:`ubelt.indexable_allclose<ubelt.util_indexable.indexable_allclose>`                        3
+:func:`ubelt.UDict<ubelt.util_dict.UDict>`                                                       3
+:func:`ubelt.SetDict<ubelt.util_dict.SetDict>`                                                   2
 :func:`ubelt.AutoOrderedDict<ubelt.util_dict.AutoOrderedDict>`                                   2
 :func:`ubelt.argunique<ubelt.util_list.argunique>`                                               2
-:func:`ubelt.NO_COLOR<ubelt.util_colors.NO_COLOR>`                                               2
-:func:`ubelt.UDict<ubelt.util_dict.UDict>`                                                       1
+:func:`ubelt.map_values<ubelt.util_dict.map_values>`                                             1
 :func:`ubelt.unique_flags<ubelt.util_list.unique_flags>`                                         1
 :func:`ubelt.userhome<ubelt.util_path.userhome>`                                                 0
 :func:`ubelt.split_archive<ubelt.util_zip.split_archive>`                                        0
@@ -121,10 +124,8 @@ my own code (excluding ubelt itself).
 :func:`ubelt.ensure_app_config_dir<ubelt.util_platform.ensure_app_config_dir>`                   0
 :func:`ubelt.TempDir<ubelt.util_path.TempDir>`                                                   0
 :func:`ubelt.TeeStringIO<ubelt.util_stream.TeeStringIO>`                                         0
-:func:`ubelt.SetDict<ubelt.util_dict.SetDict>`                                                   0
 :func:`ubelt.ReprExtensions<ubelt.util_repr.ReprExtensions>`                                     0
 :func:`ubelt.POSIX<ubelt.util_platform.POSIX>`                                                   0
-:func:`ubelt.OrderedSet<ubelt.orderedset.OrderedSet>`                                            0
 :func:`ubelt.DownloadManager<ubelt.util_download_manager.DownloadManager>`                       0
 :func:`ubelt.CaptureStream<ubelt.util_stream.CaptureStream>`                                     0
 ================================================================================= ================
@@ -132,16 +133,16 @@ my own code (excluding ubelt itself).
 .. code:: python
 
     usage stats = {
-        'mean': 109.39655,
-        'std': 292.5527,
+        'mean': 164.10257,
+        'std': 467.12064,
         'min': 0.0,
-        'max': 2893.0,
-        'q_0.25': 5.0,
-        'q_0.50': 37.0,
-        'q_0.75': 106.0,
-        'med': 37.0,
-        'sum': 12690,
-        'shape': (116,),
+        'max': 4327.0,
+        'q_0.25': 6.0,
+        'q_0.50': 50.0,
+        'q_0.75': 134.0,
+        'med': 50.0,
+        'sum': 19200,
+        'shape': (117,),
     }
 
 :mod:`ubelt.orderedset`
@@ -301,6 +302,7 @@ my own code (excluding ubelt itself).
 :func:`<ubelt.userhome><ubelt.util_path.userhome>`
 :func:`<ubelt.ensuredir><ubelt.util_path.ensuredir>`
 :func:`<ubelt.expandpath><ubelt.util_path.expandpath>`
+:func:`<ubelt.ChDir><ubelt.util_path.ChDir>`
 
 :mod:`ubelt.util_platform`
 --------------------------