# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1618479991 -7200
# Node ID c2b5365aa827dd195b26101d216befd6fd109311
# Parent  9ea75ea235347aa20e93de6c24afc6912fee498a
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

diff -r 9ea75ea23534 -r c2b5365aa827 mercurial/utils/urlutil.py
--- 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