feat: add per-task untimed lifecycle hooks

[achingbrain]

Adds four lifecycle hooks that can be configured to run on a per-task basis without impacting the test timings:

• beforeAll: run once before iterations of the task start
• beforeEach: run before each iteration of the task
• afterEach: run after each iteration of the task
• afterAll: run after all iterations finish

A contrived example:

suite.add('my task', async () => {
  // the timed function
}, {
  beforeAll: () => {
    // start a server
  },
  beforeEach: () => {
    // set up some data that the timed function will mutate
  },
  afterEach: () => {
    // tear down any mutated data or maybe verify that the timed function did what it claims to do
  },
  afterAll: () => {
    // stop the server
  }
})

This is useful if, for example, you are testing several implementations of the same functionality and need to perform different operations on each implementation to bring them into the same state so that the timing data from the task function is useful data.

Fixes #32

[achingbrain]

Without this change, npm i fails with:

% npm i
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: [email protected]
npm ERR! Found: [email protected]
npm ERR! node_modules/size-limit
npm ERR!   dev size-limit@"^8.2.4" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer size-limit@"7.0.8" from @size-limit/[email protected]
npm ERR! node_modules/@size-limit/preset-small-lib
npm ERR!   dev @size-limit/preset-small-lib@"^7.0.4" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! 
npm ERR! For a full report see:
npm ERR! /Users/alex/.npm/_logs/2023-02-21T11_08_37_616Z-eresolve-report.txt

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/alex/.npm/_logs/2023-02-21T11_08_37_616Z-debug-0.log

If you update size-limit, @size-limit/preset-small-li and @size-limit/time all to the latest versions, conflicting versions of esbuild are pulled in which tsup tries to pass the watch flag to - this was recently removed and errors out, so the simplest thing to do here seems to be to downgrade size-limit.

[achingbrain]

I've changed the names before -> beforeAll, after -> afterAll as from this comment I think the jest style is your preference rather than the mocha style.

[achingbrain]

@Aslemammad are there any changes you'd like to be made or is there anything else I can do here?

[Aslemammad]

It's good for now, soon on the weekend i'll review it and let you know

…

On Mon, 27 Feb 2023, 21:18 Alex Potsides, ***@***.***> wrote: @Aslemammad <https://github.com/Aslemammad> are there any changes you'd like to be made or is there anything else I can do here? — Reply to this email directly, view it on GitHub <#33 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AJBMICBP5Z3U3ITRBPXV4UTWZTSG5ANCNFSM6AAAAAAVC44QSI> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[Aslemammad]

Thank you so much, I forgot to write this one :)