Add functions to extract name/version of filename

src/commoncode/version.py

@@ -7,6 +7,8 @@
 #
 
 import re
+from collections import namedtuple
+from os import path
 
 
 def VERSION_PATTERNS_REGEX():
@@ -37,7 +39,7 @@ def VERSION_PATTERNS_REGEX():
 
 def hint(path):
     """
-    Return a version found in a path or None. Prefix the version with 'v ' if
+    Return a version found in a ``path`` or None. Prefix the version with 'v ' if
     the version does not start with v.
     """
     for pattern in VERSION_PATTERNS_REGEX():
@@ -54,3 +56,225 @@ def hint(path):
                 if not v.lower().startswith('v'):
                     v = f'v {v}'
                 return v
+
+
+def is_dot_num(s):
+    """
+    Return True if a version string `s` is semver-like and composed only of dots
+    and numbers.
+    """
+    return s.strip(".0123456789") == "" and not s.startswith(".") and not s.endswith(".")
+
+
+common_version_suffixes = (
+    "final",
+    "release",
+    "snapshot",
+    "jre",
+    "android",
+    "pre",
+    "alpha",
+    "beta",
+    "rc",
+)
+common_dash_version_suffixes = tuple(f"-{s}" for s in common_version_suffixes)
+
+
+def is_moslty_num(s):
+    """
+    Return True if a version string `s` is primarily composed only of dots and
+    numbers, with a minority of letters.
+
+    >>> is_moslty_num("v11r2")
+    True
+    """
+    dot_segments = s.split(".")
+    len_alpha = 0
+    len_digit = 0
+    first_seg = dot_segments[0].lstrip("vV")
+    starts_with_digit = first_seg.isdigit()
+    for dot_seg in dot_segments:
+        dot_seg = dot_seg.lstrip("vV")
+        for seg in re.split("([0-9]+|[a-zA-Z]+)", dot_seg):
+            if seg.isdigit():
+                len_digit += len(seg)
+            elif seg.isalpha() and seg.lower() not in common_version_suffixes:
+                len_alpha += len(seg)
+
+    if not len_alpha and not len_digit:
+        return False
+
+    if not len_alpha:
+        return True
+
+    # we want twice more digits than alphas
+    if (2 * len_alpha) < len_digit:
+        return True
+
+    if starts_with_digit and len_alpha < len_digit:
+        return True
+
+    return False
+
+
+NameVersion = namedtuple('NameVersion', 'name, version')
+
+
+def get_jar_nv(filename):
+    """
+    Return a NameVersion tuple parsed from the JAR `filename` or None.
+
+    For example::
+        >>> get_jar_nv('org.eclipse.persistence.antlr_3.2.0.v201302191141.jar')
+        NameVersion(name='org.eclipse.persistence.antlr', version='3.2.0.v201302191141')
+        >>> get_jar_nv('org.eclipse.persistence.antlr.jar')
+        NameVersion(name='org.eclipse.persistence.antlr', version=None)
+        >>> get_jar_nv('org.eclipse.persistence.core_2.4.2.v20130514-5956486.jar')
+        NameVersion(name='org.eclipse.persistence.core', version='2.4.2.v20130514-5956486')
+
+        >>> get_jar_nv('com.io7m.jareas.checkstyle-0.2.2.jar')
+        NameVersion(name='com.io7m.jareas.checkstyle', version='0.2.2')
+
+        >>> get_jar_nv('ant-contrib-1.0b3.jar')
+        NameVersion(name='ant-contrib', version='1.0b3')
+        >>> get_jar_nv('xpp3-1.1.3.4.C.jar')
+        NameVersion(name='xpp3', version='1.1.3.4.C')
+        >>> get_jar_nv('ojdbc6_v11r2.jar')
+        NameVersion(name='ojdbc6', version='v11r2')
+
+        >>> get_jar_nv('amazon-sqs-java-messaging-lib-1.0.8.jar')
+        NameVersion(name='amazon-sqs-java-messaging-lib', version='1.0.8')
+        >>> get_jar_nv('annotations-4.1.1.4.jar')
+        NameVersion(name='annotations', version='4.1.1.4')
+        >>> get_jar_nv('aws-swf-build-tools-1.10.jar')
+        NameVersion(name='aws-swf-build-tools', version='1.10')
+        >>> get_jar_nv('c3p0-0.9.1.1.jar')
+        NameVersion(name='c3p0', version='0.9.1.1')
+        >>> get_jar_nv('javax.persistence_2.0.5.v201212031355.jar')
+        NameVersion(name='javax.persistence', version='2.0.5.v201212031355')
+        >>> get_jar_nv('proto-google-cloud-pubsub-v1-1.95.4.jar')
+        NameVersion(name='proto-google-cloud-pubsub-v1', version='1.95.4')
+
+        >>> get_jar_nv('xpp3-1.1.4c.jar')
+        NameVersion(name='xpp3', version='1.1.4c')
+
+        >>> get_jar_nv('listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar')
+        NameVersion(name='listenablefuture-9999.0-empty-to-avoid-conflict-with-guava', version=None)
+
+        >>> get_jar_nv('aspectjweaver.jar')
+        NameVersion(name='aspectjweaver', version=None)
+        >>> get_jar_nv('flyway-client.jar')
+        NameVersion(name='flyway-client', version=None)
+        >>> get_jar_nv('jakarta.xml.bind-api.jar')
+        NameVersion(name='jakarta.xml.bind-api', version=None)
+        >>> get_jar_nv('javax.enterprise.concurrent.jar')
+        NameVersion(name='javax.enterprise.concurrent', version=None)
+
+        >>> get_jar_nv('netty-codec-http-4.1.53.Final.jar')
+        NameVersion(name='netty-codec-http', version='4.1.53.Final')
+        >>> get_jar_nv('spring-context-3.0.7.RELEASE.jar')
+        NameVersion(name='spring-context', version='3.0.7.RELEASE')
+
+        >>> get_jar_nv('guava-30.1-jre.jar')
+        NameVersion(name='guava', version='30.1-jre')
+        >>> get_jar_nv('guava-30.1.1-android.jar')
+        NameVersion(name='guava', version='30.1.1-android')
+
+        >>> get_jar_nv('guava-30.1.1-android.foo')
+
+    """
+    if not filename.endswith(".jar"):
+        return
+
+    basename, _extension = path.splitext(filename)
+
+    # JAR name/version come in many flavors
+    # amazon-sqs-java-messaging-lib-1.0.8.jar  is a plain name-ver
+    if "_" in basename:
+        # org.eclipse.persistence.antlr_3.2.0.v201302191141.jar
+        name, _, version = basename.rpartition("_")
+        if (
+            is_dot_num(version)
+            or is_moslty_num(version)
+            or version.lower().endswith(common_version_suffixes)
+        ):
+            return NameVersion(name, version)
+
+    if "-" in basename:
+        # amazon-sqs-java-messaging-lib-1.0.8.jar
+        dashname = basename
+        suffix = ""
+        for cs in common_dash_version_suffixes:
+            if dashname.endswith(cs):
+                dashname, _, suff = dashname.rpartition("-")
+                suffix = f"-{suff}"
+                break
+
+        name, _, version = dashname.rpartition("-")
+        if (
+            is_dot_num(version)
+            or is_moslty_num(version)
+            or version.lower().endswith(common_version_suffixes)
+        ):
+            return NameVersion(name, f"{version}{suffix}")
+
+    # no dash, no underscore means no version: org.eclipse.persistence.antlr.jar
+    return NameVersion(basename, None)
+
+
+def get_nupkg_nv(filename):
+    """
+    Return a NameVersion tuple parsed from the .nupkg NuGet archive `filename`.
+
+    For example (taken from https://stackoverflow.com/questions/51662737/regex-to-parse-package-name-and-version-number-from-nuget-package-filenames/51662926):
+        >>> get_nupkg_nv('knockoutjs.3.4.2.nupkg')
+        NameVersion(name='knockoutjs', version='3.4.2')
+        >>> get_nupkg_nv('log4net.2.0.8.nupkg')
+        NameVersion(name='log4net', version='2.0.8')
+
+        >>> get_nupkg_nv('runtime.tizen.4.0.0-armel.microsoft.netcore.jit.2.0.0.nupkg')
+        NameVersion(name='runtime.tizen.4.0.0-armel.microsoft.netcore.jit', version='2.0.0')
+        >>> get_nupkg_nv('nuget.core.2.7.0-alpha.nupkg')
+        NameVersion(name='nuget.core', version='2.7.0-alpha')
+
+        >>> get_nupkg_nv('microsoft.identitymodel.6.1.7600.16394.nupkg')
+        NameVersion(name='microsoft.identitymodel', version='6.1.7600.16394')
+
+        >>> get_nupkg_nv('guava.30.1.1.foo')
+    """
+    if not filename.endswith(".nupkg"):
+        return
+
+    basename, _extension = path.splitext(filename)
+
+    # Either the last 3 or 4 segments are all digits in which case this is the
+    # version. Otherwise we consider as version anything after the first all
+    # digit segment starting from left.
+
+    dot_segments = basename.split(".")
+    len_dot_segments = len(dot_segments)
+    if len_dot_segments > 4 and all(s.isdigit() for s in dot_segments[-4:]):
+        names = dot_segments[:-4]
+        versions = dot_segments[-4:]
+        return NameVersion(".".join(names), ".".join(versions))
+
+    if len_dot_segments > 3 and all(s.isdigit() for s in dot_segments[-3:]):
+        names = dot_segments[:-3]
+        versions = dot_segments[-3:]
+        return NameVersion(".".join(names), ".".join(versions))
+
+    names = []
+    versions = []
+    in_version = False
+    for seg in dot_segments:
+        if in_version:
+            versions.append(seg)
+            continue
+
+        if not seg.isdigit():
+            names.append(seg)
+        else:
+            versions.append(seg)
+            in_version = True
+
+    return NameVersion(".".join(names), ".".join(versions))