Renamed get_chunks to get_files.

Author: owais

README.md

@@ -226,19 +226,25 @@ WEBPACK_LOADER = {
 </head>
 ```
 
-#### Exposing an asset URL
+#### File URLs instead of html tags
 
-If you need the URL to an asset without the HTML tags the `get_chunks`
+If you need the URL to an asset without the HTML tags, the `get_files`
 template tag can be used. A common use case is specifying the URL to a
 custom css file for a Javascript plugin.
 
-The first parameter is the name of the bundle and is required.
-Optional second and third parameters are the extension (css/js)
-and the configuration.
+`get_files` works exactly like `render_bundle` except it returns a list of
+matching files and lets you assign the list to a custom template variable. For example,
 
 ```HTML+Django
-{% get_chunks 'editor' 'css' as editor_css_chunks %}
-CKEDITOR.config.contentsCss = '{{ editor_css_chunks.0.publicPath }}';
+{% get_files 'editor' 'css' as editor_css_files %}
+CKEDITOR.config.contentsCss = '{{ editor_css_files.0.publicPath }}';
+
+<!-- or list down name, path and download url for every file -->
+<ul>
+{% for css_file in editor_css_files %}
+    <li>{{ css_file.name }} : {{ css_file.path }} : {{ css_file.publicPath }}</li>
+{% endfor %}
+</ul>
 ```
 
 

tests/app/templates/custom_config.html

@@ -0,0 +1,11 @@
+{% load get_files from webpack_loader %}
+<script>
+
+  {% get_files 'main' 'css' as main_css_files %}
+  {% get_files 'main' 'js' as main_js_files %}
+
+  var contentCss = '{{ main_css_files.0.url }}';
+
+  var contentJS = '{{ main_js_files.0.url }}';
+
+</script>

tests/app/templates/only_files.html

@@ -102,7 +102,7 @@ def test_templatetags(self):
         self.assertIn('<script type="text/javascript" src="/static/bundles/app2.js"></script>', result.rendered_content)
         self.assertIn('<img src="/static/my-image.png"/>', result.rendered_content)
 
-        view = TemplateView.as_view(template_name='custom_config.html')
+        view = TemplateView.as_view(template_name='only_files.html')
         result = view(request)
         self.assertIn("var contentCss = '/static/bundles/styles.css'", result.rendered_content)
         self.assertIn("var contentJS = '/static/bundles/main.js'", result.rendered_content)

tests/app/tests/test_webpack.py

@@ -39,23 +39,25 @@ def render_bundle(bundle_name, extension=None, config='DEFAULT'):
 @register.simple_tag
 def webpack_static(asset_name, config='DEFAULT'):
     return "{}{}".format(
-        get_assets(get_config(config)).get('publicPath', getattr(settings, 'STATIC_URL')),
+        get_assets(get_config(config)).get(
+            'publicPath', getattr(settings, 'STATIC_URL')
+        ),
         asset_name
     )
 
 
 @register.assignment_tag
-def get_chunks(bundle_name, extension=None, config='DEFAULT'):
+def get_files(bundle_name, extension=None, config='DEFAULT'):
     """
     Returns all chunks in the given bundle.
     Example usage::
 
-        {% get_chunks 'editor' 'css' as editor_css_chunks %}
+        {% get_files 'editor' 'css' as editor_css_chunks %}
         CKEDITOR.config.contentsCss = '{{ editor_css_chunks.0.publicPath }}';
 
     :param bundle_name: The name of the bundle
     :param extension: (optional) filter by extension
     :param config: (optional) the name of the configuration
-    :return: the whole bundle
+    :return: a list of matching chunks
     """
     return list(_get_bundle(bundle_name, extension, config))