mastapy-cli-regression 0.1.0b1__tar.gz

mastapy_cli_regression-0.1.0b1/.hgignore

@@ -0,0 +1,124 @@
+# use glob syntax
+syntax: glob
+
+*.obj
+*.pdb
+*.user
+obj/
+[Pp]ackages/[0-9a-zA-Z]*/**
+Build Output*/**
+VSBuildObjects/**
+*.suo
+TestResult.xml
+*.bak
+*.orig
+TestResults/**
+Tests/* TeamCity Artifacts/**/**
+*.tmp
+MastaRelease/CDImageSource*/**
+MastaRelease/Installer*/**
+MastaRelease/MastaSuite*/**
+MastaRelease/ReleaseBuild/**
+MastaRelease/SuiteOutput*/**
+MastaRelease/*.log
+MastaRelease/*.mds
+MastaRelease/*.mdf
+MastaRelease/Help/MASTA/CHM/**/*.*
+HaspHelper/Extracted/**
+.vs/**
+.venv/**
+.nox/**
+.pytest_cache/**
+.ruff_cache/**
+__pycache__/**
+_build/**
+_rst/**
+stubs.min/**
+_ReSharperPlatform*/**
+TestFileResources/MAARegression/Reports/*/*.*
+TestFileResources/MAARegression/Results/Changed/*.*
+*.vspx
+*.psess
+*.tmp_proj
+_ReSharper.Caches/*
+*.vsp
+MastaRelease/CD Template/Installs/**
+Utility/Translation/LanguageDatabase_log.ldf
+Utility/Translation/LanguageDatabase.mdf
+MastaAPI/MastaAPI/**
+MastaAPI/MastaAPI.Core/**
+MastaAPI/documentation/_site/**
+MastaAPI/Versioning.generated.cs
+ScriptedMastaToolsCode/bin/**
+StarterConsoleAppCode/bin/*
+ExampleConsoleAppCode/bin/*
+BearingCalculationApiCode/bin/*
+BearingCatalogApiCode/bin/*
+BearingWebsite/bin/*
+BearingWebsiteCore/bin/*
+PreparedApiProjects/*
+MastaAPI/pythonStubs/stubsGen/logs
+MastaAPI/PythonAPI/.workers/**
+MastaAPI/PythonAPI/results/**
+MastaAPI/PythonAPI/SMT/**
+MastaAPI/PythonAPI/mastapy/**
+MastaAPI/PythonAPI/mastapy.egg-info/**
+MastaAPI/PythonAPI/lib/mastapy-cli-regression/mastapy_cli_regression/legacy/mastapy_shim/_lib/**
+MastaAPI/PythonAPI/build/**
+MastaAPI/PythonAPI/dist/**
+MastaAPI/PythonAPI/src/mastapy/**
+MastaAPI/PythonAPI/src/last_updated.json
+MastaAPI/PythonAPI/tests/Results/**
+MastaAPI/PythonAPI/tests/requirements-test.txt
+MastaAPI/PythonAPI/tests/requirements-test-mastapy.txt
+MastaAPI/PythonAPI/tests/requirements-workspace.txt
+MastaAPI/PythonAPI/tests/.pip-audit_cache
+MastaAPI/PythonAPI/sandbox.py
+MastaAPI/PythonAPI/keyfile.json
+mastafile.py
+SMTStoreSolutions/Store/**
+MastaAPI/pythonpackage/dist/*
+MastaAPI/pythonpackage/build/*
+SMTStoreSolutions/*/bin/*
+SMTStoreSolutions/ReferenceTorqueCalculator/ReferenceTorqueCalculator/bin/
+MastaAPI/documentation/template/styles/package-lock.json
+MAAResources/MastaFiles/Analyses/Bevel LTCA/Spiral Bevel LTCA.Masta
+MAAResources/MastaFiles/Analyses/LTCA/Internal Pair.Masta
+MAAResources/MastaFiles/Analyses/LTCA/Marine Gear Set.Masta
+MAAResources/MastaFiles/Analyses/LTCA/Truck With Stresses.Masta
+TestFileResources/MAA/MastaFiles/AGMA different tolerance recommended.Masta
+TestFileResources/MAA/MastaFiles/AGMA same tolerance recommended.Masta
+TestFileResources/MAA/MastaFiles/AGMA tolerance recommended material fail.Masta
+TestFileResources/MAA/MastaFiles/DIN same tolerance recommended.Masta
+TestFileResources/MAA/MastaFiles/ISO different tolerance recommended.Masta
+TestFileResources/MAA/MastaFiles/ISO same tolerance recommended.Masta
+TestFileResources/MAA/MastaFiles/ISO tolerance recommended material fail.Masta
+TestFileResources/MAARegression/Designs/Ignore/simple FE helix gear pair.M*
+*/.idea/workspace.xml
+*/.idea/projectSettingsUpdater.xml
+.idea/config/applicationhost.config
+Core/BuildOutput/**/*
+.git/*
+.gitattributes
+.gitignore
+.yarn/*
+node_modules/*
+.yarnrc.yml
+.pnp.*
+*.nupkg
+# Default ignored files
+MastaAPITests/LatestReferenceFile
+MastaInstallationBuilder/GeometryModellerInstaller/**.msi
+MastaInstallationBuilder/GeometryModellerInstaller/**.exe
+MastaInstallationBuilder/GeometryModellerInstaller/**.dll
+MastaInstallationBuilder/GeometryModellerInstaller/*.cab
+MastaInstallationBuilder/GeometryModellerInstaller/Geometry Modeller (modified)-cache/**.*
+MastaInstallationBuilder/GeometryModellerInstaller/GeometryModeller.MSIUpdate*/*.*
+msbuild.log
+MastaRelease/BuildNumberGenerator/bin/**/**
+*_*_*tmp.csproj
+*.Untracked.props
+MastaInstallationBuilder/GraphApiInterop/bin/**/**
+SMTNodeProjects/HTMLScripts/src/*.js
+**/.idea/icon.svg
+**/.idea/**/copilot.data.migration*

mastapy_cli_regression-0.1.0b1/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: mastapy-cli-regression
+Version: 0.1.0b1
+Summary: Command-line tool for running a single mastapy script in multiple APIs and comparing results.
+Author-email: George Baron <george.baron@smartmt.com>
+License-Expression: MIT
+Keywords: masta,mastapy,plugin,regression,smt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Plugins
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: beartype>=0.22.6
+Requires-Dist: numpy>=1.22.0; python_version >= '3.9' and python_version < '3.12'
+Requires-Dist: numpy>=1.26.0; python_version >= '3.12'
+Requires-Dist: packaging>=25.0
+Requires-Dist: polars>=1.36.1
+Requires-Dist: rich-argparse>=1.7.2
+Requires-Dist: rich>=14.2.0
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: xlsxwriter>=3.2.9
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+<img src="https://documentation.smartmt.com/MastaAPI/15.1.1/images/smt_logo.png" width="150" alt="SMT">
+</h1><br>
+
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ![Python](https://img.shields.io/pypi/pyversions/mastapy-cli-regression)
+
+`mastapy-cli-regression` is a command-line plugin for [mastapy](https://pypi.org/project/mastapy/).
+
+- **Website**: https://www.smartmt.com/
+- **Support**: https://support.smartmt.com/
+
+![A preview of the regression plugin on the command line.](https://documentation.smartmt.com/MastaAPI/PyPi_images/mastapy-cli-regression-preview.png)
+
+To install this plugin, run the following:
+
+```bash
+pip install mastapy[cli-regression]
+```
+
+This plugin is designed to be used on the command-line via the [mastapy](https://pypi.org/project/mastapy/) package using the following syntax:
+
+```bash
+python -m mastapy regression ...
+```
+
+### Features
+
+- Compare results between different versions of the MASTA API and automatically identify regressions.
+- Completely automated and parallelized virtual environment creation, installation and script execution for each specified version of the MASTA API.
+- Fully customisable comparisons; choose your own tolerances, group values together and decide how you want them to be compared.
+- Supports loading legacy `mastapy` packages using modern Python versions.
+- Export results to an Excel workbook for further analysis.
+
+### Release Information
+
+This is the initial release of the package.
+
+### Pre-Requisites
+
+Note that these pre-requisites are only required for launching the plugin from the command-line.
+
+- `mastapy>=15.1.3`
+- An internet connection
+
+### Usage
+
+Before starting, prepare a Python script for the plugin to execute. This must be a self-contained script (i.e. does not rely on `@mastapy.masta_property`) that can be executed from the command-line.
+
+There are two steps to using this plugin. Before executing your script, you must modify it to export a comparison structure, `mastapy_cli_regression.Comparer`, which the plugin will read to run your regression tests. The following is an example script demonstrating a modified script.
+
+```python
+from mastapy import Examples
+
+# Import the Comparer from the regression package.
+from mastapy_cli_regression import Comparer
+
+
+def main() -> None:
+    design = Examples.Components.SIMPLE_HOUSING_FULL_MESH.load()
+
+    # Create a new Comparer object. We will add values to this for regression testing.
+    comparer = Comparer()
+
+    for load_case in design.static_loads:
+        # For each load case, create a new group. Any values added to the comparer while
+        # indented inside the `with` statement will get added to the group. his will
+        # help organise our results.
+        with comparer.group("Load Case: " + load_case.name):
+            system_deflection = load_case.system_deflection
+            system_deflection.perform_analysis()
+
+            gear_sets = design.all_parts_of_type_cylindrical_gear_set()
+            mesh_groups = (gear_set.cylindrical_meshes for gear_set in gear_sets)
+            meshes = (mesh for group in mesh_groups for mesh in group)
+
+            for mesh in meshes:
+                sd = system_deflection.results_for_cylindrical_gear_mesh(
+                    mesh
+                ).cast_to.cylindrical_gear_mesh_system_deflection_with_ltca_results
+                altca_results = sd.advanced_ltca_results
+
+                # Once we have results, we can add them to our comparison
+                # structure. We must also decide how we want to configure
+                # our tolerances for the regression tests. We have opted for a
+                # relative tolerance, but other options are available.
+                comparer.add(
+                    "Total Misalignment",
+                    sd.misalignment_data.total_equivalent_misalignment_for_rating,
+                    relative_tolerance=0.0000001,
+                )
+
+                flank_rating = altca_results.rating.cylindrical_mesh_single_flank_rating
+                flank_rating = flank_rating.gear_single_flank_ratings
+
+                # Add values for the gear bending stress.
+                comparer.add(
+                    "Root Stress 0",
+                    flank_rating[0].tooth_root_stress,
+                    relative_tolerance=0.0000001,
+                )
+                comparer.add(
+                    "Root Stress 1",
+                    flank_rating[1].tooth_root_stress,
+                    relative_tolerance=0.0000001,
+                )
+
+                # Add values for the gear contact stress.
+                comparer.add(
+                    "Contact Stress 0",
+                    flank_rating[0].calculated_contact_stress,
+                    relative_tolerance=0.0000001,
+                )
+                comparer.add(
+                    "Contact Stress 1",
+                    flank_rating[1].calculated_contact_stress,
+                    relative_tolerance=0.0000001,
+                )
+
+    # Once we are done, we must call `comparer.collect`. This will output our
+    # comparison structure for the regression plugin to read!
+    comparer.collect()
+
+
+if __name__ == "__main__":
+    main()
+```
+
+Once the script has been modified to output a comparison structure, we are ready to launch it using the plugin. This is done from the command line.
+
+For instance, to compare results between MASTA 14.0 and MASTA 15.0 and export results to Excel, assuming both versions of MASTA are installed in the default location, we could run:
+
+```bash
+python -m mastapy regression "path/to/script.py" 14.0 15.0 --export-excel
+```
+
+This will execute your script in both versions of the API and automatically compile test results, then export them to Excel. Alternatively, you can provide paths to your MASTA installations:
+
+```bash
+python -m mastapy regression "path/to/script.py" "path/to/MASTA 14.0" "path/to/MASTA 15.0" --export-excel
+```
+
+To view the full list of features, run:
+
+```bash
+python -m mastapy regression --help
+```
+
+### Troubleshooting
+
+#### Version differences
+
+If you are attempting to compare different major versions of the API (e.g. comparing 14.0 and 15.0), changes in the API might cause your script to work in one API but not the other. To work around this, you can import `__api_version__` from `mastapy` and branch on it:
+
+```python
+from mastapy import __api_version__
+
+if __api_version__ == "14.0.0":
+    # Run code for MASTA 14.0
+    ...
+else:
+    # Run code for MASTA 15.0
+    ...
+```
+
+You may also need to use different versions of Python, depending on what each version of `mastapy` supports. This can be configured in your launch command using `@VERSION` syntax (or `@PATH` if you have a path to the Python executable):
+
+```bash
+python -m mastapy regression "path/to/script.py" 14.0@3.10 15.0
+```
+
+This will launch MASTA 14.0 using Python 3.10. You must have the corresponding version of Python installed.
+
+#### Package Installation
+
+This plugin automatically creates virtual environments, then downloads and installs packages into them. Internally, `pip` is used for all package management. If you require SSL certification, you can optionally use the `--truststore` flag to install it into your virtual environments:
+
+```bash
+python -m mastapy regression --truststore ...
+```
+
+Everything else must be configured using `pip.ini` or environment variables.

mastapy_cli_regression-0.1.0b1/README.md

@@ -0,0 +1,181 @@
+<h1 align="center">
+<img src="https://documentation.smartmt.com/MastaAPI/15.1.1/images/smt_logo.png" width="150" alt="SMT">
+</h1><br>
+
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ![Python](https://img.shields.io/pypi/pyversions/mastapy-cli-regression)
+
+`mastapy-cli-regression` is a command-line plugin for [mastapy](https://pypi.org/project/mastapy/).
+
+- **Website**: https://www.smartmt.com/
+- **Support**: https://support.smartmt.com/
+
+![A preview of the regression plugin on the command line.](https://documentation.smartmt.com/MastaAPI/PyPi_images/mastapy-cli-regression-preview.png)
+
+To install this plugin, run the following:
+
+```bash
+pip install mastapy[cli-regression]
+```
+
+This plugin is designed to be used on the command-line via the [mastapy](https://pypi.org/project/mastapy/) package using the following syntax:
+
+```bash
+python -m mastapy regression ...
+```
+
+### Features
+
+- Compare results between different versions of the MASTA API and automatically identify regressions.
+- Completely automated and parallelized virtual environment creation, installation and script execution for each specified version of the MASTA API.
+- Fully customisable comparisons; choose your own tolerances, group values together and decide how you want them to be compared.
+- Supports loading legacy `mastapy` packages using modern Python versions.
+- Export results to an Excel workbook for further analysis.
+
+### Release Information
+
+This is the initial release of the package.
+
+### Pre-Requisites
+
+Note that these pre-requisites are only required for launching the plugin from the command-line.
+
+- `mastapy>=15.1.3`
+- An internet connection
+
+### Usage
+
+Before starting, prepare a Python script for the plugin to execute. This must be a self-contained script (i.e. does not rely on `@mastapy.masta_property`) that can be executed from the command-line.
+
+There are two steps to using this plugin. Before executing your script, you must modify it to export a comparison structure, `mastapy_cli_regression.Comparer`, which the plugin will read to run your regression tests. The following is an example script demonstrating a modified script.
+
+```python
+from mastapy import Examples
+
+# Import the Comparer from the regression package.
+from mastapy_cli_regression import Comparer
+
+
+def main() -> None:
+    design = Examples.Components.SIMPLE_HOUSING_FULL_MESH.load()
+
+    # Create a new Comparer object. We will add values to this for regression testing.
+    comparer = Comparer()
+
+    for load_case in design.static_loads:
+        # For each load case, create a new group. Any values added to the comparer while
+        # indented inside the `with` statement will get added to the group. his will
+        # help organise our results.
+        with comparer.group("Load Case: " + load_case.name):
+            system_deflection = load_case.system_deflection
+            system_deflection.perform_analysis()
+
+            gear_sets = design.all_parts_of_type_cylindrical_gear_set()
+            mesh_groups = (gear_set.cylindrical_meshes for gear_set in gear_sets)
+            meshes = (mesh for group in mesh_groups for mesh in group)
+
+            for mesh in meshes:
+                sd = system_deflection.results_for_cylindrical_gear_mesh(
+                    mesh
+                ).cast_to.cylindrical_gear_mesh_system_deflection_with_ltca_results
+                altca_results = sd.advanced_ltca_results
+
+                # Once we have results, we can add them to our comparison
+                # structure. We must also decide how we want to configure
+                # our tolerances for the regression tests. We have opted for a
+                # relative tolerance, but other options are available.
+                comparer.add(
+                    "Total Misalignment",
+                    sd.misalignment_data.total_equivalent_misalignment_for_rating,
+                    relative_tolerance=0.0000001,
+                )
+
+                flank_rating = altca_results.rating.cylindrical_mesh_single_flank_rating
+                flank_rating = flank_rating.gear_single_flank_ratings
+
+                # Add values for the gear bending stress.
+                comparer.add(
+                    "Root Stress 0",
+                    flank_rating[0].tooth_root_stress,
+                    relative_tolerance=0.0000001,
+                )
+                comparer.add(
+                    "Root Stress 1",
+                    flank_rating[1].tooth_root_stress,
+                    relative_tolerance=0.0000001,
+                )
+
+                # Add values for the gear contact stress.
+                comparer.add(
+                    "Contact Stress 0",
+                    flank_rating[0].calculated_contact_stress,
+                    relative_tolerance=0.0000001,
+                )
+                comparer.add(
+                    "Contact Stress 1",
+                    flank_rating[1].calculated_contact_stress,
+                    relative_tolerance=0.0000001,
+                )
+
+    # Once we are done, we must call `comparer.collect`. This will output our
+    # comparison structure for the regression plugin to read!
+    comparer.collect()
+
+
+if __name__ == "__main__":
+    main()
+```
+
+Once the script has been modified to output a comparison structure, we are ready to launch it using the plugin. This is done from the command line.
+
+For instance, to compare results between MASTA 14.0 and MASTA 15.0 and export results to Excel, assuming both versions of MASTA are installed in the default location, we could run:
+
+```bash
+python -m mastapy regression "path/to/script.py" 14.0 15.0 --export-excel
+```
+
+This will execute your script in both versions of the API and automatically compile test results, then export them to Excel. Alternatively, you can provide paths to your MASTA installations:
+
+```bash
+python -m mastapy regression "path/to/script.py" "path/to/MASTA 14.0" "path/to/MASTA 15.0" --export-excel
+```
+
+To view the full list of features, run:
+
+```bash
+python -m mastapy regression --help
+```
+
+### Troubleshooting
+
+#### Version differences
+
+If you are attempting to compare different major versions of the API (e.g. comparing 14.0 and 15.0), changes in the API might cause your script to work in one API but not the other. To work around this, you can import `__api_version__` from `mastapy` and branch on it:
+
+```python
+from mastapy import __api_version__
+
+if __api_version__ == "14.0.0":
+    # Run code for MASTA 14.0
+    ...
+else:
+    # Run code for MASTA 15.0
+    ...
+```
+
+You may also need to use different versions of Python, depending on what each version of `mastapy` supports. This can be configured in your launch command using `@VERSION` syntax (or `@PATH` if you have a path to the Python executable):
+
+```bash
+python -m mastapy regression "path/to/script.py" 14.0@3.10 15.0
+```
+
+This will launch MASTA 14.0 using Python 3.10. You must have the corresponding version of Python installed.
+
+#### Package Installation
+
+This plugin automatically creates virtual environments, then downloads and installs packages into them. Internally, `pip` is used for all package management. If you require SSL certification, you can optionally use the `--truststore` flag to install it into your virtual environments:
+
+```bash
+python -m mastapy regression --truststore ...
+```
+
+Everything else must be configured using `pip.ini` or environment variables.

mastapy_cli_regression-0.1.0b1/mastapy_cli_regression/__init__.py

@@ -0,0 +1,29 @@
+"""Run a single mastapy script in multiple APIs and compare results."""
+
+__version__ = "0.1.0b1"
+
+from .comparing.comparer import Comparer
+
+__all__ = ("__version__", "Comparer")
+
+
+def run(args: list[str]) -> None:
+    """Run the plugin.
+
+    Args:
+        args (list[str]): Arguments from the command line for the plugin to process.
+    """
+    from .common.cli import Options
+    from .common.errors import ProcessError
+    from .common.print import print_panel
+    from .processing import runner
+    from rich import print
+
+    try:
+        options = Options.from_command_line(args)
+        print()
+        print_panel(str(options), title="Configuration", color="green")
+
+        runner.launch_processes(options)
+    except ProcessError as error:
+        print(f"[red]{error}[/]")

mastapy_cli_regression-0.1.0b1/mastapy_cli_regression/common/__init__.py

@@ -0,0 +1 @@
+"""Sub-package for modules shared across other sub-packages."""