micropython-stubber 1.24.1__py3-none-any.whl → 1.24.4__py3-none-any.whl

mpflash/mpflash/versions.py

@@ -1,123 +0,0 @@
-"""
-Version handling for mpflash and micropython-stubber
-"""
-
-from pathlib import Path
-
-from cache_to_disk import NoCacheCondition, cache_to_disk
-from loguru import logger as log
-from packaging.version import Version, parse
-
-import mpflash.basicgit as git
-from mpflash.common import GH_CLIENT
-
-OLDEST_VERSION = "1.16"
-"This is the oldest MicroPython version to build the stubs on"
-
-V_PREVIEW = "preview"
-"Latest preview version"
-
-SET_PREVIEW = {"preview", "latest", "master"}
-
-
-def clean_version(
-    version: str,
-    *,
-    build: bool = False,
-    patch: bool = False,
-    commit: bool = False,
-    drop_v: bool = False,
-    flat: bool = False,
-):  # sourcery skip: assign-if-exp
-    "Clean up and transform the many flavours of versions"
-    # 'v1.13.0-103-gb137d064e' --> 'v1.13-103'
-    if version in {"", "-"}:
-        return version
-    if version.lower() == "stable":
-        _v = get_stable_mp_version()
-        if not _v:
-            log.warning("Could not determine the latest stable version")
-            return "stable"
-        version = _v
-        log.trace(f"Using latest stable version: {version}")
-    is_preview = "-preview" in version
-    nibbles = version.split("-")
-    ver_ = nibbles[0].lower().lstrip("v")
-    if not patch and ver_ >= "1.10.0" and ver_ < "1.20.0" and ver_.endswith(".0"):
-        # remove the last ".0" - but only for versions between 1.10 and 1.20 (because)
-        nibbles[0] = nibbles[0][:-2]
-    if len(nibbles) == 1:
-        version = nibbles[0]
-    elif build and not is_preview:
-        # HACK: this is not always right, but good enough most of the time
-        version = "-".join(nibbles) if commit else "-".join(nibbles[:-1])
-    elif is_preview:
-        version = "-".join((nibbles[0], V_PREVIEW))
-    else:
-        version = V_PREVIEW
-    if flat:
-        version = version.strip().replace(".", "_").replace("-", "_")
-    else:
-        version = version.strip().replace("_preview", "-preview").replace("_", ".")
-
-    if drop_v:
-        version = version.lstrip("v")
-    elif not version.startswith("v") and version.lower() not in SET_PREVIEW:
-        version = "v" + version
-    if version in SET_PREVIEW:
-        version = V_PREVIEW
-    return version
-
-
-def is_version(version: str):
-    """Check if the version is a valid version string"""
-    return Version._regex.search(version) is not None
-
-
-@cache_to_disk(n_days_to_cache=1)
-def micropython_versions(minver: str = "v1.20", reverse: bool = False, cache_it=True):
-    """Get the list of micropython versions from github tags"""
-
-    try:
-        gh_client = GH_CLIENT
-        repo = gh_client.get_repo("micropython/micropython")
-        tags = [tag.name for tag in repo.get_tags() if parse(tag.name) >= parse(minver)]
-        versions = [v for v in tags if not v.endswith(V_PREVIEW)]
-        # Only keep the last preview
-        preview = sorted([v for v in tags if v.endswith(V_PREVIEW)], reverse=True)[0]
-        versions.append(preview)
-    except Exception as e:
-        log.error(e)
-        versions = []
-        # returns - but does not cache
-        raise NoCacheCondition(function_value=versions)
-    # remove any duplicates and sort
-    versions = sorted(list(set(versions)), reverse=reverse, key=lambda s: (not is_version(s), s))
-    if cache_it:
-        return versions
-    # returns - but does not cache
-    raise NoCacheCondition(function_value=versions)
-
-
-def get_stable_mp_version(cache_it=True) -> str:
-    # read the versions from the git tags
-    all_versions = micropython_versions(minver=OLDEST_VERSION, cache_it=cache_it)
-    versions = [v for v in all_versions if not v.endswith(V_PREVIEW)]
-    return versions[-1] if versions else ""
-
-
-def get_preview_mp_version(cache_it=True) -> str:
-    # read the versions from the git tags
-    all_versions = micropython_versions(minver=OLDEST_VERSION, cache_it=cache_it)
-    versions = [v for v in all_versions if v.endswith(V_PREVIEW)]
-    return versions[0] if versions else ""
-
-
-# Do not cache , same path will have different versions checked out
-def checkedout_version(path: Path, flat: bool = False) -> str:
-    """Get the checked-out version of the repo"""
-    version = git.get_local_tag(path.as_posix())
-    if not version:
-        raise ValueError("No valid Tag found")
-    version = clean_version(version, flat=flat, drop_v=False)
-    return version