laketower 0.6.0__py3-none-any.whl → 0.6.2__py3-none-any.whl

laketower/static/vendor/halfmoon/halfmoon.modern.css

@@ -0,0 +1,282 @@
+
+/*!
+ * ----------------------------------------------------------------------------
+ * Halfmoon CSS - Modern theme
+ * Copyright (c) 2023, Tahmid Khan | MIT License | https://www.gethalfmoon.com
+ * ----------------------------------------------------------------------------
+ * The above notice must be included in its entirety when this file is used.
+ */
+
+/* Color palette */
+
+[data-bs-core=modern] {
+	/* Gray */
+
+	--bs-slate-hue: 216;
+	--bs-slate-saturation: 20%;
+
+	/* Light gray */
+
+	--bs-lightgray-hue: var(--bs-slate-hue);
+	--bs-lightgray-saturation: var(--bs-slate-saturation);
+
+	/* Sable (almost black) */
+
+	--bs-sable-hue: var(--bs-darkgray-hue);
+	--bs-sable-saturation: var(--bs-darkgray-saturation);
+	--bs-sable-100-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 31%;
+	--bs-sable-200-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 29%;
+	--bs-sable-300-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 27%;
+	--bs-sable-400-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 25%;
+	--bs-sable-500-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 23%;
+	--bs-sable-600-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 21%;
+	--bs-sable-700-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 19%;
+	--bs-sable-800-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 17%;
+	--bs-sable-900-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 15%;
+	--bs-sable-100: hsl(var(--bs-sable-100-hsl));
+	--bs-sable-200: hsl(var(--bs-sable-200-hsl));
+	--bs-sable-300: hsl(var(--bs-sable-300-hsl));
+	--bs-sable-400: hsl(var(--bs-sable-400-hsl));
+	--bs-sable-500: hsl(var(--bs-sable-500-hsl));
+	--bs-sable-600: hsl(var(--bs-sable-600-hsl));
+	--bs-sable-700: hsl(var(--bs-sable-700-hsl));
+	--bs-sable-800: hsl(var(--bs-sable-800-hsl));
+	--bs-sable-900: hsl(var(--bs-sable-900-hsl));
+	--bs-sable-hsl: var(--bs-sable-500-hsl);
+	--bs-sable: hsl(var(--bs-sable-hsl));
+	--bs-sable-foreground-hsl: var(--bs-white-hsl);
+	--bs-sable-foreground: hsl(var(--bs-sable-foreground-hsl));
+	--bs-sable-text-emphasis-hsl: var(--bs-sable-600-hsl);
+	--bs-sable-text-emphasis: hsl(var(--bs-sable-text-emphasis-hsl));
+	--bs-sable-hover-bg: var(--bs-sable-600);
+	--bs-sable-active-bg: var(--bs-sable-700);
+	--bs-sable-bg-subtle: hsl(var(--bs-sable-hue), var(--bs-sable-saturation), 70%);
+	--bs-sable-border-subtle: var(--bs-sable-400);
+	--bs-sable-checkbox-svg: var(--bs-checkbox-svg-light);
+	--bs-sable-dash-svg: var(--bs-dash-svg-light);
+	--bs-sable-radio-svg: var(--bs-radio-svg-light);
+	--bs-sable-switch-svg: var(--bs-switch-svg-light);
+
+	/* Primary */
+
+	--bs-primary-hue: var(--bs-navy-hue);
+	--bs-primary-saturation: var(--bs-navy-saturation);
+	--bs-primary-100-hsl: var(--bs-navy-100-hsl);
+	--bs-primary-200-hsl: var(--bs-navy-200-hsl);
+	--bs-primary-300-hsl: var(--bs-navy-300-hsl);
+	--bs-primary-400-hsl: var(--bs-navy-400-hsl);
+	--bs-primary-500-hsl: var(--bs-navy-500-hsl);
+	--bs-primary-600-hsl: var(--bs-navy-600-hsl);
+	--bs-primary-700-hsl: var(--bs-navy-700-hsl);
+	--bs-primary-800-hsl: var(--bs-navy-800-hsl);
+	--bs-primary-900-hsl: var(--bs-navy-900-hsl);
+	--bs-primary-100: var(--bs-navy-100);
+	--bs-primary-200: var(--bs-navy-200);
+	--bs-primary-300: var(--bs-navy-300);
+	--bs-primary-400: var(--bs-navy-400);
+	--bs-primary-500: var(--bs-navy-500);
+	--bs-primary-600: var(--bs-navy-600);
+	--bs-primary-700: var(--bs-navy-700);
+	--bs-primary-800: var(--bs-navy-800);
+	--bs-primary-900: var(--bs-navy-900);
+	--bs-primary-hsl: var(--bs-navy-hsl);
+	--bs-primary: var(--bs-navy);
+	--bs-primary-foreground-hsl: var(--bs-navy-foreground-hsl);
+	--bs-primary-foreground: var(--bs-navy-foreground);
+	--bs-primary-text-emphasis-hsl: var(--bs-navy-text-emphasis-hsl);
+	--bs-primary-text-emphasis: var(--bs-navy-text-emphasis);
+	--bs-primary-hover-bg: var(--bs-navy-hover-bg);
+	--bs-primary-active-bg: var(--bs-navy-active-bg);
+	--bs-primary-bg-subtle: var(--bs-navy-bg-subtle);
+	--bs-primary-border-subtle: var(--bs-navy-border-subtle);
+	--bs-primary-checkbox-svg: var(--bs-navy-checkbox-svg);
+	--bs-primary-dash-svg: var(--bs-navy-dash-svg);
+	--bs-primary-radio-svg: var(--bs-navy-radio-svg);
+	--bs-primary-switch-svg: var(--bs-navy-switch-svg);
+
+	/* Info */
+
+	--bs-info-hue: var(--bs-blue-hue);
+	--bs-info-saturation: var(--bs-blue-saturation);
+	--bs-info-100-hsl: var(--bs-blue-100-hsl);
+	--bs-info-200-hsl: var(--bs-blue-200-hsl);
+	--bs-info-300-hsl: var(--bs-blue-300-hsl);
+	--bs-info-400-hsl: var(--bs-blue-400-hsl);
+	--bs-info-500-hsl: var(--bs-blue-500-hsl);
+	--bs-info-600-hsl: var(--bs-blue-600-hsl);
+	--bs-info-700-hsl: var(--bs-blue-700-hsl);
+	--bs-info-800-hsl: var(--bs-blue-800-hsl);
+	--bs-info-900-hsl: var(--bs-blue-900-hsl);
+	--bs-info-100: var(--bs-blue-100);
+	--bs-info-200: var(--bs-blue-200);
+	--bs-info-300: var(--bs-blue-300);
+	--bs-info-400: var(--bs-blue-400);
+	--bs-info-500: var(--bs-blue-500);
+	--bs-info-600: var(--bs-blue-600);
+	--bs-info-700: var(--bs-blue-700);
+	--bs-info-800: var(--bs-blue-800);
+	--bs-info-900: var(--bs-blue-900);
+	--bs-info-hsl: var(--bs-blue-hsl);
+	--bs-info: var(--bs-blue);
+	--bs-info-foreground-hsl: var(--bs-blue-foreground-hsl);
+	--bs-info-foreground: var(--bs-blue-foreground);
+	--bs-info-text-emphasis-hsl: var(--bs-blue-text-emphasis-hsl);
+	--bs-info-text-emphasis: var(--bs-blue-text-emphasis);
+	--bs-info-hover-bg: var(--bs-blue-hover-bg);
+	--bs-info-active-bg: var(--bs-blue-active-bg);
+	--bs-info-bg-subtle: var(--bs-blue-bg-subtle);
+	--bs-info-border-subtle: var(--bs-blue-border-subtle);
+	--bs-info-checkbox-svg: var(--bs-blue-checkbox-svg);
+	--bs-info-dash-svg: var(--bs-blue-dash-svg);
+	--bs-info-radio-svg: var(--bs-blue-radio-svg);
+	--bs-info-switch-svg: var(--bs-blue-switch-svg);
+}
+
+[data-bs-core=modern][data-bs-theme=dark] {
+	/* Dark gray */
+
+	--bs-darkgray-text-emphasis-hsl: var(--bs-darkgray-200-hsl);
+	--bs-darkgray-text-emphasis: hsl(var(--bs-darkgray-text-emphasis-hsl));
+
+	/* Sable (black) */
+
+	--bs-sable-text-emphasis-hsl: var(--bs-sable-400-hsl);
+	--bs-sable-text-emphasis: hsl(var(--bs-sable-text-emphasis-hsl));
+	--bs-sable-bg-subtle: hsl(var(--bs-sable-hue), var(--bs-sable-saturation), 14%);
+	--bs-sable-border-subtle: var(--bs-sable-600);
+
+	/* Blue */
+
+	--bs-blue-text-emphasis-hsl: var(--bs-blue-300-hsl);
+	--bs-blue-text-emphasis: hsl(var(--bs-blue-text-emphasis-hsl));
+
+	/* Primary */
+
+	--bs-primary-hue: var(--bs-sky-hue);
+	--bs-primary-saturation: var(--bs-sky-saturation);
+	--bs-primary-100-hsl: var(--bs-sky-100-hsl);
+	--bs-primary-200-hsl: var(--bs-sky-200-hsl);
+	--bs-primary-300-hsl: var(--bs-sky-300-hsl);
+	--bs-primary-400-hsl: var(--bs-sky-400-hsl);
+	--bs-primary-500-hsl: var(--bs-sky-500-hsl);
+	--bs-primary-600-hsl: var(--bs-sky-600-hsl);
+	--bs-primary-700-hsl: var(--bs-sky-700-hsl);
+	--bs-primary-800-hsl: var(--bs-sky-800-hsl);
+	--bs-primary-900-hsl: var(--bs-sky-900-hsl);
+	--bs-primary-100: var(--bs-sky-100);
+	--bs-primary-200: var(--bs-sky-200);
+	--bs-primary-300: var(--bs-sky-300);
+	--bs-primary-400: var(--bs-sky-400);
+	--bs-primary-500: var(--bs-sky-500);
+	--bs-primary-600: var(--bs-sky-600);
+	--bs-primary-700: var(--bs-sky-700);
+	--bs-primary-800: var(--bs-sky-800);
+	--bs-primary-900: var(--bs-sky-900);
+	--bs-primary-hsl: var(--bs-sky-hsl);
+	--bs-primary: var(--bs-sky);
+	--bs-primary-foreground-hsl: var(--bs-sky-foreground-hsl);
+	--bs-primary-foreground: var(--bs-sky-foreground);
+	--bs-primary-text-emphasis-hsl: var(--bs-sky-text-emphasis-hsl);
+	--bs-primary-text-emphasis: var(--bs-sky-text-emphasis);
+	--bs-primary-hover-bg: var(--bs-sky-hover-bg);
+	--bs-primary-active-bg: var(--bs-sky-active-bg);
+	--bs-primary-bg-subtle: var(--bs-sky-bg-subtle);
+	--bs-primary-border-subtle: var(--bs-sky-border-subtle);
+	--bs-primary-checkbox-svg: var(--bs-sky-checkbox-svg);
+	--bs-primary-dash-svg: var(--bs-sky-dash-svg);
+	--bs-primary-radio-svg: var(--bs-sky-radio-svg);
+	--bs-primary-switch-svg: var(--bs-sky-switch-svg);
+
+	/* Info */
+
+	--bs-info-text-emphasis-hsl: var(--bs-blue-text-emphasis-hsl);
+	--bs-info-text-emphasis: var(--bs-blue-text-emphasis);
+	--bs-info-bg-subtle: var(--bs-blue-bg-subtle);
+	--bs-info-border-subtle: var(--bs-blue-border-subtle);
+}
+
+/* Variables */
+
+[data-bs-core=modern] {
+	/* Link */
+
+	--bs-link-color-hsl: var(--bs-info-text-emphasis-hsl);
+	--bs-link-hover-color-hsl: var(--bs-info-hsl);
+
+	/* Content (used as needed in cards, panels, menus, etc.) */
+
+	--bs-content-bg-hsl: var(--bs-body-bg-hsl);
+	--bs-content-border-color: var(--bs-border-color);
+
+	/* Form */
+
+	--bs-form-focus-border-color: var(--bs-info-border-subtle);
+	--bs-form-focus-shadow-hsl: var(--bs-info-hsl);
+	--bs-form-check-focus-border-color: var(--bs-info-border-subtle);
+}
+
+[data-bs-core=modern]:not([data-bs-theme=dark]) {
+	/* Background */
+
+	--bs-body-bg-hsl: var(--bs-white-hsl);
+	--bs-secondary-bg-hsl: var(--bs-lightgray-hue), var(--bs-lightgray-saturation), 98.75%;
+	--bs-tertiary-bg-hsl: var(--bs-lightgray-hue), var(--bs-lightgray-saturation), 97.5%;
+
+	/* Border */
+
+	--bs-border-color: var(--bs-lightgray-700);
+	--bs-border-color-light: var(--bs-lightgray-500);
+}
+
+[data-bs-core=modern][data-bs-theme=dark] {
+	/* Background */
+
+	--bs-body-bg-hsl: var(--bs-sable-900-hsl);
+	--bs-secondary-bg-hsl: var(--bs-sable-800-hsl);
+	--bs-tertiary-bg-hsl: var(--bs-sable-700-hsl);
+
+	/* Border */
+
+	--bs-border-color: var(--bs-gray-900);
+
+	/* Content (used as needed in cards, panels, menus, etc.) */
+
+	--bs-content-floating-bg-hsl: var(--bs-sable-hue), var(--bs-sable-saturation), 16.5%;
+
+	/* Action (used as needed in buttons, inputs, menu items, page links, etc.) */
+
+	--bs-action-border-color: var(--bs-border-color);
+
+	/* Contextual buttons */
+
+	--bs-ctx-btn-border-color: transparent;
+	--bs-ctx-btn-bg-clip: border-box;
+
+	/* Action bar (used as needed in range, progress, etc.) */
+
+	--bs-actionbar-border-color: hsla(var(--bs-white-hsl), 0.075);
+	--bs-progresstrack-border-width: 0;
+	--bs-progresstrack-box-shadow: inset 0 0 0 var(--bs-border-width) var(--bs-actionbar-border-color);
+	--bs-progresstrack-bg-clip: border-box;
+}
+
+/* Sidebar */
+
+[data-bs-core=modern] .sidebar {
+	--bs-sidebar-item-padding-x: 1rem;
+	--bs-sidebar-item-padding-y: 0.25rem;
+	--bs-sidebar-header-font-weight: var(--bs-font-weight-bold);
+	--bs-sidebar-divider-bg: var(--bs-sidebar-bg);
+}
+
+[data-bs-core=modern] .sidebar-nav .nav-link {
+	border-left: var(--bs-border-width) solid var(--bs-border-color-light);
+}
+
+[data-bs-core=modern] .sidebar-nav .nav-link.active,
+[data-bs-core=modern] .sidebar-nav .nav-link.show {
+	font-weight: var(--bs-font-weight-bold);
+	border-color: currentColor;
+	-webkit-font-smoothing: antialiased;
+	-moz-osx-font-smoothing: grayscale;
+}

laketower/tables.py

@@ -229,6 +229,17 @@ def load_datasets(table_configs: list[ConfigTable]) -> dict[str, padataset.Datas
     return tables_dataset
 
 
+def extract_query_parameter_names(sql: str) -> set[str]:
+    parsed_sql = sqlglot.parse(sql, dialect=sqlglot.dialects.duckdb.DuckDB)
+    return {
+        str(node.this)
+        for statement in parsed_sql
+        if statement is not None
+        for node in statement.walk()
+        if isinstance(node, sqlglot.expressions.Placeholder)
+    }
+
+
 def generate_table_query(
     table_name: str,
     limit: int | None = None,
@@ -260,8 +271,13 @@ def generate_table_statistics_query(table_name: str) -> str:
 
 
 def execute_query(
-    tables_datasets: dict[str, padataset.Dataset], sql_query: str
+    tables_datasets: dict[str, padataset.Dataset],
+    sql_query: str,
+    sql_params: dict[str, str] = {},
 ) -> pd.DataFrame:
+    if not sql_query:
+        raise ValueError("Error: Cannot execute empty SQL query")
+
     try:
         conn = duckdb.connect()
         for table_name, table_dataset in tables_datasets.items():
@@ -272,8 +288,8 @@ def execute_query(
 
             view_name = f"{table_name}_view"
             conn.register(view_name, table_dataset)
-            conn.execute(f'create table "{table_name}" as select * from "{view_name}"')  # nosec B608
-        return conn.execute(sql_query).df()
+            conn.execute(f'create view "{table_name}" as select * from "{view_name}"')  # nosec B608
+        return conn.execute(sql_query, parameters=sql_params).df()
     except duckdb.Error as e:
         raise ValueError(str(e)) from e
 

laketower/templates/_base.html

@@ -4,12 +4,10 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Laketower</title>
-  <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css" rel="stylesheet">
-  <link href="https://cdn.jsdelivr.net/npm/halfmoon@2.0.2/css/halfmoon.min.css" rel="stylesheet"
-    integrity="sha256-RjeFzczeuZHCyS+Gvz+kleETzBF/o84ZRHukze/yv6o=" crossorigin="anonymous">
-  <link href="https://cdn.jsdelivr.net/npm/halfmoon@2.0.2/css/cores/halfmoon.modern.css" rel="stylesheet"
-    integrity="sha256-DD6elX+jPmbFYPsGvzodUv2+9FHkxHlVtQi0/RJVULs=" crossorigin="anonymous">
+  <title>{{ app_metadata.app_name }}</title>
+  <link href="{{ url_for('static', path='/vendor/bootstrap-icons/bootstrap-icons.min.css') }}" rel="stylesheet">
+  <link href="{{ url_for('static', path='/vendor/halfmoon/halfmoon.min.css') }}" rel="stylesheet">
+  <link href="{{ url_for('static', path='/vendor/halfmoon/halfmoon.modern.css') }}" rel="stylesheet">
 </head>
 
 <body class="ps-md-sbwidth">
@@ -17,7 +15,7 @@
     <nav class="sidebar offcanvas-start offcanvas-md" tabindex="-1" id="sidebar">
       <div class="offcanvas-header border-bottom">
         <a class="sidebar-brand" href="/">
-          Laketower
+          {{ app_metadata.app_name }}
         </a>
         <button
           type="button"
@@ -28,8 +26,8 @@
         >
         </button>
       </div>
-      <div class="offcanvas-body">
-        <ul class="sidebar-nav">
+      <div class="offcanvas-body d-flex flex-column">
+        <ul class="sidebar-nav flex-grow-1 overflow-auto">
           <li>
             <h6 class="sidebar-header">Tables</h6>
           </li>
@@ -68,6 +66,17 @@
           </li>
           {% endfor %}
         </ul>
+
+        <div class="mt-auto pt-3 border-top flex-shrink-0">
+          <small class="text-muted px-3 d-block">
+            <a href="https://github.com/datalpia/laketower/releases/tag/{{ app_metadata.app_version }}"
+               target="_blank"
+               class="text-muted text-decoration-none">
+              v{{ app_metadata.app_version }}
+              <i class="bi-box-arrow-up-right ms-1" style="font-size: 0.7em;"></i>
+            </a>
+          </small>
+        </div>
       </div>
     </nav>
 
@@ -78,8 +87,8 @@
         </button>
 
         <a href="/" class="navbar-brand d-flex align-items-center d-md-none ms-auto ms-md-0">
-					Laketower
-				</a>
+          {{ app_metadata.app_name }}
+        </a>
       </div>
     </nav>
   </header>
@@ -90,14 +99,8 @@
     </div>
   </main>
 
-  <footer></footer>
-
-  <script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
-    integrity="sha384-I7E8VVD/ismYTF4hNIPjVp/Zjvgyol6VFvRkX/vR+Vc4jQkC+hVqc2pM8ODewa9r"
-    crossorigin="anonymous"></script>
-  <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.min.js"
-    integrity="sha384-0pUGZvbkm6XF6gxjEnlmuGrJXVbNuzT9qBBavbLwCsOGabYfZo0T0to5eqruptLy"
-    crossorigin="anonymous"></script>
+  <script src="{{ url_for('static', path='/vendor/bootstrap/bootstrap.bundle.min.js') }}"></script>
+  {% block extra_scripts %}{% endblock %}
 </body>
 
 </html>

laketower/templates/queries/view.html

@@ -5,16 +5,30 @@
   <div class="col">
     <h2 class="mb-3">{{ query.title }}</h2>
 
+    {% if query.description %}
+    <div>
+      {{ query.description | render_markdown | safe }}
+    </div>
+    {% endif %}
+
     <form action="{{ request.url.path }}" method="get">
-      <div class="mb-3">
-        <textarea disabled name="sql" rows="5" class="form-control">{{ query.sql }}</textarea>
+      {% if sql_params|length %}
+      <h3 class="mb-3">Parameters</h3>
+      {% for param_name, param_value in sql_params.items() %}
+      <div class="row mb-3">
+        <label for="param-{{ param_name }}" class="col-form-label col-sm-2">{{ param_name }}</label>
+        <div class="col-sm-4">
+          <input id="param-{{ param_name }}" class="form-control" name="{{ param_name }}" value="{{ param_value }}">
+        </div>
       </div>
+      {% endfor %}
+      {% endif %}
 
       <div class="mb-3">
         <div class="d-flex justify-content-end">
           <div class="row">
             <div class="col">
-              <a href="/tables/query?sql={{ query.sql | urlencode }}" class="btn btn-secondary" type="button" >
+              <a href="/tables/query?sql={{ query.sql | urlencode }}{% if request.query_params | length > 0 %}&{{ request.query_params.multi_items() | urlencode}}{% endif %}" class="btn btn-secondary" type="button">
                 <i class="bi-code" aria-hidden="true"></i> Edit SQL
               </a>
             </div>
@@ -63,4 +77,4 @@
     {% endif %}
   </div>
 </div>
-{% endblock %}
+{% endblock %}

laketower/templates/tables/query.html

@@ -8,9 +8,21 @@
 
     <form action="{{ request.url.path }}" method="get">
       <div class="mb-3">
-        <textarea name="sql" rows="5" class="form-control">{{ sql_query }}</textarea>
+        <textarea id="sql-editor" name="sql" rows="5" class="form-control">{{ sql_query }}</textarea>
       </div>
 
+      {% if sql_params|length %}
+      <h3 class="mb-3">Parameters</h3>
+      {% for param_name, param_value in sql_params.items() %}
+      <div class="row mb-3">
+        <label for="param-{{ param_name }}" class="col-form-label col-sm-2">{{ param_name }}</label>
+        <div class="col-sm-4">
+          <input id="param-{{ param_name }}" class="form-control" name="{{ param_name }}" value="{{ param_value }}">
+        </div>
+      </div>
+      {% endfor %}
+      {% endif %}
+
       <div class="mb-3">
         <div class="d-flex justify-content-end">
           <button type="submit" class="btn btn-primary">
@@ -54,4 +66,16 @@
     {% endif %}
   </div>
 </div>
+{% endblock %}
+
+{% block extra_scripts %}
+<script src="{{ url_for('static', path='/editor.bundle.js') }}"></script>
+<script>
+  window.addEventListener("DOMContentLoaded", () => {
+    const textArea = document.querySelector("textarea#sql-editor")
+    textArea.style.display = "none";
+    const sqlSchema = {{ sql_schema | tojson }}
+    const sqlEditor = editor.createEditor(textArea, { readOnly: false, dialect: 'duckdb', schema: sqlSchema})
+  })
+</script>
 {% endblock %}