initial working version

Author: dlech

.gitattributes

@@ -0,0 +1 @@
+* text eol=lf

.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+*.pyc

README.md

@@ -0,0 +1,33 @@
+# Python packaging for multi-target mpy-cross
+
+This repository contains Python packaging to distribute the `mpy-cross` tool
+from [MicroPython](https://github.com/micropython/micropython) via PyPI.
+
+This package includes multiple versions of `mpy-cross` to support different
+MicroPython runtime versions.
+
+## Installation
+
+To install the latest version of `mpy-cross-multi`:
+
+    pip install mpy-cross-multi
+
+## Usage
+
+This package can be used programmatically or as a command line script.
+
+### Script
+
+This can be used just like the original `mpy-cross` tool: by substituting
+the name `mpy-cross` with `mpy-cross-multi` in the command line.
+
+    mpy-cross-multi --version
+
+It has an optional extra command line option to target older MicroPython
+runtimes. The oldest support MicroPython runtime is v1.12.
+
+    mpy-cross-multi --micropython 1.22 ...
+
+### API
+
+TODO

mpy_cross_multi/__init__.py

@@ -0,0 +1,35 @@
+from semver.version import Version
+
+
+def _mp_version_to_mpy_abi_version(mp_ver: Version) -> str:
+    """
+    Convert MicroPython version to mpy-cross ABI version.
+
+    See https://docs.micropython.org/en/latest/reference/mpyfiles.html#versioning-and-compatibility-of-mpy-files
+
+    Parameters:
+        mp_ver: MicroPython version
+
+    Returns:
+        str: mpy-cross ABI version
+
+    Raises:
+        TypeError: If the input is not a valid version string
+        NotImplementedError: If the MicroPython version is not supported
+    """
+    if mp_ver.match(">=1.23.0"):
+        raise NotImplementedError("MicroPython version must be <1.23.0")
+
+    if mp_ver.match(">=1.22.0"):
+        return "6.2"
+
+    if mp_ver.match(">=1.20.0"):
+        return "6.1"
+
+    if mp_ver.match(">=1.19.0"):
+        return "6"
+
+    if mp_ver.match(">=1.12.0"):
+        return "5"
+
+    raise NotImplementedError("MicroPython version must be >=1.12.0")

mpy_cross_multi/__main__.py

@@ -0,0 +1,66 @@
+import sys
+import subprocess
+import importlib
+import itertools
+
+from semver.version import Version
+
+from . import _mp_version_to_mpy_abi_version
+
+
+def _run():
+    """
+    Run mpy-cross directly with extra arg for getting the right version.
+    """
+
+    # remove the first argument (the script name)
+    # if there is --micropython=X.Y, split it into two arguments
+    args = list(
+        itertools.chain(
+            *(
+                arg.split("=") if arg.startswith("--micropython") else (arg,)
+                for arg in sys.argv[1:]
+            )
+        )
+    )
+
+    try:
+        idx = args.index("--micropython")
+    except ValueError:
+        # default if argument is not given
+        mp_ver = "1.22"
+    else:
+        # argument is given
+        mp_ver = args.pop(idx + 1)
+        # also remove the --micropython flag
+        del args[idx]
+
+    # validate the version argument
+    try:
+        mp_semver = Version.parse(mp_ver, optional_minor_and_patch=True)
+    except ValueError:
+        print(
+            f"Error: invalid version format for --micropython: '{mp_ver}'",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    try:
+        abi = _mp_version_to_mpy_abi_version(mp_semver)
+    except NotImplementedError:
+        print(
+            f"Error: targeting MicroPython v{mp_semver} is not supported",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    # get the right mpy-cross version for the target ABI
+    mpy_cross = importlib.import_module(f"mpy_cross_v{abi.replace('.', '_')}")
+
+    # run mpy-cross with the remaining arguments
+    proc = subprocess.run([mpy_cross.MPY_CROSS_PATH] + args)
+    sys.exit(proc.returncode)
+
+
+if __name__ == "__main__":
+    _run()

poetry.lock

@@ -0,0 +1,25 @@
+[tool.poetry]
+name = "mpy-cross-multi"
+version = "1.0.0"
+description = "MicroPython cross-compiler targeting multiple runtime versions."
+authors = ["David Lechner <[email protected]>"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.scripts]
+"mpy-cross-multi" = "mpy_cross_multi.__main__:_run"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+mpy-cross-v5 = "^1.0.2"
+mpy-cross-v6 = "^1.0.2"
+"mpy-cross-v6.1" = "^1.0.1"
+"mpy-cross-v6.2" = "^1.0.0"
+semver = "^3.0.2"
+
+[tool.poetry.group.dev.dependencies]
+ruff = "^0.4.3"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"