class YamlFileLoaderTest

Tests Drupal\Core\DependencyInjection\YamlFileLoader.

Attributes

#[CoversClass(YamlFileLoader::class)] #[Group('DependencyInjection')]

Hierarchy

Expanded class hierarchy of YamlFileLoaderTest

File

core/tests/Drupal/Tests/Core/DependencyInjection/YamlFileLoaderTest.php, line 22

Namespace

Drupal\Tests\Core\DependencyInjection
View source
class YamlFileLoaderTest extends UnitTestCase {
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    FileCacheFactory::setPrefix('example');
  }
  public function testParseDefinitionsWithProvider() : void {
    $yml = <<<YAML
    services:
      example_service_1:
        class: \\Drupal\\Core\\ExampleClass
      example_service_2: '@example_service_1'
      example_private_service:
        class: \\Drupal\\Core\\ExampleClass
        public: false
      Drupal\\Core\\ExampleClass: ~
      example_tagged_iterator:
        class: \\Drupal\\Core\\ExampleClass
        arguments: [!tagged_iterator foo.bar]
      example_service_closure:
        class: \\Drupal\\Core\\ExampleClass
        arguments: [!service_closure '@example_service_1']
      example_service_closure_shorthand:
        class: \\Drupal\\Core\\ExampleClass
        arguments: ['@>example_service_1']
    YAML;
    vfsStream::setup('drupal', NULL, [
      'modules' => [
        'example' => [
          'example.yml' => $yml,
        ],
      ],
    ]);
    $builder = new ContainerBuilder();
    $yaml_file_loader = new YamlFileLoader($builder);
    $yaml_file_loader->load('vfs://drupal/modules/example/example.yml');
    $this->assertEquals([
      '_provider' => [
        [
          'provider' => 'example',
        ],
      ],
    ], $builder->getDefinition('example_service_1')
      ->getTags());
    $this->assertEquals('example_service_1', $builder->getAlias('example_service_2')
      ->__toString());
    $this->assertTrue($builder->getDefinition('example_service_1')
      ->isPublic());
    $this->assertFalse($builder->getDefinition('example_private_service')
      ->isPublic());
    $builder->compile();
    $this->assertTrue($builder->has('example_service_1'));
    $this->assertFalse($builder->has('example_private_service'));
    $this->assertTrue($builder->has('Drupal\\Core\\ExampleClass'));
    $this->assertSame('Drupal\\Core\\ExampleClass', $builder->getDefinition('Drupal\\Core\\ExampleClass')
      ->getClass());
    $this->assertInstanceOf(TaggedIteratorArgument::class, $builder->getDefinition('example_tagged_iterator')
      ->getArgument(0));
    // Test service closures.
    $service_closure = $builder->getDefinition('example_service_closure')
      ->getArgument(0);
    $this->assertInstanceOf(ServiceClosureArgument::class, $service_closure);
    $ref = $service_closure->getValues()[0];
    $this->assertInstanceOf(Reference::class, $ref);
    $this->assertEquals('example_service_1', $ref);
    $service_closure = $builder->getDefinition('example_service_closure_shorthand')
      ->getArgument(0);
    $this->assertInstanceOf(ServiceClosureArgument::class, $service_closure);
    $ref = $service_closure->getValues()[0];
    $this->assertInstanceOf(Reference::class, $ref);
    $this->assertEquals('example_service_1', $ref);
  }
  
  /**
   * Tests exceptions.
   */
  public function testExceptions($yml, $message) : void {
    vfsStream::setup('drupal', NULL, [
      'modules' => [
        'example' => [
          'example.yml' => $yml,
        ],
      ],
    ]);
    $builder = new ContainerBuilder();
    $yaml_file_loader = new YamlFileLoader($builder);
    $this->expectException(\InvalidArgumentException::class);
    $this->expectExceptionMessage($message);
    $yaml_file_loader->load('vfs://drupal/modules/example/example.yml');
  }
  public static function providerTestExceptions() {
    return [
      '_defaults must be an array' => [
        <<<YAML
        services:
          _defaults: string
        YAML,
        'Service "_defaults" key must be an array, "string" given in "vfs://drupal/modules/example/example.yml".',
      ],
      'invalid _defaults key' => [
        <<<YAML
        services:
          _defaults:
            invalid: string
        YAML,
        'The configuration key "invalid" cannot be used to define a default value in "vfs://drupal/modules/example/example.yml". Allowed keys are "public", "tags", "autowire", "autoconfigure".',
      ],
      'default tags must be an array' => [
        <<<YAML
        services:
          _defaults:
            tags: string
        YAML,
        'Parameter "tags" in "_defaults" must be an array in "vfs://drupal/modules/example/example.yml". Check your YAML syntax.',
      ],
      'default tags must have a name' => [
        <<<YAML
        services:
          _defaults:
            tags:
              - {}
        YAML,
        'A "tags" entry in "_defaults" is missing a "name" key in "vfs://drupal/modules/example/example.yml".',
      ],
      'default tag name must not be empty' => [
        <<<YAML
        services:
          _defaults:
            tags:
              - ''
        YAML,
        'The tag name in "_defaults" must be a non-empty string in "vfs://drupal/modules/example/example.yml".',
      ],
      'default tag name must be a string' => [
        <<<YAML
        services:
          _defaults:
            tags:
              - 123
        YAML,
        'The tag name in "_defaults" must be a non-empty string in "vfs://drupal/modules/example/example.yml".',
      ],
      'default tag attribute must be scalar' => [
        <<<YAML
        services:
          _defaults:
            tags:
              - { name: tag, value: [] }
        YAML,
        'Tag "tag", attribute "value" in "_defaults" must be of a scalar-type in "vfs://drupal/modules/example/example.yml". Check your YAML syntax.',
      ],
      'tags must be an array' => [
        <<<YAML
        services:
          service:
            tags: string
        YAML,
        'Parameter "tags" must be an array for service "service" in "vfs://drupal/modules/example/example.yml". Check your YAML syntax.',
      ],
      'tags must have a name' => [
        <<<YAML
        services:
          service:
            tags:
              - {}
        YAML,
        'A "tags" entry is missing a "name" key for service "service" in "vfs://drupal/modules/example/example.yml".',
      ],
      'tag name must not be empty' => [
        <<<YAML
        services:
          service:
            tags:
              - ''
        YAML,
        'The tag name for service "service" in "vfs://drupal/modules/example/example.yml" must be a non-empty string.',
      ],
      'tag attribute must be scalar' => [
        <<<YAML
        services:
          service:
            tags:
              - { name: tag, value: [] }
        YAML,
        'A "tags" attribute must be of a scalar-type for service "service", tag "tag", attribute "value" in "vfs://drupal/modules/example/example.yml". Check your YAML syntax.',
      ],
      'service must be array or @service' => [
        <<<YAML
        services:
          service: string
        YAML,
        'A service definition must be an array or a string starting with "@" but string found for service "service" in vfs://drupal/modules/example/example.yml. Check your YAML syntax.',
      ],
      'YAML must be valid' => [
        <<<YAML
           do not:
              do: this: for the love of Foo Bar!
        YAML,
        'The file "vfs://drupal/modules/example/example.yml" does not contain valid YAML',
      ],
      'YAML must have expected keys' => [
        <<<YAML
        "do not":
          do: this
        YAML,
        'The service file "vfs://drupal/modules/example/example.yml" is not valid: it contains invalid root key(s) "do not". Services have to be added under "services" and Parameters under "parameters".',
      ],
      'decorates must be without @' => [
        <<<YAML
        services:
          example_service_1:
            class: \\Drupal\\Core\\ExampleClass
          example_decoration:
            class: \\Drupal\\Core\\ExampleClass
            decorates: "@example_service_1"
        YAML,
        'The value of the "decorates" option for the "example_decoration" service must be the id of the service without the "@" prefix (replace "@example_service_1" with "example_service_1").',
      ],
      'decorates_on_invalid may not be "null" with quotes' => [
        <<<YAML
        services:
          example_service_1:
            class: \\Drupal\\Core\\ExampleClass
          example_decoration:
            class: \\Drupal\\Core\\ExampleClass
            decorates: example_service_1
            decoration_on_invalid: "null"
        YAML,
        'Invalid value "null" for attribute "decoration_on_invalid" on service "example_decoration". Did you mean null (without quotes) in "vfs://drupal/modules/example/example.yml"?',
      ],
      'decoration_on_invalid must be valid' => [
        <<<YAML
        services:
          example_service_1:
            class: \\Drupal\\Core\\ExampleClass
          example_decoration:
            class: \\Drupal\\Core\\ExampleClass
            decorates: example_service_1
            decoration_on_invalid: foo
        YAML,
        'Invalid value "foo" for attribute "decoration_on_invalid" on service "example_decoration". Did you mean "exception", "ignore" or null in "vfs://drupal/modules/example/example.yml"?',
      ],
    ];
  }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
ExpectDeprecationTrait::expectDeprecation public function Adds an expected deprecation.
ExpectDeprecationTrait::setUpErrorHandler public function Sets up the test error handler.
ExpectDeprecationTrait::tearDownErrorHandler public function Tears down the test error handler.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
UnitTestCase::$root protected property The app root.
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setDebugDumpHandler public static function Registers the dumper CLI handler when the DebugDump extension is enabled.
UnitTestCase::setupMockIterator protected function Set up a traversable class mock to return specific items when iterated.
YamlFileLoaderTest::providerTestExceptions public static function
YamlFileLoaderTest::setUp protected function Overrides UnitTestCase::setUp
YamlFileLoaderTest::testExceptions public function Tests exceptions.
YamlFileLoaderTest::testParseDefinitionsWithProvider public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.