Skip to content

docs: fix CacheBase.streams docstring - #1126

Open
Aaron ("AJ") Steers (aaronsteers) wants to merge 1 commit into
mainfrom
devin/1787789091-fix-streams-docstring
Open

docs: fix CacheBase.streams docstring#1126
Aaron ("AJ") Steers (aaronsteers) wants to merge 1 commit into
mainfrom
devin/1787789091-fix-streams-docstring

Conversation

@aaronsteers

@aaronsteers Aaron ("AJ") Steers (aaronsteers) commented Aug 27, 2026

Copy link
Copy Markdown
Member

Summary

Fixes a copy-paste docstring on CacheBase.streams — it read "Return a temporary table name." (copied from SqlProcessorBase._get_temp_table_name) despite returning dict[str, CachedDataset]. Now reads "Return a mapping of stream names to cached datasets."

Surfaced by Copilot review on the regenerated API reference in airbytehq/airbyte#85090.

Link to Devin session: https://app.devin.ai/sessions/8b64278f1f054e8dbed5d9965d30776b
Requested by: Aaron ("AJ") Steers (@aaronsteers)

Summary by CodeRabbit

  • Documentation
    • Corrected the description of cached stream data to accurately reflect the mapping returned.

Co-Authored-By: AJ Steers <aj@airbyte.io>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration
devin-ai-integration Bot marked this pull request as ready for review August 27, 2026 00:05
Copilot AI lite review requested due to automatic review settings August 27, 2026 00:05
@github-actions

Copy link
Copy Markdown

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

Testing This PyAirbyte Version

You can test this version of PyAirbyte using the following:

# Run PyAirbyte CLI from this branch:
uvx --from 'git+https://github.com/airbytehq/PyAirbyte.git@devin/1787789091-fix-streams-docstring' pyairbyte --help

# Install PyAirbyte from this branch for development:
pip install 'git+https://github.com/airbytehq/PyAirbyte.git@devin/1787789091-fix-streams-docstring'

PR Slash Commands

Airbyte Maintainers can execute the following slash commands on your PR:

  • /fix-pr - Fixes most formatting and linting issues
  • /uv-lock - Updates uv.lock file
  • /test-pr - Runs tests with the updated PyAirbyte
  • /prerelease - Builds and publishes a prerelease version to PyPI
📚 Show Repo Guidance

Helpful Resources

Community Support

Questions? Join the #pyairbyte channel in our Slack workspace.

📝 Edit this welcome message.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR corrects the CacheBase.streams property docstring in airbyte/caches/base.py so the generated API reference reflects the actual return value and avoids misleading documentation.

Changes:

  • Updated the CacheBase.streams docstring to describe that it returns a mapping of stream names to cached datasets (not a temporary table name).

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@coderabbitai

coderabbitai Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1292c74e-2c4a-460d-8786-274241379940

📥 Commits

Reviewing files that changed from the base of the PR and between e872911 and ee16028.

📒 Files selected for processing (1)
  • airbyte/caches/base.py

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

The streams property docstring in airbyte/caches/base.py now describes its return value as a mapping of stream names to cached datasets. No functional behavior changed.

Changes

Cache documentation

Layer / File(s) Summary
Correct streams property documentation
airbyte/caches/base.py
The docstring now describes the mapping returned by streams.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to ee160

This PR corrects the documented return value for CacheBase.streams without changing runtime behavior; no actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: correcting the CacheBase.streams docstring.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch devin/1787789091-fix-streams-docstring

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-code-quality

github-code-quality Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Code Coverage Overview

Languages: Python

Python / code-coverage/pytest-fast

The overall line coverage in commit ee16028 in the devin/1787789091-fix... branch is 69%. The line coverage in commit d9f652f in the main branch is 65%.

Show a line coverage summary of the most impacted files.
File main d9f652f devin/1787789091-fix... ee16028 +/-
airbyte/mcp/cloud.py 52% 57% +5%
airbyte/cloud/connections.py 26% 37% +11%
airbyte/mcp/_tool_utils.py 72% 87% +15%
airbyte/mcp/_arg_resolvers.py 13% 44% +31%
airbyte/mcp/int...c_history_ui.py 0% 36% +36%
airbyte/mcp/int...hared_models.py 0% 81% +81%
airbyte/mcp/int..._registry_ui.py 0% 92% +92%
airbyte/cloud/models.py 0% 95% +95%
airbyte/mcp/http_main.py 0% 95% +95%
airbyte/mcp/int...nc_status_ui.py 0% 97% +97%

Python / code-coverage/pytest-no-creds

The overall line coverage in commit ee16028 in the devin/1787789091-fix... branch is 69%. The line coverage in commit d9f652f in the main branch is 65%.

Show a line coverage summary of the most impacted files.
File main d9f652f devin/1787789091-fix... ee16028 +/-
airbyte/mcp/cloud.py 52% 57% +5%
airbyte/cloud/connections.py 26% 37% +11%
airbyte/mcp/_tool_utils.py 72% 87% +15%
airbyte/mcp/_arg_resolvers.py 13% 44% +31%
airbyte/mcp/int...c_history_ui.py 0% 36% +36%
airbyte/mcp/int...hared_models.py 0% 81% +81%
airbyte/mcp/int..._registry_ui.py 0% 92% +92%
airbyte/cloud/models.py 0% 95% +95%
airbyte/mcp/http_main.py 0% 95% +95%
airbyte/mcp/int...nc_status_ui.py 0% 97% +97%

Python / code-coverage/pytest

The overall line coverage in commit ee16028 in the devin/1787789091-fix... branch is 73%. The line coverage in commit d9f652f in the main branch is 71%.

Show a line coverage summary of the most impacted files.
File main d9f652f devin/1787789091-fix... ee16028 +/-
airbyte/mcp/cloud.py 52% 57% +5%
airbyte/mcp/_tool_utils.py 72% 87% +15%
airbyte/mcp/server.py 69% 88% +19%
airbyte/mcp/_arg_resolvers.py 13% 44% +31%
airbyte/mcp/int...c_history_ui.py 0% 36% +36%
airbyte/mcp/int...hared_models.py 0% 81% +81%
airbyte/mcp/int..._registry_ui.py 0% 92% +92%
airbyte/cloud/models.py 0% 95% +95%
airbyte/mcp/http_main.py 0% 95% +95%
airbyte/mcp/int...nc_status_ui.py 0% 97% +97%

Updated August 27, 2026 00:31 UTC

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.

2 participants