Skip to content

docs: add migration guide from jq/yq/mlr to morph#89

Merged
alvinreal merged 1 commit intomainfrom
fix/issue-83
Feb 23, 2026
Merged

docs: add migration guide from jq/yq/mlr to morph#89
alvinreal merged 1 commit intomainfrom
fix/issue-83

Conversation

@alvinreal
Copy link
Owner

Summary

Adds docs/MIGRATION.md — a comprehensive side-by-side recipe guide for users migrating from jq, yq, or mlr (Miller) to morph.

Sections covered

  • Format conversion — basic format-to-format examples
  • Field selection, renaming, dropping — with jq/yq/mlr equivalents
  • Filtering rows — single and compound conditions
  • Adding/computing fields — static values and computed expressions
  • Type casting — int, float, string, bool
  • Nested data — flatten and nest operations
  • Sorting — ascending and descending
  • String operations — lower, upper, replace, join, split, trim, len
  • Conditional logic — when blocks
  • Array iteration — each blocks
  • Defaults/null handling — default and coalesce
  • Chaining operations — pipeline composition
  • Caveats & differences — comparison table, limitations, common gotchas
  • Quick reference card — one-liner summary of all operations

README changes

Added a Documentation section linking to the mapping language reference, installation guide, and migration guide.

Fixes #83

@alvinreal alvinreal merged commit 6e916b9 into main Feb 23, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migration Guide: jq/yq/mlr -> morph recipes

1 participant