enable ES6 syntax by default

Signed-off-by: Richard Barella <ribab127@gmail.com>

Author: richard-barella

README.md

@@ -1,4 +1,3 @@
-
 # better-dash-callback
 
 A library that enables running clientside callback functions in Dash applications using Python syntax, eliminating the need for inline JavaScript.
@@ -60,7 +59,10 @@ app.layout = html.Div([
 @callback(
     Output("output", "children"),
     Input("input", "value"),
-    clientside=True
+    clientside=True,
+    enable_es6=True,
+    enable_stage3=True,
+    prevent_initial_call=True
 )
 def update_output(value):
     return f"You entered: {value}"
@@ -71,6 +73,13 @@ if __name__ == "__main__":
 
 As you can see, the `better-dash-callback` example is more elegant and easier to read. You can write your callback function using Python syntax, without having to worry about inline JavaScript code.
 
+The `callback` function takes the following additional arguments:
+
+* `clientside`: A boolean indicating whether the callback should be executed on the client-side (default is `False`).
+* `enable_es6`: A boolean indicating whether to enable ES6 syntax in the generated JavaScript code (default is `True`).
+* `enable_stage3`: A boolean indicating whether to enable Stage 3 syntax in the generated JavaScript code (default is `True`).
+* `prevent_initial_call`: A boolean indicating whether to prevent the callback from being called on the initial render (default is `False`).
+
 ## Installation
 
 To install `better-dash-callback`, you can use `pip`:

better_dash_callback/src.py

@@ -3,25 +3,30 @@
 import dash
 import inspect
 
-def callback(*args, clientside=False, **kwargs):
+def callback(*args, clientside=False, enable_es6=True, enable_stage3=True, **kwargs):
     """
     A decorator to register a Dash callback. If `clientside` is True, the python callback
-    will be executed clientside using jsbuilder, which will convert it to javascript.
+    will be executed clientside using https://github.com/metapensiero/metapensiero.pj
+    which will convert it to javascript.
     
     If `clientside` is False or not set, the callback will be executed serverside
     using Dash's standard callback system.
 
     Other than clientside argument, all other arguments are the same as Dash's @callback function.
 
     :param clientside: Whether to execute the callback clientside. Defaults to False.
+    :param enable_es6: Whether to enable ES6 syntax. Defaults to True.
+    :param enable_stage3: Whether to enable Stage3 syntax. Defaults to True.
+    :param args: Arguments to pass to the Dash callback. Include dash.Output, dash.Input, and dash.State.
+    :param kwargs: Keyword arguments to pass to the Dash callback. Includes `prevent_initial_call=True`.
     """
 
     def decorator(func):
 
         if clientside:
             python_code = inspect.getsource(func)
             python_code = python_code[python_code.find("def "):]
-            js_code = metapensiero.pj.__main__.transform_string(python_code)
+            js_code = metapensiero.pj.__main__.transform_string(python_code, enable_es6=enable_es6, enable_stage3=enable_stage3)
             dash.clientside_callback(js_code, *args, **kwargs)
         else:
             @dash.callback(*args, **kwargs)

examples/example.py

@@ -0,0 +1,26 @@
+import dash
+from dash import html, dcc, Output, Input
+from better_dash_callback import callback
+
+app = dash.Dash(__name__)
+
+app.layout = html.Div([
+    dcc.Input(id="input", type="text"),
+    html.Div(id="output")
+])
+
+@callback(
+    Output("output", "children"),
+    Input("input", "value"),
+    prevent_initial_call=True,
+    clientside=True
+)
+def update_output(value):
+    """
+    this code will be executed clientside as javascript.
+    This page shows what syntax is supported: https://github.com/metapensiero/metapensiero.pj
+    """
+    return f"You entered: {value}"
+
+if __name__ == "__main__":
+    app.run_server(debug=True)