test-move

Test Move Contracts

Run Move test suite with options for filtering specific tests, coverage analysis, and gas profiling. Provides formatted output and actionable insights.

What This Command Does

1. Locates Move package
2. Parses command arguments for filters and options
3. Runs sui move test with appropriate flags
4. Formats and presents results
5. Provides coverage or gas analysis if requested

Instructions

Step 1: Locate Package

Check for Move.toml:

# Current directory
if [ -f "Move.toml" ]; then
  PACKAGE_PATH="."
# Or find in subdirectories
else
  find . -name "Move.toml" -maxdepth 3
fi

If multiple packages found, ask user which to test.

Step 2: Parse Arguments

Extract from arguments:

Test filter (optional):

• Specific test function name
• Module name pattern
• Example: test_create, my_module::test_*

Flags:

• --coverage or -c: Enable coverage reporting
• --gas-profile or -g: Enable gas profiling
• Both can be combined

Step 3: Run Basic Tests

Without filter:

cd [PACKAGE_PATH]
sui move test

With filter:

sui move test [FILTER]

Examples:

• sui move test test_create_nft - Run specific test
• sui move test my_module - Run all tests in module

Step 4: Format Test Results

Parse output for:

• Total tests run
• Passed tests
• Failed tests
• Test names and durations

Present formatted summary:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧪 Test Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Total Tests:    15
Passed:         14 ✓
Failed:         1 ✗
Duration:       2.3s

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If all tests pass:

✅ All tests passed!

If tests fail:

❌ Tests failed

Failed:
  • test_invalid_input (my_module)
    Expected: 0, Got: 1

Review failures and fix before deploying.

Step 5: Coverage Analysis

If --coverage flag provided:

sui move test --coverage

Parse coverage output:

• Lines covered/total
• Coverage percentage by module
• Uncovered lines