feat: add .todo helper for describe, it, and test

[wellwelwel]

Closes #563.

---

📋 todo

.todo is an extended helper for describe, it, and test to assist you plan future tests.

Basic Usage

Simple message

import { describe, it, test } from 'poku';

describe.todo('todo: Upcoming test');

it.todo('todo: Upcoming test');

test.todo('todo: Upcoming test');

• There is no difference between the features.

Also in internal contexts:

import { describe, it } from 'poku';

describe(() => {
  it.todo('todo: Upcoming test');

  it('Real test', () => {
    /* ... */
  });
});

Ignoring a callback

This can be useful when you already have an idea or prototype of what you want to test, but you don't want the test to actually run.

It can also be useful for tests that have unexpectedly stopped working due to some external event, requiring further attention.

import { describe, it } from 'poku';

describe.todo('todo: Upcoming test', () => {
  it(async () => {
    process.exit(1);
  });
});

• The method received by todo and everything inside it will be completely ignored.

---

When using beforeEach or afterEach, they will not be triggered by tests with .todo.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.67%. Comparing base (03005a5) to head (aa3d74e).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #633      +/-   ##
==========================================
+ Coverage   97.74%   98.67%   +0.92%     
==========================================
  Files          35       36       +1     
  Lines        1997     2037      +40     
  Branches       22       12      -10     
==========================================
+ Hits         1952     2010      +58     
+ Misses         26       16      -10     
+ Partials       19       11       -8     

Flag	Coverage Δ
linux	98.62% <100.00%> (+1.07%)	⬆️
osx	99.02% <100.00%> (+1.19%)	⬆️
windows	?

Flags with carried forward coverage won't be shown. Click here to find out more.

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