tests/phpunit/CRM/Extension/InfoTest.php

   1 <?php
   2
   3 /**
   4  * Class CRM_Extension_InfoTest
   5  * @group headless
   6  */
   7 class CRM_Extension_InfoTest extends CiviUnitTestCase {
   8
   9   public function setUp() {
  10     parent::setUp();
  11     $this->file = NULL;
  12   }
  13
  14   public function tearDown(): void {
  15     if ($this->file) {
  16       unlink($this->file);
  17     }
  18     parent::tearDown();
  19   }
  20
  21   public function testGood_file() {
  22     $this->file = tempnam(sys_get_temp_dir(), 'infoxml-');
  23     file_put_contents($this->file, "<extension key='test.foo' type='module'><file>foo</file><typeInfo><extra>zamboni</extra></typeInfo></extension>");
  24
  25     $info = CRM_Extension_Info::loadFromFile($this->file);
  26     $this->assertEquals('test.foo', $info->key);
  27     $this->assertEquals('foo', $info->file);
  28     $this->assertEquals('zamboni', $info->typeInfo['extra']);
  29   }
  30
  31   public function testBad_file() {
  32     // <file> vs file>
  33     $this->file = tempnam(sys_get_temp_dir(), 'infoxml-');
  34     file_put_contents($this->file, "<extension key='test.foo' type='module'>file>foo</file></extension>");
  35
  36     $exc = NULL;
  37     try {
  38       $info = CRM_Extension_Info::loadFromFile($this->file);
  39     }
  40     catch (CRM_Extension_Exception $e) {
  41       $exc = $e;
  42     }
  43     $this->assertTrue(is_object($exc));
  44   }
  45
  46   public function testGood_string() {
  47     $data = "<extension key='test.foo' type='module'><file>foo</file><typeInfo><extra>zamboni</extra></typeInfo></extension>";
  48
  49     $info = CRM_Extension_Info::loadFromString($data);
  50     $this->assertEquals('test.foo', $info->key);
  51     $this->assertEquals('foo', $info->file);
  52     $this->assertEquals('zamboni', $info->typeInfo['extra']);
  53     $this->assertEquals([], $info->requires);
  54   }
  55
  56   public function testGood_string_extras() {
  57     $data = "<extension key='test.bar' type='module'><file>testbar</file>
  58       <classloader>
  59         <psr4 prefix=\"Civi\\\" path=\"Civi\"/>
  60         <psr0 prefix=\"CRM_\" path=\"\"/>
  61       </classloader>
  62       <requires><ext>org.civicrm.a</ext><ext>org.civicrm.b</ext></requires>
  63     </extension>
  64     ";
  65
  66     $info = CRM_Extension_Info::loadFromString($data);
  67     $this->assertEquals('test.bar', $info->key);
  68     $this->assertEquals('testbar', $info->file);
  69     $this->assertEquals('Civi\\', $info->classloader[0]['prefix']);
  70     $this->assertEquals('Civi', $info->classloader[0]['path']);
  71     $this->assertEquals('psr4', $info->classloader[0]['type']);
  72     $this->assertEquals('CRM_', $info->classloader[1]['prefix']);
  73     $this->assertEquals('', $info->classloader[1]['path']);
  74     $this->assertEquals('psr0', $info->classloader[1]['type']);
  75     $this->assertEquals(['org.civicrm.a', 'org.civicrm.b'], $info->requires);
  76   }
  77
  78   public function getExampleAuthors() {
  79     $authorAliceXml = '<author><name>Alice</name><email>alice@example.org</email><role>Maintainer</role></author>';
  80     $authorAliceArr = ['name' => 'Alice', 'email' => 'alice@example.org', 'role' => 'Maintainer'];
  81     $authorBobXml = ' <author><name>Bob</name><homepage>https://example.com/bob</homepage><role>Developer</role></author>';
  82     $authorBobArr = ['name' => 'Bob', 'homepage' => 'https://example.com/bob', 'role' => 'Developer'];
  83
  84     $maintAliceXml = '<maintainer><author>Alice</author><email>alice@example.org</email></maintainer>';
  85     $maintAliceArr = ['author' => 'Alice', 'email' => 'alice@example.org'];
  86
  87     $hdr = "<extension key='test.author' type='module'><file>testauthor</file>";
  88     $ftr = "</extension>";
  89
  90     // Maintainers can be inputted via either <maintainer> or <authors> (with role).
  91     // Maintainers are outputted via both `$info->maintainer` and `$info->authors` (with role)
  92
  93     $cases = [];
  94     $cases[] = ["{$hdr}{$maintAliceXml}{$ftr}", [$authorAliceArr], $maintAliceArr];
  95     $cases[] = ["{$hdr}<authors>{$authorAliceXml}</authors>{$ftr}", [$authorAliceArr], $maintAliceArr];
  96     $cases[] = ["{$hdr}<authors>{$authorAliceXml}{$authorBobXml}</authors>{$ftr}", [$authorAliceArr, $authorBobArr], $maintAliceArr];
  97     $cases[] = ["{$hdr}<authors>{$authorBobXml}</authors>{$ftr}", [$authorBobArr], NULL];
  98     return $cases;
  99   }
 100
 101   /**
 102    * @dataProvider getExampleAuthors
 103    */
 104   public function testAuthors($xmlString, $expectAuthors, $expectMaintainer) {
 105     $info = CRM_Extension_Info::loadFromString($xmlString);
 106     $this->assertEquals($expectAuthors, $info->authors);
 107     $this->assertEquals($expectMaintainer, $info->maintainer);
 108   }
 109
 110   public function testBad_string() {
 111     // <file> vs file>
 112     $data = "<extension key='test.foo' type='module'>file>foo</file></extension>";
 113
 114     $exc = NULL;
 115     try {
 116       $info = CRM_Extension_Info::loadFromString($data);
 117     }
 118     catch (CRM_Extension_Exception $e) {
 119       $exc = $e;
 120     }
 121     $this->assertTrue(is_object($exc));
 122   }
 123
 124   public function test_requirements() {
 125     // Quicksearch requirement should get filtered out per extension-compatibility.json
 126     $data = "<extension key='test.foo' type='module'><file>foo</file><requires><ext>example.test</ext><ext>com.ixiam.modules.quicksearch</ext></requires></extension>";
 127
 128     $info = CRM_Extension_Info::loadFromString($data);
 129     $this->assertEquals(['example.test'], $info->requires);
 130   }
 131
 132 }