Skip to content

Conversation

@alamb
Copy link
Contributor

@alamb alamb commented Mar 15, 2024

Which issue does this PR close?

Closes #.

Rationale for this change

Inspired by apache/datafusion#9614, I wanted to make it clearer that BufWriter existed / what it could do

What changes are included in this PR?

  1. Update main lib docs to mention BufReader and BufWriter
  2. Update docs for BufReader to mention it adaptively used put / put multi-part

Are there any user-facing changes?

Docs

No code / behavior changes

@alamb alamb added documentation Improvements or additions to documentation object-store labels Mar 15, 2024
@alamb alamb changed the title Minor: add additional documentation about BufWriter Minor: add additional documentation about BufWriter Mar 15, 2024

/// An async buffered writer compatible with the tokio IO traits
///
/// This writer adaptively uses [`ObjectStore::put`] or
Copy link
Contributor Author

Choose a reason for hiding this comment

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

this is such an important feature I think it is worth calling out explicitly

@alamb alamb marked this pull request as ready for review March 15, 2024 13:39
Copy link
Contributor

@tustvold tustvold left a comment

Choose a reason for hiding this comment

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

Just a minor copy suggestion, I think we should highlight that they're a compatibility tool and not hugely recommended

alamb and others added 2 commits March 15, 2024 16:38
@tustvold tustvold merged commit f41c2a4 into apache:master Mar 16, 2024
alamb added a commit to alamb/arrow-rs that referenced this pull request Mar 20, 2025
* Minor: add additional documentation about BufWriter

* Update object_store/src/buffered.rs

* Apply suggestions from code review

Co-authored-by: Raphael Taylor-Davies <[email protected]>

* Format

---------

Co-authored-by: Raphael Taylor-Davies <[email protected]>
Co-authored-by: Raphael Taylor-Davies <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants