mukan-ignite/ignite/internal/tools/gen-mig-diffs/readme.md
Mukan Erkin Törük 26b204bd04
Some checks are pending
Docs Deploy / build_and_deploy (push) Waiting to run
Generate Docs / cli (push) Waiting to run
Generate Config Doc / cli (push) Waiting to run
Go formatting / go-formatting (push) Waiting to run
Check links / markdown-link-check (push) Waiting to run
Integration / pre-test (push) Waiting to run
Integration / test on (push) Blocked by required conditions
Integration / status (push) Blocked by required conditions
Lint / Lint Go code (push) Waiting to run
Test / test (ubuntu-latest) (push) Waiting to run
feat: fork Ignite CLI v29 as Mukan Ignite — remove cosmos-sdk restrictions
2026-05-11 03:31:37 +03:00

2.5 KiB

Generate Ignite Migration Diffs

This repository hosts the Chain Scaffold Migration Tool for Ignite CLI, designed to help developers migrate their projects from older versions of Ignite to the latest release. This tool addresses compatibility and feature alignment as a detailed in Issue #3699 and implemented in PR #3718.

The migration tool aims to streamline the update process for projects built with Ignite CLI, ensuring they leverage the latest improvements and SDK stack.

Features

  • Automated migration of chain scaffold files.
  • Detailed comparison and generation of migration differences.
  • Support for multiple versions of chain scaffolds.

Installation

It is located in the ignite/internal/tools/gen-mig-diffs directory and made it a standalone project.

To set up this tool in your development environment:

  1. Clone the Ignite CLI repository:
git clone https://github.com/ignite/cli.git && \
cd cli/ignite/internal/tools/gen-mig-diffs
  1. Install and show usage:
go install . && gen-mig-diffs -h
  1. Run migration diff tool:
gen-mig-diffs --output temp/migs --from v0.27.2 --to v28.3.0
  1. In case of the issue unable to authenticate, attempted methods [none publickey], no supported methods remain. Make sure you have SSH keys set up for GitHub. If yes, try to add the SSH key to your SSH agent:
chmod 600 ~/.ssh/id_rsa
ssh-add ~/.ssh/id_rsa

Usage

This tool is used to generate migration diff files for each of ignites scaffold commands

Usage:
  gen-mig-diffs [flags]

Flags:
  -f, --from string              Version of Ignite or path to Ignite source code to generate the diff from
  -h, --help                     help for gen-mig-diffs
  -o, --output string            Output directory to save the migration document (default "docs/docs/06-migration")
      --repo-output string       Output path to clone the Ignite repository
  -s, --repo-source string       Path to Ignite source code repository. Set the source automatically set the cleanup to false
      --repo-url string          Git URL for the Ignite repository (default "https://github.com/ignite/cli.git")
      --scaffold-cache string    Path to cache directory
      --scaffold-output string   Output path to clone the Ignite repository
  -t, --to string                Version of Ignite or path to Ignite source code to generate the diff to