Ephemeral relations, Refactor & Cleanup#34
Merged
Conversation
Remove dead code and obsolete docstrings Simplify iterator loops by removing unused parameters Extract ephemeral name generation helper to eliminate duplication Inline single use rename_iterator function
df411c9 to
e52d6ac
Compare
schonfinkel
reviewed
Dec 7, 2025
EduardoLR10
previously approved these changes
Dec 8, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Context
In this branch I did a major refactor to enforce a clear segregation between iterators and pure relational operations.
Implementations
Ephemeral Relations
Ephemeral relations are like views in the SQL standard, except that here they are evanescent objects generated out of running any query whatsoever. In an analogy, they are more closely related to the output of a query.
Provenance and lineage at the relation level
It didn't make sense to store the provenance and lineage at the tuple level. A lonely tuple is not bound by any relational scope and practically speaking, causes horrendous duplication of information on rendering for no reason. So I moved it all up to the relation record itself.
Segregation between iterators and operators
The distinction was not clear, so I made pure relational operations to spawn an iterator on demand as to generate its tuples. This is used by both ephemeral and persistent relations. Iterators just pull data, operations organize tuples.
Documentation
Purged old dummy AI-created docs
Example