From cf3373e7b7fb9342d705d7b5b8d52fe09ac46a34 Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Tue, 7 Jul 2026 17:59:58 -0700
Subject: [PATCH] Refactor --functions option, improve help

---
 docs/cli-reference.rst | 11 ++++++-----
 sqlite_utils/cli.py    | 29 ++++++++++++++---------------
 2 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/docs/cli-reference.rst b/docs/cli-reference.rst
index e57f4b3..c232881 100644
--- a/docs/cli-reference.rst
+++ b/docs/cli-reference.rst
@@ -138,8 +138,8 @@ See :ref:`cli_query`.
       -r, --raw                   Raw output, first column of first row
       --raw-lines                 Raw output, first column of each row
       -p, --param <TEXT TEXT>...  Named :parameters for SQL query
-      --functions TEXT            Python code or file path defining custom SQL
-                                  functions
+      --functions TEXT            Python code or a file path defining custom SQL
+                                  functions; can be used multiple times
       --load-extension TEXT       Path to SQLite extension, with optional
                                   :entrypoint
       -h, --help                  Show this message and exit.
@@ -181,8 +181,8 @@ See :ref:`cli_memory`.
           sqlite-utils memory animals.csv --schema
 
     Options:
-      --functions TEXT            Python code or file path defining custom SQL
-                                  functions
+      --functions TEXT            Python code or a file path defining custom SQL
+                                  functions; can be used multiple times
       --attach <TEXT FILE>...     Additional databases to attach - specify alias and
                                   filepath
       --flatten                   Flatten nested JSON objects, so {"foo": {"bar":
@@ -383,7 +383,8 @@ See :ref:`cli_bulk`.
 
     Options:
       --batch-size INTEGER   Commit every X records
-      --functions TEXT       Python code or file path defining custom SQL functions
+      --functions TEXT       Python code or a file path defining custom SQL
+                             functions; can be used multiple times
       --flatten              Flatten nested JSON objects, so {"a": {"b": 1}} becomes
                              {"a_b": 1}
       --nl                   Expect newline-delimited JSON
diff --git a/sqlite_utils/cli.py b/sqlite_utils/cli.py
index 99a8c64..edf1634 100644
--- a/sqlite_utils/cli.py
+++ b/sqlite_utils/cli.py
@@ -153,6 +153,17 @@ def load_extension_option(fn):
     )(fn)
 
 
+def functions_option(fn):
+    return click.option(
+        "--functions",
+        help=(
+            "Python code or a file path defining custom SQL functions; "
+            "can be used multiple times"
+        ),
+        multiple=True,
+    )(fn)
+
+
 @click.group(
     cls=DefaultGroup,
     default="query",
@@ -1450,11 +1461,7 @@ def upsert(
 @click.argument("sql")
 @click.argument("file", type=click.File("rb"), required=True)
 @click.option("--batch-size", type=int, default=100, help="Commit every X records")
-@click.option(
-    "--functions",
-    help="Python code or file path defining custom SQL functions",
-    multiple=True,
-)
+@functions_option
 @import_options
 @load_extension_option
 def bulk(
@@ -1860,11 +1867,7 @@ def drop_view(path, view, ignore, load_extension):
     type=(str, str),
     help="Named :parameters for SQL query",
 )
-@click.option(
-    "--functions",
-    help="Python code or file path defining custom SQL functions",
-    multiple=True,
-)
+@functions_option
 @load_extension_option
 def query(
     path,
@@ -1937,11 +1940,7 @@ def query(
     nargs=-1,
 )
 @click.argument("sql")
-@click.option(
-    "--functions",
-    help="Python code or file path defining custom SQL functions",
-    multiple=True,
-)
+@functions_option
 @click.option(
     "--attach",
     type=(str, click.Path(file_okay=True, dir_okay=False, allow_dash=False)),