[10.x] Sleep syncing

[timacdonald]

Adds a testing helper to keep carbon in sync when sleeping.

// Test...
Sleep::fake();
Sleep::syncWithCarbon();

// Code...
$start = now();

Sleep::for(1)->second();

$start->diffForHumans(); // 1 second ago

Before you would commonly do the following...

Carbon::fake();

Sleep::whenFakingSleep(function ($duration) {
    Carbon::setTestNow(now()->add($duration);
});

Docs: laravel/docs#9462

[abenerd]

I like this change, makes sense. I feel like this should be the default behavior for L11, would this be update for there too?

[timacdonald]

@abenerd, I thought about that as well, but wondered if it might be too magical. I usually want my tests to be really explicit and if there are side-effects happening I haven't asked for it might cause headaches.

An application just put Sleep::syncWithCarbon() in their global set up so it applies to every test.

[abenerd]

@timacdonald I feel like this is less magic and more like expected behavior, when I wake up after sleeping I want to get the correct time and not when I fell asleep. Alternatively one can also add the option to sync with carbon to the fake method, I think what "bugs" me the most is the extra call to syncWithCarbon you have to make. I could PR this.