Code Coverage |
||||||||||
Classes and Traits |
Functions and Methods |
Lines |
||||||||
| Total | |
100.00% |
1 / 1 |
|
100.00% |
9 / 9 |
CRAP | |
100.00% |
35 / 35 |
| bbcode_merger | |
100.00% |
1 / 1 |
|
100.00% |
9 / 9 |
13 | |
100.00% |
35 / 35 |
| __construct | |
100.00% |
1 / 1 |
1 | |
100.00% |
2 / 2 |
|||
| merge_bbcodes | |
100.00% |
1 / 1 |
3 | |
100.00% |
7 / 7 |
|||
| create_bbcode | |
100.00% |
1 / 1 |
1 | |
100.00% |
6 / 6 |
|||
| indent_template | |
100.00% |
1 / 1 |
2 | |
100.00% |
6 / 6 |
|||
| is_content_bbcode | |
100.00% |
1 / 1 |
2 | |
100.00% |
2 / 2 |
|||
| is_optional_bbcode | |
100.00% |
1 / 1 |
1 | |
100.00% |
2 / 2 |
|||
| merge_content_bbcode | |
100.00% |
1 / 1 |
1 | |
100.00% |
3 / 3 |
|||
| merge_optional_bbcode | |
100.00% |
1 / 1 |
1 | |
100.00% |
3 / 3 |
|||
| normalize_template | |
100.00% |
1 / 1 |
1 | |
100.00% |
4 / 4 |
|||
| <?php | |
| /** | |
| * | |
| * This file is part of the phpBB Forum Software package. | |
| * | |
| * @copyright (c) phpBB Limited <https://www.phpbb.com> | |
| * @license GNU General Public License, version 2 (GPL-2.0) | |
| * | |
| * For full copyright and license information, please see | |
| * the docs/CREDITS.txt file. | |
| * | |
| */ | |
| namespace phpbb\textformatter\s9e; | |
| use phpbb\textformatter\s9e\factory; | |
| use s9e\TextFormatter\Configurator\Helpers\TemplateLoader; | |
| use s9e\TextFormatter\Configurator\Items\UnsafeTemplate; | |
| class bbcode_merger | |
| { | |
| /** | |
| * @var \s9e\TextFormatter\Configurator $configurator Configurator instance used to inspect BBCodes | |
| */ | |
| protected $configurator; | |
| /** | |
| * @param factory $factory | |
| */ | |
| public function __construct(factory $factory) | |
| { | |
| $this->configurator = $factory->get_configurator(); | |
| } | |
| /** | |
| * Merge two BBCode definitions | |
| * | |
| * All of the arrays contain a "usage" element and a "template" element | |
| * | |
| * @throws InvalidArgumentException if a definition cannot be interpreted | |
| * @throws RuntimeException if something unexpected occurs | |
| * | |
| * @param array $without BBCode definition without an attribute | |
| * @param array $with BBCode definition with an attribute | |
| * @return array Merged definition | |
| */ | |
| public function merge_bbcodes(array $without, array $with) | |
| { | |
| $without = $this->create_bbcode($without); | |
| $with = $this->create_bbcode($with); | |
| // Select the appropriate strategy for merging this BBCode | |
| if (!$this->is_optional_bbcode($without, $with) && $this->is_content_bbcode($without, $with)) | |
| { | |
| $merged = $this->merge_content_bbcode($without, $with); | |
| } | |
| else | |
| { | |
| $merged = $this->merge_optional_bbcode($without, $with); | |
| } | |
| $merged['template'] = $this->normalize_template($merged['template']); | |
| return $merged; | |
| } | |
| /** | |
| * Create a custom BBCode for inspection | |
| * | |
| * @param array $definition Original BBCode definition | |
| * @return array Updated definition containing a BBCode object and a Tag | |
| */ | |
| protected function create_bbcode(array $definition) | |
| { | |
| $bbcode = $this->configurator->BBCodes->addCustom( | |
| $definition['usage'], | |
| new UnsafeTemplate($definition['template']) | |
| ); | |
| $definition['bbcode'] = $bbcode; | |
| $definition['tag'] = $this->configurator->tags[$bbcode->tagName]; | |
| return $definition; | |
| } | |
| /** | |
| * Indent given template for readability | |
| * | |
| * @param string $template | |
| * @return string | |
| */ | |
| protected function indent_template($template) | |
| { | |
| $dom = TemplateLoader::load($template); | |
| $dom->formatOutput = true; | |
| $template = TemplateLoader::save($dom); | |
| // Remove the first level of indentation if the template starts with whitespace | |
| if (preg_match('(^\\n +)', $template, $m)) | |
| { | |
| $template = str_replace($m[0], "\n", $template); | |
| } | |
| return trim($template); | |
| } | |
| /** | |
| * Test whether the two definitions form a "content"-style BBCode | |
| * | |
| * Such BBCodes include the [url] BBCode, which uses its text content as | |
| * attribute if none is provided | |
| * | |
| * @param array $without BBCode definition without an attribute | |
| * @param array $with BBCode definition with an attribute | |
| * @return bool | |
| */ | |
| protected function is_content_bbcode(array $without, array $with) | |
| { | |
| // Test whether we find the same non-TEXT token between "]" and "[" in the usage | |
| // as between ">" and "<" in the template | |
| return (preg_match('(\\]\\s*(\\{(?!TEXT)[^}]+\\})\\s*\\[)', $without['usage'], $m) | |
| && preg_match('(>[^<]*?' . preg_quote($m[1]) . '[^>]*?<)s', $without['template'])); | |
| } | |
| /** | |
| * Test whether the two definitions form BBCode with an optional attribute | |
| * | |
| * @param array $without BBCode definition without an attribute | |
| * @param array $with BBCode definition with an attribute | |
| * @return bool | |
| */ | |
| protected function is_optional_bbcode(array $without, array $with) | |
| { | |
| // Remove the default attribute from the definition | |
| $with['usage'] = preg_replace('(=[^\\]]++)', '', $with['usage']); | |
| // Test whether both definitions are the same, regardless of case | |
| return strcasecmp($without['usage'], $with['usage']) === 0; | |
| } | |
| /** | |
| * Merge the two BBCode definitions of a "content"-style BBCode | |
| * | |
| * @param array $without BBCode definition without an attribute | |
| * @param array $with BBCode definition with an attribute | |
| * @return array Merged definition | |
| */ | |
| protected function merge_content_bbcode(array $without, array $with) | |
| { | |
| // Convert [x={X}] into [x={X;useContent}] | |
| $usage = preg_replace('(\\})', ';useContent}', $with['usage'], 1); | |
| // Use the template from the definition that uses an attribute | |
| $template = $with['tag']->template; | |
| return ['usage' => $usage, 'template' => $template]; | |
| } | |
| /** | |
| * Merge the two BBCode definitions of a BBCode with an optional argument | |
| * | |
| * Such BBCodes include the [quote] BBCode, which takes an optional argument | |
| * but otherwise does not behave differently | |
| * | |
| * @param array $without BBCode definition without an attribute | |
| * @param array $with BBCode definition with an attribute | |
| * @return array Merged definition | |
| */ | |
| protected function merge_optional_bbcode(array $without, array $with) | |
| { | |
| // Convert [X={X}] into [X={X?}] | |
| $usage = preg_replace('(\\})', '?}', $with['usage'], 1); | |
| // Build a template for both versions | |
| $template = '<xsl:choose><xsl:when test="@' . $with['bbcode']->defaultAttribute . '">' . $with['tag']->template . '</xsl:when><xsl:otherwise>' . $without['tag']->template . '</xsl:otherwise></xsl:choose>'; | |
| return ['usage' => $usage, 'template' => $template]; | |
| } | |
| /** | |
| * Normalize a template | |
| * | |
| * @param string $template | |
| * @return string | |
| */ | |
| protected function normalize_template($template) | |
| { | |
| // Normalize the template to simplify it | |
| $template = $this->configurator->templateNormalizer->normalizeTemplate($template); | |
| // Convert xsl:value-of elements back to {L_} tokens where applicable | |
| $template = preg_replace('(<xsl:value-of select="\\$(L_\\w+)"/>)', '{$1}', $template); | |
| // Beautify the template | |
| $template = $this->indent_template($template); | |
| return $template; | |
| } | |
| } |