agx-openplx 0.15.0__cp39-cp39-macosx_12_0_arm64.whl

openplx/migrate.py

@@ -0,0 +1,136 @@
+#!/usr/bin/env python3
+"""
+Command line utility that helps migrating OpenPLX files to a newer version
+"""
+from pathlib import Path
+import itertools
+import os
+import tempfile
+import json
+import urllib.request
+import zipfile
+from io import BytesIO
+from argparse import ArgumentParser, ArgumentDefaultsHelpFormatter, SUPPRESS
+from openplx import __version__, get_error_strings
+from openplx.Core import OpenPlxContext, parseFromFile, analyze, StringVector, DocumentVector
+from openplx.migrations import collect_migrations, ReplaceOp
+from openplx.versionaction import VersionAction
+
+def download_package_version(package_name, version):
+    """Download a specific version of a package from PyPI."""
+    url = f"https://pypi.org/pypi/{package_name}/{version}/json"
+    with urllib.request.urlopen(url, timeout=16) as response:
+        content = response.read().decode('utf-8')
+    data = json.loads(content)
+    return data['urls'][0]['url']
+
+def unzip_package(url, extract_to):
+    """Download and unzip a package."""
+    with urllib.request.urlopen(url, timeout=32) as response:
+        file_data = BytesIO(response.read())
+    with zipfile.ZipFile(file_data) as zip_file:
+        zip_file.extractall(extract_to)
+
+def parse_args():
+    parser = ArgumentParser(description="Migrates a .openplx file from an older to a newer version", formatter_class=ArgumentDefaultsHelpFormatter)
+    parser.add_argument("openplxfile", metavar="path", help="the .openplx file or directory to migrate")
+    parser.add_argument("--version", help="Show version", action=VersionAction, nargs=0, default=SUPPRESS)
+    parser.add_argument("--from-version", help="Version to convert from", required=True)
+    parser.add_argument("--to-version", help="Version to convert to", default=__version__)
+    return parser.parse_known_args()
+
+def parse_and_analyze(openplxfile, openplx_context):
+    parse_result = parseFromFile(str(Path(openplxfile).absolute()), openplx_context)
+
+    documents = DocumentVector()
+
+    if parse_result[0] is None:
+        return documents
+
+    analyze(openplx_context, None)
+
+    documents.push_back(parse_result[0])
+    return documents
+
+def has_errors(openplx_context):
+    if openplx_context.hasErrors():
+        error_strings = get_error_strings(openplx_context.getErrors())
+        for e_s in error_strings:
+            print(e_s)
+        return True
+    return False
+
+def refactor_openplx_file(openplxfile, bundle_path_vec, from_version, to_version) -> bool:
+    print(f"Migrating {openplxfile} from {from_version} to {to_version}")
+    openplx_context = OpenPlxContext(bundle_path_vec)
+    migrations = collect_migrations(from_version, to_version)
+
+    documents = parse_and_analyze(openplxfile, openplx_context)
+
+    if has_errors(openplx_context):
+        return False
+
+    print(f"Found {len(migrations)} migrations ", [m.__name__ for m in migrations])
+
+    order_group = [(key, list(group)) for key, group in itertools.groupby(migrations, lambda m: m.openplx_order)]
+    order_group.sort(key=lambda pair: pair[0])
+
+    for _, migration_group in order_group:
+        ops = []
+        for migration in migration_group:
+            ops.extend(migration(documents))
+
+        for key, op_group in itertools.groupby(ops, lambda op: op.path):
+            if Path(openplxfile).samefile(key):
+                with open(key, 'r', encoding="utf8") as file:
+                    lines = file.readlines()
+                lines = ReplaceOp.apply_many(op_group, lines)
+                with open(key, 'w', encoding="utf8") as file:
+                    file.writelines(lines)
+    return True
+
+def run_openplx_migrate(args):
+
+    # NOTE: Depending on version, we need to change the package_name
+    package_name = 'brickbundles'
+
+    # Download the package
+    url = download_package_version(package_name, args.from_version)
+    if url is None:
+        print(f"Could not find the source distribution for {package_name}=={args.from_version}.")
+        return
+
+    # Create a temporary directory
+    with tempfile.TemporaryDirectory() as tmpdirname:
+        tmp_path = str(Path(os.path.realpath(tmpdirname)).absolute())
+        print(f"Extracting to temporary directory: {tmp_path}")
+        unzip_package(url, tmp_path)
+        print(f"Package {package_name}=={args.from_version} extracted to {tmp_path}")
+        bundle_path = str((Path(tmp_path) / package_name).absolute())
+
+        print(f'Using bundle path {bundle_path}')
+        print(os.listdir(bundle_path))
+
+        bundle_path_vec = StringVector()
+        bundle_path_vec.push_back(bundle_path)
+        success = True
+        # Apply the refactoring
+        if os.path.isdir(args.openplxfile):
+            for root, _, files in os.walk(args.openplxfile):
+                for file in files:
+                    if file.endswith(".openplx") and not file.endswith("config.openplx"):
+                        openplxfile = os.path.join(root, file)
+                        if not refactor_openplx_file(openplxfile, bundle_path_vec, args.from_version, args.to_version):
+                            success = False
+        else:
+            if not refactor_openplx_file(args.openplxfile, bundle_path_vec, args.from_version, args.to_version):
+                success = False
+        if success:
+            print(f"Refactor from {args.from_version} to {args.to_version} complete!")
+        else:
+            print(f"Refactor from {args.from_version} to {args.to_version} failed due to errors!")
+            print("Note, some files might have been partially migrated.")
+
+if __name__ == '__main__':
+    arguments, _ = parse_args()
+    run_openplx_migrate(arguments)

openplx/migration_hint.py

@@ -0,0 +1,14 @@
+"""
+Migration hint for use by cmdline tools
+"""
+from openplx import check_if_migrate_hint_is_justified, __version__
+
+class Ansi: # pylint: disable=too-few-public-methods # This is basically an enum, but we do not want to use Enum
+    WARNING = '\033[93m'
+    ENDC = '\033[0m'
+
+def check_migration_hint(openplxfile, errors):
+    old_version = check_if_migrate_hint_is_justified(__version__, errors)
+    if old_version:
+        print(f"{Ansi.WARNING}Dependency errors might be due to upgrade. If so, try running: "
+                f"openplx_migrate --from-version {old_version} {openplxfile}{Ansi.ENDC}")

openplx/migrations.py

@@ -0,0 +1,521 @@
+"""
+This module contains migration functions that can be used to refactor code in a backwards compatible way.
+"""
+
+import functools
+import sys
+import re
+from pathlib import Path
+import itertools
+from abc import ABC, abstractmethod
+from openplx.Core import RefactorReplaceOp, RefactorToolkit
+
+
+def migration(from_version: str, to_version: str, order: int = 0):
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            result = func(*args, **kwargs)
+            return result
+
+        wrapper.openplx_from_version = from_version
+        wrapper.openplx_to_version = to_version
+        wrapper.openplx_order = order
+        return wrapper
+
+    return decorator
+
+
+@migration("0.9.2", "0.9.3")
+def snakecaseify_methods(documents):
+    ops = []
+    ops.extend(RefactorToolkit.renameMethod(documents, "Math.Vec3.fromXYZ", "from_xyz"))
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Vec3.angleBetweenVectors", "angle_between_vectors"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Vec3.getOrthogonalUnitVector", "get_orthogonal_unit_vector"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(documents, "Math.Quat.angleAxis", "angle_axis")
+    )
+    ops.extend(RefactorToolkit.renameMethod(documents, "Math.Quat.fromTo", "from_to"))
+    ops.extend(
+        RefactorToolkit.renameMethod(documents, "Math.Quat.fromXYZW", "from_xyzw")
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.AffineTransform.fromAxes", "from_axes"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.AffineTransform.inverseOf", "inverse_of"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.AffineTransform.transformVec3Point", "transform_vec3_point"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Math.AffineTransform.transformVec3Vector",
+            "transform_vec3_vector",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix3x3.fromRowMajor", "from_row_major"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(documents, "Math.Matrix3x3.fromRows", "from_rows")
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix3x3.fromColumns", "from_columns"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix4x4.fromRowMajor", "from_row_major"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(documents, "Math.Matrix4x4.fromRows", "from_rows")
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix4x4.fromColumns", "from_columns"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix4x4.fromVec3Quat", "from_vec3_quat"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix4x4.getAffineTranslation", "get_affine_translation"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Math.Matrix4x4.getAffineRotation", "get_affine_rotation"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Functions.harmonicMean", "harmonic_mean"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(documents, "Math.Line.fromPoints", "from_points")
+    )
+
+    return [ReplaceOp(op) for op in ops]
+
+
+@migration("0.9.3", "0.10.0")
+def snakecaseify_methods_093(documents):
+    ops = []
+    # ValueOutputSignal
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.fromAngle", "from_angle"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromAngularVelocity1D",
+            "from_angular_velocity_1d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.fromDistance", "from_distance"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.fromForce1D", "from_force_1d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromVelocity1D",
+            "from_velocity_1d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromTorque1D",
+            "from_torque_1d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromAcceleration3D",
+            "from_acceleration_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromAngularAcceleration3D",
+            "from_angular_acceleration_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromAngularVelocity3D",
+            "from_angular_velocity_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.fromForce3D", "from_force_3d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromTorque3D",
+            "from_torque_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromVelocity3D",
+            "from_velocity_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.fromPosition3D",
+            "from_position_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.fromRPY", "from_rpy"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.isReal", "is_real"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asReal", "as_real"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asVec3", "as_vec3"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asAngle", "as_angle"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asAngularVelocity1D",
+            "as_angular_velocity_1d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asDistance", "as_distance"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asForce1D", "as_force_1d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asVelocity1D",
+            "as_velocity_1d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asTorque1D", "as_torque_1d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asAcceleration3D",
+            "as_acceleration_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asAngularAcceleration3D",
+            "as_angular_acceleration_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asAngularVelocity3D",
+            "as_angular_velocity_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asForce3D", "as_force_3d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Physics.Signals.ValueOutputSignal.asTorque3D", "as_torque_3d"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asVelocity3D",
+            "as_velocity_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents,
+            "Physics.Signals.ValueOutputSignal.asPosition3D",
+            "as_position_3d",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameMethod(
+            documents, "Robotics.Signals.RobotInputSignal.fromValues", "from_values"
+        )
+    )
+
+    # DriveTrain.Signals
+    ops.extend(
+        RefactorToolkit.moveAndRenameModel(
+            documents,
+            "DriveTrain.Signals.CombustionEngineThrottleInput",
+            "Physics.Signals",
+            "FractionInput",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.moveAndRenameModel(
+            documents,
+            "DriveTrain.Signals.CombustionEngineTorqueOutput",
+            "Physics.Signals",
+            "Torque1DOutput",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.moveAndRenameModel(
+            documents,
+            "DriveTrain.Signals.GearTorqueOutput",
+            "Physics.Signals",
+            "Torque1DOutput",
+        )
+    )
+
+    return [ReplaceOp(op) for op in ops]
+
+
+@migration("0.10.3", "0.11.0")
+def migrations_for_0_10_3(documents):
+    ops = []
+    # Physics3D.Transform -> Math.AffineTransform
+    ops.extend(
+        RefactorToolkit.moveAndRenameModel(
+            documents, "Physics3D.Transform", "Math", "AffineTransform"
+        )
+    )
+    # Robotics.Joints.FlexibleVelocityJoint -> Robotics.Joints.FlexibleAngularVelocityJoint
+    ops.extend(
+        RefactorToolkit.renameModel(
+            documents,
+            "Robotics.Joints.FlexibleVelocityJoint",
+            "FlexibleAngularVelocityJoint",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameModel(
+            documents,
+            "Physics3D.Signals.MateConnector.Velocity3DOutput",
+            "LinearVelocity3DOutput",
+        )
+    )
+    return [ReplaceOp(op) for op in ops]
+
+
+@migration("0.11.0", "0.11.1")
+def migrations_for_0_11_0(documents):
+    ops = []
+    ops.extend(
+        RefactorToolkit.renameModel(
+            documents,
+            "Physics3D.Signals.RigidBodyVelocityOutput",
+            "LinearVelocity3DOutput",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents, "Physics3D.Signals.RigidBodyVelocityOutput.rigid_body", "source"
+        )
+    )
+    return [ReplaceOp(op) for op in ops]
+
+
+@migration("0.12.1", "0.12.2")
+def migrations_for_0_12_1(documents):
+    ops = []
+    ops.extend(
+        RefactorToolkit.moveAndRenameModel(
+            documents,
+            "Physics3D.Signals.PrismaticVelocityOutput",
+            "Physics.Signals",
+            "LinearVelocity1DOutput",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents, "Physics3D.Signals.PrismaticVelocityOutput.prismatic", "source"
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents,
+            "DriveTrain.ManualClutch.initial_opening_fraction",
+            "initial_engagement_fraction",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents,
+            "DriveTrain.ManualClutch.opening_fraction_input",
+            "engagement_fraction_input",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents,
+            "DriveTrain.ManualClutch.opening_fraction_output",
+            "engagement_fraction_output",
+        )
+    )
+    ops.extend(
+        RefactorToolkit.renameAttribute(
+            documents,
+            "DriveTrain.AutomaticClutch.engage_time",
+            "engagement_time",
+        )
+    )
+
+    return [ReplaceOp(op) for op in ops]
+
+
+@migration("0.13.1", "0.13.2")
+def migrations_for_0_13_1(documents):
+    ops = []
+    # DriveTrain.Gear -> DriveTrain.FlexibleGear
+    ops.extend(
+        RefactorToolkit.renameModel(
+            documents,
+            "DriveTrain.Gear",
+            "FlexibleGear",
+        )
+    )
+
+    return [ReplaceOp(op) for op in ops]
+
+
+def split_version(v):
+    match = re.match(r"^(\d+)\.(\d+)\.(\d+)", v)
+
+    if not match:
+        raise ValueError("Invalid version format")
+
+    return tuple(int(part) for part in match.groups())
+
+
+def collect_migrations(from_version, to_version):
+    migrations = filter(
+        lambda obj: (
+            callable(obj)
+            and hasattr(obj, "openplx_from_version")
+            and hasattr(obj, "openplx_to_version")
+            and hasattr(obj, "openplx_order")
+            and split_version(from_version) <= split_version(obj.openplx_from_version)
+            and split_version(obj.openplx_from_version) < split_version(to_version)
+        ),
+        [obj for _, obj in globals().items()],
+    )
+
+    return sorted(list(migrations), key=lambda m: split_version(m.openplx_from_version))
+
+
+class MigrateOp(ABC):  # pylint: disable=R0903 # Too few public methods
+    @abstractmethod
+    def apply_to(self, lines, offset):
+        pass
+
+
+class ReplaceOp(MigrateOp):
+    def __init__(self, op: RefactorReplaceOp):
+        self.path = Path(op.source_id)
+        self.from_line = op.from_line
+        self.from_column = op.from_column
+        self.end_line = op.end_line
+        self.end_column = op.end_column
+        self.new_content = op.new_content
+
+    def __str__(self):
+        return f"{{{self.path}, {self.from_line}, {self.from_column}, {self.end_line}, {self.end_column}, {self.new_content} }}"
+
+    @staticmethod
+    def apply_many(ops, lines):
+        # There can be multiple ops per line, we need to run them in order sorted by column
+        for _, line_group in itertools.groupby(ops, lambda op: op.from_line):
+            offset = 0
+            for op in sorted(line_group, key=lambda op: op.from_column):
+                lines = op.apply_to(lines, offset)
+                offset += len(op.new_content) - op.end_column + op.from_column
+        return lines
+
+    def apply_to(self, lines, offset):
+
+        if self.end_line != self.from_line:
+            print("Multiple line replace ops are not supported", file=sys.stderr)
+            return []
+
+        target_line = lines[self.from_line - 1]
+
+        lines[self.from_line - 1] = (
+            target_line[: (self.from_column + offset - 1)]
+            + self.new_content
+            + target_line[(self.end_column + offset - 1) :]
+        )
+
+        return lines