Support desc filter (#180)

* Adding Desc filter

* Make sue we save Desc when importing

* Make the class final

* Adding visitors to twig filter

* Added tests

* cs

* Addd author docs

Author: Nyholm

Changelog.md

@@ -6,6 +6,16 @@ The change log describes what is "Added", "Removed", "Changed" or "Fixed" betwee
 
 ### Added
 
+- Support for `desc` filter in Twig.
+
+### Changed
+
+- Twig extension `TranslationExtension` was renamed to `EditInPlaceExtension`
+
+## 0.5.0
+
+### Added
+
 - Symfony 4 support
 - New `--cache` option on the `translation:download` allowing to clear the cache automatically if the downloaded translations have changed.
 - Support for Yandex translator

Resources/config/edit_in_place.yml

@@ -24,7 +24,7 @@ services:
 
   php_translation.edit_in_place.extension.trans:
     public: false
-    class: Translation\Bundle\Twig\TranslationExtension
+    class: Translation\Bundle\Twig\EditInPlaceExtension
     arguments:
       - '@php_translator.edit_in_place.xtrans_html_translator'
     calls:

Resources/config/extractors.yml

@@ -73,7 +73,7 @@ services:
     public: false
 
   php_translation.extractor.twig.visitor.twig:
-    class: Translation\Bundle\Twig\DummyTwigVisitor
+    class: Translation\Bundle\Twig\Visitor\DummyTwigVisitor
     factory: ["@php_translation.extractor.twig.factory", create]
     tags:
       - { name: 'php_translation.visitor', type: 'twig' }

Resources/config/services.yml

@@ -56,6 +56,7 @@ services:
     arguments: []
 
   php_translation.twig_extension:
-    class: Translation\Extractor\Twig\TranslationExtension
+    class: Translation\Bundle\Twig\TranslationExtension
+    arguments: ['@translator', "%kernel.debug%"]
     tags:
-        - { name: twig.extension }
+        - { name: twig.extension }

Service/Importer.php

@@ -120,6 +120,9 @@ private function convertSourceLocationsToMessages(MessageCatalogue $catalogue, S
 
             $meta = $this->getMetadata($catalogue, $key, $domain);
             $meta->addCategory('file-source', sprintf('%s:%s', substr($sourceLocation->getPath(), $trimLength), $sourceLocation->getLine()));
+            if (isset($sourceLocation->getContext()['desc'])) {
+                $meta->addCategory('desc', $sourceLocation->getContext()['desc']);
+            }
             $this->setMetadata($catalogue, $key, $domain, $meta);
         }
     }

Tests/Unit/Twig/BaseTwigTestCase.php

@@ -0,0 +1,35 @@
+<?php
+
+/*
+ * This file is part of the PHP Translation package.
+ *
+ * (c) PHP Translation team <tobias.nyholm@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Translation\Bundle\Tests\Unit\Twig;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Translation\MessageSelector;
+use Symfony\Component\Translation\IdentityTranslator;
+use Symfony\Bridge\Twig\Extension\TranslationExtension as SymfonyTranslationExtension;
+use Translation\Bundle\Twig\TranslationExtension;
+
+/**
+ * @author Johannes M. Schmitt <schmittjoh@gmail.com>
+ */
+abstract class BaseTwigTestCase extends TestCase
+{
+    final protected function parse($file, $debug = false)
+    {
+        $content = file_get_contents(__DIR__.'/Fixture/'.$file);
+
+        $env = new \Twig_Environment(new \Twig_Loader_Array([]));
+        $env->addExtension(new SymfonyTranslationExtension($translator = new IdentityTranslator(new MessageSelector())));
+        $env->addExtension(new TranslationExtension($translator, $debug));
+
+        return $env->parse($env->tokenize(new \Twig_Source($content, null)))->getNode('body');
+    }
+}

Tests/Unit/Twig/DefaultApplyingNodeVisitorTest.php

@@ -0,0 +1,26 @@
+<?php
+
+/*
+ * This file is part of the PHP Translation package.
+ *
+ * (c) PHP Translation team <tobias.nyholm@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Translation\Bundle\Tests\Unit\Twig;
+
+/**
+ * @author Johannes M. Schmitt <schmittjoh@gmail.com>
+ */
+class DefaultApplyingNodeVisitorTest extends BaseTwigTestCase
+{
+    public function testApply()
+    {
+        $this->assertEquals(
+            $this->parse('apply_default_value_compiled.html.twig', true),
+            $this->parse('apply_default_value.html.twig', true)
+        );
+    }
+}

Tests/Unit/Twig/Fixture/apply_default_value.html.twig

@@ -0,0 +1,4 @@
+{{ "form.label.firstname"|trans|desc("Firstname") }}
+
+{{ "foo.%bar%"|trans({"%bar%": "baz"})|desc("Foo %bar%") }}
+

Tests/Unit/Twig/Fixture/apply_default_value_compiled.html.twig

@@ -0,0 +1,4 @@
+{{ "form.label.firstname"|trans == "form.label.firstname" ? "Firstname" : "form.label.firstname"|trans }}
+
+{{ "foo.%bar%"|trans({}) == "foo.%bar%" ? "Foo %bar%"|replace({"%bar%": "baz"}) : "foo.%bar%"|trans({"%bar%": "baz"}) }}
+

Tests/Unit/Twig/Fixture/binary_concat_of_constants.html.twig

@@ -0,0 +1,3 @@
+{{ "foo"
+   ~ "bar"
+   ~ "baz" }}