Skip to content

Document non-seekable file handle limitations#10

Open
asubbarao wants to merge 1 commit into
Query-farm:mainfrom
asubbarao:fix/document-seek-limitations
Open

Document non-seekable file handle limitations#10
asubbarao wants to merge 1 commit into
Query-farm:mainfrom
asubbarao:fix/document-seek-limitations

Conversation

@asubbarao

@asubbarao asubbarao commented Jun 14, 2026

Copy link
Copy Markdown

Adds a comment block to shell_file_system.hpp documenting that:

  • Seek / SeekPosition are not overridden and throw via the base class
  • GetFileSize always returns 0
  • Reset throws
  • Consumers should check CanSeek() or guard these calls

Related to #9 — the read_text / read_blob pipe failures are likely the same root cause (those functions also call SeekPosition unconditionally on the returned handle).


Fix developed with Claude Opus 4 and Grok (xAI) for the initial implementation pass.

ShellFileSystem does not override Seek/SeekPosition (they throw via
the base class), GetFileSize always returns 0, and Reset throws.
Add a comment block near CanSeek() so extension authors who consume
shellfs file handles know to check CanSeek() or guard these calls.

Related: Query-farm#9 (read_text/read_blob failures with pipe processes)
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