mpflash 0.9.0__py3-none-any.whl → 0.9.1__py3-none-any.whl

mpflash/vendor/basicgit.py

@@ -1,288 +0,0 @@
-"""
-Simple Git module, where needed via powershell
-
-Some of the functions are based on the PyGithub module
-"""
-
-import os
-import subprocess
-from pathlib import Path
-from typing import List, Optional, Union
-
-import cachetools.func
-from github import Auth, Github
-from loguru import logger as log
-from packaging.version import parse
-
-# from stubber.utils.versions import SET_PREVIEW
-
-# Token with no permissions to avoid throttling
-# https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2022-11-28#getting-a-higher-rate-limit
-PAT_NO_ACCESS = (
-    "github_pat" + "_11AAHPVFQ0qAkDnSUaMKSp" + "_ZkDl5NRRwBsUN6EYg9ahp1Dvj4FDDONnXVgimxC2EtpY7Q7BUKBoQ0Jq72X"
-)
-PAT = os.environ.get("GITHUB_TOKEN") or PAT_NO_ACCESS
-GH_CLIENT = Github(auth=Auth.Token(PAT))
-
-
-def _run_local_git(
-    cmd: List[str],
-    repo: Optional[Union[Path, str]] = None,
-    expect_stderr=False,
-    capture_output=True,
-    echo_output=True,
-):
-    "run a external (git) command in the repo's folder and deal with some of the errors"
-    try:
-        if repo:
-            if isinstance(repo, str):
-                repo = Path(repo)
-            result = subprocess.run(
-                cmd, capture_output=capture_output, check=True, cwd=repo.absolute().as_posix(), encoding="utf-8"
-            )
-        else:
-            result = subprocess.run(cmd, capture_output=capture_output, check=True, encoding="utf-8")
-    except (NotADirectoryError, FileNotFoundError) as e:  # pragma: no cover
-        return None
-    except subprocess.CalledProcessError as e:  # pragma: no cover
-        # add some logging for github actions
-        log.error(f"{str(e)} : { e.stderr}")
-        return None
-    if result.stderr and result.stderr != b"":
-        stderr = result.stderr
-        if "cloning into" in stderr.lower():
-            # log.info(stderr)
-            expect_stderr = True
-        if "warning" in stderr.lower():
-            log.warning(stderr)
-            expect_stderr = True
-        elif capture_output and echo_output:  # pragma: no cover
-            log.info(stderr)
-        if not expect_stderr:
-            raise ChildProcessError(stderr)
-
-    if result.returncode and result.returncode < 0:
-        raise ChildProcessError(result.stderr)
-    return result
-
-
-def clone(remote_repo: str, path: Path, shallow: bool = False, tag: Optional[str] = None) -> bool:
-    """git clone [--depth 1] [--branch <tag_name>] <remote> <directory>"""
-    cmd = ["git", "clone"]
-    if shallow:
-        cmd += ["--depth", "1"]
-    if tag in {"preview", "latest", "master"}:
-        tag = None
-    cmd += [remote_repo, "--branch", tag, str(path)] if tag else [remote_repo, str(path)]
-    if result := _run_local_git(cmd, expect_stderr=True, capture_output=False):
-        return result.returncode == 0
-    else:
-        return False
-
-
-def get_local_tag(repo: Optional[Union[str, Path]] = None, abbreviate: bool = True) -> Union[str, None]:
-    """
-    get the most recent git version tag of a local repo
-    repo Path should be in the form of : repo = "./repo/micropython"
-
-    returns the tag or None
-    """
-    if not repo:
-        repo = Path(".")
-    elif isinstance(repo, str):
-        repo = Path(repo)
-
-    result = _run_local_git(
-        # ["git", "describe", "--tags"],
-        ["git", "describe", "--tags", "--dirty", "--always", "--match", "v[1-9].*"],
-        repo=repo.as_posix(),
-        expect_stderr=True,
-    )
-    if not result:
-        return None
-    tag: str = result.stdout
-    tag = tag.replace("\r", "").replace("\n", "")
-    if not abbreviate or "-" not in tag:
-        return tag
-    if "-preview" in tag:
-        tag = tag.split("-preview")[0] + "-preview"
-    return tag
-
-
-def get_local_tags(repo: Optional[Path] = None, minver: Optional[str] = None) -> List[str]:
-    """
-    get list of all tags of a local repo
-    """
-    if not repo:
-        repo = Path(".")
-
-    result = _run_local_git(["git", "tag", "-l"], repo=repo.as_posix(), expect_stderr=True)
-    if not result or result.returncode != 0:
-        return []
-    tags = result.stdout.replace("\r", "").split("\n")
-    tags = [tag for tag in tags if tag.startswith("v")]
-    if minver:
-        tags = [tag for tag in tags if parse(tag) >= parse(minver)]
-    return sorted(tags)
-
-
-@cachetools.func.ttl_cache(maxsize=16, ttl=60)  # 60 seconds
-def get_tags(repo: str, minver: Optional[str] = None) -> List[str]:
-    """
-    Get list of tag of a repote github repo
-    """
-    if not repo or not isinstance(repo, str) or "/" not in repo:  # type: ignore
-        return []
-    try:
-        gh_repo = GH_CLIENT.get_repo(repo)
-    except ConnectionError as e:
-        # TODO: unable to capture the exeption
-        log.warning(f"Unable to get tags - {e}")
-        return []
-    tags = [tag.name for tag in gh_repo.get_tags()]
-    if minver:
-        tags = [tag for tag in tags if parse(tag) >= parse(minver)]
-    return sorted(tags)
-
-
-def checkout_tag(tag: str, repo: Optional[Union[str, Path]] = None) -> bool:
-    """
-    checkout a specific git tag
-    """
-    cmd = ["git", "checkout", tag, "--quiet", "--force"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True, capture_output=True)
-    if not result:
-        return False
-    # actually a good result
-    msg = {result.stdout}
-    if msg != {""}:
-        log.warning(f"git message: {msg}")
-    return True
-
-
-def sync_submodules(repo: Optional[Union[Path, str]] = None) -> bool:
-    """
-    make sure any submodules are in sync
-    """
-    cmds = [
-        ["git", "submodule", "sync", "--quiet"],
-        # ["git", "submodule", "update", "--quiet"],
-        ["git", "submodule", "update", "--init", "lib/micropython-lib"],
-    ]
-    for cmd in cmds:
-        if result := _run_local_git(cmd, repo=repo, expect_stderr=True):
-            # actually a good result
-            log.debug(result.stderr)
-        else:
-            return False
-    return True
-
-
-def checkout_commit(commit_hash: str, repo: Optional[Union[Path, str]] = None) -> bool:
-    """
-    Checkout a specific commit
-    """
-    cmd = ["git", "checkout", commit_hash, "--quiet", "--force"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True)
-    if not result:
-        return False
-    # actually a good result
-    log.debug(result.stderr)
-    return True
-
-
-def switch_tag(tag: Union[str, Path], repo: Optional[Union[Path, str]] = None) -> bool:
-    """
-    switch to the specified version tag of a local repo
-    repo should be in the form of : path/.git
-    repo = '../micropython/.git'
-    returns None
-    """
-
-    cmd = ["git", "switch", "--detach", tag, "--quiet", "--force"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True)
-    if not result:
-        return False
-    # actually a good result
-    log.debug(result.stderr)
-    return True
-
-
-def switch_branch(branch: str, repo: Optional[Union[Path, str]] = None) -> bool:
-    """
-    switch to the specified branch in a local repo"
-    repo should be in the form of : path/.git
-    repo = '../micropython/.git'
-    returns None
-    """
-    cmd = ["git", "switch", branch, "--quiet", "--force"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True)
-    if not result:
-        return False
-    # actually a good result
-    log.debug(result.stderr)
-    return True
-
-
-def fetch(repo: Union[Path, str]) -> bool:
-    """
-    fetches a repo
-    repo should be in the form of : path/.git
-    repo = '../micropython/.git'
-    returns True on success
-    """
-    if not repo:
-        raise NotADirectoryError
-
-    cmd = ["git", "fetch", "--all", "--tags", "--quiet"]
-    result = _run_local_git(cmd, repo=repo, echo_output=False)
-    return result.returncode == 0 if result else False
-
-
-def pull(repo: Union[Path, str], branch: str = "main") -> bool:
-    """
-    pull a repo origin into main
-    repo should be in the form of : path/.git
-    repo = '../micropython/.git'
-    returns True on success
-    """
-    if not repo:
-        raise NotADirectoryError
-    repo = Path(repo)
-    # first checkout HEAD
-    cmd = ["git", "checkout", branch, "--quiet", "--force"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True)
-    if not result:
-        log.error("error during git checkout main", result)
-        return False
-
-    cmd = ["git", "pull", "origin", branch, "--quiet", "--autostash"]
-    result = _run_local_git(cmd, repo=repo, expect_stderr=True)
-    if not result:
-        log.error("error durign pull", result)
-        return False
-    return result.returncode == 0
-
-
-def get_git_describe(folder: Optional[str] = None):
-    """
-    Based on MicroPython makeversionhdr.py
-    returns : current git tag, commits ,commit hash : "v1.19.1-841-g3446"
-    """
-    # Note: git describe doesn't work if no tag is available
-    try:
-        git_describe = subprocess.check_output(
-            ["git", "describe", "--tags", "--dirty", "--always", "--match", "v[1-9].*"],
-            stderr=subprocess.STDOUT,
-            universal_newlines=True,
-            cwd=folder,
-        ).strip()
-    except subprocess.CalledProcessError as er:
-        if er.returncode == 128:
-            # git exit code of 128 means no repository found
-            return None
-        git_describe = ""
-    except OSError:
-        return None
-    # format
-    return git_describe

mpflash-0.9.0.dist-info/RECORD

@@ -1,52 +0,0 @@
-mpflash/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mpflash/add_firmware.py,sha256=QXk9P1UC0xvDlWhJ3Kj-Acy2wuxxK7R0L61KKiAjk1U,3337
-mpflash/ask_input.py,sha256=GGyOOlzpvhYmxyILVuNSj7hJlAvpPFXpP95erinTyCs,8717
-mpflash/bootloader/__init__.py,sha256=AbZJVbubvgcV0bQtItS9PEAvvPOKWLZpgi8DX5a5f5A,1282
-mpflash/bootloader/manual.py,sha256=tebIE2YBYvsWx2YmAcUcWnTnSjCqR1AwkXKVHJvnQkA,3002
-mpflash/bootloader/micropython.py,sha256=of9OuCchiGoczXPi6i0NT9LZHB9FgvigtZxWWvAcb2Q,399
-mpflash/bootloader/touch1200.py,sha256=D9yB1n2bSR-nyQDdQXJtCsNknSfHhI6hRziBqOv_HJI,1466
-mpflash/cli_download.py,sha256=qKZzHmuHazw5fhj_EGDu4DsqYCan41BK99nk1YWELFE,3527
-mpflash/cli_flash.py,sha256=IQfloZM1UK4VO4bo-8OxQkwH-RTGUFs7IWb-m4gFJJg,7136
-mpflash/cli_group.py,sha256=s180-nyUVNEwA5bPlkIum4mZPEW0Udf6oBAElnrjsvQ,2236
-mpflash/cli_list.py,sha256=AvYq5_Z7l0Z4rkbr23TwFNzstuZsQgopFpdcrTLwUvs,1965
-mpflash/cli_main.py,sha256=nFe30fOZZoz4zl3VkLUNoGv478etVtEEN-ccBmok9Tk,1093
-mpflash/common.py,sha256=ZfJR8dKKUy4VDZUgnDTILzuaem2o1Ix2haLxHQ47Z0o,5765
-mpflash/config.py,sha256=7-IL4R9oHeSh0jO-hppw8pDv990nEI31dwBzZFD50eY,1007
-mpflash/connected.py,sha256=vzQ6heV7w5Mnu76nR2dr9FiQ7Ja1x1Q_k0TGgdV1lT8,2955
-mpflash/download.py,sha256=EL17R88QO4TaiX-80GjjlEd6CNZ0vDOcWPuwewZ0_zs,13875
-mpflash/downloaded.py,sha256=n2iSVv3pS6rZmUr5ry8tOh-jSCZJdI-g_QJG8N5R1As,4815
-mpflash/errors.py,sha256=6lUhVtECY3syV2bBGKzegGH4pPKXhevvhYQZd74sy6o,238
-mpflash/flash.py,sha256=aC1z4Jq8b8a8O6rCTX1gdGcO5yM1vGoWlZGIWgKuHro,2059
-mpflash/flash_esp.py,sha256=j-VdSAKzNQZRVVO7oM9NcRAJWPDHsUianOien8rnYE8,2252
-mpflash/flash_stm32.py,sha256=JNY1bL-VNlnaQ6AhY9drKj8EgwpGwty0WAH1JD-Ecfs,584
-mpflash/flash_stm32_cube.py,sha256=TnLNqmJcdwRXWj_t0W4o-NmwBjd3z94qpjuyz77oP9o,3859
-mpflash/flash_stm32_dfu.py,sha256=GUJTU6bmxu4m9cK_wQKRCXPKSIf7F8BAxKMSDs59TwQ,2985
-mpflash/flash_uf2.py,sha256=f9CwUaBwnmgO9q7I5-Psbd0cStxyeiu0XDcu_OHlmVc,2796
-mpflash/flash_uf2_boardid.py,sha256=2s4K3QiKWK5HKFKWYsDV3hI8alfWSxEOMeurER3eZtM,408
-mpflash/flash_uf2_linux.py,sha256=I6KYbLrnn6lFvzoG-LFETak86VHuMG3XKpdrjCGH2co,3945
-mpflash/flash_uf2_macos.py,sha256=HqQ2HjXlTYzCC5DzjNaoCOR4QKKi5UzjqJcfZVJLaKM,998
-mpflash/flash_uf2_windows.py,sha256=Pg2siQENEqLddM7KKl9PdXtP7HzBsPICxo8uVCgn57E,1050
-mpflash/list.py,sha256=pSV9WJozObPSnW-oYs2JPdmh2PtCPJUNgvrozclpnU4,2874
-mpflash/logger.py,sha256=BAVrSXMGZLfSDRFbtVBtvb7Rl0sTJxooCgBS5t-6bXo,1057
-mpflash/mpboard_id/__init__.py,sha256=yeSWAP1YJWYWB2i8KZlBK1l8loJRcDo-xdymuCv92nU,3723
-mpflash/mpboard_id/add_boards.py,sha256=JgSXbK9aKtrSWQMIMYYW9OivuWXb1LLTIAmRthi1FC8,9429
-mpflash/mpboard_id/board.py,sha256=yQ8IDHQS09AelvTvmPhpmsL4oX3L7IXGqHorkxDOkoE,1114
-mpflash/mpboard_id/board_id.py,sha256=G5s-kMKAD-LGUAuU5eYnq25-MGIQPyB-zJojjcGawa4,2878
-mpflash/mpboard_id/board_info.zip,sha256=F6YowS96DAqjten4ySe4MXgZwPtE-saZOUfY5OQkqKk,19759
-mpflash/mpboard_id/store.py,sha256=lQQgHSxcaM_ZURcfZNSUv3-ZJjUKMC_xEOOSdpzVvBU,1493
-mpflash/mpremoteboard/__init__.py,sha256=j-Cex6TlihDp125gjGB01S_zE9nIq4mdRfamWjnOJoA,7549
-mpflash/mpremoteboard/mpy_fw_info.py,sha256=BTupe4rZDTs3UHRqvs429XqWHCchSpwa05yACOiOt5U,4413
-mpflash/mpremoteboard/runner.py,sha256=YUmo5Y0aOgMaww8CXSdNdgXD-wRKncILuMZ0OB_2qRU,4646
-mpflash/uf2disk.py,sha256=dQ8_U6e3qkFOyfXZDpWAsvEBIlMr-ZzLkzTDD8SADqM,286
-mpflash/vendor/basicgit.py,sha256=b6-gdK_DT0dmW3jEY9T0cjKR-TSEQOSl9U9sRcJh538,9257
-mpflash/vendor/click_aliases.py,sha256=K98inhtze8td1dw312kexJS7OX_0ojlptPQ5Z0SHxJY,3065
-mpflash/vendor/dfu.py,sha256=jGsiD3lbSV1Ar9qJubhoY_hy-L8FI-K55aow8vgwoYQ,5590
-mpflash/vendor/pydfu.py,sha256=1ObubGsPFrQ7T9M3JRlIPNIG2xx8uYffaEe0Y6bdf_g,19937
-mpflash/vendor/readme.md,sha256=ZVg7kuUYyXcWcrWkaSJ0CunwebCqu2SiS2sqDadwrT8,84
-mpflash/vendor/versions.py,sha256=osv5yFyg47_BZ85k3LRrzjyPu6T4psx56rgBN3YXMyM,3885
-mpflash/worklist.py,sha256=j64PVJXm8jhLzPUQt3rnJXCbT1JEczTax46mRWID9bM,5809
-mpflash-0.9.0.dist-info/LICENSE,sha256=xHwgxGNkI0R2iN4KNfbPbQSzRomWyRz7bJnR1O2mln8,1057
-mpflash-0.9.0.dist-info/METADATA,sha256=B5R5UZfNdyGhHZJZboAlHOOmxzwHW4PmTbzmI9Xh0TY,15275
-mpflash-0.9.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-mpflash-0.9.0.dist-info/entry_points.txt,sha256=Jk_visOhYOsZIcSP2Ms9hKqfKy1iorR-6dYltSoWCpY,52
-mpflash-0.9.0.dist-info/RECORD,,