DOC: example using clipboard_set for all output formats

[attack68]

rather than change the underlying DataFrame.to_clipboard method, here I just included a simple example to demonstrate how to use pandas to send any output string (in any render format) to the clipboard.

• closes ENH: to_clipboard(as="html" | "markdown" | "latex" | ...) #46269

[twoertwein]

I think clipboard_set is not even listed as a public function: https://pandas.pydata.org/docs/search.html?q=clipboard_set

Might be good to also add it to the web documentation.

[twoertwein]

I think pandas.io.clipboard is currently not declared as a public module (from a typing perspective). It is not listed here

pandas/pandas/io/__init__.py

Line 12 in 471319b

__all__ = ["formats", "json", "stata"]

Would need to add "clipboard" to this list. (edit: and import it)

[mroeschke]

I'm not 100% sure these helpers were ever supposed to be public (since a lot of this code is vendored from pyperclip anyways).

IMO for the original issue, I would just recommend passing the output of to_html/to_latex/etc to pyperclip directly.

[attack68]

I'm not 100% sure these helpers were ever supposed to be public (since a lot of this code is vendored from pyperclip anyways).

IMO for the original issue, I would just recommend passing the output of to_html/to_latex/etc to pyperclip directly.

yes I agree, since pandas just copies the pyperclip module (1.7.0) it is probably worth noting this and stating the user can just import the pyperclip module themselves.

[jreback]

thanks @attack68