Allow using instance of Field

[georgeboot]

This code enabled you to use an instance of a Field instead of only specifying it's class. This enables some cool reusability scenarios.

The problem we wanted to solve is reusability of both a field definition (with args) but also the resolver.

By default you define your field in a field class and your resolver (mapper) in a scalar.
But since the scalar can't access the $args, we opted to do it this way.

We're currently using it for our FormattableDate type.

<?php

class Purchase extends GraphQLType
{
    protected $attributes = [
        'name' => 'Purchase',
        'model' => PurchaseModel::class,
    ];

    public function fields(): array
    {
        return [
            // ...

            'createdAt' => new Fields\FormattableDate([
                'alias' => 'created_at',
            ]),
        ];
    }
}

<?php

class FormattableDate extends Field
{
    protected $attributes = [
        'name' => 'FormattableDate',
    ];

    public function __construct(array $settings = [])
    {
        $this->attributes = \array_merge($this->attributes, $settings);
    }

    protected function getProperty(): string
    {
        return $this->attributes['alias'] ?? $this->attributes['name'];
    }

    public function args(): array
    {
        return [
            'human' => [
                'type' => Type::boolean(),
                'defaultValue' => false,
            ],
            'format' => [
                'type' => Type::string(),
                'defaultValue' => 'Y-m-d H:i',
                'description' => 'Defaults to Y-m-d H:i',
            ],
            'relative' => [
                'type' => Type::boolean(),
                'defaultValue' => false,
            ],
        ];
    }

    public function type(): Type
    {
        return GraphQL::type('FormattableDate');
    }

    public function resolve(Model $root, array $args): string
    {
        /** @var Carbon $date */
        $date = $root->{$this->getProperty()};

        if ($args['human']) {
            return $date->format('l j F Y');
        }

        if ($args['relative']) {
            return $date->diffForHumans();
        }
        
        return $date->format($args['format']);
    }
}

[mfn]

Approach looks good to me!

Could you please:

• add test for it?
  Since this requires custom types, they're usually put into tests/Unit/<NameOfTestUnit/ with their types, queries, etc.
• add a your example to the documentation?

thanks!

[mfn]

Solid work, thank you 🤗