metamove 0.2.0

Transform YAML: move meta under config.meta

MetaMove: Automate Your dbt 1.10 Migration

⚠️ dbt 1.10 Deprecation Notice: Starting with dbt 1.10, meta and tags properties must be moved under a config block. This tool automates that migration for you.

🎯 What This Does For You

If you're using dbt (Core or Cloud) and upgrading to version 1.10, you'll start seeing deprecation warnings for your YAML files. This is because dbt is changing how meta and tags should be structured in your project files.

Instead of manually updating hundreds of YAML files, MetaMove does it automatically while preserving your comments and formatting.

Before & After Example

Before:

models:
  - name: my_model
    meta:
      owner: "Data Team"
    tags: ["core", "customer"]
    columns:
      - name: id
        meta:
          is_primary_key: true
        tags: ["identifier"]

After:

models:
  - name: my_model
    config:
      meta:
        owner: "Data Team"
      tags: ["core", "customer"]
    columns:
      - name: id
        config:
          meta:
            is_primary_key: true
          tags: ["identifier"]

🚀 Quick Start

For Mac Users

1. Download the latest binary from GitHub Releases
2. Make it executable:

   chmod +x metamove
   

3. Run it:

   ./metamove --help
   

For Everyone Else

The easiest way to install is with pipx:

pip install pipx  # if you don't have it
pipx install metamove
metamove --help

💡 Why Use This?

• Save Hours: No more manual file editing
• Zero Risk: Preserves all your comments and formatting
• Complete: Handles all your YAML files, including nested structures
• Smart: Intelligently merges existing config blocks
• Safe: Creates backups before making changes

🔧 Technical Details

The tool handles:

• meta and tags at any nesting level (including inside columns)
• Existing config blocks (merges new values in)
• All YAML types (dict, list, scalar)
• YAML comments and whitespace formatting
• Proper placement following dbt precedence rules

📚 Learn More

• dbt 1.10 Release Notes
• dbt Configuration Guide
• GitHub Issue #11651

🤝 Contributing

Found a bug or have an idea? Open an issue or submit a pull request!