localtools-sql-formatter 1.0.0__py3-none-any.whl

localtools_sql_formatter/ui/kit/localtools.css

@@ -0,0 +1,189 @@
+/* localtools UI kit. Swiss industrial: ruled grid, square corners, one red accent.
+   Light/dark follow the system. No network requests: fonts are vendored in ./fonts. */
+
+@font-face { font-family: "JetBrains Mono"; font-weight: 400; font-display: swap;
+  src: url("fonts/jetbrains-mono-latin-regular.woff2") format("woff2"); }
+@font-face { font-family: "JetBrains Mono"; font-weight: 700; font-display: swap;
+  src: url("fonts/jetbrains-mono-latin-bold.woff2") format("woff2"); }
+
+:root {
+  color-scheme: light dark;
+  --bg: #f1f1ec;
+  --panel: #fafaf7;
+  --ink: #121211;
+  --muted: #55554f;
+  --rule: #121211;
+  --hair: #c6c6bd;
+  --accent: #c8161b;
+  --on-ink: #f1f1ec;
+  --warn: #8a5300;
+  --ok: #1b6b2e;
+  --info: #1f4f9a;
+  --sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+  --mono: "JetBrains Mono", ui-monospace, "Cascadia Mono", Consolas, monospace;
+  --s1: 4px; --s2: 8px; --s3: 12px; --s4: 16px; --s5: 24px; --s6: 40px;
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #111110;
+    --panel: #191917;
+    --ink: #ebebe5;
+    --muted: #a5a59c;
+    --rule: #ebebe5;
+    --hair: #3a3a36;
+    --accent: #ff4d40;
+    --on-ink: #111110;
+    --warn: #e6a832;
+    --ok: #5cc46e;
+    --info: #7aa7ff;
+  }
+}
+
+*, *::before, *::after { box-sizing: border-box; }
+html { -webkit-text-size-adjust: 100%; }
+body { margin: 0; background: var(--bg); color: var(--ink); font: 15px/1.5 var(--sans); }
+:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+::selection { background: var(--accent); color: #fff; }
+[hidden] { display: none !important; }
+a { color: inherit; text-underline-offset: 3px; }
+a:hover { color: var(--accent); }
+code, kbd, samp, pre { font-family: var(--mono); font-size: 13px; }
+
+/* ---------- page + header ---------- */
+.lt-page { max-width: 1120px; margin: 0 auto; padding: var(--s5) var(--s4) var(--s6); }
+.lt-header { position: relative; border-bottom: 3px solid var(--rule); padding: var(--s5) 0 var(--s4); }
+.lt-title { margin: 0; font: 700 clamp(30px, 6vw, 56px)/0.95 var(--sans); letter-spacing: -0.035em; text-transform: uppercase; overflow-wrap: anywhere; }
+.lt-desc { margin: var(--s3) 0 0; max-width: 65ch; color: var(--muted); }
+.lt-issue { position: absolute; top: 0; right: 0; font: 11px/1 var(--mono); letter-spacing: .06em; text-transform: uppercase; color: var(--muted); padding: var(--s1) 0; }
+
+/* ---------- sections ---------- */
+.lt-section { border-bottom: 1px solid var(--rule); padding: var(--s4) 0 var(--s5); }
+.lt-section:last-child { border-bottom: 0; }
+.lt-label, .lt-field > label, .lt-field > legend { display: block; font: 700 11px/1.3 var(--mono); letter-spacing: .08em; text-transform: uppercase; color: var(--muted); margin-bottom: var(--s2); }
+h2.lt-label { color: var(--ink); font-size: 12px; margin: 0 0 var(--s3); }
+.lt-hint { font-size: 13px; color: var(--muted); margin: var(--s2) 0 0; }
+
+/* ---------- inputs ---------- */
+.lt-textarea, .lt-input, .lt-select {
+  width: 100%; background: var(--panel); color: var(--ink); border: 1px solid var(--rule);
+  border-radius: 0; font: 14px/1.5 var(--mono); padding: var(--s2) var(--s3);
+}
+.lt-textarea { min-height: 200px; resize: vertical; display: block; }
+.lt-input, .lt-select { min-height: 38px; }
+.lt-select { appearance: none; padding-right: 32px; cursor: pointer;
+  background-image: linear-gradient(45deg, transparent 50%, var(--ink) 50%), linear-gradient(-45deg, transparent 50%, var(--ink) 50%);
+  background-position: right 16px top 50%, right 11px top 50%; background-size: 5px 5px; background-repeat: no-repeat; }
+.lt-textarea::placeholder, .lt-input::placeholder { color: var(--muted); }
+
+.lt-drop {
+  display: grid; place-items: center; gap: var(--s1); min-height: 120px; padding: var(--s5) var(--s4);
+  border: 1px dashed var(--rule); background: var(--panel); text-align: center; cursor: pointer;
+  font: 13px/1.4 var(--mono); color: var(--muted);
+}
+.lt-drop strong { color: var(--ink); font-weight: 700; text-transform: uppercase; letter-spacing: .06em; }
+.lt-drop:hover, .lt-drop[data-over] { border-style: solid; border-color: var(--accent); color: var(--ink); }
+.lt-drop:focus-within { outline: 2px solid var(--accent); outline-offset: 2px; }
+.lt-drop input[type=file] { position: absolute; width: 1px; height: 1px; opacity: 0; }
+.lt-files { list-style: none; margin: var(--s2) 0 0; padding: 0; font: 13px/1.4 var(--mono); }
+.lt-files li { display: flex; justify-content: space-between; gap: var(--s3); padding: var(--s1) 0; border-bottom: 1px solid var(--hair); }
+.lt-files li span:first-child { overflow-wrap: anywhere; }
+.lt-files li span:last-child { color: var(--muted); white-space: nowrap; }
+.lt-or { display: flex; align-items: center; gap: var(--s3); margin: var(--s3) 0; font: 11px var(--mono); color: var(--muted); text-transform: uppercase; letter-spacing: .08em; }
+.lt-or::before, .lt-or::after { content: ""; flex: 1; border-top: 1px solid var(--hair); }
+
+/* ---------- options ---------- */
+.lt-options { display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: var(--s4); align-items: end; }
+.lt-field { margin: 0; min-width: 0; border: 0; padding: 0; }
+.lt-field > legend { padding: 0; }
+.lt-check { display: flex; align-items: center; gap: var(--s2); min-height: 38px; cursor: pointer; font-size: 14px; }
+.lt-check input { width: 18px; height: 18px; margin: 0; accent-color: var(--accent); }
+
+.lt-seg { display: inline-flex; flex-wrap: wrap; border: 1px solid var(--rule); background: var(--panel); }
+.lt-seg label { position: relative; cursor: pointer; }
+.lt-seg input { position: absolute; opacity: 0; inset: 0; margin: 0; cursor: pointer; }
+.lt-seg span { display: block; padding: 0 var(--s3); line-height: 36px; font: 700 12px/36px var(--mono); letter-spacing: .04em; text-transform: uppercase; }
+.lt-seg label + label { border-left: 1px solid var(--rule); }
+.lt-seg input:checked + span { background: var(--ink); color: var(--on-ink); }
+.lt-seg input:focus-visible + span { outline: 2px solid var(--accent); outline-offset: -4px; }
+
+/* ---------- buttons ---------- */
+.lt-actions { display: flex; flex-wrap: wrap; align-items: center; gap: var(--s3); }
+.lt-btn {
+  display: inline-flex; align-items: center; justify-content: center; gap: var(--s2);
+  min-height: 34px; padding: 0 var(--s3); border: 1px solid var(--rule); border-radius: 0;
+  background: transparent; color: var(--ink); font: 700 12px/1 var(--mono); letter-spacing: .06em;
+  text-transform: uppercase; white-space: nowrap; cursor: pointer;
+}
+.lt-btn:hover { background: var(--ink); color: var(--on-ink); }
+.lt-btn:active { transform: translateY(1px); }
+.lt-btn:disabled { opacity: .45; cursor: not-allowed; }
+.lt-btn-primary { min-height: 48px; padding: 0 var(--s5); font-size: 14px; background: var(--ink); color: var(--on-ink); border-width: 2px; }
+.lt-btn-primary:hover { background: var(--accent); border-color: var(--accent); color: #fff; }
+.lt-btn[aria-busy=true] { cursor: progress; opacity: 1; }
+.lt-btn[aria-busy=true]::after { content: ""; width: .6em; height: 1em; background: currentColor; animation: lt-blink 1s steps(1) infinite; }
+@keyframes lt-blink { 50% { opacity: 0; } }
+.lt-btn[data-done]::before { content: "\2713"; }
+
+/* ---------- feedback ---------- */
+.lt-error { margin: var(--s4) 0 0; padding: var(--s3) var(--s4); border: 2px solid var(--accent); border-left-width: 8px; background: var(--panel); font: 13px/1.5 var(--mono); overflow-wrap: anywhere; }
+.lt-error::before { content: "Error  "; font-weight: 700; color: var(--accent); text-transform: uppercase; letter-spacing: .06em; }
+.lt-status { font: 12px/1.4 var(--mono); color: var(--muted); }
+
+/* ---------- output ---------- */
+.lt-output { margin-top: var(--s4); border: 1px solid var(--rule); background: var(--panel); }
+.lt-bar { display: flex; flex-wrap: wrap; align-items: center; gap: var(--s2); padding: var(--s2); border-bottom: 1px solid var(--rule); }
+.lt-bar > :first-child { margin-right: auto; }
+.lt-bar .lt-status { padding: 0 var(--s1); }
+.lt-pre { margin: 0; padding: var(--s4); max-height: 60vh; overflow: auto; white-space: pre; line-height: 1.55; tab-size: 4; }
+.lt-pre.lt-wrap { white-space: pre-wrap; overflow-wrap: anywhere; }
+.lt-empty { padding: var(--s6) var(--s4); text-align: center; font: 13px var(--mono); color: var(--muted); }
+.lt-preview { padding: var(--s4); display: grid; place-items: center;
+  background: repeating-conic-gradient(var(--hair) 0 25%, transparent 0 50%) 0 0 / 16px 16px; }
+.lt-preview img, .lt-preview svg, .lt-preview video { max-width: 100%; max-height: 60vh; height: auto; display: block; }
+.lt-frame { display: block; width: 100%; height: 70vh; border: 0; background: #fff; }
+
+.lt-table-wrap { max-height: 60vh; overflow: auto; overscroll-behavior-x: contain; -webkit-overflow-scrolling: touch; }
+.lt-table { width: 100%; border-collapse: collapse; font: 13px/1.4 var(--mono); }
+.lt-table th { position: sticky; top: 0; background: var(--ink); color: var(--on-ink); text-align: left; font-weight: 700; font-size: 11px; letter-spacing: .06em; text-transform: uppercase; }
+.lt-table th, .lt-table td { padding: var(--s2) var(--s3); vertical-align: top; }
+.lt-table td { border-bottom: 1px solid var(--hair); overflow-wrap: break-word; }
+/* Narrow screens: keep columns readable and scroll the table sideways inside its panel instead of crushing it. */
+@media (max-width: 720px) {
+  .lt-table { min-width: 640px; }
+  .lt-table td { min-width: 10ch; }
+}
+.lt-table td.lt-num, .lt-table th.lt-num { text-align: right; font-variant-numeric: tabular-nums; }
+
+.lt-kv { display: grid; grid-template-columns: minmax(120px, max-content) 1fr; margin: 0; font: 13px/1.4 var(--mono); }
+.lt-kv dt, .lt-kv dd { margin: 0; padding: var(--s2) var(--s3); border-bottom: 1px solid var(--hair); }
+.lt-kv dt { color: var(--muted); text-transform: uppercase; font-size: 11px; letter-spacing: .06em; padding-top: 10px; }
+.lt-kv dd { overflow-wrap: anywhere; }
+
+/* ---------- severity ---------- */
+.lt-badge { display: inline-block; min-width: 5ch; padding: 2px 6px; border: 1px solid currentColor; font: 700 10px/1.3 var(--mono); letter-spacing: .08em; text-transform: uppercase; text-align: center; white-space: nowrap; }
+.lt-badge[data-sev=error] { color: var(--accent); }
+.lt-badge[data-sev=warn] { color: var(--warn); }
+.lt-badge[data-sev=info] { color: var(--info); }
+.lt-badge[data-sev=ok] { color: var(--ok); }
+.lt-findings { list-style: none; margin: 0; padding: 0; font: 13px/1.5 var(--mono); }
+.lt-findings li { display: grid; grid-template-columns: 64px 1fr; gap: var(--s1) var(--s3); padding: var(--s2) var(--s4); border-bottom: 1px solid var(--hair); align-items: baseline; }
+.lt-findings .lt-badge { justify-self: start; }
+.lt-findings small { grid-column: 2; color: var(--muted); font-size: 12px; }
+
+/* ---------- tabs ---------- */
+.lt-tabs { display: flex; overflow-x: auto; }
+.lt-tabs [role=tab] { border: 0; border-bottom: 3px solid transparent; background: none; color: var(--muted); padding: var(--s2) var(--s3); font: 700 12px/1.2 var(--mono); letter-spacing: .06em; text-transform: uppercase; cursor: pointer; white-space: nowrap; }
+.lt-tabs [role=tab]:hover { color: var(--ink); }
+.lt-tabs [role=tab][aria-selected=true] { color: var(--ink); border-bottom-color: var(--accent); }
+
+@media (max-width: 560px) {
+  .lt-page { padding-top: var(--s4); }
+  .lt-header { padding-top: var(--s5); }
+  .lt-options { grid-template-columns: 1fr; }
+  .lt-btn-primary { width: 100%; }
+  .lt-kv { grid-template-columns: 1fr; }
+  .lt-kv dt { border-bottom: 0; padding-bottom: 0; }
+}
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { animation: none !important; transition: none !important; }
+}

localtools_sql_formatter/ui/kit/localtools.js

@@ -0,0 +1,191 @@
+// localtools UI kit helpers. ES module, no dependencies.
+
+export function fmtBytes(n) {
+  const u = ["B", "KB", "MB", "GB", "TB"];
+  let i = 0;
+  while (n >= 1024 && i < u.length - 1) { n /= 1024; i++; }
+  return (i ? n.toFixed(n < 10 ? 1 : 0) : n) + " " + u[i];
+}
+
+export function fmtMs(ms) {
+  if (ms < 1000) return Math.round(ms) + " ms";
+  if (ms < 60000) return (ms / 1000).toFixed(ms < 10000 ? 2 : 1) + " s";
+  return Math.floor(ms / 60000) + " m " + Math.round((ms % 60000) / 1000) + " s";
+}
+
+// Wire a <label class="lt-drop"> containing <input type=file>. Lists chosen files in `list`
+// (a <ul class="lt-files">). Returns a function giving the current File[].
+export function dropZone(zone, list, onChange) {
+  const input = zone.querySelector("input[type=file]");
+  const render = () => {
+    const files = [...input.files];
+    if (list) list.replaceChildren(...files.map((f) => {
+      const li = document.createElement("li");
+      li.append(span(f.name), span(fmtBytes(f.size)));
+      return li;
+    }));
+    onChange?.(files);
+  };
+  const over = (on) => (e) => { e.preventDefault(); zone.toggleAttribute("data-over", on); };
+  zone.addEventListener("dragenter", over(true));
+  zone.addEventListener("dragover", over(true));
+  zone.addEventListener("dragleave", over(false));
+  zone.addEventListener("drop", (e) => {
+    over(false)(e);
+    const dt = new DataTransfer();
+    const dropped = [...e.dataTransfer.files];
+    for (const f of input.multiple ? dropped : dropped.slice(0, 1)) dt.items.add(f);
+    input.files = dt.files;
+    render();
+  });
+  input.addEventListener("change", render);
+  return () => [...input.files];
+}
+
+// POST to /api/<action>. `json` sends JSON; otherwise multipart from files + fields.
+// Resolves to the parsed JSON, or { blob, filename } for file responses. Throws Error(message).
+export async function api(action, { files = [], fields = {}, json } = {}) {
+  let body, headers = {};
+  if (json !== undefined) {
+    body = JSON.stringify(json);
+    headers["Content-Type"] = "application/json";
+  } else {
+    body = new FormData();
+    for (const f of files) body.append("file", f, f.name);
+    for (const [k, v] of Object.entries(fields)) body.append(k, String(v));
+  }
+  let res;
+  try {
+    res = await fetch("/api/" + action, { method: "POST", body, headers });
+  } catch {
+    throw new Error("Cannot reach the local server. Is the tool still running?");
+  }
+  const type = res.headers.get("Content-Type") || "";
+  if (!res.ok) {
+    let msg = res.status + " " + res.statusText;
+    try { msg = type.includes("json") ? (await res.json()).error || msg : (await res.text()) || msg; } catch {}
+    throw new Error(msg);
+  }
+  // Integers beyond 2^53 keep their exact digits (as strings) where the browser exposes the source text.
+  if (type.includes("application/json"))
+    return JSON.parse(await res.text(), (k, v, c) => (Number.isInteger(v) && !Number.isSafeInteger(v) && c?.source ? c.source : v));
+  const cd = res.headers.get("Content-Disposition") || "";
+  const m = /filename\*=UTF-8''([^;]+)/i.exec(cd) || /filename="?([^";]+)"?/i.exec(cd);
+  return { blob: await res.blob(), filename: m ? decodeURIComponent(m[1]) : "download" };
+}
+
+// Run `fn` with `button` in busy state. Shows thrown errors in `errorEl` (class lt-error).
+// Resolves to fn's result, or undefined on error.
+export async function run(button, errorEl, fn) {
+  if (errorEl) errorEl.hidden = true;
+  button.disabled = true;
+  button.setAttribute("aria-busy", "true");
+  try {
+    return await fn();
+  } catch (e) {
+    showError(errorEl, e.message || String(e));
+  } finally {
+    button.disabled = false;
+    button.removeAttribute("aria-busy");
+  }
+}
+
+export function showError(el, msg) {
+  if (!el) return alert(msg);
+  el.textContent = msg;
+  el.hidden = false;
+}
+
+function flash(button, text) {
+  const old = button.textContent;
+  button.textContent = text;
+  button.toggleAttribute("data-done", text === "Copied");
+  setTimeout(() => { button.textContent = old; button.removeAttribute("data-done"); }, 1400);
+}
+
+export async function copy(text, button) {
+  try {
+    await navigator.clipboard.writeText(text);
+    if (button) flash(button, "Copied");
+  } catch {
+    if (button) flash(button, "Copy failed");
+  }
+}
+
+export function download(blob, filename) {
+  const a = document.createElement("a");
+  a.href = URL.createObjectURL(blob);
+  a.download = filename;
+  a.click();
+  setTimeout(() => URL.revokeObjectURL(a.href), 1000);
+}
+
+// rows: array of objects (headers = keys of first row) or arrays (pass headers).
+// Columns whose first-row value is a number are right-aligned.
+export function renderTable(el, rows, headers) {
+  if (!headers) headers = rows.length ? Object.keys(rows[0]) : [];
+  const table = document.createElement("table");
+  table.className = "lt-table";
+  const cellsOf = (row) => (Array.isArray(row) ? row : headers.map((h) => row[h]));
+  const num = rows.length ? cellsOf(rows[0]).map((c) => typeof c === "number") : [];
+  const tr = (cells, tag) => {
+    const r = document.createElement("tr");
+    cells.forEach((c, i) => {
+      const cell = document.createElement(tag);
+      cell.textContent = c ?? "";
+      if (num[i]) cell.className = "lt-num";
+      r.append(cell);
+    });
+    return r;
+  };
+  table.createTHead().append(tr(headers, "th"));
+  const body = table.createTBody();
+  for (const row of rows) body.append(tr(cellsOf(row), "td"));
+  el.replaceChildren(table);
+}
+
+// findings: [{ severity: "error"|"warn"|"info"|"ok", message, where? }]
+export function renderFindings(el, findings) {
+  const ul = document.createElement("ul");
+  ul.className = "lt-findings";
+  for (const f of findings) {
+    const li = document.createElement("li");
+    const b = span(f.severity);
+    b.className = "lt-badge";
+    b.dataset.sev = f.severity;
+    li.append(b, span(f.message));
+    if (f.where) {
+      const s = document.createElement("small");
+      s.textContent = f.where;
+      li.append(s);
+    }
+    ul.append(li);
+  }
+  el.replaceChildren(ul);
+}
+
+// Wire a [role=tablist].lt-tabs: each [role=tab] has aria-controls pointing at its panel.
+export function tabs(list) {
+  const all = [...list.querySelectorAll("[role=tab]")];
+  const select = (t) => all.forEach((x) => {
+    const on = x === t;
+    x.setAttribute("aria-selected", on);
+    x.tabIndex = on ? 0 : -1;
+    document.getElementById(x.getAttribute("aria-controls")).hidden = !on;
+  });
+  list.addEventListener("click", (e) => { const t = e.target.closest("[role=tab]"); if (t) select(t); });
+  list.addEventListener("keydown", (e) => {
+    const d = { ArrowRight: 1, ArrowLeft: -1 }[e.key];
+    if (!d) return;
+    const t = all[(all.indexOf(document.activeElement) + d + all.length) % all.length];
+    select(t);
+    t.focus();
+  });
+  select(all.find((t) => t.getAttribute("aria-selected") === "true") || all[0]);
+}
+
+function span(text) {
+  const s = document.createElement("span");
+  s.textContent = text;
+  return s;
+}

localtools_sql_formatter-1.0.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.5
+Name: localtools-sql-formatter
+Version: 1.0.0
+Summary: Lint, fix and transpile SQL in any major dialect with sqlfluff and sqlglot (localtools, offline)
+Project-URL: Source, https://github.com/chayprabs/localtools
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: multipart>=1.2
+Requires-Dist: sqlfluff[rs]<5,>=4.4
+Requires-Dist: sqlglot>=30
+Description-Content-Type: text/markdown
+
+# SQL Formatter (localtools)
+
+Lint, auto-fix and format SQL in 28 dialects with **sqlfluff**, and transpile between dialects with **sqlglot**.
+Runs on your machine: a one-page web UI on `http://127.0.0.1:47117`, plus a CLI for scripts and CI.
+
+## Install
+
+| OS | command |
+|---|---|
+| Windows (PowerShell) | `irm https://raw.githubusercontent.com/chayprabs/localtools/main/sql-formatter/install.ps1 \| iex` |
+| macOS / Linux | `curl -fsSL https://raw.githubusercontent.com/chayprabs/localtools/main/sql-formatter/install.sh \| bash` |
+| PyPI | `pipx install localtools-sql-formatter` |
+
+The script installs a self-contained build (bundled Python) into `~/.localtools/sql-formatter` and adds a launcher.
+
+## Use
+
+`localtools-sql-formatter` opens the UI. Paste SQL or drop `.sql` files (several at once), pick the dialect, then:
+
+- **Lint**: every violation with line:column, rule code (linked to the sqlfluff docs) and whether it can be auto-fixed. Download the report as JSON.
+- **Fix**: the fixed SQL with a diff, Copy and Download, plus what still needs a human.
+- **Transpile**: rewrite between dialects (e.g. T-SQL `TOP`/`ISNULL` to Postgres `LIMIT`/`COALESCE`), with notes on unsupported constructs.
+
+Options: rule selection/exclusion (`LT01,CP01`, `core`, `layout`), templater (Jinja, or placeholders `:name`, `?`, `$1`, `%(name)s`, `@name`), and an uploaded `.sqlfluff` / `setup.cfg` / `tox.ini` / `pyproject.toml`.
+
+```sh
+localtools-sql-formatter lint models/*.sql --dialect postgres --format json   # or human | sarif; exit 1 on violations
+localtools-sql-formatter fix query.sql --dialect snowflake                     # fixed SQL to stdout
+localtools-sql-formatter fix *.sql --in-place --config .sqlfluff              # rewrite files; exit 1 if anything is left
+localtools-sql-formatter fix - --diff < query.sql                             # stdin, unified diff
+localtools-sql-formatter transpile q.sql --read tsql --write duckdb
+localtools-sql-formatter dialects | rules
+```
+
+API: `POST /api/lint`, `/api/fix`, `/api/transpile` (multipart: `sql` and/or `file`..., `dialect`, `rules`, `exclude_rules`,
+`templater`, `config` file; transpile: `read`, `write`), `GET /api/meta`. `/api/lint` with `format=sarif` returns SARIF 2.1.0.
+
+## Engine and why
+
+- **sqlfluff 4** (with its Rust parser, sqlfluffrs) is the most complete open-source SQL linter: dialect-aware parsing,
+  ~70 rules, real auto-fix, Jinja/placeholder templating. Results are identical to the `sqlfluff` CLI with the same config
+  (tested on TPC-H, sqlfluff's dialect fixtures, dbt's jaffle_shop and GitLab's schema).
+- `fix` repeats sqlfluff's fix pass until nothing changes, so running it twice gives the same SQL; when sqlfluff
+  oscillates between two layouts (it happens), the tool settles on one of them deterministically.
+- **sqlglot** transpiles (sqlfluff cannot): it parses into an AST and regenerates SQL for 31 dialects. Output equals the
+  `python -m sqlglot --identify false` CLI. It reformats in its own style, which is why lint/fix stay with sqlfluff.
+
+## Limits and safety
+
+- The web UI/API takes up to 512 KB of SQL and about 2,000 statements per run, and each run has a 120 s deadline
+  (sqlfluff is thorough but slow: a messy 20 KB file can take 10+ s). Every run is a separate worker process that is
+  killed at the deadline, when the browser disconnects, or when the server exits; at most 1–4 run at once (else HTTP 503).
+  On Linux each worker is capped at 2 GB of memory. The CLI has no size limit or deadline.
+- Config files are parsed, never executed: `library_path`, macro/loader paths (any `*_path` / `*_dir` key), the python and
+  dbt templaters and `processes` are ignored and listed in the result. sqlfluff's 20 KB "skip large file" default is off.
+- Files that do not parse are not fixed (like the sqlfluff CLI); the parse error shows line and column.
+
+## Cut
+
+- dbt templater (needs a dbt project, adapters and a database connection) and the python templater (runs code): use
+  `jinja`, which provides dbt's `ref`/`source`/`config` builtins.
+- Automatic discovery of `.sqlfluff` files next to the SQL: pass `--config` explicitly.
+- winget/Homebrew/Scoop packages: Python-runtime tools ship through the install scripts and PyPI.
+
+## Update / uninstall
+
+`localtools-sql-formatter update` · `localtools-sql-formatter uninstall` (pipx: `pipx upgrade|uninstall localtools-sql-formatter`).
+
+## License
+
+MIT. Bundled components: see THIRD_PARTY_NOTICES.md.

localtools_sql_formatter-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+localtools_sql_formatter/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+localtools_sql_formatter/__main__.py,sha256=IaEO7qivn2CPwS9wjnkLZsSLwkuI-cvIVul0dqSoNrU,12585
+localtools_sql_formatter/engine.py,sha256=2Qv4W2i7m4W4IsO5P1CBCu5OqJJvQv9hb1a4mY0fgFY,13349
+localtools_sql_formatter/localtools.py,sha256=MbEqWmk5jV_mgJ7qbkJhrEdqxSaFFAqVAB_CEvLJop8,9365
+localtools_sql_formatter/ui/index.html,sha256=RzL1-uBVeVEi_sxmSMSpcS0RQ7aeYRElXuoNyczg9O8,14778
+localtools_sql_formatter/ui/kit/localtools.css,sha256=NgBrTzgoYRmbCXdR_pw7zQUKhAU5L2oDBOhvahbUnQk,11745
+localtools_sql_formatter/ui/kit/localtools.js,sha256=imvk6LjKtqq7w3oSDaSmiC3RRilOWYHoE9WAOLjX-wU,6952
+localtools_sql_formatter/ui/kit/fonts/OFL.txt,sha256=MPDBNuPIjkItB5Gs2XI4hw-QVKlym8NM8v8NTtjKxK0,4399
+localtools_sql_formatter/ui/kit/fonts/jetbrains-mono-latin-bold.woff2,sha256=Mg99end-3OPuni9FiJPYQ3jc0UefDFMD8b5wjfFInRU,28312
+localtools_sql_formatter/ui/kit/fonts/jetbrains-mono-latin-regular.woff2,sha256=5mWll5qAq7tYNYt5PLlvl6J3eXwOrrJd7PMXoL57kF0,27264
+localtools_sql_formatter-1.0.0.dist-info/METADATA,sha256=UXytFrpEnxBNJbH_F709k-wYTUYlOAngDvwpcjpf7ZM,4897
+localtools_sql_formatter-1.0.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+localtools_sql_formatter-1.0.0.dist-info/entry_points.txt,sha256=M0KcUoUfj7LQpGX0sasZ7txMcUqKUlUf9_ai27JO5pQ,84
+localtools_sql_formatter-1.0.0.dist-info/licenses/LICENSE,sha256=gJAae3942rCeAsztX3njV-wLkC5woX6Bug8e1odqZHc,1076
+localtools_sql_formatter-1.0.0.dist-info/RECORD,,

localtools_sql_formatter-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

localtools_sql_formatter-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+localtools-sql-formatter = localtools_sql_formatter.__main__:main

localtools_sql_formatter-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chaitanya Prabuddha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.