Feature: Add runtimeHooksPath options with onBeforeWriteToDiscPath in it

[Ayc0]

Description

Add a new top level option runtimeHooksPath that contains a potential path to a JS file.
This file can contain multiple hooks when diffSnapshot is called, like onBeforeWriteToDiscPath (to be able to inject EXIF data to PNGs without building this feature into this library).

The reason why I exposed that via a path to a JS file instead of exposing a function, is because diffSnapshot is sometimes called from a worker, and we cannot serialize properly functions.

For now there is only onBeforeWriteToDiscPath but I made that generic enough to be able to add more features to it in the future.

Motivation and Context

Fixes: #332

How Has This Been Tested?

I added unit tests for this feature

Types of Changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation (adding or updating documentation)
• Dependency update

Checklist:

• My change requires a change to the documentation and I have updated the documentation accordingly.
• My changes are in sync with the code style of this project.
• There aren't any other open Pull Requests for the same issue/update.
• These changes should be applied to a maintenance branch.
• I have added the Apache 2.0 license header to any new files created.

What is the Impact to Developers Using Jest-Image-Snapshot?

It shouldn't impact them at all as long as they don't use this new feature

[Ayc0]

@code-forger what do you think about this new feature?

[JAdshead]

Sorry for the long wait, this fell of the radar. Small comment but not going to block this.

[JAdshead]

Stylistically i'd prefer moving this function out of diffImageToSnapshot and renaming to something like writeFileWithHooks and have it take runtimeHooksPath as a third argument. that way it more clearly differentiates the custom writeFileSync from fs.writeFileSync

as an example:

Suggested change

	const writeFileSync = (pathToFile, content) => {
	const writeFileWithHooks = (pathToFile, content, runtimeHooksPath) => {

[Ayc0]

I won't have time to do this modification right now, but I'll do it in the next few days!

Thanks for the review 🙇‍♂️

[Ayc0]

FYI: I'd need 5 arguments as testPath & currentTestName are also used inside of this writeFileSync

[Ayc0]

This is now updated
@JAdshead you can re-review if you want 👌

[Ayc0]

FYI, due to bade294, the command npm run test:git-history seems to be failing:

[oneamexbot]

🎉 This PR is included in version 6.3.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀