Merge pull request #32 from Vinelab/develop

Add bypass option

readme.md

@@ -138,6 +138,13 @@ not to exceed what you have allowed in your PHP configuration.
     'threshold' => 10,
 ```
 
+#### Bypass
+
+To load your local assets (not the CDN assets) for testing or during development, set the `bypass` option to `true`:
+
+```php
+    'bypass' => true,
+```
 ## Usage
 
 ### Push

src/Vinelab/Cdn/Cdn.php

@@ -63,6 +63,7 @@ public function push()
         // Initialize an instance of the asset holder to read the configurations
         // then call the read(), to return all the allowed assets as a collection of files objects
         $assets = $this->finder->read($this->asset_holder->init($configurations));
+
         // store the returned assets in the instance of the asset holder as collection of paths
         $this->asset_holder->setAssets($assets);
 

src/Vinelab/Cdn/CdnFacade.php

@@ -16,6 +16,11 @@
  */
 class CdnFacade implements CdnFacadeInterface{
 
+    /**
+     * @var array
+     */
+    protected $configurations;
+
     /**
      * @var Contracts\ProviderFactoryInterface
      */
@@ -90,7 +95,8 @@ public function path($path)
     }
 
     /**
-     * responsible of preparing the path before generating the url
+     * check if package is surpassed or not then
+     * prepare the path before generating the url
      *
      * @param $path
      * @param $prepend
@@ -100,6 +106,11 @@ public function path($path)
      */
     private function generateUrl($path, $prepend = '')
     {
+        // if the package is surpassed, then return the same $path
+        // to load the asset from the localhost
+        if ( isset($this->configurations['bypass']) and  $this->configurations['bypass'] )
+            return $path;
+
         if ( ! isset($path))
             throw new EmptyPathException('Path does not exist.');
 
@@ -120,10 +131,10 @@ private function generateUrl($path, $prepend = '')
     private function init()
     {
         // return the configurations from the config file
-        $configurations = $this->helper->getConfigurations();
+        $this->configurations = $this->helper->getConfigurations();
 
         // return an instance of the corresponding Provider concrete according to the configuration
-        $this->provider = $this->provider_factory->create($configurations);
+        $this->provider = $this->provider_factory->create($this->configurations);
     }
 
 }

src/config/cdn.php

@@ -2,6 +2,23 @@
 
 return [
 
+
+    /*
+    |--------------------------------------------------------------------------
+    | Bypass loading assets from the CDN
+    |--------------------------------------------------------------------------
+    |
+    | This option determines whether to load the assets from localhost or from
+    | the CDN server. (this is useful during development).
+    | Set it to "true" to load from localhost, or set it to "false" to load
+    | from the CDN (on production).
+    |
+    | Default: false
+    |
+    */
+
+    'bypass' => false,
+
     /*
     |--------------------------------------------------------------------------
     | Default CDN provider
@@ -75,7 +92,7 @@
                 |
                 */
                 'buckets' => [
-                    'bucket-name-here' => '*',
+                    'bucket-name' => '*',
                     //        'your-js-bucket-name-here'   =>  ['public/js'],
                     //        'your-css-bucket-name-here'  =>  ['public/css'],
                 ],