[7.x] Add withToken() helper method

[aryehraber]

This PR adds a small helper method for tests using Authorization Bearer tokens as part of request headers. It was inspired by the existing $request->bearerToken() method on the Illuminate\Http\Request class, which is also really useful.

I feel this allows requests inside tests to read a little nicer, as well as helps against typos when writing "Authorization" and "Bearer" over and over, and instead IDEs can autocomplete the method.

$response = $this->withHeader('Authorization', 'Bearer test_token')->postJson('/some-endpoint');

$response = $this->withBearerToken('test_token')->postJson('/some-endpoint');

There are no breaking changes, and I've added a small test to verify everything works as expected.

Happy to make changes if there's any feedback!

[aryehraber]

I just noticed that the Illuminate\Http\Client\PendingRequest class uses withToken() which is even better/shorter and allows overriding the default "Bearer" type.

I'll push an update to make this method more dynamic shortly!

[GrahamCampbell]

Please also rebase this PR against the latest 7.x codebase. :)

[aryehraber]

Whoops, I think I did something wrong while rebasing! Apologies if this sent out a bunch of notifications 🤦‍♂️

@GrahamCampbell Sorry about this, what's the best way to fix this? Should I create a new PR and ensure my branch is on latest 7.x?

[lcdss]

It can be easier just copy the your commits hash sequentially (since it's not many), reset hard the branch to the latest upstream commit, cherry pick your commits and then a push force.

[aryehraber]

Thanks @lcdss, I ended up doing something similar -- looks ok now (I think)

[aryehraber]

The PR is now ready for review!

The method changed slightly since my original message, so here's an updated snippet to demonstrate its usefulness:

$response = $this->withHeader('Authorization', 'Bearer test_token')->postJson('/some-endpoint');

$response = $this->withToken('test_token')->postJson('/some-endpoint');

Much shorter and more readable I think — hope you agree 😊

Let me know if there's any feedback!