You are here

InputDefinitionTest.php in Zircon Profile 8.0

Same filename and directory in other branches
  1. 8 vendor/symfony/console/Tests/Input/InputDefinitionTest.php

File

vendor/symfony/console/Tests/Input/InputDefinitionTest.php
View source
<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Symfony\Component\Console\Tests\Input;

use Symfony\Component\Console\Input\InputDefinition;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputOption;
class InputDefinitionTest extends \PHPUnit_Framework_TestCase {
  protected static $fixtures;
  protected $foo, $bar, $foo1, $foo2;
  public static function setUpBeforeClass() {
    self::$fixtures = __DIR__ . '/../Fixtures/';
  }
  public function testConstructorArguments() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $this
      ->assertEquals(array(), $definition
      ->getArguments(), '__construct() creates a new InputDefinition object');
    $definition = new InputDefinition(array(
      $this->foo,
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getArguments(), '__construct() takes an array of InputArgument objects as its first argument');
  }
  public function testConstructorOptions() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition();
    $this
      ->assertEquals(array(), $definition
      ->getOptions(), '__construct() creates a new InputDefinition object');
    $definition = new InputDefinition(array(
      $this->foo,
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getOptions(), '__construct() takes an array of InputOption objects as its first argument');
  }
  public function testSetArguments() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->setArguments(array(
      $this->foo,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getArguments(), '->setArguments() sets the array of InputArgument objects');
    $definition
      ->setArguments(array(
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'bar' => $this->bar,
    ), $definition
      ->getArguments(), '->setArguments() clears all InputArgument objects');
  }
  public function testAddArguments() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArguments(array(
      $this->foo,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getArguments(), '->addArguments() adds an array of InputArgument objects');
    $definition
      ->addArguments(array(
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getArguments(), '->addArguments() does not clear existing InputArgument objects');
  }
  public function testAddArgument() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument($this->foo);
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getArguments(), '->addArgument() adds a InputArgument object');
    $definition
      ->addArgument($this->bar);
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getArguments(), '->addArgument() adds a InputArgument object');
  }

  /**
   * @expectedException        \LogicException
   * @expectedExceptionMessage An argument with name "foo" already exists.
   */
  public function testArgumentsMustHaveDifferentNames() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument($this->foo);
    $definition
      ->addArgument($this->foo1);
  }

  /**
   * @expectedException        \LogicException
   * @expectedExceptionMessage Cannot add an argument after an array argument.
   */
  public function testArrayArgumentHasToBeLast() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument(new InputArgument('fooarray', InputArgument::IS_ARRAY));
    $definition
      ->addArgument(new InputArgument('anotherbar'));
  }

  /**
   * @expectedException        \LogicException
   * @expectedExceptionMessage Cannot add a required argument after an optional one.
   */
  public function testRequiredArgumentCannotFollowAnOptionalOne() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument($this->foo);
    $definition
      ->addArgument($this->foo2);
  }
  public function testGetArgument() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArguments(array(
      $this->foo,
    ));
    $this
      ->assertEquals($this->foo, $definition
      ->getArgument('foo'), '->getArgument() returns a InputArgument by its name');
  }

  /**
   * @expectedException        \InvalidArgumentException
   * @expectedExceptionMessage The "bar" argument does not exist.
   */
  public function testGetInvalidArgument() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArguments(array(
      $this->foo,
    ));
    $definition
      ->getArgument('bar');
  }
  public function testHasArgument() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArguments(array(
      $this->foo,
    ));
    $this
      ->assertTrue($definition
      ->hasArgument('foo'), '->hasArgument() returns true if a InputArgument exists for the given name');
    $this
      ->assertFalse($definition
      ->hasArgument('bar'), '->hasArgument() returns false if a InputArgument exists for the given name');
  }
  public function testGetArgumentRequiredCount() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument($this->foo2);
    $this
      ->assertEquals(1, $definition
      ->getArgumentRequiredCount(), '->getArgumentRequiredCount() returns the number of required arguments');
    $definition
      ->addArgument($this->foo);
    $this
      ->assertEquals(1, $definition
      ->getArgumentRequiredCount(), '->getArgumentRequiredCount() returns the number of required arguments');
  }
  public function testGetArgumentCount() {
    $this
      ->initializeArguments();
    $definition = new InputDefinition();
    $definition
      ->addArgument($this->foo2);
    $this
      ->assertEquals(1, $definition
      ->getArgumentCount(), '->getArgumentCount() returns the number of arguments');
    $definition
      ->addArgument($this->foo);
    $this
      ->assertEquals(2, $definition
      ->getArgumentCount(), '->getArgumentCount() returns the number of arguments');
  }
  public function testGetArgumentDefaults() {
    $definition = new InputDefinition(array(
      new InputArgument('foo1', InputArgument::OPTIONAL),
      new InputArgument('foo2', InputArgument::OPTIONAL, '', 'default'),
      new InputArgument('foo3', InputArgument::OPTIONAL | InputArgument::IS_ARRAY),
    ));
    $this
      ->assertEquals(array(
      'foo1' => null,
      'foo2' => 'default',
      'foo3' => array(),
    ), $definition
      ->getArgumentDefaults(), '->getArgumentDefaults() return the default values for each argument');
    $definition = new InputDefinition(array(
      new InputArgument('foo4', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, '', array(
        1,
        2,
      )),
    ));
    $this
      ->assertEquals(array(
      'foo4' => array(
        1,
        2,
      ),
    ), $definition
      ->getArgumentDefaults(), '->getArgumentDefaults() return the default values for each argument');
  }
  public function testSetOptions() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getOptions(), '->setOptions() sets the array of InputOption objects');
    $definition
      ->setOptions(array(
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'bar' => $this->bar,
    ), $definition
      ->getOptions(), '->setOptions() clears all InputOption objects');
  }

  /**
   * @expectedException        \InvalidArgumentException
   * @expectedExceptionMessage The "-f" option does not exist.
   */
  public function testSetOptionsClearsOptions() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $definition
      ->setOptions(array(
      $this->bar,
    ));
    $definition
      ->getOptionForShortcut('f');
  }
  public function testAddOptions() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getOptions(), '->addOptions() adds an array of InputOption objects');
    $definition
      ->addOptions(array(
      $this->bar,
    ));
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getOptions(), '->addOptions() does not clear existing InputOption objects');
  }
  public function testAddOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition();
    $definition
      ->addOption($this->foo);
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
    ), $definition
      ->getOptions(), '->addOption() adds a InputOption object');
    $definition
      ->addOption($this->bar);
    $this
      ->assertEquals(array(
      'foo' => $this->foo,
      'bar' => $this->bar,
    ), $definition
      ->getOptions(), '->addOption() adds a InputOption object');
  }

  /**
   * @expectedException        \LogicException
   * @expectedExceptionMessage An option named "foo" already exists.
   */
  public function testAddDuplicateOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition();
    $definition
      ->addOption($this->foo);
    $definition
      ->addOption($this->foo2);
  }

  /**
   * @expectedException        \LogicException
   * @expectedExceptionMessage An option with shortcut "f" already exists.
   */
  public function testAddDuplicateShortcutOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition();
    $definition
      ->addOption($this->foo);
    $definition
      ->addOption($this->foo1);
  }
  public function testGetOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertEquals($this->foo, $definition
      ->getOption('foo'), '->getOption() returns a InputOption by its name');
  }

  /**
   * @expectedException        \InvalidArgumentException
   * @expectedExceptionMessage The "--bar" option does not exist.
   */
  public function testGetInvalidOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $definition
      ->getOption('bar');
  }
  public function testHasOption() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertTrue($definition
      ->hasOption('foo'), '->hasOption() returns true if a InputOption exists for the given name');
    $this
      ->assertFalse($definition
      ->hasOption('bar'), '->hasOption() returns false if a InputOption exists for the given name');
  }
  public function testHasShortcut() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertTrue($definition
      ->hasShortcut('f'), '->hasShortcut() returns true if a InputOption exists for the given shortcut');
    $this
      ->assertFalse($definition
      ->hasShortcut('b'), '->hasShortcut() returns false if a InputOption exists for the given shortcut');
  }
  public function testGetOptionForShortcut() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $this
      ->assertEquals($this->foo, $definition
      ->getOptionForShortcut('f'), '->getOptionForShortcut() returns a InputOption by its shortcut');
  }
  public function testGetOptionForMultiShortcut() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->multi,
    ));
    $this
      ->assertEquals($this->multi, $definition
      ->getOptionForShortcut('m'), '->getOptionForShortcut() returns a InputOption by its shortcut');
    $this
      ->assertEquals($this->multi, $definition
      ->getOptionForShortcut('mmm'), '->getOptionForShortcut() returns a InputOption by its shortcut');
  }

  /**
   * @expectedException        \InvalidArgumentException
   * @expectedExceptionMessage The "-l" option does not exist.
   */
  public function testGetOptionForInvalidShortcut() {
    $this
      ->initializeOptions();
    $definition = new InputDefinition(array(
      $this->foo,
    ));
    $definition
      ->getOptionForShortcut('l');
  }
  public function testGetOptionDefaults() {
    $definition = new InputDefinition(array(
      new InputOption('foo1', null, InputOption::VALUE_NONE),
      new InputOption('foo2', null, InputOption::VALUE_REQUIRED),
      new InputOption('foo3', null, InputOption::VALUE_REQUIRED, '', 'default'),
      new InputOption('foo4', null, InputOption::VALUE_OPTIONAL),
      new InputOption('foo5', null, InputOption::VALUE_OPTIONAL, '', 'default'),
      new InputOption('foo6', null, InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY),
      new InputOption('foo7', null, InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, '', array(
        1,
        2,
      )),
    ));
    $defaults = array(
      'foo1' => false,
      'foo2' => null,
      'foo3' => 'default',
      'foo4' => null,
      'foo5' => 'default',
      'foo6' => array(),
      'foo7' => array(
        1,
        2,
      ),
    );
    $this
      ->assertSame($defaults, $definition
      ->getOptionDefaults(), '->getOptionDefaults() returns the default values for all options');
  }

  /**
   * @dataProvider getGetSynopsisData
   */
  public function testGetSynopsis(InputDefinition $definition, $expectedSynopsis, $message = null) {
    $this
      ->assertEquals($expectedSynopsis, $definition
      ->getSynopsis(), $message ? '->getSynopsis() ' . $message : '');
  }
  public function getGetSynopsisData() {
    return array(
      array(
        new InputDefinition(array(
          new InputOption('foo'),
        )),
        '[--foo]',
        'puts optional options in square brackets',
      ),
      array(
        new InputDefinition(array(
          new InputOption('foo', 'f'),
        )),
        '[-f|--foo]',
        'separates shortcut with a pipe',
      ),
      array(
        new InputDefinition(array(
          new InputOption('foo', 'f', InputOption::VALUE_REQUIRED),
        )),
        '[-f|--foo FOO]',
        'uses shortcut as value placeholder',
      ),
      array(
        new InputDefinition(array(
          new InputOption('foo', 'f', InputOption::VALUE_OPTIONAL),
        )),
        '[-f|--foo [FOO]]',
        'puts optional values in square brackets',
      ),
      array(
        new InputDefinition(array(
          new InputArgument('foo', InputArgument::REQUIRED),
        )),
        '<foo>',
        'puts arguments in angle brackets',
      ),
      array(
        new InputDefinition(array(
          new InputArgument('foo'),
        )),
        '[<foo>]',
        'puts optional arguments in square brackets',
      ),
      array(
        new InputDefinition(array(
          new InputArgument('foo', InputArgument::IS_ARRAY),
        )),
        '[<foo>]...',
        'uses an ellipsis for array arguments',
      ),
      array(
        new InputDefinition(array(
          new InputArgument('foo', InputArgument::REQUIRED | InputArgument::IS_ARRAY),
        )),
        '<foo> (<foo>)...',
        'uses parenthesis and ellipsis for required array arguments',
      ),
      array(
        new InputDefinition(array(
          new InputOption('foo'),
          new InputArgument('foo', InputArgument::REQUIRED),
        )),
        '[--foo] [--] <foo>',
        'puts [--] between options and arguments',
      ),
    );
  }
  public function testGetShortSynopsis() {
    $definition = new InputDefinition(array(
      new InputOption('foo'),
      new InputOption('bar'),
      new InputArgument('cat'),
    ));
    $this
      ->assertEquals('[options] [--] [<cat>]', $definition
      ->getSynopsis(true), '->getSynopsis(true) groups options in [options]');
  }

  /**
   * @group legacy
   */
  public function testLegacyAsText() {
    $definition = new InputDefinition(array(
      new InputArgument('foo', InputArgument::OPTIONAL, 'The foo argument'),
      new InputArgument('baz', InputArgument::OPTIONAL, 'The baz argument', true),
      new InputArgument('bar', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'The bar argument', array(
        'http://foo.com/',
      )),
      new InputOption('foo', 'f', InputOption::VALUE_REQUIRED, 'The foo option'),
      new InputOption('baz', null, InputOption::VALUE_OPTIONAL, 'The baz option', false),
      new InputOption('bar', 'b', InputOption::VALUE_OPTIONAL, 'The bar option', 'bar'),
      new InputOption('qux', '', InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, 'The qux option', array(
        'http://foo.com/',
        'bar',
      )),
      new InputOption('qux2', '', InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, 'The qux2 option', array(
        'foo' => 'bar',
      )),
    ));
    $this
      ->assertStringEqualsFile(self::$fixtures . '/definition_astext.txt', $definition
      ->asText(), '->asText() returns a textual representation of the InputDefinition');
  }

  /**
   * @group legacy
   */
  public function testLegacyAsXml() {
    $definition = new InputDefinition(array(
      new InputArgument('foo', InputArgument::OPTIONAL, 'The foo argument'),
      new InputArgument('baz', InputArgument::OPTIONAL, 'The baz argument', true),
      new InputArgument('bar', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'The bar argument', array(
        'bar',
      )),
      new InputOption('foo', 'f', InputOption::VALUE_REQUIRED, 'The foo option'),
      new InputOption('baz', null, InputOption::VALUE_OPTIONAL, 'The baz option', false),
      new InputOption('bar', 'b', InputOption::VALUE_OPTIONAL, 'The bar option', 'bar'),
    ));
    $this
      ->assertXmlStringEqualsXmlFile(self::$fixtures . '/definition_asxml.txt', $definition
      ->asXml(), '->asXml() returns an XML representation of the InputDefinition');
  }
  protected function initializeArguments() {
    $this->foo = new InputArgument('foo');
    $this->bar = new InputArgument('bar');
    $this->foo1 = new InputArgument('foo');
    $this->foo2 = new InputArgument('foo2', InputArgument::REQUIRED);
  }
  protected function initializeOptions() {
    $this->foo = new InputOption('foo', 'f');
    $this->bar = new InputOption('bar', 'b');
    $this->foo1 = new InputOption('fooBis', 'f');
    $this->foo2 = new InputOption('foo', 'p');
    $this->multi = new InputOption('multi', 'm|mm|mmm');
  }

}

Classes