Release Notes

v5.x Highlights

These are the new features and additions of Athenaeum v5.x.

• v5.x Highlights
  • Http Client Middleware
  • Extract Response Expectations
  • Debugging Request and Response
  • Default otherwise callback
  • Support for TOML configuration files
  • Resolve list of dependencies
  • Http Messages Package
  • Duration
  • Upgraded Dependencies
• Changelog

Http Client Middleware

You can now assign middleware to process your outgoing requests and incoming responses. See Http Client Middleware for more examples.

use Acme\Middleware\MeasuresResponseTime;

$response = $client
        ->withMiddleware(new MeasuresResponseTime())
        ->get('/weather');

Extract Response Expectations

A ResponseExpectations class has been added, which you can use as a base class to extract complex expectations into separate classes. See documentation for additional information.

use Aedart\Http\Clients\Requests\Builders\Expectations\ResponseExpectation;
use Aedart\Contracts\Http\Clients\Responses\Status;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

class UserWasCreated extends ResponseExpectations
{
    public function expectation(
        Status $status,
        ResponseInterface $response,
        RequestInterface $request
    ): void {
        // ...validation not shown here...
    }
}

// --------------------------------------- /
// Use expectation when you send your request
$response = $client
        ->expect(new UserWasCreated())
        ->post('/users', [ 'name' => 'John Snow' ]);

Debugging Request and Response

Debugging and logging utilities have been added for a quick way to dump outgoing request and incoming response.

// Dump request / response.
$response = $client
        ->debug()
        ->get('/users');

// --------------------------------------------

// Logs the request / response.
$response = $client
        ->log()
        ->get('/users');

Default otherwise callback

The Circuit Breaker now supports setting a default "otherwise" callback, via the otherwise() method. When no "otherwise" callback is provided to the attempt() method, the default "otherwise" callback will be used.

use Aedart\Contracts\Circuits\CircuitBreaker;

$result = $circuitBreaker
    ->otherwise(function(CircuitBreaker $cb) {
        // ...not shown...
    })
    ->attempt(function(CircuitBreaker $cb) {
        // ...callback not shown...
    });

Support for TOML configuration files

Added configuration file parser for TOML format, for the configuration loader.

Resolve list of dependencies

Using the new ListResolver, you can resolve a list of dependencies, including custom arguments. (Component is available in the Service Container package).

use Aedart\Container\ListResolver;

$list = [
    \Acme\Filters\SanitizeInput::class,
    \Acme\Filters\ConvertEmptyToNull::class,
    \Acme\Filters\ApplySorting::class => [
        'sortBy' => 'age',
        'direction' => 'desc'
    ]
];

// Resolve list of dependencies
$filters = (new ListResolver())->make($list);

Http Messages Package

A new package for that offers PSR-7 Http Messages utilities. See documentation for additional information.

Duration

Added Duration utility; a small component able to help with dealing with relative date and time. See utilities for more information.

Upgraded Dependencies

Upgraded several dependencies, here amongst Laravel which is now running on v8.x.

Changelog

Make sure to read the changelog for additional information about the latest release, new features, changes and bug fixes.