mainframe-migration-toolkit 0.2.0__py3-none-any.whl

mainframe_migration_toolkit-0.2.0.dist-info/METADATA

@@ -0,0 +1,16 @@
+Metadata-Version: 2.5
+Name: mainframe-migration-toolkit
+Version: 0.2.0
+Summary: Runtime and deterministic tools for COBOL/JCL to PySpark migrations
+Author: Mainframe Migration Toolkit
+Requires-Python: >=3.10
+Provides-Extra: all
+Requires-Dist: pyarrow>=15; extra == 'all'
+Requires-Dist: pyspark<5,>=3.5; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=15; extra == 'parquet'
+Provides-Extra: spark
+Requires-Dist: pyspark<5,>=3.5; extra == 'spark'

mainframe_migration_toolkit-0.2.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+mainframe_toolkit/__init__.py,sha256=iBuG-E3iICCMZUrJeVZ4o2iM7zOY5acOrJIUm3YGNkw,2168
+mainframe_toolkit/__main__.py,sha256=4BTAfHHF2u3j_oUg_Wluqu0HyxnXfAHBQUcnPQ-e1xs,50
+mainframe_toolkit/cli.py,sha256=fpHDNn2aoScDqzIHCDtEan6HVMrxxSlTpThAX8a_UDk,14495
+mainframe_toolkit/cobol.py,sha256=EOeTBh74IwwLtmZKF0Ov8fnuB1gAWGHc4qyA7Kfa6ug,3658
+mainframe_toolkit/copybook.py,sha256=omXj6X1BhtaXvKUsDYR6siBQqgIQUzL4hH3eoBF5fRA,18248
+mainframe_toolkit/errors.py,sha256=u1cBP7Zu8bUK9Xn-T2Qb45-ikw0cVqEfjhvIImdmCAs,395
+mainframe_toolkit/external.py,sha256=IGZLHyu9qfhzqZYsUcfITtlIOhzfZ9c9BwSKaH4xwRQ,1942
+mainframe_toolkit/io.py,sha256=hQTbu2Gp-zYM4cBFtUzdZjg_ajPCbENoXNgZJnWDPkI,6605
+mainframe_toolkit/jcl.py,sha256=UB3t33UcpEeGkIVSQo4meKWN6968J5vCX9Bei6WHl0U,4604
+mainframe_toolkit/pipeline.py,sha256=cIivUpc2FY158CsrE_I76SOzgfTGjUeO_tcLfP4LfV4,12078
+mainframe_toolkit/sequential.py,sha256=iJYANVtGnFH42hp6mXyRfk7Oy8fJWrceKSQbL--Nkq0,9182
+mainframe_toolkit/similarity.py,sha256=GUxSt_vySk_n5yFsRqqg0XKzRLCdeZj8C4Vk6TjdU34,38319
+mainframe_toolkit/sorting.py,sha256=HBtEQxS05-9m-DnhJyKI7hfrQ5e_RM3nCopRdH6HCzA,2041
+mainframe_toolkit/specs.py,sha256=8c-ZRUJQvaJokZGsypmModaM-e5rOBm3nt60eGc5E5w,12311
+mainframe_toolkit/synthetic.py,sha256=RKdqkmqaxssktWJN6H85Ang-bN5uEXTJDyU3nXgEKTE,4276
+mainframe_toolkit/workspace.py,sha256=5tyak9Tmyopc5in0c_UFeUCJ6JT00KXH5CIGGA_FUsM,4740
+mainframe_toolkit/_workspace/AGENTS.md,sha256=Jl0fjSNtzzVVpx5st0zA2mDVSkfV4a_n1Z1ivr55PXA,1565
+mainframe_toolkit/_workspace/CLAUDE.md,sha256=XnHDtjkvRbD50sNxe-Ki7JuUHXo7YPlRTY5UdHngJag,12
+mainframe_toolkit/_workspace/validator-java/mvnw,sha256=yuls74nr6jUxIh9K4Xwjz47fZ9AOroMG1Bhq4bvtTQI,11790
+mainframe_toolkit/_workspace/validator-java/mvnw.cmd,sha256=Ru7bhBm9FP5w1bspFte29RgG5Rs51bdqQmEDhMqSnBw,8481
+mainframe_toolkit/_workspace/validator-java/pom.xml,sha256=2HW7K2QRFWRG1UT_ws1Xd4HhYWrA4FqzJ6wutD5EH3g,3961
+mainframe_toolkit/_workspace/validator-java/.mvn/wrapper/maven-wrapper.properties,sha256=jypEOIEDSCcNnZj41tUwVB3bcnHjc9sgforDgeDjW2I,168
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/AvroValueFormatter.java,sha256=CTwiBZEI8B31Gd5mknlaYwQouc_8ie0CCNqlBhbhR_8,6165
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/CsvTabularReader.java,sha256=az7e6IYWIAbG1tmM-AHiRvXxrVW8E91xlD2U6I08Ctk,3446
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/DataFormat.java,sha256=vbVyeuKJ_oxMrDxH0Hk4WFTlGfvt00A6JFPxrypLQ0M,2289
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/Difference.java,sha256=fAWJ64edhpZ03_AMVdRhO_se6vxJiGyeaKtHYxQKKBs,927
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/InputFileSet.java,sha256=ktAgQKPW0yzJP7btzKqbF7Q-Qy7zAZBoPwRVnwwF3eg,1535
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/InputOptions.java,sha256=BnfW6-KChmAIQu8nh98OJbNG1c3ZX3BjrQYP4kNPImc,547
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/JsonReportWriter.java,sha256=Vg5qBwAdKdmGIJD4ygHv6arQwh42VvFe4McqY9aqjMY,1376
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/MultiFileTabularReader.java,sha256=FvIppE8HZe6BmEYTA4AYgDH6aDyRcAMYmpOcx0mhsMg,2335
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/Normalization.java,sha256=vE25GgHSabyKKg4ioFf23Krt0DJMQcN-zNKteULKlqQ,434
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ParquetTabularReader.java,sha256=T1L0cS0DipALIuVpGNe7U-ZpeTMIPF624KgzbI30NBw,2069
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/TabularReader.java,sha256=JSGorThD2LKwuJ4Jpwg4MRnnWi-tVa9QZgcPRSQ33Ks,275
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/TabularReaderFactory.java,sha256=8Po2kyidjstrsevSlHwX1XobuekZVlwRkGelphYnP7U,1065
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ValidationOptions.java,sha256=MfdfOsqhnswRt9vRJeSXdhNlSQBbJnrGJ7nz7QyC-9A,1420
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ValidationReport.java,sha256=6jAlflov1O92rri-eB1BfNL_CjP66rwyFXkTncLblZc,1048
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ValidationService.java,sha256=3saqmhdMExgajxf0jB44dWrhWiMKlHjckoQJS9O-oL4,15999
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ValidatorCli.java,sha256=tjb6XgsMLG7sYtX16VRT_o-uNkJHfiT165lm0tfSeBo,7971
+mainframe_toolkit/_workspace/validator-java/src/main/java/io/mainframe/migration/validator/ValueNormalizer.java,sha256=A6VSnTAiPNHWKp79vraC0ZJ5eQtP2Fja2MS35N7ZTYY,888
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/DirectoryValidationTest.java,sha256=84wZ3DsJiZeWXc7Rutw_6GIrWP_pJ5hXhmHQ3b-ESOg,3075
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/JsonReportWriterTest.java,sha256=PjuWz0wMUDFsZGpn-7McuJWLm_pnozl69Djzw_KyqwI,1372
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/KeyedValidationTest.java,sha256=FXsg3LdL1NgMKwE7exPs2jLBGzy19avUHmzknq8yFS8,3640
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/ParquetValidationTest.java,sha256=1OhMG2v4msDmoYzBs3iux3ZFyrKnBG9fJ7ZGvBq4GBw,5569
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/ValidationServiceTest.java,sha256=HgV51RgTTUNBA5pf1ILrmNJhOKIk4PZE1lq7OdIPSKY,5350
+mainframe_toolkit/_workspace/validator-java/src/test/java/io/mainframe/migration/validator/ValidatorCliTest.java,sha256=jn-WL2u6-ZnJAgOjqhJN1RwlPYUOHjQzAe6zhbqY0hM,3866
+mainframe_toolkit/_workspace/.claude/skills/analyze-mainframe-similarity/SKILL.md,sha256=DblDy-Q7N0IOt_1OeeO2cv66c9YqajrabrV9HdfkhBA,1926
+mainframe_toolkit/_workspace/.claude/skills/migrate-mainframe-job/SKILL.md,sha256=PfwPGi-uM9rCXfaSfdUDwo6gYxiX8cgXW-7ShMh8FHg,5123
+mainframe_toolkit/_workspace/.claude/skills/validate-golden-dataset/SKILL.md,sha256=A5l8g7k6LT1pNKxJdKNT-3Tj5CI9UCSwZ7ZbJqg92dQ,1001
+mainframe_migration_toolkit-0.2.0.dist-info/METADATA,sha256=lwCG7Zdl9IypviltG-esz3NSbfTvOe0Zkc54VHNH4D4,568
+mainframe_migration_toolkit-0.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+mainframe_migration_toolkit-0.2.0.dist-info/entry_points.txt,sha256=V5_IEuCYCDUOEVCjnqrOz2eipU1EdlcKtMUJS23qMP0,98
+mainframe_migration_toolkit-0.2.0.dist-info/RECORD,,

mainframe_migration_toolkit-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mainframe_migration_toolkit-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+mainframe-toolkit = mainframe_toolkit.cli:main
+mft = mainframe_toolkit.cli:main

mainframe_toolkit/__init__.py

@@ -0,0 +1,92 @@
+"""Reusable runtime for specification-led COBOL/JCL migrations."""
+
+from .cobol import (
+    cobol_decimal,
+    decode_overpunch,
+    decode_packed_decimal,
+    encode_packed_decimal,
+    is_numeric,
+    quantize_cobol,
+)
+from .copybook import CopybookParseError, layout_to_dict, parse_copybook, parse_copybook_text
+from .external import ExternalProgramRegistry, external_program
+from .io import (
+    configure_s3,
+    read_csv,
+    read_dataset,
+    read_delimited_rows,
+    read_parquet,
+    read_s3_csv,
+    read_s3_parquet,
+    s3_uri,
+    write_csv,
+    write_dataset,
+    write_parquet,
+    write_s3_csv,
+    write_s3_parquet,
+)
+from .jcl import JCLJob, JCLStep, parse_jcl
+from .pipeline import (
+    DatasetRegistry,
+    PipelineContext,
+    PipelineProgram,
+    ProgramResult,
+    PipelineRunner,
+    PipelineRunError,
+    ProgramReturnCodeError,
+)
+from .sequential import FieldSpec, RecordLayout, convert_sequential, iter_sequential
+from .sorting import SortKey, sort_dataframe, sort_records
+from .synthetic import synthetic_dataframe, synthetic_rows
+from .workspace import WorkspaceInitResult, init_workspace
+
+__all__ = [
+    "CopybookParseError",
+    "DatasetRegistry",
+    "ExternalProgramRegistry",
+    "FieldSpec",
+    "JCLJob",
+    "JCLStep",
+    "PipelineContext",
+    "PipelineProgram",
+    "ProgramResult",
+    "ProgramReturnCodeError",
+    "PipelineRunError",
+    "PipelineRunner",
+    "RecordLayout",
+    "SortKey",
+    "WorkspaceInitResult",
+    "cobol_decimal",
+    "configure_s3",
+    "convert_sequential",
+    "decode_overpunch",
+    "decode_packed_decimal",
+    "encode_packed_decimal",
+    "external_program",
+    "is_numeric",
+    "init_workspace",
+    "iter_sequential",
+    "layout_to_dict",
+    "parse_copybook",
+    "parse_copybook_text",
+    "parse_jcl",
+    "quantize_cobol",
+    "read_csv",
+    "read_dataset",
+    "read_delimited_rows",
+    "read_parquet",
+    "read_s3_csv",
+    "read_s3_parquet",
+    "s3_uri",
+    "sort_dataframe",
+    "sort_records",
+    "synthetic_dataframe",
+    "synthetic_rows",
+    "write_csv",
+    "write_dataset",
+    "write_parquet",
+    "write_s3_csv",
+    "write_s3_parquet",
+]
+
+__version__ = "0.2.0"

mainframe_toolkit/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+raise SystemExit(main())
+

mainframe_toolkit/_workspace/.claude/skills/analyze-mainframe-similarity/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: analyze-mainframe-similarity
+description: Cluster COBOL and JCL source by deterministic textual similarity, inspect every proposed cluster, and add an AI verdict and concise justification to JSON and CSV outputs. Use for duplicate or near-duplicate codebase analysis.
+---
+
+# Analyze mainframe similarity
+
+1. Run the deterministic scan:
+
+   ```text
+   python -m mainframe_toolkit similarity scan <source-root> --threshold <threshold> --json similarity.json --csv similarity.csv --review-request similarity-review-request.json
+   ```
+
+   Use the requested threshold, or 80 when absent. Never edit deterministic scores or cluster membership manually.
+
+2. For each non-singleton cluster in the review request, read every original file and its normalized evidence. Check all pair relationships; connected-component chaining alone is not proof of equivalence. Ignore comments, sequence columns, copyright blocks, whitespace, generated names, and environment-only identifiers. Compare JCL execution flow/DD semantics or COBOL inputs, outputs, branches, calculations, side effects, error behavior, and record layouts.
+
+3. Assign exactly one verdict per requested cluster:
+
+   - `identico`: same executable semantics; differences are non-semantic.
+   - `similar`: materially shared flow/business implementation but at least one real semantic variation.
+   - `diferente`: superficial boilerplate or chaining grouped programs with different behavior.
+
+4. Write the requested review JSON with a short evidence-based Portuguese justification, then apply it:
+
+   ```text
+   python -m mainframe_toolkit similarity apply-review similarity.json similarity-review.json --json similarity-reviewed.json --csv similarity-reviewed.csv
+   ```
+
+5. Verify both reviewed files contain `parecer_ia` and `justificativa_ia` for every row. Keep singletons as `diferente` unless direct inspection establishes a duplicate omitted by the threshold.

mainframe_toolkit/_workspace/.claude/skills/migrate-mainframe-job/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: migrate-mainframe-job
+description: Convert one specification-led JCL job and its COBOL programs to an incrementally validated PySpark pipeline with audited in-memory handoffs and final golden-dataset equality. Use when asked to migrate, continue, repair, or finish a mainframe job in this repository.
+---
+
+# Migrate mainframe job
+
+Migrate `$ARGUMENTS`, or the single job requested by the user. Do not widen the job scope.
+
+## Preflight
+
+1. Install the repo package if its import fails:
+
+   ```text
+   python -m pip install -e ".[all]"
+   ```
+
+2. Run `python -m mainframe_toolkit inspect . --output .migration-work/project-inspection.json`. Resolve structural errors before conversion; unresolved dependencies may proceed only through the synthetic/external rules below.
+3. Read the selected `spec/jcl/<JOB>-jcl.json` and source JCL completely. Reconcile their ordered steps, conditions, DD concatenation, SORT/IDCAMS control cards, input/output datasets, GDGs, and return-code behavior. The spec defines intended business behavior; source resolves mechanics the spec leaves open.
+4. Read every referenced `spec/cobol/<PROGRAM>-cbl.json`, COBOL source, used copybook, and relevant entry in `external-programs/*.json`. Do not infer a record layout from narrative text when a copybook exists. Distinguish physical COBOL width from any expanded textual transport width.
+5. Inventory every supplied input and golden file before generating anything. Freeze clock-dependent behavior behind an injected processing date.
+
+## Target shape
+
+Create only the files needed under `converted/<JOB>/`:
+
+```text
+<job_lower>.py
+programs/__init__.py
+programs/<program_lower>.py
+tests/...
+RELATORIO_FINAL.md                 # only after acceptance
+```
+
+Create one module per COBOL program. Represent utility steps separately when they implement a transformation. Every module exposes `run(context)` and returns a mapping of logical dataset names to PySpark DataFrames, or a `ProgramResult` when a return code matters.
+
+The JCL-named entrypoint contains no transformation, validation, lookup, calculation, filtering, joining, or formatting rules. It only initializes Spark and `PipelineContext`, imports modules, declares `PipelineProgram` order/conditions, loads runtime arguments, and calls `PipelineRunner`. It must accept `--through <PROGRAM>` so prefixes are executable.
+
+Use `mainframe_toolkit.io` for local/S3 CSV and Parquet, `sequential`/`copybook` for fixed records, `sorting` for stable multi-key sort, `external` for subprogram adapters, and COBOL decimal helpers instead of cloning generic logic into modules.
+
+## Ordered conversion gate
+
+For each executable step in JCL order:
+
+1. Implement only that program's behavior from its spec and source. Preserve COBOL decimal/truncation, key, mutation, EOF, return-code, and error semantics unless the specification explicitly overrides them.
+2. Add its import and `PipelineProgram` entry to the JCL-named file immediately.
+3. Run fast module tests, then execute the entire pipeline prefix with `--through <PROGRAM>` using supplied inputs.
+4. If a required input, dataset, clock value, or external implementation is absent, create the smallest deterministic substitute that makes semantic sense. Keep relationships valid, use a stable seed, place it under `converted/<JOB>/synthetic/`, and write a machine-readable provenance manifest. Never overwrite or shadow supplied data.
+5. Confirm the prefix has no import, analysis, Spark, schema, conversion, or runtime errors. Confirm each program output exists both in the in-memory registry and its audit path. Fix the current or earlier responsible module before moving to the next step.
+
+Do not use the final golden comparison for a partial prefix unless that prefix is itself the documented final producer.
+
+## Final equivalence loop
+
+1. Execute the full pipeline with a clean run ID. Make final row ordering explicit using contract keys before export; Spark partition order is not a business order.
+2. Build the Java validator if needed, then invoke it through `python -m mainframe_toolkit golden validate ...` with the final output, matching golden file, format/delimiter, and ordering keys.
+3. Acceptance is `status=MATCH`, zero differing cells, equal row/column counts, and exit code 0.
+4. On mismatch, start from the first reported row/key/column. Trace that field backward through the per-program audit outputs and JCL data flow; identify the earliest program that creates the wrong value, row, multiplicity, or ordering. Correct that module, rerun its prefix, then rerun the full pipeline and validator.
+5. Repeat until 100% equal. Do not weaken comparison options, discard differing rows, alter the golden dataset, or encode golden values as business rules.
+
+## Final artifact
+
+Only after acceptance, create `converted/<JOB>/RELATORIO_FINAL.md` with: programs converted in order; material spec/source decisions; supplied versus synthetic inputs and external adapters; tests/checkpoints executed; exact final comparison result; and the shortest commands needed to run the job and validator. Do not add deployment guidance.

mainframe_toolkit/_workspace/.claude/skills/validate-golden-dataset/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: validate-golden-dataset
+description: Compare a converted pipeline's final CSV or Parquet output cell by cell against its golden dataset and localize mismatches using audit lineage. Use for final equivalence checks or divergence repair.
+---
+
+# Validate golden dataset
+
+Build `validator-java` when its executable JAR is absent, then run `python -m mainframe_toolkit golden validate` for `$ARGUMENTS`. Supply the real delimiter/header/null/decimal options and explicit ordering keys whenever record order is not contractual.
+
+Require equal schema, column order, row count, and normalized cell values. Exit code 0 and zero differences are the only passing result.
+
+For a mismatch, use the report's first row/key/column and the audit manifest to trace the field backward through program outputs. Fix the earliest converted program that introduces the divergence, rerun its full prefix, then the full job and validator. Repeat without changing the golden dataset or relaxing comparison semantics.

mainframe_toolkit/_workspace/AGENTS.md

@@ -0,0 +1,10 @@
+# Mainframe migration toolkit
+
+- Treat `spec/` as the intended behavior, the JCL/COBOL/copybook sources as the mechanical detail, and `golden-dataset/` as the final observable acceptance criterion. Record material conflicts in the final report.
+- Convert a job strictly in JCL execution order. After each program, import it from the JCL-named entrypoint and execute the complete prefix through that program. Fix every syntax or runtime failure before continuing.
+- Keep intermediate datasets as PySpark DataFrames in `PipelineContext`; never use an audit file as the handoff between programs. Publish every program output so the runtime also materializes an audit copy.
+- Put business rules only in program modules. The JCL-named entrypoint may initialize Spark/context, import programs, declare their order/conditions, parse runtime arguments, and run the pipeline.
+- Generate deterministic synthetic data or an external-program adapter only for an unavailable dependency. Never replace supplied data. Preserve referential integrity and identify every synthetic resource in the final report.
+- Completion requires a full run and 100% cell-level equality with the golden dataset. Use explicit ordering keys when row order is not part of the contract. Trace mismatches to the responsible program, fix it, and rerun until equal.
+- Do not add deployment, infrastructure, production hardening, architecture prose, README files, or per-step reports. Generate only functional core code, tests, audit artifacts, and the final `RELATORIO_FINAL.md` for each converted job.
+

mainframe_toolkit/_workspace/CLAUDE.md

@@ -0,0 +1,2 @@
+@AGENTS.md
+

mainframe_toolkit/_workspace/validator-java/.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,3 @@
+wrapperVersion=3.3.4
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip

mainframe_toolkit/_workspace/validator-java/mvnw

@@ -0,0 +1,295 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.3.4
+#
+# Optional ENV vars
+# -----------------
+#   JAVA_HOME - location of a JDK home dir, required when download maven via java source
+#   MVNW_REPOURL - repo url base for downloading maven distribution
+#   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+#   MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
+# ----------------------------------------------------------------------------
+
+set -euf
+[ "${MVNW_VERBOSE-}" != debug ] || set -x
+
+# OS specific support.
+native_path() { printf %s\\n "$1"; }
+case "$(uname)" in
+CYGWIN* | MINGW*)
+  [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
+  native_path() { cygpath --path --windows "$1"; }
+  ;;
+esac
+
+# set JAVACMD and JAVACCMD
+set_java_home() {
+  # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
+  if [ -n "${JAVA_HOME-}" ]; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ]; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+      JAVACCMD="$JAVA_HOME/jre/sh/javac"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+      JAVACCMD="$JAVA_HOME/bin/javac"
+
+      if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
+        echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
+        echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
+        return 1
+      fi
+    fi
+  else
+    JAVACMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v java
+    )" || :
+    JAVACCMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v javac
+    )" || :
+
+    if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
+      echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
+      return 1
+    fi
+  fi
+}
+
+# hash string like Java String::hashCode
+hash_string() {
+  str="${1:-}" h=0
+  while [ -n "$str" ]; do
+    char="${str%"${str#?}"}"
+    h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
+    str="${str#?}"
+  done
+  printf %x\\n $h
+}
+
+verbose() { :; }
+[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
+
+die() {
+  printf %s\\n "$1" >&2
+  exit 1
+}
+
+trim() {
+  # MWRAPPER-139:
+  #   Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
+  #   Needed for removing poorly interpreted newline sequences when running in more
+  #   exotic environments such as mingw bash on Windows.
+  printf "%s" "${1}" | tr -d '[:space:]'
+}
+
+scriptDir="$(dirname "$0")"
+scriptName="$(basename "$0")"
+
+# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
+while IFS="=" read -r key value; do
+  case "${key-}" in
+  distributionUrl) distributionUrl=$(trim "${value-}") ;;
+  distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
+  esac
+done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
+[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+
+case "${distributionUrl##*/}" in
+maven-mvnd-*bin.*)
+  MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
+  case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
+  *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
+  :Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
+  :Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
+  :Linux*x86_64*) distributionPlatform=linux-amd64 ;;
+  *)
+    echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
+    distributionPlatform=linux-amd64
+    ;;
+  esac
+  distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
+  ;;
+maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
+*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
+esac
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
+distributionUrlName="${distributionUrl##*/}"
+distributionUrlNameMain="${distributionUrlName%.*}"
+distributionUrlNameMain="${distributionUrlNameMain%-bin}"
+MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
+MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
+
+exec_maven() {
+  unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
+  exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
+}
+
+if [ -d "$MAVEN_HOME" ]; then
+  verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  exec_maven "$@"
+fi
+
+case "${distributionUrl-}" in
+*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
+*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
+esac
+
+# prepare tmp dir
+if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
+  clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
+  trap clean HUP INT TERM EXIT
+else
+  die "cannot create temp dir"
+fi
+
+mkdir -p -- "${MAVEN_HOME%/*}"
+
+# Download and Install Apache Maven
+verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+verbose "Downloading from: $distributionUrl"
+verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+# select .zip or .tar.gz
+if ! command -v unzip >/dev/null; then
+  distributionUrl="${distributionUrl%.zip}.tar.gz"
+  distributionUrlName="${distributionUrl##*/}"
+fi
+
+# verbose opt
+__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
+[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
+
+# normalize http auth
+case "${MVNW_PASSWORD:+has-password}" in
+'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+esac
+
+if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
+  verbose "Found wget ... using wget"
+  wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
+elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
+  verbose "Found curl ... using curl"
+  curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
+elif set_java_home; then
+  verbose "Falling back to use Java to download"
+  javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
+  targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
+  cat >"$javaSource" <<-END
+	public class Downloader extends java.net.Authenticator
+	{
+	  protected java.net.PasswordAuthentication getPasswordAuthentication()
+	  {
+	    return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
+	  }
+	  public static void main( String[] args ) throws Exception
+	  {
+	    setDefault( new Downloader() );
+	    java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
+	  }
+	}
+	END
+  # For Cygwin/MinGW, switch paths to Windows format before running javac and java
+  verbose " - Compiling Downloader.java ..."
+  "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
+  verbose " - Running Downloader.java ..."
+  "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
+fi
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+if [ -n "${distributionSha256Sum-}" ]; then
+  distributionSha256Result=false
+  if [ "$MVN_CMD" = mvnd.sh ]; then
+    echo "Checksum validation is not supported for maven-mvnd." >&2
+    echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  elif command -v sha256sum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  elif command -v shasum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
+    echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  fi
+  if [ $distributionSha256Result = false ]; then
+    echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
+    echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+# unzip and move
+if command -v unzip >/dev/null; then
+  unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
+else
+  tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
+fi
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+actualDistributionDir=""
+
+# First try the expected directory name (for regular distributions)
+if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
+  if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
+    actualDistributionDir="$distributionUrlNameMain"
+  fi
+fi
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if [ -z "$actualDistributionDir" ]; then
+  # enable globbing to iterate over items
+  set +f
+  for dir in "$TMP_DOWNLOAD_DIR"/*; do
+    if [ -d "$dir" ]; then
+      if [ -f "$dir/bin/$MVN_CMD" ]; then
+        actualDistributionDir="$(basename "$dir")"
+        break
+      fi
+    fi
+  done
+  set -f
+fi
+
+if [ -z "$actualDistributionDir" ]; then
+  verbose "Contents of $TMP_DOWNLOAD_DIR:"
+  verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
+  die "Could not find Maven distribution directory in extracted archive"
+fi
+
+verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
+mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
+
+clean || :
+exec_maven "$@"