Skip to content

Say the generator is staged, because it is - #51

Merged
estebanzimanyi merged 1 commit into
MobilityDB:mainfrom
estebanzimanyi:docs/state-what-the-binding-is
Aug 31, 2026
Merged

estebanzimanyi merged 1 commit into
MobilityDB:mainfrom
estebanzimanyi:docs/state-what-the-binding-is

Conversation

@estebanzimanyi

Copy link
Copy Markdown
Member

GENERATION.md calls codegen_jvm.py "the single generator vendored identically
by every JVM binding", and the pom.xml comment calls the catalog "vendored".
Neither is: .gitignore lists tools/meos-idl.json, tools/codegen_jvm.py and
tools/codegen_spark_udfs.py, and maven.yml copies all three in — the catalog
from the provision-meos action, the two generator files from a JMEOS checkout. The
workflow says as much in its own comment two files away.

The distinction is the point rather than a nicety. Every symbol the generator
emits is a call into the functions.GeneratedFunctions the jar carries, so the
generator and the surface it binds are one unit, and JMEOS owns it. A copy in this
tree goes stale the moment that surface folds an out-parameter or widens a return,
which is what three copies did before JMEOS took ownership: they drifted by 202
lines.

`GENERATION.md` calls `codegen_jvm.py` "the single generator vendored identically
by every JVM binding", and the `pom.xml` comment calls the catalog "vendored".
Neither is: `.gitignore` lists `tools/meos-idl.json`, `tools/codegen_jvm.py` and
`tools/codegen_spark_udfs.py`, and `maven.yml` copies all three in — the catalog
from the provision-meos action, the two generator files from a JMEOS checkout. The
workflow says as much in its own comment two files away.

The distinction is the point rather than a nicety. Every symbol the generator
emits is a call into the `functions.GeneratedFunctions` the jar carries, so the
generator and the surface it binds are one unit, and JMEOS owns it. A copy in this
tree goes stale the moment that surface folds an out-parameter or widens a return,
which is what three copies did before JMEOS took ownership: they drifted by 202
lines.
@estebanzimanyi
estebanzimanyi merged commit a82a331 into MobilityDB:main Aug 31, 2026
2 checks passed
@estebanzimanyi
estebanzimanyi deleted the docs/state-what-the-binding-is branch August 31, 2026 22:31
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.

1 participant