Multi-purpose Value Objects for Laravel

 Laravel Value Objects is a collection of general-purpose value objects you can use in your Laravel application. Value objects help represent simple entities such as money or X/Y coordinates on a 2D axis. Specifically, this package offers the following value objects you'd typically run into:

• Boolean
• Number
• Text
• Email
• Full Name
• Name
• Tax Number
• UUID

Take working with a user's full name, for example you might need to split up a name string into a first and last name:

$name = new FullName(' Joe User ');
 
$name->fullName(); // 'Joe User'
$name->firstName(); // 'Joe'
$name->lastName(); // 'User'

This package also provides some Laravel-specific goodies, such as extending value objects via Laravel's Macroable trait and Laravel's Conditionable trait, which applies a callback when a condition is "truthy":

TaxNumber::from('PL0123456789')
    ->when(function ($number) {
        return $number->prefix() !== null;
    })
    ->prefix();

Another example is the Number value object, which you can use to scale numbers for example:

$number = new Number('10.20999', scale: 2);
$number = Number::make('10.20999', scale: 2);
$number = Number::from('10.20999', scale: 2);
 
$number->value();   // '10.20'
(string) $number;   // '10.20'
$number->toArray(); // ['10.20']

As you can also see, this package provides a few static constructors you can use to create a value object and handle invalid data via the makeOrNull() static constructor.

You can learn more about this package, get full installation instructions, and view the source code on GitHub. The readme has documentation on how to use each of the provided value objects.

Read More

Assert DOM Elements in Laravel Tests

 The Laravel DOM Assertions package by René Sinnbeck adds document object model (DOM) assertion helpers to Laravel's TestResponse class:

This package provides some extra assertion helpers to use in HTTP Tests. If you have ever needed more control over your view assertions than assertSee, assertSeeInOrder, assertSeeText, assertSeeTextInOrder, assertDontSee, and assertDontSeeText then this is the package for you.

The package's README has an example of asserting a navigation menu to ensure the correct li element has an active class, but also ensure the "Home" li element does not:

$this->get(route('about'))
    ->assertOk()
    ->assertElementExists('nav > ul', function(AssertElement $ul) {
        $ul->contains('li', [
            'class' => 'active',
            'text' => 'About'
        ]);
        $ul->doesntContain('li', [
            'class' => 'active',
            'text' => 'Home'
        ]);
    });

The snippet illustrates the granular control provided by this package, including testing DOM elements, nested elements, forms, and more. At the time of the writing, this package's main assertions include:

• Assert if an element exists
• Assert if an element has a given attribute
• Assert if an element contains in another element
• Assert that an element does not contain another element
• Find an element to process further assertions
• Assert if a form exists
• Assert that a form has a CSRF token
• Assert for select options

You can learn more about this package, get full installation instructions, and view the source code on GitHub.

As a side note, this package's source code has an example of using the macroable mixin method to add multiple macro methods into another object from a service provider, which might be a helpful inspiration for others writing packages for Laravel.

Read More