!url hg more

Author: tony

src/libvcs/url/hg.py

@@ -434,18 +434,18 @@ def is_valid(cls, url: str, is_explicit: Optional[bool] = None) -> bool:
 
         **Will** match normal ``hg(1)`` URLs, use :meth:`HgURL.is_valid` for that.
 
-        >>> HgURL.is_valid(url='https://hg.mozilla.org/mozilla-central/libvcs.hg')
+        >>> HgURL.is_valid(url='https://hg.mozilla.org/mozilla-central/libvcs')
         True
 
         >>> HgURL.is_valid(url='hg@hg.mozilla.org:MyProject/project')
         True
 
         Pip-style URLs:
 
-        >>> HgURL.is_valid(url='hg+https://hg.mozilla.org/mozilla-central/project.hg')
+        >>> HgURL.is_valid(url='hg+https://hg.mozilla.org/mozilla-central/project')
         True
 
-        >>> HgURL.is_valid(url='hg+ssh://hg@hg.mozilla.org:MyProject/project.hg')
+        >>> HgURL.is_valid(url='hg+ssh://hg@hg.mozilla.org:MyProject/project')
         True
 
         >>> HgURL.is_valid(url='notaurl')
@@ -457,24 +457,24 @@ def is_valid(cls, url: str, is_explicit: Optional[bool] = None) -> bool:
         unambigously narrow the type of VCS:
 
         >>> HgURL.is_valid(
-        ...     url='hg+ssh://hg@hg.mozilla.org:MyProject/libvcs.hg', is_explicit=True
+        ...     url='hg+ssh://hg@hg.mozilla.org:mozilla-central/image', is_explicit=True
         ... )
         True
 
-        Below, while it's GitHub, that doesn't necessarily mean that the URL itself
-        is conclusively a `hg` URL (e.g. the pattern is too lax):
+        Below, while it's hg.mozilla.org, that doesn't necessarily mean that the URL
+        itself is conclusively a `hg` URL (e.g. the pattern is too broad):
 
         >>> HgURL.is_valid(
-        ...     url='hg@hg.mozilla.org:MyProject/libvcs.hg', is_explicit=True
+        ...     url='hg@hg.mozilla.org:mozilla-central/image', is_explicit=True
         ... )
         False
 
-        You could create a HgHub rule that consider hg.mozilla.org hostnames to be
+        You could create a Mozilla rule that consider hg.mozilla.org hostnames to be
         exclusively hg:
 
-        >>> HgHubRule = Rule(
+        >>> MozillaRule = Rule(
         ...     # Since hg.mozilla.org exclusively serves hg repos, make explicit
-        ...     label='gh-rule',
+        ...     label='mozilla-rule',
         ...     description='Matches hg.mozilla.org https URLs, exact VCS match',
         ...     pattern=re.compile(
         ...         rf'''
@@ -492,21 +492,21 @@ def is_valid(cls, url: str, is_explicit: Optional[bool] = None) -> bool:
         ...     }
         ... )
 
-        >>> HgURL.rule_map.register(HgHubRule)
+        >>> HgURL.rule_map.register(MozillaRule)
 
         >>> HgURL.is_valid(
-        ...     url='hg@hg.mozilla.org:MyProject/libvcs.hg', is_explicit=True
+        ...     url='hg@hg.mozilla.org:mozilla-central/image', is_explicit=True
         ... )
         True
 
-        >>> HgURL(url='hg@hg.mozilla.org:MyProject/libvcs.hg').rule
-        'gh-rule'
+        >>> HgURL(url='hg@hg.mozilla.org:mozilla-central/image').rule
+        'mozilla-rule'
 
         This is just us cleaning up:
 
-        >>> HgURL.rule_map.unregister('gh-rule')
+        >>> HgURL.rule_map.unregister('mozilla-rule')
 
-        >>> HgURL(url='hg@hg.mozilla.org:MyProject/libvcs.hg').rule
+        >>> HgURL(url='hg@hg.mozilla.org:mozilla-central/mozilla-rule').rule
         'core-hg-scp'
         """
         return super().is_valid(url=url, is_explicit=is_explicit)