Merge pull request #891 from robfrawley/feature-release-1.7.3

[WIP] Release 1.7.3

CHANGELOG.md

@@ -1,10 +1,20 @@
 # Change Log
 
 ## [Unreleased](https://github.com/liip/LiipImagineBundle/tree/HEAD) (2017-xx-xx)
-[Full Changelog](https://github.com/liip/LiipImagineBundle/compare/1.7.2...HEAD)
+[Full Changelog](https://github.com/liip/LiipImagineBundle/compare/1.7.3...HEAD)
 
-## [1.7.2](https://github.com/liip/LiipImagineBundle/tree/HEAD) (2017-02-07)
-[Full Changelog](https://github.com/liip/LiipImagineBundle/compare/1.7.2...1.7.1)
+## [1.7.3](https://github.com/liip/LiipImagineBundle/tree/1.7.3) (2017-03-01)
+[Full Changelog](https://github.com/liip/LiipImagineBundle/compare/1.7.2...1.7.3)
+
+- \[Tests\] Support PHPUnit 5.x (and remove depredations) [\#887](https://github.com/liip/LiipImagineBundle/pull/887) ([robfrawley](https://github.com/robfrawley))
+- \[Tests\] Assert expected deprecation using symfony/phpunit-bridge [\#886](https://github.com/liip/LiipImagineBundle/pull/886) ([robfrawley](https://github.com/robfrawley))
+- \[Minor\] \[Docs\] Fix typo in general filters documentation [\#888](https://github.com/liip/LiipImagineBundle/pull/888) ([svenluijten](https://github.com/svenluijten))
+- \[Loader\] Add bundle resources to safe path when requested [\#883](https://github.com/liip/LiipImagineBundle/pull/883) ([bobvandevijver](https://github.com/bobvandevijver), [robfrawley](https://github.com/robfrawley))
+- \[Tests\] Enable mongo unit tests on PHP7 using "mongo" => "mongodb" extension adapter [\#882](https://github.com/liip/LiipImagineBundle/pull/882) ([robfrawley](https://github.com/robfrawley))
+- \[Loader\] \[Locator\] FileSystemLocator service must not be shared [\#875](https://github.com/liip/LiipImagineBundle/pull/875) ([robfrawley](https://github.com/liip/LiipImagineBundle/pull/875))
+
+## [1.7.2](https://github.com/liip/LiipImagineBundle/tree/1.7.2) (2017-02-07)
+[Full Changelog](https://github.com/liip/LiipImagineBundle/compare/1.7.1...1.7.2)
 
 - \[Loader\] Abstract filesystem resource locator and legacy insecure locator implementation [\#866](https://github.com/liip/LiipImagineBundle/pull/866) ([robfrawley](https://github.com/robfrawley))
 - \[Minor\] \[Loader\] Fix for FileSystemLoader annotation [\#868](https://github.com/liip/LiipImagineBundle/pull/868) ([tgabi333](https://github.com/tgabi333))

UPGRADE.md

@@ -1,5 +1,75 @@
 # Upgrade
 
+## 1.7.3
+
+  - __[Data Loader]__ The `FileSystemLoader` now allows you to assign keys to data roots, and directly reference them when
+  requesting resources.
+
+    ```yml
+
+      # provide index for data roots
+      liip_imagine:
+        loaders:
+          default:
+            filesystem:
+              data_root:
+                foo: /path/to/foo
+                bar: /path/to/bar
+
+    ```
+
+    Assume you have a file name `file.ext` in both data root paths. Given the above configuration, you can specifically
+    request the file from the `/path/to/foo` root using the following file syntax: `@foo:file.ext`. Similarly, you can
+    request the same file from `/path/to/bar` using `@bar:file.ext`. Note, that the auto-registered bundles (detailed below)
+    are given indexes of their short bundle name (for example, given the bundle `FooBundle`, you can request a file from
+    its public resources path via `@FooBundle:path/to/file.ext`).
+
+  - __[Data Loader]__ The `FileSystemLoader` now supports automatically registering the `Resources/public` folders within
+  all loaded bundles. This can be enabled via the following configuration.
+
+    ```yml
+
+      # enable bundle auto-registration
+      liip_imagine:
+        loaders:
+          default:
+            filesystem:
+              bundle_resources:
+                enabled: true
+
+    ```
+
+    Additionally, you can whitelist or blacklist specific bundles from the auto-registration routine.
+
+    ```yml
+
+      # blacklist "FooBundle" from auto-registration
+      liip_imagine:
+        loaders:
+          default:
+            filesystem:
+              bundle_resources:
+                enabled: true
+                access_control_type: blacklist
+                access_control_list
+                  - FooBundle
+
+      # whitelist "BarBundle" from auto-registration
+      liip_imagine:
+        loaders:
+          default:
+            filesystem:
+              bundle_resources:
+                enabled: true
+                access_control_type: whitelist
+                access_control_list
+                  - BarBundle
+
+    ```
+
+  - __[Data Locator]__ The `*Locator` services passed to `FileSystemLoader` are now marked as "non-shared" or "prototype"
+  within the DI container, resulting in new instances being passed every time the services are requested.
+
 ## 1.7.2
 
   - __[Data Loader]__ The `FileSystemLoader`'s resource locator has been abstracted out into `FileSystemLocator`