--functions can take filenames, can be used multiple times

[simonw]

Claude Code: https://gistpreview.github.io/?37fe8d2b19231e8ed5ef2967e1ba757b

Closes:

• --functions should take filenames, and be usable multiple times #659

The --functions option now supports:

1. File paths: Pass a .py file containing function definitions

   sqlite-utils query db.db "select domain(url) from urls" --functions funcs.py

2. Multiple invocations: Use --functions multiple times to load from different sources

   sqlite-utils query db.db "select f1(x), f2(x) from data" \
     --functions funcs.py \
     --functions 'def f2(x): return x * 2'

3. Inline code: Existing behavior still works

   sqlite-utils query db.db "select double(5)" --functions 'def double(x): return x * 2'

Implementation

Follows the same pattern as LLM's --functions flag (simonw/llm@a880c123):

• Detects file paths by checking for no newlines and .py extension
• Reads file contents using pathlib.Path().read_text()
• Iterates over multiple function sources when multiple=True

Changes

• Added multiple=True to --functions Click option in query, bulk, and memory commands
• Modified _register_functions() to detect and read .py files
• Updated _maybe_register_functions() to iterate over multiple function sources
• Removed unused bytes/bytearray handling
• Added comprehensive tests for file paths and multiple invocations
• Updated documentation with examples

All tests pass including new test coverage for:

• Loading functions from .py files
• Using --functions multiple times
• Combining file and inline code
• Error handling for missing files

---

📚 Documentation preview 📚: https://sqlite-utils--681.org.readthedocs.build/en/681/

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.32%. Comparing base (fb93452) to head (4147ed0).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #681      +/-   ##
==========================================
+ Coverage   95.27%   95.32%   +0.04%     
==========================================
  Files           8        8              
  Lines        3008     3014       +6     
==========================================
+ Hits         2866     2873       +7     
+ Misses        142      141       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.