Widgets Namespaces

Author: sebastienheyd

README.md

@@ -383,3 +383,31 @@ Widget::group('sidebar')->removeAll(); // Widget group is empty now
 `Widget::group('sidebar')->any(); // bool`
 
 `Widget::group('sidebar')->count(); // int`
+
+## Namespaces for third party packages (extra)
+
+In some cases, it may be useful to deliver widgets with your own packages. For example, if your package allows 
+you to manage news, it would be convenient to have immediately configurable widgets, ready for display, directly 
+delivered with your package.
+
+To avoid having to use the fqcn each time, you can set a widget namespace into your package provider. This way the 
+widgets from your package can be more easily identified, and especially the syntax will be shorter.
+
+To do that, all you have to do is to register the namespace in your package service provider :
+
+```php
+public function boot() 
+{
+    app('arrilot.widget-namespaces')->registerNamespace('my-package-name', '\VendorName\PackageName\Path\To\Widgets');
+}
+```
+
+After that you can use the namespace in your views :
+
+```php
+@widget('my-package-name::foo.bar')
+
+// is equivalent to
+@widget('\VendorName\PackageName\Path\To\Widgets\Foo\Bar')
+```
+ 

src/Console/WidgetMakeCommand.php

@@ -224,7 +224,7 @@ protected function makeViewName()
         // convert to snake_case part by part to avoid unexpected underscores.
         $nameArray = explode('/', $name);
         array_walk($nameArray, function (&$part) {
-            $part = snake_case($part);
+            $part = Str::snake($part);
         });
 
         return implode('/', $nameArray);

src/Contracts/ApplicationWrapperContract.php

@@ -54,4 +54,13 @@ public function getNamespace();
      * @return mixed
      */
     public function make($abstract, array $parameters = []);
+
+    /**
+     * Wrapper around app()->get().
+     *
+     * @param string $id
+     *
+     * @return mixed
+     */
+    public function get($id);
 }

src/Factories/AbstractWidgetFactory.php

@@ -8,6 +8,7 @@
 use Arrilot\Widgets\Misc\InvalidWidgetClassException;
 use Arrilot\Widgets\Misc\ViewExpressionTrait;
 use Arrilot\Widgets\WidgetId;
+use Illuminate\Support\Str;
 
 abstract class AbstractWidgetFactory
 {
@@ -115,12 +116,21 @@ protected function instantiateWidget(array $params = [])
     {
         WidgetId::increment();
 
-        $this->widgetName = $this->parseFullWidgetNameFromString(array_shift($params));
+        $str = array_shift($params);
+
+        if (preg_match('#^(.*?)::(.*?)$#', $str, $m)) {
+            $rootNamespace = $this->app->get('arrilot.widget-namespaces')->getNamespace($m[1]);
+            $str = $m[2];
+        }
+
+        $this->widgetName = $this->parseFullWidgetNameFromString($str);
         $this->widgetFullParams = $params;
         $this->widgetConfig = (array) array_shift($params);
         $this->widgetParams = $params;
 
-        $rootNamespace = $this->app->config('laravel-widgets.default_namespace', $this->app->getNamespace().'Widgets');
+        if(!isset($rootNamespace)) {
+            $rootNamespace = $this->app->config('laravel-widgets.default_namespace', $this->app->getNamespace().'Widgets');
+        }
 
         $fqcn = $rootNamespace.'\\'.$this->widgetName;
         $widgetClass = class_exists($fqcn) ? $fqcn : $this->widgetName;
@@ -149,7 +159,7 @@ protected function instantiateWidget(array $params = [])
      */
     protected function parseFullWidgetNameFromString($widgetName)
     {
-        return studly_case(str_replace('.', '\\_', $widgetName));
+        return Str::studly(str_replace('.', '\\_', $widgetName));
     }
 
     /**

src/Misc/LaravelApplicationWrapper.php

@@ -90,4 +90,17 @@ public function make($abstract, array $parameters = [])
     {
         return $this->app->make($abstract, $parameters);
     }
+
+    /**
+     * Wrapper around app()->get().
+     *
+     * @param string $id
+     *
+     * @return mixed
+     * @throws \Illuminate\Container\EntryNotFoundException
+     */
+    public function get($id)
+    {
+        return $this->app->get($id);
+    }
 }

src/Misc/NamespaceNotFoundException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Arrilot\Widgets\Misc;
+
+use Exception;
+
+class NamespaceNotFoundException extends Exception
+{
+}

src/NamespacesRepository.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Arrilot\Widgets;
+
+use Arrilot\Widgets\Misc\NamespaceNotFoundException;
+
+class NamespacesRepository
+{
+    /**
+     * The array of namespaces.
+     *
+     * @var array
+     */
+    protected $namespaces;
+
+    /**
+     * Register a namespace.
+     *
+     * @param string $alias
+     * @param string $namespace
+     *
+     * @return WidgetNamespaces
+     */
+    public function registerNamespace($alias, $namespace)
+    {
+        $this->namespaces[$alias] = rtrim($namespace, '\\');
+        return $this;
+    }
+
+    /**
+     * Get namespace by his alias.
+     *
+     * @param string $label
+     *
+     * @return string
+     * @throws \Exception
+     */
+    public function getNamespace($alias)
+    {
+        if (!isset($this->namespaces[$alias])) {
+            throw new NamespaceNotFoundException('Namespace not found with the alias "'.$alias.'"');
+        }
+
+        return $this->namespaces[$alias];
+    }
+}

src/ServiceProvider.php

@@ -33,6 +33,10 @@ public function register()
             return new WidgetGroupCollection(new LaravelApplicationWrapper());
         });
 
+        $this->app->singleton('arrilot.widget-namespaces', function () {
+            return new NamespacesRepository();
+        });
+
         $this->app->singleton('command.widget.make', function ($app) {
             return new WidgetMakeCommand($app['files']);
         });

tests/Support/TestApplicationWrapper.php

@@ -6,6 +6,7 @@
 use Arrilot\Widgets\Contracts\ApplicationWrapperContract;
 use Arrilot\Widgets\Factories\AsyncWidgetFactory;
 use Arrilot\Widgets\Factories\WidgetFactory;
+use Arrilot\Widgets\NamespacesRepository;
 use Illuminate\Container\Container;
 use Closure;
 use Doctrine\Instantiator\Exception\InvalidArgumentException;
@@ -107,4 +108,18 @@ public function make($abstract, array $parameters = [])
 
         throw new InvalidArgumentException("Binding {$abstract} cannot be resolved while testing");
     }
+
+    /**
+     * Wrapper around app()->get().
+     *
+     * @param string $id
+     *
+     * @return mixed
+     */
+    public function get($id)
+    {
+        if ($id == 'arrilot.widget-namespaces') {
+            return (new NamespacesRepository())->registerNamespace('dummy', '\Arrilot\Widgets\Test\Dummies');
+        }
+    }
 }

tests/WidgetFactoryTest.php

@@ -3,6 +3,7 @@
 namespace Arrilot\Widgets\Test;
 
 use Arrilot\Widgets\Factories\WidgetFactory;
+use Arrilot\Widgets\NamespacesRepository;
 use Arrilot\Widgets\Test\Dummies\TestCachedWidget;
 use Arrilot\Widgets\Test\Support\TestApplicationWrapper;
 use Arrilot\Widgets\Test\Support\TestCase;
@@ -68,6 +69,20 @@ public function testItCanRunWidgetsUsingFQCN()
         $this->assertEquals('Default test slider was executed with $slides = 6', $output);
     }
 
+    public function testItThrowsExceptionForNamespaceNotFound()
+    {
+        $this->expectException('Arrilot\Widgets\Misc\NamespaceNotFoundException');
+
+        $output = $this->factory->run('notfound::TestDefaultSlider');
+    }
+
+    public function testItCanRunWidgetsUsingNamespace()
+    {
+        $output = $this->factory->run('dummy::TestDefaultSlider');
+
+        $this->assertEquals('Default test slider was executed with $slides = 6', $output);
+    }
+
     public function testItLoadsWidgetsFromRootNamespaceFirst()
     {
         $output = $this->factory->run('Exception');