feat(parser,is_valid): Optionally check for is_explicit

Author: tony

libvcs/parse/base.py

@@ -1,5 +1,5 @@
 import dataclasses
-from typing import Iterator, Pattern, Protocol
+from typing import Iterator, Optional, Pattern, Protocol
 
 from libvcs._internal.dataclasses import SkipDefaultFieldsReprMixin
 
@@ -13,7 +13,7 @@ def __init__(self, url: str):
     def to_url(self) -> str:
         ...
 
-    def is_valid(self, url: str) -> bool:
+    def is_valid(self, url: str, is_explicit: Optional[bool] = None) -> bool:
         ...
 
 

libvcs/parse/git.py

@@ -278,7 +278,7 @@ def __post_init__(self):
                     setattr(self, k, v)
 
     @classmethod
-    def is_valid(cls, url: str) -> bool:
+    def is_valid(cls, url: str, is_explicit: Optional[bool] = None) -> bool:
         """Whether URL is compatible with VCS or not.
 
         Examples
@@ -293,6 +293,12 @@ def is_valid(cls, url: str) -> bool:
         >>> GitURL.is_valid(url='notaurl')
         False
         """
+        if is_explicit is not None:
+            return any(
+                re.search(matcher.pattern, url)
+                for matcher in cls.matchers.values()
+                if matcher.is_explicit == is_explicit
+            )
         return any(re.search(matcher.pattern, url) for matcher in cls.matchers.values())
 
     def to_url(self) -> str:

libvcs/parse/hg.py

@@ -195,7 +195,7 @@ def __post_init__(self):
                     setattr(self, k, v)
 
     @classmethod
-    def is_valid(cls, url: str) -> bool:
+    def is_valid(cls, url: str, is_explicit: Optional[bool] = False) -> bool:
         """Whether URL is compatible with VCS or not.
 
         Examples

libvcs/parse/svn.py

@@ -189,7 +189,7 @@ def __post_init__(self):
                     setattr(self, k, v)
 
     @classmethod
-    def is_valid(cls, url: str) -> bool:
+    def is_valid(cls, url: str, is_explicit: Optional[bool] = False) -> bool:
         """Whether URL is compatible with VCS or not.
 
         Examples