philiprehberger-clipboard
v0.2.01,411 downloadsMIT
Cross-platform clipboard copy and paste in one function call
$
pip install philiprehberger-clipboardREADME
philiprehberger-clipboard
Cross-platform clipboard copy and paste in one function call.
Installation
pip install philiprehberger-clipboard
Usage
from philiprehberger_clipboard import copy, paste
copy("Hello, clipboard!")
text = paste()
print(text) # Hello, clipboard!
Detect availability
from philiprehberger_clipboard import copy, is_available
if is_available():
copy("hello")
else:
print("install xclip / xsel / wl-clipboard to enable copy")
CLI
Copy text from stdin:
echo "Hello" | python -m philiprehberger_clipboard copy
Paste clipboard contents to stdout:
python -m philiprehberger_clipboard paste
Or use the installed script:
echo "Hello" | clipboard copy
clipboard paste
API
| Function | Description |
|---|---|
copy(text: str) -> None | Copy a string to the system clipboard |
paste() -> str | Read a string from the system clipboard |
is_available() -> bool | Return True if a clipboard backend is detected on the current platform |
ClipboardError | Raised when clipboard tool is unavailable or operation fails |
Platform support
| Platform | Copy | Paste |
|---|---|---|
| Windows | clip.exe | PowerShell Get-Clipboard |
| macOS | pbcopy | pbpaste |
| Linux (X11) | xclip or xsel | xclip or xsel |
| Linux (Wayland) | wl-copy | wl-paste |
Development
pip install -e .
python -m pytest tests/ -v
Support
If you find this project useful: