changeset 47030:c2b5365aa827

urlutil: introduce a new `list_paths` function

This function will be useful for command and template that wants to display path
related information.

Differential Revision: https://phab.mercurial-scm.org/D10440

--- a/mercurial/utils/urlutil.py	Thu Apr 15 10:05:51 2021 +0200
+++ b/mercurial/utils/urlutil.py	Thu Apr 15 11:46:31 2021 +0200
@@ -445,6 +445,18 @@
     return bytes(u)
 
 
+def list_paths(ui, target_path=None):
+    """list all the (name, paths) in the passed ui"""
+    if target_path is None:
+        return sorted(pycompat.iteritems(ui.paths))
+    else:
+        path = ui.paths.get(target_path)
+        if path is None:
+            return []
+        else:
+            return [(target_path, path)]
+
+
 def try_path(ui, url):
     """try to build a path from a url