U
|
¬ý°dW ã @ sp d Z dZddlZddlZddlmZmZmZmZmZ ddl Z ddl
|
Z
|
ddl m Z ddl Z ddlZddlZddlmZmZ ddlmZ e d¡Zd Zd
|
Ze
|
¡ d kr¨d Znd Zdd Ze dddZ dd Z dd Z dd Z dd Z!dd Z"d d Z#d d Z$d!d" Z%G d#d$ d$Z&d%d& Z'd'd( Z(d)d* Z)d+d, Z*d-d. Z+d/d0 Z,e-dd1d2Z.e+e, a/a0d3d4d,d*gZ1t0Z2t/Z3dS )5ae
|
Pyperclip
|
|
A cross-platform clipboard module for Python,
|
with copy & paste functions for plain text.
|
By Al Sweigart al@inventwithpython.com
|
BSD License
|
|
Usage:
|
import pyperclip
|
pyperclip.copy('The text to be copied to the clipboard.')
|
spam = pyperclip.paste()
|
|
if not pyperclip.is_available():
|
print("Copy functionality unavailable!")
|
|
On Windows, no additional modules are needed.
|
On Mac, the pyobjc module is used, falling back to the pbcopy and pbpaste cli
|
commands. (These commands should come with OS X.).
|
On Linux, install xclip or xsel via package manager. For example, in Debian:
|
sudo apt-get install xclip
|
sudo apt-get install xsel
|
|
Otherwise on Linux, you will need the PyQt5 modules installed.
|
|
This module does not work with PyGObject yet.
|
|
Cygwin is currently not supported.
|
|
Security Note: This module runs programs with these names:
|
- which
|
- where
|
- pbcopy
|
- pbpaste
|
- xclip
|
- xsel
|
- klipper
|
- qdbus
|
A malicious user could rename or add programs with these names, tricking
|
Pyperclip into running them with whatever permissions the Python process has.
|
|
z1.7.0é N)Úc_size_tÚc_wcharÚ c_wchar_pÚ get_errnoÚsizeof)Úwhich)ÚPyperclipExceptionÚPyperclipWindowsException)Úfind_stack_levelZDISPLAYz·
|
Pyperclip could not find a copy/paste mechanism for your system.
|
For more information, please visit
|
https://pyperclip.readthedocs.io/en/latest/#not-implemented-error
|
zutf-8ÚWindowsÚwherer c C s t jt| gt jt jddkS )N)ÚstdoutÚstderrr )Ú
|
subprocessÚcallÚ WHICH_CMDÚPIPE)Úname© r úSd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/io/clipboard/__init__.pyÚ_executable_existsY s ÿýÿr ©Úreturnc C s2 t tttf}t| |s*tdt| j t | S )NzJonly str, int, float, and bool values can be copied to the clipboard, not )ÚstrÚintÚfloatÚboolÚ
|
isinstancer ÚtypeÚ__name__)ÚtextZ acceptedTypesr r r Ú_stringifyTextb s
|
ÿr! c C s dd } dd }| |fS )Nc S s@ t | } tjddgtjdd}|j| t¡d W 5 Q R X d S )NÚpbcopyÚwT©ÚstdinÚ close_fds©Úinput©r! r ÚPopenr Ú communicateÚencodeÚENCODING©r Úpr r r Úcopy_osx_pbcopym s ÿz2init_osx_pbcopy_clipboard.<locals>.copy_osx_pbcopyc S s8 t jddgt jdd} | ¡ d }W 5 Q R X | t¡S )NZpbpasteÚrT©r r& r ©r r* r r+ Údecoder- ©r/ r r r r Úpaste_osx_pbcopyt s ÿz3init_osx_pbcopy_clipboard.<locals>.paste_osx_pbcopyr )r0 r6 r r r Úinit_osx_pbcopy_clipboardl s r7 c C s dd } dd }| |fS )Nc S sP t | } tj | ¡ ¡ }| tj¡}tj ¡ }|
|
tj gd¡ | |tj ¡ dS )z!Copy string argument to clipboardN) r! Ú
|
FoundationZNSStringZstringWithString_ZnsstringZdataUsingEncoding_ZNSUTF8StringEncodingÚAppKitÚ NSPasteboardÚgeneralPasteboardZdeclareTypes_owner_ÚNSStringPboardTypeZsetData_forType_)r ZnewStrZnewDataÚboardr r r Úcopy_osx_pyobjc s
|
z2init_osx_pyobjc_clipboard.<locals>.copy_osx_pyobjcc S s t j ¡ } | t j¡}|S )z Returns contents of clipboard)r9 r: r; ZstringForType_r< )r= Úcontentr r r Úpaste_osx_pyobjc s
|
z3init_osx_pyobjc_clipboard.<locals>.paste_osx_pyobjcr )r> r@ r r r Úinit_osx_pyobjc_clipboard~ s rA c s zddl ma W nF tk
|
rV zddlma W n tk
|
rP ddlma Y nX Y nX t ¡ d krptg fdd} td fdd }| |fS )Nr )Ú QApplicationc s t | } ¡ }| | ¡ d S ©N)r! Ú clipboardZsetText)r Úcb©Zappr r Úcopy_qt¢ s z"init_qt_clipboard.<locals>.copy_qtr c s ¡ } t| ¡ S rC )rD r r )rE rF r r Úpaste_qt§ s z#init_qt_clipboard.<locals>.paste_qt)Zqtpy.QtWidgetsrB Ú ImportErrorZPyQt5.QtWidgetsZ PyQt4.QtGuiÚinstancer )rG rH r rF r Úinit_qt_clipboard s rK c s0 d dd fdd } d fdd }| |fS )
|
NÚcr/ Fc sN t | } }|r}tjdd|gtjdd}|j| t¡d W 5 Q R X d S )NÚxclipú
|
-selectionTr$ r' r) )r ÚprimaryÚ selectionr/ ©ZDEFAULT_SELECTIONZPRIMARY_SELECTIONr r Ú
|
copy_xclip² s ÿz(init_xclip_clipboard.<locals>.copy_xclipc sL }| r }t jdd|dgt jt jdd}| ¡ d }W 5 Q R X | t¡S )NrM rN ú-oT©r r r& r r3 )rO rP r/ r rQ r r Ú paste_xclip¼ s
|
üz)init_xclip_clipboard.<locals>.paste_xclip)F)Fr )rR rU r rQ r Úinit_xclip_clipboard® s
|
|
rV c s0 d dd fdd } d fdd }| |fS )
|
Nz-bz-pFc sN t | } }|r}tjd|dgtjdd}|j| t¡d W 5 Q R X d S )NÚxselz-iTr$ r' r) )r rO Úselection_flagr/ rQ r r Ú copy_xselÑ s ÿz&init_xsel_clipboard.<locals>.copy_xselc sF }| r }t jd|dgt jdd}| ¡ d }W 5 Q R X | t¡S )NrW rS Tr2 r r3 )rO rX r/ r rQ r r Ú
|
paste_xselÛ s ÿz'init_xsel_clipboard.<locals>.paste_xsel)F)Fr )rY rZ r rQ r Úinit_xsel_clipboardÍ s
|
|
|
r[ c C s dd } dd }| |fS )Nc S sF t | } tjdddd| t¡gtjdd}|jd d W 5 Q R X d S )NÚqdbusúorg.kde.klipperú/klipperZsetClipboardContentsTr$ r' )r! r r* r, r- r r+ r. r r r Ú copy_klipperé s û÷
|
z,init_klipper_clipboard.<locals>.copy_klipperc S st t jddddgt jdd} | ¡ d }W 5 Q R X | t¡}t|dksLt| d¡sZt| d¡rp|d d
}|S )
|
Nr\ r] r^ ZgetClipboardContentsTr2 r Ú
|
éÿÿÿÿ) r r* r r+ r4 r- ÚlenÚAssertionErrorÚendswith)r/ r ZclipboardContentsr r r Ú paste_klipperø s
|
ý
|
|
z-init_klipper_clipboard.<locals>.paste_klipperr )r_ re r r r Úinit_klipper_clipboardè s rf c C s dd } t ddd}| |fS )Nc S s\ t | } | dkr tjdt d d| kr8tjdt d tdd}| | ¡ W 5 Q R X d S )NÚ z]Pyperclip cannot copy a blank string to the clipboard on Cygwin. This is effectively a no-op.©Ú
|
stacklevelú z0Pyperclip cannot handle \r characters on Cygwin.ú/dev/clipboardr# )r! ÚwarningsÚwarnr
|
ÚopenÚwrite)r Úfdr r r Úcopy_dev_clipboard s ýþ z8init_dev_clipboard_clipboard.<locals>.copy_dev_clipboardr c S s t d} | ¡ }W 5 Q R X |S )Nrk )rn Úread)rp r? r r r Úpaste_dev_clipboard s
|
z9init_dev_clipboard_clipboard.<locals>.paste_dev_clipboard)r )rq rs r r r Ú init_dev_clipboard_clipboard s rt c C s G dd d} | | fS )Nc @ s" e Zd Zdd ZedddZdS )z/init_no_clipboard.<locals>.ClipboardUnavailablec _ s t td S rC )r Ú
|
EXCEPT_MSG)ÚselfÚargsÚkwargsr r r Ú__call__* s z8init_no_clipboard.<locals>.ClipboardUnavailable.__call__r c S s dS )NFr )rv r r r Ú__bool__- s z8init_no_clipboard.<locals>.ClipboardUnavailable.__bool__N)r Ú
|
__module__Ú __qualname__ry r rz r r r r ÚClipboardUnavailable) s r} r )r} r r r Úinit_no_clipboard( s r~ c s2 e Zd Zdd fdd Zdd Zdd Z ZS ) Ú CheckedCallNr c s t d|¡ d S )NÚf)ÚsuperÚ __setattr__)rv r ©Ú __class__r r Ú__init__5 s zCheckedCall.__init__c G s( | j | }|s$t r$td| j j |S )NzError calling )r r r r )rv rw Úretr r r ry 8 s
|
|
zCheckedCall.__call__c C s t | j|| d S rC )Úsetattrr )rv ÚkeyÚvaluer r r r > s zCheckedCall.__setattr__)r r{ r| r
ry r Ú __classcell__r r r r r 4 s r c sØ ddl mamamamamamamamam a m
|
a
|
m a t j } t d¡}t| jjtt t ttttttttt
|
g _t_t| jjtg_t_| jjtg_t_t| jjg _t_t| jjg _t_t| jjt g_t_t| jj t tg _t _t| jj t t g _t _t| jj
|
tg
|
_t
|
|
_t| jj tg _t _t|j t g _t _dd t!j"fddt!j"fdd
|
f
|
d
|
d } fd d }||fS )Nr ) ÚBOOLÚDWORDÚHANDLEÚHGLOBALÚ HINSTANCEÚHMENUÚHWNDÚINTÚLPCSTRÚLPVOIDÚUINTÚmsvcrté é c 3 s8 dddddddddddd } z
|
| V W 5 | X dS )z=
|
Context that provides a valid Windows hwnd.
|
r s STATICNr )Úhwnd)ÚsafeCreateWindowExAÚsafeDestroyWindowr r Úwindow s" ÿ
|
z&init_windows_clipboard.<locals>.windowc 3 sZ t ¡ d }d}t ¡ |k r6 | }|r*q6t d¡ q|sBtdz
|
dV W 5 X dS )z
|
Context manager that opens the clipboard and prevents
|
other applications from modifying the clipboard content.
|
g à?Fg{®Gáz?zError calling OpenClipboardN)ÚtimeÚsleepr )r ÚtÚsuccess)Ú OpenClipboardÚsafeCloseClipboardr r rD ¡ s
|
z)init_windows_clipboard.<locals>.clipboardc
|
s t | } z}|f | rz| d }|tt }|}t t|t| |tt ¡ | | W 5 Q R X W 5 Q R X d S )Né )r! r r ÚctypesÚmemmover )r r ÚcountÚhandleZ locked_handle)
|
ÚCF_UNICODETEXTÚ GMEM_MOVEABLErD ÚsafeEmptyClipboardÚsafeGlobalAllocÚsafeGlobalLockÚsafeGlobalUnlockÚsafeSetClipboardDataÚwcslenr r r Ú copy_windows¹ s
|
|
ýz,init_windows_clipboard.<locals>.copy_windowsc
|
sD d 2 } | s$W 5 Q R £ dS t | jW 5 Q R £ S Q R X d S )Nrg )r r )r§ )r¨ rD ÚsafeGetClipboardDatar r Ú paste_windowsÚ s
|
|
z-init_windows_clipboard.<locals>.paste_windows)#Zctypes.wintypesr r r r r r r r r r r r¤ ÚwindllÚCDLLr Zuser32ZCreateWindowExAÚargtypesÚrestypeZ DestroyWindowr¡ ZCloseClipboardZEmptyClipboardZGetClipboardDataZSetClipboardDataÚkernel32Z GlobalAllocr Z
|
GlobalLockZ GlobalUnlockr¯ r Ú
|
contextlibÚcontextmanager)r³ r r° r² r )r¨ r© r¡ rD r¢ r r rª r± r« r¬ r r® r¯ r r Úinit_windows_clipboardB sr 4
|
ô
|
|
|
! rº c C s dd } dd }| |fS )Nc S s> t | } tjdgtjdd}|j| t¡d W 5 Q R X d S )Nzclip.exeTr$ r' r) r. r r r Úcopy_wslé s z$init_wsl_clipboard.<locals>.copy_wslc S sF t jdddgt jt jdd} | ¡ d }W 5 Q R X |d d
t¡S )Nzpowershell.exez-commandz Get-ClipboardTrT r éþÿÿÿr3 r5 r r r Ú paste_wslî s üz%init_wsl_clipboard.<locals>.paste_wslr )r» r½ r r r Úinit_wsl_clipboardè s r¾ c C s~ dt ¡ ¡ kr4tj d¡rPtjdt d t S n tj
|
dksJt ¡ dkrPt S t ¡ dkrjt drjt S tj
|
d kst ¡ d
|
kr¶zd d lad d laW n tk
|
r® t Y S X t S trxtd rÊt S tdrØt S tdrîtdrît S z d d laW nv tk
|
rp z d d laW nH tk
|
r` z d d laW n tk
|
rL Y nX t Y Y S Y n X t Y S Y nX t S t S )z]
|
Determine the OS/platform and set the copy() and paste() functions
|
accordingly.
|
Úcygwinrk zcPyperclip's support for Cygwin is not perfect, see https://github.com/asweigart/pyperclip/issues/55rh Úntr ÚLinuxz wslconfig.exeÚmacÚDarwinr NrW rM Úklipperr\ ) ÚplatformÚsystemÚlowerÚosÚpathÚexistsrl rm r
|
rt r rº r r¾ r9 r8 rI r7 rA Ú HAS_DISPLAYr r[ rV rf ZqtpyZPyQt5ZPyQt4rK r~ r r r r Údetermine_clipboardþ sR ÿ ý rÌ c C sR t tttttttd}| |kr@dd |D }tdd |¡ || \a
|
a dS )aÒ
|
Explicitly sets the clipboard mechanism. The "clipboard mechanism" is how
|
the copy() and paste() functions interact with the operating system to
|
implement the copy/paste feature. The clipboard parameter must be one of:
|
- pbcopy
|
- pyobjc (default on macOS)
|
- qt
|
- xclip
|
- xsel
|
- klipper
|
- windows (default on Windows)
|
- no (this is what is set when no clipboard mechanism can be found)
|
)r" ZpyobjcZqtrM rW rÄ ZwindowsÚnoc S s g | ] }t |qS r )Úrepr)Ú.0Ú_r r r Ú
|
<listcomp>c s z!set_clipboard.<locals>.<listcomp>zArgument must be one of z, N) r7 rA rK rV r[ rf rº r~ Ú
|
ValueErrorÚjoinÚcopyÚpaste)rD Zclipboard_typesZallowed_clipboard_typesr r r Ú set_clipboardG s ø ÿrÖ c C s t \aat| S )aD
|
A stub function for copy(), which will load the real copy() function when
|
called so that the real copy() function is used for later calls.
|
|
This allows users to import pyperclip without having determine_clipboard()
|
automatically run, which will automatically select a clipboard mechanism.
|
This could be a problem if it selects, say, the memory-heavy PyQt4 module
|
but the user was just going to immediately call set_clipboard() to use a
|
different clipboard mechanism.
|
|
The lazy loading this stub function implements gives the user a chance to
|
call set_clipboard() to pick another clipboard mechanism. Or, if the user
|
simply calls copy() or paste() without calling set_clipboard() first,
|
will fall back on whatever clipboard mechanism that determine_clipboard()
|
automatically chooses.
|
©rÌ rÔ rÕ )r r r r Úlazy_load_stub_copyl s
|
rØ c C s t \aat S )aG
|
A stub function for paste(), which will load the real paste() function when
|
called so that the real paste() function is used for later calls.
|
|
This allows users to import pyperclip without having determine_clipboard()
|
automatically run, which will automatically select a clipboard mechanism.
|
This could be a problem if it selects, say, the memory-heavy PyQt4 module
|
but the user was just going to immediately call set_clipboard() to use a
|
different clipboard mechanism.
|
|
The lazy loading this stub function implements gives the user a chance to
|
call set_clipboard() to pick another clipboard mechanism. Or, if the user
|
simply calls copy() or paste() without calling set_clipboard() first,
|
will fall back on whatever clipboard mechanism that determine_clipboard()
|
automatically chooses.
|
r× r r r r Úlazy_load_stub_paste s
|
rÙ c C s t tkottkS rC )rÔ rØ rÕ rÙ r r r r Ú is_available s rÚ rÔ rÕ )4Ú__doc__Ú __version__r¸ r¤ r r r r r rÈ rÅ Úshutilr r r rl Z pandas.errorsr r Zpandas.util._exceptionsr
|
ÚgetenvrË ru r- rÆ r r r r! r7 rA rK rV r[ rf rt r~ r rº r¾ rÌ rÖ rØ rÙ r rÚ rÔ rÕ Ú__all__Z clipboard_getZ clipboard_setr r r r Ú<module> sR +
|
|
& 'I%
|
|
