[DEPR]: Remove literal string/bytes input from read_excel, read_html, and read_xml · Issue #53767 · pandas-dev/pandas (original) (raw)

Skip to content

Navigation Menu

• • GitHub Copilot Write better code with AI
  • GitHub Advanced Security Find and fix vulnerabilities
  • Actions Automate any workflow
  • Codespaces Instant dev environments
  • Issues Plan and track work
  • Code Review Manage code changes
  • Discussions Collaborate outside of code
  • Code Search Find more, search less
• Explore
  • Learning Pathways
  • Events & Webinars
  • Ebooks & Whitepapers
  • Customer Stories
  • Partners
  • Executive Insights
• • GitHub Sponsors Fund open source developers
  • The ReadME Project GitHub community articles
• • Enterprise platform AI-powered developer platform
• Pricing

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Sign up

Appearance settings

Description

Following on from #52271 and #53409 (and to close out #5924), here is the state of play for IO routines in terms of what they accept as input

• read_clipboard: doesn't take input argument
• read_csv: pathlike, BinaryIO, StringIO
• read_excel: pathlike, BinaryIO, engine-specific objects, literal bytes
• read_feather: pathlike, BinaryIO
• read_fwf: pathlike, BinaryIO, StringIO
• read_gbq: SQL query (str)
• read_hdf: pathlike, pytables.HDFStore
• read_html: pathlike, BinaryIO, StringIO, literal bytes, literal string
• read_json: pathlike, BinaryIO, StringIO, literal string (deprecated in DEPR: Deprecate literal json string input to read_json #53409)
• read_orc: pathlike, BinaryIO
• read_parquet: pathlike, BinaryIO
• read_pickle: pathlike, BinaryIO
• read_sas: pathlike, BinaryIO
• read_spss: pathlike (pyreadstat doesn't allow reading from a buffer)
• read_sql_query: SQL query (str)
• read_sql_table: name of database table (str)
• read_stata: pathlike, BinaryIO
• read_table: pathlike, BinaryIO, StringIO
• read_xml: pathlike, BinaryIO, StringIO, literal bytes, literal string

So some, but not all, of the textual formats support reading literally, some support reading bytes as well as strings, and some of the binary formats support reading literal bytes.

Having deprecated literal input to read_json I suggest it makes sense to therefore also do so for:

• read_excel
• read_html
• read_xml