Automatically resolve to_shopify mapping chain from oldest to current version

[danielpgross]

TL;DR

Changes how integration mappings are defined from older Shopify taxonomy versions.

Before:

• In data, old Shopify integration versions were defined relative to the current/latest version (ex. 2022-01 is defined relative to 2025-01-unstable)
  • Pain point: every time we added a new to_shopify mapping, we needed to also add it individually to each older version.
• In dist, old Shopify integration versions were generated relative to the current version

After:

• In data, old Shopify integration versions are defined relative to the immediately next version (ex. 2022-01 is defined relative to 2024-07)
• In dist, old Shopify integration versions are generated relative to the current version

How it works

• When initially loading MappingRules, category IDs are no longer resolved to Category objects using the current taxonomy. Instead, the raw category ID is stored.
• After all mappings to Shopify have been loaded, the category IDs are resolved:
  • We start from the newest integration version and resolve its category IDs against the current taxonomy.
  • We then move backwards one version at a time, resolving each version against the immediate next one.
• Once this process is done, each integration version has had its category IDs resolved to Category objects, taking into account any mappings that appear in newer versions.

Breakdown of changes

The PR is big, but most of the changes are test fixtures. The actual implementation changes are mostly in:

• IntegrationVersion#load_all_from_source
• IntegrationVersion#resolve_to_shopify_mappings

The other notable change is extracting out one of the tests from IntegrationVersionTest into a dedicated integration test (GenerateMappingsDistTest). Instead of heavily relying on mocking like the old test, the new dedicated test compares generated file contents against fixtures. This approach is more straightforward and easier to maintain.

[danielpgross]

• Automatically resolve to_shopify mapping chain from oldest to current version #517 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[elsom25]

Such an important change — left just a few stylistic nits, nothing blocking

[danielpgross]

Merge activity

• Jan 8, 4:41 PM EST: A user started a stack merge that includes this pull request via Graphite.
• Jan 8, 4:44 PM EST: A user merged this pull request with Graphite.