Added a new attrs option to render_budnle tag and documented webpack_static tag

Author: owais

README.md

@@ -235,6 +235,9 @@ WEBPACK_LOADER = {
  {% render_bundle 'main' 'css' 'DASHBOARD' %}
  {% render_bundle 'main' extension='css' config='DASHBOARD' %}
  {% render_bundle 'main' config='DASHBOARD' extension='css' %}
+
+ <!-- add some extra attributes to the tag -->
+ {% render_bundle 'main' 'js' 'DEFAULT' attrs='async chatset="UTF-8"'%}
  </body>
 </head>
 ```
@@ -260,6 +263,18 @@ CKEDITOR.config.contentsCss = '{{ editor_css_files.0.publicPath }}';
 </ul>
 ```
 
+#### Refer other static assets
+
+`webpack_static` template tag provides facilities to load static assets managed by webpack
+in django templates. It is like django's built in `static` tag but for webpack assets instead.
+In the below example, `logo.png` can be any static asset shipped with any npm or bower package.
+
+```HTML+Django
+{% load webpack_static from webpack_loader %}
+
+<!-- render full public path of logo.png -->
+<img src="{% webpack_static 'logo.png' %}"/>
+```
 
 <br>
 

examples/simple/db.sqlite3

@@ -0,0 +1 @@
+{"status":"done","chunks":{"main":[{"name":"main-ffc7dc21b0f5761ce41a.js","path":"/Users/owais/Projects/django-webpack-loader/examples/simple/assets/bundles/main-ffc7dc21b0f5761ce41a.js"}]}}

examples/simple/webpack-stats.json

@@ -12,7 +12,7 @@
  <img src="{% webpack_static 'my-image.png' %}"/>
  <img src="{% webpack_static 'my-image.png' 'APP2'%}"/>
  <div id="react-app"></div>
- {% render_bundle 'main' 'js' %}
+ {% render_bundle 'main' 'js' attrs='async charset="UTF-8"'%}
  {% render_bundle 'app2' 'js' config='APP2' %}
  </body>
 </html>

tests/app/templates/home.html

@@ -93,11 +93,11 @@ def test_templatetags(self):
  view = TemplateView.as_view(template_name='home.html')
  request = self.factory.get('/')
  result = view(request)
- self.assertIn('<link type="text/css" href="/static/bundles/styles.css" rel="stylesheet"/>', result.rendered_content)
- self.assertIn('<script type="text/javascript" src="/static/bundles/main.js"></script>', result.rendered_content)
+ self.assertIn('<link type="text/css" href="/static/bundles/styles.css" rel="stylesheet" />', result.rendered_content)
+ self.assertIn('<script type="text/javascript" src="/static/bundles/main.js" async charset="UTF-8"></script>', result.rendered_content)
 
- self.assertIn('<link type="text/css" href="/static/bundles/styles-app2.css" rel="stylesheet"/>', result.rendered_content)
- self.assertIn('<script type="text/javascript" src="/static/bundles/app2.js"></script>', result.rendered_content)
+ self.assertIn('<link type="text/css" href="/static/bundles/styles-app2.css" rel="stylesheet" />', result.rendered_content)
+ 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='only_files.html')

tests/app/tests/test_webpack.py

@@ -14,17 +14,17 @@ def filter_by_extension(bundle, extension):
  yield chunk
 
 
-def render_as_tags(bundle):
+def render_as_tags(bundle, attrs):
  tags = []
  for chunk in bundle:
  if chunk['name'].endswith('.js'):
  tags.append((
- '<script type="text/javascript" src="{0}"></script>'
- ).format(chunk['url']))
+ '<script type="text/javascript" src="{0}" {1}></script>'
+ ).format(chunk['url'], attrs))
  elif chunk['name'].endswith('.css'):
  tags.append((
- '<link type="text/css" href="{0}" rel="stylesheet"/>'
- ).format(chunk['url']))
+ '<link type="text/css" href="{0}" rel="stylesheet" {1}/>'
+ ).format(chunk['url'], attrs))
  return mark_safe('\n'.join(tags))
 
 
@@ -36,8 +36,8 @@ def _get_bundle(bundle_name, extension, config):
 
 
 @register.simple_tag
-def render_bundle(bundle_name, extension=None, config='DEFAULT'):
- return render_as_tags(_get_bundle(bundle_name, extension, config))
+def render_bundle(bundle_name, extension=None, config='DEFAULT', attrs=''):
+ return render_as_tags(_get_bundle(bundle_name, extension, config), attrs)
 
 
 @register.simple_tag