[WIP] Easy Toolset (#184)

* New Easy Toolset

New builder to ease the use of this project.
Offers a simple and fluent way to create, load, verify and decrypt tokens

Example:

```php
$jws = Build::jws()
    ->exp(time() + 3600)
    ->iat(time())
    ->nbf(time())
    ->jti('0123456789', true)
    ->alg('RS512')
    ->sign($this->rsaKey())
```

* Decrypter added

* Auto-load algorithms

* New Easy package

* Critical header support + tests added

* Minor correction

* Zip method test

* Bugs fixed

* New Load class

* Composer branches fixed

* Composer branches fixed

* Errors fixed or ignored

* Errors fixed or ignored

* Micro-optimization

* @throws statements

* @throws statements

* @throws statements + autodispatcher alias

* @throws statements

* Error fixed

* Error fixed

* Error fixed

Author: Spomky

.gitsplit.yml

@@ -51,6 +51,8 @@ splits:
       target: "https://${GH_TOKEN}@github.com/web-token/encryption-pack.git"
     - prefix: "packs/signature"
       target: "https://${GH_TOKEN}@github.com/web-token/signature-pack.git"
+    - prefix: "src/Easy"
+      target: "https://${GH_TOKEN}@github.com/web-token/jwt-easy.git"
 
 origins:
     - ^master$

phpstan.neon

@@ -11,6 +11,11 @@ parameters:
         - %currentWorkingDirectory%/src/EncryptionAlgorithm/KeyEncryption/*/Tests/*
         - %currentWorkingDirectory%/src/SignatureAlgorithm/*/Tests/*
     ignoreErrors:
+        - '#Strict comparison using === between false and .* will always evaluate to false\.*#'
+        - '#Instanceof between Jose\\Component\\Core\\Algorithm and Jose\\Component\\Core\\Algorithm will always evaluate to true\.*#'
+        - '#Parameter .* of function call_user_func_array expects .* array given\.*#'
+        - '#Call to function is_int\(\) with int will always evaluate to true\.*#'
+        - '#Call to an undefined method Jose\\Easy\\.*#'
         - '#Call to an undefined method Symfony\\Component\\Config\\Definition\\Builder\\NodeDefinition::children\(\)#'
         - '#Parameter \#1 \$value of class FG\\ASN1\\Universal\\Integer constructor expects int\, string given\.#'
         - '#Method Jose\\Component\\Core\\Util\\Ecc\\Math::rightShift\(\) should return GMP but returns resource\.#'

phpunit.xml.dist

@@ -19,6 +19,7 @@
             <directory>./src/EncryptionAlgorithm/ContentEncryption/*/Tests/</directory>
             <directory>./src/EncryptionAlgorithm/KeyEncryption/*/Tests/</directory>
             <directory>./src/EncryptionAlgorithm/Experimental/Tests/</directory>
+            <directory>./src/Easy/Tests/</directory>
         </testsuite>
     </testsuites>
     <php>

src/Bundle/JoseFramework/DependencyInjection/Compiler/AlgorithmCompilerPass.php

@@ -23,6 +23,8 @@ final class AlgorithmCompilerPass implements CompilerPassInterface
 {
     /**
      * {@inheritdoc}
+     *
+     * @throws InvalidArgumentException if the algorithm has no alias
      */
     public function process(ContainerBuilder $container): void
     {

src/Bundle/JoseFramework/DependencyInjection/Compiler/ClaimCheckerCompilerPass.php

@@ -23,6 +23,8 @@ final class ClaimCheckerCompilerPass implements CompilerPassInterface
 {
     /**
      * {@inheritdoc}
+     *
+     * @throws InvalidArgumentException if the claim checker has no alias
      */
     public function process(ContainerBuilder $container): void
     {

src/Bundle/JoseFramework/DependencyInjection/Compiler/CompressionMethodCompilerPass.php

@@ -23,6 +23,8 @@ final class CompressionMethodCompilerPass implements CompilerPassInterface
 {
     /**
      * {@inheritdoc}
+     *
+     * @throws InvalidArgumentException if the compression method has no alias
      */
     public function process(ContainerBuilder $container): void
     {

src/Bundle/JoseFramework/DependencyInjection/Compiler/EventDispatcherAliasCompilerPass.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2014-2019 Spomky-Labs
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license.  See the LICENSE file for details.
+ */
+
+namespace Jose\Bundle\JoseFramework\DependencyInjection\Compiler;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+
+final class EventDispatcherAliasCompilerPass implements CompilerPassInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function process(ContainerBuilder $container): void
+    {
+        if (!$container->hasDefinition('event_dispatcher') || $container->hasAlias(EventDispatcherInterface::class)) {
+            return;
+        }
+
+        $container->setAlias(EventDispatcherInterface::class, 'event_dispatcher');
+    }
+}

src/Bundle/JoseFramework/DependencyInjection/Compiler/HeaderCheckerCompilerPass.php

@@ -36,6 +36,9 @@ public function process(ContainerBuilder $container): void
         $this->addTokenType($definition, $container);
     }
 
+    /**
+     * @throws InvalidArgumentException if a header checker is wnongly configured
+     */
     private function addHeaderCheckers(Definition $definition, ContainerBuilder $container): void
     {
         $taggedHeaderCheckerServices = $container->findTaggedServiceIds('jose.checker.header');

src/Bundle/JoseFramework/DependencyInjection/Compiler/KeySetControllerCompilerPass.php

@@ -22,6 +22,8 @@ final class KeySetControllerCompilerPass implements CompilerPassInterface
 {
     /**
      * {@inheritdoc}
+     *
+     * @throws InvalidArgumentException if a controller has no "path" attribute
      */
     public function process(ContainerBuilder $container): void
     {
@@ -35,7 +37,7 @@ public function process(ContainerBuilder $container): void
         foreach ($taggedAlgorithmServices as $id => $tags) {
             foreach ($tags as $attributes) {
                 if (!isset($attributes['path'])) {
-                    throw new InvalidArgumentException(sprintf('The algorithm "%s" does not have any "path" attribute.', $id));
+                    throw new InvalidArgumentException(sprintf('The controller "%s" does not have any "path" attribute.', $id));
                 }
                 $definition->addMethodCall('add', [$attributes['path'], $id]);
             }

src/Bundle/JoseFramework/DependencyInjection/Source/KeyManagement/JWKSetSource.php

@@ -13,6 +13,7 @@
 
 namespace Jose\Bundle\JoseFramework\DependencyInjection\Source\KeyManagement;
 
+use InvalidArgumentException;
 use Jose\Bundle\JoseFramework\DependencyInjection\Source\KeyManagement\JWKSetSource\JWKSetSource as JWKSetSourceInterface;
 use Jose\Bundle\JoseFramework\DependencyInjection\Source\Source;
 use LogicException;
@@ -33,6 +34,9 @@ public function name(): string
         return 'key_sets';
     }
 
+    /**
+     * @throws LogicException if the definition is not configured
+     */
     public function load(array $configs, ContainerBuilder $container): void
     {
         $sources = $this->getJWKSetSources();
@@ -77,6 +81,8 @@ public function prepend(ContainerBuilder $container, array $config): array
     }
 
     /**
+     * @throws InvalidArgumentException if the source object is not valid
+     *
      * @return JWKSetSourceInterface[]
      */
     private function getJWKSetSources(): array
@@ -97,7 +103,7 @@ private function getJWKSetSources(): array
         foreach (array_keys($services) as $id) {
             $factory = $tempContainer->get($id);
             if (!$factory instanceof JWKSetSourceInterface) {
-                throw new \InvalidArgumentException('Invalid object');
+                throw new InvalidArgumentException('Invalid object');
             }
             $jwkset_sources[str_replace('-', '_', $factory->getKeySet())] = $factory;
         }