✨ Add PunctuationSpacingSniff

Author: VincentLanglet

TwigCS/src/Ruleset/Generic/OperatorSpacingSniff.php

@@ -8,7 +8,7 @@
 use TwigCS\Token\Token;
 
 /**
- * Ensure there is one space before and after an operator
+ * Ensure there is one space before and after an operator except for '..'
  */
 class OperatorSpacingSniff extends AbstractSpacingSniff
 {
@@ -21,35 +21,43 @@ class OperatorSpacingSniff extends AbstractSpacingSniff
     protected function shouldHaveSpaceBefore(int $tokenPosition, array $tokens): ?int
     {
         $token = $tokens[$tokenPosition];
+        if (!$this->isTokenMatching($token, Token::OPERATOR_TYPE)) {
+            return null;
+        }
 
-        $isMinus = $this->isTokenMatching($token, Token::OPERATOR_TYPE, '-');
-        $isPlus = $this->isTokenMatching($token, Token::OPERATOR_TYPE, '+');
-
-        if ($isMinus || $isPlus) {
+        if ($this->isTokenMatching($token, Token::OPERATOR_TYPE, ['-', '+'])) {
             return $this->isUnary($tokenPosition, $tokens) ? null : 1;
         }
 
-        return $this->isTokenMatching($token, Token::OPERATOR_TYPE) && '..' !== $token->getValue() ? 1 : null;
+        if ($this->isTokenMatching($token, Token::OPERATOR_TYPE, '..')) {
+            return 0;
+        }
+
+        return 1;
     }
 
     /**
      * @param int     $tokenPosition
      * @param Token[] $tokens
      *
-     * @return bool
+     * @return int|null
      */
     protected function shouldHaveSpaceAfter(int $tokenPosition, array $tokens): ?int
     {
         $token = $tokens[$tokenPosition];
+        if (!$this->isTokenMatching($token, Token::OPERATOR_TYPE)) {
+            return null;
+        }
 
-        $isMinus = $this->isTokenMatching($token, Token::OPERATOR_TYPE, '-');
-        $isPlus = $this->isTokenMatching($token, Token::OPERATOR_TYPE, '+');
-
-        if ($isMinus || $isPlus) {
+        if ($this->isTokenMatching($token, Token::OPERATOR_TYPE, ['-', '+'])) {
             return $this->isUnary($tokenPosition, $tokens) ? 0 : 1;
         }
 
-        return $this->isTokenMatching($token, Token::OPERATOR_TYPE) && '..' !== $token->getValue() ? 1 : null;
+        if ($this->isTokenMatching($token, Token::OPERATOR_TYPE, '..')) {
+            return 0;
+        }
+
+        return 1;
     }
 
     /**

TwigCS/src/Ruleset/Generic/PunctuationSpacingSniff.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TwigCS\Ruleset\Generic;
+
+use TwigCS\Sniff\AbstractSpacingSniff;
+use TwigCS\Token\Token;
+
+/**
+ * Ensure there is no space before and after a punctuation except for ':' and ','
+ */
+class PunctuationSpacingSniff extends AbstractSpacingSniff
+{
+    /**
+     * @param int     $tokenPosition
+     * @param Token[] $tokens
+     *
+     * @return int|null
+     */
+    protected function shouldHaveSpaceBefore(int $tokenPosition, array $tokens): ?int
+    {
+        $token = $tokens[$tokenPosition];
+        if ($this->isTokenMatching($token, Token::PUNCTUATION_TYPE, [')', ']', '}', ':', '.', ',', '|'])) {
+            return 0;
+        }
+
+        return null;
+    }
+
+    /**
+     * @param int     $tokenPosition
+     * @param Token[] $tokens
+     *
+     * @return int|null
+     */
+    protected function shouldHaveSpaceAfter(int $tokenPosition, array $tokens): ?int
+    {
+        $token = $tokens[$tokenPosition];
+        if ($this->isTokenMatching($token, Token::PUNCTUATION_TYPE, [':', ','])) {
+            return 1;
+        }
+
+        if ($this->isTokenMatching($token, Token::PUNCTUATION_TYPE, ['(', '[', '{', '.', '|'])) {
+            return 0;
+        }
+
+        return null;
+    }
+}

TwigCS/tests/Ruleset/Generic/OperatorSpacing/OperatorSpacingTest.fixed.twig

@@ -16,8 +16,6 @@
 
 Untouch +-/*%==:
 
-{{ [1, 2, 3] }}
-{{ {'foo': 'bar'} }}
 {{ 1 ?: 2 }}
 {{ 1 ?? 2 }}
 

TwigCS/tests/Ruleset/Generic/OperatorSpacing/OperatorSpacingTest.php

@@ -47,13 +47,13 @@ public function testSniff(): void
             [14 => 7],
             [15 => 7],
             [15 => 7],
-            [21 => 5],
-            [21 => 5],
-            [22 => 5],
-            [22 => 5],
-            [24 => 6],
-            [35 => 10],
-            [35 => 10],
+            [19 => 5],
+            [19 => 5],
+            [20 => 5],
+            [20 => 5],
+            [22 => 6],
+            [33 => 10],
+            [33 => 10],
         ]);
     }
 }

TwigCS/tests/Ruleset/Generic/OperatorSpacing/OperatorSpacingTest.twig

@@ -16,8 +16,6 @@
 
 Untouch +-/*%==:
 
-{{ [1, 2, 3] }}
-{{ {'foo': 'bar'} }}
 {{ 1?:2 }}
 {{ 1??2 }}
 

docs/twig.md

@@ -1,5 +1,44 @@
 # Twig Coding Standard Rules
 
-In construction... 
+From the [official one](http://twig.sensiolabs.org/doc/coding_standards.html).
 
-See [official one](http://twig.sensiolabs.org/doc/coding_standards.html).
+### Delimiter spacing
+
+Put one (and only one) space after the start of a delimiter (`{{`, `{%`, and `{#`)
+and before the end of a delimiter (`}}`, `%}`, and `#}`).
+
+When using the whitespace control character, do not put any spaces between it and the delimiter
+
+### Operator spacing
+
+Put one (and only one) space before and after the following operators:
+comparison operators (`==`, `!=`, `<`, `>`, `>=`, `<=`), math operators (`+`, `-`, `/`, `*`, `%`, `//`, `**`),
+logic operators (`not`, `and`, `or`), `~`, `is`, `in`, and the ternary operator (`?:`)
+
+Do not put any spaces before and after the operator `..`.
+
+### Punctuation spacing
+
+Put one (and only one) space after the `:` sign in hashes and `,` in arrays and hashes
+
+Do not put any spaces after an opening parenthesis and before a closing parenthesis in expressions
+
+Do not put any spaces before and after the following operators: `|`, `.`, `[]`
+
+Do not put any spaces before and after the opening and the closing of arrays and hashes
+
+### Todo
+
+Do not put any spaces before and after string delimiters
+
+### Todo
+
+Do not put any spaces before and after the parenthesis used for filter and function calls
+
+### Todo
+
+Use lower cased and underscored variable names
+
+### Todo
+
+Indent your code inside tags (use the same indentation as the one used for the target language of the rendered template)