test(#3616606): cover the active updating skip path

[Decipher]

Refs https://www.drupal.org/project/filefield_paths/issues/3616606

Summary

Test-only. Adds coverage for the active_updating skip path, which nothing exercised before, and records that the reported bug does not reproduce.

Why there is no fix here

dshields reports that files are renamed on every save even with active_updating off, and attributes it to property_exists($entity, 'original') missing a magic property on Drupal 10. That mechanism does not hold on any supported core:

• On 10.x, 11.0 and 11.1, original is a real dynamic property set by EntityStorageBase::doPreSave(), and property_exists() returns TRUE for those.
• On 11.2+, original became magic, but the code takes the getOriginal() branch there, and core clears the original only after invoking the update hook.

Even the released isset($entity->original) form is sound on 11.2+, because core's __isset() special-cases original.

Verification

• testFileIsNotMovedOnUpdateWhenActiveUpdatingIsOff performs the reported sequence: save with a file, change the path pattern, save again. The file stays put.
• testFileIsMovedOnUpdateWhenActiveUpdatingIsOn is the control. Without it, the first test could pass simply because the hook never ran.

The issue needs the reporter's core version and entity type before it can go further.

Summary by CodeRabbit

• Bug Fixes

  • Improved file handling when processing entities across supported Drupal versions.
  • Prevented errors caused by incompatible access to an entity’s original revision.
  • Ensured file locations update correctly when active updating is enabled, while remaining unchanged when it is disabled.

• Tests

  • Added coverage for file path behavior during entity updates.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a94d814f-0189-4925-af92-4b237e878588

📥 Commits

Reviewing files that changed from the base of the PR and between 509a32e and 6b97eb7.

📒 Files selected for processing (3)

• rector.php
• src/Hook/FileFieldPathsProcessFileLegacy.php
• tests/src/Kernel/ActiveUpdatingTest.php

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The hook now resolves an entity’s original revision once with Drupal-version compatibility. Rector excludes this legacy access from automated rewriting. A new kernel test verifies file movement when active updating is disabled or enabled.

Changes

Active updating behavior

Layer / File(s)	Summary
Original entity compatibility rector.php, src/Hook/FileFieldPathsProcessFileLegacy.php	The hook resolves the original entity once through the Drupal 11.2+ accessor or the legacy property. Rector skips this file during ReplaceEntityOriginalPropertyRector processing.
Active updating kernel coverage tests/src/Kernel/ActiveUpdatingTest.php	The kernel test verifies that files remain in the original directory when active updating is off and move to the new path when it is on.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk: ⚪ Minimal · up to 6b97e

The PR adds focused coverage for the active-updating behavior and keeps existing files in place when updating is disabled without introducing new file-operation capabilities. No actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 7 functions across 3 files.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the primary change: adding test coverage for the active updating skip path described in the PR objectives.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/3616606-active-updating

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.39%. Comparing base (d23f47e) to head (75b9e99).
⚠️ Report is 4 commits behind head on 8.x-1.x.

Additional details and impacted files

@@           Coverage Diff            @@
##           8.x-1.x      #25   +/-   ##
========================================
  Coverage    83.39%   83.39%           
========================================
  Files           20       20           
  Lines          783      783           
========================================
  Hits           653      653           
  Misses         130      130           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.