Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOC: update DataFrame.to_feather docstring #35408

Merged
merged 7 commits into from
Sep 13, 2020

Conversation

arw2019
Copy link
Member

@arw2019 arw2019 commented Jul 25, 2020

The issue was that DataFrame.to_feather had an fname argument which in fact could be either a filename or a buffer. Most of the work to close #29532 was done in #30338 where fname argument was deprecated in favor of path. Here I update the docstring to let users know that they can use a buffer.

@arw2019 arw2019 force-pushed the to-feather-api-docs branch 2 times, most recently from f2fb477 to 5a3d562 Compare July 31, 2020 03:40
@simonjayhawkins simonjayhawkins added this to the 1.2 milestone Aug 3, 2020
path : str or file-like object
If a string, it will be used as Root Directory path. By file-like
object, we refer to objects with a write() method, such as
a file handler (e.g. via builtin open function) or io.BytesIO.
Copy link
Member

Choose a reason for hiding this comment

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

do we describe what file-like means elsewhere? id be ok with leaving that out.

backticks around io.BytesIO

Copy link
Member Author

Choose a reason for hiding this comment

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

we do describe it in other writer methods and in the user guide - I took it out (fb37d73)

@arw2019
Copy link
Member Author

arw2019 commented Sep 4, 2020

@simonjayhawkins

@simonjayhawkins simonjayhawkins added the Needs Review Waiting for review/response from a maintainer. label Sep 7, 2020
pandas/core/frame.py Show resolved Hide resolved
@jbrockmendel
Copy link
Member

LGTM

@jreback jreback merged commit 1f49b76 into pandas-dev:master Sep 13, 2020
@jreback
Copy link
Contributor

jreback commented Sep 13, 2020

thanks @arw2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Docs Needs Review Waiting for review/response from a maintainer.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update DataFrame.to_feather() docstring/api documentation and deprecate fname argument.
4 participants