Merge pull request #94 from jchristgit/add-include-js-flag

Allow omitting JS resources on templatetag call

Author: lemonsaurus

README.md

@@ -102,7 +102,9 @@ theme by providing a key that matches the regex `\w+_variables` (e.g. `alt_varia
 stylesheets will then be generated using the variables at that key.
 
 To use these stylesheets in a template, pass the theme name to the `{% bulma %}` tag either as a
-string `{% bulma 'alt' %}` or as a template variable `{% bulma theme %}`.
+string `{% bulma 'alt' %}` or as a template variable `{% bulma theme %}`. When calling the `bulma` template
+more than once in the same document (for example for implementing a dark theme switch), you will want to pass `include_js=False` to 
+at least one of these to prevent duplicate loading of JavaScript resources.
 
 #### Extensions
 

django_simple_bulma/templatetags/django_simple_bulma.py

@@ -12,8 +12,20 @@
 
 
 @register.simple_tag
-def bulma(theme: str = "") -> SafeString:
-    """Build static files required for Bulma."""
+def bulma(theme: str = "", *, include_js: bool = True) -> SafeString:
+    """Build static files required for Bulma.
+
+    Parameters:
+        theme:
+            CSS theme to load. If the given theme can not be found, a warning
+            will be logged and the library will fall back to the default theme.
+
+    Keyword arguments:
+        include_js:
+            Whether to include directives to load Bulma's JavaScript resources
+            in the result. Useful to prevent duplicate loading of JS when
+            calling this tag more than once on the same resource.
+    """
     from ..utils import (
         get_js_files,
         logger,
@@ -36,8 +48,9 @@ def bulma(theme: str = "") -> SafeString:
     ]
 
     # Build html to include all the js files required.
-    for js_file in map(static, get_js_files()):
-        html.append(f'<script defer type="text/javascript" src="{js_file}"></script>')
+    if include_js:
+        for js_file in map(static, get_js_files()):
+            html.append(f'<script defer type="text/javascript" src="{js_file}"></script>')
 
     return mark_safe("\n".join(html))