[2.x] Lazy loaded MediaFile metadata properties

[caendesilva]

Abstract

• Follow up to [2.x] Major performance and data handling improvements to media assets #1918
• This is a part of [2.x] Rewrite the Asset API #1904

Changes

• Makes the public readonly metadata properties protected and only accessible via getter methods
• Lazy loads metadata properties using a boot system, which constructs all metadata properties when one is accessed (and when instance is serialized to array), and then caches them for future access
• No longer validates file existence in the constructor, but instead on boot, making it possible to create memory based file objects which opens up the API for more use cases, at the cost of inconsistent places where the file existence is checked but still having a robust system in place for when trying to get filesystem information for a non-existent file

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.93%. Comparing base (5ba193a) to head (0fbbf2d).

Additional details and impacted files

@@                      Coverage Diff                      @@
##             normalize-the-asset-api    #1933      +/-   ##
=============================================================
- Coverage                      99.97%   99.93%   -0.05%     
- Complexity                      1883     1887       +4     
=============================================================
  Files                            193      193              
  Lines                           4971     4978       +7     
=============================================================
+ Hits                            4970     4975       +5     
- Misses                             1        3       +2     

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

[caendesilva]

Technically we could do something like $this->getBootedProperty() but I think this is much more readable and understandable.