Configuration::createEmailExtension() - Code Metrics - Inspection of "Add feature to configure tasks in bundle config" - zenstruck/schedule-bundle - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#2)

by Kevin
created 2020-01-14 16:29 UTC
Configuration::createEmailExtension() A

↳ Parent: Configuration
Complexity

Conditions	1
Paths	1
Size

Total Lines	21
Code Lines	16
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	16
CRAP Score	1
Importance

Changes
Metric	Value
eloc	16
c	0
b	0
f	0
dl	0
loc	21
rs	9.7333
ccs	16
cts	16
cp	1
cc	1
nc	1
nop	2
crap	1
<?php

namespace Zenstruck\ScheduleBundle\DependencyInjection;

use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
use Symfony\Component\Config\Definition\Builder\TreeBuilder;
use Symfony\Component\Config\Definition\ConfigurationInterface;
use Zenstruck\ScheduleBundle\Schedule\Extension\SingleServerExtension;
use Zenstruck\ScheduleBundle\Schedule\Extension\WithoutOverlappingExtension;

/**
 * @author Kevin Bond <[email protected]>
 */
final class Configuration implements ConfigurationInterface
{
    public function getConfigTreeBuilder(): TreeBuilder
    {
        $treeBuilder = new TreeBuilder('zenstruck_schedule');

        $treeBuilder->getRootNode()
            ->children()
                ->scalarNode('without_overlapping_handler')
                    ->info('The LockFactory service to use')
                    ->example('lock.default.factory')
                    ->defaultNull()
                ->end()
                ->scalarNode('single_server_handler')
                    ->info('The LockFactory service to use - be sure to use a "remote store" (https://symfony.com/doc/current/components/lock.html#remote-stores)')
                    ->example('lock.redis.factory')
                    ->defaultNull()
                ->end()
                ->scalarNode('ping_handler')
                    ->info('The HttpClient service to use')
                    ->example('http_client')
                    ->defaultNull()
                ->end()
                ->scalarNode('timezone')
                    ->info('The timezone for tasks (override at task level), null for system default')
                    ->example('America/New_York')
                    ->defaultNull()
                    ->validate()
                        ->ifNotInArray(\timezone_identifiers_list())
                        ->thenInvalid('Timezone %s is not available')
                    ->end()
                ->end()
                ->arrayNode('email_handler')
                    ->canBeEnabled()
                    ->children()
                        ->scalarNode('service')
                            ->defaultValue('mailer')
                            ->cannotBeEmpty()
                            ->info('The mailer service to use')
                        ->end()
                        ->scalarNode('default_from')
                            ->info('The default "from" email address (use if no mailer default from is configured)')
                            ->defaultNull()
                        ->end()
                        ->scalarNode('default_to')
                            ->info('The default "to" email address (can be overridden by extension)')
                            ->defaultNull()
                        ->end()
                        ->scalarNode('subject_prefix')
                            ->info('The prefix to use for email subjects (use to distinguish between different application schedules)')
                            ->example('"[Acme Inc Website]"')
                            ->defaultNull()
                        ->end()
                    ->end()
                ->end()
                ->arrayNode('schedule_extensions')
                    ->addDefaultsIfNotSet()
                    ->children()
                        ->arrayNode('environments')
                            ->beforeNormalization()->castToArray()->end()
                            ->scalarPrototype()->end()
                            ->info('Set the environment(s) you only want the schedule to run in.')
                            ->example('[prod, staging]')
                        ->end()
                        ->arrayNode('on_single_server')
                            ->info('Run schedule on only one server')
                            ->canBeEnabled()
                            ->children()
                                ->integerNode('ttl')
                                    ->info('Maximum expected lock duration in seconds')
                                    ->defaultValue(SingleServerExtension::DEFAULT_TTL)
                                ->end()
                            ->end()
                        ->end()
                        ->append(self::createEmailExtension('email_on_failure', 'Send email if schedule fails'))
                        ->append(self::createPingExtension('ping_before', 'Ping a url before schedule runs'))
                        ->append(self::createPingExtension('ping_after', 'Ping a url after schedule runs'))
                        ->append(self::createPingExtension('ping_on_success', 'Ping a url if the schedule successfully ran'))
                        ->append(self::createPingExtension('ping_on_failure', 'Ping a url if the schedule failed'))
                    ->end()
                ->end()
                ->append(self::taskConfiguration())
            ->end()
        ;

        return $treeBuilder;
    }

    private static function taskConfiguration(): ArrayNodeDefinition
    {
        $treeBuilder = new TreeBuilder('tasks');
        $node = $treeBuilder->getRootNode();

        $node
            ->example([
                [
                    'command' => 'send:sales-report --detailed',
                    'frequency' => '0 * * * *',
                    'description' => 'Send sales report hourly',
                    'without_overlapping' => '~',
                    'between' => [
                        'start' => '9:00',
                        'end' => '17:00',
                    ],
                    'ping_on_success' => [
                        'url' => 'https://example.com/hourly-report-health-check',
                    ],
                    'email_on_failure' => [
                        'to' => '[email protected]',
                    ],
                ],
            ])
            ->arrayPrototype()
            ->/** @scrutinizer ignore-call */ arrayPrototype()
                ->children()
                    ->scalarNode('command')
                        ->info('The Symfony command name (with arguments) or process')
                        ->example('"my:command arg1 --option1=value" or "/bin/my-script"')
                        ->isRequired()
                        ->cannotBeEmpty()
                    ->end()
                    ->enumNode('type')
                        ->defaultValue('command')
                        ->values(['command', 'process'])
                    ->end()
                    ->scalarNode('frequency')
                        ->info('Cron string')
                        ->example('0 * * * *')
                        ->isRequired()
                        ->validate()
                            ->ifTrue(function ($v) {
                                return 5 !== \count(\explode(' ', $v));
                            })
                            ->thenInvalid('%s is an invalid cron expression.')
                        ->end()
                    ->end()
                    ->scalarNode('description')
                        ->info('Task description')
                        ->defaultNull()
                    ->end()
                    ->arrayNode('without_overlapping')
                        ->info('Prevent task from running if still running from previous run')
                        ->canBeEnabled()
                        ->children()
                            ->integerNode('ttl')
                                ->info('Maximum expected lock duration in seconds')
                                ->defaultValue(WithoutOverlappingExtension::DEFAULT_TTL)
                            ->end()
                        ->end()
                    ->end()
                    ->arrayNode('between')
                        ->info('Only run between given times')
                        ->canBeEnabled()
                        ->children()
                            ->scalarNode('start')
                                ->example('9:00')
                                ->isRequired()
                            ->end()
                            ->scalarNode('end')
                                ->example('17:00')
                                ->isRequired()
                            ->end()
                        ->end()
                    ->end()
                    ->arrayNode('unless_between')
                        ->info('Skip when between given times')
                        ->canBeEnabled()
                        ->children()
                            ->scalarNode('start')
                                ->example('17:00')
                                ->isRequired()
                            ->end()
                                ->scalarNode('end')
                                ->example('06:00')
                                ->isRequired()
                            ->end()
                        ->end()
                    ->end()
                    ->append(self::createPingExtension('ping_before', 'Ping a url before task runs'))
                    ->append(self::createPingExtension('ping_after', 'Ping a url after task runs'))
                    ->append(self::createPingExtension('ping_on_success', 'Ping a url if the task successfully ran'))
                    ->append(self::createPingExtension('ping_on_failure', 'Ping a url if the task failed'))
                    ->append(self::createEmailExtension('email_after', 'Send email after task runs'))
                    ->append(self::createEmailExtension('email_on_failure', 'Send email if task fails'))
                ->end()
            ->end()
        ;

        return $node;

    }

    private static function createEmailExtension(string $name, string $description): ArrayNodeDefinition
    {
        $treeBuilder = new TreeBuilder($name);
        $node = $treeBuilder->getRootNode();

        $node
            ->info($description)
            ->canBeEnabled()
            ->/** @scrutinizer ignore-call */ canBeEnabled()
            ->children()
                ->scalarNode('to')
                    ->info('Email address to send email to (leave blank to use "zenstruck_schedule.email_handler.default_to")')
                    ->defaultNull()
                ->end()
                ->scalarNode('subject')
                    ->info('Email subject (leave blank to use extension default)')
                    ->defaultNull()
                ->end()
            ->end()
        ;

        return $node;

    }

    private static function createPingExtension(string $name, string $description): ArrayNodeDefinition
    {
        $treeBuilder = new TreeBuilder($name);
        $node = $treeBuilder->getRootNode();

        $node
            ->info($description)
            ->canBeEnabled()
            ->children()
                ->scalarNode('url')
                    ->info('The url to ping')
                    ->isRequired()
                    ->cannotBeEmpty()
                ->end()
                ->scalarNode('method')
                    ->info('The HTTP method to use')
                    ->defaultValue('GET')
                    ->cannotBeEmpty()
                ->end()
                ->arrayNode('options')
                    ->info('See HttpClientInterface::OPTIONS_DEFAULTS')
                    ->scalarPrototype()->end()
                ->end()
            ->end()
        ;

        return $node;

    }
}

zenstruck / schedule-bundle

Pull Request — master (#2)

Configuration::createEmailExtension() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
