Skip to content

Docs: since 26.11.1 the engine refuses a mismatched count of positional values - #109

Merged
tae898 merged 1 commit into
mainfrom
docs/10721-engine-counts
Oct 27, 2026
Merged

tae898 merged 1 commit into
mainfrom
docs/10721-engine-counts

Conversation

@tae898

@tae898 tae898 commented Oct 27, 2026

Copy link
Copy Markdown
Collaborator

Closes #108

The parameters section of the queries guide, the _params.py module docstring and the test_positional_count.py header described the engine of 26.10.x: it bound the first of two values for one ?, dropped the second without a word, and bound null for a missing value. ArcadeData/arcadedb#10798, in 26.11.1, makes the engine refuse a mismatched count of positional values, too many or too few, with an error that names both counts. Verified on f8ae3a8e7f on JDK 21 and 25 (ArcadeData/arcadedb#10721).

What changes: text only.

  • Queries guide: the surplus case says the bindings raise TypeError before the call and the engine refuses it too since 26.11.1; older engines dropped the value. The missing-value case says 26.11.1 refuses it with an ArcadeDBError wrapping CommandSQLParsingException (older engines bound null), tells the reader to pass None for a placeholder meant as null, and says the async executor's error now reaches the error callback.
  • _params.py and test_positional_count.py: the same facts in their docstrings, and why the bindings' check stays.

What does not change: refuse_surplus_positionals and every call path. The check still fails earlier with a message that names the fix ([[a, b]] or a named parameter), and it covers a build linked to an older engine.

pre-commit run --files on the three files passes (black, isort, the old package name check).

🤖 Generated with Claude Code

…al values

The parameters section and two docstrings said the engine binds the first of two values for one ?, drops the second and binds null for a missing value. That held up to 26.10.x; ArcadeData/arcadedb#10798 (26.11.1) refuses both too many and too few values with an error naming both counts (verified on f8ae3a8e7f: ArcadeData/arcadedb#10721). The bindings' TypeError check stays: it fails earlier, names the fix and covers builds on an older engine.

Closes #108

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tae898
tae898 merged commit f3ab39c into main Oct 27, 2026
36 checks passed
@tae898
tae898 deleted the docs/10721-engine-counts branch October 27, 2026 20:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: the engine now refuses a mismatched count of positional values (26.11.1); the parameters text still says it drops or nulls them

1 participant