File: //proc/thread-self/root/proc/self/root/proc/self/root/proc/thread-self/cwd/site-packages.zip
PK ok\%M�m m ( netifaces.cpython-39-x86_64-linux-gnu.sonu ȯ�� ELF > � @ H� @ 8 @ $ ! �5 �5 �5 �5 �5 � � 6 6 6 � � � � � $ $ P�td 4 4 4 < < Q�td GNU r���N�m��f�4�/�^(>� 5 ��( @ 5 7 : BE���|�f?��qX ������ � � u . � � � � J + x � w � � ; q � j � � � C � X � � Y � ~ � # f � � � a � k 8 R " � _ �: �: � �& = �: � 0. __gmon_start__ _init _fini _ITM_deregisterTMCloneTable _ITM_registerTMCloneTable __cxa_finalize _Jv_RegisterClasses PyList_New getifaddrs strncmp PyUnicode_FromString PySequence_Contains PyList_Append _Py_Dealloc freeifaddrs PyExc_OSError PyErr_SetFromErrno getnameinfo sprintf getpagesize PyDict_New PyDict_SetItemString PyDict_GetItemString malloc socket bind getsockname sendto recvmsg memcmp if_indextoname inet_ntop _Py_FalseStruct PyTuple_Pack PyObject_IsTrue PyObject_Size PyLong_FromLong PyDict_SetItem free close __errno_location _Py_TrueStruct PyErr_SetString PyDict_GetItem PyErr_NoMemory PyArg_ParseTuple strcmp memcpy PyExc_ValueError PyInit_netifaces PyModule_Create2 PyModule_AddIntConstant PyModule_AddObject PyModule_AddStringConstant libpthread.so.0 libc.so.6 _edata __bss_start _end GLIBC_2.2.5 GLIBC_2.3 � ui # ii
/ ui # �5 P �5 6 6 �9 �/ �9 : : �/ (: @ 8: 0 @: �/ H: � X: 1 `: �/ h: � x: P1 �7 �7 �7 �7 8 8 $ 8 , 8 1 8 2 @8 H8 P8 X8 `8 h8 p8 x8
�8 �8 �8
�8 �8 �8 �8 �8 �8 �8 �8 �8 �8 �8 �8 �8 9 9 9 ! 9 " 9 # (9 % 09 & 89 ' @9 ( H9 ) P9 * X9 + `9 - h9 . p9 / x9 0 �9 2 �9 3 �9 4 H���� H��� �5j& �%l& @ �%j& h ����%b& h �����%Z& h ����%R& h ����%J& h ����%B& h ����%:& h ����%2& h �p����%*& h �`����%"& h �P����%& h
�@����%& h �0����%
& h � ����%& h
�����%�% h � ����%�% h ���%�% h ����%�% h �����%�% h ����%�% h ����%�% h ����%�% h ����%�% h ����%�% h �p����%�% h �`����%�% h �P����%�% h �@����%�% h �0����%�% h � ����%�% h �����%z% h � ����%r% h ���%j% h ����%b% h! �����%Z% h" ����%R% h# ����%J% h$ ����%B% h% ����%:% h& ����%2% h' �p����%*% h( �`����%"% h) �P����%% h* �@���H��H�u# H��t��H���f � H� & H�=�% UH)�H��H��w]�H� # H��t�]�� @ H��% H�=�% UH)�H��H��H��H��?H�H�u]�H�# H��t�]H��� @ �=�% u'H�=�" UH��t H�=� � ����h���]�`% ��fffff. � H�=� t&H��" H��tUH�=� H���]�W��� � �K���f. � �AU1�ATUSH��H�$ �7���H��I��������� H� $H���� E1��f�H�m tZL�cH�H��t]H�kH��t�M��t� L��H���/�����t�H������L��H��H���e�����u�H��L������H�m u�H������� D H�<$�g���L��H��[]A\A]�1���I�m uL�����H�! H�8����1��� AVAUATUH��SH��H���� �f���� ��
I��� ��w
H� �4�E1�E1��$ � L��H��������tx�E A� �Ѓ�
��w H�
� Lc$�I��f��H�]tcO�4dI�� wfM��A�E �����t:I�L���H�5 H��1�H��H����L9�u�C�D5� 1�A�} ����H��[]A\A]A^�D�e H�] � D �������f � AWAVAUATU� SH�� ���H��$� = � N�H�����H���H�����I��H�D$(����H�5^ H��H��L�����H�+�q H�|$(H�5: � ���H�D$XHc�H��H�D$�*���H��I���C 1Ҿ � �-������$�z H�\$p� �Ǻ f�L$p�D$x H���D$t �T������8 �<$H�T$`H���D$` ������ �<$� L�Q � fA�T$1�A� � L��I�D$ A�D$ A�$ fA�D$A�D$ A�D$ ���H���� H��$� E1�H�D$H��$� H�D$H��$� H�D$ H��$� H�D$PH��$� H�D$Hf D H�D$H�t$ 1ҋ<$L��$� DŽ$� HDŽ$� H��$� H�D$HDŽ$� HDŽ$� DŽ$� H��$� H�D$H��$� ������$� �� H���: ���� A�,$���� 9�A���� L���. A�B��A)�H�A���� �+���� D9��� �{A��űD$t9C u�D�k�CA��f��E���a f���� �M�H�S ��~��C f��v�9�|�A�����E1�1�E���3 @ f��tZf��uD�B����)�H�H�~N�f��vE9�A�rf��tw�L�Rf��ID��� � D�J�f. � L�z�f. � H��tM�C<�� <
A�����H�5� � D�D$8D�L$0�l$D�����D�L$0D�D$8D�T$D�����D��A���� M����!Є������H�t$PD��D�D$0����H��H��� �{H�T$H� L��� ���H���� �{�D�D$0�� L�=( �C< w)���� E��� DHǃ��t D9��� D���� H������H�|$HH������L��H��H��H�D$8� 1��0���L��H�D$0E1��0�����L�L$8�� I�)�w H�m �_ H�|$0H��t�C������H���z M��t1�{�2���H�|$XH��L��H���o���H�m � I�/�� D��R���f�E�������L���/����<$����H�D$(�H�5 � D�D$8D�L$0������D�L$0D�D$8�U���A����������S�ډH�� H�8����H�|$(H�H�D$H��H��H�� L����<$�C���1�H�Ĉ []A\A]A^A_�H��������L�=� �F���L����D��v���L�=W �[���H�C H�5� H�8���o���H�������L���z��|���L��H�� 1��s���L�L$8I���S���@����H�|$(H��H�D$8���L�D$8M���= H���� H�l$0H��H�����H�E H�D$8H��H��H�E �*���H�|$0����������f D �������H�D$(H�8H�W�H�<$H�1�H������H�|$(H�$��H�$���H������H�- H�8�u�H�|$(H�H�D$H��H��H�u�g�L����<$��1��_���� L�D$8���H��H��L�D$8�� H�|$0H�@H��L��H�L$0H�8H�|$(���H�L$0H�)�0���H�����#��� H�l$0H�} H�W�H��H�U uH��H�D$���H�D$H��tH�8H�W�H��H�uH����M�������I�/�y���L�����l��� @ H�! H�8�i�H�|$(H�H�$H��H��H�u�\�L����1��\���H�l$0H�m uH��L�D$�4�L�D$I�(�y���L��� ��l��� � AWH��H�5q 1�AVAUATUSH��H H�T$H�D$ ���� �C�H��H�$�� H�|$ ����� H�\$ H���� H�D$01�L�|$@H�D$�v H�5�
L���!�M��tI�m uL���m�M��tI�.uL���Z�H��tH�m uH���F�H�CL���(�'�H���� � H�H���e H�{H��t�H�t$����u�H�{H��t�L��E1��"������b H�{ H��t
f�?
�� L��E1�����& H�{(L��1������� H�Cf�8�� � �H��I���� M��tH�5� L��H����M��tH�5� L��L����H�������CH�������H�5r L�������� � ����H�<$H��H����H���p H���� L��H����I�,$����L�������� @ L���h�H��H�Cf�8�'����@�f1�= ������H��t H�m �� 1��
�H��I������M��tI�m uL���}�M��tI�.uL���j�H��tH�m uH���V�H�$H�H�D$H��H��H��� H���2�� D E1�A� � D���T� ��� �t#��@�������@���������3Dƃ�U�g E�L��� �� D)�D)�A��A��E��` D�G1�M���-f D ��D�G t�uH��$@ I9�s A�$:I��H��D��L��$@ ���q0��W@��:M�A��A�H0A��W��:AM�M9�sM�D$A�4$M9��� A�L$I����D9�u����� H��$@ L)�L�t$H�5
1�L�����L��
H����������!�%����t������ D�H�JHD� �H��H+T$Hc�H9�}H�t$H��L���F�Ƅ$? L���&�I������f D L����I����� � A��������A��A����?������M�� � H��$@ L)�H���$���I�D$H��$@ A�$:A�D$:H)�I������1��i�H�$H�H�D$H��H��H��s H�~ H�5o
H�8�� � 1�H��H []A\A]A^A_� @ H�|$ ����H�$u�� @ I�,$tyH��t
H�(�� H�$H�H�D$H��H��H��� H�|$ ����f�� ���H��I��tRH�@H�<$L��H��L� ��I�m �����L���%���L��H�D$��H�D$�p���H�����r���I�,$t*H�m �`���H������S���H��1���� �)���L����� ��H�<$���B���H�$H�H�D$H��H��H�uH����H�) H�8�q�1����H���r�f��~���M���8��� ATH�=� �� US��H��H��� ��H�5k 1�H��H�����H�=W ��1�I����L��H��H�����H�5= � H����H�=) �r�� I���E�L��H��H����H�5
� H���s�H�=� �7�� I���
�L��H��H���L�H�5� � H���8�H�=� ��� I�����L��H��H����H�5� � H����H�=� ��� I����L��H��H�����H�5q � H�����H�=] ��� I���Y�L��H��H����H�5= � H����H�=) �K�� I��� �L��H��H���`�H�5 � H���L�H�=� ��� I�����L��H��H���%�H�5� � H����H�=� ���� I����L��H��H�����H�5� � H�����H�=� ��� I���m�L��H��H����H�5y � H����H�=e �_�� I���2�L��H��H���t�H�5H � H���`�H�=4 �$�� I����L��H��H���9�H�5 �
H���%�H�= ����
I����L��H��H����H�5� �
H�����H�=� ���
I����L��H��H�����H�5� � H����H�=� �s�� I���F�L��H��H����H�5� � H���t�H�=m �8�� I��� �L��H��H���M�H�5P � H���9�H�=< ��� I�����L��H��H����H�5 � H����H�= ���� I����L��H��H�����H�5� � H�����H�=� ��� I���Z�L��H��H����H�5� � H����H�=� �L�� I��� �L��H��H���a�H�5� � H���M�H�=s ��� I�����L��H��H���&�H�5T � H����H�=@ ���� I����L��H��H�����H�5% � H�����H�= ��� I���n�L��H��H����H�5� � H����H�=� �`�� I���3�L��H��H���u�H�5� � H���a�H�=� �%�� I����L��H��H���:�H�5� � H���&�H�=y ���� I����L��H��H����H�5� � H�����H�=� ��� I����L��H��H�����H�5! � H����H�=
�t�� I���G�L��H��H����H�5� � H���u�H�=� �9�� I��� �L��H��H���N�H�5� � H���:�H�=� ��� I�����L��H��H����H�5� H��H�����H�� H�5� H�����H��[]A\� H��H��� %02x: default netlink message truncated /%u addr netmask peer broadcast AF_UNSPEC AF_UNIX AF_FILE AF_INET AF_AX25 AF_SNA AF_DECnet AF_APPLETALK AF_ROUTE AF_LINK AF_PACKET AF_IPX AF_INET6 AF_NETBEUI AF_ATMPVC AF_ATMSVC AF_IRDA AF_NETROM AF_BRIDGE AF_X25 AF_ROSE AF_SECURITY AF_KEY AF_NETLINK AF_ASH AF_ECONET AF_PPPOX AF_WANPIPE AF_BLUETOOTH address_families 0.11.0 version netifaces ifaddresses interfaces gateways You must specify a valid interface name. Obtain information about the specified network interface.
Returns a dict whose keys are equal to the address family constants,
e.g. netifaces.AF_INET, and whose values are a list of addresses in
that family that are attached to the network interface. Obtain a list of the interfaces available on this machine. Obtain a list of the gateways on this machine.
Returns a dict whose keys are equal to the address family constants,
e.g. netifaces.AF_INET, and whose values are a list of tuples of the
format (<address>, <interface>, <is_default>).
There is also a special entry with the key 'default', which you can use
to quickly obtain the default gateway for a particular address family.
There may in general be multiple gateways; different address
families may have different gateway settings (e.g. AF_INET vs AF_INET6)
and on some systems it's also possible to have interface-specific
default gateways.
;< ���X ��� p�� �� 0�X �� zR x � $ P��� FJ w� ?;*3$" < D ��� B�D�A �A(�D@�
(A ABBA D � �� B�B�B �A(�D0�D@�
0A(A BBBA L � p�� B�B�B �B(�A0�F8�G��
8A0A(B BBBA L ��� B�N�B �B(�A0�A8�G�,
8A0A(B BBBE , l 0�= B�M�A �)AB P 6 � �
0. �5 �5 ���o � � �
9 (8 �
� ( ���o 0 ���o �o �
���o 6 � � � & 6 F V f v � � � � � � � � & 6 F V f v � � � � � � � � & 6 F V f v �/ �������� : �/ @ 0 �/ � 1 �/ � P1 GCC: (GNU) 4.1.2 20080704 (Red Hat 4.1.2-55) GCC: (GNU) 4.8.2 20140120 (Red Hat 4.8.2-15) GCC: (GNU) 4.1.2 20080704 (Red Hat 4.1.2-55) , � � �M � � � -. �
�8 � � � � � int � = �i Z
�i � �
�i � � �
�M � `
b # � � #� � #�
� # � # ? � #( � #0� � #8�
� #@� � #H� � #P� � #X� � #`1 !� #h? #b #p� 'b #tL )p #x� -F #� .T #�M /� #�� 3� #�P <{ #�3 E� #�� F� #�: G� #�A H� #�H I- #� Kb #� M� #� � � �
� � � �
� �� �� # � �� #� �b # � � � � � � � � b � �
n� � �? ^ �F �M � � \ � b �
�� ( 1? � 2F Q 4M A i V
r� � � B� �
�� �
� # 9
� #G
ď # �
ď #(�
�� #04
ɏ #8�
�� #@8
� #H
�� #P
�R #X�
�� #`�
�� #hM
� #pt
�] #x@
�c #�]
�R #��
� #�j
�G #��
� #�$
�8 #�
� #��
� #�~
� #��
�~ #��
� #�'
�� #��
�� #�
�G #��
�S #��
�� #�y
�� #�
�7 #�
�� #��
�� #��
� #��
� #�2
#�4
� #��
� #�D
� #�4
7 #�5
7 #�
7 #�F
7 #��
7 #�
� #��
M #�C
� #��
< #�
� i� � k� # � l� # � w
m� s � t� # u� #
v� { �! ' 7 7 7 � � �H N 7 c 7 7 u �n t 7 � 7 7 7 I �� � b � 7 G �� � � � 7 �� � 7 � 7 � � � b ! 7 � 7 � �, 2 b L 7 7 7 � �W ] b r 7 7 0 �} � b � 7 � �� � b � 7 r � � �� � �� �
� 7 � �� � 7 7 � �H d �' - b G 7 � 7 � �, � �! � �h n � ~ 7 �� � 7 � 7 7 b � �! { �! I �n 0 �, � �, � �� � 7
� 7 7 �
�
7 1
� �
� P
8�
buf
9� # obj
:7 #len
;� #�
<� #�
>b # �
?b #$t
@� #(i
A�
#0`
B�
#8H
C�
#@�
D� #H � �
E1
a
G�
�
b 7 b �
H% +
< 7 �
JG M 7 l 7 l - 7 r 7
o�
�
t= # l
u= #�
v= #
w= #�
x= # W
yc #(�
z #0�
{ #8�
| #@�
}� #HZ
~ #P(
= #X�
�= #`+
�= #h�
�= #pa
�= #x�
� #��
�� #��
� #�l
�= #�T
�= #�l
�= #�)
�= #�Y
�c #�*
�= #�d
�= #��
�= #�7
�= #��
�= #�
�= #��
�= #�B
�= #�x
�= #��
� #�
�= #�,
�= #�
�w P
�- �
�� # �
�= #�
�� #�
�� #�
�� # �
�� #(d
�� #0�
�L #82
�= #@�
�� #H j
��
�k �
�� # q
�= #�
�! # �
�8
�� �
� # .
� #�
� # �
�v
�� �
��
# �
� #
�� � �
- k �
7 #G | $ # � %P #+ &b #d ( # � M
( � # get
� #set � #doc #K � # Y � ? � �
�
U� �
V # Z
W� # ]
-� � � ( ? �
# H ? # � # 7 � � H 7 * [
� (,� � -� # W .� #� /� #�
07 # 7 � � 1l
g =� �
>b # `
?� #
� hK| � L� # B M #(� N #0 O� #8 Pf #@� Q| #H R� #P�
S� #X� T� #` � � 7 � 7 � � � � � � b � 7 7 �
� ,� c .� # � /- # > )-
� 2 ` " U
l F
� �a < �- # � �a # � q �
�� q b � � w � � � � �� �� �� �a �# � T �� � ��m ��
' 8�\ � ٍ # � �c #� �\ #, �- #� ߍ # d
�- #(r �b #0 � 8
� � � - # � ` # � #U !L # h
� L� ' N- # O� #)
Pb # � � � s
�
` �M � �- # � ު #� � # �P #
� � �- # � � #� � # �5 #\ � # S M �
� # / %- # � &/ # ': #�
( #( )$ #
*? # � d � + s 7 � C �
XZ W� Wb 9 W� # W� � W� � W ! WM k W� � W� V W �
W% � W1 W= � WI � 8 h � � $ � / : S E � P � [ f + q 7 | C � \� [$ [� 9 [� # [ � [ � [ ! [) k [4 � [? V [J �
[U � [` [k � [v ,� ; _ �
8 � Y � � �� �� �� ��
��
� 7 �� �� �� � � � \y - ��
� �� : �� # � [ � � � � �% n � y % � � 5 �
�P O �� # ? ` � ; ? �
F C M
�k
k � v - # � !F #� "v #| #v #
% &$ (v # O )k #p *k #o +v #S ,v #
C _M ab # msg b� #
M � e � � m � �
� � 2 ;
� � � � !
"P $, %� &� (� )L *� ,� -� .� 0� 1E 2 4� 6� :$ > � � � �
� � � # � � � ( �
+
yv � {F # h |F #
� �? # � �? #= �? #� �? #
�? #� �? #A �? #
�? #� �M # � �3 6
� �& �� �� ���� | �� - o
| � �
v
U � "
F ^ �
A � �
� � � # x ` # F� H� # � � � � J� ? �
� � � F # 4 F #x b #� F #� ? #
? # P # '� � -b S .b
\ 8 # "� #] #M #h %b #� &b # � /� #(W 9� #0 � � �. op �7 q �b } !� �7 !- �b obj �7 "q �7 "� �7 #� �b � $af �b � �� op �7 � Ub X ! Ub !� V� !� W- "L Yb "� Zb " [b " \c %&n ~- &len ~- &ptr � "[ � %"�
�X � �b B ! �b !� �� !� �- %"� �� &n �M "L �M "� �M "Z �M "S �� "� �� "O �� ' "A �? &x �? &zx �M %"A �? &ch1 �� &ch2 �� (� 7 � } � )o 7 *�
7 ; *� C � +^ D �@* E � , W * T7 - - � 0 X ." v /9 I 0Uv 1
I 0Uv 1 -I < 0U} 0Tv /* KI 0U} 0Tv 2 [ j J� 3" ]/j I 0U} 1� hI � 0U0 1� �I � 0Uw 1 �I � 0Uv 0T| 0Q@ 4I �I 4y �I 5� � � � @" .� � .� 5 6� 7� � 7 � 7
, 8� 2} � � az! .� O ,` " 7 z 7$ � 70 � 7< _ 2} � � ��! .� � 9p � �! 7I /L �I 0Uv}0T @. /� J 0Uv 0Q} 0R
0X00Y00w 1 (� �7 � 8 & . )o �7 x *� �7 � *f
�7 � X ��" :hdr �� # :rt �v #[ � . # *� �. "
*< �. �
;s �b L ;seq �b � ;ret � � +g �� ��{+� �. 4 +� �c ��{*L �b � *� �b
*� �b �
<+ �b + �. ��|= � - � � ��# ." � /y I 0Us ,� t+ +�
� ��{>iov
� ��{+' � ��{*� b 0 ,0 1+ ;dst +� f ;gw ,� � *� -b " * .*. o *� .*. ;len /b H *� 0b ~ +g i@. 4 +� jE. �3 ,� �* +� qJ. ��}+� r� ��{* s� * t t *
u7 � *� v7 � *i w7 S *� x7 � *� x7 d - M ` ��% ." \ 4� I - W � ��% ." � /� I 0Uv -. r � �m( .X � .L T .@ � ?� @d @p ,� U( .X @ .L � .@ � ?� 7d K 7p � 2 < e ��& ." Y /` I 0U��z 2 A e ��& ." | /X I 0U��z 2 e � �' ." � /� I 0Uv 2� � � �V' .� � A � � �." � 4� I 2 ! ��' 3" V/ I 0Uv 2 ! 8 ��' ."
43 I 1 BJ �' 0Uv � 1 ZJ �' 0U��z0T��z 1< KI ( 0Tv 1 hI -( 0U1 /A wJ 0U��z0T��z0Q��z /w �J 0U��z , ") * �7 - - � P ��( ." � /� I 0Uv - � � ��( ." � /� I 0U 4� BJ /� wJ 0U��{0Tv 0Q - 0 � �Q) ." 4j I 2� � � ��) .� U A � � �." x /� I 0U 1� �J �) 0T��{ 1� �J �) 0T 0Q��{0R
1 I * 0Uv 1 I * 0U��{ 10 �J K* 0U30T��z0Qv 0R 4@ K 1U (K p* 0U| 1] =K �* 0Uw � /� �J 0U20T��z0Qv 9 0 �* *x HZ. � 4 VK 40 �I 1K dK + 0T �3 0Q@ /� dK 0T 4 0Q4 1� �K X+ 0Uw �0T��z0Q0 /� �K 0T N. - z � ��+ ." � /� I 0U��z 2 � � �+ ." � /� I 0U��z 2 � � �$, ."
/� I 0U��z 4� �K 4� �K 4� �K 1� �K v, 0U 0T F. 0Qs 1 L �, 0U��z0T F. 1& #L �, 0U��z 1C <L �, 0U@0T30Q0 1| ^L �, 0Uw �0Ts 0Q< 1� �L $- 0Uw �0Ts 0Q��{ 1 �L `- 0Uw �0T| 0QL0R00X 4 0Y< 1� (K x- 0U| 1� =K �- 0Uw � 4z �L 4� �I 1� (K �- 0U| 1� =K �- 0Uw � 4� �I /� (K 0U| � . B� �" � b *. � M ? @. � 0. � � Z. � � $ (\ �7 @ �& / �8 )o �7 � )T �7 � + � ��}*� �7 *a �b Q +^ � ��}* � , �7 +� J. ��}*� 7 � *� 7 g *� 7 ! *a 7 �! -^ � p /l0 .� D" .| �" .p 1# ,� W0 @� 7� z# 7� �# 7� 4$ 7� }$ 7� �$ @� C� ��},P �/ 7� �% 7
& 7 [& ,� 0 7 �& 7' ' 73 `' 1W$ �I :0 0U~ 0T h. /�$ �L 0U| 0T��} /�! � 0T ,� t6 * A7 �' 2� � � \�0 .� >( A � � �." �( /� I 0U} 2� � � ]=1 .� �( A � � �." ?) /� I 0U~ 2� �
! ^�1 .� b) A �
! �." �) /
! I 0Uv -. ! a 4 .X �) .L ** .@ l* ? @d @p ,@
4 .X �* .L <+ .@ e+ ?@ 7d �+ 7p 4, 2 T" p" �P2 ." - /g" I 0U| - �% � ��2 ." :- /=& I 0U| -� �% � ��2 .� p- D �% � �." �- 4O& I 2 & 0& �
3 ." �- /+& I 0U} - T& �C3 ." �- /�& I 0U| 2 [& s& �}3 ." 5. /n& I 0Uv 1(" BJ �3 0Uv
�� 17" ZJ �3 0Uw 0Tv 1T" KI �3 0T| 1�% hI �3 0U1 /& wJ 0Uw 0Tv 0Q} /! �J 0U| 2� �" �" D|4 .� X. A �" �" �." {. /�" I 0U} 2� �" �" E�4 .� �. A �" �" �." �. /�" I 0U~ 2� �" �" F45 .� �. A �" �" �." / /�" I 0Uv 2 �" (# Ho5 ." */ / # I 0Uw - �% P b�5 ." N/ /�& I 0Uw 1� �K �5 0U| 0T y. 4�! �K 1�! �K 6 0U| 0T l. 0Q} 1�! �K .6 0U| 0T q. 0Q~ 1" �K Y6 0U| 0T ~. 0Qv 4�" �K 4�% �I 9<! F! �6 "O - "� - 4F! M ,� H7 ;sin 8M �/ 9�" �" �6 ;__v :M �/ ;__x :M �/ D� �" � ;.� 0 D �" � �." _0 4}& I 1^! � `7 0T 1�! � x7 0T 1x" I �7 0U 1�$ I �7 0U /�$ I 0U - G% 0 �7 ." �0 /�& I 0Uw 2 �& �& �/8 ." �0 /�& I 0Uw 1p )M \8 0U�T0T �/ 0Q��} 4} �K 1� �I �8 0U��} 1G% �I �8 0U0 1y% �K �8 0T �/ 4�% �I 4�& �I E�
7 �& -. 1 iH *y
7 �1 ;m
7 �1 1' GM >9 0U �9 0T
� 4' �K 1*' jM u9 0Us 0T �. 0Q0 16' I �9 0U �. 1@' BJ �9 0U0 1N' wJ �9 0Uv 0Q| 1b' jM �9 0Us 0T �. 0Q1 1n' I : 0U �. 1{' BJ ): 0U1 1�' wJ G: 0Uv 0Q| 1�' jM q: 0Us 0T �. 0Q1 1�' I �: 0U �. 1�' BJ �: 0U1 1�' wJ �: 0Uv 0Q| 1�' jM �: 0Us 0T �. 0Q2 1�' I ; 0U �. 1�' BJ %; 0U2 1�' wJ C; 0Uv 0Q| 1( jM m; 0Us 0T �. 0Q3 1 ( I �; 0U �. 1,( BJ �; 0U3 1:( wJ �; 0Uv 0Q| 1N( jM �; 0Us 0T �. 0QF 1Z( I
< 0U �. 1g( BJ !< 0UF 1u( wJ ?< 0Uv 0Q| 1�( jM i< 0Us 0T �. 0Q< 1�( I �< 0U �. 1�( BJ �< 0U< 1�( wJ �< 0Uv 0Q| 1�( jM �< 0Us 0T �. 0Q5 1�( I = 0U �. 1�( BJ = 0U5 1�( wJ ;= 0Uv 0Q| 1�( jM e= 0Us 0T �. 0Q@ 1 ) I �= 0U �. 1) BJ �= 0U@ 1&) wJ �= 0Uv 0Q| 1:) jM �= 0Us 0T �. 0QA 1F) I > 0U �. 1S) BJ > 0UA 1a) wJ 7> 0Uv 0Q| 1u) jM a> 0Us 0T �. 0QA 1�) I �> 0U �. 1�) BJ �> 0UA 1�) wJ �> 0Uv 0Q| 1�) jM �> 0Us 0T �. 0Q4 1�) I �> 0U �. 1�) BJ ? 0U4 1�) wJ 3? 0Uv 0Q| 1�) jM ]? 0Us 0T �. 0Q: 1�) I |? 0U �. 1* BJ �? 0U: 1* wJ �? 0Uv 0Q| 1&* jM �? 0Us 0T �. 0Q= 12* I �? 0U �. 1?* BJ @ 0U= 1M* wJ /@ 0Uv 0Q| 1a* jM Y@ 0Us 0T / 0Q8 1m* I x@ 0U / 1z* BJ �@ 0U8 1�* wJ �@ 0Uv 0Q| 1�* jM �@ 0Us 0T / 0QD 1�* I �@ 0U / 1�* BJ
A 0UD 1�* wJ +A 0Uv 0Q| 1�* jM UA 0Us 0T / 0QG 1�* I tA 0U / 1�* BJ �A 0UG 1�* wJ �A 0Uv 0Q| 1+ jM �A 0Us 0T "/ 0Q6 1 + I �A 0U "/ 1++ BJ B 0U6 19+ wJ 'B 0Uv 0Q| 1M+ jM QB 0Us 0T ,/ 0Q7 1Y+ I pB 0U ,/ 1f+ BJ �B 0U7 1t+ wJ �B 0Uv 0Q| 1�+ jM �B 0Us 0T 6/ 0Q9 1�+ I �B 0U 6/ 1�+ BJ C 0U9 1�+ wJ #C 0Uv 0Q| 1�+ jM MC 0Us 0T =/ 0Q; 1�+ I lC 0U =/ 1�+ BJ �C 0U; 1�+ wJ �C 0Uv 0Q| 1�+ jM �C 0Us 0T E/ 0Q> 1
, I �C 0U E/ 1, BJ D 0U> 1%, wJ D 0Uv 0Q| 19, jM ID 0Us 0T Q/ 0Q? 1E, I hD 0U Q/ 1R, BJ D 0U? 1`, wJ �D 0Uv 0Q| 1t, jM �D 0Us 0T X/ 0Q@ 1�, I �D 0U X/ 1�, BJ �D 0U@ 1�, wJ E 0Uv 0Q| 1�, jM EE 0Us 0T c/ 0QB 1�, I dE 0U c/ 1�, BJ {E 0UB 1�, wJ �E 0Uv 0Q| 1�, jM �E 0Us 0T j/ 0QC 1�, I �E 0U j/ 1- BJ �E 0UC 1- wJ F 0Uv 0Q| 1%- jM AF 0Us 0T �. 0QF 11- I `F 0U �. 1>- BJ wF 0UF 1L- wJ �F 0Uv 0Q| 1`- jM �F 0Us 0T t/ 0QH 1l- I �F 0U t/ 1y- BJ �F 0UH 1�- wJ G 0Uv 0Q| 1�- jM =G 0Us 0T }/ 0QI 1�- I \G 0U }/ 1�- BJ sG 0UI 1�- wJ �G 0Uv 0Q| 1�- jM �G 0Us 0T �/ 0QO 1�- I �G 0U �/ 1�- BJ �G 0UO 1�- wJ H 0Uv 0Q| 1. �M :H 0Us 0T �/ 0Qv /%. �M 0Us 0T �/ 0Q �/ [ yH � + � iH : +!
� �9 F� �� F2 �� F} � Fh � FF � F� !W7 F� !s7 GV �I 7 H� "�7 -I IC #�b KI 7 7 H
$"b hI 7 7 H� $ 7 �I � Hv Cb �I �I HO %fb �I - JX F�I H� !�7 �I 7 I{ Ob J � K I &�b BJ � c � c � c M HF
'7 ZJ i H� (7 wJ 7 7 H� (b �J 7 7 7 I� #� �J 7 H �� �J M � H )A �J b \ � c H�
*#7 K � K I1 b (K 7 G� +[=K � II @b VK b L� ,+ HE %>b �K \ \ - H7 � �K b �K b � JI !
�K 7 MI �b Ly (7 H� (:b L 7 7 H� (97 #L 7 IZ +M� <L - H; db ^L b b b H� nb �L b � c H� rb �L b O �L c HS
� �L b \ - b � c LZ !�7 N� � M � \ � O . b )M H� -(b GM 7 K H� -�7 dM dM b � H� -�b �M 7 i H -�b �M 7 7 Pg -�b 7 % : ; I $ > $ > I : ;
: ;I8
& I
' I : ;
: ;
: ; I8
I ! I/ & : ; : ; ' I
: ; I8
: ; < ' I : ; (
: ; : ;
: ; I .: ;' : ;I .: ;' I ! : ;I "4 : ;I #.: ; ' I $ : ; I % &4 : ;I ' (.: ;' I@�B ) : ;I *4 : ;I +4 : ;I
, U - 1RUX Y . 1 /��1 0��
�B
1��1 2 1X Y 3 1
4�� 1 5.1@�B 64 1 74 1 8 1 9 :
: ;I8
;4 : ;I <4 : ;I =
: ; >4 : ;I
? U @4 1 A 1X Y B! I C4 1
D 1RUX Y E.? : ;' I@�B F4 : ; I? < G.? : ;' < H.? : ; ' I< I.? : ;' I< J.? : ; ' < K L. ? : ; ' I< M. ? : ;' I< N.? ' I4 < O.? : ; �@' I< P.? : ; ' I< 9 � �
/opt/_internal/cpython-3.9.5/include/python3.9 /opt/rh/devtoolset-2/root/usr/lib/gcc/x86_64-CentOS-linux/4.8.2/include /usr/include/bits /usr/include /usr/include/sys /opt/_internal/cpython-3.9.5/include/python3.9/cpython /usr/include/linux /usr/include/netax25 /usr/include/netinet /usr/include/netipx /usr/include/net /usr/include/asm-x86_64 /usr/include/netpacket /usr/include/arpa netifaces.c object.h stddef.h types.h libio.h types.h unistd.h stdint.h pyport.h object.h methodobject.h descrobject.h longintrepr.h listobject.h moduleobject.h uio.h sockaddr.h socket.h atalk.h ax25.h in.h ipx.h
socket.h if.h types.h types.h netlink.h rtnetlink.h packet.h
ifaddrs.h stdio.h boolobject.h pyerrors.h unicodeobject.h abstract.h listobject.h string.h netdb.h longobject.h dictobject.h inet.h tupleobject.h stdlib.h errno.h modsupport.h <built-in> � �
;.E.8��Z:>�t��xt�tvJ�� X=�d>��x�|�.jX� <���xJ|����xt ��~��<
�O�~J��xJ JwJ.�:Z�/IW]'_�YN������}X��^}]SA��Ys=�u��
�Z�:>l,> fTxTY�:� ȫ��7]ytZkw�!�g��� 8��. Xt��e� =Z�
��)�~� � � � �
�ZHLHLk �;M-Yf;0(� �Pn� X �K�MKy�K�Y� �I
�":>iZ� X�u���W=Z�:YX)<�t � J � �vf� �Y�V>�s�� ֓��~��X �z.[5��t�� ���~��.�o � ��t�� ����u�� ��v֑"� ��}���
��uX�
.�u.��
$�u���
X���wt�;=���=�}��xJ� �X�� �����
�u�|�
X��u�|x ��JXr��T��Z:L�f&�{��X�.�{X���{��X|� ��Xn� ��X|���|J�<�|<��wX� � � �U<+<��{J� ��<�|<�X�Ot1.�
�Z:>
fY!Y"�K;i�|��I=�� ��}������{.�X��3Z:>�{f�X|� ��Xn� ��X|x��
<ɆZKL�h�_WY;=v�Wb."�+[g��Cy�h���Y��m��CZB��U�{t>m�*5�L�Y��zt���0�~X���y�� t�X�&��|J�;=4K�=�}X�x1(���z.x(|����{t� ���
.v�
.Y;=jZ�>Y$='='='=,'='='='='='='='='='='=''= '='='='='='='='='='='='='='([ RTA_DST rtm_family RTM_NEWADDR _unused2 __RTM_MAX RTM_GETROUTE _fileno lenfunc __s1_len freeifaddrs sockaddr_iso add_to_family __sockaddr_un__ PyDict_GetItemString tp_getattr sq_item RTM_NEWACTION nb_add ob_refcnt msg_name sq_ass_item rtm_dst_len sq_inplace_repeat tp_as_async nb_matrix_multiply nb_lshift sq_inplace_concat tp_is_gc _shortbuf nb_power sockaddr_in sa_family_t s_node inet_ntop am_anext IFF_PROMISC __CONST_SOCKADDR_ARG RTM_NEWADDRLABEL PyInit_netifaces sq_repeat tp_itemsize sq_concat uint16_t initproc sin_zero in_port_t PyGetSetDef RT_TABLE_MAIN tp_bases __off_t memcmp zeroes ifu_dstaddr IFF_BROADCAST RTM_SETLINK address_family_dict string_from_netmask _lock PyModule_Create2 netifaces.c nb_negative setattrofunc sockaddr_ll tp_dealloc msg_namelen IFF_AUTOMEDIA _typeobject nb_floor_divide nb_inplace_lshift sa_family RTA_FLOW pfxbuf _Py_Dealloc MSG_PEEK sockaddr_nl MSG_CTRUNC MSG_NOSIGNAL memcpy sin6 sockaddr_ns priority nl_pid RTA_SESSION nb_index tp_richcompare MSG_DONTWAIT rtm_protocol m_free sll_family _IO_write_end nb_remainder RTA_PROTOINFO visitproc s_addr byte _Py_TrueStruct sat_zero RTA_CACHEINFO nb_inplace_multiply msg_control braddr ax25_address was_sq_slice PyMemberDef PyExc_OSError gateways ob_type _Py_XDECREF tp_free sin_family getter PyModuleDef PyVarObject __sockaddr__ MSG_RST nb_and SOCK_RAW __u8 tp_call ob_item RTM_NEWQDISC tp_str was_sq_ass_slice ternaryfunc sin_port RTM_GETQDISC ob_base PyTypeObject sa_data RTM_DELACTION RTA_TABLE PyModule_AddIntConstant string_from_sockaddr sq_contains /tmp/pip-req-build-fl52pudd __sockaddr_in__ _chain tp_setattr PySequence_Contains ifa_data SOCK_RDM isdefault sockaddr_un richcmpfunc unsigned char mp_ass_subscript RTM_DELTFILTER SOCK_DGRAM __sockaddr_inarp__ getsockname _IO_lock_t ifndx __RTA_MAX tp_dictoffset IFF_POINTOPOINT PyNumberMethods msg_iovlen PyMethodDef tp_finalize strncmp m_init u_int16_t rta_type mp_subscript tp_clear _Py_DECREF rtm_flags PyModuleDef_Base __sockaddr_eon__ nb_bool IFF_NOTRAILERS sat_port RTM_DELNEIGH tp_init objobjargproc ob_size MSG_PROXY attrs tp_dict moduledef interrupted recvmsg _IO_write_ptr tp_as_mapping u6_addr8 setattrfunc nlmsg_flags RTA_IIF MSG_WAITALL u_int8_t binaryfunc __s2_len __errno_location m_doc interfaces IFF_ALLMULTI bf_getbuffer vectorcallfunc getiterfunc gniaddr ssizeargfunc error sll_addr uint8_t descrsetfunc rtm_src_len descrgetfunc __sockaddr_ipx__ sanl nb_inplace_add sprintf nb_reserved deftuple _IO_save_base iovec MSG_SYN m_index IFF_NOARP reprfunc sockaddr_x25 sin6_flowinfo __pad2 RTM_GETTFILTER rtmsg PyList_Append rtm_type RTA_PREFSRC sax25_ndigis RT_TABLE_UNSPEC PyLong_FromLong Py_hash_t value defaults RTA_SRC PyObject nb_xor __SOCKADDR_ARG __socklen_t lladdr RTA_GATEWAY RTM_SETNEIGHTBL slot __ssize_t sanl_from _longobject IFF_MULTICAST sipx_node s_net m_traverse sin6_addr PyBufferProcs ml_flags tp_new IFF_UP m_name getpagesize RTA_METRICS found PyModuleDef_Slot nb_inplace_true_divide PyObject_Size destructor PyCFunction rtm_tos sanl_kernel result buflen msg_iov _sbuf bind MSG_DONTROUTE _IO_save_end ifa_next sipx_zero tp_del nlmsg_len sipx_type stdout tp_name rtm_scope closure nlmsg_pid ifa_flags PyModule_AddStringConstant RTM_GETMULTICAST tp_as_sequence RTM_GETLINK tp_as_buffer sizetype nllen nb_inplace_and sll_hatype short unsigned int rt_class_t __be16 rtm_table SOCK_STREAM RTM_GETRULE rtattr tp_alloc RTM_NEWNEIGH suboffsets sendto __off64_t msg_controllen sockaddr_eon _IO_read_base m_clear IFF_SLAVE __u16 PyTuple_Pack __sockaddr_iso__ _IO_buf_end IFF_DEBUG RTM_GETADDR tp_getattro allocfunc m_copy _mode tp_methods _IO_write_base __sockaddr_ax25__ tp_mro msgbuf __u32 close in6_u SOCK_PACKET nb_or ipv4_default format unaryfunc _IO_marker PyDict_SetItem RTM_GETNEIGH RT_TABLE_DEFAULT ifa_ifu nb_float PyDict_GetItem __sockaddr_dl__ u6_addr16 PyExc_ValueError traverseproc RTM_NEWPREFIX RTM_DELADDRLABEL tp_vectorcall_offset inquiry uint32_t nb_invert ml_doc __sockaddr_in6__ ml_name __sockaddr_ns__ sipx_port atalk_addr tp_as_number iov_len PyAsyncMethods tp_weaklistoffset PyDict_SetItemString ml_meth readonly tp_doc getattrofunc pyfamily SOCK_SEQPACKET PyObject_IsTrue RTA_MP_ALGO sockaddr_inarp sin6_scope_id PySequenceMethods rtattr_type_t stdin sin_addr is_multi u6_addr32 tp_weaklist prev_name _IO_buf_base bufferinfo newfunc hashfunc getattrfunc _IO_read_end sipx_network _IO_FILE PyModule_AddObject in_addr_t IFF_PORTSEL nlmsgerr RTM_GETTCLASS PyErr_NoMemory shape self tp_hash nl_groups pmsg PyUnicode_FromString ndim ssizeobjargproc sat_family tp_vectorcall RTM_NEWTFILTER tp_version_tag sockaddr_ax25 ipv6_default __builtin_strcmp getnameinfo RTM_GETANYCAST __pad1 __pad3 __pad4 __pad5 nlmsg_type malloc getbufferproc nlmsg_seq PyDict_New RTM_DELROUTE failure _markers _pos setter am_await PyList_New RTM_BASE tp_members tp_traverse PyErr_SetFromErrno bufend mp_length sat_addr def_priorities double nlmsghdr am_aiter nb_inplace_xor tp_subclasses args nb_inplace_power tp_setattro nl_family freefunc nb_multiply m_base nb_true_divide tp_getset rta_len bufsize ifa_netmask tp_iternext sq_length IFF_MASTER RTM_NEWTCLASS RTM_NEWNEIGHTBL tp_descr_get sll_halen tp_iter sipx_family socket nb_inplace_floor_divide bytes strides ifa_addr MSG_OOB tp_base nb_rshift sin6_family sll_pkttype __sockaddr_x25__ ifnamebuf bf_releasebuffer RTM_GETNEIGHTBL long long unsigned int _cur_column releasebufferproc sax25_call u_int32_t nb_inplace_remainder __socket_type bigaddr MSG_ERRQUEUE MSG_CONFIRM MSG_MORE getifaddrs m_slots _object MSG_FIN MSG_EOR nb_absolute _IO_backup_base _IO_read_ptr PyListObject internal RTA_MULTIPATH sanl_len nb_inplace_or m_methods m_size tp_repr tp_cache sax25_family sll_protocol Py_ssize_t _old_offset routing_msg nb_inplace_rshift RTA_PRIORITY pyaddr RTA_OIF PyArg_ParseTuple nb_positive RT_TABLE_LOCAL long long int _flags2 PyMappingMethods prefix sockaddr_at ifu_broadaddr gnilen sockaddr_in6 allocated tp_flags RTA_UNSPEC IFF_LOOPBACK RTM_GETACTION bufptr ob_digit iov_base nb_subtract perr PyType_Type GNU C 4.8.2 20140120 (Red Hat 4.8.2-15) -mtune=generic -march=x86-64 -g -O3 -fwrapv -fPIC MSG_TRYHARD RT_TABLE_MAX RTM_DELLINK if_indextoname ifa_name IFF_DYNAMIC RTM_DELQDISC __sockaddr_at__ PyErr_SetString IFF_RUNNING RTM_NEWLINK py_family iternextfunc sockaddr_dl RTM_GETADDRLABEL RTM_DELRULE nb_int MSG_TRUNC af_to_len sockaddr_ipx tp_descr_set Py_buffer RTM_GETPREFIX RTM_NEWRULE pyifname short int _vtable_offset nb_inplace_matrix_multiply tp_basicsize nb_inplace_subtract _Py_FalseStruct sll_ifindex RTM_DELADDR nb_divmod objobjproc nl_pad RTM_NEWROUTE sin6_port RTM_DELTCLASS w w w w w( � w� � � w(� � w � � w� � w� � w� � w� U � �U� # P# � ]� � ] > 0�> � \� � 0� 0 0�0 � S� � S� � 0� > K V� � P� � V > K V� � V � � w� � w� � w� � w � � w(� � w0� � w� � � w0� � w(� � w � � w� � w� � w� � w� � F UF � V� � �U�� � V � T � ]� � �T�� � ]� � �T� K S P . J UJ � V� � �U�� � V . J T ; u �
��� � � 0� o � \� � \ � � ]� � V� � U� � v}�� � V� � } ~ "1 � } � S� � S S \ p
���\ _ Q_ � p
���� � p
��� � � V w w w w w( w0 w8 � w�� � w8� � w0� � w(� � w � � w� � w� � w� �
w� U �
�U� L P PP � _� � ��z� � _� � ��z� _ , ��z, p _p 4
��z4
s
_s
�
��z [ e Pe � S� � P� � ��{� � S� �
��{ � \W } \} . SP � S� S1 � S , Sp 4
Ss
�
S � � P� � \� � \� � P� �
\ � � P� � w � � w 4
w 4
?
P?
S
w s
�
w ^ 0�^ � 1�� � 0�� � 1�� 0� , 1�p 4
1�4
s
0�s
�
1� @ } P P 7 P 0 � V� � ��z� � V� � ��z� V , ��z, p Vp � ��z4
s
Vs
�
��z 0 � 0�� � ]� 9 ]P � ]� � 0�� � ]� 0� , ], p 0�p 4
]4
s
0�s
�
] f � S� � S� S4
s
S W } P� � ^ � 0� W UY � UP j U� � 0� � 0�t v _� � 0� � ��d f Y� � �� � . s �P � s �� s �1 � s � , s �p 4
s �s
�
s � � � QP \ Q � � RP j R � ��@ [ x $0 $+( �[ � ��z� $0 $+( �
��z� $0 $+( � P � V� � V
V ! D P� � P � � P� � V1 j V � � P� � T� � ��z1 � ��z @ � _� � U
_ � � 0�� � P� � ��z� � 0�
0�1 � ��zp � ��z� 4
��zs
�
��z � � 0�� & _� � 0��
_
0�1 K _K e 0�e j Pj � _ , _p 4
_s
�
_ � � Y> E Y � � V1 > V � � U� � ��zj � ��zp � ��z� 4
��zs
�
��z � � p ��� � v ��j � v ��p � v ��s
x
v �� � � ��zj � ��zp 4
��zs
�
��z j � ��zp � ��z� 4
��zs
�
��z j � v ��p � v ��s
x
v �� j � ��zp 4
��zs
�
��z s � P� � ��zp z ��z�
��z � � Pp ~ P� � P� � R� � ��z� � P� � ��zs
�
P � � V � � ��z �
V �
P �
P �
�
X P & V�
V , V & V�
V , V & _�
_ � � ��z� � U� � ��z
4
_
4
_ � � s� � ��z ; p ��z G
s
��z �
�
w�
�
w�
�
w�
�
w �
�
w(�
�
w0�
�
w8�
� w�� � w8� � w0� � w(� � w � w w w ] w� �
�
U�
] �U� �
�
T�
�
U�
] �T� �
P � w ] w �
- 0�- � 1�� � V� � 1�� � 0� V 1� F 0�U ] 1� �
0� � S S F 0�F ] S - � ]� � 0�� 2 ]2 C 0�C H PH � ] 6 ]^ p ]� � ]� � ]U ] ] - � ^� � 0�� �
^�
- 0�- 2 P2 � 0� ^U ] 0� - > Q> � V� 0� � V� � 0�� � P� �
V�
� 0�� � V� � UU ] 0� - � 0� 0�U ] 0� - �
�� 2
�H �
�
�U ]
� - � _� 2 _H � _ _U ] _ � � U�
UH q U �
X 0� G P� � PH n Xn q 0� �
YH n Y �
� Qn � QU ] Q y 1$� � Yn � YU ] Y _ : \: C |�C \ � X� � |�� " \n q _q � \� � |�� � PU ] X �
�
QH n Q �
�
Q�
�
r q ��
�
R �
�
8��
�
7��
�
T�
�
P�
�
p�H n P X' f X 5 TX � TU ] T G Rj � RU ] R - � \+ G PG � \)
B
PB
�
\ � \� \ ? � ]� � ] 6 ]^ p ]� � ] D S ] S � ^� � ^ R ^^ � ^� ^ X f ^ f � V k z V � � U� � \� � \ R \^ � \� \ � � v
���� � v
��� � � w � � w R w ^ � w � w � � \ R \^ � \� \ � � v
��� � � w R w ^ � w � w � � P� � V R V^ � V� V � � P ' P^ i Pp v Pv � ]� � P� � ��}� � P� � ]� � P� ] � � \ 6 \� � \ ' 6 P� � P , 6 P� � P � � ] � � \� \ � � V /
�
] 4
C
] C
�
^ H
V
^ V
�
V [
j
V j
�
w 6 R w
Q
w � � P �
P � � p� � P
V� � V� � U
V� � V� � U � � w F M QM U w F w ` b wb o wo p wp � w � � w� � w� � w � � P� � V { � P� � S� � P @ K u � @ G � � O � � � f p � � � 0 P � � � , p 8
x
�
� � � � � 0 P � � 1 � , p 8
x
�
� � � 0 � � � 1 � , p 8
x
�
� � > K � � 1 > � � j � p
x
�
� 0 �
, , 0 �
� � � � � � � ! � � � U ] & 0 � � � � �
" P � U ] & 0 �
" P � U ] �
�
P [ � U ] 0 � �
�
� � ~ � � � � � 6 ` � � ' � � ' 6 � � , 6 � � � � � 6 R �
� �
� � � �
� � � � � � F U .symtab .strtab .shstrtab .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .text .fini .rodata .eh_frame_hdr .eh_frame .init_array .fini_array .jcr .data.rel.ro .dynamic .got .got.plt .data .bss .comment .debug_aranges .debug_info .debug_abbrev .debug_line .debug_str .debug_loc .debug_ranges � � $ . ���o � � < 8 � � � @ � � 9 H ���o �
�
v U ���o 0 0 P d � � ( n �
�
x � � s � � � ~ � � � � 0. 0. � @. @. � � 4 4 < � P4 P4 � � �5 �5 � �5 �5 � 6 6 � 6 6 � 6 6 � � �7 �7 H � (8 (8 p � �9 �9 � �: �: � �: � � ); 0 Y; �M &� * ( P� = 4 0 �� � ? ^� 22 J �� ` �� X H� @ # ? � � � � � � �
0 � �
�
� � 0.
@. 4 P4 �5 �5 6 6 6 �7 (8 �9 �: � � * � 5 6 B � W � j � �: � �5 � P � �5 � � � � � � �
�3 $ # � � ,
4 >
�3 Q
4 d @ � l �9 h v : � * � ~ �5 � 6 � � 6 � 6 � �: � (8 � � � 1 O d � � �: � � �& = � � 0. � � � ( A Q e t � � � � � � � � 5 �: : J [ w � �: � � � � � � 2 A Z s � � " � � � � /usr/lib/../lib64/crti.o call_gmon_start crtstuff.c __JCR_LIST__ deregister_tm_clones register_tm_clones __do_global_dtors_aux completed.6330 __do_global_dtors_aux_fini_array_entry frame_dummy __frame_dummy_init_array_entry netifaces.c interfaces string_from_sockaddr.constprop.2 CSWTCH.22 gateways sanl_kernel.13636 ipv6_default.13667 ipv4_default.13666 ifaddrs moduledef methods __FRAME_END__ __JCR_END__ __dso_handle _DYNAMIC __TMC_END__ _GLOBAL_OFFSET_TABLE_ inet_ntop@@GLIBC_2.2.5 PyList_New PyDict_SetItemString free@@GLIBC_2.2.5 PyModule_AddIntConstant __errno_location@@GLIBC_2.2.5 strncmp@@GLIBC_2.2.5 _ITM_deregisterTMCloneTable PyErr_SetFromErrno _edata _Py_Dealloc PyInit_netifaces PyErr_NoMemory _fini PyErr_SetString PyExc_ValueError PySequence_Contains sendto@@GLIBC_2.2.5 close@@GLIBC_2.2.5 getnameinfo@@GLIBC_2.2.5 PyLong_FromLong memcmp@@GLIBC_2.2.5 PyDict_GetItem memcpy@@GLIBC_2.2.5 PyList_Append strcmp@@GLIBC_2.2.5 PyExc_OSError _Py_FalseStruct __gmon_start__ PyModule_Create2 PyDict_GetItemString PyObject_Size malloc@@GLIBC_2.2.5 getifaddrs@@GLIBC_2.3 _end PyObject_IsTrue PyArg_ParseTuple if_indextoname@@GLIBC_2.2.5 _Py_TrueStruct __bss_start recvmsg@@GLIBC_2.2.5 freeifaddrs@@GLIBC_2.3 PyDict_New bind@@GLIBC_2.2.5 PyUnicode_FromString PyModule_AddStringConstant PyModule_AddObject _Jv_RegisterClasses PyDict_SetItem getsockname@@GLIBC_2.2.5 getpagesize@@GLIBC_2.2.5 sprintf@@GLIBC_2.2.5 _ITM_registerTMCloneTable __cxa_finalize@@GLIBC_2.2.5 _init PyTuple_Pack socket@@GLIBC_2.2.5 PK ok\��; �; psutil/_compat.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Module which provides compatibility with older Python versions.
This is more future-compatible rather than the opposite (prefer latest
Python 3 way of doing things).
"""
import collections
import contextlib
import errno
import functools
import os
import sys
import types
# fmt: off
__all__ = [
# constants
"PY3",
# builtins
"long", "range", "super", "unicode", "basestring",
# literals
"b",
# collections module
"lru_cache",
# shutil module
"which", "get_terminal_size",
# contextlib module
"redirect_stderr",
# python 3 exceptions
"FileNotFoundError", "PermissionError", "ProcessLookupError",
"InterruptedError", "ChildProcessError", "FileExistsError",
]
# fmt: on
PY3 = sys.version_info[0] >= 3
_SENTINEL = object()
if PY3:
long = int
xrange = range
unicode = str
basestring = str
range = range
def b(s):
return s.encode("latin-1")
else:
long = long
range = xrange
unicode = unicode
basestring = basestring
def b(s):
return s
# --- builtins
# Python 3 super().
# Taken from "future" package.
# Credit: Ryan Kelly
if PY3:
super = super
else:
_builtin_super = super
def super(type_=_SENTINEL, type_or_obj=_SENTINEL, framedepth=1):
"""Like Python 3 builtin super(). If called without any arguments
it attempts to infer them at runtime.
"""
if type_ is _SENTINEL:
f = sys._getframe(framedepth)
try:
# Get the function's first positional argument.
type_or_obj = f.f_locals[f.f_code.co_varnames[0]]
except (IndexError, KeyError):
msg = 'super() used in a function with no args'
raise RuntimeError(msg)
try:
# Get the MRO so we can crawl it.
mro = type_or_obj.__mro__
except (AttributeError, RuntimeError):
try:
mro = type_or_obj.__class__.__mro__
except AttributeError:
msg = 'super() used in a non-newstyle class'
raise RuntimeError(msg)
for type_ in mro:
# Find the class that owns the currently-executing method.
for meth in type_.__dict__.values():
# Drill down through any wrappers to the underlying func.
# This handles e.g. classmethod() and staticmethod().
try:
while not isinstance(meth, types.FunctionType):
if isinstance(meth, property):
# Calling __get__ on the property will invoke
# user code which might throw exceptions or
# have side effects
meth = meth.fget
else:
try:
meth = meth.__func__
except AttributeError:
meth = meth.__get__(type_or_obj, type_)
except (AttributeError, TypeError):
continue
if meth.func_code is f.f_code:
break # found
else:
# Not found. Move onto the next class in MRO.
continue
break # found
else:
msg = 'super() called outside a method'
raise RuntimeError(msg)
# Dispatch to builtin super().
if type_or_obj is not _SENTINEL:
return _builtin_super(type_, type_or_obj)
return _builtin_super(type_)
# --- exceptions
if PY3:
FileNotFoundError = FileNotFoundError # NOQA
PermissionError = PermissionError # NOQA
ProcessLookupError = ProcessLookupError # NOQA
InterruptedError = InterruptedError # NOQA
ChildProcessError = ChildProcessError # NOQA
FileExistsError = FileExistsError # NOQA
else:
# https://github.com/PythonCharmers/python-future/blob/exceptions/
# src/future/types/exceptions/pep3151.py
import platform
def _instance_checking_exception(base_exception=Exception):
def wrapped(instance_checker):
class TemporaryClass(base_exception):
def __init__(self, *args, **kwargs):
if len(args) == 1 and isinstance(args[0], TemporaryClass):
unwrap_me = args[0]
for attr in dir(unwrap_me):
if not attr.startswith('__'):
setattr(self, attr, getattr(unwrap_me, attr))
else:
super(TemporaryClass, self).__init__( # noqa
*args, **kwargs
)
class __metaclass__(type):
def __instancecheck__(cls, inst):
return instance_checker(inst)
def __subclasscheck__(cls, classinfo):
value = sys.exc_info()[1]
return isinstance(value, cls)
TemporaryClass.__name__ = instance_checker.__name__
TemporaryClass.__doc__ = instance_checker.__doc__
return TemporaryClass
return wrapped
@_instance_checking_exception(EnvironmentError)
def FileNotFoundError(inst):
return getattr(inst, 'errno', _SENTINEL) == errno.ENOENT
@_instance_checking_exception(EnvironmentError)
def ProcessLookupError(inst):
return getattr(inst, 'errno', _SENTINEL) == errno.ESRCH
@_instance_checking_exception(EnvironmentError)
def PermissionError(inst):
return getattr(inst, 'errno', _SENTINEL) in (errno.EACCES, errno.EPERM)
@_instance_checking_exception(EnvironmentError)
def InterruptedError(inst):
return getattr(inst, 'errno', _SENTINEL) == errno.EINTR
@_instance_checking_exception(EnvironmentError)
def ChildProcessError(inst):
return getattr(inst, 'errno', _SENTINEL) == errno.ECHILD
@_instance_checking_exception(EnvironmentError)
def FileExistsError(inst):
return getattr(inst, 'errno', _SENTINEL) == errno.EEXIST
if platform.python_implementation() != "CPython":
try:
raise OSError(errno.EEXIST, "perm")
except FileExistsError:
pass
except OSError:
msg = (
"broken or incompatible Python implementation, see: "
"https://github.com/giampaolo/psutil/issues/1659"
)
raise RuntimeError(msg)
# --- stdlib additions
# py 3.2 functools.lru_cache
# Taken from: http://code.activestate.com/recipes/578078
# Credit: Raymond Hettinger
try:
from functools import lru_cache
except ImportError:
try:
from threading import RLock
except ImportError:
from dummy_threading import RLock
_CacheInfo = collections.namedtuple(
"CacheInfo", ["hits", "misses", "maxsize", "currsize"]
)
class _HashedSeq(list):
__slots__ = ('hashvalue',)
def __init__(self, tup, hash=hash):
self[:] = tup
self.hashvalue = hash(tup)
def __hash__(self):
return self.hashvalue
def _make_key(
args,
kwds,
typed,
kwd_mark=(_SENTINEL,),
fasttypes=set((int, str, frozenset, type(None))), # noqa
sorted=sorted,
tuple=tuple,
type=type,
len=len,
):
key = args
if kwds:
sorted_items = sorted(kwds.items())
key += kwd_mark
for item in sorted_items:
key += item
if typed:
key += tuple(type(v) for v in args)
if kwds:
key += tuple(type(v) for k, v in sorted_items)
elif len(key) == 1 and type(key[0]) in fasttypes:
return key[0]
return _HashedSeq(key)
def lru_cache(maxsize=100, typed=False):
"""Least-recently-used cache decorator, see:
http://docs.python.org/3/library/functools.html#functools.lru_cache.
"""
def decorating_function(user_function):
cache = {}
stats = [0, 0]
HITS, MISSES = 0, 1
make_key = _make_key
cache_get = cache.get
_len = len
lock = RLock()
root = []
root[:] = [root, root, None, None]
nonlocal_root = [root]
PREV, NEXT, KEY, RESULT = 0, 1, 2, 3
if maxsize == 0:
def wrapper(*args, **kwds):
result = user_function(*args, **kwds)
stats[MISSES] += 1
return result
elif maxsize is None:
def wrapper(*args, **kwds):
key = make_key(args, kwds, typed)
result = cache_get(key, root)
if result is not root:
stats[HITS] += 1
return result
result = user_function(*args, **kwds)
cache[key] = result
stats[MISSES] += 1
return result
else:
def wrapper(*args, **kwds):
if kwds or typed:
key = make_key(args, kwds, typed)
else:
key = args
lock.acquire()
try:
link = cache_get(key)
if link is not None:
(root,) = nonlocal_root
link_prev, link_next, key, result = link
link_prev[NEXT] = link_next
link_next[PREV] = link_prev
last = root[PREV]
last[NEXT] = root[PREV] = link
link[PREV] = last
link[NEXT] = root
stats[HITS] += 1
return result
finally:
lock.release()
result = user_function(*args, **kwds)
lock.acquire()
try:
(root,) = nonlocal_root
if key in cache:
pass
elif _len(cache) >= maxsize:
oldroot = root
oldroot[KEY] = key
oldroot[RESULT] = result
root = nonlocal_root[0] = oldroot[NEXT]
oldkey = root[KEY]
root[KEY] = root[RESULT] = None
del cache[oldkey]
cache[key] = oldroot
else:
last = root[PREV]
link = [last, root, key, result]
last[NEXT] = root[PREV] = cache[key] = link
stats[MISSES] += 1
finally:
lock.release()
return result
def cache_info():
"""Report cache statistics."""
lock.acquire()
try:
return _CacheInfo(
stats[HITS], stats[MISSES], maxsize, len(cache)
)
finally:
lock.release()
def cache_clear():
"""Clear the cache and cache statistics."""
lock.acquire()
try:
cache.clear()
root = nonlocal_root[0]
root[:] = [root, root, None, None]
stats[:] = [0, 0]
finally:
lock.release()
wrapper.__wrapped__ = user_function
wrapper.cache_info = cache_info
wrapper.cache_clear = cache_clear
return functools.update_wrapper(wrapper, user_function)
return decorating_function
# python 3.3
try:
from shutil import which
except ImportError:
def which(cmd, mode=os.F_OK | os.X_OK, path=None):
"""Given a command, mode, and a PATH string, return the path which
conforms to the given mode on the PATH, or None if there is no such
file.
`mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
of os.environ.get("PATH"), or can be overridden with a custom search
path.
"""
def _access_check(fn, mode):
return (
os.path.exists(fn)
and os.access(fn, mode)
and not os.path.isdir(fn)
)
if os.path.dirname(cmd):
if _access_check(cmd, mode):
return cmd
return None
if path is None:
path = os.environ.get("PATH", os.defpath)
if not path:
return None
path = path.split(os.pathsep)
if sys.platform == "win32":
if os.curdir not in path:
path.insert(0, os.curdir)
pathext = os.environ.get("PATHEXT", "").split(os.pathsep)
if any(cmd.lower().endswith(ext.lower()) for ext in pathext):
files = [cmd]
else:
files = [cmd + ext for ext in pathext]
else:
files = [cmd]
seen = set()
for dir in path:
normdir = os.path.normcase(dir)
if normdir not in seen:
seen.add(normdir)
for thefile in files:
name = os.path.join(dir, thefile)
if _access_check(name, mode):
return name
return None
# python 3.3
try:
from shutil import get_terminal_size
except ImportError:
def get_terminal_size(fallback=(80, 24)):
try:
import fcntl
import struct
import termios
except ImportError:
return fallback
else:
try:
# This should work on Linux.
res = struct.unpack(
'hh', fcntl.ioctl(1, termios.TIOCGWINSZ, '1234')
)
return (res[1], res[0])
except Exception: # noqa: BLE001
return fallback
# python 3.3
try:
from subprocess import TimeoutExpired as SubprocessTimeoutExpired
except ImportError:
class SubprocessTimeoutExpired(Exception):
pass
# python 3.5
try:
from contextlib import redirect_stderr
except ImportError:
@contextlib.contextmanager
def redirect_stderr(new_target):
original = sys.stderr
try:
sys.stderr = new_target
yield new_target
finally:
sys.stderr = original
PK ok\͔���� �� psutil/tests/test_misc.pynu �[��� #!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Miscellaneous tests."""
import ast
import collections
import errno
import json
import os
import pickle
import socket
import stat
import sys
import psutil
import psutil.tests
from psutil import POSIX
from psutil import WINDOWS
from psutil._common import bcat
from psutil._common import cat
from psutil._common import debug
from psutil._common import isfile_strict
from psutil._common import memoize
from psutil._common import memoize_when_activated
from psutil._common import parse_environ_block
from psutil._common import supports_ipv6
from psutil._common import wrap_numbers
from psutil._compat import PY3
from psutil._compat import FileNotFoundError
from psutil._compat import redirect_stderr
from psutil.tests import CI_TESTING
from psutil.tests import HAS_BATTERY
from psutil.tests import HAS_MEMORY_MAPS
from psutil.tests import HAS_NET_IO_COUNTERS
from psutil.tests import HAS_SENSORS_BATTERY
from psutil.tests import HAS_SENSORS_FANS
from psutil.tests import HAS_SENSORS_TEMPERATURES
from psutil.tests import PYTHON_EXE
from psutil.tests import PYTHON_EXE_ENV
from psutil.tests import QEMU_USER
from psutil.tests import SCRIPTS_DIR
from psutil.tests import PsutilTestCase
from psutil.tests import mock
from psutil.tests import process_namespace
from psutil.tests import pytest
from psutil.tests import reload_module
from psutil.tests import sh
from psutil.tests import system_namespace
# ===================================================================
# --- Test classes' repr(), str(), ...
# ===================================================================
class TestSpecialMethods(PsutilTestCase):
def test_check_pid_range(self):
with pytest.raises(OverflowError):
psutil._psplatform.cext.check_pid_range(2**128)
with pytest.raises(psutil.NoSuchProcess):
psutil.Process(2**128)
def test_process__repr__(self, func=repr):
p = psutil.Process(self.spawn_testproc().pid)
r = func(p)
assert "psutil.Process" in r
assert "pid=%s" % p.pid in r
assert "name='%s'" % str(p.name()) in r.replace("name=u'", "name='")
assert "status=" in r
assert "exitcode=" not in r
p.terminate()
p.wait()
r = func(p)
assert "status='terminated'" in r
assert "exitcode=" in r
with mock.patch.object(
psutil.Process,
"name",
side_effect=psutil.ZombieProcess(os.getpid()),
):
p = psutil.Process()
r = func(p)
assert "pid=%s" % p.pid in r
assert "status='zombie'" in r
assert "name=" not in r
with mock.patch.object(
psutil.Process,
"name",
side_effect=psutil.NoSuchProcess(os.getpid()),
):
p = psutil.Process()
r = func(p)
assert "pid=%s" % p.pid in r
assert "terminated" in r
assert "name=" not in r
with mock.patch.object(
psutil.Process,
"name",
side_effect=psutil.AccessDenied(os.getpid()),
):
p = psutil.Process()
r = func(p)
assert "pid=%s" % p.pid in r
assert "name=" not in r
def test_process__str__(self):
self.test_process__repr__(func=str)
def test_error__repr__(self):
assert repr(psutil.Error()) == "psutil.Error()"
def test_error__str__(self):
assert str(psutil.Error()) == "" # noqa
def test_no_such_process__repr__(self):
assert (
repr(psutil.NoSuchProcess(321))
== "psutil.NoSuchProcess(pid=321, msg='process no longer exists')"
)
assert (
repr(psutil.NoSuchProcess(321, name="name", msg="msg"))
== "psutil.NoSuchProcess(pid=321, name='name', msg='msg')"
)
def test_no_such_process__str__(self):
assert (
str(psutil.NoSuchProcess(321))
== "process no longer exists (pid=321)"
)
assert (
str(psutil.NoSuchProcess(321, name="name", msg="msg"))
== "msg (pid=321, name='name')"
)
def test_zombie_process__repr__(self):
assert (
repr(psutil.ZombieProcess(321))
== 'psutil.ZombieProcess(pid=321, msg="PID still '
'exists but it\'s a zombie")'
)
assert (
repr(psutil.ZombieProcess(321, name="name", ppid=320, msg="foo"))
== "psutil.ZombieProcess(pid=321, ppid=320, name='name',"
" msg='foo')"
)
def test_zombie_process__str__(self):
assert (
str(psutil.ZombieProcess(321))
== "PID still exists but it's a zombie (pid=321)"
)
assert (
str(psutil.ZombieProcess(321, name="name", ppid=320, msg="foo"))
== "foo (pid=321, ppid=320, name='name')"
)
def test_access_denied__repr__(self):
assert repr(psutil.AccessDenied(321)) == "psutil.AccessDenied(pid=321)"
assert (
repr(psutil.AccessDenied(321, name="name", msg="msg"))
== "psutil.AccessDenied(pid=321, name='name', msg='msg')"
)
def test_access_denied__str__(self):
assert str(psutil.AccessDenied(321)) == "(pid=321)"
assert (
str(psutil.AccessDenied(321, name="name", msg="msg"))
== "msg (pid=321, name='name')"
)
def test_timeout_expired__repr__(self):
assert (
repr(psutil.TimeoutExpired(5))
== "psutil.TimeoutExpired(seconds=5, msg='timeout after 5"
" seconds')"
)
assert (
repr(psutil.TimeoutExpired(5, pid=321, name="name"))
== "psutil.TimeoutExpired(pid=321, name='name', seconds=5, "
"msg='timeout after 5 seconds')"
)
def test_timeout_expired__str__(self):
assert str(psutil.TimeoutExpired(5)) == "timeout after 5 seconds"
assert (
str(psutil.TimeoutExpired(5, pid=321, name="name"))
== "timeout after 5 seconds (pid=321, name='name')"
)
def test_process__eq__(self):
p1 = psutil.Process()
p2 = psutil.Process()
assert p1 == p2
p2._ident = (0, 0)
assert p1 != p2
assert p1 != 'foo'
def test_process__hash__(self):
s = set([psutil.Process(), psutil.Process()])
assert len(s) == 1
# ===================================================================
# --- Misc, generic, corner cases
# ===================================================================
class TestMisc(PsutilTestCase):
def test__all__(self):
dir_psutil = dir(psutil)
for name in dir_psutil:
if name in (
'debug',
'long',
'tests',
'test',
'PermissionError',
'ProcessLookupError',
):
continue
if not name.startswith('_'):
try:
__import__(name)
except ImportError:
if name not in psutil.__all__:
fun = getattr(psutil, name)
if fun is None:
continue
if (
fun.__doc__ is not None
and 'deprecated' not in fun.__doc__.lower()
):
raise self.fail('%r not in psutil.__all__' % name)
# Import 'star' will break if __all__ is inconsistent, see:
# https://github.com/giampaolo/psutil/issues/656
# Can't do `from psutil import *` as it won't work on python 3
# so we simply iterate over __all__.
for name in psutil.__all__:
assert name in dir_psutil
def test_version(self):
assert (
'.'.join([str(x) for x in psutil.version_info])
== psutil.__version__
)
def test_process_as_dict_no_new_names(self):
# See https://github.com/giampaolo/psutil/issues/813
p = psutil.Process()
p.foo = '1'
assert 'foo' not in p.as_dict()
def test_serialization(self):
def check(ret):
json.loads(json.dumps(ret))
a = pickle.dumps(ret)
b = pickle.loads(a)
assert ret == b
# --- process APIs
proc = psutil.Process()
check(psutil.Process().as_dict())
ns = process_namespace(proc)
for fun, name in ns.iter(ns.getters, clear_cache=True):
with self.subTest(proc=proc, name=name):
try:
ret = fun()
except psutil.Error:
pass
else:
check(ret)
# --- system APIs
ns = system_namespace()
for fun, name in ns.iter(ns.getters):
if name in {"win_service_iter", "win_service_get"}:
continue
if QEMU_USER and name == "net_if_stats":
# OSError: [Errno 38] ioctl(SIOCETHTOOL) not implemented
continue
with self.subTest(name=name):
try:
ret = fun()
except psutil.AccessDenied:
pass
else:
check(ret)
# --- exception classes
b = pickle.loads(
pickle.dumps(
psutil.NoSuchProcess(pid=4567, name='name', msg='msg')
)
)
assert isinstance(b, psutil.NoSuchProcess)
assert b.pid == 4567
assert b.name == 'name'
assert b.msg == 'msg'
b = pickle.loads(
pickle.dumps(
psutil.ZombieProcess(pid=4567, name='name', ppid=42, msg='msg')
)
)
assert isinstance(b, psutil.ZombieProcess)
assert b.pid == 4567
assert b.ppid == 42
assert b.name == 'name'
assert b.msg == 'msg'
b = pickle.loads(
pickle.dumps(psutil.AccessDenied(pid=123, name='name', msg='msg'))
)
assert isinstance(b, psutil.AccessDenied)
assert b.pid == 123
assert b.name == 'name'
assert b.msg == 'msg'
b = pickle.loads(
pickle.dumps(
psutil.TimeoutExpired(seconds=33, pid=4567, name='name')
)
)
assert isinstance(b, psutil.TimeoutExpired)
assert b.seconds == 33
assert b.pid == 4567
assert b.name == 'name'
# # XXX: https://github.com/pypa/setuptools/pull/2896
# @pytest.mark.skipif(APPVEYOR,
# reason="temporarily disabled due to setuptools bug"
# )
# def test_setup_script(self):
# setup_py = os.path.join(ROOT_DIR, 'setup.py')
# if CI_TESTING and not os.path.exists(setup_py):
# raise pytest.skip("can't find setup.py")
# module = import_module_by_path(setup_py)
# self.assertRaises(SystemExit, module.setup)
# self.assertEqual(module.get_version(), psutil.__version__)
def test_ad_on_process_creation(self):
# We are supposed to be able to instantiate Process also in case
# of zombie processes or access denied.
with mock.patch.object(
psutil.Process, '_get_ident', side_effect=psutil.AccessDenied
) as meth:
psutil.Process()
assert meth.called
with mock.patch.object(
psutil.Process, '_get_ident', side_effect=psutil.ZombieProcess(1)
) as meth:
psutil.Process()
assert meth.called
with mock.patch.object(
psutil.Process, '_get_ident', side_effect=ValueError
) as meth:
with pytest.raises(ValueError):
psutil.Process()
assert meth.called
with mock.patch.object(
psutil.Process, '_get_ident', side_effect=psutil.NoSuchProcess(1)
) as meth:
with self.assertRaises(psutil.NoSuchProcess):
psutil.Process()
assert meth.called
def test_sanity_version_check(self):
# see: https://github.com/giampaolo/psutil/issues/564
with mock.patch(
"psutil._psplatform.cext.version", return_value="0.0.0"
):
with pytest.raises(ImportError) as cm:
reload_module(psutil)
assert "version conflict" in str(cm.value).lower()
# ===================================================================
# --- psutil/_common.py utils
# ===================================================================
class TestMemoizeDecorator(PsutilTestCase):
def setUp(self):
self.calls = []
tearDown = setUp
def run_against(self, obj, expected_retval=None):
# no args
for _ in range(2):
ret = obj()
assert self.calls == [((), {})]
if expected_retval is not None:
assert ret == expected_retval
# with args
for _ in range(2):
ret = obj(1)
assert self.calls == [((), {}), ((1,), {})]
if expected_retval is not None:
assert ret == expected_retval
# with args + kwargs
for _ in range(2):
ret = obj(1, bar=2)
assert self.calls == [((), {}), ((1,), {}), ((1,), {'bar': 2})]
if expected_retval is not None:
assert ret == expected_retval
# clear cache
assert len(self.calls) == 3
obj.cache_clear()
ret = obj()
if expected_retval is not None:
assert ret == expected_retval
assert len(self.calls) == 4
# docstring
assert obj.__doc__ == "My docstring."
def test_function(self):
@memoize
def foo(*args, **kwargs):
"""My docstring."""
baseclass.calls.append((args, kwargs))
return 22
baseclass = self
self.run_against(foo, expected_retval=22)
def test_class(self):
@memoize
class Foo:
"""My docstring."""
def __init__(self, *args, **kwargs):
baseclass.calls.append((args, kwargs))
def bar(self):
return 22
baseclass = self
self.run_against(Foo, expected_retval=None)
assert Foo().bar() == 22
def test_class_singleton(self):
# @memoize can be used against classes to create singletons
@memoize
class Bar:
def __init__(self, *args, **kwargs):
pass
assert Bar() is Bar()
assert id(Bar()) == id(Bar())
assert id(Bar(1)) == id(Bar(1))
assert id(Bar(1, foo=3)) == id(Bar(1, foo=3))
assert id(Bar(1)) != id(Bar(2))
def test_staticmethod(self):
class Foo:
@staticmethod
@memoize
def bar(*args, **kwargs):
"""My docstring."""
baseclass.calls.append((args, kwargs))
return 22
baseclass = self
self.run_against(Foo().bar, expected_retval=22)
def test_classmethod(self):
class Foo:
@classmethod
@memoize
def bar(cls, *args, **kwargs):
"""My docstring."""
baseclass.calls.append((args, kwargs))
return 22
baseclass = self
self.run_against(Foo().bar, expected_retval=22)
def test_original(self):
# This was the original test before I made it dynamic to test it
# against different types. Keeping it anyway.
@memoize
def foo(*args, **kwargs):
"""Foo docstring."""
calls.append(None)
return (args, kwargs)
calls = []
# no args
for _ in range(2):
ret = foo()
expected = ((), {})
assert ret == expected
assert len(calls) == 1
# with args
for _ in range(2):
ret = foo(1)
expected = ((1,), {})
assert ret == expected
assert len(calls) == 2
# with args + kwargs
for _ in range(2):
ret = foo(1, bar=2)
expected = ((1,), {'bar': 2})
assert ret == expected
assert len(calls) == 3
# clear cache
foo.cache_clear()
ret = foo()
expected = ((), {})
assert ret == expected
assert len(calls) == 4
# docstring
assert foo.__doc__ == "Foo docstring."
class TestCommonModule(PsutilTestCase):
def test_memoize_when_activated(self):
class Foo:
@memoize_when_activated
def foo(self):
calls.append(None)
f = Foo()
calls = []
f.foo()
f.foo()
assert len(calls) == 2
# activate
calls = []
f.foo.cache_activate(f)
f.foo()
f.foo()
assert len(calls) == 1
# deactivate
calls = []
f.foo.cache_deactivate(f)
f.foo()
f.foo()
assert len(calls) == 2
def test_parse_environ_block(self):
def k(s):
return s.upper() if WINDOWS else s
assert parse_environ_block("a=1\0") == {k("a"): "1"}
assert parse_environ_block("a=1\0b=2\0\0") == {
k("a"): "1",
k("b"): "2",
}
assert parse_environ_block("a=1\0b=\0\0") == {k("a"): "1", k("b"): ""}
# ignore everything after \0\0
assert parse_environ_block("a=1\0b=2\0\0c=3\0") == {
k("a"): "1",
k("b"): "2",
}
# ignore everything that is not an assignment
assert parse_environ_block("xxx\0a=1\0") == {k("a"): "1"}
assert parse_environ_block("a=1\0=b=2\0") == {k("a"): "1"}
# do not fail if the block is incomplete
assert parse_environ_block("a=1\0b=2") == {k("a"): "1"}
def test_supports_ipv6(self):
self.addCleanup(supports_ipv6.cache_clear)
if supports_ipv6():
with mock.patch('psutil._common.socket') as s:
s.has_ipv6 = False
supports_ipv6.cache_clear()
assert not supports_ipv6()
supports_ipv6.cache_clear()
with mock.patch(
'psutil._common.socket.socket', side_effect=socket.error
) as s:
assert not supports_ipv6()
assert s.called
supports_ipv6.cache_clear()
with mock.patch(
'psutil._common.socket.socket', side_effect=socket.gaierror
) as s:
assert not supports_ipv6()
supports_ipv6.cache_clear()
assert s.called
supports_ipv6.cache_clear()
with mock.patch(
'psutil._common.socket.socket.bind',
side_effect=socket.gaierror,
) as s:
assert not supports_ipv6()
supports_ipv6.cache_clear()
assert s.called
else:
with pytest.raises(socket.error):
sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
try:
sock.bind(("::1", 0))
finally:
sock.close()
def test_isfile_strict(self):
this_file = os.path.abspath(__file__)
assert isfile_strict(this_file)
assert not isfile_strict(os.path.dirname(this_file))
with mock.patch(
'psutil._common.os.stat', side_effect=OSError(errno.EPERM, "foo")
):
with pytest.raises(OSError):
isfile_strict(this_file)
with mock.patch(
'psutil._common.os.stat', side_effect=OSError(errno.EACCES, "foo")
):
with pytest.raises(OSError):
isfile_strict(this_file)
with mock.patch(
'psutil._common.os.stat', side_effect=OSError(errno.ENOENT, "foo")
):
assert not isfile_strict(this_file)
with mock.patch('psutil._common.stat.S_ISREG', return_value=False):
assert not isfile_strict(this_file)
def test_debug(self):
if PY3:
from io import StringIO
else:
from StringIO import StringIO
with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
with redirect_stderr(StringIO()) as f:
debug("hello")
sys.stderr.flush()
msg = f.getvalue()
assert msg.startswith("psutil-debug"), msg
assert "hello" in msg
assert __file__.replace('.pyc', '.py') in msg
# supposed to use repr(exc)
with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
with redirect_stderr(StringIO()) as f:
debug(ValueError("this is an error"))
msg = f.getvalue()
assert "ignoring ValueError" in msg
assert "'this is an error'" in msg
# supposed to use str(exc), because of extra info about file name
with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
with redirect_stderr(StringIO()) as f:
exc = OSError(2, "no such file")
exc.filename = "/foo"
debug(exc)
msg = f.getvalue()
assert "no such file" in msg
assert "/foo" in msg
def test_cat_bcat(self):
testfn = self.get_testfn()
with open(testfn, "w") as f:
f.write("foo")
assert cat(testfn) == "foo"
assert bcat(testfn) == b"foo"
with pytest.raises(FileNotFoundError):
cat(testfn + '-invalid')
with pytest.raises(FileNotFoundError):
bcat(testfn + '-invalid')
assert cat(testfn + '-invalid', fallback="bar") == "bar"
assert bcat(testfn + '-invalid', fallback="bar") == "bar"
# ===================================================================
# --- Tests for wrap_numbers() function.
# ===================================================================
nt = collections.namedtuple('foo', 'a b c')
class TestWrapNumbers(PsutilTestCase):
def setUp(self):
wrap_numbers.cache_clear()
tearDown = setUp
def test_first_call(self):
input = {'disk1': nt(5, 5, 5)}
assert wrap_numbers(input, 'disk_io') == input
def test_input_hasnt_changed(self):
input = {'disk1': nt(5, 5, 5)}
assert wrap_numbers(input, 'disk_io') == input
assert wrap_numbers(input, 'disk_io') == input
def test_increase_but_no_wrap(self):
input = {'disk1': nt(5, 5, 5)}
assert wrap_numbers(input, 'disk_io') == input
input = {'disk1': nt(10, 15, 20)}
assert wrap_numbers(input, 'disk_io') == input
input = {'disk1': nt(20, 25, 30)}
assert wrap_numbers(input, 'disk_io') == input
input = {'disk1': nt(20, 25, 30)}
assert wrap_numbers(input, 'disk_io') == input
def test_wrap(self):
# let's say 100 is the threshold
input = {'disk1': nt(100, 100, 100)}
assert wrap_numbers(input, 'disk_io') == input
# first wrap restarts from 10
input = {'disk1': nt(100, 100, 10)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(100, 100, 110)}
# then it remains the same
input = {'disk1': nt(100, 100, 10)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(100, 100, 110)}
# then it goes up
input = {'disk1': nt(100, 100, 90)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(100, 100, 190)}
# then it wraps again
input = {'disk1': nt(100, 100, 20)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(100, 100, 210)}
# and remains the same
input = {'disk1': nt(100, 100, 20)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(100, 100, 210)}
# now wrap another num
input = {'disk1': nt(50, 100, 20)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(150, 100, 210)}
# and again
input = {'disk1': nt(40, 100, 20)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(190, 100, 210)}
# keep it the same
input = {'disk1': nt(40, 100, 20)}
assert wrap_numbers(input, 'disk_io') == {'disk1': nt(190, 100, 210)}
def test_changing_keys(self):
# Emulate a case where the second call to disk_io()
# (or whatever) provides a new disk, then the new disk
# disappears on the third call.
input = {'disk1': nt(5, 5, 5)}
assert wrap_numbers(input, 'disk_io') == input
input = {'disk1': nt(5, 5, 5), 'disk2': nt(7, 7, 7)}
assert wrap_numbers(input, 'disk_io') == input
input = {'disk1': nt(8, 8, 8)}
assert wrap_numbers(input, 'disk_io') == input
def test_changing_keys_w_wrap(self):
input = {'disk1': nt(50, 50, 50), 'disk2': nt(100, 100, 100)}
assert wrap_numbers(input, 'disk_io') == input
# disk 2 wraps
input = {'disk1': nt(50, 50, 50), 'disk2': nt(100, 100, 10)}
assert wrap_numbers(input, 'disk_io') == {
'disk1': nt(50, 50, 50),
'disk2': nt(100, 100, 110),
}
# disk 2 disappears
input = {'disk1': nt(50, 50, 50)}
assert wrap_numbers(input, 'disk_io') == input
# then it appears again; the old wrap is supposed to be
# gone.
input = {'disk1': nt(50, 50, 50), 'disk2': nt(100, 100, 100)}
assert wrap_numbers(input, 'disk_io') == input
# remains the same
input = {'disk1': nt(50, 50, 50), 'disk2': nt(100, 100, 100)}
assert wrap_numbers(input, 'disk_io') == input
# and then wraps again
input = {'disk1': nt(50, 50, 50), 'disk2': nt(100, 100, 10)}
assert wrap_numbers(input, 'disk_io') == {
'disk1': nt(50, 50, 50),
'disk2': nt(100, 100, 110),
}
def test_real_data(self):
d = {
'nvme0n1': (300, 508, 640, 1571, 5970, 1987, 2049, 451751, 47048),
'nvme0n1p1': (1171, 2, 5600256, 1024, 516, 0, 0, 0, 8),
'nvme0n1p2': (54, 54, 2396160, 5165056, 4, 24, 30, 1207, 28),
'nvme0n1p3': (2389, 4539, 5154, 150, 4828, 1844, 2019, 398, 348),
}
assert wrap_numbers(d, 'disk_io') == d
assert wrap_numbers(d, 'disk_io') == d
# decrease this ↓
d = {
'nvme0n1': (100, 508, 640, 1571, 5970, 1987, 2049, 451751, 47048),
'nvme0n1p1': (1171, 2, 5600256, 1024, 516, 0, 0, 0, 8),
'nvme0n1p2': (54, 54, 2396160, 5165056, 4, 24, 30, 1207, 28),
'nvme0n1p3': (2389, 4539, 5154, 150, 4828, 1844, 2019, 398, 348),
}
out = wrap_numbers(d, 'disk_io')
assert out['nvme0n1'][0] == 400
# --- cache tests
def test_cache_first_call(self):
input = {'disk1': nt(5, 5, 5)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
assert cache[1] == {'disk_io': {}}
assert cache[2] == {'disk_io': {}}
def test_cache_call_twice(self):
input = {'disk1': nt(5, 5, 5)}
wrap_numbers(input, 'disk_io')
input = {'disk1': nt(10, 10, 10)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
assert cache[1] == {
'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 0}
}
assert cache[2] == {'disk_io': {}}
def test_cache_wrap(self):
# let's say 100 is the threshold
input = {'disk1': nt(100, 100, 100)}
wrap_numbers(input, 'disk_io')
# first wrap restarts from 10
input = {'disk1': nt(100, 100, 10)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
assert cache[1] == {
'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 100}
}
assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
def check_cache_info():
cache = wrap_numbers.cache_info()
assert cache[1] == {
'disk_io': {
('disk1', 0): 0,
('disk1', 1): 0,
('disk1', 2): 100,
}
}
assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
# then it remains the same
input = {'disk1': nt(100, 100, 10)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
check_cache_info()
# then it goes up
input = {'disk1': nt(100, 100, 90)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
check_cache_info()
# then it wraps again
input = {'disk1': nt(100, 100, 20)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
assert cache[1] == {
'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 190}
}
assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
def test_cache_changing_keys(self):
input = {'disk1': nt(5, 5, 5)}
wrap_numbers(input, 'disk_io')
input = {'disk1': nt(5, 5, 5), 'disk2': nt(7, 7, 7)}
wrap_numbers(input, 'disk_io')
cache = wrap_numbers.cache_info()
assert cache[0] == {'disk_io': input}
assert cache[1] == {
'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 0}
}
assert cache[2] == {'disk_io': {}}
def test_cache_clear(self):
input = {'disk1': nt(5, 5, 5)}
wrap_numbers(input, 'disk_io')
wrap_numbers(input, 'disk_io')
wrap_numbers.cache_clear('disk_io')
assert wrap_numbers.cache_info() == ({}, {}, {})
wrap_numbers.cache_clear('disk_io')
wrap_numbers.cache_clear('?!?')
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_cache_clear_public_apis(self):
if not psutil.disk_io_counters() or not psutil.net_io_counters():
raise pytest.skip("no disks or NICs available")
psutil.disk_io_counters()
psutil.net_io_counters()
caches = wrap_numbers.cache_info()
for cache in caches:
assert 'psutil.disk_io_counters' in cache
assert 'psutil.net_io_counters' in cache
psutil.disk_io_counters.cache_clear()
caches = wrap_numbers.cache_info()
for cache in caches:
assert 'psutil.net_io_counters' in cache
assert 'psutil.disk_io_counters' not in cache
psutil.net_io_counters.cache_clear()
caches = wrap_numbers.cache_info()
assert caches == ({}, {}, {})
# ===================================================================
# --- Example script tests
# ===================================================================
@pytest.mark.skipif(
not os.path.exists(SCRIPTS_DIR), reason="can't locate scripts directory"
)
class TestScripts(PsutilTestCase):
"""Tests for scripts in the "scripts" directory."""
@staticmethod
def assert_stdout(exe, *args, **kwargs):
kwargs.setdefault("env", PYTHON_EXE_ENV)
exe = '%s' % os.path.join(SCRIPTS_DIR, exe)
cmd = [PYTHON_EXE, exe]
for arg in args:
cmd.append(arg)
try:
out = sh(cmd, **kwargs).strip()
except RuntimeError as err:
if 'AccessDenied' in str(err):
return str(err)
else:
raise
assert out, out
return out
@staticmethod
def assert_syntax(exe):
exe = os.path.join(SCRIPTS_DIR, exe)
with open(exe, encoding="utf8") if PY3 else open(exe) as f:
src = f.read()
ast.parse(src)
def test_coverage(self):
# make sure all example scripts have a test method defined
meths = dir(self)
for name in os.listdir(SCRIPTS_DIR):
if name.endswith('.py'):
if 'test_' + os.path.splitext(name)[0] not in meths:
# self.assert_stdout(name)
raise self.fail(
'no test defined for %r script'
% os.path.join(SCRIPTS_DIR, name)
)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_executable(self):
for root, dirs, files in os.walk(SCRIPTS_DIR):
for file in files:
if file.endswith('.py'):
path = os.path.join(root, file)
if not stat.S_IXUSR & os.stat(path)[stat.ST_MODE]:
raise self.fail('%r is not executable' % path)
def test_disk_usage(self):
self.assert_stdout('disk_usage.py')
def test_free(self):
self.assert_stdout('free.py')
def test_meminfo(self):
self.assert_stdout('meminfo.py')
def test_procinfo(self):
self.assert_stdout('procinfo.py', str(os.getpid()))
@pytest.mark.skipif(CI_TESTING and not psutil.users(), reason="no users")
def test_who(self):
self.assert_stdout('who.py')
def test_ps(self):
self.assert_stdout('ps.py')
def test_pstree(self):
self.assert_stdout('pstree.py')
def test_netstat(self):
self.assert_stdout('netstat.py')
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_ifconfig(self):
self.assert_stdout('ifconfig.py')
@pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
def test_pmap(self):
self.assert_stdout('pmap.py', str(os.getpid()))
def test_procsmem(self):
if 'uss' not in psutil.Process().memory_full_info()._fields:
raise pytest.skip("not supported")
self.assert_stdout('procsmem.py')
def test_killall(self):
self.assert_syntax('killall.py')
def test_nettop(self):
self.assert_syntax('nettop.py')
def test_top(self):
self.assert_syntax('top.py')
def test_iotop(self):
self.assert_syntax('iotop.py')
def test_pidof(self):
output = self.assert_stdout('pidof.py', psutil.Process().name())
assert str(os.getpid()) in output
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
def test_winservices(self):
self.assert_stdout('winservices.py')
def test_cpu_distribution(self):
self.assert_syntax('cpu_distribution.py')
@pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
def test_temperatures(self):
if not psutil.sensors_temperatures():
raise pytest.skip("no temperatures")
self.assert_stdout('temperatures.py')
@pytest.mark.skipif(not HAS_SENSORS_FANS, reason="not supported")
def test_fans(self):
if not psutil.sensors_fans():
raise pytest.skip("no fans")
self.assert_stdout('fans.py')
@pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_battery(self):
self.assert_stdout('battery.py')
@pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_sensors(self):
self.assert_stdout('sensors.py')
PK ok\X���N �N psutil/tests/test_bsd.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
# TODO: (FreeBSD) add test for comparing connections with 'sockstat' cmd.
"""Tests specific to all BSD platforms."""
import datetime
import os
import re
import time
import psutil
from psutil import BSD
from psutil import FREEBSD
from psutil import NETBSD
from psutil import OPENBSD
from psutil.tests import HAS_BATTERY
from psutil.tests import TOLERANCE_SYS_MEM
from psutil.tests import PsutilTestCase
from psutil.tests import pytest
from psutil.tests import retry_on_failure
from psutil.tests import sh
from psutil.tests import spawn_testproc
from psutil.tests import terminate
from psutil.tests import which
if BSD:
from psutil._psutil_posix import getpagesize
PAGESIZE = getpagesize()
# muse requires root privileges
MUSE_AVAILABLE = os.getuid() == 0 and which('muse')
else:
PAGESIZE = None
MUSE_AVAILABLE = False
def sysctl(cmdline):
"""Expects a sysctl command with an argument and parse the result
returning only the value of interest.
"""
result = sh("sysctl " + cmdline)
if FREEBSD:
result = result[result.find(": ") + 2 :]
elif OPENBSD or NETBSD:
result = result[result.find("=") + 1 :]
try:
return int(result)
except ValueError:
return result
def muse(field):
"""Thin wrapper around 'muse' cmdline utility."""
out = sh('muse')
for line in out.split('\n'):
if line.startswith(field):
break
else:
raise ValueError("line not found")
return int(line.split()[1])
# =====================================================================
# --- All BSD*
# =====================================================================
@pytest.mark.skipif(not BSD, reason="BSD only")
class BSDTestCase(PsutilTestCase):
"""Generic tests common to all BSD variants."""
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
@pytest.mark.skipif(NETBSD, reason="-o lstart doesn't work on NETBSD")
def test_process_create_time(self):
output = sh("ps -o lstart -p %s" % self.pid)
start_ps = output.replace('STARTED', '').strip()
start_psutil = psutil.Process(self.pid).create_time()
start_psutil = time.strftime(
"%a %b %e %H:%M:%S %Y", time.localtime(start_psutil)
)
assert start_ps == start_psutil
def test_disks(self):
# test psutil.disk_usage() and psutil.disk_partitions()
# against "df -a"
def df(path):
out = sh('df -k "%s"' % path).strip()
lines = out.split('\n')
lines.pop(0)
line = lines.pop(0)
dev, total, used, free = line.split()[:4]
if dev == 'none':
dev = ''
total = int(total) * 1024
used = int(used) * 1024
free = int(free) * 1024
return dev, total, used, free
for part in psutil.disk_partitions(all=False):
usage = psutil.disk_usage(part.mountpoint)
dev, total, used, free = df(part.mountpoint)
assert part.device == dev
assert usage.total == total
# 10 MB tolerance
if abs(usage.free - free) > 10 * 1024 * 1024:
raise self.fail("psutil=%s, df=%s" % (usage.free, free))
if abs(usage.used - used) > 10 * 1024 * 1024:
raise self.fail("psutil=%s, df=%s" % (usage.used, used))
@pytest.mark.skipif(not which('sysctl'), reason="sysctl cmd not available")
def test_cpu_count_logical(self):
syst = sysctl("hw.ncpu")
assert psutil.cpu_count(logical=True) == syst
@pytest.mark.skipif(not which('sysctl'), reason="sysctl cmd not available")
@pytest.mark.skipif(
NETBSD, reason="skipped on NETBSD" # we check /proc/meminfo
)
def test_virtual_memory_total(self):
num = sysctl('hw.physmem')
assert num == psutil.virtual_memory().total
@pytest.mark.skipif(
not which('ifconfig'), reason="ifconfig cmd not available"
)
def test_net_if_stats(self):
for name, stats in psutil.net_if_stats().items():
try:
out = sh("ifconfig %s" % name)
except RuntimeError:
pass
else:
assert stats.isup == ('RUNNING' in out)
if "mtu" in out:
assert stats.mtu == int(re.findall(r'mtu (\d+)', out)[0])
# =====================================================================
# --- FreeBSD
# =====================================================================
@pytest.mark.skipif(not FREEBSD, reason="FREEBSD only")
class FreeBSDPsutilTestCase(PsutilTestCase):
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
@retry_on_failure()
def test_memory_maps(self):
out = sh('procstat -v %s' % self.pid)
maps = psutil.Process(self.pid).memory_maps(grouped=False)
lines = out.split('\n')[1:]
while lines:
line = lines.pop()
fields = line.split()
_, start, stop, _perms, res = fields[:5]
map = maps.pop()
assert "%s-%s" % (start, stop) == map.addr
assert int(res) == map.rss
if not map.path.startswith('['):
assert fields[10] == map.path
def test_exe(self):
out = sh('procstat -b %s' % self.pid)
assert psutil.Process(self.pid).exe() == out.split('\n')[1].split()[-1]
def test_cmdline(self):
out = sh('procstat -c %s' % self.pid)
assert ' '.join(psutil.Process(self.pid).cmdline()) == ' '.join(
out.split('\n')[1].split()[2:]
)
def test_uids_gids(self):
out = sh('procstat -s %s' % self.pid)
euid, ruid, suid, egid, rgid, sgid = out.split('\n')[1].split()[2:8]
p = psutil.Process(self.pid)
uids = p.uids()
gids = p.gids()
assert uids.real == int(ruid)
assert uids.effective == int(euid)
assert uids.saved == int(suid)
assert gids.real == int(rgid)
assert gids.effective == int(egid)
assert gids.saved == int(sgid)
@retry_on_failure()
def test_ctx_switches(self):
tested = []
out = sh('procstat -r %s' % self.pid)
p = psutil.Process(self.pid)
for line in out.split('\n'):
line = line.lower().strip()
if ' voluntary context' in line:
pstat_value = int(line.split()[-1])
psutil_value = p.num_ctx_switches().voluntary
assert pstat_value == psutil_value
tested.append(None)
elif ' involuntary context' in line:
pstat_value = int(line.split()[-1])
psutil_value = p.num_ctx_switches().involuntary
assert pstat_value == psutil_value
tested.append(None)
if len(tested) != 2:
raise RuntimeError("couldn't find lines match in procstat out")
@retry_on_failure()
def test_cpu_times(self):
tested = []
out = sh('procstat -r %s' % self.pid)
p = psutil.Process(self.pid)
for line in out.split('\n'):
line = line.lower().strip()
if 'user time' in line:
pstat_value = float('0.' + line.split()[-1].split('.')[-1])
psutil_value = p.cpu_times().user
assert pstat_value == psutil_value
tested.append(None)
elif 'system time' in line:
pstat_value = float('0.' + line.split()[-1].split('.')[-1])
psutil_value = p.cpu_times().system
assert pstat_value == psutil_value
tested.append(None)
if len(tested) != 2:
raise RuntimeError("couldn't find lines match in procstat out")
@pytest.mark.skipif(not FREEBSD, reason="FREEBSD only")
class FreeBSDSystemTestCase(PsutilTestCase):
@staticmethod
def parse_swapinfo():
# the last line is always the total
output = sh("swapinfo -k").splitlines()[-1]
parts = re.split(r'\s+', output)
if not parts:
raise ValueError("Can't parse swapinfo: %s" % output)
# the size is in 1k units, so multiply by 1024
total, used, free = (int(p) * 1024 for p in parts[1:4])
return total, used, free
def test_cpu_frequency_against_sysctl(self):
# Currently only cpu 0 is frequency is supported in FreeBSD
# All other cores use the same frequency.
sensor = "dev.cpu.0.freq"
try:
sysctl_result = int(sysctl(sensor))
except RuntimeError:
raise pytest.skip("frequencies not supported by kernel")
assert psutil.cpu_freq().current == sysctl_result
sensor = "dev.cpu.0.freq_levels"
sysctl_result = sysctl(sensor)
# sysctl returns a string of the format:
# <freq_level_1>/<voltage_level_1> <freq_level_2>/<voltage_level_2>...
# Ordered highest available to lowest available.
max_freq = int(sysctl_result.split()[0].split("/")[0])
min_freq = int(sysctl_result.split()[-1].split("/")[0])
assert psutil.cpu_freq().max == max_freq
assert psutil.cpu_freq().min == min_freq
# --- virtual_memory(); tests against sysctl
@retry_on_failure()
def test_vmem_active(self):
syst = sysctl("vm.stats.vm.v_active_count") * PAGESIZE
assert abs(psutil.virtual_memory().active - syst) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_inactive(self):
syst = sysctl("vm.stats.vm.v_inactive_count") * PAGESIZE
assert abs(psutil.virtual_memory().inactive - syst) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_wired(self):
syst = sysctl("vm.stats.vm.v_wire_count") * PAGESIZE
assert abs(psutil.virtual_memory().wired - syst) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_cached(self):
syst = sysctl("vm.stats.vm.v_cache_count") * PAGESIZE
assert abs(psutil.virtual_memory().cached - syst) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_free(self):
syst = sysctl("vm.stats.vm.v_free_count") * PAGESIZE
assert abs(psutil.virtual_memory().free - syst) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_buffers(self):
syst = sysctl("vfs.bufspace")
assert abs(psutil.virtual_memory().buffers - syst) < TOLERANCE_SYS_MEM
# --- virtual_memory(); tests against muse
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
def test_muse_vmem_total(self):
num = muse('Total')
assert psutil.virtual_memory().total == num
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_active(self):
num = muse('Active')
assert abs(psutil.virtual_memory().active - num) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_inactive(self):
num = muse('Inactive')
assert abs(psutil.virtual_memory().inactive - num) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_wired(self):
num = muse('Wired')
assert abs(psutil.virtual_memory().wired - num) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_cached(self):
num = muse('Cache')
assert abs(psutil.virtual_memory().cached - num) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_free(self):
num = muse('Free')
assert abs(psutil.virtual_memory().free - num) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not MUSE_AVAILABLE, reason="muse not installed")
@retry_on_failure()
def test_muse_vmem_buffers(self):
num = muse('Buffer')
assert abs(psutil.virtual_memory().buffers - num) < TOLERANCE_SYS_MEM
def test_cpu_stats_ctx_switches(self):
assert (
abs(
psutil.cpu_stats().ctx_switches
- sysctl('vm.stats.sys.v_swtch')
)
< 1000
)
def test_cpu_stats_interrupts(self):
assert (
abs(psutil.cpu_stats().interrupts - sysctl('vm.stats.sys.v_intr'))
< 1000
)
def test_cpu_stats_soft_interrupts(self):
assert (
abs(
psutil.cpu_stats().soft_interrupts
- sysctl('vm.stats.sys.v_soft')
)
< 1000
)
@retry_on_failure()
def test_cpu_stats_syscalls(self):
# pretty high tolerance but it looks like it's OK.
assert (
abs(psutil.cpu_stats().syscalls - sysctl('vm.stats.sys.v_syscall'))
< 200000
)
# def test_cpu_stats_traps(self):
# self.assertAlmostEqual(psutil.cpu_stats().traps,
# sysctl('vm.stats.sys.v_trap'), delta=1000)
# --- swap memory
def test_swapmem_free(self):
_total, _used, free = self.parse_swapinfo()
assert abs(psutil.swap_memory().free - free) < TOLERANCE_SYS_MEM
def test_swapmem_used(self):
_total, used, _free = self.parse_swapinfo()
assert abs(psutil.swap_memory().used - used) < TOLERANCE_SYS_MEM
def test_swapmem_total(self):
total, _used, _free = self.parse_swapinfo()
assert abs(psutil.swap_memory().total - total) < TOLERANCE_SYS_MEM
# --- others
def test_boot_time(self):
s = sysctl('sysctl kern.boottime')
s = s[s.find(" sec = ") + 7 :]
s = s[: s.find(',')]
btime = int(s)
assert btime == psutil.boot_time()
# --- sensors_battery
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_sensors_battery(self):
def secs2hours(secs):
m, _s = divmod(secs, 60)
h, m = divmod(m, 60)
return "%d:%02d" % (h, m)
out = sh("acpiconf -i 0")
fields = dict(
[(x.split('\t')[0], x.split('\t')[-1]) for x in out.split("\n")]
)
metrics = psutil.sensors_battery()
percent = int(fields['Remaining capacity:'].replace('%', ''))
remaining_time = fields['Remaining time:']
assert metrics.percent == percent
if remaining_time == 'unknown':
assert metrics.secsleft == psutil.POWER_TIME_UNLIMITED
else:
assert secs2hours(metrics.secsleft) == remaining_time
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_sensors_battery_against_sysctl(self):
assert psutil.sensors_battery().percent == sysctl(
"hw.acpi.battery.life"
)
assert psutil.sensors_battery().power_plugged == (
sysctl("hw.acpi.acline") == 1
)
secsleft = psutil.sensors_battery().secsleft
if secsleft < 0:
assert sysctl("hw.acpi.battery.time") == -1
else:
assert secsleft == sysctl("hw.acpi.battery.time") * 60
@pytest.mark.skipif(HAS_BATTERY, reason="has battery")
def test_sensors_battery_no_battery(self):
# If no battery is present one of these calls is supposed
# to fail, see:
# https://github.com/giampaolo/psutil/issues/1074
with pytest.raises(RuntimeError):
sysctl("hw.acpi.battery.life")
sysctl("hw.acpi.battery.time")
sysctl("hw.acpi.acline")
assert psutil.sensors_battery() is None
# --- sensors_temperatures
def test_sensors_temperatures_against_sysctl(self):
num_cpus = psutil.cpu_count(True)
for cpu in range(num_cpus):
sensor = "dev.cpu.%s.temperature" % cpu
# sysctl returns a string in the format 46.0C
try:
sysctl_result = int(float(sysctl(sensor)[:-1]))
except RuntimeError:
raise pytest.skip("temperatures not supported by kernel")
assert (
abs(
psutil.sensors_temperatures()["coretemp"][cpu].current
- sysctl_result
)
< 10
)
sensor = "dev.cpu.%s.coretemp.tjmax" % cpu
sysctl_result = int(float(sysctl(sensor)[:-1]))
assert (
psutil.sensors_temperatures()["coretemp"][cpu].high
== sysctl_result
)
# =====================================================================
# --- OpenBSD
# =====================================================================
@pytest.mark.skipif(not OPENBSD, reason="OPENBSD only")
class OpenBSDTestCase(PsutilTestCase):
def test_boot_time(self):
s = sysctl('kern.boottime')
sys_bt = datetime.datetime.strptime(s, "%a %b %d %H:%M:%S %Y")
psutil_bt = datetime.datetime.fromtimestamp(psutil.boot_time())
assert sys_bt == psutil_bt
# =====================================================================
# --- NetBSD
# =====================================================================
@pytest.mark.skipif(not NETBSD, reason="NETBSD only")
class NetBSDTestCase(PsutilTestCase):
@staticmethod
def parse_meminfo(look_for):
with open('/proc/meminfo') as f:
for line in f:
if line.startswith(look_for):
return int(line.split()[1]) * 1024
raise ValueError("can't find %s" % look_for)
# --- virtual mem
def test_vmem_total(self):
assert psutil.virtual_memory().total == self.parse_meminfo("MemTotal:")
def test_vmem_free(self):
assert (
abs(psutil.virtual_memory().free - self.parse_meminfo("MemFree:"))
< TOLERANCE_SYS_MEM
)
def test_vmem_buffers(self):
assert (
abs(
psutil.virtual_memory().buffers
- self.parse_meminfo("Buffers:")
)
< TOLERANCE_SYS_MEM
)
def test_vmem_shared(self):
assert (
abs(
psutil.virtual_memory().shared
- self.parse_meminfo("MemShared:")
)
< TOLERANCE_SYS_MEM
)
def test_vmem_cached(self):
assert (
abs(psutil.virtual_memory().cached - self.parse_meminfo("Cached:"))
< TOLERANCE_SYS_MEM
)
# --- swap mem
def test_swapmem_total(self):
assert (
abs(psutil.swap_memory().total - self.parse_meminfo("SwapTotal:"))
< TOLERANCE_SYS_MEM
)
def test_swapmem_free(self):
assert (
abs(psutil.swap_memory().free - self.parse_meminfo("SwapFree:"))
< TOLERANCE_SYS_MEM
)
def test_swapmem_used(self):
smem = psutil.swap_memory()
assert smem.used == smem.total - smem.free
# --- others
def test_cpu_stats_interrupts(self):
with open('/proc/stat', 'rb') as f:
for line in f:
if line.startswith(b'intr'):
interrupts = int(line.split()[1])
break
else:
raise ValueError("couldn't find line")
assert abs(psutil.cpu_stats().interrupts - interrupts) < 1000
def test_cpu_stats_ctx_switches(self):
with open('/proc/stat', 'rb') as f:
for line in f:
if line.startswith(b'ctxt'):
ctx_switches = int(line.split()[1])
break
else:
raise ValueError("couldn't find line")
assert abs(psutil.cpu_stats().ctx_switches - ctx_switches) < 1000
PK ok\�;�3< 3< psutil/tests/test_memleaks.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Tests for detecting function memory leaks (typically the ones
implemented in C). It does so by calling a function many times and
checking whether process memory usage keeps increasing between
calls or over time.
Note that this may produce false positives (especially on Windows
for some reason).
PyPy appears to be completely unstable for this framework, probably
because of how its JIT handles memory, so tests are skipped.
"""
from __future__ import print_function
import functools
import os
import platform
import psutil
import psutil._common
from psutil import LINUX
from psutil import MACOS
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._compat import ProcessLookupError
from psutil._compat import super
from psutil.tests import HAS_CPU_AFFINITY
from psutil.tests import HAS_CPU_FREQ
from psutil.tests import HAS_ENVIRON
from psutil.tests import HAS_IONICE
from psutil.tests import HAS_MEMORY_MAPS
from psutil.tests import HAS_NET_IO_COUNTERS
from psutil.tests import HAS_PROC_CPU_NUM
from psutil.tests import HAS_PROC_IO_COUNTERS
from psutil.tests import HAS_RLIMIT
from psutil.tests import HAS_SENSORS_BATTERY
from psutil.tests import HAS_SENSORS_FANS
from psutil.tests import HAS_SENSORS_TEMPERATURES
from psutil.tests import QEMU_USER
from psutil.tests import TestMemoryLeak
from psutil.tests import create_sockets
from psutil.tests import get_testfn
from psutil.tests import process_namespace
from psutil.tests import pytest
from psutil.tests import skip_on_access_denied
from psutil.tests import spawn_testproc
from psutil.tests import system_namespace
from psutil.tests import terminate
cext = psutil._psplatform.cext
thisproc = psutil.Process()
FEW_TIMES = 5
def fewtimes_if_linux():
"""Decorator for those Linux functions which are implemented in pure
Python, and which we want to run faster.
"""
def decorator(fun):
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
if LINUX:
before = self.__class__.times
try:
self.__class__.times = FEW_TIMES
return fun(self, *args, **kwargs)
finally:
self.__class__.times = before
else:
return fun(self, *args, **kwargs)
return wrapper
return decorator
# ===================================================================
# Process class
# ===================================================================
class TestProcessObjectLeaks(TestMemoryLeak):
"""Test leaks of Process class methods."""
proc = thisproc
def test_coverage(self):
ns = process_namespace(None)
ns.test_class_coverage(self, ns.getters + ns.setters)
@fewtimes_if_linux()
def test_name(self):
self.execute(self.proc.name)
@fewtimes_if_linux()
def test_cmdline(self):
self.execute(self.proc.cmdline)
@fewtimes_if_linux()
def test_exe(self):
self.execute(self.proc.exe)
@fewtimes_if_linux()
def test_ppid(self):
self.execute(self.proc.ppid)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@fewtimes_if_linux()
def test_uids(self):
self.execute(self.proc.uids)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@fewtimes_if_linux()
def test_gids(self):
self.execute(self.proc.gids)
@fewtimes_if_linux()
def test_status(self):
self.execute(self.proc.status)
def test_nice(self):
self.execute(self.proc.nice)
def test_nice_set(self):
niceness = thisproc.nice()
self.execute(lambda: self.proc.nice(niceness))
@pytest.mark.skipif(not HAS_IONICE, reason="not supported")
def test_ionice(self):
self.execute(self.proc.ionice)
@pytest.mark.skipif(not HAS_IONICE, reason="not supported")
def test_ionice_set(self):
if WINDOWS:
value = thisproc.ionice()
self.execute(lambda: self.proc.ionice(value))
else:
self.execute(lambda: self.proc.ionice(psutil.IOPRIO_CLASS_NONE))
fun = functools.partial(cext.proc_ioprio_set, os.getpid(), -1, 0)
self.execute_w_exc(OSError, fun)
@pytest.mark.skipif(not HAS_PROC_IO_COUNTERS, reason="not supported")
@fewtimes_if_linux()
def test_io_counters(self):
self.execute(self.proc.io_counters)
@pytest.mark.skipif(POSIX, reason="worthless on POSIX")
def test_username(self):
# always open 1 handle on Windows (only once)
psutil.Process().username()
self.execute(self.proc.username)
@fewtimes_if_linux()
def test_create_time(self):
self.execute(self.proc.create_time)
@fewtimes_if_linux()
@skip_on_access_denied(only_if=OPENBSD)
def test_num_threads(self):
self.execute(self.proc.num_threads)
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
def test_num_handles(self):
self.execute(self.proc.num_handles)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@fewtimes_if_linux()
def test_num_fds(self):
self.execute(self.proc.num_fds)
@fewtimes_if_linux()
def test_num_ctx_switches(self):
self.execute(self.proc.num_ctx_switches)
@fewtimes_if_linux()
@skip_on_access_denied(only_if=OPENBSD)
def test_threads(self):
self.execute(self.proc.threads)
@fewtimes_if_linux()
def test_cpu_times(self):
self.execute(self.proc.cpu_times)
@fewtimes_if_linux()
@pytest.mark.skipif(not HAS_PROC_CPU_NUM, reason="not supported")
def test_cpu_num(self):
self.execute(self.proc.cpu_num)
@fewtimes_if_linux()
def test_memory_info(self):
self.execute(self.proc.memory_info)
@fewtimes_if_linux()
def test_memory_full_info(self):
self.execute(self.proc.memory_full_info)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@fewtimes_if_linux()
def test_terminal(self):
self.execute(self.proc.terminal)
def test_resume(self):
times = FEW_TIMES if POSIX else self.times
self.execute(self.proc.resume, times=times)
@fewtimes_if_linux()
def test_cwd(self):
self.execute(self.proc.cwd)
@pytest.mark.skipif(not HAS_CPU_AFFINITY, reason="not supported")
def test_cpu_affinity(self):
self.execute(self.proc.cpu_affinity)
@pytest.mark.skipif(not HAS_CPU_AFFINITY, reason="not supported")
def test_cpu_affinity_set(self):
affinity = thisproc.cpu_affinity()
self.execute(lambda: self.proc.cpu_affinity(affinity))
self.execute_w_exc(ValueError, lambda: self.proc.cpu_affinity([-1]))
@fewtimes_if_linux()
def test_open_files(self):
with open(get_testfn(), 'w'):
self.execute(self.proc.open_files)
@pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
@fewtimes_if_linux()
def test_memory_maps(self):
self.execute(self.proc.memory_maps)
@pytest.mark.skipif(not LINUX, reason="LINUX only")
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit(self):
self.execute(lambda: self.proc.rlimit(psutil.RLIMIT_NOFILE))
@pytest.mark.skipif(not LINUX, reason="LINUX only")
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_set(self):
limit = thisproc.rlimit(psutil.RLIMIT_NOFILE)
self.execute(lambda: self.proc.rlimit(psutil.RLIMIT_NOFILE, limit))
self.execute_w_exc((OSError, ValueError), lambda: self.proc.rlimit(-1))
@fewtimes_if_linux()
# Windows implementation is based on a single system-wide
# function (tested later).
@pytest.mark.skipif(WINDOWS, reason="worthless on WINDOWS")
def test_net_connections(self):
# TODO: UNIX sockets are temporarily implemented by parsing
# 'pfiles' cmd output; we don't want that part of the code to
# be executed.
with create_sockets():
kind = 'inet' if SUNOS else 'all'
self.execute(lambda: self.proc.net_connections(kind))
@pytest.mark.skipif(not HAS_ENVIRON, reason="not supported")
def test_environ(self):
self.execute(self.proc.environ)
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
def test_proc_info(self):
self.execute(lambda: cext.proc_info(os.getpid()))
class TestTerminatedProcessLeaks(TestProcessObjectLeaks):
"""Repeat the tests above looking for leaks occurring when dealing
with terminated processes raising NoSuchProcess exception.
The C functions are still invoked but will follow different code
paths. We'll check those code paths.
"""
@classmethod
def setUpClass(cls):
super().setUpClass()
cls.subp = spawn_testproc()
cls.proc = psutil.Process(cls.subp.pid)
cls.proc.kill()
cls.proc.wait()
@classmethod
def tearDownClass(cls):
super().tearDownClass()
terminate(cls.subp)
def call(self, fun):
try:
fun()
except psutil.NoSuchProcess:
pass
if WINDOWS:
def test_kill(self):
self.execute(self.proc.kill)
def test_terminate(self):
self.execute(self.proc.terminate)
def test_suspend(self):
self.execute(self.proc.suspend)
def test_resume(self):
self.execute(self.proc.resume)
def test_wait(self):
self.execute(self.proc.wait)
def test_proc_info(self):
# test dual implementation
def call():
try:
return cext.proc_info(self.proc.pid)
except ProcessLookupError:
pass
self.execute(call)
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
class TestProcessDualImplementation(TestMemoryLeak):
def test_cmdline_peb_true(self):
self.execute(lambda: cext.proc_cmdline(os.getpid(), use_peb=True))
def test_cmdline_peb_false(self):
self.execute(lambda: cext.proc_cmdline(os.getpid(), use_peb=False))
# ===================================================================
# system APIs
# ===================================================================
class TestModuleFunctionsLeaks(TestMemoryLeak):
"""Test leaks of psutil module functions."""
def test_coverage(self):
ns = system_namespace()
ns.test_class_coverage(self, ns.all)
# --- cpu
@fewtimes_if_linux()
def test_cpu_count(self): # logical
self.execute(lambda: psutil.cpu_count(logical=True))
@fewtimes_if_linux()
def test_cpu_count_cores(self):
self.execute(lambda: psutil.cpu_count(logical=False))
@fewtimes_if_linux()
def test_cpu_times(self):
self.execute(psutil.cpu_times)
@fewtimes_if_linux()
def test_per_cpu_times(self):
self.execute(lambda: psutil.cpu_times(percpu=True))
@fewtimes_if_linux()
def test_cpu_stats(self):
self.execute(psutil.cpu_stats)
@fewtimes_if_linux()
# TODO: remove this once 1892 is fixed
@pytest.mark.skipif(
MACOS and platform.machine() == 'arm64', reason="skipped due to #1892"
)
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_cpu_freq(self):
self.execute(psutil.cpu_freq)
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
def test_getloadavg(self):
psutil.getloadavg()
self.execute(psutil.getloadavg)
# --- mem
def test_virtual_memory(self):
self.execute(psutil.virtual_memory)
# TODO: remove this skip when this gets fixed
@pytest.mark.skipif(SUNOS, reason="worthless on SUNOS (uses a subprocess)")
def test_swap_memory(self):
self.execute(psutil.swap_memory)
def test_pid_exists(self):
times = FEW_TIMES if POSIX else self.times
self.execute(lambda: psutil.pid_exists(os.getpid()), times=times)
# --- disk
def test_disk_usage(self):
times = FEW_TIMES if POSIX else self.times
self.execute(lambda: psutil.disk_usage('.'), times=times)
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_disk_partitions(self):
self.execute(psutil.disk_partitions)
@pytest.mark.skipif(
LINUX and not os.path.exists('/proc/diskstats'),
reason="/proc/diskstats not available on this Linux version",
)
@fewtimes_if_linux()
def test_disk_io_counters(self):
self.execute(lambda: psutil.disk_io_counters(nowrap=False))
# --- proc
@fewtimes_if_linux()
def test_pids(self):
self.execute(psutil.pids)
# --- net
@fewtimes_if_linux()
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_net_io_counters(self):
self.execute(lambda: psutil.net_io_counters(nowrap=False))
@fewtimes_if_linux()
@pytest.mark.skipif(MACOS and os.getuid() != 0, reason="need root access")
def test_net_connections(self):
# always opens and handle on Windows() (once)
psutil.net_connections(kind='all')
with create_sockets():
self.execute(lambda: psutil.net_connections(kind='all'))
def test_net_if_addrs(self):
# Note: verified that on Windows this was a false positive.
tolerance = 80 * 1024 if WINDOWS else self.tolerance
self.execute(psutil.net_if_addrs, tolerance=tolerance)
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_net_if_stats(self):
self.execute(psutil.net_if_stats)
# --- sensors
@fewtimes_if_linux()
@pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
def test_sensors_battery(self):
self.execute(psutil.sensors_battery)
@fewtimes_if_linux()
@pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
def test_sensors_temperatures(self):
self.execute(psutil.sensors_temperatures)
@fewtimes_if_linux()
@pytest.mark.skipif(not HAS_SENSORS_FANS, reason="not supported")
def test_sensors_fans(self):
self.execute(psutil.sensors_fans)
# --- others
@fewtimes_if_linux()
def test_boot_time(self):
self.execute(psutil.boot_time)
def test_users(self):
self.execute(psutil.users)
def test_set_debug(self):
self.execute(lambda: psutil._set_debug(False))
if WINDOWS:
# --- win services
def test_win_service_iter(self):
self.execute(cext.winservice_enumerate)
def test_win_service_get(self):
pass
def test_win_service_get_config(self):
name = next(psutil.win_service_iter()).name()
self.execute(lambda: cext.winservice_query_config(name))
def test_win_service_get_status(self):
name = next(psutil.win_service_iter()).name()
self.execute(lambda: cext.winservice_query_status(name))
def test_win_service_get_description(self):
name = next(psutil.win_service_iter()).name()
self.execute(lambda: cext.winservice_query_descr(name))
PK ok\���H!1 !1 psutil/tests/test_contracts.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Contracts tests. These tests mainly check API sanity in terms of
returned types and APIs availability.
Some of these are duplicates of tests test_system.py and test_process.py.
"""
import platform
import signal
import psutil
from psutil import AIX
from psutil import FREEBSD
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._compat import long
from psutil.tests import GITHUB_ACTIONS
from psutil.tests import HAS_CPU_FREQ
from psutil.tests import HAS_NET_IO_COUNTERS
from psutil.tests import HAS_SENSORS_FANS
from psutil.tests import HAS_SENSORS_TEMPERATURES
from psutil.tests import PYPY
from psutil.tests import QEMU_USER
from psutil.tests import SKIP_SYSCONS
from psutil.tests import PsutilTestCase
from psutil.tests import create_sockets
from psutil.tests import enum
from psutil.tests import is_namedtuple
from psutil.tests import kernel_version
from psutil.tests import pytest
# ===================================================================
# --- APIs availability
# ===================================================================
# Make sure code reflects what doc promises in terms of APIs
# availability.
class TestAvailConstantsAPIs(PsutilTestCase):
def test_PROCFS_PATH(self):
assert hasattr(psutil, "PROCFS_PATH") == (LINUX or SUNOS or AIX)
def test_win_priority(self):
ae = self.assertEqual
ae(hasattr(psutil, "ABOVE_NORMAL_PRIORITY_CLASS"), WINDOWS)
ae(hasattr(psutil, "BELOW_NORMAL_PRIORITY_CLASS"), WINDOWS)
ae(hasattr(psutil, "HIGH_PRIORITY_CLASS"), WINDOWS)
ae(hasattr(psutil, "IDLE_PRIORITY_CLASS"), WINDOWS)
ae(hasattr(psutil, "NORMAL_PRIORITY_CLASS"), WINDOWS)
ae(hasattr(psutil, "REALTIME_PRIORITY_CLASS"), WINDOWS)
def test_linux_ioprio_linux(self):
ae = self.assertEqual
ae(hasattr(psutil, "IOPRIO_CLASS_NONE"), LINUX)
ae(hasattr(psutil, "IOPRIO_CLASS_RT"), LINUX)
ae(hasattr(psutil, "IOPRIO_CLASS_BE"), LINUX)
ae(hasattr(psutil, "IOPRIO_CLASS_IDLE"), LINUX)
def test_linux_ioprio_windows(self):
ae = self.assertEqual
ae(hasattr(psutil, "IOPRIO_HIGH"), WINDOWS)
ae(hasattr(psutil, "IOPRIO_NORMAL"), WINDOWS)
ae(hasattr(psutil, "IOPRIO_LOW"), WINDOWS)
ae(hasattr(psutil, "IOPRIO_VERYLOW"), WINDOWS)
@pytest.mark.skipif(
GITHUB_ACTIONS and LINUX,
reason="unsupported on GITHUB_ACTIONS + LINUX",
)
def test_rlimit(self):
ae = self.assertEqual
ae(hasattr(psutil, "RLIM_INFINITY"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_AS"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_CORE"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_CPU"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_DATA"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_FSIZE"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_MEMLOCK"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_NOFILE"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_NPROC"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_RSS"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_STACK"), LINUX or FREEBSD)
ae(hasattr(psutil, "RLIMIT_LOCKS"), LINUX)
if POSIX:
if kernel_version() >= (2, 6, 8):
ae(hasattr(psutil, "RLIMIT_MSGQUEUE"), LINUX)
if kernel_version() >= (2, 6, 12):
ae(hasattr(psutil, "RLIMIT_NICE"), LINUX)
if kernel_version() >= (2, 6, 12):
ae(hasattr(psutil, "RLIMIT_RTPRIO"), LINUX)
if kernel_version() >= (2, 6, 25):
ae(hasattr(psutil, "RLIMIT_RTTIME"), LINUX)
if kernel_version() >= (2, 6, 8):
ae(hasattr(psutil, "RLIMIT_SIGPENDING"), LINUX)
ae(hasattr(psutil, "RLIMIT_SWAP"), FREEBSD)
ae(hasattr(psutil, "RLIMIT_SBSIZE"), FREEBSD)
ae(hasattr(psutil, "RLIMIT_NPTS"), FREEBSD)
class TestAvailSystemAPIs(PsutilTestCase):
def test_win_service_iter(self):
assert hasattr(psutil, "win_service_iter") == WINDOWS
def test_win_service_get(self):
assert hasattr(psutil, "win_service_get") == WINDOWS
def test_cpu_freq(self):
assert hasattr(psutil, "cpu_freq") == (
LINUX or MACOS or WINDOWS or FREEBSD or OPENBSD
)
def test_sensors_temperatures(self):
assert hasattr(psutil, "sensors_temperatures") == (LINUX or FREEBSD)
def test_sensors_fans(self):
assert hasattr(psutil, "sensors_fans") == LINUX
def test_battery(self):
assert hasattr(psutil, "sensors_battery") == (
LINUX or WINDOWS or FREEBSD or MACOS
)
class TestAvailProcessAPIs(PsutilTestCase):
def test_environ(self):
assert hasattr(psutil.Process, "environ") == (
LINUX
or MACOS
or WINDOWS
or AIX
or SUNOS
or FREEBSD
or OPENBSD
or NETBSD
)
def test_uids(self):
assert hasattr(psutil.Process, "uids") == POSIX
def test_gids(self):
assert hasattr(psutil.Process, "uids") == POSIX
def test_terminal(self):
assert hasattr(psutil.Process, "terminal") == POSIX
def test_ionice(self):
assert hasattr(psutil.Process, "ionice") == (LINUX or WINDOWS)
@pytest.mark.skipif(
GITHUB_ACTIONS and LINUX,
reason="unsupported on GITHUB_ACTIONS + LINUX",
)
def test_rlimit(self):
assert hasattr(psutil.Process, "rlimit") == (LINUX or FREEBSD)
def test_io_counters(self):
hasit = hasattr(psutil.Process, "io_counters")
assert hasit == (not (MACOS or SUNOS))
def test_num_fds(self):
assert hasattr(psutil.Process, "num_fds") == POSIX
def test_num_handles(self):
assert hasattr(psutil.Process, "num_handles") == WINDOWS
def test_cpu_affinity(self):
assert hasattr(psutil.Process, "cpu_affinity") == (
LINUX or WINDOWS or FREEBSD
)
def test_cpu_num(self):
assert hasattr(psutil.Process, "cpu_num") == (
LINUX or FREEBSD or SUNOS
)
def test_memory_maps(self):
hasit = hasattr(psutil.Process, "memory_maps")
assert hasit == (not (OPENBSD or NETBSD or AIX or MACOS))
# ===================================================================
# --- API types
# ===================================================================
class TestSystemAPITypes(PsutilTestCase):
"""Check the return types of system related APIs.
Mainly we want to test we never return unicode on Python 2, see:
https://github.com/giampaolo/psutil/issues/1039.
"""
@classmethod
def setUpClass(cls):
cls.proc = psutil.Process()
def assert_ntuple_of_nums(self, nt, type_=float, gezero=True):
assert is_namedtuple(nt)
for n in nt:
assert isinstance(n, type_)
if gezero:
assert n >= 0
def test_cpu_times(self):
self.assert_ntuple_of_nums(psutil.cpu_times())
for nt in psutil.cpu_times(percpu=True):
self.assert_ntuple_of_nums(nt)
def test_cpu_percent(self):
assert isinstance(psutil.cpu_percent(interval=None), float)
assert isinstance(psutil.cpu_percent(interval=0.00001), float)
def test_cpu_times_percent(self):
self.assert_ntuple_of_nums(psutil.cpu_times_percent(interval=None))
self.assert_ntuple_of_nums(psutil.cpu_times_percent(interval=0.0001))
def test_cpu_count(self):
assert isinstance(psutil.cpu_count(), int)
# TODO: remove this once 1892 is fixed
@pytest.mark.skipif(
MACOS and platform.machine() == 'arm64', reason="skipped due to #1892"
)
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_cpu_freq(self):
if psutil.cpu_freq() is None:
raise pytest.skip("cpu_freq() returns None")
self.assert_ntuple_of_nums(psutil.cpu_freq(), type_=(float, int, long))
def test_disk_io_counters(self):
# Duplicate of test_system.py. Keep it anyway.
for k, v in psutil.disk_io_counters(perdisk=True).items():
assert isinstance(k, str)
self.assert_ntuple_of_nums(v, type_=(int, long))
def test_disk_partitions(self):
# Duplicate of test_system.py. Keep it anyway.
for disk in psutil.disk_partitions():
assert isinstance(disk.device, str)
assert isinstance(disk.mountpoint, str)
assert isinstance(disk.fstype, str)
assert isinstance(disk.opts, str)
@pytest.mark.skipif(SKIP_SYSCONS, reason="requires root")
def test_net_connections(self):
with create_sockets():
ret = psutil.net_connections('all')
assert len(ret) == len(set(ret))
for conn in ret:
assert is_namedtuple(conn)
def test_net_if_addrs(self):
# Duplicate of test_system.py. Keep it anyway.
for ifname, addrs in psutil.net_if_addrs().items():
assert isinstance(ifname, str)
for addr in addrs:
if enum is not None and not PYPY:
assert isinstance(addr.family, enum.IntEnum)
else:
assert isinstance(addr.family, int)
assert isinstance(addr.address, str)
assert isinstance(addr.netmask, (str, type(None)))
assert isinstance(addr.broadcast, (str, type(None)))
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_net_if_stats(self):
# Duplicate of test_system.py. Keep it anyway.
for ifname, info in psutil.net_if_stats().items():
assert isinstance(ifname, str)
assert isinstance(info.isup, bool)
if enum is not None:
assert isinstance(info.duplex, enum.IntEnum)
else:
assert isinstance(info.duplex, int)
assert isinstance(info.speed, int)
assert isinstance(info.mtu, int)
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_net_io_counters(self):
# Duplicate of test_system.py. Keep it anyway.
for ifname in psutil.net_io_counters(pernic=True):
assert isinstance(ifname, str)
@pytest.mark.skipif(not HAS_SENSORS_FANS, reason="not supported")
def test_sensors_fans(self):
# Duplicate of test_system.py. Keep it anyway.
for name, units in psutil.sensors_fans().items():
assert isinstance(name, str)
for unit in units:
assert isinstance(unit.label, str)
assert isinstance(unit.current, (float, int, type(None)))
@pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
def test_sensors_temperatures(self):
# Duplicate of test_system.py. Keep it anyway.
for name, units in psutil.sensors_temperatures().items():
assert isinstance(name, str)
for unit in units:
assert isinstance(unit.label, str)
assert isinstance(unit.current, (float, int, type(None)))
assert isinstance(unit.high, (float, int, type(None)))
assert isinstance(unit.critical, (float, int, type(None)))
def test_boot_time(self):
# Duplicate of test_system.py. Keep it anyway.
assert isinstance(psutil.boot_time(), float)
def test_users(self):
# Duplicate of test_system.py. Keep it anyway.
for user in psutil.users():
assert isinstance(user.name, str)
assert isinstance(user.terminal, (str, type(None)))
assert isinstance(user.host, (str, type(None)))
assert isinstance(user.pid, (int, type(None)))
class TestProcessWaitType(PsutilTestCase):
@pytest.mark.skipif(not POSIX, reason="not POSIX")
def test_negative_signal(self):
p = psutil.Process(self.spawn_testproc().pid)
p.terminate()
code = p.wait()
assert code == -signal.SIGTERM
if enum is not None:
assert isinstance(code, enum.IntEnum)
else:
assert isinstance(code, int)
PK ok\ ��c�H �H psutil/tests/test_process_all.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Iterate over all process PIDs and for each one of them invoke and
test all psutil.Process() methods.
"""
import enum
import errno
import multiprocessing
import os
import stat
import time
import traceback
import psutil
from psutil import AIX
from psutil import BSD
from psutil import FREEBSD
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import OSX
from psutil import POSIX
from psutil import WINDOWS
from psutil._compat import PY3
from psutil._compat import FileNotFoundError
from psutil._compat import long
from psutil._compat import unicode
from psutil.tests import CI_TESTING
from psutil.tests import PYTEST_PARALLEL
from psutil.tests import QEMU_USER
from psutil.tests import VALID_PROC_STATUSES
from psutil.tests import PsutilTestCase
from psutil.tests import check_connection_ntuple
from psutil.tests import create_sockets
from psutil.tests import is_namedtuple
from psutil.tests import is_win_secure_system_proc
from psutil.tests import process_namespace
from psutil.tests import pytest
# Cuts the time in half, but (e.g.) on macOS the process pool stays
# alive after join() (multiprocessing bug?), messing up other tests.
USE_PROC_POOL = LINUX and not CI_TESTING and not PYTEST_PARALLEL
def proc_info(pid):
tcase = PsutilTestCase()
def check_exception(exc, proc, name, ppid):
tcase.assertEqual(exc.pid, pid)
if exc.name is not None:
tcase.assertEqual(exc.name, name)
if isinstance(exc, psutil.ZombieProcess):
tcase.assertProcessZombie(proc)
if exc.ppid is not None:
tcase.assertGreaterEqual(exc.ppid, 0)
tcase.assertEqual(exc.ppid, ppid)
elif isinstance(exc, psutil.NoSuchProcess):
tcase.assertProcessGone(proc)
str(exc)
repr(exc)
def do_wait():
if pid != 0:
try:
proc.wait(0)
except psutil.Error as exc:
check_exception(exc, proc, name, ppid)
try:
proc = psutil.Process(pid)
except psutil.NoSuchProcess:
tcase.assertPidGone(pid)
return {}
try:
d = proc.as_dict(['ppid', 'name'])
except psutil.NoSuchProcess:
tcase.assertProcessGone(proc)
else:
name, ppid = d['name'], d['ppid']
info = {'pid': proc.pid}
ns = process_namespace(proc)
# We don't use oneshot() because in order not to fool
# check_exception() in case of NSP.
for fun, fun_name in ns.iter(ns.getters, clear_cache=False):
try:
info[fun_name] = fun()
except psutil.Error as exc:
check_exception(exc, proc, name, ppid)
continue
do_wait()
return info
class TestFetchAllProcesses(PsutilTestCase):
"""Test which iterates over all running processes and performs
some sanity checks against Process API's returned values.
Uses a process pool to get info about all processes.
"""
def setUp(self):
psutil._set_debug(False)
# Using a pool in a CI env may result in deadlock, see:
# https://github.com/giampaolo/psutil/issues/2104
if USE_PROC_POOL:
self.pool = multiprocessing.Pool()
def tearDown(self):
psutil._set_debug(True)
if USE_PROC_POOL:
self.pool.terminate()
self.pool.join()
def iter_proc_info(self):
# Fixes "can't pickle <function proc_info>: it's not the
# same object as test_process_all.proc_info".
from psutil.tests.test_process_all import proc_info
if USE_PROC_POOL:
return self.pool.imap_unordered(proc_info, psutil.pids())
else:
ls = []
for pid in psutil.pids():
ls.append(proc_info(pid))
return ls
def test_all(self):
failures = []
for info in self.iter_proc_info():
for name, value in info.items():
meth = getattr(self, name)
try:
meth(value, info)
except Exception: # noqa: BLE001
s = '\n' + '=' * 70 + '\n'
s += "FAIL: name=test_%s, pid=%s, ret=%s\ninfo=%s\n" % (
name,
info['pid'],
repr(value),
info,
)
s += '-' * 70
s += "\n%s" % traceback.format_exc()
s = "\n".join((" " * 4) + i for i in s.splitlines()) + "\n"
failures.append(s)
else:
if value not in (0, 0.0, [], None, '', {}):
assert value, value
if failures:
raise self.fail(''.join(failures))
def cmdline(self, ret, info):
assert isinstance(ret, list)
for part in ret:
assert isinstance(part, str)
def exe(self, ret, info):
assert isinstance(ret, (str, unicode))
assert ret.strip() == ret
if ret:
if WINDOWS and not ret.endswith('.exe'):
return # May be "Registry", "MemCompression", ...
assert os.path.isabs(ret), ret
# Note: os.stat() may return False even if the file is there
# hence we skip the test, see:
# http://stackoverflow.com/questions/3112546/os-path-exists-lies
if POSIX and os.path.isfile(ret):
if hasattr(os, 'access') and hasattr(os, "X_OK"):
# XXX: may fail on MACOS
try:
assert os.access(ret, os.X_OK)
except AssertionError:
if os.path.exists(ret) and not CI_TESTING:
raise
def pid(self, ret, info):
assert isinstance(ret, int)
assert ret >= 0
def ppid(self, ret, info):
assert isinstance(ret, (int, long))
assert ret >= 0
proc_info(ret)
def name(self, ret, info):
assert isinstance(ret, (str, unicode))
if WINDOWS and not ret and is_win_secure_system_proc(info['pid']):
# https://github.com/giampaolo/psutil/issues/2338
return
# on AIX, "<exiting>" processes don't have names
if not AIX:
assert ret, repr(ret)
def create_time(self, ret, info):
assert isinstance(ret, float)
try:
assert ret >= 0
except AssertionError:
# XXX
if OPENBSD and info['status'] == psutil.STATUS_ZOMBIE:
pass
else:
raise
# this can't be taken for granted on all platforms
# self.assertGreaterEqual(ret, psutil.boot_time())
# make sure returned value can be pretty printed
# with strftime
time.strftime("%Y %m %d %H:%M:%S", time.localtime(ret))
def uids(self, ret, info):
assert is_namedtuple(ret)
for uid in ret:
assert isinstance(uid, int)
assert uid >= 0
def gids(self, ret, info):
assert is_namedtuple(ret)
# note: testing all gids as above seems not to be reliable for
# gid == 30 (nodoby); not sure why.
for gid in ret:
assert isinstance(gid, int)
if not MACOS and not NETBSD:
assert gid >= 0
def username(self, ret, info):
assert isinstance(ret, str)
assert ret.strip() == ret
assert ret.strip()
def status(self, ret, info):
assert isinstance(ret, str)
assert ret, ret
if QEMU_USER:
# status does not work under qemu user
return
assert ret != '?' # XXX
assert ret in VALID_PROC_STATUSES
def io_counters(self, ret, info):
assert is_namedtuple(ret)
for field in ret:
assert isinstance(field, (int, long))
if field != -1:
assert field >= 0
def ionice(self, ret, info):
if LINUX:
assert isinstance(ret.ioclass, int)
assert isinstance(ret.value, int)
assert ret.ioclass >= 0
assert ret.value >= 0
else: # Windows, Cygwin
choices = [
psutil.IOPRIO_VERYLOW,
psutil.IOPRIO_LOW,
psutil.IOPRIO_NORMAL,
psutil.IOPRIO_HIGH,
]
assert isinstance(ret, int)
assert ret >= 0
assert ret in choices
def num_threads(self, ret, info):
assert isinstance(ret, int)
if WINDOWS and ret == 0 and is_win_secure_system_proc(info['pid']):
# https://github.com/giampaolo/psutil/issues/2338
return
assert ret >= 1
def threads(self, ret, info):
assert isinstance(ret, list)
for t in ret:
assert is_namedtuple(t)
assert t.id >= 0
assert t.user_time >= 0
assert t.system_time >= 0
for field in t:
assert isinstance(field, (int, float))
def cpu_times(self, ret, info):
assert is_namedtuple(ret)
for n in ret:
assert isinstance(n, float)
assert n >= 0
# TODO: check ntuple fields
def cpu_percent(self, ret, info):
assert isinstance(ret, float)
assert 0.0 <= ret <= 100.0, ret
def cpu_num(self, ret, info):
assert isinstance(ret, int)
if FREEBSD and ret == -1:
return
assert ret >= 0
if psutil.cpu_count() == 1:
assert ret == 0
assert ret in list(range(psutil.cpu_count()))
def memory_info(self, ret, info):
assert is_namedtuple(ret)
for value in ret:
assert isinstance(value, (int, long))
assert value >= 0
if WINDOWS:
assert ret.peak_wset >= ret.wset
assert ret.peak_paged_pool >= ret.paged_pool
assert ret.peak_nonpaged_pool >= ret.nonpaged_pool
assert ret.peak_pagefile >= ret.pagefile
def memory_full_info(self, ret, info):
assert is_namedtuple(ret)
total = psutil.virtual_memory().total
for name in ret._fields:
value = getattr(ret, name)
assert isinstance(value, (int, long))
assert value >= 0
if LINUX or (OSX and name in ('vms', 'data')):
# On Linux there are processes (e.g. 'goa-daemon') whose
# VMS is incredibly high for some reason.
continue
assert value <= total, name
if LINUX:
assert ret.pss >= ret.uss
def open_files(self, ret, info):
assert isinstance(ret, list)
for f in ret:
assert isinstance(f.fd, int)
assert isinstance(f.path, str)
assert f.path.strip() == f.path
if WINDOWS:
assert f.fd == -1
elif LINUX:
assert isinstance(f.position, int)
assert isinstance(f.mode, str)
assert isinstance(f.flags, int)
assert f.position >= 0
assert f.mode in ('r', 'w', 'a', 'r+', 'a+')
assert f.flags > 0
elif BSD and not f.path:
# XXX see: https://github.com/giampaolo/psutil/issues/595
continue
assert os.path.isabs(f.path), f
try:
st = os.stat(f.path)
except FileNotFoundError:
pass
else:
assert stat.S_ISREG(st.st_mode), f
def num_fds(self, ret, info):
assert isinstance(ret, int)
assert ret >= 0
def net_connections(self, ret, info):
with create_sockets():
assert len(ret) == len(set(ret))
for conn in ret:
assert is_namedtuple(conn)
check_connection_ntuple(conn)
def cwd(self, ret, info):
assert isinstance(ret, (str, unicode))
assert ret.strip() == ret
if ret:
assert os.path.isabs(ret), ret
try:
st = os.stat(ret)
except OSError as err:
if WINDOWS and psutil._psplatform.is_permission_err(err):
pass
# directory has been removed in mean time
elif err.errno != errno.ENOENT:
raise
else:
assert stat.S_ISDIR(st.st_mode)
def memory_percent(self, ret, info):
assert isinstance(ret, float)
assert 0 <= ret <= 100, ret
def is_running(self, ret, info):
assert isinstance(ret, bool)
def cpu_affinity(self, ret, info):
assert isinstance(ret, list)
assert ret != []
cpus = list(range(psutil.cpu_count()))
for n in ret:
assert isinstance(n, int)
assert n in cpus
def terminal(self, ret, info):
assert isinstance(ret, (str, type(None)))
if ret is not None:
assert os.path.isabs(ret), ret
assert os.path.exists(ret), ret
def memory_maps(self, ret, info):
for nt in ret:
assert isinstance(nt.addr, str)
assert isinstance(nt.perms, str)
assert isinstance(nt.path, str)
for fname in nt._fields:
value = getattr(nt, fname)
if fname == 'path':
if not value.startswith(("[", "anon_inode:")):
assert os.path.isabs(nt.path), nt.path
# commented as on Linux we might get
# '/foo/bar (deleted)'
# assert os.path.exists(nt.path), nt.path
elif fname == 'addr':
assert value, repr(value)
elif fname == 'perms':
if not WINDOWS:
assert value, repr(value)
else:
assert isinstance(value, (int, long))
assert value >= 0
def num_handles(self, ret, info):
assert isinstance(ret, int)
assert ret >= 0
def nice(self, ret, info):
assert isinstance(ret, int)
if POSIX:
assert -20 <= ret <= 20, ret
else:
priorities = [
getattr(psutil, x)
for x in dir(psutil)
if x.endswith('_PRIORITY_CLASS')
]
assert ret in priorities
if PY3:
assert isinstance(ret, enum.IntEnum)
else:
assert isinstance(ret, int)
def num_ctx_switches(self, ret, info):
assert is_namedtuple(ret)
for value in ret:
assert isinstance(value, (int, long))
assert value >= 0
def rlimit(self, ret, info):
assert isinstance(ret, tuple)
assert len(ret) == 2
assert ret[0] >= -1
assert ret[1] >= -1
def environ(self, ret, info):
assert isinstance(ret, dict)
for k, v in ret.items():
assert isinstance(k, str)
assert isinstance(v, str)
class TestPidsRange(PsutilTestCase):
"""Given pid_exists() return value for a range of PIDs which may or
may not exist, make sure that psutil.Process() and psutil.pids()
agree with pid_exists(). This guarantees that the 3 APIs are all
consistent with each other. See:
https://github.com/giampaolo/psutil/issues/2359
XXX - Note about Windows: it turns out there are some "hidden" PIDs
which are not returned by psutil.pids() and are also not revealed
by taskmgr.exe and ProcessHacker, still they can be instantiated by
psutil.Process() and queried. One of such PIDs is "conhost.exe".
Running as_dict() for it reveals that some Process() APIs
erroneously raise NoSuchProcess, so we know we have problem there.
Let's ignore this for now, since it's quite a corner case (who even
imagined hidden PIDs existed on Windows?).
"""
def setUp(self):
psutil._set_debug(False)
def tearDown(self):
psutil._set_debug(True)
def test_it(self):
def is_linux_tid(pid):
try:
f = open("/proc/%s/status" % pid, "rb")
except FileNotFoundError:
return False
else:
with f:
for line in f:
if line.startswith(b"Tgid:"):
tgid = int(line.split()[1])
# If tgid and pid are different then we're
# dealing with a process TID.
return tgid != pid
raise ValueError("'Tgid' line not found")
def check(pid):
# In case of failure retry up to 3 times in order to avoid
# race conditions, especially when running in a CI
# environment where PIDs may appear and disappear at any
# time.
x = 3
while True:
exists = psutil.pid_exists(pid)
try:
if exists:
psutil.Process(pid)
if not WINDOWS: # see docstring
assert pid in psutil.pids()
else:
# On OpenBSD thread IDs can be instantiated,
# and oneshot() succeeds, but other APIs fail
# with EINVAL.
if not OPENBSD:
with pytest.raises(psutil.NoSuchProcess):
psutil.Process(pid)
if not WINDOWS: # see docstring
assert pid not in psutil.pids()
except (psutil.Error, AssertionError):
x -= 1
if x == 0:
raise
else:
return
for pid in range(1, 3000):
if LINUX and is_linux_tid(pid):
# On Linux a TID (thread ID) can be passed to the
# Process class and is querable like a PID (process
# ID). Skip it.
continue
with self.subTest(pid=pid):
check(pid)
PK ok\Z��� � psutil/tests/__init__.pynu �[��� # -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Test utilities."""
from __future__ import print_function
import atexit
import contextlib
import ctypes
import errno
import functools
import gc
import os
import platform
import random
import re
import select
import shlex
import shutil
import signal
import socket
import stat
import subprocess
import sys
import tempfile
import textwrap
import threading
import time
import unittest
import warnings
from socket import AF_INET
from socket import AF_INET6
from socket import SOCK_STREAM
try:
import pytest
except ImportError:
pytest = None
import psutil
from psutil import AIX
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._common import bytes2human
from psutil._common import debug
from psutil._common import memoize
from psutil._common import print_color
from psutil._common import supports_ipv6
from psutil._compat import PY3
from psutil._compat import FileExistsError
from psutil._compat import FileNotFoundError
from psutil._compat import range
from psutil._compat import super
from psutil._compat import unicode
from psutil._compat import which
try:
from unittest import mock # py3
except ImportError:
with warnings.catch_warnings():
warnings.simplefilter("ignore")
import mock # NOQA - requires "pip install mock"
if PY3:
import enum
else:
import unittest2 as unittest
enum = None
if POSIX:
from psutil._psposix import wait_pid
# fmt: off
__all__ = [
# constants
'APPVEYOR', 'DEVNULL', 'GLOBAL_TIMEOUT', 'TOLERANCE_SYS_MEM', 'NO_RETRIES',
'PYPY', 'PYTHON_EXE', 'PYTHON_EXE_ENV', 'ROOT_DIR', 'SCRIPTS_DIR',
'TESTFN_PREFIX', 'UNICODE_SUFFIX', 'INVALID_UNICODE_SUFFIX',
'CI_TESTING', 'VALID_PROC_STATUSES', 'TOLERANCE_DISK_USAGE', 'IS_64BIT',
"HAS_CPU_AFFINITY", "HAS_CPU_FREQ", "HAS_ENVIRON", "HAS_PROC_IO_COUNTERS",
"HAS_IONICE", "HAS_MEMORY_MAPS", "HAS_PROC_CPU_NUM", "HAS_RLIMIT",
"HAS_SENSORS_BATTERY", "HAS_BATTERY", "HAS_SENSORS_FANS",
"HAS_SENSORS_TEMPERATURES", "HAS_NET_CONNECTIONS_UNIX", "MACOS_11PLUS",
"MACOS_12PLUS", "COVERAGE", 'AARCH64', "QEMU_USER", "PYTEST_PARALLEL",
# subprocesses
'pyrun', 'terminate', 'reap_children', 'spawn_testproc', 'spawn_zombie',
'spawn_children_pair',
# threads
'ThreadTask',
# test utils
'unittest', 'skip_on_access_denied', 'skip_on_not_implemented',
'retry_on_failure', 'TestMemoryLeak', 'PsutilTestCase',
'process_namespace', 'system_namespace', 'print_sysinfo',
'is_win_secure_system_proc', 'fake_pytest',
# fs utils
'chdir', 'safe_rmpath', 'create_py_exe', 'create_c_exe', 'get_testfn',
# os
'get_winver', 'kernel_version',
# sync primitives
'call_until', 'wait_for_pid', 'wait_for_file',
# network
'check_net_address', 'filter_proc_net_connections',
'get_free_port', 'bind_socket', 'bind_unix_socket', 'tcp_socketpair',
'unix_socketpair', 'create_sockets',
# compat
'reload_module', 'import_module_by_path',
# others
'warn', 'copyload_shared_lib', 'is_namedtuple',
]
# fmt: on
# ===================================================================
# --- constants
# ===================================================================
# --- platforms
PYPY = '__pypy__' in sys.builtin_module_names
# whether we're running this test suite on a Continuous Integration service
APPVEYOR = 'APPVEYOR' in os.environ
GITHUB_ACTIONS = 'GITHUB_ACTIONS' in os.environ or 'CIBUILDWHEEL' in os.environ
CI_TESTING = APPVEYOR or GITHUB_ACTIONS
COVERAGE = 'COVERAGE_RUN' in os.environ
PYTEST_PARALLEL = "PYTEST_XDIST_WORKER" in os.environ # `make test-parallel`
if LINUX and GITHUB_ACTIONS:
with open('/proc/1/cmdline') as f:
QEMU_USER = "/bin/qemu-" in f.read()
else:
QEMU_USER = False
# are we a 64 bit process?
IS_64BIT = sys.maxsize > 2**32
AARCH64 = platform.machine() == "aarch64"
@memoize
def macos_version():
version_str = platform.mac_ver()[0]
version = tuple(map(int, version_str.split(".")[:2]))
if version == (10, 16):
# When built against an older macOS SDK, Python will report
# macOS 10.16 instead of the real version.
version_str = subprocess.check_output(
[
sys.executable,
"-sS",
"-c",
"import platform; print(platform.mac_ver()[0])",
],
env={"SYSTEM_VERSION_COMPAT": "0"},
universal_newlines=True,
)
version = tuple(map(int, version_str.split(".")[:2]))
return version
if MACOS:
MACOS_11PLUS = macos_version() > (10, 15)
MACOS_12PLUS = macos_version() >= (12, 0)
else:
MACOS_11PLUS = False
MACOS_12PLUS = False
# --- configurable defaults
# how many times retry_on_failure() decorator will retry
NO_RETRIES = 10
# bytes tolerance for system-wide related tests
TOLERANCE_SYS_MEM = 5 * 1024 * 1024 # 5MB
TOLERANCE_DISK_USAGE = 10 * 1024 * 1024 # 10MB
# the timeout used in functions which have to wait
GLOBAL_TIMEOUT = 5
# be more tolerant if we're on CI in order to avoid false positives
if CI_TESTING:
NO_RETRIES *= 3
GLOBAL_TIMEOUT *= 3
TOLERANCE_SYS_MEM *= 4
TOLERANCE_DISK_USAGE *= 3
# --- file names
# Disambiguate TESTFN for parallel testing.
if os.name == 'java':
# Jython disallows @ in module names
TESTFN_PREFIX = '$psutil-%s-' % os.getpid()
else:
TESTFN_PREFIX = '@psutil-%s-' % os.getpid()
UNICODE_SUFFIX = u"-ƒőő"
# An invalid unicode string.
if PY3:
INVALID_UNICODE_SUFFIX = b"f\xc0\x80".decode('utf8', 'surrogateescape')
else:
INVALID_UNICODE_SUFFIX = "f\xc0\x80"
ASCII_FS = sys.getfilesystemencoding().lower() in ('ascii', 'us-ascii')
# --- paths
ROOT_DIR = os.path.realpath(
os.path.join(os.path.dirname(__file__), '..', '..')
)
SCRIPTS_DIR = os.environ.get(
"PSUTIL_SCRIPTS_DIR", os.path.join(ROOT_DIR, 'scripts')
)
HERE = os.path.realpath(os.path.dirname(__file__))
# --- support
HAS_CPU_AFFINITY = hasattr(psutil.Process, "cpu_affinity")
HAS_CPU_FREQ = hasattr(psutil, "cpu_freq")
HAS_ENVIRON = hasattr(psutil.Process, "environ")
HAS_GETLOADAVG = hasattr(psutil, "getloadavg")
HAS_IONICE = hasattr(psutil.Process, "ionice")
HAS_MEMORY_MAPS = hasattr(psutil.Process, "memory_maps")
HAS_NET_CONNECTIONS_UNIX = POSIX and not SUNOS
HAS_NET_IO_COUNTERS = hasattr(psutil, "net_io_counters")
HAS_PROC_CPU_NUM = hasattr(psutil.Process, "cpu_num")
HAS_PROC_IO_COUNTERS = hasattr(psutil.Process, "io_counters")
HAS_RLIMIT = hasattr(psutil.Process, "rlimit")
HAS_SENSORS_BATTERY = hasattr(psutil, "sensors_battery")
try:
HAS_BATTERY = HAS_SENSORS_BATTERY and bool(psutil.sensors_battery())
except Exception: # noqa: BLE001
HAS_BATTERY = False
HAS_SENSORS_FANS = hasattr(psutil, "sensors_fans")
HAS_SENSORS_TEMPERATURES = hasattr(psutil, "sensors_temperatures")
HAS_THREADS = hasattr(psutil.Process, "threads")
SKIP_SYSCONS = (MACOS or AIX) and os.getuid() != 0
# --- misc
def _get_py_exe():
def attempt(exe):
try:
subprocess.check_call(
[exe, "-V"], stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
except subprocess.CalledProcessError:
return None
else:
return exe
env = os.environ.copy()
# On Windows, starting with python 3.7, virtual environments use a
# venv launcher startup process. This does not play well when
# counting spawned processes, or when relying on the PID of the
# spawned process to do some checks, e.g. connections check per PID.
# Let's use the base python in this case.
base = getattr(sys, "_base_executable", None)
if WINDOWS and sys.version_info >= (3, 7) and base is not None:
# We need to set __PYVENV_LAUNCHER__ to sys.executable for the
# base python executable to know about the environment.
env["__PYVENV_LAUNCHER__"] = sys.executable
return base, env
elif GITHUB_ACTIONS:
return sys.executable, env
elif MACOS:
exe = (
attempt(sys.executable)
or attempt(os.path.realpath(sys.executable))
or attempt(which("python%s.%s" % sys.version_info[:2]))
or attempt(psutil.Process().exe())
)
if not exe:
raise ValueError("can't find python exe real abspath")
return exe, env
else:
exe = os.path.realpath(sys.executable)
assert os.path.exists(exe), exe
return exe, env
PYTHON_EXE, PYTHON_EXE_ENV = _get_py_exe()
DEVNULL = open(os.devnull, 'r+')
atexit.register(DEVNULL.close)
VALID_PROC_STATUSES = [
getattr(psutil, x) for x in dir(psutil) if x.startswith('STATUS_')
]
AF_UNIX = getattr(socket, "AF_UNIX", object())
_subprocesses_started = set()
_pids_started = set()
# ===================================================================
# --- threads
# ===================================================================
class ThreadTask(threading.Thread):
"""A thread task which does nothing expect staying alive."""
def __init__(self):
super().__init__()
self._running = False
self._interval = 0.001
self._flag = threading.Event()
def __repr__(self):
name = self.__class__.__name__
return '<%s running=%s at %#x>' % (name, self._running, id(self))
def __enter__(self):
self.start()
return self
def __exit__(self, *args, **kwargs):
self.stop()
def start(self):
"""Start thread and keep it running until an explicit
stop() request. Polls for shutdown every 'timeout' seconds.
"""
if self._running:
raise ValueError("already started")
threading.Thread.start(self)
self._flag.wait()
def run(self):
self._running = True
self._flag.set()
while self._running:
time.sleep(self._interval)
def stop(self):
"""Stop thread execution and and waits until it is stopped."""
if not self._running:
raise ValueError("already stopped")
self._running = False
self.join()
# ===================================================================
# --- subprocesses
# ===================================================================
def _reap_children_on_err(fun):
@functools.wraps(fun)
def wrapper(*args, **kwargs):
try:
return fun(*args, **kwargs)
except Exception:
reap_children()
raise
return wrapper
@_reap_children_on_err
def spawn_testproc(cmd=None, **kwds):
"""Create a python subprocess which does nothing for some secs and
return it as a subprocess.Popen instance.
If "cmd" is specified that is used instead of python.
By default stdin and stdout are redirected to /dev/null.
It also attempts to make sure the process is in a reasonably
initialized state.
The process is registered for cleanup on reap_children().
"""
kwds.setdefault("stdin", DEVNULL)
kwds.setdefault("stdout", DEVNULL)
kwds.setdefault("cwd", os.getcwd())
kwds.setdefault("env", PYTHON_EXE_ENV)
if WINDOWS:
# Prevents the subprocess to open error dialogs. This will also
# cause stderr to be suppressed, which is suboptimal in order
# to debug broken tests.
CREATE_NO_WINDOW = 0x8000000
kwds.setdefault("creationflags", CREATE_NO_WINDOW)
if cmd is None:
testfn = get_testfn(dir=os.getcwd())
try:
safe_rmpath(testfn)
pyline = (
"import time;"
+ "open(r'%s', 'w').close();" % testfn
+ "[time.sleep(0.1) for x in range(100)];" # 10 secs
)
cmd = [PYTHON_EXE, "-c", pyline]
sproc = subprocess.Popen(cmd, **kwds)
_subprocesses_started.add(sproc)
wait_for_file(testfn, delete=True, empty=True)
finally:
safe_rmpath(testfn)
else:
sproc = subprocess.Popen(cmd, **kwds)
_subprocesses_started.add(sproc)
wait_for_pid(sproc.pid)
return sproc
@_reap_children_on_err
def spawn_children_pair():
"""Create a subprocess which creates another one as in:
A (us) -> B (child) -> C (grandchild).
Return a (child, grandchild) tuple.
The 2 processes are fully initialized and will live for 60 secs
and are registered for cleanup on reap_children().
"""
tfile = None
testfn = get_testfn(dir=os.getcwd())
try:
s = textwrap.dedent("""\
import subprocess, os, sys, time
s = "import os, time;"
s += "f = open('%s', 'w');"
s += "f.write(str(os.getpid()));"
s += "f.close();"
s += "[time.sleep(0.1) for x in range(100 * 6)];"
p = subprocess.Popen([r'%s', '-c', s])
p.wait()
""" % (os.path.basename(testfn), PYTHON_EXE))
# On Windows if we create a subprocess with CREATE_NO_WINDOW flag
# set (which is the default) a "conhost.exe" extra process will be
# spawned as a child. We don't want that.
if WINDOWS:
subp, tfile = pyrun(s, creationflags=0)
else:
subp, tfile = pyrun(s)
child = psutil.Process(subp.pid)
grandchild_pid = int(wait_for_file(testfn, delete=True, empty=False))
_pids_started.add(grandchild_pid)
grandchild = psutil.Process(grandchild_pid)
return (child, grandchild)
finally:
safe_rmpath(testfn)
if tfile is not None:
safe_rmpath(tfile)
def spawn_zombie():
"""Create a zombie process and return a (parent, zombie) process tuple.
In order to kill the zombie parent must be terminate()d first, then
zombie must be wait()ed on.
"""
assert psutil.POSIX
unix_file = get_testfn()
src = textwrap.dedent("""\
import os, sys, time, socket, contextlib
child_pid = os.fork()
if child_pid > 0:
time.sleep(3000)
else:
# this is the zombie process
s = socket.socket(socket.AF_UNIX)
with contextlib.closing(s):
s.connect('%s')
if sys.version_info < (3, ):
pid = str(os.getpid())
else:
pid = bytes(str(os.getpid()), 'ascii')
s.sendall(pid)
""" % unix_file)
tfile = None
sock = bind_unix_socket(unix_file)
try:
sock.settimeout(GLOBAL_TIMEOUT)
parent, tfile = pyrun(src)
conn, _ = sock.accept()
try:
select.select([conn.fileno()], [], [], GLOBAL_TIMEOUT)
zpid = int(conn.recv(1024))
_pids_started.add(zpid)
zombie = psutil.Process(zpid)
call_until(lambda: zombie.status() == psutil.STATUS_ZOMBIE)
return (parent, zombie)
finally:
conn.close()
finally:
sock.close()
safe_rmpath(unix_file)
if tfile is not None:
safe_rmpath(tfile)
@_reap_children_on_err
def pyrun(src, **kwds):
"""Run python 'src' code string in a separate interpreter.
Returns a subprocess.Popen instance and the test file where the source
code was written.
"""
kwds.setdefault("stdout", None)
kwds.setdefault("stderr", None)
srcfile = get_testfn()
try:
with open(srcfile, "w") as f:
f.write(src)
subp = spawn_testproc([PYTHON_EXE, f.name], **kwds)
wait_for_pid(subp.pid)
return (subp, srcfile)
except Exception:
safe_rmpath(srcfile)
raise
@_reap_children_on_err
def sh(cmd, **kwds):
"""Run cmd in a subprocess and return its output.
raises RuntimeError on error.
"""
# Prevents subprocess to open error dialogs in case of error.
flags = 0x8000000 if WINDOWS else 0
kwds.setdefault("stdout", subprocess.PIPE)
kwds.setdefault("stderr", subprocess.PIPE)
kwds.setdefault("universal_newlines", True)
kwds.setdefault("creationflags", flags)
if isinstance(cmd, str):
cmd = shlex.split(cmd)
p = subprocess.Popen(cmd, **kwds)
_subprocesses_started.add(p)
if PY3:
stdout, stderr = p.communicate(timeout=GLOBAL_TIMEOUT)
else:
stdout, stderr = p.communicate()
if p.returncode != 0:
raise RuntimeError(stdout + stderr)
if stderr:
warn(stderr)
if stdout.endswith('\n'):
stdout = stdout[:-1]
return stdout
def terminate(proc_or_pid, sig=signal.SIGTERM, wait_timeout=GLOBAL_TIMEOUT):
"""Terminate a process and wait() for it.
Process can be a PID or an instance of psutil.Process(),
subprocess.Popen() or psutil.Popen().
If it's a subprocess.Popen() or psutil.Popen() instance also closes
its stdin / stdout / stderr fds.
PID is wait()ed even if the process is already gone (kills zombies).
Does nothing if the process does not exist.
Return process exit status.
"""
def wait(proc, timeout):
if isinstance(proc, subprocess.Popen) and not PY3:
proc.wait()
else:
proc.wait(timeout)
if WINDOWS and isinstance(proc, subprocess.Popen):
# Otherwise PID may still hang around.
try:
return psutil.Process(proc.pid).wait(timeout)
except psutil.NoSuchProcess:
pass
def sendsig(proc, sig):
# XXX: otherwise the build hangs for some reason.
if MACOS and GITHUB_ACTIONS:
sig = signal.SIGKILL
# If the process received SIGSTOP, SIGCONT is necessary first,
# otherwise SIGTERM won't work.
if POSIX and sig != signal.SIGKILL:
proc.send_signal(signal.SIGCONT)
proc.send_signal(sig)
def term_subprocess_proc(proc, timeout):
try:
sendsig(proc, sig)
except OSError as err:
if WINDOWS and err.winerror == 6: # "invalid handle"
pass
elif err.errno != errno.ESRCH:
raise
return wait(proc, timeout)
def term_psutil_proc(proc, timeout):
try:
sendsig(proc, sig)
except psutil.NoSuchProcess:
pass
return wait(proc, timeout)
def term_pid(pid, timeout):
try:
proc = psutil.Process(pid)
except psutil.NoSuchProcess:
# Needed to kill zombies.
if POSIX:
return wait_pid(pid, timeout)
else:
return term_psutil_proc(proc, timeout)
def flush_popen(proc):
if proc.stdout:
proc.stdout.close()
if proc.stderr:
proc.stderr.close()
# Flushing a BufferedWriter may raise an error.
if proc.stdin:
proc.stdin.close()
p = proc_or_pid
try:
if isinstance(p, int):
return term_pid(p, wait_timeout)
elif isinstance(p, (psutil.Process, psutil.Popen)):
return term_psutil_proc(p, wait_timeout)
elif isinstance(p, subprocess.Popen):
return term_subprocess_proc(p, wait_timeout)
else:
raise TypeError("wrong type %r" % p)
finally:
if isinstance(p, (subprocess.Popen, psutil.Popen)):
flush_popen(p)
pid = p if isinstance(p, int) else p.pid
assert not psutil.pid_exists(pid), pid
def reap_children(recursive=False):
"""Terminate and wait() any subprocess started by this test suite
and any children currently running, ensuring that no processes stick
around to hog resources.
If recursive is True it also tries to terminate and wait()
all grandchildren started by this process.
"""
# Get the children here before terminating them, as in case of
# recursive=True we don't want to lose the intermediate reference
# pointing to the grandchildren.
children = psutil.Process().children(recursive=recursive)
# Terminate subprocess.Popen.
while _subprocesses_started:
subp = _subprocesses_started.pop()
terminate(subp)
# Collect started pids.
while _pids_started:
pid = _pids_started.pop()
terminate(pid)
# Terminate children.
if children:
for p in children:
terminate(p, wait_timeout=None)
_, alive = psutil.wait_procs(children, timeout=GLOBAL_TIMEOUT)
for p in alive:
warn("couldn't terminate process %r; attempting kill()" % p)
terminate(p, sig=signal.SIGKILL)
# ===================================================================
# --- OS
# ===================================================================
def kernel_version():
"""Return a tuple such as (2, 6, 36)."""
if not POSIX:
raise NotImplementedError("not POSIX")
s = ""
uname = os.uname()[2]
for c in uname:
if c.isdigit() or c == '.':
s += c
else:
break
if not s:
raise ValueError("can't parse %r" % uname)
minor = 0
micro = 0
nums = s.split('.')
major = int(nums[0])
if len(nums) >= 2:
minor = int(nums[1])
if len(nums) >= 3:
micro = int(nums[2])
return (major, minor, micro)
def get_winver():
if not WINDOWS:
raise NotImplementedError("not WINDOWS")
wv = sys.getwindowsversion()
if hasattr(wv, 'service_pack_major'): # python >= 2.7
sp = wv.service_pack_major or 0
else:
r = re.search(r"\s\d$", wv[4])
sp = int(r.group(0)) if r else 0
return (wv[0], wv[1], sp)
# ===================================================================
# --- sync primitives
# ===================================================================
class retry:
"""A retry decorator."""
def __init__(
self,
exception=Exception,
timeout=None,
retries=None,
interval=0.001,
logfun=None,
):
if timeout and retries:
raise ValueError("timeout and retries args are mutually exclusive")
self.exception = exception
self.timeout = timeout
self.retries = retries
self.interval = interval
self.logfun = logfun
def __iter__(self):
if self.timeout:
stop_at = time.time() + self.timeout
while time.time() < stop_at:
yield
elif self.retries:
for _ in range(self.retries):
yield
else:
while True:
yield
def sleep(self):
if self.interval is not None:
time.sleep(self.interval)
def __call__(self, fun):
@functools.wraps(fun)
def wrapper(*args, **kwargs):
exc = None
for _ in self:
try:
return fun(*args, **kwargs)
except self.exception as _: # NOQA
exc = _
if self.logfun is not None:
self.logfun(exc)
self.sleep()
continue
if PY3:
raise exc # noqa: PLE0704
else:
raise # noqa: PLE0704
# This way the user of the decorated function can change config
# parameters.
wrapper.decorator = self
return wrapper
@retry(
exception=psutil.NoSuchProcess,
logfun=None,
timeout=GLOBAL_TIMEOUT,
interval=0.001,
)
def wait_for_pid(pid):
"""Wait for pid to show up in the process list then return.
Used in the test suite to give time the sub process to initialize.
"""
if pid not in psutil.pids():
raise psutil.NoSuchProcess(pid)
psutil.Process(pid)
@retry(
exception=(FileNotFoundError, AssertionError),
logfun=None,
timeout=GLOBAL_TIMEOUT,
interval=0.001,
)
def wait_for_file(fname, delete=True, empty=False):
"""Wait for a file to be written on disk with some content."""
with open(fname, "rb") as f:
data = f.read()
if not empty:
assert data
if delete:
safe_rmpath(fname)
return data
@retry(
exception=AssertionError,
logfun=None,
timeout=GLOBAL_TIMEOUT,
interval=0.001,
)
def call_until(fun):
"""Keep calling function until it evaluates to True."""
ret = fun()
assert ret
return ret
# ===================================================================
# --- fs
# ===================================================================
def safe_rmpath(path):
"""Convenience function for removing temporary test files or dirs."""
def retry_fun(fun):
# On Windows it could happen that the file or directory has
# open handles or references preventing the delete operation
# to succeed immediately, so we retry for a while. See:
# https://bugs.python.org/issue33240
stop_at = time.time() + GLOBAL_TIMEOUT
while time.time() < stop_at:
try:
return fun()
except FileNotFoundError:
pass
except WindowsError as _:
err = _
warn("ignoring %s" % (str(err)))
time.sleep(0.01)
raise err
try:
st = os.stat(path)
if stat.S_ISDIR(st.st_mode):
fun = functools.partial(shutil.rmtree, path)
else:
fun = functools.partial(os.remove, path)
if POSIX:
fun()
else:
retry_fun(fun)
except FileNotFoundError:
pass
def safe_mkdir(dir):
"""Convenience function for creating a directory."""
try:
os.mkdir(dir)
except FileExistsError:
pass
@contextlib.contextmanager
def chdir(dirname):
"""Context manager which temporarily changes the current directory."""
curdir = os.getcwd()
try:
os.chdir(dirname)
yield
finally:
os.chdir(curdir)
def create_py_exe(path):
"""Create a Python executable file in the given location."""
assert not os.path.exists(path), path
atexit.register(safe_rmpath, path)
shutil.copyfile(PYTHON_EXE, path)
if POSIX:
st = os.stat(path)
os.chmod(path, st.st_mode | stat.S_IEXEC)
return path
def create_c_exe(path, c_code=None):
"""Create a compiled C executable in the given location."""
assert not os.path.exists(path), path
if not which("gcc"):
raise pytest.skip("gcc is not installed")
if c_code is None:
c_code = textwrap.dedent("""
#include <unistd.h>
int main() {
pause();
return 1;
}
""")
else:
assert isinstance(c_code, str), c_code
atexit.register(safe_rmpath, path)
with open(get_testfn(suffix='.c'), "w") as f:
f.write(c_code)
try:
subprocess.check_call(["gcc", f.name, "-o", path])
finally:
safe_rmpath(f.name)
return path
def get_testfn(suffix="", dir=None):
"""Return an absolute pathname of a file or dir that did not
exist at the time this call is made. Also schedule it for safe
deletion at interpreter exit. It's technically racy but probably
not really due to the time variant.
"""
while True:
name = tempfile.mktemp(prefix=TESTFN_PREFIX, suffix=suffix, dir=dir)
if not os.path.exists(name): # also include dirs
path = os.path.realpath(name) # needed for OSX
atexit.register(safe_rmpath, path)
return path
# ===================================================================
# --- testing
# ===================================================================
class fake_pytest:
"""A class that mimics some basic pytest APIs. This is meant for
when unit tests are run in production, where pytest may not be
installed. Still, the user can test psutil installation via:
$ python3 -m psutil.tests
"""
@staticmethod
def main(*args, **kw): # noqa ARG004
"""Mimics pytest.main(). It has the same effect as running
`python3 -m unittest -v` from the project root directory.
"""
suite = unittest.TestLoader().discover(HERE)
unittest.TextTestRunner(verbosity=2).run(suite)
warnings.warn(
"Fake pytest module was used. Test results may be inaccurate.",
UserWarning,
stacklevel=1,
)
return suite
@staticmethod
def raises(exc, match=None):
"""Mimics `pytest.raises`."""
class ExceptionInfo:
_exc = None
@property
def value(self):
return self._exc
@contextlib.contextmanager
def context(exc, match=None):
einfo = ExceptionInfo()
try:
yield einfo
except exc as err:
if match and not re.search(match, str(err)):
msg = '"{}" does not match "{}"'.format(match, str(err))
raise AssertionError(msg)
einfo._exc = err
else:
raise AssertionError("%r not raised" % exc)
return context(exc, match=match)
@staticmethod
def warns(warning, match=None):
"""Mimics `pytest.warns`."""
if match:
return unittest.TestCase().assertWarnsRegex(warning, match)
return unittest.TestCase().assertWarns(warning)
@staticmethod
def skip(reason=""):
"""Mimics `unittest.SkipTest`."""
raise unittest.SkipTest(reason)
class mark:
@staticmethod
def skipif(condition, reason=""):
"""Mimics `@pytest.mark.skipif` decorator."""
return unittest.skipIf(condition, reason)
class xdist_group:
"""Mimics `@pytest.mark.xdist_group` decorator (no-op)."""
def __init__(self, name=None):
pass
def __call__(self, cls_or_meth):
return cls_or_meth
if pytest is None:
pytest = fake_pytest
class TestCase(unittest.TestCase):
# ...otherwise multiprocessing.Pool complains
if not PY3:
def runTest(self):
pass
@contextlib.contextmanager
def subTest(self, *args, **kw):
# fake it for python 2.7
yield
# monkey patch default unittest.TestCase
unittest.TestCase = TestCase
class PsutilTestCase(TestCase):
"""Test class providing auto-cleanup wrappers on top of process
test utilities. All test classes should derive from this one, even
if we use pytest.
"""
def get_testfn(self, suffix="", dir=None):
fname = get_testfn(suffix=suffix, dir=dir)
self.addCleanup(safe_rmpath, fname)
return fname
def spawn_testproc(self, *args, **kwds):
sproc = spawn_testproc(*args, **kwds)
self.addCleanup(terminate, sproc)
return sproc
def spawn_children_pair(self):
child1, child2 = spawn_children_pair()
self.addCleanup(terminate, child2)
self.addCleanup(terminate, child1) # executed first
return (child1, child2)
def spawn_zombie(self):
parent, zombie = spawn_zombie()
self.addCleanup(terminate, zombie)
self.addCleanup(terminate, parent) # executed first
return (parent, zombie)
def pyrun(self, *args, **kwds):
sproc, srcfile = pyrun(*args, **kwds)
self.addCleanup(safe_rmpath, srcfile)
self.addCleanup(terminate, sproc) # executed first
return sproc
def _check_proc_exc(self, proc, exc):
assert isinstance(exc, psutil.Error)
assert exc.pid == proc.pid
assert exc.name == proc._name
if exc.name:
assert exc.name
if isinstance(exc, psutil.ZombieProcess):
assert exc.ppid == proc._ppid
if exc.ppid is not None:
assert exc.ppid >= 0
str(exc)
repr(exc)
def assertPidGone(self, pid):
with pytest.raises(psutil.NoSuchProcess) as cm:
try:
psutil.Process(pid)
except psutil.ZombieProcess:
raise AssertionError("wasn't supposed to raise ZombieProcess")
assert cm.value.pid == pid
assert cm.value.name is None
assert not psutil.pid_exists(pid), pid
assert pid not in psutil.pids()
assert pid not in [x.pid for x in psutil.process_iter()]
def assertProcessGone(self, proc):
self.assertPidGone(proc.pid)
ns = process_namespace(proc)
for fun, name in ns.iter(ns.all, clear_cache=True):
with self.subTest(proc=proc, name=name):
try:
ret = fun()
except psutil.ZombieProcess:
raise
except psutil.NoSuchProcess as exc:
self._check_proc_exc(proc, exc)
else:
msg = "Process.%s() didn't raise NSP and returned %r" % (
name,
ret,
)
raise AssertionError(msg)
proc.wait(timeout=0) # assert not raise TimeoutExpired
def assertProcessZombie(self, proc):
# A zombie process should always be instantiable.
clone = psutil.Process(proc.pid)
# Cloned zombie on Open/NetBSD has null creation time, see:
# https://github.com/giampaolo/psutil/issues/2287
assert proc == clone
if not (OPENBSD or NETBSD):
assert hash(proc) == hash(clone)
# Its status always be querable.
assert proc.status() == psutil.STATUS_ZOMBIE
# It should be considered 'running'.
assert proc.is_running()
assert psutil.pid_exists(proc.pid)
# as_dict() shouldn't crash.
proc.as_dict()
# It should show up in pids() and process_iter().
assert proc.pid in psutil.pids()
assert proc.pid in [x.pid for x in psutil.process_iter()]
psutil._pmap = {}
assert proc.pid in [x.pid for x in psutil.process_iter()]
# Call all methods.
ns = process_namespace(proc)
for fun, name in ns.iter(ns.all, clear_cache=True):
with self.subTest(proc=proc, name=name):
try:
fun()
except (psutil.ZombieProcess, psutil.AccessDenied) as exc:
self._check_proc_exc(proc, exc)
if LINUX:
# https://github.com/giampaolo/psutil/pull/2288
with pytest.raises(psutil.ZombieProcess) as cm:
proc.cmdline()
self._check_proc_exc(proc, cm.value)
with pytest.raises(psutil.ZombieProcess) as cm:
proc.exe()
self._check_proc_exc(proc, cm.value)
with pytest.raises(psutil.ZombieProcess) as cm:
proc.memory_maps()
self._check_proc_exc(proc, cm.value)
# Zombie cannot be signaled or terminated.
proc.suspend()
proc.resume()
proc.terminate()
proc.kill()
assert proc.is_running()
assert psutil.pid_exists(proc.pid)
assert proc.pid in psutil.pids()
assert proc.pid in [x.pid for x in psutil.process_iter()]
psutil._pmap = {}
assert proc.pid in [x.pid for x in psutil.process_iter()]
# Its parent should 'see' it (edit: not true on BSD and MACOS).
# descendants = [x.pid for x in psutil.Process().children(
# recursive=True)]
# self.assertIn(proc.pid, descendants)
# __eq__ can't be relied upon because creation time may not be
# querable.
# self.assertEqual(proc, psutil.Process(proc.pid))
# XXX should we also assume ppid() to be usable? Note: this
# would be an important use case as the only way to get
# rid of a zombie is to kill its parent.
# self.assertEqual(proc.ppid(), os.getpid())
@pytest.mark.skipif(PYPY, reason="unreliable on PYPY")
class TestMemoryLeak(PsutilTestCase):
"""Test framework class for detecting function memory leaks,
typically functions implemented in C which forgot to free() memory
from the heap. It does so by checking whether the process memory
usage increased before and after calling the function many times.
Note that this is hard (probably impossible) to do reliably, due
to how the OS handles memory, the GC and so on (memory can even
decrease!). In order to avoid false positives, in case of failure
(mem > 0) we retry the test for up to 5 times, increasing call
repetitions each time. If the memory keeps increasing then it's a
failure.
If available (Linux, OSX, Windows), USS memory is used for comparison,
since it's supposed to be more precise, see:
https://gmpy.dev/blog/2016/real-process-memory-and-environ-in-python
If not, RSS memory is used. mallinfo() on Linux and _heapwalk() on
Windows may give even more precision, but at the moment are not
implemented.
PyPy appears to be completely unstable for this framework, probably
because of its JIT, so tests on PYPY are skipped.
Usage:
class TestLeaks(psutil.tests.TestMemoryLeak):
def test_fun(self):
self.execute(some_function)
"""
# Configurable class attrs.
times = 200
warmup_times = 10
tolerance = 0 # memory
retries = 10 if CI_TESTING else 5
verbose = True
_thisproc = psutil.Process()
_psutil_debug_orig = bool(os.getenv('PSUTIL_DEBUG'))
@classmethod
def setUpClass(cls):
psutil._set_debug(False) # avoid spamming to stderr
@classmethod
def tearDownClass(cls):
psutil._set_debug(cls._psutil_debug_orig)
def _get_mem(self):
# USS is the closest thing we have to "real" memory usage and it
# should be less likely to produce false positives.
mem = self._thisproc.memory_full_info()
return getattr(mem, "uss", mem.rss)
def _get_num_fds(self):
if POSIX:
return self._thisproc.num_fds()
else:
return self._thisproc.num_handles()
def _log(self, msg):
if self.verbose:
print_color(msg, color="yellow", file=sys.stderr)
def _check_fds(self, fun):
"""Makes sure num_fds() (POSIX) or num_handles() (Windows) does
not increase after calling a function. Used to discover forgotten
close(2) and CloseHandle syscalls.
"""
before = self._get_num_fds()
self.call(fun)
after = self._get_num_fds()
diff = after - before
if diff < 0:
raise self.fail(
"negative diff %r (gc probably collected a "
"resource from a previous test)" % diff
)
if diff > 0:
type_ = "fd" if POSIX else "handle"
if diff > 1:
type_ += "s"
msg = "%s unclosed %s after calling %r" % (diff, type_, fun)
raise self.fail(msg)
def _call_ntimes(self, fun, times):
"""Get 2 distinct memory samples, before and after having
called fun repeatedly, and return the memory difference.
"""
gc.collect(generation=1)
mem1 = self._get_mem()
for x in range(times):
ret = self.call(fun)
del x, ret
gc.collect(generation=1)
mem2 = self._get_mem()
assert gc.garbage == []
diff = mem2 - mem1 # can also be negative
return diff
def _check_mem(self, fun, times, retries, tolerance):
messages = []
prev_mem = 0
increase = times
for idx in range(1, retries + 1):
mem = self._call_ntimes(fun, times)
msg = "Run #%s: extra-mem=%s, per-call=%s, calls=%s" % (
idx,
bytes2human(mem),
bytes2human(mem / times),
times,
)
messages.append(msg)
success = mem <= tolerance or mem <= prev_mem
if success:
if idx > 1:
self._log(msg)
return
else:
if idx == 1:
print() # NOQA
self._log(msg)
times += increase
prev_mem = mem
raise self.fail(". ".join(messages))
# ---
def call(self, fun):
return fun()
def execute(
self, fun, times=None, warmup_times=None, retries=None, tolerance=None
):
"""Test a callable."""
times = times if times is not None else self.times
warmup_times = (
warmup_times if warmup_times is not None else self.warmup_times
)
retries = retries if retries is not None else self.retries
tolerance = tolerance if tolerance is not None else self.tolerance
try:
assert times >= 1, "times must be >= 1"
assert warmup_times >= 0, "warmup_times must be >= 0"
assert retries >= 0, "retries must be >= 0"
assert tolerance >= 0, "tolerance must be >= 0"
except AssertionError as err:
raise ValueError(str(err))
self._call_ntimes(fun, warmup_times) # warm up
self._check_fds(fun)
self._check_mem(fun, times=times, retries=retries, tolerance=tolerance)
def execute_w_exc(self, exc, fun, **kwargs):
"""Convenience method to test a callable while making sure it
raises an exception on every call.
"""
def call():
self.assertRaises(exc, fun)
self.execute(call, **kwargs)
def print_sysinfo():
import collections
import datetime
import getpass
import locale
import pprint
try:
import pip
except ImportError:
pip = None
try:
import wheel
except ImportError:
wheel = None
info = collections.OrderedDict()
# OS
if psutil.LINUX and which('lsb_release'):
info['OS'] = sh('lsb_release -d -s')
elif psutil.OSX:
info['OS'] = 'Darwin %s' % platform.mac_ver()[0]
elif psutil.WINDOWS:
info['OS'] = "Windows " + ' '.join(map(str, platform.win32_ver()))
if hasattr(platform, 'win32_edition'):
info['OS'] += ", " + platform.win32_edition()
else:
info['OS'] = "%s %s" % (platform.system(), platform.version())
info['arch'] = ', '.join(
list(platform.architecture()) + [platform.machine()]
)
if psutil.POSIX:
info['kernel'] = platform.uname()[2]
# python
info['python'] = ', '.join([
platform.python_implementation(),
platform.python_version(),
platform.python_compiler(),
])
info['pip'] = getattr(pip, '__version__', 'not installed')
if wheel is not None:
info['pip'] += " (wheel=%s)" % wheel.__version__
# UNIX
if psutil.POSIX:
if which('gcc'):
out = sh(['gcc', '--version'])
info['gcc'] = str(out).split('\n')[0]
else:
info['gcc'] = 'not installed'
s = platform.libc_ver()[1]
if s:
info['glibc'] = s
# system
info['fs-encoding'] = sys.getfilesystemencoding()
lang = locale.getlocale()
info['lang'] = '%s, %s' % (lang[0], lang[1])
info['boot-time'] = datetime.datetime.fromtimestamp(
psutil.boot_time()
).strftime("%Y-%m-%d %H:%M:%S")
info['time'] = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
info['user'] = getpass.getuser()
info['home'] = os.path.expanduser("~")
info['cwd'] = os.getcwd()
info['pyexe'] = PYTHON_EXE
info['hostname'] = platform.node()
info['PID'] = os.getpid()
# metrics
info['cpus'] = psutil.cpu_count()
info['loadavg'] = "%.1f%%, %.1f%%, %.1f%%" % (
tuple([x / psutil.cpu_count() * 100 for x in psutil.getloadavg()])
)
mem = psutil.virtual_memory()
info['memory'] = "%s%%, used=%s, total=%s" % (
int(mem.percent),
bytes2human(mem.used),
bytes2human(mem.total),
)
swap = psutil.swap_memory()
info['swap'] = "%s%%, used=%s, total=%s" % (
int(swap.percent),
bytes2human(swap.used),
bytes2human(swap.total),
)
info['pids'] = len(psutil.pids())
pinfo = psutil.Process().as_dict()
pinfo.pop('memory_maps', None)
info['proc'] = pprint.pformat(pinfo)
print("=" * 70, file=sys.stderr) # NOQA
for k, v in info.items():
print("%-17s %s" % (k + ':', v), file=sys.stderr) # NOQA
print("=" * 70, file=sys.stderr) # NOQA
sys.stdout.flush()
# if WINDOWS:
# os.system("tasklist")
# elif which("ps"):
# os.system("ps aux")
# print("=" * 70, file=sys.stderr) # NOQA
sys.stdout.flush()
def is_win_secure_system_proc(pid):
# see: https://github.com/giampaolo/psutil/issues/2338
@memoize
def get_procs():
ret = {}
out = sh("tasklist.exe /NH /FO csv")
for line in out.splitlines()[1:]:
bits = [x.replace('"', "") for x in line.split(",")]
name, pid = bits[0], int(bits[1])
ret[pid] = name
return ret
try:
return get_procs()[pid] == "Secure System"
except KeyError:
return False
def _get_eligible_cpu():
p = psutil.Process()
if hasattr(p, "cpu_num"):
return p.cpu_num()
elif hasattr(p, "cpu_affinity"):
return random.choice(p.cpu_affinity())
return 0
class process_namespace:
"""A container that lists all Process class method names + some
reasonable parameters to be called with. Utility methods (parent(),
children(), ...) are excluded.
>>> ns = process_namespace(psutil.Process())
>>> for fun, name in ns.iter(ns.getters):
... fun()
"""
utils = [('cpu_percent', (), {}), ('memory_percent', (), {})]
ignored = [
('as_dict', (), {}),
('children', (), {'recursive': True}),
('connections', (), {}), # deprecated
('is_running', (), {}),
('memory_info_ex', (), {}), # deprecated
('oneshot', (), {}),
('parent', (), {}),
('parents', (), {}),
('pid', (), {}),
('wait', (0,), {}),
]
getters = [
('cmdline', (), {}),
('cpu_times', (), {}),
('create_time', (), {}),
('cwd', (), {}),
('exe', (), {}),
('memory_full_info', (), {}),
('memory_info', (), {}),
('name', (), {}),
('net_connections', (), {'kind': 'all'}),
('nice', (), {}),
('num_ctx_switches', (), {}),
('num_threads', (), {}),
('open_files', (), {}),
('ppid', (), {}),
('status', (), {}),
('threads', (), {}),
('username', (), {}),
]
if POSIX:
getters += [('uids', (), {})]
getters += [('gids', (), {})]
getters += [('terminal', (), {})]
getters += [('num_fds', (), {})]
if HAS_PROC_IO_COUNTERS:
getters += [('io_counters', (), {})]
if HAS_IONICE:
getters += [('ionice', (), {})]
if HAS_RLIMIT:
getters += [('rlimit', (psutil.RLIMIT_NOFILE,), {})]
if HAS_CPU_AFFINITY:
getters += [('cpu_affinity', (), {})]
if HAS_PROC_CPU_NUM:
getters += [('cpu_num', (), {})]
if HAS_ENVIRON:
getters += [('environ', (), {})]
if WINDOWS:
getters += [('num_handles', (), {})]
if HAS_MEMORY_MAPS:
getters += [('memory_maps', (), {'grouped': False})]
setters = []
if POSIX:
setters += [('nice', (0,), {})]
else:
setters += [('nice', (psutil.NORMAL_PRIORITY_CLASS,), {})]
if HAS_RLIMIT:
setters += [('rlimit', (psutil.RLIMIT_NOFILE, (1024, 4096)), {})]
if HAS_IONICE:
if LINUX:
setters += [('ionice', (psutil.IOPRIO_CLASS_NONE, 0), {})]
else:
setters += [('ionice', (psutil.IOPRIO_NORMAL,), {})]
if HAS_CPU_AFFINITY:
setters += [('cpu_affinity', ([_get_eligible_cpu()],), {})]
killers = [
('send_signal', (signal.SIGTERM,), {}),
('suspend', (), {}),
('resume', (), {}),
('terminate', (), {}),
('kill', (), {}),
]
if WINDOWS:
killers += [('send_signal', (signal.CTRL_C_EVENT,), {})]
killers += [('send_signal', (signal.CTRL_BREAK_EVENT,), {})]
all = utils + getters + setters + killers
def __init__(self, proc):
self._proc = proc
def iter(self, ls, clear_cache=True):
"""Given a list of tuples yields a set of (fun, fun_name) tuples
in random order.
"""
ls = list(ls)
random.shuffle(ls)
for fun_name, args, kwds in ls:
if clear_cache:
self.clear_cache()
fun = getattr(self._proc, fun_name)
fun = functools.partial(fun, *args, **kwds)
yield (fun, fun_name)
def clear_cache(self):
"""Clear the cache of a Process instance."""
self._proc._init(self._proc.pid, _ignore_nsp=True)
@classmethod
def test_class_coverage(cls, test_class, ls):
"""Given a TestCase instance and a list of tuples checks that
the class defines the required test method names.
"""
for fun_name, _, _ in ls:
meth_name = 'test_' + fun_name
if not hasattr(test_class, meth_name):
msg = "%r class should define a '%s' method" % (
test_class.__class__.__name__,
meth_name,
)
raise AttributeError(msg)
@classmethod
def test(cls):
this = set([x[0] for x in cls.all])
ignored = set([x[0] for x in cls.ignored])
klass = set([x for x in dir(psutil.Process) if x[0] != '_'])
leftout = (this | ignored) ^ klass
if leftout:
raise ValueError("uncovered Process class names: %r" % leftout)
class system_namespace:
"""A container that lists all the module-level, system-related APIs.
Utilities such as cpu_percent() are excluded. Usage:
>>> ns = system_namespace
>>> for fun, name in ns.iter(ns.getters):
... fun()
"""
getters = [
('boot_time', (), {}),
('cpu_count', (), {'logical': False}),
('cpu_count', (), {'logical': True}),
('cpu_stats', (), {}),
('cpu_times', (), {'percpu': False}),
('cpu_times', (), {'percpu': True}),
('disk_io_counters', (), {'perdisk': True}),
('disk_partitions', (), {'all': True}),
('disk_usage', (os.getcwd(),), {}),
('net_connections', (), {'kind': 'all'}),
('net_if_addrs', (), {}),
('net_if_stats', (), {}),
('net_io_counters', (), {'pernic': True}),
('pid_exists', (os.getpid(),), {}),
('pids', (), {}),
('swap_memory', (), {}),
('users', (), {}),
('virtual_memory', (), {}),
]
if HAS_CPU_FREQ:
if MACOS and platform.machine() == 'arm64': # skipped due to #1892
pass
else:
getters += [('cpu_freq', (), {'percpu': True})]
if HAS_GETLOADAVG:
getters += [('getloadavg', (), {})]
if HAS_SENSORS_TEMPERATURES:
getters += [('sensors_temperatures', (), {})]
if HAS_SENSORS_FANS:
getters += [('sensors_fans', (), {})]
if HAS_SENSORS_BATTERY:
getters += [('sensors_battery', (), {})]
if WINDOWS:
getters += [('win_service_iter', (), {})]
getters += [('win_service_get', ('alg',), {})]
ignored = [
('process_iter', (), {}),
('wait_procs', ([psutil.Process()],), {}),
('cpu_percent', (), {}),
('cpu_times_percent', (), {}),
]
all = getters
@staticmethod
def iter(ls):
"""Given a list of tuples yields a set of (fun, fun_name) tuples
in random order.
"""
ls = list(ls)
random.shuffle(ls)
for fun_name, args, kwds in ls:
fun = getattr(psutil, fun_name)
fun = functools.partial(fun, *args, **kwds)
yield (fun, fun_name)
test_class_coverage = process_namespace.test_class_coverage
def retry_on_failure(retries=NO_RETRIES):
"""Decorator which runs a test function and retries N times before
actually failing.
"""
def logfun(exc):
print("%r, retrying" % exc, file=sys.stderr) # NOQA
return retry(
exception=AssertionError, timeout=None, retries=retries, logfun=logfun
)
def skip_on_access_denied(only_if=None):
"""Decorator to Ignore AccessDenied exceptions."""
def decorator(fun):
@functools.wraps(fun)
def wrapper(*args, **kwargs):
try:
return fun(*args, **kwargs)
except psutil.AccessDenied:
if only_if is not None:
if not only_if:
raise
raise pytest.skip("raises AccessDenied")
return wrapper
return decorator
def skip_on_not_implemented(only_if=None):
"""Decorator to Ignore NotImplementedError exceptions."""
def decorator(fun):
@functools.wraps(fun)
def wrapper(*args, **kwargs):
try:
return fun(*args, **kwargs)
except NotImplementedError:
if only_if is not None:
if not only_if:
raise
msg = (
"%r was skipped because it raised NotImplementedError"
% fun.__name__
)
raise pytest.skip(msg)
return wrapper
return decorator
# ===================================================================
# --- network
# ===================================================================
# XXX: no longer used
def get_free_port(host='127.0.0.1'):
"""Return an unused TCP port. Subject to race conditions."""
with contextlib.closing(socket.socket()) as sock:
sock.bind((host, 0))
return sock.getsockname()[1]
def bind_socket(family=AF_INET, type=SOCK_STREAM, addr=None):
"""Binds a generic socket."""
if addr is None and family in (AF_INET, AF_INET6):
addr = ("", 0)
sock = socket.socket(family, type)
try:
if os.name not in ('nt', 'cygwin'):
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
sock.bind(addr)
if type == socket.SOCK_STREAM:
sock.listen(5)
return sock
except Exception:
sock.close()
raise
def bind_unix_socket(name, type=socket.SOCK_STREAM):
"""Bind a UNIX socket."""
assert psutil.POSIX
assert not os.path.exists(name), name
sock = socket.socket(socket.AF_UNIX, type)
try:
sock.bind(name)
if type == socket.SOCK_STREAM:
sock.listen(5)
except Exception:
sock.close()
raise
return sock
def tcp_socketpair(family, addr=("", 0)):
"""Build a pair of TCP sockets connected to each other.
Return a (server, client) tuple.
"""
with contextlib.closing(socket.socket(family, SOCK_STREAM)) as ll:
ll.bind(addr)
ll.listen(5)
addr = ll.getsockname()
c = socket.socket(family, SOCK_STREAM)
try:
c.connect(addr)
caddr = c.getsockname()
while True:
a, addr = ll.accept()
# check that we've got the correct client
if addr == caddr:
return (a, c)
a.close()
except OSError:
c.close()
raise
def unix_socketpair(name):
"""Build a pair of UNIX sockets connected to each other through
the same UNIX file name.
Return a (server, client) tuple.
"""
assert psutil.POSIX
server = client = None
try:
server = bind_unix_socket(name, type=socket.SOCK_STREAM)
server.setblocking(0)
client = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
client.setblocking(0)
client.connect(name)
# new = server.accept()
except Exception:
if server is not None:
server.close()
if client is not None:
client.close()
raise
return (server, client)
@contextlib.contextmanager
def create_sockets():
"""Open as many socket families / types as possible."""
socks = []
fname1 = fname2 = None
try:
socks.append(bind_socket(socket.AF_INET, socket.SOCK_STREAM))
socks.append(bind_socket(socket.AF_INET, socket.SOCK_DGRAM))
if supports_ipv6():
socks.append(bind_socket(socket.AF_INET6, socket.SOCK_STREAM))
socks.append(bind_socket(socket.AF_INET6, socket.SOCK_DGRAM))
if POSIX and HAS_NET_CONNECTIONS_UNIX:
fname1 = get_testfn()
fname2 = get_testfn()
s1, s2 = unix_socketpair(fname1)
s3 = bind_unix_socket(fname2, type=socket.SOCK_DGRAM)
for s in (s1, s2, s3):
socks.append(s)
yield socks
finally:
for s in socks:
s.close()
for fname in (fname1, fname2):
if fname is not None:
safe_rmpath(fname)
def check_net_address(addr, family):
"""Check a net address validity. Supported families are IPv4,
IPv6 and MAC addresses.
"""
import ipaddress # python >= 3.3 / requires "pip install ipaddress"
if enum and PY3 and not PYPY:
assert isinstance(family, enum.IntEnum), family
if family == socket.AF_INET:
octs = [int(x) for x in addr.split('.')]
assert len(octs) == 4, addr
for num in octs:
assert 0 <= num <= 255, addr
if not PY3:
addr = unicode(addr)
ipaddress.IPv4Address(addr)
elif family == socket.AF_INET6:
assert isinstance(addr, str), addr
if not PY3:
addr = unicode(addr)
ipaddress.IPv6Address(addr)
elif family == psutil.AF_LINK:
assert re.match(r'([a-fA-F0-9]{2}[:|\-]?){6}', addr) is not None, addr
else:
raise ValueError("unknown family %r" % family)
def check_connection_ntuple(conn):
"""Check validity of a connection namedtuple."""
def check_ntuple(conn):
has_pid = len(conn) == 7
assert len(conn) in (6, 7), len(conn)
assert conn[0] == conn.fd, conn.fd
assert conn[1] == conn.family, conn.family
assert conn[2] == conn.type, conn.type
assert conn[3] == conn.laddr, conn.laddr
assert conn[4] == conn.raddr, conn.raddr
assert conn[5] == conn.status, conn.status
if has_pid:
assert conn[6] == conn.pid, conn.pid
def check_family(conn):
assert conn.family in (AF_INET, AF_INET6, AF_UNIX), conn.family
if enum is not None:
assert isinstance(conn.family, enum.IntEnum), conn
else:
assert isinstance(conn.family, int), conn
if conn.family == AF_INET:
# actually try to bind the local socket; ignore IPv6
# sockets as their address might be represented as
# an IPv4-mapped-address (e.g. "::127.0.0.1")
# and that's rejected by bind()
s = socket.socket(conn.family, conn.type)
with contextlib.closing(s):
try:
s.bind((conn.laddr[0], 0))
except socket.error as err:
if err.errno != errno.EADDRNOTAVAIL:
raise
elif conn.family == AF_UNIX:
assert conn.status == psutil.CONN_NONE, conn.status
def check_type(conn):
# SOCK_SEQPACKET may happen in case of AF_UNIX socks
SOCK_SEQPACKET = getattr(socket, "SOCK_SEQPACKET", object())
assert conn.type in (
socket.SOCK_STREAM,
socket.SOCK_DGRAM,
SOCK_SEQPACKET,
), conn.type
if enum is not None:
assert isinstance(conn.type, enum.IntEnum), conn
else:
assert isinstance(conn.type, int), conn
if conn.type == socket.SOCK_DGRAM:
assert conn.status == psutil.CONN_NONE, conn.status
def check_addrs(conn):
# check IP address and port sanity
for addr in (conn.laddr, conn.raddr):
if conn.family in (AF_INET, AF_INET6):
assert isinstance(addr, tuple), type(addr)
if not addr:
continue
assert isinstance(addr.port, int), type(addr.port)
assert 0 <= addr.port <= 65535, addr.port
check_net_address(addr.ip, conn.family)
elif conn.family == AF_UNIX:
assert isinstance(addr, str), type(addr)
def check_status(conn):
assert isinstance(conn.status, str), conn.status
valids = [
getattr(psutil, x) for x in dir(psutil) if x.startswith('CONN_')
]
assert conn.status in valids, conn.status
if conn.family in (AF_INET, AF_INET6) and conn.type == SOCK_STREAM:
assert conn.status != psutil.CONN_NONE, conn.status
else:
assert conn.status == psutil.CONN_NONE, conn.status
check_ntuple(conn)
check_family(conn)
check_type(conn)
check_addrs(conn)
check_status(conn)
def filter_proc_net_connections(cons):
"""Our process may start with some open UNIX sockets which are not
initialized by us, invalidating unit tests.
"""
new = []
for conn in cons:
if POSIX and conn.family == socket.AF_UNIX:
if MACOS and "/syslog" in conn.raddr:
debug("skipping %s" % str(conn))
continue
new.append(conn)
return new
# ===================================================================
# --- compatibility
# ===================================================================
def reload_module(module):
"""Backport of importlib.reload of Python 3.3+."""
try:
import importlib
if not hasattr(importlib, 'reload'): # python <=3.3
raise ImportError
except ImportError:
import imp
return imp.reload(module)
else:
return importlib.reload(module)
def import_module_by_path(path):
name = os.path.splitext(os.path.basename(path))[0]
if sys.version_info[0] < 3:
import imp
return imp.load_source(name, path)
else:
import importlib.util
spec = importlib.util.spec_from_file_location(name, path)
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
return mod
# ===================================================================
# --- others
# ===================================================================
def warn(msg):
"""Raise a warning msg."""
warnings.warn(msg, UserWarning, stacklevel=2)
def is_namedtuple(x):
"""Check if object is an instance of namedtuple."""
t = type(x)
b = t.__bases__
if len(b) != 1 or b[0] is not tuple:
return False
f = getattr(t, '_fields', None)
if not isinstance(f, tuple):
return False
return all(isinstance(n, str) for n in f)
if POSIX:
@contextlib.contextmanager
def copyload_shared_lib(suffix=""):
"""Ctx manager which picks up a random shared CO lib used
by this process, copies it in another location and loads it
in memory via ctypes. Return the new absolutized path.
"""
exe = 'pypy' if PYPY else 'python'
ext = ".so"
dst = get_testfn(suffix=suffix + ext)
libs = [
x.path
for x in psutil.Process().memory_maps()
if os.path.splitext(x.path)[1] == ext and exe in x.path.lower()
]
src = random.choice(libs)
shutil.copyfile(src, dst)
try:
ctypes.CDLL(dst)
yield dst
finally:
safe_rmpath(dst)
else:
@contextlib.contextmanager
def copyload_shared_lib(suffix=""):
"""Ctx manager which picks up a random shared DLL lib used
by this process, copies it in another location and loads it
in memory via ctypes.
Return the new absolutized, normcased path.
"""
from ctypes import WinError
from ctypes import wintypes
ext = ".dll"
dst = get_testfn(suffix=suffix + ext)
libs = [
x.path
for x in psutil.Process().memory_maps()
if x.path.lower().endswith(ext)
and 'python' in os.path.basename(x.path).lower()
and 'wow64' not in x.path.lower()
]
if PYPY and not libs:
libs = [
x.path
for x in psutil.Process().memory_maps()
if 'pypy' in os.path.basename(x.path).lower()
]
src = random.choice(libs)
shutil.copyfile(src, dst)
cfile = None
try:
cfile = ctypes.WinDLL(dst)
yield dst
finally:
# Work around OverflowError:
# - https://ci.appveyor.com/project/giampaolo/psutil/build/1207/
# job/o53330pbnri9bcw7
# - http://bugs.python.org/issue30286
# - http://stackoverflow.com/questions/23522055
if cfile is not None:
FreeLibrary = ctypes.windll.kernel32.FreeLibrary
FreeLibrary.argtypes = [wintypes.HMODULE]
ret = FreeLibrary(cfile._handle)
if ret == 0:
WinError()
safe_rmpath(dst)
# ===================================================================
# --- Exit funs (first is executed last)
# ===================================================================
# this is executed first
@atexit.register
def cleanup_test_procs():
reap_children(recursive=True)
# atexit module does not execute exit functions in case of SIGTERM, which
# gets sent to test subprocesses, which is a problem if they import this
# module. With this it will. See:
# https://gmpy.dev/blog/2016/how-to-always-execute-exit-functions-in-python
if POSIX:
signal.signal(signal.SIGTERM, lambda sig, _: sys.exit(sig))
PK ok\V�a�S S psutil/tests/test_connections.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Tests for psutil.net_connections() and Process.net_connections() APIs."""
import os
import socket
import textwrap
from contextlib import closing
from socket import AF_INET
from socket import AF_INET6
from socket import SOCK_DGRAM
from socket import SOCK_STREAM
import psutil
from psutil import FREEBSD
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._common import supports_ipv6
from psutil._compat import PY3
from psutil.tests import AF_UNIX
from psutil.tests import HAS_NET_CONNECTIONS_UNIX
from psutil.tests import SKIP_SYSCONS
from psutil.tests import PsutilTestCase
from psutil.tests import bind_socket
from psutil.tests import bind_unix_socket
from psutil.tests import check_connection_ntuple
from psutil.tests import create_sockets
from psutil.tests import filter_proc_net_connections
from psutil.tests import pytest
from psutil.tests import reap_children
from psutil.tests import retry_on_failure
from psutil.tests import skip_on_access_denied
from psutil.tests import tcp_socketpair
from psutil.tests import unix_socketpair
from psutil.tests import wait_for_file
SOCK_SEQPACKET = getattr(socket, "SOCK_SEQPACKET", object())
def this_proc_net_connections(kind):
cons = psutil.Process().net_connections(kind=kind)
if kind in ("all", "unix"):
return filter_proc_net_connections(cons)
return cons
@pytest.mark.xdist_group(name="serial")
class ConnectionTestCase(PsutilTestCase):
def setUp(self):
assert this_proc_net_connections(kind='all') == []
def tearDown(self):
# Make sure we closed all resources.
assert this_proc_net_connections(kind='all') == []
def compare_procsys_connections(self, pid, proc_cons, kind='all'):
"""Given a process PID and its list of connections compare
those against system-wide connections retrieved via
psutil.net_connections.
"""
try:
sys_cons = psutil.net_connections(kind=kind)
except psutil.AccessDenied:
# On MACOS, system-wide connections are retrieved by iterating
# over all processes
if MACOS:
return
else:
raise
# Filter for this proc PID and exlucde PIDs from the tuple.
sys_cons = [c[:-1] for c in sys_cons if c.pid == pid]
sys_cons.sort()
proc_cons.sort()
assert proc_cons == sys_cons
class TestBasicOperations(ConnectionTestCase):
@pytest.mark.skipif(SKIP_SYSCONS, reason="requires root")
def test_system(self):
with create_sockets():
for conn in psutil.net_connections(kind='all'):
check_connection_ntuple(conn)
def test_process(self):
with create_sockets():
for conn in this_proc_net_connections(kind='all'):
check_connection_ntuple(conn)
def test_invalid_kind(self):
with pytest.raises(ValueError):
this_proc_net_connections(kind='???')
with pytest.raises(ValueError):
psutil.net_connections(kind='???')
@pytest.mark.xdist_group(name="serial")
class TestUnconnectedSockets(ConnectionTestCase):
"""Tests sockets which are open but not connected to anything."""
def get_conn_from_sock(self, sock):
cons = this_proc_net_connections(kind='all')
smap = dict([(c.fd, c) for c in cons])
if NETBSD or FREEBSD:
# NetBSD opens a UNIX socket to /var/log/run
# so there may be more connections.
return smap[sock.fileno()]
else:
assert len(cons) == 1
if cons[0].fd != -1:
assert smap[sock.fileno()].fd == sock.fileno()
return cons[0]
def check_socket(self, sock):
"""Given a socket, makes sure it matches the one obtained
via psutil. It assumes this process created one connection
only (the one supposed to be checked).
"""
conn = self.get_conn_from_sock(sock)
check_connection_ntuple(conn)
# fd, family, type
if conn.fd != -1:
assert conn.fd == sock.fileno()
assert conn.family == sock.family
# see: http://bugs.python.org/issue30204
assert conn.type == sock.getsockopt(socket.SOL_SOCKET, socket.SO_TYPE)
# local address
laddr = sock.getsockname()
if not laddr and PY3 and isinstance(laddr, bytes):
# See: http://bugs.python.org/issue30205
laddr = laddr.decode()
if sock.family == AF_INET6:
laddr = laddr[:2]
assert conn.laddr == laddr
# XXX Solaris can't retrieve system-wide UNIX sockets
if sock.family == AF_UNIX and HAS_NET_CONNECTIONS_UNIX:
cons = this_proc_net_connections(kind='all')
self.compare_procsys_connections(os.getpid(), cons, kind='all')
return conn
def test_tcp_v4(self):
addr = ("127.0.0.1", 0)
with closing(bind_socket(AF_INET, SOCK_STREAM, addr=addr)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == ()
assert conn.status == psutil.CONN_LISTEN
@pytest.mark.skipif(not supports_ipv6(), reason="IPv6 not supported")
def test_tcp_v6(self):
addr = ("::1", 0)
with closing(bind_socket(AF_INET6, SOCK_STREAM, addr=addr)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == ()
assert conn.status == psutil.CONN_LISTEN
def test_udp_v4(self):
addr = ("127.0.0.1", 0)
with closing(bind_socket(AF_INET, SOCK_DGRAM, addr=addr)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == ()
assert conn.status == psutil.CONN_NONE
@pytest.mark.skipif(not supports_ipv6(), reason="IPv6 not supported")
def test_udp_v6(self):
addr = ("::1", 0)
with closing(bind_socket(AF_INET6, SOCK_DGRAM, addr=addr)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == ()
assert conn.status == psutil.CONN_NONE
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_unix_tcp(self):
testfn = self.get_testfn()
with closing(bind_unix_socket(testfn, type=SOCK_STREAM)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == "" # noqa
assert conn.status == psutil.CONN_NONE
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_unix_udp(self):
testfn = self.get_testfn()
with closing(bind_unix_socket(testfn, type=SOCK_STREAM)) as sock:
conn = self.check_socket(sock)
assert conn.raddr == "" # noqa
assert conn.status == psutil.CONN_NONE
@pytest.mark.xdist_group(name="serial")
class TestConnectedSocket(ConnectionTestCase):
"""Test socket pairs which are actually connected to
each other.
"""
# On SunOS, even after we close() it, the server socket stays around
# in TIME_WAIT state.
@pytest.mark.skipif(SUNOS, reason="unreliable on SUONS")
def test_tcp(self):
addr = ("127.0.0.1", 0)
assert this_proc_net_connections(kind='tcp4') == []
server, client = tcp_socketpair(AF_INET, addr=addr)
try:
cons = this_proc_net_connections(kind='tcp4')
assert len(cons) == 2
assert cons[0].status == psutil.CONN_ESTABLISHED
assert cons[1].status == psutil.CONN_ESTABLISHED
# May not be fast enough to change state so it stays
# commenteed.
# client.close()
# cons = this_proc_net_connections(kind='all')
# self.assertEqual(len(cons), 1)
# self.assertEqual(cons[0].status, psutil.CONN_CLOSE_WAIT)
finally:
server.close()
client.close()
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_unix(self):
testfn = self.get_testfn()
server, client = unix_socketpair(testfn)
try:
cons = this_proc_net_connections(kind='unix')
assert not (cons[0].laddr and cons[0].raddr), cons
assert not (cons[1].laddr and cons[1].raddr), cons
if NETBSD or FREEBSD:
# On NetBSD creating a UNIX socket will cause
# a UNIX connection to /var/run/log.
cons = [c for c in cons if c.raddr != '/var/run/log']
assert len(cons) == 2
if LINUX or FREEBSD or SUNOS or OPENBSD:
# remote path is never set
assert cons[0].raddr == "" # noqa
assert cons[1].raddr == "" # noqa
# one local address should though
assert testfn == (cons[0].laddr or cons[1].laddr)
else:
# On other systems either the laddr or raddr
# of both peers are set.
assert (cons[0].laddr or cons[1].laddr) == testfn
finally:
server.close()
client.close()
class TestFilters(ConnectionTestCase):
def test_filters(self):
def check(kind, families, types):
for conn in this_proc_net_connections(kind=kind):
assert conn.family in families
assert conn.type in types
if not SKIP_SYSCONS:
for conn in psutil.net_connections(kind=kind):
assert conn.family in families
assert conn.type in types
with create_sockets():
check(
'all',
[AF_INET, AF_INET6, AF_UNIX],
[SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET],
)
check('inet', [AF_INET, AF_INET6], [SOCK_STREAM, SOCK_DGRAM])
check('inet4', [AF_INET], [SOCK_STREAM, SOCK_DGRAM])
check('tcp', [AF_INET, AF_INET6], [SOCK_STREAM])
check('tcp4', [AF_INET], [SOCK_STREAM])
check('tcp6', [AF_INET6], [SOCK_STREAM])
check('udp', [AF_INET, AF_INET6], [SOCK_DGRAM])
check('udp4', [AF_INET], [SOCK_DGRAM])
check('udp6', [AF_INET6], [SOCK_DGRAM])
if HAS_NET_CONNECTIONS_UNIX:
check(
'unix',
[AF_UNIX],
[SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET],
)
@skip_on_access_denied(only_if=MACOS)
def test_combos(self):
reap_children()
def check_conn(proc, conn, family, type, laddr, raddr, status, kinds):
all_kinds = (
"all",
"inet",
"inet4",
"inet6",
"tcp",
"tcp4",
"tcp6",
"udp",
"udp4",
"udp6",
)
check_connection_ntuple(conn)
assert conn.family == family
assert conn.type == type
assert conn.laddr == laddr
assert conn.raddr == raddr
assert conn.status == status
for kind in all_kinds:
cons = proc.net_connections(kind=kind)
if kind in kinds:
assert cons != []
else:
assert cons == []
# compare against system-wide connections
# XXX Solaris can't retrieve system-wide UNIX
# sockets.
if HAS_NET_CONNECTIONS_UNIX:
self.compare_procsys_connections(proc.pid, [conn])
tcp_template = textwrap.dedent("""
import socket, time
s = socket.socket({family}, socket.SOCK_STREAM)
s.bind(('{addr}', 0))
s.listen(5)
with open('{testfn}', 'w') as f:
f.write(str(s.getsockname()[:2]))
[time.sleep(0.1) for x in range(100)]
""")
udp_template = textwrap.dedent("""
import socket, time
s = socket.socket({family}, socket.SOCK_DGRAM)
s.bind(('{addr}', 0))
with open('{testfn}', 'w') as f:
f.write(str(s.getsockname()[:2]))
[time.sleep(0.1) for x in range(100)]
""")
# must be relative on Windows
testfile = os.path.basename(self.get_testfn(dir=os.getcwd()))
tcp4_template = tcp_template.format(
family=int(AF_INET), addr="127.0.0.1", testfn=testfile
)
udp4_template = udp_template.format(
family=int(AF_INET), addr="127.0.0.1", testfn=testfile
)
tcp6_template = tcp_template.format(
family=int(AF_INET6), addr="::1", testfn=testfile
)
udp6_template = udp_template.format(
family=int(AF_INET6), addr="::1", testfn=testfile
)
# launch various subprocess instantiating a socket of various
# families and types to enrich psutil results
tcp4_proc = self.pyrun(tcp4_template)
tcp4_addr = eval(wait_for_file(testfile, delete=True)) # noqa
udp4_proc = self.pyrun(udp4_template)
udp4_addr = eval(wait_for_file(testfile, delete=True)) # noqa
if supports_ipv6():
tcp6_proc = self.pyrun(tcp6_template)
tcp6_addr = eval(wait_for_file(testfile, delete=True)) # noqa
udp6_proc = self.pyrun(udp6_template)
udp6_addr = eval(wait_for_file(testfile, delete=True)) # noqa
else:
tcp6_proc = None
udp6_proc = None
tcp6_addr = None
udp6_addr = None
for p in psutil.Process().children():
cons = p.net_connections()
assert len(cons) == 1
for conn in cons:
# TCP v4
if p.pid == tcp4_proc.pid:
check_conn(
p,
conn,
AF_INET,
SOCK_STREAM,
tcp4_addr,
(),
psutil.CONN_LISTEN,
("all", "inet", "inet4", "tcp", "tcp4"),
)
# UDP v4
elif p.pid == udp4_proc.pid:
check_conn(
p,
conn,
AF_INET,
SOCK_DGRAM,
udp4_addr,
(),
psutil.CONN_NONE,
("all", "inet", "inet4", "udp", "udp4"),
)
# TCP v6
elif p.pid == getattr(tcp6_proc, "pid", None):
check_conn(
p,
conn,
AF_INET6,
SOCK_STREAM,
tcp6_addr,
(),
psutil.CONN_LISTEN,
("all", "inet", "inet6", "tcp", "tcp6"),
)
# UDP v6
elif p.pid == getattr(udp6_proc, "pid", None):
check_conn(
p,
conn,
AF_INET6,
SOCK_DGRAM,
udp6_addr,
(),
psutil.CONN_NONE,
("all", "inet", "inet6", "udp", "udp6"),
)
def test_count(self):
with create_sockets():
# tcp
cons = this_proc_net_connections(kind='tcp')
assert len(cons) == (2 if supports_ipv6() else 1)
for conn in cons:
assert conn.family in (AF_INET, AF_INET6)
assert conn.type == SOCK_STREAM
# tcp4
cons = this_proc_net_connections(kind='tcp4')
assert len(cons) == 1
assert cons[0].family == AF_INET
assert cons[0].type == SOCK_STREAM
# tcp6
if supports_ipv6():
cons = this_proc_net_connections(kind='tcp6')
assert len(cons) == 1
assert cons[0].family == AF_INET6
assert cons[0].type == SOCK_STREAM
# udp
cons = this_proc_net_connections(kind='udp')
assert len(cons) == (2 if supports_ipv6() else 1)
for conn in cons:
assert conn.family in (AF_INET, AF_INET6)
assert conn.type == SOCK_DGRAM
# udp4
cons = this_proc_net_connections(kind='udp4')
assert len(cons) == 1
assert cons[0].family == AF_INET
assert cons[0].type == SOCK_DGRAM
# udp6
if supports_ipv6():
cons = this_proc_net_connections(kind='udp6')
assert len(cons) == 1
assert cons[0].family == AF_INET6
assert cons[0].type == SOCK_DGRAM
# inet
cons = this_proc_net_connections(kind='inet')
assert len(cons) == (4 if supports_ipv6() else 2)
for conn in cons:
assert conn.family in (AF_INET, AF_INET6)
assert conn.type in (SOCK_STREAM, SOCK_DGRAM)
# inet6
if supports_ipv6():
cons = this_proc_net_connections(kind='inet6')
assert len(cons) == 2
for conn in cons:
assert conn.family == AF_INET6
assert conn.type in (SOCK_STREAM, SOCK_DGRAM)
# Skipped on BSD becayse by default the Python process
# creates a UNIX socket to '/var/run/log'.
if HAS_NET_CONNECTIONS_UNIX and not (FREEBSD or NETBSD):
cons = this_proc_net_connections(kind='unix')
assert len(cons) == 3
for conn in cons:
assert conn.family == AF_UNIX
assert conn.type in (SOCK_STREAM, SOCK_DGRAM)
@pytest.mark.skipif(SKIP_SYSCONS, reason="requires root")
class TestSystemWideConnections(ConnectionTestCase):
"""Tests for net_connections()."""
def test_it(self):
def check(cons, families, types_):
for conn in cons:
assert conn.family in families
if conn.family != AF_UNIX:
assert conn.type in types_
check_connection_ntuple(conn)
with create_sockets():
from psutil._common import conn_tmap
for kind, groups in conn_tmap.items():
# XXX: SunOS does not retrieve UNIX sockets.
if kind == 'unix' and not HAS_NET_CONNECTIONS_UNIX:
continue
families, types_ = groups
cons = psutil.net_connections(kind)
assert len(cons) == len(set(cons))
check(cons, families, types_)
@retry_on_failure()
def test_multi_sockets_procs(self):
# Creates multiple sub processes, each creating different
# sockets. For each process check that proc.net_connections()
# and psutil.net_connections() return the same results.
# This is done mainly to check whether net_connections()'s
# pid is properly set, see:
# https://github.com/giampaolo/psutil/issues/1013
with create_sockets() as socks:
expected = len(socks)
pids = []
times = 10
fnames = []
for _ in range(times):
fname = self.get_testfn()
fnames.append(fname)
src = textwrap.dedent("""\
import time, os
from psutil.tests import create_sockets
with create_sockets():
with open(r'%s', 'w') as f:
f.write("hello")
[time.sleep(0.1) for x in range(100)]
""" % fname)
sproc = self.pyrun(src)
pids.append(sproc.pid)
# sync
for fname in fnames:
wait_for_file(fname)
syscons = [
x for x in psutil.net_connections(kind='all') if x.pid in pids
]
for pid in pids:
assert len([x for x in syscons if x.pid == pid]) == expected
p = psutil.Process(pid)
assert len(p.net_connections('all')) == expected
class TestMisc(PsutilTestCase):
def test_net_connection_constants(self):
ints = []
strs = []
for name in dir(psutil):
if name.startswith('CONN_'):
num = getattr(psutil, name)
str_ = str(num)
assert str_.isupper(), str_
assert str not in strs
assert num not in ints
ints.append(num)
strs.append(str_)
if SUNOS:
psutil.CONN_IDLE # noqa
psutil.CONN_BOUND # noqa
if WINDOWS:
psutil.CONN_DELETE_TCB # noqa
PK ok\�TZn� n� psutil/tests/test_process.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Tests for psutil.Process class."""
import collections
import errno
import getpass
import itertools
import os
import signal
import socket
import stat
import string
import subprocess
import sys
import textwrap
import time
import types
import psutil
from psutil import AIX
from psutil import BSD
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import OSX
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._common import open_text
from psutil._compat import PY3
from psutil._compat import FileNotFoundError
from psutil._compat import long
from psutil._compat import redirect_stderr
from psutil._compat import super
from psutil.tests import APPVEYOR
from psutil.tests import CI_TESTING
from psutil.tests import GITHUB_ACTIONS
from psutil.tests import GLOBAL_TIMEOUT
from psutil.tests import HAS_CPU_AFFINITY
from psutil.tests import HAS_ENVIRON
from psutil.tests import HAS_IONICE
from psutil.tests import HAS_MEMORY_MAPS
from psutil.tests import HAS_PROC_CPU_NUM
from psutil.tests import HAS_PROC_IO_COUNTERS
from psutil.tests import HAS_RLIMIT
from psutil.tests import HAS_THREADS
from psutil.tests import MACOS_11PLUS
from psutil.tests import PYPY
from psutil.tests import PYTHON_EXE
from psutil.tests import PYTHON_EXE_ENV
from psutil.tests import QEMU_USER
from psutil.tests import PsutilTestCase
from psutil.tests import ThreadTask
from psutil.tests import call_until
from psutil.tests import copyload_shared_lib
from psutil.tests import create_c_exe
from psutil.tests import create_py_exe
from psutil.tests import mock
from psutil.tests import process_namespace
from psutil.tests import pytest
from psutil.tests import reap_children
from psutil.tests import retry_on_failure
from psutil.tests import sh
from psutil.tests import skip_on_access_denied
from psutil.tests import skip_on_not_implemented
from psutil.tests import wait_for_pid
# ===================================================================
# --- psutil.Process class tests
# ===================================================================
class TestProcess(PsutilTestCase):
"""Tests for psutil.Process class."""
def spawn_psproc(self, *args, **kwargs):
sproc = self.spawn_testproc(*args, **kwargs)
try:
return psutil.Process(sproc.pid)
except psutil.NoSuchProcess:
self.assertPidGone(sproc.pid)
raise
# ---
def test_pid(self):
p = psutil.Process()
assert p.pid == os.getpid()
with pytest.raises(AttributeError):
p.pid = 33
def test_kill(self):
p = self.spawn_psproc()
p.kill()
code = p.wait()
if WINDOWS:
assert code == signal.SIGTERM
else:
assert code == -signal.SIGKILL
self.assertProcessGone(p)
def test_terminate(self):
p = self.spawn_psproc()
p.terminate()
code = p.wait()
if WINDOWS:
assert code == signal.SIGTERM
else:
assert code == -signal.SIGTERM
self.assertProcessGone(p)
def test_send_signal(self):
sig = signal.SIGKILL if POSIX else signal.SIGTERM
p = self.spawn_psproc()
p.send_signal(sig)
code = p.wait()
if WINDOWS:
assert code == sig
else:
assert code == -sig
self.assertProcessGone(p)
@pytest.mark.skipif(not POSIX, reason="not POSIX")
def test_send_signal_mocked(self):
sig = signal.SIGTERM
p = self.spawn_psproc()
with mock.patch(
'psutil.os.kill', side_effect=OSError(errno.ESRCH, "")
):
with pytest.raises(psutil.NoSuchProcess):
p.send_signal(sig)
p = self.spawn_psproc()
with mock.patch(
'psutil.os.kill', side_effect=OSError(errno.EPERM, "")
):
with pytest.raises(psutil.AccessDenied):
p.send_signal(sig)
def test_wait_exited(self):
# Test waitpid() + WIFEXITED -> WEXITSTATUS.
# normal return, same as exit(0)
cmd = [PYTHON_EXE, "-c", "pass"]
p = self.spawn_psproc(cmd)
code = p.wait()
assert code == 0
self.assertProcessGone(p)
# exit(1), implicit in case of error
cmd = [PYTHON_EXE, "-c", "1 / 0"]
p = self.spawn_psproc(cmd, stderr=subprocess.PIPE)
code = p.wait()
assert code == 1
self.assertProcessGone(p)
# via sys.exit()
cmd = [PYTHON_EXE, "-c", "import sys; sys.exit(5);"]
p = self.spawn_psproc(cmd)
code = p.wait()
assert code == 5
self.assertProcessGone(p)
# via os._exit()
cmd = [PYTHON_EXE, "-c", "import os; os._exit(5);"]
p = self.spawn_psproc(cmd)
code = p.wait()
assert code == 5
self.assertProcessGone(p)
@pytest.mark.skipif(NETBSD, reason="fails on NETBSD")
def test_wait_stopped(self):
p = self.spawn_psproc()
if POSIX:
# Test waitpid() + WIFSTOPPED and WIFCONTINUED.
# Note: if a process is stopped it ignores SIGTERM.
p.send_signal(signal.SIGSTOP)
with pytest.raises(psutil.TimeoutExpired):
p.wait(timeout=0.001)
p.send_signal(signal.SIGCONT)
with pytest.raises(psutil.TimeoutExpired):
p.wait(timeout=0.001)
p.send_signal(signal.SIGTERM)
assert p.wait() == -signal.SIGTERM
assert p.wait() == -signal.SIGTERM
else:
p.suspend()
with pytest.raises(psutil.TimeoutExpired):
p.wait(timeout=0.001)
p.resume()
with pytest.raises(psutil.TimeoutExpired):
p.wait(timeout=0.001)
p.terminate()
assert p.wait() == signal.SIGTERM
assert p.wait() == signal.SIGTERM
def test_wait_non_children(self):
# Test wait() against a process which is not our direct
# child.
child, grandchild = self.spawn_children_pair()
with pytest.raises(psutil.TimeoutExpired):
child.wait(0.01)
with pytest.raises(psutil.TimeoutExpired):
grandchild.wait(0.01)
# We also terminate the direct child otherwise the
# grandchild will hang until the parent is gone.
child.terminate()
grandchild.terminate()
child_ret = child.wait()
grandchild_ret = grandchild.wait()
if POSIX:
assert child_ret == -signal.SIGTERM
# For processes which are not our children we're supposed
# to get None.
assert grandchild_ret is None
else:
assert child_ret == signal.SIGTERM
assert child_ret == signal.SIGTERM
def test_wait_timeout(self):
p = self.spawn_psproc()
p.name()
with pytest.raises(psutil.TimeoutExpired):
p.wait(0.01)
with pytest.raises(psutil.TimeoutExpired):
p.wait(0)
with pytest.raises(ValueError):
p.wait(-1)
def test_wait_timeout_nonblocking(self):
p = self.spawn_psproc()
with pytest.raises(psutil.TimeoutExpired):
p.wait(0)
p.kill()
stop_at = time.time() + GLOBAL_TIMEOUT
while time.time() < stop_at:
try:
code = p.wait(0)
break
except psutil.TimeoutExpired:
pass
else:
raise self.fail('timeout')
if POSIX:
assert code == -signal.SIGKILL
else:
assert code == signal.SIGTERM
self.assertProcessGone(p)
def test_cpu_percent(self):
p = psutil.Process()
p.cpu_percent(interval=0.001)
p.cpu_percent(interval=0.001)
for _ in range(100):
percent = p.cpu_percent(interval=None)
assert isinstance(percent, float)
assert percent >= 0.0
with pytest.raises(ValueError):
p.cpu_percent(interval=-1)
def test_cpu_percent_numcpus_none(self):
# See: https://github.com/giampaolo/psutil/issues/1087
with mock.patch('psutil.cpu_count', return_value=None) as m:
psutil.Process().cpu_percent()
assert m.called
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_cpu_times(self):
times = psutil.Process().cpu_times()
assert times.user >= 0.0, times
assert times.system >= 0.0, times
assert times.children_user >= 0.0, times
assert times.children_system >= 0.0, times
if LINUX:
assert times.iowait >= 0.0, times
# make sure returned values can be pretty printed with strftime
for name in times._fields:
time.strftime("%H:%M:%S", time.localtime(getattr(times, name)))
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_cpu_times_2(self):
user_time, kernel_time = psutil.Process().cpu_times()[:2]
utime, ktime = os.times()[:2]
# Use os.times()[:2] as base values to compare our results
# using a tolerance of +/- 0.1 seconds.
# It will fail if the difference between the values is > 0.1s.
if (max([user_time, utime]) - min([user_time, utime])) > 0.1:
raise self.fail("expected: %s, found: %s" % (utime, user_time))
if (max([kernel_time, ktime]) - min([kernel_time, ktime])) > 0.1:
raise self.fail("expected: %s, found: %s" % (ktime, kernel_time))
@pytest.mark.skipif(not HAS_PROC_CPU_NUM, reason="not supported")
def test_cpu_num(self):
p = psutil.Process()
num = p.cpu_num()
assert num >= 0
if psutil.cpu_count() == 1:
assert num == 0
assert p.cpu_num() in range(psutil.cpu_count())
def test_create_time(self):
p = self.spawn_psproc()
now = time.time()
create_time = p.create_time()
# Use time.time() as base value to compare our result using a
# tolerance of +/- 1 second.
# It will fail if the difference between the values is > 2s.
difference = abs(create_time - now)
if difference > 2:
raise self.fail(
"expected: %s, found: %s, difference: %s"
% (now, create_time, difference)
)
# make sure returned value can be pretty printed with strftime
time.strftime("%Y %m %d %H:%M:%S", time.localtime(p.create_time()))
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_terminal(self):
terminal = psutil.Process().terminal()
if terminal is not None:
try:
tty = os.path.realpath(sh('tty'))
except RuntimeError:
# Note: happens if pytest is run without the `-s` opt.
raise pytest.skip("can't rely on `tty` CLI")
else:
assert terminal == tty
@pytest.mark.skipif(not HAS_PROC_IO_COUNTERS, reason="not supported")
@skip_on_not_implemented(only_if=LINUX)
def test_io_counters(self):
p = psutil.Process()
# test reads
io1 = p.io_counters()
with open(PYTHON_EXE, 'rb') as f:
f.read()
io2 = p.io_counters()
if not BSD and not AIX:
assert io2.read_count > io1.read_count
assert io2.write_count == io1.write_count
if LINUX:
assert io2.read_chars > io1.read_chars
assert io2.write_chars == io1.write_chars
else:
assert io2.read_bytes >= io1.read_bytes
assert io2.write_bytes >= io1.write_bytes
# test writes
io1 = p.io_counters()
with open(self.get_testfn(), 'wb') as f:
if PY3:
f.write(bytes("x" * 1000000, 'ascii'))
else:
f.write("x" * 1000000)
io2 = p.io_counters()
assert io2.write_count >= io1.write_count
assert io2.write_bytes >= io1.write_bytes
assert io2.read_count >= io1.read_count
assert io2.read_bytes >= io1.read_bytes
if LINUX:
assert io2.write_chars > io1.write_chars
assert io2.read_chars >= io1.read_chars
# sanity check
for i in range(len(io2)):
if BSD and i >= 2:
# On BSD read_bytes and write_bytes are always set to -1.
continue
assert io2[i] >= 0
assert io2[i] >= 0
@pytest.mark.skipif(not HAS_IONICE, reason="not supported")
@pytest.mark.skipif(not LINUX, reason="linux only")
def test_ionice_linux(self):
def cleanup(init):
ioclass, value = init
if ioclass == psutil.IOPRIO_CLASS_NONE:
value = 0
p.ionice(ioclass, value)
p = psutil.Process()
if not CI_TESTING:
assert p.ionice()[0] == psutil.IOPRIO_CLASS_NONE
assert psutil.IOPRIO_CLASS_NONE == 0
assert psutil.IOPRIO_CLASS_RT == 1 # high
assert psutil.IOPRIO_CLASS_BE == 2 # normal
assert psutil.IOPRIO_CLASS_IDLE == 3 # low
init = p.ionice()
self.addCleanup(cleanup, init)
# low
p.ionice(psutil.IOPRIO_CLASS_IDLE)
assert tuple(p.ionice()) == (psutil.IOPRIO_CLASS_IDLE, 0)
with pytest.raises(ValueError): # accepts no value
p.ionice(psutil.IOPRIO_CLASS_IDLE, value=7)
# normal
p.ionice(psutil.IOPRIO_CLASS_BE)
assert tuple(p.ionice()) == (psutil.IOPRIO_CLASS_BE, 0)
p.ionice(psutil.IOPRIO_CLASS_BE, value=7)
assert tuple(p.ionice()) == (psutil.IOPRIO_CLASS_BE, 7)
with pytest.raises(ValueError):
p.ionice(psutil.IOPRIO_CLASS_BE, value=8)
try:
p.ionice(psutil.IOPRIO_CLASS_RT, value=7)
except psutil.AccessDenied:
pass
# errs
with pytest.raises(ValueError, match="ioclass accepts no value"):
p.ionice(psutil.IOPRIO_CLASS_NONE, 1)
with pytest.raises(ValueError, match="ioclass accepts no value"):
p.ionice(psutil.IOPRIO_CLASS_IDLE, 1)
with pytest.raises(
ValueError, match="'ioclass' argument must be specified"
):
p.ionice(value=1)
@pytest.mark.skipif(not HAS_IONICE, reason="not supported")
@pytest.mark.skipif(
not WINDOWS, reason="not supported on this win version"
)
def test_ionice_win(self):
p = psutil.Process()
if not CI_TESTING:
assert p.ionice() == psutil.IOPRIO_NORMAL
init = p.ionice()
self.addCleanup(p.ionice, init)
# base
p.ionice(psutil.IOPRIO_VERYLOW)
assert p.ionice() == psutil.IOPRIO_VERYLOW
p.ionice(psutil.IOPRIO_LOW)
assert p.ionice() == psutil.IOPRIO_LOW
try:
p.ionice(psutil.IOPRIO_HIGH)
except psutil.AccessDenied:
pass
else:
assert p.ionice() == psutil.IOPRIO_HIGH
# errs
with pytest.raises(
TypeError, match="value argument not accepted on Windows"
):
p.ionice(psutil.IOPRIO_NORMAL, value=1)
with pytest.raises(ValueError, match="is not a valid priority"):
p.ionice(psutil.IOPRIO_HIGH + 1)
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_get(self):
import resource
p = psutil.Process(os.getpid())
names = [x for x in dir(psutil) if x.startswith('RLIMIT')]
assert names, names
for name in names:
value = getattr(psutil, name)
assert value >= 0
if name in dir(resource):
assert value == getattr(resource, name)
# XXX - On PyPy RLIMIT_INFINITY returned by
# resource.getrlimit() is reported as a very big long
# number instead of -1. It looks like a bug with PyPy.
if PYPY:
continue
assert p.rlimit(value) == resource.getrlimit(value)
else:
ret = p.rlimit(value)
assert len(ret) == 2
assert ret[0] >= -1
assert ret[1] >= -1
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_set(self):
p = self.spawn_psproc()
p.rlimit(psutil.RLIMIT_NOFILE, (5, 5))
assert p.rlimit(psutil.RLIMIT_NOFILE) == (5, 5)
# If pid is 0 prlimit() applies to the calling process and
# we don't want that.
if LINUX:
with pytest.raises(ValueError, match="can't use prlimit"):
psutil._psplatform.Process(0).rlimit(0)
with pytest.raises(ValueError):
p.rlimit(psutil.RLIMIT_NOFILE, (5, 5, 5))
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit(self):
p = psutil.Process()
testfn = self.get_testfn()
soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
try:
p.rlimit(psutil.RLIMIT_FSIZE, (1024, hard))
with open(testfn, "wb") as f:
f.write(b"X" * 1024)
# write() or flush() doesn't always cause the exception
# but close() will.
with pytest.raises(IOError) as exc:
with open(testfn, "wb") as f:
f.write(b"X" * 1025)
assert (exc.value.errno if PY3 else exc.value[0]) == errno.EFBIG
finally:
p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
assert p.rlimit(psutil.RLIMIT_FSIZE) == (soft, hard)
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_infinity(self):
# First set a limit, then re-set it by specifying INFINITY
# and assume we overridden the previous limit.
p = psutil.Process()
soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
try:
p.rlimit(psutil.RLIMIT_FSIZE, (1024, hard))
p.rlimit(psutil.RLIMIT_FSIZE, (psutil.RLIM_INFINITY, hard))
with open(self.get_testfn(), "wb") as f:
f.write(b"X" * 2048)
finally:
p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
assert p.rlimit(psutil.RLIMIT_FSIZE) == (soft, hard)
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_infinity_value(self):
# RLIMIT_FSIZE should be RLIM_INFINITY, which will be a really
# big number on a platform with large file support. On these
# platforms we need to test that the get/setrlimit functions
# properly convert the number to a C long long and that the
# conversion doesn't raise an error.
p = psutil.Process()
soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
assert hard == psutil.RLIM_INFINITY
p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
def test_num_threads(self):
# on certain platforms such as Linux we might test for exact
# thread number, since we always have with 1 thread per process,
# but this does not apply across all platforms (MACOS, Windows)
p = psutil.Process()
if OPENBSD:
try:
step1 = p.num_threads()
except psutil.AccessDenied:
raise pytest.skip("on OpenBSD this requires root access")
else:
step1 = p.num_threads()
with ThreadTask():
step2 = p.num_threads()
assert step2 == step1 + 1
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
def test_num_handles(self):
# a better test is done later into test/_windows.py
p = psutil.Process()
assert p.num_handles() > 0
@pytest.mark.skipif(not HAS_THREADS, reason="not supported")
def test_threads(self):
p = psutil.Process()
if OPENBSD:
try:
step1 = p.threads()
except psutil.AccessDenied:
raise pytest.skip("on OpenBSD this requires root access")
else:
step1 = p.threads()
with ThreadTask():
step2 = p.threads()
assert len(step2) == len(step1) + 1
athread = step2[0]
# test named tuple
assert athread.id == athread[0]
assert athread.user_time == athread[1]
assert athread.system_time == athread[2]
@retry_on_failure()
@skip_on_access_denied(only_if=MACOS)
@pytest.mark.skipif(not HAS_THREADS, reason="not supported")
def test_threads_2(self):
p = self.spawn_psproc()
if OPENBSD:
try:
p.threads()
except psutil.AccessDenied:
raise pytest.skip("on OpenBSD this requires root access")
assert (
abs(p.cpu_times().user - sum([x.user_time for x in p.threads()]))
< 0.1
)
assert (
abs(
p.cpu_times().system
- sum([x.system_time for x in p.threads()])
)
< 0.1
)
@retry_on_failure()
def test_memory_info(self):
p = psutil.Process()
# step 1 - get a base value to compare our results
rss1, vms1 = p.memory_info()[:2]
percent1 = p.memory_percent()
assert rss1 > 0
assert vms1 > 0
# step 2 - allocate some memory
memarr = [None] * 1500000
rss2, vms2 = p.memory_info()[:2]
percent2 = p.memory_percent()
# step 3 - make sure that the memory usage bumped up
assert rss2 > rss1
assert vms2 >= vms1 # vms might be equal
assert percent2 > percent1
del memarr
if WINDOWS:
mem = p.memory_info()
assert mem.rss == mem.wset
assert mem.vms == mem.pagefile
mem = p.memory_info()
for name in mem._fields:
assert getattr(mem, name) >= 0
def test_memory_full_info(self):
p = psutil.Process()
total = psutil.virtual_memory().total
mem = p.memory_full_info()
for name in mem._fields:
value = getattr(mem, name)
assert value >= 0
if name == 'vms' and OSX or LINUX:
continue
assert value <= total
if LINUX or WINDOWS or MACOS:
assert mem.uss >= 0
if LINUX:
assert mem.pss >= 0
assert mem.swap >= 0
@pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
def test_memory_maps(self):
p = psutil.Process()
maps = p.memory_maps()
assert len(maps) == len(set(maps))
ext_maps = p.memory_maps(grouped=False)
for nt in maps:
if not nt.path.startswith('['):
if QEMU_USER and "/bin/qemu-" in nt.path:
continue
assert os.path.isabs(nt.path), nt.path
if POSIX:
try:
assert os.path.exists(nt.path) or os.path.islink(
nt.path
), nt.path
except AssertionError:
if not LINUX:
raise
else:
# https://github.com/giampaolo/psutil/issues/759
with open_text('/proc/self/smaps') as f:
data = f.read()
if "%s (deleted)" % nt.path not in data:
raise
else:
# XXX - On Windows we have this strange behavior with
# 64 bit dlls: they are visible via explorer but cannot
# be accessed via os.stat() (wtf?).
if '64' not in os.path.basename(nt.path):
try:
st = os.stat(nt.path)
except FileNotFoundError:
pass
else:
assert stat.S_ISREG(st.st_mode), nt.path
for nt in ext_maps:
for fname in nt._fields:
value = getattr(nt, fname)
if fname == 'path':
continue
if fname in ('addr', 'perms'):
assert value, value
else:
assert isinstance(value, (int, long))
assert value >= 0, value
@pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
def test_memory_maps_lists_lib(self):
# Make sure a newly loaded shared lib is listed.
p = psutil.Process()
with copyload_shared_lib() as path:
def normpath(p):
return os.path.realpath(os.path.normcase(p))
libpaths = [normpath(x.path) for x in p.memory_maps()]
assert normpath(path) in libpaths
def test_memory_percent(self):
p = psutil.Process()
p.memory_percent()
with pytest.raises(ValueError):
p.memory_percent(memtype="?!?")
if LINUX or MACOS or WINDOWS:
p.memory_percent(memtype='uss')
def test_is_running(self):
p = self.spawn_psproc()
assert p.is_running()
assert p.is_running()
p.kill()
p.wait()
assert not p.is_running()
assert not p.is_running()
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_exe(self):
p = self.spawn_psproc()
exe = p.exe()
try:
assert exe == PYTHON_EXE
except AssertionError:
if WINDOWS and len(exe) == len(PYTHON_EXE):
# on Windows we don't care about case sensitivity
normcase = os.path.normcase
assert normcase(exe) == normcase(PYTHON_EXE)
else:
# certain platforms such as BSD are more accurate returning:
# "/usr/local/bin/python2.7"
# ...instead of:
# "/usr/local/bin/python"
# We do not want to consider this difference in accuracy
# an error.
ver = "%s.%s" % (sys.version_info[0], sys.version_info[1])
try:
assert exe.replace(ver, '') == PYTHON_EXE.replace(ver, '')
except AssertionError:
# Typically MACOS. Really not sure what to do here.
pass
out = sh([exe, "-c", "import os; print('hey')"])
assert out == 'hey'
def test_cmdline(self):
cmdline = [
PYTHON_EXE,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
p = self.spawn_psproc(cmdline)
if NETBSD and p.cmdline() == []:
# https://github.com/giampaolo/psutil/issues/2250
raise pytest.skip("OPENBSD: returned EBUSY")
# XXX - most of the times the underlying sysctl() call on Net
# and Open BSD returns a truncated string.
# Also /proc/pid/cmdline behaves the same so it looks
# like this is a kernel bug.
# XXX - AIX truncates long arguments in /proc/pid/cmdline
if NETBSD or OPENBSD or AIX:
assert p.cmdline()[0] == PYTHON_EXE
else:
if MACOS and CI_TESTING:
pyexe = p.cmdline()[0]
if pyexe != PYTHON_EXE:
assert ' '.join(p.cmdline()[1:]) == ' '.join(cmdline[1:])
return
if QEMU_USER:
assert ' '.join(p.cmdline()[2:]) == ' '.join(cmdline)
return
assert ' '.join(p.cmdline()) == ' '.join(cmdline)
@pytest.mark.skipif(PYPY, reason="broken on PYPY")
def test_long_cmdline(self):
cmdline = [PYTHON_EXE]
cmdline.extend(["-v"] * 50)
cmdline.extend(
["-c", "import time; [time.sleep(0.1) for x in range(100)]"]
)
p = self.spawn_psproc(cmdline)
if OPENBSD:
# XXX: for some reason the test process may turn into a
# zombie (don't know why).
try:
assert p.cmdline() == cmdline
except psutil.ZombieProcess:
raise pytest.skip("OPENBSD: process turned into zombie")
elif QEMU_USER:
assert p.cmdline()[2:] == cmdline
else:
ret = p.cmdline()
if NETBSD and ret == []:
# https://github.com/giampaolo/psutil/issues/2250
raise pytest.skip("OPENBSD: returned EBUSY")
assert ret == cmdline
def test_name(self):
p = self.spawn_psproc()
name = p.name().lower()
pyexe = os.path.basename(os.path.realpath(sys.executable)).lower()
assert pyexe.startswith(name), (pyexe, name)
@pytest.mark.skipif(PYPY or QEMU_USER, reason="unreliable on PYPY")
@pytest.mark.skipif(QEMU_USER, reason="unreliable on QEMU user")
def test_long_name(self):
pyexe = create_py_exe(self.get_testfn(suffix=string.digits * 2))
cmdline = [
pyexe,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
p = self.spawn_psproc(cmdline)
if OPENBSD:
# XXX: for some reason the test process may turn into a
# zombie (don't know why). Because the name() is long, all
# UNIX kernels truncate it to 15 chars, so internally psutil
# tries to guess the full name() from the cmdline(). But the
# cmdline() of a zombie on OpenBSD fails (internally), so we
# just compare the first 15 chars. Full explanation:
# https://github.com/giampaolo/psutil/issues/2239
try:
assert p.name() == os.path.basename(pyexe)
except AssertionError:
if p.status() == psutil.STATUS_ZOMBIE:
assert os.path.basename(pyexe).startswith(p.name())
else:
raise
else:
assert p.name() == os.path.basename(pyexe)
# XXX
@pytest.mark.skipif(SUNOS, reason="broken on SUNOS")
@pytest.mark.skipif(AIX, reason="broken on AIX")
@pytest.mark.skipif(PYPY, reason="broken on PYPY")
@pytest.mark.skipif(QEMU_USER, reason="broken on QEMU user")
def test_prog_w_funky_name(self):
# Test that name(), exe() and cmdline() correctly handle programs
# with funky chars such as spaces and ")", see:
# https://github.com/giampaolo/psutil/issues/628
pyexe = create_py_exe(self.get_testfn(suffix='foo bar )'))
cmdline = [
pyexe,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
p = self.spawn_psproc(cmdline)
assert p.cmdline() == cmdline
assert p.name() == os.path.basename(pyexe)
assert os.path.normcase(p.exe()) == os.path.normcase(pyexe)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_uids(self):
p = psutil.Process()
real, effective, _saved = p.uids()
# os.getuid() refers to "real" uid
assert real == os.getuid()
# os.geteuid() refers to "effective" uid
assert effective == os.geteuid()
# No such thing as os.getsuid() ("saved" uid), but starting
# from python 2.7 we have os.getresuid() which returns all
# of them.
if hasattr(os, "getresuid"):
assert os.getresuid() == p.uids()
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_gids(self):
p = psutil.Process()
real, effective, _saved = p.gids()
# os.getuid() refers to "real" uid
assert real == os.getgid()
# os.geteuid() refers to "effective" uid
assert effective == os.getegid()
# No such thing as os.getsgid() ("saved" gid), but starting
# from python 2.7 we have os.getresgid() which returns all
# of them.
if hasattr(os, "getresuid"):
assert os.getresgid() == p.gids()
def test_nice(self):
def cleanup(init):
try:
p.nice(init)
except psutil.AccessDenied:
pass
p = psutil.Process()
with pytest.raises(TypeError):
p.nice("str")
init = p.nice()
self.addCleanup(cleanup, init)
if WINDOWS:
highest_prio = None
for prio in [
psutil.IDLE_PRIORITY_CLASS,
psutil.BELOW_NORMAL_PRIORITY_CLASS,
psutil.NORMAL_PRIORITY_CLASS,
psutil.ABOVE_NORMAL_PRIORITY_CLASS,
psutil.HIGH_PRIORITY_CLASS,
psutil.REALTIME_PRIORITY_CLASS,
]:
with self.subTest(prio=prio):
try:
p.nice(prio)
except psutil.AccessDenied:
pass
else:
new_prio = p.nice()
# The OS may limit our maximum priority,
# even if the function succeeds. For higher
# priorities, we match either the expected
# value or the highest so far.
if prio in (
psutil.ABOVE_NORMAL_PRIORITY_CLASS,
psutil.HIGH_PRIORITY_CLASS,
psutil.REALTIME_PRIORITY_CLASS,
):
if new_prio == prio or highest_prio is None:
highest_prio = prio
assert new_prio == highest_prio
else:
assert new_prio == prio
else:
try:
if hasattr(os, "getpriority"):
assert (
os.getpriority(os.PRIO_PROCESS, os.getpid())
== p.nice()
)
p.nice(1)
assert p.nice() == 1
if hasattr(os, "getpriority"):
assert (
os.getpriority(os.PRIO_PROCESS, os.getpid())
== p.nice()
)
# XXX - going back to previous nice value raises
# AccessDenied on MACOS
if not MACOS:
p.nice(0)
assert p.nice() == 0
except psutil.AccessDenied:
pass
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_status(self):
p = psutil.Process()
assert p.status() == psutil.STATUS_RUNNING
def test_username(self):
p = self.spawn_psproc()
username = p.username()
if WINDOWS:
domain, username = username.split('\\')
getpass_user = getpass.getuser()
if getpass_user.endswith('$'):
# When running as a service account (most likely to be
# NetworkService), these user name calculations don't produce
# the same result, causing the test to fail.
raise pytest.skip('running as service account')
assert username == getpass_user
if 'USERDOMAIN' in os.environ:
assert domain == os.environ['USERDOMAIN']
else:
assert username == getpass.getuser()
def test_cwd(self):
p = self.spawn_psproc()
assert p.cwd() == os.getcwd()
def test_cwd_2(self):
cmd = [
PYTHON_EXE,
"-c",
(
"import os, time; os.chdir('..'); [time.sleep(0.1) for x in"
" range(100)]"
),
]
p = self.spawn_psproc(cmd)
call_until(lambda: p.cwd() == os.path.dirname(os.getcwd()))
@pytest.mark.skipif(not HAS_CPU_AFFINITY, reason="not supported")
def test_cpu_affinity(self):
p = psutil.Process()
initial = p.cpu_affinity()
assert initial, initial
self.addCleanup(p.cpu_affinity, initial)
if hasattr(os, "sched_getaffinity"):
assert initial == list(os.sched_getaffinity(p.pid))
assert len(initial) == len(set(initial))
all_cpus = list(range(len(psutil.cpu_percent(percpu=True))))
for n in all_cpus:
p.cpu_affinity([n])
assert p.cpu_affinity() == [n]
if hasattr(os, "sched_getaffinity"):
assert p.cpu_affinity() == list(os.sched_getaffinity(p.pid))
# also test num_cpu()
if hasattr(p, "num_cpu"):
assert p.cpu_affinity()[0] == p.num_cpu()
# [] is an alias for "all eligible CPUs"; on Linux this may
# not be equal to all available CPUs, see:
# https://github.com/giampaolo/psutil/issues/956
p.cpu_affinity([])
if LINUX:
assert p.cpu_affinity() == p._proc._get_eligible_cpus()
else:
assert p.cpu_affinity() == all_cpus
if hasattr(os, "sched_getaffinity"):
assert p.cpu_affinity() == list(os.sched_getaffinity(p.pid))
with pytest.raises(TypeError):
p.cpu_affinity(1)
p.cpu_affinity(initial)
# it should work with all iterables, not only lists
p.cpu_affinity(set(all_cpus))
p.cpu_affinity(tuple(all_cpus))
@pytest.mark.skipif(not HAS_CPU_AFFINITY, reason="not supported")
def test_cpu_affinity_errs(self):
p = self.spawn_psproc()
invalid_cpu = [len(psutil.cpu_times(percpu=True)) + 10]
with pytest.raises(ValueError):
p.cpu_affinity(invalid_cpu)
with pytest.raises(ValueError):
p.cpu_affinity(range(10000, 11000))
with pytest.raises(TypeError):
p.cpu_affinity([0, "1"])
with pytest.raises(ValueError):
p.cpu_affinity([0, -1])
@pytest.mark.skipif(not HAS_CPU_AFFINITY, reason="not supported")
def test_cpu_affinity_all_combinations(self):
p = psutil.Process()
initial = p.cpu_affinity()
assert initial, initial
self.addCleanup(p.cpu_affinity, initial)
# All possible CPU set combinations.
if len(initial) > 12:
initial = initial[:12] # ...otherwise it will take forever
combos = []
for i in range(len(initial) + 1):
for subset in itertools.combinations(initial, i):
if subset:
combos.append(list(subset))
for combo in combos:
p.cpu_affinity(combo)
assert sorted(p.cpu_affinity()) == sorted(combo)
# TODO: #595
@pytest.mark.skipif(BSD, reason="broken on BSD")
# can't find any process file on Appveyor
@pytest.mark.skipif(APPVEYOR, reason="unreliable on APPVEYOR")
def test_open_files(self):
p = psutil.Process()
testfn = self.get_testfn()
files = p.open_files()
assert testfn not in files
with open(testfn, 'wb') as f:
f.write(b'x' * 1024)
f.flush()
# give the kernel some time to see the new file
call_until(lambda: len(p.open_files()) != len(files))
files = p.open_files()
filenames = [os.path.normcase(x.path) for x in files]
assert os.path.normcase(testfn) in filenames
if LINUX:
for file in files:
if file.path == testfn:
assert file.position == 1024
for file in files:
assert os.path.isfile(file.path), file
# another process
cmdline = (
"import time; f = open(r'%s', 'r'); [time.sleep(0.1) for x in"
" range(100)];" % testfn
)
p = self.spawn_psproc([PYTHON_EXE, "-c", cmdline])
for x in range(100):
filenames = [os.path.normcase(x.path) for x in p.open_files()]
if testfn in filenames:
break
time.sleep(0.01)
else:
assert os.path.normcase(testfn) in filenames
for file in filenames:
assert os.path.isfile(file), file
# TODO: #595
@pytest.mark.skipif(BSD, reason="broken on BSD")
# can't find any process file on Appveyor
@pytest.mark.skipif(APPVEYOR, reason="unreliable on APPVEYOR")
def test_open_files_2(self):
# test fd and path fields
p = psutil.Process()
normcase = os.path.normcase
testfn = self.get_testfn()
with open(testfn, 'w') as fileobj:
for file in p.open_files():
if (
normcase(file.path) == normcase(fileobj.name)
or file.fd == fileobj.fileno()
):
break
else:
raise self.fail(
"no file found; files=%s" % (repr(p.open_files()))
)
assert normcase(file.path) == normcase(fileobj.name)
if WINDOWS:
assert file.fd == -1
else:
assert file.fd == fileobj.fileno()
# test positions
ntuple = p.open_files()[0]
assert ntuple[0] == ntuple.path
assert ntuple[1] == ntuple.fd
# test file is gone
assert fileobj.name not in p.open_files()
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_num_fds(self):
p = psutil.Process()
testfn = self.get_testfn()
start = p.num_fds()
file = open(testfn, 'w')
self.addCleanup(file.close)
assert p.num_fds() == start + 1
sock = socket.socket()
self.addCleanup(sock.close)
assert p.num_fds() == start + 2
file.close()
sock.close()
assert p.num_fds() == start
@skip_on_not_implemented(only_if=LINUX)
@pytest.mark.skipif(
OPENBSD or NETBSD, reason="not reliable on OPENBSD & NETBSD"
)
def test_num_ctx_switches(self):
p = psutil.Process()
before = sum(p.num_ctx_switches())
for _ in range(2):
time.sleep(0.05) # this shall ensure a context switch happens
after = sum(p.num_ctx_switches())
if after > before:
return
raise self.fail("num ctx switches still the same after 2 iterations")
def test_ppid(self):
p = psutil.Process()
if hasattr(os, 'getppid'):
assert p.ppid() == os.getppid()
p = self.spawn_psproc()
assert p.ppid() == os.getpid()
def test_parent(self):
p = self.spawn_psproc()
assert p.parent().pid == os.getpid()
lowest_pid = psutil.pids()[0]
assert psutil.Process(lowest_pid).parent() is None
def test_parent_multi(self):
parent = psutil.Process()
child, grandchild = self.spawn_children_pair()
assert grandchild.parent() == child
assert child.parent() == parent
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
@retry_on_failure()
def test_parents(self):
parent = psutil.Process()
assert parent.parents()
child, grandchild = self.spawn_children_pair()
assert child.parents()[0] == parent
assert grandchild.parents()[0] == child
assert grandchild.parents()[1] == parent
def test_children(self):
parent = psutil.Process()
assert parent.children() == []
assert parent.children(recursive=True) == []
# On Windows we set the flag to 0 in order to cancel out the
# CREATE_NO_WINDOW flag (enabled by default) which creates
# an extra "conhost.exe" child.
child = self.spawn_psproc(creationflags=0)
children1 = parent.children()
children2 = parent.children(recursive=True)
for children in (children1, children2):
assert len(children) == 1
assert children[0].pid == child.pid
assert children[0].ppid() == parent.pid
def test_children_recursive(self):
# Test children() against two sub processes, p1 and p2, where
# p1 (our child) spawned p2 (our grandchild).
parent = psutil.Process()
child, grandchild = self.spawn_children_pair()
assert parent.children() == [child]
assert parent.children(recursive=True) == [child, grandchild]
# If the intermediate process is gone there's no way for
# children() to recursively find it.
child.terminate()
child.wait()
assert parent.children(recursive=True) == []
def test_children_duplicates(self):
# find the process which has the highest number of children
table = collections.defaultdict(int)
for p in psutil.process_iter():
try:
table[p.ppid()] += 1
except psutil.Error:
pass
# this is the one, now let's make sure there are no duplicates
pid = sorted(table.items(), key=lambda x: x[1])[-1][0]
if LINUX and pid == 0:
raise pytest.skip("PID 0")
p = psutil.Process(pid)
try:
c = p.children(recursive=True)
except psutil.AccessDenied: # windows
pass
else:
assert len(c) == len(set(c))
def test_parents_and_children(self):
parent = psutil.Process()
child, grandchild = self.spawn_children_pair()
# forward
children = parent.children(recursive=True)
assert len(children) == 2
assert children[0] == child
assert children[1] == grandchild
# backward
parents = grandchild.parents()
assert parents[0] == child
assert parents[1] == parent
def test_suspend_resume(self):
p = self.spawn_psproc()
p.suspend()
for _ in range(100):
if p.status() == psutil.STATUS_STOPPED:
break
time.sleep(0.01)
p.resume()
assert p.status() != psutil.STATUS_STOPPED
def test_invalid_pid(self):
with pytest.raises(TypeError):
psutil.Process("1")
with pytest.raises(ValueError):
psutil.Process(-1)
def test_as_dict(self):
p = psutil.Process()
d = p.as_dict(attrs=['exe', 'name'])
assert sorted(d.keys()) == ['exe', 'name']
p = psutil.Process(min(psutil.pids()))
d = p.as_dict(attrs=['net_connections'], ad_value='foo')
if not isinstance(d['net_connections'], list):
assert d['net_connections'] == 'foo'
# Test ad_value is set on AccessDenied.
with mock.patch(
'psutil.Process.nice', create=True, side_effect=psutil.AccessDenied
):
assert p.as_dict(attrs=["nice"], ad_value=1) == {"nice": 1}
# Test that NoSuchProcess bubbles up.
with mock.patch(
'psutil.Process.nice',
create=True,
side_effect=psutil.NoSuchProcess(p.pid, "name"),
):
with pytest.raises(psutil.NoSuchProcess):
p.as_dict(attrs=["nice"])
# Test that ZombieProcess is swallowed.
with mock.patch(
'psutil.Process.nice',
create=True,
side_effect=psutil.ZombieProcess(p.pid, "name"),
):
assert p.as_dict(attrs=["nice"], ad_value="foo") == {"nice": "foo"}
# By default APIs raising NotImplementedError are
# supposed to be skipped.
with mock.patch(
'psutil.Process.nice', create=True, side_effect=NotImplementedError
):
d = p.as_dict()
assert 'nice' not in list(d.keys())
# ...unless the user explicitly asked for some attr.
with pytest.raises(NotImplementedError):
p.as_dict(attrs=["nice"])
# errors
with pytest.raises(TypeError):
p.as_dict('name')
with pytest.raises(ValueError):
p.as_dict(['foo'])
with pytest.raises(ValueError):
p.as_dict(['foo', 'bar'])
def test_oneshot(self):
p = psutil.Process()
with mock.patch("psutil._psplatform.Process.cpu_times") as m:
with p.oneshot():
p.cpu_times()
p.cpu_times()
assert m.call_count == 1
with mock.patch("psutil._psplatform.Process.cpu_times") as m:
p.cpu_times()
p.cpu_times()
assert m.call_count == 2
def test_oneshot_twice(self):
# Test the case where the ctx manager is __enter__ed twice.
# The second __enter__ is supposed to resut in a NOOP.
p = psutil.Process()
with mock.patch("psutil._psplatform.Process.cpu_times") as m1:
with mock.patch("psutil._psplatform.Process.oneshot_enter") as m2:
with p.oneshot():
p.cpu_times()
p.cpu_times()
with p.oneshot():
p.cpu_times()
p.cpu_times()
assert m1.call_count == 1
assert m2.call_count == 1
with mock.patch("psutil._psplatform.Process.cpu_times") as m:
p.cpu_times()
p.cpu_times()
assert m.call_count == 2
def test_oneshot_cache(self):
# Make sure oneshot() cache is nonglobal. Instead it's
# supposed to be bound to the Process instance, see:
# https://github.com/giampaolo/psutil/issues/1373
p1, p2 = self.spawn_children_pair()
p1_ppid = p1.ppid()
p2_ppid = p2.ppid()
assert p1_ppid != p2_ppid
with p1.oneshot():
assert p1.ppid() == p1_ppid
assert p2.ppid() == p2_ppid
with p2.oneshot():
assert p1.ppid() == p1_ppid
assert p2.ppid() == p2_ppid
def test_halfway_terminated_process(self):
# Test that NoSuchProcess exception gets raised in case the
# process dies after we create the Process object.
# Example:
# >>> proc = Process(1234)
# >>> time.sleep(2) # time-consuming task, process dies in meantime
# >>> proc.name()
# Refers to Issue #15
def assert_raises_nsp(fun, fun_name):
try:
ret = fun()
except psutil.ZombieProcess: # differentiate from NSP
raise
except psutil.NoSuchProcess:
pass
except psutil.AccessDenied:
if OPENBSD and fun_name in ('threads', 'num_threads'):
return
raise
else:
# NtQuerySystemInformation succeeds even if process is gone.
if WINDOWS and fun_name in ('exe', 'name'):
return
raise self.fail(
"%r didn't raise NSP and returned %r instead" % (fun, ret)
)
p = self.spawn_psproc()
p.terminate()
p.wait()
if WINDOWS: # XXX
call_until(lambda: p.pid not in psutil.pids())
self.assertProcessGone(p)
ns = process_namespace(p)
for fun, name in ns.iter(ns.all):
assert_raises_nsp(fun, name)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_zombie_process(self):
_parent, zombie = self.spawn_zombie()
self.assertProcessZombie(zombie)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_zombie_process_is_running_w_exc(self):
# Emulate a case where internally is_running() raises
# ZombieProcess.
p = psutil.Process()
with mock.patch(
"psutil.Process", side_effect=psutil.ZombieProcess(0)
) as m:
assert p.is_running()
assert m.called
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_zombie_process_status_w_exc(self):
# Emulate a case where internally status() raises
# ZombieProcess.
p = psutil.Process()
with mock.patch(
"psutil._psplatform.Process.status",
side_effect=psutil.ZombieProcess(0),
) as m:
assert p.status() == psutil.STATUS_ZOMBIE
assert m.called
def test_reused_pid(self):
# Emulate a case where PID has been reused by another process.
if PY3:
from io import StringIO
else:
from StringIO import StringIO
subp = self.spawn_testproc()
p = psutil.Process(subp.pid)
p._ident = (p.pid, p.create_time() + 100)
list(psutil.process_iter())
assert p.pid in psutil._pmap
assert not p.is_running()
# make sure is_running() removed PID from process_iter()
# internal cache
with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
with redirect_stderr(StringIO()) as f:
list(psutil.process_iter())
assert (
"refreshing Process instance for reused PID %s" % p.pid
in f.getvalue()
)
assert p.pid not in psutil._pmap
assert p != psutil.Process(subp.pid)
msg = "process no longer exists and its PID has been reused"
ns = process_namespace(p)
for fun, name in ns.iter(ns.setters + ns.killers, clear_cache=False):
with self.subTest(name=name):
with pytest.raises(psutil.NoSuchProcess, match=msg):
fun()
assert "terminated + PID reused" in str(p)
assert "terminated + PID reused" in repr(p)
with pytest.raises(psutil.NoSuchProcess, match=msg):
p.ppid()
with pytest.raises(psutil.NoSuchProcess, match=msg):
p.parent()
with pytest.raises(psutil.NoSuchProcess, match=msg):
p.parents()
with pytest.raises(psutil.NoSuchProcess, match=msg):
p.children()
def test_pid_0(self):
# Process(0) is supposed to work on all platforms except Linux
if 0 not in psutil.pids():
with pytest.raises(psutil.NoSuchProcess):
psutil.Process(0)
# These 2 are a contradiction, but "ps" says PID 1's parent
# is PID 0.
assert not psutil.pid_exists(0)
assert psutil.Process(1).ppid() == 0
return
p = psutil.Process(0)
exc = psutil.AccessDenied if WINDOWS else ValueError
with pytest.raises(exc):
p.wait()
with pytest.raises(exc):
p.terminate()
with pytest.raises(exc):
p.suspend()
with pytest.raises(exc):
p.resume()
with pytest.raises(exc):
p.kill()
with pytest.raises(exc):
p.send_signal(signal.SIGTERM)
# test all methods
ns = process_namespace(p)
for fun, name in ns.iter(ns.getters + ns.setters):
try:
ret = fun()
except psutil.AccessDenied:
pass
else:
if name in ("uids", "gids"):
assert ret.real == 0
elif name == "username":
user = 'NT AUTHORITY\\SYSTEM' if WINDOWS else 'root'
assert p.username() == user
elif name == "name":
assert name, name
if not OPENBSD:
assert 0 in psutil.pids()
assert psutil.pid_exists(0)
@pytest.mark.skipif(not HAS_ENVIRON, reason="not supported")
def test_environ(self):
def clean_dict(d):
exclude = ["PLAT", "HOME", "PYTEST_CURRENT_TEST", "PYTEST_VERSION"]
if MACOS:
exclude.extend([
"__CF_USER_TEXT_ENCODING",
"VERSIONER_PYTHON_PREFER_32_BIT",
"VERSIONER_PYTHON_VERSION",
"VERSIONER_PYTHON_VERSION",
])
for name in exclude:
d.pop(name, None)
return dict([
(
k.replace("\r", "").replace("\n", ""),
v.replace("\r", "").replace("\n", ""),
)
for k, v in d.items()
])
self.maxDiff = None
p = psutil.Process()
d1 = clean_dict(p.environ())
d2 = clean_dict(os.environ.copy())
if not OSX and GITHUB_ACTIONS:
assert d1 == d2
@pytest.mark.skipif(not HAS_ENVIRON, reason="not supported")
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@pytest.mark.skipif(
MACOS_11PLUS,
reason="macOS 11+ can't get another process environment, issue #2084",
)
@pytest.mark.skipif(
NETBSD, reason="sometimes fails on `assert is_running()`"
)
def test_weird_environ(self):
# environment variables can contain values without an equals sign
code = textwrap.dedent("""
#include <unistd.h>
#include <fcntl.h>
char * const argv[] = {"cat", 0};
char * const envp[] = {"A=1", "X", "C=3", 0};
int main(void) {
// Close stderr on exec so parent can wait for the
// execve to finish.
if (fcntl(2, F_SETFD, FD_CLOEXEC) != 0)
return 0;
return execve("/bin/cat", argv, envp);
}
""")
cexe = create_c_exe(self.get_testfn(), c_code=code)
sproc = self.spawn_testproc(
[cexe], stdin=subprocess.PIPE, stderr=subprocess.PIPE
)
p = psutil.Process(sproc.pid)
wait_for_pid(p.pid)
assert p.is_running()
# Wait for process to exec or exit.
assert sproc.stderr.read() == b""
if MACOS and CI_TESTING:
try:
env = p.environ()
except psutil.AccessDenied:
# XXX: fails sometimes with:
# PermissionError from 'sysctl(KERN_PROCARGS2) -> EIO'
return
else:
env = p.environ()
assert env == {"A": "1", "C": "3"}
sproc.communicate()
assert sproc.returncode == 0
# ===================================================================
# --- Limited user tests
# ===================================================================
if POSIX and os.getuid() == 0:
class LimitedUserTestCase(TestProcess):
"""Repeat the previous tests by using a limited user.
Executed only on UNIX and only if the user who run the test script
is root.
"""
# the uid/gid the test suite runs under
if hasattr(os, 'getuid'):
PROCESS_UID = os.getuid()
PROCESS_GID = os.getgid()
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
# re-define all existent test methods in order to
# ignore AccessDenied exceptions
for attr in [x for x in dir(self) if x.startswith('test')]:
meth = getattr(self, attr)
def test_(self):
try:
meth() # noqa
except psutil.AccessDenied:
pass
setattr(self, attr, types.MethodType(test_, self))
def setUp(self):
super().setUp()
os.setegid(1000)
os.seteuid(1000)
def tearDown(self):
os.setegid(self.PROCESS_UID)
os.seteuid(self.PROCESS_GID)
super().tearDown()
def test_nice(self):
try:
psutil.Process().nice(-1)
except psutil.AccessDenied:
pass
else:
raise self.fail("exception not raised")
@pytest.mark.skipif(True, reason="causes problem as root")
def test_zombie_process(self):
pass
# ===================================================================
# --- psutil.Popen tests
# ===================================================================
class TestPopen(PsutilTestCase):
"""Tests for psutil.Popen class."""
@classmethod
def tearDownClass(cls):
reap_children()
def test_misc(self):
# XXX this test causes a ResourceWarning on Python 3 because
# psutil.__subproc instance doesn't get properly freed.
# Not sure what to do though.
cmd = [
PYTHON_EXE,
"-c",
"import time; [time.sleep(0.1) for x in range(100)];",
]
with psutil.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
env=PYTHON_EXE_ENV,
) as proc:
proc.name()
proc.cpu_times()
proc.stdin # noqa
assert dir(proc)
with pytest.raises(AttributeError):
proc.foo # noqa
proc.terminate()
if POSIX:
assert proc.wait(5) == -signal.SIGTERM
else:
assert proc.wait(5) == signal.SIGTERM
def test_ctx_manager(self):
with psutil.Popen(
[PYTHON_EXE, "-V"],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
stdin=subprocess.PIPE,
env=PYTHON_EXE_ENV,
) as proc:
proc.communicate()
assert proc.stdout.closed
assert proc.stderr.closed
assert proc.stdin.closed
assert proc.returncode == 0
def test_kill_terminate(self):
# subprocess.Popen()'s terminate(), kill() and send_signal() do
# not raise exception after the process is gone. psutil.Popen
# diverges from that.
cmd = [
PYTHON_EXE,
"-c",
"import time; [time.sleep(0.1) for x in range(100)];",
]
with psutil.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
env=PYTHON_EXE_ENV,
) as proc:
proc.terminate()
proc.wait()
with pytest.raises(psutil.NoSuchProcess):
proc.terminate()
with pytest.raises(psutil.NoSuchProcess):
proc.kill()
with pytest.raises(psutil.NoSuchProcess):
proc.send_signal(signal.SIGTERM)
if WINDOWS:
with pytest.raises(psutil.NoSuchProcess):
proc.send_signal(signal.CTRL_C_EVENT)
with pytest.raises(psutil.NoSuchProcess):
proc.send_signal(signal.CTRL_BREAK_EVENT)
PK ok\��� O� O� psutil/tests/test_system.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Tests for system APIS."""
import contextlib
import datetime
import errno
import os
import platform
import pprint
import shutil
import signal
import socket
import sys
import time
import psutil
from psutil import AIX
from psutil import BSD
from psutil import FREEBSD
from psutil import LINUX
from psutil import MACOS
from psutil import NETBSD
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil import WINDOWS
from psutil._compat import PY3
from psutil._compat import FileNotFoundError
from psutil._compat import long
from psutil.tests import ASCII_FS
from psutil.tests import CI_TESTING
from psutil.tests import DEVNULL
from psutil.tests import GITHUB_ACTIONS
from psutil.tests import GLOBAL_TIMEOUT
from psutil.tests import HAS_BATTERY
from psutil.tests import HAS_CPU_FREQ
from psutil.tests import HAS_GETLOADAVG
from psutil.tests import HAS_NET_IO_COUNTERS
from psutil.tests import HAS_SENSORS_BATTERY
from psutil.tests import HAS_SENSORS_FANS
from psutil.tests import HAS_SENSORS_TEMPERATURES
from psutil.tests import IS_64BIT
from psutil.tests import MACOS_12PLUS
from psutil.tests import PYPY
from psutil.tests import QEMU_USER
from psutil.tests import UNICODE_SUFFIX
from psutil.tests import PsutilTestCase
from psutil.tests import check_net_address
from psutil.tests import enum
from psutil.tests import mock
from psutil.tests import pytest
from psutil.tests import retry_on_failure
# ===================================================================
# --- System-related API tests
# ===================================================================
class TestProcessIter(PsutilTestCase):
def test_pid_presence(self):
assert os.getpid() in [x.pid for x in psutil.process_iter()]
sproc = self.spawn_testproc()
assert sproc.pid in [x.pid for x in psutil.process_iter()]
p = psutil.Process(sproc.pid)
p.kill()
p.wait()
assert sproc.pid not in [x.pid for x in psutil.process_iter()]
def test_no_duplicates(self):
ls = [x for x in psutil.process_iter()]
assert sorted(ls, key=lambda x: x.pid) == sorted(
set(ls), key=lambda x: x.pid
)
def test_emulate_nsp(self):
list(psutil.process_iter()) # populate cache
for x in range(2):
with mock.patch(
'psutil.Process.as_dict',
side_effect=psutil.NoSuchProcess(os.getpid()),
):
assert list(psutil.process_iter(attrs=["cpu_times"])) == []
psutil.process_iter.cache_clear() # repeat test without cache
def test_emulate_access_denied(self):
list(psutil.process_iter()) # populate cache
for x in range(2):
with mock.patch(
'psutil.Process.as_dict',
side_effect=psutil.AccessDenied(os.getpid()),
):
with pytest.raises(psutil.AccessDenied):
list(psutil.process_iter(attrs=["cpu_times"]))
psutil.process_iter.cache_clear() # repeat test without cache
def test_attrs(self):
for p in psutil.process_iter(attrs=['pid']):
assert list(p.info.keys()) == ['pid']
# yield again
for p in psutil.process_iter(attrs=['pid']):
assert list(p.info.keys()) == ['pid']
with pytest.raises(ValueError):
list(psutil.process_iter(attrs=['foo']))
with mock.patch(
"psutil._psplatform.Process.cpu_times",
side_effect=psutil.AccessDenied(0, ""),
) as m:
for p in psutil.process_iter(attrs=["pid", "cpu_times"]):
assert p.info['cpu_times'] is None
assert p.info['pid'] >= 0
assert m.called
with mock.patch(
"psutil._psplatform.Process.cpu_times",
side_effect=psutil.AccessDenied(0, ""),
) as m:
flag = object()
for p in psutil.process_iter(
attrs=["pid", "cpu_times"], ad_value=flag
):
assert p.info['cpu_times'] is flag
assert p.info['pid'] >= 0
assert m.called
def test_cache_clear(self):
list(psutil.process_iter()) # populate cache
assert psutil._pmap
psutil.process_iter.cache_clear()
assert not psutil._pmap
class TestProcessAPIs(PsutilTestCase):
@pytest.mark.skipif(
PYPY and WINDOWS,
reason="spawn_testproc() unreliable on PYPY + WINDOWS",
)
def test_wait_procs(self):
def callback(p):
pids.append(p.pid)
pids = []
sproc1 = self.spawn_testproc()
sproc2 = self.spawn_testproc()
sproc3 = self.spawn_testproc()
procs = [psutil.Process(x.pid) for x in (sproc1, sproc2, sproc3)]
with pytest.raises(ValueError):
psutil.wait_procs(procs, timeout=-1)
with pytest.raises(TypeError):
psutil.wait_procs(procs, callback=1)
t = time.time()
gone, alive = psutil.wait_procs(procs, timeout=0.01, callback=callback)
assert time.time() - t < 0.5
assert gone == []
assert len(alive) == 3
assert pids == []
for p in alive:
assert not hasattr(p, 'returncode')
@retry_on_failure(30)
def test_1(procs, callback):
gone, alive = psutil.wait_procs(
procs, timeout=0.03, callback=callback
)
assert len(gone) == 1
assert len(alive) == 2
return gone, alive
sproc3.terminate()
gone, alive = test_1(procs, callback)
assert sproc3.pid in [x.pid for x in gone]
if POSIX:
assert gone.pop().returncode == -signal.SIGTERM
else:
assert gone.pop().returncode == 1
assert pids == [sproc3.pid]
for p in alive:
assert not hasattr(p, 'returncode')
@retry_on_failure(30)
def test_2(procs, callback):
gone, alive = psutil.wait_procs(
procs, timeout=0.03, callback=callback
)
assert len(gone) == 3
assert len(alive) == 0
return gone, alive
sproc1.terminate()
sproc2.terminate()
gone, alive = test_2(procs, callback)
assert set(pids) == set([sproc1.pid, sproc2.pid, sproc3.pid])
for p in gone:
assert hasattr(p, 'returncode')
@pytest.mark.skipif(
PYPY and WINDOWS,
reason="spawn_testproc() unreliable on PYPY + WINDOWS",
)
def test_wait_procs_no_timeout(self):
sproc1 = self.spawn_testproc()
sproc2 = self.spawn_testproc()
sproc3 = self.spawn_testproc()
procs = [psutil.Process(x.pid) for x in (sproc1, sproc2, sproc3)]
for p in procs:
p.terminate()
psutil.wait_procs(procs)
def test_pid_exists(self):
sproc = self.spawn_testproc()
assert psutil.pid_exists(sproc.pid)
p = psutil.Process(sproc.pid)
p.kill()
p.wait()
assert not psutil.pid_exists(sproc.pid)
assert not psutil.pid_exists(-1)
assert psutil.pid_exists(0) == (0 in psutil.pids())
def test_pid_exists_2(self):
pids = psutil.pids()
for pid in pids:
try:
assert psutil.pid_exists(pid)
except AssertionError:
# in case the process disappeared in meantime fail only
# if it is no longer in psutil.pids()
time.sleep(0.1)
assert pid not in psutil.pids()
pids = range(max(pids) + 15000, max(pids) + 16000)
for pid in pids:
assert not psutil.pid_exists(pid)
class TestMiscAPIs(PsutilTestCase):
def test_boot_time(self):
bt = psutil.boot_time()
assert isinstance(bt, float)
assert bt > 0
assert bt < time.time()
@pytest.mark.skipif(
CI_TESTING and not psutil.users(), reason="unreliable on CI"
)
def test_users(self):
users = psutil.users()
assert users != []
for user in users:
with self.subTest(user=user):
assert user.name
assert isinstance(user.name, str)
assert isinstance(user.terminal, (str, type(None)))
if user.host is not None:
assert isinstance(user.host, (str, type(None)))
user.terminal # noqa
user.host # noqa
assert user.started > 0.0
datetime.datetime.fromtimestamp(user.started)
if WINDOWS or OPENBSD:
assert user.pid is None
else:
psutil.Process(user.pid)
def test_test(self):
# test for psutil.test() function
stdout = sys.stdout
sys.stdout = DEVNULL
try:
psutil.test()
finally:
sys.stdout = stdout
def test_os_constants(self):
names = [
"POSIX",
"WINDOWS",
"LINUX",
"MACOS",
"FREEBSD",
"OPENBSD",
"NETBSD",
"BSD",
"SUNOS",
]
for name in names:
assert isinstance(getattr(psutil, name), bool), name
if os.name == 'posix':
assert psutil.POSIX
assert not psutil.WINDOWS
names.remove("POSIX")
if "linux" in sys.platform.lower():
assert psutil.LINUX
names.remove("LINUX")
elif "bsd" in sys.platform.lower():
assert psutil.BSD
assert [psutil.FREEBSD, psutil.OPENBSD, psutil.NETBSD].count(
True
) == 1
names.remove("BSD")
names.remove("FREEBSD")
names.remove("OPENBSD")
names.remove("NETBSD")
elif (
"sunos" in sys.platform.lower()
or "solaris" in sys.platform.lower()
):
assert psutil.SUNOS
names.remove("SUNOS")
elif "darwin" in sys.platform.lower():
assert psutil.MACOS
names.remove("MACOS")
else:
assert psutil.WINDOWS
assert not psutil.POSIX
names.remove("WINDOWS")
# assert all other constants are set to False
for name in names:
assert not getattr(psutil, name), name
class TestMemoryAPIs(PsutilTestCase):
def test_virtual_memory(self):
mem = psutil.virtual_memory()
assert mem.total > 0, mem
assert mem.available > 0, mem
assert 0 <= mem.percent <= 100, mem
assert mem.used > 0, mem
assert mem.free >= 0, mem
for name in mem._fields:
value = getattr(mem, name)
if name != 'percent':
assert isinstance(value, (int, long))
if name != 'total':
if not value >= 0:
raise self.fail("%r < 0 (%s)" % (name, value))
if value > mem.total:
raise self.fail(
"%r > total (total=%s, %s=%s)"
% (name, mem.total, name, value)
)
def test_swap_memory(self):
mem = psutil.swap_memory()
assert mem._fields == (
'total',
'used',
'free',
'percent',
'sin',
'sout',
)
assert mem.total >= 0, mem
assert mem.used >= 0, mem
if mem.total > 0:
# likely a system with no swap partition
assert mem.free > 0, mem
else:
assert mem.free == 0, mem
assert 0 <= mem.percent <= 100, mem
assert mem.sin >= 0, mem
assert mem.sout >= 0, mem
class TestCpuAPIs(PsutilTestCase):
def test_cpu_count_logical(self):
logical = psutil.cpu_count()
assert logical is not None
assert logical == len(psutil.cpu_times(percpu=True))
assert logical >= 1
if os.path.exists("/proc/cpuinfo"):
with open("/proc/cpuinfo") as fd:
cpuinfo_data = fd.read()
if "physical id" not in cpuinfo_data:
raise pytest.skip("cpuinfo doesn't include physical id")
def test_cpu_count_cores(self):
logical = psutil.cpu_count()
cores = psutil.cpu_count(logical=False)
if cores is None:
raise pytest.skip("cpu_count_cores() is None")
if WINDOWS and sys.getwindowsversion()[:2] <= (6, 1): # <= Vista
assert cores is None
else:
assert cores >= 1
assert logical >= cores
def test_cpu_count_none(self):
# https://github.com/giampaolo/psutil/issues/1085
for val in (-1, 0, None):
with mock.patch(
'psutil._psplatform.cpu_count_logical', return_value=val
) as m:
assert psutil.cpu_count() is None
assert m.called
with mock.patch(
'psutil._psplatform.cpu_count_cores', return_value=val
) as m:
assert psutil.cpu_count(logical=False) is None
assert m.called
def test_cpu_times(self):
# Check type, value >= 0, str().
total = 0
times = psutil.cpu_times()
sum(times)
for cp_time in times:
assert isinstance(cp_time, float)
assert cp_time >= 0.0
total += cp_time
assert round(abs(total - sum(times)), 6) == 0
str(times)
# CPU times are always supposed to increase over time
# or at least remain the same and that's because time
# cannot go backwards.
# Surprisingly sometimes this might not be the case (at
# least on Windows and Linux), see:
# https://github.com/giampaolo/psutil/issues/392
# https://github.com/giampaolo/psutil/issues/645
# if not WINDOWS:
# last = psutil.cpu_times()
# for x in range(100):
# new = psutil.cpu_times()
# for field in new._fields:
# new_t = getattr(new, field)
# last_t = getattr(last, field)
# self.assertGreaterEqual(new_t, last_t,
# msg="%s %s" % (new_t, last_t))
# last = new
def test_cpu_times_time_increases(self):
# Make sure time increases between calls.
t1 = sum(psutil.cpu_times())
stop_at = time.time() + GLOBAL_TIMEOUT
while time.time() < stop_at:
t2 = sum(psutil.cpu_times())
if t2 > t1:
return
raise self.fail("time remained the same")
def test_per_cpu_times(self):
# Check type, value >= 0, str().
for times in psutil.cpu_times(percpu=True):
total = 0
sum(times)
for cp_time in times:
assert isinstance(cp_time, float)
assert cp_time >= 0.0
total += cp_time
assert round(abs(total - sum(times)), 6) == 0
str(times)
assert len(psutil.cpu_times(percpu=True)[0]) == len(
psutil.cpu_times(percpu=False)
)
# Note: in theory CPU times are always supposed to increase over
# time or remain the same but never go backwards. In practice
# sometimes this is not the case.
# This issue seemd to be afflict Windows:
# https://github.com/giampaolo/psutil/issues/392
# ...but it turns out also Linux (rarely) behaves the same.
# last = psutil.cpu_times(percpu=True)
# for x in range(100):
# new = psutil.cpu_times(percpu=True)
# for index in range(len(new)):
# newcpu = new[index]
# lastcpu = last[index]
# for field in newcpu._fields:
# new_t = getattr(newcpu, field)
# last_t = getattr(lastcpu, field)
# self.assertGreaterEqual(
# new_t, last_t, msg="%s %s" % (lastcpu, newcpu))
# last = new
def test_per_cpu_times_2(self):
# Simulate some work load then make sure time have increased
# between calls.
tot1 = psutil.cpu_times(percpu=True)
giveup_at = time.time() + GLOBAL_TIMEOUT
while True:
if time.time() >= giveup_at:
return self.fail("timeout")
tot2 = psutil.cpu_times(percpu=True)
for t1, t2 in zip(tot1, tot2):
t1, t2 = psutil._cpu_busy_time(t1), psutil._cpu_busy_time(t2)
difference = t2 - t1
if difference >= 0.05:
return
@pytest.mark.skipif(
CI_TESTING and OPENBSD, reason="unreliable on OPENBSD + CI"
)
def test_cpu_times_comparison(self):
# Make sure the sum of all per cpu times is almost equal to
# base "one cpu" times. On OpenBSD the sum of per-CPUs is
# higher for some reason.
base = psutil.cpu_times()
per_cpu = psutil.cpu_times(percpu=True)
summed_values = base._make([sum(num) for num in zip(*per_cpu)])
for field in base._fields:
with self.subTest(field=field, base=base, per_cpu=per_cpu):
assert (
abs(getattr(base, field) - getattr(summed_values, field))
< 1
)
def _test_cpu_percent(self, percent, last_ret, new_ret):
try:
assert isinstance(percent, float)
assert percent >= 0.0
assert percent is not -0.0
assert percent <= 100.0 * psutil.cpu_count()
except AssertionError as err:
raise AssertionError(
"\n%s\nlast=%s\nnew=%s"
% (err, pprint.pformat(last_ret), pprint.pformat(new_ret))
)
def test_cpu_percent(self):
last = psutil.cpu_percent(interval=0.001)
for _ in range(100):
new = psutil.cpu_percent(interval=None)
self._test_cpu_percent(new, last, new)
last = new
with pytest.raises(ValueError):
psutil.cpu_percent(interval=-1)
def test_per_cpu_percent(self):
last = psutil.cpu_percent(interval=0.001, percpu=True)
assert len(last) == psutil.cpu_count()
for _ in range(100):
new = psutil.cpu_percent(interval=None, percpu=True)
for percent in new:
self._test_cpu_percent(percent, last, new)
last = new
with pytest.raises(ValueError):
psutil.cpu_percent(interval=-1, percpu=True)
def test_cpu_times_percent(self):
last = psutil.cpu_times_percent(interval=0.001)
for _ in range(100):
new = psutil.cpu_times_percent(interval=None)
for percent in new:
self._test_cpu_percent(percent, last, new)
self._test_cpu_percent(sum(new), last, new)
last = new
with pytest.raises(ValueError):
psutil.cpu_times_percent(interval=-1)
def test_per_cpu_times_percent(self):
last = psutil.cpu_times_percent(interval=0.001, percpu=True)
assert len(last) == psutil.cpu_count()
for _ in range(100):
new = psutil.cpu_times_percent(interval=None, percpu=True)
for cpu in new:
for percent in cpu:
self._test_cpu_percent(percent, last, new)
self._test_cpu_percent(sum(cpu), last, new)
last = new
def test_per_cpu_times_percent_negative(self):
# see: https://github.com/giampaolo/psutil/issues/645
psutil.cpu_times_percent(percpu=True)
zero_times = [
x._make([0 for x in range(len(x._fields))])
for x in psutil.cpu_times(percpu=True)
]
with mock.patch('psutil.cpu_times', return_value=zero_times):
for cpu in psutil.cpu_times_percent(percpu=True):
for percent in cpu:
self._test_cpu_percent(percent, None, None)
def test_cpu_stats(self):
# Tested more extensively in per-platform test modules.
infos = psutil.cpu_stats()
assert infos._fields == (
'ctx_switches',
'interrupts',
'soft_interrupts',
'syscalls',
)
for name in infos._fields:
value = getattr(infos, name)
assert value >= 0
# on AIX, ctx_switches is always 0
if not AIX and name in ('ctx_switches', 'interrupts'):
assert value > 0
# TODO: remove this once 1892 is fixed
@pytest.mark.skipif(
MACOS and platform.machine() == 'arm64', reason="skipped due to #1892"
)
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_cpu_freq(self):
def check_ls(ls):
for nt in ls:
assert nt._fields == ('current', 'min', 'max')
if nt.max != 0.0:
assert nt.current <= nt.max
for name in nt._fields:
value = getattr(nt, name)
assert isinstance(value, (int, long, float))
assert value >= 0
ls = psutil.cpu_freq(percpu=True)
if FREEBSD and not ls:
raise pytest.skip("returns empty list on FreeBSD")
assert ls, ls
check_ls([psutil.cpu_freq(percpu=False)])
if LINUX:
assert len(ls) == psutil.cpu_count()
@pytest.mark.skipif(not HAS_GETLOADAVG, reason="not supported")
def test_getloadavg(self):
loadavg = psutil.getloadavg()
assert len(loadavg) == 3
for load in loadavg:
assert isinstance(load, float)
assert load >= 0.0
class TestDiskAPIs(PsutilTestCase):
@pytest.mark.skipif(
PYPY and not IS_64BIT, reason="unreliable on PYPY32 + 32BIT"
)
def test_disk_usage(self):
usage = psutil.disk_usage(os.getcwd())
assert usage._fields == ('total', 'used', 'free', 'percent')
assert usage.total > 0, usage
assert usage.used > 0, usage
assert usage.free > 0, usage
assert usage.total > usage.used, usage
assert usage.total > usage.free, usage
assert 0 <= usage.percent <= 100, usage.percent
if hasattr(shutil, 'disk_usage'):
# py >= 3.3, see: http://bugs.python.org/issue12442
shutil_usage = shutil.disk_usage(os.getcwd())
tolerance = 5 * 1024 * 1024 # 5MB
assert usage.total == shutil_usage.total
assert abs(usage.free - shutil_usage.free) < tolerance
if not MACOS_12PLUS:
# see https://github.com/giampaolo/psutil/issues/2147
assert abs(usage.used - shutil_usage.used) < tolerance
# if path does not exist OSError ENOENT is expected across
# all platforms
fname = self.get_testfn()
with pytest.raises(FileNotFoundError):
psutil.disk_usage(fname)
@pytest.mark.skipif(not ASCII_FS, reason="not an ASCII fs")
def test_disk_usage_unicode(self):
# See: https://github.com/giampaolo/psutil/issues/416
with pytest.raises(UnicodeEncodeError):
psutil.disk_usage(UNICODE_SUFFIX)
def test_disk_usage_bytes(self):
psutil.disk_usage(b'.')
def test_disk_partitions(self):
def check_ntuple(nt):
assert isinstance(nt.device, str)
assert isinstance(nt.mountpoint, str)
assert isinstance(nt.fstype, str)
assert isinstance(nt.opts, str)
# all = False
ls = psutil.disk_partitions(all=False)
assert ls
for disk in ls:
check_ntuple(disk)
if WINDOWS and 'cdrom' in disk.opts:
continue
if not POSIX:
assert os.path.exists(disk.device), disk
else:
# we cannot make any assumption about this, see:
# http://goo.gl/p9c43
disk.device # noqa
# on modern systems mount points can also be files
assert os.path.exists(disk.mountpoint), disk
assert disk.fstype, disk
# all = True
ls = psutil.disk_partitions(all=True)
assert ls
for disk in psutil.disk_partitions(all=True):
check_ntuple(disk)
if not WINDOWS and disk.mountpoint:
try:
os.stat(disk.mountpoint)
except OSError as err:
if GITHUB_ACTIONS and MACOS and err.errno == errno.EIO:
continue
# http://mail.python.org/pipermail/python-dev/
# 2012-June/120787.html
if err.errno not in (errno.EPERM, errno.EACCES):
raise
else:
assert os.path.exists(disk.mountpoint), disk
# ---
def find_mount_point(path):
path = os.path.abspath(path)
while not os.path.ismount(path):
path = os.path.dirname(path)
return path.lower()
mount = find_mount_point(__file__)
mounts = [
x.mountpoint.lower()
for x in psutil.disk_partitions(all=True)
if x.mountpoint
]
assert mount in mounts
@pytest.mark.skipif(
LINUX and not os.path.exists('/proc/diskstats'),
reason="/proc/diskstats not available on this linux version",
)
@pytest.mark.skipif(
CI_TESTING and not psutil.disk_io_counters(), reason="unreliable on CI"
) # no visible disks
def test_disk_io_counters(self):
def check_ntuple(nt):
assert nt[0] == nt.read_count
assert nt[1] == nt.write_count
assert nt[2] == nt.read_bytes
assert nt[3] == nt.write_bytes
if not (OPENBSD or NETBSD):
assert nt[4] == nt.read_time
assert nt[5] == nt.write_time
if LINUX:
assert nt[6] == nt.read_merged_count
assert nt[7] == nt.write_merged_count
assert nt[8] == nt.busy_time
elif FREEBSD:
assert nt[6] == nt.busy_time
for name in nt._fields:
assert getattr(nt, name) >= 0, nt
ret = psutil.disk_io_counters(perdisk=False)
assert ret is not None, "no disks on this system?"
check_ntuple(ret)
ret = psutil.disk_io_counters(perdisk=True)
# make sure there are no duplicates
assert len(ret) == len(set(ret))
for key in ret:
assert key, key
check_ntuple(ret[key])
def test_disk_io_counters_no_disks(self):
# Emulate a case where no disks are installed, see:
# https://github.com/giampaolo/psutil/issues/1062
with mock.patch(
'psutil._psplatform.disk_io_counters', return_value={}
) as m:
assert psutil.disk_io_counters(perdisk=False) is None
assert psutil.disk_io_counters(perdisk=True) == {}
assert m.called
class TestNetAPIs(PsutilTestCase):
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_net_io_counters(self):
def check_ntuple(nt):
assert nt[0] == nt.bytes_sent
assert nt[1] == nt.bytes_recv
assert nt[2] == nt.packets_sent
assert nt[3] == nt.packets_recv
assert nt[4] == nt.errin
assert nt[5] == nt.errout
assert nt[6] == nt.dropin
assert nt[7] == nt.dropout
assert nt.bytes_sent >= 0, nt
assert nt.bytes_recv >= 0, nt
assert nt.packets_sent >= 0, nt
assert nt.packets_recv >= 0, nt
assert nt.errin >= 0, nt
assert nt.errout >= 0, nt
assert nt.dropin >= 0, nt
assert nt.dropout >= 0, nt
ret = psutil.net_io_counters(pernic=False)
check_ntuple(ret)
ret = psutil.net_io_counters(pernic=True)
assert ret != []
for key in ret:
assert key
assert isinstance(key, str)
check_ntuple(ret[key])
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_net_io_counters_no_nics(self):
# Emulate a case where no NICs are installed, see:
# https://github.com/giampaolo/psutil/issues/1062
with mock.patch(
'psutil._psplatform.net_io_counters', return_value={}
) as m:
assert psutil.net_io_counters(pernic=False) is None
assert psutil.net_io_counters(pernic=True) == {}
assert m.called
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_net_if_addrs(self):
nics = psutil.net_if_addrs()
assert nics, nics
nic_stats = psutil.net_if_stats()
# Not reliable on all platforms (net_if_addrs() reports more
# interfaces).
# self.assertEqual(sorted(nics.keys()),
# sorted(psutil.net_io_counters(pernic=True).keys()))
families = set([socket.AF_INET, socket.AF_INET6, psutil.AF_LINK])
for nic, addrs in nics.items():
assert isinstance(nic, str)
assert len(set(addrs)) == len(addrs)
for addr in addrs:
assert isinstance(addr.family, int)
assert isinstance(addr.address, str)
assert isinstance(addr.netmask, (str, type(None)))
assert isinstance(addr.broadcast, (str, type(None)))
assert addr.family in families
if PY3 and not PYPY:
assert isinstance(addr.family, enum.IntEnum)
if nic_stats[nic].isup:
# Do not test binding to addresses of interfaces
# that are down
if addr.family == socket.AF_INET:
s = socket.socket(addr.family)
with contextlib.closing(s):
s.bind((addr.address, 0))
elif addr.family == socket.AF_INET6:
info = socket.getaddrinfo(
addr.address,
0,
socket.AF_INET6,
socket.SOCK_STREAM,
0,
socket.AI_PASSIVE,
)[0]
af, socktype, proto, _canonname, sa = info
s = socket.socket(af, socktype, proto)
with contextlib.closing(s):
s.bind(sa)
for ip in (
addr.address,
addr.netmask,
addr.broadcast,
addr.ptp,
):
if ip is not None:
# TODO: skip AF_INET6 for now because I get:
# AddressValueError: Only hex digits permitted in
# u'c6f3%lxcbr0' in u'fe80::c8e0:fff:fe54:c6f3%lxcbr0'
if addr.family != socket.AF_INET6:
check_net_address(ip, addr.family)
# broadcast and ptp addresses are mutually exclusive
if addr.broadcast:
assert addr.ptp is None
elif addr.ptp:
assert addr.broadcast is None
if BSD or MACOS or SUNOS:
if hasattr(socket, "AF_LINK"):
assert psutil.AF_LINK == socket.AF_LINK
elif LINUX:
assert psutil.AF_LINK == socket.AF_PACKET
elif WINDOWS:
assert psutil.AF_LINK == -1
def test_net_if_addrs_mac_null_bytes(self):
# Simulate that the underlying C function returns an incomplete
# MAC address. psutil is supposed to fill it with null bytes.
# https://github.com/giampaolo/psutil/issues/786
if POSIX:
ret = [('em1', psutil.AF_LINK, '06:3d:29', None, None, None)]
else:
ret = [('em1', -1, '06-3d-29', None, None, None)]
with mock.patch(
'psutil._psplatform.net_if_addrs', return_value=ret
) as m:
addr = psutil.net_if_addrs()['em1'][0]
assert m.called
if POSIX:
assert addr.address == '06:3d:29:00:00:00'
else:
assert addr.address == '06-3d-29-00-00-00'
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_net_if_stats(self):
nics = psutil.net_if_stats()
assert nics, nics
all_duplexes = (
psutil.NIC_DUPLEX_FULL,
psutil.NIC_DUPLEX_HALF,
psutil.NIC_DUPLEX_UNKNOWN,
)
for name, stats in nics.items():
assert isinstance(name, str)
isup, duplex, speed, mtu, flags = stats
assert isinstance(isup, bool)
assert duplex in all_duplexes
assert duplex in all_duplexes
assert speed >= 0
assert mtu >= 0
assert isinstance(flags, str)
@pytest.mark.skipif(
not (LINUX or BSD or MACOS), reason="LINUX or BSD or MACOS specific"
)
def test_net_if_stats_enodev(self):
# See: https://github.com/giampaolo/psutil/issues/1279
with mock.patch(
'psutil._psutil_posix.net_if_mtu',
side_effect=OSError(errno.ENODEV, ""),
) as m:
ret = psutil.net_if_stats()
assert ret == {}
assert m.called
class TestSensorsAPIs(PsutilTestCase):
@pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
def test_sensors_temperatures(self):
temps = psutil.sensors_temperatures()
for name, entries in temps.items():
assert isinstance(name, str)
for entry in entries:
assert isinstance(entry.label, str)
if entry.current is not None:
assert entry.current >= 0
if entry.high is not None:
assert entry.high >= 0
if entry.critical is not None:
assert entry.critical >= 0
@pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
def test_sensors_temperatures_fahreneit(self):
d = {'coretemp': [('label', 50.0, 60.0, 70.0)]}
with mock.patch(
"psutil._psplatform.sensors_temperatures", return_value=d
) as m:
temps = psutil.sensors_temperatures(fahrenheit=True)['coretemp'][0]
assert m.called
assert temps.current == 122.0
assert temps.high == 140.0
assert temps.critical == 158.0
@pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_sensors_battery(self):
ret = psutil.sensors_battery()
assert ret.percent >= 0
assert ret.percent <= 100
if ret.secsleft not in (
psutil.POWER_TIME_UNKNOWN,
psutil.POWER_TIME_UNLIMITED,
):
assert ret.secsleft >= 0
else:
if ret.secsleft == psutil.POWER_TIME_UNLIMITED:
assert ret.power_plugged
assert isinstance(ret.power_plugged, bool)
@pytest.mark.skipif(not HAS_SENSORS_FANS, reason="not supported")
def test_sensors_fans(self):
fans = psutil.sensors_fans()
for name, entries in fans.items():
assert isinstance(name, str)
for entry in entries:
assert isinstance(entry.label, str)
assert isinstance(entry.current, (int, long))
assert entry.current >= 0
PK ok\ 3�
� � psutil/tests/test_osx.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""macOS specific tests."""
import platform
import re
import time
import psutil
from psutil import MACOS
from psutil import POSIX
from psutil.tests import HAS_BATTERY
from psutil.tests import TOLERANCE_DISK_USAGE
from psutil.tests import TOLERANCE_SYS_MEM
from psutil.tests import PsutilTestCase
from psutil.tests import pytest
from psutil.tests import retry_on_failure
from psutil.tests import sh
from psutil.tests import spawn_testproc
from psutil.tests import terminate
if POSIX:
from psutil._psutil_posix import getpagesize
def sysctl(cmdline):
"""Expects a sysctl command with an argument and parse the result
returning only the value of interest.
"""
out = sh(cmdline)
result = out.split()[1]
try:
return int(result)
except ValueError:
return result
def vm_stat(field):
"""Wrapper around 'vm_stat' cmdline utility."""
out = sh('vm_stat')
for line in out.split('\n'):
if field in line:
break
else:
raise ValueError("line not found")
return int(re.search(r'\d+', line).group(0)) * getpagesize()
@pytest.mark.skipif(not MACOS, reason="MACOS only")
class TestProcess(PsutilTestCase):
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
def test_process_create_time(self):
output = sh("ps -o lstart -p %s" % self.pid)
start_ps = output.replace('STARTED', '').strip()
hhmmss = start_ps.split(' ')[-2]
year = start_ps.split(' ')[-1]
start_psutil = psutil.Process(self.pid).create_time()
assert hhmmss == time.strftime(
"%H:%M:%S", time.localtime(start_psutil)
)
assert year == time.strftime("%Y", time.localtime(start_psutil))
@pytest.mark.skipif(not MACOS, reason="MACOS only")
class TestSystemAPIs(PsutilTestCase):
# --- disk
@retry_on_failure()
def test_disks(self):
# test psutil.disk_usage() and psutil.disk_partitions()
# against "df -a"
def df(path):
out = sh('df -k "%s"' % path).strip()
lines = out.split('\n')
lines.pop(0)
line = lines.pop(0)
dev, total, used, free = line.split()[:4]
if dev == 'none':
dev = ''
total = int(total) * 1024
used = int(used) * 1024
free = int(free) * 1024
return dev, total, used, free
for part in psutil.disk_partitions(all=False):
usage = psutil.disk_usage(part.mountpoint)
dev, total, used, free = df(part.mountpoint)
assert part.device == dev
assert usage.total == total
assert abs(usage.free - free) < TOLERANCE_DISK_USAGE
assert abs(usage.used - used) < TOLERANCE_DISK_USAGE
# --- cpu
def test_cpu_count_logical(self):
num = sysctl("sysctl hw.logicalcpu")
assert num == psutil.cpu_count(logical=True)
def test_cpu_count_cores(self):
num = sysctl("sysctl hw.physicalcpu")
assert num == psutil.cpu_count(logical=False)
# TODO: remove this once 1892 is fixed
@pytest.mark.skipif(
MACOS and platform.machine() == 'arm64', reason="skipped due to #1892"
)
def test_cpu_freq(self):
freq = psutil.cpu_freq()
assert freq.current * 1000 * 1000 == sysctl("sysctl hw.cpufrequency")
assert freq.min * 1000 * 1000 == sysctl("sysctl hw.cpufrequency_min")
assert freq.max * 1000 * 1000 == sysctl("sysctl hw.cpufrequency_max")
# --- virtual mem
def test_vmem_total(self):
sysctl_hwphymem = sysctl('sysctl hw.memsize')
assert sysctl_hwphymem == psutil.virtual_memory().total
@retry_on_failure()
def test_vmem_free(self):
vmstat_val = vm_stat("free")
psutil_val = psutil.virtual_memory().free
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_active(self):
vmstat_val = vm_stat("active")
psutil_val = psutil.virtual_memory().active
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_inactive(self):
vmstat_val = vm_stat("inactive")
psutil_val = psutil.virtual_memory().inactive
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_vmem_wired(self):
vmstat_val = vm_stat("wired")
psutil_val = psutil.virtual_memory().wired
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
# --- swap mem
@retry_on_failure()
def test_swapmem_sin(self):
vmstat_val = vm_stat("Pageins")
psutil_val = psutil.swap_memory().sin
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_swapmem_sout(self):
vmstat_val = vm_stat("Pageout")
psutil_val = psutil.swap_memory().sout
assert abs(psutil_val - vmstat_val) < TOLERANCE_SYS_MEM
# --- network
def test_net_if_stats(self):
for name, stats in psutil.net_if_stats().items():
try:
out = sh("ifconfig %s" % name)
except RuntimeError:
pass
else:
assert stats.isup == ('RUNNING' in out), out
assert stats.mtu == int(re.findall(r'mtu (\d+)', out)[0])
# --- sensors_battery
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_sensors_battery(self):
out = sh("pmset -g batt")
percent = re.search(r"(\d+)%", out).group(1)
drawing_from = re.search("Now drawing from '([^']+)'", out).group(1)
power_plugged = drawing_from == "AC Power"
psutil_result = psutil.sensors_battery()
assert psutil_result.power_plugged == power_plugged
assert psutil_result.percent == int(percent)
PK ok\
�u5 5 psutil/tests/__main__.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Run unit tests. This is invoked by:
$ python -m psutil.tests.
"""
from psutil.tests import pytest
pytest.main(["-v", "-s", "--tb=short"])
PK ok\��k� � 0 psutil/tests/__pycache__/test_aix.cpython-39.pycnu �[��� a
��?h� � @ sj d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ejj e dd�G d d
� d
e��Z
dS ) zAIX specific tests.� N)�AIX)�PsutilTestCase)�pytest)�shzAIX only)�reasonc @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �AIXSpecificTestCasec C s� t d�}d}d�� D ]}|d|f 7 }qt�||�}|d us@J �d}t|�d��| }t|�d��| }t|�d��| }t|�d ��| } t�� }
d
| | } |
j|ks�J �t |
j
| �| k s�J �t |
j | �| k s�J �t |
j | �| k s�J �d S ) Nz/usr/bin/svmon -O unit=KBz memory\s*z+size inuse free pin virtual available mmode�(?P<%s>\S+)\s+i �size� availableZinuse�free� )
r �split�re�search�int�group�psutilZvirtual_memory�total�abs�usedr
r ) �self�out�
re_pattern�field�matchobjZKBr r
r r �
psutil_resultZTOLERANCE_SYS_MEM� r �A/usr/local/lib64/python3.9/site-packages/psutil/tests/test_aix.py�test_virtual_memory s" z'AIXSpecificTestCase.test_virtual_memoryc C sT t d�}t�d|�}|d us J �t|�d��}d}t�� }t|j| �|ksPJ �d S )Nz/usr/sbin/lsps -az=(?P<space>\S+)\s+(?P<vol>\S+)\s+(?P<vg>\S+)\s+(?P<size>\d+)MBr i )r r r r r r Z swap_memoryr )r r r Ztotal_mbZMBr r r r �test_swap_memory0 s � z$AIXSpecificTestCase.test_swap_memoryc C s� t d�}d}d�� D ]}|d|f 7 }qt�||�}|d us@J �d}t�� }t|jt|� d�� �|k slJ �t|j
t|� d�� �|k s�J �t|j t|� d�� �|k s�J �t|j t|� d �� �|k s�J �d S )
N�/usr/bin/mpstat -azALL\s*zfmin maj mpcs mpcr dev soft dec ph cs ics bound rq push S3pull S3grd S0rd S1rd S2rd S3rd S4rd S5rd syscr i� �csZsysc�devZsoft)
r r
r r r Z cpu_statsr Z ctx_switchesr r ZsyscallsZ
interruptsZsoft_interrupts)r r r r r ZCPU_STATS_TOLERANCEr r r r �test_cpu_statsG s2 �
��������z"AIXSpecificTestCase.test_cpu_statsc C s: t d�}tt�d|��d��}tjdd�}||ks6J �d S )Nr z
lcpu=(\d+)� T)�logical)r r r r r r � cpu_count)r r Z mpstat_lcpuZ psutil_lcpur r r �test_cpu_count_logicali s z*AIXSpecificTestCase.test_cpu_count_logicalc C s4 t d�}t|�� �}tt�� �� �}||ks0J �d S )Nz/etc/ifconfig -l)r �setr
r Z net_if_addrs�keys)r r Zifconfig_namesZ psutil_namesr r r �test_net_if_addrs_nameso s z+AIXSpecificTestCase.test_net_if_addrs_namesN)�__name__�
__module__� __qualname__r r r# r' r* r r r r r s
"r ) �__doc__r r r Z psutil.testsr r r �markZskipifr r r r r �<module> s PK ok\�*ejX jX 6 psutil/tests/__pycache__/test_testutils.cpython-39.pycnu �[��� a
��?h�H � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl m
Z
ddl mZ ddl mZ ddlmZ ddlmZ ddlmZ dd lmZ dd
l mZ dd l mZ dd l mZ dd
l mZ ddl mZ ddl mZ ddl m Z ddl m Z ddl m Z ddl m Z ddl m Z ddl m!Z! ddl m"Z" ddl m#Z# ddl m$Z$ ddl m%Z% ddl m&Z& ddl m'Z' dd l m(Z( dd l m)Z) dd l m*Z* dd l m+Z+ dd l m,Z, dd!l m-Z- dd"l m.Z. dd#l m/Z/ dd$l m0Z0 dd%l m1Z1 dd&l m2Z2 dd'l m3Z3 dd(l m4Z4 G d)d*� d*e �Z5G d+d,� d,e �Z6G d-d.� d.e �Z7G d/d0� d0e �Z8G d1d2� d2e �Z9e)j:j;d3d4�G d5d6� d6e ��Z<G d7d8� d8e �Z=G d9d:� d:e �Z>G d;d<� d<e �Z?dS )=z1Tests for testing utils (psutil.tests namespace).� N)�FREEBSD)�NETBSD)�POSIX)� open_binary)� open_text)�
supports_ipv6)�PY3)�
CI_TESTING)�COVERAGE)�HAS_NET_CONNECTIONS_UNIX)�HERE)�
PYTHON_EXE)�PYTHON_EXE_ENV)�PsutilTestCase)�TestMemoryLeak)� bind_socket)�bind_unix_socket��
call_until)�chdir)�create_sockets)� fake_pytest)�filter_proc_net_connections)�
get_free_port)�
is_namedtuple)�mock)�process_namespace)�pytest)�
reap_children)�retry)�retry_on_failure)�
safe_mkdir)� safe_rmpath)�system_namespace)�tcp_socketpair)� terminate)�unix_socketpair)�
wait_for_file)� wait_for_pidc @ sx e Zd Ze�d�dd� �Ze�d�dd� �Ze�d�dd� �Ze�d�dd � �Ze�d�d
d � �Z e�d�d d
� �Z
dS )�TestRetryDecoratorz
time.sleepc sF t ddd d�� fdd��}ttd��� |� dks4J �|jdksBJ �d S )N� � ��retries�intervalZlogfunc s � r� � � dd q dS �Nr+ r ��pop� ��queuer2 �G/usr/local/lib64/python3.9/site-packages/psutil/tests/test_testutils.py�fooI s
z2TestRetryDecorator.test_retry_success.<locals>.foo� )r �list�range�
call_count��self�sleepr6 r2 r3 r5 �test_retry_successE s
z%TestRetryDecorator.test_retry_successc sh t ddd d�� fdd��}ttd��� t�t�� |� W d � n1 sL0 Y |jdksdJ �d S )Nr* r+ r, c s � r� � � dd q dS r/ r0 r2 r3 r2 r5 r6 W s
z2TestRetryDecorator.test_retry_failure.<locals>.foo� )r r8 r9 r �raises�ZeroDivisionErrorr: r; r2 r3 r5 �test_retry_failureT s $z%TestRetryDecorator.test_retry_failurec C sV t tdd�dd� �}t�t�� |� W d � n1 s:0 Y |jdksRJ �d S )Nr+ )� exceptionr. c S s t �d S �N)� TypeErrorr2 r2 r2 r5 r6 e s z2TestRetryDecorator.test_exception_arg.<locals>.foor )r �
ValueErrorr r@ rE r: r; r2 r2 r5 �test_exception_argc s
$z%TestRetryDecorator.test_exception_argc C sX t dd d d�dd� �}t�t�� |� W d � n1 s<0 Y |jdksTJ �d S )Nr* r, c S s dd d S r/ r2 r2 r2 r2 r5 r6 q s z4TestRetryDecorator.test_no_interval_arg.<locals>.foor �r r r@ rA r: r; r2 r2 r5 �test_no_interval_argm s
$z'TestRetryDecorator.test_no_interval_argc C sX t ddd d�dd� �}t�t�� |� W d � n1 s<0 Y |jdksTJ �d S )Nr* r+ r, c S s dd d S r/ r2 r2 r2 r2 r5 r6 { s z0TestRetryDecorator.test_retries_arg.<locals>.foorH r; r2 r2 r5 �test_retries_argy s
$z#TestRetryDecorator.test_retries_argc C s: t �t�� tddd� W d � n1 s,0 Y d S )Nr* r+ )r- �timeout)r r@ rF r )r< r= r2 r2 r5 � test_retries_and_timeout_args� s z0TestRetryDecorator.test_retries_and_timeout_argsN) �__name__�
__module__� __qualname__r �patchr> rB rG rI rJ rL r2 r2 r2 r5 r) D s
r) c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�TestSyncTestUtilsc C s� t t�� � tt�� �d }tjdtdg�d��D t �
tj �� t |� W d � n1 s\0 Y W d � n1 sz0 Y d S )Ni�� �psutil.tests.retry.__iter__r �Z return_value) r( �os�getpid�max�psutilZpidsr rP �iterr r@ Z
NoSuchProcess)r< Znopidr2 r2 r5 �test_wait_for_pid� s
z#TestSyncTestUtils.test_wait_for_pidc C sX | � � }t|d��}|�d� W d � n1 s20 Y t|� tj�|�rTJ �d S )N�wr6 ��
get_testfn�open�writer' rT �path�exists�r< �testfn�fr2 r2 r5 �test_wait_for_file� s
(z$TestSyncTestUtils.test_wait_for_filec C sR | � � }t|d�� W d � n1 s(0 Y t|dd� tj�|�rNJ �d S )NrZ T)�empty)r\ r] r' rT r_ r` �r< rb r2 r2 r5 �test_wait_for_file_empty� s
z*TestSyncTestUtils.test_wait_for_file_emptyc C sr | � � }tjdtdg�d��B t�t�� t|� W d � n1 sF0 Y W d � n1 sd0 Y d S )NrR r rS )r\ r rP rX r r@ �IOErrorr' rf r2 r2 r5 �test_wait_for_file_no_file� s z,TestSyncTestUtils.test_wait_for_file_no_filec C s\ | � � }t|d��}|�d� W d � n1 s20 Y t|dd� tj�|�sXJ �d S )NrZ r6 F)�deleter[ ra r2 r2 r5 � test_wait_for_file_no_delete� s
( z.TestSyncTestUtils.test_wait_for_file_no_deletec C s t dd� � d S )Nc S s dS �Nr+ r2 r2 r2 r2 r5 �<lambda>� � z3TestSyncTestUtils.test_call_until.<locals>.<lambda>r �r< r2 r2 r5 �test_call_until� s z!TestSyncTestUtils.test_call_untilN) rM rN rO rY rd rg ri rk rp r2 r2 r2 r5 rQ � s rQ c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �TestFSTestUtilsc C s: t t�� }|jdksJ �W d � n1 s,0 Y d S )N�r)r �__file__�mode�r< rc r2 r2 r5 �test_open_text� s
z TestFSTestUtils.test_open_textc C s: t t�� }|jdksJ �W d � n1 s,0 Y d S )N�rb)r rs rt ru r2 r2 r5 �test_open_binary� s
z TestFSTestUtils.test_open_binaryc C s< | � � }t|� tj�|�s J �t|� tj�|�s8J �d S rD )r\ r! rT r_ �isdirrf r2 r2 r5 �test_safe_mkdir� s
z TestFSTestUtils.test_safe_mkdirc C s� | � � }t|d��� t|� tj�|�r.J �t|� t�|� t|� tj�|�rXJ �tj dt
t j d�d��L}t
�t
�� t|� W d � n1 s�0 Y |js�J �W d � n1 s�0 Y d S )NrZ zpsutil.tests.os.stat� )Z side_effect)r\ r] �closer" rT r_ r` �mkdirr rP �OSError�errno�EINVALr r@ �called)r< rb �mr2 r2 r5 �test_safe_rmpath� s
� &z TestFSTestUtils.test_safe_rmpathc C sp | � � }t�� }t�|� t|��* t�� tj�||�ks>J �W d � n1 sR0 Y t�� |kslJ �d S rD )r\ rT �getcwdr} r r_ �join)r< rb �baser2 r2 r5 �
test_chdir� s
8zTestFSTestUtils.test_chdirN)rM rN rO rv rx rz r� r� r2 r2 r2 r5 rq � s
rq c @ s> e Zd Zdd� Zdd� Zejje dd�dd� �Z d d
� Z
d S ) �TestProcessUtilsc C sN | � � }t�|j�}|�� s J �t� |�� r2J �tjjr>J �tjjrJJ �d S rD ) �spawn_testprocrW �Process�pid�
is_runningr �testsZ
_pids_startedZ_subprocesses_started)r< Zsubp�pr2 r2 r5 �test_reap_children� s z#TestProcessUtils.test_reap_childrenc C s� | � � \}}|j|jks J �|�� s(J �|�� s4J �t�� �� }||gksNJ �t�� jdd�}t|�dksnJ �||v szJ �||v s�J �|�� t� � ks�J �|�� |jks�J �t
|� |�� r�J �|�� s�J �t
|� |�� r�J �d S )NT)� recursive� ) Zspawn_children_pairr� r� rW r� �children�len�ppidrT rU r% )r< �childZ
grandchildr� r2 r2 r5 �test_spawn_children_pair� s" z)TestProcessUtils.test_spawn_children_pair�
POSIX only��reasonc C s" | � � \}}|�� tjks J �d S rD )� spawn_zombie�statusrW Z
STATUS_ZOMBIE)r< �_parent�zombier2 r2 r5 �test_spawn_zombie� s z"TestProcessUtils.test_spawn_zombiec C s� | � � }t|� | �|j� t|� t�| � � j�}t|� | �|j� t|� tddg}tj|tj tj t
d�}t|� | �|j� t|� | � � j}t|� | �|j� t|� t r�| � � \}}t|� t|� | �|j� | �|j� d S )Nz-cz3import time; [time.sleep(0.1) for x in range(100)];)�stdout�stderr�env)
r� r% Z
assertPidGoner� rW r� r
�Popen�
subprocess�PIPEr r r� )r< r� �cmdr� �parentr� r2 r2 r5 �test_terminate s> ��
z TestProcessUtils.test_terminateN) rM rN rO r� r� r �mark�skipifr r� r� r2 r2 r2 r5 r� � s
r� c @ sl e Zd Zdd� Zejje dd�dd� �Zdd� Z ejje dd�ejje
pNe d d�d
d � ��Z d d
� Z
dS )� TestNetUtilsc C sR t � }t�td|fd���$}|�� d |ks0J �W d � n1 sD0 Y d S )Nr{ ��addrr+ )r �
contextlib�closingr � getsockname)r< �port�sr2 r2 r5 r + s zTestNetUtils.bind_socketr� r� c C s� | � � }t|�}t�|��f |jtjks,J �|jtjks<J �|� � |ksLJ �t
j � |�s\J �t
�t
�
|�j�srJ �W d � n1 s�0 Y | � � }t|tjd�}t�|�� |jtjks�J �W d � n1 s�0 Y d S )N)�type)r\ r r� r� �family�socket�AF_UNIXr� � SOCK_STREAMr� rT r_ r` �stat�S_ISSOCK�st_mode�
SOCK_DGRAM)r< �name�sockr2 r2 r5 �test_bind_unix_socket0 s 4 z"TestNetUtils.test_bind_unix_socketc C s� dt � f}ttj|d�\}}t�|��j t�|��@ |�� |ksDJ �|�� |ksTJ �|�� |ksdJ �W d � n1 sx0 Y W d � n1 s�0 Y d S )Nz 127.0.0.1r� )r r$ r� �AF_INETr� r� r� � getpeername)r< r� �server�clientr2 r2 r5 �tcp_tcp_socketpair@ s
z TestNetUtils.tcp_tcp_socketpairz*/var/run/log UNIX socket opened by defaultc C s� t �� }|�� }t|jdd��g ks(J �| �� }t|�\}}z�tj� |�sNJ �t
� t�
|�j �sdJ �|�� | dksxJ �t
t|jdd���dks�J �|�� |ks�J �|�� |ks�J �W |�� |�� n|�� |�� 0 d S )N�unix)�kindr� )rW r� �num_fdsr Znet_connectionsr\ r& rT r_ r` r� r� r� r� r� r� r| )r< r� r� r� r� r� r2 r2 r5 �test_unix_socketpairK s, � ���
�z!TestNetUtils.test_unix_socketpairc C s� t � ��}t�t�}t�t�}|D ]2}||j d7 < ||�tjtj� d7 < q |tj dksfJ �t
� r~|tj dks~J �t r�t
r�|tj dks�J �|tj dks�J �|tj dks�J �W d � n1 s�0 Y d S )Nr+ r� )r � collections� defaultdict�intr� �
getsockoptr� �
SOL_SOCKET�SO_TYPEr� r �AF_INET6r r r� r� r� )r< �socksZfams�typesr� r2 r2 r5 �test_create_socketsg s
z TestNetUtils.test_create_socketsN)rM rN rO r r r� r� r r� r� r r r� r� r2 r2 r2 r5 r� * s
� r� �serial�r� c @ sh e Zd Ze� dd� �Zdd� Ze� ejje dd�ejje
dd�dd � ���Z d
d � Z d d
� Z
dd� ZdS )�TestMemLeakClassc s8 � fdd�}ddi� | j |ddd� � d dks4J �d S ) Nc s � d d7 < d S )N�cntr+ r2 r2 �r� r2 r5 �fun| s z(TestMemLeakClass.test_times.<locals>.funr� r �
� )�times� warmup_times� )�execute)r< r� r2 r� r5 �
test_timesz s zTestMemLeakClass.test_timesc C s2 t �t��" | jdd� dd� W d � n1 s20 Y t �t��" | jdd� dd� W d � n1 sn0 Y t �t��" | jdd� dd� W d � n1 s�0 Y t �t��" | jd d� dd
� W d � n1 s�0 Y t �t��" | jd d� dd � W d � n1 �s$0 Y d S )
Nc S s dS �Nr r2 r2 r2 r2 r5 rm � rn z1TestMemLeakClass.test_param_err.<locals>.<lambda>r �r� c S s dS r� r2 r2 r2 r2 r5 rm � rn ���c S s dS r� r2 r2 r2 r2 r5 rm � rn )r� c S s dS r� r2 r2 r2 r2 r5 rm � rn )� tolerancec S s dS r� r2 r2 r2 r2 r5 rm � rn )r- )r r@ rF r� ro r2 r2 r5 �test_param_err� s 0 0 0 0 z TestMemLeakClass.test_param_errz
skipped on CIr� z skipped during test coveragec C s\ g }|fdd�}zBt jtdd�� | j|dd� W d � n1 sD0 Y W ~n~0 d S )Nc S s | � dd � d S )NZ�xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx� ��append��lsr2 r2 r5 r� � s z+TestMemLeakClass.test_leak_mem.<locals>.funz extra-mem��match�d r� )r r@ �AssertionErrorr� )r< r� r� r2 r2 r5 �
test_leak_mem� s .z TestMemLeakClass.test_leak_memc s^ � �fdd�}g � t rdnd}tjtd| d�� ��|� W d � n1 sP0 Y d S )Nc s" t t�} ��| j� � �| � d S rD )r] rs Z
addCleanupr| r� )rc �Zboxr< r2 r5 r� � s z1TestMemLeakClass.test_unclosed_files.<locals>.fun�fd�handlez unclosed r� )r r r@ r� r� )r< r� r� r2 r� r5 �test_unclosed_files� s
z$TestMemLeakClass.test_unclosed_filesc s> � fdd�}g � d}| j ||ddd� t� �|d ks:J �d S )Nc s � � dd � d S )NZxxxxxxxxxxxxxxxxxxxxxxxxr� r� r2 r� r2 r5 r� � s z,TestMemLeakClass.test_tolerance.<locals>.funr� r i � )r� r� r� r+ )r� r� )r< r� r� r2 r� r5 �test_tolerance� s �z TestMemLeakClass.test_tolerancec C s� dd� }| � t|� t�t�� | � t|� W d � n1 s@0 Y dd� }t�t�� | � t|� W d � n1 s~0 Y d S )Nc S s dd d S r/ r2 r2 r2 r2 r5 �fun_1� s z2TestMemLeakClass.test_execute_w_exc.<locals>.fun_1c S s d S rD r2 r2 r2 r2 r5 �fun_2� s z2TestMemLeakClass.test_execute_w_exc.<locals>.fun_2)Z
execute_w_excrA r r@ r~ r� )r< r� r� r2 r2 r5 �test_execute_w_exc� s * z#TestMemLeakClass.test_execute_w_excN)rM rN rO r r� r� r r� r� r r
r� r� r� r� r2 r2 r2 r5 r� x s
r� c @ sV e Zd Zdd� Zdd� Zdd� Zdd� Zejj e
d d
�d d � �Z d
d� Z dd� Z
dS )�TestFakePytestc C s( t �� }|�|� t �� }|�|�}|S rD )�unittestZ TestSuiteZaddTestZTextTestRunner�run)r< �klass�suite�runner�resultr2 r2 r5 �run_test_class� s
z TestFakePytest.run_test_classc
C s� t �t��}dd W d � n1 s(0 Y t|jt�sBJ �t jtdd��}td��W d � n1 sn0 Y z:t jtdd��}td��W d � n1 s�0 Y W n4 ty� } z t|�dks�J �W Y d }~nd }~0 0 | �d��d S )Nr+ r r6 r� �barz"foo" does not match "bar"�exception not raised) r r@ rA �
isinstance�valuerF r� �str�fail)r< �cm�errr2 r2 r5 � test_raises� s &&*&zTestFakePytest.test_raisesc C sV t jjdd�dd� �}|� dks$J �t jjdd�G dd� d��}|� �� dksRJ �d S )Nr� r� c S s dS rl r2 r2 r2 r2 r5 r6 � s z%TestFakePytest.test_mark.<locals>.foor+ c @ s e Zd Zdd� ZdS )z%TestFakePytest.test_mark.<locals>.Fooc S s dS rl r2 ro r2 r2 r5 r� � s z)TestFakePytest.test_mark.<locals>.Foo.barN)rM rN rO r� r2 r2 r2 r5 �Foo� s r )r r� � xdist_groupr� )r< r6 r r2 r2 r5 � test_mark� s
zTestFakePytest.test_markc C s� G dd� dt j�}| �|d��}|�� s,J �t|j�dks>J �|jd d dksTJ �G dd� dt j�}| �|d��}|�� s�J �t|j�dks�J �d S )Nc @ s$ e Zd Zejjddd�dd� �ZdS )�,TestFakePytest.test_skipif.<locals>.TestCaseTr� r� c S s ddks J �d S rl r2 ro r2 r2 r5 r6 � s �0TestFakePytest.test_skipif.<locals>.TestCase.fooN�rM rN rO r r� r� r6 r2 r2 r2 r5 �TestCase� s r r6 r+ r r� c @ s$ e Zd Zejjddd�dd� �ZdS )r Fr� r� c S s ddks J �d S rl r2 ro r2 r2 r5 r6 � s r
Nr r2 r2 r2 r5 r � s �r� r r� Z
wasSuccessfulr� �skipped�r< r r� r2 r2 r5 � test_skipif� s zTestFakePytest.test_skipifznot PY3r� c C sX G dd� dt j�}| �|d��}|�� s,J �t|j�dks>J �|jd d dksTJ �d S )Nc @ s e Zd Zdd� ZdS )z*TestFakePytest.test_skip.<locals>.TestCasec S s t �d� ddksJ �d S )Nr� r+ r )r �skipro r2 r2 r5 r6 s
z.TestFakePytest.test_skip.<locals>.TestCase.fooN)rM rN rO r6 r2 r2 r2 r5 r s r r6 r+ r r� r
r r2 r2 r5 � test_skip� s
zTestFakePytest.test_skipc C s | j td�}t�|� ttj�|d�d�� W d � n1 s@0 Y ttj�|d�d��$}|�t� d��
� � W d � n1 s�0 Y t j �
tjd|��T | �td��( t�� }|�� dks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S ) N)�dirz __init__.pyrZ z test_file.pyz� import unittest
class TestCase(unittest.TestCase):
def test_passed(self):
pass
r zFake pytest module was usedr+ )r\ r rT r} r] r_ r� r^ �textwrap�dedent�lstripr rP �objectrW r� ZassertWarnsRegex� UserWarningr �mainZcountTestCases)r< Ztmpdirrc r� r2 r2 r5 � test_main
s
2�zTestFakePytest.test_mainc C s< t �t�� tjdtdd� W d � n1 s00 Y z>t �t�� tjdtdd� W d � n1 sl0 Y W n ty� Y n 0 | �d��t jtdd�� tjdtdd� W d � n1 s�0 Y zDt jtdd�� tjdtdd� W d � n1 �s 0 Y W n t�y, Y n 0 | �d��d S )Nr6 r+ )�
stacklevelr� r� r� )r Zwarnsr �warnings�warn�DeprecationWarningr� r ro r2 r2 r5 �
test_warns s . 2
.4zTestFakePytest.test_warnsN)rM rN rO r� r r r r r� r� r r r r r2 r2 r2 r5 r� � s
r� c @ s e Zd Zdd� Zdd� ZdS )�TestTestingUtilsc C sL t �� }t|�}|�� dd� |�|j�D �d d }|� |�� ksHJ �d S )Nc S s g | ]}|d dkr|�qS )r+ r� r2 ��.0�xr2 r2 r5 �
<listcomp>? rn z;TestTestingUtils.test_process_namespace.<locals>.<listcomp>r )rW r� r �testrX �gettersr� )r< r� �nsr� r2 r2 r5 �test_process_namespace; s
z'TestTestingUtils.test_process_namespacec C s: t � }dd� |�|j�D �d d }|� t�� ks6J �d S )Nc S s g | ]}|d dkr|�qS )r+ � net_if_addrsr2 r! r2 r2 r5 r$ D rn z:TestTestingUtils.test_system_namespace.<locals>.<listcomp>r )r# rX r& rW r) )r< r' r� r2 r2 r5 �test_system_namespaceB s z&TestTestingUtils.test_system_namespaceN)rM rN rO r( r* r2 r2 r2 r5 r : s r c @ s e Zd Zdd� ZdS )�TestOtherUtilsc C s. t t�dd�ddd��s J �t t� �r*J �d S )Nr6 za b cr+ r� r7 )r r� �
namedtuple�tuplero r2 r2 r5 �test_is_namedtupleI s z!TestOtherUtils.test_is_namedtupleN)rM rN rO r. r2 r2 r2 r5 r+ H s r+ )@�__doc__r� r� r rT r� r� r� r r� r rW Z psutil.testsr r r Zpsutil._commonr r r Zpsutil._compatr r r
r r r
r r r r r r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) rQ rq r� r� r� r r� r� r r+ r2 r2 r2 r5 �<module> sx E(-LN KvPK ok\���Sh� h� 0 psutil/tests/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s: d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZ ddlm Z ddlm Z z ddl Z W n e �y dZ Y n0 ddl Z ddl m!Z! ddl m"Z" dd l m#Z# dd
l m$Z$ dd l m%Z% dd l m&Z& dd
l m'Z' ddl m(Z( ddl)m*Z* ddl)m+Z+ ddl)m,Z, ddl)m-Z- ddl)m.Z. ddl/m0Z0 ddl/m1Z1 ddl/m2Z2 ddl/m3Z3 ddl/m4Z4 ddl/m5Z5 ddl/m6Z6 zddlm7Z7 W nP e �yr e�8� �" e�9d � ddl7Z7W d � n1 �sd0 Y Y n0 e0�r�ddl:Z:n ddl;ZdZ:e&�r�dd l<m=Z= g d �Z>d ej?v Z@d e jAv ZBd!e jAv �p�d"e jAv ZCeB�p�eCZDd#e jAv ZEd$e jAv ZFe"�r6eC�r6eGd%�� ZHd&eH�I� v ZJW d � n1 �s*0 Y nd'ZJejKd(kZLe
�M� d)kZNe,d*d+� �ZOe#�rxeO� d,kZPeO� d-kZQnd'ZPd'ZQd.ZRd/ZSd0ZTd1ZUeD�r�eRd29 ZReUd29 ZUeSd39 ZSeTd29 ZTe jVd4k�r�d5e �W� ZXn d6e �W� ZXd7ZYe0�r�d8�Zd9d:�Z[nd;Z[e�\� �]� d<v Z^e j_�`e j_�ae j_�bec�d=d=��Zde jA�ed>e j_�aedd?��Zfe j_�`e j_�bec��Zgehe jid@�Zjehe dA�Zkehe jidB�Zlehe dC�Zmehe jidD�Znehe jidE�Zoe&�o�e' Zpehe dF�Zqehe jidG�Zrehe jidH�Zsehe jidI�Ztehe dJ�Zuzeu�o�eve �w� �ZxW n ey�y
d'ZxY n0 ehe dK�Zzehe dL�Z{ehe jidM�Z|e#�s8e!�oBe �}� dkZ~dNdO� Ze� \Z�Z�eGe j�dP�Z�e��e�j�� dQdR� e�e �D �Z�e�edSe�� �Z�e�� Z�e�� Z�G dTdU� dUej��Z�dVdW� Z�e�d�dXdY��Z�e�dZd[� �Z�d\d]� Z�e�d^d_� �Z�e�d`da� �Z�ej�eUfdbdc�Z�d�ddde�Z�dfdg� Z�dhdi� Z�G djdk� dk�Z�e�e j�deUdldm�dndo� �Z�e�e2e�fdeUdldm�d�dqdr��Z�e�e�deUdldm�dsdt� �Z�dudv� Z�dwdx� Z�ej�dydz� �Z�d{d|� Z�d�d}d~�Z�d�d�d��Z�G d�d�� d��Z�e du �r�e�Z G d�d�� d�ej��Z�e�e_�G d�d�� d�e��Z�e j�j�e@d�d��G d�d�� d�e���Z�d�d�� Z�d�d�� Z�d�d�� Z�G d�d�� d��Z�G d�d�� d��Z�eRfd�d��Z�d�d�d��Z�d�d�d��Z�d�d�d��Z�ee dfd�d��Z�ej fd�d��Z�d�d�d��Z�d�d�� Z�ej�d�d�� �Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�e&�r ej�d�d�d���Z�nej�d�d�d���Z�ej�d�d�� �Z�e&�r6e�ej�d�d�� � dS )�zTest utilities.� )�print_functionN)�AF_INET)�AF_INET6)� SOCK_STREAM)�AIX)�LINUX)�MACOS)�NETBSD)�OPENBSD)�POSIX)�SUNOS)�WINDOWS)� bytes2human)�debug)�memoize)� print_color)�
supports_ipv6)�PY3)�FileExistsError)�FileNotFoundError)�range)�super)�unicode)�which)�mock�ignore)�wait_pid)M�APPVEYOR�DEVNULL�GLOBAL_TIMEOUT�TOLERANCE_SYS_MEM�
NO_RETRIES�PYPY�
PYTHON_EXE�PYTHON_EXE_ENV�ROOT_DIR� SCRIPTS_DIR�
TESTFN_PREFIX�UNICODE_SUFFIX�INVALID_UNICODE_SUFFIX�
CI_TESTING�VALID_PROC_STATUSES�TOLERANCE_DISK_USAGE�IS_64BIT�HAS_CPU_AFFINITY� HAS_CPU_FREQ� HAS_ENVIRON�HAS_PROC_IO_COUNTERS�
HAS_IONICE�HAS_MEMORY_MAPS�HAS_PROC_CPU_NUM�
HAS_RLIMIT�HAS_SENSORS_BATTERY� HAS_BATTERY�HAS_SENSORS_FANS�HAS_SENSORS_TEMPERATURES�HAS_NET_CONNECTIONS_UNIX� MACOS_11PLUS� MACOS_12PLUS�COVERAGE�AARCH64� QEMU_USER�PYTEST_PARALLEL�pyrun� terminate�
reap_children�spawn_testproc� spawn_zombie�spawn_children_pair�
ThreadTask�unittest�skip_on_access_denied�skip_on_not_implemented�retry_on_failure�TestMemoryLeak�PsutilTestCase�process_namespace�system_namespace�
print_sysinfo�is_win_secure_system_proc� fake_pytest�chdir� safe_rmpath�
create_py_exe� create_c_exe�
get_testfn�
get_winver�kernel_version�
call_until� wait_for_pid�
wait_for_file�check_net_address�filter_proc_net_connections�
get_free_port� bind_socket�bind_unix_socket�tcp_socketpair�unix_socketpair�create_sockets�
reload_module�import_module_by_path�warn�copyload_shared_lib�
is_namedtupleZ__pypy__r �GITHUB_ACTIONSZ CIBUILDWHEELZ COVERAGE_RUNZPYTEST_XDIST_WORKERz/proc/1/cmdlinez
/bin/qemu-Fl �aarch64c C sn t �� d } ttt| �d�d d� ��}|dkrjtjtj dddgdd id
d �} ttt| �d�d d� ��}|S ) Nr �.� )�
� z-sS�-cz-import platform; print(platform.mac_ver()[0])ZSYSTEM_VERSION_COMPAT�0T)�env�universal_newlines)
�platform�mac_ver�tuple�map�int�split�
subprocess� check_output�sys�
executable)� version_str�version� r� �A/usr/local/lib64/python3.9/site-packages/psutil/tests/__init__.py�
macos_version� s ��
r� )rn � )� r rn i P i � � � � �javaz $psutil-%s-z @psutil-%s-u -ƒőős f���utf8�surrogateescapeu fÀ)�asciizus-asciiz..ZPSUTIL_SCRIPTS_DIR�scripts� cpu_affinity�cpu_freq�environ�
getloadavg�ionice� memory_maps�net_io_counters�cpu_num� io_counters�rlimit�sensors_battery� sensors_fans�sensors_temperatures�threadsc C s� dd� } t j�� }ttdd �}trFtjdkrF|d urFtj|d< ||fS trTtj|fS t r�| tj�p�| t j
� tj��p�| t dtjd d� ��p�| t
�� �� �}|s�td��||fS t j
� tj�}t j
�|�s�J |��||fS d S ) Nc S s< z t j| dgt jt jd� W n t jy2 Y d S 0 | S d S )Nz-V)�stdout�stderr)rz �
check_call�PIPE�CalledProcessError)�exer� r� r� �attempt� s �
z _get_py_exe.<locals>.attempt�_base_executable)r� � �__PYVENV_LAUNCHER__z python%s.%srm z"can't find python exe real abspath)�osr� �copy�getattrr| r
� version_infor} rj r �path�realpathr �psutil�Processr� �
ValueError�exists)r� rr �baser� r� r� r� � _get_py_exe� s,
���r� zr+c C s g | ]}|� d �rtt|��qS )ZSTATUS_��
startswithr� r� ��.0�xr� r� r� �
<listcomp>$ s r� �AF_UNIXc sP e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
� Z S )rG z6A thread task which does nothing expect staying alive.c s$ t � �� d| _d| _t�� | _d S )NF���MbP?)r �__init__�_running� _interval� threading�Event�_flag��self�� __class__r� r� r� 5 s
zThreadTask.__init__c C s | j j}d|| jt| �f S )Nz<%s running=%s at %#x>)r� �__name__r� �id�r� �namer� r� r� �__repr__; s zThreadTask.__repr__c C s | � � | S �N)�startr� r� r� r� � __enter__? s zThreadTask.__enter__c O s | � � d S r� )�stop)r� �args�kwargsr� r� r� �__exit__C s zThreadTask.__exit__c C s( | j rtd��tj�| � | j�� dS )zStart thread and keep it running until an explicit
stop() request. Polls for shutdown every 'timeout' seconds.
zalready startedN)r� r� r� �Threadr� r� �waitr� r� r� r� r� F s zThreadTask.startc C s( d| _ | j�� | j r$t�| j� qd S )NT)r� r� �set�time�sleepr� r� r� r� r� �runO s
zThreadTask.runc C s | j std��d| _ | �� dS )z8Stop thread execution and and waits until it is stopped.zalready stoppedFN)r� r� �joinr� r� r� r� r� U s zThreadTask.stop) r� �
__module__� __qualname__�__doc__r� r� r� r� r� r� r� �
__classcell__r� r� r� r� rG 2 s rG c s t �� �� fdd��}|S )Nc s0 z� | i |��W S t y* t� � Y n0 d S r� )� ExceptionrC �r� r� ��funr� r� �wrapperc s
z&_reap_children_on_err.<locals>.wrapper�� functools�wraps�r� r� r� r� r� �_reap_children_on_errb s r� c K s� |� dt� |� dt� |� dt�� � |� dt� trHd}|� d|� | du r�tt�� d�}zXt|� d d
| d }td |g} t j
| fi |��}t � |� t
|d
d
d� W t|� q�t|� 0 n&t j
| fi |��}t � |� t|j� |S )a Create a python subprocess which does nothing for some secs and
return it as a subprocess.Popen instance.
If "cmd" is specified that is used instead of python.
By default stdin and stdout are redirected to /dev/null.
It also attempts to make sure the process is in a reasonably
initialized state.
The process is registered for cleanup on reap_children().
�stdinr� �cwdrr � �
creationflagsN��dirz import time;zopen(r'%s', 'w').close();z&[time.sleep(0.1) for x in range(100)];rp T��delete�empty)�
setdefaultr r� �getcwdr$ r
rW rT r# rz �Popen�_subprocesses_started�addr\ r[ �pid)�cmd�kwdsZCREATE_NO_WINDOW�testfnZpyline�sprocr� r� r� rD n s4
���
rD c C s� d} t t�� d�}z�t�dtj�|�tf �}trDt |dd�\}} n t |�\}} t
� |j �}t
t|ddd��}t�|� t
� |�}||fW t|� | dur�t| � S nt|� | dur�t| � 0 dS ) a Create a subprocess which creates another one as in:
A (us) -> B (child) -> C (grandchild).
Return a (child, grandchild) tuple.
The 2 processes are fully initialized and will live for 60 secs
and are registered for cleanup on reap_children().
Nr� aV import subprocess, os, sys, time
s = "import os, time;"
s += "f = open('%s', 'w');"
s += "f.write(str(os.getpid()));"
s += "f.close();"
s += "[time.sleep(0.1) for x in range(100 * 6)];"
p = subprocess.Popen([r'%s', '-c', s])
p.wait()
r )r� TFr� )rW r� r� �textwrap�dedentr� �basenamer# r
rA r� r� r� rx r\ �
_pids_startedr� rT )�tfiler� �s�subp�childZgrandchild_pidZ
grandchildr� r� r� rF � s0 �
� �rF c s$ t js
J �t� } t�d| �}d}t| �}z�|�t� t|�\}}|� � \}}z|t
�
|� � gg g t� t |�
d��}t�|� t �|�� t� fdd�� |� fW |�� W |�� t| � |dur�t|� S |�� 0 W |�� t| � |du�r t|� n$|�� t| � |du�r t|� 0 dS )z�Create a zombie process and return a (parent, zombie) process tuple.
In order to kill the zombie parent must be terminate()d first, then
zombie must be wait()ed on.
a import os, sys, time, socket, contextlib
child_pid = os.fork()
if child_pid > 0:
time.sleep(3000)
else:
# this is the zombie process
s = socket.socket(socket.AF_UNIX)
with contextlib.closing(s):
s.connect('%s')
if sys.version_info < (3, ):
pid = str(os.getpid())
else:
pid = bytes(str(os.getpid()), 'ascii')
s.sendall(pid)
N� c s � � � tjkS r� )�statusr� �
STATUS_ZOMBIEr� ��zombier� r� �<lambda>� � z spawn_zombie.<locals>.<lambda>)r� r rW r� r� ra �
settimeoutr rA �accept�select�filenorx �recvr� r� r� rZ �closerT )Z unix_file�srcr� �sock�parent�conn�_Zzpidr� r r� rE � sD
�
��
�
rE c K s� |� dd� |� dd� t� }z^t|d��}|�| � W d � n1 sJ0 Y tt|jgfi |��}t|j� ||fW S t y� t
|� � Y n0 dS )z�Run python 'src' code string in a separate interpreter.
Returns a subprocess.Popen instance and the test file where the source
code was written.
r� Nr� �w) r� rW �open�writerD r# r� r[ r� r� rT )r r� �srcfile�fr� r� r� r� rA � s (
rA c K s� t rdnd}|�dtj� |�dtj� |�dd� |�d|� t| t�rTt�| �} tj| fi |��}t �
|� t r�|j t
d�\}}n |� � \}}|jdkr�t|| ��|r�t|� |�d �r�|d
d � }|S ) zURun cmd in a subprocess and return its output.
raises RuntimeError on error.
r� r r� r� rs Tr� ��timeout�
N���)r
r� rz r� �
isinstance�str�shlexry r� r� r� r � communicater �
returncode� RuntimeErrorrg �endswith)r� r� �flags�pr� r� r� r� r� �sh s&
r# c
s dd� �dd� � � ��fdd�}� ��fdd���fd d
�}d d � }| }�znt |t�r�|||�W t |tjtjf�rz||� t |t�r�|n|j}t�|�r�J |��S t |tjtjf��r�||�W t |tjtjf�r�||� t |t�r�|n|j}t�|��rJ |��S t |tj��rd|||�W t |tjtjf��r8||� t |t��rH|n|j}t�|��rbJ |��S td
| ��W t |tjtjf��r�||� t |t��r�|n|j}t�|��rJ |��nHt |tjtjf��r�||� t |t��r�|n|j}t�|��r J |��0 dS )a� Terminate a process and wait() for it.
Process can be a PID or an instance of psutil.Process(),
subprocess.Popen() or psutil.Popen().
If it's a subprocess.Popen() or psutil.Popen() instance also closes
its stdin / stdout / stderr fds.
PID is wait()ed even if the process is already gone (kills zombies).
Does nothing if the process does not exist.
Return process exit status.
c S sb t | tj�rts| �� n
| �|� tr^t | tj�r^zt�| j��|�W S tj y\ Y n0 d S r� )
r rz r� r r� r
r� r� r� �
NoSuchProcess��procr r� r� r� r� ' s
zterminate.<locals>.waitc S s6 t rtrtj}tr(|tjkr(| �tj� | �|� d S r� )r rj �signal�SIGKILLr � send_signal�SIGCONT)r& �sigr� r� r� �sendsig3 s
zterminate.<locals>.sendsigc
s\ z� | �� W nB t yP } z*tr.|jdkr.n|jtjkr<� W Y d }~n
d }~0 0 �| |�S )N� )�OSErrorr
�winerror�errnoZESRCH)r& r �err�r, r+ r� r� r� �term_subprocess_proc= s z'terminate.<locals>.term_subprocess_procc s. z� | �� W n t jy" Y n0 �| |�S r� )r� r$ r% r2 r� r� �term_psutil_procG s
z#terminate.<locals>.term_psutil_procc sD zt �| �}W n& t jy4 tr0t| |� Y S Y n 0 � ||�S d S r� )r� r� r$ r r )r� r r& )r4 r� r� �term_pidN s zterminate.<locals>.term_pidc S s4 | j r| j �� | jr | j�� | jr0| j�� d S r� )r� r r� r� )r& r� r� r� � flush_popenX s
z terminate.<locals>.flush_popenz
wrong type %rN) r rx rz r� r� r� �
pid_existsr� � TypeError)Z proc_or_pidr+ � wait_timeoutr3 r5 r6 r" r� r� )r, r+ r4 r� r� rB sL
�
�
��rB c C s� t �� j| d�}tr&t�� }t|� qtr<t�� }t|� q&|r�|D ]}t|dd� qDt j|td�\}}|D ] }t d| � t|t
j d� qldS )a Terminate and wait() any subprocess started by this test suite
and any children currently running, ensuring that no processes stick
around to hog resources.
If recursive is True it also tries to terminate and wait()
all grandchildren started by this process.
�� recursiveN)r9 r z0couldn't terminate process %r; attempting kill())r+ ) r� r� �childrenr� �poprB r� �
wait_procsr rg r' r( )r; r< r� r� r" r �aliver� r� r� rC r s
rC c C s� t s td��d} t�� d }|D ]"}|�� s4|dkr>| |7 } q qDq | sTtd| ��d}d}| �d�}t|d �}t|�dkr�t|d �}t|�dkr�t|d �}|||fS ) z"Return a tuple such as (2, 6, 36).z not POSIX� rm rl zcan't parse %rr � r� ) r �NotImplementedErrorr� �uname�isdigitr� ry rx �len)r� rC �c�minor�micro�nums�majorr� r� r� rY � s&
rY c C sb t s td��t�� } t| d�r*| jp&d}n&t�d| d �}|rLt|� d��nd}| d | d |fS )Nz not WINDOWS�service_pack_majorr z\s\d$r� rA )
r
rB r| �getwindowsversion�hasattrrK �re�searchrx �group)Zwv�sp�rr� r� r� rX � s
rX c @ s< e Zd ZdZeddddfdd�Zdd� Zdd � Zd
d � ZdS ) �retryzA retry decorator.Nr� c C s2 |r|rt d��|| _|| _|| _|| _|| _d S )Nz/timeout and retries args are mutually exclusive)r� � exceptionr �retries�interval�logfun)r� rT r rU rV rW r� r� r� r� � s zretry.__init__c c sT | j r*t�� | j }t�� |k rPd V qn&| jrHt| j�D ]
}d V q:nd V qHd S r� )r r� rU r )r� �stop_atr r� r� r� �__iter__� s
zretry.__iter__c C s | j d urt�| j � d S r� )rV r� r� r� r� r� r� r� � s
z retry.sleepc s" t �� �� �fdd��}�|_|S )Nc s� d }�D ]l}z� | i |��W S �j yr } z8|}�jd urJ��|� ��� W Y d }~qW Y d }~qd }~0 0 qtr�|�n� d S r� )rT rW r� r )r� r� �excr �r� r� r� r� r� � s
$z retry.__call__.<locals>.wrapper)r� r� � decorator)r� r� r� r� r[ r� �__call__� s zretry.__call__) r� r� r� r� r� r� rY r� r] r� r� r� r� rS � s �
rS r� )rT rW r rV c C s$ | t �� vrt �| ��t �| � dS )z�Wait for pid to show up in the process list then return.
Used in the test suite to give time the sub process to initialize.
N)r� �pidsr$ r� �r� r� r� r� r[ � s
r[ Tc C sN t | d��}|�� }W d � n1 s(0 Y |s>|s>J �|rJt| � |S )z8Wait for a file to be written on disk with some content.�rbN)r �readrT )�fnamer� r� r �datar� r� r� r\
s &r\ c C s | � }|sJ �|S )z1Keep calling function until it evaluates to True.r� )r� �retr� r� r� rZ s rZ c C sl dd� }zLt �| �}t�|j�r0t�tj| �}nt�t j| �}t rJ|� n||� W n t
yf Y n0 dS )z?Convenience function for removing temporary test files or dirs.c
S s~ t � � t }t � � |k rvz| � W S ty2 Y n8 tyh } z |}tdt|� � W Y d }~n
d }~0 0 t �d� q |�d S )Nz ignoring %sg{�G�z�?)r� r r Z WindowsErrorrg r r� )r� rX r r1 r� r� r� � retry_fun0 s & z safe_rmpath.<locals>.retry_funN) r� �stat�S_ISDIR�st_moder� �partial�shutil�rmtree�remover r )r� re �str� r� r� r� rT - s
rT c C s& zt �| � W n ty Y n0 dS )z.Convenience function for creating a directory.N)r� �mkdirr r� r� r� r� �
safe_mkdirO s ro c c s8 t �� }z t �| � dV W t �|� n t �|� 0 dS )z@Context manager which temporarily changes the current directory.N)r� r� rS )�dirname�curdirr� r� r� rS W s
rS c C sR t j�| �rJ | ��t�t| � t�t| � t rNt �
| �}t � | |j t
j
B � | S )z6Create a Python executable file in the given location.)r� r� r� �atexit�registerrT rj �copyfiler# r rf �chmodrh �S_IEXEC)r� rm r� r� r� rU b s
rU c C s� t j�| �rJ | ��td�s&t�d��|du r:t�d�}nt|t �sLJ |��t
� t | � t
tdd�d��}|�|� W d � n1 s�0 Y z"t�d|jd| g� W t |j� n t |j� 0 | S ) z5Create a compiled C executable in the given location.�gcczgcc is not installedNz�
#include <unistd.h>
int main() {
pause();
return 1;
}
z.c��suffixr z-o)r� r� r� r �pytest�skipr� r� r r rr rs rT r rW r rz r� r� )r� Zc_coder r� r� r� rV m s
(rV r@ c C s> t jt| |d�}tj�|�s tj�|�}t�t |� |S q dS )z�Return an absolute pathname of a file or dir that did not
exist at the time this call is made. Also schedule it for safe
deletion at interpreter exit. It's technically racy but probably
not really due to the time variant.
)�prefixry r� N)
�tempfile�mktempr' r� r� r� r� rr rs rT )ry r� r� r� r� r� r� rW � s
rW c @ sT e Zd ZdZedd� �Zeddd��Zeddd��Zedd
d ��ZG d d
� d
�Z dS )rR z�A class that mimics some basic pytest APIs. This is meant for
when unit tests are run in production, where pytest may not be
installed. Still, the user can test psutil installation via:
$ python3 -m psutil.tests
c O s4 t �� �t�}t jdd��|� tjdtdd� |S )z�Mimics pytest.main(). It has the same effect as running
`python3 -m unittest -v` from the project root directory.
rm )� verbosityz<Fake pytest module was used. Test results may be inaccurate.rA ��
stacklevel) rH Z
TestLoaderZdiscover�HEREZTextTestRunnerr� �warningsrg � UserWarning)r� �kwZsuiter� r� r� �main� s �zfake_pytest.mainNc s. G dd� d�� t jd� fdd� �}|| |d�S )zMimics `pytest.raises`.c @ s e Zd ZdZedd� �ZdS )z)fake_pytest.raises.<locals>.ExceptionInfoNc S s | j S r� )�_excr� r� r� r� �value� s z/fake_pytest.raises.<locals>.ExceptionInfo.value)r� r� r� r� �propertyr� r� r� r� r� �
ExceptionInfo� s r� Nc
3 sx � � }z
|V W nV | yf } z>|rLt �|t|��sLd�|t|��}t|��||_W Y d }~nd }~0 0 td| ��d S )Nz"{}" does not match "{}"z
%r not raised)rN rO r �format�AssertionErrorr� )rZ �matchZeinfor1 �msg�r� r� r� �context� s
z#fake_pytest.raises.<locals>.context)r� )N)�
contextlib�contextmanager)rZ r� r� r� r� r� �raises� s zfake_pytest.raisesc C s" |rt �� �| |�S t �� �| �S )zMimics `pytest.warns`.)rH �TestCaseZassertWarnsRegexZ assertWarns)�warningr� r� r� r� �warns� s zfake_pytest.warnsr@ c C s t �| ��dS )zMimics `unittest.SkipTest`.N)rH ZSkipTest��reasonr� r� r� r{ � s zfake_pytest.skipc @ s( e Zd Zeddd��ZG dd� d�ZdS )zfake_pytest.markr@ c C s t �| |�S )z'Mimics `@pytest.mark.skipif` decorator.)rH ZskipIf)� conditionr� r� r� r� �skipif� s zfake_pytest.mark.skipifc @ s" e Zd ZdZddd�Zdd� ZdS )z fake_pytest.mark.xdist_groupz4Mimics `@pytest.mark.xdist_group` decorator (no-op).Nc C s d S r� r� r� r� r� r� r� � s z%fake_pytest.mark.xdist_group.__init__c C s |S r� r� )r� Z cls_or_methr� r� r� r] � s z%fake_pytest.mark.xdist_group.__call__)N)r� r� r� r� r� r] r� r� r� r� � xdist_group� s
r� N)r@ )r� r� r� � staticmethodr� r� r� r� r� r� �mark� s r� )N)N)r@ )
r� r� r� r� r� r� r� r� r{ r� r� r� r� r� rR � s
rR c @ s& e Zd Zes"dd� Zejdd� �ZdS )r� c C s d S r� r� r� r� r� r� �runTest� s zTestCase.runTestc o s
d V d S r� r� )r� r� r� r� r� r� �subTest� s zTestCase.subTestN)r� r� r� r r� r� r� r� r� r� r� r� r� � s r� c @ sZ e Zd ZdZddd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dS )rM z�Test class providing auto-cleanup wrappers on top of process
test utilities. All test classes should derive from this one, even
if we use pytest.
r@ Nc C s t ||d�}| �t|� |S )N)ry r� )rW �
addCleanuprT )r� ry r� rb r� r� r� rW s zPsutilTestCase.get_testfnc O s t |i |��}| �t|� |S r� )rD r� rB )r� r� r� r� r� r� r� rD s z PsutilTestCase.spawn_testprocc C s* t � \}}| �t|� | �t|� ||fS r� )rF r� rB )r� Zchild1Zchild2r� r� r� rF s
z"PsutilTestCase.spawn_children_pairc C s* t � \}}| �t|� | �t|� ||fS r� )rE r� rB )r� r r r� r� r� rE s
zPsutilTestCase.spawn_zombiec O s. t |i |��\}}| �t|� | �t|� |S r� )rA r� rT rB )r� r� r� r� r r� r� r� rA s zPsutilTestCase.pyrunc C s� t |tj�sJ �|j|jks J �|j|jks0J �|jr@|js@J �t |tj�rt|j|jks\J �|jd urt|jdkstJ �t |� t
|� d S �Nr ) r r� �Errorr� r� �_name�
ZombieProcess�ppidZ_ppidr �repr)r� r& rZ r� r� r� �_check_proc_exc s
z PsutilTestCase._check_proc_excc C s� t �tj��<}zt�|� W n tjy8 td��Y n0 W d � n1 sN0 Y |jj|kshJ �|jj d u sxJ �t�
|�r�J |��|t� � vs�J �|dd� t� � D �vs�J �d S )Nz&wasn't supposed to raise ZombieProcessc S s g | ]
}|j �qS r� r_ r� r� r� r� r� 5 r z0PsutilTestCase.assertPidGone.<locals>.<listcomp>)
rz r� r� r$ r� r� r� r� r� r� r7 r^ � process_iter)r� r� �cmr� r� r� �
assertPidGone+ s ,z PsutilTestCase.assertPidGonec C s� | � |j� t|�}|j|jdd�D ]�\}}| j||d��v z
|� }W nF tjy\ � Y nF tjy� } z| � ||� W Y d }~n d }~0 0 d||f }t
|��W d � q$1 s�0 Y q$|j dd� d S )NT�� clear_cache�r& r� z-Process.%s() didn't raise NSP and returned %rr r ) r� r� rN �iter�allr� r� r� r$ r� r� r� )r� r& �nsr� r� rd rZ r� r� r� r� �assertProcessGone7 s
"�(z PsutilTestCase.assertProcessGonec C s� t �|j�}||ksJ �ts4ts4t|�t|�ks4J �|�� t jksFJ �|�� sRJ �t � |j�sbJ �|�
� |jt � � v s|J �|jdd� t � � D �v s�J �i t _
|jdd� t � � D �v s�J �t|�}|j|jdd�D ]~\}}| j||d��V z
|� W n: t jt jf�y. } z| �||� W Y d }~n
d }~0 0 W d � q�1 �sF0 Y q�t�r$t�t j��}|�� W d � n1 �s�0 Y | �||j� t�t j��}|�� W d � n1 �s�0 Y | �||j� t�t j��}|�� W d � n1 �s 0 Y | �||j� |� � |� � |� � |� � |�� �sRJ �t � |j��sdJ �|jt � � v �sxJ �|jdd� t � � D �v �s�J �i t _
|jdd� t � � D �v �s�J �d S ) Nc S s g | ]
}|j �qS r� r_ r� r� r� r� r� [ r z6PsutilTestCase.assertProcessZombie.<locals>.<listcomp>c S s g | ]
}|j �qS r� r_ r� r� r� r� r� ] r Tr� r� c S s g | ]
}|j �qS r� r_ r� r� r� r� r� y r c S s g | ]
}|j �qS r� r_ r� r� r� r� r� { r ) r� r� r� r
r �hashr r �
is_runningr7 �as_dictr^ r� Z_pmaprN r� r� r� r� � AccessDeniedr� r rz r� �cmdliner� r� r� �suspend�resumerB �kill)r� r& �cloner� r� r� rZ r� r� r� r� �assertProcessZombieJ sN
D((( z"PsutilTestCase.assertProcessZombie)r@ N)
r� r� r� r� rW rD rF rE rA r� r� r� r� r� r� r� r� rM � s
rM zunreliable on PYPYr� c @ s� e Zd ZdZdZdZdZer dndZdZ e
� � Z e
e�d��Zedd � �Zed
d � �Zd d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd dd �Zd d � Z dS ) rL a� Test framework class for detecting function memory leaks,
typically functions implemented in C which forgot to free() memory
from the heap. It does so by checking whether the process memory
usage increased before and after calling the function many times.
Note that this is hard (probably impossible) to do reliably, due
to how the OS handles memory, the GC and so on (memory can even
decrease!). In order to avoid false positives, in case of failure
(mem > 0) we retry the test for up to 5 times, increasing call
repetitions each time. If the memory keeps increasing then it's a
failure.
If available (Linux, OSX, Windows), USS memory is used for comparison,
since it's supposed to be more precise, see:
https://gmpy.dev/blog/2016/real-process-memory-and-environ-in-python
If not, RSS memory is used. mallinfo() on Linux and _heapwalk() on
Windows may give even more precision, but at the moment are not
implemented.
PyPy appears to be completely unstable for this framework, probably
because of its JIT, so tests on PYPY are skipped.
Usage:
class TestLeaks(psutil.tests.TestMemoryLeak):
def test_fun(self):
self.execute(some_function)
�� rn r r� TZ PSUTIL_DEBUGc C s t �d� d S )NF)r� �
_set_debug��clsr� r� r� �
setUpClass� s zTestMemoryLeak.setUpClassc C s t �| j� d S r� )r� r� �_psutil_debug_origr� r� r� r� �
tearDownClass� s z TestMemoryLeak.tearDownClassc C s | j �� }t|d|j�S )NZuss)� _thisproc�memory_full_infor� Zrss)r� �memr� r� r� �_get_mem� s
zTestMemoryLeak._get_memc C s t r| j�� S | j�� S d S r� )r r� �num_fds� num_handlesr� r� r� r� � _get_num_fds� s
zTestMemoryLeak._get_num_fdsc C s | j rt|dtjd� d S )N�yellow)�color�file)�verboser r| r� )r� r� r� r� r� �_log� s zTestMemoryLeak._logc C sx | � � }| �|� | � � }|| }|dk r8| �d| ��|dkrttrHdnd}|dkr\|d7 }d|||f }| �|��dS ) z�Makes sure num_fds() (POSIX) or num_handles() (Windows) does
not increase after calling a function. Used to discover forgotten
close(2) and CloseHandle syscalls.
r zHnegative diff %r (gc probably collected a resource from a previous test)�fd�handlerA r� z %s unclosed %s after calling %rN)r� �call�failr )r� r� �before�after�diff�type_r� r� r� r� �
_check_fds� s
�� zTestMemoryLeak._check_fdsc C s^ t jdd� | �� }t|�D ]}| �|�}~~q t jdd� | �� }t jg ksRJ �|| }|S )z�Get 2 distinct memory samples, before and after having
called fun repeatedly, and return the memory difference.
rA )Z
generation)�gcZcollectr� r r� �garbage)r� r� �timesZmem1r� rd Zmem2r� r� r� r� � _call_ntimes� s
zTestMemoryLeak._call_ntimesc C s� g }d}|}t d|d �D ]�}| �||�} d|t| �t| | �|f }
|�|
� | |kp^| |k} | r||dkrv| �|
� d S |dkr�t� | �|
� ||7 }| }q| �d�|���d S )Nr rA z,Run #%s: extra-mem=%s, per-call=%s, calls=%sz. )r r� r �appendr� �printr� r� ) r� r� r� rU � tolerance�messagesZprev_memZincrease�idxr� r� �successr� r� r� �
_check_mem� s.
�
zTestMemoryLeak._check_memc C s |� S r� r� )r� r� r� r� r� r�
s zTestMemoryLeak.callNc
C s� |dur |n| j }|dur |n| j}|dur0|n| j}|durB|n| j}zD|dksZJ d��|dksjJ d��|dkszJ d��|dks�J d��W n0 ty� } ztt|���W Y d}~n
d}~0 0 | �||� | �|� | j ||||d� dS ) zTest a callable.NrA ztimes must be >= 1r zwarmup_times must be >= 0zretries must be >= 0ztolerance must be >= 0)r� rU r� )
r� � warmup_timesrU r� r� r� r r� r� r� )r� r� r� r� rU r� r1 r� r� r� �execute s �"
zTestMemoryLeak.executec s& � ��fdd�}�j |fi |�� dS )znConvenience method to test a callable while making sure it
raises an exception on every call.
c s �� � �� d S r� )� assertRaisesr� �rZ r� r� r� r� r� + s z*TestMemoryLeak.execute_w_exc.<locals>.callN)r� )r� rZ r� r� r� r� r� r� �
execute_w_exc& s z TestMemoryLeak.execute_w_exc)NNNN) r� r� r� r� r� r� r� r* rU r� r� r� r� �boolr� �getenvr� � classmethodr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� rL � s,
�
rL c C s� dd l } dd l}dd l}dd l}dd l}z dd l}W n tyJ d }Y n0 z dd l}W n tyn d }Y n0 | �� }t j
r�t d�r�t d�|d< nzt j
r�dt�� d |d< n^t jr�dd�ttt�� �� |d< ttd�r�|d d t�� 7 < nd
t�� t�� f |d< d �tt�� �t�� g �|d < t j �rFt� � d |d
< d �t� � t� � t� � g�|d< t!|dd�|d< |d u�r�|d d|j" 7 < t j �r�t d��r�t ddg�}t|��#d�d |d< nd|d< t�$� d } | �r�| |d< t%�&� |d< |�'� }
d|
d |
d f |d< |j�(t �)� ��*d�|d < |j�+� �*d�|d < |�,� |d < t-j.�/d �|d < t-�0� |d!< t1|d"< t�2� |d#< t-�3� |d$< t �4� |d%< d&t5d'd(� t �6� D �� |d)< t �7� } d*t8| j9�t:| j;�t:| j<�f |d+< t �=� } d*t8| j9�t:| j;�t:| j<�f |d,< t>t �?� �|d-< t �@� �A� }
|
�Bd.d � |�C|
�|d/< tDd0t%jEd1� |�F� D ]$\}}tDd2|d3 |f t%jEd1� �q^tDd0t%jEd1� t%jG�H� t%jG�H� d S )4Nr � lsb_releasezlsb_release -d -sZOSz Darwin %szWindows � �
win32_editionz, z%s %s�archrm Zkernel�python� __version__z
not installed�pipz (wheel=%s)rw z --versionr rA �glibcz fs-encodingz%s, %s�langz%Y-%m-%d %H:%M:%Sz boot-timer� �user�~�homer� Zpyexe�hostnameZPIDZcpusz%.1f%%, %.1f%%, %.1f%%c S s g | ]}|t �� d �qS )�d )r� � cpu_countr� r� r� r� r� { r z!print_sysinfo.<locals>.<listcomp>Zloadavgz%s%%, used=%s, total=%sZmemory�swapr^ r� r& zF======================================================================�r� z%-17s %s�:)I� collections�datetime�getpass�locale�pprintr� � ImportError�wheel� OrderedDictr� r r r# ZOSXrt ru r
r� rw r � win32_verrM r� �systemr �list� architecture�machiner rC �python_implementation�python_version�python_compilerr� r� ry �libc_verr| �getfilesystemencoding� getlocale�
fromtimestamp� boot_time�strftime�now�getuserr� r� �
expanduserr� r# �node�getpidr� rv r� �virtual_memoryrx �percentr �used�total� swap_memoryrE r^ r� r� r= �pformatr� r� �itemsr� �flush)r� r� r� r r r� r �info�outr� r� r� r� Zpinfo�k�vr� r� r� rP 1 s�
��
�� ��
�
rP c C s6 t dd� �}z|� | dkW S ty0 Y dS 0 d S )Nc S sX i } t d�}|�� dd � D ]6}dd� |�d�D �}|d t|d � }}|| |< q | S )Nztasklist.exe /NH /FO csvrA c S s g | ]}|� d d��qS )�"r@ )�replacer� r� r� r� r� � r z@is_win_secure_system_proc.<locals>.get_procs.<locals>.<listcomp>�,r )r# �
splitlinesry rx )rd r! �line�bitsr� r� r� r� r� � get_procs� s
z,is_win_secure_system_proc.<locals>.get_procsz
Secure SystemF)r �KeyError)r� r* r� r� r� rQ � s
rQ c C s6 t �� } t| d�r| �� S t| d�r2t�| �� �S dS )Nr� r� r )r� r� rM r� �random�choicer� )r" r� r� r� �_get_eligible_cpu� s
r. c @ sJ e Zd ZdZddi fddi fgZddi fddddifd di fd
di fd di fd di fd
di fddi fddi fddi fg
Zddi fddi fddi fddi fddi fddi fddi fddi fdddd ifd di fd di fd di fd di fd!di fd"di fd#di fd$di fgZe�rNed%di fg7 Zed&di fg7 Zed'di fg7 Zed(di fg7 Ze�rded)di fg7 Ze �rzed*di fg7 Ze
�r�ed+e j fi fg7 Ze
�r�ed,di fg7 Ze�r�ed-di fg7 Ze�r�ed.di fg7 Ze�r�ed/di fg7 Ze�red0dd1d2ifg7 Zg Ze�r"ed di fg7 Zned e jfi fg7 Ze
�rRed+e j d3fi fg7 Ze �r�e�rved*e jd4fi fg7 Zned*e jfi fg7 Ze
�r�ed,e� gfi fg7 Zd5ejfi fd6di fd7di fd8di fd9di fgZe�red5ejfi fg7 Zed5ej fi fg7 Zee e e Z d:d;� Z dEd<d=�Z d>d?� Z e!d@dA� �Z"e!dBdC� �Z#dDS )FrN a A container that lists all Process class method names + some
reasonable parameters to be called with. Utility methods (parent(),
children(), ...) are excluded.
>>> ns = process_namespace(psutil.Process())
>>> for fun, name in ns.iter(ns.getters):
... fun()
� cpu_percentr� Zmemory_percentr� r< r; T� connectionsr� Zmemory_info_exZoneshotr �parentsr� r� �r r� � cpu_timesZ create_timer� r� r� Z memory_infor� �net_connections�kindr� �niceZnum_ctx_switchesZ num_threadsZ
open_filesr� r r� �usernameZuids�gidsZterminalr� r� r� r� r� r� r� r� r� ZgroupedF)r� i r r) r� r� rB r� c C s
|| _ d S r� )�_proc)r� r& r� r� r� r� s zprocess_namespace.__init__c c s` t |�}t�|� |D ]D\}}}|r,| �� t| j|�}tj|g|�R i |��}||fV qdS �z_Given a list of tuples yields a set of (fun, fun_name) tuples
in random order.
N)r r, �shuffler� r� r9 r� ri )r� �lsr� �fun_namer� r� r� r� r� r� r� s
zprocess_namespace.iterc C s | j j| j jdd� dS )z&Clear the cache of a Process instance.T)Z _ignore_nspN)r9 �_initr� r� r� r� r� r� & s z process_namespace.clear_cachec C s> |D ]4\}}}d| }t ||�sd|jj|f }t|��qdS )z}Given a TestCase instance and a list of tuples checks that
the class defines the required test method names.
Ztest_z$%r class should define a '%s' methodN)rM r� r� �AttributeError)r� Z
test_classr< r= r � meth_namer� r� r� r� �test_class_coverage* s
�z%process_namespace.test_class_coveragec C s` t dd� | jD ��}t dd� | jD ��}t dd� ttj�D ��}||B |A }|r\td| ��d S )Nc S s g | ] }|d �qS r2 r� r� r� r� r� r� : r z*process_namespace.test.<locals>.<listcomp>c S s g | ] }|d �qS r2 r� r� r� r� r� r� ; r c S s g | ]}|d dkr|�qS )r r r� r� r� r� r� r� < r z!uncovered Process class names: %r)r� r� �ignoredr� r� r� r� )r� �thisrB �klassZleftoutr� r� r� �test8 s zprocess_namespace.testN)T)$r� r� r� r� �utilsrB �gettersr r1 r2 r5 r� Z
RLIMIT_NOFILEr. r4 r0 r
r3 ZsettersZNORMAL_PRIORITY_CLASSr ZIOPRIO_CLASS_NONEZ
IOPRIO_NORMALr. r' �SIGTERMZkillersZ CTRL_C_EVENTZCTRL_BREAK_EVENTr� r� r� r� r� rA rE r� r� r� r� rN � s� � � �
rN c @ s� e Zd ZdZddi fddddifddddifddi fd dd
difd dd
difd dd difd
dddifde�� fi fddddifddi fddi fddddifde�� fi fddi fddi fddi fddi fgZer�e r�e
� � dkr�ned dd
difg7 Ze �r ed di fg7 Ze
�r"ed di fg7 Ze�r8ed di fg7 Ze�rNed di fg7 Ze�rted!di fg7 Zed"d#i fg7 Zd$di fd%e�� gfi fd&di fd'di fgZeZed(d)� �ZejZd*S )+rO z�A container that lists all the module-level, system-related APIs.
Utilities such as cpu_percent() are excluded. Usage:
>>> ns = system_namespace
>>> for fun, name in ns.iter(ns.getters):
... fun()
r r� r� �logicalFTZ cpu_statsr3 ZpercpuZdisk_io_countersZperdiskZdisk_partitionsr� �
disk_usager4 r5 Z net_if_addrsZ net_if_statsr� Zpernicr7 r^ r Zusersr �arm64r� r� r� r� r� Zwin_service_iterZwin_service_get)�algr� r> r/ Zcpu_times_percentc c sR t | �} t�| � | D ]6\}}}tt|�}tj|g|�R i |��}||fV qdS r: )r r, r; r� r� r� ri )r< r= r� r� r� r� r� r� r� y s
zsystem_namespace.iterN)r� r� r� r� r� r� r rG r/ r rt r �HAS_GETLOADAVGr9 r8 r6 r
r� r� rB r� r� r� rN rA r� r� r� r� rO B sX ��
rO c C s dd� }t td| |d�S )zZDecorator which runs a test function and retries N times before
actually failing.
c S s t d| tjd� d S )Nz %r, retryingr� )r� r| r� )rZ r� r� r� rW � s z retry_on_failure.<locals>.logfunN)rT r rU rW )rS r� )rU rW r� r� r� rK � s �rK c s � fdd�}|S )z,Decorator to Ignore AccessDenied exceptions.c s t �� �� �fdd��}|S )Nc sB z� | i |��W S t jy< �d ur.�s.� t�d��Y n0 d S )Nzraises AccessDenied)r� r� rz r{ r� �r� �only_ifr� r� r� � s z9skip_on_access_denied.<locals>.decorator.<locals>.wrapperr� r� �rO r� r� r\ � s z(skip_on_access_denied.<locals>.decoratorr� �rO r\ r� rP r� rI � s
rI c s � fdd�}|S )z3Decorator to Ignore NotImplementedError exceptions.c s t �� �� �fdd��}|S )Nc sJ z� | i |��W S t yD �d ur,�s,� d� j }t�|��Y n0 d S )Nz4%r was skipped because it raised NotImplementedError)rB r� rz r{ )r� r� r� rN r� r� r� � s ��z;skip_on_not_implemented.<locals>.decorator.<locals>.wrapperr� r� rP r� r� r\ � s
z*skip_on_not_implemented.<locals>.decoratorr� rQ r� rP r� rJ � s rJ � 127.0.0.1c C sL t �t�� ��*}|�| df� |�� d W d � S 1 s>0 Y dS )z6Return an unused TCP port. Subject to race conditions.r rA N)r� �closing�socket�bind� getsockname)�hostr
r� r� r� r_ � s r_ c C s� |du r| t tfv rd}t�| |�}z@tjdvrB|�tjtjd� |�|� |tj kr`|�
d� |W S t y� |� � � Y n0 dS )zBinds a generic socket.N�r@ r )�nt�cygwinrA r� )
r r rT r� r� �
setsockopt�
SOL_SOCKET� SO_REUSEADDRrU r �listenr� r )�family�type�addrr
r� r� r� r` � s
r` c C sp t js
J �tj�| �r J | ��t�tj|�}z"|�| � |tjkrL|� d� W n t
yj |� � � Y n0 |S )zBind a UNIX socket.r� ) r� r r� r� r� rT r� rU r r^ r� r )r� r` r
r� r� r� ra � s
ra rX c C s� t �t�| t����}|�|� |�d� |�� }t�| t�}zL|�|� |�� }|�� \}}||kr|||fW W d � S |� � qPW n t
y� |� � � Y n0 W d � n1 s�0 Y dS )z^Build a pair of TCP sockets connected to each other.
Return a (server, client) tuple.
r� N) r� rS rT r rU r^ rV �connectr r r. )r_ ra ZllrF Zcaddr�ar� r� r� rb � s
rb c C s� t js
J �d }}z@t| tjd�}|�d� t�tjtj�}|�d� |�| � W n4 ty� |durp|� � |dur�|� � � Y n0 ||fS )z�Build a pair of UNIX sockets connected to each other through
the same UNIX file name.
Return a (server, client) tuple.
N�r` r )
r� r ra rT r � setblockingr� rb r� r )r� �server�clientr� r� r� rc s
rc c c s g } d }}z�| � ttjtj�� | � ttjtj�� t� rd| � ttjtj�� | � ttjtj�� tr�t r�t
� }t
� }t |�\}}t |tjd�}|||fD ]}| � |� q�| V W | D ] }|�
� q�||fD ]}|dur�t|� q�n6| D ] }|�
� q�||fD ]}|du�r t|� �q 0 dS )z1Open as many socket families / types as possible.Nrd )r� r` rT r r �
SOCK_DGRAMr r r r: rW rc ra r rT )�socksZfname1Zfname2�s1�s2Zs3r� rb r� r� r� rd s4
�
rd c C s ddl }tr(tr(ts(t|tj�s(J |��|tjkr�dd� | �d�D �}t |�dksZJ | ��|D ]"}d| krvdks^n J | ��q^ts�t
| �} |� | � nd|tj kr�t| t
�s�J | ��ts�t
| �} |�| � n0|tjkr�t�d| �dus�J | ��n td | ��dS )
z[Check a net address validity. Supported families are IPv4,
IPv6 and MAC addresses.
r Nc S s g | ] }t |��qS r� )rx r� r� r� r� r� > r z%check_net_address.<locals>.<listcomp>rl r� � z([a-fA-F0-9]{2}[:|\-]?){6}zunknown family %r)� ipaddress�enumr r" r �IntEnumrT r ry rE r � IPv4Addressr r � IPv6Addressr� ZAF_LINKrN r� r� )ra r_ rm Zocts�numr� r� r� r] 5 s&
r] c C sT dd� }dd� }dd� }dd� }d d
� }|| � || � || � || � || � d S ) z*Check validity of a connection namedtuple.c S s� t | �dk}t | �dv s$J t | ���| d | jks<J | j��| d | jksTJ | j��| d | jkslJ | j��| d | jks�J | j��| d | jks�J | j��| d | jks�J | j��|r�| d | jks�J | j��d S )
Nr� )r- r� r rA rm r� r� r� r- )rE r� r_ r` �laddr�raddrr r� )r Zhas_pidr� r� r� � check_ntupleS s z-check_connection_ntuple.<locals>.check_ntuplec S s
| j tttfv sJ | j ��td ur:t| j tj�sNJ | ��nt| j t�sNJ | ��| j tkr�t�| j | j �}t
� |��^ z|� | j
d df� W n4 tjy� } z|jtjkr�� W Y d }~n
d }~0 0 W d � n1 s�0 Y n$| j tk�r| jtjk�sJ | j��d S r� )r_ r r r� rn r ro rx rT r` r� rS rU rs �errorr0 Z
EADDRNOTAVAILr r� � CONN_NONE)r r� r1 r� r� r� � check_family_ s
8 z-check_connection_ntuple.<locals>.check_familyc S s� t tdt� �}| jtjtj|fv s,J | j��td urLt| jtj�s`J | ��nt| jt �s`J | ��| jtjkr�| j
t j ks�J | j
��d S )N�SOCK_SEQPACKET)
r� rT �objectr` r rh rn r ro rx r r� rw )r ry r� r� r� �
check_typet s �� z+check_connection_ntuple.<locals>.check_typec S s� | j | jfD ]�}| jttfv r�t|t�s4J t|���|s:q t|jt �sTJ t|j���d|j krjdksvn J |j��t
|j | j� q | jt kr t|t
�s J t|���q d S )Nr i�� )rs rt r_ r r r rv r` �portrx r] �ipr� r )r ra r� r� r� � check_addrs� s "
z,check_connection_ntuple.<locals>.check_addrsc S s� t | jt�sJ | j��dd� tt�D �}| j|v s<J | j��| jttfv rl| jt krl| jtj
ks�J | j��n| jtj
ks�J | j��d S )Nc S s g | ]}|� d �rtt|��qS )ZCONN_r� r� r� r� r� r� � s zAcheck_connection_ntuple.<locals>.check_status.<locals>.<listcomp>) r r r r� r� r_ r r r` r rw )r Zvalidsr� r� r� � check_status� s �z-check_connection_ntuple.<locals>.check_statusNr� )r ru rx r{ r~ r r� r� r� �check_connection_ntupleP s
r� c C sL g }| D ]>}t r<|jtjkr<tr<d|jv r<tdt|� � q|�|� q|S )ztOur process may start with some open UNIX sockets which are not
initialized by us, invalidating unit tests.
z/syslogz skipping %s) r r_ rT r� r rt r r r� )Zcons�newr r� r� r� r^ � s r^ c C sN zddl }t|d�st�W n$ ty> ddl}|�| � Y S 0 |�| �S dS )z,Backport of importlib.reload of Python 3.3+.r N�reload)� importlibrM r �impr� )�moduler� r� r� r� r� re � s
re c C sp t j�t j�| ��d }tjd dk r:dd l}|�|| �S dd l}|j �
|| �}|j � |�}|j �
|� |S d S )Nr r� )r� r� �splitextr� r| r� r� Z load_source�importlib.util�util�spec_from_file_location�module_from_spec�loader� exec_module)r� r� r� r� �spec�modr� r� r� rf � s rf c C s t j| tdd� dS )zRaise a warning msg.rm r� N)r� rg r� )r� r� r� r� rg � s rg c C sV t | �}|j}t|�dks&|d tur*dS t|dd�}t|t�sDdS tdd� |D ��S )z-Check if object is an instance of namedtuple.rA r F�_fieldsNc s s | ]}t |t�V qd S r� )r r )r� �nr� r� r� � <genexpr>� r z is_namedtuple.<locals>.<genexpr>)r` � __bases__rE rv r� r r� )r� �t�br r� r� r� ri � s
ri c # s| t rdnd� d�t| � d�}� �fdd�t�� �� D �}t�|�}t�||� z t �
|� |V W t |� n
t |� 0 dS )z�Ctx manager which picks up a random shared CO lib used
by this process, copies it in another location and loads it
in memory via ctypes. Return the new absolutized path.
�pypyr� z.sorx c s6 g | ].}t j�|j�d �kr� |j�� v r|j�qS )rA )r� r� r� �lowerr� �r� �extr� r� r� � s $��'copyload_shared_lib.<locals>.<listcomp>N) r" rW r� r� r� r, r- rj rt �ctypes�CDLLrT )ry �dst�libsr r� r� r� rh � s
�
rh c # s ddl m} ddl m} d� t| � d�}� fdd�t�� �� D �}trb|sbdd� t�� �� D �}t� |�}t
� ||� d }zPt � |�}|V W |d ur�t j
jj}|jg|_||j�}|dkr�|� t|� nB|d u�rt j
jj}|jg|_||j�}|dk�r|� t|� 0 d S )
z�Ctx manager which picks up a random shared DLL lib used
by this process, copies it in another location and loads it
in memory via ctypes.
Return the new absolutized, normcased path.
r )�WinError)�wintypesz.dllrx c sF g | ]>}|j �� �� �rd tj �|j ��� v rd|j �� vr|j �qS )r� Zwow64)r� r� r r� r� r� �r� r� r� r� s
�r� c S s( g | ] }d t j�|j��� v r|j�qS )r� )r� r� r� r� r� r� r� r� r� s �N)r� r� r� rW r� r� r� r" r, r- rj rt �WinDLL�windllZkernel32� FreeLibraryZHMODULE�argtypes�_handlerT ) ry r� r� r� r� r �cfiler� rd r� r� r� rh s>
�
�
�
c C s t dd� d S )NTr: )rC r� r� r� r� �cleanup_test_procs7 s r� c C s
t �| �S r� )r| �exit)r+ r r� r� r� r A r r )N)F)TF)N)r@ N)N)N)rR )rX )r@ )r@ )�r� �
__future__r rr r� r� r0 r� r� r� rt r, rN r r rj r' rT rf rz r| r} r� r� r� rH r� r r r rz r r� r r r r r
r r r
Zpsutil._commonr r r r r Zpsutil._compatr r r r r r r r �catch_warnings� simplefilterrn Z unittest2Zpsutil._psposixr �__all__�builtin_module_namesr" r� r rj r* r= r@ r r ra r? �maxsizer- r r> r� r; r< r! r r, r r� r r' r( �decoder) r r� ZASCII_FSr� r� r� rp �__file__r% �getr& r� rM r� r. r/ r0 rM r2 r3 r: ZHAS_NET_IO_COUNTERSr4 r1 r5 r6 r� r� r7 r� r8 r9 Z HAS_THREADS�getuidZ SKIP_SYSCONSr� r# r$ �devnullr rs r r� r+ r� rz r� r� r� r� r� rG r� rD rF rE rA r# rH rB rC rY rX rS r$ r[ r� r\ rZ rT ro r� rS rU rV rW rR r� rM r� r� rL rP rQ r. rN rO rK rI rJ r_ r` ra rb rc rd r] r� r^ re rf rg ri rh r� r� r� r� r� �<module> s�
.
-
.
��
*
�0 )
&-
V
%;�
� �
"
M
%l F
R 3
PK ok\�����\ �\ 5 psutil/tests/__pycache__/test_memleaks.cpython-39.pycnu �[��� a
��?h3< � @ s d Z ddlmZ ddlZddlZddlZddlZddlZddlmZ ddlm Z ddlm
Z
ddlm Z ddlm Z dd lm
Z
dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! dd lm"Z" dd lm#Z# dd lm$Z$ dd lm%Z% dd lm&Z& dd!lm'Z' ej(j)Z)e�*� Z+d"Z,d#d$� Z-G d%d&� d&e �Z.G d'd(� d(e.�Z/e#j0j1e
d)d*�G d+d,� d,e ��Z2G d-d.� d.e �Z3dS )/a� Tests for detecting function memory leaks (typically the ones
implemented in C). It does so by calling a function many times and
checking whether process memory usage keeps increasing between
calls or over time.
Note that this may produce false positives (especially on Windows
for some reason).
PyPy appears to be completely unstable for this framework, probably
because of how its JIT handles memory, so tests are skipped.
� )�print_functionN)�LINUX)�MACOS)�OPENBSD)�POSIX)�SUNOS)�WINDOWS)�ProcessLookupError)�super)�HAS_CPU_AFFINITY)� HAS_CPU_FREQ)� HAS_ENVIRON)�
HAS_IONICE)�HAS_MEMORY_MAPS)�HAS_NET_IO_COUNTERS)�HAS_PROC_CPU_NUM)�HAS_PROC_IO_COUNTERS)�
HAS_RLIMIT)�HAS_SENSORS_BATTERY)�HAS_SENSORS_FANS)�HAS_SENSORS_TEMPERATURES)� QEMU_USER)�TestMemoryLeak)�create_sockets)�
get_testfn)�process_namespace)�pytest)�skip_on_access_denied)�spawn_testproc)�system_namespace)� terminate� c C s dd� } | S )zsDecorator for those Linux functions which are implemented in pure
Python, and which we want to run faster.
c s t �� �� fdd��}|S )Nc s\ t rB| jj}z(t| j_� | g|�R i |��W || j_S || j_0 n� | g|�R i |��S d S �N)r � __class__�times� FEW_TIMES)�self�args�kwargs�before��fun� �F/usr/local/lib64/python3.9/site-packages/psutil/tests/test_memleaks.py�wrapperD s � z5fewtimes_if_linux.<locals>.decorator.<locals>.wrapper)� functools�wraps)r+ r. r, r* r- � decoratorC s z$fewtimes_if_linux.<locals>.decoratorr, )r1 r, r, r- �fewtimes_if_linux> s r2 c @ s0 e Zd ZdZeZdd� Ze� dd� �Ze� dd� �Z e� dd � �Z
e� d
d � �Z e j
je d d
�e� dd� ��Ze j
je d d
�e� dd� ��Ze� dd� �Zdd� Zdd� Ze j
je dd
�dd� �Ze j
je dd
�dd � �Ze j
je dd
�e� d d � ��Ze j
jed d
�d d!� �Ze� d"d#� �Ze� e e d$�d%d&� ��Z e j
je d'd
�d(d)� �Z e j
je d d
�e� d*d+� ��Z!e� d,d-� �Z"e� e e d$�d.d/� ��Z#e� d0d1� �Z$e� e j
je% dd
�d2d3� ��Z&e� d4d5� �Z'e� d6d7� �Z(e j
je d d
�e� d8d9� ��Z)d:d;� Z*e� d<d=� �Z+e j
je, dd
�d>d?� �Z-e j
je, dd
�d@dA� �Z.e� dBdC� �Z/e j
je0 dd
�e� dDdE� ��Z1e j
je2 dFd
�e j
je3 dd
�dGdH� ��Z4e j
je2 dFd
�e j
je3 dd
�dIdJ� ��Z5e� e j
je dKd
�dLdM� ��Z6e j
je7 dd
�dNdO� �Z8e j
je d'd
�dPdQ� �Z9dRS )S�TestProcessObjectLeaksz$Test leaks of Process class methods.c C s t d �}|�| |j|j � d S r" )r �test_class_coverageZgettersZsetters�r& �nsr, r, r- �
test_coverage_ s z$TestProcessObjectLeaks.test_coveragec C s | � | jj� d S r" )�execute�proc�name�r& r, r, r- � test_namec s z TestProcessObjectLeaks.test_namec C s | � | jj� d S r" )r8 r9 Zcmdliner; r, r, r- � test_cmdlineg s z#TestProcessObjectLeaks.test_cmdlinec C s | � | jj� d S r" )r8 r9 Zexer; r, r, r- �test_exek s z TestProcessObjectLeaks.test_exec C s | � | jj� d S r" )r8 r9 Zppidr; r, r, r- � test_ppido s z TestProcessObjectLeaks.test_ppidz
POSIX only��reasonc C s | � | jj� d S r" )r8 r9 Zuidsr; r, r, r- � test_uidss s z TestProcessObjectLeaks.test_uidsc C s | � | jj� d S r" )r8 r9 �gidsr; r, r, r- � test_gidsx s z TestProcessObjectLeaks.test_gidsc C s | � | jj� d S r" )r8 r9 �statusr; r, r, r- � test_status} s z"TestProcessObjectLeaks.test_statusc C s | � | jj� d S r" )r8 r9 �nicer; r, r, r- � test_nice� s z TestProcessObjectLeaks.test_nicec s t �� � ��� �fdd�� d S )Nc s �j �� �S r" )r9 rG r, �Znicenessr& r, r- �<lambda>� � z6TestProcessObjectLeaks.test_nice_set.<locals>.<lambda>)�thisprocrG r8 r; r, rI r- �
test_nice_set� s z$TestProcessObjectLeaks.test_nice_set�
not supportedc C s | � | jj� d S r" )r8 r9 �ionicer; r, r, r- � test_ionice� s z"TestProcessObjectLeaks.test_ionicec sZ t r"t�� �� �� �fdd�� n4� �� fdd�� t�tjt� � dd�}� �
t |� d S )Nc s � j ���S r" )r9 rO r, �r& �valuer, r- rJ � rK z8TestProcessObjectLeaks.test_ionice_set.<locals>.<lambda>c s � j �tj�S r" )r9 rO �psutilZIOPRIO_CLASS_NONEr, r; r, r- rJ � rK ���r ) r rL rO r8 r/ �partial�cextZproc_ioprio_set�os�getpid�
execute_w_exc�OSError�r& r+ r, rQ r- �test_ionice_set� s z&TestProcessObjectLeaks.test_ionice_setc C s | � | jj� d S r" )r8 r9 Z io_countersr; r, r, r- �test_io_counters� s z'TestProcessObjectLeaks.test_io_counterszworthless on POSIXc C s t �� �� | �| jj� d S r" )rS �Process�usernamer8 r9 r; r, r, r- �
test_username� s z$TestProcessObjectLeaks.test_usernamec C s | � | jj� d S r" )r8 r9 Z create_timer; r, r, r- �test_create_time� s z'TestProcessObjectLeaks.test_create_time)Zonly_ifc C s | � | jj� d S r" )r8 r9 Z num_threadsr; r, r, r- �test_num_threads� s z'TestProcessObjectLeaks.test_num_threads� WINDOWS onlyc C s | � | jj� d S r" )r8 r9 Z num_handlesr; r, r, r- �test_num_handles� s z'TestProcessObjectLeaks.test_num_handlesc C s | � | jj� d S r" )r8 r9 Znum_fdsr; r, r, r- � test_num_fds� s z#TestProcessObjectLeaks.test_num_fdsc C s | � | jj� d S r" )r8 r9 Znum_ctx_switchesr; r, r, r- �test_num_ctx_switches� s z,TestProcessObjectLeaks.test_num_ctx_switchesc C s | � | jj� d S r" )r8 r9 �threadsr; r, r, r- � test_threads� s z#TestProcessObjectLeaks.test_threadsc C s | � | jj� d S r" )r8 r9 � cpu_timesr; r, r, r- �test_cpu_times� s z%TestProcessObjectLeaks.test_cpu_timesc C s | � | jj� d S r" )r8 r9 Zcpu_numr; r, r, r- � test_cpu_num� s z#TestProcessObjectLeaks.test_cpu_numc C s | � | jj� d S r" )r8 r9 Z memory_infor; r, r, r- �test_memory_info� s z'TestProcessObjectLeaks.test_memory_infoc C s | � | jj� d S r" )r8 r9 Zmemory_full_infor; r, r, r- �test_memory_full_info� s z,TestProcessObjectLeaks.test_memory_full_infoc C s | � | jj� d S r" )r8 r9 Zterminalr; r, r, r- �
test_terminal� s z$TestProcessObjectLeaks.test_terminalc C s$ t rtn| j}| j| jj|d� d S )N�r$ )r r% r$ r8 r9 �resume�r& r$ r, r, r- � test_resume� s z"TestProcessObjectLeaks.test_resumec C s | � | jj� d S r" )r8 r9 �cwdr; r, r, r- �test_cwd� s z TestProcessObjectLeaks.test_cwdc C s | � | jj� d S r" )r8 r9 � cpu_affinityr; r, r, r- �test_cpu_affinity� s z(TestProcessObjectLeaks.test_cpu_affinityc s4 t �� � ��� �fdd�� ��t�fdd�� d S )Nc s �j �� �S r" �r9 ru r, �Zaffinityr& r, r- rJ � rK z>TestProcessObjectLeaks.test_cpu_affinity_set.<locals>.<lambda>c s � j �dg�S �NrT rw r, r; r, r- rJ � rK )rL ru r8 rY �
ValueErrorr; r, rx r- �test_cpu_affinity_set� s z,TestProcessObjectLeaks.test_cpu_affinity_setc C s> t t� d�� | �| jj� W d � n1 s00 Y d S )N�w)�openr r8 r9 Z
open_filesr; r, r, r- �test_open_files� s z&TestProcessObjectLeaks.test_open_filesc C s | � | jj� d S r" )r8 r9 Z memory_mapsr; r, r, r- �test_memory_maps� s z'TestProcessObjectLeaks.test_memory_mapsz
LINUX onlyc s � � � fdd�� d S )Nc s � j �tj�S r" �r9 �rlimitrS �
RLIMIT_NOFILEr, r; r, r- rJ � rK z4TestProcessObjectLeaks.test_rlimit.<locals>.<lambda>�r8 r; r, r; r- � test_rlimit� s z"TestProcessObjectLeaks.test_rlimitc s< t �tj�� ��� �fdd�� ��ttf�fdd�� d S )Nc s �j �tj� �S r" r� r, ��limitr& r, r- rJ � rK z8TestProcessObjectLeaks.test_rlimit_set.<locals>.<lambda>c s � j �d�S ry )r9 r� r, r; r, r- rJ � rK )rL r� rS r� r8 rY rZ rz r; r, r� r- �test_rlimit_set� s z&TestProcessObjectLeaks.test_rlimit_setzworthless on WINDOWSc sJ t � �0 trdnd� ��� �fdd�� W d � n1 s<0 Y d S )NZinet�allc s �j �� �S r" )r9 �net_connectionsr, ��kindr& r, r- rJ rK z=TestProcessObjectLeaks.test_net_connections.<locals>.<lambda>)r r r8 r; r, r� r- �test_net_connections� s z+TestProcessObjectLeaks.test_net_connectionsc C s | � | jj� d S r" )r8 r9 �environr; r, r, r- � test_environ s z#TestProcessObjectLeaks.test_environc C s | � dd� � d S )Nc S s t �t�� �S r" )rV � proc_inforW rX r, r, r, r- rJ rK z7TestProcessObjectLeaks.test_proc_info.<locals>.<lambda>r� r; r, r, r- �test_proc_info
s z%TestProcessObjectLeaks.test_proc_infoN):�__name__�
__module__� __qualname__�__doc__rL r9 r7 r2 r< r= r> r? r �mark�skipifr rB rD rF rH rM r rP r\ r r] r` ra r r rb r rd re rf rh rj r rk rl rm rn rr rt r rv r{ r~ r r r r r� r� r� r
r� r� r, r, r, r- r3 Z s�
r3 c sp e Zd ZdZe� fdd��Ze� fdd��Zdd� Zerhdd � Z d
d � Z
d d
� Z dd� Z dd� Z
dd� Z� ZS )�TestTerminatedProcessLeaksz�Repeat the tests above looking for leaks occurring when dealing
with terminated processes raising NoSuchProcess exception.
The C functions are still invoked but will follow different code
paths. We'll check those code paths.
c s: t � �� t� | _t�| jj�| _| j�� | j� � d S r" )
r
�
setUpClassr �subprS r^ �pidr9 �kill�wait��cls�r# r, r- r� s
z%TestTerminatedProcessLeaks.setUpClassc s t � �� t| j� d S r" )r
�
tearDownClassr r� r� r� r, r- r� s
z(TestTerminatedProcessLeaks.tearDownClassc C s$ z
|� W n t jy Y n0 d S r" )rS Z
NoSuchProcessr[ r, r, r- �call# s
z TestTerminatedProcessLeaks.callc C s | � | jj� d S r" )r8 r9 r� r; r, r, r- � test_kill+ s z$TestTerminatedProcessLeaks.test_killc C s | � | jj� d S r" )r8 r9 r r; r, r, r- �test_terminate. s z)TestTerminatedProcessLeaks.test_terminatec C s | � | jj� d S r" )r8 r9 Zsuspendr; r, r, r- � test_suspend1 s z'TestTerminatedProcessLeaks.test_suspendc C s | � | jj� d S r" )r8 r9 rp r; r, r, r- rr 4 s z&TestTerminatedProcessLeaks.test_resumec C s | � | jj� d S r" )r8 r9 r� r; r, r, r- � test_wait7 s z$TestTerminatedProcessLeaks.test_waitc s � fdd�}� � |� d S )Nc s( zt �� jj�W S ty" Y n0 d S r" )rV r� r9 r� r r, r; r, r- r� < s z7TestTerminatedProcessLeaks.test_proc_info.<locals>.callr� )r& r� r, r; r- r� : s z)TestTerminatedProcessLeaks.test_proc_info)r� r� r� r� � classmethodr� r� r� r r� r� r� rr r� r� �
__classcell__r, r, r� r- r� s r� rc r@ c @ s e Zd Zdd� Zdd� ZdS )� TestProcessDualImplementationc C s | � dd� � d S )Nc S s t jt�� dd�S )NT�Zuse_peb�rV Z proc_cmdlinerW rX r, r, r, r- rJ H rK zETestProcessDualImplementation.test_cmdline_peb_true.<locals>.<lambda>r� r; r, r, r- �test_cmdline_peb_trueG s z3TestProcessDualImplementation.test_cmdline_peb_truec C s | � dd� � d S )Nc S s t jt�� dd�S )NFr� r� r, r, r, r- rJ K rK zFTestProcessDualImplementation.test_cmdline_peb_false.<locals>.<lambda>r� r; r, r, r- �test_cmdline_peb_falseJ s z4TestProcessDualImplementation.test_cmdline_peb_falseN)r� r� r� r� r� r, r, r, r- r� E s r� c @ sP e Zd ZdZdd� Ze� dd� �Ze� dd� �Ze� dd � �Ze� d
d � �Z e� d d
� �Z
e� e j j
eore�� dkdd�e j j
e dd�dd� ���Ze j j
e dd�dd� �Zdd� Ze j j
edd�dd� �Zd d � Zd d � Ze j j
ed d�d!d"� �Ze j j
e �oe j � d#� d$d�e� d%d&� ��Z e� d'd(� �Z!e� e j j
e" dd�d)d*� ��Z#e� e j j
e�one �$� d+kd,d�d-d.� ��Z%d/d0� Z&e j j
ed d�d1d2� �Z'e� e j j
e( dd�d3d4� ��Z)e� e j j
e* dd�d5d6� ��Z+e� e j j
e, dd�d7d8� ��Z-e� d9d:� �Z.d;d<� Z/d=d>� Z0e�rLd?d@� Z1dAdB� Z2dCdD� Z3dEdF� Z4dGdH� Z5dIS )J�TestModuleFunctionsLeaksz&Test leaks of psutil module functions.c C s t � }|�| |j� d S r" )r r4 r� r5 r, r, r- r7 V s z&TestModuleFunctionsLeaks.test_coveragec C s | � dd� � d S )Nc S s t jdd�S )NT��logical�rS � cpu_countr, r, r, r- rJ ^ rK z9TestModuleFunctionsLeaks.test_cpu_count.<locals>.<lambda>r� r; r, r, r- �test_cpu_count\ s z'TestModuleFunctionsLeaks.test_cpu_countc C s | � dd� � d S )Nc S s t jdd�S )NFr� r� r, r, r, r- rJ b rK z?TestModuleFunctionsLeaks.test_cpu_count_cores.<locals>.<lambda>r� r; r, r, r- �test_cpu_count_cores` s z-TestModuleFunctionsLeaks.test_cpu_count_coresc C s | � tj� d S r" )r8 rS ri r; r, r, r- rj d s z'TestModuleFunctionsLeaks.test_cpu_timesc C s | � dd� � d S )Nc S s t jdd�S )NT)Zpercpu)rS ri r, r, r, r- rJ j rK z=TestModuleFunctionsLeaks.test_per_cpu_times.<locals>.<lambda>r� r; r, r, r- �test_per_cpu_timesh s z+TestModuleFunctionsLeaks.test_per_cpu_timesc C s | � tj� d S r" )r8 rS Z cpu_statsr; r, r, r- �test_cpu_statsl s z'TestModuleFunctionsLeaks.test_cpu_stats�arm64zskipped due to #1892r@ rN c C s | � tj� d S r" )r8 rS Zcpu_freqr; r, r, r- �
test_cpu_freqp s z&TestModuleFunctionsLeaks.test_cpu_freqrc c C s t �� | �t j� d S r" )rS �
getloadavgr8 r; r, r, r- �test_getloadavgy s z(TestModuleFunctionsLeaks.test_getloadavgc C s | � tj� d S r" )r8 rS Zvirtual_memoryr; r, r, r- �test_virtual_memory� s z,TestModuleFunctionsLeaks.test_virtual_memoryz&worthless on SUNOS (uses a subprocess)c C s | � tj� d S r" )r8 rS Z swap_memoryr; r, r, r- �test_swap_memory� s z)TestModuleFunctionsLeaks.test_swap_memoryc C s$ t rtn| j}| jdd� |d� d S )Nc S s t �t�� �S r" )rS Z
pid_existsrW rX r, r, r, r- rJ � rK z:TestModuleFunctionsLeaks.test_pid_exists.<locals>.<lambda>ro �r r% r$ r8 rq r, r, r- �test_pid_exists� s z(TestModuleFunctionsLeaks.test_pid_existsc C s$ t rtn| j}| jdd� |d� d S )Nc S s
t �d�S )N�.)rS �
disk_usager, r, r, r- rJ � rK z:TestModuleFunctionsLeaks.test_disk_usage.<locals>.<lambda>ro r� rq r, r, r- �test_disk_usage� s z(TestModuleFunctionsLeaks.test_disk_usagezQEMU user not supportedc C s | � tj� d S r" )r8 rS Zdisk_partitionsr; r, r, r- �test_disk_partitions� s z-TestModuleFunctionsLeaks.test_disk_partitionsz/proc/diskstatsz3/proc/diskstats not available on this Linux versionc C s | � dd� � d S )Nc S s t jdd�S �NF)Znowrap)rS Zdisk_io_countersr, r, r, r- rJ � rK z@TestModuleFunctionsLeaks.test_disk_io_counters.<locals>.<lambda>r� r; r, r, r- �test_disk_io_counters� s z.TestModuleFunctionsLeaks.test_disk_io_countersc C s | � tj� d S r" )r8 rS Zpidsr; r, r, r- � test_pids� s z"TestModuleFunctionsLeaks.test_pidsc C s | � dd� � d S )Nc S s t jdd�S r� )rS Znet_io_countersr, r, r, r- rJ � rK z?TestModuleFunctionsLeaks.test_net_io_counters.<locals>.<lambda>r� r; r, r, r- �test_net_io_counters� s z-TestModuleFunctionsLeaks.test_net_io_countersr zneed root accessc C sD t jdd� t� � | �dd� � W d � n1 s60 Y d S )Nr� �r� c S s t jdd�S )Nr� r� )rS r� r, r, r, r- rJ � rK z?TestModuleFunctionsLeaks.test_net_connections.<locals>.<lambda>)rS r� r r8 r; r, r, r- r� � s z-TestModuleFunctionsLeaks.test_net_connectionsc C s" t rdn| j}| jtj|d� d S )Ni @ )� tolerance)r r� r8 rS Z net_if_addrs)r& r� r, r, r- �test_net_if_addrs� s z*TestModuleFunctionsLeaks.test_net_if_addrsc C s | � tj� d S r" )r8 rS Z net_if_statsr; r, r, r- �test_net_if_stats� s z*TestModuleFunctionsLeaks.test_net_if_statsc C s | � tj� d S r" )r8 rS Zsensors_batteryr; r, r, r- �test_sensors_battery� s z-TestModuleFunctionsLeaks.test_sensors_batteryc C s | � tj� d S r" )r8 rS Zsensors_temperaturesr; r, r, r- �test_sensors_temperatures� s z2TestModuleFunctionsLeaks.test_sensors_temperaturesc C s | � tj� d S r" )r8 rS Z sensors_fansr; r, r, r- �test_sensors_fans� s z*TestModuleFunctionsLeaks.test_sensors_fansc C s | � tj� d S r" )r8 rS Z boot_timer; r, r, r- �test_boot_time� s z'TestModuleFunctionsLeaks.test_boot_timec C s | � tj� d S r" )r8 rS Zusersr; r, r, r- �
test_users� s z#TestModuleFunctionsLeaks.test_usersc C s | � dd� � d S )Nc S s
t �d�S )NF)rS Z
_set_debugr, r, r, r- rJ � rK z9TestModuleFunctionsLeaks.test_set_debug.<locals>.<lambda>r� r; r, r, r- �test_set_debug� s z'TestModuleFunctionsLeaks.test_set_debugc C s | � tj� d S r" )r8 rV Zwinservice_enumerater; r, r, r- �test_win_service_iter� s z.TestModuleFunctionsLeaks.test_win_service_iterc C s d S r" r, r; r, r, r- �test_win_service_get� s z-TestModuleFunctionsLeaks.test_win_service_getc s& t t�� ��� � | �� fdd�� d S )Nc s
t �� �S r" )rV Zwinservice_query_configr, �r: r, r- rJ � rK zFTestModuleFunctionsLeaks.test_win_service_get_config.<locals>.<lambda>��nextrS Zwin_service_iterr: r8 r; r, r� r- �test_win_service_get_config� s z4TestModuleFunctionsLeaks.test_win_service_get_configc s& t t�� ��� � | �� fdd�� d S )Nc s
t �� �S r" )rV Zwinservice_query_statusr, r� r, r- rJ � rK zFTestModuleFunctionsLeaks.test_win_service_get_status.<locals>.<lambda>r� r; r, r� r- �test_win_service_get_status� s z4TestModuleFunctionsLeaks.test_win_service_get_statusc s& t t�� ��� � | �� fdd�� d S )Nc s
t �� �S r" )rV Zwinservice_query_descrr, r� r, r- rJ � rK zKTestModuleFunctionsLeaks.test_win_service_get_description.<locals>.<lambda>r� r; r, r� r- � test_win_service_get_description� s z9TestModuleFunctionsLeaks.test_win_service_get_descriptionN)6r� r� r� r� r7 r2 r� r� rj r� r� r r� r� r �platform�machiner r� r r� r� r r� r� r� r r� r rW �path�existsr� r� r r� �getuidr� r� r� r r� r r� r r� r� r� r� r� r� r� r� r� r, r, r, r- r� S s~
�
�
r� )4r� �
__future__r r/ rW r� rS Zpsutil._commonr r r r r r Zpsutil._compatr r
Z psutil.testsr r r
r r r r r r r r r r r r r r r r r r r Z _psplatformrV r^ rL r% r2 r3 r� r� r� r� r� r, r, r, r- �<module> s\
66
PK ok\�đ�&> &> 8 psutil/tests/__pycache__/test_connections.cpython-39.pycnu �[��� a
��?hS � @ s\ d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddl
Z
ddl
m Z dd l
m Z dd
l
m
Z
dd l
mZ dd l
mZ dd
l
mZ ddl
mZ ddl
mZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! dd lm"Z" dd lm#Z# dd lm$Z$ dd lm%Z% dd lm&Z& dd!lm'Z' e(ed"e)� �Z*d#d$� Z+e!j,j-d%d&�G d'd(� d(e��Z.G d)d*� d*e.�Z/e!j,j-d%d&�G d+d,� d,e.��Z0e!j,j-d%d&�G d-d.� d.e.��Z1G d/d0� d0e.�Z2e!j,j3ed1d2�G d3d4� d4e.��Z4G d5d6� d6e�Z5dS )7zFTests for psutil.net_connections() and Process.net_connections() APIs.� N)�closing)�AF_INET)�AF_INET6)�
SOCK_DGRAM)� SOCK_STREAM)�FREEBSD)�LINUX)�MACOS)�NETBSD)�OPENBSD)�POSIX)�SUNOS)�WINDOWS)�
supports_ipv6)�PY3)�AF_UNIX)�HAS_NET_CONNECTIONS_UNIX)� SKIP_SYSCONS)�PsutilTestCase)� bind_socket)�bind_unix_socket)�check_connection_ntuple)�create_sockets)�filter_proc_net_connections)�pytest)�
reap_children)�retry_on_failure)�skip_on_access_denied)�tcp_socketpair)�unix_socketpair)�
wait_for_file�SOCK_SEQPACKETc C s$ t �� j| d�}| dv r t|�S |S )N��kind)�all�unix)�psutil�Process�net_connectionsr )r# �cons� r* �I/usr/local/lib64/python3.9/site-packages/psutil/tests/test_connections.py�this_proc_net_connections2 s r, �serial)�namec @ s& e Zd Zdd� Zdd� Zd dd�ZdS )
�ConnectionTestCasec C s t dd�g ksJ �d S �Nr$ r" �r, ��selfr* r* r+ �setUp; s zConnectionTestCase.setUpc C s t dd�g ksJ �d S r0 r1 r2 r* r* r+ �tearDown> s zConnectionTestCase.tearDownr$ c sd zt j|d�}W n t jy0 tr*Y dS � Y n0 � fdd�|D �}|�� |�� ||ks`J �dS )z�Given a process PID and its list of connections compare
those against system-wide connections retrieved via
psutil.net_connections.
r" Nc s" g | ]}|j � kr|d d� �qS )N�����pid��.0�cr7 r* r+ �
<listcomp>Q � zBConnectionTestCase.compare_procsys_connections.<locals>.<listcomp>)r& r( Z AccessDeniedr �sort)r3 r8 Z proc_consr# Zsys_consr* r7 r+ �compare_procsys_connectionsB s z.ConnectionTestCase.compare_procsys_connectionsN)r$ )�__name__�
__module__� __qualname__r4 r5 r? r* r* r* r+ r/ 9 s r/ c @ s4 e Zd Zejjedd�dd� �Zdd� Zdd� Z d S )
�TestBasicOperations�
requires root��reasonc C sD t � �* tjdd�D ] }t|� qW d � n1 s60 Y d S r0 )r r& r( r �r3 �connr* r* r+ � test_systemX s z TestBasicOperations.test_systemc C sB t � �( tdd�D ] }t|� qW d � n1 s40 Y d S r0 )r r, r rG r* r* r+ � test_process^ s z TestBasicOperations.test_processc C sn t �t�� tdd� W d � n1 s*0 Y t �t�� tjdd� W d � n1 s`0 Y d S )Nz???r" )r Zraises�
ValueErrorr, r& r( r2 r* r* r+ �test_invalid_kindc s ( z%TestBasicOperations.test_invalid_kindN)
r@ rA rB r �mark�skipifr rI rJ rL r* r* r* r+ rC W s
rC c @ s� e Zd ZdZdd� Zdd� Zdd� Zejj e
� dd �d
d � �Z d d
� Z ejj e
� dd �dd� �Z
ejj e dd �dd� �Zejj e dd �dd� �ZdS )�TestUnconnectedSocketsz;Tests sockets which are open but not connected to anything.c C st t dd�}tdd� |D ��}ts$tr0||�� S t|�dks@J �|d jdkrh||�� j|�� kshJ �|d S d S )Nr$ r" c S s g | ]}|j |f�qS r* )�fdr9 r* r* r+ r< p r= z=TestUnconnectedSockets.get_conn_from_sock.<locals>.<listcomp>� r r6 )r, �dictr
r �fileno�lenrP )r3 �sockr) Zsmapr* r* r+ �get_conn_from_sockn s
z)TestUnconnectedSockets.get_conn_from_sockc C s� | � |�}t|� |jdkr.|j|�� ks.J �|j|jks>J �|j|�tjtj �ksXJ �|�
� }|szt rzt |t
�rz|�� }|jtkr�|dd� }|j|ks�J �|jtkr�tr�tdd�}| jt�� |dd� |S )z�Given a socket, makes sure it matches the one obtained
via psutil. It assumes this process created one connection
only (the one supposed to be checked).
r6 N� r$ r" )rV r rP rS �family�type�
getsockopt�socket�
SOL_SOCKET�SO_TYPE� getsocknamer �
isinstance�bytes�decoder �laddrr r r, r? �os�getpid)r3 rU rH rb r) r* r* r+ � check_socket{ s
z#TestUnconnectedSockets.check_socketc C sb d}t ttt|d���8}| �|�}|jdks0J �|jtjks@J �W d � n1 sT0 Y d S �N�� 127.0.0.1r ��addrr* ) r r r r re �raddr�statusr& � CONN_LISTEN�r3 rj rU rH r* r* r+ � test_tcp_v4� s
z"TestUnconnectedSockets.test_tcp_v4zIPv6 not supportedrE c C sb d}t ttt|d���8}| �|�}|jdks0J �|jtjks@J �W d � n1 sT0 Y d S �N)�::1r ri r* ) r r r r re rk rl r& rm rn r* r* r+ � test_tcp_v6� s
z"TestUnconnectedSockets.test_tcp_v6c C sb d}t ttt|d���8}| �|�}|jdks0J �|jtjks@J �W d � n1 sT0 Y d S rf ) r r r r re rk rl r& � CONN_NONErn r* r* r+ � test_udp_v4� s
z"TestUnconnectedSockets.test_udp_v4c C sb d}t ttt|d���8}| �|�}|jdks0J �|jtjks@J �W d � n1 sT0 Y d S rp ) r r r r re rk rl r& rs rn r* r* r+ � test_udp_v6� s
z"TestUnconnectedSockets.test_udp_v6�
POSIX onlyc C sd | � � }tt|td���8}| �|�}|jdks2J �|jtjksBJ �W d � n1 sV0 Y d S �N)rY � � �
get_testfnr r r re rk rl r& rs �r3 �testfnrU rH r* r* r+ �
test_unix_tcp� s
z$TestUnconnectedSockets.test_unix_tcpc C sd | � � }tt|td���8}| �|�}|jdks2J �|jtjksBJ �W d � n1 sV0 Y d S rw ry r{ r* r* r+ �
test_unix_udp� s
z$TestUnconnectedSockets.test_unix_udpN)r@ rA rB �__doc__rV re ro r rM rN r rr rt ru r r} r~ r* r* r* r+ rO j s
rO c @ sB e Zd ZdZejjedd�dd� �Zejje dd�dd� �Z
d S )
�TestConnectedSocketzFTest socket pairs which are actually connected to
each other.
zunreliable on SUONSrE c C s� d}t dd�g ksJ �tt|d�\}}zVt dd�}t|�dksBJ �|d jtjksVJ �|d jtjksjJ �W |�� |�� n|�� |�� 0 d S )Nrg �tcp4r" ri rW r rQ )r, r r rT rl r& ZCONN_ESTABLISHED�close)r3 rj �server�clientr) r* r* r+ �test_tcp� s
�z TestConnectedSocket.test_tcprv c C s | � � }t|�\}}z�tdd�}|d jr<|d jr<J |��|d jrX|d jrXJ |��ts`trndd� |D �}t|�dks~J �ts�ts�t s�t
r�|d jdks�J �|d jdks�J �||d jp�|d jks�J �n |d jp�|d j|ks�J �W |� � |� � n|� � |� � 0 d S ) Nr% r" r rQ c S s g | ]}|j d kr|�qS )z /var/run/log)rk r9 r* r* r+ r< � r= z1TestConnectedSocket.test_unix.<locals>.<listcomp>rW rx ) rz r r, rb rk r
r rT r r
r r� )r3 r| r� r� r) r* r* r+ � test_unix� s$
�z TestConnectedSocket.test_unixN) r@ rA rB r r rM rN r
r� r r� r* r* r* r+ r� � s
r� c @ s. e Zd Zdd� Zeed�dd� �Zdd� ZdS ) � TestFiltersc C s� dd� }t � �� |dtttgtttg� |dttgttg� |dtgttg� |dttgtg� |dtgtg� |dtgtg� |d ttgtg� |d
tgtg� |d tgtg� tr�|d tgtttg� W d � n1 s�0 Y d S )
Nc S sb t | d�D ] }|j|v s J �|j|v s
J �q
ts^tj| d�D ] }|j|v sNJ �|j|v s<J �q<d S )Nr" )r, rX rY r r& r( )r# �families�typesrH r* r* r+ �check s z'TestFilters.test_filters.<locals>.checkr$ �inet�inet4�tcpr� �tcp6�udp�udp4�udp6r% )r r r r r r r! r )r3 r� r* r* r+ � test_filters s* ��zTestFilters.test_filters)Zonly_ifc s� t � � fdd�}t�d�}t�d�}tj�� jt�� d��}|jt t
�d|d�}|jt t
�d|d�}|jt t �d|d�}|jt t �d|d�}� � |�} t
t|d d
��}
� � |�} t
t|d d
��} t� r�� � |�}
t
t|d d
��}� � |�}t
t|d d
��}nd }
d }d }d }t�� �� D ]�}|�� }t|�d k�s8J �|D ]�}|j| jk�rh|||t
t|
d tjd
� n�|j| jk�r�|||t
t| d tjd� nZ|jt|
dd �k�r�|||t t|d tjd� n,|jt|dd �k�r<|||t t|d tjd� �q<�qd S )Nc s� d}t |� |j|ksJ �|j|ks(J �|j|ks6J �|j|ksDJ �|j|ksRJ �|D ]2} | j| d�}
| |v r||
g ks�J �qV|
g ksVJ �qVtr�� �| j |g� d S )N)
r$ r� r� �inet6r� r� r� r� r� r� r" )
r rX rY rb rk rl r( r r? r8 ) �procrH rX rY rb rk rl �kindsZ all_kindsr# r) r2 r* r+ �
check_conn$ s z+TestFilters.test_combos.<locals>.check_conna4
import socket, time
s = socket.socket({family}, socket.SOCK_STREAM)
s.bind(('{addr}', 0))
s.listen(5)
with open('{testfn}', 'w') as f:
f.write(str(s.getsockname()[:2]))
[time.sleep(0.1) for x in range(100)]
a
import socket, time
s = socket.socket({family}, socket.SOCK_DGRAM)
s.bind(('{addr}', 0))
with open('{testfn}', 'w') as f:
f.write(str(s.getsockname()[:2]))
[time.sleep(0.1) for x in range(100)]
)�dirrh )rX rj r| rq T)�deleterQ r* )r$ r� r� r� r� )r$ r� r� r� r� r8 )r$ r� r� r� r� )r$ r� r� r� r� )r �textwrap�dedentrc �path�basenamerz �getcwd�format�intr r �pyrun�evalr r r& r' �childrenr( rT r8 r rm r rs �getattr)r3 r� Z tcp_templateZ udp_templateZtestfileZ
tcp4_templateZ
udp4_templateZ
tcp6_templateZ
udp6_templateZ tcp4_procZ tcp4_addrZ udp4_procZ udp4_addrZ tcp6_procZ tcp6_addrZ udp6_procZ udp6_addr�pr) rH r* r2 r+ � test_combos s�
�
�
�
�
� � � �zTestFilters.test_combosc C s� t � ��� tdd�}t|�t� r$dndks.J �|D ]$}|jttfv sHJ �|jtks2J �q2tdd�}t|�dksrJ �|d jtks�J �|d jtks�J �t� r�tdd�}t|�dks�J �|d jtks�J �|d jtks�J �tdd�}t|�t� r�dndks�J �|D ]*}|jttfv �sJ �|jt k�sJ ��qtd d�}t|�dk�sJJ �|d jtk�s^J �|d jt k�srJ �t� �r�td
d�}t|�dk�s�J �|d jtk�s�J �|d jt k�s�J �td d�}t|�t� �r�d ndk�s�J �|D ].}|jttfv �sJ �|jtt fv �s�J ��q�t� �rntd
d�}t|�dk�s>J �|D ]*}|jtk�sVJ �|jtt fv �sBJ ��qBt
�r�t �s�t �s�tdd�}t|�dk�s�J �|D ]*}|jt
k�s�J �|jtt fv �s�J ��q�W d � n1 �s�0 Y d S )Nr� r" rW rQ r� r r� r� r� r� r� � r� r% � )r r, rT r rX r r rY r r r r r
r )r3 r) rH r* r* r+ �
test_count� s\
zTestFilters.test_countN)r@ rA rB r� r r r� r� r* r* r* r+ r� s
r� rD rE c @ s& e Zd ZdZdd� Ze� dd� �ZdS )�TestSystemWideConnectionsz Tests for net_connections().c C s� dd� }t � �r ddlm} |�� D ]L\}}|dkr:ts:q$|\}}t�|�}t|�tt|��ksdJ �||||� q$W d � n1 s�0 Y d S )Nc S s< | D ]2}|j |v sJ �|j tkr.|j|v s.J �t|� qd S )N)rX r rY r )r) r� �types_rH r* r* r+ r� � s
z0TestSystemWideConnections.test_it.<locals>.checkr )� conn_tmapr% ) r �psutil._commonr� �itemsr r& r( rT �set)r3 r� r� r# �groupsr� r� r) r* r* r+ �test_it� s
z!TestSystemWideConnections.test_itc s� t � �}t|�}W d � n1 s$0 Y g �d}g }t|�D ]:}| �� }|�|� t�d| �}| �|�}��|j� qB|D ] }t |� q��fdd�t
j dd�D �} �D ]B� t� fdd�| D ��|ks�J �t
� � �}
t|
� d��|ks�J �q�d S )N�
a" import time, os
from psutil.tests import create_sockets
with create_sockets():
with open(r'%s', 'w') as f:
f.write("hello")
[time.sleep(0.1) for x in range(100)]
c s g | ]}|j � v r|�qS r* r7 �r: �x)�pidsr* r+ r< s zFTestSystemWideConnections.test_multi_sockets_procs.<locals>.<listcomp>r$ r" c s g | ]}|j � kr|�qS r* r7 r� r7 r* r+ r< ! r= )
r rT �rangerz �appendr� r� r� r8 r r& r( r' ) r3 �socks�expected�times�fnames�_�fname�srcZsprocZsysconsr� r* )r8 r� r+ �test_multi_sockets_procs� s, &
�
�
z2TestSystemWideConnections.test_multi_sockets_procsN)r@ rA rB r r� r r� r* r* r* r+ r� � s r� c @ s e Zd Zdd� ZdS )�TestMiscc C s� g }g }t t�D ]\}|�d�rtt|�}t|�}|�� s@J |��t|vsLJ �||vsXJ �|�|� |�|� qtr~tj tj t
r�tj d S )NZCONN_) r� r& �
startswithr� �str�isupperr� r
Z CONN_IDLEZ
CONN_BOUNDr ZCONN_DELETE_TCB)r3 Zints�strsr. �numZstr_r* r* r+ � test_net_connection_constants' s
z&TestMisc.test_net_connection_constantsN)r@ rA rB r� r* r* r* r+ r� & s r� )6r rc r[ r� �
contextlibr r r r r r& r r r r
r r r
r r� r Zpsutil._compatr Z psutil.testsr r r r r r r r r r r r r r r r r� �objectr! r, rM Z xdist_groupr/ rC rO r� r� rN r� r� r* r* r* r+ �<module> sb ] 7 g?PK ok\����7 �7 2 psutil/tests/__pycache__/test_posix.cpython-39.pycnu �[��� a
��?h D � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlmZ ddlm Z ddlm
Z
ddlm Z ddlm Z ddlm
Z
dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z e
�rNddl Z ddl Z ddl m Z d,dd�Z!dd� Z"d d � Z#d d � Z$d d!� Z%d"d#� Z&ej'j(e
d$d%�G d&d'� d'e��Z)ej'j(e
d$d%�G d(d)� d)e��Z*ej'j(e
d$d%�G d*d+� d+e��Z+dS )-zPOSIX specific tests.� N)�AIX)�BSD)�LINUX)�MACOS)�OPENBSD)�POSIX)�SUNOS)�AARCH64)�HAS_NET_IO_COUNTERS)�
PYTHON_EXE)� QEMU_USER)�PsutilTestCase)�mock)�pytest)�retry_on_failure)�sh)�skip_on_access_denied)�spawn_testproc)� terminate)�which)� getpagesizec C s� dg}t r|�d� |dur0|�dt|�g� n ts8trD|�d� n
|�d� tr^| �dd�} |�d | g� t|�}t r�|�� n|�� d
d� }g }|D ]6}|� � }z t
|�}W n t y� Y n0 |�|� q�|du r�|S |d S dS ) zwWrapper for calling the ps command with a little bit of cross-platform
support for a narrow range of features.
�psz --no-headersNz-pz-A�ax�startZstimez-o� r ) r �append�extend�strr r �replacer �
splitlines�strip�int�
ValueError)�fmt�pid�cmd�output�
all_output�line� r) �C/usr/local/lib64/python3.9/site-packages/psutil/tests/test_posix.pyr / s0
r c C s> d}t r d}t|| ��� }tr6d|d v s.J �|d S |d S )N�commandZcommz
/bin/qemu-r r )r r �splitr )r$ �fieldr+ r) r) r* �ps_nameg s r. c C s0 d}t s trd}t|| �}t�dd|�}|�� S )Nr+ �argsz\(python.*?\)$� )r r r �re�subr )r$ r- �outr) r) r* �ps_argsr s
r4 c C s d}t r d}t|| �S )NZrssZrssize�r r �r$ r- r) r) r* �ps_rss| s r7 c C s d}t r d}t|| �S )NZvszZvsizer5 r6 r) r) r* �ps_vsz� s r8 c
C s� zt d| ��� }W n@ tyT } z(dt|��� v r>t�d��� W Y d }~n
d }~0 0 |�d�d }|�� }t|d �d }t|d �d }t|d �d }t |d �
d
d ��}||||fS ) Nzdf -k %sz device busyzdf returned EBUSY�
r � � � � �%r0 ) r r � RuntimeErrorr �lowerr �skipr, r! �floatr ) �devicer3 �errr( �fields� sys_total�sys_used�sys_free� sys_percentr) r) r* �df� s
rJ z
POSIX only��reasonc @ s� e Zd ZdZedd� �Zedd� �Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z e � e
� dd� ��Ze � e
� dd� ��Zdd� Zdd� Zdd� Zdd� Zejjep�ed d �d d � �Zd d!� Ze
� d"d#� �Zejje d$d �ejje d%d �d&d'� ��Z d(S ))� TestProcesszBCompare psutil results against 'ps' command line utility (mainly).c C s t tddgtjd�j| _d S )Nz-Ez-O)�stdin)r r �
subprocess�PIPEr$ ��clsr) r) r* �
setUpClass� s �zTestProcess.setUpClassc C s t | j� d S �N)r r$ rQ r) r) r* �
tearDownClass� s zTestProcess.tearDownClassc C s, t d| j�}t�| j��� }||ks(J �d S )N�ppid)r r$ �psutil�ProcessrV )�selfZppid_psZ ppid_psutilr) r) r* � test_ppid� s zTestProcess.test_ppidc C s. t d| j�}t�| j��� j}||ks*J �d S )N�uid)r r$ rW rX �uids�real)rY Zuid_psZ
uid_psutilr) r) r* �test_uid� s zTestProcess.test_uidc C s. t d| j�}t�| j��� j}||ks*J �d S )NZrgid)r r$ rW rX �gidsr] )rY Zgid_psZ
gid_psutilr) r) r* �test_gid� s zTestProcess.test_gidc C s, t d| j�}t�| j��� }||ks(J �d S )N�user)r r$ rW rX �username)rY Z username_psZusername_psutilr) r) r* �
test_username� s zTestProcess.test_usernamec C s^ t �� }tjdtd��4}|�� t|�� j�ks2J �|j s<J �W d � n1 sP0 Y d S )Nzpsutil.pwd.getpwuid�Z side_effect)
rW rX r �patch�KeyErrorrb r r\ r] �called)rY �pZfunr) r) r* �test_username_no_resolution� s z'TestProcess.test_username_no_resolutionc C s< t �d� t| j�}t�| j��� d d }||ks8J �d S )N皙�����?r r: )�time�sleepr7 r$ rW rX � memory_info)rY Zrss_psZ
rss_psutilr) r) r* �test_rss_memory� s
zTestProcess.test_rss_memoryc C s< t �d� t| j�}t�| j��� d d }||ks8J �d S )Nrj r r: )rk rl r8 r$ rW rX rm )rY Zvsz_psZ
vsz_psutilr) r) r* �test_vsz_memory� s
zTestProcess.test_vsz_memoryc C sv t | j�}tj�|��� }t�| j��� �� }t �
dd|�}t �
dd|�}t �
dd|�}t �
dd|�}||ksrJ �d S )Nz\d.\dr0 z\d) r. r$ �os�path�basenamer@ rW rX �namer1 r2 )rY Zname_psZ name_psutilr) r) r* � test_name� s
zTestProcess.test_namec C s� d}g d�}t jd|d��V t jd|d��( t�� }|�� dksDJ �W d � n1 sX0 Y W d � n1 sv0 Y d S )N�long-program-name)�long-program-name-extendedZfoo�bar� psutil._psplatform.Process.name�Z return_value�"psutil._psplatform.Process.cmdlinerv )r re rW rX rs )rY rs �cmdlinerh r) r) r* �test_name_long� s �zTestProcess.test_name_longc C s� d}t jd|d��^ t jdt�dd�d��( t�� }|�� dksDJ �W d � n1 sX0 Y W d � n1 sv0 Y d S �Nru rx ry rz r r0 rd )r re rW Z AccessDeniedrX rs �rY rs rh r) r) r* � test_name_long_cmdline_ad_exc� s
�z)TestProcess.test_name_long_cmdline_ad_excc
C s� d}t jd|d��� t jdt�dd�d��L t�� }t�tj�� |�� W d � n1 s^0 Y W d � n1 s|0 Y W d � n1 s�0 Y d S r} )r re rW Z
NoSuchProcessrX r �raisesrs r~ r) r) r* � test_name_long_cmdline_nsp_exc s
�z*TestProcess.test_name_long_cmdline_nsp_exczps -o start not availablerK c C s\ t d| j�}t�| j��� }tj�|��d�}t|�}tj�|��d�}|||fv sXJ �d S )Nr z%H:%M:%S) r r$ rW rX Z create_time�datetime�
fromtimestamp�strftime�round)rY Ztime_psZ time_psutilZtime_psutil_tstampZround_time_psutilZround_time_psutil_tstampr) r) r* �test_create_time s ����z TestProcess.test_create_timec C s^ t | j�}t�| j��� }z||ks(J �W n. tyX |d t|�� }||ksTJ �Y n0 d S rT )r. r$ rW rX Zexe�AssertionError�len)rY Z ps_pathnameZpsutil_pathnameZadjusted_ps_pathnamer) r) r* �test_exe s
zTestProcess.test_exec C sT t | j�}d�t�| j��� �}trDt|�t|�k rD|�|�sPJ �n ||ksPJ �d S )N� ) r4 r$ �joinrW rX r{ r r� �
startswith)rY Z
ps_cmdlineZpsutil_cmdliner) r) r* � test_cmdline1 s
zTestProcess.test_cmdlineznot reliable on SUNOSznot reliable on AIXc C s( t d| j�}t�� �� }||ks$J �d S )N�nice)r r$ rW rX r� )rY Zps_niceZ psutil_nicer) r) r* � test_nice? s zTestProcess.test_niceN) �__name__�
__module__� __qualname__�__doc__� classmethodrS rU rZ r^ r` rc ri r r rn ro rt r| r r� r �mark�skipifr r r� r� r� r r r� r) r) r) r* rM � s8
rM c @ s� e Zd ZdZe� dd� �Zejje dd�ejje
d� dd�ejje dd�d d
� ���Z e� d d � �Z
e� d
d� �Zdd� Zdd� Zdd� Zdd� Zejjedd�e� dd� ��ZdS )�TestSystemAPIszTest some system APIs.c s~ t td��� t�� �ts$tr0d� vr0� �dd� t� �t�� dkrz� fdd��D ��fdd�� D � }| �dt |� ��d S )Nr$ r r c s g | ]}|� vr|�qS r) r) ��.0�x)�pids_psr) r* �
<listcomp>X � z,TestSystemAPIs.test_pids.<locals>.<listcomp>c s g | ]}|� vr|�qS r) r) r� )� pids_psutilr) r* r� X s z difference: )
�sortedr rW Zpidsr r �insertr� �failr )rY �
differencer) )r� r� r* � test_pidsK s �zTestSystemAPIs.test_pidszunreliable on SUNOSrK �ifconfigzno ifconfig cmdz
not supportedc C sL t d�}tjdd�D ]2}|�� D ]}|�|�r qq | �d||f ��qd S )Nz ifconfig -aT)Zpernicz/couldn't find %s nic in 'ifconfig -a' output
%s)r rW Znet_io_countersr, r� r� )rY r& Znicr( r) r) r* �test_nic_names_ s
��z TestSystemAPIs.test_nic_namesc C s� t d�}|�� st�d��|�d�}dd� |D �}dd� |D �}t|�tt�� �ksXJ �| jt�� |d��` t t�� �D ]B\}}|j
|| ks�J �|j || ks�J �|j d urxt�
|j � qxW d � n1 s�0 Y d S )N�who -u�no users on this systemr9 c S s g | ]}|� � d �qS )r �r, r� r) r) r* r� v r� z-TestSystemAPIs.test_users.<locals>.<listcomp>c S s g | ]}|� � d �qS )r r� r� r) r) r* r� w r� �rW Zwho)r r r rA r, r� rW �users�subTest� enumeraters Zterminalr$ rX )rY r3 �linesr� Z terminals�idx�ur) r) r* �
test_usersp s
zTestSystemAPIs.test_usersc C s t d�}|�� st�d��d }t�d|�}|r4d}nNt�d|�}|rJd}n8t�d|�}|r`d}n"t�d |�}|r�d}d
d � |D �}|s�t�d | ��| jt�� |d
��J t t�� �D ],\}}t
j
� |j ��
|�}||| ks�J �q�W d � n1 s�0 Y d S )Nr� r� z \d\d\d\d-\d\d-\d\d \d\d:\d\dz%Y-%m-%d %H:%Mz [A-Z][a-z][a-z] \d\d \d\d:\d\dz %b %d %H:%Mz[A-Z][a-z][a-z] \d\dz%b %dz[a-z][a-z][a-z] \d\dc S s g | ] }|� � �qS r) )�
capitalizer� r) r) r* r� � r� z5TestSystemAPIs.test_users_started.<locals>.<listcomp>z(cannot interpret tstamp in who output
%sr� )r r r rA r1 �findallr� rW r� r� r� r� �startedr� )rY r3 Ztstampr� r� r� Z psutil_valuer) r) r* �test_users_started� s:
���z!TestSystemAPIs.test_users_startedc C s~ t jdttjd�d��T}t�t�� tj� t
� � � W d � n1 sH0 Y |j s\J �W d � n1 sp0 Y d S )Nzpsutil._psposix.os.killr0 rd )
r re �OSError�errno�EBADFr r� rW �_psposixZ
pid_existsrp �getpidrg �rY �mr) r) r* �test_pid_exists_let_raise� s � .z(TestSystemAPIs.test_pid_exists_let_raisec C s~ t jdttjd�d��T}t�t�� tj� t
� � � W d � n1 sH0 Y |j s\J �W d � n1 sp0 Y d S )N�psutil._psposix.os.waitpidr0 rd )
r re r� r� r� r r� rW r� �wait_pidrp r� rg r� r) r) r* �test_os_waitpid_let_raise� s � .z(TestSystemAPIs.test_os_waitpid_let_raisec C s� t jdttjd�d��\}t�tjj ��$ tjj
t � � dd� W d � n1 sP0 Y |j
sdJ �W d � n1 sx0 Y d S )Nr� r0 rd g{�G�z�?)�timeout)r re r� r� ZEINTRr r� rW r� �TimeoutExpiredr� rp r� rg r� r) r) r* �test_os_waitpid_eintr� s �2z$TestSystemAPIs.test_os_waitpid_eintrc C sv t jddd��T}t�t�� tj�t� � � W d � n1 s@0 Y |j
sTJ �W d � n1 sh0 Y d S )Nr� )r ���ry ) r re r r� r" rW r� r� rp r� rg r� r) r) r* � test_os_waitpid_bad_ret_status� s � .z-TestSystemAPIs.test_os_waitpid_bad_ret_statuszunreliable on AIXc C s� d}t jdd�D ]�}t �|j�}zt|j�\}}}}W nV ty� } z>t|��� }d|v sjd|v sjd|v rvW Y d }~q� W Y d }~qd }~0 0 t |j
| �|k s�J �t |j | �|k s�J �t |j | �|k s�J �t |j
| �dksJ �qd S )Ni @ F)�allzno such file or directoryzraw devices not supportedzpermission deniedr )rW Zdisk_partitions�
disk_usageZ
mountpointrJ rC r? r r@ �abs�total�used�free�percent) rY Z tolerance�part�usagerF rG rH rI rD r) r) r* �test_disk_usage� s& ��� z TestSystemAPIs.test_disk_usageN)r� r� r� r� r r� r r� r� r r r
r� r� r� r� r� r� r� r r� r) r) r) r* r� G s$
&
r� c @ s e Zd Zdd� ZdS )�TestMiscc C s4 t � }|dksJ �|t� � ks"J �|tjks0J �d S )Nr )r �resource�mmapZPAGESIZE)rY Zpagesizer) r) r* �test_getpagesize� s zTestMisc.test_getpagesizeN)r� r� r� r� r) r) r) r* r� � s r� )N),r� r� r� rp r1 rO rk rW r r r r r r r Z psutil.testsr r
r r r
r r r r r r r r r� r� Zpsutil._psutil_posixr r r. r4 r7 r8 rJ r� r� rM r� r� r) r) r) r* �<module> sZ
8
- #PK ok\v�b�? �? 8 psutil/tests/__pycache__/test_process_all.cpython-39.pycnu �[��� a
��?h�H � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddlm Z ddlm
Z
ddlm Z ddlm Z ddlm
Z
ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# e �o�e �o�e Z$d d � Z%G d d � d e �Z&G d d!� d!e �Z'dS )"zeIterate over all process PIDs and for each one of them invoke and
test all psutil.Process() methods.
� N)�AIX)�BSD)�FREEBSD)�LINUX)�MACOS)�NETBSD)�OPENBSD)�OSX)�POSIX)�WINDOWS)�PY3)�FileNotFoundError)�long)�unicode)�
CI_TESTING)�PYTEST_PARALLEL)� QEMU_USER)�VALID_PROC_STATUSES)�PsutilTestCase)�check_connection_ntuple)�create_sockets)�
is_namedtuple)�is_win_secure_system_proc)�process_namespace)�pytestc s* t � ���fdd�� � ����fdd�}zt����W n" tjyX ���� i Y S 0 z��ddg�}W n tjy� ���� Y n�0 |d |d ��d�ji}t��}|j |j
dd �D ]Z\}}z|� ||< W q� tj �y } z&� |���� W Y d }~q�W Y d }~q�d }~0 0 q�|� |S d S )
Nc s� �� | j� � | jd ur&�� | j|� t| tj�rd��|� | jd urz��| jd� �� | j|� nt| tj �rz��
|� t | � t | � d S �Nr )
� assertEqual�pid�name�
isinstance�psutilZ
ZombieProcessZassertProcessZombie�ppidZassertGreaterEqual�
NoSuchProcess�assertProcessGone�str�repr)�exc�procr r! )r �tcase� �I/usr/local/lib64/python3.9/site-packages/psutil/tests/test_process_all.py�check_exception7 s
z"proc_info.<locals>.check_exceptionc
sP �dkrLz�� d� W n4 tjyJ } z� | ���� W Y d } ~ n
d } ~ 0 0 d S r )�waitr �Error)r& )r+ r r r! r' r) r* �do_waitE s
zproc_info.<locals>.do_waitr! r r F)� clear_cache) r r �Processr" Z
assertPidGoneZas_dictr# r r �iterZgettersr- )r r. �d�info�nsZfunZfun_namer& r) )r+ r r r! r' r( r* � proc_info4 s.
$r5 c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!d>d?� Z"d@dA� Z#dBdC� Z$dDdE� Z%dFdG� Z&dHdI� Z'dJdK� Z(dLS )M�TestFetchAllProcessesz�Test which iterates over all running processes and performs
some sanity checks against Process API's returned values.
Uses a process pool to get info about all processes.
c C s t �d� trt�� | _d S �NF)r �
_set_debug�
USE_PROC_POOL�multiprocessingZPool�pool��selfr) r) r* �setUpk s
zTestFetchAllProcesses.setUpc C s& t �d� tr"| j�� | j�� d S �NT)r r8 r9 r; � terminate�joinr< r) r) r* �tearDownr s
z TestFetchAllProcesses.tearDownc C sJ ddl m} tr"| j�|t�� �S g }t�� D ]}|�||�� q.|S d S )Nr )r5 )Z psutil.tests.test_process_allr5 r9 r; Zimap_unorderedr �pids�append)r= r5 Zlsr r) r) r* �iter_proc_infox s z$TestFetchAllProcesses.iter_proc_infoc C s� g }| � � D ]�}|�� D ]�\}}t| |�}z|||� W np ty� d}|d||d t|�|f 7 }|d7 }|dt�� 7 }d�dd� |�� D ��d }|� |� Y q0 |d d
g d d i fvr|sJ |��qq |r�| �
d �|���d S ) NzH
======================================================================
z+FAIL: name=test_%s, pid=%s, ret=%s
info=%s
r zF----------------------------------------------------------------------z
%s�
c s s | ]}d | V qdS )z Nr) )�.0�ir) r) r* � <genexpr>� � z1TestFetchAllProcesses.test_all.<locals>.<genexpr>r � � ) rE �items�getattr� Exceptionr% � traceback�
format_excrA �
splitlinesrD Zfail)r= Zfailuresr3 r �value�meth�sr) r) r* �test_all� s,
� z TestFetchAllProcesses.test_allc C s* t |t�sJ �|D ]}t |t�sJ �qd S �N)r �listr$ )r= �retr3 �partr) r) r* �cmdline� s z TestFetchAllProcesses.cmdlinec C s� t |ttf�sJ �|�� |ks"J �|r�tr8|�d�s8d S tj�|�sLJ |��t r�tj�
|�r�t td�r�t td�r�zt� |tj
�s�J �W n$ ty� tj�|�r�ts�� Y n0 d S )Nz.exe�access�X_OK)r r$ r �stripr �endswith�os�path�isabsr
�isfile�hasattrr\ r] �AssertionError�existsr �r= rY r3 r) r) r* �exe� s zTestFetchAllProcesses.exec C s t |t�sJ �|dksJ �d S r �r �intrg r) r) r* r � s zTestFetchAllProcesses.pidc C s* t |ttf�sJ �|dks J �t|� d S r )r rj r r5 rg r) r) r* r! � s zTestFetchAllProcesses.ppidc C sB t |ttf�sJ �tr*|s*t|d �r*d S ts>|s>J t|���d S )Nr )r r$ r r r r r% rg r) r) r* r � s
zTestFetchAllProcesses.namec C s^ t |t�sJ �z|dks J �W n( tyF tr@|d tjkr@n� Y n0 t�dt�|�� d S )Nr �statusz%Y %m %d %H:%M:%S) r �floatre r r Z
STATUS_ZOMBIE�time�strftime� localtimerg r) r) r* � create_time� s z!TestFetchAllProcesses.create_timec C s4 t |�s J �|D ] }t|t�s"J �|dksJ �qd S r )r r rj )r= rY r3 �uidr) r) r* �uids� s zTestFetchAllProcesses.uidsc C s< t |�s J �|D ]&}t|t�s"J �tsts|dksJ �qd S r )r r rj r r )r= rY r3 �gidr) r) r* �gids� s
zTestFetchAllProcesses.gidsc C s. t |t�sJ �|�� |ks J �|�� s*J �d S rW )r r$ r^ rg r) r) r* �username� s z TestFetchAllProcesses.usernamec C s> t |t�sJ �|sJ |��tr"d S |dks.J �|tv s:J �d S )N�?)r r$ r r rg r) r) r* rk � s z TestFetchAllProcesses.statusc C s@ t |�s J �|D ]*}t|ttf�s&J �|dkr|dksJ �qd S )N���r �r r rj r )r= rY r3 �fieldr) r) r* � io_counters� s
z!TestFetchAllProcesses.io_countersc C s� t rBt|jt�sJ �t|jt�s$J �|jdks2J �|jdks|J �n:tjtjtjtj g}t|t�sdJ �|dkspJ �||v s|J �d S r )
r r Zioclassrj rS r ZIOPRIO_VERYLOWZ
IOPRIO_LOWZ
IOPRIO_NORMALZ IOPRIO_HIGH)r= rY r3 �choicesr) r) r* �ionice� s � z TestFetchAllProcesses.ionicec C s: t |t�sJ �tr*|dkr*t|d �r*d S |dks6J �d S )Nr r � )r rj r r rg r) r) r* � num_threads
s z!TestFetchAllProcesses.num_threadsc C sn t |t�sJ �|D ]V}t|�s"J �|jdks0J �|jdks>J �|jdksLJ �|D ]}t |ttf�sPJ �qPqd S r )r rX r �idZ user_timeZ system_timerj rl )r= rY r3 �try r) r) r* �threads s z TestFetchAllProcesses.threadsc C s4 t |�s J �|D ] }t|t�s"J �|dksJ �qd S r )r r rl )r= rY r3 �nr) r) r* � cpu_times s z TestFetchAllProcesses.cpu_timesc C s0 t |t�sJ �d| kr"dks,n J |��d S )NrK g Y@�r rl rg r) r) r* � cpu_percent% s z!TestFetchAllProcesses.cpu_percentc C s^ t |t�sJ �tr |dkr d S |dks*J �t�� dkrB|dksBJ �|ttt�� ��v sZJ �d S )Nrw r r} )r rj r r � cpu_countrX �rangerg r) r) r* �cpu_num) s z TestFetchAllProcesses.cpu_numc C s| t |�s J �|D ]"}t|ttf�s&J �|dksJ �qtrx|j|jksHJ �|j|jksXJ �|j |j
kshJ �|j |j ksxJ �d S r )
r r rj r r Z peak_wsetZwsetZpeak_paged_poolZ
paged_poolZpeak_nonpaged_poolZ
nonpaged_poolZ
peak_pagefileZpagefile�r= rY r3 rS r) r) r* � memory_info2 s z!TestFetchAllProcesses.memory_infoc C s� t |�s J �t�� j}|jD ]N}t||�}t|ttf�s<J �|dksHJ �t s t
rZ|dv rZq ||ks J |��q t r�|j |j ks�J �d S )Nr )Zvms�data)
r r Zvirtual_memory�total�_fieldsrN r rj r r r ZpssZuss)r= rY r3 r� r rS r) r) r* �memory_full_info= s
z&TestFetchAllProcesses.memory_full_infoc C s" t |t�sJ �|D �]}t |jt�s(J �t |jt�s8J �|j�� |jksLJ �tr`|jdks�J �nltr�t |j t�stJ �t |j
t�s�J �t |j t�s�J �|j dks�J �|j
dv s�J �|j dks�J �n t r�|js�qt
j�|j�s�J |��zt
�|j�}W n t�y Y q0 t�|j�sJ |��qd S )Nrw r )�r�w�azr+za+)r rX �fdrj ra r$ r^ r r �position�mode�flagsr r` rb �statr
�S_ISREG�st_mode)r= rY r3 �f�str) r) r* �
open_filesM s,
z TestFetchAllProcesses.open_filesc C s t |t�sJ �|dksJ �d S r ri rg r) r) r* �num_fdsg s z TestFetchAllProcesses.num_fdsc C s` t � �F t|�tt|��ks J �|D ]}t|�s4J �t|� q$W d � n1 sR0 Y d S rW )r �len�setr r )r= rY r3 �connr) r) r* �net_connectionsk s
z%TestFetchAllProcesses.net_connectionsc
C s� t |ttf�sJ �|�� |ks"J �|r�tj�|�s:J |��zt�|�}W nD ty� } z,t rjt
j � |�rjn|j
t
jkrx� W Y d }~nd }~0 0 t�|j�s�J �d S rW )r r$ r r^ r` ra rb r� �OSErrorr r Z _psplatformZis_permission_err�errno�ENOENT�S_ISDIRr� )r= rY r3 r� �errr) r) r* �cwdr s zTestFetchAllProcesses.cwdc C s0 t |t�sJ �d| kr"dks,n J |��d S )Nr �d r� rg r) r) r* �memory_percent� s z$TestFetchAllProcesses.memory_percentc C s t |t�sJ �d S rW )r �boolrg r) r) r* �
is_running� s z TestFetchAllProcesses.is_runningc C sR t |t�sJ �|g ksJ �ttt�� ��}|D ] }t |t�s@J �||v s.J �q.d S rW )r rX r� r r� rj )r= rY r3 Zcpusr� r) r) r* � cpu_affinity� s z"TestFetchAllProcesses.cpu_affinityc C sJ t |ttd �f�sJ �|d urFtj�|�s2J |��tj�|�sFJ |��d S rW )r r$ �typer` ra rb rf rg r) r) r* �terminal� s z TestFetchAllProcesses.terminalc C s� |D ]�}t |jt�sJ �t |jt�s(J �t |jt�s8J �|jD ]�}t||�}|dkrx|�d�s�tj� |j�s�J |j��q>|dkr�|s�J t
|���q>|dkr�t s�|s�J t
|���q>t |t t
f�s�J �|dks>J �q>qd S )Nra )�[z anon_inode:�addr�permsr )r r� r$ r� ra r� rN �
startswithr` rb r% r rj r )r= rY r3 �nt�fnamerS r) r) r* � memory_maps� s
z!TestFetchAllProcesses.memory_mapsc C s t |t�sJ �|dksJ �d S r ri rg r) r) r* � num_handles� s z!TestFetchAllProcesses.num_handlesc C sx t |t�sJ �tr2d| kr&dkstn J |��nBdd� tt�D �}||v sPJ �trft |tj�stJ �nt |t�stJ �d S )Ni��� c S s g | ]}|� d �rtt|��qS )Z_PRIORITY_CLASS)r_ rN r )rG �xr) r) r* �
<listcomp>� s
�z.TestFetchAllProcesses.nice.<locals>.<listcomp>)r rj r
�dirr r �enum�IntEnum)r= rY r3 Z
prioritiesr) r) r* �nice� s � zTestFetchAllProcesses.nicec C s8 t |�s J �|D ]"}t|ttf�s&J �|dksJ �qd S r rx r� r) r) r* �num_ctx_switches� s z&TestFetchAllProcesses.num_ctx_switchesc C sB t |t�sJ �t|�dks J �|d dks.J �|d dks>J �d S )N� r rw r} )r �tupler� rg r) r) r* �rlimit� s z TestFetchAllProcesses.rlimitc C s@ t |t�sJ �|�� D ]$\}}t |t�s,J �t |t�sJ �qd S rW )r �dictrM r$ )r= rY r3 �k�vr) r) r* �environ� s z TestFetchAllProcesses.environN))�__name__�
__module__� __qualname__�__doc__r> rB rE rV r[ rh r r! r rp rr rt ru rk rz r| r~ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r) r) r) r* r6 e sL
r6 c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �
TestPidsRangea@ Given pid_exists() return value for a range of PIDs which may or
may not exist, make sure that psutil.Process() and psutil.pids()
agree with pid_exists(). This guarantees that the 3 APIs are all
consistent with each other. See:
https://github.com/giampaolo/psutil/issues/2359
XXX - Note about Windows: it turns out there are some "hidden" PIDs
which are not returned by psutil.pids() and are also not revealed
by taskmgr.exe and ProcessHacker, still they can be instantiated by
psutil.Process() and queried. One of such PIDs is "conhost.exe".
Running as_dict() for it reveals that some Process() APIs
erroneously raise NoSuchProcess, so we know we have problem there.
Let's ignore this for now, since it's quite a corner case (who even
imagined hidden PIDs existed on Windows?).
c C s t �d� d S r7 �r r8 r< r) r) r* r> � s zTestPidsRange.setUpc C s t �d� d S r? r� r< r) r) r* rB � s zTestPidsRange.tearDownc C sf dd� }dd� }t dd�D ]F}tr,||�r,q| j|d�� ||� W d � q1 sV0 Y qd S )Nc S s� zt d| d�}W n ty& Y dS 0 |�V |D ]8}|�d�r2t|�� d �}|| k W d � S q2td��W d � n1 s�0 Y d S )Nz/proc/%s/status�rbFs Tgid:r} z'Tgid' line not found)�openr
r� rj �split�
ValueError)r r� �lineZtgidr) r) r* � is_linux_tid� s
z+TestPidsRange.test_it.<locals>.is_linux_tidc S s� d}t �| �}zv|r4t �| � ts�| t �� v s�J �nNtsnt�t j�� t �| � W d � n1 sd0 Y ts�| t �� vs�J �W n* t j t
fy� |d8 }|dkr�� Y q0 d S qd S )N� r} r ) r Z
pid_existsr0 r rC r r Zraisesr" r- re )r r� rf r) r) r* �check� s"
(z$TestPidsRange.test_it.<locals>.checkr} i� )r )r� r ZsubTest)r= r� r� r r) r) r* �test_it� s zTestPidsRange.test_itN)r� r� r� r� r> rB r� r) r) r) r* r� � s r� )(r� r� r� r: r` r� rm rP r r r r r r r r r r
r Zpsutil._compatr r
r r Z psutil.testsr r r r r r r r r r r r9 r5 r6 r� r) r) r) r* �<module> sN 1 qPK ok\+��N �N 0 psutil/tests/__pycache__/test_bsd.cpython-39.pycnu �[��� a
��?h�N � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z ddl
m Z dd l
m
Z
dd
l
mZ dd l
mZ dd l
mZ dd
l
mZ ddl
mZ ddl
mZ er�ddlmZ e� Ze�� dko�ed�ZndZdZdd� Zdd� Zejj e dd�G dd� de
��Z ejj e dd�G dd � d e
��Z ejj e dd�G d d � d e
��Z ejj e d d�G d d!� d!e
��Z ejj e d"d�G d#d$� d$e
��Z!dS )%z$Tests specific to all BSD platforms.� N)�BSD)�FREEBSD)�NETBSD)�OPENBSD)� HAS_BATTERY)�TOLERANCE_SYS_MEM)�PsutilTestCase)�pytest)�retry_on_failure)�sh)�spawn_testproc)� terminate)�which)� getpagesize�museFc C sl t d| �}tr(||�d�d d� }n ts0trF||�d�d d� }z
t|�W S tyf | Y S 0 dS )zmExpects a sysctl command with an argument and parse the result
returning only the value of interest.
zsysctl z: � N�=� )r r �findr r �int�
ValueError)�cmdline�result� r �A/usr/local/lib64/python3.9/site-packages/psutil/tests/test_bsd.py�sysctl- s
r c C s> t d�}|�d�D ]}|�| �r q.qtd��t|�� d �S )z+Thin wrapper around 'muse' cmdline utility.r �
zline not foundr )r �split�
startswithr r )�field�out�liner r r r < s
zBSD only��reasonc @ s� e Zd ZdZedd� �Zedd� �Zejj e
dd�dd � �Z d
d � Z ejj e
d � d
d�dd� �Zejj e
d � d
d�ejj e
dd�dd� ��Zejj e
d� dd�dd� �ZdS )� BSDTestCasez)Generic tests common to all BSD variants.c C s t � j| _d S �N�r �pid��clsr r r �
setUpClassP s zBSDTestCase.setUpClassc C s t | j� d S r% �r
r' r( r r r �
tearDownClassT s zBSDTestCase.tearDownClassz -o lstart doesn't work on NETBSDr" c C sP t d| j �}|�dd��� }t�| j��� }t�dt� |��}||ksLJ �d S )Nzps -o lstart -p %sZSTARTED� z%a %b %e %H:%M:%S %Y)
r r' �replace�strip�psutil�ProcessZ create_time�time�strftime� localtime)�self�outputZstart_psZ start_psutilr r r �test_process_create_timeX s
�z$BSDTestCase.test_process_create_timec C s� dd� }t jdd�D ]�}t �|j�}||j�\}}}}|j|ksDJ �|j|ksRJ �t|j| �dkrx| �d|j|f ��t|j | �dkr| �d|j |f ��qd S )Nc S s� t d| ��� }|�d�}|�d� |�d�}|�� d d� \}}}}|dkrRd}t|�d }t|�d }t|�d }||||fS )Nz
df -k "%s"r r � �noner- � )r r/ r �popr )�pathr �linesr! �dev�total�used�freer r r �dfe s
z"BSDTestCase.test_disks.<locals>.dfF)�alli � zpsutil=%s, df=%s)
r0 Zdisk_partitions�
disk_usageZ
mountpointZdevicer? �absrA Zfailr@ )r5 rB �part�usager> r? r@ rA r r r �
test_disksb s
zBSDTestCase.test_disksr zsysctl cmd not availablec C s t d�}tjdd�|ks J �d S )Nzhw.ncpuT)�logical)r r0 � cpu_count�r5 Zsystr r r �test_cpu_count_logical} s z"BSDTestCase.test_cpu_count_logicalzskipped on NETBSDc C s t d�}|t�� jksJ �d S )Nz
hw.physmem)r r0 �virtual_memoryr? �r5 �numr r r �test_virtual_memory_total� s z%BSDTestCase.test_virtual_memory_total�ifconfigzifconfig cmd not availablec C sv t �� �� D ]d\}}ztd| �}W n ty6 Y q 0 |jd|v ksJJ �d|v r |jtt� d|�d �ks J �q d S )Nz ifconfig %s�RUNNING�mtuz mtu (\d+)r )
r0 Z net_if_stats�itemsr � RuntimeErrorZisuprS r �re�findall)r5 �name�statsr r r r �test_net_if_stats� s z BSDTestCase.test_net_if_statsN)�__name__�
__module__� __qualname__�__doc__� classmethodr* r, r �mark�skipifr r7 rH r rL rP rZ r r r r r$ L s&
�
�r$ z FREEBSD onlyc @ sf e Zd Zedd� �Zedd� �Ze� dd� �Zdd� Zd d
� Z d d � Z
e� d
d� �Z e� dd� �Z dS )�FreeBSDPsutilTestCasec C s t � j| _d S r% r& r( r r r r* � s z FreeBSDPsutilTestCase.setUpClassc C s t | j� d S r% r+ r( r r r r, � s z#FreeBSDPsutilTestCase.tearDownClassc C s� t d| j �}t�| j�jdd�}|�d�dd � }|r�|�� }|�� }|d d� \}}}} }
|�� } d||f | jks|J �t|
�| j ks�J �| j
� d�s4|d | j
ks4J �q4d S )
Nzprocstat -v %sF)Zgroupedr r � z%s-%s�[�
) r r' r0 r1 Z memory_mapsr r; �addrr Zrssr< r ) r5 r �mapsr= r! �fields�_�start�stopZ_perms�res�mapr r r �test_memory_maps� s z&FreeBSDPsutilTestCase.test_memory_mapsc C s< t d| j �}t�| j��� |�d�d �� d ks8J �d S )Nzprocstat -b %sr r ���)r r' r0 r1 Zexer �r5 r r r r �test_exe� s z FreeBSDPsutilTestCase.test_exec C sL t d| j �}d�t�| j��� �d�|�d�d �� dd � �ksHJ �d S )Nzprocstat -c %s� r r r )r r' �joinr0 r1 r r rp r r r � test_cmdline� s �z"FreeBSDPsutilTestCase.test_cmdlinec C s� t d| j �}|�d�d �� dd� \}}}}}}t�| j�}|�� } |�� }
| jt|�ksbJ �| j t|�kstJ �| j
t|�ks�J �|
jt|�ks�J �|
j t|�ks�J �|
j
t|�ks�J �d S )Nzprocstat -s %sr r r � ) r r' r r0 r1 �uids�gids�realr Z effectiveZsaved) r5 r ZeuidZruidZsuidZegidZrgidZsgid�prv rw r r r �test_uids_gids� s & z$FreeBSDPsutilTestCase.test_uids_gidsc C s� g }t d| j �}t�| j�}|�d�D ]�}|�� �� }d|v rrt|�� d �}|�� j }||ksfJ �|�
d � q(d|v r(t|�� d �}|�� j }||ks�J �|�
d � q(t |�dkr�t
d��d S )N�procstat -r %sr z voluntary contextro z involuntary contextr �)couldn't find lines match in procstat out)r r' r0 r1 r �lowerr/ r Znum_ctx_switchesZ voluntary�appendZ involuntary�lenrU �r5 Ztestedr ry r! Z pstat_valueZ psutil_valuer r r �test_ctx_switches� s"
z'FreeBSDPsutilTestCase.test_ctx_switchesc C s� g }t d| j �}t�| j�}|�d�D ]�}|�� �� }d|v r�td|�� d �d�d �}|�� j }||kstJ �|�
d � q(d|v r(td|�� d �d�d �}|�� j }||ks�J �|�
d � q(t |�dkr�t
d ��d S )
Nr{ r z user timez0.ro �.z system timer r| )r r' r0 r1 r r} r/ �floatZ cpu_times�userr~ �systemr rU r� r r r �test_cpu_times� s"
z$FreeBSDPsutilTestCase.test_cpu_timesN)
r[ r\ r] r_ r* r, r
rn rq rt rz r� r� r r r r rb � s
rb c @ s� e Zd Zedd� �Zdd� Ze� dd� �Ze� dd� �Ze� d d
� �Z e� d d � �Z
e� d
d� �Z e� dd� �Z e
jje dd�dd� �Ze
jje dd�e� dd� ��Ze
jje dd�e� dd� ��Ze
jje dd�e� dd� ��Ze
jje dd�e� dd � ��Ze
jje dd�e� d d � ��Ze
jje dd�e� d d � ��Zd!d"� Zd#d$� Zd%d&� Ze� d'd(� �Zd)d*� Z d+d,� Z d-d.� Z d/d0� Z e
jje d1d�d2d3� �Z!e
jje d1d�d4d5� �Z"e
jje d6d�d7d8� �Z#d9d:� Z$d;S )<�FreeBSDSystemTestCasec C sR t d��� d } t�d| �}|s,td| ��dd� |dd� D �\}}}|||fS ) Nz swapinfo -kro z\s+zCan't parse swapinfo: %sc s s | ]}t |�d V qdS )r: N)r )�.0ry r r r � <genexpr> � z7FreeBSDSystemTestCase.parse_swapinfo.<locals>.<genexpr>r r8 )r �
splitlinesrV r r )r6 �partsr? r@ rA r r r �parse_swapinfo� s z$FreeBSDSystemTestCase.parse_swapinfoc C s� d}zt t|��}W n ty0 t�d��Y n0 t�� j|ksDJ �d}t|�}t |�� d �d�d �}t |�� d �d�d �}t�� j |ks�J �t�� j
|ks�J �d S )Nzdev.cpu.0.freqz#frequencies not supported by kernelzdev.cpu.0.freq_levelsr �/ro ) r r rU r �skipr0 Zcpu_freq�currentr �max�min)r5 �sensor�
sysctl_resultZmax_freqZmin_freqr r r �!test_cpu_frequency_against_sysctl s z7FreeBSDSystemTestCase.test_cpu_frequency_against_sysctlc C s* t d�t }tt�� j| �tk s&J �d S )Nzvm.stats.vm.v_active_count)r �PAGESIZErE r0 rM �activer rK r r r �test_vmem_active s z&FreeBSDSystemTestCase.test_vmem_activec C s* t d�t }tt�� j| �tk s&J �d S )Nz vm.stats.vm.v_inactive_count)r r� rE r0 rM �inactiver rK r r r �test_vmem_inactive! s z(FreeBSDSystemTestCase.test_vmem_inactivec C s* t d�t }tt�� j| �tk s&J �d S )Nzvm.stats.vm.v_wire_count)r r� rE r0 rM �wiredr rK r r r �test_vmem_wired& s z%FreeBSDSystemTestCase.test_vmem_wiredc C s* t d�t }tt�� j| �tk s&J �d S )Nzvm.stats.vm.v_cache_count)r r� rE r0 rM �cachedr rK r r r �test_vmem_cached+ s z&FreeBSDSystemTestCase.test_vmem_cachedc C s* t d�t }tt�� j| �tk s&J �d S )Nzvm.stats.vm.v_free_count)r r� rE r0 rM rA r rK r r r �test_vmem_free0 s z$FreeBSDSystemTestCase.test_vmem_freec C s& t d�}tt�� j| �tk s"J �d S )Nz vfs.bufspace)r rE r0 rM �buffersr rK r r r �test_vmem_buffers5 s z'FreeBSDSystemTestCase.test_vmem_bufferszmuse not installedr" c C s t d�}t�� j|ksJ �d S )NZTotal)r r0 rM r? rN r r r �test_muse_vmem_total< s z*FreeBSDSystemTestCase.test_muse_vmem_totalc C s& t d�}tt�� j| �tk s"J �d S )NZActive)r rE r0 rM r� r rN r r r �test_muse_vmem_activeA s z+FreeBSDSystemTestCase.test_muse_vmem_activec C s& t d�}tt�� j| �tk s"J �d S )NZInactive)r rE r0 rM r� r rN r r r �test_muse_vmem_inactiveG s z-FreeBSDSystemTestCase.test_muse_vmem_inactivec C s& t d�}tt�� j| �tk s"J �d S )NZWired)r rE r0 rM r� r rN r r r �test_muse_vmem_wiredM s z*FreeBSDSystemTestCase.test_muse_vmem_wiredc C s& t d�}tt�� j| �tk s"J �d S )N�Cache)r rE r0 rM r� r rN r r r �test_muse_vmem_cachedS s z+FreeBSDSystemTestCase.test_muse_vmem_cachedc C s& t d�}tt�� j| �tk s"J �d S )NZFree)r rE r0 rM rA r rN r r r �test_muse_vmem_freeY s z)FreeBSDSystemTestCase.test_muse_vmem_freec C s& t d�}tt�� j| �tk s"J �d S )NZBuffer)r rE r0 rM r� r rN r r r �test_muse_vmem_buffers_ s z,FreeBSDSystemTestCase.test_muse_vmem_buffersc C s" t t�� jtd� �dk s J �d S )Nzvm.stats.sys.v_swtch�� )rE r0 � cpu_stats� ctx_switchesr �r5 r r r �test_cpu_stats_ctx_switchese s ����z1FreeBSDSystemTestCase.test_cpu_stats_ctx_switchesc C s" t t�� jtd� �dk s J �d S )Nzvm.stats.sys.v_intrr� )rE r0 r� �
interruptsr r� r r r �test_cpu_stats_interruptsn s ��z/FreeBSDSystemTestCase.test_cpu_stats_interruptsc C s" t t�� jtd� �dk s J �d S )Nzvm.stats.sys.v_softr� )rE r0 r� Zsoft_interruptsr r� r r r � test_cpu_stats_soft_interruptst s ����z4FreeBSDSystemTestCase.test_cpu_stats_soft_interruptsc C s" t t�� jtd� �dk s J �d S )Nzvm.stats.sys.v_syscalli@
)rE r0 r� Zsyscallsr r� r r r �test_cpu_stats_syscalls} s ��z-FreeBSDSystemTestCase.test_cpu_stats_syscallsc C s, | � � \}}}tt�� j| �tk s(J �d S r% )r� rE r0 � swap_memoryrA r )r5 �_total�_usedrA r r r �test_swapmem_free� s z'FreeBSDSystemTestCase.test_swapmem_freec C s, | � � \}}}tt�� j| �tk s(J �d S r% )r� rE r0 r� r@ r )r5 r� r@ �_freer r r �test_swapmem_used� s z'FreeBSDSystemTestCase.test_swapmem_usedc C s, | � � \}}}tt�� j| �tk s(J �d S r% )r� rE r0 r� r? r )r5 r? r� r� r r r �test_swapmem_total� s z(FreeBSDSystemTestCase.test_swapmem_totalc C sL t d�}||�d�d d � }|d |�d�� }t|�}|t�� ksHJ �d S )Nzsysctl kern.boottimez sec = � �,)r r r r0 � boot_time)r5 �sZbtimer r r �test_boot_time� s
z$FreeBSDSystemTestCase.test_boot_timez
no batteryc C s� dd� }t d�}tdd� |�d�D ��}t�� }t|d �dd ��}|d
}|j|ksZJ �|d krt|jtj ks�J �n||j�|ks�J �d S ) Nc S s( t | d�\}}t |d�\}}d||f S )N�< z%d:%02d)�divmod)Zsecs�mZ_s�hr r r �
secs2hours� s z>FreeBSDSystemTestCase.test_sensors_battery.<locals>.secs2hoursz
acpiconf -i 0c S s( g | ] }|� d �d |� d �d f�qS )� r ro )r )r� �xr r r �
<listcomp>� r� z>FreeBSDSystemTestCase.test_sensors_battery.<locals>.<listcomp>r zRemaining capacity:�%r- zRemaining time:�unknown)
r �dictr r0 �sensors_batteryr r. �percent�secsleftZPOWER_TIME_UNLIMITED)r5 r� r rh Zmetricsr� Zremaining_timer r r �test_sensors_battery� s �z*FreeBSDSystemTestCase.test_sensors_batteryc C sl t �� jtd�ksJ �t �� jtd�dkks0J �t �� j}|dk rTtd�dkshJ �n|td�d kshJ �d S )N�hw.acpi.battery.life�hw.acpi.acliner r �hw.acpi.battery.timero r� )r0 r� r� r Z
power_pluggedr� )r5 r� r r r �#test_sensors_battery_against_sysctl� s
�
�
z9FreeBSDSystemTestCase.test_sensors_battery_against_sysctlz has batteryc C sV t �t��( td� td� td� W d � n1 s80 Y t�� d u sRJ �d S )Nr� r� r� )r ZraisesrU r r0 r� r� r r r � test_sensors_battery_no_battery� s
&z5FreeBSDSystemTestCase.test_sensors_battery_no_batteryc C s� t �d�}t|�D ]�}d| }z ttt|�d d� ��}W n tyV t�d��Y n0 t t �
� d | j | �dk szJ �d| }ttt|�d d� ��}t �
� d | j |ksJ �qd S )NTzdev.cpu.%s.temperaturero z$temperatures not supported by kernelZcoretempre zdev.cpu.%s.coretemp.tjmax)
r0 rJ �ranger r� r rU r r� rE Zsensors_temperaturesr� �high)r5 Znum_cpus�cpur� r� r r r �(test_sensors_temperatures_against_sysctl� s*
������z>FreeBSDSystemTestCase.test_sensors_temperatures_against_sysctlN)%r[ r\ r] � staticmethodr� r� r
r� r� r� r� r� r� r r` ra �MUSE_AVAILABLEr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r� r� r� r r r r r� � sf
r� z OPENBSD onlyc @ s e Zd Zdd� ZdS )�OpenBSDTestCasec C s6 t d�}tj�|d�}tj�t�� �}||ks2J �d S )Nz
kern.boottimez%a %b %d %H:%M:%S %Y)r �datetime�strptime�
fromtimestampr0 r� )r5 r� Zsys_btZ psutil_btr r r r� � s z OpenBSDTestCase.test_boot_timeN)r[ r\ r] r� r r r r r� � s r� z NETBSD onlyc @ sh e Zd Zedd� �Zdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dd� ZdS )�NetBSDTestCasec C sr t d��J}|D ]4}|�| �rt|�� d �d W d � S qW d � n1 sX0 Y td| ��d S )Nz
/proc/meminfor r: z
can't find %s)�openr r r r )Zlook_for�fr! r r r �
parse_meminfo� s
Fz NetBSDTestCase.parse_meminfoc C s t �� j| �d�ksJ �d S )Nz MemTotal:)r0 rM r? r� r� r r r �test_vmem_total s z NetBSDTestCase.test_vmem_totalc C s$ t t�� j| �d� �tk s J �d S )NzMemFree:)rE r0 rM rA r� r r� r r r r� s ��z NetBSDTestCase.test_vmem_freec C s$ t t�� j| �d� �tk s J �d S )NzBuffers:)rE r0 rM r� r� r r� r r r r� s ����z NetBSDTestCase.test_vmem_buffersc C s$ t t�� j| �d� �tk s J �d S )Nz
MemShared:)rE r0 rM Zsharedr� r r� r r r �test_vmem_shared s ����z NetBSDTestCase.test_vmem_sharedc C s$ t t�� j| �d� �tk s J �d S )NzCached:)rE r0 rM r� r� r r� r r r r� $ s ��z NetBSDTestCase.test_vmem_cachedc C s$ t t�� j| �d� �tk s J �d S )Nz
SwapTotal:)rE r0 r� r? r� r r� r r r r� , s ��z!NetBSDTestCase.test_swapmem_totalc C s$ t t�� j| �d� �tk s J �d S )Nz SwapFree:)rE r0 r� rA r� r r� r r r r� 2 s ��z NetBSDTestCase.test_swapmem_freec C s" t �� }|j|j|j ks J �d S r% )r0 r� r@ r? rA )r5 Zsmemr r r r� 8 s z NetBSDTestCase.test_swapmem_usedc C sx t dd��@}|D ]"}|�d�rt|�� d �} q<qtd��W d � n1 sP0 Y tt�� j| �dk stJ �d S )N�
/proc/stat�rbs intrr �couldn't find liner� ) r� r r r r rE r0 r� r� )r5 r� r! r� r r r r� > s
&z(NetBSDTestCase.test_cpu_stats_interruptsc C sx t dd��@}|D ]"}|�d�rt|�� d �} q<qtd��W d � n1 sP0 Y tt�� j| �dk stJ �d S )Nr� r� s ctxtr r� r� ) r� r r r r rE r0 r� r� )r5 r� r! r� r r r r� H s
&z*NetBSDTestCase.test_cpu_stats_ctx_switchesN)r[ r\ r] r� r� r� r� r� r� r� r� r� r� r� r� r r r r r� � s
r� )"r^ r� �osrV r2 r0 r r r r Z psutil.testsr r r r r
r r r
r Zpsutil._psutil_posixr r� �getuidr� r r r` ra r$ rb r� r� r� r r r r �<module>
sJ QX x
PK ok\{��
y
y 4 psutil/tests/__pycache__/test_windows.cpython-39.pycnu �[��� a
��?h � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl m
Z
ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! e
�r�e�s�e �"� �: e �#d� ddl$Z$ddl%Z%ddl&Z&ddl'Z'W d � n1 �s�0 Y e
�r�ddl(m)Z) e j*j+Z+e j,j-e
dd�e j,j-edd�e j,j-e�o�e dd�G d d � d e����Z.d d � Z/e0fd d!�Z1G d"d#� d#e.�Z2G d$d%� d%e.�Z3G d&d'� d'e.�Z4G d(d)� d)e.�Z5G d*d+� d+e.�Z6e j,j-e
dd�G d,d-� d-e��Z7e j,j-e
dd�G d.d/� d/e��Z8e j,j-e
dd�G d0d1� d1e��Z9dS )2zWindows specific tests.� N)�WINDOWS)�FileNotFoundError)�super)�which)�APPVEYOR)�GITHUB_ACTIONS)� HAS_BATTERY)�IS_64BIT)�PY3)�PYPY)�TOLERANCE_DISK_USAGE)�TOLERANCE_SYS_MEM)�PsutilTestCase)�mock)�pytest)�retry_on_failure)�sh)�spawn_testproc)� terminate�ignore)�convert_oserrorz WINDOWS only��reasonz pywin32 not available on PYPYz pywin32 broken on GITHUB + PY2c @ s e Zd ZdS )�WindowsTestCaseN)�__name__�
__module__� __qualname__� r r �E/usr/local/lib64/python3.9/site-packages/psutil/tests/test_windows.pyr ; s r c C s& t d�st�d��dd| }t|�S )z�Currently not used, but available just in case. Usage:
>>> powershell(
"Get-CIMInstance Win32_PageFileUsage | Select AllocatedBaseSize")
zpowershell.exez powershell.exe not availablez?powershell.exe -ExecutionPolicy Bypass -NoLogo -NonInteractive z,-NoProfile -WindowStyle Hidden -Command "%s")r r �skipr )�cmd�cmdliner r r �
powershellE s
��r" c sj t d| |f ��� }d�|�� dd� ��� }� durbd|v rXt� fdd�|�� D ��S � |�S n|S dS )z�Currently not used, but available just in case. Usage:
>>> wmic("Win32_OperatingSystem", "FreePhysicalMemory")
2134124534
zwmic path %s get %s� � N�,c s g | ] }� |��qS r r ��.0�x�� converterr r �
<listcomp>^ � zwmic.<locals>.<listcomp>)r �strip�join�
splitlines�tuple�split)�path�whatr* �out�datar r) r �wmicT s
r6 c @ sR e Zd Zejjdejvdd�dd� �Zdd� Z dd � Z
d
d � Z d d
� Z dd� Z
dS )� TestCpuAPIs�NUMBER_OF_PROCESSORSz-NUMBER_OF_PROCESSORS env var is not availabler c C s" t tjd �}|t�� ks J �d S )Nr8 )�int�os�environ�psutil� cpu_count)�selfZnum_cpusr r r �&test_cpu_count_vs_NUMBER_OF_PROCESSORSk s z2TestCpuAPIs.test_cpu_count_vs_NUMBER_OF_PROCESSORSc C s$ t �� d }t�� }||ks J �d S )N� )�win32apiZ
GetSystemInfor< r= �r> � sys_value� psutil_valuer r r � test_cpu_count_vs_GetSystemInfou s z+TestCpuAPIs.test_cpu_count_vs_GetSystemInfoc C s2 t �� }tdd� |�� D ��}t�� |ks.J �d S )Nc s s | ] }|j V qd S �N)ZNumberOfLogicalProcessors�r' �procr r r � <genexpr>~ s z<TestCpuAPIs.test_cpu_count_logical_vs_wmi.<locals>.<genexpr>��wmi�WMI�sum�Win32_Processorr< r= )r> �wZprocsr r r � test_cpu_count_logical_vs_wmi| s
�z)TestCpuAPIs.test_cpu_count_logical_vs_wmic C s6 t �� }tdd� |�� D ��}tjdd�|ks2J �d S )Nc s s | ] }|j V qd S rF )Z
NumberOfCoresrG r r r rI � r, z:TestCpuAPIs.test_cpu_count_cores_vs_wmi.<locals>.<genexpr>F)�logicalrJ )r> rO Zcoresr r r �test_cpu_count_cores_vs_wmi� s z'TestCpuAPIs.test_cpu_count_cores_vs_wmic C s t �� tt jdd��ks J �d S )NT)Zpercpu)r< r= �len� cpu_times�r> r r r �test_cpu_count_vs_cpu_times� s z'TestCpuAPIs.test_cpu_count_vs_cpu_timesc C s@ t �� }|�� d }|jt�� jks(J �|jt�� jks<J �d S �Nr ) rK rL rN ZCurrentClockSpeedr< Zcpu_freq�currentZ
MaxClockSpeed�max)r> rO rH r r r �
test_cpu_freq� s zTestCpuAPIs.test_cpu_freqN)r r r r �mark�skipifr: r; r? rE rP rR rV rZ r r r r r7 j s �
r7 c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zej j
e d d �e � d
d� ��Z
e � dd� �Ze � dd� �Zdd� Zdd� Zdd� Zdd� ZdS ) �TestSystemAPIsc C sR t d�}tjdd��� }|D ]0}d|�dd��� v r6q ||vr | �d| ��q d S )Nz
ipconfig /allT)Zperniczpseudo-interface� �-z-%r nic wasn't found in 'ipconfig /all' output)r r< Znet_io_counters�keys�replace�lower�fail)r> r4 ZnicsZnicr r r �test_nic_names� s �z TestSystemAPIs.test_nic_namesc C s, t �� �� d }t|j�t�� jks(J �d S rW )rK rL ZWin32_ComputerSystemr9 ZTotalPhysicalMemoryr< �virtual_memory�total�r> rO r r r �test_total_phymem� s z TestSystemAPIs.test_total_phymemc C s4 t �� �� d }tt|j�t�� j �t k s0J �d S rW )
rK rL � Win32_PerfRawData_PerfOS_Memory�absr9 ZAvailableBytesr< re �freer
rg r r r �test_free_phymem� s
��z TestSystemAPIs.test_free_phymemc C sh t �� �� d }t|j�t�� j t�� jks2J �t�� jdkrdt�� j dksRJ �t�� j
dksdJ �d S rW ) rK rL ri r9 Z CommitLimitr< re rf � swap_memoryrk �usedrg r r r �test_total_swapmem� s ��z!TestSystemAPIs.test_total_swapmemc C s| t �� jdkrxt�� jdd�d }t|j�d t|j� }t �� j dksLJ �t
t �� j | �dk sfJ �t �� j dksxJ �d S )Nr Z_Total)�Name�d r@ ) r< rm rf rK rL Z#Win32_PerfRawData_PerfOS_PagingFiler9 Z PercentUsageZPercentUsage_Base�percentrj )r> rO Z percentSwapr r r �test_percent_swapmem� s z#TestSystemAPIs.test_percent_swapmemz test not relieable on appveyorr c C s: t �� �� }tdd� |D ��}tt�� �}||ks6J �d S )Nc S s g | ]
}|j �qS r �Z ProcessIdr& r r r r+ � r, z,TestSystemAPIs.test_pids.<locals>.<listcomp>)rK rL �
Win32_Process�setr< �pids)r> rO Zwmi_pidsZ psutil_pidsr r r � test_pids� s zTestSystemAPIs.test_pidsc
C s� t jdd�}t�� �� }|D ]�}|D ]�}|j�dd�|jkr$|jsF q d|j v rT q |j�
d�rd q zt � |j�}W n t y� Y q Y n0 |j
t|j�ks�J �t|j�}|j|ks�J �t|j| �dkr�| �d|j|f �� q q$| �d t|� ��q d S )
NT��all�\r# �cdrom�A:i � zpsutil=%s, wmi=%szcan't find partition %s)r< �disk_partitionsrK rL ZWin32_LogicalDiskZdevicera ZDeviceID�
mountpoint�opts�
startswith�
disk_usager rf r9 �SizeZ FreeSpacerk rj rc �repr)r> Zps_partsZ wmi_partsZps_partZwmi_part�usageZwmi_freer r r �
test_disks� s0
�zTestSystemAPIs.test_disksc C s� t �� D ]r}d|jv rqt�|j�}t �|j�}t|d |j �t k sJJ �t|d |j
�t k sdJ �|j |j
|j ksJ �qd S )Nr| r r$ ) r< r~ r� rA ZGetDiskFreeSpaceExr r� rj rk r rf rn )r> ZdiskrC rD r r r �test_disk_usage� s
�z TestSystemAPIs.test_disk_usagec C s> dd� t �� �d�D �}dd� tjdd�D �}||ks:J �d S )Nc S s" g | ]}|r|� d �s|d �qS )r} r{ )r� r& r r r r+ s �z7TestSystemAPIs.test_disk_partitions.<locals>.<listcomp>z\ c S s g | ]}|j �d �s|j �qS )r} )r r� r& r r r r+ s �Try )rA ZGetLogicalDriveStringsr1 r< r~ rB r r r �test_disk_partitions s �
�z#TestSystemAPIs.test_disk_partitionsc C s\ t t�� �}t�� �� }t � }|D ] }|�|j� |�|j� q"||@ sXJ d||f ��d S )Nzno common entries in %s, %s) rv �cextZ net_if_statsrK rL ZWin32_NetworkAdapter�addrp ZNetConnectionID)r> Zps_namesZ wmi_adaptersZ wmi_namesZ wmi_adapterr r r �test_net_if_stats
s �z TestSystemAPIs.test_net_if_statsc C s^ t �� �� }|d j�d�d }tj�|d�}tj�t� � �}t
|| � � �}|dksZJ �d S )Nr �.� %Y%m%d%H%M%Sr@ ) rK rL ZWin32_OperatingSystemZLastBootUpTimer1 �datetime�strptime�
fromtimestampr< � boot_timerj �
total_seconds)r> Zwmi_osZ
wmi_btime_strZ wmi_btime_dtZ psutil_dt�diffr r r �test_boot_time s �z TestSystemAPIs.test_boot_timec C s� t jddd�� t�� dks J �W d � n1 s40 Y t jddd�� t�� dks^J �W d � n1 sr0 Y t jddd�� t�� dks�J �W d � n1 s�0 Y t jddd�� t�� dks�J �W d � n1 s�0 Y d S )Nz psutil._pswindows.cext.boot_timer@ �Z return_value� � iM )r �patchr< r� rU r r r �test_boot_time_fluctuation# s ...z)TestSystemAPIs.test_boot_time_fluctuationN)r r r rd rh rl ro rs r r[ r\ r r rx r� r� r� r� r� r� r r r r r] � s
r] c @ sh e Zd Zdd� Zejje dd�dd� �Zejje dd�dd� �Z d d
� Z
d d � Z d
d� Z dd� Z
dS )�TestSensorsBatteryc C s2 t �� d r t�� d us.J �nt�� d u s.J �d S )NZSystemBatteriesPresent)rA ZGetPwrCapabilitiesr< �sensors_batteryrU r r r �test_has_battery5 s z#TestSensorsBattery.test_has_batteryz
no batteryr c C s: t �� }|�d�d }t�� }t|j|j �dk s6J �d S )N�select * from Win32_Batteryr r$ )rK rL �queryr< r� rj rr ZEstimatedChargeRemaining�r> rO Z battery_wmiZbattery_psutilr r r � test_percent; s ��z TestSensorsBattery.test_percentc C s6 t �� }|�d�d }t�� }|j|jdkks2J �d S )Nr� r � )rK rL r� r< r� Z
power_pluggedZ
BatteryStatusr� r r r �test_power_pluggedE s z%TestSensorsBattery.test_power_pluggedc C sL t jddd��*}t�� d u s J �|js*J �W d � n1 s>0 Y d S )N�&psutil._pswindows.cext.sensors_battery)r � r r r� )r r� r< r� �called�r> �mr r r �test_emulate_no_batteryN s �z*TestSensorsBattery.test_emulate_no_batteryc C sP t jddd��.}t�� jtjks$J �|js.J �W d � n1 sB0 Y d S )Nr� )r$ r r r r� �r r� r< r� �secsleftZPOWER_TIME_UNLIMITEDr� r� r r r � test_emulate_power_connectedV s ���z/TestSensorsBattery.test_emulate_power_connectedc C sP t jddd��.}t�� jtjks$J �|js.J �W d � n1 sB0 Y d S )Nr� )r � r r r� r� r� r r r �test_emulate_power_charging` s ���z.TestSensorsBattery.test_emulate_power_chargingc C sP t jddd��.}t�� jtjks$J �|js.J �W d � n1 sB0 Y d S )Nr� )r r r ���r� )r r� r< r� r� ZPOWER_TIME_UNKNOWNr� r� r r r � test_emulate_secs_left_unknownj s ��z1TestSensorsBattery.test_emulate_secs_left_unknownN)r r r r� r r[ r\ r r� r� r� r� r� r� r r r r r� 4 s
r� c @ s� e Zd Zedd� �Zedd� �Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#S )$� TestProcessc C s t � j| _d S rF �r �pid��clsr r r �
setUpClass{ s zTestProcess.setUpClassc C s t | j� d S rF �r r� r� r r r �
tearDownClass s zTestProcess.tearDownClassc C sB t �d�}t�t j�� |�� W d � n1 s40 Y d S rW )r< �Processr �raises� AccessDenied�kill�r> �pr r r �
test_issue_24� s
zTestProcess.test_issue_24c C s� t �d�}|�� dksJ �t|� |�� |�� dks:J �z|�� d d� \}}W n& t jyx t� � d dvrt� Y n0 |dks�J �d S )Nr� �Systemg r� r$ )Zvistazwin-7Zwin7r )
r< r� �name�str�username� create_time� memory_infor� �platform�uname)r> r� �rssZ_vmsr r r �test_special_pid� s
z TestProcess.test_special_pidc C sF t �| j�}t�t�� |�tj� W d � n1 s80 Y d S rF ) r< r� r� r r� �
ValueError� send_signal�signal�SIGINTr� r r r �test_send_signal� s z TestProcess.test_send_signalc C sb t �t�� �}|�� }t�tjtj t�� �}|�� }||d ksDJ �t�
|� |�� |ks^J �d S )Nr$ ) r< r� r: �getpid� num_handlesrA � OpenProcess�win32con�PROCESS_QUERY_INFORMATION�FALSE� CloseHandle)r> r� �before�handle�afterr r r �test_num_handles_increment� s �
z&TestProcess.test_num_handles_incrementc C s� t �| �� j�}|�tj� |�tj� |�� |� � t
� t j �� |�tj� W d � n1 sf0 Y t
� t j �� |�tj� W d � n1 s�0 Y d S rF )
r< r� r r� r� r� Z CTRL_C_EVENTZCTRL_BREAK_EVENTr� �waitr r� �
NoSuchProcessr� r r r �test_ctrl_signals� s *z TestProcess.test_ctrl_signalsc C s8 t �tj�}|�d�r t�d��t�� � � |ks4J �d S )N�$zrunning as service account)
rA Z
GetUserNameExr� ZNameSamCompatible�endswithr r r< r� r� )r> r� r r r �
test_username� s
zTestProcess.test_usernamec C sf t �ddt�� ��� }d�t�� �� �}|d d krD|d krVn n|� ddd�}||ksbJ �d S )Nz[ ]+r^ r �"r# r� )
�re�subrA ZGetCommandLiner- r. r< r� r! ra rB r r r � test_cmdline� s
zTestProcess.test_cmdlinec C sJ t �tjtjt�� �}| �t j|� t �
|�}t � � �
� }||ksFJ �d S rF )rA r� r� r� r� r: r� �
addCleanupr� � win32processZGetPriorityClassr< r� �nice�r> r� rC rD r r r � test_nice� s �
zTestProcess.test_nicec C s� t �tjtj| j�}| �t j|� t� |�}t
� | j�� � }|d |j
ksNJ �|d |jks`J �|d |jksrJ �|d |jks�J �|d |jks�J �|d |jks�J �|d |jks�J �|d |jks�J �|j|jks�J �|j|jks�J �d S ) NZPeakWorkingSetSize�WorkingSetSizeZQuotaPeakPagedPoolUsageZQuotaPagedPoolUsageZQuotaPeakNonPagedPoolUsageZQuotaNonPagedPoolUsageZ
PagefileUsageZPeakPagefileUsage)rA r� r� r� r� r� r� r� r� ZGetProcessMemoryInfor< r� r� Z peak_wsetZwsetZpeak_paged_poolZ
paged_poolZpeak_nonpaged_poolZ
nonpaged_poolZpagefileZ
peak_pagefiler� �vmsr� r r r �test_memory_info� s. �
���� �z TestProcess.test_memory_infoc C sX t �tjtj| j�}| �t j|� t� | j�}|�
� |� � }t �
|�}||ksTJ �d S rF )rA r� r� r� r� r� r� r� r< r� r r� r� ZGetExitCodeProcess)r> r� r� rD rC r r r � test_wait� s �
zTestProcess.test_waitc C s\ dd� }t �tjtj| j�}| �t j|� |t� |�d �}t
� | j�� � }||ksXJ �d S )Nc s � fdd�t d�D �S )Nc s g | ]}d |> � @ r|�qS )r$ r )r' �i�r( r r r+ r, zGTestProcess.test_cpu_affinity.<locals>.from_bitmask.<locals>.<listcomp>�@ )�ranger� r r� r � from_bitmask s z3TestProcess.test_cpu_affinity.<locals>.from_bitmaskr )
rA r� r� r� r� r� r� r� r� ZGetProcessAffinityMaskr< r� Z cpu_affinity)r> r� r� rC rD r r r �test_cpu_affinity s � �z TestProcess.test_cpu_affinityc C s� t �tjtjt�� �}| �t j|� t �
|�}t � � �
� }|j|d ksLJ �|j|d ks^J �|j|d kspJ �|j|d ks�J �|j|d ks�J �|j|d ks�J �d S )NZReadOperationCountZWriteOperationCountZReadTransferCountZWriteTransferCountZOtherOperationCountZOtherTransferCount)rA r� r� r� r� r: r� r� r� r� ZGetProcessIoCountersr< r� � io_countersZ
read_countZ write_count�
read_bytes� write_bytes� other_countZ other_bytesr� r r r �test_io_counters s �
z TestProcess.test_io_countersc C s� dd l }dd l}d}|jj�|d| j�}| �|jjj|� |j� � }|jj�
||� |�� |j }t
�| j��� }||ks|J �d S )Nr � )�ctypesZctypes.wintypes�windllZkernel32r� r� r� r� ZwintypesZDWORDZGetProcessHandleCount�byref�valuer< r� r� )r> r� r� r� ZhndcntrC rD r r r �test_num_handles" s �
�z TestProcess.test_num_handlesc
C s� t � }d|_tjd|d��v t�d��L}t�� }t�tj�� |� � W d � n1 sZ0 Y W d � n1 sx0 Y W d � n1 s�0 Y |j
dks�J �d S )Ni+ z psutil._psplatform.cext.proc_cwd�Z side_effectz
time.sleepr@ ) � WindowsError�winerrorr r� r< r� r r� r� �cwdZ
call_count)r> �excr� r� r r r �test_error_partial_copy4 s bz#TestProcess.test_error_partial_copyc C sT t �� d d }t j�|�}t�t j�� |�� W d � n1 sF0 Y d S )Nr� i�� )r< rw � _psplatformr� r r� r� �exe)r> r� rH r r r �test_exe? s zTestProcess.test_exeN)r r r � classmethodr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r� z s&
r� c @ s| e Zd ZdZedd� �Zedd� �Zdd� Zej j
e dd �d
d � �Z d d
� Z
dd� Ze� dd� �Ze� dd� �Zdd� ZdS )�TestProcessWMIz%Compare Process API results with WMI.c C s t � j| _d S rF r� r� r r r r� K s zTestProcessWMI.setUpClassc C s t | j� d S rF r� r� r r r r� O s z TestProcessWMI.tearDownClassc C s8 t �� j| jd�d }t�| j�}|�� |jks4J �d S �Nrt r )rK rL ru r� r< r� r� ZCaption�r> rO r� r r r � test_nameS s zTestProcessWMI.test_namez!unreliable path on GITHUB_ACTIONSr c C s@ t �� j| jd�d }t�| j�}|�� �� |j�� ks<J �d S r ) rK rL ru r� r< r� r rb ZExecutablePathr r r r r Y s zTestProcessWMI.test_exec C sF t �� j| jd�d }t�| j�}d�|�� �|j� dd�ksBJ �d S )Nrt r r^ r� r# )
rK rL ru r� r< r� r. r! Z CommandLinera r r r r r� c s zTestProcessWMI.test_cmdlinec C sP t �� j| jd�d }t�| j�}|�� \}}}d||f }|�� |ksLJ �d S )Nrt r z%s\%s)rK rL ru r� r< r� ZGetOwnerr� )r> rO r� �domain�_r� r r r r� h s
z TestProcessWMI.test_usernamec C sB t �� j| jd�d }t�| j�}|�� j}|t|j �ks>J �d S r )
rK rL ru r� r< r� r� r� r9 r� )r> rO r� r� r r r �test_memory_rsso s
z TestProcessWMI.test_memory_rssc C s\ t �� j| jd�d }t�| j�}|�� j}t|j �}|||d fvrX| �
d||f ��d S )Nrt r r� zwmi=%s, psutil=%s) rK rL ru r� r< r� r� r� r9 Z
PageFileUsagerc )r> rO r� r� Z wmi_usager r r �test_memory_vmsv s
z TestProcessWMI.test_memory_vmsc C s\ t �� j| jd�d }t�| j�}t|j�d�d �}t �
dt � |� � ��}||ksXJ �d S )Nrt r r� r� )
rK rL ru r� r< r� r� Z CreationDater1 �time�strftime� localtimer� )r> rO r� Z wmic_createZ
psutil_creater r r �test_create_time� s �z TestProcessWMI.test_create_timeN)r r r �__doc__r r� r� r
r r[ r\ r r r� r� r r
r r r r r r r H s"
�
r c @ sX e Zd ZdZedd� �Zedd� �Zdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dS )� TestDualProcessImplementationaw Certain APIs on Windows have 2 internal implementations, one
based on documented Windows APIs, another one based
NtQuerySystemInformation() which gets called as fallback in
case the first fails because of limited permission error.
Here we test that the two methods return the exact same value,
see:
https://github.com/giampaolo/psutil/issues/304.
c C s t � j| _d S rF r� r� r r r r� � s z(TestDualProcessImplementation.setUpClassc C s t | j� d S rF r� r� r r r r� � s z+TestDualProcessImplementation.tearDownClassc C s� t �| j��� }tjdttjd�d���}t �| j��� }t |�t |�ksLJ �t
t |��D ]@}|| dkslJ �|| dks|J �t || || �dk sXJ �qX|j s�J �W d � n1 s�0 Y d S )Nz(psutil._psplatform.cext.proc_memory_info�msgr� r i )
r< r� r� r� r r� �OSError�errno�EPERMrS r� rj r� )r> Zmem_1�funZmem_2r� r r r r� � s
� z.TestDualProcessImplementation.test_memory_infoc C sl t �| j��� }tjdttjd�d��2}t �| j��� |ks@J �|j sJJ �W d � n1 s^0 Y d S )N�"psutil._psplatform.cext.proc_timesr r� )
r< r� r� r� r r� r r r r� )r> �ctimer r r r r � s
�z.TestDualProcessImplementation.test_create_timec C s� t �| j��� }tjdttjd�d��Z}t �| j��� }|j sBJ �t
|j |j �dk sZJ �t
|j |j �dk srJ �W d � n1 s�0 Y d S )Nr r r� g{�G�z�?)
r< r� r� rT r r� r r r r� rj �user�system)r> Z cpu_times_1r Z cpu_times_2r r r �test_cpu_times� s
�
z,TestDualProcessImplementation.test_cpu_timesc C s� t �| j��� }tjdttjd�d��X}t �| j��� }t t
|��D ] }t || || �dk sDJ �qD|j spJ �W d � n1 s�0 Y d S )Nz(psutil._psplatform.cext.proc_io_countersr r� r@ )
r< r� r� r� r r� r r r r� rS rj r� )r> Z
io_counters_1r Z
io_counters_2r� r r r r� � s
� z.TestDualProcessImplementation.test_io_countersc C sl t �| j��� }tjdttjd�d��2}t �| j��� |ks@J �|j sJJ �W d � n1 s^0 Y d S )Nz(psutil._psplatform.cext.proc_num_handlesr r� )
r< r� r� r� r r� r r r r� )r> r� r r r r r� � s
�z.TestDualProcessImplementation.test_num_handlesc C s� t �� D ]r}z tj|dd�}tj|dd�}W n@ tyl } z(t|�}t|t jt jf�sX� W Y d }~qd }~0 0 ||ksJ �qd S )NT)Zuse_pebF) r< rw r� Z proc_cmdliner r �
isinstancer� r� )r> r� �a�b�errr r r r� � s �z*TestDualProcessImplementation.test_cmdlineN)
r r r r r r� r� r� r r r� r� r� r r r r r � s
r c sp e Zd ZdZedd� �ZddgZ� fdd�Z� fdd �Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Z� ZS )�RemoteProcessTestCasez�Certain functions require calling ReadProcessMemory.
This trivially works when called on the current process.
Check that this works on other processes, especially when they
have a different bitness.
c C s\ d} t � d�D ]H}tj|d| gtjtjd�}|�� \}}|�� |tt �kr| S qd S )Nz6import sys; sys.stdout.write(str(sys.maxsize > 2**32))zC:\Python*\python.exe�-c)�args�stdout�stderr) �glob�
subprocess�Popen�PIPE�STDOUT� communicater� r� r )�code�filenamerH �outputr r r r �find_other_interpreter� s � z,RemoteProcessTestCase.find_other_interpreterr$ z import sys; sys.stdin.read()c s� t � �� | �� }|d u r$t�d��tr8tj| _|| _ n|| _tj| _ t
j � � }t
t
�� �|d< | j| j g| j |tjd�| _| j| jg| j |tjd�| _d S )Nz0could not find interpreter with opposite bitness�THINK_OF_A_NUMBER)�env�stdin)r �setUpr1 r r r �sys�
executableZpython64Zpython32r: r; �copyr� r� r � test_argsr) r+ �proc32�proc64)r> Z other_pythonr3 �� __class__r r r5 s&
�
��zRemoteProcessTestCase.setUpc s" t � �� | j�� | j�� d S rF )r �tearDownr: r- r; rU r< r r r> s
z RemoteProcessTestCase.tearDownc C s@ t �| jj�}t|�� �dks"J �|�� dd � | jks<J �d S �N� r$ )r< r� r: r� rS r! r9 r� r r r �test_cmdline_32! s z%RemoteProcessTestCase.test_cmdline_32c C s@ t �| jj�}t|�� �dks"J �|�� dd � | jks<J �d S r? )r< r� r; r� rS r! r9 r� r r r �test_cmdline_64& s z%RemoteProcessTestCase.test_cmdline_64c C s& t �| jj�}|�� t�� ks"J �d S rF )r< r� r: r� r r: �getcwdr� r r r � test_cwd_32+ s z!RemoteProcessTestCase.test_cwd_32c C s& t �| jj�}|�� t�� ks"J �d S rF )r< r� r; r� r r: rC r� r r r � test_cwd_64/ s z!RemoteProcessTestCase.test_cwd_64c C s> t �| jj�}|�� }d|v s"J �|d tt�� �ks:J �d S )Nr2 )r< r� r: r� r; r� r: r� )r> r� �er r r �test_environ_323 s z%RemoteProcessTestCase.test_environ_32c C s4 t �| jj�}z |�� W n t jy. Y n0 d S rF )r< r� r; r� r; r� r� r r r �test_environ_649 s
z%RemoteProcessTestCase.test_environ_64)r r r r � staticmethodr1 r9 r5 r> rA rB rD rE rG rH �
__classcell__r r r< r r# � s
r# c @ s e Zd Zdd� Zdd� ZdS )� TestServicesc C s` t g d��}t g d��}t g d��}t�� D �],}|�� }t|d t�sLJ �|d �� s\J �t|d t�snJ �t|d t�s�J �|d |v s�J �|d d ur�t�|d � t|d t�s�J �t|d t�s�J �t|d
t�s�J �|d
|v s�J �|d |v �sJ �t|d t��sJ �|�� }|d u�r@t�|�}|� � �s@J �t�
|� � �}||ks,J �q,d S ) N)�running�paused�start�pause�continue�stop�stopped)Z automaticZmanual�disabled)rL rM Z
start_pendingZ
pause_pendingZcontinue_pendingZ stop_pendingrR r� � display_namer� �statusr� ZbinpathZ
start_type� description) rv r< �win_service_iterZas_dictr r� r- r� r� �
is_running�win_service_getr� )r> Zvalid_statusesZvalid_start_typesZservr5 r� r� �sr r r �test_win_service_iterH s0
z"TestServices.test_win_service_iterc C s� t jjj}t jjj}tt �� ��� }t� t j
�� }t � |d � W d � n1 sT0 Y |j j|d ksrJ �t � |�}t
r�ddd|f}n|df}t|� }tjd|d��D t� t j
�� |�� W d � n1 s�0 Y W d � n1 s�0 Y tjd|d��F t� t j
�� |�� W d � n1 �s<0 Y W d � n1 �s\0 Y t
�rzddd|f}n|df}t|� }tjd|d��F t� t j�� |�� W d � n1 �s�0 Y W d � n1 �s�0 Y tjd|d��F t� t j�� |�� W d � n1 �s,0 Y W d � n1 �sL0 Y |�� t|�v �slJ �|�� t|�v �s�J �|�� t|�v �s�J �|�� t|�v �s�J �d S )Nz???r r z/psutil._psplatform.cext.winservice_query_statusr� z/psutil._psplatform.cext.winservice_query_config)r< r r� � ERROR_SERVICE_DOES_NOT_EXIST�ERROR_ACCESS_DENIED�nextrW r� r r� r� rY r� r
r� r r� rU r� r� r� rT r� )r> r\ r] r� �cmZservicer% r r r r �test_win_service_gett sP �
,
�D�H�H�Hz!TestServices.test_win_service_getN)r r r r[ r` r r r r rK F s ,rK ):r r� r r( r: r� r� r� r) r6 r �warningsr< r Zpsutil._compatr r r Z psutil.testsr r r r r
r r r
r r r r r r r �catch_warnings� simplefilterrA r� r� rK Zpsutil._pswindowsr r r� r[ r\ r r" r9 r6 r7 r] r� r� r r r# rK r r r r �<module> s|
( � ( #F OHW]PK ok\�n�E 0 psutil/tests/__pycache__/test_osx.cpython-39.pycnu �[��� a
��?h� � @ s d Z ddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
ddlm Z dd lm Z dd
lm
Z
dd lmZ dd lmZ dd
lmZ er�ddlmZ dd� Zdd� Ze jje dd�G dd� de ��Ze jje dd�G dd� de ��ZdS )zmacOS specific tests.� N)�MACOS)�POSIX)� HAS_BATTERY)�TOLERANCE_DISK_USAGE)�TOLERANCE_SYS_MEM)�PsutilTestCase)�pytest)�retry_on_failure)�sh)�spawn_testproc)� terminate)� getpagesizec C s: t | �}|�� d }z
t|�W S ty4 | Y S 0 dS )zmExpects a sysctl command with an argument and parse the result
returning only the value of interest.
� N)r
�split�int�
ValueError)Zcmdline�out�result� r �A/usr/local/lib64/python3.9/site-packages/psutil/tests/test_osx.py�sysctl s
r c C sH t d�}|�d�D ]}| |v r q,qtd��tt�d|��d��t� S )z)Wrapper around 'vm_stat' cmdline utility.�vm_stat�
zline not foundz\d+r )r
r r r �re�search�groupr
)�fieldr �liner r r r + s r z
MACOS only��reasonc @ s, e Zd Zedd� �Zedd� �Zdd� ZdS )� TestProcessc C s t � j| _d S �N)r �pid��clsr r r �
setUpClass8 s zTestProcess.setUpClassc C s t | j� d S r! )r r" r# r r r �
tearDownClass< s zTestProcess.tearDownClassc C s� t d| j �}|�dd��� }|�d�d }|�d�d }t�| j��� }|t� dt�
|��ksdJ �|t� dt�
|��ks~J �d S ) Nzps -o lstart -p %sZSTARTED� � ������z%H:%M:%Sz%Y) r
r" �replace�stripr �psutil�ProcessZ create_time�time�strftime� localtime)�self�outputZstart_psZhhmmss�yearZ start_psutilr r r �test_process_create_time@ s
�
z$TestProcess.test_process_create_timeN)�__name__�
__module__� __qualname__� classmethodr% r& r5 r r r r r 6 s
r c @ s� e Zd Ze� dd� �Zdd� Zdd� Zejj e
o:e � � dkdd �d
d � �Z
d d
� Ze� dd� �Ze� dd� �Ze� dd� �Ze� dd� �Ze� dd� �Ze� dd� �Zdd� Zejj e d d �d d � �Zd S ) �TestSystemAPIsc C s� dd� }t jdd�D ]j}t �|j�}||j�\}}}}|j|ksDJ �|j|ksRJ �t|j| �tk shJ �t|j | �tk sJ �qd S )Nc S s� t d| ��� }|�d�}|�d� |�d�}|�� d d� \}}}}|dkrRd}t|�d }t|�d }t|�d }||||fS )Nz
df -k "%s"r r � �noner' i )r
r, r �popr )�pathr �linesr �dev�total�used�freer r r �dfU s
z%TestSystemAPIs.test_disks.<locals>.dfF)�all)
r- Zdisk_partitions�
disk_usageZ
mountpointZdevicerA �absrC r rB )r2 rD �part�usager@ rA rB rC r r r �
test_disksQ s
zTestSystemAPIs.test_disksc C s t d�}|tjdd�ks J �d S )Nzsysctl hw.logicalcpuT��logical�r r- � cpu_count�r2 �numr r r �test_cpu_count_logicall s z%TestSystemAPIs.test_cpu_count_logicalc C s t d�}|tjdd�ks J �d S )Nzsysctl hw.physicalcpuFrK rM rO r r r �test_cpu_count_coresp s z#TestSystemAPIs.test_cpu_count_cores�arm64zskipped due to #1892r c C sZ t �� }|jd d td�ks"J �|jd d td�ks<J �|jd d td�ksVJ �d S )Ni� zsysctl hw.cpufrequencyzsysctl hw.cpufrequency_minzsysctl hw.cpufrequency_max)r- Zcpu_freq�currentr �min�max)r2 �freqr r r �
test_cpu_frequ s z TestSystemAPIs.test_cpu_freqc C s t d�}|t�� jksJ �d S )Nzsysctl hw.memsize)r r- �virtual_memoryrA )r2 Zsysctl_hwphymemr r r �test_vmem_total� s z TestSystemAPIs.test_vmem_totalc C s* t d�}t�� j}t|| �tk s&J �d S )NrC )r r- rY rC rG r �r2 Z
vmstat_valZ
psutil_valr r r �test_vmem_free� s
z TestSystemAPIs.test_vmem_freec C s* t d�}t�� j}t|| �tk s&J �d S )N�active)r r- rY r] rG r r[ r r r �test_vmem_active� s
z TestSystemAPIs.test_vmem_activec C s* t d�}t�� j}t|| �tk s&J �d S )N�inactive)r r- rY r_ rG r r[ r r r �test_vmem_inactive� s
z!TestSystemAPIs.test_vmem_inactivec C s* t d�}t�� j}t|| �tk s&J �d S )N�wired)r r- rY ra rG r r[ r r r �test_vmem_wired� s
z TestSystemAPIs.test_vmem_wiredc C s* t d�}t�� j}t|| �tk s&J �d S )NZPageins)r r- � swap_memory�sinrG r r[ r r r �test_swapmem_sin� s
z TestSystemAPIs.test_swapmem_sinc C s* t d�}t�� j}t|| �tk s&J �d S )NZPageout)r r- rc ZsoutrG r r[ r r r �test_swapmem_sout� s
z TestSystemAPIs.test_swapmem_soutc C sr t �� �� D ]`\}}ztd| �}W n ty6 Y q 0 |jd|v ksNJ |��|jtt� d|�d �ks J �q d S )Nz ifconfig %s�RUNNINGz mtu (\d+)r )
r- Z net_if_stats�itemsr
� RuntimeErrorZisupZmtur r �findall)r2 �name�statsr r r r �test_net_if_stats� s z TestSystemAPIs.test_net_if_statsz
no batteryc C s` t d�}t�d|��d�}t�d|��d�}|dk}t�� }|j|ksJJ �|jt|�ks\J �d S )Nz
pmset -g battz(\d+)%r zNow drawing from '([^']+)'zAC Power) r
r r r r- Zsensors_battery�
power_plugged�percentr )r2 r ro Z drawing_fromrn Z
psutil_resultr r r �test_sensors_battery� s z#TestSystemAPIs.test_sensors_batteryN)r6 r7 r8 r rJ rQ rR r �mark�skipifr �platform�machinerX rZ r\ r^ r` rb re rf rm r rp r r r r r: L s0
�
r: )�__doc__rs r r/ r- r r Z psutil.testsr r r r r r r
r r Zpsutil._psutil_posixr
r r rq rr r r: r r r r �<module> s. PK ok\�J�>C) C) 2 psutil/tests/__pycache__/test_linux.cpython-39.pycnu �[��� a
��?h[d � @ s d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# ddlm$Z$ ddlm%Z% ddlm&Z& ddlm'Z' ddlm(Z( ddlm)Z) ddlm*Z* dd lm+Z+ dd lm,Z, dd lm-Z- e�r�dd l.m/Z/ dd l.m0Z0 dd!l.m1Z1 dd"l.m2Z2 ej3�4ej3�5e6��Z7d#Z8d$Z9d%Z:d&Z;d'Z<e�r,d(Z=e�d)� Z>d*d+� Z?d,d-� Z@d.d/� ZAd0d1� ZBd2d3� ZCd4d5� ZDd6d7� ZEd8d9� ZFd:d;� ZGejHd<d=� �ZIejHd>d?� �ZJe'jKjLe d@dA�G dBdC� dCe#��ZMe'jKjLe d@dA�G dDdE� dEe#��ZNe'jKjLe d@dA�G dFdG� dGe#��ZOe'jKjLe d@dA�G dHdI� dIe#��ZPe'jKjLe d@dA�G dJdK� dKe#��ZQe'jKjLe d@dA�G dLdM� dMe#��ZRe'jKjLe d@dA�G dNdO� dOe#��ZSe'jKjLe d@dA�G dPdQ� dQe#��ZTe'jKjLe d@dA�G dRdS� dSe#��ZUe'jKjLe d@dA�G dTdU� dUe#��ZVe'jKjLe d@dA�G dVdW� dWe#��ZWe'jKjLe d@dA�e'jKjLe dXdA�G dYdZ� dZe#���ZXe'jKjLe d@dA�G d[d\� d\e#��ZYe'jKjLe d@dA�G d]d^� d^e#��ZZe'jKjLe d@dA�G d_d`� d`e#��Z[e'jKjLe d@dA�G dadb� dbe#��Z\e'jKjLe d@dA�G dcdd� dde#��Z]e'jKjLe d@dA�G dedf� dfe#��Z^e'jKjLe d@dA�e'jKjLe dgdA�G dhdi� die#���Z_e'jKjLe d@dA�G djdk� dke#��Z`e'jKjLe d@dA�G dldm� dme#��Zae'jKjLe d@dA�G dndo� doe#��Zbe'jKjLe d@dA�G dpdq� dqe#��Zce'jKjLe d@dA�G drds� dse#��Zde'jKjLe d@dA�G dtdu� due#��ZedS )vzLinux specific tests.� )�divisionN)�LINUX)�PY3)�FileNotFoundError)�
basestring)�AARCH64)�GITHUB_ACTIONS)�GLOBAL_TIMEOUT)� HAS_BATTERY)� HAS_CPU_FREQ)�HAS_GETLOADAVG)�
HAS_RLIMIT)�PYPY)�PYTEST_PARALLEL)� QEMU_USER)�TOLERANCE_DISK_USAGE)�TOLERANCE_SYS_MEM)�PsutilTestCase)�
ThreadTask)�
call_until)�mock)�pytest)�
reload_module)�retry_on_failure)� safe_rmpath)�sh)�skip_on_not_implemented)�which)� CLOCK_TICKS)�RootFsDeviceFinder)�calculate_avail_vmem)� open_binaryi� i� i'� i� i� i z/sys/class/hwmon/hwmon*c C s� dd l }| d d� } tr"t| d�} t�tjtj�}t�|��8 t�|� |�
� t t �
d| ��dd� �W d � S 1 sz0 Y d S �Nr � �ascii�256s� � )�fcntlr �bytes�socket�AF_INET�
SOCK_DGRAM�
contextlib�closing� inet_ntoa�ioctl�fileno� SIOCGIFADDR�struct�pack��ifnamer( �s� r8 �C/usr/local/lib64/python3.9/site-packages/psutil/tests/test_linux.py�get_ipv4_addressN s
��r: c C s� dd l }| d d� } tr"t| d�} t�tjtj�}t�|��8 t�|� |�
� t t �
d| ��dd� �W d � S 1 sz0 Y d S r" )r( r r) r* r+ r, r- r. r/ r0 r1 �SIOCGIFNETMASKr3 r4 r5 r8 r8 r9 �get_ipv4_netmask] s
���r< c C s� dd l }| d d� } tr"t| d�} t�tjtj�}t�|��8 t�|� |�
� t t �
d| ��dd� �W d � S 1 sz0 Y d S r" )r( r r) r* r+ r, r- r. r/ r0 r1 �SIOCGIFBRDADDRr3 r4 r5 r8 r8 r9 �get_ipv4_broadcastl s
���r> c C s� t d��T}g }|D ]"}|�� }|d | kr|�|� qt|�dkrNtd| ��W d � n1 sb0 Y tt|��D ]j}|| d }g }tdt|�d�D ]}|�|||d � � q�d�|�} t�tj | �}
t�
tj |
�||< qx|S )Nz/proc/net/if_inet6���r zcould not find interface %r� �:) �open�split�append�len�
ValueError�range�joinr* � inet_pton�AF_INET6� inet_ntop) r6 �fZ
all_fields�line�fields�iZ unformatted�groups�j� formatted�packedr8 r8 r9 �get_ipv6_addresses{ s"
*
rT c s� dd l }| d d� } tr"t| d�} t�tjtj�}t�|��n |�|� � t
t � d| ��}trfdd� � ndd l
}|j� d�� fdd �|d
d � D ��d d � W d � S 1 s�0 Y d S )
Nr r# r$ r% c S s | S �Nr8 ��xr8 r8 r9 �ord� s z get_mac_address.<locals>.ord� c s g | ]}d � |� �qS )z%02x:r8 )�.0�char�rX r8 r9 �
<listcomp>� � z#get_mac_address.<locals>.<listcomp>� r' r? )r( r r) r* r+ r, r- r. r0 r1 �
SIOCGIFHWADDRr3 r4 � __builtin__rX rH )r6 r( r7 �infora r8 r\ r9 �get_mac_address� s
�
rc c C s� t ddgddid�} | �d�}|D ]F}|�d�r"|�� \}}}}t�dd�}|t|�t|�t|�� S q"td d�|� ��d
S ) zQParse 'free' cmd and return swap memory's s total, used and free
values.
�free�-b�LANG�C.UTF-8��env�
ZSwapztotal used freez&can't find 'Swap' in 'free' output:
%sN)r rC �
startswith� collections�
namedtuple�intrF rH )�out�linesrM �_�total�usedrd �ntr8 r8 r9 � free_swap� s
�ru c C s� t ddgddid�} | �d�}|D ]P}|�d�r"dd � |�� d
d � D �\}}}}t�dd �}|||||| � S q"td
d�|� ��dS )zSParse 'free' cmd and return physical memory's total, used
and free values.
rd re rf rg rh rj ZMemc s s | ]}t |�V qd S rU )rn �rZ rW r8 r8 r9 � <genexpr>� r^ z free_physmem.<locals>.<genexpr>� � z total used free shared outputz%can't find 'Mem' in 'free' output:
%sN)r rC rk rl rm rF rH )ro rp rM rr rs rd �sharedrt r8 r8 r9 � free_physmem� s
"� �r{ c C sZ t ddgddid�}|�d�D ]*}|�� }| |v r t|�d�d � S q td | ��d S )
N�vmstatz-srf rg rh rj � r z can't find %r in 'vmstat' output)r rC �striprn rF )�statro rM r8 r8 r9 r| � s r| c C s@ t ddg��� } d| v r"t�d��tttt�d| � � d ���S )Nrd z-V�UNKNOWNz can't determine free versionz\d+r? )
r r~ r �skip�tuple�maprn �re�findallrC )ro r8 r8 r9 �get_free_version_info� s
r� c # sX � �fdd�}t � trdnd}tj|d|d��}|V W d � n1 sJ0 Y dS )z�Mock open() builtin and forces it to return a certain content
for a given path. `pairs` is a {"path": "content", ...} dict.
c sZ | �v r@�| }t r4t|t�r(t�|�S t�|�S qVt�|�S n� | g|�R i |��S d S rU )r �
isinstancer �io�StringIO�BytesIO)�name�args�kwargs�content�� orig_open�pairsr8 r9 � open_mock� s
z$mock_open_content.<locals>.open_mock�
builtins.open�__builtin__.openT��create� side_effectN�rB r r �patch)r� r� � patch_point�mr8 r� r9 �mock_open_content� s
r� c # sZ � ��fdd�}t �tr dnd}tj|d|d��}|V W d � n1 sL0 Y dS )zZMock open() builtin and raises `exc` if the path being opened
matches `for_path`.
c s( | �kr� �n�| g|�R i |��S d S rU r8 �r� r� r� ��exc�for_pathr� r8 r9 r� � s z&mock_open_exception.<locals>.open_mockr� r� Tr� Nr� )r� r� r� r� r� r8 r� r9 �mock_open_exception� s
r� z
LINUX only��reasonc @ sL e Zd Zdd� Ze� dd� �Ze� dd� �Ze� dd� �Ze� d d
� �Zd S ) �"TestSystemVirtualMemoryAgainstFreec C s" t � j}t�� j}||ks J �d S rU )r{ rr �psutil�virtual_memory��selfZ cli_value� psutil_valuer8 r8 r9 �
test_total s
z-TestSystemVirtualMemoryAgainstFree.test_totalc C sR t � dk rt�d��t � dkr(t�d��t� j}t�� j}t|| �tk sNJ �d S )N�� r� � �free version too old�r@ r r �free version too recent) r� r r� r{ rs r� r� �absr r� r8 r8 r9 � test_used s
z,TestSystemVirtualMemoryAgainstFree.test_usedc C s* t � j}t�� j}t|| �tk s&J �d S rU )r{ rd r� r� r� r r� r8 r8 r9 � test_free' s
z,TestSystemVirtualMemoryAgainstFree.test_freec C sP t � }|j}|dkr t�d��t�� j}t|| �tk sLJ d|||jf ��d S )Nr z%free does not support 'shared' column� %s %s
%s) r{ rz r r� r� r� r� r �output)r� rd �
free_valuer� r8 r8 r9 � test_shared- s
��z.TestSystemVirtualMemoryAgainstFree.test_sharedc C sr t ddg�}|�d�}d|d vr.t�d��n@t|d �� d �}t�� j}t|| �t k snJ d |||f ��d S )
Nrd re rj � availabler z(free does not support 'available' columnrx r? r� )
r rC r r� rn r� r� r� r� r )r� ro rp r� r� r8 r8 r9 �test_available8 s
� �z1TestSystemVirtualMemoryAgainstFree.test_availableN) �__name__�
__module__� __qualname__r� r r� r� r� r� r8 r8 r8 r9 r� s
r� c @ sZ e Zd Zdd� Ze� dd� �Ze� dd� �Ze� dd� �Ze� d d
� �Ze� d d � �Z d
S )�$TestSystemVirtualMemoryAgainstVmstatc C s. t d�d }t�� j}t|| �tk s*J �d S )Nz total memory� )r| r� r� rr r� r �r� Z vmstat_valuer� r8 r8 r9 r� J s
z/TestSystemVirtualMemoryAgainstVmstat.test_totalc C sV t � dk rt�d��t � dkr(t�d��td�d }t�� j}t|| �tk sRJ �d S )Nr� r� r� r� z used memoryr� ) r� r r� r| r� r� rs r� r r� r8 r8 r9 r� O s
z.TestSystemVirtualMemoryAgainstVmstat.test_usedc C s. t d�d }t�� j}t|| �tk s*J �d S )Nz free memoryr� )r| r� r� rd r� r r� r8 r8 r9 r� a s
z.TestSystemVirtualMemoryAgainstVmstat.test_freec C s. t d�d }t�� j}t|| �tk s*J �d S )Nz
buffer memoryr� )r| r� r� �buffersr� r r� r8 r8 r9 � test_buffersg s
z1TestSystemVirtualMemoryAgainstVmstat.test_buffersc C s. t d�d }t�� j}t|| �tk s*J �d S )Nz
active memoryr� )r| r� r� �activer� r r� r8 r8 r9 � test_activem s
z0TestSystemVirtualMemoryAgainstVmstat.test_activec C s. t d�d }t�� j}t|| �tk s*J �d S )Nzinactive memoryr� )r| r� r� �inactiver� r r� r8 r8 r9 �
test_inactives s
z2TestSystemVirtualMemoryAgainstVmstat.test_inactiveN)
r� r� r� r� r r� r� r� r� r� r8 r8 r8 r9 r� H s
r� c @ sB e Zd Zdd� Ze� dd� �Zdd� Zdd� Zd d
� Zd d � Z d
S )� TestSystemVirtualMemoryMocksc C s� t �d��� }td|i���^}tjdd���.}t�d� t�� }|j sJJ �t
|�dksZJ �|d }dt |j �v stJ �d t |j �v s�J �d
t |j �v s�J �d t |j �v s�J �d t |j �v s�J �d
t |j �v s�J �dt |j �v s�J �|j
dks�J �|jdks�J �|jdk�s J �|jdk�s J �|jdk�s,J �|jdk�s<J �|jdk�sLJ �W d � n1 �sb0 Y W d � n1 �s�0 Y d S )NaL Active(anon): 6145416 kB
Active(file): 2950064 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemAvailable: -1 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
SReclaimable: 346648 kB
�
/proc/meminfoT��record�alwaysrx r z#memory stats couldn't be determined�cachedrz r� r� r� r� )�textwrap�dedent�encoder� �warnings�catch_warnings� simplefilterr� r� �calledrE �str�messager� r� r� rz r� r� �slab�r� r� r� �ws�ret�wr8 r8 r9 �test_warnings_on_misses| s,
z4TestSystemVirtualMemoryMocks.test_warnings_on_missesc C s� i }t d��:}|D ]$}|�� }t|d �d ||d < qW d � n1 sL0 Y t|�}d|v r�|d }t|| �| d }|dk s�J �d S )Nr� rx r� r s
MemAvailable:�d r# )r! rC rn r r� )r� ZmemsrL rM rN �a�bZ diff_percentr8 r8 r9 �test_avail_old_percent� s
8z3TestSystemVirtualMemoryMocks.test_avail_old_percentc C s� t �d��� }td|i��v}tjdd��}t�� }W d � n1 sF0 Y |jsZJ �|j dkshJ �|d }dt
|j �v s�J �W d � n1 s�0 Y d S )Na Active: 9444728 kB
Active(anon): 6145416 kB
Active(file): 2950064 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemAvailable: 6574984 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
SReclaimable: 346648 kB
r� Tr� l �" r �,inactive memory stats couldn't be determined� r� r� r� r� r� r� r� r� r� r� r� r� r� r8 r8 r9 � test_avail_old_comes_from_kernel� s &
�z=TestSystemVirtualMemoryMocks.test_avail_old_comes_from_kernelc C s� t �d��� }td|i��v}tjdd��}t�� }W d � n1 sF0 Y |jsZJ �|j dkshJ �|d }dt
|j �v s�J �W d � n1 s�0 Y d S )Nat Active: 9444728 kB
Active(anon): 6145416 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
r� Tr� � `LG r r� r� r� r8 r8 r9 � test_avail_old_missing_fields� s &
�z:TestSystemVirtualMemoryMocks.test_avail_old_missing_fieldsc
C s� t �d��� }td|i��� tdttjd���l tj dd��@}t
� � }|j dksTJ �|d }d t
|j�v snJ �W d � n1 s�0 Y W d � n1 s�0 Y W d � n1 s�0 Y d S )
Na� Active: 9444728 kB
Active(anon): 6145416 kB
Active(file): 2950064 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
SReclaimable: 346648 kB
r� z/proc/zoneinfo�no such file or directoryTr� r� r r� )r� r� r� r� r� �IOError�errno�ENOENTr� r� r� r� r� r� r� )r� r� r� r� r� r8 r8 r9 � test_avail_old_missing_zoneinfo� s
���z<TestSystemVirtualMemoryMocks.test_avail_old_missing_zoneinfoc C s� t �d��� }td|i���}t�� }|js.J �|jdks<J �|jdksJJ �|j dksXJ �|j
dksfJ �|j dkstJ �|j dks�J �|j
d ks�J �|jd
ks�J �|jd ks�J �W d � n1 s�0 Y d S ) Na� MemTotal: 100 kB
MemFree: 2 kB
MemAvailable: 3 kB
Buffers: 4 kB
Cached: 5 kB
SwapCached: 6 kB
Active: 7 kB
Inactive: 8 kB
Active(anon): 9 kB
Inactive(anon): 10 kB
Active(file): 11 kB
Inactive(file): 12 kB
Unevictable: 13 kB
Mlocked: 14 kB
SwapTotal: 15 kB
SwapFree: 16 kB
Dirty: 17 kB
Writeback: 18 kB
AnonPages: 19 kB
Mapped: 20 kB
Shmem: 21 kB
Slab: 22 kB
SReclaimable: 23 kB
SUnreclaim: 24 kB
KernelStack: 25 kB
PageTables: 26 kB
NFS_Unstable: 27 kB
Bounce: 28 kB
WritebackTmp: 29 kB
CommitLimit: 30 kB
Committed_AS: 31 kB
VmallocTotal: 32 kB
VmallocUsed: 33 kB
VmallocChunk: 34 kB
HardwareCorrupted: 35 kB
AnonHugePages: 36 kB
ShmemHugePages: 37 kB
ShmemPmdMapped: 38 kB
CmaTotal: 39 kB
CmaFree: 40 kB
HugePages_Total: 41 kB
HugePages_Free: 42 kB
HugePages_Rsvd: 43 kB
HugePages_Surp: 44 kB
Hugepagesize: 45 kB
DirectMap46k: 46 kB
DirectMap47M: 47 kB
DirectMap48G: 48 kB
r� i � i � i p i T i i i X � )r� r� r� r� r� r� r� rr rd r� r� rz r� r� r� r� )r� r� r� Zmemr8 r8 r9 �test_virtual_memory_mocked s 2
z7TestSystemVirtualMemoryMocks.test_virtual_memory_mockedN)
r� r� r� r� r r� r� r� r� r� r8 r8 r8 r9 r� z s $
r� c @ s\ e Zd Zedd� �Zdd� Ze� dd� �Ze� dd� �Zd d
� Z d d � Z
d
d� Z dd� Z dS )�TestSystemSwapMemoryc C s@ t d��} | �� }W d � n1 s&0 Y d|v o>d|v S )z3Return True if /proc/meminfo provides swap metrics.r� Nz
SwapTotal:z SwapFree:)rB �read)rL �datar8 r8 r9 �meminfo_has_swap_infoN s
&z*TestSystemSwapMemory.meminfo_has_swap_infoc C s* t � j}t�� j}t|| �tk s&J �d S rU )ru rr r� � swap_memoryr� r �r� r� r� r8 r8 r9 r� U s
z TestSystemSwapMemory.test_totalc C s* t � j}t�� j}t|| �tk s&J �d S rU )ru rs r� r� r� r r� r8 r8 r9 r� Z s
z TestSystemSwapMemory.test_usedc C s* t � j}t�� j}t|| �tk s&J �d S rU )ru rd r� r� r� r r� r8 r8 r9 r� ` s
z TestSystemSwapMemory.test_freec C s� t jddd���}tjdd��r}t�d� t�� }|js:J �t|�dksJJ �|d }dt |j
�v sdJ �|j dksrJ �|j dks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S ) N�psutil._common.openT�r� r� r� rx r z9'sin' and 'sout' swap memory stats couldn't be determined)
r r� r� r� r� r� r� r� rE r� r� �sin�sout�r� r� r� r� r� r8 r8 r9 �test_missing_sin_soutf s
��z*TestSystemSwapMemory.test_missing_sin_soutc C s� t dttjd����}tjdd��r}t�d� t�� }|j s>J �t
|�dksNJ �|d }dt |j �v shJ �|j
dksvJ �|jdks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S ) Nz /proc/vmstatr� Tr� r� rx r zK'sin' and 'sout' swap memory stats couldn't be determined and were set to 0)r� r� r� r� r� r� r� r� r� r� rE r� r� r� r� r� r8 r8 r9 �test_no_vmstat_mockedu s �
��z*TestSystemSwapMemory.test_no_vmstat_mockedc C s� | � � st�d��t�d��}t�� }W d � n1 s:0 Y |jrNJ �dd lm } |�
� \}}}}}}}||9 }||9 }|j |ks�J �t |j
| �tk s�J �d S )Nz!/proc/meminfo has no swap metricsz"psutil._pslinux.cext.linux_sysinfor )r� r r� r r� r� r� r� Zpsutil._psutil_linuxZ
_psutil_linuxZ
linux_sysinforr r� rd r )r� r� �swapZcextrq rr rd Zunit_multiplierr8 r8 r9 � test_meminfo_against_sysinfo� s
&
z1TestSystemSwapMemory.test_meminfo_against_sysinfoc C sB t ddi��"}t�� |js J �W d � n1 s40 Y d S )Nr� r^ )r� r� r� r� �r� r� r8 r8 r9 �#test_emulate_meminfo_has_no_metrics� s z8TestSystemSwapMemory.test_emulate_meminfo_has_no_metricsN)
r� r� r� � staticmethodr� r� r r� r� r� r� r� r� r8 r8 r8 r9 r� L s
r� c @ s e Zd Zdd� ZdS )�TestSystemCPUTimesc C s� t �� j}t�dt�� d �d }ttt |�
d���}|dkrLd|v sXJ �n d|vsXJ �|dkrnd|v szJ �n d|vszJ �|d kr�d
|v s�J �n d
|vs�J �d S ) Nz
\d+\.\d+\.\d+� r �.)r� � � �steal)r� r r' Zguest)r� r� r Z
guest_nice) r� � cpu_times�_fieldsr� r� �os�unamer� r� rn rC )r� rN Z
kernel_verZkernel_ver_infor8 r8 r9 � test_fields� s
z TestSystemCPUTimes.test_fieldsN)r� r� r� r r8 r8 r8 r9 r� � s r� c @ s� e Zd Zejjej�d� dd�dd� �Z ejjej�d� dd�dd � �Z
ejje d
� d d�d d
� �Z ejje d� dd�dd� �Z
dd� ZdS )�TestSystemCPUCountLogical� /sys/devices/system/cpu/onlinez-/sys/devices/system/cpu/online does not existr� c C sj t d�� }|�� �� }W d � n1 s*0 Y dt|�v rft|�d�d �d }t�� |ksfJ �d S )Nr
�-rx )rB r� r~ r� rn rC r� � cpu_count)r� rL �valuer8 r8 r9 � test_against_sysdev_cpu_online� s
* z8TestSystemCPUCountLogical.test_against_sysdev_cpu_online�/sys/devices/system/cpuz&/sys/devices/system/cpu does not existc C s0 t �d�}tdd� |D ��}t�� |ks,J �d S )Nr c S s g | ]}t �d |�dur|�qS )zcpu\d+$N)r� �searchrv r8 r8 r9 r] � r^ zITestSystemCPUCountLogical.test_against_sysdev_cpu_num.<locals>.<listcomp>)r �listdirrE r� r )r� Zls�countr8 r8 r9 �test_against_sysdev_cpu_num� s
z5TestSystemCPUCountLogical.test_against_sysdev_cpu_numZnprocznproc utility not availablec C s$ t td��}tjdd�|ks J �d S )Nz nproc --allT��logical)rn r r� r )r� �numr8 r8 r9 �test_against_nproc� s z,TestSystemCPUCountLogical.test_against_nproc�lscpu�lscpu utility not availablec C s8 t d�}tdd� |�d�D ��}tjdd�|ks4J �d S )N�lscpu -pc S s g | ]}|� d �s|�qS )�#�rk rv r8 r8 r9 r] � r^ z@TestSystemCPUCountLogical.test_against_lscpu.<locals>.<listcomp>rj Tr )r rE rC r� r )r� ro r r8 r8 r9 �test_against_lscpu� s z,TestSystemCPUCountLogical.test_against_lscpuc C s� dd l }|j�� }tjdtd���`}|j�� |ks6J �|js@J �tjddd��F}|j�� d u sbJ �|jdkspJ �|jd d dks�J �W d � n1 s�0 Y t d d
��}|�
� }W d � n1 s�0 Y t � |�}tjd|dd ��$}|j�� |k�sJ �W d � n1 �s 0 Y t
d d i��0}|j�� |k�sHJ �|j�sTJ �W d � n1 �sj0 Y W d � n1 �s�0 Y d S )
Nr zpsutil._pslinux.os.sysconf�r� r� Tr� r� �
/proc/stat�
/proc/cpuinfo�rb�� return_valuer� r^ )�psutil._pslinux�_pslinuxZcpu_count_logicalr r� rF r� Z
call_countZ call_argsrB r� r� r� r� )r� r� �originalr� rL Z cpuinfo_data� fake_filer8 r8 r9 �test_emulate_fallbacks� s.
�
4 &
�4z0TestSystemCPUCountLogical.test_emulate_fallbacksN)r� r� r� r �mark�skipifr �path�existsr r r r r r( r8 r8 r8 r9 r � s& �
�
�
�
r c @ s: e Zd Zejjed� dd�dd� �Zdd� Zdd � Z d
S ) �TestSystemCPUCountCoresr r r� c C s\ t d�}t� }|�d�D ]&}|�d�s|�d�}|�|d � qtjdd�t|�ksXJ �d S )Nr rj r �,rx Fr )r �setrC rk �addr� r rE )r� ro Zcore_idsrM rN r8 r8 r9 r s
z*TestSystemCPUCountCores.test_against_lscpuc C sd t j�� }tjdg d��$}t j�� }|js.J �W d � n1 sB0 Y |d ur`||ks`J �d S )N� glob.glob�r# )r� r% �cpu_count_coresr r� r� )r� Zmeth_1r� Zmeth_2r8 r8 r9 �
test_method_2 s
(z%TestSystemCPUCountCores.test_method_2c C s� t jdg d��P}t jddd��"}tj�� d u s2J �W d � n1 sF0 Y W d � n1 sd0 Y |jsxJ �|js�J �d S )Nr1 r2 r� Tr� )r r� r� r% r3 r� )r� �m1�m2r8 r8 r9 �test_emulate_none s
N
z)TestSystemCPUCountCores.test_emulate_noneN)
r� r� r� r r) r* r r r4 r7 r8 r8 r8 r9 r- s
�
r- c @ s� e Zd Zejje dd�dd� �Zejje dd�ejjedd�dd� ��Z ejje dd�dd � �Z
ejje dd�d
d � �Z ejje dd�d d
� �Z dS )�TestSystemCPUFrequency�
not supportedr� c sT � fdd�}t jj� tjd|dd�� t�� s2J �W d � n1 sF0 Y d S )Nc s | � d�rdS � | �S d S )N�&/sys/devices/system/cpu/cpufreq/policyFr �r+ �Z orig_existsr8 r9 �path_exists_mock( s
zMTestSystemCPUFrequency.test_emulate_use_second_file.<locals>.path_exists_mock�os.path.existsT)r� r� )r r+ r, r r� r� �cpu_freq)r� r= r8 r< r9 � test_emulate_use_second_file% s �z3TestSystemCPUFrequency.test_emulate_use_second_filez,aarch64 does not report mhz in /proc/cpuinfoc s� � fdd�}t jj� z�tjd|d��x ttj� t�� }|sDJ |��|j dksRJ �|j
dks`J �tjdd�D ] }|j dks~J �|j
dkslJ �qlW d � n1 s�0 Y W ttj� tt� nttj� tt� 0 d S )Nc s | � d�rdS � | �S d S )Nz/sys/devices/system/cpu/Fr r; �Zos_path_existsr8 r9 r= ; s
zITestSystemCPUFrequency.test_emulate_use_cpuinfo.<locals>.path_exists_mockr> r � T�Zpercpu) r r+ r, r r� r r� r% r? �max�min)r� r= r� �freqr8 rA r9 �test_emulate_use_cpuinfo4 s
0
�
z/TestSystemCPUFrequency.test_emulate_use_cpuinfoc s� � fdd�}t � trdnd}tj||d��� tjddd��V t�� }|jd ksRJ �|jd
krj|jd ksjJ �|jd
kr�|jd ks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )
Nc s� | � d�r | �d�r t�d�S | � d�r<| �d�r<t�d�S | � d�rZ| �d�rZt�d�S | dkrlt�d �S � | g|�R i |��S d S )
N�/scaling_cur_freqr: � 500000�/scaling_min_freq� 600000�/scaling_max_freqs 700000r s cpu MHz : 500��endswithrk r� r� r� �r� r8 r9 r� R s �
�
�
z;TestSystemCPUFrequency.test_emulate_data.<locals>.open_mockr� r� r r> Tr2 � @@rB � ��@g �@� rB r r r� r� r? �currentrE rD �r� r� r� rF r8 rO r9 �test_emulate_dataP s
z(TestSystemCPUFrequency.test_emulate_datac
sb � fdd�}t � trdnd}tj||d��� tjddd��� tjd d
d��� tjdd �}|d jd
kslJ �|d jdkr�|d jdks�J �|d jdkr�|d jdks�J �|d jdks�J �|d jdkr�|d jdks�J �|d jdkr�|d jdks�J �W d � n1 �s0 Y W d � n1 �s40 Y W d � n1 �sT0 Y d S )Nc s� | }|� d�r"|�d�r"t�d�S |� d�r@|�d�r@t�d�S |� d�r^|�d�r^t�d�S |� d�r||�d�r|t�d �S |� d�r�|�d�r�t�d
�S |� d�r�|�d�r�t�d �S | d kr�t�d
�S � | g|�R i |��S d S )NrH z'/sys/devices/system/cpu/cpufreq/policy0s 100000rJ � 200000rL s 300000z'/sys/devices/system/cpu/cpufreq/policy1s 400000rI rK r s# cpu MHz : 100
cpu MHz : 400rM )r� r� r� �nrO r8 r9 r� s s8 �
�
�
�
�
�
z@TestSystemCPUFrequency.test_emulate_multi_cpu.<locals>.open_mockr� r� r r> Tr2 �!psutil._pslinux.cpu_count_logicalr� rC r � Y@rB g i@g �r@rx g y@rP rQ rR rT r8 rO r9 �test_emulate_multi_cpuq s& � z-TestSystemCPUFrequency.test_emulate_multi_cpuc
s� � fdd�}t � trdnd}tj||d��� tjddd��T tjd d
d��& t�� }|jd ksbJ �W d � n1 sv0 Y W d � n1 s�0 Y W d � n1 s�0 Y d S ) Nc sX | � d�rttjd��n<| � d�r,t�d�S | dkr>t�d�S � | g|�R i |��S d S )NrH rY z/cpuinfo_cur_freqrV r s cpu MHz : 200)rN r� r� r� r� r� r� rO r8 r9 r� � s
zOTestSystemCPUFrequency.test_emulate_no_scaling_cur_freq_file.<locals>.open_mockr� r� r r> Tr2 rX rx �� )rB r r r� r� r? rS rT r8 rO r9 �%test_emulate_no_scaling_cur_freq_file� s
�z<TestSystemCPUFrequency.test_emulate_no_scaling_cur_freq_fileN)
r� r� r� r r) r* r r@ r rG rU rZ r\ r8 r8 r8 r9 r8 # s
�
3r8 c @ s e Zd Zdd� ZdS )�TestSystemCPUStatsc C s* t d�}t�� j}t|| �dk s&J �d S )N�
interruptsi� )r| r� Z cpu_statsr^ r� r� r8 r8 r9 �test_interrupts� s
z"TestSystemCPUStats.test_interruptsN)r� r� r� r_ r8 r8 r8 r9 r] � s r] c @ s& e Zd Zejje dd�dd� �ZdS )� TestLoadAvgr9 r� c C s� t �� }td�� }|�� �� }W d � n1 s20 Y tt|d �|d �dk s\J �tt|d �|d �dk s|J �tt|d �|d �dk s�J �d S )Nz
/proc/loadavgr rx r� )r� �
getloadavgrB r� rC r� �float)r� r� rL Z
proc_valuer8 r8 r9 �test_getloadavg� s
* zTestLoadAvg.test_getloadavgN)r� r� r� r r) r* r rc r8 r8 r8 r9 r` � s r` c @ s e Zd Zdd� ZdS )�TestSystemNetIfAddrsc C s� t �� �� D ]�\}}|D ]�}|jt jkr<|jt|�ks�J �q|jtjkr�|jt |�ksZJ �|j
t |�kslJ �|j d ur�|j t
|�ks�J �q�t
|�dks�J �q|jtjkr|j�d�d }|t|�v sJ �qq d S )Nz0.0.0.0�%r )r� Z net_if_addrs�items�familyZAF_LINK�addressrc r* r+ r: �netmaskr< � broadcastr> rJ rC rT )r� r� �addrs�addrrh r8 r8 r9 �test_ips� s
z TestSystemNetIfAddrs.test_ipsN)r� r� r� rm r8 r8 r8 r9 rd � s rd �QEMU user not supportedc @ sP e Zd Zejjed� dd�dd� �Zdd� Zejjed� dd�dd � �Z d
S ) �TestSystemNetIfStats�ifconfig� ifconfig utility not availabler� c C sr t �� �� D ]`\}}ztd| �}W n ty6 Y q 0 |jd|v ksNJ |��|jtt� d|�d �ks J �q d S )N� ifconfig %s�RUNNINGz(?i)MTU[: ](\d+)r )
r� � net_if_statsrf r � RuntimeErrorZisup�mturn r� r� )r� r� �statsro r8 r8 r9 �test_against_ifconfig s �z*TestSystemNetIfStats.test_against_ifconfigc C s` t �� �� D ]N\}}td| ��*}|jt|�� �� �ks<J �W d � q 1 sP0 Y q d S )Nz/sys/class/net/%s/mtu)r� rt rf rB rv rn r� r~ )r� r� rw rL r8 r8 r9 �test_mtu s z TestSystemNetIfStats.test_mtuc C s
d}t �� �� D ]�\}}ztd| �}W n ty: Y q0 t�d|�}|r�t|�� �dkr�|d7 }t |�
d�� � � d��}t |j
� d��}||ks�J �qt�d|�}|rt|�� �dkr|d7 }t |�
d�� � � � �}t |j
� d��}||ksJ �q|�s| �d ��d S )
Nr rr zflags=(\d+)?<(.*?)>r� rx r. z (.*) MTU:(\d+) Metric:(\d+)r� zno matches were found)r� rt rf r ru r� r rE rP r/ �group�lowerrC �flags�fail)r� Z
matches_foundr� rw ro �matchZifconfig_flagsZ psutil_flagsr8 r8 r9 �
test_flags s( z TestSystemNetIfStats.test_flagsN)
r� r� r� r r) r* r rx ry r r8 r8 r8 r9 ro s
�
�ro c @ s0 e Zd Zejjed� dd�e� dd� ��ZdS )�TestSystemNetIOCountersrp rq r� c C s$ dd� }t jddd�}|�� D � ]�\}}z ||�}W n tyJ Y q Y n0 t|j|d �dk sfJ �t|j|d �dk s�J �t|j|d �d
k s�J �t|j|d �d
k s�J �t|j |d �d
k s�J �t|j
|d �d
k s�J �t|j |d �d
k �sJ �t|j |d �d
k s J �q d S )Nc S s� i }t d| �}tt�d|�d �|d< tt�d|�d �|d< tt�d|�d �|d< tt�d|�d �|d
< tt�d |�d �|d < tt�d |�d �|d
< tt�d|�d �|d< tt�d|�d �|d< |S )Nrr zRX packets[: ](\d+)r � packets_recvzTX packets[: ](\d+)� packets_sentzerrors[: ](\d+)�errinrx �erroutzdropped[: ](\d+)�dropin�dropoutz#RX (?:packets \d+ +)?bytes[: ](\d+)�
bytes_recvz#TX (?:packets \d+ +)?bytes[: ](\d+)�
bytes_sent)r rn r� r� )Znicr� ro r8 r8 r9 rp E s& ����z?TestSystemNetIOCounters.test_against_ifconfig.<locals>.ifconfigTF)Zpernic�nowrapr� i ( r� r� r� r� r� �
r� r� r� )
r� �net_io_countersrf ru r� r� r� r� r� r� r� r� r� )r� rp Znior� rw Z ifconfig_retr8 r8 r9 rx @ s&
���� z-TestSystemNetIOCounters.test_against_ifconfigN) r� r� r� r r) r* r r rx r8 r8 r8 r9 r� > s
�r� c @ s8 e Zd Zejded�ejddd�dd� ��Zdd � Zd
S ) �TestSystemNetConnectionsz psutil._pslinux.socket.inet_ntopr z psutil._pslinux.supports_ipv6Fr2 c C sP z*t � t jt j�}| �|j� |�d� W n t jy> Y n0 tjdd� d S )N)z::1r Zinet6��kind) r* rJ � SOCK_STREAMZ
addCleanup�close�bind�errorr� �net_connections)r� Z
supports_ipv6rK r7 r8 r8 r9 � test_emulate_ipv6_unsupportedt s z6TestSystemNetConnections.test_emulate_ipv6_unsupportedc C sP t �d�}td|i��&}tjdd� |js.J �W d � n1 sB0 Y d S )Na 0: 00000003 000 000 0001 03 462170 @/tmp/dbus-Qw2hMPIU3n
0: 00000003 000 000 0001 03 35010 @/tmp/dbus-tB2X8h69BQ
0: 00000003 000 000 0001 03 34424 @/tmp/dbus-cHy80Y8O
000000000000000000000000000000000000000000000000000000
z/proc/net/unix�unixr� )r� r� r� r� r� r� )r� r� r� r8 r8 r9 �test_emulate_unix� s
z*TestSystemNetConnections.test_emulate_unixN)r� r� r� r r� rF r� r� r8 r8 r8 r9 r� r s
r� c @ sB e Zd Zejjeed� dd�e� dd� ��Z dd� Z
dd � Z d
S ) �TestSystemDiskPartitions�statvfszos.statvfs() not availabler� c C sv dd� }t jdd�D ]\}t �|j�}||j�\}}}}|j|ksDJ �t|j| �tk sZJ �t|j| �tk sJ �qd S )Nc S sz t d| ��� }|�d�}|�d� |�d�}|�� d d� \}}}}|dkrRd}t|�t|�t|� }}}||||fS )Nzdf -P -B 1 "%s"rj r r@ �nonerY )r r~ rC �poprn )r+ ro rp rM �devrr rs rd r8 r8 r9 �df� s
z4TestSystemDiskPartitions.test_against_df.<locals>.dfF)�all) r� �disk_partitions�
disk_usageZ
mountpointrr r� rd r rs )r� r� �part�usagerq rr rs rd r8 r8 r9 �test_against_df� s z(TestSystemDiskPartitions.test_against_dfc C s t d��}|�� }W d � n1 s&0 Y d|v r`t�� D ]}|jdkr@ q^q@| �d��n�t�d�}tj d|dd��v}tj dd gd
��F}t�� }|j
s�J �|j
s�J �|s�J �|d jdks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S ) Nz/proc/filesystems�zfsz couldn't find any ZFS partitionz
nodev zfs
r� Tr" �$psutil._pslinux.cext.disk_partitions)z /dev/sdb3�/r� �rwr2 r ) rB r� r� r� Zfstyper} r� r� r r� r� )r� rL r� r� r' r5 r6 r� r8 r8 r9 � test_zfs_fs� s,
&
��
z$TestSystemDiskPartitions.test_zfs_fsc C s� ztt jddd��L}t�t�� t�� W d � n1 s:0 Y |jsNJ �W d � n1 sb0 Y W dt_ndt_0 d S )Nzos.path.realpathz
/non/existentr2 �/proc) r r� r �raisesr r� r� r� � PROCFS_PATHr� r8 r8 r9 �test_emulate_realpath_fail� s � &*z3TestSystemDiskPartitions.test_emulate_realpath_failN) r� r� r� r r) r* �hasattrr r r� r� r� r8 r8 r8 r9 r� � s � r� c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dS )�TestSystemDiskIoCountersc C s� d}t d|i��� tjddd��� tjdd�}|jdks<J �|jd ksJJ �|jd
t ks\J �|j d ksjJ �|j
d ksxJ �|j d
ks�J �|j dt ks�J �|j
dks�J �|jdks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nz+ 3 0 1 hda 2 3 4 5 6 7 8 9 10 11 12�/proc/diskstats�!psutil._pslinux.is_storage_deviceTr2 F�r� rx r� r� r@ ry r � � r� �r� r r� r� �disk_io_counters�
read_count�read_merged_count�
read_bytes� SECTOR_SIZE� read_time� write_count�write_merged_count� write_bytes�
write_time� busy_time�r� r� r� r8 r8 r9 �test_emulate_kernel_2_4� s � z0TestSystemDiskIoCounters.test_emulate_kernel_2_4c C s� d}t d|i��� tjddd��� tjdd�}|jdks<J �|jd ksJJ �|jd
t ks\J �|j d ksjJ �|j
d ksxJ �|j d
ks�J �|j dt ks�J �|j
dks�J �|jdks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nz' 3 0 hda 1 2 3 4 5 6 7 8 9 10 11r� r� Tr2 Fr� rx r� r� r@ ry r r� r� r� r� r� r8 r8 r9 � test_emulate_kernel_2_6_full� s � z5TestSystemDiskIoCounters.test_emulate_kernel_2_6_fullc C s� t ddi��� tjddd��� tjdd�}|jdks8J �|jd t ksJJ �|jd
ksXJ �|j d t ksjJ �|j
d ksxJ �|j d ks�J �|j d ks�J �|j
d ks�J �|jd ks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )
Nr� z 3 1 hda 1 2 3 4r� Tr2 Fr� rx r� r� r@ r )r� r r� r� r� r� r� r� r� r� r� r� r� r� r� )r� r� r8 r8 r9 � test_emulate_kernel_2_6_limited� s � z8TestSystemDiskIoCounters.test_emulate_kernel_2_6_limitedc C s� t �d�}td|i��� tjddd��v tjddd�}t|�dksFJ �|d jd
ksXJ �|d jd
ksjJ �|d j d ks|J �|d j d ks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )
N�x 3 0 nvme0n1 1 2 3 4 5 6 7 8 9 10 11
3 0 nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
r� r� Fr2 T��perdiskr� r� �nvme0n1rx Z nvme0n1p1ry )
r� r� r� r r� r� r� rE r� r� r� r8 r8 r9 � test_emulate_include_partitions s
�z8TestSystemDiskIoCounters.test_emulate_include_partitionsc C s t �d�}td|i��X tjddd��* tjddd�}|d u sBJ �W d � n1 sV0 Y W d � n1 st0 Y dd� }t �d�}td|i��j tjdd |d
��: tjddd�}|jd ks�J �|jd ks�J �W d � n1 s�0 Y W d � n1 �s0 Y d S )
Nr� r� r� Fr2 r� c S s | dkS )Nr� r8 )r� r8 r8 r9 �is_storage_device4 s zSTestSystemDiskIoCounters.test_emulate_exclude_partitions.<locals>.is_storage_deviceTr� rx ry ) r� r� r� r r� r� r� r� r� )r� r� r� r� r8 r8 r9 � test_emulate_exclude_partitions% s$
�H
�z8TestSystemDiskIoCounters.test_emulate_exclude_partitionsc C sh dd� }t jdd�}tjdd|d�� t jdd�}W d � n1 sF0 Y t|�t|�ksdJ �d S )Nc S s | dkS )Nr� r8 r; r8 r8 r9 r, F s z?TestSystemDiskIoCounters.test_emulate_use_sysfs.<locals>.existsT)r� � psutil._pslinux.os.path.existsr� )r� r� r r� rE )r� r, ZwprocfsZwsysfsr8 r8 r9 �test_emulate_use_sysfsE s �*z/TestSystemDiskIoCounters.test_emulate_use_sysfsc C sn dd� }t jdd|d��B t�t�� t�� W d � n1 sB0 Y W d � n1 s`0 Y d S )Nc S s dS )NFr8 r; r8 r8 r9 r, Q s z>TestSystemDiskIoCounters.test_emulate_not_impl.<locals>.existsr� Tr� )r r� r r� �NotImplementedErrorr� r� )r� r, r8 r8 r9 �test_emulate_not_implP s � z.TestSystemDiskIoCounters.test_emulate_not_implN)
r� r� r� r� r� r� r� r� r� r� r8 r8 r8 r9 r� � s r� c @ sj e Zd Zdd� Zdd� Zejjedd�dd� �Z ejje
d � d
d�ejjedd�d d � ��Z d
d� Z dS )�TestRootFsDeviceFinderc C s( t �d�j}t �|�| _t �|�| _d S )Nr� )r r �st_dev�major�minor)r� r� r8 r8 r9 �setUp] s z TestRootFsDeviceFinder.setUpc C s� t � }tj�d�r |�� n2t�t�� |�� W d � n1 sD0 Y tj�d| j| j f �rp|�
� n2t�t�� |�
� W d � n1 s�0 Y |� � d S �Nz/proc/partitionsz/sys/dev/block/%s:%s/uevent) r r r+ r, �ask_proc_partitionsr r� r r� r� �ask_sys_dev_block�ask_sys_class_block)r� �finderr8 r8 r9 �test_call_methodsb s
&�
&z(TestRootFsDeviceFinder.test_call_methodsz unsupported on GITHUB_ACTIONSr� c C s� t � }|�� d usJ �d } }}tj�d�r6|�� }tj�d| j| jf �rV|�� }|� � }|ph|ph|}|r~|r~||ks~J �|r�|r�||ks�J �|r�|r�||ks�J �d S r� )
r �findr r+ r, r� r� r� r� r� )r� r� r� r� �c�baser8 r8 r9 �test_comparisonsr s" � z'TestRootFsDeviceFinder.test_comparisonsZfindmntz findmnt utility not availablec C s" t � �� }td�}||ks J �d S )Nzfindmnt -o SOURCE -rn /)r r� r )r� r� Z
findmnt_valuer8 r8 r9 �test_against_findmnt� s
z+TestRootFsDeviceFinder.test_against_findmntc C s� t jddgd��\}t�� d }|js(J �tsP|jdks:J �|jt� �� ks^J �n|jdks^J �W d � n1 sr0 Y d S )Nr� )� /dev/rootr� Zext4r� r2 r r� ) r r� r� r� r� r Zdevicer r� )r� r� r� r8 r8 r9 �test_disk_partitions_mocked� s �
z2TestRootFsDeviceFinder.test_disk_partitions_mockedN)
r� r� r� r� r� r r) r* r r� r r� r� r8 r8 r8 r9 r� [ s
� r� c @ sb e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Ze � e
j j e
d
d�dd� ��Zdd� ZdS )�TestMiscc C s( t d�}t�� }t|�t|�ks$J �d S )Nz boot time)r| r� � boot_timern r� r8 r8 r9 �test_boot_time� s zTestMisc.test_boot_timec sb | � � }t�|� ttj�|d�d��.}|�d� |�d� |�d� W d � n1 sZ0 Y �z�t� � fdd�}tr�dnd }tj ||d
���~ t
t � t �
t�� t �� W d � n1 s�0 Y t �
t�� t jd d � W d � n1 s�0 Y t �
t�� t �� W d � n1 �s00 Y t �
t�� t jd d � W d � n1 �sh0 Y t �
t�� t �� W d � n1 �s�0 Y t �
t�� t jd d � W d � n1 �s�0 Y |t _t �� d
k�s�J �tt �� �d
k�s J �t jd d �}t|�d
k�s*J �t jd d �}ttt|��d
k�sNJ �ttj�|d�d��.}|�d� |�d� |�d� W d � n1 �s�0 Y t �� d
k�s�J �tt jd d ��d
k�s�J �tt �� �d
k�s�J �tttt jd d ���d
k�sJ �W d � n1 �s0 Y W t�|� t
t � nt�|� t
t � 0 t jdk�s^J �d S )Nr r� zcpu 0 0 0 0 0 0 0 0 0 0
zcpu0 0 0 0 0 0 0 0 0 0 0
zcpu1 0 0 0 0 0 0 0 0 0 0
c s, | � d�rttjd��� | g|�R i |��S )Nr� zrejecting access for test)rk r� r� r� r� rO r8 r9 r� � s
z4TestMisc.test_no_procfs_on_import.<locals>.open_mockr� r� r TrC r zcpu 1 0 0 0 0 0 0 0 0 0
zcpu0 1 0 0 0 0 0 0 0 0 0
zcpu1 1 0 0 0 0 0 0 0 0 0
r� )�
get_testfnr �mkdirrB r+ rH �writer r r� r r� r r� r� r � cpu_percent�cpu_times_percentr� �sumr� �shutil�rmtree)r� Z my_procfsrL r� r� Zper_cpu_percentZper_cpu_times_percentr8 rO r9 �test_no_procfs_on_import� sZ
( & * ( , ( ,
*�*
�
z!TestMisc.test_no_procfs_on_importc C sj t �d��� }td|i��B}t�� |js.J �tjdd� t�� tjdd� W d � n1 sb0 Y t �d��� }td|i��� t�� }|js�J �tjdd�}t�� }tjdd�}|dks�J �t|�dks�J �t|�dks�J �t|�dks�J �tt t|��dk�sJ �tt t|��dk�s&J �|j
dk�s6J �|j dk�sFJ �W d � n1 �s\0 Y d S )Nz~ cpu 0 0 0 0 0 0 0 1 0 0
cpu0 0 0 0 0 0 0 0 1 0 0
cpu1 0 0 0 0 0 0 0 1 0 0
r TrC z~ cpu 1 0 0 0 0 0 0 0 0 0
cpu0 1 0 0 0 0 0 0 0 0 0
cpu1 1 0 0 0 0 0 0 0 0 0
r rY ) r� r� r� r� r� r� r� r� r� r� r �user)r� r� r� r� Zcpu_percent_percpur� Zcpu_times_percent_percpur8 r8 r9 �test_cpu_steal_decrease� s,
*
z TestMisc.test_cpu_steal_decreasec C sp t jddd��N}t�t�� tj�� W d � n1 s:0 Y |jsNJ �W d � n1 sb0 Y d S )Nr� Tr� ) r r� r r� ru r� r% r� r� r� r8 r8 r9 �test_boot_time_mocked s (z TestMisc.test_boot_time_mockedc C s t �� D ]}|jdvsJ �qd S )N)z:0z:0.0)r� Zusers�host)r� r� r8 r8 r9 �
test_users s zTestMisc.test_usersc C s | � � }t�|� �z�|t_t�t�� t�� W d � n1 sD0 Y t�t�� t� � W d � n1 sv0 Y t�t�� tj dd� W d � n1 s�0 Y t�t�� t�
� W d � n1 s�0 Y t�t�� t� � W d � n1 �s0 Y t�t�� t� � W d � n1 �sF0 Y t�t�� t�
� W d � n1 �sz0 Y t�t�� t�� W d � n1 �s�0 Y t�tj�� t�� W d � n1 �s�0 Y W dt_ndt_0 d S )NTrC r� )r� r r� r� r� r r� r� r� r r� r� r� rt r� Z
NoSuchProcess�Process)r� Ztdirr8 r8 r9 �test_procfs_path s.
& & * & ( ( ( (*zTestMisc.test_procfs_pathzskip if pytest-parallelr� c C s� t � �~ t�� }|�� }t|�tr&dndks0J �t|dd� d�d j}|j|ksTJ �t�|�}|� � |t�
� vsvJ �W d � n1 s�0 Y d S )Nr� r� c S s | j S rU )�idrV r8 r8 r9 �<lambda>H r^ z)TestMisc.test_issue_687.<locals>.<lambda>)�keyrx ) r r� r� �threadsrE r �sortedr� �pidZas_dictZpids)r� �pr� �tid�ptr8 r8 r9 �test_issue_687< s
zTestMisc.test_issue_687c C sL t ddi��,}t�t�� �s J �|js*J �W d � n1 s>0 Y d S )N�/proc/%s/statusrY )r� r� Z
pid_existsr �getpidr� r� r8 r8 r9 � test_pid_exists_no_proc_statusN s z'TestMisc.test_pid_exists_no_proc_statusN)r� r� r� r� r� r� r� r� r� r r r) r* r r� r� r8 r8 r8 r9 r� � s B' r� z
no batteryc @ sj e Zd Zejjed� dd�dd� �Zdd� Zdd � Z d
d � Z
d d
� Z dd� Z dd� Z
dd� Zdd� ZdS )�TestSensorsBatteryZacpizacpi utility not availabler� c C sH t d�}t|�d�d �� �dd��}t�� j}t|| �dk sDJ �d S )Nzacpi -br. rx re rY ) r rn rC r~ �replacer� �sensors_battery�percentr� )r� ro Z
acpi_valuer� r8 r8 r9 � test_percent_ s
z TestSensorsBattery.test_percentc s~ � fdd�}t � trdnd}tj||d��@}t�� jdu s>J �t�� jtjksRJ �|j s\J �W d � n1 sp0 Y d S )Nc s. | � d�rt�d�S � | g|�R i |��S d S )N�z
AC0/onlinez AC/online� 1�rN r� r� r� rO r8 r9 r� h s
z@TestSensorsBattery.test_emulate_power_plugged.<locals>.open_mockr� r� r T)
rB r r r� r� r �
power_pluggedZsecsleftZPOWER_TIME_UNLIMITEDr� �r� r� r� r� r8 rO r9 �test_emulate_power_pluggedf s ��z-TestSensorsBattery.test_emulate_power_pluggedc sj � fdd�}t � trdnd}tj||d��,}t�� jdu s>J �|jsHJ �W d � n1 s\0 Y d S )Nc sF | � d�rttjd��n*| � d�r,t�d�S � | g|�R i |��S d S )Nr rY �/statusZcharging�rN r� r� r� r� r� r� rO r8 r9 r� { s
zBTestSensorsBattery.test_emulate_power_plugged_2.<locals>.open_mockr� r� r T�rB r r r� r� r r r� r r8 rO r9 � test_emulate_power_plugged_2x s z/TestSensorsBattery.test_emulate_power_plugged_2c sj � fdd�}t � trdnd}tj||d��,}t�� jdu s>J �|jsHJ �W d � n1 s\0 Y d S )Nc s. | � d�rt�d�S � | g|�R i |��S d S )Nr � 0r r� rO r8 r9 r� � s
zDTestSensorsBattery.test_emulate_power_not_plugged.<locals>.open_mockr� r� r Fr
r r8 rO r9 � test_emulate_power_not_plugged� s z1TestSensorsBattery.test_emulate_power_not_pluggedc sj � fdd�}t � trdnd}tj||d��,}t�� jdu s>J �|jsHJ �W d � n1 s\0 Y d S )Nc sF | � d�rttjd��n*| � d�r,t�d�S � | g|�R i |��S d S )Nr rY r Z dischargingr r� rO r8 r9 r� � s
zFTestSensorsBattery.test_emulate_power_not_plugged_2.<locals>.open_mockr� r� r Fr
r r8 rO r9 � test_emulate_power_not_plugged_2� s z3TestSensorsBattery.test_emulate_power_not_plugged_2c sj � fdd�}t � trdnd}tj||d��,}t�� jd u s>J �|jsHJ �W d � n1 s\0 Y d S )Nc sF | � d�rttjd��n*| � d�r,t�d�S � | g|�R i |��S d S )N)�"/sys/class/power_supply/AC0/online�!/sys/class/power_supply/AC/onlinerY �#/sys/class/power_supply/BAT0/statuss ???)rk r� r� r� r� r� r� rO r8 r9 r� � s
zETestSensorsBattery.test_emulate_power_undetermined.<locals>.open_mockr� r� r r
r r8 rO r9 � test_emulate_power_undetermined� s z2TestSensorsBattery.test_emulate_power_undeterminedc C sL t ddi��,}t�� jdks J �|js*J �W d � n1 s>0 Y d S )N�(/sys/class/power_supply/BAT0/energy_fullr r )r� r� r r r� r� r8 r8 r9 �test_emulate_energy_full_0� s �z-TestSensorsBattery.test_emulate_energy_full_0c
C s� t dttjd���� t dttjd���N tddi��" t�� jdksHJ �W d � n1 s\0 Y W d � n1 sz0 Y W d � n1 s�0 Y d S )Nr rY z(/sys/class/power_supply/BAT0/charge_fullz%/sys/class/power_supply/BAT0/capacitys 88�X )r� r� r� r� r� r� r r �r� r8 r8 r9 �"test_emulate_energy_full_not_avail� s
�
��z5TestSensorsBattery.test_emulate_energy_full_not_availc
C s� t dttjd���� t dttjd���T t dttjd���" t�� jd u sNJ �W d � n1 sb0 Y W d � n1 s�0 Y W d � n1 s�0 Y d S )Nr rY r r )r� r� r� r� r� r r r r8 r8 r9 �test_emulate_no_power� s � �
�z(TestSensorsBattery.test_emulate_no_powerN)r� r� r� r r) r* r r r
r r r r r r r r8 r8 r8 r9 r \ s
r c @ s e Zd Zdd� ZdS )�TestSensorsBatteryEmulatedc s� � fdd�}t � trdnd}tjddgd��N}tj||d�� }t�� d usNJ �W d � n1 sb0 Y W d � n1 s�0 Y |js�J �|js�J �d S ) Nc sV | � d�rt�d�S | � d�r(t�d�S | � d�r<t�d�S � | g|�R i |��S d S )Nz /energy_nowZ60000000z
/power_now�0z /energy_fullZ60000001�rN r� r� r� rO r8 r9 r� � s
z5TestSensorsBatteryEmulated.test_it.<locals>.open_mockr� r� z
os.listdirZBAT0r2 r )rB r r r� r� r r� )r� r� r� ZmlistdirZmopenr8 rO r9 �test_it� s
L
z"TestSensorsBatteryEmulated.test_itN)r� r� r� r r8 r8 r8 r9 r � s r c @ s e Zd Zdd� Zdd� ZdS )�TestSensorsTemperaturesc s� � fdd�}t � trdnd}tj||d��� tjddgd��X t�� d d
}|jd ks\J �|jd ksjJ �|jd
ksxJ �|j dks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nc s~ | � d�rt�d�S | � d�r(t�d�S | � d�r<t�d�S | � d�rPt�d�S | � d �rdt�d
�S � | g|�R i |��S d S ) N�/namer� z /temp1_label�labelz /temp1_input� 30000z
/temp1_maxs 40000z /temp1_crit� 50000)rN r� r� r� r� rO r8 r9 r� � s
zCTestSensorsTemperatures.test_emulate_class_hwmon.<locals>.open_mockr� r� r r1 z /sys/class/hwmon/hwmon0/temp1r2 r� r r" � >@g D@� I@�
rB r r r� r� Zsensors_temperaturesr" rS �high�critical)r� r� r� �tempr8 rO r9 �test_emulate_class_hwmon� s �z0TestSensorsTemperatures.test_emulate_class_hwmonc s� � fdd�}dd� }t � tr dnd}tj||d��� tjdd |d
��X t�� d d }|jd
ksdJ �|jdksrJ �|jdks�J �|j dks�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nc sj | � d�rt�d�S | � d�r(t�d�S | � d�r<t�d�S | � d�rPt�d�S � | g|�R i |��S d S ) NZ0_tempr$ r* r# Z0_typer) �typer� )rN r� r� r� r� rO r8 r9 r� s
zETestSensorsTemperatures.test_emulate_class_thermal.<locals>.open_mockc S s: | dkr g S | dkrg S | dkr&dgS | dkr6ddgS g S )Nz /sys/class/hwmon/hwmon*/temp*_*z&/sys/class/hwmon/hwmon*/device/temp*_*z /sys/class/thermal/thermal_zone*z /sys/class/thermal/thermal_zone0z,/sys/class/thermal/thermal_zone0/trip_point*z2/sys/class/thermal/thermal_zone1/trip_point_0_typez2/sys/class/thermal/thermal_zone1/trip_point_0_tempr8 r; r8 r8 r9 � glob_mock$ s �zETestSensorsTemperatures.test_emulate_class_thermal.<locals>.glob_mockr� r� r r1 Tr� r� r rY r% r& r' )r� r� r- r� r* r8 rO r9 �test_emulate_class_thermal s z2TestSensorsTemperatures.test_emulate_class_thermalN)r� r� r� r+ r. r8 r8 r8 r9 r � s r c @ s e Zd Zdd� ZdS )�TestSensorsFansc s� � fdd�}t � trdnd}tj||d��l tjddgd��< t�� d d
}|jd ks\J �|jd ksjJ �W d � n1 s~0 Y W d � n1 s�0 Y d S )
Nc sV | � d�rt�d�S | � d�r(t�d�S | � d�r<t�d�S � | g|�R i |��S d S )Nr! r� z /fan1_labelr" z /fan1_input�2000r r� rO r8 r9 r� @ s
z4TestSensorsFans.test_emulate_data.<locals>.open_mockr� r� r r1 z /sys/class/hwmon/hwmon2/fan1r2 r� r r" i� )rB r r r� r� Z sensors_fansr" rS )r� r� r� Zfanr8 rO r9 rU ? s
�z!TestSensorsFans.test_emulate_dataN)r� r� r� rU r8 r8 r8 r9 r/ = s r/ c @ s� e Zd Ze� dd� �Zdd� Zejje dd�dd� �Z
d d
� Z d d � Z d
d� Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zejje d d�d d!� �Zd"d#� Zd$d%� Zd&d'� Zd(S ))� TestProcessc C s� | � � }tj�|j��� \}}}t�|j�jdd�}t|tdd� |D �� �dk sVJ �t|tdd� |D �� �dk sxJ �t|tdd� |D �� �dk s�J �d S )NF)Zgroupedc S s g | ]}|j |j �qS r8 )Z
private_dirtyZ
private_cleanrv r8 r8 r9 r] b r^ z?TestProcess.test_parse_smaps_vs_memory_maps.<locals>.<listcomp>r� c S s g | ]
}|j �qS r8 )�pssrv r8 r8 r9 r] e r^ c S s g | ]
}|j �qS r8 )r� rv r8 r8 r9 r] f r^ ) Zspawn_testprocr� r% r� r� � _parse_smaps� memory_mapsr� r� )r� Zsproc�ussr2 r� �mapsr8 r8 r9 � test_parse_smaps_vs_memory_maps\ s ��"z+TestProcess.test_parse_smaps_vs_memory_mapsc C s� t �d��� }tdt�� |i��\}tj�t�� �}|� � \}}}|j
sLJ �|dksXJ �|dksdJ �|dkspJ �W d � n1 s�0 Y d S )Nan fffff0 r-xp 00000000 00:00 0 [vsyscall]
Size: 1 kB
Rss: 2 kB
Pss: 3 kB
Shared_Clean: 4 kB
Shared_Dirty: 5 kB
Private_Clean: 6 kB
Private_Dirty: 7 kB
Referenced: 8 kB
Anonymous: 9 kB
LazyFree: 10 kB
AnonHugePages: 11 kB
ShmemPmdMapped: 12 kB
Shared_Hugetlb: 13 kB
Private_Hugetlb: 14 kB
Swap: 15 kB
SwapPss: 16 kB
KernelPageSize: 17 kB
MMUPageSize: 18 kB
Locked: 19 kB
VmFlags: rd ex
�/proc/%s/smapsi l r� i < ) r� r� r� r� r r� r� r% r� r3 r� )r� r� r� r� r5 r2 r� r8 r8 r9 �test_parse_smaps_mockedh s
z#TestProcess.test_parse_smaps_mockedzunreliable on PYPYr� c C s dd� }| � � }t|d��" ||�jdks.J �W d � n1 sB0 Y t|��" ||�jdkshJ �W d � n1 s|0 Y t|d��" ||�jdks�J �W d � n1 s�0 Y t|d��" ||�jdks�J �W d � n1 s�0 Y t|d��$ ||�jdk�s J �W d � n1 �s40 Y t|d��$ ||�jdk�s^J �W d � n1 �st0 Y t�rt|� t|d ��$ ||�jdk�s�J �W d � n1 �s�0 Y t|� t|d
��$ ||�jdk�s�J �W d � n1 �s
0 Y d S ) Nc S sZ t �� }t�� t }|�� D ].}|jtj�| �kr:| S t�� |kr qq qtd��d S )Nz timeout looking for test file) r� r� �timer �
open_filesr+ r �abspathru )�fnamer� Z giveup_at�filer8 r8 r9 �
get_test_file� s z7TestProcess.test_open_files_mode.<locals>.get_test_filer� �rr� zr+zw+za+rW zx+)r� rB �moder r )r� r? Ztestfnr8 r8 r9 �test_open_files_mode� s* 0
0 0 0 4 4 4 z TestProcess.test_open_files_modec s� t �� ���� � t| �� d��� t� �fdd�� tjdtt j
d�d��*}��� g ksZJ �|j sdJ �W d � n1 sx0 Y tjdtt j d�d��*}��� g ks�J �|j s�J �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nr� c s t ��� �t � �kS rU �rE r; r8 ��filesr� r8 r9 r� � r^ z7TestProcess.test_open_files_file_gone.<locals>.<lambda>�psutil._pslinux.os.readlinkrY r )
r� r� r; rB r� r r r� �OSErrorr� r� r� �EINVALr� r8 rD r9 �test_open_files_file_gone� s$
�(
�z%TestProcess.test_open_files_file_gonec s� t �� ���� � t| �� d��~ t� �fdd�� tr:dnd}tj|t t
j d�d��*}��� g ksfJ �|j spJ �W d � n1 s�0 Y W d � n1 s�0 Y d S )Nr� c s t ��� �t � �kS rU rC r8 rD r8 r9 r� � r^ z5TestProcess.test_open_files_fd_gone.<locals>.<lambda>r� r� rY r )
r� r� r; rB r� r r r r� r� r� r� r� �r� r� r� r8 rD r9 �test_open_files_fd_gone� s �z#TestProcess.test_open_files_fd_gonec
s� t �� ���� � t| �� d��� t� �fdd�� d}tj|tt j
d�d��T}t�d��* ��� g ksjJ �|j stJ �W d � n1 s�0 Y W d � n1 s�0 Y W d � n1 s�0 Y d S )Nr� c s t ��� �t � �kS rU rC r8 rD r8 r9 r� � r^ z:TestProcess.test_open_files_enametoolong.<locals>.<lambda>rF rY r �psutil._pslinux.debug) r� r� r; rB r� r r r� rG r� � ENAMETOOLONGr� rJ r8 rD r9 � test_open_files_enametoolong� s � z(TestProcess.test_open_files_enametoolongc C sX t jdi d��6}tj�t�� ��� d u s,J �|js6J �W d � n1 sJ0 Y d S )Nz)psutil._pslinux._psposix.get_terminal_mapr2 ) r r� r� r% r� r r� Zterminalr� r� r8 r8 r9 �test_terminal_mocked� s � z TestProcess.test_terminal_mockedc C s� t �� }t�d�}tjd|dd��.}|�� ddgks8J �|jsBJ �W d � n1 sV0 Y t�d�}tjd|dd��.}|�� g d�ks�J �|js�J �W d � n1 s�0 Y d S ) Nzfoo bar r� Tr" �foo�barz foo bar �rP rQ rY �r� r� r� r� r r� Zcmdliner� �r� r� r' r� r8 r8 r9 �test_cmdline_mocked� s
�(
�z TestProcess.test_cmdline_mockedc C s� t �� }t�d�}tjd|dd��.}|�� ddgks8J �|jsBJ �W d � n1 sV0 Y t�d�}tjd|dd��.}|�� g d�ks�J �|js�J �W d � n1 s�0 Y d S ) Nzfoo bar r� Tr" rP rQ z foo bar rR rS rT r8 r8 r9 �test_cmdline_spaces_mocked s
�(
�z&TestProcess.test_cmdline_spaces_mockedc C sd t �� }t�d�}tjd|dd��.}|�� ddgks8J �|jsBJ �W d � n1 sV0 Y d S )Nzfoo bar r� Tr" rP rQ rS rT r8 r8 r9 � test_cmdline_mixed_separators s
�z)TestProcess.test_cmdline_mixed_separatorsc C sZ t jddd��8 t�� �� dks$J �t�� �� dks8J �W d � n1 sL0 Y d S )NrF z/home/foo (deleted)r2 z /home/foo)r r� r� r� �exe�cwdr r8 r8 r9 �!test_readlink_path_deleted_mocked! s
�z-TestProcess.test_readlink_path_deleted_mockedc s� � fdd�}t � trdnd}tj||d��2}t�� �� }|jsBJ �|g ksNJ �W d � n1 sb0 Y � fdd�}tj||d��H t� tj
�� t�� �� W d � n1 s�0 Y W d � n1 s�0 Y d S )Nc s: | � dt�� �r ttjd��n� | g|�R i |��S d S �Nz
/proc/%s/taskrY )rk r r� r� r� r� r� rO r8 r9 � open_mock_1- s z4TestProcess.test_threads_mocked.<locals>.open_mock_1r� r� r c s: | � dt�� �r ttjd��n� | g|�R i |��S d S r[ )rk r r� r� r� �EPERMr� rO r8 r9 � open_mock_2< s z4TestProcess.test_threads_mocked.<locals>.open_mock_2) rB r r r� r� r� r� r� r r� Z AccessDenied)r� r\ r� r� r� r^ r8 rO r9 �test_threads_mocked( s
* z TestProcess.test_threads_mockedc C s� t jdttjd�d��`}t jdg d��2 t�� �� }|js>J �|dksJJ �W d � n1 s^0 Y W d � n1 s|0 Y d S )Nzpsutil._pslinux.readlinkrY r z psutil._pslinux.Process.cmdliner2 ) r r� rG r� r� r� r� rX r� )r� r� r� r8 r8 r9 �test_exe_mockedF s ��
zTestProcess.test_exe_mockedc C s� t dt�� ttjd���T}t�� }t� t
�� |� � W d � n1 sL0 Y |j s`J �W d � n1 st0 Y d S )Nr8 rY )
r� r r� r� r� r� r� r� r r� r r4 r� �r� r� r� r8 r8 r9 �test_issue_1014R s � &zTestProcess.test_issue_1014r9 c
C s� t jdttjd�d���}t jddd��X}t�� }|�� t� tj
�� }|� tj � W d � n1 sf0 Y W d � n1 s�0 Y W d � n1 s�0 Y |j
s�J �|j
s�J �|jj|jks�J �|jj|�� ks�J �d S )Nzpsutil._pslinux.prlimitrY r z"psutil._pslinux.Process._is_zombieTr2 )r r� rG r� ZENOSYSr� r� r� r r� Z
ZombieProcessZrlimitZ
RLIMIT_NOFILEr� r
r� )r� r5 r6 r� �cmr8 r8 r9 �test_rlimit_zombie] s ��f
z TestProcess.test_rlimit_zombiec C s g d�}d� |��� }tdt�� |i��� t�� }|�� dksDJ �|�� tj ksVJ �|�
� dksfJ �|� � dt t�
� ks�J �|�� }|jdt ks�J �|jdt ks�J �|jd t ks�J �|jd
t ks�J �|jd t ks�J �|�� dks�J �W d � n1 �s
0 Y d S ) N)*r z(cat)�Z�1r r r r r r r r r �2�3�4�5r r r r �6r r r r r r r r r r r r r r r r rk r r �7r} z
/proc/%s/stat�catrx r r� r� r@ ry r� )rH r� r� r r� r� r� r� �statusZ
STATUS_ZOMBIE�ppidZ create_timer r� r r� �system�
children_user�children_systemZiowaitZcpu_num)r� r� r� r� �cpur8 r8 r9 �test_stat_file_parsingq s , z"TestProcess.test_stat_file_parsingc C s t �d��� }tdt�� |i��� t�� }|�� j dks>J �|�� j
dksPJ �|� � dks`J �|� � }|j
dksvJ �|jdks�J �|jdks�J �|�� }|j
d ks�J �|jd
ks�J �|jd ks�J �|j�� ttd ��ks�J �W d � n1 s�0 Y d S )
Nz� Uid: 1000 1001 1002 1003
Gid: 1004 1005 1006 1007
Threads: 66
Cpus_allowed: f
Cpus_allowed_list: 0-7
voluntary_ctxt_switches: 12
nonvoluntary_ctxt_switches: 13r� r� �
�B i� i� i� i� i� i� r� )r� r� r� r� r r� r� r� �num_ctx_switches� voluntary� involuntary� num_threads�uids�realZ effectiveZsaved�gids�_proc�_get_eligible_cpus�listrG )r� r� r� r{ r} r8 r8 r9 �test_status_file_parsing� s z$TestProcess.test_status_file_parsingc C s� t jdttjd�d��\}t�� }t �d��* |�� g ks<J �|jsFJ �W d � n1 sZ0 Y W d � n1 sx0 Y d S )NrF rY r rL ) r r� rG r� rM r� r� r� r� ra r8 r8 r9 �!test_net_connections_enametoolong� s
� z-TestProcess.test_net_connections_enametoolongN)r� r� r� r r7 r9 r r) r* r rB rI rK rN rO rU rV rW rZ r_ r` rb r
rd rt r� r� r8 r8 r8 r9 r1 Z s*
"
"
<r1 c @ s� e Zd ZdZedd� �Zdd� Zdd� Zej j
e dd �d
d � �Z d d
� Z
dd� Zdd� Zdd� Ze� dd� �Zdd� Zdd� ZdS )�TestProcessAgainstStatusa /proc/pid/stat and /proc/pid/status have many values in common.
Whenever possible, psutil uses /proc/pid/stat (it's faster).
For all those cases we check that the value found in
/proc/pid/stat (by psutil) matches the one found in
/proc/pid/status.
c C s t �� | _d S rU )r� r� �proc)�clsr8 r8 r9 �
setUpClass� s z#TestProcessAgainstStatus.setUpClassc
C s� t j�d| jj ���}|D ]j}|�� }|�|�r|�d�d }z t|�W W d � S t y� | Y W d � S 0 qt d| ��W d � n1 s�0 Y d S )Nr� � r� z
can't find %r)
r� � _psplatform� open_textr� r� r~ rk � partitionrn rF )r� Z linestartrL rM r
r8 r8 r9 �read_status_file� s
�
z)TestProcessAgainstStatus.read_status_filec C s | � d�}| j�� |ks J �d S )NzName:)r� r� r� �r� r
r8 r8 r9 � test_name� s
z"TestProcessAgainstStatus.test_namern r� c C sH | � d�}||�d�d |�d�� }|�dd�}| j�� |ksDJ �d S )NzState:�(rx �)r} r )r� r� �rfindr r� rn r� r8 r8 r9 � test_status� s
z$TestProcessAgainstStatus.test_statusc C s | � d�}| j�� |ks J �d S )NzPPid:)r� r� ro r� r8 r8 r9 � test_ppid� s
z"TestProcessAgainstStatus.test_ppidc C s | � d�}| j�� |ks J �d S )NzThreads:)r� r� rz r� r8 r8 r9 �test_num_threads� s
z)TestProcessAgainstStatus.test_num_threadsc C s: | � d�}ttt|�� dd� ��}| j�� |ks6J �d S )NzUid:rx r@ )r� r� r� rn rC r� r{ r� r8 r8 r9 � test_uids s
z"TestProcessAgainstStatus.test_uidsc C s: | � d�}ttt|�� dd� ��}| j�� |ks6J �d S )NzGid:rx r@ )r� r� r� rn rC r� r} r� r8 r8 r9 � test_gids s
z"TestProcessAgainstStatus.test_gidsc C s@ | � d�}| j�� j|ks J �| � d�}| j�� j|ks<J �d S )Nzvoluntary_ctxt_switches:znonvoluntary_ctxt_switches:)r� r� rw rx ry r� r8 r8 r9 �test_num_ctx_switches s
z.TestProcessAgainstStatus.test_num_ctx_switchesc C sN | � d�}dt|�v rJtt|�d��\}}| j�� tt||d ��ksJJ �d S )N�Cpus_allowed_list:r rx ) r� r� r� rn rC r� Z cpu_affinityr� rG )r� r
Zmin_Zmax_r8 r8 r9 �test_cpu_affinity s
z*TestProcessAgainstStatus.test_cpu_affinityc C sf | � d�}t�d�� }| jj�� W d � n1 s60 Y dt|�v rX|jrbJ �n
|jsbJ �d S )Nr� z psutil._pslinux.per_cpu_timesr )r� r r� r� r~ r r� r� )r� r
r� r8 r8 r9 � test_cpu_affinity_eligible_cpus s
* z8TestProcessAgainstStatus.test_cpu_affinity_eligible_cpusN)r� r� r� �__doc__� classmethodr� r� r� r r) r* r r� r� r� r� r� r r� r� r� r8 r8 r8 r9 r� � s
r� c @ s e Zd Zdd� ZdS )� TestUtilsc C sP t jddd��.}tj�d�dks$J �|js.J �W d � n1 sB0 Y d S )Nz os.readlinkz
foo (deleted)r2 rQ rP )r r� r� r� �readlinkr� r� r8 r8 r9 �
test_readlink) s zTestUtils.test_readlinkN)r� r� r� r� r8 r8 r8 r9 r� ' s r� )fr� �
__future__r rl r- r� �globr� r r� r� r* r3 r� r: r� r� r Zpsutil._compatr r r Z psutil.testsr r r r
r r r
r r r r r r r r r r r r r r r r r$ r r r r! r+ r< �dirname�__file__ZHEREr2 Z SIOCGIFCONFr` r; r= r� ZEMPTY_TEMPERATURESr: r< r> rT rc ru r{ r| r� �contextmanagerr� r� r) r* r� r� r� r� r� r r- r8 r] r` rd ro r� r� r� r� r� r� r r r r/ r1 r� r� r8 r8 r8 r9 �<module> s
91 RZI '63 A H 8 C zSPK ok\ r.�}� }� 4 psutil/tests/__pycache__/test_process.cpython-39.pycnu �[��� a
��?hn� � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddl m Z ddl m Z ddl m Z ddl m Z ddl m!Z! ddl"m#Z# ddl"m$Z$ ddl"m%Z% ddl"m&Z& ddl"m'Z' ddl"m(Z( ddl"m)Z) ddl"m*Z* ddl"m+Z+ dd l"m,Z, dd l"m-Z- dd l"m.Z. dd l"m/Z/ dd l"m0Z0 dd!l"m1Z1 dd"l"m2Z2 dd#l"m3Z3 dd$l"m4Z4 dd%l"m5Z5 dd&l"m6Z6 dd'l"m7Z7 dd(l"m8Z8 dd)l"m9Z9 dd*l"m:Z: dd+l"m;Z; dd,l"m<Z< dd-l"m=Z= dd.l"m>Z> dd/l"m?Z? dd0l"m@Z@ dd1l"mAZA dd2l"mBZB G d3d4� d4e4�ZCe�r�e�D� dk�r�G d5d6� d6eC�ZEG d7d8� d8e4�ZFdS )9� Tests for psutil.Process class.� N)�AIX)�BSD)�LINUX)�MACOS)�NETBSD)�OPENBSD)�OSX)�POSIX)�SUNOS)�WINDOWS)� open_text)�PY3)�FileNotFoundError)�long)�redirect_stderr)�super)�APPVEYOR)�
CI_TESTING)�GITHUB_ACTIONS)�GLOBAL_TIMEOUT)�HAS_CPU_AFFINITY)� HAS_ENVIRON)�
HAS_IONICE)�HAS_MEMORY_MAPS)�HAS_PROC_CPU_NUM)�HAS_PROC_IO_COUNTERS)�
HAS_RLIMIT)� HAS_THREADS)� MACOS_11PLUS)�PYPY)�
PYTHON_EXE)�PYTHON_EXE_ENV)� QEMU_USER)�PsutilTestCase)�
ThreadTask)�
call_until)�copyload_shared_lib)� create_c_exe)�
create_py_exe)�mock)�process_namespace)�pytest��
reap_children)�retry_on_failure)�sh)�skip_on_access_denied)�skip_on_not_implemented)� wait_for_pidc @ s e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Ze j
j e d d
�dd� �Z
dd� Ze j
j edd
�dd� �Zdd� Zdd� Zdd� Zdd � Zd d � Ze j
j ed d
�d d!� �Ze j
j ed d
�d"d#� �Ze j
j e d$d
�d%d&� �Zd'd(� Ze j
j e d)d
�d*d+� �Z e j
j e d$d
�e e d,�d-d.� ��Z e j
j e! d$d
�e j
j e d/d
�d0d1� ��Z"e j
j e! d$d
�e j
j e# d2d
�d3d4� ��Z$e j
j e% d$d
�d5d6� �Z&e j
j e% d$d
�d7d8� �Z'e j
j e% d$d
�d9d:� �Z(e j
j e% d$d
�d;d<� �Z)e j
j e% d$d
�d=d>� �Z*d?d@� Z+e j
j e# dAd
�dBdC� �Z,e j
j e- d$d
�dDdE� �Z.e/� e0e1d,�e j
j e- d$d
�dFdG� ���Z2e/� dHdI� �Z3dJdK� Z4e j
j e5 d$d
�dLdM� �Z6e j
j e5 d$d
�dNdO� �Z7dPdQ� Z8dRdS� Z9e j
j ed d
�dTdU� �Z:dVdW� Z;e j
j e<dXd
�dYdZ� �Z=d[d\� Z>e j
j e<�ped]d
�e j
j ed^d
�d_d`� ��Z?e j
j e@dad
�e j
j eAdbd
�e j
j e<dXd
�e j
j edcd
�ddde� ����ZBe j
j e d)d
�dfdg� �ZCe j
j e d)d
�dhdi� �ZDdjdk� ZEe j
j ed d
�dldm� �ZFdndo� ZGdpdq� ZHdrds� ZIe j
j eJ d$d
�dtdu� �ZKe j
j eJ d$d
�dvdw� �ZLe j
j eJ d$d
�dxdy� �ZMe j
j eNdzd
�e j
j eOd{d
�d|d}� ��ZPe j
j eNdzd
�e j
j eOd{d
�d~d� ��ZQe j
j e d)d
�d�d�� �ZRe e d,�e j
j eS�p�ed�d
�d�d�� ��ZTd�d�� ZUd�d�� ZVd�d�� ZWe j
j ed d
�e/� d�d�� ��ZXd�d�� ZYd�d�� ZZd�d�� Z[d�d�� Z\d�d�� Z]d�d�� Z^d�d�� Z_d�d�� Z`d�d�� Zad�d�� Zbd�d�� Zce j
j e d)d
�d�d�� �Zde j
j e d)d
�d�d�� �Zee j
j e d)d
�d�d�� �Zfd�d�� Zgd�d�� Zhe j
j ei d$d
�d�d�� �Zje j
j ei d$d
�e j
j e d)d
�e j
j ekd�d
�e j
j ed�d
�d�d�� ����Zld�S )�� TestProcessr c O sF | j |i |��}zt�|j�W S tjy@ | �|j� � Y n0 d S �N)�spawn_testproc�psutil�Process�pid�
NoSuchProcessZ
assertPidGone)�self�args�kwargs�sproc� r? �E/usr/local/lib64/python3.9/site-packages/psutil/tests/test_process.py� spawn_psprocS s zTestProcess.spawn_psprocc C sN t �� }|jt�� ksJ �t�t�� d|_W d � n1 s@0 Y d S )N�! )r7 r8 r9 �os�getpidr, �raises�AttributeError�r; �pr? r? r@ �test_pid] s zTestProcess.test_pidc C sJ | � � }|�� |�� }tr,|tjks<J �n|tj ks<J �| �|� d S r5 )rA �kill�waitr �signal�SIGTERM�SIGKILL�assertProcessGone�r; rH �coder? r? r@ � test_killc s zTestProcess.test_killc C sJ | � � }|�� |�� }tr,|tjks<J �n|tj ks<J �| �|� d S r5 )rA � terminaterK r rL rM rO rP r? r? r@ �test_terminatem s zTestProcess.test_terminatec C sX t r
tjntj}| �� }|�|� |�� }tr<||ksJJ �n|| ksJJ �| �|� d S r5 ) r
rL rN rM rA � send_signalrK r rO )r; �sigrH rQ r? r? r@ �test_send_signalw s
z TestProcess.test_send_signalz not POSIX��reasonc C s� t j}| �� }tjdttjd�d��F t� t
j �� |� |� W d � n1 sR0 Y W d � n1 sp0 Y | �� }tjdttj
d�d��F t� t
j�� |� |� W d � n1 s�0 Y W d � n1 s�0 Y d S )Nzpsutil.os.kill� �� side_effect)rL rM rA r* �patch�OSError�errnoZESRCHr, rE r7 r: rU �EPERM� AccessDenied)r; rV rH r? r? r@ �test_send_signal_mocked� s �F �z#TestProcess.test_send_signal_mockedc C s� t ddg}| �|�}|�� }|dks(J �| �|� t ddg}| j|tjd�}|�� }|dks`J �| �|� t ddg}| �|�}|�� }|dks�J �| �|� t dd g}| �|�}|�� }|dks�J �| �|� d S )
N�-c�passr z1 / 0)�stderr� zimport sys; sys.exit(5);� zimport os; os._exit(5);)r! rA rK rO �
subprocess�PIPE)r; �cmdrH rQ r? r? r@ �test_wait_exited� s(
z TestProcess.test_wait_exitedzfails on NETBSDc C s� | � � }tr�|�tj� t�tj�� |j dd� W d � n1 sF0 Y |�tj
� t�tj�� |j dd� W d � n1 s�0 Y |�tj � |� � tj ks�J �|� � tj ks�J �n�|� � t�tj�� |j dd� W d � n1 �s0 Y |�
� t�tj�� |j dd� W d � n1 �sD0 Y |�� |� � tj k�sjJ �|� � tj k�s~J �d S )N���MbP?)�timeout)rA r
rU rL �SIGSTOPr, rE r7 �TimeoutExpiredrK �SIGCONTrM �suspend�resumerS rG r? r? r@ �test_wait_stopped� s( * * ,,z TestProcess.test_wait_stoppedc C s� | � � \}}t�tj�� |�d� W d � n1 s80 Y t�tj�� |�d� W d � n1 sn0 Y |�� |�� |�� }|�� }tr�|tj ks�J �|d u s�J �n |tj ks�J �|tj ks�J �d S )N�{�G�z�?)
�spawn_children_pairr, rE r7 ro rK rS r
rL rM )r; �child�
grandchildZ child_retZgrandchild_retr? r? r@ �test_wait_non_children� s ((z"TestProcess.test_wait_non_childrenc C s� | � � }|�� t�tj�� |�d� W d � n1 s<0 Y t�tj�� |�d� W d � n1 sr0 Y t�t�� |�d� W d � n1 s�0 Y d S )Nrt r ���)rA �namer, rE r7 ro rK �
ValueErrorrG r? r? r@ �test_wait_timeout� s (( z TestProcess.test_wait_timeoutc C s� | � � }t�tj�� |�d� W d � n1 s40 Y |�� t�� t }t�� |k r�z|�d�}W q�W qR tjy� Y qR0 qR| � d��t
r�|t j ks�J �n|t j
ks�J �| �|� d S )Nr rm )rA r, rE r7 ro rK rJ �timer �failr
rL rN rM rO )r; rH Zstop_atrQ r? r? r@ � test_wait_timeout_nonblocking� s (
z)TestProcess.test_wait_timeout_nonblockingc C s� t �� }|jdd� |jdd� td�D ]*}|jd d�}t|t�sFJ �|dks(J �q(t�t�� |jdd� W d � n1 s�0 Y d S )Nrl )�interval�d � ry ) r7 r8 � cpu_percent�range�
isinstance�floatr, rE r{ )r; rH �_�percentr? r? r@ �test_cpu_percent� s z TestProcess.test_cpu_percentc C sH t jdd d��&}t�� �� |js&J �W d � n1 s:0 Y d S )Nzpsutil.cpu_count)Z return_value)r* r] r7 r8 r� �called)r; �mr? r? r@ � test_cpu_percent_numcpus_none s z)TestProcess.test_cpu_percent_numcpus_nonezQEMU user not supportedc C s� t �� �� }|jdks J |��|jdks0J |��|jdksBJ |��|jdksTJ |��trj|jdksjJ |��|j D ] }t
� dt
� t
||��� qpd S )Nr� z%H:%M:%S)r7 r8 � cpu_times�user�system�
children_user�children_systemr Ziowait�_fieldsr} �strftime� localtime�getattr)r; �timesrz r? r? r@ �test_cpu_times s
zTestProcess.test_cpu_timesc C s� t �� �� d d� \}}t�� d d� \}}t||g�t||g� dkrZ| �d||f ��t||g�t||g� dkr�| �d||f ��d S )N� 皙�����?zexpected: %s, found: %s)r7 r8 r� rC r� �max�minr~ )r; � user_timeZ kernel_time�utimeZktimer? r? r@ �test_cpu_times_2 s z TestProcess.test_cpu_times_2z
not supportedc C sP t �� }|�� }|dks J �t �� dkr4|dks4J �|�� tt �� �v sLJ �d S �Nr rf )r7 r8 Zcpu_num� cpu_countr� )r; rH �numr? r? r@ � test_cpu_num) s zTestProcess.test_cpu_numc C sZ | � � }t�� }|�� }t|| �}|dkr@| �d|||f ��t�dt�|�� �� d S )Nr� z'expected: %s, found: %s, difference: %sz%Y %m %d %H:%M:%S)rA r} � create_time�absr~ r� r� )r; rH �nowr� �
differencer? r? r@ �test_create_time2 s ��z TestProcess.test_create_timez
POSIX onlyc C sV t �� �� }|d urRztj�td��}W n tyD t� d��Y n0 ||ksRJ �d S )N�ttyzcan't rely on `tty` CLI)
r7 r8 �terminalrC �path�realpathr0 � RuntimeErrorr, �skip)r; r� r� r? r? r@ �
test_terminalD s zTestProcess.test_terminal)Zonly_ifc C s� t �� }|�� }ttd��}|�� W d � n1 s80 Y |�� }ts�ts�|j|jksbJ �|j |j ksrJ �t
r�|j |j ks�J �|j |j ks�J �n |j
|j
ks�J �|j|jks�J �|�� }t| �� d��8}tr�|�tdd d�� n|�dd � W d � n1 �s0 Y |�� }|j |j k�s2J �|j|jk�sDJ �|j|jk�sVJ �|j
|j
k�shJ �t
�r�|j |j k�s�J �|j |j k�s�J �tt|��D ]>}t�r�|dk�r��q�|| dk�s�J �|| dk�s�J ��q�d S )N�rb�wb�xi@B �asciir� r )r7 r8 Z io_counters�openr! �readr r Z
read_countZ write_countr Z
read_charsZ write_chars�
read_bytes� write_bytes�
get_testfnr �write�bytesr� �len)r; rH Zio1�fZio2�ir? r? r@ �test_io_countersP s> &.z TestProcess.test_io_countersz
linux onlyc sR � fdd�}t �� � ts.� �� d t jks.J �t jdks<J �t jdksJJ �t jdksXJ �t jdksfJ �� �� }| �||� � �t j� t � �� �t jdfks�J �t
� t �� � jt jdd� W d � n1 s�0 Y � �t j� t � �� �t jdfk�sJ �� jt jdd� t � �� �t jdfk�s.J �t
� t �� � jt jd d� W d � n1 �s`0 Y z� jt jdd� W n t j
�y� Y n0 t
j t d
d �� � �t jd� W d � n1 �s�0 Y t
j t d
d �� � �t jd� W d � n1 �s0 Y t
j t d d �� � jdd� W d � n1 �sD0 Y d S )
Nc s& | \}}|t jkrd}� �||� d S �Nr )r7 �IOPRIO_CLASS_NONE�ionice)�initZioclass�value�rH r? r@ �cleanup~ s
z.TestProcess.test_ionice_linux.<locals>.cleanupr rf r� � � �r� � zioclass accepts no value��matchz$'ioclass' argument must be specified)r7 r8 r r� r� ZIOPRIO_CLASS_RTZIOPRIO_CLASS_BEZIOPRIO_CLASS_IDLE�
addCleanup�tupler, rE r{ ra )r; r� r� r? r� r@ �test_ionice_linux{ s@ . 0..�z TestProcess.test_ionice_linuxz!not supported on this win versionc C s* t �� }ts |�� t jks J �|�� }| �|j|� |�t j� |�� t jksRJ �|�t j� |�� t jkspJ �z|�t j� W n t j y� Y n0 |�� t jks�J �t
j t dd�� |jt jdd� W d � n1 s�0 Y t
j t
dd�� |�t jd � W d � n1 �s 0 Y d S )Nz&value argument not accepted on Windowsr� rf r� zis not a valid priority)r7 r8 r r� Z
IOPRIO_NORMALr� ZIOPRIO_VERYLOWZ
IOPRIO_LOWZ IOPRIO_HIGHra r, rE � TypeErrorr{ )r; rH r� r? r? r@ �test_ionice_win� s( �.zTestProcess.test_ionice_winc C s� dd l }t�t�� �}dd� tt�D �}|s4J |��|D ]�}tt|�}|dksRJ �|t|�v r�|t||�kspJ �trvq8|�|�|� |�ks�J �q8|�|�}t
|�dks�J �|d dks�J �|d dks8J �q8d S )Nr c S s g | ]}|� d �r|�qS )ZRLIMIT��
startswith��.0r� r? r? r@ �
<listcomp>� � z/TestProcess.test_rlimit_get.<locals>.<listcomp>r� ry rf ) �resourcer7 r8 rC rD �dirr� r �rlimitZ getrlimitr� )r; r� rH �namesrz r� �retr? r? r@ �test_rlimit_get� s
zTestProcess.test_rlimit_getc C s� | � � }|�tjd� |�tj�dks*J �trntjtdd��" tj� d��d� W d � n1 sd0 Y t�t�� |�tjd� W d � n1 s�0 Y d S )N)rg rg zcan't use prlimitr� r )rg rg rg )
rA r� r7 Z
RLIMIT_NOFILEr r, rE r{ Z _psplatformr8 rG r? r? r@ �test_rlimit_set� s 0 zTestProcess.test_rlimit_setc C sH t �� }| �� }|�t j�\}}z�|�t jd|f� t|d��}|�d� W d � n1 s^0 Y t�t ��D}t|d��}|�d� W d � n1 s�0 Y W d � n1 s�0 Y t
r�|j j n|j d t j
ks�J �W |�t j||f� |�t j�||fk�sDJ �n.|�t j||f� |�t j�||fk�sBJ �0 d S )N� r� s XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXs XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXr )r7 r8 r� r� � RLIMIT_FSIZEr� r� r, rE �IOErrorr r� r_ ZEFBIG)r; rH �testfn�soft�hardr� �excr? r? r@ � test_rlimit� s ( F" �zTestProcess.test_rlimitc C s� t �� }|�t j�\}}z�|�t jd|f� |�t jt j|f� t| �� d��}|�d� W d � n1 sn0 Y W |�t j||f� |�t j�||fks�J �n,|�t j||f� |�t j�||fks�J �0 d S )Nr� r� s XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX)r7 r8 r� r� �
RLIM_INFINITYr� r� r� )r; rH r� r� r� r? r? r@ �test_rlimit_infinity� s *�z TestProcess.test_rlimit_infinityc C s< t �� }|�t j�\}}|t jks&J �|�t j||f� d S r5 )r7 r8 r� r� r� )r; rH r� r� r? r? r@ �test_rlimit_infinity_value
s z&TestProcess.test_rlimit_infinity_valuec C s� t �� }tr:z |�� }W qB t jy6 t�d��Y qB0 n|�� }t� �( |�� }||d ksbJ �W d � n1 sv0 Y d S )N�$on OpenBSD this requires root accessrf )r7 r8 r � num_threadsra r, r� r% )r; rH �step1�step2r? r? r@ �test_num_threads s z TestProcess.test_num_threadsz WINDOWS onlyc C s t �� }|�� dksJ �d S r� )r7 r8 Z num_handlesrG r? r? r@ �test_num_handles* s z TestProcess.test_num_handlesc C s� t �� }tr:z |�� }W qB t jy6 t�d��Y qB0 n|�� }t� �n |�� }t|�t|�d ksjJ �|d }|j |d ks�J �|j
|d ks�J �|j |d ks�J �W d � n1 s�0 Y d S )Nr� rf r r� ) r7 r8 r �threadsra r, r� r% r� �idr� � system_time)r; rH r� r� Zathreadr? r? r@ � test_threads0 s zTestProcess.test_threadsc C s� | � � }tr8z |�� W n tjy6 t�d��Y n0 t|�� j t
dd� |�� D �� �dk sdJ �t|�� j t
dd� |�� D �� �dk s�J �d S )Nr� c S s g | ]
}|j �qS r? )r� r� r? r? r@ r� O r� z.TestProcess.test_threads_2.<locals>.<listcomp>r� c S s g | ]
}|j �qS r? )r� r� r? r? r@ r� U r� ) rA r r� r7 ra r, r� r� r� r� �sumr� rG r? r? r@ �test_threads_2D s$ "������zTestProcess.test_threads_2c C s� t �� }|�� d d� \}}|�� }|dks0J �|dks<J �d gd }|�� d d� \}}|�� }||ksnJ �||kszJ �||ks�J �~tr�|�� } | j| jks�J �| j| jks�J �|�� } | j D ]}
t
| |
�dks�J �q�d S )Nr� r i`� ) r7 r8 Z memory_info�memory_percentr ZrssZwset�vmsZpagefiler� r� ) r; rH Zrss1Zvms1Zpercent1ZmemarrZrss2Zvms2Zpercent2�memrz r? r? r@ �test_memory_infoZ s&
z TestProcess.test_memory_infoc C s� t �� }t �� j}|�� }|jD ]8}t||�}|dks:J �|dkrFts trLq ||ks J �q tsft sft
rt|j dkstJ �tr�|j dks�J �|j
dks�J �d S )Nr r� )r7 r8 Zvirtual_memory�totalZmemory_full_infor� r� r r r r �ussZpssZswap)r; rH r� r� rz r� r? r? r@ �test_memory_full_infoy s
z!TestProcess.test_memory_full_infoc
C s� t �� }|�� }t|�tt|��ks(J �|jdd�}|D �]}|j�d�s8trZd|jv rZq8tj� |j�srJ |j��t
�r z*tj� |j�s�tj� |j�s�J |j��W nZ t
y� ts�� n@td��}|�� }W d � n1 s�0 Y d|j |vr�� Y n0 q8dtj�|j�vr8zt�|j�}W n t�y6 Y q80 t�|j�s8J |j��q8|D ]l}|jD ]^}t||�} |dk�rz�q^|d v �r�| �s�J | ��n&t| ttf��s�J �| d
k�s^J | ���q^�qTd S ) NF)Zgrouped�[z
/bin/qemu-z/proc/self/smapsz %s (deleted)Z64r� )�addrZpermsr )r7 r8 � memory_mapsr� �setr� r� r# rC �isabsr
�exists�islink�AssertionErrorr r
r� �basename�statr �S_ISREG�st_moder� r� r� �intr )
r; rH �mapsZext_maps�ntr� �data�st�fnamer� r? r? r@ �test_memory_maps� sL
��
&
z TestProcess.test_memory_mapsc s` t �� }t� �>}dd� � � fdd�|�� D �}� |�|v s>J �W d � n1 sR0 Y d S )Nc S s t j�t j�| ��S r5 )rC r� r� �normcaser� r? r? r@ �normpath� s z8TestProcess.test_memory_maps_lists_lib.<locals>.normpathc s g | ]}� |j ��qS r? )r� r� �r r? r@ r� � r� z:TestProcess.test_memory_maps_lists_lib.<locals>.<listcomp>)r7 r8 r' r� )r; rH r� Zlibpathsr? r r@ �test_memory_maps_lists_lib� s
z&TestProcess.test_memory_maps_lists_libc C sb t �� }|�� t�t�� |jdd� W d � n1 s<0 Y tsRtsRtr^|jdd� d S )Nz?!?)Zmemtyper� ) r7 r8 r� r, rE r{ r r r rG r? r? r@ �test_memory_percent� s * z TestProcess.test_memory_percentc C sL | � � }|�� sJ �|�� s J �|�� |�� |�� r<J �|�� rHJ �d S r5 )rA �
is_runningrJ rK rG r? r? r@ �test_is_running� s zTestProcess.test_is_runningc C s� | � � }|�� }z|tks J �W n� ty� tr`t|�tt�kr`tjj}||�|t�ks�J �nLdt j
d t j
d f }z |� |d�t� |d�ks�J �W n ty� Y n0 Y n0 t |ddg�}|dks�J �d S )Nz%s.%sr rf rZ rc zimport os; print('hey')Zhey)
rA �exer! r r r� rC r� r �sys� version_info�replacer0 )r; rH r r �ver�outr? r? r@ �test_exe� s zTestProcess.test_exec C s� t ddg}| �|�}tr.|�� g kr.t�d��ts:ts:trP|�� d t ks�J �n�tr�t r�|�� d }|t kr�d�
|�� dd � �d�
|dd � �ks�J �d S t r�d�
|�� dd � �d�
|�ks�J �d S d�
|�� �d�
|�ks�J �d S )Nrc �2import time; [time.sleep(0.1) for x in range(100)]�OPENBSD: returned EBUSYr � rf r� ) r! rA r �cmdliner, r� r r r r �joinr# )r; r rH �pyexer? r? r@ � test_cmdline� s$ �
,$zTestProcess.test_cmdlinezbroken on PYPYc C s� t g}|�dgd � |�ddg� | �|�}trhz|�� |ksDJ �W q� tjyd t�d��Y q�0 nHt r�|�� dd � |ks�J �n*|�� }t
r�|g kr�t�d��||ks�J �d S )Nz-v�2 rc r z#OPENBSD: process turned into zombier� r ) r! �extendrA r r r7 �
ZombieProcessr, r� r# r )r; r rH r� r? r? r@ �test_long_cmdline s" �
z TestProcess.test_long_cmdlinec C sH | � � }|�� �� }tj�tj�tj���� }|� |�sDJ ||f��d S r5 )
rA rz �lowerrC r� r r� r �
executabler� )r; rH rz r! r? r? r@ � test_name( s zTestProcess.test_namezunreliable on PYPYzunreliable on QEMU userc C s� t | jtjd d��}|ddg}| �|�}tr�z |�� tj� |�ksHJ �W q� t
y� |� � t j
kr�tj� |��|�� �s�J �n� Y q�0 n|�� tj� |�ks�J �d S )Nr� ��suffixrc r )r) r� �string�digitsrA r rz rC r� r r �statusr7 �
STATUS_ZOMBIEr� �r; r! r rH r? r? r@ �test_long_name. s �
zTestProcess.test_long_namezbroken on SUNOSz
broken on AIXzbroken on QEMU userc C sp t | jdd��}|ddg}| �|�}|�� |ks4J �|�� tj�|�ksLJ �tj�|� � �tj�|�kslJ �d S )Nz foo bar )r* rc r )
r) r� rA r rz rC r� r r r r0 r? r? r@ �test_prog_w_funky_nameK s �
z"TestProcess.test_prog_w_funky_namec C sX t �� }|�� \}}}|t�� ks&J �|t�� ks6J �ttd�rTt�� |�� ksTJ �d S �N� getresuid)r7 r8 �uidsrC �getuid�geteuid�hasattrr4 �r; rH �realZ effectiveZ_savedr? r? r@ � test_uids^ s
zTestProcess.test_uidsc C sX t �� }|�� \}}}|t�� ks&J �|t�� ks6J �ttd�rTt�� |�� ksTJ �d S r3 )r7 r8 �gidsrC �getgid�getegidr8 � getresgidr9 r? r? r@ � test_gidsl s
zTestProcess.test_gidsc
s� � fdd�}t �� � t�t�� � �d� W d � n1 s>0 Y � �� }| �||� t�r(d }t jt j t j
t j t j t j
fD ]�}| j|d��� z� �|� W n t jy� Y nN0 � �� }|t j t j t j
fv r�||ks�|d u r�|}||ks�J �n||k�sJ �W d � q�1 �s0 Y q�n�z�ttd��rVt�tjt�� �� �� k�sVJ �� �d� � �� dk�srJ �ttd��r�t�tjt�� �� �� k�s�J �t�s�� �d� � �� dk�s�J �W n t j�y� Y n0 d S )Nc s( z� � | � W n tjy" Y n0 d S r5 )�nicer7 ra )r� r� r? r@ r� { s z&TestProcess.test_nice.<locals>.cleanup�str)�prio� getpriorityrf r )r7 r8 r, rE r� rA r� r ZIDLE_PRIORITY_CLASSZBELOW_NORMAL_PRIORITY_CLASSZNORMAL_PRIORITY_CLASSZABOVE_NORMAL_PRIORITY_CLASSZHIGH_PRIORITY_CLASSZREALTIME_PRIORITY_CLASS�subTestra r8 rC rD � PRIO_PROCESSrD r )r; r� r� Z highest_priorC Znew_prior? r� r@ � test_nicez s` ( ��2 ��
��
zTestProcess.test_nicec C s t �� }|�� t jksJ �d S r5 )r7 r8 r. ZSTATUS_RUNNINGrG r? r? r@ � test_status� s zTestProcess.test_statusc C s| | � � }|�� }trh|�d�\}}t�� }|�d�r>t�d��||ksJJ �dt j
v rx|t j
d ksxJ �n|t�� ksxJ �d S )N�\�$zrunning as service accountZ
USERDOMAIN) rA �usernamer �split�getpass�getuser�endswithr, r� rC �environ)r; rH rK �domainZ getpass_userr? r? r@ �
test_username� s
zTestProcess.test_usernamec C s | � � }|�� t�� ks J �d S r5 )rA �cwdrC �getcwdrG r? r? r@ �test_cwd� s zTestProcess.test_cwdc s( t ddg}| �|�� t� fdd�� d S )Nrc zFimport os, time; os.chdir('..'); [time.sleep(0.1) for x in range(100)]c s � � � tj�t�� �kS r5 )rS rC r� �dirnamerT r? r� r? r@ �<lambda>� r� z(TestProcess.test_cwd_2.<locals>.<lambda>)r! rA r& )r; rj r? r� r@ �
test_cwd_2� s �
zTestProcess.test_cwd_2c C s� t �� }|�� }|s J |��| �|j|� ttd�rL|tt�|j��ksLJ �t |�t t
|��ksdJ �tt t t j dd����}|D ]j}|�|g� |�� |gks�J �ttd�r�|�� tt�|j��ks�J �t|d�r�|�� d |�
� ks�J �q�|�g � t�r|�� |j�� k�s(J �n|�� |k�s(J �ttd��rR|�� tt�|j��k�sRJ �t�t�� |�d� W d � n1 �s~0 Y |�|� |�t
|�� |�t|�� d S )N�sched_getaffinityT�Zpercpu�num_cpur rf )r7 r8 � cpu_affinityr� r8 rC �listrY r9 r� r� r� r� r[ r �_procZ_get_eligible_cpusr, rE r� r� )r; rH �initialZall_cpus�nr? r? r@ �test_cpu_affinity� s4
*
z TestProcess.test_cpu_affinityc C s | � � }ttjdd��d g}t�t�� |�|� W d � n1 sH0 Y t�t�� |�tdd�� W d � n1 s�0 Y t�t �� |�ddg� W d � n1 s�0 Y t�t�� |�ddg� W d � n1 s�0 Y d S ) NTrZ �
i' i�* r �1ry )
rA r� r7 r� r, rE r{ r\ r� r� )r; rH Z invalid_cpur? r? r@ �test_cpu_affinity_errs s ( . , z"TestProcess.test_cpu_affinity_errsc C s� t �� }|�� }|s J |��| �|j|� t|�dkrB|d d� }g }tt|�d �D ](}t�||�D ]}|rf|�t |�� qfqV|D ]&}|�|� t
|�� �t
|�ks�J �q�d S )N� rf ) r7 r8 r\ r� r� r� � itertools� combinations�appendr] �sorted)r; rH r_ Zcombosr� ZsubsetZcombor? r? r@ �"test_cpu_affinity_all_combinations s
z.TestProcess.test_cpu_affinity_all_combinationsz
broken on BSDzunreliable on APPVEYORc sr t �� �| �� }��� � |� vs$J �t|d���}|�d� |�� t� �fdd�� ��� � dd� � D �}tj �
|�|v s~J �t r�� D ] }|j |kr�|j dks�J �q�W d � n1 s�0 Y � D ]}tj �
|j �s�J |��q�d| }| �td |g��td
�D ]2}d d� ��� D �}||v �r( �qLt�d � �qtj �
|�|v �sLJ �|D ] }tj �
|��sPJ |���qPd S )
Nr� s xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxc s t ��� �t � �kS r5 )r� �
open_filesr? ��filesrH r? r@ rW 7 r� z-TestProcess.test_open_files.<locals>.<lambda>c S s g | ]}t j�|j��qS r? �rC r� r r� r? r? r@ r� 9 r� z/TestProcess.test_open_files.<locals>.<listcomp>r� zIimport time; f = open(r'%s', 'r'); [time.sleep(0.1) for x in range(100)];rc r� c S s g | ]}t j�|j��qS r? rn r� r? r? r@ r� J r� rt )r7 r8 r� rk r� r� �flushr& rC r� r r �position�isfilerA r! r� r} �sleep)r; r� r� � filenames�filer r� r? rl r@ �test_open_files+ s<
.��
zTestProcess.test_open_filesc C s t �� }tjj}| �� }t|d���}|�� D ]*}||j�||j�ksR|j |�
� kr, qnq,| � dt |�� � ��||j�||j�ks�J �t
r�|j dks�J �n|j |�
� ks�J �|�� d }|d |jks�J �|d |j ks�J �|j|�� vs�J �W d � n1 �s0 Y d S )N�wzno file found; files=%sry r rf )r7 r8 rC r� r r� r� rk rz �fd�filenor~ �reprr )r; rH r r� �fileobjrt Zntupler? r? r@ �test_open_files_2T s* � �� z TestProcess.test_open_files_2c C s� t �� }| �� }|�� }t|d�}| �|j� |�� |d ksBJ �t�� }| �|j� |�� |d ksjJ �|�� |�� |�� |ks�J �d S )Nrv rf r� )r7 r8 r� Znum_fdsr� r� �close�socket)r; rH r� �startrt �sockr? r? r@ � test_num_fdss s
zTestProcess.test_num_fdsz not reliable on OPENBSD & NETBSDc C sT t �� }t|�� �}td�D ](}t�d� t|�� �}||kr d S q | �d��d S )Nr� g�������?z2num ctx switches still the same after 2 iterations)r7 r8 r� Znum_ctx_switchesr� r} rr r~ )r; rH �beforer� �afterr? r? r@ �test_num_ctx_switches� s
z!TestProcess.test_num_ctx_switchesc C sF t �� }ttd�r&|�� t�� ks&J �| �� }|�� t�� ksBJ �d S )N�getppid)r7 r8 r8 rC �ppidr� rA rD rG r? r? r@ � test_ppid� s
zTestProcess.test_ppidc C sD | � � }|�� jt�� ks J �t�� d }t�|��� d u s@J �d S r� )rA �parentr9 rC rD r7 �pidsr8 )r; rH Z
lowest_pidr? r? r@ � test_parent� s zTestProcess.test_parentc C s8 t �� }| �� \}}|�� |ks$J �|�� |ks4J �d S r5 )r7 r8 ru r� �r; r� rv rw r? r? r@ �test_parent_multi� s z TestProcess.test_parent_multic C s` t �� }|�� sJ �| �� \}}|�� d |ks4J �|�� d |ksHJ �|�� d |ks\J �d S r� )r7 r8 �parentsru r� r? r? r@ � test_parents� s zTestProcess.test_parentsc C s� t �� }|�� g ksJ �|jdd�g ks,J �| jdd�}|�� }|jdd�}||fD ]>}t|�dkshJ �|d j|jks|J �|d �� |jksTJ �qTd S )NT�� recursiver )�
creationflagsrf )r7 r8 �childrenrA r� r9 r� )r; r� rv Z children1Z children2r� r? r? r@ �
test_children� s zTestProcess.test_childrenc C sf t �� }| �� \}}|�� |gks&J �|jdd�||gks>J �|�� |�� |jdd�g ksbJ �d S )NTr� )r7 r8 ru r� rS rK r� r? r? r@ �test_children_recursive� s z#TestProcess.test_children_recursivec C s� t �t�}t�� D ]2}z||�� d7 < W q tjyB Y q0 qt|�� dd� d�d d }t rx|dkrxt
� d��t� |�}z|j
dd �}W n tjy� Y n0 t|�tt|��ks�J �d S )
Nrf c S s | d S )Nrf r? )r� r? r? r@ rW � r� z6TestProcess.test_children_duplicates.<locals>.<lambda>)�keyry r zPID 0Tr� )� collections� defaultdictr r7 � process_iterr� �Errorri �itemsr r, r� r8 r� ra r� r� )r; �tablerH r9 �cr? r? r@ �test_children_duplicates� s
z$TestProcess.test_children_duplicatesc C s| t �� }| �� \}}|jdd�}t|�dks0J �|d |ks@J �|d |ksPJ �|�� }|d |kshJ �|d |ksxJ �d S )NTr� r� r rf )r7 r8 ru r� r� r� )r; r� rv rw r� r� r? r? r@ �test_parents_and_children� s z%TestProcess.test_parents_and_childrenc C sX | � � }|�� td�D ] }|�� tjkr. q:t�d� q|�� |�� tjksTJ �d S )Nr� rt ) rA rq r� r. r7 ZSTATUS_STOPPEDr} rr rr )r; rH r� r? r? r@ �test_suspend_resume� s z TestProcess.test_suspend_resumec C sl t �t�� t�d� W d � n1 s*0 Y t �t�� t�d� W d � n1 s^0 Y d S )Nrc ry )r, rE r� r7 r8 r{ �r; r? r? r@ �test_invalid_pid� s ( z TestProcess.test_invalid_pidc C s� t �� }|jddgd�}t|�� �ddgks0J �t �tt �� ��}|jdgdd�}t|d t�sp|d dkspJ �t j
ddt j d ��, |jd
gd d�d
d iks�J �W d � n1 s�0 Y t j
ddt � |j
d�d ��L t�t j �� |jd
gd� W d � n1 �s 0 Y W d � n1 �s,0 Y t j
ddt �|j
d�d ��. |jd
gdd�d
dik�spJ �W d � n1 �s�0 Y t j
ddtd ��h |�� }d
t|�� �v�s�J �t�t�� |jd
gd� W d � n1 �s�0 Y W d � n1 �s0 Y t�t�� |�d� W d � n1 �sF0 Y t�t�� |�dg� W d � n1 �s~0 Y t�t�� |�dd g� W d � n1 �s�0 Y d S )
Nr rz )�attrsZnet_connections�foo)r� Zad_valuezpsutil.Process.niceT)�creater\ rA rf �bar)r7 r8 Zas_dictri �keysr� r� r� r] r* r] ra r: r9 r, rE r% �NotImplementedErrorr� r{ )r; rH �dr? r? r@ � test_as_dict� sJ �: �N �>� N * , zTestProcess.test_as_dictc C s� t �� }t�d��V}|�� � |�� |�� W d � n1 sB0 Y |jdksZJ �W d � n1 sn0 Y t�d�� }|�� |�� W d � n1 s�0 Y |jdks�J �d S )N�$psutil._psplatform.Process.cpu_timesrf r� �r7 r8 r* r] �oneshotr� Z
call_count�r; rH r� r? r? r@ � test_oneshot/ s
&, &zTestProcess.test_oneshotc C s8 t �� }t�d���}t�d���}|�� �X |�� |�� |�� � |�� |�� W d � n1 sh0 Y W d � n1 s�0 Y |jdks�J �|jdks�J �W d � n1 s�0 Y W d � n1 s�0 Y t�d�� }|�� |�� W d � n1 �s0 Y |jdk�s4J �d S )Nr� z(psutil._psplatform.Process.oneshot_enterrf r� r� )r; rH �m1�m2r� r? r? r@ �test_oneshot_twice< s
DJ (z TestProcess.test_oneshot_twicec C s� | � � \}}|�� }|�� }||ks(J �|�� �0 |�� |ksBJ �|�� |ksRJ �W d � n1 sf0 Y |�� �0 |�� |ks�J �|�� |ks�J �W d � n1 s�0 Y d S r5 )ru r� r� )r; �p1�p2Zp1_ppidZp2_ppidr? r? r@ �test_oneshot_cacheP s
.
z TestProcess.test_oneshot_cachec sn �fdd�}�� � � � �� � �� tr8t� fdd�� ��� � t� �}|�|j�D ]\}}|||� qVd S )Nc s� z
| � }W nN t jy � Y n\ t jy2 Y nJ t jyX trR|dv rRY d S � Y n$0 trj|dv rjd S � �d| |f ��d S )N)r� r� )r rz z+%r didn't raise NSP and returned %r instead)r7 r% r: ra r r r~ )�funZfun_namer� r� r? r@ �assert_raises_nspg s
�zFTestProcess.test_halfway_terminated_process.<locals>.assert_raises_nspc s � j t�� vS r5 )r9 r7 r� r? r� r? r@ rW ~ r� z=TestProcess.test_halfway_terminated_process.<locals>.<lambda>) rA rS rK r r& rO r+ �iter�all)r; r� �nsr� rz r? )rH r; r@ � test_halfway_terminated_process_ s
z+TestProcess.test_halfway_terminated_processc C s | � � \}}| �|� d S r5 )Z spawn_zombieZassertProcessZombie)r; �_parentZzombier? r? r@ �test_zombie_process� s z TestProcess.test_zombie_processc C sV t �� }tjdt �d�d��&}|�� s*J �|js4J �W d � n1 sH0 Y d S )Nzpsutil.Processr r[ )r7 r8 r* r] r% r r� r� r? r? r@ �$test_zombie_process_is_running_w_exc� s
� z0TestProcess.test_zombie_process_is_running_w_excc C s\ t �� }tjdt �d�d��,}|�� t jks0J �|js:J �W d � n1 sN0 Y d S )Nz!psutil._psplatform.Process.statusr r[ )r7 r8 r* r] r% r. r/ r� r� r? r? r@ � test_zombie_process_status_w_exc� s �z,TestProcess.test_zombie_process_status_w_excc
C s� t rddlm} n ddlm} | �� }t�|j�}|j|�� d f|_t t�
� � |jtj v sbJ �|� � rnJ �t
j�tjdd��F t|� �� }t t�
� � W d � n1 s�0 Y W d � n1 s�0 Y d|j |�� v s�J �|jtj vs�J �|t�|j�k�sJ �d}t|�}|j|j|j dd �D ]p\}}| j|d
��H tjtj|d �� |� W d � n1 �sx0 Y W d � n1 �s�0 Y �q4d t|�v �s�J �d t |�v �s�J �tjtj|d �� |� � W d � n1 �s�0 Y tjtj|d �� |� � W d � n1 �s40 Y tjtj|d �� |� � W d � n1 �sn0 Y tjtj|d �� |� � W d � n1 �s�0 Y d S )
Nr )�StringIOr� Z PSUTIL_DEBUGTz-refreshing Process instance for reused PID %sz4process no longer exists and its PID has been reusedF)� clear_cache)rz r� zterminated + PID reused)!r �ior� r6 r7 r8 r9 r� �_identr] r� Z_pmapr r* r] �object�_commonr �getvaluer+ r� �settersZkillersrE r, rE r: rB ry r� r� r� r� ) r; r� ZsubprH r� �msgr� r� rz r? r? r@ �test_reused_pid� sD H�� J(((zTestProcess.test_reused_pidc C s� dt �� vrjt�t j�� t �d� W d � n1 s80 Y t �d�rPJ �t �d��� dksfJ �d S t �d�}tr~t j nt
}t�|�� |� � W d � n1 s�0 Y t�|�� |� � W d � n1 s�0 Y t�|�� |�
� W d � n1 �s0 Y t�|�� |�� W d � n1 �sD0 Y t�|�� |�� W d � n1 �sx0 Y t�|�� |�tj� W d � n1 �s�0 Y t|�}|�|j|j �D ]�\}}z
|� }W n t j �y� Y nb0 |dv �r|jdk�s^J �nD|dk�rFt�r.dnd}|�� |k�s^J �n|dk�r�|�s�J |���q�t�s�dt �� v �szJ �t �d��s�J �d S )Nr rf )r5 r< rK zNT AUTHORITY\SYSTEM�rootrz )r7 r� r, rE r: r8 Z
pid_existsr� r ra r{ rK rS rq rr rJ rU rL rM r+ r� Zgettersr� r: rK r )r; rH r� r� r� rz r� r� r? r? r@ �
test_pid_0� sH (
& & ( ( ( ,
zTestProcess.test_pid_0c C sH dd� }d | _ t�� }||�� �}|tj�� �}tsDtrD||ksDJ �d S )Nc S sF g d�}t r|�g d�� |D ]}| �|d � q tdd� | �� D ��S )N)�PLAT�HOMEZPYTEST_CURRENT_TESTZPYTEST_VERSION)Z__CF_USER_TEXT_ENCODINGZ VERSIONER_PYTHON_PREFER_32_BIT�VERSIONER_PYTHON_VERSIONr� c S s8 g | ]0\}}|� d d�� dd�|� d d�� dd�f�qS )�
rZ �
)r )r� �k�vr? r? r@ r�
s ��z@TestProcess.test_environ.<locals>.clean_dict.<locals>.<listcomp>)r r$ �pop�dictr� )r� �excluderz r? r? r@ �
clean_dict� s �z,TestProcess.test_environ.<locals>.clean_dict)ZmaxDiffr7 r8 rP rC �copyr r )r; r� rH Zd1Zd2r? r? r@ � test_environ� s zTestProcess.test_environz<macOS 11+ can't get another process environment, issue #2084z(sometimes fails on `assert is_running()`c C s� t �d�}t| �� |d�}| j|gtjtjd�}t�|j �}t
|j � |� � sRJ �|j �
� dksdJ �tr�tr�z |�� }W q� tjy� Y d S 0 n|�� }|ddd�ks�J �|�� |jdks�J �d S ) Na�
#include <unistd.h>
#include <fcntl.h>
char * const argv[] = {"cat", 0};
char * const envp[] = {"A=1", "X", "C=3", 0};
int main(void) {
// Close stderr on exec so parent can wait for the
// execve to finish.
if (fcntl(2, F_SETFD, FD_CLOEXEC) != 0)
return 0;
return execve("/bin/cat", argv, envp);
}
)Zc_code)�stdinre r� rc �3)�A�Cr )�textwrap�dedentr( r� r6 rh ri r7 r8 r9 r3 r re r� r r rP ra � communicate�
returncode)r; rQ Zcexer> rH �envr? r? r@ �test_weird_environ s$
�
z TestProcess.test_weird_environN)m�__name__�
__module__� __qualname__�__doc__rA rI rR rT rW r, �mark�skipifr
rb rk r rs rx r| r r� r� r# r� r� r r� r� r� r r2 r r� r r� r r� r r� r� r� r� r� r� r� r r� r/ r1 r r� r� r� r r
r r r r r" r r& r) r1 r r r2 r; r@ rG rH rR rU rX r ra rd rj r r ru r{ r� r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r r� r? r? r? r@ r4 P s
) +�
/
B
&
&
�
4
&
..
��r4 c sr e Zd ZdZeed�r&e�� Ze�� Z � fdd�Z
� fdd�Z � fdd�Z d d
� Z
ejjd d d
�dd� �Z� ZS )�LimitedUserTestCasez�Repeat the previous tests by using a limited user.
Executed only on UNIX and only if the user who run the test script
is root.
r6 c sX t � j|i |�� dd� t| �D �D ].}t| |�� � fdd�}t| |t�|| �� q$d S )Nc S s g | ]}|� d �r|�qS )�testr� r� r? r? r@ r� ` r� z0LimitedUserTestCase.__init__.<locals>.<listcomp>c s$ z
� � W n t jy Y n0 d S r5 )r7 ra r� ��methr? r@ �test_c s
z+LimitedUserTestCase.__init__.<locals>.test_)r �__init__r� r� �setattr�types�
MethodType)r; r< r= �attrr� �� __class__r� r@ r� \ s
z LimitedUserTestCase.__init__c s" t � �� t�d� t�d� d S )Ni� )r �setUprC �setegid�seteuidr� r� r? r@ r� k s
zLimitedUserTestCase.setUpc s& t �| j� t �| j� t� �� d S r5 )rC r� � PROCESS_UIDr� � PROCESS_GIDr �tearDownr� r� r? r@ r� p s z LimitedUserTestCase.tearDownc C s6 zt �� �d� W n t jy& Y n 0 | �d��d S )Nry zexception not raised)r7 r8 rA ra r~ r� r? r? r@ rG u s
z LimitedUserTestCase.test_niceTzcauses problem as rootrX c C s d S r5 r? r� r? r? r@ r� } s z'LimitedUserTestCase.test_zombie_process)r� r� r� r� r8 rC r6 r� r= r� r� r� r� rG r, r� r� r� �
__classcell__r? r? r� r@ r� Q s
r� c @ s4 e Zd ZdZedd� �Zdd� Zdd� Zdd � Zd
S ) � TestPopenz Tests for psutil.Popen class.c C s
t � d S r5 r- )�clsr? r? r@ �
tearDownClass� s zTestPopen.tearDownClassc C s� t ddg}tj|tjtjtd��j}|�� |�� |j t |�sDJ �t
� t �� |j
W d � n1 sj0 Y |�� W d � n1 s�0 Y tr�|�d�tj ks�J �n|�d�tjks�J �d S )Nrc �3import time; [time.sleep(0.1) for x in range(100)];��stdoutre r� rg )r! r7 �Popenrh ri r" rz r� r� r� r, rE rF r� rS r
rK rL rM �r; rj �procr? r? r@ � test_misc� s* �� $&zTestPopen.test_miscc C s| t jtdgtjtjtjtd��}|�� W d � n1 s<0 Y |jjsRJ �|j js^J �|j
jsjJ �|j dksxJ �d S )Nz-V)r� re r� r� r ) r7 r r! rh ri r" r� r� �closedre r� r� )r; r r? r? r@ �test_ctx_manager� s �& zTestPopen.test_ctx_managerc C sr t ddg}tj|tjtjtd���:}|�� |�� t� tj
�� |�� W d � n1 s^0 Y t� tj
�� |� � W d � n1 s�0 Y t� tj
�� |� t
j� W d � n1 s�0 Y t�rNt� tj
�� |� t
j� W d � n1 �s
0 Y t� tj
�� |� t
j� W d � n1 �sD0 Y W d � n1 �sd0 Y d S )Nrc r� r� )r! r7 r rh ri r" rS rK r, rE r: rJ rU rL rM r Z CTRL_C_EVENTZCTRL_BREAK_EVENTr r? r? r@ �test_kill_terminate� s0 ��&&*,z TestPopen.test_kill_terminateN) r� r� r� r� � classmethodr� r r r r? r? r? r@ r� � s
r� )Gr� r� r_ rM rf rC rL r} r r, rh r r� r} r� r7 r r r r r r r r
r r Zpsutil._commonr
Zpsutil._compatr r r r r Z psutil.testsr r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) r* r+ r, r. r/ r0 r1 r2 r3 r4 r6 r� r� r? r? r? r@ �<module> s� 6PK ok\��yZ5 5 6 psutil/tests/__pycache__/test_contracts.cpython-39.pycnu �[��� a
��?h!1 � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm
Z
dd
lm Z dd lm Z dd l
mZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z G dd � d e�Z G d d � d e�Z G d d � d e�Z G d!d"� d"e�Z!G d#d$� d$e�Z"dS )%z�Contracts tests. These tests mainly check API sanity in terms of
returned types and APIs availability.
Some of these are duplicates of tests test_system.py and test_process.py.
� N)�AIX)�FREEBSD)�LINUX)�MACOS)�NETBSD)�OPENBSD)�POSIX)�SUNOS)�WINDOWS)�long)�GITHUB_ACTIONS)� HAS_CPU_FREQ)�HAS_NET_IO_COUNTERS)�HAS_SENSORS_FANS)�HAS_SENSORS_TEMPERATURES)�PYPY)� QEMU_USER)� SKIP_SYSCONS)�PsutilTestCase)�create_sockets)�enum)�
is_namedtuple)�kernel_version)�pytestc @ sH e Zd Zdd� Zdd� Zdd� Zdd� Zejj e
o4e d d
�d d � �Z d
S )�TestAvailConstantsAPIsc C s t td�tptptksJ �d S )NZ PROCFS_PATH)�hasattr�psutilr r r ��self� r �G/usr/local/lib64/python3.9/site-packages/psutil/tests/test_contracts.py�test_PROCFS_PATH3 s z'TestAvailConstantsAPIs.test_PROCFS_PATHc C sj | j }|ttd�t� |ttd�t� |ttd�t� |ttd�t� |ttd�t� |ttd�t� d S )NZABOVE_NORMAL_PRIORITY_CLASSZBELOW_NORMAL_PRIORITY_CLASSZHIGH_PRIORITY_CLASSZIDLE_PRIORITY_CLASSZNORMAL_PRIORITY_CLASSZREALTIME_PRIORITY_CLASS�� assertEqualr r r
�r Zaer r r �test_win_priority6 s z(TestAvailConstantsAPIs.test_win_priorityc C sJ | j }|ttd�t� |ttd�t� |ttd�t� |ttd�t� d S )NZIOPRIO_CLASS_NONEZIOPRIO_CLASS_RTZIOPRIO_CLASS_BEZIOPRIO_CLASS_IDLE)r# r r r r$ r r r �test_linux_ioprio_linux? s
z.TestAvailConstantsAPIs.test_linux_ioprio_linuxc C sJ | j }|ttd�t� |ttd�t� |ttd�t� |ttd�t� d S )NZ IOPRIO_HIGHZ
IOPRIO_NORMALZ
IOPRIO_LOWZIOPRIO_VERYLOWr" r$ r r r �test_linux_ioprio_windowsF s
z0TestAvailConstantsAPIs.test_linux_ioprio_windows�%unsupported on GITHUB_ACTIONS + LINUX��reasonc C s� | j }|ttd�tpt� |ttd�tp*t� |ttd�tp>t� |ttd�tpRt� |ttd�tpft� |ttd�tpzt� |ttd�tp�t� |ttd�tp�t� |ttd �tp�t� |ttd
�tp�t� |ttd �tp�t� |ttd �t� t�r�t� d
k�r|ttd�t� t� dk�r0|ttd�t� t� dk�rL|ttd�t� t� dk�rh|ttd�t� t� d
k�r�|ttd�t� |ttd�t� |ttd�t� |ttd�t� d S )NZ
RLIM_INFINITYZ RLIMIT_ASZ RLIMIT_COREZ
RLIMIT_CPUZ RLIMIT_DATAZ RLIMIT_FSIZEZRLIMIT_MEMLOCKZ
RLIMIT_NOFILEZ RLIMIT_NPROCZ
RLIMIT_RSSZ RLIMIT_STACKZ RLIMIT_LOCKS)� � � ZRLIMIT_MSGQUEUE)r+ r, � Z RLIMIT_NICEZ
RLIMIT_RTPRIO)r+ r, � Z
RLIMIT_RTTIMEZRLIMIT_SIGPENDINGZ RLIMIT_SWAPZ
RLIMIT_SBSIZEZ RLIMIT_NPTS)r# r r r r r r r$ r r r � test_rlimitM s6 z"TestAvailConstantsAPIs.test_rlimitN)
�__name__�
__module__� __qualname__r! r% r& r' r �mark�skipifr r r0 r r r r r 2 s �r c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�TestAvailSystemAPIsc C s t td�tksJ �d S )NZwin_service_iter�r r r
r r r r �test_win_service_iterr s z)TestAvailSystemAPIs.test_win_service_iterc C s t td�tksJ �d S )NZwin_service_getr7 r r r r �test_win_service_getu s z(TestAvailSystemAPIs.test_win_service_getc C s& t td�tptptptptks"J �d S )N�cpu_freq)r r r r r
r r r r r r �
test_cpu_freqx s �z!TestAvailSystemAPIs.test_cpu_freqc C s t td�tptksJ �d S )N�sensors_temperatures)r r r r r r r r �test_sensors_temperatures} s z-TestAvailSystemAPIs.test_sensors_temperaturesc C s t td�tksJ �d S )N� sensors_fans)r r r r r r r �test_sensors_fans� s z%TestAvailSystemAPIs.test_sensors_fansc C s" t td�tptptptks J �d S )NZsensors_battery)r r r r
r r r r r r � test_battery� s �z TestAvailSystemAPIs.test_batteryN) r1 r2 r3 r8 r9 r; r= r? r@ r r r r r6 q s r6 c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zej j
e o<e d d �d
d� �Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� ZdS ) �TestAvailProcessAPIsc C s4 t tjd�tp(tp(tp(tp(tp(tp(t p(t
ks0J �d S )N�environ) r r �Processr r r
r r r r r r r r r � test_environ� s
�������z!TestAvailProcessAPIs.test_environc C s t tjd�tksJ �d S �NZuids�r r rC r r r r r � test_uids� s z TestAvailProcessAPIs.test_uidsc C s t tjd�tksJ �d S rE rF r r r r � test_gids� s z TestAvailProcessAPIs.test_gidsc C s t tjd�tksJ �d S )N�terminalrF r r r r �
test_terminal� s z"TestAvailProcessAPIs.test_terminalc C s t tjd�tptksJ �d S )NZionice)r r rC r r
r r r r � test_ionice� s z TestAvailProcessAPIs.test_ionicer( r) c C s t tjd�tptksJ �d S )NZrlimit)r r rC r r r r r r r0 � s z TestAvailProcessAPIs.test_rlimitc C s" t tjd�}|tpt ks J �d S )NZ io_counters)r r rC r r �r Zhasitr r r �test_io_counters� s z%TestAvailProcessAPIs.test_io_countersc C s t tjd�tksJ �d S )NZnum_fdsrF r r r r � test_num_fds� s z!TestAvailProcessAPIs.test_num_fdsc C s t tjd�tksJ �d S )NZ num_handles)r r rC r
r r r r �test_num_handles� s z%TestAvailProcessAPIs.test_num_handlesc C s t tjd�tptptks J �d S )NZ cpu_affinity)r r rC r r
r r r r r �test_cpu_affinity� s
�z&TestAvailProcessAPIs.test_cpu_affinityc C s t tjd�tptptks J �d S )NZcpu_num)r r rC r r r r r r r � test_cpu_num� s
�z!TestAvailProcessAPIs.test_cpu_numc C s* t tjd�}|tp tp tp t ks&J �d S )NZ memory_maps)r r rC r r r r rL r r r �test_memory_maps� s z%TestAvailProcessAPIs.test_memory_mapsN)r1 r2 r3 rD rG rH rJ rK r r4 r5 r r r0 rM rN rO rP rQ rR r r r r rA � s �
rA c @ s& e Zd ZdZedd� �Zedfdd�Zdd� Zd d
� Z d d � Z
d
d� Z e j
jeoZe�� dkdd�e j
je dd�dd� ��Zdd� Zdd� Ze j
jedd�dd� �Zd d � Ze j
jed d�d d � �Ze j
je dd�d!d"� �Z e j
je dd�d#d$� �Z e j
je dd�d%d&� �Z d'd(� Z!d)d*� Z"d+S ),�TestSystemAPITypesz�Check the return types of system related APIs.
Mainly we want to test we never return unicode on Python 2, see:
https://github.com/giampaolo/psutil/issues/1039.
c C s t �� | _d S �N)r rC �proc)�clsr r r �
setUpClass� s z TestSystemAPITypes.setUpClassTc C s8 t |�s J �|D ]"}t||�s"J �|r|dksJ �qd S )Nr )r �
isinstance)r �nt�type_Zgezero�nr r r �assert_ntuple_of_nums� s
z(TestSystemAPITypes.assert_ntuple_of_numsc C s. | � t�� � tjdd�D ]}| � |� qd S )NT)Zpercpu)r\ r Z cpu_times)r rY r r r �test_cpu_times� s z!TestSystemAPITypes.test_cpu_timesc C s0 t tjd d�t�sJ �t tjdd�t�s,J �d S )N��intervalg�h㈵��>)rX r Z cpu_percent�floatr r r r �test_cpu_percent� s z#TestSystemAPITypes.test_cpu_percentc C s( | � tjd d�� | � tjdd�� d S )Nr^ g-C ��6?)r\ r Zcpu_times_percentr r r r �test_cpu_times_percent� s z)TestSystemAPITypes.test_cpu_times_percentc C s t t�� t�sJ �d S rT )rX r � cpu_count�intr r r r �test_cpu_count� s z!TestSystemAPITypes.test_cpu_count�arm64zskipped due to #1892r) z
not supportedc C s2 t �� d u rt�d��| jt �� tttfd� d S )Nzcpu_freq() returns None�rZ )r r: r �skipr\ r` rd r r r r r r; � s
z TestSystemAPITypes.test_cpu_freqc C s> t jdd��� D ](\}}t|t�s&J �| j|ttfd� qd S )NT)Zperdiskrg )r Zdisk_io_counters�itemsrX �strr\ rd r )r �k�vr r r �test_disk_io_counters� s z(TestSystemAPITypes.test_disk_io_countersc C sR t �� D ]D}t|jt�s J �t|jt�s,J �t|jt�s<J �t|jt�sJ �qd S rT )r Zdisk_partitionsrX Zdevicerj Z
mountpointZfstype�opts)r Zdiskr r r �test_disk_partitions� s
z'TestSystemAPITypes.test_disk_partitionsz
requires rootc C sb t � �H t�d�}t|�tt|��ks*J �|D ]}t|�s.J �q.W d � n1 sT0 Y d S )N�all)r r Znet_connections�len�setr )r �ret�connr r r �test_net_connections s
z'TestSystemAPITypes.test_net_connectionsc C s� t �� �� D ]�\}}t|t�s"J �|D ]t}td urJtsJt|jtj�sZJ �nt|jt �sZJ �t|j
t�sjJ �t|j tt d �f�s�J �t|j
tt d �f�s&J �q&q d S rT )r Z net_if_addrsri rX rj r r �family�IntEnumrd �address�netmask�type� broadcast)r �ifname�addrs�addrr r r �test_net_if_addrs s z$TestSystemAPITypes.test_net_if_addrszQEMU user not supportedc C s� t �� �� D ]r\}}t|t�s"J �t|jt�s2J �td urNt|jtj �s^J �nt|jt
�s^J �t|j t
�snJ �t|j t
�s J �q d S rT )
r Z net_if_statsri rX rj Zisup�boolr Zduplexrw rd �speedZmtu)r r| �infor r r �test_net_if_stats s z$TestSystemAPITypes.test_net_if_statsc C s$ t jdd�D ]}t|t�s J �q d S )NT)Zpernic)r Znet_io_countersrX rj )r r| r r r �test_net_io_counters" s z'TestSystemAPITypes.test_net_io_countersc C s\ t �� �� D ]J\}}t|t�s"J �|D ].}t|jt�s:J �t|jttt d �f�s&J �q&q d S rT )
r r> ri rX rj �label�currentr` rd rz �r �nameZunits�unitr r r r? ( s
z$TestSystemAPITypes.test_sensors_fansc C s� t �� �� D ]~\}}t|t�s"J �|D ]b}t|jt�s:J �t|jttt d �f�sTJ �t|j
ttt d �f�snJ �t|j ttt d �f�s&J �q&q d S rT ) r r< ri rX rj r� r� r` rd rz �high�criticalr� r r r r= 1 s z,TestSystemAPITypes.test_sensors_temperaturesc C s t t�� t�sJ �d S rT )rX r Z boot_timer` r r r r �test_boot_time< s z!TestSystemAPITypes.test_boot_timec C sj t �� D ]\}t|jt�s J �t|jttd �f�s4J �t|jttd �f�sLJ �t|jt td �f�sJ �qd S rT )
r ZusersrX r� rj rI rz �host�pidrd )r �userr r r �
test_users@ s
z TestSystemAPITypes.test_usersN)#r1 r2 r3 �__doc__� classmethodrW r` r\ r] ra rb re r r4 r5 r �platform�machiner
r; rm ro r ru r r r� r r� r r? r r= r� r� r r r r rS � s8
�
rS c @ s& e Zd Zejje dd�dd� �ZdS )�TestProcessWaitTypez not POSIXr) c C s\ t �| �� j�}|�� |�� }|tj ks0J �td urJt |tj
�sXJ �nt |t �sXJ �d S rT ) r rC Zspawn_testprocr� � terminate�wait�signal�SIGTERMr rX rw rd )r �p�coder r r �test_negative_signalJ s z(TestProcessWaitType.test_negative_signalN)r1 r2 r3 r r4 r5 r r� r r r r r� I s r� )#r� r� r� r r r r r r r r r r
Zpsutil._compatr Z psutil.testsr r
r r r r r r r r r r r r r r6 rA rS r� r r r r �<module> sB ?> PK ok\R4�(| | 1 psutil/tests/__pycache__/test_misc.cpython-39.pycnu �[��� a
��?h�� � @ sf d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z
ddl
m Z ddl
m
Z
ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddl m Z ddl m Z ddl m Z ddl m Z ddl m Z ddl m!Z! ddl m"Z" ddl m#Z# ddl m$Z$ ddl m%Z% ddl m&Z& dd l m'Z' dd l m(Z( dd l m)Z) dd l m*Z* dd l m+Z+ dd!l m,Z, dd"l m-Z- G d#d$� d$e'�Z.G d%d&� d&e'�Z/G d'd(� d(e'�Z0G d)d*� d*e'�Z1e�2d+d,�Z3G d-d.� d.e'�Z4e*j5j6ej7�8e&� d/d0�G d1d2� d2e'��Z9dS )3zMiscellaneous tests.� N)�POSIX)�WINDOWS)�bcat)�cat)�debug)�
isfile_strict)�memoize)�memoize_when_activated��parse_environ_block)�
supports_ipv6�� wrap_numbers)�PY3)�FileNotFoundError)�redirect_stderr)�
CI_TESTING)� HAS_BATTERY)�HAS_MEMORY_MAPS)�HAS_NET_IO_COUNTERS)�HAS_SENSORS_BATTERY)�HAS_SENSORS_FANS)�HAS_SENSORS_TEMPERATURES)�
PYTHON_EXE)�PYTHON_EXE_ENV)� QEMU_USER)� SCRIPTS_DIR)�PsutilTestCase)�mock)�process_namespace)�pytest)�
reload_module)�sh)�system_namespacec @ s� e Zd Zdd� Zefdd�Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd � Zd d � Zd S ) �TestSpecialMethodsc C sz t �t��" tjj�dd � W d � n1 s20 Y t �tj�� t�dd � W d � n1 sl0 Y d S )N� � ) r �raises�
OverflowError�psutilZ _psplatformZcextZcheck_pid_range�
NoSuchProcess�Process��self� r. �B/usr/local/lib64/python3.9/site-packages/psutil/tests/test_misc.py�test_check_pid_range> s 0z'TestSpecialMethods.test_check_pid_rangec C s t �| �� j�}||�}d|v s$J �d|j |v s6J �dt|�� � |�dd�v sVJ �d|v sbJ �d|vsnJ �|�� |�� ||�}d|v s�J �d|v s�J �t j
j t jd t � t
�� �d
��J t �� }||�}d|j |v s�J �d |v s�J �d |vs�J �W d � n1 �s0 Y t j
j t jd t �t
�� �d
��P t �� }||�}d|j |v �s\J �d
|v �sjJ �d |v�sxJ �W d � n1 �s�0 Y t j
j t jd t �t
�� �d
��B t �� }||�}d|j |v �s�J �d |v�s�J �W d � n1 �s 0 Y d S )Nzpsutil.Processzpid=%sz name='%s'zname=u'zname='zstatus=z exitcode=zstatus='terminated'�name�Z side_effectzstatus='zombie'zname=Z
terminated)r) r+ Zspawn_testproc�pid�strr1 �replace� terminate�waitr �patch�object�
ZombieProcess�os�getpidr* � AccessDenied)r- �func�p�rr. r. r/ �test_process__repr__D sR � , �. �z'TestSpecialMethods.test_process__repr__c C s | j td� d S )N)r> )rA r4 r, r. r. r/ �test_process__str__p s z&TestSpecialMethods.test_process__str__c C s t t�� �dksJ �d S )Nzpsutil.Error())�reprr) �Errorr, r. r. r/ �test_error__repr__s s z%TestSpecialMethods.test_error__repr__c C s t t�� �dksJ �d S )N� )r4 r) rD r, r. r. r/ �test_error__str__v s z$TestSpecialMethods.test_error__str__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )N�A z=psutil.NoSuchProcess(pid=321, msg='process no longer exists')r1 �msg�r1 rI z5psutil.NoSuchProcess(pid=321, name='name', msg='msg'))rC r) r* r, r. r. r/ � test_no_such_process__repr__y s ����z/TestSpecialMethods.test_no_such_process__repr__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )NrH z"process no longer exists (pid=321)r1 rI rJ �msg (pid=321, name='name'))r4 r) r* r, r. r. r/ �test_no_such_process__str__� s ����z.TestSpecialMethods.test_no_such_process__str__c C s8 t t�d��dksJ �t tjddddd��dks4J �d S )NrH zGpsutil.ZombieProcess(pid=321, msg="PID still exists but it's a zombie")r1 �@ �foo�r1 �ppidrI z?psutil.ZombieProcess(pid=321, ppid=320, name='name', msg='foo'))rC r) r: r, r. r. r/ �test_zombie_process__repr__� s ����z.TestSpecialMethods.test_zombie_process__repr__c C s8 t t�d��dksJ �t tjddddd��dks4J �d S )NrH z,PID still exists but it's a zombie (pid=321)r1 rN rO rP z$foo (pid=321, ppid=320, name='name'))r4 r) r: r, r. r. r/ �test_zombie_process__str__� s ����z-TestSpecialMethods.test_zombie_process__str__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )NrH z psutil.AccessDenied(pid=321)r1 rI rJ z4psutil.AccessDenied(pid=321, name='name', msg='msg'))rC r) r= r, r. r. r/ �test_access_denied__repr__� s
��z-TestSpecialMethods.test_access_denied__repr__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )NrH z (pid=321)r1 rI rJ rL )r4 r) r= r, r. r. r/ �test_access_denied__str__� s
��z,TestSpecialMethods.test_access_denied__str__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )N� z?psutil.TimeoutExpired(seconds=5, msg='timeout after 5 seconds')rH r1 �r3 r1 zUpsutil.TimeoutExpired(pid=321, name='name', seconds=5, msg='timeout after 5 seconds'))rC r) �TimeoutExpiredr, r. r. r/ � test_timeout_expired__repr__� s ����z/TestSpecialMethods.test_timeout_expired__repr__c C s6 t t�d��dksJ �t tjdddd��dks2J �d S )NrV ztimeout after 5 secondsrH r1 rW z.timeout after 5 seconds (pid=321, name='name'))r4 r) rX r, r. r. r/ �test_timeout_expired__str__� s
��z.TestSpecialMethods.test_timeout_expired__str__c C s> t �� }t �� }||ks J �d|_||ks.J �|dks:J �d S )N)r r rO )r) r+ �_ident)r- �p1�p2r. r. r/ �test_process__eq__� s z%TestSpecialMethods.test_process__eq__c C s( t t�� t�� g�}t|�dks$J �d S )N� )�setr) r+ �len)r- �sr. r. r/ �test_process__hash__� s z'TestSpecialMethods.test_process__hash__N)�__name__�
__module__� __qualname__r0 rC rA rB rE rG rK rM rR rS rT rU rY rZ r^ rc r. r. r. r/ r$ = s ,
r$ c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�TestMiscc C s� t t�}|D ]~}|dv rq |�d�s z t|� W q ty� |tjvr�tt|�}|d u r^Y q |jd ur�d|j�� vr�| � d| ��Y q 0 q tjD ]}||v s�J �q�d S )N)r �long�tests�test�PermissionError�ProcessLookupError�_�
deprecatedz%r not in psutil.__all__)
�dirr) �
startswith�
__import__� ImportError�__all__�getattr�__doc__�lower�fail)r- Z
dir_psutilr1 �funr. r. r/ � test__all__� s&
� �
zTestMisc.test__all__c C s$ d� dd� tjD ��tjks J �d S )N�.c S s g | ] }t |��qS r. )r4 )�.0�xr. r. r/ �
<listcomp>� � z)TestMisc.test_version.<locals>.<listcomp>)�joinr) � version_info� __version__r, r. r. r/ � test_version� s ��zTestMisc.test_versionc C s" t �� }d|_d|�� vs J �d S )N�1rO )r) r+ rO �as_dict)r- r? r. r. r/ �!test_process_as_dict_no_new_names� s z*TestMisc.test_process_as_dict_no_new_namesc
C s� dd� }t �� }|t �� �� � t|�}|j|jdd�D ]^\}}| j||d��8 z
|� }W n t jyn Y n
0 ||� W d � q81 s�0 Y q8t� }|�|j�D ]v\}}|dv r�q�t r�|dkr�q�| j|d��8 z
|� }W n t j
y� Y n
0 ||� W d � q�1 �s0 Y q�t � t �
t jd d
d d ���}t|t j��sPJ �|jd k�s`J �|jd
k�spJ �|jd k�s�J �t � t �
t jd d
d
d d���}t|t j��s�J �|jd k�s�J �|jd
k�s�J �|jd
k�s�J �|jd k�s�J �t � t �
t j
dd
d d ���}t|t j
��s J �|jdk�s.J �|jd
k�s>J �|jd k�sNJ �t � t �
t jdd d
d���}t|t j��s|J �|jdk�s�J �|jd k�s�J �|jd
k�s�J �d S )Nc S s4 t �t �| �� t�| �}t�|�}| |ks0J �d S �N)�json�loads�dumps�pickle)�ret�a�br. r. r/ �check s
z*TestMisc.test_serialization.<locals>.checkT)� clear_cache)�procr1 > Zwin_service_iterZwin_service_getZ net_if_stats)r1 i� r1 rI )r3 r1 rI �* )r3 r1 rQ rI �{ �! )�secondsr3 r1 )r) r+ r� r �iterZgettersZsubTestrD r# r r= r� r� r� r* �
isinstancer3 r1 rI r: rQ rX r� )r- r� r� �nsrx r1 r� r� r. r. r/ �test_serialization st
(
*�������zTestMisc.test_serializationc C s� t jjtjdtjd��"}t�� |js*J �W d � n1 s>0 Y t jjtjdt�d�d��"}t�� |jsvJ �W d � n1 s�0 Y t jjtjdtd��L}t �
t�� t�� W d � n1 s�0 Y |js�J �W d � n1 s�0 Y t jjtjdt� d�d��R}| � tj �� t�� W d � n1 �sL0 Y |j�sbJ �W d � n1 �sx0 Y d S )NZ
_get_identr2 r_ )
r r8 r9 r) r+ r= �calledr: �
ValueErrorr r' r* � assertRaises)r- �methr. r. r/ �test_ad_on_process_creationa s4
�(�(� &(�(z$TestMisc.test_ad_on_process_creationc C sz t jddd��X t�t��}tt� W d � n1 s80 Y dt|j�� � v sXJ �W d � n1 sl0 Y d S )Nz psutil._psplatform.cext.versionz0.0.0�Z return_valuezversion conflict)
r r8 r r' rr r! r) r4 �valuerv )r- �cmr. r. r/ �test_sanity_version_check~ s � &z"TestMisc.test_sanity_version_checkN) rd re rf ry r� r� r� r� r� r. r. r. r/ rg � s !] rg c @ sR e Zd Zdd� ZeZddd�Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dS )�TestMemoizeDecoratorc C s
g | _ d S r� ��callsr, r. r. r/ �setUp� s zTestMemoizeDecorator.setUpNc C s2 t d�D ]2}|� }| jdi fgks&J �|d ur||ksJ �qt d�D ]:}|d�}| jdi fdi fgksjJ �|d urD||ksDJ �qDt d�D ]H}|ddd�}| jdi fdi fdddifgks�J �|d ur�||ks�J �q�t| j�dks�J �|�� |� }|d u�r
||k�s
J �t| j�dk�s J �|jd k�s.J �d S )
Nr% r. r_ �r_ ��barr� � � �
My docstring.)�ranger� ra � cache_clearru )r- �obj�expected_retvalrm r� r. r. r/ � run_against� s, $
z TestMemoizeDecorator.run_againstc s& t � fdd��}| � | j|dd� d S )Nc s � j �| |f� dS �r� � �r� �append��args�kwargs�Z baseclassr. r/ rO � s z/TestMemoizeDecorator.test_function.<locals>.foor� �r� )r r� )r- rO r. r� r/ �
test_function� s z"TestMemoizeDecorator.test_functionc s> t G � fdd�d��}| � | j|d d� |� �� dks:J �d S )Nc s$ e Zd ZdZ� fdd�Zdd� ZdS )z,TestMemoizeDecorator.test_class.<locals>.Foor� c s � j �||f� d S r� r� �r- r� r� r� r. r/ �__init__� s z5TestMemoizeDecorator.test_class.<locals>.Foo.__init__c S s dS )Nr� r. r, r. r. r/ r� � s z0TestMemoizeDecorator.test_class.<locals>.Foo.barN)rd re rf ru r� r� r. r� r. r/ �Foo� s r� r� r� )r r� r� �r- r� r. r� r/ �
test_class� s
z TestMemoizeDecorator.test_classc C s� t G dd� d��}|� |� u s"J �t|� �t|� �ks:J �t|d��t|d��ksVJ �t|ddd��t|ddd��kszJ �t|d��t|d��ks�J �d S )Nc @ s e Zd Zdd� ZdS )z6TestMemoizeDecorator.test_class_singleton.<locals>.Barc _ s d S r� r. r� r. r. r/ r� � s z?TestMemoizeDecorator.test_class_singleton.<locals>.Bar.__init__N)rd re rf r� r. r. r. r/ �Bar� s r� r_ r� )rO r% )r �id)r- r� r. r. r/ �test_class_singleton� s $z)TestMemoizeDecorator.test_class_singletonc s, G � fdd�d�}| � | j |� jdd� d S )Nc s e Zd Zee� fdd���ZdS )z3TestMemoizeDecorator.test_staticmethod.<locals>.Fooc s � j �| |f� dS r� r� r� r� r. r/ r� � s z7TestMemoizeDecorator.test_staticmethod.<locals>.Foo.barN)rd re rf � staticmethodr r� r. r� r. r/ r� � s r� r� r� �r� r� r� r. r� r/ �test_staticmethod� s z&TestMemoizeDecorator.test_staticmethodc s, G � fdd�d�}| � | j |� jdd� d S )Nc s e Zd Zee� fdd���ZdS )z2TestMemoizeDecorator.test_classmethod.<locals>.Fooc s � j �||f� dS r� r� )�clsr� r� r� r. r/ r� � s z6TestMemoizeDecorator.test_classmethod.<locals>.Foo.barN)rd re rf � classmethodr r� r. r� r. r/ r� � s r� r� r� r� r� r. r� r/ �test_classmethod� s z%TestMemoizeDecorator.test_classmethodc s t � fdd��}g � td�D ].}|� }di f}||ks:J �t� �dks J �q td�D ]0}|d�}di f}||kstJ �t� �dksTJ �qTtd�D ]8}|ddd�}dddif}||ks�J �t� �d ks�J �q�|�� |� }di f}||ks�J �t� �d
ks�J �|jd k�s
J �d S ) Nc s � � d� | |fS )�Foo docstring.N�r� r� r� r. r/ rO � s
z/TestMemoizeDecorator.test_original.<locals>.foor% r. r_ r� r� r� r� r� r� )r r� ra r� ru )r- rO rm r� �expectedr. r� r/ �
test_original� s0 z"TestMemoizeDecorator.test_original)N) rd re rf r� �tearDownr� r� r� r� r� r� r� r. r. r. r/ r� � s
r� c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�TestCommonModulec s� G � fdd�d�}|� }g � |� � |� � t� �dks<J �g � |j �|� |� � |� � t� �dkslJ �g � |j �|� |� � |� � t� �dks�J �d S )Nc s e Zd Ze� fdd��ZdS )z9TestCommonModule.test_memoize_when_activated.<locals>.Fooc s � � d � d S r� r� r, r� r. r/ rO s z=TestCommonModule.test_memoize_when_activated.<locals>.Foo.fooN)rd re rf r rO r. r� r. r/ r� s r� r% r_ )rO ra Zcache_activateZcache_deactivate)r- r� �fr. r� r/ �test_memoize_when_activated s z,TestCommonModule.test_memoize_when_activatedc C s� dd� }t d�|d�diks J �t d�|d�d|d�diks@J �t d �|d�d|d�d
iks`J �t d �|d�d|d�diks�J �t d �|d�diks�J �t d
�|d�diks�J �t d�|d�diks�J �d S )Nc S s t r | �� S | S r� )r �upper)rb r. r. r/ �k0 s z4TestCommonModule.test_parse_environ_block.<locals>.kza=1 r� r� z a=1 b=2 r� �2za=1 b= rF z
a=1 b=2 c=3 zxxx a=1 z a=1 =b=2 za=1 b=2r
)r- r� r. r. r/ �test_parse_environ_block/ s �
�
z)TestCommonModule.test_parse_environ_blockc C s� | � tj� t� �rRt�d��(}d|_t�� t� r8J �W d � n1 sL0 Y t�� tjdtjd��$}t� rzJ �|js�J �W d � n1 s�0 Y t�� tjdtj d��,}t� r�J �t�� |js�J �W d � n1 s�0 Y t�� tjdtj d��0}t� �r J �t�� |j�s0J �W d � n1 �sF0 Y n`t
� tj��B t�tj tj
�}z|�d� W |�� n
|�� 0 W d � n1 �s�0 Y d S )Nzpsutil._common.socketFz psutil._common.socket.socketr2 z!psutil._common.socket.socket.bind)z::1r )Z
addCleanupr r� r r8 �has_ipv6�socket�errorr� �gaierrorr r' �AF_INET6� SOCK_STREAM�bind�close)r- rb �sockr. r. r/ �test_supports_ipv6D sF (�
(�
(� . z#TestCommonModule.test_supports_ipv6c C s� t j�t�}t|�sJ �tt j�|��r,J �tjdtt j
d�d��B t � t�� t|� W d � n1 sl0 Y W d � n1 s�0 Y tjdtt j
d�d��B t � t�� t|� W d � n1 s�0 Y W d � n1 s�0 Y tjdtt jd�d�� t|��r"J �W d � n1 �s80 Y tjddd�� t|��r`J �W d � n1 �sv0 Y d S )Nzpsutil._common.os.statrO r2 zpsutil._common.stat.S_ISREGFr� )r; �path�abspath�__file__r �dirnamer r8 �OSError�errno�EPERMr r' �EACCES�ENOENT)r- Z this_filer. r. r/ �test_isfile_strictk s& � D � D �.z#TestCommonModule.test_isfile_strictc C s� t rddlm} n ddlm} tj�tjdd��L t|� ��"}t d� t
j � � W d � n1 sd0 Y W d � n1 s�0 Y |�
� }|�d�s�J |��d|v s�J �t�dd�|v s�J �tj�tjdd��H t|� �� }t td �� W d � n1 �s0 Y W d � n1 �s(0 Y |�
� }d
|v �sHJ �d |v �sVJ �tj�tjdd��T t|� ��(}td d
�}d|_t |� W d � n1 �s�0 Y W d � n1 �s�0 Y |�
� }d
|v �s�J �d|v �s�J �d S )Nr )�StringIOZ PSUTIL_DEBUGTZhelloz psutil-debugz.pyc�.pyzthis is an errorzignoring ValueErrorz'this is an error'r% z no such filez/foo)r �ior� r r8 r9 r) �_commonr r �sys�stderr�flush�getvaluerp r� r5 r� r� �filename)r- r� r� rI �excr. r. r/ �
test_debug� s2 F L
HzTestCommonModule.test_debugc C s� | � � }t|d��}|�d� W d � n1 s20 Y t|�dksLJ �t|�dks\J �t�t�� t|d � W d � n1 s�0 Y t�t�� t|d � W d � n1 s�0 Y t|d dd�dks�J �t|d dd�dks�J �d S )N�wrO s fooz-invalidr� )�fallback)Z
get_testfn�open�writer r r r' r )r- Ztestfnr� r. r. r/ �
test_cat_bcat� s ( * *z TestCommonModule.test_cat_bcatN) rd re rf r� r� r� r� r� r� r. r. r. r/ r� s '!r� rO za b cc @ s� e Zd Zdd� ZeZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zejje dd �d d � �Zd S ) �TestWrapNumbersc C s t �� d S r� )r r� r, r. r. r/ r� � s zTestWrapNumbers.setUpc C s& dt ddd�i}t|d�|ks"J �d S �N�disk1rV �disk_io��ntr �r- �inputr. r. r/ �test_first_call� s z TestWrapNumbers.test_first_callc C s8 dt ddd�i}t|d�|ks"J �t|d�|ks4J �d S r� r� r� r. r. r/ �test_input_hasnt_changed� s z(TestWrapNumbers.test_input_hasnt_changedc C s� dt ddd�i}t|d�|ks"J �dt ddd�i}t|d�|ksDJ �dt ddd�i}t|d�|ksfJ �dt ddd�i}t|d�|ks�J �d S ) Nr� rV r� �
� � � � r� r� r. r. r/ �test_increase_but_no_wrap� s z)TestWrapNumbers.test_increase_but_no_wrapc C s� dt ddd�i}t|d�|ks"J �dt ddd�i}t|d�dt ddd�iksPJ �dt ddd�i}t|d�dt ddd�iks~J �dt ddd�i}t|d�dt ddd�iks�J �dt ddd�i}t|d�dt ddd �iks�J �dt ddd�i}t|d�dt ddd �ik�s
J �dt d
dd�i}t|d�dt d dd �ik�s:J �dt d dd�i}t|d�dt ddd �ik�sjJ �dt d dd�i}t|d�dt ddd �ik�s�J �d S )
Nr� �d r� r �n �Z � r �� �2 � �( r� r� r. r. r/ � test_wrap� s$ zTestWrapNumbers.test_wrapc C st dt ddd�i}t|d�|ks"J �t ddd�t ddd�d�}t|d�|ksNJ �dt ddd�i}t|d�|kspJ �d S )Nr� rV r� � �r� Zdisk2� r� r� r. r. r/ �test_changing_keys� s z"TestWrapNumbers.test_changing_keysc C s0 t ddd�t ddd�d�}t|d�|ks,J �t ddd�t ddd�d�}t|d�t ddd�t ddd�d�ksnJ �dt ddd�i}t|d�|ks�J �t ddd�t ddd�d�}t|d�|ks�J �t ddd�t ddd�d�}t|d�|ks�J �t ddd�t ddd�d�}t|d�t ddd�t ddd�d�k�s,J �d S )Nr r r r� r r
r� r� r� r. r. r/ �test_changing_keys_w_wrap� s$
�
�z)TestWrapNumbers.test_changing_keys_w_wrapc C sb ddddd�}t |d�|ks J �t |d�|ks2J �ddddd�}t |d�}|d d d
ks^J �d S ) N) i, � � �# �R �� � �� �ȷ ) i� r% i tU i i r r r r ) �6 r i �$ i �N r� � r i� � ) iU i� i" r i� i4 i� i� i\ )�nvme0n1Z nvme0n1p1Z nvme0n1p2Z nvme0n1p3r� ) r r r r r r r r r r" r i� r
)r- �d�outr. r. r/ �test_real_data s ��
z TestWrapNumbers.test_real_datac C sb dt ddd�i}t|d� t�� }|d d|iks6J �|d di iksJJ �|d di iks^J �d S )Nr� rV r� r r_ r% �r� r �
cache_info�r- r �cacher. r. r/ �test_cache_first_call( s
z%TestWrapNumbers.test_cache_first_callc C s� dt ddd�i}t|d� dt ddd�i}t|d� t�� }|d d|iksPJ �|d ddddd�ikslJ �|d di iks�J �d S ) Nr� rV r� r r r_ �)r� r )r� r_ �r� r% r% r& r( r. r. r/ �test_cache_call_twice0 s
�
z%TestWrapNumbers.test_cache_call_twicec C s� dt ddd�i}t|d� dt ddd�i}t|d� t�� }|d d|iksPJ �|d ddddd�ikslJ �|d ddtd g�iiks�J �d
d � }dt ddd�i}t|d� t�� }|d d|iks�J �|� dt ddd �i}t|d� t�� }|d d|ik�sJ �|� dt ddd
�i}t|d� t�� }|d d|ik�sDJ �|d ddddd�ik�sbJ �|d ddtd g�iik�s�J �d S )Nr� r r� r r r_ r+ r% r, c S sF t �� } | d ddddd�iks$J �| d ddtdg�iiksBJ �d S ) Nr_ r� r r r+ r% r� r, )r r' r` )r) r. r. r/ �check_cache_infoK s ��
z9TestWrapNumbers.test_cache_wrap.<locals>.check_cache_infor r r )r� r r' r` )r- r r) r. r. r. r/ �test_cache_wrap< s:
�
� z TestWrapNumbers.test_cache_wrapc C s� dt ddd�i}t|d� t ddd�t ddd�d�}t|d� t�� }|d d|iksZJ �|d ddddd�iksvJ �|d di iks�J �d S )
Nr� rV r� r r r r_ r+ r% r& r( r. r. r/ �test_cache_changing_keysn s
�
z(TestWrapNumbers.test_cache_changing_keysc C s\ dt ddd�i}t|d� t|d� t�d� t�� i i i fksDJ �t�d� t�d� d S )Nr� rV r� z?!?)r� r r� r' r� r. r. r/ �test_cache_clearz s
z TestWrapNumbers.test_cache_clear�
not supported��reasonc C s� t �� rt �� st�d��t �� t �� t�� }|D ] }d|v sFJ �d|v s6J �q6t j�� t�� }|D ] }d|v szJ �d|vsjJ �qjt j�� t�� }|i i i fks�J �d S )Nzno disks or NICs availablezpsutil.disk_io_counterszpsutil.net_io_counters)r) Zdisk_io_countersZnet_io_countersr �skipr r' r� )r- �cachesr) r. r. r/ � test_cache_clear_public_apis� s
z,TestWrapNumbers.test_cache_clear_public_apisN)rd re rf r� r� r r r r r r r% r* r- r/ r0 r1 r �mark�skipifr r7 r. r. r. r/ r� � s
2 r� z can't locate scripts directoryr3 c @ s� e Zd ZdZedd� �Zedd� �Zdd� Zej j
e dd �d
d � �Z d d
� Z
dd� Zdd� Zdd� Zej j
eoxe�� dd �dd� �Zdd� Zdd� Zdd � Zej j
ed d �d d � �Zej j
e d d �d!d"� �Zd#d$� Z d%d&� Z d'd(� Z d)d*� Z d+d,� Z d-d.� Z!ej j
e" d/d �d0d1� �Z#d2d3� Z$ej j
e% d d �d4d5� �Z&ej j
e' d d �d6d7� �Z(ej j
e) d d �ej j
e* d8d �d9d:� ��Z+ej j
e) d d �ej j
e* d8d �d;d<� ��Z,d=S )>� TestScriptsz-Tests for scripts in the "scripts" directory.c
O s� |� dt� dtj�t| � } t| g}|D ]}|�|� q*zt|fi |��� � }W nF t
y� } z.dt |�v r�t |�W Y d }~S � W Y d }~n
d }~0 0 |s�J |��|S )N�envz%sr= ) �
setdefaultr r; r� r r r r� r" �strip� RuntimeErrorr4 )�exer� r� �cmd�argr$ �errr. r. r/ �
assert_stdout� s zTestScripts.assert_stdoutc C s\ t j�t| �} tr t| dd�nt| ��}|�� }W d � n1 sD0 Y t�|� d S )N�utf8)�encoding) r; r� r r r r� �read�ast�parse)r? r� �srcr. r. r/ �
assert_syntax� s &zTestScripts.assert_syntaxc C sV t | �}t�t�D ]>}|�d�rdtj�|�d |vr| �dtj�t|� ��qd S )Nr� Ztest_r z no test defined for %r script) ro r; �listdirr �endswithr� �splitextrw r )r- Zmethsr1 r. r. r/ �
test_coverage� s
��zTestScripts.test_coveragez
POSIX onlyr3 c C s` t �t�D ]P\}}}|D ]@}|�d�rt j�||�}tjt �|�tj @ s| � d| ��qq
d S )Nr� z%r is not executable)
r; �walkr rL r� r �stat�S_IXUSR�ST_MODErw )r- �root�dirs�files�filer� r. r. r/ �test_executable� s
zTestScripts.test_executablec C s | � d� d S )Nz
disk_usage.py�rC r, r. r. r/ �test_disk_usage� s zTestScripts.test_disk_usagec C s | � d� d S )Nzfree.pyrX r, r. r. r/ � test_free� s zTestScripts.test_freec C s | � d� d S )Nz
meminfo.pyrX r, r. r. r/ � test_meminfo� s zTestScripts.test_meminfoc C s | � dtt�� �� d S )Nz procinfo.py�rC r4 r; r< r, r. r. r/ �
test_procinfo� s zTestScripts.test_procinfozno usersc C s | � d� d S )Nzwho.pyrX r, r. r. r/ �test_who� s zTestScripts.test_whoc C s | � d� d S )Nzps.pyrX r, r. r. r/ �test_ps� s zTestScripts.test_psc C s | � d� d S )Nz pstree.pyrX r, r. r. r/ � test_pstree� s zTestScripts.test_pstreec C s | � d� d S )Nz
netstat.pyrX r, r. r. r/ � test_netstat� s zTestScripts.test_netstatzQEMU user not supportedc C s | � d� d S )Nz ifconfig.pyrX r, r. r. r/ �
test_ifconfig� s zTestScripts.test_ifconfigr2 c C s | � dtt�� �� d S )Nzpmap.pyr\ r, r. r. r/ � test_pmap� s zTestScripts.test_pmapc C s* dt �� �� jvr t�d��| �d� d S )NZussr2 z procsmem.py)r) r+ Zmemory_full_info�_fieldsr r5 rC r, r. r. r/ �
test_procsmem� s
zTestScripts.test_procsmemc C s | � d� d S )Nz
killall.py�rJ r, r. r. r/ � test_killall� s zTestScripts.test_killallc C s | � d� d S )Nz nettop.pyrf r, r. r. r/ � test_nettop� s zTestScripts.test_nettopc C s | � d� d S )Nztop.pyrf r, r. r. r/ �test_top� s zTestScripts.test_topc C s | � d� d S )Nziotop.pyrf r, r. r. r/ �
test_iotop s zTestScripts.test_iotopc C s, | � dt�� �� �}tt�� �|v s(J �d S )Nzpidof.py)rC r) r+ r1 r4 r; r< )r- �outputr. r. r/ �
test_pidof s zTestScripts.test_pidofz WINDOWS onlyc C s | � d� d S )Nzwinservices.pyrX r, r. r. r/ �test_winservices s z TestScripts.test_winservicesc C s | � d� d S )Nzcpu_distribution.pyrf r, r. r. r/ �test_cpu_distribution s z!TestScripts.test_cpu_distributionc C s t �� st�d��| �d� d S )Nzno temperaturesztemperatures.py)r) Zsensors_temperaturesr r5 rC r, r. r. r/ �test_temperatures s
z TestScripts.test_temperaturesc C s t �� st�d��| �d� d S )Nzno fanszfans.py)r) Z sensors_fansr r5 rC r, r. r. r/ � test_fans s
zTestScripts.test_fansz
no batteryc C s | � d� d S )Nz
battery.pyrX r, r. r. r/ � test_battery s zTestScripts.test_batteryc C s | � d� d S )Nz
sensors.pyrX r, r. r. r/ � test_sensors s zTestScripts.test_sensorsN)-rd re rf ru r� rC rJ rN r r8 r9 r rW rY rZ r[ r] r r) Zusersr^ r_ r` ra r rb r rc re rg rh ri rj rl r rm rn r ro r rp r r rq rr r. r. r. r/ r: � sP
r: ):ru rG � collectionsr� r� r; r� r� rP r� r) Z psutil.testsr r Zpsutil._commonr r r r r r r r r Zpsutil._compatr r r r r r r r r r r r r r r r r r r! r" r# r$ rg r� r� �
namedtupler� r� r8 r9 r� �existsr: r. r. r. r/ �<module> st 8 ! h�PK ok\�6�r �r 3 psutil/tests/__pycache__/test_system.cpython-39.pycnu �[��� a
��?hO� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl m
Z
ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ dd l mZ dd
l mZ dd l mZ dd l mZ dd
lmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# ddlm$Z$ ddlm%Z% ddlm&Z& ddlm'Z' dd lm(Z( dd lm)Z) dd lm*Z* dd lm+Z+ dd lm,Z, dd!lm-Z- dd"lm.Z. dd#lm/Z/ dd$lm0Z0 dd%lm1Z1 dd&lm2Z2 G d'd(� d(e-�Z3G d)d*� d*e-�Z4G d+d,� d,e-�Z5G d-d.� d.e-�Z6G d/d0� d0e-�Z7G d1d2� d2e-�Z8G d3d4� d4e-�Z9G d5d6� d6e-�Z:dS )7zTests for system APIS.� N)�AIX)�BSD)�FREEBSD)�LINUX)�MACOS)�NETBSD)�OPENBSD)�POSIX)�SUNOS)�WINDOWS)�PY3)�FileNotFoundError)�long)�ASCII_FS)�
CI_TESTING)�DEVNULL)�GITHUB_ACTIONS)�GLOBAL_TIMEOUT)� HAS_BATTERY)� HAS_CPU_FREQ)�HAS_GETLOADAVG)�HAS_NET_IO_COUNTERS)�HAS_SENSORS_BATTERY)�HAS_SENSORS_FANS)�HAS_SENSORS_TEMPERATURES)�IS_64BIT)� MACOS_12PLUS)�PYPY)� QEMU_USER)�UNICODE_SUFFIX)�PsutilTestCase)�check_net_address)�enum)�mock)�pytest)�retry_on_failurec @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )�TestProcessIterc C s~ t �� dd� t�� D �v s J �| �� }|jdd� t�� D �v sBJ �t�|j�}|�� |�� |jdd� t�� D �vszJ �d S )Nc S s g | ]
}|j �qS � ��pid��.0�xr' r' �D/usr/local/lib64/python3.9/site-packages/psutil/tests/test_system.py�
<listcomp>C � z5TestProcessIter.test_pid_presence.<locals>.<listcomp>c S s g | ]
}|j �qS r' r( r* r' r' r- r. E r/ c S s g | ]
}|j �qS r' r( r* r' r' r- r. I r/ ) �os�getpid�psutil� process_iter�spawn_testprocr) �Process�kill�wait��selfZsproc�pr' r' r- �test_pid_presenceB s z!TestProcessIter.test_pid_presencec C s> dd� t �� D �}t|dd� d�tt|�dd� d�ks:J �d S )Nc S s g | ]}|�qS r' r' r* r' r' r- r. L r/ z6TestProcessIter.test_no_duplicates.<locals>.<listcomp>c S s | j S �Nr( �r, r' r' r- �<lambda>M r/ z4TestProcessIter.test_no_duplicates.<locals>.<lambda>)�keyc S s | j S r< r( r= r' r' r- r> N r/ )r2 r3 �sorted�set)r9 �lsr' r' r- �test_no_duplicatesK s �z"TestProcessIter.test_no_duplicatesc C sz t t�� � td�D ]`}tjdt�t�� �d��* t tjdgd��g ksLJ �W d � n1 s`0 Y tj� � qd S �N� zpsutil.Process.as_dict�Z side_effect� cpu_times��attrs)
�listr2 r3 �ranger# �patchZ
NoSuchProcessr0 r1 � cache_clear�r9 r, r' r' r- �test_emulate_nspQ s �8z TestProcessIter.test_emulate_nspc
C s� t t�� � td�D ]�}tjdt�t�� �d��N t �
tj��" t tjdgd�� W d � n1 sf0 Y W d � n1 s�0 Y tj� � qd S rD ) rJ r2 r3 rK r# rL � AccessDeniedr0 r1 r$ �raisesrM rN r' r' r- �test_emulate_access_denied[ s �Nz*TestProcessIter.test_emulate_access_deniedc C s� t jdgd�D ] }t|j�� �dgksJ �qt jdgd�D ] }t|j�� �dgks:J �q:t�t��" tt jdgd�� W d � n1 s�0 Y tj dt �
dd�d��T}t jddgd�D ](}|jd d u s�J �|jd dks�J �q�|j s�J �W d � n1 �s0 Y tj dt �
dd�d��d}t � }t jddg|d �D ].}|jd |u �sXJ �|jd dk�s@J ��q@|j �s|J �W d � n1 �s�0 Y d S )
Nr) rH Zfooz$psutil._psplatform.Process.cpu_timesr � rF rG )rI Zad_value)
r2 r3 rJ �info�keysr$ rQ �
ValueErrorr# rL rP �called�object)r9 r: �m�flagr' r' r- �
test_attrsf s6 0
�*
��
zTestProcessIter.test_attrsc C s. t t�� � tjsJ �tj�� tjr*J �d S r< )rJ r2 r3 Z_pmaprM �r9 r' r' r- �test_cache_clear� s
z TestProcessIter.test_cache_clearN) �__name__�
__module__� __qualname__r; rC rO rR r[ r] r' r' r' r- r& A s
r& c @ sT e Zd Zejjeoedd�dd� �Zejjeo0edd�dd� �Z dd� Z
d d
� Z d S ) �TestProcessAPIsz-spawn_testproc() unreliable on PYPY + WINDOWS��reasonc s4 � fdd�}g � | � � }| � � }| � � }dd� |||fD �}t�t�� tj|dd� W d � n1 sj0 Y t�t�� tj|dd� W d � n1 s�0 Y t�� }tj|d |d
�\}}t�� | d k s�J �|g ks�J �t|�d ks�J �� g k�sJ �|D ]} t | d
��r
J ��q
t
d�dd� �}
|� � |
||�\}}|j dd� |D �v �sbJ �t
�r�|�� jtj k�s�J �n|�� jdk�s�J �� |j gk�s�J �|D ]} t | d
��r�J ��q�t
d�dd� �} |� � |� � | ||�\}}t� �t|j |j |j g�k�sJ �|D ]} t | d
��sJ ��qd S )Nc s � � | j� d S r< )�appendr) )r: ��pidsr' r- �callback� s z1TestProcessAPIs.test_wait_procs.<locals>.callbackc S s g | ]}t �|j��qS r' �r2 r5 r) r* r' r' r- r. � r/ z3TestProcessAPIs.test_wait_procs.<locals>.<listcomp>���)�timeout� )rg g{�G�z�?�rj rg g �?� �
returncode� c S s< t j| d|d�\}}t|�dks$J �t|�dks4J �||fS )N� ��Q��?rl rk rE �r2 �
wait_procs�len��procsrg �gone�aliver' r' r- �test_1� s �
z/TestProcessAPIs.test_wait_procs.<locals>.test_1c S s g | ]
}|j �qS r' r( r* r' r' r- r. � r/ c S s< t j| d|d�\}}t|�dks$J �t|�dks4J �||fS )Nrp rl rm r rq rt r' r' r- �test_2� s �
z/TestProcessAPIs.test_wait_procs.<locals>.test_2)r4 r$ rQ rV r2 rr � TypeError�timers �hasattrr% � terminater) r �poprn �signal�SIGTERMrA ) r9 rg �sproc1�sproc2�sproc3ru �trv rw r: rx ry r' re r- �test_wait_procs� sJ , ,
"z TestProcessAPIs.test_wait_procsc C sL | � � }| � � }| � � }dd� |||fD �}|D ] }|�� q0t�|� d S )Nc S s g | ]}t �|j��qS r' rh r* r' r' r- r. � r/ z>TestProcessAPIs.test_wait_procs_no_timeout.<locals>.<listcomp>)r4 r} r2 rr )r9 r� r� r� ru r: r' r' r- �test_wait_procs_no_timeout� s
z*TestProcessAPIs.test_wait_procs_no_timeoutc C sp | � � }t�|j�sJ �t�|j�}|�� |�� t�|j�rDJ �t�d�rRJ �t�d�dt�� v kslJ �d S )Nri r )r4 r2 �
pid_existsr) r5 r6 r7 rf r8 r' r' r- �test_pid_exists� s z TestProcessAPIs.test_pid_existsc C s� t �� }|D ]D}zt �|�s J �W q tyN t�d� |t �� vsJJ �Y q 0 q tt|�d t|�d �}|D ]}t �|�rpJ �qpd S )Ng�������?i�: i�> )r2 rf r� �AssertionErrorr{ �sleeprK �max)r9 rf r) r' r' r- �test_pid_exists_2� s
z!TestProcessAPIs.test_pid_exists_2N) r^ r_ r` r$ �mark�skipifr r r� r� r� r� r' r' r' r- ra � s �
;�
ra c @ sF e Zd Zdd� Zejjeo"e� � dd�dd� �Z
dd� Z d d
� Z d S ) � TestMiscAPIsc C s6 t �� }t|t�sJ �|dks"J �|t�� k s2J �d S �Nr )r2 Z boot_time�
isinstance�floatr{ )r9 Zbtr' r' r- �test_boot_time� s zTestMiscAPIs.test_boot_time�unreliable on CIrb c C s� t �� }|g ksJ �|D ]�}| j|d��� |js4J �t|jt�sDJ �t|jttd �f�s\J �|jd ur~t|jttd �f�s~J �|j |j |j dks�J �t
j
� |j � t s�t
r�|jd u s�J �n t �|j� W d � q1 s�0 Y qd S )N)�user� )r2 �users�subTest�namer� �strZterminal�type�host�started�datetime�
fromtimestampr r r) r5 )r9 r� r� r' r' r- �
test_users� s
zTestMiscAPIs.test_usersc C s, t j}tt _zt�� W |t _n|t _0 d S r< )�sys�stdoutr r2 �test)r9 r� r' r' r- � test_test s
zTestMiscAPIs.test_testc C s| g d�}|D ] }t tt|�t�s J |��q tjdk�r6tjs@J �tjrJJ �|�d� dt j
� � v rxtj slJ �|�d� n�dt j
� � v r�tj
s�J �tjtjtjg�d�dks�J �|�d � |�d
� |�d � |�d � n\d
t j
� � v s�dt j
� � v �rtj�sJ �|�d� n&dt j
� � v �rXtj�s*J �|�d� n"tj�sBJ �tj�rNJ �|�d� |D ]}tt|��r\J |���q\d S )N) r r r r r r r r r
�posixr �linuxr ZbsdTrk r r r r �sunos�solarisr
�darwinr r )r� �getattrr2 �boolr0 r� r r �remover� �platform�lowerr r r r r �countr
r )r9 �namesr� r' r' r- �test_os_constants sF
��
� �
z TestMiscAPIs.test_os_constantsN)
r^ r_ r` r� r$ r� r� r r2 r� r� r� r� r' r' r' r- r� � s �
r� c @ s e Zd Zdd� Zdd� ZdS )�TestMemoryAPIsc C s� t �� }|jdksJ |��|jdks,J |��d|j krBdksLn J |��|jdks^J |��|jdkspJ |��|jD ]l}t||�}|dkr�t |t
t f�s�J �|dkrv|dks�| � d||f ��||jkrv| � d||j||f ��qvd S )Nr �d �percent�totalz %r < 0 (%s)z %r > total (total=%s, %s=%s))
r2 Zvirtual_memoryr� � availabler� �used�free�_fieldsr� r� �intr �fail)r9 �memr� �valuer' r' r- �test_virtual_memoryH s&
��z"TestMemoryAPIs.test_virtual_memoryc C s� t �� }|jdksJ �|jdks(J |��|jdks:J |��|jdkrX|jdksjJ |��n|jdksjJ |��d|j kr�dks�n J |��|jdks�J |��|jdks�J |��d S )N)r� r� r� r� �sin�soutr r� ) r2 Z swap_memoryr� r� r� r� r� r� r� )r9 r� r' r' r- �test_swap_memory\ s
z TestMemoryAPIs.test_swap_memoryN)r^ r_ r` r� r� r' r' r' r- r� G s r� c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z e
j j e
oLedd�dd� �Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Ze
j j eo�e�� d!kd"d�e
j j e d#d�d$d%� ��Ze
j j e d#d�d&d'� �Z d(S ))� TestCpuAPIsc C s� t �� }|d usJ �|tt jdd��ks,J �|dks8J �tj�d�r�td��}|�� }W d � n1 sj0 Y d|vr�t �
d��d S )NT��percpurk z
/proc/cpuinfoz physical idz#cpuinfo doesn't include physical id) r2 � cpu_countrs rG r0 �path�exists�open�readr$ �skip)r9 �logical�fdZ cpuinfo_datar' r' r- �test_cpu_count_logicalt s
&z"TestCpuAPIs.test_cpu_count_logicalc C sh t �� }t jdd�}|d u r&t�d��trLt�� d d� dkrL|d u sdJ �n|dksXJ �||ksdJ �d S )NF�r� zcpu_count_cores() is NonerE )� rk rk )r2 r� r$ r� r r� �getwindowsversion)r9 r� Zcoresr' r' r- �test_cpu_count_cores� s
z TestCpuAPIs.test_cpu_count_coresc C s� dD ]�}t jd|d��*}t�� d u s(J �|js2J �W d � n1 sF0 Y t jd|d��.}tjdd�d u stJ �|js~J �W d � q1 s�0 Y qd S )N)ri r Nz$psutil._psplatform.cpu_count_logical�Z return_valuez"psutil._psplatform.cpu_count_coresFr� )r# rL r2 r� rW )r9 �valrY r' r' r- �test_cpu_count_none� s �(�z TestCpuAPIs.test_cpu_count_nonec C sj d}t �� }t|� |D ]&}t|t�s*J �|dks6J �||7 }qtt|t|� �d�dks^J �t|� d S )Nr r� r� )r2 rG �sumr� r� �round�absr� )r9 r� �times�cp_timer' r' r- �test_cpu_times� s
zTestCpuAPIs.test_cpu_timesc C sL t t�� �}t�� t }t�� |k r>t t�� �}||krd S q| �d��d S )Nztime remained the same)r� r2 rG r{ r r� )r9 �t1Zstop_at�t2r' r' r- � test_cpu_times_time_increases� s z)TestCpuAPIs.test_cpu_times_time_increasesc C s� t jdd�D ]b}d}t|� |D ]&}t|t�s2J �|dks>J �||7 }q tt|t|� �d�dksfJ �t|� q tt jdd�d �tt jdd��ks�J �d S )NTr� r r� r� F) r2 rG r� r� r� r� r� r� rs )r9 r� r� r� r' r' r- �test_per_cpu_times� s
�z TestCpuAPIs.test_per_cpu_timesc C s� t jdd�}t�� t }t�� |kr.| �d�S t jdd�}t||�D ]4\}}t �|�t �|� }}|| }|dkrD d S qDqd S )NTr� rj g�������?)r2 rG r{ r r� �zipZ_cpu_busy_time)r9 Ztot1Z giveup_atZtot2r� r� �
differencer' r' r- �test_per_cpu_times_2� s
z TestCpuAPIs.test_per_cpu_times_2zunreliable on OPENBSD + CIrb c C s� t �� }t jdd�}|�dd� t|� D ��}|jD ]T}| j|||d��0 tt||�t||� �dk shJ �W d � q21 s|0 Y q2d S )NTr� c S s g | ] }t |��qS r' )r� )r+ �numr' r' r- r. � r/ z9TestCpuAPIs.test_cpu_times_comparison.<locals>.<listcomp>)�field�base�per_cpurk )r2 rG �_maker� r� r� r� r� )r9 r� r� Z
summed_valuesr� r' r' r- �test_cpu_times_comparison� s
��z%TestCpuAPIs.test_cpu_times_comparisonc
C s� z>t |t�sJ �|dks J �|dus(J �|dt�� ks<J �W nB ty� } z*td|t�|�t�|�f ��W Y d }~n
d }~0 0 d S )Nr� g �g Y@z
%s
last=%s
new=%s)r� r� r2 r� r� �pprint�pformat)r9 r� Zlast_retZnew_ret�errr' r' r- �_test_cpu_percent s ��z TestCpuAPIs._test_cpu_percentc C sr t jdd�}td�D ]"}t jd d�}| �|||� |}qt�t�� t jdd� W d � n1 sd0 Y d S �N���MbP?)�intervalr� ri )r2 � cpu_percentrK r� r$ rQ rV )r9 �last�_�newr' r' r- �test_cpu_percent s z TestCpuAPIs.test_cpu_percentc C s� t jddd�}t|�t �� ks"J �td�D ].}t jd dd�}|D ]}| �|||� q@|}q*t�t�� t jddd� W d � n1 s�0 Y d S )Nr� T�r� r� r� ri ) r2 r� rs r� rK r� r$ rQ rV �r9 r� r� r� r� r' r' r- �test_per_cpu_percent s z TestCpuAPIs.test_per_cpu_percentc C s� t jdd�}td�D ]>}t jd d�}|D ]}| �|||� q(| �t|�||� |}qt�t�� t jdd� W d � n1 s�0 Y d S r� )r2 �cpu_times_percentrK r� r� r$ rQ rV r� r' r' r- �test_cpu_times_percent" s z"TestCpuAPIs.test_cpu_times_percentc C sz t jddd�}t|�t �� ks"J �td�D ]J}t jd dd�}|D ].}|D ]}| �|||� qH| �t|�||� q@|}q*d S )Nr� Tr� r� )r2 r� rs r� rK r� r� )r9 r� r� r� �cpur� r' r' r- �test_per_cpu_times_percent- s z&TestCpuAPIs.test_per_cpu_times_percentc C s~ t jdd� dd� t jdd�D �}tjd|d��: t jdd�D ] }|D ]}| �|d d � qFq>W d � n1 sp0 Y d S )NTr� c S s* g | ]"}|� d d� tt|j��D ���qS )c S s g | ]}d �qS )r r' r* r' r' r- r. < r/ zNTestCpuAPIs.test_per_cpu_times_percent_negative.<locals>.<listcomp>.<listcomp>)r� rK rs r� r* r' r' r- r. ; s �zCTestCpuAPIs.test_per_cpu_times_percent_negative.<locals>.<listcomp>zpsutil.cpu_timesr� )r2 r� rG r# rL r� )r9 Z
zero_timesr� r� r' r' r- �#test_per_cpu_times_percent_negative8 s
�z/TestCpuAPIs.test_per_cpu_times_percent_negativec C sT t �� }|jdksJ �|jD ]2}t||�}|dks6J �ts |dv r |dks J �q d S )N)� ctx_switches�
interruptsZsoft_interruptsZsyscallsr )r� r� )r2 Z cpu_statsr� r� r )r9 �infosr� r� r' r' r- �test_cpu_statsD s
zTestCpuAPIs.test_cpu_stats�arm64zskipped due to #1892�
not supportedc C s` dd� }t jdd�}tr&|s&t�d��|s2J |��|t jdd�g� tr\t|�t �� ks\J �d S )Nc S sl | D ]b}|j dksJ �|jdkr0|j|jks0J �|j D ].}t||�}t|tttf�sXJ �|dks6J �q6qd S )N)�current�minr� r� r )r� r� r r� r� r� r r� )rB �ntr� r� r' r' r- �check_lsZ s
z+TestCpuAPIs.test_cpu_freq.<locals>.check_lsTr� z returns empty list on FreeBSDF)r2 Zcpu_freqr r$ r� r rs r� )r9 r rB r' r' r- �
test_cpu_freqU s
zTestCpuAPIs.test_cpu_freqc C s@ t �� }t|�dksJ �|D ] }t|t�s.J �|dks J �q d S )Nrm r� )r2 �
getloadavgrs r� r� )r9 Zloadavg�loadr' r' r- �test_getloadavgn s
zTestCpuAPIs.test_getloadavgN) r^ r_ r` r� r� r� r� r� r� r� r$ r� r� r r r� r� r� r� r� r� r� r� r r� �machiner r r r r' r' r' r- r� s s2
"�
� r� c @ s� e Zd Zejjeoe dd�dd� �Zejje dd�dd� �Z
dd � Z d
d � Z ejje
ofej�d � d
d�ejjeo~e�� dd�dd� ��Zdd� ZdS )� TestDiskAPIsz unreliable on PYPY32 + 32BITrb c C s> t �t�� �}|jdks J �|jdks.J |��|jdks@J |��|jdksRJ |��|j|jksfJ |��|j|jkszJ |��d|j kr�dks�n J |j��t t
d�r�t
�t�� �}d}|j|jks�J �t |j|j �|k s�J �t s�t |j|j �|k s�J �| �
� }t�t�� t �|� W d � n1 �s00 Y d S )N)r� r� r� r� r r� �
disk_usagei P )r2 r r0 �getcwdr� r� r� r� r� r| �shutilr� r Z
get_testfnr$ rQ r
)r9 �usageZ shutil_usageZ tolerance�fnamer' r' r- �test_disk_usagex s$ "
z TestDiskAPIs.test_disk_usageznot an ASCII fsc C s8 t �t�� t�t� W d � n1 s*0 Y d S r< )r$ rQ �UnicodeEncodeErrorr2 r r r\ r' r' r- �test_disk_usage_unicode� s z$TestDiskAPIs.test_disk_usage_unicodec C s t �d� d S )N� .)r2 r r\ r' r' r- �test_disk_usage_bytes� s z"TestDiskAPIs.test_disk_usage_bytesc C s~ dd� }t jdd�}|s J �|D ]b}||� tr<d|jv r<q tsXtj�|j�s^J |��n|j tj�|j �stJ |��|j
s J |��q t jdd�}|s�J �t jdd�D ]�}||� ts�|j r�zt� |j � W nb t �y, } zHt
�rt�r|jtjk�rW Y d }~q�|jtjtjfv�r� W Y d }~q�d }~0 0 tj�|j �s�J |��q�dd� }|t�}d d
� t jdd�D �}||v �szJ �d S ) Nc S sD t | jt�sJ �t | jt�s J �t | jt�s0J �t | jt�s@J �d S r< )r� �devicer� �
mountpoint�fstype�opts�r r' r' r- � check_ntuple� s z7TestDiskAPIs.test_disk_partitions.<locals>.check_ntupleF)�allZcdromTc S s. t j�| �} t j�| �s&t j�| �} q | �� S r< )r0 r� �abspath�ismount�dirnamer� )r� r' r' r- �find_mount_point� s z;TestDiskAPIs.test_disk_partitions.<locals>.find_mount_pointc S s g | ]}|j r|j �� �qS r' )r r� r* r' r' r- r. � s �z5TestDiskAPIs.test_disk_partitions.<locals>.<listcomp>)r2 Zdisk_partitionsr r r r0 r� r� r r r �stat�OSErrorr r �errno�EIO�EPERM�EACCES�__file__)r9 r rB Zdiskr� r �mountZmountsr' r' r- �test_disk_partitions� s>
�z!TestDiskAPIs.test_disk_partitionsz/proc/diskstatsz3/proc/diskstats not available on this linux versionr� c C sv dd� }t jdd�}|d us$J d��||� t jdd�}t|�tt|��ksPJ �|D ] }|sdJ |��||| � qTd S )Nc S s� | d | j ksJ �| d | jks$J �| d | jks6J �| d | jksHJ �ts�ts�| d | jksbJ �| d | jkstJ �tr�| d | j ks�J �| d | j
ks�J �| d | j ks�J �nt r�| d | j ks�J �| j
D ]}t| |�dks�J | ��q�d S )
Nr rk rE rm � � r� � � )Z
read_countZ write_count�
read_bytes� write_bytesr r Z read_timeZ
write_timer Zread_merged_countZwrite_merged_countZ busy_timer r� r� )r r� r' r' r- r � s
z8TestDiskAPIs.test_disk_io_counters.<locals>.check_ntupleF�Zperdiskzno disks on this system?T)r2 �disk_io_countersrs rA �r9 r �retr? r' r' r- �test_disk_io_counters� s z"TestDiskAPIs.test_disk_io_countersc C sd t jdi d��B}tjdd�d u s$J �tjdd�i ks8J �|jsBJ �W d � n1 sV0 Y d S )Nz#psutil._psplatform.disk_io_countersr� Fr0 T)r# rL r2 r1 rW �r9 rY r' r' r- � test_disk_io_counters_no_disks� s �z+TestDiskAPIs.test_disk_io_counters_no_disksN)r^ r_ r` r$ r� r� r r r r r r r) r r0 r� r� r r2 r1 r4 r6 r' r' r' r- r w s"
�
:�� r c @ s� e Zd Zejje dd�dd� �Zejje dd�dd� �Zejje dd�dd � �Z
d
d � Z ejje dd�d d
� �Z ejje
p�ep�e dd�dd� �ZdS )� TestNetAPIsr rb c C sd dd� }t jdd�}||� t jdd�}|g ks4J �|D ]&}|sDJ �t|t�sRJ �||| � q8d S )Nc S s( | d | j ksJ �| d | jks$J �| d | jks6J �| d | jksHJ �| d | jksZJ �| d | jkslJ �| d | jks~J �| d | jks�J �| j dks�J | ��| jdks�J | ��| jdks�J | ��| jdks�J | ��| jdks�J | ��| jdks�J | ��| jdk�sJ | ��| jdk�s$J | ��d S ) Nr rk rE rm r* r+ r� r, )Z
bytes_sentZ
bytes_recvZ packets_sentZ packets_recvZerrinZerroutZdropinZdropoutr r' r' r- r s z6TestNetAPIs.test_net_io_counters.<locals>.check_ntupleF�ZpernicT)r2 �net_io_countersr� r� r2 r' r' r- �test_net_io_counters s z TestNetAPIs.test_net_io_countersc C sd t jdi d��B}tjdd�d u s$J �tjdd�i ks8J �|jsBJ �W d � n1 sV0 Y d S )Nz"psutil._psplatform.net_io_countersr� Fr8 T)r# rL r2 r9 rW r5 r' r' r- � test_net_io_counters_no_nics$ s �z(TestNetAPIs.test_net_io_counters_no_nicszQEMU user not supportedc
C s� t �� }|sJ |��t �� }ttjtjt jg�}|�� D �]\}}t |t
�sPJ �t t|��t |�kshJ �|D �]�}t |j t
�s�J �t |jt
�s�J �t |jt
td �f�s�J �t |jt
td �f�s�J �|j |v s�J �tr�ts�t |j tj�s�J �|| j�r�|j tjk�rNt�|j �}t�|�� |�|jdf� W d � n1 �sB0 Y n�|j tjk�r�t�|jdtjtjdtj �d }|\} }
} } }
t�| |
| �}t�|�� |�|
� W d � n1 �s�0 Y |j|j|j|j fD ]*}|d u�r�|j tjk�r�t ||j � �q�|j�r(|j d u �s<J �ql|j rl|jd u slJ �qlq8t �sRt �sRt!�rrt"td��r�t jtjk�s�J �n0t#�r�t jtj$k�s�J �nt%�r�t jdk�s�J �d S )Nr �AF_LINKri )&r2 � net_if_addrs� net_if_statsrA �socket�AF_INET�AF_INET6r< �itemsr� r� rs �familyr� �address�netmaskr� � broadcastr r r" �IntEnum�isup�
contextlib�closing�bind� getaddrinfo� SOCK_STREAM�
AI_PASSIVEZptpr! r r r
r| r � AF_PACKETr )r9 �nicsZ nic_statsZfamiliesZnic�addrs�addr�srT �af�socktype�protoZ
_canonname�sa�ipr' r' r- �test_net_if_addrs/ sl
2�� *�
z TestNetAPIs.test_net_if_addrsc C s� t rdtjdd d d fg}ndg}tjd|d��L}t�� d d }|jsJJ �t r^|jdkslJ �n|jdkslJ �W d � n1 s�0 Y d S ) N�em1z06:3d:29)rZ ri z06-3d-29NNNz psutil._psplatform.net_if_addrsr� r z06:3d:29:00:00:00z06-3d-29-00-00-00)r r2 r< r# rL r= rW rD )r9 r3 rY rR r' r' r- � test_net_if_addrs_mac_null_bytesu s �
z,TestNetAPIs.test_net_if_addrs_mac_null_bytesc
C s� t �� }|sJ |��t jt jt jf}|�� D ]p\}}t|t�sBJ �|\}}}}} t|t�s^J �||v sjJ �||v svJ �|dks�J �|dks�J �t| t�s,J �q,d S r� ) r2 r> ZNIC_DUPLEX_FULLZNIC_DUPLEX_HALFZNIC_DUPLEX_UNKNOWNrB r� r� r� )
r9 rP Z all_duplexesr� �statsrH Zduplex�speedZmtu�flagsr' r' r- �test_net_if_stats� s � z TestNetAPIs.test_net_if_statsz LINUX or BSD or MACOS specificc C sX t jdttjd�d��.}t�� }|i ks,J �|js6J �W d � n1 sJ0 Y d S )Nz psutil._psutil_posix.net_if_mturS rF )r# rL r" r# ZENODEVr2 r> rW )r9 rY r3 r' r' r- �test_net_if_stats_enodev� s
� z$TestNetAPIs.test_net_if_stats_enodevN)r^ r_ r` r$ r� r� r r: r; r rY r[ r_ r r r r` r' r' r' r- r7 s
E
�r7 c @ s� e Zd Zejje dd�dd� �Zejje dd�dd� �Zejje dd�ejje
dd�dd � ��Z ejje dd�d
d � �Z
d S )
�TestSensorsAPIsr rb c C s� t �� }|�� D ]x\}}t|t�s&J �|D ]\}t|jt�s>J �|jd urV|jdksVJ �|jd urn|jdksnJ �|jd ur*|jdks*J �q*qd S r� ) r2 �sensors_temperaturesrB r� r� �labelr �high�critical)r9 �tempsr� �entries�entryr' r' r- �test_sensors_temperatures� s
z)TestSensorsAPIs.test_sensors_temperaturesc C s� ddgi}t jd|d��X}tjdd�d d }|js8J �|jdksFJ �|jd ksTJ �|jd
ksbJ �W d � n1 sv0 Y d S ) NZcoretemp)rc g I@g N@g �Q@z'psutil._psplatform.sensors_temperaturesr� T)Z
fahrenheitr g �^@g �a@g �c@)r# rL r2 rb rW r rd re )r9 �drY rf r' r' r- �#test_sensors_temperatures_fahreneit� s
�
z3TestSensorsAPIs.test_sensors_temperatures_fahreneitz
no batteryc C sp t �� }|jdksJ �|jdks$J �|jt jt jfvrF|jdks\J �n|jt jkr\|js\J �t|jt�slJ �d S )Nr r� ) r2 Zsensors_batteryr� ZsecsleftZPOWER_TIME_UNKNOWNZPOWER_TIME_UNLIMITEDZ
power_pluggedr� r� )r9 r3 r' r' r- �test_sensors_battery� s �
z$TestSensorsAPIs.test_sensors_batteryc C sh t �� }|�� D ]R\}}t|t�s&J �|D ]6}t|jt�s>J �t|jttf�sRJ �|jdks*J �q*qd S r� ) r2 Z sensors_fansrB r� r� rc r r� r )r9 Zfansr� rg rh r' r' r- �test_sensors_fans� s z!TestSensorsAPIs.test_sensors_fansN)r^ r_ r` r$ r� r� r ri rk r r rl r rm r' r' r' r- ra � s
ra );�__doc__rI r� r# r0 r� r� r r r? r� r{ r2 r r r r r r r r r
r Zpsutil._compatr r
r Z psutil.testsr r r r r r r r r r r r r r r r r r r! r" r# r$ r% r& ra r� r� r� r r7 ra r' r' r' r- �<module> sx HfX, #PK ok\}��} } 2 psutil/tests/__pycache__/test_sunos.cpython-39.pycnu �[��� a
��?h� � @ sj d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ejj e dd�G d d
� d
e��Z
dS ) zSun OS specific tests.� N)�SUNOS)�PsutilTestCase)�pytest)�shz
SUNOS only)�reasonc @ s e Zd Zdd� Zdd� ZdS )�SunOSSpecificTestCasec C s� t dtjd �}|�� �d�dd � }|s4td��d }}|D ],}|�� }t|d �d }t|d �d }q@|| }t�� }|j |ks�J �|j
|ks�J �|j |ks�J �d S )
Nz#env PATH=/usr/sbin:/sbin:%s swap -l�PATH�
� z no swap device(s) configuredr � i � ) r �os�environ�strip�split�
ValueError�int�psutilZ swap_memory�total�used�free) �self�out�linesr r �line�fieldsr Z psutil_swap� r �C/usr/local/lib64/python3.9/site-packages/psutil/tests/test_sunos.py�test_swap_memory s z&SunOSSpecificTestCase.test_swap_memoryc C s& t d�}t�� t|�d��ks"J �d S )Nz/usr/sbin/psrinfor )r r � cpu_count�lenr )r r r r r �test_cpu_count% s z$SunOSSpecificTestCase.test_cpu_countN)�__name__�
__module__� __qualname__r r! r r r r r s r ) �__doc__r
r r Z psutil.testsr r r �markZskipifr r r r r �<module> s PK ok\豍B B 0 psutil/tests/__pycache__/__main__.cpython-39.pycnu �[��� a
��?h5 � @ s" d Z ddlmZ e�g d�� dS )z>Run unit tests. This is invoked by:
$ python -m psutil.tests.
� )�pytest)z-vz-sz
--tb=shortN)�__doc__Z psutil.testsr �main� r r �A/usr/local/lib64/python3.9/site-packages/psutil/tests/__main__.py�<module> s PK ok\ށ�, , 4 psutil/tests/__pycache__/test_unicode.cpython-39.pycnu �[��� a
��?h;1 � @ s d Z ddlZddlZddlZddlZddlmZ ddlZddlmZ ddlm Z ddlm
Z
ddl m Z ddl m
Z
dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! dd lm"Z" dd lm#Z# dd lm$Z$ e�r�d d � Z!d!d"� Z%G d#d$� d$e�Z&e j'j(d%d&�e j'j)ed'd(�e j'j)e�o�e d)d(�G d*d+� d+e&����Z*e j'j)ed,d(�G d-d.� d.e*��Z+G d/d0� d0e&�Z,dS )1a> Notes about unicode handling in psutil
======================================.
Starting from version 5.3.0 psutil adds unicode support, see:
https://github.com/giampaolo/psutil/issues/1040
The notes below apply to *any* API returning a string such as
process exe(), cwd() or username():
* all strings are encoded by using the OS filesystem encoding
(sys.getfilesystemencoding()) which varies depending on the platform
(e.g. "UTF-8" on macOS, "mbcs" on Win)
* no API call is supposed to crash with UnicodeDecodeError
* instead, in case of badly encoded data returned by the OS, the
following error handlers are used to replace the corrupted characters in
the string:
* Python 3: sys.getfilesystemencodeerrors() (PY 3.6+) or
"surrogatescape" on POSIX and "replace" on Windows
* Python 2: "replace"
* on Python 2 all APIs return bytes (str type), never unicode
* on Python 2, you can go back to unicode by doing:
>>> unicode(p.exe(), sys.getdefaultencoding(), errors="replace")
For a detailed explanation of how psutil handles unicode see #1040.
Tests
=====
List of APIs returning or dealing with a string:
('not tested' means they are not tested to deal with non-ASCII strings):
* Process.cmdline()
* Process.cwd()
* Process.environ()
* Process.exe()
* Process.memory_maps()
* Process.name()
* Process.net_connections('unix')
* Process.open_files()
* Process.username() (not tested)
* disk_io_counters() (not tested)
* disk_partitions() (not tested)
* disk_usage(str)
* net_connections('unix')
* net_if_addrs() (not tested)
* net_if_stats() (not tested)
* net_io_counters() (not tested)
* sensors_fans() (not tested)
* sensors_temperatures() (not tested)
* users() (not tested)
* WindowsService.binpath() (not tested)
* WindowsService.description() (not tested)
* WindowsService.display_name() (not tested)
* WindowsService.name() (not tested)
* WindowsService.status() (not tested)
* WindowsService.username() (not tested)
In here we create a unicode path with a funky non-ASCII name and (where
possible) make psutil return it back (e.g. on name(), exe(), open_files(),
etc.) and make sure that:
* psutil never crashes with UnicodeDecodeError
* the returned path matches
� N)�closing)�BSD)�POSIX)�WINDOWS)�PY3)�super)�APPVEYOR)�ASCII_FS)�
CI_TESTING)� HAS_ENVIRON)�HAS_MEMORY_MAPS)�HAS_NET_CONNECTIONS_UNIX)�INVALID_UNICODE_SUFFIX)�PYPY��
TESTFN_PREFIX)�UNICODE_SUFFIX)�PsutilTestCase)�bind_unix_socket)�chdir)�copyload_shared_lib)�
create_py_exe)�
get_testfn)�pytest)�
safe_mkdir�� safe_rmpath)�skip_on_access_denied)�spawn_testproc)� terminatec C s6 ddl m} z
|| �W S ty0 t�� Y n0 d S )Nr r )� psutil.testsr Z WindowsError� traceback� print_exc)�pathZrm� r$ �E/usr/local/lib64/python3.9/site-packages/psutil/tests/test_unicode.pyr q s
r c C s� d}t | d�}z�z<t|� t|� t|gd�}t�||d � t|d � W n2 ttfy~ Y W |durrt|� t|� dS 0 W |dur�t|� t|� dS W |dur�t|� t|� n|dur�t|� t|� 0 dS )z`Return True if both the fs and the subprocess module can
deal with a unicode file name.
N��suffix)�cmdz-2FT) r r r r �shutil�copyfile�UnicodeEncodeError�IOErrorr )r' �sprocZtestfnr$ r$ r% � try_unicode� s2
��
�r. c s0 e Zd ZdZe� fdd��Z� fdd�Z� ZS )�BaseUnicodeTestNc sN t � �� d| _d | _| jd urJt| j�s2d| _nt| jd�| _t| j� d S )NFTr& )r �
setUpClass�
skip_tests�
funky_name� funky_suffixr. r r )�cls�� __class__r$ r% r0 � s
zBaseUnicodeTest.setUpClassc s t � �� | jrt�d��d S )Nzcan't handle unicode str)r �setUpr1 r �skip��selfr5 r$ r% r7 � s
zBaseUnicodeTest.setUp)�__name__�
__module__� __qualname__r3 � classmethodr0 r7 �
__classcell__r$ r$ r5 r% r/ � s r/ �serial)�namezASCII fs��reasonztoo much trouble on PYPY2c @ s� e Zd ZdZeZdd� Zdd� Zdd� Zdd � Z d
d � Z
e j j
eoDed d
�dd� �Ze j j
e dd
�dd� �Ze j j
e dd
�e j j
e dd
�e� dd� ���Zdd� Ze j j
e dd
�e j j
e dd
�e j j
edd
�dd � ���Zd S ) �
TestFSAPIsz1Test FS APIs with a funky, valid, UTF8 path name.c C sZ t | jt�rdnd}t�� �* t�d� | jt�|�v W d � S 1 sL0 Y d S )N�.�ignore)�
isinstancer2 �str�warnings�catch_warnings� simplefilter�os�listdir)r: �herer$ r$ r% �expect_exact_path_match� s
z"TestFSAPIs.expect_exact_path_matchc C sb | j ddg}| �|�}t�|j�}|�� }t|t�s8J �| �� r^t j
� |�t j
� | j �ks^J �d S �Nz-cz2import time; [time.sleep(0.1) for x in range(100)]) r2 r �psutil�Process�pid�exerG rH rO rL r# �normcase)r: r( �subp�prT r$ r$ r% �
test_proc_exe� s �
zTestFSAPIs.test_proc_exec C sV | j ddg}| �|�}t�|j��� }t|t�s4J �| �� rR|t j
� | j �ksRJ �d S rP ) r2 r rQ rR rS rA rG rH rO rL r# �basename)r: r( rV rA r$ r$ r% �test_proc_name� s �
zTestFSAPIs.test_proc_namec C sZ | j ddg}| �|�}t�|j�}|�� }|D ]}t|t�s.J �q.| �� rV||ksVJ �d S rP ) r2 r rQ rR rS �cmdlinerG rH rO )r: r( rV rW r[ �partr$ r$ r% �test_proc_cmdline� s �
z TestFSAPIs.test_proc_cmdlinec C s� | j d }| �t|� t|� t|�� t�� }|�� }W d � n1 sL0 Y t|�� t �shJ �| �
� r|||ks|J �d S �N�2) r2 �
addCleanupr r r rQ rR �cwdrG rH rO )r: �dnamerW ra r$ r$ r% �
test_proc_cwd� s
&zTestFSAPIs.test_proc_cwdzfails on PYPY + WINDOWSrB c C s� t �� }t|�� �}t| jd�� t|�� �}W d � n1 sB0 Y || �� j}t|t �shJ �t
rz|szt � d��| �
� r�tj�|�tj�| j�ks�J �d S )N�rbzopen_files on BSD is broken)rQ rR �setZ
open_files�openr2 �popr# rG rH r r r8 rO rL rU )r: rW �start�newr# r$ r$ r% �test_proc_open_files� s *
z TestFSAPIs.test_proc_open_filesz
POSIX onlyc C s� | j | jd�}z t|�}W n$ ty> tr0� n
t�d��Y n0 t|��@ t� � �
d�d }t |j t
�slJ �|j |kszJ �W d � n1 s�0 Y d S )Nr& �
not supported�unixr )r r3 r r+ r r r8 r rQ rR �net_connectionsrG �laddrrH )r: rA �sock�connr$ r$ r% �test_proc_net_connections s
z$TestFSAPIs.test_proc_net_connectionszcan't list UNIX socketsc C s� dd� }| j | jd�}z t|�}W n$ tyF tr8� n
t�d��Y n0 t|��B tj dd�}||�}t
|j t �svJ �|j |ks�J �W d � n1 s�0 Y d S )Nc S s2 | D ] }t j�|j��t�r| S qtd��d S )Nzconnection not found)rL r# rY rn �
startswithr �
ValueError)�consrp r$ r$ r% � find_sock s
z2TestFSAPIs.test_net_connections.<locals>.find_sockr& rk rl )�kind)
r r3 r r+ r r r8 r rQ rm rG rn rH )r: ru rA ro rt rp r$ r$ r% �test_net_connections s
z TestFSAPIs.test_net_connectionsc C s, | j d }| �t|� t|� t�|� d S r^ )r2 r` r r rQ �
disk_usage)r: rb r$ r$ r% �test_disk_usage/ s
zTestFSAPIs.test_disk_usagerk z&ctypes does not support unicode on PY2zunstable on PYPYc s� t | jd��h}dd� � � fdd�t�� �� D �}dd� |D �}� |�|v sNJ �|D ]}t|t�sRJ �qRW d � n1 sz0 Y d S )Nr& c S s t j�t j�| ��S )N)rL r# �realpathrU )rW r$ r$ r% �normpath? s z-TestFSAPIs.test_memory_maps.<locals>.normpathc s g | ]}� |j ��qS r$ )r# ��.0�x�r{ r$ r% �
<listcomp>B s z/TestFSAPIs.test_memory_maps.<locals>.<listcomp>c S s g | ]}t |v r|�qS r$ r r| r$ r$ r% r� F � )r r3 rQ rR Z memory_mapsrG rH )r: Z
funky_pathZlibpathsr# r$ r r% �test_memory_maps5 s
�zTestFSAPIs.test_memory_mapsN)r; r< r= �__doc__r r3 rO rX rZ r] rc r �mark�skipifr r rj r rq r
r rw ry r r r� r$ r$ r$ r% rD � s0
��rD zunreliable on CIc @ s e Zd ZdZeZdd� ZdS )�TestFSAPIsWithInvalidPathz-Test FS APIs with a funky, invalid path name.c C s dS )NTr$ r9 r$ r$ r% rO R s z1TestFSAPIsWithInvalidPath.expect_exact_path_matchN)r; r< r= r� r r3 rO r$ r$ r$ r% r� L s r� c @ sJ e Zd ZdZerendZejj e
dd�ejj e o4e dd�dd� ��Z
dS ) �
TestNonFSAPISz&Unicode tests for non fs-related APIs.� èrk rB zsegfaults on PYPY + WINDOWSc C sx t j�� }| j|d< | j|d�}t�|j�}|�� }|�� D ]$\}}t |t
�sRJ �t |t
�s<J �q<|d | jkstJ �d S )NZ FUNNY_ARG)�env) rL �environ�copyr3 r rQ rR rS �itemsrG rH )r: r� r- rW �k�vr$ r$ r% �test_proc_environa s
z TestNonFSAPIS.test_proc_environN)r; r< r= r� r r r3 r r� r� r r r r� r$ r$ r$ r% r� \ s
r� )-r� rL r) r! rI �
contextlibr rQ r r r Zpsutil._compatr r r r r r
r r r
r r r r r r r r r r r r r r r r r. r/ r� Z xdist_groupr� rD r� r� r$ r$ r$ r% �<module> sZ C PK ok\7 psutil/tests/test_windows.pynu �[��� #!/usr/bin/env python3
# -*- coding: UTF-8 -*
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Windows specific tests."""
import datetime
import errno
import glob
import os
import platform
import re
import signal
import subprocess
import sys
import time
import warnings
import psutil
from psutil import WINDOWS
from psutil._compat import FileNotFoundError
from psutil._compat import super
from psutil._compat import which
from psutil.tests import APPVEYOR
from psutil.tests import GITHUB_ACTIONS
from psutil.tests import HAS_BATTERY
from psutil.tests import IS_64BIT
from psutil.tests import PY3
from psutil.tests import PYPY
from psutil.tests import TOLERANCE_DISK_USAGE
from psutil.tests import TOLERANCE_SYS_MEM
from psutil.tests import PsutilTestCase
from psutil.tests import mock
from psutil.tests import pytest
from psutil.tests import retry_on_failure
from psutil.tests import sh
from psutil.tests import spawn_testproc
from psutil.tests import terminate
if WINDOWS and not PYPY:
with warnings.catch_warnings():
warnings.simplefilter("ignore")
import win32api # requires "pip install pywin32"
import win32con
import win32process
import wmi # requires "pip install wmi" / "make install-pydeps-test"
if WINDOWS:
from psutil._pswindows import convert_oserror
cext = psutil._psplatform.cext
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
@pytest.mark.skipif(PYPY, reason="pywin32 not available on PYPY")
# https://github.com/giampaolo/psutil/pull/1762#issuecomment-632892692
@pytest.mark.skipif(
GITHUB_ACTIONS and not PY3, reason="pywin32 broken on GITHUB + PY2"
)
class WindowsTestCase(PsutilTestCase):
pass
def powershell(cmd):
"""Currently not used, but available just in case. Usage:
>>> powershell(
"Get-CIMInstance Win32_PageFileUsage | Select AllocatedBaseSize")
"""
if not which("powershell.exe"):
raise pytest.skip("powershell.exe not available")
cmdline = (
'powershell.exe -ExecutionPolicy Bypass -NoLogo -NonInteractive '
+ '-NoProfile -WindowStyle Hidden -Command "%s"' % cmd
)
return sh(cmdline)
def wmic(path, what, converter=int):
"""Currently not used, but available just in case. Usage:
>>> wmic("Win32_OperatingSystem", "FreePhysicalMemory")
2134124534
"""
out = sh("wmic path %s get %s" % (path, what)).strip()
data = "".join(out.splitlines()[1:]).strip() # get rid of the header
if converter is not None:
if "," in what:
return tuple([converter(x) for x in data.split()])
else:
return converter(data)
else:
return data
# ===================================================================
# System APIs
# ===================================================================
class TestCpuAPIs(WindowsTestCase):
@pytest.mark.skipif(
'NUMBER_OF_PROCESSORS' not in os.environ,
reason="NUMBER_OF_PROCESSORS env var is not available",
)
def test_cpu_count_vs_NUMBER_OF_PROCESSORS(self):
# Will likely fail on many-cores systems:
# https://stackoverflow.com/questions/31209256
num_cpus = int(os.environ['NUMBER_OF_PROCESSORS'])
assert num_cpus == psutil.cpu_count()
def test_cpu_count_vs_GetSystemInfo(self):
# Will likely fail on many-cores systems:
# https://stackoverflow.com/questions/31209256
sys_value = win32api.GetSystemInfo()[5]
psutil_value = psutil.cpu_count()
assert sys_value == psutil_value
def test_cpu_count_logical_vs_wmi(self):
w = wmi.WMI()
procs = sum(
proc.NumberOfLogicalProcessors for proc in w.Win32_Processor()
)
assert psutil.cpu_count() == procs
def test_cpu_count_cores_vs_wmi(self):
w = wmi.WMI()
cores = sum(proc.NumberOfCores for proc in w.Win32_Processor())
assert psutil.cpu_count(logical=False) == cores
def test_cpu_count_vs_cpu_times(self):
assert psutil.cpu_count() == len(psutil.cpu_times(percpu=True))
def test_cpu_freq(self):
w = wmi.WMI()
proc = w.Win32_Processor()[0]
assert proc.CurrentClockSpeed == psutil.cpu_freq().current
assert proc.MaxClockSpeed == psutil.cpu_freq().max
class TestSystemAPIs(WindowsTestCase):
def test_nic_names(self):
out = sh('ipconfig /all')
nics = psutil.net_io_counters(pernic=True).keys()
for nic in nics:
if "pseudo-interface" in nic.replace(' ', '-').lower():
continue
if nic not in out:
raise self.fail(
"%r nic wasn't found in 'ipconfig /all' output" % nic
)
def test_total_phymem(self):
w = wmi.WMI().Win32_ComputerSystem()[0]
assert int(w.TotalPhysicalMemory) == psutil.virtual_memory().total
def test_free_phymem(self):
w = wmi.WMI().Win32_PerfRawData_PerfOS_Memory()[0]
assert (
abs(int(w.AvailableBytes) - psutil.virtual_memory().free)
< TOLERANCE_SYS_MEM
)
def test_total_swapmem(self):
w = wmi.WMI().Win32_PerfRawData_PerfOS_Memory()[0]
assert (
int(w.CommitLimit) - psutil.virtual_memory().total
== psutil.swap_memory().total
)
if psutil.swap_memory().total == 0:
assert psutil.swap_memory().free == 0
assert psutil.swap_memory().used == 0
def test_percent_swapmem(self):
if psutil.swap_memory().total > 0:
w = wmi.WMI().Win32_PerfRawData_PerfOS_PagingFile(Name="_Total")[0]
# calculate swap usage to percent
percentSwap = int(w.PercentUsage) * 100 / int(w.PercentUsage_Base)
# exact percent may change but should be reasonable
# assert within +/- 5% and between 0 and 100%
assert psutil.swap_memory().percent >= 0
assert abs(psutil.swap_memory().percent - percentSwap) < 5
assert psutil.swap_memory().percent <= 100
# @pytest.mark.skipif(wmi is None, reason="wmi module is not installed")
# def test__UPTIME(self):
# # _UPTIME constant is not public but it is used internally
# # as value to return for pid 0 creation time.
# # WMI behaves the same.
# w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
# p = psutil.Process(0)
# wmic_create = str(w.CreationDate.split('.')[0])
# psutil_create = time.strftime("%Y%m%d%H%M%S",
# time.localtime(p.create_time()))
# Note: this test is not very reliable
@pytest.mark.skipif(APPVEYOR, reason="test not relieable on appveyor")
@retry_on_failure()
def test_pids(self):
# Note: this test might fail if the OS is starting/killing
# other processes in the meantime
w = wmi.WMI().Win32_Process()
wmi_pids = set([x.ProcessId for x in w])
psutil_pids = set(psutil.pids())
assert wmi_pids == psutil_pids
@retry_on_failure()
def test_disks(self):
ps_parts = psutil.disk_partitions(all=True)
wmi_parts = wmi.WMI().Win32_LogicalDisk()
for ps_part in ps_parts:
for wmi_part in wmi_parts:
if ps_part.device.replace('\\', '') == wmi_part.DeviceID:
if not ps_part.mountpoint:
# this is usually a CD-ROM with no disk inserted
break
if 'cdrom' in ps_part.opts:
break
if ps_part.mountpoint.startswith('A:'):
break # floppy
try:
usage = psutil.disk_usage(ps_part.mountpoint)
except FileNotFoundError:
# usually this is the floppy
break
assert usage.total == int(wmi_part.Size)
wmi_free = int(wmi_part.FreeSpace)
assert usage.free == wmi_free
# 10 MB tolerance
if abs(usage.free - wmi_free) > 10 * 1024 * 1024:
raise self.fail(
"psutil=%s, wmi=%s" % (usage.free, wmi_free)
)
break
else:
raise self.fail("can't find partition %s" % repr(ps_part))
@retry_on_failure()
def test_disk_usage(self):
for disk in psutil.disk_partitions():
if 'cdrom' in disk.opts:
continue
sys_value = win32api.GetDiskFreeSpaceEx(disk.mountpoint)
psutil_value = psutil.disk_usage(disk.mountpoint)
assert abs(sys_value[0] - psutil_value.free) < TOLERANCE_DISK_USAGE
assert (
abs(sys_value[1] - psutil_value.total) < TOLERANCE_DISK_USAGE
)
assert psutil_value.used == psutil_value.total - psutil_value.free
def test_disk_partitions(self):
sys_value = [
x + '\\'
for x in win32api.GetLogicalDriveStrings().split("\\\x00")
if x and not x.startswith('A:')
]
psutil_value = [
x.mountpoint
for x in psutil.disk_partitions(all=True)
if not x.mountpoint.startswith('A:')
]
assert sys_value == psutil_value
def test_net_if_stats(self):
ps_names = set(cext.net_if_stats())
wmi_adapters = wmi.WMI().Win32_NetworkAdapter()
wmi_names = set()
for wmi_adapter in wmi_adapters:
wmi_names.add(wmi_adapter.Name)
wmi_names.add(wmi_adapter.NetConnectionID)
assert ps_names & wmi_names, "no common entries in %s, %s" % (
ps_names,
wmi_names,
)
def test_boot_time(self):
wmi_os = wmi.WMI().Win32_OperatingSystem()
wmi_btime_str = wmi_os[0].LastBootUpTime.split('.')[0]
wmi_btime_dt = datetime.datetime.strptime(
wmi_btime_str, "%Y%m%d%H%M%S"
)
psutil_dt = datetime.datetime.fromtimestamp(psutil.boot_time())
diff = abs((wmi_btime_dt - psutil_dt).total_seconds())
assert diff <= 5
def test_boot_time_fluctuation(self):
# https://github.com/giampaolo/psutil/issues/1007
with mock.patch('psutil._pswindows.cext.boot_time', return_value=5):
assert psutil.boot_time() == 5
with mock.patch('psutil._pswindows.cext.boot_time', return_value=4):
assert psutil.boot_time() == 5
with mock.patch('psutil._pswindows.cext.boot_time', return_value=6):
assert psutil.boot_time() == 5
with mock.patch('psutil._pswindows.cext.boot_time', return_value=333):
assert psutil.boot_time() == 333
# ===================================================================
# sensors_battery()
# ===================================================================
class TestSensorsBattery(WindowsTestCase):
def test_has_battery(self):
if win32api.GetPwrCapabilities()['SystemBatteriesPresent']:
assert psutil.sensors_battery() is not None
else:
assert psutil.sensors_battery() is None
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_percent(self):
w = wmi.WMI()
battery_wmi = w.query('select * from Win32_Battery')[0]
battery_psutil = psutil.sensors_battery()
assert (
abs(battery_psutil.percent - battery_wmi.EstimatedChargeRemaining)
< 1
)
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
def test_power_plugged(self):
w = wmi.WMI()
battery_wmi = w.query('select * from Win32_Battery')[0]
battery_psutil = psutil.sensors_battery()
# Status codes:
# https://msdn.microsoft.com/en-us/library/aa394074(v=vs.85).aspx
assert battery_psutil.power_plugged == (battery_wmi.BatteryStatus == 2)
def test_emulate_no_battery(self):
with mock.patch(
"psutil._pswindows.cext.sensors_battery",
return_value=(0, 128, 0, 0),
) as m:
assert psutil.sensors_battery() is None
assert m.called
def test_emulate_power_connected(self):
with mock.patch(
"psutil._pswindows.cext.sensors_battery", return_value=(1, 0, 0, 0)
) as m:
assert (
psutil.sensors_battery().secsleft
== psutil.POWER_TIME_UNLIMITED
)
assert m.called
def test_emulate_power_charging(self):
with mock.patch(
"psutil._pswindows.cext.sensors_battery", return_value=(0, 8, 0, 0)
) as m:
assert (
psutil.sensors_battery().secsleft
== psutil.POWER_TIME_UNLIMITED
)
assert m.called
def test_emulate_secs_left_unknown(self):
with mock.patch(
"psutil._pswindows.cext.sensors_battery",
return_value=(0, 0, 0, -1),
) as m:
assert (
psutil.sensors_battery().secsleft == psutil.POWER_TIME_UNKNOWN
)
assert m.called
# ===================================================================
# Process APIs
# ===================================================================
class TestProcess(WindowsTestCase):
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
def test_issue_24(self):
p = psutil.Process(0)
with pytest.raises(psutil.AccessDenied):
p.kill()
def test_special_pid(self):
p = psutil.Process(4)
assert p.name() == 'System'
# use __str__ to access all common Process properties to check
# that nothing strange happens
str(p)
p.username()
assert p.create_time() >= 0.0
try:
rss, _vms = p.memory_info()[:2]
except psutil.AccessDenied:
# expected on Windows Vista and Windows 7
if platform.uname()[1] not in ('vista', 'win-7', 'win7'):
raise
else:
assert rss > 0
def test_send_signal(self):
p = psutil.Process(self.pid)
with pytest.raises(ValueError):
p.send_signal(signal.SIGINT)
def test_num_handles_increment(self):
p = psutil.Process(os.getpid())
before = p.num_handles()
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, os.getpid()
)
after = p.num_handles()
assert after == before + 1
win32api.CloseHandle(handle)
assert p.num_handles() == before
def test_ctrl_signals(self):
p = psutil.Process(self.spawn_testproc().pid)
p.send_signal(signal.CTRL_C_EVENT)
p.send_signal(signal.CTRL_BREAK_EVENT)
p.kill()
p.wait()
with pytest.raises(psutil.NoSuchProcess):
p.send_signal(signal.CTRL_C_EVENT)
with pytest.raises(psutil.NoSuchProcess):
p.send_signal(signal.CTRL_BREAK_EVENT)
def test_username(self):
name = win32api.GetUserNameEx(win32con.NameSamCompatible)
if name.endswith('$'):
# When running as a service account (most likely to be
# NetworkService), these user name calculations don't produce the
# same result, causing the test to fail.
raise pytest.skip('running as service account')
assert psutil.Process().username() == name
def test_cmdline(self):
sys_value = re.sub('[ ]+', ' ', win32api.GetCommandLine()).strip()
psutil_value = ' '.join(psutil.Process().cmdline())
if sys_value[0] == '"' != psutil_value[0]:
# The PyWin32 command line may retain quotes around argv[0] if they
# were used unnecessarily, while psutil will omit them. So remove
# the first 2 quotes from sys_value if not in psutil_value.
# A path to an executable will not contain quotes, so this is safe.
sys_value = sys_value.replace('"', '', 2)
assert sys_value == psutil_value
# XXX - occasional failures
# def test_cpu_times(self):
# handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
# win32con.FALSE, os.getpid())
# self.addCleanup(win32api.CloseHandle, handle)
# sys_value = win32process.GetProcessTimes(handle)
# psutil_value = psutil.Process().cpu_times()
# self.assertAlmostEqual(
# psutil_value.user, sys_value['UserTime'] / 10000000.0,
# delta=0.2)
# self.assertAlmostEqual(
# psutil_value.user, sys_value['KernelTime'] / 10000000.0,
# delta=0.2)
def test_nice(self):
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, os.getpid()
)
self.addCleanup(win32api.CloseHandle, handle)
sys_value = win32process.GetPriorityClass(handle)
psutil_value = psutil.Process().nice()
assert psutil_value == sys_value
def test_memory_info(self):
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, self.pid
)
self.addCleanup(win32api.CloseHandle, handle)
sys_value = win32process.GetProcessMemoryInfo(handle)
psutil_value = psutil.Process(self.pid).memory_info()
assert sys_value['PeakWorkingSetSize'] == psutil_value.peak_wset
assert sys_value['WorkingSetSize'] == psutil_value.wset
assert (
sys_value['QuotaPeakPagedPoolUsage']
== psutil_value.peak_paged_pool
)
assert sys_value['QuotaPagedPoolUsage'] == psutil_value.paged_pool
assert (
sys_value['QuotaPeakNonPagedPoolUsage']
== psutil_value.peak_nonpaged_pool
)
assert (
sys_value['QuotaNonPagedPoolUsage'] == psutil_value.nonpaged_pool
)
assert sys_value['PagefileUsage'] == psutil_value.pagefile
assert sys_value['PeakPagefileUsage'] == psutil_value.peak_pagefile
assert psutil_value.rss == psutil_value.wset
assert psutil_value.vms == psutil_value.pagefile
def test_wait(self):
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, self.pid
)
self.addCleanup(win32api.CloseHandle, handle)
p = psutil.Process(self.pid)
p.terminate()
psutil_value = p.wait()
sys_value = win32process.GetExitCodeProcess(handle)
assert psutil_value == sys_value
def test_cpu_affinity(self):
def from_bitmask(x):
return [i for i in range(64) if (1 << i) & x]
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, self.pid
)
self.addCleanup(win32api.CloseHandle, handle)
sys_value = from_bitmask(
win32process.GetProcessAffinityMask(handle)[0]
)
psutil_value = psutil.Process(self.pid).cpu_affinity()
assert psutil_value == sys_value
def test_io_counters(self):
handle = win32api.OpenProcess(
win32con.PROCESS_QUERY_INFORMATION, win32con.FALSE, os.getpid()
)
self.addCleanup(win32api.CloseHandle, handle)
sys_value = win32process.GetProcessIoCounters(handle)
psutil_value = psutil.Process().io_counters()
assert psutil_value.read_count == sys_value['ReadOperationCount']
assert psutil_value.write_count == sys_value['WriteOperationCount']
assert psutil_value.read_bytes == sys_value['ReadTransferCount']
assert psutil_value.write_bytes == sys_value['WriteTransferCount']
assert psutil_value.other_count == sys_value['OtherOperationCount']
assert psutil_value.other_bytes == sys_value['OtherTransferCount']
def test_num_handles(self):
import ctypes
import ctypes.wintypes
PROCESS_QUERY_INFORMATION = 0x400
handle = ctypes.windll.kernel32.OpenProcess(
PROCESS_QUERY_INFORMATION, 0, self.pid
)
self.addCleanup(ctypes.windll.kernel32.CloseHandle, handle)
hndcnt = ctypes.wintypes.DWORD()
ctypes.windll.kernel32.GetProcessHandleCount(
handle, ctypes.byref(hndcnt)
)
sys_value = hndcnt.value
psutil_value = psutil.Process(self.pid).num_handles()
assert psutil_value == sys_value
def test_error_partial_copy(self):
# https://github.com/giampaolo/psutil/issues/875
exc = WindowsError()
exc.winerror = 299
with mock.patch("psutil._psplatform.cext.proc_cwd", side_effect=exc):
with mock.patch("time.sleep") as m:
p = psutil.Process()
with pytest.raises(psutil.AccessDenied):
p.cwd()
assert m.call_count >= 5
def test_exe(self):
# NtQuerySystemInformation succeeds if process is gone. Make sure
# it raises NSP for a non existent pid.
pid = psutil.pids()[-1] + 99999
proc = psutil._psplatform.Process(pid)
with pytest.raises(psutil.NoSuchProcess):
proc.exe()
class TestProcessWMI(WindowsTestCase):
"""Compare Process API results with WMI."""
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
def test_name(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
assert p.name() == w.Caption
# This fail on github because using virtualenv for test environment
@pytest.mark.skipif(
GITHUB_ACTIONS, reason="unreliable path on GITHUB_ACTIONS"
)
def test_exe(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
# Note: wmi reports the exe as a lower case string.
# Being Windows paths case-insensitive we ignore that.
assert p.exe().lower() == w.ExecutablePath.lower()
def test_cmdline(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
assert ' '.join(p.cmdline()) == w.CommandLine.replace('"', '')
def test_username(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
domain, _, username = w.GetOwner()
username = "%s\\%s" % (domain, username)
assert p.username() == username
@retry_on_failure()
def test_memory_rss(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
rss = p.memory_info().rss
assert rss == int(w.WorkingSetSize)
@retry_on_failure()
def test_memory_vms(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
vms = p.memory_info().vms
# http://msdn.microsoft.com/en-us/library/aa394372(VS.85).aspx
# ...claims that PageFileUsage is represented in Kilo
# bytes but funnily enough on certain platforms bytes are
# returned instead.
wmi_usage = int(w.PageFileUsage)
if vms not in (wmi_usage, wmi_usage * 1024):
raise self.fail("wmi=%s, psutil=%s" % (wmi_usage, vms))
def test_create_time(self):
w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
p = psutil.Process(self.pid)
wmic_create = str(w.CreationDate.split('.')[0])
psutil_create = time.strftime(
"%Y%m%d%H%M%S", time.localtime(p.create_time())
)
assert wmic_create == psutil_create
# ---
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
class TestDualProcessImplementation(PsutilTestCase):
"""Certain APIs on Windows have 2 internal implementations, one
based on documented Windows APIs, another one based
NtQuerySystemInformation() which gets called as fallback in
case the first fails because of limited permission error.
Here we test that the two methods return the exact same value,
see:
https://github.com/giampaolo/psutil/issues/304.
"""
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc().pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
def test_memory_info(self):
mem_1 = psutil.Process(self.pid).memory_info()
with mock.patch(
"psutil._psplatform.cext.proc_memory_info",
side_effect=OSError(errno.EPERM, "msg"),
) as fun:
mem_2 = psutil.Process(self.pid).memory_info()
assert len(mem_1) == len(mem_2)
for i in range(len(mem_1)):
assert mem_1[i] >= 0
assert mem_2[i] >= 0
assert abs(mem_1[i] - mem_2[i]) < 512
assert fun.called
def test_create_time(self):
ctime = psutil.Process(self.pid).create_time()
with mock.patch(
"psutil._psplatform.cext.proc_times",
side_effect=OSError(errno.EPERM, "msg"),
) as fun:
assert psutil.Process(self.pid).create_time() == ctime
assert fun.called
def test_cpu_times(self):
cpu_times_1 = psutil.Process(self.pid).cpu_times()
with mock.patch(
"psutil._psplatform.cext.proc_times",
side_effect=OSError(errno.EPERM, "msg"),
) as fun:
cpu_times_2 = psutil.Process(self.pid).cpu_times()
assert fun.called
assert abs(cpu_times_1.user - cpu_times_2.user) < 0.01
assert abs(cpu_times_1.system - cpu_times_2.system) < 0.01
def test_io_counters(self):
io_counters_1 = psutil.Process(self.pid).io_counters()
with mock.patch(
"psutil._psplatform.cext.proc_io_counters",
side_effect=OSError(errno.EPERM, "msg"),
) as fun:
io_counters_2 = psutil.Process(self.pid).io_counters()
for i in range(len(io_counters_1)):
assert abs(io_counters_1[i] - io_counters_2[i]) < 5
assert fun.called
def test_num_handles(self):
num_handles = psutil.Process(self.pid).num_handles()
with mock.patch(
"psutil._psplatform.cext.proc_num_handles",
side_effect=OSError(errno.EPERM, "msg"),
) as fun:
assert psutil.Process(self.pid).num_handles() == num_handles
assert fun.called
def test_cmdline(self):
for pid in psutil.pids():
try:
a = cext.proc_cmdline(pid, use_peb=True)
b = cext.proc_cmdline(pid, use_peb=False)
except OSError as err:
err = convert_oserror(err)
if not isinstance(
err, (psutil.AccessDenied, psutil.NoSuchProcess)
):
raise
else:
assert a == b
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
class RemoteProcessTestCase(PsutilTestCase):
"""Certain functions require calling ReadProcessMemory.
This trivially works when called on the current process.
Check that this works on other processes, especially when they
have a different bitness.
"""
@staticmethod
def find_other_interpreter():
# find a python interpreter that is of the opposite bitness from us
code = "import sys; sys.stdout.write(str(sys.maxsize > 2**32))"
# XXX: a different and probably more stable approach might be to access
# the registry but accessing 64 bit paths from a 32 bit process
for filename in glob.glob(r"C:\Python*\python.exe"):
proc = subprocess.Popen(
args=[filename, "-c", code],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
)
output, _ = proc.communicate()
proc.wait()
if output == str(not IS_64BIT):
return filename
test_args = ["-c", "import sys; sys.stdin.read()"]
def setUp(self):
super().setUp()
other_python = self.find_other_interpreter()
if other_python is None:
raise pytest.skip(
"could not find interpreter with opposite bitness"
)
if IS_64BIT:
self.python64 = sys.executable
self.python32 = other_python
else:
self.python64 = other_python
self.python32 = sys.executable
env = os.environ.copy()
env["THINK_OF_A_NUMBER"] = str(os.getpid())
self.proc32 = self.spawn_testproc(
[self.python32] + self.test_args, env=env, stdin=subprocess.PIPE
)
self.proc64 = self.spawn_testproc(
[self.python64] + self.test_args, env=env, stdin=subprocess.PIPE
)
def tearDown(self):
super().tearDown()
self.proc32.communicate()
self.proc64.communicate()
def test_cmdline_32(self):
p = psutil.Process(self.proc32.pid)
assert len(p.cmdline()) == 3
assert p.cmdline()[1:] == self.test_args
def test_cmdline_64(self):
p = psutil.Process(self.proc64.pid)
assert len(p.cmdline()) == 3
assert p.cmdline()[1:] == self.test_args
def test_cwd_32(self):
p = psutil.Process(self.proc32.pid)
assert p.cwd() == os.getcwd()
def test_cwd_64(self):
p = psutil.Process(self.proc64.pid)
assert p.cwd() == os.getcwd()
def test_environ_32(self):
p = psutil.Process(self.proc32.pid)
e = p.environ()
assert "THINK_OF_A_NUMBER" in e
assert e["THINK_OF_A_NUMBER"] == str(os.getpid())
def test_environ_64(self):
p = psutil.Process(self.proc64.pid)
try:
p.environ()
except psutil.AccessDenied:
pass
# ===================================================================
# Windows services
# ===================================================================
@pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
class TestServices(PsutilTestCase):
def test_win_service_iter(self):
valid_statuses = set([
"running",
"paused",
"start",
"pause",
"continue",
"stop",
"stopped",
])
valid_start_types = set(["automatic", "manual", "disabled"])
valid_statuses = set([
"running",
"paused",
"start_pending",
"pause_pending",
"continue_pending",
"stop_pending",
"stopped",
])
for serv in psutil.win_service_iter():
data = serv.as_dict()
assert isinstance(data['name'], str)
assert data['name'].strip()
assert isinstance(data['display_name'], str)
assert isinstance(data['username'], str)
assert data['status'] in valid_statuses
if data['pid'] is not None:
psutil.Process(data['pid'])
assert isinstance(data['binpath'], str)
assert isinstance(data['username'], str)
assert isinstance(data['start_type'], str)
assert data['start_type'] in valid_start_types
assert data['status'] in valid_statuses
assert isinstance(data['description'], str)
pid = serv.pid()
if pid is not None:
p = psutil.Process(pid)
assert p.is_running()
# win_service_get
s = psutil.win_service_get(serv.name())
# test __eq__
assert serv == s
def test_win_service_get(self):
ERROR_SERVICE_DOES_NOT_EXIST = (
psutil._psplatform.cext.ERROR_SERVICE_DOES_NOT_EXIST
)
ERROR_ACCESS_DENIED = psutil._psplatform.cext.ERROR_ACCESS_DENIED
name = next(psutil.win_service_iter()).name()
with pytest.raises(psutil.NoSuchProcess) as cm:
psutil.win_service_get(name + '???')
assert cm.value.name == name + '???'
# test NoSuchProcess
service = psutil.win_service_get(name)
if PY3:
args = (0, "msg", 0, ERROR_SERVICE_DOES_NOT_EXIST)
else:
args = (ERROR_SERVICE_DOES_NOT_EXIST, "msg")
exc = WindowsError(*args)
with mock.patch(
"psutil._psplatform.cext.winservice_query_status", side_effect=exc
):
with pytest.raises(psutil.NoSuchProcess):
service.status()
with mock.patch(
"psutil._psplatform.cext.winservice_query_config", side_effect=exc
):
with pytest.raises(psutil.NoSuchProcess):
service.username()
# test AccessDenied
if PY3:
args = (0, "msg", 0, ERROR_ACCESS_DENIED)
else:
args = (ERROR_ACCESS_DENIED, "msg")
exc = WindowsError(*args)
with mock.patch(
"psutil._psplatform.cext.winservice_query_status", side_effect=exc
):
with pytest.raises(psutil.AccessDenied):
service.status()
with mock.patch(
"psutil._psplatform.cext.winservice_query_config", side_effect=exc
):
with pytest.raises(psutil.AccessDenied):
service.username()
# test __str__ and __repr__
assert service.name() in str(service)
assert service.display_name() in str(service)
assert service.name() in repr(service)
assert service.display_name() in repr(service)
PK ok\�P�
�H �H psutil/tests/test_testutils.pynu �[��� #!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Tests for testing utils (psutil.tests namespace)."""
import collections
import contextlib
import errno
import os
import socket
import stat
import subprocess
import textwrap
import unittest
import warnings
import psutil
import psutil.tests
from psutil import FREEBSD
from psutil import NETBSD
from psutil import POSIX
from psutil._common import open_binary
from psutil._common import open_text
from psutil._common import supports_ipv6
from psutil._compat import PY3
from psutil.tests import CI_TESTING
from psutil.tests import COVERAGE
from psutil.tests import HAS_NET_CONNECTIONS_UNIX
from psutil.tests import HERE
from psutil.tests import PYTHON_EXE
from psutil.tests import PYTHON_EXE_ENV
from psutil.tests import PsutilTestCase
from psutil.tests import TestMemoryLeak
from psutil.tests import bind_socket
from psutil.tests import bind_unix_socket
from psutil.tests import call_until
from psutil.tests import chdir
from psutil.tests import create_sockets
from psutil.tests import fake_pytest
from psutil.tests import filter_proc_net_connections
from psutil.tests import get_free_port
from psutil.tests import is_namedtuple
from psutil.tests import mock
from psutil.tests import process_namespace
from psutil.tests import pytest
from psutil.tests import reap_children
from psutil.tests import retry
from psutil.tests import retry_on_failure
from psutil.tests import safe_mkdir
from psutil.tests import safe_rmpath
from psutil.tests import system_namespace
from psutil.tests import tcp_socketpair
from psutil.tests import terminate
from psutil.tests import unix_socketpair
from psutil.tests import wait_for_file
from psutil.tests import wait_for_pid
# ===================================================================
# --- Unit tests for test utilities.
# ===================================================================
class TestRetryDecorator(PsutilTestCase):
@mock.patch('time.sleep')
def test_retry_success(self, sleep):
# Fail 3 times out of 5; make sure the decorated fun returns.
@retry(retries=5, interval=1, logfun=None)
def foo():
while queue:
queue.pop()
1 / 0 # noqa
return 1
queue = list(range(3))
assert foo() == 1
assert sleep.call_count == 3
@mock.patch('time.sleep')
def test_retry_failure(self, sleep):
# Fail 6 times out of 5; th function is supposed to raise exc.
@retry(retries=5, interval=1, logfun=None)
def foo():
while queue:
queue.pop()
1 / 0 # noqa
return 1
queue = list(range(6))
with pytest.raises(ZeroDivisionError):
foo()
assert sleep.call_count == 5
@mock.patch('time.sleep')
def test_exception_arg(self, sleep):
@retry(exception=ValueError, interval=1)
def foo():
raise TypeError
with pytest.raises(TypeError):
foo()
assert sleep.call_count == 0
@mock.patch('time.sleep')
def test_no_interval_arg(self, sleep):
# if interval is not specified sleep is not supposed to be called
@retry(retries=5, interval=None, logfun=None)
def foo():
1 / 0 # noqa
with pytest.raises(ZeroDivisionError):
foo()
assert sleep.call_count == 0
@mock.patch('time.sleep')
def test_retries_arg(self, sleep):
@retry(retries=5, interval=1, logfun=None)
def foo():
1 / 0 # noqa
with pytest.raises(ZeroDivisionError):
foo()
assert sleep.call_count == 5
@mock.patch('time.sleep')
def test_retries_and_timeout_args(self, sleep):
with pytest.raises(ValueError):
retry(retries=5, timeout=1)
class TestSyncTestUtils(PsutilTestCase):
def test_wait_for_pid(self):
wait_for_pid(os.getpid())
nopid = max(psutil.pids()) + 99999
with mock.patch('psutil.tests.retry.__iter__', return_value=iter([0])):
with pytest.raises(psutil.NoSuchProcess):
wait_for_pid(nopid)
def test_wait_for_file(self):
testfn = self.get_testfn()
with open(testfn, 'w') as f:
f.write('foo')
wait_for_file(testfn)
assert not os.path.exists(testfn)
def test_wait_for_file_empty(self):
testfn = self.get_testfn()
with open(testfn, 'w'):
pass
wait_for_file(testfn, empty=True)
assert not os.path.exists(testfn)
def test_wait_for_file_no_file(self):
testfn = self.get_testfn()
with mock.patch('psutil.tests.retry.__iter__', return_value=iter([0])):
with pytest.raises(IOError):
wait_for_file(testfn)
def test_wait_for_file_no_delete(self):
testfn = self.get_testfn()
with open(testfn, 'w') as f:
f.write('foo')
wait_for_file(testfn, delete=False)
assert os.path.exists(testfn)
def test_call_until(self):
call_until(lambda: 1)
# TODO: test for timeout
class TestFSTestUtils(PsutilTestCase):
def test_open_text(self):
with open_text(__file__) as f:
assert f.mode == 'r'
def test_open_binary(self):
with open_binary(__file__) as f:
assert f.mode == 'rb'
def test_safe_mkdir(self):
testfn = self.get_testfn()
safe_mkdir(testfn)
assert os.path.isdir(testfn)
safe_mkdir(testfn)
assert os.path.isdir(testfn)
def test_safe_rmpath(self):
# test file is removed
testfn = self.get_testfn()
open(testfn, 'w').close()
safe_rmpath(testfn)
assert not os.path.exists(testfn)
# test no exception if path does not exist
safe_rmpath(testfn)
# test dir is removed
os.mkdir(testfn)
safe_rmpath(testfn)
assert not os.path.exists(testfn)
# test other exceptions are raised
with mock.patch(
'psutil.tests.os.stat', side_effect=OSError(errno.EINVAL, "")
) as m:
with pytest.raises(OSError):
safe_rmpath(testfn)
assert m.called
def test_chdir(self):
testfn = self.get_testfn()
base = os.getcwd()
os.mkdir(testfn)
with chdir(testfn):
assert os.getcwd() == os.path.join(base, testfn)
assert os.getcwd() == base
class TestProcessUtils(PsutilTestCase):
def test_reap_children(self):
subp = self.spawn_testproc()
p = psutil.Process(subp.pid)
assert p.is_running()
reap_children()
assert not p.is_running()
assert not psutil.tests._pids_started
assert not psutil.tests._subprocesses_started
def test_spawn_children_pair(self):
child, grandchild = self.spawn_children_pair()
assert child.pid != grandchild.pid
assert child.is_running()
assert grandchild.is_running()
children = psutil.Process().children()
assert children == [child]
children = psutil.Process().children(recursive=True)
assert len(children) == 2
assert child in children
assert grandchild in children
assert child.ppid() == os.getpid()
assert grandchild.ppid() == child.pid
terminate(child)
assert not child.is_running()
assert grandchild.is_running()
terminate(grandchild)
assert not grandchild.is_running()
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_spawn_zombie(self):
_parent, zombie = self.spawn_zombie()
assert zombie.status() == psutil.STATUS_ZOMBIE
def test_terminate(self):
# by subprocess.Popen
p = self.spawn_testproc()
terminate(p)
self.assertPidGone(p.pid)
terminate(p)
# by psutil.Process
p = psutil.Process(self.spawn_testproc().pid)
terminate(p)
self.assertPidGone(p.pid)
terminate(p)
# by psutil.Popen
cmd = [
PYTHON_EXE,
"-c",
"import time; [time.sleep(0.1) for x in range(100)];",
]
p = psutil.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
env=PYTHON_EXE_ENV,
)
terminate(p)
self.assertPidGone(p.pid)
terminate(p)
# by PID
pid = self.spawn_testproc().pid
terminate(pid)
self.assertPidGone(p.pid)
terminate(pid)
# zombie
if POSIX:
parent, zombie = self.spawn_zombie()
terminate(parent)
terminate(zombie)
self.assertPidGone(parent.pid)
self.assertPidGone(zombie.pid)
class TestNetUtils(PsutilTestCase):
def bind_socket(self):
port = get_free_port()
with contextlib.closing(bind_socket(addr=('', port))) as s:
assert s.getsockname()[1] == port
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_bind_unix_socket(self):
name = self.get_testfn()
sock = bind_unix_socket(name)
with contextlib.closing(sock):
assert sock.family == socket.AF_UNIX
assert sock.type == socket.SOCK_STREAM
assert sock.getsockname() == name
assert os.path.exists(name)
assert stat.S_ISSOCK(os.stat(name).st_mode)
# UDP
name = self.get_testfn()
sock = bind_unix_socket(name, type=socket.SOCK_DGRAM)
with contextlib.closing(sock):
assert sock.type == socket.SOCK_DGRAM
def tcp_tcp_socketpair(self):
addr = ("127.0.0.1", get_free_port())
server, client = tcp_socketpair(socket.AF_INET, addr=addr)
with contextlib.closing(server):
with contextlib.closing(client):
# Ensure they are connected and the positions are
# correct.
assert server.getsockname() == addr
assert client.getpeername() == addr
assert client.getsockname() != addr
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@pytest.mark.skipif(
NETBSD or FREEBSD, reason="/var/run/log UNIX socket opened by default"
)
def test_unix_socketpair(self):
p = psutil.Process()
num_fds = p.num_fds()
assert (
filter_proc_net_connections(p.net_connections(kind='unix')) == []
)
name = self.get_testfn()
server, client = unix_socketpair(name)
try:
assert os.path.exists(name)
assert stat.S_ISSOCK(os.stat(name).st_mode)
assert p.num_fds() - num_fds == 2
assert (
len(
filter_proc_net_connections(p.net_connections(kind='unix'))
)
== 2
)
assert server.getsockname() == name
assert client.getpeername() == name
finally:
client.close()
server.close()
def test_create_sockets(self):
with create_sockets() as socks:
fams = collections.defaultdict(int)
types = collections.defaultdict(int)
for s in socks:
fams[s.family] += 1
# work around http://bugs.python.org/issue30204
types[s.getsockopt(socket.SOL_SOCKET, socket.SO_TYPE)] += 1
assert fams[socket.AF_INET] >= 2
if supports_ipv6():
assert fams[socket.AF_INET6] >= 2
if POSIX and HAS_NET_CONNECTIONS_UNIX:
assert fams[socket.AF_UNIX] >= 2
assert types[socket.SOCK_STREAM] >= 2
assert types[socket.SOCK_DGRAM] >= 2
@pytest.mark.xdist_group(name="serial")
class TestMemLeakClass(TestMemoryLeak):
@retry_on_failure()
def test_times(self):
def fun():
cnt['cnt'] += 1
cnt = {'cnt': 0}
self.execute(fun, times=10, warmup_times=15)
assert cnt['cnt'] == 26
def test_param_err(self):
with pytest.raises(ValueError):
self.execute(lambda: 0, times=0)
with pytest.raises(ValueError):
self.execute(lambda: 0, times=-1)
with pytest.raises(ValueError):
self.execute(lambda: 0, warmup_times=-1)
with pytest.raises(ValueError):
self.execute(lambda: 0, tolerance=-1)
with pytest.raises(ValueError):
self.execute(lambda: 0, retries=-1)
@retry_on_failure()
@pytest.mark.skipif(CI_TESTING, reason="skipped on CI")
@pytest.mark.skipif(COVERAGE, reason="skipped during test coverage")
def test_leak_mem(self):
ls = []
def fun(ls=ls):
ls.append("x" * 248 * 1024)
try:
# will consume around 60M in total
with pytest.raises(AssertionError, match="extra-mem"):
self.execute(fun, times=100)
finally:
del ls
def test_unclosed_files(self):
def fun():
f = open(__file__)
self.addCleanup(f.close)
box.append(f)
box = []
kind = "fd" if POSIX else "handle"
with pytest.raises(AssertionError, match="unclosed " + kind):
self.execute(fun)
def test_tolerance(self):
def fun():
ls.append("x" * 24 * 1024)
ls = []
times = 100
self.execute(
fun, times=times, warmup_times=0, tolerance=200 * 1024 * 1024
)
assert len(ls) == times + 1
def test_execute_w_exc(self):
def fun_1():
1 / 0 # noqa
self.execute_w_exc(ZeroDivisionError, fun_1)
with pytest.raises(ZeroDivisionError):
self.execute_w_exc(OSError, fun_1)
def fun_2():
pass
with pytest.raises(AssertionError):
self.execute_w_exc(ZeroDivisionError, fun_2)
class TestFakePytest(PsutilTestCase):
def run_test_class(self, klass):
suite = unittest.TestSuite()
suite.addTest(klass)
runner = unittest.TextTestRunner()
result = runner.run(suite)
return result
def test_raises(self):
with fake_pytest.raises(ZeroDivisionError) as cm:
1 / 0 # noqa
assert isinstance(cm.value, ZeroDivisionError)
with fake_pytest.raises(ValueError, match="foo") as cm:
raise ValueError("foo")
try:
with fake_pytest.raises(ValueError, match="foo") as cm:
raise ValueError("bar")
except AssertionError as err:
assert str(err) == '"foo" does not match "bar"'
else:
raise self.fail("exception not raised")
def test_mark(self):
@fake_pytest.mark.xdist_group(name="serial")
def foo():
return 1
assert foo() == 1
@fake_pytest.mark.xdist_group(name="serial")
class Foo:
def bar(self):
return 1
assert Foo().bar() == 1
def test_skipif(self):
class TestCase(unittest.TestCase):
@fake_pytest.mark.skipif(True, reason="reason")
def foo(self):
assert 1 == 1 # noqa
result = self.run_test_class(TestCase("foo"))
assert result.wasSuccessful()
assert len(result.skipped) == 1
assert result.skipped[0][1] == "reason"
class TestCase(unittest.TestCase):
@fake_pytest.mark.skipif(False, reason="reason")
def foo(self):
assert 1 == 1 # noqa
result = self.run_test_class(TestCase("foo"))
assert result.wasSuccessful()
assert len(result.skipped) == 0
@pytest.mark.skipif(not PY3, reason="not PY3")
def test_skip(self):
class TestCase(unittest.TestCase):
def foo(self):
fake_pytest.skip("reason")
assert 1 == 0 # noqa
result = self.run_test_class(TestCase("foo"))
assert result.wasSuccessful()
assert len(result.skipped) == 1
assert result.skipped[0][1] == "reason"
def test_main(self):
tmpdir = self.get_testfn(dir=HERE)
os.mkdir(tmpdir)
with open(os.path.join(tmpdir, "__init__.py"), "w"):
pass
with open(os.path.join(tmpdir, "test_file.py"), "w") as f:
f.write(textwrap.dedent("""\
import unittest
class TestCase(unittest.TestCase):
def test_passed(self):
pass
""").lstrip())
with mock.patch.object(psutil.tests, "HERE", tmpdir):
with self.assertWarnsRegex(
UserWarning, "Fake pytest module was used"
):
suite = fake_pytest.main()
assert suite.countTestCases() == 1
def test_warns(self):
# success
with fake_pytest.warns(UserWarning):
warnings.warn("foo", UserWarning, stacklevel=1)
# failure
try:
with fake_pytest.warns(UserWarning):
warnings.warn("foo", DeprecationWarning, stacklevel=1)
except AssertionError:
pass
else:
raise self.fail("exception not raised")
# match success
with fake_pytest.warns(UserWarning, match="foo"):
warnings.warn("foo", UserWarning, stacklevel=1)
# match failure
try:
with fake_pytest.warns(UserWarning, match="foo"):
warnings.warn("bar", UserWarning, stacklevel=1)
except AssertionError:
pass
else:
raise self.fail("exception not raised")
class TestTestingUtils(PsutilTestCase):
def test_process_namespace(self):
p = psutil.Process()
ns = process_namespace(p)
ns.test()
fun = [x for x in ns.iter(ns.getters) if x[1] == 'ppid'][0][0]
assert fun() == p.ppid()
def test_system_namespace(self):
ns = system_namespace()
fun = [x for x in ns.iter(ns.getters) if x[1] == 'net_if_addrs'][0][0]
assert fun() == psutil.net_if_addrs()
class TestOtherUtils(PsutilTestCase):
def test_is_namedtuple(self):
assert is_namedtuple(collections.namedtuple('foo', 'a b c')(1, 2, 3))
assert not is_namedtuple(tuple())
PK ok\�c�;1 ;1 psutil/tests/test_unicode.pynu �[��� #!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Notes about unicode handling in psutil
======================================.
Starting from version 5.3.0 psutil adds unicode support, see:
https://github.com/giampaolo/psutil/issues/1040
The notes below apply to *any* API returning a string such as
process exe(), cwd() or username():
* all strings are encoded by using the OS filesystem encoding
(sys.getfilesystemencoding()) which varies depending on the platform
(e.g. "UTF-8" on macOS, "mbcs" on Win)
* no API call is supposed to crash with UnicodeDecodeError
* instead, in case of badly encoded data returned by the OS, the
following error handlers are used to replace the corrupted characters in
the string:
* Python 3: sys.getfilesystemencodeerrors() (PY 3.6+) or
"surrogatescape" on POSIX and "replace" on Windows
* Python 2: "replace"
* on Python 2 all APIs return bytes (str type), never unicode
* on Python 2, you can go back to unicode by doing:
>>> unicode(p.exe(), sys.getdefaultencoding(), errors="replace")
For a detailed explanation of how psutil handles unicode see #1040.
Tests
=====
List of APIs returning or dealing with a string:
('not tested' means they are not tested to deal with non-ASCII strings):
* Process.cmdline()
* Process.cwd()
* Process.environ()
* Process.exe()
* Process.memory_maps()
* Process.name()
* Process.net_connections('unix')
* Process.open_files()
* Process.username() (not tested)
* disk_io_counters() (not tested)
* disk_partitions() (not tested)
* disk_usage(str)
* net_connections('unix')
* net_if_addrs() (not tested)
* net_if_stats() (not tested)
* net_io_counters() (not tested)
* sensors_fans() (not tested)
* sensors_temperatures() (not tested)
* users() (not tested)
* WindowsService.binpath() (not tested)
* WindowsService.description() (not tested)
* WindowsService.display_name() (not tested)
* WindowsService.name() (not tested)
* WindowsService.status() (not tested)
* WindowsService.username() (not tested)
In here we create a unicode path with a funky non-ASCII name and (where
possible) make psutil return it back (e.g. on name(), exe(), open_files(),
etc.) and make sure that:
* psutil never crashes with UnicodeDecodeError
* the returned path matches
"""
import os
import shutil
import traceback
import warnings
from contextlib import closing
import psutil
from psutil import BSD
from psutil import POSIX
from psutil import WINDOWS
from psutil._compat import PY3
from psutil._compat import super
from psutil.tests import APPVEYOR
from psutil.tests import ASCII_FS
from psutil.tests import CI_TESTING
from psutil.tests import HAS_ENVIRON
from psutil.tests import HAS_MEMORY_MAPS
from psutil.tests import HAS_NET_CONNECTIONS_UNIX
from psutil.tests import INVALID_UNICODE_SUFFIX
from psutil.tests import PYPY
from psutil.tests import TESTFN_PREFIX
from psutil.tests import UNICODE_SUFFIX
from psutil.tests import PsutilTestCase
from psutil.tests import bind_unix_socket
from psutil.tests import chdir
from psutil.tests import copyload_shared_lib
from psutil.tests import create_py_exe
from psutil.tests import get_testfn
from psutil.tests import pytest
from psutil.tests import safe_mkdir
from psutil.tests import safe_rmpath
from psutil.tests import skip_on_access_denied
from psutil.tests import spawn_testproc
from psutil.tests import terminate
if APPVEYOR:
def safe_rmpath(path): # NOQA
# TODO - this is quite random and I'm not sure why it happens,
# nor I can reproduce it locally:
# https://ci.appveyor.com/project/giampaolo/psutil/build/job/
# jiq2cgd6stsbtn60
# safe_rmpath() happens after reap_children() so this is weird
# Perhaps wait_procs() on Windows is broken? Maybe because
# of STILL_ACTIVE?
# https://github.com/giampaolo/psutil/blob/
# 68c7a70728a31d8b8b58f4be6c4c0baa2f449eda/psutil/arch/
# windows/process_info.c#L146
from psutil.tests import safe_rmpath as rm
try:
return rm(path)
except WindowsError:
traceback.print_exc()
def try_unicode(suffix):
"""Return True if both the fs and the subprocess module can
deal with a unicode file name.
"""
sproc = None
testfn = get_testfn(suffix=suffix)
try:
safe_rmpath(testfn)
create_py_exe(testfn)
sproc = spawn_testproc(cmd=[testfn])
shutil.copyfile(testfn, testfn + '-2')
safe_rmpath(testfn + '-2')
except (UnicodeEncodeError, IOError):
return False
else:
return True
finally:
if sproc is not None:
terminate(sproc)
safe_rmpath(testfn)
# ===================================================================
# FS APIs
# ===================================================================
class BaseUnicodeTest(PsutilTestCase):
funky_suffix = None
@classmethod
def setUpClass(cls):
super().setUpClass()
cls.skip_tests = False
cls.funky_name = None
if cls.funky_suffix is not None:
if not try_unicode(cls.funky_suffix):
cls.skip_tests = True
else:
cls.funky_name = get_testfn(suffix=cls.funky_suffix)
create_py_exe(cls.funky_name)
def setUp(self):
super().setUp()
if self.skip_tests:
raise pytest.skip("can't handle unicode str")
@pytest.mark.xdist_group(name="serial")
@pytest.mark.skipif(ASCII_FS, reason="ASCII fs")
@pytest.mark.skipif(PYPY and not PY3, reason="too much trouble on PYPY2")
class TestFSAPIs(BaseUnicodeTest):
"""Test FS APIs with a funky, valid, UTF8 path name."""
funky_suffix = UNICODE_SUFFIX
def expect_exact_path_match(self):
# Do not expect psutil to correctly handle unicode paths on
# Python 2 if os.listdir() is not able either.
here = '.' if isinstance(self.funky_name, str) else u'.'
with warnings.catch_warnings():
warnings.simplefilter("ignore")
return self.funky_name in os.listdir(here)
# ---
def test_proc_exe(self):
cmd = [
self.funky_name,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
subp = self.spawn_testproc(cmd)
p = psutil.Process(subp.pid)
exe = p.exe()
assert isinstance(exe, str)
if self.expect_exact_path_match():
assert os.path.normcase(exe) == os.path.normcase(self.funky_name)
def test_proc_name(self):
cmd = [
self.funky_name,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
subp = self.spawn_testproc(cmd)
name = psutil.Process(subp.pid).name()
assert isinstance(name, str)
if self.expect_exact_path_match():
assert name == os.path.basename(self.funky_name)
def test_proc_cmdline(self):
cmd = [
self.funky_name,
"-c",
"import time; [time.sleep(0.1) for x in range(100)]",
]
subp = self.spawn_testproc(cmd)
p = psutil.Process(subp.pid)
cmdline = p.cmdline()
for part in cmdline:
assert isinstance(part, str)
if self.expect_exact_path_match():
assert cmdline == cmd
def test_proc_cwd(self):
dname = self.funky_name + "2"
self.addCleanup(safe_rmpath, dname)
safe_mkdir(dname)
with chdir(dname):
p = psutil.Process()
cwd = p.cwd()
assert isinstance(p.cwd(), str)
if self.expect_exact_path_match():
assert cwd == dname
@pytest.mark.skipif(PYPY and WINDOWS, reason="fails on PYPY + WINDOWS")
def test_proc_open_files(self):
p = psutil.Process()
start = set(p.open_files())
with open(self.funky_name, 'rb'):
new = set(p.open_files())
path = (new - start).pop().path
assert isinstance(path, str)
if BSD and not path:
# XXX - see https://github.com/giampaolo/psutil/issues/595
raise pytest.skip("open_files on BSD is broken")
if self.expect_exact_path_match():
assert os.path.normcase(path) == os.path.normcase(self.funky_name)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
def test_proc_net_connections(self):
name = self.get_testfn(suffix=self.funky_suffix)
try:
sock = bind_unix_socket(name)
except UnicodeEncodeError:
if PY3:
raise
else:
raise pytest.skip("not supported")
with closing(sock):
conn = psutil.Process().net_connections('unix')[0]
assert isinstance(conn.laddr, str)
assert conn.laddr == name
@pytest.mark.skipif(not POSIX, reason="POSIX only")
@pytest.mark.skipif(
not HAS_NET_CONNECTIONS_UNIX, reason="can't list UNIX sockets"
)
@skip_on_access_denied()
def test_net_connections(self):
def find_sock(cons):
for conn in cons:
if os.path.basename(conn.laddr).startswith(TESTFN_PREFIX):
return conn
raise ValueError("connection not found")
name = self.get_testfn(suffix=self.funky_suffix)
try:
sock = bind_unix_socket(name)
except UnicodeEncodeError:
if PY3:
raise
else:
raise pytest.skip("not supported")
with closing(sock):
cons = psutil.net_connections(kind='unix')
conn = find_sock(cons)
assert isinstance(conn.laddr, str)
assert conn.laddr == name
def test_disk_usage(self):
dname = self.funky_name + "2"
self.addCleanup(safe_rmpath, dname)
safe_mkdir(dname)
psutil.disk_usage(dname)
@pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
@pytest.mark.skipif(
not PY3, reason="ctypes does not support unicode on PY2"
)
@pytest.mark.skipif(PYPY, reason="unstable on PYPY")
def test_memory_maps(self):
# XXX: on Python 2, using ctypes.CDLL with a unicode path
# opens a message box which blocks the test run.
with copyload_shared_lib(suffix=self.funky_suffix) as funky_path:
def normpath(p):
return os.path.realpath(os.path.normcase(p))
libpaths = [
normpath(x.path) for x in psutil.Process().memory_maps()
]
# ...just to have a clearer msg in case of failure
libpaths = [x for x in libpaths if TESTFN_PREFIX in x]
assert normpath(funky_path) in libpaths
for path in libpaths:
assert isinstance(path, str)
@pytest.mark.skipif(CI_TESTING, reason="unreliable on CI")
class TestFSAPIsWithInvalidPath(TestFSAPIs):
"""Test FS APIs with a funky, invalid path name."""
funky_suffix = INVALID_UNICODE_SUFFIX
def expect_exact_path_match(self):
# Invalid unicode names are supposed to work on Python 2.
return True
# ===================================================================
# Non fs APIs
# ===================================================================
class TestNonFSAPIS(BaseUnicodeTest):
"""Unicode tests for non fs-related APIs."""
funky_suffix = UNICODE_SUFFIX if PY3 else 'è'
@pytest.mark.skipif(not HAS_ENVIRON, reason="not supported")
@pytest.mark.skipif(PYPY and WINDOWS, reason="segfaults on PYPY + WINDOWS")
def test_proc_environ(self):
# Note: differently from others, this test does not deal
# with fs paths. On Python 2 subprocess module is broken as
# it's not able to handle with non-ASCII env vars, so
# we use "è", which is part of the extended ASCII table
# (unicode point <= 255).
env = os.environ.copy()
env['FUNNY_ARG'] = self.funky_suffix
sproc = self.spawn_testproc(env=env)
p = psutil.Process(sproc.pid)
env = p.environ()
for k, v in env.items():
assert isinstance(k, str)
assert isinstance(v, str)
assert env['FUNNY_ARG'] == self.funky_suffix
PK ok\�μ[d [d psutil/tests/test_linux.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Linux specific tests."""
from __future__ import division
import collections
import contextlib
import errno
import glob
import io
import os
import re
import shutil
import socket
import struct
import textwrap
import time
import warnings
import psutil
from psutil import LINUX
from psutil._compat import PY3
from psutil._compat import FileNotFoundError
from psutil._compat import basestring
from psutil.tests import AARCH64
from psutil.tests import GITHUB_ACTIONS
from psutil.tests import GLOBAL_TIMEOUT
from psutil.tests import HAS_BATTERY
from psutil.tests import HAS_CPU_FREQ
from psutil.tests import HAS_GETLOADAVG
from psutil.tests import HAS_RLIMIT
from psutil.tests import PYPY
from psutil.tests import PYTEST_PARALLEL
from psutil.tests import QEMU_USER
from psutil.tests import TOLERANCE_DISK_USAGE
from psutil.tests import TOLERANCE_SYS_MEM
from psutil.tests import PsutilTestCase
from psutil.tests import ThreadTask
from psutil.tests import call_until
from psutil.tests import mock
from psutil.tests import pytest
from psutil.tests import reload_module
from psutil.tests import retry_on_failure
from psutil.tests import safe_rmpath
from psutil.tests import sh
from psutil.tests import skip_on_not_implemented
from psutil.tests import which
if LINUX:
from psutil._pslinux import CLOCK_TICKS
from psutil._pslinux import RootFsDeviceFinder
from psutil._pslinux import calculate_avail_vmem
from psutil._pslinux import open_binary
HERE = os.path.abspath(os.path.dirname(__file__))
SIOCGIFADDR = 0x8915
SIOCGIFCONF = 0x8912
SIOCGIFHWADDR = 0x8927
SIOCGIFNETMASK = 0x891B
SIOCGIFBRDADDR = 0x8919
if LINUX:
SECTOR_SIZE = 512
EMPTY_TEMPERATURES = not glob.glob('/sys/class/hwmon/hwmon*')
# =====================================================================
# --- utils
# =====================================================================
def get_ipv4_address(ifname):
import fcntl
ifname = ifname[:15]
if PY3:
ifname = bytes(ifname, 'ascii')
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
with contextlib.closing(s):
return socket.inet_ntoa(
fcntl.ioctl(s.fileno(), SIOCGIFADDR, struct.pack('256s', ifname))[
20:24
]
)
def get_ipv4_netmask(ifname):
import fcntl
ifname = ifname[:15]
if PY3:
ifname = bytes(ifname, 'ascii')
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
with contextlib.closing(s):
return socket.inet_ntoa(
fcntl.ioctl(
s.fileno(), SIOCGIFNETMASK, struct.pack('256s', ifname)
)[20:24]
)
def get_ipv4_broadcast(ifname):
import fcntl
ifname = ifname[:15]
if PY3:
ifname = bytes(ifname, 'ascii')
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
with contextlib.closing(s):
return socket.inet_ntoa(
fcntl.ioctl(
s.fileno(), SIOCGIFBRDADDR, struct.pack('256s', ifname)
)[20:24]
)
def get_ipv6_addresses(ifname):
with open("/proc/net/if_inet6") as f:
all_fields = []
for line in f:
fields = line.split()
if fields[-1] == ifname:
all_fields.append(fields)
if len(all_fields) == 0:
raise ValueError("could not find interface %r" % ifname)
for i in range(len(all_fields)):
unformatted = all_fields[i][0]
groups = []
for j in range(0, len(unformatted), 4):
groups.append(unformatted[j : j + 4])
formatted = ":".join(groups)
packed = socket.inet_pton(socket.AF_INET6, formatted)
all_fields[i] = socket.inet_ntop(socket.AF_INET6, packed)
return all_fields
def get_mac_address(ifname):
import fcntl
ifname = ifname[:15]
if PY3:
ifname = bytes(ifname, 'ascii')
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
with contextlib.closing(s):
info = fcntl.ioctl(
s.fileno(), SIOCGIFHWADDR, struct.pack('256s', ifname)
)
if PY3:
def ord(x):
return x
else:
import __builtin__
ord = __builtin__.ord
return ''.join(['%02x:' % ord(char) for char in info[18:24]])[:-1]
def free_swap():
"""Parse 'free' cmd and return swap memory's s total, used and free
values.
"""
out = sh(["free", "-b"], env={"LANG": "C.UTF-8"})
lines = out.split('\n')
for line in lines:
if line.startswith('Swap'):
_, total, used, free = line.split()
nt = collections.namedtuple('free', 'total used free')
return nt(int(total), int(used), int(free))
raise ValueError(
"can't find 'Swap' in 'free' output:\n%s" % '\n'.join(lines)
)
def free_physmem():
"""Parse 'free' cmd and return physical memory's total, used
and free values.
"""
# Note: free can have 2 different formats, invalidating 'shared'
# and 'cached' memory which may have different positions so we
# do not return them.
# https://github.com/giampaolo/psutil/issues/538#issuecomment-57059946
out = sh(["free", "-b"], env={"LANG": "C.UTF-8"})
lines = out.split('\n')
for line in lines:
if line.startswith('Mem'):
total, used, free, shared = (int(x) for x in line.split()[1:5])
nt = collections.namedtuple(
'free', 'total used free shared output'
)
return nt(total, used, free, shared, out)
raise ValueError(
"can't find 'Mem' in 'free' output:\n%s" % '\n'.join(lines)
)
def vmstat(stat):
out = sh(["vmstat", "-s"], env={"LANG": "C.UTF-8"})
for line in out.split("\n"):
line = line.strip()
if stat in line:
return int(line.split(' ')[0])
raise ValueError("can't find %r in 'vmstat' output" % stat)
def get_free_version_info():
out = sh(["free", "-V"]).strip()
if 'UNKNOWN' in out:
raise pytest.skip("can't determine free version")
return tuple(map(int, re.findall(r'\d+', out.split()[-1])))
@contextlib.contextmanager
def mock_open_content(pairs):
"""Mock open() builtin and forces it to return a certain content
for a given path. `pairs` is a {"path": "content", ...} dict.
"""
def open_mock(name, *args, **kwargs):
if name in pairs:
content = pairs[name]
if PY3:
if isinstance(content, basestring):
return io.StringIO(content)
else:
return io.BytesIO(content)
else:
return io.BytesIO(content)
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, create=True, side_effect=open_mock) as m:
yield m
@contextlib.contextmanager
def mock_open_exception(for_path, exc):
"""Mock open() builtin and raises `exc` if the path being opened
matches `for_path`.
"""
def open_mock(name, *args, **kwargs):
if name == for_path:
raise exc
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, create=True, side_effect=open_mock) as m:
yield m
# =====================================================================
# --- system virtual memory
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemVirtualMemoryAgainstFree(PsutilTestCase):
def test_total(self):
cli_value = free_physmem().total
psutil_value = psutil.virtual_memory().total
assert cli_value == psutil_value
@retry_on_failure()
def test_used(self):
# Older versions of procps used slab memory to calculate used memory.
# This got changed in:
# https://gitlab.com/procps-ng/procps/commit/
# 05d751c4f076a2f0118b914c5e51cfbb4762ad8e
# Newer versions of procps are using yet another way to compute used
# memory.
# https://gitlab.com/procps-ng/procps/commit/
# 2184e90d2e7cdb582f9a5b706b47015e56707e4d
if get_free_version_info() < (3, 3, 12):
raise pytest.skip("free version too old")
if get_free_version_info() >= (4, 0, 0):
raise pytest.skip("free version too recent")
cli_value = free_physmem().used
psutil_value = psutil.virtual_memory().used
assert abs(cli_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_free(self):
cli_value = free_physmem().free
psutil_value = psutil.virtual_memory().free
assert abs(cli_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_shared(self):
free = free_physmem()
free_value = free.shared
if free_value == 0:
raise pytest.skip("free does not support 'shared' column")
psutil_value = psutil.virtual_memory().shared
assert (
abs(free_value - psutil_value) < TOLERANCE_SYS_MEM
), '%s %s \n%s' % (free_value, psutil_value, free.output)
@retry_on_failure()
def test_available(self):
# "free" output format has changed at some point:
# https://github.com/giampaolo/psutil/issues/538#issuecomment-147192098
out = sh(["free", "-b"])
lines = out.split('\n')
if 'available' not in lines[0]:
raise pytest.skip("free does not support 'available' column")
else:
free_value = int(lines[1].split()[-1])
psutil_value = psutil.virtual_memory().available
assert (
abs(free_value - psutil_value) < TOLERANCE_SYS_MEM
), '%s %s \n%s' % (free_value, psutil_value, out)
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemVirtualMemoryAgainstVmstat(PsutilTestCase):
def test_total(self):
vmstat_value = vmstat('total memory') * 1024
psutil_value = psutil.virtual_memory().total
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_used(self):
# Older versions of procps used slab memory to calculate used memory.
# This got changed in:
# https://gitlab.com/procps-ng/procps/commit/
# 05d751c4f076a2f0118b914c5e51cfbb4762ad8e
# Newer versions of procps are using yet another way to compute used
# memory.
# https://gitlab.com/procps-ng/procps/commit/
# 2184e90d2e7cdb582f9a5b706b47015e56707e4d
if get_free_version_info() < (3, 3, 12):
raise pytest.skip("free version too old")
if get_free_version_info() >= (4, 0, 0):
raise pytest.skip("free version too recent")
vmstat_value = vmstat('used memory') * 1024
psutil_value = psutil.virtual_memory().used
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_free(self):
vmstat_value = vmstat('free memory') * 1024
psutil_value = psutil.virtual_memory().free
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_buffers(self):
vmstat_value = vmstat('buffer memory') * 1024
psutil_value = psutil.virtual_memory().buffers
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_active(self):
vmstat_value = vmstat('active memory') * 1024
psutil_value = psutil.virtual_memory().active
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_inactive(self):
vmstat_value = vmstat('inactive memory') * 1024
psutil_value = psutil.virtual_memory().inactive
assert abs(vmstat_value - psutil_value) < TOLERANCE_SYS_MEM
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemVirtualMemoryMocks(PsutilTestCase):
def test_warnings_on_misses(self):
# Emulate a case where /proc/meminfo provides few info.
# psutil is supposed to set the missing fields to 0 and
# raise a warning.
content = textwrap.dedent("""\
Active(anon): 6145416 kB
Active(file): 2950064 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemAvailable: -1 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
SReclaimable: 346648 kB
""").encode()
with mock_open_content({'/proc/meminfo': content}) as m:
with warnings.catch_warnings(record=True) as ws:
warnings.simplefilter("always")
ret = psutil.virtual_memory()
assert m.called
assert len(ws) == 1
w = ws[0]
assert "memory stats couldn't be determined" in str(w.message)
assert "cached" in str(w.message)
assert "shared" in str(w.message)
assert "active" in str(w.message)
assert "inactive" in str(w.message)
assert "buffers" in str(w.message)
assert "available" in str(w.message)
assert ret.cached == 0
assert ret.active == 0
assert ret.inactive == 0
assert ret.shared == 0
assert ret.buffers == 0
assert ret.available == 0
assert ret.slab == 0
@retry_on_failure()
def test_avail_old_percent(self):
# Make sure that our calculation of avail mem for old kernels
# is off by max 15%.
mems = {}
with open_binary('/proc/meminfo') as f:
for line in f:
fields = line.split()
mems[fields[0]] = int(fields[1]) * 1024
a = calculate_avail_vmem(mems)
if b'MemAvailable:' in mems:
b = mems[b'MemAvailable:']
diff_percent = abs(a - b) / a * 100
assert diff_percent < 15
def test_avail_old_comes_from_kernel(self):
# Make sure "MemAvailable:" coluimn is used instead of relying
# on our internal algorithm to calculate avail mem.
content = textwrap.dedent("""\
Active: 9444728 kB
Active(anon): 6145416 kB
Active(file): 2950064 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemAvailable: 6574984 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
SReclaimable: 346648 kB
""").encode()
with mock_open_content({'/proc/meminfo': content}) as m:
with warnings.catch_warnings(record=True) as ws:
ret = psutil.virtual_memory()
assert m.called
assert ret.available == 6574984 * 1024
w = ws[0]
assert "inactive memory stats couldn't be determined" in str(
w.message
)
def test_avail_old_missing_fields(self):
# Remove Active(file), Inactive(file) and SReclaimable
# from /proc/meminfo and make sure the fallback is used
# (free + cached),
content = textwrap.dedent("""\
Active: 9444728 kB
Active(anon): 6145416 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
""").encode()
with mock_open_content({"/proc/meminfo": content}) as m:
with warnings.catch_warnings(record=True) as ws:
ret = psutil.virtual_memory()
assert m.called
assert ret.available == 2057400 * 1024 + 4818144 * 1024
w = ws[0]
assert "inactive memory stats couldn't be determined" in str(
w.message
)
def test_avail_old_missing_zoneinfo(self):
# Remove /proc/zoneinfo file. Make sure fallback is used
# (free + cached).
content = textwrap.dedent("""\
Active: 9444728 kB
Active(anon): 6145416 kB
Active(file): 2950064 kB
Buffers: 287952 kB
Cached: 4818144 kB
Inactive(file): 1578132 kB
Inactive(anon): 574764 kB
Inactive(file): 1567648 kB
MemFree: 2057400 kB
MemTotal: 16325648 kB
Shmem: 577588 kB
SReclaimable: 346648 kB
""").encode()
with mock_open_content({"/proc/meminfo": content}):
with mock_open_exception(
"/proc/zoneinfo",
IOError(errno.ENOENT, 'no such file or directory'),
):
with warnings.catch_warnings(record=True) as ws:
ret = psutil.virtual_memory()
assert ret.available == 2057400 * 1024 + 4818144 * 1024
w = ws[0]
assert (
"inactive memory stats couldn't be determined"
in str(w.message)
)
def test_virtual_memory_mocked(self):
# Emulate /proc/meminfo because neither vmstat nor free return slab.
content = textwrap.dedent("""\
MemTotal: 100 kB
MemFree: 2 kB
MemAvailable: 3 kB
Buffers: 4 kB
Cached: 5 kB
SwapCached: 6 kB
Active: 7 kB
Inactive: 8 kB
Active(anon): 9 kB
Inactive(anon): 10 kB
Active(file): 11 kB
Inactive(file): 12 kB
Unevictable: 13 kB
Mlocked: 14 kB
SwapTotal: 15 kB
SwapFree: 16 kB
Dirty: 17 kB
Writeback: 18 kB
AnonPages: 19 kB
Mapped: 20 kB
Shmem: 21 kB
Slab: 22 kB
SReclaimable: 23 kB
SUnreclaim: 24 kB
KernelStack: 25 kB
PageTables: 26 kB
NFS_Unstable: 27 kB
Bounce: 28 kB
WritebackTmp: 29 kB
CommitLimit: 30 kB
Committed_AS: 31 kB
VmallocTotal: 32 kB
VmallocUsed: 33 kB
VmallocChunk: 34 kB
HardwareCorrupted: 35 kB
AnonHugePages: 36 kB
ShmemHugePages: 37 kB
ShmemPmdMapped: 38 kB
CmaTotal: 39 kB
CmaFree: 40 kB
HugePages_Total: 41 kB
HugePages_Free: 42 kB
HugePages_Rsvd: 43 kB
HugePages_Surp: 44 kB
Hugepagesize: 45 kB
DirectMap46k: 46 kB
DirectMap47M: 47 kB
DirectMap48G: 48 kB
""").encode()
with mock_open_content({"/proc/meminfo": content}) as m:
mem = psutil.virtual_memory()
assert m.called
assert mem.total == 100 * 1024
assert mem.free == 2 * 1024
assert mem.buffers == 4 * 1024
# cached mem also includes reclaimable memory
assert mem.cached == (5 + 23) * 1024
assert mem.shared == 21 * 1024
assert mem.active == 7 * 1024
assert mem.inactive == 8 * 1024
assert mem.slab == 22 * 1024
assert mem.available == 3 * 1024
# =====================================================================
# --- system swap memory
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemSwapMemory(PsutilTestCase):
@staticmethod
def meminfo_has_swap_info():
"""Return True if /proc/meminfo provides swap metrics."""
with open("/proc/meminfo") as f:
data = f.read()
return 'SwapTotal:' in data and 'SwapFree:' in data
def test_total(self):
free_value = free_swap().total
psutil_value = psutil.swap_memory().total
assert abs(free_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_used(self):
free_value = free_swap().used
psutil_value = psutil.swap_memory().used
assert abs(free_value - psutil_value) < TOLERANCE_SYS_MEM
@retry_on_failure()
def test_free(self):
free_value = free_swap().free
psutil_value = psutil.swap_memory().free
assert abs(free_value - psutil_value) < TOLERANCE_SYS_MEM
def test_missing_sin_sout(self):
with mock.patch('psutil._common.open', create=True) as m:
with warnings.catch_warnings(record=True) as ws:
warnings.simplefilter("always")
ret = psutil.swap_memory()
assert m.called
assert len(ws) == 1
w = ws[0]
assert (
"'sin' and 'sout' swap memory stats couldn't be determined"
in str(w.message)
)
assert ret.sin == 0
assert ret.sout == 0
def test_no_vmstat_mocked(self):
# see https://github.com/giampaolo/psutil/issues/722
with mock_open_exception(
"/proc/vmstat", IOError(errno.ENOENT, 'no such file or directory')
) as m:
with warnings.catch_warnings(record=True) as ws:
warnings.simplefilter("always")
ret = psutil.swap_memory()
assert m.called
assert len(ws) == 1
w = ws[0]
assert (
"'sin' and 'sout' swap memory stats couldn't "
"be determined and were set to 0"
in str(w.message)
)
assert ret.sin == 0
assert ret.sout == 0
def test_meminfo_against_sysinfo(self):
# Make sure the content of /proc/meminfo about swap memory
# matches sysinfo() syscall, see:
# https://github.com/giampaolo/psutil/issues/1015
if not self.meminfo_has_swap_info():
raise pytest.skip("/proc/meminfo has no swap metrics")
with mock.patch('psutil._pslinux.cext.linux_sysinfo') as m:
swap = psutil.swap_memory()
assert not m.called
import psutil._psutil_linux as cext
_, _, _, _, total, free, unit_multiplier = cext.linux_sysinfo()
total *= unit_multiplier
free *= unit_multiplier
assert swap.total == total
assert abs(swap.free - free) < TOLERANCE_SYS_MEM
def test_emulate_meminfo_has_no_metrics(self):
# Emulate a case where /proc/meminfo provides no swap metrics
# in which case sysinfo() syscall is supposed to be used
# as a fallback.
with mock_open_content({"/proc/meminfo": b""}) as m:
psutil.swap_memory()
assert m.called
# =====================================================================
# --- system CPU
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemCPUTimes(PsutilTestCase):
def test_fields(self):
fields = psutil.cpu_times()._fields
kernel_ver = re.findall(r'\d+\.\d+\.\d+', os.uname()[2])[0]
kernel_ver_info = tuple(map(int, kernel_ver.split('.')))
if kernel_ver_info >= (2, 6, 11):
assert 'steal' in fields
else:
assert 'steal' not in fields
if kernel_ver_info >= (2, 6, 24):
assert 'guest' in fields
else:
assert 'guest' not in fields
if kernel_ver_info >= (3, 2, 0):
assert 'guest_nice' in fields
else:
assert 'guest_nice' not in fields
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemCPUCountLogical(PsutilTestCase):
@pytest.mark.skipif(
not os.path.exists("/sys/devices/system/cpu/online"),
reason="/sys/devices/system/cpu/online does not exist",
)
def test_against_sysdev_cpu_online(self):
with open("/sys/devices/system/cpu/online") as f:
value = f.read().strip()
if "-" in str(value):
value = int(value.split('-')[1]) + 1
assert psutil.cpu_count() == value
@pytest.mark.skipif(
not os.path.exists("/sys/devices/system/cpu"),
reason="/sys/devices/system/cpu does not exist",
)
def test_against_sysdev_cpu_num(self):
ls = os.listdir("/sys/devices/system/cpu")
count = len([x for x in ls if re.search(r"cpu\d+$", x) is not None])
assert psutil.cpu_count() == count
@pytest.mark.skipif(
not which("nproc"), reason="nproc utility not available"
)
def test_against_nproc(self):
num = int(sh("nproc --all"))
assert psutil.cpu_count(logical=True) == num
@pytest.mark.skipif(
not which("lscpu"), reason="lscpu utility not available"
)
def test_against_lscpu(self):
out = sh("lscpu -p")
num = len([x for x in out.split('\n') if not x.startswith('#')])
assert psutil.cpu_count(logical=True) == num
def test_emulate_fallbacks(self):
import psutil._pslinux
original = psutil._pslinux.cpu_count_logical()
# Here we want to mock os.sysconf("SC_NPROCESSORS_ONLN") in
# order to cause the parsing of /proc/cpuinfo and /proc/stat.
with mock.patch(
'psutil._pslinux.os.sysconf', side_effect=ValueError
) as m:
assert psutil._pslinux.cpu_count_logical() == original
assert m.called
# Let's have open() return empty data and make sure None is
# returned ('cause we mimic os.cpu_count()).
with mock.patch('psutil._common.open', create=True) as m:
assert psutil._pslinux.cpu_count_logical() is None
assert m.call_count == 2
# /proc/stat should be the last one
assert m.call_args[0][0] == '/proc/stat'
# Let's push this a bit further and make sure /proc/cpuinfo
# parsing works as expected.
with open('/proc/cpuinfo', 'rb') as f:
cpuinfo_data = f.read()
fake_file = io.BytesIO(cpuinfo_data)
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert psutil._pslinux.cpu_count_logical() == original
# Finally, let's make /proc/cpuinfo return meaningless data;
# this way we'll fall back on relying on /proc/stat
with mock_open_content({"/proc/cpuinfo": b""}) as m:
assert psutil._pslinux.cpu_count_logical() == original
assert m.called
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemCPUCountCores(PsutilTestCase):
@pytest.mark.skipif(
not which("lscpu"), reason="lscpu utility not available"
)
def test_against_lscpu(self):
out = sh("lscpu -p")
core_ids = set()
for line in out.split('\n'):
if not line.startswith('#'):
fields = line.split(',')
core_ids.add(fields[1])
assert psutil.cpu_count(logical=False) == len(core_ids)
def test_method_2(self):
meth_1 = psutil._pslinux.cpu_count_cores()
with mock.patch('glob.glob', return_value=[]) as m:
meth_2 = psutil._pslinux.cpu_count_cores()
assert m.called
if meth_1 is not None:
assert meth_1 == meth_2
def test_emulate_none(self):
with mock.patch('glob.glob', return_value=[]) as m1:
with mock.patch('psutil._common.open', create=True) as m2:
assert psutil._pslinux.cpu_count_cores() is None
assert m1.called
assert m2.called
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemCPUFrequency(PsutilTestCase):
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_emulate_use_second_file(self):
# https://github.com/giampaolo/psutil/issues/981
def path_exists_mock(path):
if path.startswith("/sys/devices/system/cpu/cpufreq/policy"):
return False
else:
return orig_exists(path)
orig_exists = os.path.exists
with mock.patch(
"os.path.exists", side_effect=path_exists_mock, create=True
):
assert psutil.cpu_freq()
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
@pytest.mark.skipif(
AARCH64, reason="aarch64 does not report mhz in /proc/cpuinfo"
)
def test_emulate_use_cpuinfo(self):
# Emulate a case where /sys/devices/system/cpu/cpufreq* does not
# exist and /proc/cpuinfo is used instead.
def path_exists_mock(path):
if path.startswith('/sys/devices/system/cpu/'):
return False
else:
return os_path_exists(path)
os_path_exists = os.path.exists
try:
with mock.patch("os.path.exists", side_effect=path_exists_mock):
reload_module(psutil._pslinux)
ret = psutil.cpu_freq()
assert ret, ret
assert ret.max == 0.0
assert ret.min == 0.0
for freq in psutil.cpu_freq(percpu=True):
assert freq.max == 0.0
assert freq.min == 0.0
finally:
reload_module(psutil._pslinux)
reload_module(psutil)
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_emulate_data(self):
def open_mock(name, *args, **kwargs):
if name.endswith('/scaling_cur_freq') and name.startswith(
"/sys/devices/system/cpu/cpufreq/policy"
):
return io.BytesIO(b"500000")
elif name.endswith('/scaling_min_freq') and name.startswith(
"/sys/devices/system/cpu/cpufreq/policy"
):
return io.BytesIO(b"600000")
elif name.endswith('/scaling_max_freq') and name.startswith(
"/sys/devices/system/cpu/cpufreq/policy"
):
return io.BytesIO(b"700000")
elif name == '/proc/cpuinfo':
return io.BytesIO(b"cpu MHz : 500")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
with mock.patch('os.path.exists', return_value=True):
freq = psutil.cpu_freq()
assert freq.current == 500.0
# when /proc/cpuinfo is used min and max frequencies are not
# available and are set to 0.
if freq.min != 0.0:
assert freq.min == 600.0
if freq.max != 0.0:
assert freq.max == 700.0
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_emulate_multi_cpu(self):
def open_mock(name, *args, **kwargs):
n = name
if n.endswith('/scaling_cur_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy0"
):
return io.BytesIO(b"100000")
elif n.endswith('/scaling_min_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy0"
):
return io.BytesIO(b"200000")
elif n.endswith('/scaling_max_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy0"
):
return io.BytesIO(b"300000")
elif n.endswith('/scaling_cur_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy1"
):
return io.BytesIO(b"400000")
elif n.endswith('/scaling_min_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy1"
):
return io.BytesIO(b"500000")
elif n.endswith('/scaling_max_freq') and n.startswith(
"/sys/devices/system/cpu/cpufreq/policy1"
):
return io.BytesIO(b"600000")
elif name == '/proc/cpuinfo':
return io.BytesIO(b"cpu MHz : 100\ncpu MHz : 400")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
with mock.patch('os.path.exists', return_value=True):
with mock.patch(
'psutil._pslinux.cpu_count_logical', return_value=2
):
freq = psutil.cpu_freq(percpu=True)
assert freq[0].current == 100.0
if freq[0].min != 0.0:
assert freq[0].min == 200.0
if freq[0].max != 0.0:
assert freq[0].max == 300.0
assert freq[1].current == 400.0
if freq[1].min != 0.0:
assert freq[1].min == 500.0
if freq[1].max != 0.0:
assert freq[1].max == 600.0
@pytest.mark.skipif(not HAS_CPU_FREQ, reason="not supported")
def test_emulate_no_scaling_cur_freq_file(self):
# See: https://github.com/giampaolo/psutil/issues/1071
def open_mock(name, *args, **kwargs):
if name.endswith('/scaling_cur_freq'):
raise IOError(errno.ENOENT, "")
elif name.endswith('/cpuinfo_cur_freq'):
return io.BytesIO(b"200000")
elif name == '/proc/cpuinfo':
return io.BytesIO(b"cpu MHz : 200")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
with mock.patch('os.path.exists', return_value=True):
with mock.patch(
'psutil._pslinux.cpu_count_logical', return_value=1
):
freq = psutil.cpu_freq()
assert freq.current == 200
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemCPUStats(PsutilTestCase):
# XXX: fails too often.
# def test_ctx_switches(self):
# vmstat_value = vmstat("context switches")
# psutil_value = psutil.cpu_stats().ctx_switches
# self.assertAlmostEqual(vmstat_value, psutil_value, delta=500)
def test_interrupts(self):
vmstat_value = vmstat("interrupts")
psutil_value = psutil.cpu_stats().interrupts
assert abs(vmstat_value - psutil_value) < 500
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestLoadAvg(PsutilTestCase):
@pytest.mark.skipif(not HAS_GETLOADAVG, reason="not supported")
def test_getloadavg(self):
psutil_value = psutil.getloadavg()
with open("/proc/loadavg") as f:
proc_value = f.read().split()
assert abs(float(proc_value[0]) - psutil_value[0]) < 1
assert abs(float(proc_value[1]) - psutil_value[1]) < 1
assert abs(float(proc_value[2]) - psutil_value[2]) < 1
# =====================================================================
# --- system network
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemNetIfAddrs(PsutilTestCase):
def test_ips(self):
for name, addrs in psutil.net_if_addrs().items():
for addr in addrs:
if addr.family == psutil.AF_LINK:
assert addr.address == get_mac_address(name)
elif addr.family == socket.AF_INET:
assert addr.address == get_ipv4_address(name)
assert addr.netmask == get_ipv4_netmask(name)
if addr.broadcast is not None:
assert addr.broadcast == get_ipv4_broadcast(name)
else:
assert get_ipv4_broadcast(name) == '0.0.0.0'
elif addr.family == socket.AF_INET6:
# IPv6 addresses can have a percent symbol at the end.
# E.g. these 2 are equivalent:
# "fe80::1ff:fe23:4567:890a"
# "fe80::1ff:fe23:4567:890a%eth0"
# That is the "zone id" portion, which usually is the name
# of the network interface.
address = addr.address.split('%')[0]
assert address in get_ipv6_addresses(name)
# XXX - not reliable when having virtual NICs installed by Docker.
# @pytest.mark.skipif(not which('ip'), reason="'ip' utility not available")
# def test_net_if_names(self):
# out = sh("ip addr").strip()
# nics = [x for x in psutil.net_if_addrs().keys() if ':' not in x]
# found = 0
# for line in out.split('\n'):
# line = line.strip()
# if re.search(r"^\d+:", line):
# found += 1
# name = line.split(':')[1].strip()
# self.assertIn(name, nics)
# self.assertEqual(len(nics), found, msg="%s\n---\n%s" % (
# pprint.pformat(nics), out))
@pytest.mark.skipif(not LINUX, reason="LINUX only")
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
class TestSystemNetIfStats(PsutilTestCase):
@pytest.mark.skipif(
not which("ifconfig"), reason="ifconfig utility not available"
)
def test_against_ifconfig(self):
for name, stats in psutil.net_if_stats().items():
try:
out = sh("ifconfig %s" % name)
except RuntimeError:
pass
else:
assert stats.isup == ('RUNNING' in out), out
assert stats.mtu == int(
re.findall(r'(?i)MTU[: ](\d+)', out)[0]
)
def test_mtu(self):
for name, stats in psutil.net_if_stats().items():
with open("/sys/class/net/%s/mtu" % name) as f:
assert stats.mtu == int(f.read().strip())
@pytest.mark.skipif(
not which("ifconfig"), reason="ifconfig utility not available"
)
def test_flags(self):
# first line looks like this:
# "eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500"
matches_found = 0
for name, stats in psutil.net_if_stats().items():
try:
out = sh("ifconfig %s" % name)
except RuntimeError:
pass
else:
match = re.search(r"flags=(\d+)?<(.*?)>", out)
if match and len(match.groups()) >= 2:
matches_found += 1
ifconfig_flags = set(match.group(2).lower().split(","))
psutil_flags = set(stats.flags.split(","))
assert ifconfig_flags == psutil_flags
else:
# ifconfig has a different output on CentOS 6
# let's try that
match = re.search(r"(.*) MTU:(\d+) Metric:(\d+)", out)
if match and len(match.groups()) >= 3:
matches_found += 1
ifconfig_flags = set(match.group(1).lower().split())
psutil_flags = set(stats.flags.split(","))
assert ifconfig_flags == psutil_flags
if not matches_found:
raise self.fail("no matches were found")
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemNetIOCounters(PsutilTestCase):
@pytest.mark.skipif(
not which("ifconfig"), reason="ifconfig utility not available"
)
@retry_on_failure()
def test_against_ifconfig(self):
def ifconfig(nic):
ret = {}
out = sh("ifconfig %s" % nic)
ret['packets_recv'] = int(
re.findall(r'RX packets[: ](\d+)', out)[0]
)
ret['packets_sent'] = int(
re.findall(r'TX packets[: ](\d+)', out)[0]
)
ret['errin'] = int(re.findall(r'errors[: ](\d+)', out)[0])
ret['errout'] = int(re.findall(r'errors[: ](\d+)', out)[1])
ret['dropin'] = int(re.findall(r'dropped[: ](\d+)', out)[0])
ret['dropout'] = int(re.findall(r'dropped[: ](\d+)', out)[1])
ret['bytes_recv'] = int(
re.findall(r'RX (?:packets \d+ +)?bytes[: ](\d+)', out)[0]
)
ret['bytes_sent'] = int(
re.findall(r'TX (?:packets \d+ +)?bytes[: ](\d+)', out)[0]
)
return ret
nio = psutil.net_io_counters(pernic=True, nowrap=False)
for name, stats in nio.items():
try:
ifconfig_ret = ifconfig(name)
except RuntimeError:
continue
assert (
abs(stats.bytes_recv - ifconfig_ret['bytes_recv']) < 1024 * 10
)
assert (
abs(stats.bytes_sent - ifconfig_ret['bytes_sent']) < 1024 * 10
)
assert (
abs(stats.packets_recv - ifconfig_ret['packets_recv']) < 1024
)
assert (
abs(stats.packets_sent - ifconfig_ret['packets_sent']) < 1024
)
assert abs(stats.errin - ifconfig_ret['errin']) < 10
assert abs(stats.errout - ifconfig_ret['errout']) < 10
assert abs(stats.dropin - ifconfig_ret['dropin']) < 10
assert abs(stats.dropout - ifconfig_ret['dropout']) < 10
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemNetConnections(PsutilTestCase):
@mock.patch('psutil._pslinux.socket.inet_ntop', side_effect=ValueError)
@mock.patch('psutil._pslinux.supports_ipv6', return_value=False)
def test_emulate_ipv6_unsupported(self, supports_ipv6, inet_ntop):
# see: https://github.com/giampaolo/psutil/issues/623
try:
s = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
self.addCleanup(s.close)
s.bind(("::1", 0))
except socket.error:
pass
psutil.net_connections(kind='inet6')
def test_emulate_unix(self):
content = textwrap.dedent("""\
0: 00000003 000 000 0001 03 462170 @/tmp/dbus-Qw2hMPIU3n
0: 00000003 000 000 0001 03 35010 @/tmp/dbus-tB2X8h69BQ
0: 00000003 000 000 0001 03 34424 @/tmp/dbus-cHy80Y8O
000000000000000000000000000000000000000000000000000000
""")
with mock_open_content({"/proc/net/unix": content}) as m:
psutil.net_connections(kind='unix')
assert m.called
# =====================================================================
# --- system disks
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemDiskPartitions(PsutilTestCase):
@pytest.mark.skipif(
not hasattr(os, 'statvfs'), reason="os.statvfs() not available"
)
@skip_on_not_implemented()
def test_against_df(self):
# test psutil.disk_usage() and psutil.disk_partitions()
# against "df -a"
def df(path):
out = sh('df -P -B 1 "%s"' % path).strip()
lines = out.split('\n')
lines.pop(0)
line = lines.pop(0)
dev, total, used, free = line.split()[:4]
if dev == 'none':
dev = ''
total, used, free = int(total), int(used), int(free)
return dev, total, used, free
for part in psutil.disk_partitions(all=False):
usage = psutil.disk_usage(part.mountpoint)
_, total, used, free = df(part.mountpoint)
assert usage.total == total
assert abs(usage.free - free) < TOLERANCE_DISK_USAGE
assert abs(usage.used - used) < TOLERANCE_DISK_USAGE
def test_zfs_fs(self):
# Test that ZFS partitions are returned.
with open("/proc/filesystems") as f:
data = f.read()
if 'zfs' in data:
for part in psutil.disk_partitions():
if part.fstype == 'zfs':
break
else:
raise self.fail("couldn't find any ZFS partition")
else:
# No ZFS partitions on this system. Let's fake one.
fake_file = io.StringIO(u"nodev\tzfs\n")
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m1:
with mock.patch(
'psutil._pslinux.cext.disk_partitions',
return_value=[('/dev/sdb3', '/', 'zfs', 'rw')],
) as m2:
ret = psutil.disk_partitions()
assert m1.called
assert m2.called
assert ret
assert ret[0].fstype == 'zfs'
def test_emulate_realpath_fail(self):
# See: https://github.com/giampaolo/psutil/issues/1307
try:
with mock.patch(
'os.path.realpath', return_value='/non/existent'
) as m:
with pytest.raises(FileNotFoundError):
psutil.disk_partitions()
assert m.called
finally:
psutil.PROCFS_PATH = "/proc"
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSystemDiskIoCounters(PsutilTestCase):
def test_emulate_kernel_2_4(self):
# Tests /proc/diskstats parsing format for 2.4 kernels, see:
# https://github.com/giampaolo/psutil/issues/767
content = " 3 0 1 hda 2 3 4 5 6 7 8 9 10 11 12"
with mock_open_content({'/proc/diskstats': content}):
with mock.patch(
'psutil._pslinux.is_storage_device', return_value=True
):
ret = psutil.disk_io_counters(nowrap=False)
assert ret.read_count == 1
assert ret.read_merged_count == 2
assert ret.read_bytes == 3 * SECTOR_SIZE
assert ret.read_time == 4
assert ret.write_count == 5
assert ret.write_merged_count == 6
assert ret.write_bytes == 7 * SECTOR_SIZE
assert ret.write_time == 8
assert ret.busy_time == 10
def test_emulate_kernel_2_6_full(self):
# Tests /proc/diskstats parsing format for 2.6 kernels,
# lines reporting all metrics:
# https://github.com/giampaolo/psutil/issues/767
content = " 3 0 hda 1 2 3 4 5 6 7 8 9 10 11"
with mock_open_content({"/proc/diskstats": content}):
with mock.patch(
'psutil._pslinux.is_storage_device', return_value=True
):
ret = psutil.disk_io_counters(nowrap=False)
assert ret.read_count == 1
assert ret.read_merged_count == 2
assert ret.read_bytes == 3 * SECTOR_SIZE
assert ret.read_time == 4
assert ret.write_count == 5
assert ret.write_merged_count == 6
assert ret.write_bytes == 7 * SECTOR_SIZE
assert ret.write_time == 8
assert ret.busy_time == 10
def test_emulate_kernel_2_6_limited(self):
# Tests /proc/diskstats parsing format for 2.6 kernels,
# where one line of /proc/partitions return a limited
# amount of metrics when it bumps into a partition
# (instead of a disk). See:
# https://github.com/giampaolo/psutil/issues/767
with mock_open_content({"/proc/diskstats": " 3 1 hda 1 2 3 4"}):
with mock.patch(
'psutil._pslinux.is_storage_device', return_value=True
):
ret = psutil.disk_io_counters(nowrap=False)
assert ret.read_count == 1
assert ret.read_bytes == 2 * SECTOR_SIZE
assert ret.write_count == 3
assert ret.write_bytes == 4 * SECTOR_SIZE
assert ret.read_merged_count == 0
assert ret.read_time == 0
assert ret.write_merged_count == 0
assert ret.write_time == 0
assert ret.busy_time == 0
def test_emulate_include_partitions(self):
# Make sure that when perdisk=True disk partitions are returned,
# see:
# https://github.com/giampaolo/psutil/pull/1313#issuecomment-408626842
content = textwrap.dedent("""\
3 0 nvme0n1 1 2 3 4 5 6 7 8 9 10 11
3 0 nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
""")
with mock_open_content({"/proc/diskstats": content}):
with mock.patch(
'psutil._pslinux.is_storage_device', return_value=False
):
ret = psutil.disk_io_counters(perdisk=True, nowrap=False)
assert len(ret) == 2
assert ret['nvme0n1'].read_count == 1
assert ret['nvme0n1p1'].read_count == 1
assert ret['nvme0n1'].write_count == 5
assert ret['nvme0n1p1'].write_count == 5
def test_emulate_exclude_partitions(self):
# Make sure that when perdisk=False partitions (e.g. 'sda1',
# 'nvme0n1p1') are skipped and not included in the total count.
# https://github.com/giampaolo/psutil/pull/1313#issuecomment-408626842
content = textwrap.dedent("""\
3 0 nvme0n1 1 2 3 4 5 6 7 8 9 10 11
3 0 nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
""")
with mock_open_content({"/proc/diskstats": content}):
with mock.patch(
'psutil._pslinux.is_storage_device', return_value=False
):
ret = psutil.disk_io_counters(perdisk=False, nowrap=False)
assert ret is None
def is_storage_device(name):
return name == 'nvme0n1'
content = textwrap.dedent("""\
3 0 nvme0n1 1 2 3 4 5 6 7 8 9 10 11
3 0 nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
""")
with mock_open_content({"/proc/diskstats": content}):
with mock.patch(
'psutil._pslinux.is_storage_device',
create=True,
side_effect=is_storage_device,
):
ret = psutil.disk_io_counters(perdisk=False, nowrap=False)
assert ret.read_count == 1
assert ret.write_count == 5
def test_emulate_use_sysfs(self):
def exists(path):
return path == '/proc/diskstats'
wprocfs = psutil.disk_io_counters(perdisk=True)
with mock.patch(
'psutil._pslinux.os.path.exists', create=True, side_effect=exists
):
wsysfs = psutil.disk_io_counters(perdisk=True)
assert len(wprocfs) == len(wsysfs)
def test_emulate_not_impl(self):
def exists(path):
return False
with mock.patch(
'psutil._pslinux.os.path.exists', create=True, side_effect=exists
):
with pytest.raises(NotImplementedError):
psutil.disk_io_counters()
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestRootFsDeviceFinder(PsutilTestCase):
def setUp(self):
dev = os.stat("/").st_dev
self.major = os.major(dev)
self.minor = os.minor(dev)
def test_call_methods(self):
finder = RootFsDeviceFinder()
if os.path.exists("/proc/partitions"):
finder.ask_proc_partitions()
else:
with pytest.raises(FileNotFoundError):
finder.ask_proc_partitions()
if os.path.exists(
"/sys/dev/block/%s:%s/uevent" % (self.major, self.minor)
):
finder.ask_sys_dev_block()
else:
with pytest.raises(FileNotFoundError):
finder.ask_sys_dev_block()
finder.ask_sys_class_block()
@pytest.mark.skipif(GITHUB_ACTIONS, reason="unsupported on GITHUB_ACTIONS")
def test_comparisons(self):
finder = RootFsDeviceFinder()
assert finder.find() is not None
a = b = c = None
if os.path.exists("/proc/partitions"):
a = finder.ask_proc_partitions()
if os.path.exists(
"/sys/dev/block/%s:%s/uevent" % (self.major, self.minor)
):
b = finder.ask_sys_class_block()
c = finder.ask_sys_dev_block()
base = a or b or c
if base and a:
assert base == a
if base and b:
assert base == b
if base and c:
assert base == c
@pytest.mark.skipif(
not which("findmnt"), reason="findmnt utility not available"
)
@pytest.mark.skipif(GITHUB_ACTIONS, reason="unsupported on GITHUB_ACTIONS")
def test_against_findmnt(self):
psutil_value = RootFsDeviceFinder().find()
findmnt_value = sh("findmnt -o SOURCE -rn /")
assert psutil_value == findmnt_value
def test_disk_partitions_mocked(self):
with mock.patch(
'psutil._pslinux.cext.disk_partitions',
return_value=[('/dev/root', '/', 'ext4', 'rw')],
) as m:
part = psutil.disk_partitions()[0]
assert m.called
if not GITHUB_ACTIONS:
assert part.device != "/dev/root"
assert part.device == RootFsDeviceFinder().find()
else:
assert part.device == "/dev/root"
# =====================================================================
# --- misc
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestMisc(PsutilTestCase):
def test_boot_time(self):
vmstat_value = vmstat('boot time')
psutil_value = psutil.boot_time()
assert int(vmstat_value) == int(psutil_value)
def test_no_procfs_on_import(self):
my_procfs = self.get_testfn()
os.mkdir(my_procfs)
with open(os.path.join(my_procfs, 'stat'), 'w') as f:
f.write('cpu 0 0 0 0 0 0 0 0 0 0\n')
f.write('cpu0 0 0 0 0 0 0 0 0 0 0\n')
f.write('cpu1 0 0 0 0 0 0 0 0 0 0\n')
try:
orig_open = open
def open_mock(name, *args, **kwargs):
if name.startswith('/proc'):
raise IOError(errno.ENOENT, 'rejecting access for test')
return orig_open(name, *args, **kwargs)
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
reload_module(psutil)
with pytest.raises(IOError):
psutil.cpu_times()
with pytest.raises(IOError):
psutil.cpu_times(percpu=True)
with pytest.raises(IOError):
psutil.cpu_percent()
with pytest.raises(IOError):
psutil.cpu_percent(percpu=True)
with pytest.raises(IOError):
psutil.cpu_times_percent()
with pytest.raises(IOError):
psutil.cpu_times_percent(percpu=True)
psutil.PROCFS_PATH = my_procfs
assert psutil.cpu_percent() == 0
assert sum(psutil.cpu_times_percent()) == 0
# since we don't know the number of CPUs at import time,
# we awkwardly say there are none until the second call
per_cpu_percent = psutil.cpu_percent(percpu=True)
assert sum(per_cpu_percent) == 0
# ditto awkward length
per_cpu_times_percent = psutil.cpu_times_percent(percpu=True)
assert sum(map(sum, per_cpu_times_percent)) == 0
# much user, very busy
with open(os.path.join(my_procfs, 'stat'), 'w') as f:
f.write('cpu 1 0 0 0 0 0 0 0 0 0\n')
f.write('cpu0 1 0 0 0 0 0 0 0 0 0\n')
f.write('cpu1 1 0 0 0 0 0 0 0 0 0\n')
assert psutil.cpu_percent() != 0
assert sum(psutil.cpu_percent(percpu=True)) != 0
assert sum(psutil.cpu_times_percent()) != 0
assert (
sum(map(sum, psutil.cpu_times_percent(percpu=True))) != 0
)
finally:
shutil.rmtree(my_procfs)
reload_module(psutil)
assert psutil.PROCFS_PATH == '/proc'
def test_cpu_steal_decrease(self):
# Test cumulative cpu stats decrease. We should ignore this.
# See issue #1210.
content = textwrap.dedent("""\
cpu 0 0 0 0 0 0 0 1 0 0
cpu0 0 0 0 0 0 0 0 1 0 0
cpu1 0 0 0 0 0 0 0 1 0 0
""").encode()
with mock_open_content({"/proc/stat": content}) as m:
# first call to "percent" functions should read the new stat file
# and compare to the "real" file read at import time - so the
# values are meaningless
psutil.cpu_percent()
assert m.called
psutil.cpu_percent(percpu=True)
psutil.cpu_times_percent()
psutil.cpu_times_percent(percpu=True)
content = textwrap.dedent("""\
cpu 1 0 0 0 0 0 0 0 0 0
cpu0 1 0 0 0 0 0 0 0 0 0
cpu1 1 0 0 0 0 0 0 0 0 0
""").encode()
with mock_open_content({"/proc/stat": content}):
# Increase "user" while steal goes "backwards" to zero.
cpu_percent = psutil.cpu_percent()
assert m.called
cpu_percent_percpu = psutil.cpu_percent(percpu=True)
cpu_times_percent = psutil.cpu_times_percent()
cpu_times_percent_percpu = psutil.cpu_times_percent(percpu=True)
assert cpu_percent != 0
assert sum(cpu_percent_percpu) != 0
assert sum(cpu_times_percent) != 0
assert sum(cpu_times_percent) != 100.0
assert sum(map(sum, cpu_times_percent_percpu)) != 0
assert sum(map(sum, cpu_times_percent_percpu)) != 100.0
assert cpu_times_percent.steal == 0
assert cpu_times_percent.user != 0
def test_boot_time_mocked(self):
with mock.patch('psutil._common.open', create=True) as m:
with pytest.raises(RuntimeError):
psutil._pslinux.boot_time()
assert m.called
def test_users(self):
# Make sure the C extension converts ':0' and ':0.0' to
# 'localhost'.
for user in psutil.users():
assert user.host not in (":0", ":0.0")
def test_procfs_path(self):
tdir = self.get_testfn()
os.mkdir(tdir)
try:
psutil.PROCFS_PATH = tdir
with pytest.raises(IOError):
psutil.virtual_memory()
with pytest.raises(IOError):
psutil.cpu_times()
with pytest.raises(IOError):
psutil.cpu_times(percpu=True)
with pytest.raises(IOError):
psutil.boot_time()
# self.assertRaises(IOError, psutil.pids)
with pytest.raises(IOError):
psutil.net_connections()
with pytest.raises(IOError):
psutil.net_io_counters()
with pytest.raises(IOError):
psutil.net_if_stats()
# self.assertRaises(IOError, psutil.disk_io_counters)
with pytest.raises(IOError):
psutil.disk_partitions()
with pytest.raises(psutil.NoSuchProcess):
psutil.Process()
finally:
psutil.PROCFS_PATH = "/proc"
@retry_on_failure()
@pytest.mark.skipif(PYTEST_PARALLEL, reason="skip if pytest-parallel")
def test_issue_687(self):
# In case of thread ID:
# - pid_exists() is supposed to return False
# - Process(tid) is supposed to work
# - pids() should not return the TID
# See: https://github.com/giampaolo/psutil/issues/687
with ThreadTask():
p = psutil.Process()
threads = p.threads()
assert len(threads) == (3 if QEMU_USER else 2)
tid = sorted(threads, key=lambda x: x.id)[1].id
assert p.pid != tid
pt = psutil.Process(tid)
pt.as_dict()
assert tid not in psutil.pids()
def test_pid_exists_no_proc_status(self):
# Internally pid_exists relies on /proc/{pid}/status.
# Emulate a case where this file is empty in which case
# psutil is supposed to fall back on using pids().
with mock_open_content({"/proc/%s/status": ""}) as m:
assert psutil.pid_exists(os.getpid())
assert m.called
# =====================================================================
# --- sensors
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
@pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
class TestSensorsBattery(PsutilTestCase):
@pytest.mark.skipif(not which("acpi"), reason="acpi utility not available")
def test_percent(self):
out = sh("acpi -b")
acpi_value = int(out.split(",")[1].strip().replace('%', ''))
psutil_value = psutil.sensors_battery().percent
assert abs(acpi_value - psutil_value) < 1
def test_emulate_power_plugged(self):
# Pretend the AC power cable is connected.
def open_mock(name, *args, **kwargs):
if name.endswith(('AC0/online', 'AC/online')):
return io.BytesIO(b"1")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock) as m:
assert psutil.sensors_battery().power_plugged is True
assert (
psutil.sensors_battery().secsleft
== psutil.POWER_TIME_UNLIMITED
)
assert m.called
def test_emulate_power_plugged_2(self):
# Same as above but pretend /AC0/online does not exist in which
# case code relies on /status file.
def open_mock(name, *args, **kwargs):
if name.endswith(('AC0/online', 'AC/online')):
raise IOError(errno.ENOENT, "")
elif name.endswith("/status"):
return io.StringIO(u"charging")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock) as m:
assert psutil.sensors_battery().power_plugged is True
assert m.called
def test_emulate_power_not_plugged(self):
# Pretend the AC power cable is not connected.
def open_mock(name, *args, **kwargs):
if name.endswith(('AC0/online', 'AC/online')):
return io.BytesIO(b"0")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock) as m:
assert psutil.sensors_battery().power_plugged is False
assert m.called
def test_emulate_power_not_plugged_2(self):
# Same as above but pretend /AC0/online does not exist in which
# case code relies on /status file.
def open_mock(name, *args, **kwargs):
if name.endswith(('AC0/online', 'AC/online')):
raise IOError(errno.ENOENT, "")
elif name.endswith("/status"):
return io.StringIO(u"discharging")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock) as m:
assert psutil.sensors_battery().power_plugged is False
assert m.called
def test_emulate_power_undetermined(self):
# Pretend we can't know whether the AC power cable not
# connected (assert fallback to False).
def open_mock(name, *args, **kwargs):
if name.startswith((
'/sys/class/power_supply/AC0/online',
'/sys/class/power_supply/AC/online',
)):
raise IOError(errno.ENOENT, "")
elif name.startswith("/sys/class/power_supply/BAT0/status"):
return io.BytesIO(b"???")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock) as m:
assert psutil.sensors_battery().power_plugged is None
assert m.called
def test_emulate_energy_full_0(self):
# Emulate a case where energy_full files returns 0.
with mock_open_content(
{"/sys/class/power_supply/BAT0/energy_full": b"0"}
) as m:
assert psutil.sensors_battery().percent == 0
assert m.called
def test_emulate_energy_full_not_avail(self):
# Emulate a case where energy_full file does not exist.
# Expected fallback on /capacity.
with mock_open_exception(
"/sys/class/power_supply/BAT0/energy_full",
IOError(errno.ENOENT, ""),
):
with mock_open_exception(
"/sys/class/power_supply/BAT0/charge_full",
IOError(errno.ENOENT, ""),
):
with mock_open_content(
{"/sys/class/power_supply/BAT0/capacity": b"88"}
):
assert psutil.sensors_battery().percent == 88
def test_emulate_no_power(self):
# Emulate a case where /AC0/online file nor /BAT0/status exist.
with mock_open_exception(
"/sys/class/power_supply/AC/online", IOError(errno.ENOENT, "")
):
with mock_open_exception(
"/sys/class/power_supply/AC0/online", IOError(errno.ENOENT, "")
):
with mock_open_exception(
"/sys/class/power_supply/BAT0/status",
IOError(errno.ENOENT, ""),
):
assert psutil.sensors_battery().power_plugged is None
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSensorsBatteryEmulated(PsutilTestCase):
def test_it(self):
def open_mock(name, *args, **kwargs):
if name.endswith("/energy_now"):
return io.StringIO(u"60000000")
elif name.endswith("/power_now"):
return io.StringIO(u"0")
elif name.endswith("/energy_full"):
return io.StringIO(u"60000001")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch('os.listdir', return_value=["BAT0"]) as mlistdir:
with mock.patch(patch_point, side_effect=open_mock) as mopen:
assert psutil.sensors_battery() is not None
assert mlistdir.called
assert mopen.called
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSensorsTemperatures(PsutilTestCase):
def test_emulate_class_hwmon(self):
def open_mock(name, *args, **kwargs):
if name.endswith('/name'):
return io.StringIO(u"name")
elif name.endswith('/temp1_label'):
return io.StringIO(u"label")
elif name.endswith('/temp1_input'):
return io.BytesIO(b"30000")
elif name.endswith('/temp1_max'):
return io.BytesIO(b"40000")
elif name.endswith('/temp1_crit'):
return io.BytesIO(b"50000")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
# Test case with /sys/class/hwmon
with mock.patch(
'glob.glob', return_value=['/sys/class/hwmon/hwmon0/temp1']
):
temp = psutil.sensors_temperatures()['name'][0]
assert temp.label == 'label'
assert temp.current == 30.0
assert temp.high == 40.0
assert temp.critical == 50.0
def test_emulate_class_thermal(self):
def open_mock(name, *args, **kwargs):
if name.endswith('0_temp'):
return io.BytesIO(b"50000")
elif name.endswith('temp'):
return io.BytesIO(b"30000")
elif name.endswith('0_type'):
return io.StringIO(u"critical")
elif name.endswith('type'):
return io.StringIO(u"name")
else:
return orig_open(name, *args, **kwargs)
def glob_mock(path):
if path == '/sys/class/hwmon/hwmon*/temp*_*': # noqa
return []
elif path == '/sys/class/hwmon/hwmon*/device/temp*_*':
return []
elif path == '/sys/class/thermal/thermal_zone*':
return ['/sys/class/thermal/thermal_zone0']
elif path == '/sys/class/thermal/thermal_zone0/trip_point*':
return [
'/sys/class/thermal/thermal_zone1/trip_point_0_type',
'/sys/class/thermal/thermal_zone1/trip_point_0_temp',
]
return []
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
with mock.patch('glob.glob', create=True, side_effect=glob_mock):
temp = psutil.sensors_temperatures()['name'][0]
assert temp.label == '' # noqa
assert temp.current == 30.0
assert temp.high == 50.0
assert temp.critical == 50.0
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestSensorsFans(PsutilTestCase):
def test_emulate_data(self):
def open_mock(name, *args, **kwargs):
if name.endswith('/name'):
return io.StringIO(u"name")
elif name.endswith('/fan1_label'):
return io.StringIO(u"label")
elif name.endswith('/fan1_input'):
return io.StringIO(u"2000")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock):
with mock.patch(
'glob.glob', return_value=['/sys/class/hwmon/hwmon2/fan1']
):
fan = psutil.sensors_fans()['name'][0]
assert fan.label == 'label'
assert fan.current == 2000
# =====================================================================
# --- test process
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestProcess(PsutilTestCase):
@retry_on_failure()
def test_parse_smaps_vs_memory_maps(self):
sproc = self.spawn_testproc()
uss, pss, swap = psutil._pslinux.Process(sproc.pid)._parse_smaps()
maps = psutil.Process(sproc.pid).memory_maps(grouped=False)
assert (
abs(uss - sum([x.private_dirty + x.private_clean for x in maps]))
< 4096
)
assert abs(pss - sum([x.pss for x in maps])) < 4096
assert abs(swap - sum([x.swap for x in maps])) < 4096
def test_parse_smaps_mocked(self):
# See: https://github.com/giampaolo/psutil/issues/1222
content = textwrap.dedent("""\
fffff0 r-xp 00000000 00:00 0 [vsyscall]
Size: 1 kB
Rss: 2 kB
Pss: 3 kB
Shared_Clean: 4 kB
Shared_Dirty: 5 kB
Private_Clean: 6 kB
Private_Dirty: 7 kB
Referenced: 8 kB
Anonymous: 9 kB
LazyFree: 10 kB
AnonHugePages: 11 kB
ShmemPmdMapped: 12 kB
Shared_Hugetlb: 13 kB
Private_Hugetlb: 14 kB
Swap: 15 kB
SwapPss: 16 kB
KernelPageSize: 17 kB
MMUPageSize: 18 kB
Locked: 19 kB
VmFlags: rd ex
""").encode()
with mock_open_content({"/proc/%s/smaps" % os.getpid(): content}) as m:
p = psutil._pslinux.Process(os.getpid())
uss, pss, swap = p._parse_smaps()
assert m.called
assert uss == (6 + 7 + 14) * 1024
assert pss == 3 * 1024
assert swap == 15 * 1024
# On PYPY file descriptors are not closed fast enough.
@pytest.mark.skipif(PYPY, reason="unreliable on PYPY")
def test_open_files_mode(self):
def get_test_file(fname):
p = psutil.Process()
giveup_at = time.time() + GLOBAL_TIMEOUT
while True:
for file in p.open_files():
if file.path == os.path.abspath(fname):
return file
elif time.time() > giveup_at:
break
raise RuntimeError("timeout looking for test file")
testfn = self.get_testfn()
with open(testfn, "w"):
assert get_test_file(testfn).mode == "w"
with open(testfn):
assert get_test_file(testfn).mode == "r"
with open(testfn, "a"):
assert get_test_file(testfn).mode == "a"
with open(testfn, "r+"):
assert get_test_file(testfn).mode == "r+"
with open(testfn, "w+"):
assert get_test_file(testfn).mode == "r+"
with open(testfn, "a+"):
assert get_test_file(testfn).mode == "a+"
# note: "x" bit is not supported
if PY3:
safe_rmpath(testfn)
with open(testfn, "x"):
assert get_test_file(testfn).mode == "w"
safe_rmpath(testfn)
with open(testfn, "x+"):
assert get_test_file(testfn).mode == "r+"
def test_open_files_file_gone(self):
# simulates a file which gets deleted during open_files()
# execution
p = psutil.Process()
files = p.open_files()
with open(self.get_testfn(), 'w'):
# give the kernel some time to see the new file
call_until(lambda: len(p.open_files()) != len(files))
with mock.patch(
'psutil._pslinux.os.readlink',
side_effect=OSError(errno.ENOENT, ""),
) as m:
assert p.open_files() == []
assert m.called
# also simulate the case where os.readlink() returns EINVAL
# in which case psutil is supposed to 'continue'
with mock.patch(
'psutil._pslinux.os.readlink',
side_effect=OSError(errno.EINVAL, ""),
) as m:
assert p.open_files() == []
assert m.called
def test_open_files_fd_gone(self):
# Simulate a case where /proc/{pid}/fdinfo/{fd} disappears
# while iterating through fds.
# https://travis-ci.org/giampaolo/psutil/jobs/225694530
p = psutil.Process()
files = p.open_files()
with open(self.get_testfn(), 'w'):
# give the kernel some time to see the new file
call_until(lambda: len(p.open_files()) != len(files))
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(
patch_point, side_effect=IOError(errno.ENOENT, "")
) as m:
assert p.open_files() == []
assert m.called
def test_open_files_enametoolong(self):
# Simulate a case where /proc/{pid}/fd/{fd} symlink
# points to a file with full path longer than PATH_MAX, see:
# https://github.com/giampaolo/psutil/issues/1940
p = psutil.Process()
files = p.open_files()
with open(self.get_testfn(), 'w'):
# give the kernel some time to see the new file
call_until(lambda: len(p.open_files()) != len(files))
patch_point = 'psutil._pslinux.os.readlink'
with mock.patch(
patch_point, side_effect=OSError(errno.ENAMETOOLONG, "")
) as m:
with mock.patch("psutil._pslinux.debug"):
assert p.open_files() == []
assert m.called
# --- mocked tests
def test_terminal_mocked(self):
with mock.patch(
'psutil._pslinux._psposix.get_terminal_map', return_value={}
) as m:
assert psutil._pslinux.Process(os.getpid()).terminal() is None
assert m.called
# TODO: re-enable this test.
# def test_num_ctx_switches_mocked(self):
# with mock.patch('psutil._common.open', create=True) as m:
# self.assertRaises(
# NotImplementedError,
# psutil._pslinux.Process(os.getpid()).num_ctx_switches)
# assert m.called
def test_cmdline_mocked(self):
# see: https://github.com/giampaolo/psutil/issues/639
p = psutil.Process()
fake_file = io.StringIO(u'foo\x00bar\x00')
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert p.cmdline() == ['foo', 'bar']
assert m.called
fake_file = io.StringIO(u'foo\x00bar\x00\x00')
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert p.cmdline() == ['foo', 'bar', '']
assert m.called
def test_cmdline_spaces_mocked(self):
# see: https://github.com/giampaolo/psutil/issues/1179
p = psutil.Process()
fake_file = io.StringIO(u'foo bar ')
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert p.cmdline() == ['foo', 'bar']
assert m.called
fake_file = io.StringIO(u'foo bar ')
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert p.cmdline() == ['foo', 'bar', '']
assert m.called
def test_cmdline_mixed_separators(self):
# https://github.com/giampaolo/psutil/issues/
# 1179#issuecomment-552984549
p = psutil.Process()
fake_file = io.StringIO(u'foo\x20bar\x00')
with mock.patch(
'psutil._common.open', return_value=fake_file, create=True
) as m:
assert p.cmdline() == ['foo', 'bar']
assert m.called
def test_readlink_path_deleted_mocked(self):
with mock.patch(
'psutil._pslinux.os.readlink', return_value='/home/foo (deleted)'
):
assert psutil.Process().exe() == "/home/foo"
assert psutil.Process().cwd() == "/home/foo"
def test_threads_mocked(self):
# Test the case where os.listdir() returns a file (thread)
# which no longer exists by the time we open() it (race
# condition). threads() is supposed to ignore that instead
# of raising NSP.
def open_mock_1(name, *args, **kwargs):
if name.startswith('/proc/%s/task' % os.getpid()):
raise IOError(errno.ENOENT, "")
else:
return orig_open(name, *args, **kwargs)
orig_open = open
patch_point = 'builtins.open' if PY3 else '__builtin__.open'
with mock.patch(patch_point, side_effect=open_mock_1) as m:
ret = psutil.Process().threads()
assert m.called
assert ret == []
# ...but if it bumps into something != ENOENT we want an
# exception.
def open_mock_2(name, *args, **kwargs):
if name.startswith('/proc/%s/task' % os.getpid()):
raise IOError(errno.EPERM, "")
else:
return orig_open(name, *args, **kwargs)
with mock.patch(patch_point, side_effect=open_mock_2):
with pytest.raises(psutil.AccessDenied):
psutil.Process().threads()
def test_exe_mocked(self):
with mock.patch(
'psutil._pslinux.readlink', side_effect=OSError(errno.ENOENT, "")
) as m:
# de-activate guessing from cmdline()
with mock.patch(
'psutil._pslinux.Process.cmdline', return_value=[]
):
ret = psutil.Process().exe()
assert m.called
assert ret == "" # noqa
def test_issue_1014(self):
# Emulates a case where smaps file does not exist. In this case
# wrap_exception decorator should not raise NoSuchProcess.
with mock_open_exception(
'/proc/%s/smaps' % os.getpid(), IOError(errno.ENOENT, "")
) as m:
p = psutil.Process()
with pytest.raises(FileNotFoundError):
p.memory_maps()
assert m.called
@pytest.mark.skipif(not HAS_RLIMIT, reason="not supported")
def test_rlimit_zombie(self):
# Emulate a case where rlimit() raises ENOSYS, which may
# happen in case of zombie process:
# https://travis-ci.org/giampaolo/psutil/jobs/51368273
with mock.patch(
"psutil._pslinux.prlimit", side_effect=OSError(errno.ENOSYS, "")
) as m1:
with mock.patch(
"psutil._pslinux.Process._is_zombie", return_value=True
) as m2:
p = psutil.Process()
p.name()
with pytest.raises(psutil.ZombieProcess) as cm:
p.rlimit(psutil.RLIMIT_NOFILE)
assert m1.called
assert m2.called
assert cm.value.pid == p.pid
assert cm.value.name == p.name()
def test_stat_file_parsing(self):
args = [
"0", # pid
"(cat)", # name
"Z", # status
"1", # ppid
"0", # pgrp
"0", # session
"0", # tty
"0", # tpgid
"0", # flags
"0", # minflt
"0", # cminflt
"0", # majflt
"0", # cmajflt
"2", # utime
"3", # stime
"4", # cutime
"5", # cstime
"0", # priority
"0", # nice
"0", # num_threads
"0", # itrealvalue
"6", # starttime
"0", # vsize
"0", # rss
"0", # rsslim
"0", # startcode
"0", # endcode
"0", # startstack
"0", # kstkesp
"0", # kstkeip
"0", # signal
"0", # blocked
"0", # sigignore
"0", # sigcatch
"0", # wchan
"0", # nswap
"0", # cnswap
"0", # exit_signal
"6", # processor
"0", # rt priority
"0", # policy
"7", # delayacct_blkio_ticks
]
content = " ".join(args).encode()
with mock_open_content({"/proc/%s/stat" % os.getpid(): content}):
p = psutil.Process()
assert p.name() == 'cat'
assert p.status() == psutil.STATUS_ZOMBIE
assert p.ppid() == 1
assert p.create_time() == 6 / CLOCK_TICKS + psutil.boot_time()
cpu = p.cpu_times()
assert cpu.user == 2 / CLOCK_TICKS
assert cpu.system == 3 / CLOCK_TICKS
assert cpu.children_user == 4 / CLOCK_TICKS
assert cpu.children_system == 5 / CLOCK_TICKS
assert cpu.iowait == 7 / CLOCK_TICKS
assert p.cpu_num() == 6
def test_status_file_parsing(self):
content = textwrap.dedent("""\
Uid:\t1000\t1001\t1002\t1003
Gid:\t1004\t1005\t1006\t1007
Threads:\t66
Cpus_allowed:\tf
Cpus_allowed_list:\t0-7
voluntary_ctxt_switches:\t12
nonvoluntary_ctxt_switches:\t13""").encode()
with mock_open_content({"/proc/%s/status" % os.getpid(): content}):
p = psutil.Process()
assert p.num_ctx_switches().voluntary == 12
assert p.num_ctx_switches().involuntary == 13
assert p.num_threads() == 66
uids = p.uids()
assert uids.real == 1000
assert uids.effective == 1001
assert uids.saved == 1002
gids = p.gids()
assert gids.real == 1004
assert gids.effective == 1005
assert gids.saved == 1006
assert p._proc._get_eligible_cpus() == list(range(8))
def test_net_connections_enametoolong(self):
# Simulate a case where /proc/{pid}/fd/{fd} symlink points to
# a file with full path longer than PATH_MAX, see:
# https://github.com/giampaolo/psutil/issues/1940
with mock.patch(
'psutil._pslinux.os.readlink',
side_effect=OSError(errno.ENAMETOOLONG, ""),
) as m:
p = psutil.Process()
with mock.patch("psutil._pslinux.debug"):
assert p.net_connections() == []
assert m.called
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestProcessAgainstStatus(PsutilTestCase):
"""/proc/pid/stat and /proc/pid/status have many values in common.
Whenever possible, psutil uses /proc/pid/stat (it's faster).
For all those cases we check that the value found in
/proc/pid/stat (by psutil) matches the one found in
/proc/pid/status.
"""
@classmethod
def setUpClass(cls):
cls.proc = psutil.Process()
def read_status_file(self, linestart):
with psutil._psplatform.open_text(
'/proc/%s/status' % self.proc.pid
) as f:
for line in f:
line = line.strip()
if line.startswith(linestart):
value = line.partition('\t')[2]
try:
return int(value)
except ValueError:
return value
raise ValueError("can't find %r" % linestart)
def test_name(self):
value = self.read_status_file("Name:")
assert self.proc.name() == value
@pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
def test_status(self):
value = self.read_status_file("State:")
value = value[value.find('(') + 1 : value.rfind(')')]
value = value.replace(' ', '-')
assert self.proc.status() == value
def test_ppid(self):
value = self.read_status_file("PPid:")
assert self.proc.ppid() == value
def test_num_threads(self):
value = self.read_status_file("Threads:")
assert self.proc.num_threads() == value
def test_uids(self):
value = self.read_status_file("Uid:")
value = tuple(map(int, value.split()[1:4]))
assert self.proc.uids() == value
def test_gids(self):
value = self.read_status_file("Gid:")
value = tuple(map(int, value.split()[1:4]))
assert self.proc.gids() == value
@retry_on_failure()
def test_num_ctx_switches(self):
value = self.read_status_file("voluntary_ctxt_switches:")
assert self.proc.num_ctx_switches().voluntary == value
value = self.read_status_file("nonvoluntary_ctxt_switches:")
assert self.proc.num_ctx_switches().involuntary == value
def test_cpu_affinity(self):
value = self.read_status_file("Cpus_allowed_list:")
if '-' in str(value):
min_, max_ = map(int, value.split('-'))
assert self.proc.cpu_affinity() == list(range(min_, max_ + 1))
def test_cpu_affinity_eligible_cpus(self):
value = self.read_status_file("Cpus_allowed_list:")
with mock.patch("psutil._pslinux.per_cpu_times") as m:
self.proc._proc._get_eligible_cpus()
if '-' in str(value):
assert not m.called
else:
assert m.called
# =====================================================================
# --- test utils
# =====================================================================
@pytest.mark.skipif(not LINUX, reason="LINUX only")
class TestUtils(PsutilTestCase):
def test_readlink(self):
with mock.patch("os.readlink", return_value="foo (deleted)") as m:
assert psutil._psplatform.readlink("bar") == "foo"
assert m.called
PK ok\�u�� � psutil/tests/test_sunos.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Sun OS specific tests."""
import os
import psutil
from psutil import SUNOS
from psutil.tests import PsutilTestCase
from psutil.tests import pytest
from psutil.tests import sh
@pytest.mark.skipif(not SUNOS, reason="SUNOS only")
class SunOSSpecificTestCase(PsutilTestCase):
def test_swap_memory(self):
out = sh('env PATH=/usr/sbin:/sbin:%s swap -l' % os.environ['PATH'])
lines = out.strip().split('\n')[1:]
if not lines:
raise ValueError('no swap device(s) configured')
total = free = 0
for line in lines:
fields = line.split()
total = int(fields[3]) * 512
free = int(fields[4]) * 512
used = total - free
psutil_swap = psutil.swap_memory()
assert psutil_swap.total == total
assert psutil_swap.used == used
assert psutil_swap.free == free
def test_cpu_count(self):
out = sh("/usr/sbin/psrinfo")
assert psutil.cpu_count() == len(out.split('\n'))
PK ok\0�� D D psutil/tests/test_posix.pynu �[��� #!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""POSIX specific tests."""
import datetime
import errno
import os
import re
import subprocess
import time
import psutil
from psutil import AIX
from psutil import BSD
from psutil import LINUX
from psutil import MACOS
from psutil import OPENBSD
from psutil import POSIX
from psutil import SUNOS
from psutil.tests import AARCH64
from psutil.tests import HAS_NET_IO_COUNTERS
from psutil.tests import PYTHON_EXE
from psutil.tests import QEMU_USER
from psutil.tests import PsutilTestCase
from psutil.tests import mock
from psutil.tests import pytest
from psutil.tests import retry_on_failure
from psutil.tests import sh
from psutil.tests import skip_on_access_denied
from psutil.tests import spawn_testproc
from psutil.tests import terminate
from psutil.tests import which
if POSIX:
import mmap
import resource
from psutil._psutil_posix import getpagesize
def ps(fmt, pid=None):
"""Wrapper for calling the ps command with a little bit of cross-platform
support for a narrow range of features.
"""
cmd = ['ps']
if LINUX:
cmd.append('--no-headers')
if pid is not None:
cmd.extend(['-p', str(pid)])
else:
if SUNOS or AIX:
cmd.append('-A')
else:
cmd.append('ax')
if SUNOS:
fmt = fmt.replace("start", "stime")
cmd.extend(['-o', fmt])
output = sh(cmd)
output = output.splitlines() if LINUX else output.splitlines()[1:]
all_output = []
for line in output:
line = line.strip()
try:
line = int(line)
except ValueError:
pass
all_output.append(line)
if pid is None:
return all_output
else:
return all_output[0]
# ps "-o" field names differ wildly between platforms.
# "comm" means "only executable name" but is not available on BSD platforms.
# "args" means "command with all its arguments", and is also not available
# on BSD platforms.
# "command" is like "args" on most platforms, but like "comm" on AIX,
# and not available on SUNOS.
# so for the executable name we can use "comm" on Solaris and split "command"
# on other platforms.
# to get the cmdline (with args) we have to use "args" on AIX and
# Solaris, and can use "command" on all others.
def ps_name(pid):
field = "command"
if SUNOS:
field = "comm"
command = ps(field, pid).split()
if QEMU_USER:
assert "/bin/qemu-" in command[0]
return command[1]
return command[0]
def ps_args(pid):
field = "command"
if AIX or SUNOS:
field = "args"
out = ps(field, pid)
# observed on BSD + Github CI: '/usr/local/bin/python3 -E -O (python3.9)'
out = re.sub(r"\(python.*?\)$", "", out)
return out.strip()
def ps_rss(pid):
field = "rss"
if AIX:
field = "rssize"
return ps(field, pid)
def ps_vsz(pid):
field = "vsz"
if AIX:
field = "vsize"
return ps(field, pid)
def df(device):
try:
out = sh("df -k %s" % device).strip()
except RuntimeError as err:
if "device busy" in str(err).lower():
raise pytest.skip("df returned EBUSY")
raise
line = out.split('\n')[1]
fields = line.split()
sys_total = int(fields[1]) * 1024
sys_used = int(fields[2]) * 1024
sys_free = int(fields[3]) * 1024
sys_percent = float(fields[4].replace('%', ''))
return (sys_total, sys_used, sys_free, sys_percent)
@pytest.mark.skipif(not POSIX, reason="POSIX only")
class TestProcess(PsutilTestCase):
"""Compare psutil results against 'ps' command line utility (mainly)."""
@classmethod
def setUpClass(cls):
cls.pid = spawn_testproc(
[PYTHON_EXE, "-E", "-O"], stdin=subprocess.PIPE
).pid
@classmethod
def tearDownClass(cls):
terminate(cls.pid)
def test_ppid(self):
ppid_ps = ps('ppid', self.pid)
ppid_psutil = psutil.Process(self.pid).ppid()
assert ppid_ps == ppid_psutil
def test_uid(self):
uid_ps = ps('uid', self.pid)
uid_psutil = psutil.Process(self.pid).uids().real
assert uid_ps == uid_psutil
def test_gid(self):
gid_ps = ps('rgid', self.pid)
gid_psutil = psutil.Process(self.pid).gids().real
assert gid_ps == gid_psutil
def test_username(self):
username_ps = ps('user', self.pid)
username_psutil = psutil.Process(self.pid).username()
assert username_ps == username_psutil
def test_username_no_resolution(self):
# Emulate a case where the system can't resolve the uid to
# a username in which case psutil is supposed to return
# the stringified uid.
p = psutil.Process()
with mock.patch("psutil.pwd.getpwuid", side_effect=KeyError) as fun:
assert p.username() == str(p.uids().real)
assert fun.called
@skip_on_access_denied()
@retry_on_failure()
def test_rss_memory(self):
# give python interpreter some time to properly initialize
# so that the results are the same
time.sleep(0.1)
rss_ps = ps_rss(self.pid)
rss_psutil = psutil.Process(self.pid).memory_info()[0] / 1024
assert rss_ps == rss_psutil
@skip_on_access_denied()
@retry_on_failure()
def test_vsz_memory(self):
# give python interpreter some time to properly initialize
# so that the results are the same
time.sleep(0.1)
vsz_ps = ps_vsz(self.pid)
vsz_psutil = psutil.Process(self.pid).memory_info()[1] / 1024
assert vsz_ps == vsz_psutil
def test_name(self):
name_ps = ps_name(self.pid)
# remove path if there is any, from the command
name_ps = os.path.basename(name_ps).lower()
name_psutil = psutil.Process(self.pid).name().lower()
# ...because of how we calculate PYTHON_EXE; on MACOS this may
# be "pythonX.Y".
name_ps = re.sub(r"\d.\d", "", name_ps)
name_psutil = re.sub(r"\d.\d", "", name_psutil)
# ...may also be "python.X"
name_ps = re.sub(r"\d", "", name_ps)
name_psutil = re.sub(r"\d", "", name_psutil)
assert name_ps == name_psutil
def test_name_long(self):
# On UNIX the kernel truncates the name to the first 15
# characters. In such a case psutil tries to determine the
# full name from the cmdline.
name = "long-program-name"
cmdline = ["long-program-name-extended", "foo", "bar"]
with mock.patch("psutil._psplatform.Process.name", return_value=name):
with mock.patch(
"psutil._psplatform.Process.cmdline", return_value=cmdline
):
p = psutil.Process()
assert p.name() == "long-program-name-extended"
def test_name_long_cmdline_ad_exc(self):
# Same as above but emulates a case where cmdline() raises
# AccessDenied in which case psutil is supposed to return
# the truncated name instead of crashing.
name = "long-program-name"
with mock.patch("psutil._psplatform.Process.name", return_value=name):
with mock.patch(
"psutil._psplatform.Process.cmdline",
side_effect=psutil.AccessDenied(0, ""),
):
p = psutil.Process()
assert p.name() == "long-program-name"
def test_name_long_cmdline_nsp_exc(self):
# Same as above but emulates a case where cmdline() raises NSP
# which is supposed to propagate.
name = "long-program-name"
with mock.patch("psutil._psplatform.Process.name", return_value=name):
with mock.patch(
"psutil._psplatform.Process.cmdline",
side_effect=psutil.NoSuchProcess(0, ""),
):
p = psutil.Process()
with pytest.raises(psutil.NoSuchProcess):
p.name()
@pytest.mark.skipif(MACOS or BSD, reason="ps -o start not available")
def test_create_time(self):
time_ps = ps('start', self.pid)
time_psutil = psutil.Process(self.pid).create_time()
time_psutil_tstamp = datetime.datetime.fromtimestamp(
time_psutil
).strftime("%H:%M:%S")
# sometimes ps shows the time rounded up instead of down, so we check
# for both possible values
round_time_psutil = round(time_psutil)
round_time_psutil_tstamp = datetime.datetime.fromtimestamp(
round_time_psutil
).strftime("%H:%M:%S")
assert time_ps in [time_psutil_tstamp, round_time_psutil_tstamp]
def test_exe(self):
ps_pathname = ps_name(self.pid)
psutil_pathname = psutil.Process(self.pid).exe()
try:
assert ps_pathname == psutil_pathname
except AssertionError:
# certain platforms such as BSD are more accurate returning:
# "/usr/local/bin/python2.7"
# ...instead of:
# "/usr/local/bin/python"
# We do not want to consider this difference in accuracy
# an error.
adjusted_ps_pathname = ps_pathname[: len(ps_pathname)]
assert ps_pathname == adjusted_ps_pathname
# On macOS the official python installer exposes a python wrapper that
# executes a python executable hidden inside an application bundle inside
# the Python framework.
# There's a race condition between the ps call & the psutil call below
# depending on the completion of the execve call so let's retry on failure
@retry_on_failure()
def test_cmdline(self):
ps_cmdline = ps_args(self.pid)
psutil_cmdline = " ".join(psutil.Process(self.pid).cmdline())
if AARCH64 and len(ps_cmdline) < len(psutil_cmdline):
assert psutil_cmdline.startswith(ps_cmdline)
else:
assert ps_cmdline == psutil_cmdline
# On SUNOS "ps" reads niceness /proc/pid/psinfo which returns an
# incorrect value (20); the real deal is getpriority(2) which
# returns 0; psutil relies on it, see:
# https://github.com/giampaolo/psutil/issues/1082
# AIX has the same issue
@pytest.mark.skipif(SUNOS, reason="not reliable on SUNOS")
@pytest.mark.skipif(AIX, reason="not reliable on AIX")
def test_nice(self):
ps_nice = ps('nice', self.pid)
psutil_nice = psutil.Process().nice()
assert ps_nice == psutil_nice
@pytest.mark.skipif(not POSIX, reason="POSIX only")
class TestSystemAPIs(PsutilTestCase):
"""Test some system APIs."""
@retry_on_failure()
def test_pids(self):
# Note: this test might fail if the OS is starting/killing
# other processes in the meantime
pids_ps = sorted(ps("pid"))
pids_psutil = psutil.pids()
# on MACOS and OPENBSD ps doesn't show pid 0
if MACOS or (OPENBSD and 0 not in pids_ps):
pids_ps.insert(0, 0)
# There will often be one more process in pids_ps for ps itself
if len(pids_ps) - len(pids_psutil) > 1:
difference = [x for x in pids_psutil if x not in pids_ps] + [
x for x in pids_ps if x not in pids_psutil
]
raise self.fail("difference: " + str(difference))
# for some reason ifconfig -a does not report all interfaces
# returned by psutil
@pytest.mark.skipif(SUNOS, reason="unreliable on SUNOS")
@pytest.mark.skipif(not which('ifconfig'), reason="no ifconfig cmd")
@pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
def test_nic_names(self):
output = sh("ifconfig -a")
for nic in psutil.net_io_counters(pernic=True):
for line in output.split():
if line.startswith(nic):
break
else:
raise self.fail(
"couldn't find %s nic in 'ifconfig -a' output\n%s"
% (nic, output)
)
# @pytest.mark.skipif(CI_TESTING and not psutil.users(),
# reason="unreliable on CI")
@retry_on_failure()
def test_users(self):
out = sh("who -u")
if not out.strip():
raise pytest.skip("no users on this system")
lines = out.split('\n')
users = [x.split()[0] for x in lines]
terminals = [x.split()[1] for x in lines]
assert len(users) == len(psutil.users())
with self.subTest(psutil=psutil.users(), who=out):
for idx, u in enumerate(psutil.users()):
assert u.name == users[idx]
assert u.terminal == terminals[idx]
if u.pid is not None: # None on OpenBSD
psutil.Process(u.pid)
@retry_on_failure()
def test_users_started(self):
out = sh("who -u")
if not out.strip():
raise pytest.skip("no users on this system")
tstamp = None
# '2023-04-11 09:31' (Linux)
started = re.findall(r"\d\d\d\d-\d\d-\d\d \d\d:\d\d", out)
if started:
tstamp = "%Y-%m-%d %H:%M"
else:
# 'Apr 10 22:27' (macOS)
started = re.findall(r"[A-Z][a-z][a-z] \d\d \d\d:\d\d", out)
if started:
tstamp = "%b %d %H:%M"
else:
# 'Apr 10'
started = re.findall(r"[A-Z][a-z][a-z] \d\d", out)
if started:
tstamp = "%b %d"
else:
# 'apr 10' (sunOS)
started = re.findall(r"[a-z][a-z][a-z] \d\d", out)
if started:
tstamp = "%b %d"
started = [x.capitalize() for x in started]
if not tstamp:
raise pytest.skip(
"cannot interpret tstamp in who output\n%s" % (out)
)
with self.subTest(psutil=psutil.users(), who=out):
for idx, u in enumerate(psutil.users()):
psutil_value = datetime.datetime.fromtimestamp(
u.started
).strftime(tstamp)
assert psutil_value == started[idx]
def test_pid_exists_let_raise(self):
# According to "man 2 kill" possible error values for kill
# are (EINVAL, EPERM, ESRCH). Test that any other errno
# results in an exception.
with mock.patch(
"psutil._psposix.os.kill", side_effect=OSError(errno.EBADF, "")
) as m:
with pytest.raises(OSError):
psutil._psposix.pid_exists(os.getpid())
assert m.called
def test_os_waitpid_let_raise(self):
# os.waitpid() is supposed to catch EINTR and ECHILD only.
# Test that any other errno results in an exception.
with mock.patch(
"psutil._psposix.os.waitpid", side_effect=OSError(errno.EBADF, "")
) as m:
with pytest.raises(OSError):
psutil._psposix.wait_pid(os.getpid())
assert m.called
def test_os_waitpid_eintr(self):
# os.waitpid() is supposed to "retry" on EINTR.
with mock.patch(
"psutil._psposix.os.waitpid", side_effect=OSError(errno.EINTR, "")
) as m:
with pytest.raises(psutil._psposix.TimeoutExpired):
psutil._psposix.wait_pid(os.getpid(), timeout=0.01)
assert m.called
def test_os_waitpid_bad_ret_status(self):
# Simulate os.waitpid() returning a bad status.
with mock.patch(
"psutil._psposix.os.waitpid", return_value=(1, -1)
) as m:
with pytest.raises(ValueError):
psutil._psposix.wait_pid(os.getpid())
assert m.called
# AIX can return '-' in df output instead of numbers, e.g. for /proc
@pytest.mark.skipif(AIX, reason="unreliable on AIX")
@retry_on_failure()
def test_disk_usage(self):
tolerance = 4 * 1024 * 1024 # 4MB
for part in psutil.disk_partitions(all=False):
usage = psutil.disk_usage(part.mountpoint)
try:
sys_total, sys_used, sys_free, sys_percent = df(part.device)
except RuntimeError as err:
# see:
# https://travis-ci.org/giampaolo/psutil/jobs/138338464
# https://travis-ci.org/giampaolo/psutil/jobs/138343361
err = str(err).lower()
if (
"no such file or directory" in err
or "raw devices not supported" in err
or "permission denied" in err
):
continue
raise
else:
assert abs(usage.total - sys_total) < tolerance
assert abs(usage.used - sys_used) < tolerance
assert abs(usage.free - sys_free) < tolerance
assert abs(usage.percent - sys_percent) <= 1
@pytest.mark.skipif(not POSIX, reason="POSIX only")
class TestMisc(PsutilTestCase):
def test_getpagesize(self):
pagesize = getpagesize()
assert pagesize > 0
assert pagesize == resource.getpagesize()
assert pagesize == mmap.PAGESIZE
PK ok\���� � psutil/tests/test_aix.pynu �[��� #!/usr/bin/env python3
# Copyright (c) 2009, Giampaolo Rodola'
# Copyright (c) 2017, Arnon Yaari
# All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""AIX specific tests."""
import re
import psutil
from psutil import AIX
from psutil.tests import PsutilTestCase
from psutil.tests import pytest
from psutil.tests import sh
@pytest.mark.skipif(not AIX, reason="AIX only")
class AIXSpecificTestCase(PsutilTestCase):
def test_virtual_memory(self):
out = sh('/usr/bin/svmon -O unit=KB')
re_pattern = r"memory\s*"
for field in ("size inuse free pin virtual available mmode").split():
re_pattern += r"(?P<%s>\S+)\s+" % (field,)
matchobj = re.search(re_pattern, out)
assert matchobj is not None
KB = 1024
total = int(matchobj.group("size")) * KB
available = int(matchobj.group("available")) * KB
used = int(matchobj.group("inuse")) * KB
free = int(matchobj.group("free")) * KB
psutil_result = psutil.virtual_memory()
# TOLERANCE_SYS_MEM from psutil.tests is not enough. For some reason
# we're seeing differences of ~1.2 MB. 2 MB is still a good tolerance
# when compared to GBs.
TOLERANCE_SYS_MEM = 2 * KB * KB # 2 MB
assert psutil_result.total == total
assert abs(psutil_result.used - used) < TOLERANCE_SYS_MEM
assert abs(psutil_result.available - available) < TOLERANCE_SYS_MEM
assert abs(psutil_result.free - free) < TOLERANCE_SYS_MEM
def test_swap_memory(self):
out = sh('/usr/sbin/lsps -a')
# From the man page, "The size is given in megabytes" so we assume
# we'll always have 'MB' in the result
# TODO maybe try to use "swap -l" to check "used" too, but its units
# are not guaranteed to be "MB" so parsing may not be consistent
matchobj = re.search(
r"(?P<space>\S+)\s+"
r"(?P<vol>\S+)\s+"
r"(?P<vg>\S+)\s+"
r"(?P<size>\d+)MB",
out,
)
assert matchobj is not None
total_mb = int(matchobj.group("size"))
MB = 1024**2
psutil_result = psutil.swap_memory()
# we divide our result by MB instead of multiplying the lsps value by
# MB because lsps may round down, so we round down too
assert int(psutil_result.total / MB) == total_mb
def test_cpu_stats(self):
out = sh('/usr/bin/mpstat -a')
re_pattern = r"ALL\s*"
for field in (
"min maj mpcs mpcr dev soft dec ph cs ics bound rq "
"push S3pull S3grd S0rd S1rd S2rd S3rd S4rd S5rd "
"sysc"
).split():
re_pattern += r"(?P<%s>\S+)\s+" % (field,)
matchobj = re.search(re_pattern, out)
assert matchobj is not None
# numbers are usually in the millions so 1000 is ok for tolerance
CPU_STATS_TOLERANCE = 1000
psutil_result = psutil.cpu_stats()
assert (
abs(psutil_result.ctx_switches - int(matchobj.group("cs")))
< CPU_STATS_TOLERANCE
)
assert (
abs(psutil_result.syscalls - int(matchobj.group("sysc")))
< CPU_STATS_TOLERANCE
)
assert (
abs(psutil_result.interrupts - int(matchobj.group("dev")))
< CPU_STATS_TOLERANCE
)
assert (
abs(psutil_result.soft_interrupts - int(matchobj.group("soft")))
< CPU_STATS_TOLERANCE
)
def test_cpu_count_logical(self):
out = sh('/usr/bin/mpstat -a')
mpstat_lcpu = int(re.search(r"lcpu=(\d+)", out).group(1))
psutil_lcpu = psutil.cpu_count(logical=True)
assert mpstat_lcpu == psutil_lcpu
def test_net_if_addrs_names(self):
out = sh('/etc/ifconfig -l')
ifconfig_names = set(out.split())
psutil_names = set(psutil.net_if_addrs().keys())
assert ifconfig_names == psutil_names
PK ok\�$�B\ B\ psutil/__init__.pynu �[��� # -*- coding: utf-8 -*-
# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""psutil is a cross-platform library for retrieving information on
running processes and system utilization (CPU, memory, disks, network,
sensors) in Python. Supported platforms:
- Linux
- Windows
- macOS
- FreeBSD
- OpenBSD
- NetBSD
- Sun Solaris
- AIX
Works with Python versions 2.7 and 3.6+.
"""
from __future__ import division
import collections
import contextlib
import datetime
import functools
import os
import signal
import subprocess
import sys
import threading
import time
try:
import pwd
except ImportError:
pwd = None
from . import _common
from ._common import AIX
from ._common import BSD
from ._common import CONN_CLOSE
from ._common import CONN_CLOSE_WAIT
from ._common import CONN_CLOSING
from ._common import CONN_ESTABLISHED
from ._common import CONN_FIN_WAIT1
from ._common import CONN_FIN_WAIT2
from ._common import CONN_LAST_ACK
from ._common import CONN_LISTEN
from ._common import CONN_NONE
from ._common import CONN_SYN_RECV
from ._common import CONN_SYN_SENT
from ._common import CONN_TIME_WAIT
from ._common import FREEBSD # NOQA
from ._common import LINUX
from ._common import MACOS
from ._common import NETBSD # NOQA
from ._common import NIC_DUPLEX_FULL
from ._common import NIC_DUPLEX_HALF
from ._common import NIC_DUPLEX_UNKNOWN
from ._common import OPENBSD # NOQA
from ._common import OSX # deprecated alias
from ._common import POSIX # NOQA
from ._common import POWER_TIME_UNKNOWN
from ._common import POWER_TIME_UNLIMITED
from ._common import STATUS_DEAD
from ._common import STATUS_DISK_SLEEP
from ._common import STATUS_IDLE
from ._common import STATUS_LOCKED
from ._common import STATUS_PARKED
from ._common import STATUS_RUNNING
from ._common import STATUS_SLEEPING
from ._common import STATUS_STOPPED
from ._common import STATUS_TRACING_STOP
from ._common import STATUS_WAITING
from ._common import STATUS_WAKING
from ._common import STATUS_ZOMBIE
from ._common import SUNOS
from ._common import WINDOWS
from ._common import AccessDenied
from ._common import Error
from ._common import NoSuchProcess
from ._common import TimeoutExpired
from ._common import ZombieProcess
from ._common import debug
from ._common import memoize_when_activated
from ._common import wrap_numbers as _wrap_numbers
from ._compat import PY3 as _PY3
from ._compat import PermissionError
from ._compat import ProcessLookupError
from ._compat import SubprocessTimeoutExpired as _SubprocessTimeoutExpired
from ._compat import long
if LINUX:
# This is public API and it will be retrieved from _pslinux.py
# via sys.modules.
PROCFS_PATH = "/proc"
from . import _pslinux as _psplatform
from ._pslinux import IOPRIO_CLASS_BE # NOQA
from ._pslinux import IOPRIO_CLASS_IDLE # NOQA
from ._pslinux import IOPRIO_CLASS_NONE # NOQA
from ._pslinux import IOPRIO_CLASS_RT # NOQA
elif WINDOWS:
from . import _pswindows as _psplatform
from ._psutil_windows import ABOVE_NORMAL_PRIORITY_CLASS # NOQA
from ._psutil_windows import BELOW_NORMAL_PRIORITY_CLASS # NOQA
from ._psutil_windows import HIGH_PRIORITY_CLASS # NOQA
from ._psutil_windows import IDLE_PRIORITY_CLASS # NOQA
from ._psutil_windows import NORMAL_PRIORITY_CLASS # NOQA
from ._psutil_windows import REALTIME_PRIORITY_CLASS # NOQA
from ._pswindows import CONN_DELETE_TCB # NOQA
from ._pswindows import IOPRIO_HIGH # NOQA
from ._pswindows import IOPRIO_LOW # NOQA
from ._pswindows import IOPRIO_NORMAL # NOQA
from ._pswindows import IOPRIO_VERYLOW # NOQA
elif MACOS:
from . import _psosx as _psplatform
elif BSD:
from . import _psbsd as _psplatform
elif SUNOS:
from . import _pssunos as _psplatform
from ._pssunos import CONN_BOUND # NOQA
from ._pssunos import CONN_IDLE # NOQA
# This is public writable API which is read from _pslinux.py and
# _pssunos.py via sys.modules.
PROCFS_PATH = "/proc"
elif AIX:
from . import _psaix as _psplatform
# This is public API and it will be retrieved from _pslinux.py
# via sys.modules.
PROCFS_PATH = "/proc"
else: # pragma: no cover
raise NotImplementedError('platform %s is not supported' % sys.platform)
# fmt: off
__all__ = [
# exceptions
"Error", "NoSuchProcess", "ZombieProcess", "AccessDenied",
"TimeoutExpired",
# constants
"version_info", "__version__",
"STATUS_RUNNING", "STATUS_IDLE", "STATUS_SLEEPING", "STATUS_DISK_SLEEP",
"STATUS_STOPPED", "STATUS_TRACING_STOP", "STATUS_ZOMBIE", "STATUS_DEAD",
"STATUS_WAKING", "STATUS_LOCKED", "STATUS_WAITING", "STATUS_LOCKED",
"STATUS_PARKED",
"CONN_ESTABLISHED", "CONN_SYN_SENT", "CONN_SYN_RECV", "CONN_FIN_WAIT1",
"CONN_FIN_WAIT2", "CONN_TIME_WAIT", "CONN_CLOSE", "CONN_CLOSE_WAIT",
"CONN_LAST_ACK", "CONN_LISTEN", "CONN_CLOSING", "CONN_NONE",
# "CONN_IDLE", "CONN_BOUND",
"AF_LINK",
"NIC_DUPLEX_FULL", "NIC_DUPLEX_HALF", "NIC_DUPLEX_UNKNOWN",
"POWER_TIME_UNKNOWN", "POWER_TIME_UNLIMITED",
"BSD", "FREEBSD", "LINUX", "NETBSD", "OPENBSD", "MACOS", "OSX", "POSIX",
"SUNOS", "WINDOWS", "AIX",
# "RLIM_INFINITY", "RLIMIT_AS", "RLIMIT_CORE", "RLIMIT_CPU", "RLIMIT_DATA",
# "RLIMIT_FSIZE", "RLIMIT_LOCKS", "RLIMIT_MEMLOCK", "RLIMIT_NOFILE",
# "RLIMIT_NPROC", "RLIMIT_RSS", "RLIMIT_STACK", "RLIMIT_MSGQUEUE",
# "RLIMIT_NICE", "RLIMIT_RTPRIO", "RLIMIT_RTTIME", "RLIMIT_SIGPENDING",
# classes
"Process", "Popen",
# functions
"pid_exists", "pids", "process_iter", "wait_procs", # proc
"virtual_memory", "swap_memory", # memory
"cpu_times", "cpu_percent", "cpu_times_percent", "cpu_count", # cpu
"cpu_stats", # "cpu_freq", "getloadavg"
"net_io_counters", "net_connections", "net_if_addrs", # network
"net_if_stats",
"disk_io_counters", "disk_partitions", "disk_usage", # disk
# "sensors_temperatures", "sensors_battery", "sensors_fans" # sensors
"users", "boot_time", # others
]
# fmt: on
__all__.extend(_psplatform.__extra__all__)
# Linux, FreeBSD
if hasattr(_psplatform.Process, "rlimit"):
# Populate global namespace with RLIM* constants.
from . import _psutil_posix
_globals = globals()
_name = None
for _name in dir(_psutil_posix):
if _name.startswith('RLIM') and _name.isupper():
_globals[_name] = getattr(_psutil_posix, _name)
__all__.append(_name)
del _globals, _name
AF_LINK = _psplatform.AF_LINK
__author__ = "Giampaolo Rodola'"
__version__ = "6.1.0"
version_info = tuple([int(num) for num in __version__.split('.')])
_timer = getattr(time, 'monotonic', time.time)
_TOTAL_PHYMEM = None
_LOWEST_PID = None
_SENTINEL = object()
# Sanity check in case the user messed up with psutil installation
# or did something weird with sys.path. In this case we might end
# up importing a python module using a C extension module which
# was compiled for a different version of psutil.
# We want to prevent that by failing sooner rather than later.
# See: https://github.com/giampaolo/psutil/issues/564
if int(__version__.replace('.', '')) != getattr(
_psplatform.cext, 'version', None
):
msg = "version conflict: %r C extension " % _psplatform.cext.__file__
msg += "module was built for another version of psutil"
if hasattr(_psplatform.cext, 'version'):
msg += " (%s instead of %s)" % (
'.'.join([x for x in str(_psplatform.cext.version)]),
__version__,
)
else:
msg += " (different than %s)" % __version__
msg += "; you may try to 'pip uninstall psutil', manually remove %s" % (
getattr(
_psplatform.cext,
"__file__",
"the existing psutil install directory",
)
)
msg += " or clean the virtual env somehow, then reinstall"
raise ImportError(msg)
# =====================================================================
# --- Utils
# =====================================================================
if hasattr(_psplatform, 'ppid_map'):
# Faster version (Windows and Linux).
_ppid_map = _psplatform.ppid_map
else: # pragma: no cover
def _ppid_map():
"""Return a {pid: ppid, ...} dict for all running processes in
one shot. Used to speed up Process.children().
"""
ret = {}
for pid in pids():
try:
ret[pid] = _psplatform.Process(pid).ppid()
except (NoSuchProcess, ZombieProcess):
pass
return ret
def _pprint_secs(secs):
"""Format seconds in a human readable form."""
now = time.time()
secs_ago = int(now - secs)
fmt = "%H:%M:%S" if secs_ago < 60 * 60 * 24 else "%Y-%m-%d %H:%M:%S"
return datetime.datetime.fromtimestamp(secs).strftime(fmt)
# =====================================================================
# --- Process class
# =====================================================================
class Process(object): # noqa: UP004
"""Represents an OS process with the given PID.
If PID is omitted current process PID (os.getpid()) is used.
Raise NoSuchProcess if PID does not exist.
Note that most of the methods of this class do not make sure that
the PID of the process being queried has been reused. That means
that you may end up retrieving information for another process.
The only exceptions for which process identity is pre-emptively
checked and guaranteed are:
- parent()
- children()
- nice() (set)
- ionice() (set)
- rlimit() (set)
- cpu_affinity (set)
- suspend()
- resume()
- send_signal()
- terminate()
- kill()
To prevent this problem for all other methods you can use
is_running() before querying the process.
"""
def __init__(self, pid=None):
self._init(pid)
def _init(self, pid, _ignore_nsp=False):
if pid is None:
pid = os.getpid()
else:
if not _PY3 and not isinstance(pid, (int, long)):
msg = "pid must be an integer (got %r)" % pid
raise TypeError(msg)
if pid < 0:
msg = "pid must be a positive integer (got %s)" % pid
raise ValueError(msg)
try:
_psplatform.cext.check_pid_range(pid)
except OverflowError:
msg = "process PID out of range (got %s)" % pid
raise NoSuchProcess(pid, msg=msg)
self._pid = pid
self._name = None
self._exe = None
self._create_time = None
self._gone = False
self._pid_reused = False
self._hash = None
self._lock = threading.RLock()
# used for caching on Windows only (on POSIX ppid may change)
self._ppid = None
# platform-specific modules define an _psplatform.Process
# implementation class
self._proc = _psplatform.Process(pid)
self._last_sys_cpu_times = None
self._last_proc_cpu_times = None
self._exitcode = _SENTINEL
self._ident = (self.pid, None)
try:
self._ident = self._get_ident()
except AccessDenied:
# This should happen on Windows only, since we use the fast
# create time method. AFAIK, on all other platforms we are
# able to get create time for all PIDs.
pass
except ZombieProcess:
# Zombies can still be queried by this class (although
# not always) and pids() return them so just go on.
pass
except NoSuchProcess:
if not _ignore_nsp:
msg = "process PID not found"
raise NoSuchProcess(pid, msg=msg)
else:
self._gone = True
def _get_ident(self):
"""Return a (pid, uid) tuple which is supposed to identify a
Process instance univocally over time. The PID alone is not
enough, as it can be assigned to a new process after this one
terminates, so we add process creation time to the mix. We need
this in order to prevent killing the wrong process later on.
This is also known as PID reuse or PID recycling problem.
The reliability of this strategy mostly depends on
create_time() precision, which is 0.01 secs on Linux. The
assumption is that, after a process terminates, the kernel
won't reuse the same PID after such a short period of time
(0.01 secs). Technically this is inherently racy, but
practically it should be good enough.
"""
if WINDOWS:
# Use create_time() fast method in order to speedup
# `process_iter()`. This means we'll get AccessDenied for
# most ADMIN processes, but that's fine since it means
# we'll also get AccessDenied on kill().
# https://github.com/giampaolo/psutil/issues/2366#issuecomment-2381646555
self._create_time = self._proc.create_time(fast_only=True)
return (self.pid, self._create_time)
else:
return (self.pid, self.create_time())
def __str__(self):
info = collections.OrderedDict()
info["pid"] = self.pid
if self._name:
info['name'] = self._name
with self.oneshot():
if self._pid_reused:
info["status"] = "terminated + PID reused"
else:
try:
info["name"] = self.name()
info["status"] = self.status()
except ZombieProcess:
info["status"] = "zombie"
except NoSuchProcess:
info["status"] = "terminated"
except AccessDenied:
pass
if self._exitcode not in (_SENTINEL, None):
info["exitcode"] = self._exitcode
if self._create_time is not None:
info['started'] = _pprint_secs(self._create_time)
return "%s.%s(%s)" % (
self.__class__.__module__,
self.__class__.__name__,
", ".join(["%s=%r" % (k, v) for k, v in info.items()]),
)
__repr__ = __str__
def __eq__(self, other):
# Test for equality with another Process object based
# on PID and creation time.
if not isinstance(other, Process):
return NotImplemented
if OPENBSD or NETBSD: # pragma: no cover
# Zombie processes on Open/NetBSD have a creation time of
# 0.0. This covers the case when a process started normally
# (so it has a ctime), then it turned into a zombie. It's
# important to do this because is_running() depends on
# __eq__.
pid1, ident1 = self._ident
pid2, ident2 = other._ident
if pid1 == pid2:
if ident1 and not ident2:
try:
return self.status() == STATUS_ZOMBIE
except Error:
pass
return self._ident == other._ident
def __ne__(self, other):
return not self == other
def __hash__(self):
if self._hash is None:
self._hash = hash(self._ident)
return self._hash
def _raise_if_pid_reused(self):
"""Raises NoSuchProcess in case process PID has been reused."""
if self._pid_reused or (not self.is_running() and self._pid_reused):
# We may directly raise NSP in here already if PID is just
# not running, but I prefer NSP to be raised naturally by
# the actual Process API call. This way unit tests will tell
# us if the API is broken (aka don't raise NSP when it
# should). We also remain consistent with all other "get"
# APIs which don't use _raise_if_pid_reused().
msg = "process no longer exists and its PID has been reused"
raise NoSuchProcess(self.pid, self._name, msg=msg)
@property
def pid(self):
"""The process PID."""
return self._pid
# --- utility methods
@contextlib.contextmanager
def oneshot(self):
"""Utility context manager which considerably speeds up the
retrieval of multiple process information at the same time.
Internally different process info (e.g. name, ppid, uids,
gids, ...) may be fetched by using the same routine, but
only one information is returned and the others are discarded.
When using this context manager the internal routine is
executed once (in the example below on name()) and the
other info are cached.
The cache is cleared when exiting the context manager block.
The advice is to use this every time you retrieve more than
one information about the process. If you're lucky, you'll
get a hell of a speedup.
>>> import psutil
>>> p = psutil.Process()
>>> with p.oneshot():
... p.name() # collect multiple info
... p.cpu_times() # return cached value
... p.cpu_percent() # return cached value
... p.create_time() # return cached value
...
>>>
"""
with self._lock:
if hasattr(self, "_cache"):
# NOOP: this covers the use case where the user enters the
# context twice:
#
# >>> with p.oneshot():
# ... with p.oneshot():
# ...
#
# Also, since as_dict() internally uses oneshot()
# I expect that the code below will be a pretty common
# "mistake" that the user will make, so let's guard
# against that:
#
# >>> with p.oneshot():
# ... p.as_dict()
# ...
yield
else:
try:
# cached in case cpu_percent() is used
self.cpu_times.cache_activate(self)
# cached in case memory_percent() is used
self.memory_info.cache_activate(self)
# cached in case parent() is used
self.ppid.cache_activate(self)
# cached in case username() is used
if POSIX:
self.uids.cache_activate(self)
# specific implementation cache
self._proc.oneshot_enter()
yield
finally:
self.cpu_times.cache_deactivate(self)
self.memory_info.cache_deactivate(self)
self.ppid.cache_deactivate(self)
if POSIX:
self.uids.cache_deactivate(self)
self._proc.oneshot_exit()
def as_dict(self, attrs=None, ad_value=None):
"""Utility method returning process information as a
hashable dictionary.
If *attrs* is specified it must be a list of strings
reflecting available Process class' attribute names
(e.g. ['cpu_times', 'name']) else all public (read
only) attributes are assumed.
*ad_value* is the value which gets assigned in case
AccessDenied or ZombieProcess exception is raised when
retrieving that particular process information.
"""
valid_names = _as_dict_attrnames
if attrs is not None:
if not isinstance(attrs, (list, tuple, set, frozenset)):
msg = "invalid attrs type %s" % type(attrs)
raise TypeError(msg)
attrs = set(attrs)
invalid_names = attrs - valid_names
if invalid_names:
msg = "invalid attr name%s %s" % (
"s" if len(invalid_names) > 1 else "",
", ".join(map(repr, invalid_names)),
)
raise ValueError(msg)
retdict = {}
ls = attrs or valid_names
with self.oneshot():
for name in ls:
try:
if name == 'pid':
ret = self.pid
else:
meth = getattr(self, name)
ret = meth()
except (AccessDenied, ZombieProcess):
ret = ad_value
except NotImplementedError:
# in case of not implemented functionality (may happen
# on old or exotic systems) we want to crash only if
# the user explicitly asked for that particular attr
if attrs:
raise
continue
retdict[name] = ret
return retdict
def parent(self):
"""Return the parent process as a Process object pre-emptively
checking whether PID has been reused.
If no parent is known return None.
"""
lowest_pid = _LOWEST_PID if _LOWEST_PID is not None else pids()[0]
if self.pid == lowest_pid:
return None
ppid = self.ppid()
if ppid is not None:
ctime = self.create_time()
try:
parent = Process(ppid)
if parent.create_time() <= ctime:
return parent
# ...else ppid has been reused by another process
except NoSuchProcess:
pass
def parents(self):
"""Return the parents of this process as a list of Process
instances. If no parents are known return an empty list.
"""
parents = []
proc = self.parent()
while proc is not None:
parents.append(proc)
proc = proc.parent()
return parents
def is_running(self):
"""Return whether this process is running.
It also checks if PID has been reused by another process, in
which case it will remove the process from `process_iter()`
internal cache and return False.
"""
if self._gone or self._pid_reused:
return False
try:
# Checking if PID is alive is not enough as the PID might
# have been reused by another process. Process identity /
# uniqueness over time is guaranteed by (PID + creation
# time) and that is verified in __eq__.
self._pid_reused = self != Process(self.pid)
if self._pid_reused:
_pids_reused.add(self.pid)
raise NoSuchProcess(self.pid)
return True
except ZombieProcess:
# We should never get here as it's already handled in
# Process.__init__; here just for extra safety.
return True
except NoSuchProcess:
self._gone = True
return False
# --- actual API
@memoize_when_activated
def ppid(self):
"""The process parent PID.
On Windows the return value is cached after first call.
"""
# On POSIX we don't want to cache the ppid as it may unexpectedly
# change to 1 (init) in case this process turns into a zombie:
# https://github.com/giampaolo/psutil/issues/321
# http://stackoverflow.com/questions/356722/
# XXX should we check creation time here rather than in
# Process.parent()?
self._raise_if_pid_reused()
if POSIX:
return self._proc.ppid()
else: # pragma: no cover
self._ppid = self._ppid or self._proc.ppid()
return self._ppid
def name(self):
"""The process name. The return value is cached after first call."""
# Process name is only cached on Windows as on POSIX it may
# change, see:
# https://github.com/giampaolo/psutil/issues/692
if WINDOWS and self._name is not None:
return self._name
name = self._proc.name()
if POSIX and len(name) >= 15:
# On UNIX the name gets truncated to the first 15 characters.
# If it matches the first part of the cmdline we return that
# one instead because it's usually more explicative.
# Examples are "gnome-keyring-d" vs. "gnome-keyring-daemon".
try:
cmdline = self.cmdline()
except (AccessDenied, ZombieProcess):
# Just pass and return the truncated name: it's better
# than nothing. Note: there are actual cases where a
# zombie process can return a name() but not a
# cmdline(), see:
# https://github.com/giampaolo/psutil/issues/2239
pass
else:
if cmdline:
extended_name = os.path.basename(cmdline[0])
if extended_name.startswith(name):
name = extended_name
self._name = name
self._proc._name = name
return name
def exe(self):
"""The process executable as an absolute path.
May also be an empty string.
The return value is cached after first call.
"""
def guess_it(fallback):
# try to guess exe from cmdline[0] in absence of a native
# exe representation
cmdline = self.cmdline()
if cmdline and hasattr(os, 'access') and hasattr(os, 'X_OK'):
exe = cmdline[0] # the possible exe
# Attempt to guess only in case of an absolute path.
# It is not safe otherwise as the process might have
# changed cwd.
if (
os.path.isabs(exe)
and os.path.isfile(exe)
and os.access(exe, os.X_OK)
):
return exe
if isinstance(fallback, AccessDenied):
raise fallback
return fallback
if self._exe is None:
try:
exe = self._proc.exe()
except AccessDenied as err:
return guess_it(fallback=err)
else:
if not exe:
# underlying implementation can legitimately return an
# empty string; if that's the case we don't want to
# raise AD while guessing from the cmdline
try:
exe = guess_it(fallback=exe)
except AccessDenied:
pass
self._exe = exe
return self._exe
def cmdline(self):
"""The command line this process has been called with."""
return self._proc.cmdline()
def status(self):
"""The process current status as a STATUS_* constant."""
try:
return self._proc.status()
except ZombieProcess:
return STATUS_ZOMBIE
def username(self):
"""The name of the user that owns the process.
On UNIX this is calculated by using *real* process uid.
"""
if POSIX:
if pwd is None:
# might happen if python was installed from sources
msg = "requires pwd module shipped with standard python"
raise ImportError(msg)
real_uid = self.uids().real
try:
return pwd.getpwuid(real_uid).pw_name
except KeyError:
# the uid can't be resolved by the system
return str(real_uid)
else:
return self._proc.username()
def create_time(self):
"""The process creation time as a floating point number
expressed in seconds since the epoch.
The return value is cached after first call.
"""
if self._create_time is None:
self._create_time = self._proc.create_time()
return self._create_time
def cwd(self):
"""Process current working directory as an absolute path."""
return self._proc.cwd()
def nice(self, value=None):
"""Get or set process niceness (priority)."""
if value is None:
return self._proc.nice_get()
else:
self._raise_if_pid_reused()
self._proc.nice_set(value)
if POSIX:
@memoize_when_activated
def uids(self):
"""Return process UIDs as a (real, effective, saved)
namedtuple.
"""
return self._proc.uids()
def gids(self):
"""Return process GIDs as a (real, effective, saved)
namedtuple.
"""
return self._proc.gids()
def terminal(self):
"""The terminal associated with this process, if any,
else None.
"""
return self._proc.terminal()
def num_fds(self):
"""Return the number of file descriptors opened by this
process (POSIX only).
"""
return self._proc.num_fds()
# Linux, BSD, AIX and Windows only
if hasattr(_psplatform.Process, "io_counters"):
def io_counters(self):
"""Return process I/O statistics as a
(read_count, write_count, read_bytes, write_bytes)
namedtuple.
Those are the number of read/write calls performed and the
amount of bytes read and written by the process.
"""
return self._proc.io_counters()
# Linux and Windows
if hasattr(_psplatform.Process, "ionice_get"):
def ionice(self, ioclass=None, value=None):
"""Get or set process I/O niceness (priority).
On Linux *ioclass* is one of the IOPRIO_CLASS_* constants.
*value* is a number which goes from 0 to 7. The higher the
value, the lower the I/O priority of the process.
On Windows only *ioclass* is used and it can be set to 2
(normal), 1 (low) or 0 (very low).
Available on Linux and Windows > Vista only.
"""
if ioclass is None:
if value is not None:
msg = "'ioclass' argument must be specified"
raise ValueError(msg)
return self._proc.ionice_get()
else:
self._raise_if_pid_reused()
return self._proc.ionice_set(ioclass, value)
# Linux / FreeBSD only
if hasattr(_psplatform.Process, "rlimit"):
def rlimit(self, resource, limits=None):
"""Get or set process resource limits as a (soft, hard)
tuple.
*resource* is one of the RLIMIT_* constants.
*limits* is supposed to be a (soft, hard) tuple.
See "man prlimit" for further info.
Available on Linux and FreeBSD only.
"""
if limits is not None:
self._raise_if_pid_reused()
return self._proc.rlimit(resource, limits)
# Windows, Linux and FreeBSD only
if hasattr(_psplatform.Process, "cpu_affinity_get"):
def cpu_affinity(self, cpus=None):
"""Get or set process CPU affinity.
If specified, *cpus* must be a list of CPUs for which you
want to set the affinity (e.g. [0, 1]).
If an empty list is passed, all egible CPUs are assumed
(and set).
(Windows, Linux and BSD only).
"""
if cpus is None:
return sorted(set(self._proc.cpu_affinity_get()))
else:
self._raise_if_pid_reused()
if not cpus:
if hasattr(self._proc, "_get_eligible_cpus"):
cpus = self._proc._get_eligible_cpus()
else:
cpus = tuple(range(len(cpu_times(percpu=True))))
self._proc.cpu_affinity_set(list(set(cpus)))
# Linux, FreeBSD, SunOS
if hasattr(_psplatform.Process, "cpu_num"):
def cpu_num(self):
"""Return what CPU this process is currently running on.
The returned number should be <= psutil.cpu_count()
and <= len(psutil.cpu_percent(percpu=True)).
It may be used in conjunction with
psutil.cpu_percent(percpu=True) to observe the system
workload distributed across CPUs.
"""
return self._proc.cpu_num()
# All platforms has it, but maybe not in the future.
if hasattr(_psplatform.Process, "environ"):
def environ(self):
"""The environment variables of the process as a dict. Note: this
might not reflect changes made after the process started.
"""
return self._proc.environ()
if WINDOWS:
def num_handles(self):
"""Return the number of handles opened by this process
(Windows only).
"""
return self._proc.num_handles()
def num_ctx_switches(self):
"""Return the number of voluntary and involuntary context
switches performed by this process.
"""
return self._proc.num_ctx_switches()
def num_threads(self):
"""Return the number of threads used by this process."""
return self._proc.num_threads()
if hasattr(_psplatform.Process, "threads"):
def threads(self):
"""Return threads opened by process as a list of
(id, user_time, system_time) namedtuples representing
thread id and thread CPU times (user/system).
On OpenBSD this method requires root access.
"""
return self._proc.threads()
def children(self, recursive=False):
"""Return the children of this process as a list of Process
instances, pre-emptively checking whether PID has been reused.
If *recursive* is True return all the parent descendants.
Example (A == this process):
A ─┐
│
├─ B (child) ─┐
│ └─ X (grandchild) ─┐
│ └─ Y (great grandchild)
├─ C (child)
└─ D (child)
>>> import psutil
>>> p = psutil.Process()
>>> p.children()
B, C, D
>>> p.children(recursive=True)
B, X, Y, C, D
Note that in the example above if process X disappears
process Y won't be listed as the reference to process A
is lost.
"""
self._raise_if_pid_reused()
ppid_map = _ppid_map()
ret = []
if not recursive:
for pid, ppid in ppid_map.items():
if ppid == self.pid:
try:
child = Process(pid)
# if child happens to be older than its parent
# (self) it means child's PID has been reused
if self.create_time() <= child.create_time():
ret.append(child)
except (NoSuchProcess, ZombieProcess):
pass
else:
# Construct a {pid: [child pids]} dict
reverse_ppid_map = collections.defaultdict(list)
for pid, ppid in ppid_map.items():
reverse_ppid_map[ppid].append(pid)
# Recursively traverse that dict, starting from self.pid,
# such that we only call Process() on actual children
seen = set()
stack = [self.pid]
while stack:
pid = stack.pop()
if pid in seen:
# Since pids can be reused while the ppid_map is
# constructed, there may be rare instances where
# there's a cycle in the recorded process "tree".
continue
seen.add(pid)
for child_pid in reverse_ppid_map[pid]:
try:
child = Process(child_pid)
# if child happens to be older than its parent
# (self) it means child's PID has been reused
intime = self.create_time() <= child.create_time()
if intime:
ret.append(child)
stack.append(child_pid)
except (NoSuchProcess, ZombieProcess):
pass
return ret
def cpu_percent(self, interval=None):
"""Return a float representing the current process CPU
utilization as a percentage.
When *interval* is 0.0 or None (default) compares process times
to system CPU times elapsed since last call, returning
immediately (non-blocking). That means that the first time
this is called it will return a meaningful 0.0 value.
When *interval* is > 0.0 compares process times to system CPU
times elapsed before and after the interval (blocking).
In this case is recommended for accuracy that this function
be called with at least 0.1 seconds between calls.
A value > 100.0 can be returned in case of processes running
multiple threads on different CPU cores.
The returned value is explicitly NOT split evenly between
all available logical CPUs. This means that a busy loop process
running on a system with 2 logical CPUs will be reported as
having 100% CPU utilization instead of 50%.
Examples:
>>> import psutil
>>> p = psutil.Process(os.getpid())
>>> # blocking
>>> p.cpu_percent(interval=1)
2.0
>>> # non-blocking (percentage since last call)
>>> p.cpu_percent(interval=None)
2.9
>>>
"""
blocking = interval is not None and interval > 0.0
if interval is not None and interval < 0:
msg = "interval is not positive (got %r)" % interval
raise ValueError(msg)
num_cpus = cpu_count() or 1
def timer():
return _timer() * num_cpus
if blocking:
st1 = timer()
pt1 = self._proc.cpu_times()
time.sleep(interval)
st2 = timer()
pt2 = self._proc.cpu_times()
else:
st1 = self._last_sys_cpu_times
pt1 = self._last_proc_cpu_times
st2 = timer()
pt2 = self._proc.cpu_times()
if st1 is None or pt1 is None:
self._last_sys_cpu_times = st2
self._last_proc_cpu_times = pt2
return 0.0
delta_proc = (pt2.user - pt1.user) + (pt2.system - pt1.system)
delta_time = st2 - st1
# reset values for next call in case of interval == None
self._last_sys_cpu_times = st2
self._last_proc_cpu_times = pt2
try:
# This is the utilization split evenly between all CPUs.
# E.g. a busy loop process on a 2-CPU-cores system at this
# point is reported as 50% instead of 100%.
overall_cpus_percent = (delta_proc / delta_time) * 100
except ZeroDivisionError:
# interval was too low
return 0.0
else:
# Note 1:
# in order to emulate "top" we multiply the value for the num
# of CPU cores. This way the busy process will be reported as
# having 100% (or more) usage.
#
# Note 2:
# taskmgr.exe on Windows differs in that it will show 50%
# instead.
#
# Note 3:
# a percentage > 100 is legitimate as it can result from a
# process with multiple threads running on different CPU
# cores (top does the same), see:
# http://stackoverflow.com/questions/1032357
# https://github.com/giampaolo/psutil/issues/474
single_cpu_percent = overall_cpus_percent * num_cpus
return round(single_cpu_percent, 1)
@memoize_when_activated
def cpu_times(self):
"""Return a (user, system, children_user, children_system)
namedtuple representing the accumulated process time, in
seconds.
This is similar to os.times() but per-process.
On macOS and Windows children_user and children_system are
always set to 0.
"""
return self._proc.cpu_times()
@memoize_when_activated
def memory_info(self):
"""Return a namedtuple with variable fields depending on the
platform, representing memory information about the process.
The "portable" fields available on all platforms are `rss` and `vms`.
All numbers are expressed in bytes.
"""
return self._proc.memory_info()
@_common.deprecated_method(replacement="memory_info")
def memory_info_ex(self):
return self.memory_info()
def memory_full_info(self):
"""This method returns the same information as memory_info(),
plus, on some platform (Linux, macOS, Windows), also provides
additional metrics (USS, PSS and swap).
The additional metrics provide a better representation of actual
process memory usage.
Namely USS is the memory which is unique to a process and which
would be freed if the process was terminated right now.
It does so by passing through the whole process address.
As such it usually requires higher user privileges than
memory_info() and is considerably slower.
"""
return self._proc.memory_full_info()
def memory_percent(self, memtype="rss"):
"""Compare process memory to total physical system memory and
calculate process memory utilization as a percentage.
*memtype* argument is a string that dictates what type of
process memory you want to compare against (defaults to "rss").
The list of available strings can be obtained like this:
>>> psutil.Process().memory_info()._fields
('rss', 'vms', 'shared', 'text', 'lib', 'data', 'dirty', 'uss', 'pss')
"""
valid_types = list(_psplatform.pfullmem._fields)
if memtype not in valid_types:
msg = "invalid memtype %r; valid types are %r" % (
memtype,
tuple(valid_types),
)
raise ValueError(msg)
fun = (
self.memory_info
if memtype in _psplatform.pmem._fields
else self.memory_full_info
)
metrics = fun()
value = getattr(metrics, memtype)
# use cached value if available
total_phymem = _TOTAL_PHYMEM or virtual_memory().total
if not total_phymem > 0:
# we should never get here
msg = (
"can't calculate process memory percent because total physical"
" system memory is not positive (%r)" % (total_phymem)
)
raise ValueError(msg)
return (value / float(total_phymem)) * 100
if hasattr(_psplatform.Process, "memory_maps"):
def memory_maps(self, grouped=True):
"""Return process' mapped memory regions as a list of namedtuples
whose fields are variable depending on the platform.
If *grouped* is True the mapped regions with the same 'path'
are grouped together and the different memory fields are summed.
If *grouped* is False every mapped region is shown as a single
entity and the namedtuple will also include the mapped region's
address space ('addr') and permission set ('perms').
"""
it = self._proc.memory_maps()
if grouped:
d = {}
for tupl in it:
path = tupl[2]
nums = tupl[3:]
try:
d[path] = map(lambda x, y: x + y, d[path], nums)
except KeyError:
d[path] = nums
nt = _psplatform.pmmap_grouped
return [nt(path, *d[path]) for path in d] # NOQA
else:
nt = _psplatform.pmmap_ext
return [nt(*x) for x in it]
def open_files(self):
"""Return files opened by process as a list of
(path, fd) namedtuples including the absolute file name
and file descriptor number.
"""
return self._proc.open_files()
def net_connections(self, kind='inet'):
"""Return socket connections opened by process as a list of
(fd, family, type, laddr, raddr, status) namedtuples.
The *kind* parameter filters for connections that match the
following criteria:
+------------+----------------------------------------------------+
| Kind Value | Connections using |
+------------+----------------------------------------------------+
| inet | IPv4 and IPv6 |
| inet4 | IPv4 |
| inet6 | IPv6 |
| tcp | TCP |
| tcp4 | TCP over IPv4 |
| tcp6 | TCP over IPv6 |
| udp | UDP |
| udp4 | UDP over IPv4 |
| udp6 | UDP over IPv6 |
| unix | UNIX socket (both UDP and TCP protocols) |
| all | the sum of all the possible families and protocols |
+------------+----------------------------------------------------+
"""
return self._proc.net_connections(kind)
@_common.deprecated_method(replacement="net_connections")
def connections(self, kind="inet"):
return self.net_connections(kind=kind)
# --- signals
if POSIX:
def _send_signal(self, sig):
assert not self.pid < 0, self.pid
self._raise_if_pid_reused()
if self.pid == 0:
# see "man 2 kill"
msg = (
"preventing sending signal to process with PID 0 as it "
"would affect every process in the process group of the "
"calling process (os.getpid()) instead of PID 0"
)
raise ValueError(msg)
try:
os.kill(self.pid, sig)
except ProcessLookupError:
if OPENBSD and pid_exists(self.pid):
# We do this because os.kill() lies in case of
# zombie processes.
raise ZombieProcess(self.pid, self._name, self._ppid)
else:
self._gone = True
raise NoSuchProcess(self.pid, self._name)
except PermissionError:
raise AccessDenied(self.pid, self._name)
def send_signal(self, sig):
"""Send a signal *sig* to process pre-emptively checking
whether PID has been reused (see signal module constants) .
On Windows only SIGTERM is valid and is treated as an alias
for kill().
"""
if POSIX:
self._send_signal(sig)
else: # pragma: no cover
self._raise_if_pid_reused()
if sig != signal.SIGTERM and not self.is_running():
msg = "process no longer exists"
raise NoSuchProcess(self.pid, self._name, msg=msg)
self._proc.send_signal(sig)
def suspend(self):
"""Suspend process execution with SIGSTOP pre-emptively checking
whether PID has been reused.
On Windows this has the effect of suspending all process threads.
"""
if POSIX:
self._send_signal(signal.SIGSTOP)
else: # pragma: no cover
self._raise_if_pid_reused()
self._proc.suspend()
def resume(self):
"""Resume process execution with SIGCONT pre-emptively checking
whether PID has been reused.
On Windows this has the effect of resuming all process threads.
"""
if POSIX:
self._send_signal(signal.SIGCONT)
else: # pragma: no cover
self._raise_if_pid_reused()
self._proc.resume()
def terminate(self):
"""Terminate the process with SIGTERM pre-emptively checking
whether PID has been reused.
On Windows this is an alias for kill().
"""
if POSIX:
self._send_signal(signal.SIGTERM)
else: # pragma: no cover
self._raise_if_pid_reused()
self._proc.kill()
def kill(self):
"""Kill the current process with SIGKILL pre-emptively checking
whether PID has been reused.
"""
if POSIX:
self._send_signal(signal.SIGKILL)
else: # pragma: no cover
self._raise_if_pid_reused()
self._proc.kill()
def wait(self, timeout=None):
"""Wait for process to terminate and, if process is a children
of os.getpid(), also return its exit code, else None.
On Windows there's no such limitation (exit code is always
returned).
If the process is already terminated immediately return None
instead of raising NoSuchProcess.
If *timeout* (in seconds) is specified and process is still
alive raise TimeoutExpired.
To wait for multiple Process(es) use psutil.wait_procs().
"""
if timeout is not None and not timeout >= 0:
msg = "timeout must be a positive integer"
raise ValueError(msg)
if self._exitcode is not _SENTINEL:
return self._exitcode
self._exitcode = self._proc.wait(timeout)
return self._exitcode
# The valid attr names which can be processed by Process.as_dict().
# fmt: off
_as_dict_attrnames = set(
[x for x in dir(Process) if not x.startswith('_') and x not in
{'send_signal', 'suspend', 'resume', 'terminate', 'kill', 'wait',
'is_running', 'as_dict', 'parent', 'parents', 'children', 'rlimit',
'memory_info_ex', 'connections', 'oneshot'}])
# fmt: on
# =====================================================================
# --- Popen class
# =====================================================================
class Popen(Process):
"""Same as subprocess.Popen, but in addition it provides all
psutil.Process methods in a single class.
For the following methods which are common to both classes, psutil
implementation takes precedence:
* send_signal()
* terminate()
* kill()
This is done in order to avoid killing another process in case its
PID has been reused, fixing BPO-6973.
>>> import psutil
>>> from subprocess import PIPE
>>> p = psutil.Popen(["python", "-c", "print 'hi'"], stdout=PIPE)
>>> p.name()
'python'
>>> p.uids()
user(real=1000, effective=1000, saved=1000)
>>> p.username()
'giampaolo'
>>> p.communicate()
('hi', None)
>>> p.terminate()
>>> p.wait(timeout=2)
0
>>>
"""
def __init__(self, *args, **kwargs):
# Explicitly avoid to raise NoSuchProcess in case the process
# spawned by subprocess.Popen terminates too quickly, see:
# https://github.com/giampaolo/psutil/issues/193
self.__subproc = subprocess.Popen(*args, **kwargs)
self._init(self.__subproc.pid, _ignore_nsp=True)
def __dir__(self):
return sorted(set(dir(Popen) + dir(subprocess.Popen)))
def __enter__(self):
if hasattr(self.__subproc, '__enter__'):
self.__subproc.__enter__()
return self
def __exit__(self, *args, **kwargs):
if hasattr(self.__subproc, '__exit__'):
return self.__subproc.__exit__(*args, **kwargs)
else:
if self.stdout:
self.stdout.close()
if self.stderr:
self.stderr.close()
try:
# Flushing a BufferedWriter may raise an error.
if self.stdin:
self.stdin.close()
finally:
# Wait for the process to terminate, to avoid zombies.
self.wait()
def __getattribute__(self, name):
try:
return object.__getattribute__(self, name)
except AttributeError:
try:
return object.__getattribute__(self.__subproc, name)
except AttributeError:
msg = "%s instance has no attribute '%s'" % (
self.__class__.__name__,
name,
)
raise AttributeError(msg)
def wait(self, timeout=None):
if self.__subproc.returncode is not None:
return self.__subproc.returncode
ret = super(Popen, self).wait(timeout) # noqa
self.__subproc.returncode = ret
return ret
# =====================================================================
# --- system processes related functions
# =====================================================================
def pids():
"""Return a list of current running PIDs."""
global _LOWEST_PID
ret = sorted(_psplatform.pids())
_LOWEST_PID = ret[0]
return ret
def pid_exists(pid):
"""Return True if given PID exists in the current process list.
This is faster than doing "pid in psutil.pids()" and
should be preferred.
"""
if pid < 0:
return False
elif pid == 0 and POSIX:
# On POSIX we use os.kill() to determine PID existence.
# According to "man 2 kill" PID 0 has a special meaning
# though: it refers to <<every process in the process
# group of the calling process>> and that is not we want
# to do here.
return pid in pids()
else:
return _psplatform.pid_exists(pid)
_pmap = {}
_pids_reused = set()
def process_iter(attrs=None, ad_value=None):
"""Return a generator yielding a Process instance for all
running processes.
Every new Process instance is only created once and then cached
into an internal table which is updated every time this is used.
Cache can optionally be cleared via `process_iter.clear_cache()`.
The sorting order in which processes are yielded is based on
their PIDs.
*attrs* and *ad_value* have the same meaning as in
Process.as_dict(). If *attrs* is specified as_dict() is called
and the resulting dict is stored as a 'info' attribute attached
to returned Process instance.
If *attrs* is an empty list it will retrieve all process info
(slow).
"""
global _pmap
def add(pid):
proc = Process(pid)
pmap[proc.pid] = proc
return proc
def remove(pid):
pmap.pop(pid, None)
pmap = _pmap.copy()
a = set(pids())
b = set(pmap.keys())
new_pids = a - b
gone_pids = b - a
for pid in gone_pids:
remove(pid)
while _pids_reused:
pid = _pids_reused.pop()
debug("refreshing Process instance for reused PID %s" % pid)
remove(pid)
try:
ls = sorted(list(pmap.items()) + list(dict.fromkeys(new_pids).items()))
for pid, proc in ls:
try:
if proc is None: # new process
proc = add(pid)
if attrs is not None:
proc.info = proc.as_dict(attrs=attrs, ad_value=ad_value)
yield proc
except NoSuchProcess:
remove(pid)
finally:
_pmap = pmap
process_iter.cache_clear = lambda: _pmap.clear() # noqa
process_iter.cache_clear.__doc__ = "Clear process_iter() internal cache."
def wait_procs(procs, timeout=None, callback=None):
"""Convenience function which waits for a list of processes to
terminate.
Return a (gone, alive) tuple indicating which processes
are gone and which ones are still alive.
The gone ones will have a new *returncode* attribute indicating
process exit status (may be None).
*callback* is a function which gets called every time a process
terminates (a Process instance is passed as callback argument).
Function will return as soon as all processes terminate or when
*timeout* occurs.
Differently from Process.wait() it will not raise TimeoutExpired if
*timeout* occurs.
Typical use case is:
- send SIGTERM to a list of processes
- give them some time to terminate
- send SIGKILL to those ones which are still alive
Example:
>>> def on_terminate(proc):
... print("process {} terminated".format(proc))
...
>>> for p in procs:
... p.terminate()
...
>>> gone, alive = wait_procs(procs, timeout=3, callback=on_terminate)
>>> for p in alive:
... p.kill()
"""
def check_gone(proc, timeout):
try:
returncode = proc.wait(timeout=timeout)
except TimeoutExpired:
pass
except _SubprocessTimeoutExpired:
pass
else:
if returncode is not None or not proc.is_running():
# Set new Process instance attribute.
proc.returncode = returncode
gone.add(proc)
if callback is not None:
callback(proc)
if timeout is not None and not timeout >= 0:
msg = "timeout must be a positive integer, got %s" % timeout
raise ValueError(msg)
gone = set()
alive = set(procs)
if callback is not None and not callable(callback):
msg = "callback %r is not a callable" % callback
raise TypeError(msg)
if timeout is not None:
deadline = _timer() + timeout
while alive:
if timeout is not None and timeout <= 0:
break
for proc in alive:
# Make sure that every complete iteration (all processes)
# will last max 1 sec.
# We do this because we don't want to wait too long on a
# single process: in case it terminates too late other
# processes may disappear in the meantime and their PID
# reused.
max_timeout = 1.0 / len(alive)
if timeout is not None:
timeout = min((deadline - _timer()), max_timeout)
if timeout <= 0:
break
check_gone(proc, timeout)
else:
check_gone(proc, max_timeout)
alive = alive - gone # noqa PLR6104
if alive:
# Last attempt over processes survived so far.
# timeout == 0 won't make this function wait any further.
for proc in alive:
check_gone(proc, 0)
alive = alive - gone # noqa: PLR6104
return (list(gone), list(alive))
# =====================================================================
# --- CPU related functions
# =====================================================================
def cpu_count(logical=True):
"""Return the number of logical CPUs in the system (same as
os.cpu_count() in Python 3.4).
If *logical* is False return the number of physical cores only
(e.g. hyper thread CPUs are excluded).
Return None if undetermined.
The return value is cached after first call.
If desired cache can be cleared like this:
>>> psutil.cpu_count.cache_clear()
"""
if logical:
ret = _psplatform.cpu_count_logical()
else:
ret = _psplatform.cpu_count_cores()
if ret is not None and ret < 1:
ret = None
return ret
def cpu_times(percpu=False):
"""Return system-wide CPU times as a namedtuple.
Every CPU time represents the seconds the CPU has spent in the
given mode. The namedtuple's fields availability varies depending on the
platform:
- user
- system
- idle
- nice (UNIX)
- iowait (Linux)
- irq (Linux, FreeBSD)
- softirq (Linux)
- steal (Linux >= 2.6.11)
- guest (Linux >= 2.6.24)
- guest_nice (Linux >= 3.2.0)
When *percpu* is True return a list of namedtuples for each CPU.
First element of the list refers to first CPU, second element
to second CPU and so on.
The order of the list is consistent across calls.
"""
if not percpu:
return _psplatform.cpu_times()
else:
return _psplatform.per_cpu_times()
try:
_last_cpu_times = {threading.current_thread().ident: cpu_times()}
except Exception: # noqa: BLE001
# Don't want to crash at import time.
_last_cpu_times = {}
try:
_last_per_cpu_times = {
threading.current_thread().ident: cpu_times(percpu=True)
}
except Exception: # noqa: BLE001
# Don't want to crash at import time.
_last_per_cpu_times = {}
def _cpu_tot_time(times):
"""Given a cpu_time() ntuple calculates the total CPU time
(including idle time).
"""
tot = sum(times)
if LINUX:
# On Linux guest times are already accounted in "user" or
# "nice" times, so we subtract them from total.
# Htop does the same. References:
# https://github.com/giampaolo/psutil/pull/940
# http://unix.stackexchange.com/questions/178045
# https://github.com/torvalds/linux/blob/
# 447976ef4fd09b1be88b316d1a81553f1aa7cd07/kernel/sched/
# cputime.c#L158
tot -= getattr(times, "guest", 0) # Linux 2.6.24+
tot -= getattr(times, "guest_nice", 0) # Linux 3.2.0+
return tot
def _cpu_busy_time(times):
"""Given a cpu_time() ntuple calculates the busy CPU time.
We do so by subtracting all idle CPU times.
"""
busy = _cpu_tot_time(times)
busy -= times.idle
# Linux: "iowait" is time during which the CPU does not do anything
# (waits for IO to complete). On Linux IO wait is *not* accounted
# in "idle" time so we subtract it. Htop does the same.
# References:
# https://github.com/torvalds/linux/blob/
# 447976ef4fd09b1be88b316d1a81553f1aa7cd07/kernel/sched/cputime.c#L244
busy -= getattr(times, "iowait", 0)
return busy
def _cpu_times_deltas(t1, t2):
assert t1._fields == t2._fields, (t1, t2)
field_deltas = []
for field in _psplatform.scputimes._fields:
field_delta = getattr(t2, field) - getattr(t1, field)
# CPU times are always supposed to increase over time
# or at least remain the same and that's because time
# cannot go backwards.
# Surprisingly sometimes this might not be the case (at
# least on Windows and Linux), see:
# https://github.com/giampaolo/psutil/issues/392
# https://github.com/giampaolo/psutil/issues/645
# https://github.com/giampaolo/psutil/issues/1210
# Trim negative deltas to zero to ignore decreasing fields.
# top does the same. Reference:
# https://gitlab.com/procps-ng/procps/blob/v3.3.12/top/top.c#L5063
field_delta = max(0, field_delta)
field_deltas.append(field_delta)
return _psplatform.scputimes(*field_deltas)
def cpu_percent(interval=None, percpu=False):
"""Return a float representing the current system-wide CPU
utilization as a percentage.
When *interval* is > 0.0 compares system CPU times elapsed before
and after the interval (blocking).
When *interval* is 0.0 or None compares system CPU times elapsed
since last call or module import, returning immediately (non
blocking). That means the first time this is called it will
return a meaningless 0.0 value which you should ignore.
In this case is recommended for accuracy that this function be
called with at least 0.1 seconds between calls.
When *percpu* is True returns a list of floats representing the
utilization as a percentage for each CPU.
First element of the list refers to first CPU, second element
to second CPU and so on.
The order of the list is consistent across calls.
Examples:
>>> # blocking, system-wide
>>> psutil.cpu_percent(interval=1)
2.0
>>>
>>> # blocking, per-cpu
>>> psutil.cpu_percent(interval=1, percpu=True)
[2.0, 1.0]
>>>
>>> # non-blocking (percentage since last call)
>>> psutil.cpu_percent(interval=None)
2.9
>>>
"""
tid = threading.current_thread().ident
blocking = interval is not None and interval > 0.0
if interval is not None and interval < 0:
msg = "interval is not positive (got %r)" % interval
raise ValueError(msg)
def calculate(t1, t2):
times_delta = _cpu_times_deltas(t1, t2)
all_delta = _cpu_tot_time(times_delta)
busy_delta = _cpu_busy_time(times_delta)
try:
busy_perc = (busy_delta / all_delta) * 100
except ZeroDivisionError:
return 0.0
else:
return round(busy_perc, 1)
# system-wide usage
if not percpu:
if blocking:
t1 = cpu_times()
time.sleep(interval)
else:
t1 = _last_cpu_times.get(tid) or cpu_times()
_last_cpu_times[tid] = cpu_times()
return calculate(t1, _last_cpu_times[tid])
# per-cpu usage
else:
ret = []
if blocking:
tot1 = cpu_times(percpu=True)
time.sleep(interval)
else:
tot1 = _last_per_cpu_times.get(tid) or cpu_times(percpu=True)
_last_per_cpu_times[tid] = cpu_times(percpu=True)
for t1, t2 in zip(tot1, _last_per_cpu_times[tid]):
ret.append(calculate(t1, t2))
return ret
# Use a separate dict for cpu_times_percent(), so it's independent from
# cpu_percent() and they can both be used within the same program.
_last_cpu_times_2 = _last_cpu_times.copy()
_last_per_cpu_times_2 = _last_per_cpu_times.copy()
def cpu_times_percent(interval=None, percpu=False):
"""Same as cpu_percent() but provides utilization percentages
for each specific CPU time as is returned by cpu_times().
For instance, on Linux we'll get:
>>> cpu_times_percent()
cpupercent(user=4.8, nice=0.0, system=4.8, idle=90.5, iowait=0.0,
irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
>>>
*interval* and *percpu* arguments have the same meaning as in
cpu_percent().
"""
tid = threading.current_thread().ident
blocking = interval is not None and interval > 0.0
if interval is not None and interval < 0:
msg = "interval is not positive (got %r)" % interval
raise ValueError(msg)
def calculate(t1, t2):
nums = []
times_delta = _cpu_times_deltas(t1, t2)
all_delta = _cpu_tot_time(times_delta)
# "scale" is the value to multiply each delta with to get percentages.
# We use "max" to avoid division by zero (if all_delta is 0, then all
# fields are 0 so percentages will be 0 too. all_delta cannot be a
# fraction because cpu times are integers)
scale = 100.0 / max(1, all_delta)
for field_delta in times_delta:
field_perc = field_delta * scale
field_perc = round(field_perc, 1)
# make sure we don't return negative values or values over 100%
field_perc = min(max(0.0, field_perc), 100.0)
nums.append(field_perc)
return _psplatform.scputimes(*nums)
# system-wide usage
if not percpu:
if blocking:
t1 = cpu_times()
time.sleep(interval)
else:
t1 = _last_cpu_times_2.get(tid) or cpu_times()
_last_cpu_times_2[tid] = cpu_times()
return calculate(t1, _last_cpu_times_2[tid])
# per-cpu usage
else:
ret = []
if blocking:
tot1 = cpu_times(percpu=True)
time.sleep(interval)
else:
tot1 = _last_per_cpu_times_2.get(tid) or cpu_times(percpu=True)
_last_per_cpu_times_2[tid] = cpu_times(percpu=True)
for t1, t2 in zip(tot1, _last_per_cpu_times_2[tid]):
ret.append(calculate(t1, t2))
return ret
def cpu_stats():
"""Return CPU statistics."""
return _psplatform.cpu_stats()
if hasattr(_psplatform, "cpu_freq"):
def cpu_freq(percpu=False):
"""Return CPU frequency as a namedtuple including current,
min and max frequency expressed in Mhz.
If *percpu* is True and the system supports per-cpu frequency
retrieval (Linux only) a list of frequencies is returned for
each CPU. If not a list with one element is returned.
"""
ret = _psplatform.cpu_freq()
if percpu:
return ret
else:
num_cpus = float(len(ret))
if num_cpus == 0:
return None
elif num_cpus == 1:
return ret[0]
else:
currs, mins, maxs = 0.0, 0.0, 0.0
set_none = False
for cpu in ret:
currs += cpu.current
# On Linux if /proc/cpuinfo is used min/max are set
# to None.
if LINUX and cpu.min is None:
set_none = True
continue
mins += cpu.min
maxs += cpu.max
current = currs / num_cpus
if set_none:
min_ = max_ = None
else:
min_ = mins / num_cpus
max_ = maxs / num_cpus
return _common.scpufreq(current, min_, max_)
__all__.append("cpu_freq")
if hasattr(os, "getloadavg") or hasattr(_psplatform, "getloadavg"):
# Perform this hasattr check once on import time to either use the
# platform based code or proxy straight from the os module.
if hasattr(os, "getloadavg"):
getloadavg = os.getloadavg
else:
getloadavg = _psplatform.getloadavg
__all__.append("getloadavg")
# =====================================================================
# --- system memory related functions
# =====================================================================
def virtual_memory():
"""Return statistics about system memory usage as a namedtuple
including the following fields, expressed in bytes:
- total:
total physical memory available.
- available:
the memory that can be given instantly to processes without the
system going into swap.
This is calculated by summing different memory values depending
on the platform and it is supposed to be used to monitor actual
memory usage in a cross platform fashion.
- percent:
the percentage usage calculated as (total - available) / total * 100
- used:
memory used, calculated differently depending on the platform and
designed for informational purposes only:
macOS: active + wired
BSD: active + wired + cached
Linux: total - free
- free:
memory not being used at all (zeroed) that is readily available;
note that this doesn't reflect the actual memory available
(use 'available' instead)
Platform-specific fields:
- active (UNIX):
memory currently in use or very recently used, and so it is in RAM.
- inactive (UNIX):
memory that is marked as not used.
- buffers (BSD, Linux):
cache for things like file system metadata.
- cached (BSD, macOS):
cache for various things.
- wired (macOS, BSD):
memory that is marked to always stay in RAM. It is never moved to disk.
- shared (BSD):
memory that may be simultaneously accessed by multiple processes.
The sum of 'used' and 'available' does not necessarily equal total.
On Windows 'available' and 'free' are the same.
"""
global _TOTAL_PHYMEM
ret = _psplatform.virtual_memory()
# cached for later use in Process.memory_percent()
_TOTAL_PHYMEM = ret.total
return ret
def swap_memory():
"""Return system swap memory statistics as a namedtuple including
the following fields:
- total: total swap memory in bytes
- used: used swap memory in bytes
- free: free swap memory in bytes
- percent: the percentage usage
- sin: no. of bytes the system has swapped in from disk (cumulative)
- sout: no. of bytes the system has swapped out from disk (cumulative)
'sin' and 'sout' on Windows are meaningless and always set to 0.
"""
return _psplatform.swap_memory()
# =====================================================================
# --- disks/partitions related functions
# =====================================================================
def disk_usage(path):
"""Return disk usage statistics about the given *path* as a
namedtuple including total, used and free space expressed in bytes
plus the percentage usage.
"""
return _psplatform.disk_usage(path)
def disk_partitions(all=False):
"""Return mounted partitions as a list of
(device, mountpoint, fstype, opts) namedtuple.
'opts' field is a raw string separated by commas indicating mount
options which may vary depending on the platform.
If *all* parameter is False return physical devices only and ignore
all others.
"""
return _psplatform.disk_partitions(all)
def disk_io_counters(perdisk=False, nowrap=True):
"""Return system disk I/O statistics as a namedtuple including
the following fields:
- read_count: number of reads
- write_count: number of writes
- read_bytes: number of bytes read
- write_bytes: number of bytes written
- read_time: time spent reading from disk (in ms)
- write_time: time spent writing to disk (in ms)
Platform specific:
- busy_time: (Linux, FreeBSD) time spent doing actual I/Os (in ms)
- read_merged_count (Linux): number of merged reads
- write_merged_count (Linux): number of merged writes
If *perdisk* is True return the same information for every
physical disk installed on the system as a dictionary
with partition names as the keys and the namedtuple
described above as the values.
If *nowrap* is True it detects and adjust the numbers which overflow
and wrap (restart from 0) and add "old value" to "new value" so that
the returned numbers will always be increasing or remain the same,
but never decrease.
"disk_io_counters.cache_clear()" can be used to invalidate the
cache.
On recent Windows versions 'diskperf -y' command may need to be
executed first otherwise this function won't find any disk.
"""
kwargs = dict(perdisk=perdisk) if LINUX else {}
rawdict = _psplatform.disk_io_counters(**kwargs)
if not rawdict:
return {} if perdisk else None
if nowrap:
rawdict = _wrap_numbers(rawdict, 'psutil.disk_io_counters')
nt = getattr(_psplatform, "sdiskio", _common.sdiskio)
if perdisk:
for disk, fields in rawdict.items():
rawdict[disk] = nt(*fields)
return rawdict
else:
return nt(*(sum(x) for x in zip(*rawdict.values())))
disk_io_counters.cache_clear = functools.partial(
_wrap_numbers.cache_clear, 'psutil.disk_io_counters'
)
disk_io_counters.cache_clear.__doc__ = "Clears nowrap argument cache"
# =====================================================================
# --- network related functions
# =====================================================================
def net_io_counters(pernic=False, nowrap=True):
"""Return network I/O statistics as a namedtuple including
the following fields:
- bytes_sent: number of bytes sent
- bytes_recv: number of bytes received
- packets_sent: number of packets sent
- packets_recv: number of packets received
- errin: total number of errors while receiving
- errout: total number of errors while sending
- dropin: total number of incoming packets which were dropped
- dropout: total number of outgoing packets which were dropped
(always 0 on macOS and BSD)
If *pernic* is True return the same information for every
network interface installed on the system as a dictionary
with network interface names as the keys and the namedtuple
described above as the values.
If *nowrap* is True it detects and adjust the numbers which overflow
and wrap (restart from 0) and add "old value" to "new value" so that
the returned numbers will always be increasing or remain the same,
but never decrease.
"net_io_counters.cache_clear()" can be used to invalidate the
cache.
"""
rawdict = _psplatform.net_io_counters()
if not rawdict:
return {} if pernic else None
if nowrap:
rawdict = _wrap_numbers(rawdict, 'psutil.net_io_counters')
if pernic:
for nic, fields in rawdict.items():
rawdict[nic] = _common.snetio(*fields)
return rawdict
else:
return _common.snetio(*[sum(x) for x in zip(*rawdict.values())])
net_io_counters.cache_clear = functools.partial(
_wrap_numbers.cache_clear, 'psutil.net_io_counters'
)
net_io_counters.cache_clear.__doc__ = "Clears nowrap argument cache"
def net_connections(kind='inet'):
"""Return system-wide socket connections as a list of
(fd, family, type, laddr, raddr, status, pid) namedtuples.
In case of limited privileges 'fd' and 'pid' may be set to -1
and None respectively.
The *kind* parameter filters for connections that fit the
following criteria:
+------------+----------------------------------------------------+
| Kind Value | Connections using |
+------------+----------------------------------------------------+
| inet | IPv4 and IPv6 |
| inet4 | IPv4 |
| inet6 | IPv6 |
| tcp | TCP |
| tcp4 | TCP over IPv4 |
| tcp6 | TCP over IPv6 |
| udp | UDP |
| udp4 | UDP over IPv4 |
| udp6 | UDP over IPv6 |
| unix | UNIX socket (both UDP and TCP protocols) |
| all | the sum of all the possible families and protocols |
+------------+----------------------------------------------------+
On macOS this function requires root privileges.
"""
return _psplatform.net_connections(kind)
def net_if_addrs():
"""Return the addresses associated to each NIC (network interface
card) installed on the system as a dictionary whose keys are the
NIC names and value is a list of namedtuples for each address
assigned to the NIC. Each namedtuple includes 5 fields:
- family: can be either socket.AF_INET, socket.AF_INET6 or
psutil.AF_LINK, which refers to a MAC address.
- address: is the primary address and it is always set.
- netmask: and 'broadcast' and 'ptp' may be None.
- ptp: stands for "point to point" and references the
destination address on a point to point interface
(typically a VPN).
- broadcast: and *ptp* are mutually exclusive.
Note: you can have more than one address of the same family
associated with each interface.
"""
has_enums = _PY3
if has_enums:
import socket
rawlist = _psplatform.net_if_addrs()
rawlist.sort(key=lambda x: x[1]) # sort by family
ret = collections.defaultdict(list)
for name, fam, addr, mask, broadcast, ptp in rawlist:
if has_enums:
try:
fam = socket.AddressFamily(fam)
except ValueError:
if WINDOWS and fam == -1:
fam = _psplatform.AF_LINK
elif (
hasattr(_psplatform, "AF_LINK")
and fam == _psplatform.AF_LINK
):
# Linux defines AF_LINK as an alias for AF_PACKET.
# We re-set the family here so that repr(family)
# will show AF_LINK rather than AF_PACKET
fam = _psplatform.AF_LINK
if fam == _psplatform.AF_LINK:
# The underlying C function may return an incomplete MAC
# address in which case we fill it with null bytes, see:
# https://github.com/giampaolo/psutil/issues/786
separator = ":" if POSIX else "-"
while addr.count(separator) < 5:
addr += "%s00" % separator
ret[name].append(_common.snicaddr(fam, addr, mask, broadcast, ptp))
return dict(ret)
def net_if_stats():
"""Return information about each NIC (network interface card)
installed on the system as a dictionary whose keys are the
NIC names and value is a namedtuple with the following fields:
- isup: whether the interface is up (bool)
- duplex: can be either NIC_DUPLEX_FULL, NIC_DUPLEX_HALF or
NIC_DUPLEX_UNKNOWN
- speed: the NIC speed expressed in mega bits (MB); if it can't
be determined (e.g. 'localhost') it will be set to 0.
- mtu: the maximum transmission unit expressed in bytes.
"""
return _psplatform.net_if_stats()
# =====================================================================
# --- sensors
# =====================================================================
# Linux, macOS
if hasattr(_psplatform, "sensors_temperatures"):
def sensors_temperatures(fahrenheit=False):
"""Return hardware temperatures. Each entry is a namedtuple
representing a certain hardware sensor (it may be a CPU, an
hard disk or something else, depending on the OS and its
configuration).
All temperatures are expressed in celsius unless *fahrenheit*
is set to True.
"""
def convert(n):
if n is not None:
return (float(n) * 9 / 5) + 32 if fahrenheit else n
ret = collections.defaultdict(list)
rawdict = _psplatform.sensors_temperatures()
for name, values in rawdict.items():
while values:
label, current, high, critical = values.pop(0)
current = convert(current)
high = convert(high)
critical = convert(critical)
if high and not critical:
critical = high
elif critical and not high:
high = critical
ret[name].append(
_common.shwtemp(label, current, high, critical)
)
return dict(ret)
__all__.append("sensors_temperatures")
# Linux
if hasattr(_psplatform, "sensors_fans"):
def sensors_fans():
"""Return fans speed. Each entry is a namedtuple
representing a certain hardware sensor.
All speed are expressed in RPM (rounds per minute).
"""
return _psplatform.sensors_fans()
__all__.append("sensors_fans")
# Linux, Windows, FreeBSD, macOS
if hasattr(_psplatform, "sensors_battery"):
def sensors_battery():
"""Return battery information. If no battery is installed
returns None.
- percent: battery power left as a percentage.
- secsleft: a rough approximation of how many seconds are left
before the battery runs out of power. May be
POWER_TIME_UNLIMITED or POWER_TIME_UNLIMITED.
- power_plugged: True if the AC power cable is connected.
"""
return _psplatform.sensors_battery()
__all__.append("sensors_battery")
# =====================================================================
# --- other system related functions
# =====================================================================
def boot_time():
"""Return the system boot time expressed in seconds since the epoch."""
# Note: we are not caching this because it is subject to
# system clock updates.
return _psplatform.boot_time()
def users():
"""Return users currently connected on the system as a list of
namedtuples including the following fields.
- user: the name of the user
- terminal: the tty or pseudo-tty associated with the user, if any.
- host: the host name associated with the entry, if any.
- started: the creation time as a floating point number expressed in
seconds since the epoch.
"""
return _psplatform.users()
# =====================================================================
# --- Windows services
# =====================================================================
if WINDOWS:
def win_service_iter():
"""Return a generator yielding a WindowsService instance for all
Windows services installed.
"""
return _psplatform.win_service_iter()
def win_service_get(name):
"""Get a Windows service by *name*.
Raise NoSuchProcess if no service with such name exists.
"""
return _psplatform.win_service_get(name)
# =====================================================================
def _set_debug(value):
"""Enable or disable PSUTIL_DEBUG option, which prints debugging
messages to stderr.
"""
import psutil._common
psutil._common.PSUTIL_DEBUG = bool(value)
_psplatform.cext.set_debug(bool(value))
def test(): # pragma: no cover
from ._common import bytes2human
from ._compat import get_terminal_size
today_day = datetime.date.today()
# fmt: off
templ = "%-10s %5s %5s %7s %7s %5s %6s %6s %6s %s"
attrs = ['pid', 'memory_percent', 'name', 'cmdline', 'cpu_times',
'create_time', 'memory_info', 'status', 'nice', 'username']
print(templ % ("USER", "PID", "%MEM", "VSZ", "RSS", "NICE", # NOQA
"STATUS", "START", "TIME", "CMDLINE"))
# fmt: on
for p in process_iter(attrs, ad_value=None):
if p.info['create_time']:
ctime = datetime.datetime.fromtimestamp(p.info['create_time'])
if ctime.date() == today_day:
ctime = ctime.strftime("%H:%M")
else:
ctime = ctime.strftime("%b%d")
else:
ctime = ''
if p.info['cpu_times']:
cputime = time.strftime(
"%M:%S", time.localtime(sum(p.info['cpu_times']))
)
else:
cputime = ''
user = p.info['username'] or ''
if not user and POSIX:
try:
user = p.uids()[0]
except Error:
pass
if user and WINDOWS and '\\' in user:
user = user.split('\\')[1]
user = user[:9]
vms = (
bytes2human(p.info['memory_info'].vms)
if p.info['memory_info'] is not None
else ''
)
rss = (
bytes2human(p.info['memory_info'].rss)
if p.info['memory_info'] is not None
else ''
)
memp = (
round(p.info['memory_percent'], 1)
if p.info['memory_percent'] is not None
else ''
)
nice = int(p.info['nice']) if p.info['nice'] else ''
if p.info['cmdline']:
cmdline = ' '.join(p.info['cmdline'])
else:
cmdline = p.info['name']
status = p.info['status'][:5] if p.info['status'] else ''
line = templ % (
user[:10],
p.info['pid'],
memp,
vms,
rss,
nice,
status,
ctime,
cputime,
cmdline,
)
print(line[: get_terminal_size()[0]]) # NOQA
del memoize_when_activated, division
if sys.version_info[0] < 3:
del num, x # noqa
if __name__ == "__main__":
test()
PK ok\0T;+ + psutil/_psposix.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Routines common to all posix systems."""
import glob
import os
import signal
import sys
import time
from ._common import MACOS
from ._common import TimeoutExpired
from ._common import memoize
from ._common import sdiskusage
from ._common import usage_percent
from ._compat import PY3
from ._compat import ChildProcessError
from ._compat import FileNotFoundError
from ._compat import InterruptedError
from ._compat import PermissionError
from ._compat import ProcessLookupError
from ._compat import unicode
if MACOS:
from . import _psutil_osx
if PY3:
import enum
else:
enum = None
__all__ = ['pid_exists', 'wait_pid', 'disk_usage', 'get_terminal_map']
def pid_exists(pid):
"""Check whether pid exists in the current process table."""
if pid == 0:
# According to "man 2 kill" PID 0 has a special meaning:
# it refers to <<every process in the process group of the
# calling process>> so we don't want to go any further.
# If we get here it means this UNIX platform *does* have
# a process with id 0.
return True
try:
os.kill(pid, 0)
except ProcessLookupError:
return False
except PermissionError:
# EPERM clearly means there's a process to deny access to
return True
# According to "man 2 kill" possible error values are
# (EINVAL, EPERM, ESRCH)
else:
return True
# Python 3.5 signals enum (contributed by me ^^):
# https://bugs.python.org/issue21076
if enum is not None and hasattr(signal, "Signals"):
Negsignal = enum.IntEnum(
'Negsignal', dict([(x.name, -x.value) for x in signal.Signals])
)
def negsig_to_enum(num):
"""Convert a negative signal value to an enum."""
try:
return Negsignal(num)
except ValueError:
return num
else: # pragma: no cover
def negsig_to_enum(num):
return num
def wait_pid(
pid,
timeout=None,
proc_name=None,
_waitpid=os.waitpid,
_timer=getattr(time, 'monotonic', time.time), # noqa: B008
_min=min,
_sleep=time.sleep,
_pid_exists=pid_exists,
):
"""Wait for a process PID to terminate.
If the process terminated normally by calling exit(3) or _exit(2),
or by returning from main(), the return value is the positive integer
passed to *exit().
If it was terminated by a signal it returns the negated value of the
signal which caused the termination (e.g. -SIGTERM).
If PID is not a children of os.getpid() (current process) just
wait until the process disappears and return None.
If PID does not exist at all return None immediately.
If *timeout* != None and process is still alive raise TimeoutExpired.
timeout=0 is also possible (either return immediately or raise).
"""
if pid <= 0:
# see "man waitpid"
msg = "can't wait for PID 0"
raise ValueError(msg)
interval = 0.0001
flags = 0
if timeout is not None:
flags |= os.WNOHANG
stop_at = _timer() + timeout
def sleep(interval):
# Sleep for some time and return a new increased interval.
if timeout is not None:
if _timer() >= stop_at:
raise TimeoutExpired(timeout, pid=pid, name=proc_name)
_sleep(interval)
return _min(interval * 2, 0.04)
# See: https://linux.die.net/man/2/waitpid
while True:
try:
retpid, status = os.waitpid(pid, flags)
except InterruptedError:
interval = sleep(interval)
except ChildProcessError:
# This has two meanings:
# - PID is not a child of os.getpid() in which case
# we keep polling until it's gone
# - PID never existed in the first place
# In both cases we'll eventually return None as we
# can't determine its exit status code.
while _pid_exists(pid):
interval = sleep(interval)
return
else:
if retpid == 0:
# WNOHANG flag was used and PID is still running.
interval = sleep(interval)
continue
if os.WIFEXITED(status):
# Process terminated normally by calling exit(3) or _exit(2),
# or by returning from main(). The return value is the
# positive integer passed to *exit().
return os.WEXITSTATUS(status)
elif os.WIFSIGNALED(status):
# Process exited due to a signal. Return the negative value
# of that signal.
return negsig_to_enum(-os.WTERMSIG(status))
# elif os.WIFSTOPPED(status):
# # Process was stopped via SIGSTOP or is being traced, and
# # waitpid() was called with WUNTRACED flag. PID is still
# # alive. From now on waitpid() will keep returning (0, 0)
# # until the process state doesn't change.
# # It may make sense to catch/enable this since stopped PIDs
# # ignore SIGTERM.
# interval = sleep(interval)
# continue
# elif os.WIFCONTINUED(status):
# # Process was resumed via SIGCONT and waitpid() was called
# # with WCONTINUED flag.
# interval = sleep(interval)
# continue
else:
# Should never happen.
raise ValueError("unknown process exit status %r" % status)
def disk_usage(path):
"""Return disk usage associated with path.
Note: UNIX usually reserves 5% disk space which is not accessible
by user. In this function "total" and "used" values reflect the
total and used disk space whereas "free" and "percent" represent
the "free" and "used percent" user disk space.
"""
if PY3:
st = os.statvfs(path)
else: # pragma: no cover
# os.statvfs() does not support unicode on Python 2:
# - https://github.com/giampaolo/psutil/issues/416
# - http://bugs.python.org/issue18695
try:
st = os.statvfs(path)
except UnicodeEncodeError:
if isinstance(path, unicode):
try:
path = path.encode(sys.getfilesystemencoding())
except UnicodeEncodeError:
pass
st = os.statvfs(path)
else:
raise
# Total space which is only available to root (unless changed
# at system level).
total = st.f_blocks * st.f_frsize
# Remaining free space usable by root.
avail_to_root = st.f_bfree * st.f_frsize
# Remaining free space usable by user.
avail_to_user = st.f_bavail * st.f_frsize
# Total space being used in general.
used = total - avail_to_root
if MACOS:
# see: https://github.com/giampaolo/psutil/pull/2152
used = _psutil_osx.disk_usage_used(path, used)
# Total space which is available to user (same as 'total' but
# for the user).
total_user = used + avail_to_user
# User usage percent compared to the total amount of space
# the user can use. This number would be higher if compared
# to root's because the user has less space (usually -5%).
usage_percent_user = usage_percent(used, total_user, round_=1)
# NB: the percentage is -5% than what shown by df due to
# reserved blocks that we are currently not considering:
# https://github.com/giampaolo/psutil/issues/829#issuecomment-223750462
return sdiskusage(
total=total, used=used, free=avail_to_user, percent=usage_percent_user
)
@memoize
def get_terminal_map():
"""Get a map of device-id -> path as a dict.
Used by Process.terminal().
"""
ret = {}
ls = glob.glob('/dev/tty*') + glob.glob('/dev/pts/*')
for name in ls:
assert name not in ret, name
try:
ret[os.stat(name).st_rdev] = name
except FileNotFoundError:
pass
return ret
PK ok\t�|�Z Z psutil/_pslinux.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Linux platform implementation."""
from __future__ import division
import base64
import collections
import errno
import functools
import glob
import os
import re
import socket
import struct
import sys
import warnings
from collections import defaultdict
from collections import namedtuple
from . import _common
from . import _psposix
from . import _psutil_linux as cext
from . import _psutil_posix as cext_posix
from ._common import NIC_DUPLEX_FULL
from ._common import NIC_DUPLEX_HALF
from ._common import NIC_DUPLEX_UNKNOWN
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import ZombieProcess
from ._common import bcat
from ._common import cat
from ._common import debug
from ._common import decode
from ._common import get_procfs_path
from ._common import isfile_strict
from ._common import memoize
from ._common import memoize_when_activated
from ._common import open_binary
from ._common import open_text
from ._common import parse_environ_block
from ._common import path_exists_strict
from ._common import supports_ipv6
from ._common import usage_percent
from ._compat import PY3
from ._compat import FileNotFoundError
from ._compat import PermissionError
from ._compat import ProcessLookupError
from ._compat import b
from ._compat import basestring
if PY3:
import enum
else:
enum = None
# fmt: off
__extra__all__ = [
'PROCFS_PATH',
# io prio constants
"IOPRIO_CLASS_NONE", "IOPRIO_CLASS_RT", "IOPRIO_CLASS_BE",
"IOPRIO_CLASS_IDLE",
# connection status constants
"CONN_ESTABLISHED", "CONN_SYN_SENT", "CONN_SYN_RECV", "CONN_FIN_WAIT1",
"CONN_FIN_WAIT2", "CONN_TIME_WAIT", "CONN_CLOSE", "CONN_CLOSE_WAIT",
"CONN_LAST_ACK", "CONN_LISTEN", "CONN_CLOSING",
]
# fmt: on
# =====================================================================
# --- globals
# =====================================================================
POWER_SUPPLY_PATH = "/sys/class/power_supply"
HAS_PROC_SMAPS = os.path.exists('/proc/%s/smaps' % os.getpid())
HAS_PROC_SMAPS_ROLLUP = os.path.exists('/proc/%s/smaps_rollup' % os.getpid())
HAS_PROC_IO_PRIORITY = hasattr(cext, "proc_ioprio_get")
HAS_CPU_AFFINITY = hasattr(cext, "proc_cpu_affinity_get")
# Number of clock ticks per second
CLOCK_TICKS = os.sysconf("SC_CLK_TCK")
PAGESIZE = cext_posix.getpagesize()
BOOT_TIME = None # set later
LITTLE_ENDIAN = sys.byteorder == 'little'
# "man iostat" states that sectors are equivalent with blocks and have
# a size of 512 bytes. Despite this value can be queried at runtime
# via /sys/block/{DISK}/queue/hw_sector_size and results may vary
# between 1k, 2k, or 4k... 512 appears to be a magic constant used
# throughout Linux source code:
# * https://stackoverflow.com/a/38136179/376587
# * https://lists.gt.net/linux/kernel/2241060
# * https://github.com/giampaolo/psutil/issues/1305
# * https://github.com/torvalds/linux/blob/
# 4f671fe2f9523a1ea206f63fe60a7c7b3a56d5c7/include/linux/bio.h#L99
# * https://lkml.org/lkml/2015/8/17/234
DISK_SECTOR_SIZE = 512
if enum is None:
AF_LINK = socket.AF_PACKET
else:
AddressFamily = enum.IntEnum(
'AddressFamily', {'AF_LINK': int(socket.AF_PACKET)}
)
AF_LINK = AddressFamily.AF_LINK
# ioprio_* constants http://linux.die.net/man/2/ioprio_get
if enum is None:
IOPRIO_CLASS_NONE = 0
IOPRIO_CLASS_RT = 1
IOPRIO_CLASS_BE = 2
IOPRIO_CLASS_IDLE = 3
else:
class IOPriority(enum.IntEnum):
IOPRIO_CLASS_NONE = 0
IOPRIO_CLASS_RT = 1
IOPRIO_CLASS_BE = 2
IOPRIO_CLASS_IDLE = 3
globals().update(IOPriority.__members__)
# See:
# https://github.com/torvalds/linux/blame/master/fs/proc/array.c
# ...and (TASK_* constants):
# https://github.com/torvalds/linux/blob/master/include/linux/sched.h
PROC_STATUSES = {
"R": _common.STATUS_RUNNING,
"S": _common.STATUS_SLEEPING,
"D": _common.STATUS_DISK_SLEEP,
"T": _common.STATUS_STOPPED,
"t": _common.STATUS_TRACING_STOP,
"Z": _common.STATUS_ZOMBIE,
"X": _common.STATUS_DEAD,
"x": _common.STATUS_DEAD,
"K": _common.STATUS_WAKE_KILL,
"W": _common.STATUS_WAKING,
"I": _common.STATUS_IDLE,
"P": _common.STATUS_PARKED,
}
# https://github.com/torvalds/linux/blob/master/include/net/tcp_states.h
TCP_STATUSES = {
"01": _common.CONN_ESTABLISHED,
"02": _common.CONN_SYN_SENT,
"03": _common.CONN_SYN_RECV,
"04": _common.CONN_FIN_WAIT1,
"05": _common.CONN_FIN_WAIT2,
"06": _common.CONN_TIME_WAIT,
"07": _common.CONN_CLOSE,
"08": _common.CONN_CLOSE_WAIT,
"09": _common.CONN_LAST_ACK,
"0A": _common.CONN_LISTEN,
"0B": _common.CONN_CLOSING,
}
# =====================================================================
# --- named tuples
# =====================================================================
# fmt: off
# psutil.virtual_memory()
svmem = namedtuple(
'svmem', ['total', 'available', 'percent', 'used', 'free',
'active', 'inactive', 'buffers', 'cached', 'shared', 'slab'])
# psutil.disk_io_counters()
sdiskio = namedtuple(
'sdiskio', ['read_count', 'write_count',
'read_bytes', 'write_bytes',
'read_time', 'write_time',
'read_merged_count', 'write_merged_count',
'busy_time'])
# psutil.Process().open_files()
popenfile = namedtuple(
'popenfile', ['path', 'fd', 'position', 'mode', 'flags'])
# psutil.Process().memory_info()
pmem = namedtuple('pmem', 'rss vms shared text lib data dirty')
# psutil.Process().memory_full_info()
pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', 'pss', 'swap'))
# psutil.Process().memory_maps(grouped=True)
pmmap_grouped = namedtuple(
'pmmap_grouped',
['path', 'rss', 'size', 'pss', 'shared_clean', 'shared_dirty',
'private_clean', 'private_dirty', 'referenced', 'anonymous', 'swap'])
# psutil.Process().memory_maps(grouped=False)
pmmap_ext = namedtuple(
'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields))
# psutil.Process.io_counters()
pio = namedtuple('pio', ['read_count', 'write_count',
'read_bytes', 'write_bytes',
'read_chars', 'write_chars'])
# psutil.Process.cpu_times()
pcputimes = namedtuple('pcputimes',
['user', 'system', 'children_user', 'children_system',
'iowait'])
# fmt: on
# =====================================================================
# --- utils
# =====================================================================
def readlink(path):
"""Wrapper around os.readlink()."""
assert isinstance(path, basestring), path
path = os.readlink(path)
# readlink() might return paths containing null bytes ('\x00')
# resulting in "TypeError: must be encoded string without NULL
# bytes, not str" errors when the string is passed to other
# fs-related functions (os.*, open(), ...).
# Apparently everything after '\x00' is garbage (we can have
# ' (deleted)', 'new' and possibly others), see:
# https://github.com/giampaolo/psutil/issues/717
path = path.split('\x00')[0]
# Certain paths have ' (deleted)' appended. Usually this is
# bogus as the file actually exists. Even if it doesn't we
# don't care.
if path.endswith(' (deleted)') and not path_exists_strict(path):
path = path[:-10]
return path
def file_flags_to_mode(flags):
"""Convert file's open() flags into a readable string.
Used by Process.open_files().
"""
modes_map = {os.O_RDONLY: 'r', os.O_WRONLY: 'w', os.O_RDWR: 'w+'}
mode = modes_map[flags & (os.O_RDONLY | os.O_WRONLY | os.O_RDWR)]
if flags & os.O_APPEND:
mode = mode.replace('w', 'a', 1)
mode = mode.replace('w+', 'r+')
# possible values: r, w, a, r+, a+
return mode
def is_storage_device(name):
"""Return True if the given name refers to a root device (e.g.
"sda", "nvme0n1") as opposed to a logical partition (e.g. "sda1",
"nvme0n1p1"). If name is a virtual device (e.g. "loop1", "ram")
return True.
"""
# Re-adapted from iostat source code, see:
# https://github.com/sysstat/sysstat/blob/
# 97912938cd476645b267280069e83b1c8dc0e1c7/common.c#L208
# Some devices may have a slash in their name (e.g. cciss/c0d0...).
name = name.replace('/', '!')
including_virtual = True
if including_virtual:
path = "/sys/block/%s" % name
else:
path = "/sys/block/%s/device" % name
return os.access(path, os.F_OK)
@memoize
def set_scputimes_ntuple(procfs_path):
"""Set a namedtuple of variable fields depending on the CPU times
available on this Linux kernel version which may be:
(user, nice, system, idle, iowait, irq, softirq, [steal, [guest,
[guest_nice]]])
Used by cpu_times() function.
"""
global scputimes
with open_binary('%s/stat' % procfs_path) as f:
values = f.readline().split()[1:]
fields = ['user', 'nice', 'system', 'idle', 'iowait', 'irq', 'softirq']
vlen = len(values)
if vlen >= 8:
# Linux >= 2.6.11
fields.append('steal')
if vlen >= 9:
# Linux >= 2.6.24
fields.append('guest')
if vlen >= 10:
# Linux >= 3.2.0
fields.append('guest_nice')
scputimes = namedtuple('scputimes', fields)
try:
set_scputimes_ntuple("/proc")
except Exception as err: # noqa: BLE001
# Don't want to crash at import time.
debug("ignoring exception on import: %r" % err)
scputimes = namedtuple('scputimes', 'user system idle')(0.0, 0.0, 0.0)
# =====================================================================
# --- prlimit
# =====================================================================
# Backport of resource.prlimit() for Python 2. Originally this was done
# in C, but CentOS-6 which we use to create manylinux wheels is too old
# and does not support prlimit() syscall. As such the resulting wheel
# would not include prlimit(), even when installed on newer systems.
# This is the only part of psutil using ctypes.
prlimit = None
try:
from resource import prlimit # python >= 3.4
except ImportError:
import ctypes
libc = ctypes.CDLL(None, use_errno=True)
if hasattr(libc, "prlimit"):
def prlimit(pid, resource_, limits=None):
class StructRlimit(ctypes.Structure):
_fields_ = [
('rlim_cur', ctypes.c_longlong),
('rlim_max', ctypes.c_longlong),
]
current = StructRlimit()
if limits is None:
# get
ret = libc.prlimit(pid, resource_, None, ctypes.byref(current))
else:
# set
new = StructRlimit()
new.rlim_cur = limits[0]
new.rlim_max = limits[1]
ret = libc.prlimit(
pid, resource_, ctypes.byref(new), ctypes.byref(current)
)
if ret != 0:
errno_ = ctypes.get_errno()
raise OSError(errno_, os.strerror(errno_))
return (current.rlim_cur, current.rlim_max)
if prlimit is not None:
__extra__all__.extend(
[x for x in dir(cext) if x.startswith('RLIM') and x.isupper()]
)
# =====================================================================
# --- system memory
# =====================================================================
def calculate_avail_vmem(mems):
"""Fallback for kernels < 3.14 where /proc/meminfo does not provide
"MemAvailable", see:
https://blog.famzah.net/2014/09/24/.
This code reimplements the algorithm outlined here:
https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/
commit/?id=34e431b0ae398fc54ea69ff85ec700722c9da773
We use this function also when "MemAvailable" returns 0 (possibly a
kernel bug, see: https://github.com/giampaolo/psutil/issues/1915).
In that case this routine matches "free" CLI tool result ("available"
column).
XXX: on recent kernels this calculation may differ by ~1.5% compared
to "MemAvailable:", as it's calculated slightly differently.
It is still way more realistic than doing (free + cached) though.
See:
* https://gitlab.com/procps-ng/procps/issues/42
* https://github.com/famzah/linux-memavailable-procfs/issues/2
"""
# Note about "fallback" value. According to:
# https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/
# commit/?id=34e431b0ae398fc54ea69ff85ec700722c9da773
# ...long ago "available" memory was calculated as (free + cached),
# We use fallback when one of these is missing from /proc/meminfo:
# "Active(file)": introduced in 2.6.28 / Dec 2008
# "Inactive(file)": introduced in 2.6.28 / Dec 2008
# "SReclaimable": introduced in 2.6.19 / Nov 2006
# /proc/zoneinfo: introduced in 2.6.13 / Aug 2005
free = mems[b'MemFree:']
fallback = free + mems.get(b"Cached:", 0)
try:
lru_active_file = mems[b'Active(file):']
lru_inactive_file = mems[b'Inactive(file):']
slab_reclaimable = mems[b'SReclaimable:']
except KeyError as err:
debug(
"%s is missing from /proc/meminfo; using an approximation for "
"calculating available memory"
% err.args[0]
)
return fallback
try:
f = open_binary('%s/zoneinfo' % get_procfs_path())
except IOError:
return fallback # kernel 2.6.13
watermark_low = 0
with f:
for line in f:
line = line.strip()
if line.startswith(b'low'):
watermark_low += int(line.split()[1])
watermark_low *= PAGESIZE
avail = free - watermark_low
pagecache = lru_active_file + lru_inactive_file
pagecache -= min(pagecache / 2, watermark_low)
avail += pagecache
avail += slab_reclaimable - min(slab_reclaimable / 2.0, watermark_low)
return int(avail)
def virtual_memory():
"""Report virtual memory stats.
This implementation mimics procps-ng-3.3.12, aka "free" CLI tool:
https://gitlab.com/procps-ng/procps/blob/
24fd2605c51fccc375ab0287cec33aa767f06718/proc/sysinfo.c#L778-791
The returned values are supposed to match both "free" and "vmstat -s"
CLI tools.
"""
missing_fields = []
mems = {}
with open_binary('%s/meminfo' % get_procfs_path()) as f:
for line in f:
fields = line.split()
mems[fields[0]] = int(fields[1]) * 1024
# /proc doc states that the available fields in /proc/meminfo vary
# by architecture and compile options, but these 3 values are also
# returned by sysinfo(2); as such we assume they are always there.
total = mems[b'MemTotal:']
free = mems[b'MemFree:']
try:
buffers = mems[b'Buffers:']
except KeyError:
# https://github.com/giampaolo/psutil/issues/1010
buffers = 0
missing_fields.append('buffers')
try:
cached = mems[b"Cached:"]
except KeyError:
cached = 0
missing_fields.append('cached')
else:
# "free" cmdline utility sums reclaimable to cached.
# Older versions of procps used to add slab memory instead.
# This got changed in:
# https://gitlab.com/procps-ng/procps/commit/
# 05d751c4f076a2f0118b914c5e51cfbb4762ad8e
cached += mems.get(b"SReclaimable:", 0) # since kernel 2.6.19
try:
shared = mems[b'Shmem:'] # since kernel 2.6.32
except KeyError:
try:
shared = mems[b'MemShared:'] # kernels 2.4
except KeyError:
shared = 0
missing_fields.append('shared')
try:
active = mems[b"Active:"]
except KeyError:
active = 0
missing_fields.append('active')
try:
inactive = mems[b"Inactive:"]
except KeyError:
try:
inactive = (
mems[b"Inact_dirty:"]
+ mems[b"Inact_clean:"]
+ mems[b"Inact_laundry:"]
)
except KeyError:
inactive = 0
missing_fields.append('inactive')
try:
slab = mems[b"Slab:"]
except KeyError:
slab = 0
used = total - free - cached - buffers
if used < 0:
# May be symptomatic of running within a LCX container where such
# values will be dramatically distorted over those of the host.
used = total - free
# - starting from 4.4.0 we match free's "available" column.
# Before 4.4.0 we calculated it as (free + buffers + cached)
# which matched htop.
# - free and htop available memory differs as per:
# http://askubuntu.com/a/369589
# http://unix.stackexchange.com/a/65852/168884
# - MemAvailable has been introduced in kernel 3.14
try:
avail = mems[b'MemAvailable:']
except KeyError:
avail = calculate_avail_vmem(mems)
else:
if avail == 0:
# Yes, it can happen (probably a kernel bug):
# https://github.com/giampaolo/psutil/issues/1915
# In this case "free" CLI tool makes an estimate. We do the same,
# and it matches "free" CLI tool.
avail = calculate_avail_vmem(mems)
if avail < 0:
avail = 0
missing_fields.append('available')
elif avail > total:
# If avail is greater than total or our calculation overflows,
# that's symptomatic of running within a LCX container where such
# values will be dramatically distorted over those of the host.
# https://gitlab.com/procps-ng/procps/blob/
# 24fd2605c51fccc375ab0287cec33aa767f06718/proc/sysinfo.c#L764
avail = free
percent = usage_percent((total - avail), total, round_=1)
# Warn about missing metrics which are set to 0.
if missing_fields:
msg = "%s memory stats couldn't be determined and %s set to 0" % (
", ".join(missing_fields),
"was" if len(missing_fields) == 1 else "were",
)
warnings.warn(msg, RuntimeWarning, stacklevel=2)
return svmem(
total,
avail,
percent,
used,
free,
active,
inactive,
buffers,
cached,
shared,
slab,
)
def swap_memory():
"""Return swap memory metrics."""
mems = {}
with open_binary('%s/meminfo' % get_procfs_path()) as f:
for line in f:
fields = line.split()
mems[fields[0]] = int(fields[1]) * 1024
# We prefer /proc/meminfo over sysinfo() syscall so that
# psutil.PROCFS_PATH can be used in order to allow retrieval
# for linux containers, see:
# https://github.com/giampaolo/psutil/issues/1015
try:
total = mems[b'SwapTotal:']
free = mems[b'SwapFree:']
except KeyError:
_, _, _, _, total, free, unit_multiplier = cext.linux_sysinfo()
total *= unit_multiplier
free *= unit_multiplier
used = total - free
percent = usage_percent(used, total, round_=1)
# get pgin/pgouts
try:
f = open_binary("%s/vmstat" % get_procfs_path())
except IOError as err:
# see https://github.com/giampaolo/psutil/issues/722
msg = (
"'sin' and 'sout' swap memory stats couldn't "
+ "be determined and were set to 0 (%s)" % str(err)
)
warnings.warn(msg, RuntimeWarning, stacklevel=2)
sin = sout = 0
else:
with f:
sin = sout = None
for line in f:
# values are expressed in 4 kilo bytes, we want
# bytes instead
if line.startswith(b'pswpin'):
sin = int(line.split(b' ')[1]) * 4 * 1024
elif line.startswith(b'pswpout'):
sout = int(line.split(b' ')[1]) * 4 * 1024
if sin is not None and sout is not None:
break
else:
# we might get here when dealing with exotic Linux
# flavors, see:
# https://github.com/giampaolo/psutil/issues/313
msg = "'sin' and 'sout' swap memory stats couldn't "
msg += "be determined and were set to 0"
warnings.warn(msg, RuntimeWarning, stacklevel=2)
sin = sout = 0
return _common.sswap(total, used, free, percent, sin, sout)
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return a named tuple representing the following system-wide
CPU times:
(user, nice, system, idle, iowait, irq, softirq [steal, [guest,
[guest_nice]]])
Last 3 fields may not be available on all Linux kernel versions.
"""
procfs_path = get_procfs_path()
set_scputimes_ntuple(procfs_path)
with open_binary('%s/stat' % procfs_path) as f:
values = f.readline().split()
fields = values[1 : len(scputimes._fields) + 1]
fields = [float(x) / CLOCK_TICKS for x in fields]
return scputimes(*fields)
def per_cpu_times():
"""Return a list of namedtuple representing the CPU times
for every CPU available on the system.
"""
procfs_path = get_procfs_path()
set_scputimes_ntuple(procfs_path)
cpus = []
with open_binary('%s/stat' % procfs_path) as f:
# get rid of the first line which refers to system wide CPU stats
f.readline()
for line in f:
if line.startswith(b'cpu'):
values = line.split()
fields = values[1 : len(scputimes._fields) + 1]
fields = [float(x) / CLOCK_TICKS for x in fields]
entry = scputimes(*fields)
cpus.append(entry)
return cpus
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
try:
return os.sysconf("SC_NPROCESSORS_ONLN")
except ValueError:
# as a second fallback we try to parse /proc/cpuinfo
num = 0
with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
for line in f:
if line.lower().startswith(b'processor'):
num += 1
# unknown format (e.g. amrel/sparc architectures), see:
# https://github.com/giampaolo/psutil/issues/200
# try to parse /proc/stat as a last resort
if num == 0:
search = re.compile(r'cpu\d')
with open_text('%s/stat' % get_procfs_path()) as f:
for line in f:
line = line.split(' ')[0]
if search.match(line):
num += 1
if num == 0:
# mimic os.cpu_count()
return None
return num
def cpu_count_cores():
"""Return the number of CPU cores in the system."""
# Method #1
ls = set()
# These 2 files are the same but */core_cpus_list is newer while
# */thread_siblings_list is deprecated and may disappear in the future.
# https://www.kernel.org/doc/Documentation/admin-guide/cputopology.rst
# https://github.com/giampaolo/psutil/pull/1727#issuecomment-707624964
# https://lkml.org/lkml/2019/2/26/41
p1 = "/sys/devices/system/cpu/cpu[0-9]*/topology/core_cpus_list"
p2 = "/sys/devices/system/cpu/cpu[0-9]*/topology/thread_siblings_list"
for path in glob.glob(p1) or glob.glob(p2):
with open_binary(path) as f:
ls.add(f.read().strip())
result = len(ls)
if result != 0:
return result
# Method #2
mapping = {}
current_info = {}
with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
for line in f:
line = line.strip().lower()
if not line:
# new section
try:
mapping[current_info[b'physical id']] = current_info[
b'cpu cores'
]
except KeyError:
pass
current_info = {}
else:
# ongoing section
if line.startswith((b'physical id', b'cpu cores')):
key, value = line.split(b'\t:', 1)
current_info[key] = int(value)
result = sum(mapping.values())
return result or None # mimic os.cpu_count()
def cpu_stats():
"""Return various CPU stats as a named tuple."""
with open_binary('%s/stat' % get_procfs_path()) as f:
ctx_switches = None
interrupts = None
soft_interrupts = None
for line in f:
if line.startswith(b'ctxt'):
ctx_switches = int(line.split()[1])
elif line.startswith(b'intr'):
interrupts = int(line.split()[1])
elif line.startswith(b'softirq'):
soft_interrupts = int(line.split()[1])
if (
ctx_switches is not None
and soft_interrupts is not None
and interrupts is not None
):
break
syscalls = 0
return _common.scpustats(
ctx_switches, interrupts, soft_interrupts, syscalls
)
def _cpu_get_cpuinfo_freq():
"""Return current CPU frequency from cpuinfo if available."""
ret = []
with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
for line in f:
if line.lower().startswith(b'cpu mhz'):
ret.append(float(line.split(b':', 1)[1]))
return ret
if os.path.exists("/sys/devices/system/cpu/cpufreq/policy0") or os.path.exists(
"/sys/devices/system/cpu/cpu0/cpufreq"
):
def cpu_freq():
"""Return frequency metrics for all CPUs.
Contrarily to other OSes, Linux updates these values in
real-time.
"""
cpuinfo_freqs = _cpu_get_cpuinfo_freq()
paths = glob.glob(
"/sys/devices/system/cpu/cpufreq/policy[0-9]*"
) or glob.glob("/sys/devices/system/cpu/cpu[0-9]*/cpufreq")
paths.sort(key=lambda x: int(re.search(r"[0-9]+", x).group()))
ret = []
pjoin = os.path.join
for i, path in enumerate(paths):
if len(paths) == len(cpuinfo_freqs):
# take cached value from cpuinfo if available, see:
# https://github.com/giampaolo/psutil/issues/1851
curr = cpuinfo_freqs[i] * 1000
else:
curr = bcat(pjoin(path, "scaling_cur_freq"), fallback=None)
if curr is None:
# Likely an old RedHat, see:
# https://github.com/giampaolo/psutil/issues/1071
curr = bcat(pjoin(path, "cpuinfo_cur_freq"), fallback=None)
if curr is None:
online_path = (
"/sys/devices/system/cpu/cpu{}/online".format(i)
)
# if cpu core is offline, set to all zeroes
if cat(online_path, fallback=None) == "0\n":
ret.append(_common.scpufreq(0.0, 0.0, 0.0))
continue
msg = "can't find current frequency file"
raise NotImplementedError(msg)
curr = int(curr) / 1000
max_ = int(bcat(pjoin(path, "scaling_max_freq"))) / 1000
min_ = int(bcat(pjoin(path, "scaling_min_freq"))) / 1000
ret.append(_common.scpufreq(curr, min_, max_))
return ret
else:
def cpu_freq():
"""Alternate implementation using /proc/cpuinfo.
min and max frequencies are not available and are set to None.
"""
return [_common.scpufreq(x, 0.0, 0.0) for x in _cpu_get_cpuinfo_freq()]
# =====================================================================
# --- network
# =====================================================================
net_if_addrs = cext_posix.net_if_addrs
class _Ipv6UnsupportedError(Exception):
pass
class NetConnections:
"""A wrapper on top of /proc/net/* files, retrieving per-process
and system-wide open connections (TCP, UDP, UNIX) similarly to
"netstat -an".
Note: in case of UNIX sockets we're only able to determine the
local endpoint/path, not the one it's connected to.
According to [1] it would be possible but not easily.
[1] http://serverfault.com/a/417946
"""
def __init__(self):
# The string represents the basename of the corresponding
# /proc/net/{proto_name} file.
tcp4 = ("tcp", socket.AF_INET, socket.SOCK_STREAM)
tcp6 = ("tcp6", socket.AF_INET6, socket.SOCK_STREAM)
udp4 = ("udp", socket.AF_INET, socket.SOCK_DGRAM)
udp6 = ("udp6", socket.AF_INET6, socket.SOCK_DGRAM)
unix = ("unix", socket.AF_UNIX, None)
self.tmap = {
"all": (tcp4, tcp6, udp4, udp6, unix),
"tcp": (tcp4, tcp6),
"tcp4": (tcp4,),
"tcp6": (tcp6,),
"udp": (udp4, udp6),
"udp4": (udp4,),
"udp6": (udp6,),
"unix": (unix,),
"inet": (tcp4, tcp6, udp4, udp6),
"inet4": (tcp4, udp4),
"inet6": (tcp6, udp6),
}
self._procfs_path = None
def get_proc_inodes(self, pid):
inodes = defaultdict(list)
for fd in os.listdir("%s/%s/fd" % (self._procfs_path, pid)):
try:
inode = readlink("%s/%s/fd/%s" % (self._procfs_path, pid, fd))
except (FileNotFoundError, ProcessLookupError):
# ENOENT == file which is gone in the meantime;
# os.stat('/proc/%s' % self.pid) will be done later
# to force NSP (if it's the case)
continue
except OSError as err:
if err.errno == errno.EINVAL:
# not a link
continue
if err.errno == errno.ENAMETOOLONG:
# file name too long
debug(err)
continue
raise
else:
if inode.startswith('socket:['):
# the process is using a socket
inode = inode[8:][:-1]
inodes[inode].append((pid, int(fd)))
return inodes
def get_all_inodes(self):
inodes = {}
for pid in pids():
try:
inodes.update(self.get_proc_inodes(pid))
except (FileNotFoundError, ProcessLookupError, PermissionError):
# os.listdir() is gonna raise a lot of access denied
# exceptions in case of unprivileged user; that's fine
# as we'll just end up returning a connection with PID
# and fd set to None anyway.
# Both netstat -an and lsof does the same so it's
# unlikely we can do any better.
# ENOENT just means a PID disappeared on us.
continue
return inodes
@staticmethod
def decode_address(addr, family):
"""Accept an "ip:port" address as displayed in /proc/net/*
and convert it into a human readable form, like:
"0500000A:0016" -> ("10.0.0.5", 22)
"0000000000000000FFFF00000100007F:9E49" -> ("::ffff:127.0.0.1", 40521)
The IP address portion is a little or big endian four-byte
hexadecimal number; that is, the least significant byte is listed
first, so we need to reverse the order of the bytes to convert it
to an IP address.
The port is represented as a two-byte hexadecimal number.
Reference:
http://linuxdevcenter.com/pub/a/linux/2000/11/16/LinuxAdmin.html
"""
ip, port = addr.split(':')
port = int(port, 16)
# this usually refers to a local socket in listen mode with
# no end-points connected
if not port:
return ()
if PY3:
ip = ip.encode('ascii')
if family == socket.AF_INET:
# see: https://github.com/giampaolo/psutil/issues/201
if LITTLE_ENDIAN:
ip = socket.inet_ntop(family, base64.b16decode(ip)[::-1])
else:
ip = socket.inet_ntop(family, base64.b16decode(ip))
else: # IPv6
ip = base64.b16decode(ip)
try:
# see: https://github.com/giampaolo/psutil/issues/201
if LITTLE_ENDIAN:
ip = socket.inet_ntop(
socket.AF_INET6,
struct.pack('>4I', *struct.unpack('<4I', ip)),
)
else:
ip = socket.inet_ntop(
socket.AF_INET6,
struct.pack('<4I', *struct.unpack('<4I', ip)),
)
except ValueError:
# see: https://github.com/giampaolo/psutil/issues/623
if not supports_ipv6():
raise _Ipv6UnsupportedError
else:
raise
return _common.addr(ip, port)
@staticmethod
def process_inet(file, family, type_, inodes, filter_pid=None):
"""Parse /proc/net/tcp* and /proc/net/udp* files."""
if file.endswith('6') and not os.path.exists(file):
# IPv6 not supported
return
with open_text(file) as f:
f.readline() # skip the first line
for lineno, line in enumerate(f, 1):
try:
_, laddr, raddr, status, _, _, _, _, _, inode = (
line.split()[:10]
)
except ValueError:
raise RuntimeError(
"error while parsing %s; malformed line %s %r"
% (file, lineno, line)
)
if inode in inodes:
# # We assume inet sockets are unique, so we error
# # out if there are multiple references to the
# # same inode. We won't do this for UNIX sockets.
# if len(inodes[inode]) > 1 and family != socket.AF_UNIX:
# raise ValueError("ambiguous inode with multiple "
# "PIDs references")
pid, fd = inodes[inode][0]
else:
pid, fd = None, -1
if filter_pid is not None and filter_pid != pid:
continue
else:
if type_ == socket.SOCK_STREAM:
status = TCP_STATUSES[status]
else:
status = _common.CONN_NONE
try:
laddr = NetConnections.decode_address(laddr, family)
raddr = NetConnections.decode_address(raddr, family)
except _Ipv6UnsupportedError:
continue
yield (fd, family, type_, laddr, raddr, status, pid)
@staticmethod
def process_unix(file, family, inodes, filter_pid=None):
"""Parse /proc/net/unix files."""
with open_text(file) as f:
f.readline() # skip the first line
for line in f:
tokens = line.split()
try:
_, _, _, _, type_, _, inode = tokens[0:7]
except ValueError:
if ' ' not in line:
# see: https://github.com/giampaolo/psutil/issues/766
continue
raise RuntimeError(
"error while parsing %s; malformed line %r"
% (file, line)
)
if inode in inodes: # noqa
# With UNIX sockets we can have a single inode
# referencing many file descriptors.
pairs = inodes[inode]
else:
pairs = [(None, -1)]
for pid, fd in pairs:
if filter_pid is not None and filter_pid != pid:
continue
else:
path = tokens[-1] if len(tokens) == 8 else ''
type_ = _common.socktype_to_enum(int(type_))
# XXX: determining the remote endpoint of a
# UNIX socket on Linux is not possible, see:
# https://serverfault.com/questions/252723/
raddr = ""
status = _common.CONN_NONE
yield (fd, family, type_, path, raddr, status, pid)
def retrieve(self, kind, pid=None):
if kind not in self.tmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in self.tmap]))
)
self._procfs_path = get_procfs_path()
if pid is not None:
inodes = self.get_proc_inodes(pid)
if not inodes:
# no connections for this process
return []
else:
inodes = self.get_all_inodes()
ret = set()
for proto_name, family, type_ in self.tmap[kind]:
path = "%s/net/%s" % (self._procfs_path, proto_name)
if family in (socket.AF_INET, socket.AF_INET6):
ls = self.process_inet(
path, family, type_, inodes, filter_pid=pid
)
else:
ls = self.process_unix(path, family, inodes, filter_pid=pid)
for fd, family, type_, laddr, raddr, status, bound_pid in ls:
if pid:
conn = _common.pconn(
fd, family, type_, laddr, raddr, status
)
else:
conn = _common.sconn(
fd, family, type_, laddr, raddr, status, bound_pid
)
ret.add(conn)
return list(ret)
_net_connections = NetConnections()
def net_connections(kind='inet'):
"""Return system-wide open connections."""
return _net_connections.retrieve(kind)
def net_io_counters():
"""Return network I/O statistics for every network interface
installed on the system as a dict of raw tuples.
"""
with open_text("%s/net/dev" % get_procfs_path()) as f:
lines = f.readlines()
retdict = {}
for line in lines[2:]:
colon = line.rfind(':')
assert colon > 0, repr(line)
name = line[:colon].strip()
fields = line[colon + 1 :].strip().split()
(
# in
bytes_recv,
packets_recv,
errin,
dropin,
_fifoin, # unused
_framein, # unused
_compressedin, # unused
_multicastin, # unused
# out
bytes_sent,
packets_sent,
errout,
dropout,
_fifoout, # unused
_collisionsout, # unused
_carrierout, # unused
_compressedout, # unused
) = map(int, fields)
retdict[name] = (
bytes_sent,
bytes_recv,
packets_sent,
packets_recv,
errin,
errout,
dropin,
dropout,
)
return retdict
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
duplex_map = {
cext.DUPLEX_FULL: NIC_DUPLEX_FULL,
cext.DUPLEX_HALF: NIC_DUPLEX_HALF,
cext.DUPLEX_UNKNOWN: NIC_DUPLEX_UNKNOWN,
}
names = net_io_counters().keys()
ret = {}
for name in names:
try:
mtu = cext_posix.net_if_mtu(name)
flags = cext_posix.net_if_flags(name)
duplex, speed = cext.net_if_duplex_speed(name)
except OSError as err:
# https://github.com/giampaolo/psutil/issues/1279
if err.errno != errno.ENODEV:
raise
else:
debug(err)
else:
output_flags = ','.join(flags)
isup = 'running' in flags
ret[name] = _common.snicstats(
isup, duplex_map[duplex], speed, mtu, output_flags
)
return ret
# =====================================================================
# --- disks
# =====================================================================
disk_usage = _psposix.disk_usage
def disk_io_counters(perdisk=False):
"""Return disk I/O statistics for every disk installed on the
system as a dict of raw tuples.
"""
def read_procfs():
# OK, this is a bit confusing. The format of /proc/diskstats can
# have 3 variations.
# On Linux 2.4 each line has always 15 fields, e.g.:
# "3 0 8 hda 8 8 8 8 8 8 8 8 8 8 8"
# On Linux 2.6+ each line *usually* has 14 fields, and the disk
# name is in another position, like this:
# "3 0 hda 8 8 8 8 8 8 8 8 8 8 8"
# ...unless (Linux 2.6) the line refers to a partition instead
# of a disk, in which case the line has less fields (7):
# "3 1 hda1 8 8 8 8"
# 4.18+ has 4 fields added:
# "3 0 hda 8 8 8 8 8 8 8 8 8 8 8 0 0 0 0"
# 5.5 has 2 more fields.
# See:
# https://www.kernel.org/doc/Documentation/iostats.txt
# https://www.kernel.org/doc/Documentation/ABI/testing/procfs-diskstats
with open_text("%s/diskstats" % get_procfs_path()) as f:
lines = f.readlines()
for line in lines:
fields = line.split()
flen = len(fields)
# fmt: off
if flen == 15:
# Linux 2.4
name = fields[3]
reads = int(fields[2])
(reads_merged, rbytes, rtime, writes, writes_merged,
wbytes, wtime, _, busy_time, _) = map(int, fields[4:14])
elif flen == 14 or flen >= 18:
# Linux 2.6+, line referring to a disk
name = fields[2]
(reads, reads_merged, rbytes, rtime, writes, writes_merged,
wbytes, wtime, _, busy_time, _) = map(int, fields[3:14])
elif flen == 7:
# Linux 2.6+, line referring to a partition
name = fields[2]
reads, rbytes, writes, wbytes = map(int, fields[3:])
rtime = wtime = reads_merged = writes_merged = busy_time = 0
else:
raise ValueError("not sure how to interpret line %r" % line)
yield (name, reads, writes, rbytes, wbytes, rtime, wtime,
reads_merged, writes_merged, busy_time)
# fmt: on
def read_sysfs():
for block in os.listdir('/sys/block'):
for root, _, files in os.walk(os.path.join('/sys/block', block)):
if 'stat' not in files:
continue
with open_text(os.path.join(root, 'stat')) as f:
fields = f.read().strip().split()
name = os.path.basename(root)
# fmt: off
(reads, reads_merged, rbytes, rtime, writes, writes_merged,
wbytes, wtime, _, busy_time) = map(int, fields[:10])
yield (name, reads, writes, rbytes, wbytes, rtime,
wtime, reads_merged, writes_merged, busy_time)
# fmt: on
if os.path.exists('%s/diskstats' % get_procfs_path()):
gen = read_procfs()
elif os.path.exists('/sys/block'):
gen = read_sysfs()
else:
raise NotImplementedError(
"%s/diskstats nor /sys/block filesystem are available on this "
"system"
% get_procfs_path()
)
retdict = {}
for entry in gen:
# fmt: off
(name, reads, writes, rbytes, wbytes, rtime, wtime, reads_merged,
writes_merged, busy_time) = entry
if not perdisk and not is_storage_device(name):
# perdisk=False means we want to calculate totals so we skip
# partitions (e.g. 'sda1', 'nvme0n1p1') and only include
# base disk devices (e.g. 'sda', 'nvme0n1'). Base disks
# include a total of all their partitions + some extra size
# of their own:
# $ cat /proc/diskstats
# 259 0 sda 10485760 ...
# 259 1 sda1 5186039 ...
# 259 1 sda2 5082039 ...
# See:
# https://github.com/giampaolo/psutil/pull/1313
continue
rbytes *= DISK_SECTOR_SIZE
wbytes *= DISK_SECTOR_SIZE
retdict[name] = (reads, writes, rbytes, wbytes, rtime, wtime,
reads_merged, writes_merged, busy_time)
# fmt: on
return retdict
class RootFsDeviceFinder:
"""disk_partitions() may return partitions with device == "/dev/root"
or "rootfs". This container class uses different strategies to try to
obtain the real device path. Resources:
https://bootlin.com/blog/find-root-device/
https://www.systutorials.com/how-to-find-the-disk-where-root-is-on-in-bash-on-linux/.
"""
__slots__ = ['major', 'minor']
def __init__(self):
dev = os.stat("/").st_dev
self.major = os.major(dev)
self.minor = os.minor(dev)
def ask_proc_partitions(self):
with open_text("%s/partitions" % get_procfs_path()) as f:
for line in f.readlines()[2:]:
fields = line.split()
if len(fields) < 4: # just for extra safety
continue
major = int(fields[0]) if fields[0].isdigit() else None
minor = int(fields[1]) if fields[1].isdigit() else None
name = fields[3]
if major == self.major and minor == self.minor:
if name: # just for extra safety
return "/dev/%s" % name
def ask_sys_dev_block(self):
path = "/sys/dev/block/%s:%s/uevent" % (self.major, self.minor)
with open_text(path) as f:
for line in f:
if line.startswith("DEVNAME="):
name = line.strip().rpartition("DEVNAME=")[2]
if name: # just for extra safety
return "/dev/%s" % name
def ask_sys_class_block(self):
needle = "%s:%s" % (self.major, self.minor)
files = glob.iglob("/sys/class/block/*/dev")
for file in files:
try:
f = open_text(file)
except FileNotFoundError: # race condition
continue
else:
with f:
data = f.read().strip()
if data == needle:
name = os.path.basename(os.path.dirname(file))
return "/dev/%s" % name
def find(self):
path = None
if path is None:
try:
path = self.ask_proc_partitions()
except (IOError, OSError) as err:
debug(err)
if path is None:
try:
path = self.ask_sys_dev_block()
except (IOError, OSError) as err:
debug(err)
if path is None:
try:
path = self.ask_sys_class_block()
except (IOError, OSError) as err:
debug(err)
# We use exists() because the "/dev/*" part of the path is hard
# coded, so we want to be sure.
if path is not None and os.path.exists(path):
return path
def disk_partitions(all=False):
"""Return mounted disk partitions as a list of namedtuples."""
fstypes = set()
procfs_path = get_procfs_path()
if not all:
with open_text("%s/filesystems" % procfs_path) as f:
for line in f:
line = line.strip()
if not line.startswith("nodev"):
fstypes.add(line.strip())
else:
# ignore all lines starting with "nodev" except "nodev zfs"
fstype = line.split("\t")[1]
if fstype == "zfs":
fstypes.add("zfs")
# See: https://github.com/giampaolo/psutil/issues/1307
if procfs_path == "/proc" and os.path.isfile('/etc/mtab'):
mounts_path = os.path.realpath("/etc/mtab")
else:
mounts_path = os.path.realpath("%s/self/mounts" % procfs_path)
retlist = []
partitions = cext.disk_partitions(mounts_path)
for partition in partitions:
device, mountpoint, fstype, opts = partition
if device == 'none':
device = ''
if device in ("/dev/root", "rootfs"):
device = RootFsDeviceFinder().find() or device
if not all:
if not device or fstype not in fstypes:
continue
ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
retlist.append(ntuple)
return retlist
# =====================================================================
# --- sensors
# =====================================================================
def sensors_temperatures():
"""Return hardware (CPU and others) temperatures as a dict
including hardware name, label, current, max and critical
temperatures.
Implementation notes:
- /sys/class/hwmon looks like the most recent interface to
retrieve this info, and this implementation relies on it
only (old distros will probably use something else)
- lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
- /sys/class/thermal/thermal_zone* is another one but it's more
difficult to parse
"""
ret = collections.defaultdict(list)
basenames = glob.glob('/sys/class/hwmon/hwmon*/temp*_*')
# CentOS has an intermediate /device directory:
# https://github.com/giampaolo/psutil/issues/971
# https://github.com/nicolargo/glances/issues/1060
basenames.extend(glob.glob('/sys/class/hwmon/hwmon*/device/temp*_*'))
basenames = sorted(set([x.split('_')[0] for x in basenames]))
# Only add the coretemp hwmon entries if they're not already in
# /sys/class/hwmon/
# https://github.com/giampaolo/psutil/issues/1708
# https://github.com/giampaolo/psutil/pull/1648
basenames2 = glob.glob(
'/sys/devices/platform/coretemp.*/hwmon/hwmon*/temp*_*'
)
repl = re.compile('/sys/devices/platform/coretemp.*/hwmon/')
for name in basenames2:
altname = repl.sub('/sys/class/hwmon/', name)
if altname not in basenames:
basenames.append(name)
for base in basenames:
try:
path = base + '_input'
current = float(bcat(path)) / 1000.0
path = os.path.join(os.path.dirname(base), 'name')
unit_name = cat(path).strip()
except (IOError, OSError, ValueError):
# A lot of things can go wrong here, so let's just skip the
# whole entry. Sure thing is Linux's /sys/class/hwmon really
# is a stinky broken mess.
# https://github.com/giampaolo/psutil/issues/1009
# https://github.com/giampaolo/psutil/issues/1101
# https://github.com/giampaolo/psutil/issues/1129
# https://github.com/giampaolo/psutil/issues/1245
# https://github.com/giampaolo/psutil/issues/1323
continue
high = bcat(base + '_max', fallback=None)
critical = bcat(base + '_crit', fallback=None)
label = cat(base + '_label', fallback='').strip()
if high is not None:
try:
high = float(high) / 1000.0
except ValueError:
high = None
if critical is not None:
try:
critical = float(critical) / 1000.0
except ValueError:
critical = None
ret[unit_name].append((label, current, high, critical))
# Indication that no sensors were detected in /sys/class/hwmon/
if not basenames:
basenames = glob.glob('/sys/class/thermal/thermal_zone*')
basenames = sorted(set(basenames))
for base in basenames:
try:
path = os.path.join(base, 'temp')
current = float(bcat(path)) / 1000.0
path = os.path.join(base, 'type')
unit_name = cat(path).strip()
except (IOError, OSError, ValueError) as err:
debug(err)
continue
trip_paths = glob.glob(base + '/trip_point*')
trip_points = set([
'_'.join(os.path.basename(p).split('_')[0:3])
for p in trip_paths
])
critical = None
high = None
for trip_point in trip_points:
path = os.path.join(base, trip_point + "_type")
trip_type = cat(path, fallback='').strip()
if trip_type == 'critical':
critical = bcat(
os.path.join(base, trip_point + "_temp"), fallback=None
)
elif trip_type == 'high':
high = bcat(
os.path.join(base, trip_point + "_temp"), fallback=None
)
if high is not None:
try:
high = float(high) / 1000.0
except ValueError:
high = None
if critical is not None:
try:
critical = float(critical) / 1000.0
except ValueError:
critical = None
ret[unit_name].append(('', current, high, critical))
return dict(ret)
def sensors_fans():
"""Return hardware fans info (for CPU and other peripherals) as a
dict including hardware label and current speed.
Implementation notes:
- /sys/class/hwmon looks like the most recent interface to
retrieve this info, and this implementation relies on it
only (old distros will probably use something else)
- lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
"""
ret = collections.defaultdict(list)
basenames = glob.glob('/sys/class/hwmon/hwmon*/fan*_*')
if not basenames:
# CentOS has an intermediate /device directory:
# https://github.com/giampaolo/psutil/issues/971
basenames = glob.glob('/sys/class/hwmon/hwmon*/device/fan*_*')
basenames = sorted(set([x.split('_')[0] for x in basenames]))
for base in basenames:
try:
current = int(bcat(base + '_input'))
except (IOError, OSError) as err:
debug(err)
continue
unit_name = cat(os.path.join(os.path.dirname(base), 'name')).strip()
label = cat(base + '_label', fallback='').strip()
ret[unit_name].append(_common.sfan(label, current))
return dict(ret)
def sensors_battery():
"""Return battery information.
Implementation note: it appears /sys/class/power_supply/BAT0/
directory structure may vary and provide files with the same
meaning but under different names, see:
https://github.com/giampaolo/psutil/issues/966.
"""
null = object()
def multi_bcat(*paths):
"""Attempt to read the content of multiple files which may
not exist. If none of them exist return None.
"""
for path in paths:
ret = bcat(path, fallback=null)
if ret != null:
try:
return int(ret)
except ValueError:
return ret.strip()
return None
bats = [
x
for x in os.listdir(POWER_SUPPLY_PATH)
if x.startswith('BAT') or 'battery' in x.lower()
]
if not bats:
return None
# Get the first available battery. Usually this is "BAT0", except
# some rare exceptions:
# https://github.com/giampaolo/psutil/issues/1238
root = os.path.join(POWER_SUPPLY_PATH, sorted(bats)[0])
# Base metrics.
energy_now = multi_bcat(root + "/energy_now", root + "/charge_now")
power_now = multi_bcat(root + "/power_now", root + "/current_now")
energy_full = multi_bcat(root + "/energy_full", root + "/charge_full")
time_to_empty = multi_bcat(root + "/time_to_empty_now")
# Percent. If we have energy_full the percentage will be more
# accurate compared to reading /capacity file (float vs. int).
if energy_full is not None and energy_now is not None:
try:
percent = 100.0 * energy_now / energy_full
except ZeroDivisionError:
percent = 0.0
else:
percent = int(cat(root + "/capacity", fallback=-1))
if percent == -1:
return None
# Is AC power cable plugged in?
# Note: AC0 is not always available and sometimes (e.g. CentOS7)
# it's called "AC".
power_plugged = None
online = multi_bcat(
os.path.join(POWER_SUPPLY_PATH, "AC0/online"),
os.path.join(POWER_SUPPLY_PATH, "AC/online"),
)
if online is not None:
power_plugged = online == 1
else:
status = cat(root + "/status", fallback="").strip().lower()
if status == "discharging":
power_plugged = False
elif status in ("charging", "full"):
power_plugged = True
# Seconds left.
# Note to self: we may also calculate the charging ETA as per:
# https://github.com/thialfihar/dotfiles/blob/
# 013937745fd9050c30146290e8f963d65c0179e6/bin/battery.py#L55
if power_plugged:
secsleft = _common.POWER_TIME_UNLIMITED
elif energy_now is not None and power_now is not None:
try:
secsleft = int(energy_now / power_now * 3600)
except ZeroDivisionError:
secsleft = _common.POWER_TIME_UNKNOWN
elif time_to_empty is not None:
secsleft = int(time_to_empty * 60)
if secsleft < 0:
secsleft = _common.POWER_TIME_UNKNOWN
else:
secsleft = _common.POWER_TIME_UNKNOWN
return _common.sbattery(percent, secsleft, power_plugged)
# =====================================================================
# --- other system functions
# =====================================================================
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
for item in rawlist:
user, tty, hostname, tstamp, pid = item
nt = _common.suser(user, tty or None, hostname, tstamp, pid)
retlist.append(nt)
return retlist
def boot_time():
"""Return the system boot time expressed in seconds since the epoch."""
global BOOT_TIME
path = '%s/stat' % get_procfs_path()
with open_binary(path) as f:
for line in f:
if line.startswith(b'btime'):
ret = float(line.strip().split()[1])
BOOT_TIME = ret
return ret
raise RuntimeError("line 'btime' not found in %s" % path)
# =====================================================================
# --- processes
# =====================================================================
def pids():
"""Returns a list of PIDs currently running on the system."""
return [int(x) for x in os.listdir(b(get_procfs_path())) if x.isdigit()]
def pid_exists(pid):
"""Check for the existence of a unix PID. Linux TIDs are not
supported (always return False).
"""
if not _psposix.pid_exists(pid):
return False
else:
# Linux's apparently does not distinguish between PIDs and TIDs
# (thread IDs).
# listdir("/proc") won't show any TID (only PIDs) but
# os.stat("/proc/{tid}") will succeed if {tid} exists.
# os.kill() can also be passed a TID. This is quite confusing.
# In here we want to enforce this distinction and support PIDs
# only, see:
# https://github.com/giampaolo/psutil/issues/687
try:
# Note: already checked that this is faster than using a
# regular expr. Also (a lot) faster than doing
# 'return pid in pids()'
path = "%s/%s/status" % (get_procfs_path(), pid)
with open_binary(path) as f:
for line in f:
if line.startswith(b"Tgid:"):
tgid = int(line.split()[1])
# If tgid and pid are the same then we're
# dealing with a process PID.
return tgid == pid
raise ValueError("'Tgid' line not found in %s" % path)
except (EnvironmentError, ValueError):
return pid in pids()
def ppid_map():
"""Obtain a {pid: ppid, ...} dict for all running processes in
one shot. Used to speed up Process.children().
"""
ret = {}
procfs_path = get_procfs_path()
for pid in pids():
try:
with open_binary("%s/%s/stat" % (procfs_path, pid)) as f:
data = f.read()
except (FileNotFoundError, ProcessLookupError):
# Note: we should be able to access /stat for all processes
# aka it's unlikely we'll bump into EPERM, which is good.
pass
else:
rpar = data.rfind(b')')
dset = data[rpar + 2 :].split()
ppid = int(dset[1])
ret[pid] = ppid
return ret
def wrap_exceptions(fun):
"""Decorator which translates bare OSError and IOError exceptions
into NoSuchProcess and AccessDenied.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except PermissionError:
raise AccessDenied(self.pid, self._name)
except ProcessLookupError:
self._raise_if_zombie()
raise NoSuchProcess(self.pid, self._name)
except FileNotFoundError:
self._raise_if_zombie()
if not os.path.exists("%s/%s" % (self._procfs_path, self.pid)):
raise NoSuchProcess(self.pid, self._name)
raise
return wrapper
class Process:
"""Linux process implementation."""
__slots__ = ["_cache", "_name", "_ppid", "_procfs_path", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
self._procfs_path = get_procfs_path()
def _is_zombie(self):
# Note: most of the times Linux is able to return info about the
# process even if it's a zombie, and /proc/{pid} will exist.
# There are some exceptions though, like exe(), cmdline() and
# memory_maps(). In these cases /proc/{pid}/{file} exists but
# it's empty. Instead of returning a "null" value we'll raise an
# exception.
try:
data = bcat("%s/%s/stat" % (self._procfs_path, self.pid))
except (IOError, OSError):
return False
else:
rpar = data.rfind(b')')
status = data[rpar + 2 : rpar + 3]
return status == b"Z"
def _raise_if_zombie(self):
if self._is_zombie():
raise ZombieProcess(self.pid, self._name, self._ppid)
def _raise_if_not_alive(self):
"""Raise NSP if the process disappeared on us."""
# For those C function who do not raise NSP, possibly returning
# incorrect or incomplete result.
os.stat('%s/%s' % (self._procfs_path, self.pid))
@wrap_exceptions
@memoize_when_activated
def _parse_stat_file(self):
"""Parse /proc/{pid}/stat file and return a dict with various
process info.
Using "man proc" as a reference: where "man proc" refers to
position N always subtract 3 (e.g ppid position 4 in
'man proc' == position 1 in here).
The return value is cached in case oneshot() ctx manager is
in use.
"""
data = bcat("%s/%s/stat" % (self._procfs_path, self.pid))
# Process name is between parentheses. It can contain spaces and
# other parentheses. This is taken into account by looking for
# the first occurrence of "(" and the last occurrence of ")".
rpar = data.rfind(b')')
name = data[data.find(b'(') + 1 : rpar]
fields = data[rpar + 2 :].split()
ret = {}
ret['name'] = name
ret['status'] = fields[0]
ret['ppid'] = fields[1]
ret['ttynr'] = fields[4]
ret['utime'] = fields[11]
ret['stime'] = fields[12]
ret['children_utime'] = fields[13]
ret['children_stime'] = fields[14]
ret['create_time'] = fields[19]
ret['cpu_num'] = fields[36]
try:
ret['blkio_ticks'] = fields[39] # aka 'delayacct_blkio_ticks'
except IndexError:
# https://github.com/giampaolo/psutil/issues/2455
debug("can't get blkio_ticks, set iowait to 0")
ret['blkio_ticks'] = 0
return ret
@wrap_exceptions
@memoize_when_activated
def _read_status_file(self):
"""Read /proc/{pid}/stat file and return its content.
The return value is cached in case oneshot() ctx manager is
in use.
"""
with open_binary("%s/%s/status" % (self._procfs_path, self.pid)) as f:
return f.read()
@wrap_exceptions
@memoize_when_activated
def _read_smaps_file(self):
with open_binary("%s/%s/smaps" % (self._procfs_path, self.pid)) as f:
return f.read().strip()
def oneshot_enter(self):
self._parse_stat_file.cache_activate(self)
self._read_status_file.cache_activate(self)
self._read_smaps_file.cache_activate(self)
def oneshot_exit(self):
self._parse_stat_file.cache_deactivate(self)
self._read_status_file.cache_deactivate(self)
self._read_smaps_file.cache_deactivate(self)
@wrap_exceptions
def name(self):
name = self._parse_stat_file()['name']
if PY3:
name = decode(name)
# XXX - gets changed later and probably needs refactoring
return name
@wrap_exceptions
def exe(self):
try:
return readlink("%s/%s/exe" % (self._procfs_path, self.pid))
except (FileNotFoundError, ProcessLookupError):
self._raise_if_zombie()
# no such file error; might be raised also if the
# path actually exists for system processes with
# low pids (about 0-20)
if os.path.lexists("%s/%s" % (self._procfs_path, self.pid)):
return ""
raise
@wrap_exceptions
def cmdline(self):
with open_text("%s/%s/cmdline" % (self._procfs_path, self.pid)) as f:
data = f.read()
if not data:
# may happen in case of zombie process
self._raise_if_zombie()
return []
# 'man proc' states that args are separated by null bytes '\0'
# and last char is supposed to be a null byte. Nevertheless
# some processes may change their cmdline after being started
# (via setproctitle() or similar), they are usually not
# compliant with this rule and use spaces instead. Google
# Chrome process is an example. See:
# https://github.com/giampaolo/psutil/issues/1179
sep = '\x00' if data.endswith('\x00') else ' '
if data.endswith(sep):
data = data[:-1]
cmdline = data.split(sep)
# Sometimes last char is a null byte '\0' but the args are
# separated by spaces, see: https://github.com/giampaolo/psutil/
# issues/1179#issuecomment-552984549
if sep == '\x00' and len(cmdline) == 1 and ' ' in data:
cmdline = data.split(' ')
return cmdline
@wrap_exceptions
def environ(self):
with open_text("%s/%s/environ" % (self._procfs_path, self.pid)) as f:
data = f.read()
return parse_environ_block(data)
@wrap_exceptions
def terminal(self):
tty_nr = int(self._parse_stat_file()['ttynr'])
tmap = _psposix.get_terminal_map()
try:
return tmap[tty_nr]
except KeyError:
return None
# May not be available on old kernels.
if os.path.exists('/proc/%s/io' % os.getpid()):
@wrap_exceptions
def io_counters(self):
fname = "%s/%s/io" % (self._procfs_path, self.pid)
fields = {}
with open_binary(fname) as f:
for line in f:
# https://github.com/giampaolo/psutil/issues/1004
line = line.strip()
if line:
try:
name, value = line.split(b': ')
except ValueError:
# https://github.com/giampaolo/psutil/issues/1004
continue
else:
fields[name] = int(value)
if not fields:
raise RuntimeError("%s file was empty" % fname)
try:
return pio(
fields[b'syscr'], # read syscalls
fields[b'syscw'], # write syscalls
fields[b'read_bytes'], # read bytes
fields[b'write_bytes'], # write bytes
fields[b'rchar'], # read chars
fields[b'wchar'], # write chars
)
except KeyError as err:
raise ValueError(
"%r field was not found in %s; found fields are %r"
% (err.args[0], fname, fields)
)
@wrap_exceptions
def cpu_times(self):
values = self._parse_stat_file()
utime = float(values['utime']) / CLOCK_TICKS
stime = float(values['stime']) / CLOCK_TICKS
children_utime = float(values['children_utime']) / CLOCK_TICKS
children_stime = float(values['children_stime']) / CLOCK_TICKS
iowait = float(values['blkio_ticks']) / CLOCK_TICKS
return pcputimes(utime, stime, children_utime, children_stime, iowait)
@wrap_exceptions
def cpu_num(self):
"""What CPU the process is on."""
return int(self._parse_stat_file()['cpu_num'])
@wrap_exceptions
def wait(self, timeout=None):
return _psposix.wait_pid(self.pid, timeout, self._name)
@wrap_exceptions
def create_time(self):
ctime = float(self._parse_stat_file()['create_time'])
# According to documentation, starttime is in field 21 and the
# unit is jiffies (clock ticks).
# We first divide it for clock ticks and then add uptime returning
# seconds since the epoch.
# Also use cached value if available.
bt = BOOT_TIME or boot_time()
return (ctime / CLOCK_TICKS) + bt
@wrap_exceptions
def memory_info(self):
# ============================================================
# | FIELD | DESCRIPTION | AKA | TOP |
# ============================================================
# | rss | resident set size | | RES |
# | vms | total program size | size | VIRT |
# | shared | shared pages (from shared mappings) | | SHR |
# | text | text ('code') | trs | CODE |
# | lib | library (unused in Linux 2.6) | lrs | |
# | data | data + stack | drs | DATA |
# | dirty | dirty pages (unused in Linux 2.6) | dt | |
# ============================================================
with open_binary("%s/%s/statm" % (self._procfs_path, self.pid)) as f:
vms, rss, shared, text, lib, data, dirty = (
int(x) * PAGESIZE for x in f.readline().split()[:7]
)
return pmem(rss, vms, shared, text, lib, data, dirty)
if HAS_PROC_SMAPS_ROLLUP or HAS_PROC_SMAPS:
def _parse_smaps_rollup(self):
# /proc/pid/smaps_rollup was added to Linux in 2017. Faster
# than /proc/pid/smaps. It reports higher PSS than */smaps
# (from 1k up to 200k higher; tested against all processes).
# IMPORTANT: /proc/pid/smaps_rollup is weird, because it
# raises ESRCH / ENOENT for many PIDs, even if they're alive
# (also as root). In that case we'll use /proc/pid/smaps as
# fallback, which is slower but has a +50% success rate
# compared to /proc/pid/smaps_rollup.
uss = pss = swap = 0
with open_binary(
"{}/{}/smaps_rollup".format(self._procfs_path, self.pid)
) as f:
for line in f:
if line.startswith(b"Private_"):
# Private_Clean, Private_Dirty, Private_Hugetlb
uss += int(line.split()[1]) * 1024
elif line.startswith(b"Pss:"):
pss = int(line.split()[1]) * 1024
elif line.startswith(b"Swap:"):
swap = int(line.split()[1]) * 1024
return (uss, pss, swap)
@wrap_exceptions
def _parse_smaps(
self,
# Gets Private_Clean, Private_Dirty, Private_Hugetlb.
_private_re=re.compile(br"\nPrivate.*:\s+(\d+)"),
_pss_re=re.compile(br"\nPss\:\s+(\d+)"),
_swap_re=re.compile(br"\nSwap\:\s+(\d+)"),
):
# /proc/pid/smaps does not exist on kernels < 2.6.14 or if
# CONFIG_MMU kernel configuration option is not enabled.
# Note: using 3 regexes is faster than reading the file
# line by line.
# XXX: on Python 3 the 2 regexes are 30% slower than on
# Python 2 though. Figure out why.
#
# You might be tempted to calculate USS by subtracting
# the "shared" value from the "resident" value in
# /proc/<pid>/statm. But at least on Linux, statm's "shared"
# value actually counts pages backed by files, which has
# little to do with whether the pages are actually shared.
# /proc/self/smaps on the other hand appears to give us the
# correct information.
smaps_data = self._read_smaps_file()
# Note: smaps file can be empty for certain processes.
# The code below will not crash though and will result to 0.
uss = sum(map(int, _private_re.findall(smaps_data))) * 1024
pss = sum(map(int, _pss_re.findall(smaps_data))) * 1024
swap = sum(map(int, _swap_re.findall(smaps_data))) * 1024
return (uss, pss, swap)
@wrap_exceptions
def memory_full_info(self):
if HAS_PROC_SMAPS_ROLLUP: # faster
try:
uss, pss, swap = self._parse_smaps_rollup()
except (ProcessLookupError, FileNotFoundError):
uss, pss, swap = self._parse_smaps()
else:
uss, pss, swap = self._parse_smaps()
basic_mem = self.memory_info()
return pfullmem(*basic_mem + (uss, pss, swap))
else:
memory_full_info = memory_info
if HAS_PROC_SMAPS:
@wrap_exceptions
def memory_maps(self):
"""Return process's mapped memory regions as a list of named
tuples. Fields are explained in 'man proc'; here is an updated
(Apr 2012) version: http://goo.gl/fmebo.
/proc/{PID}/smaps does not exist on kernels < 2.6.14 or if
CONFIG_MMU kernel configuration option is not enabled.
"""
def get_blocks(lines, current_block):
data = {}
for line in lines:
fields = line.split(None, 5)
if not fields[0].endswith(b':'):
# new block section
yield (current_block.pop(), data)
current_block.append(line)
else:
try:
data[fields[0]] = int(fields[1]) * 1024
except ValueError:
if fields[0].startswith(b'VmFlags:'):
# see issue #369
continue
else:
raise ValueError(
"don't know how to interpret line %r"
% line
)
yield (current_block.pop(), data)
data = self._read_smaps_file()
# Note: smaps file can be empty for certain processes or for
# zombies.
if not data:
self._raise_if_zombie()
return []
lines = data.split(b'\n')
ls = []
first_line = lines.pop(0)
current_block = [first_line]
for header, data in get_blocks(lines, current_block):
hfields = header.split(None, 5)
try:
addr, perms, _offset, _dev, _inode, path = hfields
except ValueError:
addr, perms, _offset, _dev, _inode, path = hfields + ['']
if not path:
path = '[anon]'
else:
if PY3:
path = decode(path)
path = path.strip()
if path.endswith(' (deleted)') and not path_exists_strict(
path
):
path = path[:-10]
item = (
decode(addr),
decode(perms),
path,
data.get(b'Rss:', 0),
data.get(b'Size:', 0),
data.get(b'Pss:', 0),
data.get(b'Shared_Clean:', 0),
data.get(b'Shared_Dirty:', 0),
data.get(b'Private_Clean:', 0),
data.get(b'Private_Dirty:', 0),
data.get(b'Referenced:', 0),
data.get(b'Anonymous:', 0),
data.get(b'Swap:', 0),
)
ls.append(item)
return ls
@wrap_exceptions
def cwd(self):
return readlink("%s/%s/cwd" % (self._procfs_path, self.pid))
@wrap_exceptions
def num_ctx_switches(
self, _ctxsw_re=re.compile(br'ctxt_switches:\t(\d+)')
):
data = self._read_status_file()
ctxsw = _ctxsw_re.findall(data)
if not ctxsw:
raise NotImplementedError(
"'voluntary_ctxt_switches' and 'nonvoluntary_ctxt_switches'"
"lines were not found in %s/%s/status; the kernel is "
"probably older than 2.6.23" % (self._procfs_path, self.pid)
)
else:
return _common.pctxsw(int(ctxsw[0]), int(ctxsw[1]))
@wrap_exceptions
def num_threads(self, _num_threads_re=re.compile(br'Threads:\t(\d+)')):
# Note: on Python 3 using a re is faster than iterating over file
# line by line. On Python 2 is the exact opposite, and iterating
# over a file on Python 3 is slower than on Python 2.
data = self._read_status_file()
return int(_num_threads_re.findall(data)[0])
@wrap_exceptions
def threads(self):
thread_ids = os.listdir("%s/%s/task" % (self._procfs_path, self.pid))
thread_ids.sort()
retlist = []
hit_enoent = False
for thread_id in thread_ids:
fname = "%s/%s/task/%s/stat" % (
self._procfs_path,
self.pid,
thread_id,
)
try:
with open_binary(fname) as f:
st = f.read().strip()
except (FileNotFoundError, ProcessLookupError):
# no such file or directory or no such process;
# it means thread disappeared on us
hit_enoent = True
continue
# ignore the first two values ("pid (exe)")
st = st[st.find(b')') + 2 :]
values = st.split(b' ')
utime = float(values[11]) / CLOCK_TICKS
stime = float(values[12]) / CLOCK_TICKS
ntuple = _common.pthread(int(thread_id), utime, stime)
retlist.append(ntuple)
if hit_enoent:
self._raise_if_not_alive()
return retlist
@wrap_exceptions
def nice_get(self):
# with open_text('%s/%s/stat' % (self._procfs_path, self.pid)) as f:
# data = f.read()
# return int(data.split()[18])
# Use C implementation
return cext_posix.getpriority(self.pid)
@wrap_exceptions
def nice_set(self, value):
return cext_posix.setpriority(self.pid, value)
# starting from CentOS 6.
if HAS_CPU_AFFINITY:
@wrap_exceptions
def cpu_affinity_get(self):
return cext.proc_cpu_affinity_get(self.pid)
def _get_eligible_cpus(
self, _re=re.compile(br"Cpus_allowed_list:\t(\d+)-(\d+)")
):
# See: https://github.com/giampaolo/psutil/issues/956
data = self._read_status_file()
match = _re.findall(data)
if match:
return list(range(int(match[0][0]), int(match[0][1]) + 1))
else:
return list(range(len(per_cpu_times())))
@wrap_exceptions
def cpu_affinity_set(self, cpus):
try:
cext.proc_cpu_affinity_set(self.pid, cpus)
except (OSError, ValueError) as err:
if isinstance(err, ValueError) or err.errno == errno.EINVAL:
eligible_cpus = self._get_eligible_cpus()
all_cpus = tuple(range(len(per_cpu_times())))
for cpu in cpus:
if cpu not in all_cpus:
raise ValueError(
"invalid CPU number %r; choose between %s"
% (cpu, eligible_cpus)
)
if cpu not in eligible_cpus:
raise ValueError(
"CPU number %r is not eligible; choose "
"between %s" % (cpu, eligible_cpus)
)
raise
# only starting from kernel 2.6.13
if HAS_PROC_IO_PRIORITY:
@wrap_exceptions
def ionice_get(self):
ioclass, value = cext.proc_ioprio_get(self.pid)
if enum is not None:
ioclass = IOPriority(ioclass)
return _common.pionice(ioclass, value)
@wrap_exceptions
def ionice_set(self, ioclass, value):
if value is None:
value = 0
if value and ioclass in (IOPRIO_CLASS_IDLE, IOPRIO_CLASS_NONE):
raise ValueError("%r ioclass accepts no value" % ioclass)
if value < 0 or value > 7:
msg = "value not in 0-7 range"
raise ValueError(msg)
return cext.proc_ioprio_set(self.pid, ioclass, value)
if prlimit is not None:
@wrap_exceptions
def rlimit(self, resource_, limits=None):
# If pid is 0 prlimit() applies to the calling process and
# we don't want that. We should never get here though as
# PID 0 is not supported on Linux.
if self.pid == 0:
msg = "can't use prlimit() against PID 0 process"
raise ValueError(msg)
try:
if limits is None:
# get
return prlimit(self.pid, resource_)
else:
# set
if len(limits) != 2:
msg = (
"second argument must be a (soft, hard) "
+ "tuple, got %s" % repr(limits)
)
raise ValueError(msg)
prlimit(self.pid, resource_, limits)
except OSError as err:
if err.errno == errno.ENOSYS:
# I saw this happening on Travis:
# https://travis-ci.org/giampaolo/psutil/jobs/51368273
self._raise_if_zombie()
raise
@wrap_exceptions
def status(self):
letter = self._parse_stat_file()['status']
if PY3:
letter = letter.decode()
# XXX is '?' legit? (we're not supposed to return it anyway)
return PROC_STATUSES.get(letter, '?')
@wrap_exceptions
def open_files(self):
retlist = []
files = os.listdir("%s/%s/fd" % (self._procfs_path, self.pid))
hit_enoent = False
for fd in files:
file = "%s/%s/fd/%s" % (self._procfs_path, self.pid, fd)
try:
path = readlink(file)
except (FileNotFoundError, ProcessLookupError):
# ENOENT == file which is gone in the meantime
hit_enoent = True
continue
except OSError as err:
if err.errno == errno.EINVAL:
# not a link
continue
if err.errno == errno.ENAMETOOLONG:
# file name too long
debug(err)
continue
raise
else:
# If path is not an absolute there's no way to tell
# whether it's a regular file or not, so we skip it.
# A regular file is always supposed to be have an
# absolute path though.
if path.startswith('/') and isfile_strict(path):
# Get file position and flags.
file = "%s/%s/fdinfo/%s" % (
self._procfs_path,
self.pid,
fd,
)
try:
with open_binary(file) as f:
pos = int(f.readline().split()[1])
flags = int(f.readline().split()[1], 8)
except (FileNotFoundError, ProcessLookupError):
# fd gone in the meantime; process may
# still be alive
hit_enoent = True
else:
mode = file_flags_to_mode(flags)
ntuple = popenfile(
path, int(fd), int(pos), mode, flags
)
retlist.append(ntuple)
if hit_enoent:
self._raise_if_not_alive()
return retlist
@wrap_exceptions
def net_connections(self, kind='inet'):
ret = _net_connections.retrieve(kind, self.pid)
self._raise_if_not_alive()
return ret
@wrap_exceptions
def num_fds(self):
return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
@wrap_exceptions
def ppid(self):
return int(self._parse_stat_file()['ppid'])
@wrap_exceptions
def uids(self, _uids_re=re.compile(br'Uid:\t(\d+)\t(\d+)\t(\d+)')):
data = self._read_status_file()
real, effective, saved = _uids_re.findall(data)[0]
return _common.puids(int(real), int(effective), int(saved))
@wrap_exceptions
def gids(self, _gids_re=re.compile(br'Gid:\t(\d+)\t(\d+)\t(\d+)')):
data = self._read_status_file()
real, effective, saved = _gids_re.findall(data)[0]
return _common.pgids(int(real), int(effective), int(saved))
PK ok\�#�!x� x� psutil/_psutil_linux.abi3.sonu ȯ�� ELF > 0$ @ �� @ 8 @ # "
%
% P P P ` ` �] �m �m � � �] �m �m � � 8 8 8 $ $ P�td �T �T �T � � Q�td R�td �] �m �m X X GNU !?��CT��Va2 ���<� G c�9
�$҈� �� G H J M O P S T V W X [ \ �����
U��� �ȷ��r:�H���$����"ոf�ذ�u
U;hdeG�� ������w������l�� ������W�~�_aY � Q � � � B � � � � � � M < V � � � 5 f � � ( � � � � � � � � & � H � - - � n � � 6 x 7 N � v � [ � � � 8 � � R " z � E � `? � ~ 06 W � & � ~ �u � 7 � �9 z � �% � + 9 � n 0= & � �6 i W �< y c 6
�& j � �@ H a �$ � � �C Q @ 0< t ] ' W � �' ) � @C d __gmon_start__ _init _fini _ITM_deregisterTMCloneTable _ITM_registerTMCloneTable __cxa_finalize psutil_PyErr_SetFromOSErrnoWithSyscall __errno_location strerror sprintf PyExc_OSError PyObject_CallFunction PyErr_SetObject _Py_Dealloc NoSuchProcess AccessDenied psutil_check_pid_range PyArg_ParseTuple _Py_NoneStruct PyExc_ValueError PyErr_SetString psutil_set_debug PyObject_IsTrue PSUTIL_DEBUG psutil_setup getenv socket strncpy ioctl close Py_BuildValue PyErr_SetFromErrno _Py_TrueStruct _Py_FalseStruct setpriority getnameinfo PyList_New getifaddrs PyList_Append freeifaddrs getpriority PyUnicode_FromString psutil_getpagesize sysconf psutil_pid_exists kill psutil_raise_for_pid PyExc_RuntimeError PyErr_Format PyInit__psutil_posix PyModule_Create2 PyModule_AddIntConstant PyLong_FromLong PyModule_AddObject PyInit__psutil_linux psutil_proc_ioprio_get psutil_proc_ioprio_set psutil_proc_cpu_affinity_get psutil_proc_cpu_affinity_set psutil_disk_partitions psutil_users psutil_net_if_duplex_speed psutil_linux_sysinfo PyEval_SaveThread setmntent PyEval_RestoreThread getmntent PyUnicode_DecodeFSDefault endmntent PyErr_SetFromErrnoWithFilename stderr fprintf fwrite fputc syscall __sched_cpualloc sched_getaffinity __sched_cpufree PyExc_OverflowError PyErr_NoMemory __sched_cpucount PySequence_Check PySequence_Size PyErr_Occurred PySequence_GetItem PyLong_AsLong PyExc_TypeError sched_setaffinity setutent getutent endutent libpthread.so.0 libc.so.6 GLIBC_2.2.5 GLIBC_2.7 GLIBC_2.3 GLIBC_2.3.4 GLIBC_2.6 � ui � � ii
� ii
� ti � ii
� ui � �m �$ �m �$ �m �m Hr MR `r �r �r [R �r 6 �r gR �r �. �r sR �r �* s �R s / s �R (s `( @s �R Hs �' `s �R hs @) �s �R �s t t �R @t S `t S �t )S �t ?S �t OS �t US u iS u wS @u �S �o �o �o �o �o �o ! �o # �o % �o . �o 4 �o L �o A �o D �o E (t Y Ht S ht Q �t H �t N �t V �t X u \ (u U Hu Z p p (p 0p 8p @p Hp Pp Xp
`p hp pp
xp �p �p �p �p T �p �p �p �p �p �p �p �p �p �p �p �p " q # q $ q & q ' q ( (q ) 0q * 8q W @q + Hq , Pq - Xq / `q 0 hq 1 pq 2 xq J �q O �q 3 �q 5 �q 6 �q 7 �q 8 �q 9 �q : �q ; �q < �q = �q > �q ? �q @ �q B �q C r D r [ r F H��H��O H��t�� H��� �5�O �%�O @ �%�O h ����%�O h �����%�O h ����%�O h ����%�O h ����%�O h ����%�O h ����%�O h �p����%�O h �`����%�O h �P����%�O h
�@����%�O h �0����%�O h � ����%zO h
�����%rO h � ����%jO h ���%bO h ����%ZO h �����%RO h ����%JO h ����%BO h ����%:O h ����%2O h ����%*O h �p����%"O h �`����%O h �P����%O h �@����%
O h �0����%O h � ����%�N h �����%�N h � ����%�N h ���%�N h ����%�N h! �����%�N h" ����%�N h# ����%�N h$ ����%�N h% ����%�N h& ����%�N h' �p����%�N h( �`����%�N h) �P����%�N h* �@����%�N h+ �0����%�N h, � ����%zN h- �����%rN h. � ����%jN h/ ���%bN h0 ����%ZN h1 �����%RN h2 ����%JN h3 ����%BN h4 ����%:N h5 ����%2N h6 ����%*N h7 �p����%"N h8 �`����%N h9 �P����%N h: �@����%
N h; �0����%N h< � ����%�M h= �����%�M h> � ����%�M h? ��H�=IQ H�BQ H9�tH�FK H��t �� � � � H�=Q H�5Q H)�H��H��?H��H�H�tH�]K H��t��f D � � �=�P u/UH�=>K H��t H�=�H �=����h�����P ]� � � � �{���f. � �AUATI��UH�� �|���I��8H������L��H�5�* L��H��1�����U 1�L��L�%yJ H�5�* I�<$����I�<$H��H�����H��tH�m tH�� 1�]A\A]� � H���P���H�� 1�]A\A]ÐATH��H�5�* 1�USH�� I��L������1�L�� H� �I H�5N* H�;�>���H�;H��H������H��tH�m tH�� 1�[]A\�f D H������H�� 1�[]A\�f. � ATH��H�54* 1�USH�� I��L���~���1�L��
H� ]I H�5�) H�;���H�;H��H�����H��tH�m tH�� 1�[]A\�f D H���8���H�� 1�[]A\�f. � H��H��H�5�- 1�H�T$ ������t"�D$ ��x*H��H H� H���f. � 1�H���f � H��H H�5�) H�8���1���f D H��H��H�5�* 1�H�T$�����t2H�|$�����x$H��H ���҉H�nH H� H��� D 1�H���f � H��H�=�( ���H��t
H�DH � 1�H��� � UH��1�H�5�* H��@H�T$����A��1�E��tc1Ҿ � �:����Ń��tXL�D$H�t$� L�������!� �D$ H��1��&������t �*����t$ H�=U, 1����H��@]�f�� ���H�dG H�8�l���H��@]�f D UH��1�H�5 * H��@H�T$�e���A��1�E��tm1Ҿ � ����Ń��thL�D$H�t$� L��������� �D$ H��1��v������t/�z����D$ @tCH�5�F H�=2) 1��.���H��@]� � �K���H��F H�8���H��@]�f D H�5�F H�=�( 1����H��@]� D H��H��H�5�* 1�H�L$ H�T$���A��1�E��t �T$ �t$1�������tH�LF H� H��� H�F H�8�!�����ff. � @ H���� AW��AV��AUATUSH�� ��u\��� � H��E�H��E1�E1�j� H���p���H���� H��E H� H�� []A\A]A^A_� � ��u�D�w M��t�I��H��N�,7L��L�%\& D �S H��L��1�H��H���O���I9�u�K�vL��H�=( �D� 1�����f D H��H�=�' 1��w����h���f�H�E H� � @ AW1�AVAUATUSH��(�k���H�D$H���� H�|$��������f H�l$H���� �, � ��0 H��D H� I��I��H��H�uD��M��AUI��L��H�=o% 1�����I��XZM���� H�|$L��L�$�d���L�$���� I�*�N I�,$�V H�+�^ I�/�f I�m �n H�m H���w H�}H��t�D�7D�����H;�C I��t�H���= H�} D�����H��H���E �E��
���H�}(D�����I��H��C H� I��M�������E1�H�|$H��t
L�$����L�$H�T$H�H�$H��H�� M��t
I�*�B M��t I�,$�R H��t
H�+�c M��t
I�/�t M��t I�m �� H�D$ H�D$H��([]A\A]A^A_� � L����I�,$�����L�����H�+�����H�����I�/�����L����I�m �����L����H�m H��������H�l$H������s���f D H�}(D���\���I��H�rB H� I��M���������� D H��L�$�L�L�$M����������f. � L���(���� L����M����������f. � L����H����������f. � H�����M����������f. � L�������� H�|$E1�E1�1�E1�H��� �������f�H�|$E1�E1�E1�H��������H�MA E1�E1�1�E1�H�8�J�E1����f�UH��SH�����H�T$ H�5�% H��� H��1��3�A��1�E��t!�t$ 1����Ƌ��uH�=�% 1��H�H��[]ÐH��@ H�8���H��[]�f. � AU1�ATUH��H��@�-�H��t(I��H�T$1�H��H�5_# ���uI�,$�` E1�H��@L��]A\A]�1Ҿ � ��Ń���T H�t$L�D$� L���
�� ���D$ H��1������6 �����l$ @���� @���> @���� @���: @���� @�� �� @��@� @�ŀ�R f�� �� f�� �� f�� �! f�� �� f�� �� f�� � f�� @�E f�����H�=� ���H��H������H��L���Y��H�E �W H��H�E �����H���7����f�L���(���� H�=. ��I��H���m���H��L�����I�E �� H��I�E ����L��������f D H�=� �D�I��H��� ���H��L�����I�E uuH��I�E �����L�����|���f. � H�=4" ���I��H������H��L���]��I�E u%H��I�E �C���L���?��6���f. � H��I�E �����L�����z��� D H�=� ���d��� � H�=� ��I�,$� ��E1��W�H��@L��]A\A]�f. � H�=� �4�I��H���
���H��L������I�E �a���H��I�E �����L���{��|���f D H�=� ���I��H�������H��L���M���I�E ����H��I�E �C���L���+��6���f D H�=y ��I��H���m���H��L������I�E �����H��I�E �=���L������0���L��������f � H�= �4�I��H���
���H��L������I�E �a���H��I�E ���L���{�����f D H�=� ���I��H�������H��L���M���I�E ����H��I�E �����L���+����f D H�=P ��I��H���m���H��L������I�E �����H��I�E �����L�������f D H�=� �D�I��H��� ���H��L������I�E �q���H��I�E �����L�������f D H�=� ���I��H������H��L���]���I�E �!���H��I�E �q���L���;��d���f D H�=q ��I��H���}���H��L���
���I�E ����H��I�E �,���L������ ���f D H�=) �T�I��H���-���H��L������I�E �����H��I�E ���L��������f D H�=� ��I��H������H��L���m���I�E �1���H��I�E �����L���K����f D H�=� ��I��H�������H��L��� ���I�E ���H��I�E �~���L�����q���H��H�E �M���H������@���ff. � � �v�f D H����H�=& H��H��1����f��� 1��f � H��1����A��� E��t*�#�� ��t ��tH�@9 H�8�H��������1�H���f � UH��SH��H������ ��tH��H��[]�� ���1���uH��H��[]�/� � H��8 H��H�5q H�8H��1�[]�� � AT� H�=; �=�H���� � H�5D H��I���=����� � H�5/ L���!����� 1�H�5" L�������� � H�5 L��������l � H�5 L��������P � H�5� L�������4 � H�5� L������� � H�5� L���|����� � H�5� L���`����� � H�5� L���D����� �
H�5� L���(����� � H�5� L��� ����� �
H�5� L�������ut� H�5� L�������u\� H�5w L������uD� H�5m L������u,H��������H��H��tH�5X L�����
� E1�L��A\�f. � D AT� H�=�: �-�H��tp�b H�5� H��I���1���uU1�H�5r L��� ���u@� H�5f L������u(�� H�5Z L�������u��L��A\� D E1�L��A\�f. � D AW1�AVAUATUH��SH���x�H���w I��H�T$1�H��H�5� �����V �i�H�|$H�5+ L�5� H����H��I����M���� f. � L���X�H��H���� H�;���H��H���� H�{���I��H���3 H�KL�CH��H��L��1���H��H���� H��L���4����� H�m t%I�/t-H�+�u���H���
��h��� � H����I�/u�L�����H�+t�L����H��H���D���L���X��Af D H��4 � ���� H��4 H�t$H�8�k�I�,$u L���� @ E1�H��L��[]A\A]A^A_� L����H�m �� I�/tH��t�H�+u�H���D��f�L���8���f D L����H�m u�H�����y��� @ H� 14 �# H�� 1�H�5� H�;��H� � � H�=� ���H�3�
�������L���H�����H�����I���f D H��H��H�5H 1�H�T$ ��A��1�E��t3�T$ � �� �����t$��H�=e 1��� ��
��H��� @ H�3 H�8�!�H���ff. � �H��H��H�5 1�L�D$ H�L$H�T$� �A��1�E��t.�L$�T$� �� ��
L$ ������tH��2 H� H��� � H��2 H�8���� � AWH��1�H�5H AVA� AUA�@ ATUSH��H�T$ ����u� � E�Ic�L�?��M��I��H��I��H���� �|$ H��L���;��Å��� H��� �����8� A��u�H��1 H�5G E1�H�8�,�H��L��[]A\A]A^A_�H��I�uL�����H����I�m �/ E1��ŐH��1 � ���� ��I��� D 1���I��H��twL��H��I����A�ą�u�_f � ��Hc�L9�s�H��H��H�D� H��s�� �I��H���i���H��L���'���I��B���H��I�t3��A��u�H��������� D H��0 H�8���I������L�������H� �0 �b H�� 1�H�5� H�;���H� � � H�=� ��H�3�
�L����L��������f. � AWH��1�H�5� AVAUATUSH�� H�L$H�T$�T����� H�|$������ H�|$��I��H���� L�l$ � � L���H��� 1�A� �> � I���tb�M�H��uXI��� wL��L��D��H��H��I T� H��I9�tyH�|$H���4�H��H��t&H���$�H�m I��u�H��������H��t`1�H�Ĩ []A\A]A^A_�f�H�D$H�5� H�PH�!/ H�81�� ��� D �|$L�꾀 �����u/H� / H� �H��. H�5F H�D$H�:�;�H�D$�H��. H�8�����l���AW1�AVAUATUSH���;��I��H���, ��f. � �[�H��H��� f�;u�H�{,� �I��H��� H�{���I��H���� �{L:u.�{M0u(�{N u"L�CL� H�=� L����� ���� H�=� ��H��H���� f�D�CH��L���*�T L��� H�=� �I�I��H���� H��L���������� I�/�� I�.tjH�m tCI�,$����L������[�H��H��� ��� � �c��H��L��[]A\A]A^A_ÐH���x��I�,$�����L���e��� L���X���f D L���H���s��� L����H��H��� ���E1�I�/tYI�.taH��tH�m t_M��tI�,$t*I�m t����E1��^����L��E1���������H���L������I�m u���L������I�.u�L������H������I�/u�L������ � H��xH���D���u@�D$hH�=- P1��t$PL�L$PL�D$@H�L$HH�T$8H�t$0���ZYH��x�f � H�, H�8�!��H��x�f. � f�ATH��1�H�5� UE1�H��xH�T$������� 1Ҿ � �7��Ń���� L�D$H�t$� L�����f�F� ��I��H�D$@D$@H�D$ L��1��D$ H�D$` �D$h �D$@ D$P�������tF�T$\�D$L�t$N�� ¸ H�H�=1 1����I��H��t`�����H��xL��]A\�f������ ��_t��u/1Ҿ� �f D H�=� ���H��xI��]L��A\�f D H�=� �����E1��Z��H��xL��]A\� H��H��� %s (originated from %s) (is) PSUTIL_DEBUG assume no such process (originated from %s) assume access denied (originated from %s) pid must be a positive integer %02x: (siOOOO) socket(SOCK_DGRAM) ioctl(SIOCGIFFLAGS) up broadcast loopback pointopoint notrailers noarp promisc allmulti master slave multicast portsel automedia dynamic %s syscall failed RLIMIT_AS RLIMIT_CORE RLIMIT_CPU RLIMIT_DATA RLIMIT_FSIZE RLIMIT_MEMLOCK RLIMIT_NOFILE RLIMIT_NPROC RLIMIT_RSS RLIMIT_STACK RLIMIT_LOCKS RLIMIT_MSGQUEUE RLIMIT_NICE RLIMIT_RTPRIO RLIMIT_RTTIME RLIMIT_SIGPENDING RLIM_INFINITY _psutil_posix getpagesize getpriority net_if_addrs net_if_flags net_if_is_running net_if_mtu setpriority version DUPLEX_HALF DUPLEX_FULL DUPLEX_UNKNOWN _psutil_linux proc_ioprio_get proc_ioprio_set proc_cpu_affinity_get proc_cpu_affinity_set disk_partitions users net_if_duplex_speed linux_sysinfo check_pid_range set_debug psutil/arch/linux/disk.c psutil-debug [%s:%d]> setmntent() failed (OOss) iii psutil/arch/linux/proc.c CPU_ALLOC() failed iO invalid CPU value could not allocate a large enough CPU set sequence argument expected, got %R :0.0 localhost OOOdi (kkkkkkI) socket() ioctl(SIOCETHTOOL) [ii] ;� l�� <��, ���l l��� ���� l�� ���, ���D ���p ���� ���� ��$ ���� L��� L�� \� |�$ ��< L�| \�� ��� |� ��, |�H ��� <�� ��4 ��d zR x � $ `�� FJ w� ?;*3$" < D ��� B�B�D �G�j
CBBH O CBB< � h��� B�M�A �G�L
CABG O CAB< � ���� B�M�A �G�L
CABG O CAB ��j D q
K F
J $ X��W D F
F F D ���) Dd ( \ ���� A�PP{
AC XA 0 � 4��� A�PP�
AI X
AG YA � ���a D H
D ` � 4�� K�D�E �B(�A0�A8�G�\�H�P�Z
8A0A(B BBBI ������� X < ���� B�D�B �B(�A0�A8�D`]hLpXhA`l
8A0A(B BBBH 0 � D��v A�D�D0S
AAB SAA@ � ���� B�D�A �G`y
DBBA �
DBBK L��
$ H�� DP < P��W TB< T ���i A�D�G O
DAH O
DAL XCA � ��� B�� � ���� B��
F HL � 8�z B�D�B �B(�A0�D8�DP�
8D0A(B BBBD $ h�t D W
E S D ��y D \
H H ` ,�& B�N�H �H(�A0�A8�DP�
8D0A(B BBBA L � �� B�N�B �B(�A0�A8�G��
8A0A(B BBBC L � P�H B�D�B �B(�A0�A8�D@A
8D0A(B BBBB , L P�d D�X�F�_�A�D
J S @ | ��Q B�M�G��
DBC p
DEG ZDB �$ �$ �m � �
E �m �m ���o ` �
� p � ( ���o x ���o �o � ���o �m 6 F V f v � � � � � � � � ! ! &! 6! F! V! f! v! �! �! �! �! �! �! �! �! " " &" 6" F" V" f" v" �" �" �" �" �" �" �" �" # # &# 6# F# V# f# v# �# �# �# �# �# �# �# �# $ $ &$ MR ���������r [R 6 gR �. sR �* �R / �R `( �R �' �R @) �R �������� t �R S S )S ?S OS US iS wS �S GCC: (GNU) 10.2.1 20210130 (Red Hat 10.2.1-11) , �$ � , p �' Q , �? 9 � , �E �9 z , 6P 0< � , �_ �@ H , [h @C d , �k �C Q l � ] �$ � � � � � � X int W � x �W � �c � � � � � fv W � z bj } \ T� g G � 8 + : W ; W � 5 j; = l� u m@
) ; � n F � �F � �R ; �R �
W
g ^ �} �u �
3� � � � ,W � R � R� R � * W R � L R � N3 R R : v R P R � � l W m � � �
�� � W � 2
� �W �' ) �� �' � U P � �R ' W �t } � R b �,R C = � �R �h x � W � � :' � f U�TT R Q�h H' � � �R �& j � } �"R � � b �2R � � pid � � �l �& � � U�TT �T Q�l ' � T �P P �R & � �( �� G C exc �R � � msg �
( ��w � � !m �R � � "� !� �R
�& Uv B& P � U��wT `P Q�U b& 3 T P Q=R��w p& Tv #� 9 $- � N sR �% � �L s� G C exc tR � � msg u
( ��w ` � !m zR � � "� !� zR
& Uv �% P U��wT 0P Q�U �% 3 7 T P Q3R��w �% Tv % \R �$ � � \4� I C � ]
( ��w exc dR � � � !m hR � � "0 !� hR " �% Uv % � % m (% P 4 U��wT P R| G% 3 Z T P R��w V% Tv 8 A � F �' Q o � �9 � � � � � X int c � x �c E
�N � �o � �� � � � � R �N � � f� c � z bv G
h� } T �
N I/ � ; � h � Y � R
� � �
�
� �
4 � � q � � �
� � _
�
� ! L
" � # 1 $ � % � & O ' � ( � ) * , + � , } - �
. � / v 0 � 1 � 2 � 3 � 4 0 5 | 6 $ 7 H 8 9 L : p ; � < , < � = � > ? � @ � A � B C 3 D � E � F � G � H ] I � J � K � L / M k
N � O � P Q R # S � T
U F V M W � X � Y 7 Z � [ � \ � ] � ^ � _ � ` � a b � c d C e q f � g � h % i �
j ^ k � l m � n � o � p > q r s � t � u v � w x 3 y y z � { $ | k } ~ ~ K � � � � E � � � � � �
� � � � � q � < � U � �
� 6
� & � � � � � ~ � � � ` � � � � = � K � { � q � � � � �
� � � : � ]
� � � � � � f � � � � � 8 � �
� � p � x � � � � � 3 � $ � � � %
� � � �
� � � � � � L � ' � � � � � P � � 4 � � � O � � � k � � � ^ � �
� f � � � U � � � � � h � Y � � � � � � � � � � � � �
� � � � � � 0@ � 1 G < 3N \ T� g G � 8�
+ : c
; c m � 5
j�
=
lS
u
m� ) � �
n� � � � � � �
� c �
�, 2 c F � � ^
�R X c q � � �
?~ � � � �
�� � & � A 1� � � 9 6
�
7�
� 8�
] 9c
;� 9 = � � (
+U
�
,�
�
-Z
^
.S
�
/
� � U �
0
<�
�
= c
�
> � T h
J
�
K`
�
L� (
j
M� 0
�
NS 8
�
O @
�
P H
�
QF P
1
R � X
S q ` l � �� � �� ? N � � 6 � � � � Q � � � �
8
. 8 W g f N $� z � X L ) � � N ?
y �
I k � 9
H � � G �s
w �?
� �
x
K
� �
9
K
�
� �
�
�
J
�
�
�
| �
�
�
9 �
�
�
� �)
� �?
# �-
z �
h �� �
�
. � �� � ?
� - G � � P G 9 9 � '
� � � � � � � �
� � � \ � � � ' � � �
s
�
& �
1 �
< �
G ) R � ] � h � s � ~ � � � � � @ � 9
N +1
d
� 3 �
- � @ g �� ^ ` � Q ] @� � � o�
O q9
q r9
� sG irq t@ dma u@
� v@ ��
� ��
� �
9 �M H �K
b �K
� �K
�K
�K
! � \ � �c �
�c � �1
w ��
��
� � � (~u
� � �
& � �
&� � ,�
� -�
8
�
! �
� "N
� $�
X
%�
5 .u (
� 8 � 0 � E G { -
� " � x; �g A �
g � � w = � � / w 9 ; � 9 G � 9 � ��
r � 9 � G k � # 3
F
G
�
�
� c
� G
� @
� @
� � g j � P 9 � g@ �r y � r !� ^ c � � � "� l c � � � # "@ � c � ! � � c $ E
� !� B c !" 9c 4 � � "& �� K � %L
^ � !I 4� t S !k (� � � # "� a c � c !j ) c � c 9 # !� !r c � c c c !t
b c � � � c !* c � � # !�
Kc : � � � !a "� P o !�
Lc p � � o !/ �� � � c � "� � � � � # !N c � � � ! d � � � !� �� � � &� $2
� ! # c v c "U ko . c '� �� 7 �w (mod �� \ X (v �� � � )7 p � *U r *T3 )37 P � *U| *T lQ *Q9 )O7 P � *U| *T vQ *Q4 )h7 P *U| *T �Q *Q0 )�7 P E *U| *T �Q *Q2 )�7 P o *U| *T �Q *Q1 )�7 P � *U| *T �Q *Q8 )�7 P � *U| *T �Q *Q7 )�7 P � *U| *T �Q *Q6 )8 P *U| *T �Q *Q5 ),8 P A *U| *T �Q *Q3 )H8 P k *U| *T �Q *Q: )d8 P � *U| *T �Q *Q< )�8 P � *U| *T R *Q= )�8 P � *U| *T R *Q> )�8 P *U| *T R *Q? )�8 P = *U| *T -R *Q; )�8 : U *U � +�8 *U| *T ?R , �� `( � � -} �$� � � -b �4� � � � � � ��.� � c R F (ret � c � � /ifr �M �@0� �){( � E *U�T*T �R *Q�� )�( � f *U2*T2*Q0 )�( 8 � *U�@*Q? )�( � � *Uv *T
� )�( � � *Uv )�( t � *U R 1) � 1) � +5) t *U R ,� �� / � ��* -} � � -b �/� W M � � � ��.� � c � � (ret � c � � /ifr �M ��.� �� � � .� �\ G ? 0� u2` & .� v� � � )�0 K *U| +3 K *U| 3�* T0 � K5 4�* 4�* W S 5� 6�* � � 7�* � � 6�*
+�5 K *Uv 8�* �0 � 6�* /
-
9�* �0 6�* T
R
+�0 K *Uv )`0 4 *U RQ +w0 *U| *Tv :�* �0 �0 P �: 4�* y
w
4�* �
�
6�* �
�
8�* �0 � ;�* 8�* �0 ! 6�* 2 0 9�* �0 ! 6�* W U +�0 K *U} )�0 4 *U �P +�0 *U| *T} :�* 1 1 P �? 4�* | z 4�* � � 6�* � � 8�* %1 � ;�* 8�* +1 % 6�* 5 3 9�* +1 % 6�* Z X +A1 K *U} ) 1 4 $ *U �P +#1 *U| *T} :�* P1 P1 P �D 4�* } 4�* � � 6�* � � 8�* u1 � ;�* 8�* {1 %
6�* 8
6
9�* {1 % 6�* ]
[
+�1 K *U} )\1 4 ) *U �S +s1 *U| *T} 3�* �5 ES 4�* �
�
4�* �
�
5 6�* �
�
7�* @ � 6�* ; 9 +�1 K *U} 8�* �5 6�* ` ^ 9�* �5 6�* � � +�5 K *U} )�5 4 7 *U HQ +�5 *U| *T} :�* 2 2 P X 4�* � � 4�* � � 6�* � 8�* 52 � ;�* 8�* ?2 ! 6�* c a 9�* ?2 ! 6�* � � +U2 K *U} ) 2 4 = *U �P +32 *U| *T} :�* `2 `2 P ] 4�* � � 4�* � � 6�* � 8�* �2 � ;�* 8�* �2 ! # 6�* f d 9�* �2 ! 6�* � � +�2 K *U} )l2 4 B *U �P +�2 *U| *T} :�* �2 �2 J 3b! 4�* � � 4�* � � 6�* 8�* �2 � ;�* 8�* �2 (! 6�* i g 9�* �2 6�* � � +�2 K *U} )�2 4 G! *U 0Q +�2 *U| *T} :�* 3 3 P 9g" 4�* � � 4�* � � 6�* 8�* 53 �! ;�* 8�* ?3 ! -" 6�* l j 9�* ?3 ! 6�* � � +U3 K *U} ) 3 4 L" *U 6Q +33 *U| *T} :�* `3 `3 P ?l# 4�* � � 4�* � � 6�* 8�* �3 �" ;�* 8�* �3 ! 2# 6�* o m 9�* �3 ! 6�* � � +�3 K *U} )l3 4 Q# *U @Q +�3 *U| *T} :�* �3 �3 P q$ 4�* � � 4�* � � 6�*
8�* �3 �# ;�* 8�* �3 ! 7$ 6�* r p 9�* �3 ! 6�* � � +�3 K *U} )�3 4 V$ *U Q +�3 *U| *T} :�* 4 4 P v% 4�* � � 4�* � � 6�*
8�* %4 �$ ;�* 8�* /4 ! <% 6�* u s 9�* /4 ! 6�* � � +E4 K *U} ) 4 4 [% *U �R +#4 *U| *T} :�* P4 P4 P {& 4�* � � 4�* � � 6�* 8�* u4 �% ;�* 8�* 4 ! A& 6�* x v 9�* 4 ! 6�* � � +�4 K *U} )\4 4 `& *U Q +s4 *U| *T} :�* �4 �4 P !�' 4�* � � 4�* � � 6�* 8�* �4 �& ;�* 8�* �4 ! F' 6�* { y 9�* �4 ! 6�* � � +�4 K *U} )�4 4 e' *U Q +�4 *U| *T} :�* �4 �4 P '�( 4�* � � 4�* � � 6�* 8�* 5 �' ;�* 8�* 5 ! K( 6�* ~ | 9�* 5 ! 6�* � � +55 K *U} )�4 4 j( *U Q +5 *U| *T} :�* @5 @5 P -�) 4�* � � 4�* � � 6�* ! 8�* e5 �( ;�* 8�* o5 ! P) 6�* � 9�* o5 ! 6�* � � +�5 K *U} )L5 4 o) *U )Q +c5 *U| *T} )/ ^ �) *U0 )1/ � �) *Uv *T �R *Q�� )a/ � �) *U2*T2*Q0 )�/ 8 * *U��*Q? )�/ � +* *Uv *T
� )�/ � C* *Uv )�1 � b* *U �P )�1 � �* *U �P +�1 � *Uv <I �c + =� �� =� �0� > �� ?�* >� � � @>� �� @>� �� ,� �� �' � �~, -} � � � � -b �-� � � � ��.� � c b X (ret � c � � /ifr �M �@0� �)�' � �+ *U�T*T �R *Q�� )�' � �+ *U2*T2*Q0 )( 8
, *U�@*Q? )( � ,, *Uv *T
!� )&( � D, *Uv )8( t c, *U �T 1E( � 1T( � ,� *� �* � ��1 -} * �
-b */� N J B + ��(ifa + � � .� , c � � .� .� j d .9 /� � � .� 0� � � . 1� � � .r 2�
� .� 3� D! *! A� v/, 2P �- .� l � Y" Q" 5P .� l � �" �" +�, K *U�� 2� 3. .� m � %# !# 5� .� m � _# [# +�, K *U| 2� �. .� n � �# �# 5� .� n � �# �# +�, K *Us 2� �. .� o �
$ $ 5� .� o � G$ C$ +- K *U 2 / .� p � �$ }$ 5 .� p � �$ �$ +"- K *U} 2@ R/ .� y� �$ �$ +�- K *U�� 2p �/ .m z� J% D% 5� .� z� �% �% 1�- K 2� �/ .m {� �% �% 5 .� {� & & +�- K *U| 2@ 50 .m |� \& V& 5p .� |� �& �& +�- K *Us 2� �0 .m }� �& �& 5� .� }� 2' .' +. K *U 2 �0 .m ~� l' h' 50 .� ~� �' �' +�- K *U} )�* ^ �0 *U0 )�* � 1 *U�� )M+ t 81 *U �P *Q~ *R| *Xs *Y )l+ Z1 *U��*T�� )�+ �1 r1 *T~ )�+ �1 �1 *T~ ), �1 �1 *T~ 1B, � )=- � �1 *Uv )T- �1 �1 *T~ 1v. � B �� x2 C� �(�
C� �2c Dbuf �
x2 Derr � c E, � c Dn � - Dlen � - E� �� Dptr � � @>k �2 � �2 F9 � Bg
�� �2 C} �$� Cb �4� Dpid � � E� � c E � c B� �� 3 C} �$� Cb �4� Dpid � � E� � c Go �� 6 ��3 H} �(� �' �' Hb �8� ( ( 16 |4 I.6 t *U FQ J� ��6 i �R4 Kpid �o d( V( H �&� ) ) 1�6 � L�6 � �3 *U�T )�6 R4 4 *Us L�6 � /4 *U�T I�6 � *T ZQ *Q�T M� ]c |4 Npid ]� Dret ^ c O� Ho 6
��4 I
6 *UN P�2 @) a ��5 4�2 �) �) 4�2 0* ** Q�2 �hQ�2 �l6�2 �* |* R�2 �) �) �a5 4�2 �* �* 4�2 �* �* ;�2 ;�2 ;�2 1�) � )_) � �5 *U�T*T �S *Q�h*R�l +x) � *U0 S�1 �) �c6 T�1 UT
2 TQ2 ��w;"2 ;.2 ;:2 ;D2 ;P2 ;\2 U�1 5* �V
2 V�1 5 Q2 ��w;"2 ;.2 ;:2 QD2 ^;P2 ;\2 9h2 5* ;i2 P�2 �. v �p7 4�2
+ + 4�2 M+ C+ Q3 �\63 �+ �+ R�2 �. �. �7 4�2 , , 4�2 ;, 9, ;3 ;3 1�. � 1�. � )�. � =7 *Uv *T �T *Q�\ )�. ~ T7 *U0 +�. t *U �T PR4 06 W �8 4c4 b, ^, 6o4 �, �, RR4 i6 i6 ]�7 4c4 �, �, ;o4 1x6 � )K6 � 8 *T0 1]6 � Wi _ % � r � 9 � 5 � � � � � X int W � � �c � x � fl � } \ T� g G � 8� + : W ; W �
� 5 j = l� u m ) � n� $ < 0 P
0
0 �\ b W q
0 �} � W �
0
j ^ �� � W �
0
q
j � ?� � �
j � 6 9 6. �
7� � 8� ] 9W ;� 9 = � � (+| � ,$ � -� ^ .� � /
0 0 | � 0: <� � = W � > j T hJ> � K� � L� ( j M� 0 �
N� 8 � O> @ � P D H � Q� P 1 R P X
S � ` . � g ^ �. g -
� W t 6 � �s � k 0 �
0
0 � j 0 �
0
0 �
0 �
0
0 � 0 �
0
0 j 0
0
0 w
0 5
0
0 � 0 P
0
0 M 0 k
0
0 � 0 �
0
0 � 0 �
0
0 lW �
LW �
0
�
c / �0 �
�
W � B0 9 � �mod J0 - �, #9 � D U �s T3 ?9 � p U| T �R Q
b T9 � � U| T �R Q0 l9 � � U| T �R Q1 �9 � � U| T �R Q� �9 � �
� � � �9 z � � �9 � � � � � X int c � 3 �o " �o � �o � � � � 0� d ��Y � �c � � � � � � a � � � � �
� � (
� � 0
� � 8
5 � @
~ � H
; � P
� � X
� � `
, � h
�
c p
A c t
P
v x
� G �
o U �
� � �
� � �
T &� �
� / � �
0 � �
1 � �
� 2 � �
3
- �
[ 5c �
� 7� � � �� �� � �� X �� �c a � � �
9 Y � �
9 � � � f� � �� � } \ T� g G � 8; + : c ; c ; 5 jn = l� u ms ) n � nF y \ R� _ts �
�� �
�� � � m ( 5 � 7 � � 8 � 9 � 5 : � � ; c * < c $ �
c g j �j W c J � � G` ` � � L y � "
9c � � � k (� � � � 4� � � �
� � � � �
�� � � � " d c � � �) ) � � B� J � � t � ) * c r � � I
4� � � w � �9 z ��
} "� P- L- b 2� �- �- ~ � �- �- ^ ` L. @. Q � �� I � �. �. N � �/ t/ 9 � l0 Z0 � � 11 +1 � C p � K ) �1 z1 �9 J !: / � "T .Q # : "Uv � � < � �1 �1 $� � < � 2 2 #�: f "Uv X � = � ,2 (2 $ � = � f2 b2 #�: f "U � � � > � �2 �2 $� � > � �2 �2 #�: f "Us @ m F� 3 3 $� � F� �3 �3 !�; f � "Uv #%< f "Uv � T m G� �3 �3 $P � G� X4 V4 #�; f "U � � m H� �4 {4 %~; � H� �4 �4 #�; f "Us &5; � � I� �4 �4 #D; f "U| !�9 r "U0 !�9 V - "Uv "T �R "Q�� !8: J E "U} L: � a: � !�: � � "U~ "Tv "Q !�: y � "U| "Ts !�: J � "U} !; 4 � "U} 5; � !h; 4 � "U} !�; 4
"U} !�; � @
"T �S "Q �S "R# !�; �
i
"U �S "T1"QB !
< �
�
"U: #< 4 "U} 'w m 'H > p �
� � 0< � � �9 � � � � � X int c � 3 �o " �o x �c � �o � � � � 0� d ��e � �c � � � � � � a � � � � �
� � (
� � 0
� � 8
5 � @
~ � H
; � P
� � X
� � `
, � h
�
c p
A c t
P
v x
� G �
o U �
� � �
� � �
T &� �
� / � �
0 � �
1 � �
� 2 � �
3
- �
[ 5c �
� 7� � � �� �� � �� X �� �c m � � �
9 e � �
9 � � � f� � �� c � z b� } \ T� g G � 8Y + : c ; c 1 Y 5 j� = l u m� ) � � nd � � �� �
�� �
�� (
�� ;
�� � � � w9 � ~ � � � $
9 �� $ �
c g j �N c t 8
u c � � - � 0 Y
V� ) o � � � . � � � � � �
� � � � � c � L % � " 9c @ � � a � V o � c q - � I 4� � �
R� � � � 2
� I �
� � $ 7
y c � � - �
�� " d c � � � �� ! - 8o 9 o k (� P � �
�� f � * c � � � � �� `? � �� } �(� 5 5 b �8� Y5 S5 � �$ ��~ len � - �5 �5 !pid � ��~ i � �5 �5 "� � 96 36 � �� ��~#@ 7 "h �� �6 �6 "� �o �6 �6 #� � "m � � P7 J7 $� "� � � �7 �7 %N@ &Uv #� � "� � - �7 �7 '�? � (,@ � � &Ts (<@ � &Uv 'U@ � %�@ � &T T (�? f k &U�T&T T &Q��~&R��~ '�? � '�? � (�@ � � &T PT (�@ c � &T�&Q} '�@ P M R� 0= & �w } R(� 8
8 b R8� P8 J8 cpu S c �8 �8 "� Sc (9 9 "" Sc �9 �9 "� S c �: �: !pid T ��"� U - �: �: "� V� <; .; "� W� �; �; )� �# � "� x
- �< �< # �
"� z� x= n= #@ +
"� �� �= �= %> &U~ #p ]
"� �
� > > %�> &U~ (�> @ {
&Us $ & %�> % &U} &T~ #� �
"m �� L> F> $� "� �� �> �> %Q? &U} (`= f &U�T&T �T &Q�� (= ' &UA (�= � E &T| &Qv (�= � ] &Uv '�= � (�= � � &T T (> � � &Uv '6> � (G> q � &U0 (^> V � &U| &Tv (�> � � &Uv '�> P ( ? � : &T �S &Q �S &Rb (7? ] c &U �S &T1&QB %D? h &U: � <� �< y ��
} <"� �> �> b <2� ?
? !pid = �d"� > c c? _? >c �h m >c �l" ? c �? �? *� �< � Fp
+& �? �? + %@ #@ + K@ I@ %�< ! &U�&T1 (�< f �
&U�T&T �S &Q�d&R�h&X�l ''= P � *� 0< t �� } *"� s@ o@ b *2� �@ �@ !pid + �l"� , c A �@ " ,c jA bA "m ,c �A �A ,3 T< T< /� +P /B -B +D UB SB %g< ! &U�&T1 (J< f � &U�T&T �T &Q�l (�< 9 � &U �S '�< P -� c 3 .q c /who c .� $c -� c ] .q c /who c 0w m 0H > � �
� � �@ H �! � �9 � � @ � � � X int h � x �h � �t � � � � 9 � � 9 � � f� � z b{ = �h } � 9 \ T� g G � 8I
+ : h
; h ! I 5 j|
= l
u m� ) | � nT � � � 9 � g 2�
?! 4a
! 5a
I�
s K
�
7! L
� � � :�
� <
a
! = �
_ >�
� ?� (
� @� ,
� A� L&! B� L ! H � P� M� T� S � \V T� l � � 9 g o ��
D
.!
>� � L � � "
9h � � � k (� � � 4� + � �
A
I
4� I j � �@ H �� } � }B yB b (� �B �B ut � �B �B � � xC lC 9 � D �C J � E �D � � �E �E � � YF CF � ? aA � ! $
- z $
- EG ?G aA � $
� �G �G � $
h KH CH sA � ! $*- z $*- �H �H � $*� � $*h !0
� 7 �
I I "0
� 7 � GI CI #�B � $U !`
j � 8 � �I }I "`
� 8 � �I �I #xB � $U~ !�
� � 9 � �I �I "�
� 9 � /J +J #XB � $Uv !� � : � iJ eJ "
� : � �J �J % B � $U| #kB � $U| !�
~ m @� �J �J "�
� @� .K (K %C � h $U #6C � $U ! � m A� }K wK "@ � A� �K �K # C � $U~ !p m B� L L "� � B� L {L #&C � $Uv !� b m C� �L �L " � C� M M #�B � $U| !P � � D� GM ?M &�B � %A 3 � $U0 &A + &%A � %@A � $Us, %UA � $Us %�A
$U xT %�A � > $U �T $T $Q~ $Rv %�A � \ $U} $T| &%B � &=B � %�B � $Us� &�B � &�B � G B � � �! @C d <' � � � � � X int W � � �c � v } � fj � } \ T� g G � 8� + : W ; W � � 5 j = l� u m
) � n� " � �. � ; S! B x! c �! - � p 3 q! X Y! 3 h!
d �! d (�! d 0�!
d 8�! d @�! d HM! @ P pad @ R�! d X_! d `�! L h _f C l
d C -
v S - g
^ �k
(. w � � �. � . � W � � p � . @C d �} . �M �M b 0. �M �M # p ��LC � U�� �C ` 7 U �T �C w � 5 � (# �C Q �( � �9 � � � � � X int c � � �o � � � � � fx c � } < 3N \ T� g G � 8
+ : c ; c �
5 j= = l� u mB ) = � n H � N �
y
�
I
k
�
9
H � � G
�� w
�� �
�
� � � � 9
�
� � � �
J
| % %
/ 9 : :
D � O O
Y � d d
n '
y y
� � � �
� �
� �
� \ � �
� ' � �
�
� �
� �
�
*
?
# T
. i
9 ~
D �
O �
Z �
e �
p �
{ �" @ � G S! N ' � q# (N �! )N |# *G �# +� - % q# .N �! /N |# 0G �# 1N d# 2� 4 U �" 5G h" 6G ;" 71 9 � �" :N �" ;N �# <N �# =N �# >N lmi ?G dce @G I# Aa C � S" DN o" E� G S" HN !# I � ) 9 �" J� L Y # MN �" NN �" O5 �
�� O
�9 q
�9 �
�G irq
�@ dma
�@ �
�@
� @#
� R#
�$ fr
�* �#
�0 �#
�6 �#
�< te1
�B U Y � � ) � % X#
�} x
�N �
�N _"
��
�� �
�
�9 H
�� b
�� �
��
��
�� !
� \ �
�c �
�c �
�e w
�
�
�
v $"
�H � (
�a �
�} &
�� �" ,aL cmd b� �# c� �" d� " e� �# f� � g� �" h� �# i� �" j� �! k� �" l� 2" m� J" n� �" o� # p� �" q� |" rQ $ a � a 9 g j �� a c � c k (T � � � 2
� j ) c � c 9 �# >v � v c - d T � � � r c c c c * c 6 T � � :T �C Q �� } :&T !N N b :6T `N ZN � ; � ��~ � < c �N �N !ret = c TO PO �# > c �O �O �# ? � �O �O " @ c �O �O "ifr A9 �� X" Ba �� � CT P
P #� t�D $� iD � W_
%� uP sP &�C �
'U�T'T �R 'Q��~ &�C � �
'U2'T2'Q| & D � �
'U��'Q? &UD � �
'Uv 'T
F� &�D �
'U �T &�D n " 'Uv (�D � &�D � N 'U �T &�D � m 'U �T )�D n 'Uv * " #� � +�# #4� L ,i _ % $ > $ > & I : ; 9 I I : ; 9
: ; 9 I8 7 I
< 4 : ;9 I?< 4 : ; 9 I?<
4 : ; 9 I 4 G: ; 9 .?: ;9 'I< I .?: ; 9 '< .?: ; 9 'I< .?: ;9 '< . ?: ; 9 'I< .?: ;9 'I@�B ��1 �� �B .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I 4 : ; 9 I�B ��1 �� 1 4 : ; 9 I U !4 : ; 9 I�B " U #I $! I/ %.?: ; 9 'I@�B % : ; 9 I $ > $ > & I I 7 I : ;9 I
> I: ; 9 ( : ; 9
: ; 9 I8 < 'I I ' 4 : ;9 I?< 4 : ; 9 I?< 'I > I: ; 9 > I: ;9 ( ( I ! I/
: ;9 I8
: ; 9 I8 : ; 9
: ; 9 I 4 : ; 9 I 4 : ;9 I !.?: ; 9 'I< ".?: ;9 'I< # $.?: ; 9 '< %.?: ;9 '< &. ?: ; 9 'I< '.?: ;9 'I@�B (4 : ;9 I�B )��1 *�� �B +��1 ,.: ;9 'I@�B - : ;9 I�B .4 : ;9 I�B /4 : ;9 I 0
: ;9 1�� 1 2 U 3 1R�BUX YW 4 1�B 5 U 64 1�B 7 1U 8 1 9 1 : 1R�BX YW ;4 1 <.: ;9 'I = : ;9 I >4 : ;9 I ? @ A
: ;9 B.: ; 9 'I C : ; 9 I D4 : ; 9 I E4 : ; 9 I F! I/ G.: ; 9 'I@�B H : ; 9 I�B I���B1 J.?: ; 9 '@�B K : ; 9 I�B L���B1 M.?: ; 9 'I N : ; 9 I O.?: ; 9 'I@�B P.1@�B Q4 1 R 1R�BX Y W S.1@�B T 1 U 1R�BUX Y W V 1 W. ?<n: ; % $ > $ > & I : ; 9 I I : ; 9
: ; 9 I8
7 I < 'I
I : ;9 I ' 'I 4 : ; 9 I I ! I/ 4 : ; 9 I .?: ; 9 'I< . ?: ; 9 'I< .?: ; 9 'I@�B 4 : ; 9 I�B ��1 �� �B �� 1 % : ; 9 I $ > $ > & I I : ; 9
: ; 9 I8
: ;9 I8 : ; 9 I
! I/ 7 I 4 : ; 9 I?< < < 4 : ; 9 I .?: ; 9 'I< I .?: ;9 '< .?: ;9 'I< .?: ; 9 '< . ?: ; 9 'I< .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I�B 4 : ; 9 I
: ; 9 U �� 1 !��1 "�� �B #��1 $ U % & '. ?<n: ; % : ; 9 I $ > $ > & I I : ; 9
: ; 9 I8
: ;9 I8 : ; 9 I
! I/ 7 I 4 : ; 9 I?< < 4 : ;9 I?< : ; 9 4 : ; 9 I > I: ; 9 ( .?: ; 9 'I< I . ?: ; 9 'I< .?: ;9 'I< .?: ;9 '< .?: ; 9 '< .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I 4 : ; 9 I�B !4 : ; 9 I "4 : ; 9 I�B # U $ U %��1 &�� �B '�� 1 (��1 )
: ; 9 * 1R�B UX Y W + 1�B , 1R�B X Y W -.: ; 9 'I . : ; 9 I / : ; 9 I 0. ?<n: ; % : ; 9 I $ > & I $ > I ! I/ I : ; 9
: ; 9 I8 7 I <
: ; 9 : ; 9
: ; 9 I8 4 : ; 9 I . ?: ; 9 '< . ?: ; 9 'I< .?: ;9 '< I .?: ; 9 'I< .?: ;9 'I< .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I�B 4 : ; 9 I�B
: ; 9 4 : ; 9 I ! U " U #��1 $�� �B %��1 &�� 1 % $ > $ > & I : ; 9 I I : ; 9
: ; 9 I8 7 I
< 4 : ; 9 I?<
: ; 9 I8
I ! I/ ! I7 4 : ; 9 I .?: ; 9 'I< I .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I ��1 �� �B �� 1 % : ; 9 I $ > $ > & I I : ; 9
: ; 9 I8
7 I < > I: ; 9
( ( ( I ! I/ : ; 9
: ; 9 I8 : ; 9
: ; 9 I
: ; 9 I 4 : ; 9 I .?: ;9 'I< I .?: ; 9 'I< . ?: ; 9 'I< .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I 4 : ; 9 I�B !4 : ; 9 I�B "4 : ; 9 I #
: ; 9 $ 1R�B UX Y W % 1�B &��1 '�� �B (�� 1 )��1 *.: ; 9 'I + : ; 9 I ,. ?<n: ; k . �
psutil /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m _psutil_common.c types.h stdio.h types.h pyport.h time.h object.h pyerrors.h _psutil_common.h stdlib.h modsupport.h abstract.h string.h errno.h = �$ � =w: �X:X<� �� I=� X t � � � �$n$\$��� � ;=� X t � � � �#�#\#��� � ;=� X t � � � �8�8yJ
Ct�L��z�4 �Y2�2J
@t�L �
M
t��t� .�� K� Y
� � �
psutil /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m /usr/include/netinet /usr/include/net /usr/include/asm-generic /usr/include/linux _psutil_posix.c stddef.h types.h stdio.h types.h unistd.h stdint.h pyport.h time.h object.h boolobject.h methodobject.h moduleobject.h pyerrors.h resource.h resource.h socket_type.h sockaddr.h socket.h in.h confname.h if.h ifaddrs.h int-ll64.h types.h
if_packet.h
_psutil_common.h netdb.h listobject.h unicodeobject.h modsupport.h ioctl.h socket.h longobject.h signal.h errno.h <built-in> 3 �' �3v
J3v�
J�=-[ /_f sY � t.Z] ' Y �X:�t:z P:z� P�=-[ /[f sY � u.[Y uR� Y �X ztPX:�|f:
J At=-^�ZtKp� t�:
�:s
.:s.
.:s<
� Y � 8 @ � -��
^�
^X #
Y
Y�� �L
IY \K� Y
`� lt�95`5 25* �XY� ��XJ
�� ; B
' �
� � � � � � % L) J � J Z K �q ? 0 �� = � <
�
�tK <�<XX KXK � X � X � X � X � X � � l� � � � � � � � � � % L) J 7�X�
]�
�tK < . t X J t � � � � � � � � � � �z��� A�o;;- D�v
<:�~t:� Z�h >�-^�.L �fp. �f5��5
35) �Y� t��J� =�~� /�f sY ��u X��������������� ��~�� � /Ij��t�� �~@�� � /Ij��� 7��� � /I2��� =��� � /I2��� � ����� / ;Z� ����� � /Ij��� � ��� � /Ij��� � �~�� � /Ij��X � � B��~�� � /Ij��� � �~�� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� ��~�� � /Ij��X ���}� >� �> KXu I ��L .j� l Jt=W [
X .\dX
&�h� ./�/ �X g EA
�
t K G? �= I/ X 7 �0 � X� <� � <� <� <� <� <� <� <� <� <� <N <N <N <J
� Y���� < � J �
psutil /usr/include/bits /usr/include /opt/python/cp36-cp36m/include/python3.6m /usr/include/sys psutil/arch/linux _psutil_linux.c types.h stdio.h pyport.h time.h object.h methodobject.h moduleobject.h _psutil_common.h mem.h net.h users.h disk.h proc.h modsupport.h 9 � 0 _ XK K <K <LZX nf< � �
psutil/arch/linux /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /opt/python/cp36-cp36m/include/python3.6m /usr/include/sys psutil/arch/linux/../.. disk.c stddef.h types.h stdio.h libio.h pyport.h time.h object.h pystate.h pyerrors.h mntent.h _psutil_common.h listobject.h modsupport.h unicodeobject.h ceval.h <built-in> 8 �9 8y 58y. �Z�
t�� Y�lt= Y ;=X . j � �� = �� = �.X A �
� � t f � J � f � f j ��� b� = t � =yJ �� f X f � � �t�� \ $ �!. �X� � � �
psutil/arch/linux /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m psutil/arch/linux/../.. proc.c stddef.h types.h stdio.h libio.h types.h pyport.h time.h object.h pyerrors.h sched.h _psutil_common.h sched.h longobject.h abstract.h listobject.h errno.h unistd.h modsupport.h <built-in> 8 0< )8J ?t�=-Zg .Z
- 0�
e >Y �t�88
J AtX>,\U) WJ)� <WJX+ZtK �t>
>y
_>y�
{� � o< uWu; K �
� . ��
X �
g�
:�#q � � ��
Sft � �t�[
hJX='.�1'<
< X"!X
@
��/;
j � . r1 ' < J. ��
[
f � ^ $ � , >m>y
_>y�
���
� ����f f .� z f X ] � J p J Y � \ �T @ . � .
XXb+. X<"( Nu�.� � � �
psutil/arch/linux /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m psutil/arch/linux/../.. users.c stddef.h types.h stdio.h types.h pyport.h time.h object.h utmp.h listobject.h modsupport.h unicodeobject.h utmp.h _psutil_common.h . �@ . 0., �X=�Y � ` � � h3JX = �.JX = �
f f * f J <' .
� � �� � �
� � � f t � � ` �"�Y
r. � �� � �
p� = u�#<f f X t X t t Y < d > : X Y U � � � f � �f� � o �
psutil/arch/linux /usr/include/bits /usr/include /opt/python/cp36-cp36m/include/python3.6m /usr/include/sys /usr/include/asm-generic /usr/include/linux psutil/arch/linux/../.. mem.c types.h stdio.h pyport.h time.h object.h int-ll64.h posix_types.h sysinfo.h modsupport.h pyerrors.h sysinfo.h _psutil_common.h 6 @C
6 M�M
2 t� � i ? �
psutil/arch/linux /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /opt/python/cp36-cp36m/include/python3.6m /usr/include/sys /usr/include/asm-generic /usr/include/linux/hdlc /usr/include/linux psutil/arch/linux/../.. net.c stddef.h types.h stdio.h stdint.h pyport.h time.h object.h sockaddr.h socket.h int-ll64.h ioctl.h if.h ethtool.h unistd.h modsupport.h ioctl.h string.h _psutil_common.h
socket.h socket_type.h errno.h <built-in> < �C 9<u X<u� <t< J�� /�i Mzt<� YzX[� [Z YS)XX- [L 1 O�� �=Zu h�X .�- e�.�RJ.<
q�� / ;Y� tz_dsttime syscall psutil_setup /project _typeobject _object ob_refcnt double NoSuchProcess Py_ssize_t float _py_xdecref_tmp long long unsigned int timezone unsigned char psutil_set_debug strerror _py_decref_tmp PSUTIL_DEBUG short unsigned int PyObject_IsTrue psutil_PyErr_SetFromOSErrnoWithSyscall tz_minuteswest PyObject_CallFunction AccessDenied psutil/_psutil_common.c ob_type self PyErr_SetObject __errno_location PyObject __ssize_t fullmsg long long int GNU C17 10.2.1 20210130 (Red Hat 10.2.1-11) -mtune=generic -march=x86-64 -g -O3 -fwrapv -fPIC PyArg_ParseTuple PyExc_ValueError _Py_Dealloc short int args PSUTIL_CONN_NONE __pid_t _Py_NoneStruct psutil_check_pid_range PyErr_SetString sprintf getenv PyExc_OSError _SC_EQUIV_CLASS_MAX ifr_ifrn m_copy ifa_addr _SC_THREAD_PRIO_PROTECT sin6_flowinfo ifr_ifru PyModule_Create2 getnameinfo __priority_which_t _SC_VERSION Py_BuildValue _SC_NL_NMAX m_methods _longobject slot _SC_SYNCHRONIZED_IO _SC_THREAD_PRIORITY_SCHEDULING _SC_NPROCESSORS_ONLN sa_data m_base _SC_TIMEOUTS sockaddr _SC_BASE _SC_PII_OSI_COTS sockaddr_un _SC_THREAD_SAFE_FUNCTIONS _SC_ATEXIT_MAX sockaddr_ns _SC_STREAM_MAX ifru_slave psutil_posix_getpriority _SC_PRIORITIZED_IO py_ptp _SC_V6_ILP32_OFF32 _SC_THREAD_SPORADIC_SERVER sll_pkttype __socket_type ifu_dstaddr _SC_SHRT_MIN _SC_USHRT_MAX _SC_NL_TEXTMAX _SC_STREAMS __rlimit_resource IFF_PORTSEL _SC_THREAD_DESTRUCTOR_ITERATIONS _SC_PIPE _SC_BC_DIM_MAX psutil_getpagesize _SC_MAPPED_FILES _SC_2_C_BIND _SC_MQ_OPEN_MAX _SC_XOPEN_SHM _SC_INT_MAX _SC_2_FORT_DEV kill _SC_XOPEN_XPG2 _SC_NZERO _SC_XOPEN_XPG4 IFF_NOTRAILERS _SC_CPUTIME _SC_PII_INTERNET _SC_V7_LP64_OFF64 _SC_LEVEL3_CACHE_SIZE _SC_MB_LEN_MAX ifreq __u6_addr16 __caddr_t _py_tmp sockaddr_ipx sll_hatype getifaddrs ifru_broadaddr _SC_REALTIME_SIGNALS __RLIMIT_LOCKS m_free moduledef py_netmask _SC_DEVICE_SPECIFIC_R uint32_t in_addr_t mem_start _SC_SAVED_IDS __RLIM_NLIMITS _SC_2_C_DEV _SC_XBS5_LPBIG_OFFBIG ob_base _SC_2_C_VERSION _SC_SEM_VALUE_MAX _SC_SCHAR_MAX ifru_map _SC_SSIZE_MAX _SC_2_UPE PyExc_RuntimeError freeifaddrs RLIMIT_CORE ifa_name _SC_INT_MIN _SC_BC_BASE_MAX __u6_addr8 _SC_POLL sysconf ml_flags _SC_SYSTEM_DATABASE_R sockaddr_dl sll_halen __RLIMIT_NPROC _SC_2_LOCALEDEF IFF_MULTICAST sin_family _SC_XOPEN_XPG3 _SC_T_IOV_MAX _SC_LEVEL1_ICACHE_ASSOC in_port_t py_str _SC_SYMLOOP_MAX retval _SC_TRACE_LOG ifa_ifu __u6_addr32 append_flag _SC_THREAD_CPUTIME sin_zero _SC_CHAR_MAX _SC_XBS5_ILP32_OFFBIG _SC_PII_INTERNET_DGRAM s_addr py_address _SC_2_PBS_TRACK __u16 psutil_net_if_flags _SC_FILE_ATTRIBUTES _SC_ASYNCHRONOUS_IO _SC_FSYNC __RLIMIT_NICE sockaddr_inarp _SC_DEVICE_SPECIFIC sockaddr_ax25 ifa_netmask IFF_UP _SC_THREAD_ATTR_STACKSIZE _SC_REGEX_VERSION _SC_MEMLOCK _SC_DELAYTIMER_MAX _SC_LONG_BIT _SC_SEM_NSEMS_MAX sockaddr_iso PyModule_AddObject PyModule_AddIntConstant _SC_XOPEN_STREAMS _SC_LEVEL1_ICACHE_LINESIZE _SC_SIGNALS sll_family __RLIMIT_OFILE IFF_SLAVE ioctl _SC_2_PBS_ACCOUNTING _SC_AIO_MAX _SC_LEVEL2_CACHE_LINESIZE _SC_XOPEN_VERSION mod_methods sa_family_t _SC_CLK_TCK _SC_SHELL sll_protocol _SC_UIO_MAXIOV _SC_TZNAME_MAX ifru_data _SC_SPORADIC_SERVER _SC_MEMLOCK_RANGE _SC_AVPHYS_PAGES __RLIMIT_NLIMITS _SC_V7_ILP32_OFFBIG _SC_PII_XTI close sll_ifindex flag_name sock _SC_V7_LPBIG_OFFBIG _SC_C_LANG_SUPPORT_R SOCK_DCCP _SC_LEVEL3_CACHE_ASSOC uint8_t _SC_FILE_SYSTEM ifru_netmask _SC_PAGESIZE _SC_V6_ILP32_OFFBIG SOCK_PACKET __id_t _SC_SIGQUEUE_MAX _SC_SPAWN psutil_posix_setpriority _SC_DEVICE_IO _SC_V6_LPBIG_OFFBIG _SC_2_VERSION ifru_mtu _SC_LEVEL4_CACHE_SIZE ml_name SOCK_DGRAM m_size IFF_LOOPBACK _SC_USER_GROUPS_R PyModuleDef_Slot visitproc sin_port _SC_LINE_MAX sockaddr_eon psutil/_psutil_posix.c IFF_AUTOMEDIA lladdr py_broadcast _SC_LEVEL1_DCACHE_ASSOC _SC_HOST_NAME_MAX _SC_C_LANG_SUPPORT __RLIMIT_RSS _SC_THREAD_STACK_MIN IFF_RUNNING _SC_SEMAPHORES _SC_UINT_MAX _SC_CHILD_MAX __RLIMIT_MSGQUEUE PyUnicode_FromString _SC_NGROUPS_MAX _SC_SINGLE_PROCESS IFF_ALLMULTI __be16 __in6_u sin_addr _SC_TTY_NAME_MAX _SC_PII_INTERNET_STREAM RLIMIT_AS _SC_MEMORY_PROTECTION PyModuleDef_Base m_name _SC_XOPEN_CRYPT PyCFunction psutil_net_if_is_running ifru_newname _Py_FalseStruct RLIMIT_FSIZE _SC_CHAR_BIT _SC_LEVEL1_DCACHE_SIZE IFF_NOARP _SC_CLOCK_SELECTION m_init ifrn_name sin6_addr psutil_net_if_mtu _SC_TIMERS freefunc _SC_BC_SCALE_MAX _SC_ULONG_MAX uint16_t sin6_port _SC_MQ_PRIO_MAX _SC_TRACE _SC_SPIN_LOCKS ifru_flags addrlen _SC_LEVEL1_DCACHE_LINESIZE _SC_BC_STRING_MAX PyLong_FromLong mem_end SOCK_STREAM RLIMIT_DATA _SC_V7_ILP32_OFF32 _SC_TRACE_SYS_MAX _SC_FD_MGMT _SC_REGEXP sin6_family IFF_PROMISC RLIMIT_CPU PyInit__psutil_posix _SC_LEVEL1_ICACHE_SIZE _SC_ADVISORY_INFO __RLIMIT_RTPRIO _SC_SHRT_MAX _SC_XBS5_LP64_OFF64 __builtin_strncpy _SC_READER_WRITER_LOCKS _SC_SYSTEM_DATABASE _SC_XOPEN_REALTIME_THREADS _SC_THREAD_ROBUST_PRIO_PROTECT _SC_2_CHAR_TERM _SC_PASS_MAX _SC_FIFO m_slots _SC_ARG_MAX ifru_hwaddr ml_doc _SC_2_PBS_CHECKPOINT PyMethodDef _SC_XOPEN_REALTIME PRIO_USER ifru_dstaddr psutil_getpagesize_pywrapper _SC_2_FORT_RUN socket _SC_TRACE_EVENT_FILTER psutil_raise_for_pid _SC_RE_DUP_MAX _SC_SCHAR_MIN sockaddr_in _SC_THREAD_ROBUST_PRIO_INHERIT _SC_THREADS PyList_Append _SC_PII __RLIMIT_SIGPENDING _SC_TRACE_INHERIT _SC_WORD_BIT _SC_XBS5_ILP32_OFF32 _SC_PII_OSI_M RLIMIT_NOFILE m_traverse _SC_2_SW_DEV _SC_OPEN_MAX _SC_XOPEN_UNIX sockaddr_in6 _SC_AIO_LISTIO_MAX PyErr_SetFromErrno _SC_PII_OSI _SC_UCHAR_MAX _SC_MONOTONIC_CLOCK m_clear py_tuple ifaddr SOCK_RAW _SC_PRIORITY_SCHEDULING m_doc _SC_SELECT _SC_NETWORKING _SC_TIMER_MAX _SC_TRACE_EVENT_NAME_MAX _SC_V6_LP64_OFF64 _SC_GETGR_R_SIZE_MAX _SC_LEVEL2_CACHE_SIZE _SC_LOGIN_NAME_MAX _SC_EXPR_NEST_MAX IFF_POINTOPOINT _SC_NPROCESSORS_CONF __RLIMIT_RTTIME ifru_addr __socklen_t traverseproc SOCK_SEQPACKET PRIO_PROCESS sockaddr_at psutil_pid_exists ifa_flags _SC_SS_REPL_MAX _SC_RAW_SOCKETS _SC_BARRIERS _SC_CHAR_MIN _SC_LEVEL4_CACHE_LINESIZE psutil_convert_ipaddr _SC_THREAD_PROCESS_SHARED _SC_NL_MSGMAX _Py_TrueStruct sin6_scope_id m_index _SC_LEVEL4_CACHE_ASSOC _SC_CHARCLASS_NAME_MAX _SC_PII_OSI_CLTS psutil_net_if_addrs py_retlist _SC_TYPED_MEMORY_OBJECTS ml_meth __RLIMIT_MEMLOCK base_addr _SC_2_PBS _SC_PHYS_PAGES IFF_MASTER _SC_PII_SOCKET IFF_DEBUG _SC_MULTI_PROCESS _SC_LEVEL2_CACHE_ASSOC __priority_which sa_family ifmap _SC_THREAD_KEYS_MAX PyErr_Format IFF_BROADCAST _SC_THREAD_THREADS_MAX _SC_GETPW_R_SIZE_MAX ifa_data SOCK_NONBLOCK PRIO_PGRP _SC_2_PBS_MESSAGE _SC_RTSIG_MAX sockaddr_ll _SC_THREAD_ATTR_STACKADDR PyList_New PyModuleDef _SC_FILE_LOCKING _SC_SHARED_MEMORY_OBJECTS _SC_TRACE_NAME_MAX _SC_COLL_WEIGHTS_MAX _SC_XOPEN_ENH_I18N _SC_XOPEN_LEGACY _SC_JOB_CONTROL IFF_DYNAMIC ifa_next RLIMIT_STACK _SC_MESSAGE_PASSING _SC_NL_LANGMAX _SC_IOV_MAX _SC_USER_GROUPS SOCK_CLOEXEC _SC_IPV6 _SC_LEVEL3_CACHE_LINESIZE _SC_2_PBS_LOCATE ifru_ivalue _SC_NL_SETMAX _SC_NL_ARGMAX ifu_broadaddr nic_name _SC_THREAD_PRIO_INHERIT sll_addr _SC_TRACE_USER_EVENT_MAX inquiry sockaddr_x25 SOCK_RDM _SC_AIO_PRIO_DELTA_MAX _SC_XOPEN_XCU_VERSION psutil_proc_cpu_affinity_get psutil_users psutil_disk_partitions psutil_proc_ioprio_set psutil_net_if_duplex_speed psutil_linux_sysinfo psutil_proc_ioprio_get psutil_proc_cpu_affinity_set PyInit__psutil_linux psutil/_psutil_linux.c _IO_buf_end _flags2 py_dev _old_offset PyThreadState endmntent PyEval_SaveThread _IO_save_end _IO_write_end mnt_dir _IO_write_ptr _IO_buf_base _markers _IO_read_end stderr setmntent _lock _cur_column mnt_fsname PyEval_RestoreThread _pos fprintf mnt_passno mnt_opts __builtin_fputc py_mountp _sbuf entry _IO_FILE __builtin_fwrite file __pad4 _IO_marker _shortbuf _IO_write_base _unused2 _IO_read_ptr PyUnicode_DecodeFSDefault PyErr_SetFromErrnoWithFilename __pad1 __pad2 __pad3 __pad5 mnt_type __off64_t _chain __off_t _IO_backup_base _save mtab_path _mode _IO_read_base _vtable_offset _IO_save_base _fileno psutil/arch/linux/disk.c _IO_lock_t getmntent mnt_freq PySequence_GetItem ncpus cpucount_s __bits PyExc_OverflowError PyErr_NoMemory PySequence_Size PyLong_AsLong sched_getaffinity __sched_cpufree PyErr_Occurred item iodata IOPRIO_WHO_PROCESS py_list cpu_num setsize py_cpu_set seq_len __cpu_mask ioprio __sched_cpualloc PySequence_Check __cpu psutil/arch/linux/proc.c cpu_set_t ioclass __sched_cpucount PyExc_TypeError sched_setaffinity py_username __unused ut_line exit_status tv_sec __s2_len psutil/arch/linux/users.c __s1 ut_id ut_host ut_addr_v6 ut_type setutent ut_user py_hostname __result ut_tv endutent utmp py_tty e_exit ut_session ut_pid __s1_len ut_exit getutent tv_usec e_termination procs __u32 loads freehigh totalram uptime __kernel_long_t bufferram sharedram totalhigh freeswap __kernel_ulong_t totalswap mem_unit freeram psutil/arch/linux/mem.c clock_type mdio_support psutil_ethtool_cmd_speed ifru_settings maxrxpkt raw_hdlc_proto speed_hi dlci ethcmd ifs_ifsu parity fr_proto_pvc reserved autoneg maxtxpkt __u8 timeout phy_address t391 t392 cisco_proto ethtool_cmd lp_advertising encoding eth_tp_mdix fr_proto_pvc_info eth_tp_mdix_ctrl interval master psutil/arch/linux/net.c raw_hdlc fr_proto cisco if_settings te1_settings clock_rate loopback ecmd supported n391 n392 n393 slot_map sync_serial_settings fr_pvc_info transceiver duplex memset fr_pvc uint_speed sync 0 7 U7 � �U� 0 > T> I UI � �T� X c P � � U� * �U� � � T� � U� * �T� 0 Q UQ � �U� x P � V� � V � � V� � V � � V� � V � � U� & �U� � � P� V
# V � V
# V � � V
# V U G \G � �U� ^ e Pe | V� � V f | V� � V k r V� � V c � P� A \ + > P � � U� � �U� � � T� � U� � �T� � � ��� P B VH T UT i Vj � V % PH T P P T UT E �U� P b Tb � V� � �T�� � V� E �T� P � ��� � P� � V�
��
P
Q
VV
J ��J W VW E �� � � P!
3
P c r Pr � \� D
\V
E \ � � V�
VV
J VW * V � � \� � \4
D
\J W \ � �
RQ �* @
RQ � � � \* @ \ � � 0�� � P� � V� � 0�* @ V * E V � � V � � V � E
�P � � E \ � 0� " P" / ]/ E 0� / J ] / J ] J �
�P � J � \ J _ 0�_ r Pr { ]{ � 0� { � ] { � ] � �
�S � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] �
%
HQ � �
% \ �
�
0��
P ] % 0� �
] * ] * ] V
�
�P � V
�
\ V
o
0�o
�
P�
�
]�
�
0� �
�
] �
�
] �
�
�P � �
�
\ �
�
0��
�
P�
�
]�
�
0� �
�
] �
�
] �
E
0Q � �
E \ �
0� " P" / ]/ E 0� / J ] / J ] W �
6Q � W � \ W o 0�o � P� � ]� � 0� � � ] � � ] � �
@Q � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] � E
Q � � E \ � 0� " P" / ]/ E 0� / J ] / J ] J �
�R � J � \ J _ 0�_ r Pr ] � 0� � ] � ] � �
Q � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] � 5
Q � � 5
\ � � 0��
P
]
5
0�
:
]
:
] :
�
Q � :
�
\ :
O
0�O
b
Pb
o
]o
�
0� o
�
] o
�
] �
�
)Q � �
�
\ �
�
0��
�
P�
�
]�
�
0� �
�
] �
�
] U � �U�
T
U � �T� 8 ��8 S PS � V� � U� � V j u P� � P U � �U� $ T$ � �T� K V � V� � Vm � V Y � ^ ^ ^� � ^m � ^ * < P< �� � �� * � 0�� � P� � Z� � ��� 0� � Z� � �� � 0�m � 0�� � S� � 0�� � Z� � 0� * Y 0�Y � \� � 0�( > P> � \ ( \( 0�� m \m � P� � \� � 0� * Y 0�Y � S� B 0�B N PN � S ; S; � 0�� m Sm � 0�� � S� � P� � 0� * s 0�y � _� e 0�e l Pl | _ � _ M _M � 0�� m _m � 0�� � S� � 0�� � Z� � 0� * s 0�y � ]� p 0� � ] _ ]_ � 0�� � P� m ]m � 0�� � S� � 0�� � Z� � 0� � � Z� � �� ' Z' �� � � Z� � �� ' Z' �� � � \( \ � � \( \ � � S; S � � S; S � � _M _ � � _M _ � � ]_ ] � � ]_ ] � � ��� � Q� m �� � � Z� � Z� Z � � Z� Z � � \� � \ m \ � � \ 6 \ � � S� � S( m S � � S6 V S � � _� � _H m _ � � _V m _ � � ]� � ] � � ]� � ] ` h Uh ~ �U� ` h Th ~ �T� � � U� � S� �U� S ! �U�! C SC I �U� � � T� V U �T� V U ! �T�! D VD H QH I �T� � � U� � �U� � � T� � U� � �T� � � P� � P � � �U� � � �T� � � U� F �U� � � T� . V. / �T�/ E VE F �T� P ' T/ > T / ? �U� / ? V � � U� � �U� � � P� � X � � �U� . P. � \� � P U z �U� T ] V] z �T� h 0�h l Pl � ]� z ] � � P� � SG W PW Z S� S_ m S � 0�� � P� � V� � 0�� V m 0�m z V � 0�� � P� � Q� � _� 0� ( _( � 0�� � _� m 0�m z _ � 0�� � P� S 0� 6 S6 � 0�� � S� m 0�m z S + P+ � \� z \ ] a Pa v VZ � V _ V � P V � P V � _( P _ � _( P _ S6 G S S6 G S � � 0�� � V� Vh m 0�m z V � � V� Vm z V � � 0�� � _ 0�h m 0�u z _ � � _ � � 0�� � Sh m 0� � � S � � \ 0 5 U5 � �U� 0 > T> [ U[ � �T� c � ��� � �� � � 0�� * S� � S � � P� * \c � \ � � V� P * V� � V � � _ P * _� � _ � � V * V� � V � � V * V� � V � � _ U & �U� T / U/ & �T� � � S1 7 0�7 � S� � S & S 9 � ]� � A�� ] A� ] ) A�� � ]� � A�� ] � � \1 7 P7 � \� � |�� � \� � \ & \ 1 7 P 9 C \] � \� 1 \� � \� \ 9 0�9 C V] t Pt � V� � V� � P� & V � 0�� � ]� 0� - P- � ]� � 0�� � ]� 0� & ] � � s $ &�7 C UF a Ua � s $ &�� � s $ &�� � s $ &� & s $ &� � � ^e x Px � ^� � ^ & ^ � � ^ � � ^� � ^ � � ]� � 0� & ] � � ] & ] � � U� � �U� � � T� � U� � �T� � � �h�=$�l�!�� � R � � P� � P � � �h�=$�l�!�� � R � � �d � � 1� U t �U� T U t �T� 7 I PI O QO R T\ g P < I p =&�I O q =&�O R t =&�R V T < I p
� �I O q
� �O V Q $ 6 �l $ 7 1� U H �U� T H �T� 8 O PO 8 S8 L PL M S_ H S % P% M ]_ � ]� � ]� � U H ] � 0�� � P� \ M 0�_ h \h } 0�} � \� � 0�� � \ \8 F 0� S 0�S d Pd _ M 0�_ � 0�� H _ h 0�h � P� ^ M 0�_ � 0�� � ^ ^8 F 0� � 0�� � P� V M 0�_ } 0�} � V� � 0�� � P� � V V8 F 0� q A 2�_ � 2� 8 2� q � s� �� � X� 8 s� �_ � s� �� � X� � s� � 8 s� � q w s� ��: �w } s� ��0 �} � s� ���� � s� ��� � � 4�� � 4� A __ � _ A __ � _ A ^_ � ^ A ^_ � ^ A V_ } V A V_ } V A \h } \ A \h } \ � � _ _8 F _ � � _ 8 _8 H _ � � ^ . ^F F 0� � � ^ ^ 8 ^
� � V V. 8 VF H 0� � � V. 8 V � � \ \F H 0� � � \ \ � � ]� � ]� � U
] U d �U� T d �T� U Q �U� T U Q �T� ; 0�; Z PZ � V�
V
P $ V* N V � � P� � P � � T � � �L�
��@$���
��!� � � Q
� 0�� � P� � \� < 0� � � ��� f r � � k r � � � � � � � � � � � � � � [ f � � � � ( � � ( ; � � ; M � � M _ � � _ r � � � � � � � � � � � � ( � � ( � � ( H � � @ H � � H p � � ` p � � � � � � � � � 4
?
J R � � * E � � * E �
�
* �
B S Z m � � 6 < � � ( � ( 6 � � � � � h h m u � � � m u � � � � � � h h u z � � � � � � � � h m � � � � � � � � ] � � � � � { ~ � � � � � � � � & � � & % ) C ] � � � * � � � � � � � � 0 0 0 h � � � � � ` h � � 8 F � � . F F � � . � � . 8 F F � � . 8 � �
F H � �
� � � � � �
� � � � � � 8 ` � � x �
0$ E
P �T �U �m �m �m �m �o p r �u � 0$ `$ ! �$ 7 �u C �m j �$ v �m � � � � � �' � � `( � � @) a � �) �* � $ �. v = / � Q 6 n r h x �r � � n �s h x t ` � � � � � � � � � � � � \[ � � �m � �m � �T � �u � p # . ? V n � � � � � � 9 � . > Z 0= & w `? � � E � �C Q � � 7 � � � ' 6
: M ` s � � � � � � 0< t ' < L a p � � � � � � � �6 i � �< y �$ � ; Q h � � � � � 06 W � �9 z �% � 3 B Y o ' W � � � � � & � � � �u �@ H % D Q f z � � � �& j � " � �' ) # @C d 8 crtstuff.c deregister_tm_clones __do_global_dtors_aux completed.0 __do_global_dtors_aux_fini_array_entry frame_dummy __frame_dummy_init_array_entry _psutil_common.c _psutil_posix.c psutil_net_if_mtu psutil_net_if_is_running psutil_posix_setpriority psutil_convert_ipaddr psutil_net_if_addrs psutil_posix_getpriority psutil_net_if_flags psutil_getpagesize_pywrapper moduledef mod_methods _psutil_linux.c disk.c proc.c users.c mem.c net.c __FRAME_END__ __dso_handle _DYNAMIC __GNU_EH_FRAME_HDR __TMC_END__ _GLOBAL_OFFSET_TABLE_ getenv@@GLIBC_2.2.5 PyList_New PySequence_Check endmntent@@GLIBC_2.2.5 PyModule_AddIntConstant __errno_location@@GLIBC_2.2.5 strncpy@@GLIBC_2.2.5 getpriority@@GLIBC_2.2.5 _ITM_deregisterTMCloneTable PyEval_RestoreThread PyErr_SetFromErrno PyInit__psutil_linux _Py_Dealloc PyErr_NoMemory PyErr_SetObject __sched_cpucount@@GLIBC_2.6 psutil_proc_cpu_affinity_get psutil_proc_cpu_affinity_set _fini psutil_net_if_duplex_speed PyExc_RuntimeError PyInit__psutil_posix PyErr_SetString PyExc_ValueError PyExc_TypeError setpriority@@GLIBC_2.2.5 psutil_getpagesize ioctl@@GLIBC_2.2.5 close@@GLIBC_2.2.5 PySequence_GetItem getnameinfo@@GLIBC_2.2.5 sched_setaffinity@@GLIBC_2.3.4 fputc@@GLIBC_2.2.5 endutent@@GLIBC_2.2.5 PyLong_FromLong PySequence_Size psutil_proc_ioprio_get PyList_Append PyExc_OSError fprintf@@GLIBC_2.2.5 _Py_FalseStruct syscall@@GLIBC_2.2.5 __gmon_start__ PyObject_CallFunction PyExc_OverflowError Py_BuildValue kill@@GLIBC_2.2.5 PyErr_Occurred PyModule_Create2 PyLong_AsLong psutil_raise_for_pid psutil_proc_ioprio_set psutil_PyErr_SetFromOSErrnoWithSyscall getutent@@GLIBC_2.2.5 getmntent@@GLIBC_2.2.5 setmntent@@GLIBC_2.2.5 _Py_NoneStruct getifaddrs@@GLIBC_2.3 __sched_cpufree@@GLIBC_2.7 PyObject_IsTrue PyArg_ParseTuple psutil_pid_exists psutil_disk_partitions NoSuchProcess __sched_cpualloc@@GLIBC_2.7 _Py_TrueStruct freeifaddrs@@GLIBC_2.3 setutent@@GLIBC_2.2.5 psutil_set_debug PyUnicode_DecodeFSDefault PyUnicode_FromString PyEval_SaveThread PyModule_AddObject AccessDenied sysconf@@GLIBC_2.2.5 PSUTIL_DEBUG psutil_users sysinfo@@GLIBC_2.2.5 PyErr_SetFromErrnoWithFilename PyErr_Format sprintf@@GLIBC_2.2.5 fwrite@@GLIBC_2.2.5 _ITM_registerTMCloneTable sched_getaffinity@@GLIBC_2.3.4 strerror@@GLIBC_2.2.5 psutil_check_pid_range __cxa_finalize@@GLIBC_2.2.5 _init psutil_setup stderr@@GLIBC_2.2.5 psutil_linux_sysinfo socket@@GLIBC_2.2.5 .symtab .strtab .shstrtab .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .text .fini .rodata .eh_frame_hdr .eh_frame .init_array .fini_array .data.rel.ro .dynamic .got .got.plt .data .bss .comment .debug_aranges .debug_info .debug_abbrev .debug_line .debug_str .debug_loc .debug_ranges 8 8 $ . ���o ` ` � 8 � @ � � � H ���o � � � U ���o x x � d � � ( n B x s ~ 0$ 0$ � � E E � 2 P P � � �T �T � � �U �U � � �m �] � �m �] � �m �] � �m �] � � �o �_ p � p ` � r b ` � �u �e � 0 �e / � �e � /g Sw �� � # 9� c, / 0 � �# : �B �P E 5� � � ! D � L d� S PK ok\��G��r �r , psutil/__pycache__/_pswindows.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl
m Z ddl m Z ddl m
Z
ddl mZ dd l mZ dd
l mZ dd l mZ dd l mZ dd
l mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddl m Z ddl m!Z! ddl m"Z" ddl m#Z# dd l m$Z$ dd l m%Z% zdd l
m Z& W nl e'�y� Z( zRe)e(��*� �+d ��r�e�,� d d k �r�d!Z-e-d"7 Z-e-d#7 Z-e.e-��n� W Y dZ([(n
dZ([(0 0 e�rddl/Z/ndZ/g d$�Z0d%Z1d&Z2d'ej3v Z4e/du �r0d(Z5ne/�6d)d*d(i�Z7e7j5Z5e&j8e j9e&j:e j;e&j<e j=e&j>e j?e&j@e jAe&jBe jCe&jDe jEe&jFe jGe&jHe jIe&jJe jKe&jLe jMe&jNe1e&jOe jPi
ZQe/du�r�G d+d,� d,e/j6�ZReS� �TeRjU� e/du �r�dZVdZWd-ZXd.ZYn G d/d0� d0e/j6�ZZeS� �TeZjU� e[ddd-d.d1d2d d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdB�Z\e dCg dD��Z]e dEg dF��Z^e dGg dH��Z_e dIe_j`dJ �Zae dKdLdMg�Zbe dNdOdP�cebj`� �Zde dQg dR��Zee dSdT�dUdV� �ZfdWdX� ZgedYdZ� �Zhd[d\� Zid]d^� Zje&jkZkd_d`� Zldadb� Zmdcdd� Zndedf� Zodgdh� Zpdidj� Zqdkdl� Zrdmdn� Zsdoatdpdq� Zud�drds�Zvdtdu� Zwdvdw� Zxdxdy� Zydzd{� Zzda{d|d}� Z|d~d� Z}d�d�� Z~d�d�� ZG d�d�� d��Z�e&j�Z�e&j�Z�e&j�Z�d�d�� Z�d�d�d��Z�d�d�� Z�d�d�� Z�G d�d�� d��Z�dS )�z Windows platform implementation.� N)�
namedtuple� )�_common)�ENCODING)�
ENCODING_ERRS)� AccessDenied)�
NoSuchProcess)�TimeoutExpired)� conn_tmap)�conn_to_ntuple)�debug)�
isfile_strict)�memoize)�memoize_when_activated)�parse_environ_block)�
usage_percent)�PY3)�long)� lru_cache��range)�unicode)�ABOVE_NORMAL_PRIORITY_CLASS)�BELOW_NORMAL_PRIORITY_CLASS)�HIGH_PRIORITY_CLASS)�IDLE_PRIORITY_CLASS)�NORMAL_PRIORITY_CLASS)�REALTIME_PRIORITY_CLASS)�_psutil_windowszdll load failed� z3this Windows version is too old (< Windows Vista); z:psutil 3.4.2 is the latest version which supports Windows z2000, XP and 2003 server)�win_service_iter�win_service_getr r r r r r �IOPRIO_VERYLOW�
IOPRIO_LOW�
IOPRIO_NORMAL� IOPRIO_HIGH�CONN_DELETE_TCB�AF_LINKZ
DELETE_TCBi+ Z__pypy__����
AddressFamilyr' c @ s$ e Zd ZeZeZeZeZeZeZdS )�PriorityN) �__name__�
__module__� __qualname__r r r r r r � r. r. �=/usr/local/lib64/python3.9/site-packages/psutil/_pswindows.pyr* s s r* � � c @ s e Zd ZdZdZdZdZdS )�
IOPriorityr r r0 r1 N)r+ r, r- r" r# r$ r% r. r. r. r/ r2 � s r2 � � � � � �
� � �
� � � � � � � � )� num_handles� ctx_switches� user_time� kernel_time� create_time� num_threads� io_rcount� io_wcount� io_rbytes� io_wbytes�io_count_others�io_bytes_others�num_page_faults� peak_wset�wset�peak_paged_pool�
paged_pool�peak_non_paged_pool�non_paged_pool�pagefile�
peak_pagefile� mem_private� scputimes)�user�system�idle� interrupt�dpc�svmem)�total� available�percent�used�free�pmem) �rss�vmsrP rQ rR rS rT Zpeak_nonpaged_poolZ
nonpaged_poolrW rX �private�pfullmem)�uss�
pmmap_grouped�pathrg � pmmap_extz addr perms � �pio)Z
read_countZ write_count�
read_bytes� write_bytes� other_countZ other_bytesi )�maxsizec C s@ d� | �d�dd� �}t�|�}| t|�d� }tj� ||�S )z�Convert paths using native DOS format like:
"\Device\HarddiskVolume1\Windows\systemew\file.txt"
into:
"C:\Windows\systemew\file.txt".
�\Nr1 )�join�split�cextZQueryDosDevice�len�osrm )�sZrawdriveZ driveletter� remainderr. r. r/ �convert_dos_path� s
r} c C s& t r| S t| t�r| S | �tt�S dS )zmEncode a unicode string to a byte string by using the default fs
encoding + "replace" error handler.
N)r �
isinstance�str�encoder r )r{ r. r. r/ �
py2_strencode� s
r� c C s t �� S �N)rx � getpagesizer. r. r. r/ r� � s r� c
C sJ t �� } | \}}}}|}|}|}|| }t|| |dd�} t||| ||�S )z&System virtual memory as a namedtuple.r �Zround_)rx � virtual_memr r` )
�memZtotphysZ availphysZ_totsysZ _availsysra Zavailre rd rc r. r. r/ �virtual_memory� s r� c C sp t �� } | d }| d }|| }|dkrBt �� }td| | �}nd}d}|| }t|d�}t�||||dd�S )z=Swap system memory as a (total, used, free, sin, sout) tuple.r r0 g{�G�z�?� r )rx r� Z swap_percent�int�roundr Zsswap)r� Z
total_physZ total_systemra Z percentswaprd re rc r. r. r/ � swap_memory� s
r� c C sP t r t| t�r | jtdd�} t�| �\}}|| }t||dd�}t� ||||�S )z'Return disk usage associated with path.�strict)�errorsr r� )
r r~ �bytes�decoder rx �
disk_usager r Z
sdiskusage)rm ra re rd rc r. r. r/ r� s r� c C s t �| �}dd� |D �S )zReturn disk partitions.c S s g | ]}t j|� �qS r. )r Z sdiskpart��.0�xr. r. r/ �
<listcomp>+ � z#disk_partitions.<locals>.<listcomp>)rx �disk_partitions)�all�rawlistr. r. r/ r� ( s
r� c C s< t �� \} }}tdd� tt �� � D �� }t| |||j|j�S )z)Return system CPU times as a named tuple.c S s g | ] }t |��qS r. )�sum)r� �nr. r. r/ r� 9 r� z cpu_times.<locals>.<listcomp>)rx � cpu_timesrZ �zip�
per_cpu_timesr^ r_ )r[ r\ r] Z
percpu_summedr. r. r/ r� 3 s
�r� c C s: g } t �� D ](\}}}}}t|||||�}| �|� q | S )z6Return system per-CPU times as a list of named tuples.)rx r� rZ �append)�retr[ r\ r] r^ r_ �itemr. r. r/ r� ? s
r� c C s t �� S )z0Return the number of logical CPUs in the system.)rx �cpu_count_logicalr. r. r. r/ r� H s r� c C s t �� S )z-Return the number of CPU cores in the system.)rx �cpu_count_coresr. r. r. r/ r� M s r� c C s$ t �� \} }}}d}t�| |||�S )zReturn CPU statistics.r )rx � cpu_statsr Z scpustats)rE Z
interruptsZ_dpcsZsyscallsZsoft_interruptsr. r. r/ r� R s
�r� c C s( t �� \} }d}t�t| �|t|��gS )zMReturn CPU frequency.
On Windows per-cpu frequency is not supported.
r� )rx �cpu_freqr Zscpufreq�float)�currZmax_Zmin_r. r. r/ r� [ s r� Fc C s* t st�� da t�� } tdd� | D ��S )z�Return the number of processes in the system run queue averaged
over the last 1, 5, and 15 minutes respectively as a tuple.
Tc S s g | ]}t |d ��qS )r0 )r� )r� �loadr. r. r/ r� s r� z getloadavg.<locals>.<listcomp>)�_loadavg_inititializedrx Zinit_loadavg_counter�
getloadavg�tuple)Z raw_loadsr. r. r/ r� g s
r� c C s� | t vr(td| d�dd� t D ��f ��t | \}}t�|||�}t� }|D ]D}|\}}} }
} } }
t||| |
| | t|dkr~|
ndd�}|�|� qLt |�S )z�Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
z+invalid %r kind argument; choose between %sz, c S s g | ] }t |��qS r. )�reprr� r. r. r/ r� � r� z#net_connections.<locals>.<listcomp>r( N)�pid)
r
�
ValueErrorrv rx �net_connections�setr � TCP_STATUSES�add�list)�kind�_pidZfamilies�typesr� r� r� �fd�fam�type�laddr�raddr�statusr� �ntr. r. r/ r� { s. �� �
r� c C sz i } t �� }|�� D ]`\}}ts>t|t�s6J t|���t|�}|\}}}}tt d�r^t �
|�}t � ||||d�| |< q| S )z)Get NIC stats (isup, duplex, speed, mtu).� NicDuplex� ) rx � net_if_stats�itemsr r~ r r� r� �hasattrr r� Z snicstats)r� Zrawdict�namer� ZisupZduplex�speedZmtur. r. r/ r� � s
r� c C s t �� } tdd� | �� D ��S )zsReturn network I/O statistics for every network interface
installed on the system as a dict of raw tuples.
c S s g | ]\}}t |�|f�qS r. �r� )r� �k�vr. r. r/ r� � r� z#net_io_counters.<locals>.<listcomp>)rx �net_io_counters�dictr� �r� r. r. r/ r� � s r� c C s8 g } t �� D ]&}t|�}t|d �|d< | �|� q | S )z,Return the addresses associated to each NIC.r )rx � net_if_addrsr� r� r� )r� r� r. r. r/ r� � s r� c C sd t �� \} }}}| dk}t|d@ �}t|d@ �}|r8dS |s@|rHtj}n|dkrVtj}t�|||�S )zReturn battery information.r � r6 Nr( )rx �sensors_battery�boolr ZPOWER_TIME_UNLIMITEDZPOWER_TIME_UNKNOWNZsbattery)Z
acline_status�flagsrc ZsecsleftZ
power_pluggedZ
no_batteryZchargingr. r. r/ r� � s r� c C s, t t�� �} t| t �dkr tS | a| S dS )z:The system boot time expressed in seconds since the epoch.r N)r� rx � boot_time�abs� _last_btimer� r. r. r/ r� � s
r� c C sH g } t �� }|D ]2}|\}}}t|�}t�|d||d�}| �|� q| S )z:Return currently connected users as a list of namedtuples.N)rx �usersr� r Zsuserr� )�retlistr� r� r[ �hostnameZtstampr� r. r. r/ r� � s
r� c c s* t �� D ] \} }tt| �t|��V qdS )z*Yields a list of WindowsService instances.N)rx Zwinservice_enumerate�WindowsServicer� )r� � display_namer. r. r/ r � s r c C s t | d�}|�� d |_|S )zBOpen a Windows service and return it as a WindowsService instance.Nr� )r� �
_query_config�
_display_name)r� Zservicer. r. r/ r! � s
r! c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
e j dd� �Z
dd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$S )%r� z(Represents an installed Windows service.c C s || _ || _d S r� )�_namer� )�selfr� r� r. r. r/ �__init__ s zWindowsService.__init__c C s d| j | jf }d| jj|f S )Nz(name=%r, display_name=%r)z%s%s)r� r� � __class__r+ )r� �detailsr. r. r/ �__str__ s
�zWindowsService.__str__c C s d| � � t| �f S )Nz
<%s at %s>)r� �id�r� r. r. r/ �__repr__ s zWindowsService.__repr__c C s t |t�stS | j|jkS r� )r~ r� �NotImplementedr� �r� �otherr. r. r/ �__eq__ s
zWindowsService.__eq__c C s
| |k S r� r. r� r. r. r/ �__ne__ s zWindowsService.__ne__c C s\ | � � �$ t�| j�\}}}}W d � n1 s20 Y tt|�t|�t|�t|�d�S )N)r� �binpath�username�
start_type)�_wrap_exceptionsrx Zwinservice_query_configr� r� r� )r� r� r� r� r� r. r. r/ r� s
�(�z WindowsService._query_configc C sP | � � � t�| j�\}}W d � n1 s.0 Y |dkrDd }t||d�S )Nr )r� r� )r� rx Zwinservice_query_statusr� r� )r� r� r� r. r. r/ �
_query_status- s
.z WindowsService._query_statusc
c s� z
dV W nx t y� } z`t|�r>d| j }td| j|d��n0|jtjtjfv rld| j }td| j|d��n� W Y d}~n
d}~0 0 dS )z{Ctx manager which translates bare OSError and WindowsError
exceptions into NoSuchProcess and AccessDenied.
Nz2service %r is not querable (not enough privileges)�r� r� �msgzservice %r does not exist) �OSError�is_permission_errr� r �winerrorrx ZERROR_INVALID_NAMEZ ERROR_SERVICE_DOES_NOT_EXISTr )r� �errr� r. r. r/ r� 4 s
���
z WindowsService._wrap_exceptionsc C s | j S )z�The service name. This string is how a service is referenced
and can be passed to win_service_get() to get a new
WindowsService instance.
)r� r� r. r. r/ r� M s zWindowsService.namec C s | j S )z_The service display name. The value is cached when this class
is instantiated.
)r� r� r. r. r/ r� T s zWindowsService.display_namec C s | � � d S )zwThe fully qualified path to the service binary/exe file as
a string, including command line arguments.
r� �r� r� r. r. r/ r� Z s zWindowsService.binpathc C s | � � d S )z,The name of the user that owns this service.r� r� r� r. r. r/ r� ` s zWindowsService.usernamec C s | � � d S )zRA string which can either be "automatic", "manual" or
"disabled".
r� r� r� r. r. r/ r� d s zWindowsService.start_typec C s | � � d S )zzThe process PID, if any, else None. This can be passed
to Process class to control the service's process.
r� �r� r� r. r. r/ r� l s zWindowsService.pidc C s | � � d S )zService status as a string.r� r� r� r. r. r/ r� r s zWindowsService.statusc C s t t�| �� ��S )zService long description.)r� rx Zwinservice_query_descrr� r� r. r. r/ � descriptionv s zWindowsService.descriptionc C s> | � � }|�| �� � | �� |d< | �� |d< | �� |d< |S )zUUtility method retrieving all the information above as a
dictionary.
r� r� r� )r� �updater� r� r� r� )r� �dr. r. r/ �as_dict| s zWindowsService.as_dictN)r+ r, r- �__doc__r� r� r� r� r� r� r� �
contextlib�contextmanagerr� r� r� r� r� r� r� r� r� r� r. r. r. r/ r� s&
r� c C s@ t | t�sJ | ��| jtjtjfv r(dS t| dd�tjtjfv S )z*Return True if this is a permission error.Tr� r( ) r~ r� �errno�EPERM�EACCES�getattrrx ZERROR_ACCESS_DENIEDZERROR_PRIVILEGE_NOT_HELD)�excr. r. r/ r� � s
�r� c C sF t | t�sJ | ��t| �r&t||d�S | jtjkr>t||d�S | �dS )z3Convert OSError into NoSuchProcess or AccessDenied.�r� r� N)r~ r� r� r r� ZESRCHr )r� r� r� r. r. r/ �convert_oserror� s r c s t �� �� fdd��}|S )zDDecorator which converts OSError into NoSuchProcess or AccessDenied.c
sT z� | g|�R i |��W S t yN } z t|| j| jd��W Y d }~n
d }~0 0 d S )Nr )r� r r� r� )r� �args�kwargsr� ��funr. r/ �wrapper� s z wrap_exceptions.<locals>.wrapper�� functools�wraps�r r r. r r/ �wrap_exceptions� s r c s t �� �� fdd��}|S )z�Workaround for https://github.com/giampaolo/psutil/issues/875.
See: https://stackoverflow.com/questions/4457745#4457745.
c s� d}d}t |�D ]z}z � | g|�R i |��W S ty� } z@|}|jtkrrt�|� t|d d�}W Y d }~q� W Y d }~qd }~0 0 qd�� ||�}t| j | j
|d��d S )N�-C ��6?�! r0 �{�G�z�?zH{} retried {} times, converted to AccessDenied as it's stillreturning {}r� ) r � WindowsErrorr� �ERROR_PARTIAL_COPY�time�sleep�min�formatr r� r� )r� r r �delay�times�_r� r� r r. r/ r � s"
��z)retry_error_partial_copy.<locals>.wrapperr r
r. r r/ �retry_error_partial_copy� s r c @ s� e Zd ZdZg d�Zdd� Zdd� Zdd� Zed d
� �Z d d � Z
e ed
d� ��Z e e
dd� ��Ze e
dd� ��Zdd� Zdd� Ze dd� �Ze dd� �Zdd � Ze d d � �Ze d d � �Ze dNd"d#��Ze d$d%� �Ze dOd'd(��Ze d)d*� �Ze d+d,� �Ze d-d.� �Z e d/d0� �Z e d1d2� �Z e e
d3d4� ��Z e d5d6� �Z e dPd8d9��Z!e d:d;� �Z"e d<d=� �Z#e d>d?� �Z$e d@dA� �Z%e dBdC� �Z&e dDdE� �Z'e dFdG� �Z(e dHdI� �Z)e dJdK� �Z*e dLdM� �Z+d!S )Q�Processz1Wrapper class around underlying C implementation.)�_cacher� �_ppidr� c C s || _ d | _d | _d S r� )r� r� r )r� r� r. r. r/ r� � s zProcess.__init__c C s | j �| � | j�| � d S r� )�
_proc_infoZcache_activate�exer� r. r. r/ �
oneshot_enter s zProcess.oneshot_enterc C s | j �| � | j�| � d S r� )r Zcache_deactivater r� r. r. r/ � oneshot_exit
s zProcess.oneshot_exitc C s$ t �| j�}t|�tt�ks J �|S )zOReturn multiple information about this process as a
raw tuple.
)rx Z proc_infor� ry � pinfo_map�r� r� r. r. r/ r s zProcess._proc_infoc C s, | j dkrdS | j dkr dS tj�| �� �S )zbReturn process name, which on Windows is always the final
part of the executable.
r zSystem Idle Processr3 �System)r� rz rm �basenamer r� r. r. r/ r� s
z Process.namec
C s� t rbzt�| j�}W qn ty^ } z2|jdkrHtd| � t| j| j��� W Y d }~qnd }~0 0 n t�| j�}t szt
|�}|� d�r�t |�S |S )N� z %r translated into AccessDeniedru )
�PYPYrx Zproc_exer� r r� r r r� r r� �
startswithr} )r� r r� r. r. r/ r # s
z Process.exec
C s� t jt jkrdzt j| jdd�}W qt ty` } z(t|�rJt j| jdd�}n� W Y d }~qtd }~0 0 nt j| jdd�}tr||S dd� |D �S d S )NT)Zuse_pebFc S s g | ] }t |��qS r. r� )r� r{ r. r. r/ r� J r� z#Process.cmdline.<locals>.<listcomp>)rx ZWINVERZ WINDOWS_8_1Z proc_cmdliner� r� r� r )r� r� r� r. r. r/ �cmdline8 s zProcess.cmdlinec C s6 t �| j�}|r*ts*t|t�s*J t|���tt|��S r� ) rx Z proc_environr� r r~ r r� r r� )r� Zustrr. r. r/ �environL s zProcess.environc C s4 zt � | j W S ty. t| j| j��Y n0 d S r� )�ppid_mapr� �KeyErrorr r� r� r. r. r/ �ppidT s z Process.ppidc C s� zt �| j�W S ty� } z�t|�r�td� | �� }|td |td |td |td |td |td |td |td |td
|td f
W Y d }~S � W Y d }~n
d }~0 0 d S ) Nz*attempting memory_info() fallback (slower)rP rQ rR rS rT rU rV rW rX rY )rx Zproc_memory_infor� r� r� r r r )r� r� �infor. r. r/ �_get_raw_meminfoZ s$
� zProcess._get_raw_meminfoc C s( | � � }|d }|d }t||f| � S )Nr0 r5 )r- rf )r� �trg rh r. r. r/ � memory_infoq s zProcess.memory_infoc C s, | � � }t�| j�}|t� 9 }t||f � S r� )r/ rx Zproc_memory_ussr� r� rj )r� Z basic_memrk r. r. r/ �memory_full_info{ s
zProcess.memory_full_infoc
c s� zt �| j�}W n4 tyD } z t|| j| j��W Y d }~nFd }~0 0 |D ]6\}}}}t|�}tsjt|�}t |�}||||fV qJd S r� )
rx Zproc_memory_mapsr� r� r r� r} r r� �hex)r� �rawr� �addr�permrm rg r. r. r/ � memory_maps� s &zProcess.memory_mapsc C s t �| j�S r� )rx � proc_killr� r� r. r. r/ �kill� s z Process.killc C sX |t jkrt�| j� n<|tt dt� �tt dt� �fv rHt�| j|� n d}t |��d S )NZ CTRL_C_EVENTZCTRL_BREAK_EVENTzPonly SIGTERM, CTRL_C_EVENT and CTRL_BREAK_EVENT signals are supported on Windows)
�signal�SIGTERMrx r6 r� r� �objectrz r7 r� )r� �sigr� r. r. r/ � send_signal� s
��zProcess.send_signalNc C s� |d u rt j}n t|d �}ttdtj�}|d ur<|� | nd }zt �| j|�}W n: t jyv t|| j| j��Y n t j y� d }Y n0 d}t
| j�s�|S |r�|� |kr�t|| j| jd��t� |� t |d d�}q�d S )Ni� � monotonicr r r0 r )
rx ZINFINITEr� r� r Z proc_waitr� r r� ZTimeoutAbandoned�
pid_existsr r )r� �timeoutZ cext_timeout�timerZstop_atZ exit_coder r. r. r/ �wait� s$
z Process.waitc C s2 | j dv rdS t�| j �\}}t|�d t|� S )N�r r3 zNT AUTHORITY\SYSTEMru )r� rx Z
proc_usernamer� )r� �domainr[ r. r. r/ r� � s
zProcess.usernameFc
C sv zt �| j�\}}}|W S typ } z@t|�rZ|r6� td� | �� td W Y d }~S � W Y d }~n
d }~0 0 d S )Nz*attempting create_time() fallback (slower)rH )rx �
proc_timesr� r� r� r r r )r� Z fast_only�_userZ_system�createdr� r. r. r/ rH � s zProcess.create_timec C s | � � td S )NrI )r r r� r. r. r/ rI � s zProcess.num_threadsc C s< t �| j�}g }|D ]"\}}}t�|||�}|�|� q|S r� )rx Z proc_threadsr� r Zpthreadr� )r� r� r� � thread_id�utimeZstime�ntupler. r. r/ �threads� s zProcess.threadsc
C s~ zt �| j�\}}}W nV tyl } z>t|�s0� td� | �� }|td }|td }W Y d }~n
d }~0 0 t� ||dd�S )Nz(attempting cpu_times() fallback (slower)rF rG r� )
rx rD r� r� r� r r r r Z pcputimes)r� r[ r\ Z_createdr� r, r. r. r/ r� � s "zProcess.cpu_timesc C s t �| jd� d S )NT�rx Zproc_suspend_or_resumer� r� r. r. r/ �suspend s zProcess.suspendc C s t �| jd� d S )NFrK r� r. r. r/ �resume s zProcess.resumec C s4 | j dv rt| j | j��t�| j �}ttj�|��S )NrB ) r� r r� rx Zproc_cwdr� rz rm �normpath)r� rm r. r. r/ �cwd
s
z Process.cwdc C sd | j dv rg S t� }t�| j �}|D ]6}t|�}t|�r$tsDt|�}t� |d�}|�
|� q$t |�S )NrB r( ) r� r� rx Zproc_open_filesr} r
r r� r Z popenfiler� r� )r� r� Zraw_file_names�_filerI r. r. r/ �
open_files s
zProcess.open_files�inetc C s t || jd�S )N)r� )r� r� )r� r� r. r. r/ r� ' s zProcess.net_connectionsc C s t �| j�}td ur t|�}|S r� )rx Zproc_priority_getr� �enumr* �r� �valuer. r. r/ �nice_get+ s zProcess.nice_getc C s t �| j|�S r� )rx Zproc_priority_setr� rT r. r. r/ �nice_set2 s zProcess.nice_setc C s t �| j�}td ur t|�}|S r� )rx Zproc_io_priority_getr� rS r2 r! r. r. r/ �
ionice_get6 s zProcess.ionice_getc C s> |rd}t |��|ttttfvr,td| ��t�| j|� d S )Nz&value argument not accepted on Windowsz%s is not a valid priority) � TypeErrorr" r# r$ r% r� rx Zproc_io_priority_setr� )r� ZioclassrU r� r. r. r/ �
ionice_set= s � zProcess.ionice_setc C s� zt �| j�}W n~ ty� } zft|�s*� td� | �� }|td |td |td |td |td |td f}W Y d }~n
d }~0 0 t|� S )Nz*attempting io_counters() fallback (slower)rJ rK rL rM rN rO ) rx Zproc_io_countersr� r� r� r r r rp )r� r� r� r, r. r. r/ � io_countersK s
�zProcess.io_countersc C s t �| j�}|rtjS tjS d S r� )rx Zproc_is_suspendedr� r ZSTATUS_STOPPEDZSTATUS_RUNNING)r� Z suspendedr. r. r/ r� ^ s zProcess.statusc C s dd� }t �| j�}||�S )Nc s � fdd�t d�D �S )Nc s g | ]}d |> � @ r|�qS )r r. )r� �i�r� r. r/ r� i r� zBProcess.cpu_affinity_get.<locals>.from_bitmask.<locals>.<listcomp>�@ r r] r. r] r/ � from_bitmaskh s z.Process.cpu_affinity_get.<locals>.from_bitmask)rx Zproc_cpu_affinity_getr� )r� r_ �bitmaskr. r. r/ �cpu_affinity_getf s zProcess.cpu_affinity_getc C sn dd� }t ttt� ���}|D ]4}||vr t|ttf�sFtd| ��q td| ��q ||�}t �
| j |� d S )Nc S s. | st d| ��d}| D ]}|d| O }q|S )Nzinvalid argument %rr r0 )r� )Zls�out�br. r. r/ �
to_bitmaskp s z,Process.cpu_affinity_set.<locals>.to_bitmaskz&invalid CPU %r; an integer is requiredzinvalid CPU %r) r� r ry r� r~ r� r rY r� rx Zproc_cpu_affinity_setr� )r� rU rd Zallcpus�cpur` r. r. r/ �cpu_affinity_setn s �zProcess.cpu_affinity_setc
C sf zt �| j�W S ty` } z:t|�rJtd� | �� td W Y d }~S � W Y d }~n
d }~0 0 d S )Nz*attempting num_handles() fallback (slower)rD )rx Zproc_num_handlesr� r� r� r r r )r� r� r. r. r/ rD � s zProcess.num_handlesc C s | � � td }t�|d�S )NrE r )r r r Zpctxsw)r� rE r. r. r/ �num_ctx_switches� s zProcess.num_ctx_switches)N)F)rR ),r+ r, r- r� � __slots__r� r r r r r� r r r r' r( r+ r- r/ r0 r5 r7 r< rA r� rH rI rJ r� rL rM rO rQ r� rV rW rX rZ r[ r� ra rf rD rg r. r. r. r/ r � s�
*
r )r( )NN)�r� r� r� r rz r8 �sysr � collectionsr r� r r r r r r r
r r r
r r r r Z_compatr r r r r r r r r r r r rx � ImportErrorr� r �lowerr& �getwindowsversionr� � RuntimeErrorrS Z__extra__all__r& r �builtin_module_namesr% r' �IntEnumr) ZMIB_TCP_STATE_ESTABZCONN_ESTABLISHEDZMIB_TCP_STATE_SYN_SENTZ
CONN_SYN_SENTZMIB_TCP_STATE_SYN_RCVDZ
CONN_SYN_RECVZMIB_TCP_STATE_FIN_WAIT1ZCONN_FIN_WAIT1ZMIB_TCP_STATE_FIN_WAIT2ZCONN_FIN_WAIT2ZMIB_TCP_STATE_TIME_WAITZCONN_TIME_WAITZMIB_TCP_STATE_CLOSEDZ
CONN_CLOSEZMIB_TCP_STATE_CLOSE_WAITZCONN_CLOSE_WAITZMIB_TCP_STATE_LAST_ACKZ
CONN_LAST_ACKZMIB_TCP_STATE_LISTENZ CONN_LISTENZMIB_TCP_STATE_CLOSINGZ CONN_CLOSINGZMIB_TCP_STATE_DELETE_TCBZPSUTIL_CONN_NONEZ CONN_NONEr� r* �globalsr� � __members__r" r# r$ r% r2 r� r rZ r` rf �_fieldsrj rl rv rn rp r} r� r� r� r� Zdisk_io_countersr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r! r� Zpidsr> r) r� r r r r r. r. r. r/ �<module> s6 ��
�
�!���
0
PK ok\ �U� � * psutil/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hB\ � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z z ddl
Z
W n ey� dZ
Y n0 ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# ddlm$Z$ ddlm%Z% ddlm&Z& dd lm'Z' dd lm(Z( dd lm)Z) dd lm*Z* dd lm+Z+ dd!lm,Z, dd"lm-Z- dd#lm.Z. dd$lm/Z/ dd%lm0Z0 dd&lm1Z1 dd'lm2Z2 dd(lm3Z3 dd)lm4Z4 dd*lm5Z5 dd+lm6Z6 dd,lm7Z7 dd-lm8Z8 dd.lm9Z9 dd/lm:Z: dd0lm;Z; dd1lm<Z< dd2lm=Z= dd3lm>Z> dd4lm?Z? dd5lm@ZA dd6lBmCZD dd7lBmEZE dd8lBmFZF dd9lBmGZH dd:lBmIZI e �rVd;ZJdd<lmKZL dd=lKmMZM dd>lKmNZN dd?lKmOZO dd@lKmPZP �ne8�r�ddAlmQZL ddBlRmSZS ddClRmTZT ddDlRmUZU ddElRmVZV ddFlRmWZW ddGlRmXZX ddHlQmYZY ddIlQmZZZ ddJlQm[Z[ ddKlQm\Z\ ddLlQm]Z] n~e!�rddMlm^ZL nje�rddNlm_ZL nVe7�rFddOlm`ZL ddPl`maZa ddQl`mbZb d;ZJn&e�r^ddRlmcZL d;ZJneddSe
je ��g dT�Zfef�geLjh� eieLjjdU��r�ddVlmkZk el� ZmdZneoek�D ]4Znen�pdW��r�en�q� �r�ereken�emen< ef�sen� �q�[m[neLjtZtdXZudYZvewdZd[� ev�xd\�D ��Zyere d]e j �Zzda{da|e}� Z~eev��d\d^��ereLj�d_d�k�r�d`eLj�j� Z�e�da7 Z�eieLj�d_��r�e�dbd\��dcd[� e�eLj�j��D ��evf 7 Z�n e�ddev 7 Z�e�deereLj�dfdg� 7 Z�e�dh7 Z�ee���eieLdi��r�eLj�Z�ndjdk� Z�dldm� Z�G dndo� doe}�Zje�dpd[� eoej�D ��Z�G dqdr� drej�Z�dsdt� Z�dudv� Z�i a�e�� Z�d�dwdx�Z�dydz� e�_�d{e�j�_ d�d|d}�Z�d�dd��Z�d�d�d��Z�ze ��� j�e�� iZ�W n e��y� i Z�Y n0 ze ��� j�e�d~d��iZ�W n e��y� i Z�Y n0 d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�e���� Z�e���� Z�d�d�d��Z�d�d�� Z�eieLd���r8d�d�d��Z�ef�sd�� eied���sPeieLd���rteied���rdej�Z�neLj�Z�ef�sd�� d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�d�d�d��Z�e��eAj�d��e�_�d�e�j�_ d�d�d��Z�e��eAj�d��e�_�d�e�j�_ d�d�d��Z�d�d�� Z�d�d�� Z�eieLd���rd�d�d��Z�ef�sd�� eieLd���r2d�d�� Z�ef�sd�� eieLd���rPd�d�� Z�ef�sd�� d�d�� Z�d�d�� Z�e8�rvd�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�[?[e
jyd d�k �r�[�[�e�d�k�r�e�� dS )�a/ psutil is a cross-platform library for retrieving information on
running processes and system utilization (CPU, memory, disks, network,
sensors) in Python. Supported platforms:
- Linux
- Windows
- macOS
- FreeBSD
- OpenBSD
- NetBSD
- Sun Solaris
- AIX
Works with Python versions 2.7 and 3.6+.
� )�divisionN� )�_common)�AIX)�BSD)�
CONN_CLOSE)�CONN_CLOSE_WAIT)� CONN_CLOSING)�CONN_ESTABLISHED)�CONN_FIN_WAIT1)�CONN_FIN_WAIT2)�
CONN_LAST_ACK)� CONN_LISTEN)� CONN_NONE)�
CONN_SYN_RECV)�
CONN_SYN_SENT)�CONN_TIME_WAIT)�FREEBSD)�LINUX)�MACOS)�NETBSD)�NIC_DUPLEX_FULL)�NIC_DUPLEX_HALF)�NIC_DUPLEX_UNKNOWN)�OPENBSD)�OSX)�POSIX)�POWER_TIME_UNKNOWN)�POWER_TIME_UNLIMITED)� STATUS_DEAD)�STATUS_DISK_SLEEP)� STATUS_IDLE)�
STATUS_LOCKED)�
STATUS_PARKED)�STATUS_RUNNING)�STATUS_SLEEPING)�STATUS_STOPPED)�STATUS_TRACING_STOP)�STATUS_WAITING)�
STATUS_WAKING)�
STATUS_ZOMBIE)�SUNOS)�WINDOWS)� AccessDenied)�Error)�
NoSuchProcess)�TimeoutExpired)�
ZombieProcess)�debug)�memoize_when_activated)� wrap_numbers)�PY3)�PermissionError)�ProcessLookupError)�SubprocessTimeoutExpired)�longz/proc)�_pslinux)�IOPRIO_CLASS_BE)�IOPRIO_CLASS_IDLE)�IOPRIO_CLASS_NONE)�IOPRIO_CLASS_RT)�
_pswindows)�ABOVE_NORMAL_PRIORITY_CLASS)�BELOW_NORMAL_PRIORITY_CLASS)�HIGH_PRIORITY_CLASS)�IDLE_PRIORITY_CLASS)�NORMAL_PRIORITY_CLASS)�REALTIME_PRIORITY_CLASS)�CONN_DELETE_TCB)� IOPRIO_HIGH)�
IOPRIO_LOW)�
IOPRIO_NORMAL)�IOPRIO_VERYLOW)�_psosx)�_psbsd)�_pssunos)�
CONN_BOUND)� CONN_IDLE)�_psaixz platform %s is not supported)Gr. r/ r1 r- r0 � version_info� __version__r$ r! r% r r& r' r* r r) r" r( r" r# r
r r r r r r r r
r r r �AF_LINKr r r r r r r r r r r r r r+ r, r �Process�Popen�
pid_exists�pids� process_iter�
wait_procs�virtual_memory� swap_memory� cpu_times� cpu_percent�cpu_times_percent� cpu_count� cpu_stats�net_io_counters�net_connections� net_if_addrs� net_if_stats�disk_io_counters�disk_partitions�
disk_usage�users� boot_time�rlimit)�
_psutil_posixZRLIMzGiampaolo Rodola'z6.1.0c C s g | ] }t |��qS � )�int)�.0�numrl rl �;/usr/local/lib64/python3.9/site-packages/psutil/__init__.py�
<listcomp>� � rq �.� monotonic� �versionz!version conflict: %r C extension z.module was built for another version of psutilz (%s instead of %s)c C s g | ]}|�qS rl rl �rn �xrl rl rp rq � rr z (different than %s)z;; you may try to 'pip uninstall psutil', manually remove %s�__file__z%the existing psutil install directoryz1 or clean the virtual env somehow, then reinstall�ppid_mapc
C sB i } t � D ]2}zt�|��� | |< W q
ttfy: Y q
0 q
| S )z{Return a {pid: ppid, ...} dict for all running processes in
one shot. Used to speed up Process.children().
)rW � _psplatformrT �ppidr/ r1 )�ret�pidrl rl rp � _ppid_map s
r c C s6 t � � }t|| �}|dk r dnd}tj�| ��|�S )z(Format seconds in a human readable form.i�Q z%H:%M:%Sz%Y-%m-%d %H:%M:%S)�timerm �datetime�
fromtimestamp�strftime)Zsecs�nowZsecs_ago�fmtrl rl rp � _pprint_secs s r� c @ s� e Zd ZdZd�dd�Zd�dd�Zdd � Zd
d � ZeZd d
� Z dd� Z
dd� Z dd� Z e
dd� �Zejdd� �Zd�dd�Zdd� Zd d � Zd d � Zed d!� �Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Z d,d-� Z d.d/� Z d�d0d1�Z e �red2d3� �Z!d4d5� Z"d6d7� Z#d8d9� Z$e%e&j'd:��r d;d<� Z(e%e&j'd=��r6d�d>d?�Z)e%e&j'd@��rNd�dAdB�Z*e%e&j'dC��rfd�dDdE�Z+e%e&j'dF��r|dGdH� Z,e%e&j'dI��r�dJdK� Z-e.�r�dLdM� Z/dNdO� Z0dPdQ� Z1e%e&j'dR��r�dSdT� Z2d�dUdV�Z3d�dWdX�Z4edYdZ� �Z5ed[d\� �Z6e7j8d]d^�d_d`� �Z9dadb� Z:d�ddde�Z;e%e&j'df��r0d�dhdi�Z<djdk� Z=d�dmdn�Z>e7j8dod^�d�dpdq��Z?e �rfdrds� Z@dtdu� ZAdvdw� ZBdxdy� ZCdzd{� ZDd|d}� ZEd�d~d�ZFdS )�rT a Represents an OS process with the given PID.
If PID is omitted current process PID (os.getpid()) is used.
Raise NoSuchProcess if PID does not exist.
Note that most of the methods of this class do not make sure that
the PID of the process being queried has been reused. That means
that you may end up retrieving information for another process.
The only exceptions for which process identity is pre-emptively
checked and guaranteed are:
- parent()
- children()
- nice() (set)
- ionice() (set)
- rlimit() (set)
- cpu_affinity (set)
- suspend()
- resume()
- send_signal()
- terminate()
- kill()
To prevent this problem for all other methods you can use
is_running() before querying the process.
Nc C s | � |� d S �N)�_init)�selfr~ rl rl rp �__init__> s zProcess.__init__Fc C sR |d u rt �� }nrts4t|ttf�s4d| }t|��|dk rLd| }t|��ztj �
|� W n& t y� d| }t ||d��Y n0 || _
d | _d | _d | _d| _d| _d | _t�� | _d | _t�|�| _d | _d | _t | _ | j d f| _ z| � � | _ W nV t!�y
Y nD t"�y Y n2 t �yL |�sBd}t ||d��nd| _Y n0 d S ) Nz pid must be an integer (got %r)r z'pid must be a positive integer (got %s)z!process PID out of range (got %s)��msgFzprocess PID not foundT)#�os�getpid�_PY3�
isinstancerm r9 � TypeError�
ValueErrorr{ �cextZcheck_pid_range�
OverflowErrorr/ �_pid�_name�_exe� _create_time�_gone� _pid_reused�_hash� threading�RLock�_lock�_ppidrT �_proc�_last_sys_cpu_times�_last_proc_cpu_times� _SENTINEL� _exitcoder~ �_ident�
_get_identr- r1 )r� r~ � _ignore_nspr� rl rl rp r� A sL
z
Process._initc C s2 t r | jjdd�| _| j| jfS | j| �� fS dS )a Return a (pid, uid) tuple which is supposed to identify a
Process instance univocally over time. The PID alone is not
enough, as it can be assigned to a new process after this one
terminates, so we add process creation time to the mix. We need
this in order to prevent killing the wrong process later on.
This is also known as PID reuse or PID recycling problem.
The reliability of this strategy mostly depends on
create_time() precision, which is 0.01 secs on Linux. The
assumption is that, after a process terminates, the kernel
won't reuse the same PID after such a short period of time
(0.01 secs). Technically this is inherently racy, but
practically it should be good enough.
T)Z fast_onlyN)r, r� � create_timer� r~ �r� rl rl rp r� t s zProcess._get_identc C s t �� }| j|d< | jr"| j|d< | �� �� | jr<d|d< n`z | �� |d< | �� |d< W nB tyr d|d< Y n* t y� d|d< Y n t
y� Y n0 | j t d fvr�| j |d< | j
d ur�t| j
�|d< d | jj| jjd
�d d � |�� D ��f W d � S 1 �s 0 Y d S )
Nr~ �namezterminated + PID reused�statusZzombieZ
terminated�exitcode�startedz %s.%s(%s)�, c S s g | ]\}}d ||f �qS )z%s=%rrl )rn �k�vrl rl rp rq � rr z#Process.__str__.<locals>.<listcomp>)� collections� OrderedDictr~ r� �oneshotr� r� r� r1 r/ r- r� r� r� r� � __class__�
__module__�__name__�join�items)r� �inforl rl rp �__str__� s2
�zProcess.__str__c C sh t |t�stS tstr\| j\}}|j\}}||kr\|r\|s\z| �� tkW S tyZ Y n0 | j|jkS r� ) r� rT �NotImplementedr r r� r� r* r. )r� �otherZpid1Zident1Zpid2Zident2rl rl rp �__eq__� s
zProcess.__eq__c C s
| |k S r� rl )r� r� rl rl rp �__ne__� s zProcess.__ne__c C s | j d u rt| j�| _ | j S r� )r� �hashr� r� rl rl rp �__hash__� s
zProcess.__hash__c C s. | j s| �� s*| j r*d}t| j| j|d��dS )z9Raises NoSuchProcess in case process PID has been reused.z4process no longer exists and its PID has been reusedr� N)r� �
is_runningr/ r~ r� )r� r� rl rl rp �_raise_if_pid_reused� s z Process._raise_if_pid_reusedc C s | j S )zThe process PID.)r� r� rl rl rp r~ � s z Process.pidc
c s | j �� t| d�rdV n�z�| j�| � | j�| � | j�| � trP| j�| � | j� � dV W | j�
| � | j�
| � | j�
| � tr�| j�
| � | j� � n@| j�
| � | j�
| � | j�
| � tr�| j�
| � | j� � 0 W d � n1 s�0 Y dS )a# Utility context manager which considerably speeds up the
retrieval of multiple process information at the same time.
Internally different process info (e.g. name, ppid, uids,
gids, ...) may be fetched by using the same routine, but
only one information is returned and the others are discarded.
When using this context manager the internal routine is
executed once (in the example below on name()) and the
other info are cached.
The cache is cleared when exiting the context manager block.
The advice is to use this every time you retrieve more than
one information about the process. If you're lucky, you'll
get a hell of a speedup.
>>> import psutil
>>> p = psutil.Process()
>>> with p.oneshot():
... p.name() # collect multiple info
... p.cpu_times() # return cached value
... p.cpu_percent() # return cached value
... p.create_time() # return cached value
...
>>>
�_cacheN) r� �hasattrr\ Zcache_activate� memory_infor| r �uidsr� Z
oneshot_enterZcache_deactivateZ oneshot_exitr� rl rl rp r� � s.
� zProcess.oneshotc C s t }|durvt|ttttf�s2dt|� }t|��t|�}|| }|rvdt|�dkrXdndd� t
t |��f }t |��i }|p�|}| �
� �| |D ]f}z$|dkr�| j} nt| |�}
|
� } W n4 ttfy� |} Y n ty� |r� Y q�Y n0 | ||< q�W d � n1 �s0 Y |S ) a� Utility method returning process information as a
hashable dictionary.
If *attrs* is specified it must be a list of strings
reflecting available Process class' attribute names
(e.g. ['cpu_times', 'name']) else all public (read
only) attributes are assumed.
*ad_value* is the value which gets assigned in case
AccessDenied or ZombieProcess exception is raised when
retrieving that particular process information.
Nzinvalid attrs type %szinvalid attr name%s %sr �sru r� r~ )�_as_dict_attrnamesr� �list�tuple�set� frozenset�typer� �lenr� �map�reprr� r� r~ �getattrr- r1 �NotImplementedError) r� �attrs�ad_valueZ valid_namesr� �
invalid_namesZretdict�lsr� r} �methrl rl rp �as_dict! s< �
*zProcess.as_dictc C sr t dur t nt� d }| j|kr$dS | �� }|durn| �� }z t|�}|�� |krX|W S W n tyl Y n0 dS )z�Return the parent process as a Process object pre-emptively
checking whether PID has been reused.
If no parent is known return None.
Nr )� _LOWEST_PIDrW r~ r| r� rT r/ )r� Z
lowest_pidr| �ctime�parentrl rl rp r� P s
zProcess.parentc C s, g }| � � }|dur(|�|� |� � }q |S )z�Return the parents of this process as a list of Process
instances. If no parents are known return an empty list.
N)r� �append)r� �parents�procrl rl rp r� c s
zProcess.parentsc C st | j s | jrdS z2| t| j�k| _| jr>t�| j� t| j��W dS tyV Y dS tyn d| _ Y dS 0 dS )z�Return whether this process is running.
It also checks if PID has been reused by another process, in
which case it will remove the process from `process_iter()`
internal cache and return False.
FTN)r� r� rT r~ � _pids_reused�addr/ r1 r� rl rl rp r� n s
zProcess.is_runningc C s2 | � � tr| j�� S | jp$| j�� | _| jS dS )z`The process parent PID.
On Windows the return value is cached after first call.
N)r� r r� r| r� r� rl rl rp r| � s
z Process.ppidc C s� t r| jdur| jS | j�� }trtt|�dkrtz | �� }W n ttfyP Y n$0 |rtt j
� |d �}|� |�rt|}|| _|| j_|S )z>The process name. The return value is cached after first call.N� r )
r, r� r� r� r r� �cmdliner- r1 r� �path�basename�
startswith)r� r� r� Z
extended_namerl rl rp r� � s
z Process.namec
s� � fdd�}� j du r�z� j�� }W n. tyR } z||d�W Y d}~S d}~0 0 |szz||d�}W n tyx Y n0 |� _ � j S )z�The process executable as an absolute path.
May also be an empty string.
The return value is cached after first call.
c sd � � � }|rRttd�rRttd�rR|d }tj�|�rRtj�|�rRt�|tj�rR|S t| t �r`| �| S )N�access�X_OKr )
r� r� r� r� �isabs�isfiler� r� r� r- )�fallbackr� �exer� rl rp �guess_it� s
�
� �
z Process.exe.<locals>.guess_itN)r� )r� r� r� r- )r� r� r� �errrl r� rp r� � s
z Process.exec C s
| j �� S )z3The command line this process has been called with.)r� r� r� rl rl rp r� � s zProcess.cmdlinec C s( z | j �� W S ty" t Y S 0 dS )z2The process current status as a STATUS_* constant.N)r� r� r1 r* r� rl rl rp r� � s zProcess.statusc C s\ t rNtdu rd}t|��| �� j}zt�|�jW S tyJ t|� Y S 0 n
| j �
� S dS )ztThe name of the user that owns the process.
On UNIX this is calculated by using *real* process uid.
Nz0requires pwd module shipped with standard python) r �pwd� ImportErrorr� �real�getpwuid�pw_name�KeyError�strr� �username)r� r� Zreal_uidrl rl rp r� � s
zProcess.usernamec C s | j du r| j�� | _ | j S )z�The process creation time as a floating point number
expressed in seconds since the epoch.
The return value is cached after first call.
N)r� r� r� r� rl rl rp r� s
zProcess.create_timec C s
| j �� S )z6Process current working directory as an absolute path.)r� �cwdr� rl rl rp r�
s z Process.cwdc C s* |du r| j �� S | �� | j �|� dS )z'Get or set process niceness (priority).N)r� Znice_getr� Znice_set)r� �valuerl rl rp �nice s
z Process.nicec C s
| j �� S )zVReturn process UIDs as a (real, effective, saved)
namedtuple.
)r� r� r� rl rl rp r� s z Process.uidsc C s
| j �� S )zVReturn process GIDs as a (real, effective, saved)
namedtuple.
)r� �gidsr� rl rl rp r� " s z Process.gidsc C s
| j �� S )zVThe terminal associated with this process, if any,
else None.
)r� �terminalr� rl rl rp r� ( s zProcess.terminalc C s
| j �� S )zcReturn the number of file descriptors opened by this
process (POSIX only).
)r� �num_fdsr� rl rl rp r� . s zProcess.num_fds� io_countersc C s
| j �� S )a
Return process I/O statistics as a
(read_count, write_count, read_bytes, write_bytes)
namedtuple.
Those are the number of read/write calls performed and the
amount of bytes read and written by the process.
)r� r� r� rl rl rp r� 7 s zProcess.io_counters�
ionice_getc C s@ |du r&|dur d}t |��| j�� S | �� | j�||�S dS )a� Get or set process I/O niceness (priority).
On Linux *ioclass* is one of the IOPRIO_CLASS_* constants.
*value* is a number which goes from 0 to 7. The higher the
value, the lower the I/O priority of the process.
On Windows only *ioclass* is used and it can be set to 2
(normal), 1 (low) or 0 (very low).
Available on Linux and Windows > Vista only.
Nz$'ioclass' argument must be specified)r� r� r� r� Z
ionice_set)r� Zioclassr� r� rl rl rp �ioniceC s
zProcess.ionicerj c C s |dur| � � | j�||�S )a- Get or set process resource limits as a (soft, hard)
tuple.
*resource* is one of the RLIMIT_* constants.
*limits* is supposed to be a (soft, hard) tuple.
See "man prlimit" for further info.
Available on Linux and FreeBSD only.
N)r� r� rj )r� �resourceZlimitsrl rl rp rj [ s
zProcess.rlimit�cpu_affinity_getc C sl |du rt t| j�� ��S | �� |sTt| jd�r>| j�� }nttt t
dd����}| j� t t|��� dS )a- Get or set process CPU affinity.
If specified, *cpus* must be a list of CPUs for which you
want to set the affinity (e.g. [0, 1]).
If an empty list is passed, all egible CPUs are assumed
(and set).
(Windows, Linux and BSD only).
N�_get_eligible_cpusT��percpu)
�sortedr� r� r r� r� r r� �ranger� r\ Zcpu_affinity_setr� )r� Zcpusrl rl rp � cpu_affinityl s zProcess.cpu_affinity�cpu_numc C s
| j �� S )aZ Return what CPU this process is currently running on.
The returned number should be <= psutil.cpu_count()
and <= len(psutil.cpu_percent(percpu=True)).
It may be used in conjunction with
psutil.cpu_percent(percpu=True) to observe the system
workload distributed across CPUs.
)r� r r� rl rl rp r � s zProcess.cpu_num�environc C s
| j �� S )z�The environment variables of the process as a dict. Note: this
might not reflect changes made after the process started.
)r� r r� rl rl rp r � s zProcess.environc C s
| j �� S )z\Return the number of handles opened by this process
(Windows only).
)r� � num_handlesr� rl rl rp r � s zProcess.num_handlesc C s
| j �� S )zkReturn the number of voluntary and involuntary context
switches performed by this process.
)r� �num_ctx_switchesr� rl rl rp r
� s zProcess.num_ctx_switchesc C s
| j �� S )z2Return the number of threads used by this process.)r� � num_threadsr� rl rl rp r � s zProcess.num_threads�threadsc C s
| j �� S )z�Return threads opened by process as a list of
(id, user_time, system_time) namedtuples representing
thread id and thread CPU times (user/system).
On OpenBSD this method requires root access.
)r� r r� rl rl rp r � s zProcess.threadsc
C s0 | � � t� }g }|sr|�� D ]P\}}|| jkr z&t|�}| �� |�� krT|�|� W q ttfyl Y q 0 q n�t �
t �}|�� D ]\}}|| �|� q�t � }| jg} | �r,| �
� }||v r�q�|�|� || D ]T}
z6t|
�}| �� |�� k} | �r |�|� | �|
� W q� ttf�y& Y q�0 q�q�|S )u( Return the children of this process as a list of Process
instances, pre-emptively checking whether PID has been reused.
If *recursive* is True return all the parent descendants.
Example (A == this process):
A ─┐
│
├─ B (child) ─┐
│ └─ X (grandchild) ─┐
│ └─ Y (great grandchild)
├─ C (child)
└─ D (child)
>>> import psutil
>>> p = psutil.Process()
>>> p.children()
B, C, D
>>> p.children(recursive=True)
B, X, Y, C, D
Note that in the example above if process X disappears
process Y won't be listed as the reference to process A
is lost.
)r� r r� r~ rT r� r� r/ r1 r� � defaultdictr� r� �popr� ) r� � recursiverz r} r~ r| �childZreverse_ppid_map�seen�stackZ child_pidZintimerl rl rp �children� s@
zProcess.childrenc
s |duo|dk}|dur0|dk r0d| }t |��t� p8d� � fdd�}|rv|� }| j�� }t�|� |� }| j�� }n<| j}| j}|� }| j�� }|du s�|du r�|| _|| _dS |j|j |j |j } || }
|| _|| _z| |
d } W n t
�y Y dS 0 | � } t | d�S dS ) a Return a float representing the current process CPU
utilization as a percentage.
When *interval* is 0.0 or None (default) compares process times
to system CPU times elapsed since last call, returning
immediately (non-blocking). That means that the first time
this is called it will return a meaningful 0.0 value.
When *interval* is > 0.0 compares process times to system CPU
times elapsed before and after the interval (blocking).
In this case is recommended for accuracy that this function
be called with at least 0.1 seconds between calls.
A value > 100.0 can be returned in case of processes running
multiple threads on different CPU cores.
The returned value is explicitly NOT split evenly between
all available logical CPUs. This means that a busy loop process
running on a system with 2 logical CPUs will be reported as
having 100% CPU utilization instead of 50%.
Examples:
>>> import psutil
>>> p = psutil.Process(os.getpid())
>>> # blocking
>>> p.cpu_percent(interval=1)
2.0
>>> # non-blocking (percentage since last call)
>>> p.cpu_percent(interval=None)
2.9
>>>
N� r �!interval is not positive (got %r)r c s
t � � S r� )�_timerrl ��num_cpusrl rp �timer s z"Process.cpu_percent.<locals>.timer�d ) r� r_ r� r\ r� �sleepr� r� �user�system�ZeroDivisionError�round)
r� �interval�blockingr� r Zst1Zpt1Zst2Zpt2Z
delta_procZ
delta_timeZoverall_cpus_percentZsingle_cpu_percentrl r rp r] � s< #
zProcess.cpu_percentc C s
| j �� S )a% Return a (user, system, children_user, children_system)
namedtuple representing the accumulated process time, in
seconds.
This is similar to os.times() but per-process.
On macOS and Windows children_user and children_system are
always set to 0.
)r� r\ r� rl rl rp r\ T s zProcess.cpu_timesc C s
| j �� S )a Return a namedtuple with variable fields depending on the
platform, representing memory information about the process.
The "portable" fields available on all platforms are `rss` and `vms`.
All numbers are expressed in bytes.
)r� r� r� rl rl rp r� _ s zProcess.memory_infor� )� replacementc C s | � � S r� )r� r� rl rl rp �memory_info_exj s zProcess.memory_info_exc C s
| j �� S )a] This method returns the same information as memory_info(),
plus, on some platform (Linux, macOS, Windows), also provides
additional metrics (USS, PSS and swap).
The additional metrics provide a better representation of actual
process memory usage.
Namely USS is the memory which is unique to a process and which
would be freed if the process was terminated right now.
It does so by passing through the whole process address.
As such it usually requires higher user privileges than
memory_info() and is considerably slower.
)r� �memory_full_infor� rl rl rp r$ n s zProcess.memory_full_info�rssc C s� t tjj�}||vr,d|t|�f }t|��|tjjv r>| jn| j}|� }t ||�}t
p^t � j }|dksxd| }t|��|t
|� d S )a� Compare process memory to total physical system memory and
calculate process memory utilization as a percentage.
*memtype* argument is a string that dictates what type of
process memory you want to compare against (defaults to "rss").
The list of available strings can be obtained like this:
>>> psutil.Process().memory_info()._fields
('rss', 'vms', 'shared', 'text', 'lib', 'data', 'dirty', 'uss', 'pss')
z&invalid memtype %r; valid types are %rr z`can't calculate process memory percent because total physical system memory is not positive (%r)r )r� r{ Zpfullmem�_fieldsr� r� Zpmemr� r$ r� �
_TOTAL_PHYMEMrZ �total�float)r� ZmemtypeZ valid_typesr� ZfunZmetricsr� Z total_phymemrl rl rp �memory_percent~ s*
�
��
��zProcess.memory_percent� memory_mapsTc s� | j �� }|r�i � |D ]P}|d }|dd� }z tdd� � | |�� |< W q tyd |� |< Y q0 qtj�� �fdd�� D �S tj��fdd�|D �S dS ) a� Return process' mapped memory regions as a list of namedtuples
whose fields are variable depending on the platform.
If *grouped* is True the mapped regions with the same 'path'
are grouped together and the different memory fields are summed.
If *grouped* is False every mapped region is shown as a single
entity and the namedtuple will also include the mapped region's
address space ('addr') and permission set ('perms').
� � Nc S s | | S r� rl )rx �yrl rl rp �<lambda>� rr z%Process.memory_maps.<locals>.<lambda>c s g | ]}�|g� | �R � �qS rl rl )rn r� ��d�ntrl rp rq � rr z'Process.memory_maps.<locals>.<listcomp>c s g | ] }� |� �qS rl rl rw )r2 rl rp rq � rr )r� r+ r� r� r{ Z
pmmap_groupedZ pmmap_ext)r� Zgrouped�itZtuplr� �numsrl r0 rp r+ � s
zProcess.memory_mapsc C s
| j �� S )z�Return files opened by process as a list of
(path, fd) namedtuples including the absolute file name
and file descriptor number.
)r� �
open_filesr� rl rl rp r5 � s zProcess.open_files�inetc C s | j �|�S )aT Return socket connections opened by process as a list of
(fd, family, type, laddr, raddr, status) namedtuples.
The *kind* parameter filters for connections that match the
following criteria:
+------------+----------------------------------------------------+
| Kind Value | Connections using |
+------------+----------------------------------------------------+
| inet | IPv4 and IPv6 |
| inet4 | IPv4 |
| inet6 | IPv6 |
| tcp | TCP |
| tcp4 | TCP over IPv4 |
| tcp6 | TCP over IPv6 |
| udp | UDP |
| udp4 | UDP over IPv4 |
| udp6 | UDP over IPv6 |
| unix | UNIX socket (both UDP and TCP protocols) |
| all | the sum of all the possible families and protocols |
+------------+----------------------------------------------------+
)r� rb �r� �kindrl rl rp rb � s zProcess.net_connectionsrb c C s | j |d�S )N�r8 )rb r7 rl rl rp � connections� s zProcess.connectionsc C s� | j dk rJ | j ��| �� | j dkr2d}t|��zt�| j |� W nf ty� trtt| j �rtt| j | j | j
��nd| _ t | j | j ��Y n t
y� t| j | j ��Y n0 d S )Nr z�preventing sending signal to process with PID 0 as it would affect every process in the process group of the calling process (os.getpid()) instead of PID 0T)r~ r� r� r� �killr7 r rV r1 r� r� r� r/ r6 r- �r� �sigr� rl rl rp � _send_signal� s
� zProcess._send_signalc C sP t r| �|� n<| �� |tjkr@| �� s@d}t| j| j|d��| j �
|� dS )z�Send a signal *sig* to process pre-emptively checking
whether PID has been reused (see signal module constants) .
On Windows only SIGTERM is valid and is treated as an alias
for kill().
zprocess no longer existsr� N) r r> r� �signal�SIGTERMr� r/ r~ r� r� � send_signalr< rl rl rp rA � s zProcess.send_signalc C s( t r| �tj� n| �� | j�� dS )z�Suspend process execution with SIGSTOP pre-emptively checking
whether PID has been reused.
On Windows this has the effect of suspending all process threads.
N)r r> r? �SIGSTOPr� r� �suspendr� rl rl rp rC
s zProcess.suspendc C s( t r| �tj� n| �� | j�� dS )z�Resume process execution with SIGCONT pre-emptively checking
whether PID has been reused.
On Windows this has the effect of resuming all process threads.
N)r r> r? �SIGCONTr� r� �resumer� rl rl rp rE s zProcess.resumec C s( t r| �tj� n| �� | j�� dS )z�Terminate the process with SIGTERM pre-emptively checking
whether PID has been reused.
On Windows this is an alias for kill().
N)r r> r? r@ r� r� r; r� rl rl rp � terminate# s zProcess.terminatec C s( t r| �tj� n| �� | j�� dS )zjKill the current process with SIGKILL pre-emptively checking
whether PID has been reused.
N)r r> r? �SIGKILLr� r� r; r� rl rl rp r; . s z Process.killc C s@ |dur |dks d}t |��| jtur,| jS | j�|�| _| jS )a� Wait for process to terminate and, if process is a children
of os.getpid(), also return its exit code, else None.
On Windows there's no such limitation (exit code is always
returned).
If the process is already terminated immediately return None
instead of raising NoSuchProcess.
If *timeout* (in seconds) is specified and process is still
alive raise TimeoutExpired.
To wait for multiple Process(es) use psutil.wait_procs().
Nr z"timeout must be a positive integer)r� r� r� r� �wait)r� �timeoutr� rl rl rp rH 8 s
z Process.wait)N)F)NN)N)NN)N)N)F)N)r% )T)r6 )r6 )N)Gr� r� � __qualname__�__doc__r� r� r� r� �__repr__r� r� r� r� �propertyr~ �
contextlib�contextmanagerr� r� r� r� r� r3 r| r� r� r� r� r� r� r� r� r r� r� r� r� r� r{ rT r� r� rj r r r r, r r
r r r r] r\ r� r Zdeprecated_methodr# r$ r* r+ r5 rb r: r> rA rC rE rF r; rH rl rl rl rp rT " s�
3
B
/
*
F
]
$
rT c C s" g | ]}|� d �s|dvr|�qS )�_> r� r� r: rj rE r# r� r� rA rH r r� rC r; rF )r� rw rl rl rp rq R s �c sJ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd� fd
d� Z � Z
S )rU a Same as subprocess.Popen, but in addition it provides all
psutil.Process methods in a single class.
For the following methods which are common to both classes, psutil
implementation takes precedence:
* send_signal()
* terminate()
* kill()
This is done in order to avoid killing another process in case its
PID has been reused, fixing BPO-6973.
>>> import psutil
>>> from subprocess import PIPE
>>> p = psutil.Popen(["python", "-c", "print 'hi'"], stdout=PIPE)
>>> p.name()
'python'
>>> p.uids()
user(real=1000, effective=1000, saved=1000)
>>> p.username()
'giampaolo'
>>> p.communicate()
('hi', None)
>>> p.terminate()
>>> p.wait(timeout=2)
0
>>>
c O s( t j|i |��| _| j| jjdd� d S )NT)r� )�
subprocessrU �_Popen__subprocr� r~ �r� �args�kwargsrl rl rp r� | s zPopen.__init__c C s t ttt�ttj� ��S r� )r r� �dirrU rQ r� rl rl rp �__dir__� s z
Popen.__dir__c C s t | jd�r| j�� | S )N� __enter__)r� rR rX r� rl rl rp rX � s
zPopen.__enter__c O sj t | jd�r | jj|i |��S | jr.| j�� | jr>| j�� z | jrP| j�� W | �� n
| �� 0 d S )N�__exit__)r� rR rY �stdout�close�stderr�stdinrH rS rl rl rp rY � s
zPopen.__exit__c C sf zt �| |�W S ty` zt �| j|�W Y S tyZ d| jj|f }t|��Y n0 Y n0 d S )Nz!%s instance has no attribute '%s')�object�__getattribute__�AttributeErrorrR r� r� )r� r� r� rl rl rp r_ � s �zPopen.__getattribute__Nc s0 | j jd ur| j jS tt| ��|�}|| j _|S r� )rR �
returncode�superrU rH )r� rI r} �r� rl rp rH � s
z
Popen.wait)N) r� r� rJ rK r� rW rX rY r_ rH �
__classcell__rl rl rc rp rU ^ s
rU c C s t t�� �} | d a| S )z&Return a list of current running PIDs.r )r r{ rW r� �r} rl rl rp rW � s rW c C s0 | dk r dS | dkr"t r"| t� v S t�| �S dS )z�Return True if given PID exists in the current process list.
This is faster than doing "pid in psutil.pids()" and
should be preferred.
r FN)r rW r{ rV �r~ rl rl rp rV � s
rV c # s � fdd�}� fdd�}t �� � tt� �}t� �� �}|| }|| }|D ] }||� qJtrzt�� }td| � ||� qXz�tt � �
� �t t � |��
� � �} | D ]V\}}
z2|
du r�||�}
| dur�|
j
| |d�|
_|
V W q� ty� ||� Y q�0 q�W � a n� a 0 dS )a� Return a generator yielding a Process instance for all
running processes.
Every new Process instance is only created once and then cached
into an internal table which is updated every time this is used.
Cache can optionally be cleared via `process_iter.clear_cache()`.
The sorting order in which processes are yielded is based on
their PIDs.
*attrs* and *ad_value* have the same meaning as in
Process.as_dict(). If *attrs* is specified as_dict() is called
and the resulting dict is stored as a 'info' attribute attached
to returned Process instance.
If *attrs* is an empty list it will retrieve all process info
(slow).
c s t | �}|� |j< |S r� )rT r~ )r~ r� �Zpmaprl rp r� � s
zprocess_iter.<locals>.addc s � � | d � d S r� )r rf rg rl rp �remove� s z process_iter.<locals>.removez-refreshing Process instance for reused PID %sN)r� r� )�_pmap�copyr� rW �keysr� r r2 r r� r� �dict�fromkeysr� r� r/ ) r� r� r� rh �a�bZnew_pidsZ gone_pidsr~ r� r� rl rg rp rX � s2
"
rX c C s t �� S r� )ri �clearrl rl rl rp r/ rr r/ z$Clear process_iter() internal cache.c s � �fdd�}|dur.|dks.d| }t |��t� �t| �}� dur\t� �s\d� }t|��|durnt� | }|r�|dur�|dkr�q�|D ]J}dt|� }|dur�t|t� |�}|dkr� q�|||� q�|||� q�|� }qn|r�|D ]}||d� q�|� }t��t|�fS )a, Convenience function which waits for a list of processes to
terminate.
Return a (gone, alive) tuple indicating which processes
are gone and which ones are still alive.
The gone ones will have a new *returncode* attribute indicating
process exit status (may be None).
*callback* is a function which gets called every time a process
terminates (a Process instance is passed as callback argument).
Function will return as soon as all processes terminate or when
*timeout* occurs.
Differently from Process.wait() it will not raise TimeoutExpired if
*timeout* occurs.
Typical use case is:
- send SIGTERM to a list of processes
- give them some time to terminate
- send SIGKILL to those ones which are still alive
Example:
>>> def on_terminate(proc):
... print("process {} terminated".format(proc))
...
>>> for p in procs:
... p.terminate()
...
>>> gone, alive = wait_procs(procs, timeout=3, callback=on_terminate)
>>> for p in alive:
... p.kill()
c sh z| j |d�}W n" ty" Y nB ty2 Y n20 |d usD| �� sd|| _��| � � d urd� | � d S )N)rI )rH r0 �_SubprocessTimeoutExpiredr� ra r� )r� rI ra ��callback�gonerl rp �
check_gone2 s
z wait_procs.<locals>.check_goneNr z*timeout must be a positive integer, got %sz callback %r is not a callableg �?)r� r� �callabler� r r� �minr� ) ZprocsrI rs ru r� �alive�deadliner� Z max_timeoutrl rr rp rY
s8 %
rY Tc C s. | rt �� }nt �� }|dur*|dk r*d}|S )az Return the number of logical CPUs in the system (same as
os.cpu_count() in Python 3.4).
If *logical* is False return the number of physical cores only
(e.g. hyper thread CPUs are excluded).
Return None if undetermined.
The return value is cached after first call.
If desired cache can be cleared like this:
>>> psutil.cpu_count.cache_clear()
Nr )r{ Zcpu_count_logicalZcpu_count_cores)�logicalr} rl rl rp r_ o s
r_ Fc C s | s t �� S t �� S dS )a� Return system-wide CPU times as a namedtuple.
Every CPU time represents the seconds the CPU has spent in the
given mode. The namedtuple's fields availability varies depending on the
platform:
- user
- system
- idle
- nice (UNIX)
- iowait (Linux)
- irq (Linux, FreeBSD)
- softirq (Linux)
- steal (Linux >= 2.6.11)
- guest (Linux >= 2.6.24)
- guest_nice (Linux >= 3.2.0)
When *percpu* is True return a list of namedtuples for each CPU.
First element of the list refers to first CPU, second element
to second CPU and so on.
The order of the list is consistent across calls.
N)r{ r\ Z
per_cpu_timesr rl rl rp r\ � s r\ r c C s0 t | �}tr,|t| dd�8 }|t| dd�8 }|S )zWGiven a cpu_time() ntuple calculates the total CPU time
(including idle time).
Zguestr Z
guest_nice)�sumr r� )�timesZtotrl rl rp �
_cpu_tot_time� s
r} c C s& t | �}|| j8 }|t| dd�8 }|S )zlGiven a cpu_time() ntuple calculates the busy CPU time.
We do so by subtracting all idle CPU times.
Ziowaitr )r} �idler� )r| �busyrl rl rp �_cpu_busy_time� s
r� c C s\ | j |j ksJ | |f��g }tjj D ],}t||�t| |� }td|�}|�|� q$tj|� S )Nr )r& r{ � scputimesr� �maxr� )�t1�t2Z field_deltas�field� field_deltarl rl rp �_cpu_times_deltas� s
r� c
C s� t �� j}| duo| dk}| dur:| dk r:d| }t|��dd� }|s�|r\t� }t�| � nt�|�pjt� }t� t|< ||t| �S g }|r�tdd�}t�| � nt �|�p�tdd�}tdd�t |< t
|t | �D ]\}} |� ||| �� q�|S dS ) a� Return a float representing the current system-wide CPU
utilization as a percentage.
When *interval* is > 0.0 compares system CPU times elapsed before
and after the interval (blocking).
When *interval* is 0.0 or None compares system CPU times elapsed
since last call or module import, returning immediately (non
blocking). That means the first time this is called it will
return a meaningless 0.0 value which you should ignore.
In this case is recommended for accuracy that this function be
called with at least 0.1 seconds between calls.
When *percpu* is True returns a list of floats representing the
utilization as a percentage for each CPU.
First element of the list refers to first CPU, second element
to second CPU and so on.
The order of the list is consistent across calls.
Examples:
>>> # blocking, system-wide
>>> psutil.cpu_percent(interval=1)
2.0
>>>
>>> # blocking, per-cpu
>>> psutil.cpu_percent(interval=1, percpu=True)
[2.0, 1.0]
>>>
>>> # non-blocking (percentage since last call)
>>> psutil.cpu_percent(interval=None)
2.9
>>>
Nr r r c S sN t | |�}t|�}t|�}z|| d }W n ty> Y dS 0 t|d�S d S )Nr r r )r� r} r� r r )r� r� � times_delta� all_deltaZ
busy_deltaZ busy_percrl rl rp � calculate s
z cpu_percent.<locals>.calculateTr ) r� �current_thread�identr� r\ r� r �_last_cpu_times�get�_last_per_cpu_times�zipr� �
r r �tidr! r� r� r� r} Ztot1r� rl rl rp r] � s, #
r] c
C s� t �� j}| duo| dk}| dur:| dk r:d| }t|��dd� }|s�|r\t� }t�| � nt�|�pjt� }t� t|< ||t| �S g }|r�tdd�}t�| � nt �|�p�tdd�}tdd�t |< t
|t | �D ]\}} |� ||| �� q�|S dS ) a� Same as cpu_percent() but provides utilization percentages
for each specific CPU time as is returned by cpu_times().
For instance, on Linux we'll get:
>>> cpu_times_percent()
cpupercent(user=4.8, nice=0.0, system=4.8, idle=90.5, iowait=0.0,
irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
>>>
*interval* and *percpu* arguments have the same meaning as in
cpu_percent().
Nr r r c S sd g }t | |�}t|�}dtd|� }|D ]0}|| }t|d�}ttd|�d�}|�|� q(tj|� S )Ng Y@r r )r� r} r� r rw r� r{ r� )r� r� r4 r� r� Zscaler� Z
field_percrl rl rp r� N s
z$cpu_times_percent.<locals>.calculateTr ) r� r� r� r� r\ r� r �_last_cpu_times_2r� �_last_per_cpu_times_2r� r� r� rl rl rp r^ ; s,
r^ c C s t �� S )zReturn CPU statistics.)r{ r` rl rl rl rp r` v s r` �cpu_freqc C s� t �� }| r|S tt|��}|dkr(dS |dkr8|d S d\}}}d}|D ]6}||j7 }trl|jdu rld}qJ||j7 }||j7 }qJ|| }|r�d } }
n|| } || }
t� || |
�S dS )a: Return CPU frequency as a namedtuple including current,
min and max frequency expressed in Mhz.
If *percpu* is True and the system supports per-cpu frequency
retrieval (Linux only) a list of frequencies is returned for
each CPU. If not a list with one element is returned.
r Nr )r r r FT)
r{ r� r) r� �currentr rw r� r Zscpufreq) r r} r ZcurrsZminsZmaxsZset_none�cpur� Zmin_Zmax_rl rl rp r� } s.
�
getloadavgc C s t �� } | ja| S )a� Return statistics about system memory usage as a namedtuple
including the following fields, expressed in bytes:
- total:
total physical memory available.
- available:
the memory that can be given instantly to processes without the
system going into swap.
This is calculated by summing different memory values depending
on the platform and it is supposed to be used to monitor actual
memory usage in a cross platform fashion.
- percent:
the percentage usage calculated as (total - available) / total * 100
- used:
memory used, calculated differently depending on the platform and
designed for informational purposes only:
macOS: active + wired
BSD: active + wired + cached
Linux: total - free
- free:
memory not being used at all (zeroed) that is readily available;
note that this doesn't reflect the actual memory available
(use 'available' instead)
Platform-specific fields:
- active (UNIX):
memory currently in use or very recently used, and so it is in RAM.
- inactive (UNIX):
memory that is marked as not used.
- buffers (BSD, Linux):
cache for things like file system metadata.
- cached (BSD, macOS):
cache for various things.
- wired (macOS, BSD):
memory that is marked to always stay in RAM. It is never moved to disk.
- shared (BSD):
memory that may be simultaneously accessed by multiple processes.
The sum of 'used' and 'available' does not necessarily equal total.
On Windows 'available' and 'free' are the same.
)r{ rZ r( r' re rl rl rp rZ � s 5rZ c C s t �� S )a� Return system swap memory statistics as a namedtuple including
the following fields:
- total: total swap memory in bytes
- used: used swap memory in bytes
- free: free swap memory in bytes
- percent: the percentage usage
- sin: no. of bytes the system has swapped in from disk (cumulative)
- sout: no. of bytes the system has swapped out from disk (cumulative)
'sin' and 'sout' on Windows are meaningless and always set to 0.
)r{ r[ rl rl rl rp r[ � s
r[ c C s
t �| �S )z�Return disk usage statistics about the given *path* as a
namedtuple including total, used and free space expressed in bytes
plus the percentage usage.
)r{ rg )r� rl rl rp rg s rg c C s
t �| �S )a3 Return mounted partitions as a list of
(device, mountpoint, fstype, opts) namedtuple.
'opts' field is a raw string separated by commas indicating mount
options which may vary depending on the platform.
If *all* parameter is False return physical devices only and ignore
all others.
)r{ rf )�allrl rl rp rf s rf c C s� t rt| d�ni }tjf i |��}|s2| r.i S dS |r@t|d�}ttdtj�}| rt|�� D ]\}}||� ||< qZ|S |dd� t |�
� � D �� S dS )a� Return system disk I/O statistics as a namedtuple including
the following fields:
- read_count: number of reads
- write_count: number of writes
- read_bytes: number of bytes read
- write_bytes: number of bytes written
- read_time: time spent reading from disk (in ms)
- write_time: time spent writing to disk (in ms)
Platform specific:
- busy_time: (Linux, FreeBSD) time spent doing actual I/Os (in ms)
- read_merged_count (Linux): number of merged reads
- write_merged_count (Linux): number of merged writes
If *perdisk* is True return the same information for every
physical disk installed on the system as a dictionary
with partition names as the keys and the namedtuple
described above as the values.
If *nowrap* is True it detects and adjust the numbers which overflow
and wrap (restart from 0) and add "old value" to "new value" so that
the returned numbers will always be increasing or remain the same,
but never decrease.
"disk_io_counters.cache_clear()" can be used to invalidate the
cache.
On recent Windows versions 'diskperf -y' command may need to be
executed first otherwise this function won't find any disk.
)�perdiskN�psutil.disk_io_counters�sdiskioc s s | ]}t |�V qd S r� �r{ rw rl rl rp � <genexpr>H rr z#disk_io_counters.<locals>.<genexpr>) r rl r{ re �
_wrap_numbersr� r r� r� r� �values)r� �nowraprU �rawdictr2 Zdisk�fieldsrl rl rp re s
re r� z Clears nowrap argument cachec C sn t �� }|s| ri S dS |r&t|d�}| rN|�� D ]\}}tj|� ||< q2|S tjdd� t|�� � D �� S dS )ac Return network I/O statistics as a namedtuple including
the following fields:
- bytes_sent: number of bytes sent
- bytes_recv: number of bytes received
- packets_sent: number of packets sent
- packets_recv: number of packets received
- errin: total number of errors while receiving
- errout: total number of errors while sending
- dropin: total number of incoming packets which were dropped
- dropout: total number of outgoing packets which were dropped
(always 0 on macOS and BSD)
If *pernic* is True return the same information for every
network interface installed on the system as a dictionary
with network interface names as the keys and the namedtuple
described above as the values.
If *nowrap* is True it detects and adjust the numbers which overflow
and wrap (restart from 0) and add "old value" to "new value" so that
the returned numbers will always be increasing or remain the same,
but never decrease.
"net_io_counters.cache_clear()" can be used to invalidate the
cache.
N�psutil.net_io_countersc S s g | ] }t |��qS rl r� rw rl rl rp rq z rr z#net_io_counters.<locals>.<listcomp>)r{ ra r� r� r Zsnetior� r� )Zpernicr� r� Znicr� rl rl rp ra V s
ra r� r6 c C s
t �| �S )a� Return system-wide socket connections as a list of
(fd, family, type, laddr, raddr, status, pid) namedtuples.
In case of limited privileges 'fd' and 'pid' may be set to -1
and None respectively.
The *kind* parameter filters for connections that fit the
following criteria:
+------------+----------------------------------------------------+
| Kind Value | Connections using |
+------------+----------------------------------------------------+
| inet | IPv4 and IPv6 |
| inet4 | IPv4 |
| inet6 | IPv6 |
| tcp | TCP |
| tcp4 | TCP over IPv4 |
| tcp6 | TCP over IPv6 |
| udp | UDP |
| udp4 | UDP over IPv4 |
| udp6 | UDP over IPv6 |
| unix | UNIX socket (both UDP and TCP protocols) |
| all | the sum of all the possible families and protocols |
+------------+----------------------------------------------------+
On macOS this function requires root privileges.
)r{ rb r9 rl rl rp rb � s rb c
C s� t } | rddl}t�� }|jdd� d� t�t�}|D ]�\}}}}}} | r�z|�|�}W n@ t y� t
rz|dkrztj }nt td�r�|tj kr�tj }Y n0 |tj kr�t
r�dnd }
|�|
�d
k r�|d |
7 }q�|| �t�||||| �� q6t|�S ) a* Return the addresses associated to each NIC (network interface
card) installed on the system as a dictionary whose keys are the
NIC names and value is a list of namedtuples for each address
assigned to the NIC. Each namedtuple includes 5 fields:
- family: can be either socket.AF_INET, socket.AF_INET6 or
psutil.AF_LINK, which refers to a MAC address.
- address: is the primary address and it is always set.
- netmask: and 'broadcast' and 'ptp' may be None.
- ptp: stands for "point to point" and references the
destination address on a point to point interface
(typically a VPN).
- broadcast: and *ptp* are mutually exclusive.
Note: you can have more than one address of the same family
associated with each interface.
r Nc S s | d S )Nr rl )rx rl rl rp r/ � rr z net_if_addrs.<locals>.<lambda>)�key���rS �:�-� z%s00)r� �socketr{ rc �sortr� r
r� �
AddressFamilyr� r, rS r� r �countr� r Zsnicaddrrl ) Z has_enumsr� Zrawlistr} r� �fam�addr�mask� broadcastZptp� separatorrl rl rp rc � s0
��
rc c C s t �� S )a Return information about each NIC (network interface card)
installed on the system as a dictionary whose keys are the
NIC names and value is a namedtuple with the following fields:
- isup: whether the interface is up (bool)
- duplex: can be either NIC_DUPLEX_FULL, NIC_DUPLEX_HALF or
NIC_DUPLEX_UNKNOWN
- speed: the NIC speed expressed in mega bits (MB); if it can't
be determined (e.g. 'localhost') it will be set to 0.
- mtu: the maximum transmission unit expressed in bytes.
)r{ rd rl rl rl rp rd � s rd �sensors_temperaturesc
s� � fdd�}t �t�}t�� }|�� D ]l\}}|r&|�d�\}}}} ||�}||�}|| �} |rj| sj|} n | rv|sv| }|| �t� |||| �� q.q&t
|�S )a< Return hardware temperatures. Each entry is a namedtuple
representing a certain hardware sensor (it may be a CPU, an
hard disk or something else, depending on the OS and its
configuration).
All temperatures are expressed in celsius unless *fahrenheit*
is set to True.
c s( | d ur$� r t | �d d d S | S d S )N� r� � )r) )�n��
fahrenheitrl rp �convert� s z%sensors_temperatures.<locals>.convertr ) r� r
r� r{ r� r� r r� r Zshwtemprl )
r� r� r} r� r� r� �labelr� �high�criticalrl r� rp r� � s"
�� sensors_fansc C s t �� S )z�Return fans speed. Each entry is a namedtuple
representing a certain hardware sensor.
All speed are expressed in RPM (rounds per minute).
)r{ r� rl rl rl rp r� s �sensors_batteryc C s t �� S )a� Return battery information. If no battery is installed
returns None.
- percent: battery power left as a percentage.
- secsleft: a rough approximation of how many seconds are left
before the battery runs out of power. May be
POWER_TIME_UNLIMITED or POWER_TIME_UNLIMITED.
- power_plugged: True if the AC power cable is connected.
)r{ r� rl rl rl rp r� s
c C s t �� S )zAReturn the system boot time expressed in seconds since the epoch.)r{ ri rl rl rl rp ri 2 s ri c C s t �� S )a� Return users currently connected on the system as a list of
namedtuples including the following fields.
- user: the name of the user
- terminal: the tty or pseudo-tty associated with the user, if any.
- host: the host name associated with the entry, if any.
- started: the creation time as a floating point number expressed in
seconds since the epoch.
)r{ rh rl rl rl rp rh 9 s
rh c C s t �� S )zjReturn a generator yielding a WindowsService instance for all
Windows services installed.
)r{ �win_service_iterrl rl rl rp r� M s r� c C s
t �| �S )zjGet a Windows service by *name*.
Raise NoSuchProcess if no service with such name exists.
)r{ �win_service_get)r� rl rl rp r� S s r� c C s( ddl }t| �|j_tj�t| �� dS )zZEnable or disable PSUTIL_DEBUG option, which prints debugging
messages to stderr.
r N)Zpsutil._common�boolr Z PSUTIL_DEBUGr{ r� � set_debug)r� Zpsutilrl rl rp �
_set_debug] s r� c C s@ ddl m} ddlm} tj�� }d}g d�}t|d � t|d d�D �]�}|j d r�tj�
|j d �}|�� |kr�|� d �}q�|� d
�}nd }|j d r�t � d
t �
t|j d ���}nd }|j d p�d }|s�tr�z|�� d }W n ty� Y n0 |�rt�rd|v �r|�d�d }|d d� }|j d d u�rF| |j d j�nd } |j d d u�rj| |j d j�nd }
|j d d u�r�t|j d d�nd } |j d �r�t|j d �nd } |j d �r�d�|j d �}
n
|j d }
|j d �r�|j d d d� nd }||d d� |j d | | |
| ||||
f
}t|d |� d � � qFd S ) Nr )� bytes2human)�get_terminal_sizez)%-10s %5s %5s %7s %7s %5s %6s %6s %6s %s)
r~ r* r� r� r\ r� r� r� r� r� )
�USERZPIDz%MEMZVSZZRSSZNICEZSTATUS�STARTZTIMEZCMDLINE)r� r� z%H:%Mz%b%dru r\ z%M:%Sr� r �\r� r� r* r� r� � r� r� r� �
r~ )r r� �_compatr� r� �date�today�printrX r� r� r� r� � localtimer{ r r� r. r, �split�vmsr% r rm r� )r� r� Z today_dayZtemplr� �pr� Zcputimer r� r% Zmempr� r� r� �linerl rl rp �testg sr
� �� �� ��
"
� r� r- �__main__)NN)NN)T)F)NF)NF)F)F)FT)FT)r6 )F)�rK �
__future__r r� rN r� � functoolsr� r? rQ �sysr� r� r� r� ru r r r r r r r
r r r
r r r r r r r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r2 r3 r4 r� r� r5 r� r6 r7 r8 rq r9 Z PROCFS_PATHr: r{ r; r< r= r> r? Z_psutil_windowsr@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP r� �platform�__all__�extendZ__extra__all__r� rT rk �globalsZ_globalsr� rV r� �isupperr� r� rS �
__author__rR r� r� rQ r r' r� r^ r� rm �replacer� ry r� r� r� rv rz r r� r� r� rU rW rV ri r� rX � cache_clearrY r_ r\ r� r� r� � Exceptionr� r} r� r� r] rj r� r� r^ r` r� r� rZ r[ rg rf re �partialra rb rc rd r� r� r� ri rh r� r� r� r� ro rx r� rl rl rl rp �<module> s�
1 � �
��
7�
W
6
b
�
N
;
(
;
/�
'�
2
"
J
PK ok\E�� 5 5 ( psutil/__pycache__/_psosx.cpython-39.pycnu �[��� a
��?h? � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm Z
ddlm Z dd lm
Z
dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ g Ze �� Ze j Z e
j ej e
j ej e
j!ej"e
j#ej$e
j%ej&e
j'ej(e
j)ej*e
j+ej,e
j-ej.e
j/ej0e
j1ej2e
j3ej4i Z5e
j6ej7e
j8ej9e
j:ej;e
j<ej=e
j>ej?iZ@eAddddddddddd d � ZBeAddddddddd �ZCed g d ��ZDed!g d"��ZEed#g d$��ZFed%eFjGd& �ZHd'd(� ZId)d*� ZJd+d,� ZKd-d.� ZLd/d0� ZMd1d2� ZNd3d4� ZOd5d6� ZPejQZQe
jRZRdMd8d9�ZSd:d;� ZTe
jUZUe jVZVdNd=d>�ZWd?d@� ZXdAdB� ZYdCdD� ZZdEdF� Z[ej\Z\dGdH� Z]dIdJ� Z^G dKdL� dL�Z_dS )Oz macOS platform implementation.� N)�
namedtuple� )�_common)�_psposix)� _psutil_osx)�
_psutil_posix)� AccessDenied)�
NoSuchProcess)�
ZombieProcess)� conn_tmap)�conn_to_ntuple)�
isfile_strict)�memoize_when_activated)�parse_environ_block)�
usage_percent)�PermissionError)�ProcessLookupError� � � � � � � � �
) �ppid�ruid�euid�suid�rgid�egid�sgid�ttynr�ctime�status�name)�cpuutime�cpustime�rss�vms�pfaults�pageins�
numthreads�volctxsw� scputimes��user�nice�system�idle�svmem)�total� available�percent�used�free�active�inactive�wired�pmem)r) r* r+ r, �pfullmem)�ussc C sT t �� \} }}}}}|| }|| }||8 }t| | | dd�}t| |||||||�S )z&System virtual memory as a namedtuple.r �Zround_)�cextZ virtual_memr r5 ) r6 r; r< r= r: Z speculativeZavailr9 r8 � rC �9/usr/local/lib64/python3.9/site-packages/psutil/_psosx.py�virtual_memoryq s rE c C s4 t �� \} }}}}t|| dd�}t�| |||||�S )z=Swap system memory as a (total, used, free, sin, sout) tuple.r rA )rB Zswap_memr r Zsswap)r6 r9 r: �sinZsoutr8 rC rC rD � swap_memory� s rG c C s t �� \} }}}t| |||�S )z(Return system CPU times as a namedtuple.)rB � cpu_timesr/ r0 rC rC rD rH � s rH c C s: g } t �� D ](}|\}}}}t||||�}| �|� q | S )z)Return system CPU times as a named tuple.)rB �
per_cpu_timesr/ �append)�retZcpu_tr1 r2 r3 r4 �itemrC rC rD rI � s rI c C s t �� S )z0Return the number of logical CPUs in the system.)rB �cpu_count_logicalrC rC rC rD rM � s rM c C s t �� S )z-Return the number of CPU cores in the system.)rB �cpu_count_coresrC rC rC rD rN � s rN c C s" t �� \} }}}}t�| |||�S �N)rB � cpu_statsr Z scpustats)Z ctx_switchesZ
interruptsZsoft_interruptsZsyscallsZ_trapsrC rC rD rP � s
� �rP c C s t �� \} }}t�| ||�gS )z�Return CPU frequency.
On macOS per-cpu frequency is not supported.
Also, the returned frequency never changes, see:
https://arstechnica.com/civis/viewtopic.php?f=19&t=465002.
)rB �cpu_freqr Zscpufreq)�currZmin_Zmax_rC rC rD rQ � s rQ Fc C sj g }t �� }|D ]T}|\}}}}|dkr,d}| sJtj�|�rtj�|�sJqt�||||�}|�|� q|S )z8Return mounted disk partitions as a list of namedtuples.�none� ) rB �disk_partitions�os�path�isabs�existsr Z sdiskpartrJ ) �all�retlistZ
partitions� partitionZdeviceZ
mountpointZfstype�opts�ntuplerC rC rD rU � s rU c C sb zt �� \} }}W n ty& Y dS 0 |dk}|r<tj}n|dkrLtj}n|d }t�| ||�S )zReturn battery information.Nr ����< )rB �sensors_battery�NotImplementedErrorr ZPOWER_TIME_UNLIMITEDZPOWER_TIME_UNKNOWNZsbattery)r8 ZminsleftZ
power_pluggedZsecsleftrC rC rD ra � s ra �inetc C sj g }t � D ]Z}zt|��| �}W n ty6 Y q
Y q
0 |r
|D ]"}t|�|g }|�tj|� � q@q
|S )z System-wide network connections.)�pids�Process�net_connectionsr �listrJ r Zsconn)�kindrK �pidZcons�crC rC rD rf � s
rf c
C s� t � �� } i }| D ]�}z&t�|�}t�|�}t�|�\}}W n2 tyn } z|jtjkrZ� W Y d}~qd}~0 0 t t
d�r�t
� |�}d� |�}d|v } t
�
| ||||�||< q|S )z)Get NIC stats (isup, duplex, speed, mtu).N� NicDuplex�,�running)�net_io_counters�keys�
cext_posixZ
net_if_mtuZ net_if_flagsZnet_if_duplex_speed�OSError�errnoZENODEV�hasattrr rk �joinZ snicstats)
�namesrK r& Zmtu�flagsZduplex�speed�errZ output_flagsZisuprC rC rD � net_if_stats s$
�
ry c C s t �� S )z:The system boot time expressed in seconds since the epoch.)rB � boot_timerC rC rC rD rz ! s rz c C s\ g } t �� }|D ]F}|\}}}}}|dkr,q|s2qt�||p>d|pDd||�}| �|� q| S )z:Return currently connected users as a list of namedtuples.�~N)rB �usersr ZsuserrJ ) r[ �rawlistrL r1 �tty�hostnameZtstampri �ntrC rC rD r| & s r| c C s` t �� } d| vr\z td��� | �dd� W n. ty> Y n tyZ | �dd� Y n0 | S �Nr )rB rd re � create_time�insertr r )ZlsrC rC rD rd : s rd c C s8 z t �| �td }|t jkW S ty2 Y dS 0 d S )Nr% F)rB �proc_kinfo_oneshot�kinfo_proc_map�SZOMBrq )ri �strC rC rD � is_zombieM s
r� c s t �� �� fdd��}|S )z`Decorator which translates bare OSError exceptions into
NoSuchProcess and AccessDenied.
c sz z� | g|�R i |��W S t yV t| j�rDt| j| j| j��nt| j| j��Y n tyt t| j| j��Y n0 d S rO ) r r� ri r
�_name�_ppidr r r )�self�args�kwargs��funrC rD �wrapperZ s
z wrap_exceptions.<locals>.wrapper)� functools�wraps)r� r� rC r� rD �wrap_exceptionsU s r� c @ sh e Zd ZdZg d�Zdd� Zeedd� ��Zeedd� ��Z d d
� Z
d d � Z ed
d� �Z edd� �Z
edd� �Zedd� �Zedd� �Zedd� �Zedd� �Zedd � �Zed d � �Zed d � �Zed!d"� �Zed#d$� �Zed%d&� �Zed'd(� �Zed)d*� �Zed+d,� �Zed=d.d/��Z ed0d1� �Z ed>d3d4��Z ed5d6� �Z ed7d8� �Z ed9d:� �Z!ed;d<� �Z"d2S )?re z1Wrapper class around underlying C implementation.)�_cacher� r� ri c C s || _ d | _d | _d S rO )ri r� r� )r� ri rC rC rD �__init__n s zProcess.__init__c C s$ t �| j�}t|�tt�ks J �|S rO )rB r� ri �lenr� �r� rK rC rC rD �_get_kinfo_procs s zProcess._get_kinfo_procc C s$ t �| j�}t|�tt�ks J �|S rO )rB Zproc_pidtaskinfo_oneshotri r� �pidtaskinfo_mapr� rC rC rD �_get_pidtaskinfo{ s zProcess._get_pidtaskinfoc C s | j �| � | j�| � d S rO )r� Zcache_activater� �r� rC rC rD �
oneshot_enter� s zProcess.oneshot_enterc C s | j �| � | j�| � d S rO )r� Zcache_deactivater� r� rC rC rD � oneshot_exit� s zProcess.oneshot_exitc C s( | � � td }|d ur |S t�| j�S )Nr& )r� r� rB Z proc_nameri )r� r& rC rC rD r& � s z Process.namec C s t �| j�S rO )rB Zproc_exeri r� rC rC rD �exe� s z Process.exec C s t �| j�S rO )rB Z proc_cmdlineri r� rC rC rD �cmdline� s zProcess.cmdlinec C s t t�| j��S rO )r rB Z proc_environri r� rC rC rD �environ� s zProcess.environc C s | � � td | _| jS )Nr )r� r� r� r� rC rC rD r � s z Process.ppidc C s t �| j�S rO )rB Zproc_cwdri r� rC rC rD �cwd� s z Process.cwdc C s. | � � }t�|td |td |td �S )Nr r r �r� r Zpuidsr� �r� ZrawtuplerC rC rD �uids� s
�z Process.uidsc C s. | � � }t�|td |td |td �S )Nr r! r" r� r� rC rC rD �gids� s
�z Process.gidsc C s< | � � td }t�� }z
|| W S ty6 Y d S 0 d S )Nr# )r� r� r Zget_terminal_map�KeyError)r� Ztty_nrZtmaprC rC rD �terminal� s
zProcess.terminalc C s6 | � � }t|td |td |td |td �S )Nr) r* r+ r, )r� r> r� r� rC rC rD � memory_info� s
�zProcess.memory_infoc C s" | � � }t�| j�}t||f � S rO )r� rB Zproc_memory_ussri r? )r� Z basic_memr@ rC rC rD �memory_full_info� s zProcess.memory_full_infoc C s( | � � }t�|td |td dd�S )Nr' r( g )r� r Z pcputimesr� r� rC rC rD rH � s
�zProcess.cpu_timesc C s | � � td S )Nr$ )r� r� r� rC rC rD r� � s zProcess.create_timec C s | � � td }t�|d�S )Nr. r )r� r� r Zpctxsw)r� ZvolrC rC rD �num_ctx_switches� s zProcess.num_ctx_switchesc C s | � � td S )Nr- )r� r� r� rC rC rD � num_threads� s zProcess.num_threadsc C sN | j dkrg S g }t�| j �}|D ]&\}}t|�r"t�||�}|�|� q"|S r� )ri rB Zproc_open_filesr
r Z popenfilerJ )r� �filesr} rW �fdr^ rC rC rD �
open_files� s
zProcess.open_filesrc c C s� |t vr(td|d�dd� t D ��f ��t | \}}t�| j||�}g }|D ]2}|\}}} }
} } t||| |
| | t�}
|�|
� qL|S )Nz+invalid %r kind argument; choose between %sz, c S s g | ] }t |��qS rC )�repr)�.0�xrC rC rD �
<listcomp>� � z+Process.net_connections.<locals>.<listcomp>) r �
ValueErrorrt rB Zproc_net_connectionsri r � TCP_STATUSESrJ )r� rh Zfamilies�typesr} rK rL r� �fam�type�laddr�raddrr% r� rC rC rD rf � s �� � zProcess.net_connectionsc C s | j dkrdS t�| j �S r� )ri rB Z proc_num_fdsr� rC rC rD �num_fds s
zProcess.num_fdsNc C s t �| j|| j�S rO )r Zwait_pidri r� )r� �timeoutrC rC rD �wait s z Process.waitc C s t �| j�S rO )rp � getpriorityri r� rC rC rD �nice_get s zProcess.nice_getc C s t �| j|�S rO )rp � setpriorityri )r� �valuerC rC rD �nice_set s zProcess.nice_setc C s | � � td }t�|d�S )Nr% �?)r� r� �
PROC_STATUSES�get)r� �coderC rC rD r% s zProcess.statusc C s< t �| j�}g }|D ]"\}}}t�|||�}|�|� q|S rO )rB Z proc_threadsri r ZpthreadrJ )r� r} r[ � thread_id�utimeZstimer^ rC rC rD �threads! s zProcess.threads)rc )N)#�__name__�
__module__� __qualname__�__doc__� __slots__r� r� r r� r� r� r� r& r� r� r� r r� r� r� r� r� r� rH r� r� r� r� rf r� r� r� r� r% r� rC rC rC rD re i sr
re )F)rc )`r� rr r� rV � collectionsr rT r r r rB r rp r r r
r r r
r r r Z_compatr r Z__extra__all__Z getpagesizeZPAGESIZEZAF_LINKZTCPS_ESTABLISHEDZCONN_ESTABLISHEDZ
TCPS_SYN_SENTZ
CONN_SYN_SENTZTCPS_SYN_RECEIVEDZ
CONN_SYN_RECVZTCPS_FIN_WAIT_1ZCONN_FIN_WAIT1ZTCPS_FIN_WAIT_2ZCONN_FIN_WAIT2ZTCPS_TIME_WAITZCONN_TIME_WAITZ TCPS_CLOSEDZ
CONN_CLOSEZTCPS_CLOSE_WAITZCONN_CLOSE_WAITZ
TCPS_LAST_ACKZ
CONN_LAST_ACKZ TCPS_LISTENZ CONN_LISTENZ TCPS_CLOSINGZ CONN_CLOSINGZPSUTIL_CONN_NONEZ CONN_NONEr� ZSIDLZ STATUS_IDLEZSRUNZSTATUS_RUNNINGZSSLEEPZSTATUS_SLEEPINGZSSTOPZSTATUS_STOPPEDr� Z
STATUS_ZOMBIEr� �dictr� r� r/ r5 r> �_fieldsr? rE rG rH rI rM rN rP rQ �
disk_usageZdisk_io_countersrU ra rn Z net_if_addrsrf ry rz r| rd Z
pid_existsr� r� re rC rC rC rD �<module> s� �����
PK ok\�DB�g[ g[ ) psutil/__pycache__/_common.cpython-39.pycnu �[��� a
��?h+t �
@ sh d Z ddlmZ ddlmZ ddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlmZ ddl mZ ddl mZ ddl mZ zdd l mZ W n ey� dZY n0 zdd
l mZ W n ey� dZY n0 e jd d kZe�r
ddlZndZee�d ��Ze� Z g d
�Z ej dkZ ej dkZ e j!�"d�Z#e j!�"d�Z$e$Z%e j!�"d�Z&e j!�"d�Z'e j!�"d�Z(e&�p�e'�p�e(Z)e j!�"d�Z*e j!�"d�Z+dZ,dZ-dZ.dZ/dZ0d Z1d Z2d Z3d Z4d Z5d!Z6d"Z7d#Z8d$Z9d%Z:d&Z;d'Z<d(Z=d)Z>d*Z?d+Z@d,ZAd-ZBd.ZCd/ZDd0ZEedu �r&d1ZFd2ZGdZHn G d3d4� d4ejI�ZJeK� �LeJjM� edu �rZd5ZNd6ZOn G d7d8� d8ejI�ZPeK� �LePjM� e �Q� ZRe�s�d9ZSn0z e �T� ZSW n" eU�y� e �r�d:nd9ZSY n0 ed;g d<��ZVed=g d>��ZWed?g d@��ZXedAg dB��ZYedCg dD��ZZedEg dF��Z[edGg dH��Z\edIg dJ��Z]edKg dL��Z^edMg dN��Z_edOg dP��Z`edQg dR��ZaedSg dT��ZbedUdVdWg�ZcedXg dY��ZdedZd[d\g�Zeed]g d^��Zfed_g d`��Zgedag d`��Zhedbg dc��Ziedddedfg�Zjedgdhdig�Zkedjg dk��Zledldmdng�Zmeeegeegfeegegfegegfeegegfegegfeegeegfegeegfegeegfdo�Znedu�r�en�Legegfegegfdp�� edu�r�en�Ldqegeegfi� G drds� dseo�ZpG dtdu� duep�ZqG dvdw� dweq�ZrG dxdy� dyep�ZsG dzd{� d{ep�Zte�rBeuevew��r.evd| Zxn
eyevd|�Zxexd}� nd~d� Zzd�d�d��Z{d�d�� Z|d�d�� Z}d�d�� Z~d�d�� Ze|d�d�� �Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�d�d�� Z�G d�d�� d��Z�d�d�� Z�e�� Z�e�j�e�_�e�j�e�_�d�Z�d�d�� Z�d�d�� Z�e e�fd�d��Z�e fd�d��Z�d�d�d��Z�d�d�� Z�e�r&d�d�� Z�nd�d�� Z�e|e j�fd�d���Z�d�d�d��Z�dd�e j�fd�d��Z�d�d�� Z�dS )�z9Common objects shared by __init__.py and _ps*.py modules.� )�division)�print_functionN)�
namedtuple)�AF_INET)�
SOCK_DGRAM)� SOCK_STREAM)�AF_INET6)�AF_UNIX� � PSUTIL_DEBUG)R�FREEBSD�BSD�LINUX�NETBSD�OPENBSD�MACOS�OSX�POSIX�SUNOS�WINDOWS�
CONN_CLOSE�CONN_CLOSE_WAIT� CONN_CLOSING�CONN_ESTABLISHED�CONN_FIN_WAIT1�CONN_FIN_WAIT2�
CONN_LAST_ACK� CONN_LISTEN� CONN_NONE�
CONN_SYN_RECV�
CONN_SYN_SENT�CONN_TIME_WAIT�NIC_DUPLEX_FULL�NIC_DUPLEX_HALF�NIC_DUPLEX_UNKNOWN� STATUS_DEAD�STATUS_DISK_SLEEP� STATUS_IDLE�
STATUS_LOCKED�STATUS_RUNNING�STATUS_SLEEPING�STATUS_STOPPED�STATUS_SUSPENDED�STATUS_TRACING_STOP�STATUS_WAITING�STATUS_WAKE_KILL�
STATUS_WAKING�
STATUS_ZOMBIE�
STATUS_PARKED�ENCODING�
ENCODING_ERRSr �pconn� pcputimes�pctxsw�pgids�pio�pionice� popenfile�pthread�puids�sconn� scpustats�sdiskio� sdiskpart�
sdiskusage�snetio�snicaddr� snicstats�sswap�suser� conn_tmap�deprecated_method�
isfile_strict�memoize�parse_environ_block�path_exists_strict�
usage_percent�
supports_ipv6�sockfam_to_enum�socktype_to_enum� wrap_numbers� open_text� open_binary�cat�bcat� bytes2human�conn_to_ntuple�debug�hilite�term_supports_colors� print_color�posix�nt�linux�darwin)ZfreebsdZ midnightbsdZopenbsdZnetbsd)�sunos�solaris�aix�runningZsleepingz
disk-sleep�stoppedz tracing-stopZzombieZdeadz wake-killZwaking�idle�lockedZwaitingZ suspendedZparkedZ ESTABLISHEDZSYN_SENTZSYN_RECVZ FIN_WAIT1Z FIN_WAIT2Z TIME_WAITZCLOSEZ
CLOSE_WAITZLAST_ACKZLISTENZCLOSING�NONE� � c @ s e Zd ZdZdZdZdS )� NicDuplexri rj r N)�__name__�
__module__� __qualname__r" r# r$ � ro ro �:/usr/local/lib64/python3.9/site-packages/psutil/_common.pyrk � s rk ������c @ s e Zd ZdZdZdS )� BatteryTimerq rr N)rl rm rn �POWER_TIME_UNKNOWN�POWER_TIME_UNLIMITEDro ro ro rp rs � s rs �replace�surrogateescaperF )�total�used�free�percent�sinZsoutrB )rx ry rz r{ r@ )�
read_count� write_count�
read_bytes� write_bytesZ read_timeZ
write_timerA )ZdeviceZ
mountpointZfstype�optsrC )Z
bytes_sentZ
bytes_recvZ packets_sentZ packets_recvZerrinZerroutZdropinZdropoutrG )�nameZterminal�host�started�pidr> )�fd�family�type�laddr�raddr�statusr� rD )r� �address�netmask� broadcastZptprE )ZisupZduplex�speedZmtu�flagsr? )Z ctx_switchesZ
interruptsZsoft_interruptsZsyscalls�scpufreq)�current�min�max�shwtemp)�labelr� �high�critical�sbattery)r{ ZsecsleftZ
power_plugged�sfanr� r� r6 )�user�system�
children_user�children_systemr; �pathr� r< )�idZ user_timeZ system_timer= )�realZ effectiveZsavedr8 r9 )r} r~ r r� r: Zioclass�valuer7 Z voluntaryZ involuntaryr5 )r� r� r� r� r� r� �addr�ip�port)�allZtcpZtcp4ZudpZudp4ZinetZinet4Zinet6)Ztcp6Zudp6�unixc @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S )
�ErrorzQBase exception class. All other psutil exceptions inherit
from this one.
�psutilc C sH t �� }|D ]6}t| |d �}|r*|||< q |dkr |dkr |||< q |S )Nr� r )� collections� OrderedDict�getattr)�self�attrs�infor� r� ro ro rp � _infodict$ s
zError._infodictc C sP | � d�}|r,dd�dd� |�� D �� }nd }d�dd� t| dd �|fD ��S )
N)r� �ppidr� z(%s)�, c S s g | ]\}}d ||f �qS �z%s=%rro ��.0�k�vro ro rp �
<listcomp>3 � z!Error.__str__.<locals>.<listcomp>� c S s g | ] }|r|�qS ro ro )r� �xro ro rp r� 7 r� �msg� )r� �join�itemsr� �r� r� �detailsro ro rp �__str__. s
�z
Error.__str__c C s2 | � d�}d�dd� |�� D ��}d| jj|f S )N)r� r� r� �secondsr� r� c S s g | ]\}}d ||f �qS r� ro r� ro ro rp r� < r� z"Error.__repr__.<locals>.<listcomp>z
psutil.%s(%s))r� r� r� � __class__rl r� ro ro rp �__repr__9 s
zError.__repr__N)rl rm rn �__doc__r� r� r� ro ro ro rp r� s
r� c @ s& e Zd ZdZdZddd�Zdd� ZdS ) �
NoSuchProcesszXException raised when a process with a certain PID doesn't
or no longer exists.
r� Nc C s$ t �| � || _|| _|p d| _d S )Nzprocess no longer exists�r� �__init__r� r� r� �r� r� r� r� ro ro rp r� G s
zNoSuchProcess.__init__c C s | j | j| j| jffS �N�r� r� r� r� �r� ro ro rp �
__reduce__M s zNoSuchProcess.__reduce__)NN�rl rm rn r� r� r� ro ro ro rp r� @ s
r� c @ s& e Zd ZdZdZddd�Zdd� ZdS ) �
ZombieProcessa1 Exception raised when querying a zombie process. This is
raised on macOS, BSD and Solaris only, and not always: depending
on the query the OS may be able to succeed anyway.
On Linux all zombie processes are querable (hence this is never
raised). Windows doesn't have zombie processes.
r� Nc C s$ t �| |||� || _|p d| _d S )Nz"PID still exists but it's a zombie)r� r� r� r� )r� r� r� r� r� ro ro rp r� [ s zZombieProcess.__init__c C s | j | j| j| j| jffS r� )r� r� r� r� r� r� ro ro rp r� ` s zZombieProcess.__reduce__)NNNr� ro ro ro rp r� Q s
r� c @ s& e Zd ZdZdZddd�Zdd� ZdS ) � AccessDeniedz@Exception raised when permission to perform an action is denied.r� Nc C s$ t �| � || _|| _|p d| _d S )Nr� r� r� ro ro rp r� i s
zAccessDenied.__init__c C s | j | j| j| jffS r� r� r� ro ro rp r� o s zAccessDenied.__reduce__)NNNr� ro ro ro rp r� d s
r� c @ s& e Zd ZdZdZddd�Zdd� ZdS ) �TimeoutExpiredzWRaised on Process.wait(timeout) if timeout expires and process
is still alive.
r� Nc C s* t �| � || _|| _|| _d| | _d S )Nztimeout after %s seconds)r� r� r� r� r� r� )r� r� r� r� ro ro rp r� z s
zTimeoutExpired.__init__c C s | j | j| j| jffS r� )r� r� r� r� r� ro ro rp r� � s zTimeoutExpired.__reduce__)NNr� ro ro ro rp r� s s
r� �execzvdef raise_from(value, from_value):
try:
raise value from from_value
finally:
value = None
c C s | �d S r� ro )r� �
from_valuero ro rp �
raise_from� s r� c C sD zt | �| d }W n ty( Y dS 0 |dur<t||�}|S dS )z5Calculate percentage usage of 'used' against 'total'.�d g N)�float�ZeroDivisionError�round)ry rx Zround_�retro ro rp rN � s
rN c s2 t ���� �fdd��}� fdd�}i � ||_|S )a� A simple memoize decorator for functions supporting (hashable)
positional arguments.
It also provides a cache_clear() function for clearing the cache:
>>> @memoize
... def foo()
... return 1
...
>>> foo()
1
>>> foo.cache_clear()
>>>
It supports:
- functions
- classes (acts as a @singleton)
- staticmethods
- classmethods
It does NOT support:
- methods
c
s� | t t|�� ��f}z
� | W S ty~ z�| i |�� }� |< W n. tyt } zt|d ��W Y d }~n
d }~0 0 | Y S 0 d S r� )� frozenset�sortedr� �KeyError� Exceptionr� )�args�kwargs�keyr� �err��cache�funro rp �wrapper� s
zmemoize.<locals>.wrapperc s � � � dS )z Clear cache.N)�clearro )r� ro rp � cache_clear� s z memoize.<locals>.cache_clear)� functools�wrapsr� )r� r� r� ro r� rp rK � s rK c s6 t �� �� fdd��}dd� }dd� }||_||_|S )a� A memoize decorator which is disabled by default. It can be
activated and deactivated on request.
For efficiency reasons it can be used only against class methods
accepting no arguments.
>>> class Foo:
... @memoize
... def foo()
... print(1)
...
>>> f = Foo()
>>> # deactivated (default)
>>> foo()
1
>>> foo()
1
>>>
>>> # activated
>>> foo.cache_activate(self)
>>> foo()
1
>>> foo()
>>> foo()
>>>
c
s� z| j � }W n� ty^ z� | �W Y S tyX } zt|d ��W Y d }~n
d }~0 0 Y np ty� z � | �}W n. ty� } zt|d ��W Y d }~n
d }~0 0 z|| j � < W n ty� Y n0 Y n0 |S r� )�_cache�AttributeErrorr� r� r� )r� r� r� �r� ro rp r� � s" $ z'memoize_when_activated.<locals>.wrapperc S s
i | _ dS )zsActivate cache. Expects a Process instance. Cache will be
stored as a "_cache" instance attribute.
N)r� ��procro ro rp �cache_activate s z.memoize_when_activated.<locals>.cache_activatec S s z| ` W n ty Y n0 dS )zDeactivate and clear cache.N)r� r� r� ro ro rp �cache_deactivate s z0memoize_when_activated.<locals>.cache_deactivate)r� r� r� r� )r� r� r� r� ro r� rp �memoize_when_activated� s r� c
C sZ zt �| �}W n: tyH } z"|jtjtjfv r2� W Y d}~dS d}~0 0 t�|j�S dS )z�Same as os.path.isfile() but does not swallow EACCES / EPERM
exceptions, see:
http://mail.python.org/pipermail/python-dev/2012-June/120787.html.
NF)�os�stat�OSError�errno�EPERM�EACCES�S_ISREG�st_mode)r� �str� ro ro rp rJ s rJ c
C sR zt �| � W n: tyH } z"|jtjtjfv r2� W Y d}~dS d}~0 0 dS dS )z�Same as os.path.exists() but does not swallow EACCES / EPERM
exceptions. See:
http://mail.python.org/pipermail/python-dev/2012-June/120787.html.
NFT)r� r� r� r� r� r� )r� r� ro ro rp rM - s rM c C sv t jrtdu rdS zHt � tt j�} t�| �� | �d� W d � n1 sL0 Y W dS t jyp Y dS 0 dS )z2Return True if IPv6 is supported on this platform.NF)z::1r T)�socket�has_ipv6r r �
contextlib�closing�bind�error)�sockro ro rp rO < s (rO c C sv i }d}t }| �d|�}||kr"qr| �d||�}||krh| ||� }| |d |� }|r`|�� }|||< |d }q |S )zCParse a C environ block of environment variables into a dictionary.r � �=rj )r �find�upper)�datar� �posZWINDOWS_Znext_posZ equal_posr� r� ro ro rp rL J s
rL c C s4 t du r | S z t�| �W S ty. | Y S 0 dS )z�Convert a numeric socket family value to an IntEnum member.
If it's not a known member, return the numeric value itself.
N)�enumr� �
AddressFamily�
ValueError��numro ro rp rP f s rP c C s4 t du r | S z t�| �W S ty. | Y S 0 dS )zConvert a numeric socket type value to an IntEnum member.
If it's not a known member, return the numeric value itself.
N)r r� �
SocketKindr r ro ro rp rQ s s rQ c C s� |t jtfv r&|rt|� }|r&t|� }|t jkrJ|ttfv rJ|�|t�}nt}t|�}t|�}|du rxt | |||||�S t
| ||||||�S dS )z2Convert a raw connection tuple to a proper ntuple.N) r� r r r� r �getr rP rQ r5 r> )r� �fam�type_r� r� r� Z
status_mapr� ro ro rp rX � s rX c s � fdd�}|S )z�A decorator which can be used to mark a method as deprecated
'replcement' is the method name which will be called instead.
c s: d| j �f � | jd u r � | _t�| �� �fdd��}|S )Nz8%s() is deprecated and will be removed; use %s() insteadc s$ t j� tdd� t| ��|i |��S )Nri )�category�
stacklevel)�warnings�warn�DeprecationWarningr� )r� r� r� )r� � replacementro rp �inner� s z/deprecated_method.<locals>.outer.<locals>.inner)rl r� r� r� )r� r �r )r� rp �outer� s �
z deprecated_method.<locals>.outerro )r r ro r rp rI � s rI c @ sB e Zd ZdZdd� Zdd� Zdd� Zdd � Zdd d �Zd
d� Z d
S )� _WrapNumberszNWatches numbers so that they don't overflow and wrap
(reset to zero).
c C s t �� | _i | _i | _i | _d S r� )� threading�Lock�lockr� � reminders�
reminder_keysr� ro ro rp r� � s
z_WrapNumbers.__init__c C sX || j vsJ �|| jvs J �|| jvs*J �|| j |< t�t�| j|< t�t�| j|< d S r� )r� r r r� � defaultdict�int�set)r� �
input_dictr� ro ro rp � _add_dict� s
z_WrapNumbers._add_dictc C s\ | j | }t|�� �t|�� � }|D ]0}| j| | D ]}| j| |= q8| j| |= q&dS )z�In case the number of keys changed between calls (e.g. a
disk disappears) this removes the entry from self.reminders.
N)r� r# �keysr r )r� r$ r� �old_dictZ gone_keysZgone_key�remkeyro ro rp �_remove_dead_reminders� s
z#_WrapNumbers._remove_dead_remindersc
C s || j vr| �||� |S | �||� | j | }i }|D ]�}|| }z || }W n tyn |||< Y q8Y n0 g }tt|��D ]f} || }
|| } || f} |
| k r�| j| | | 7 < | j| | �| � |� |
| j| | � q�t
|�||< q8|| j |< |S )zlCache dict and sum numbers which overflow and wrap.
Return an updated copy of `input_dict`.
) r� r% r) r� �range�lenr r �add�append�tuple)
r� r$ r� r' Znew_dictr� Z input_tupleZ old_tuple�bits�iZ input_value� old_valuer( ro ro rp �run� s2
z_WrapNumbers.runNc C s| | j �b |du r0| j�� | j�� | j�� n*| j�|d� | j�|d� | j�|d� W d � n1 sn0 Y dS )z>Clear the internal cache, optionally only for function 'name'.N)r r� r� r r �pop)r� r� ro ro rp r� � s
z_WrapNumbers.cache_clearc C s: | j � | j| j| jfW d � S 1 s,0 Y dS )z5Return internal cache dicts as a tuple of 3 elements.N)r r� r r r� ro ro rp �
cache_info� s z_WrapNumbers.cache_info)N)
rl rm rn r� r� r% r) r2 r� r4 ro ro ro rp r � s '
r c C s6 t j� t �| |�W d � S 1 s(0 Y dS )z�Given an `input_dict` and a function `name`, adjust the numbers
which "wrap" (restart from zero) across different calls by adding
"old value" to "new value" and return an updated dict.
N)�_wnr r2 )r$ r� ro ro rp rR s rR i � c C s t | dtd�S )N�rb�� buffering)�open�FILE_READ_BUFFER_SIZE)�fnamero ro rp rT s rT c C s\ t st| td�S t| tttd�}z
t|_W n, ty< Y n tyV |�� � Y n0 |S )z�On Python 3 opens a file in text mode by using fs encoding and
a proper en/decoding errors handler.
On Python 2 this is just an alias for open(name, 'rt').
r7 )r8 �encoding�errors) �PY3r9 r: r3 r4 � _CHUNK_SIZEr� r� �close)r; �fobjro ro rp rS " s �
rS c C s� |t u r:|| ��}|�� W d � S 1 s.0 Y nRz6|| ��}|�� W d � W S 1 sd0 Y W n ttfy� | Y S 0 dS )z�Read entire file content and return it as a string. File is
opened in text mode. If specified, `fallback` is the value
returned in case of error, either if the file does not exist or
it can't be read().
N)�_DEFAULT�read�IOErrorr� )r; �fallback�_open�fro ro rp rU @ s
(
,rU c C s t | |td�S )z,Same as above but opens file in binary mode.)rE rF )rU rT )r; rE ro ro rp rV Q s rV �%(value).1f%(symbol)sc C s� d}i }t |dd� �D ] \}}d|d d > ||< qt|dd� �D ]2}t| �|| krFt| �|| }|t� S qF|t|d | d� S )z�Used by various scripts. See: http://goo.gl/zeJZl.
>>> bytes2human(10000)
'9.8K'
>>> bytes2human(100001221)
'95.4M'
) �B�K�M�G�T�P�E�Z�Yrj N�
r )�symbolr� )� enumerate�reversed�absr� �locals�dict)�n�format�symbols�prefixr0 �srS r� ro ro rp rW V s rW c C s t jd jS )z+Return updated psutil.PROCFS_PATH constant.r� )�sys�modulesZ PROCFS_PATHro ro ro rp �get_procfs_pathi s r` c C s | j ttd�S )N)r< r= )�decoder3 r4 �r] ro ro rp ra p s ra c C s | S r� ro rb ro ro rp ra u s c C s^ t jdkrdS z2dd l}| �� s$J �|�� |�d�dks>J �W n tyT Y dS 0 dS d S )Nr^ Tr �colorsF)r� r� �curses�isattyZ setuptermZtigetnumr� )�filerd ro ro rp r[ ~ s
r[ Fc C s� t � s
| S g }tddddddddd d
� }d |d < z || }W n& tyb td
t|�� � ��Y n0 |�|� |r||�d� dd�|�| f S )z*Return an highlighted version of 'string'.Z34Z33Z30Z32Z37Z36Z91Z35Z93) �blue�brownZdarkgrey�greenZgreyZ lightblue�redZviolet�yellowZ29Nz#invalid color %r; choose between %s�1z [%sm%s[0m�;)r[ rX r� r �listr& r- r� )r] �color�bold�attrrc ro ro rp rZ � s2 � �
rZ c C s
t � st| |d� n�tr.tt| ||�|d� n�ddl}d}|jjj}|jjj}t ddddd�}||d< z || }W n* t
y� t d |t |�
� �f ��Y n0 |r�|dkr�|d
7 }|tju r�d nd } |j|_|| �}
||
|� zt| |d� W ||
|� n ||
|� 0 dS )
z$Print a colorized version of string.�rf r N� ri � � )ri rj rh rk z#invalid color %r; choose between %r� i�i����)r[ �printr rZ �ctypes�windllZKernel32� GetStdHandle�SetConsoleTextAttributerX r� r rn r& r^ �stderr�c_ulong�restype) r] ro rp rf rx Z
DEFAULT_COLORrz r{ rc Z handle_id�handlero ro rp r\ � s8
� ��
r\ c C sn t rjddl}|�|�� j�\}}}}}t| t�rRt| ttt f�rJd| } nd| } t
d||| f t j d� dS )z@If PSUTIL_DEBUG env var is set, print a debug message to stderr.r Nz ignoring %sz ignoring %rzpsutil-debug [%s:%s]> %srr )
r �inspect� getframeinfo� currentframe�f_back�
isinstancer� r� rD �EnvironmentErrorrw r^ r| )r� r� r; �lineno�_�_lines�_indexro ro rp rY � s �
�rY )N)N)rH )NF)�r� �
__future__r r r� r� r� r� r� r� r� r^ r r r r r r r � ImportErrorr � version_infor> r �bool�getenvr �objectrB �__all__r� r r �platform�
startswithr r r r r r r
r ZAIXr) r* r& r+ r- r1 r% r/ r0 r' r( r. r, r2 r r r r r r! r r r r r r r" r# r$ �IntEnumrk �globals�update� __members__rt ru rs �getfilesystemencodingr3 r4 �getfilesystemencodeerrorsr� rF rB r@ rA rC rG r> rD rE r? r� r� r� r� r6 r; r< r= r8 r9 r: r7 r5 r� rH r� r� r� r� r� r� r� � __builtins__rX �exec_r� r� rN rK r� rJ rM rO rL rP rQ rX rI r rR r5 r� r4 r: rT rS rU rV rW r` ra �stdoutr[ rZ r\ rY ro ro ro rp �<module> sp
&
�������
�
�
#
-G
W
�
'PK ok\]2�مG �G * psutil/__pycache__/_pssunos.cpython-39.pycnu �[��� a
��?h�c � @ s6 d Z ddlZddlZddlZddlZddlZddlZddlmZ ddlm Z ddl
m Z ddl
m Z ddl
m
Z dd l
mZ dd
l mZ dd l mZ dd l mZ dd
l mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl m Z ddl m Z ddl m Z ddl m Z ddl m!Z! g d�Z"e�#� Z$ej%Z%ej&dkZ'd Z(d Z)ej*e j+ej,e j-ej.e j/ej0e j1ej2e j3ej4e j-ej5e j6iZ7ej8e j9ej:e j;ej<e j=ej>e j?ej@e jAejBe jCejDe jEejFe jGejHe jIejJe jKejLe jMejNe jOejPe(ejQe)iZReSddd d d d!d"d#d$d%d&d'd(� ZTed)g d*��ZUed+g d,��ZVed-g d.��ZWed/d0d1g�ZXeXZYed2g d3��ZZed4d5d6�[eZj\� �Z]d7d8� Z^d9d:� Z_d;d<� Z`d=d>� Zad?d@� ZbdAdB� ZcdCdD� ZdejeZee jfZfdYdFdG�ZgejhZhejiZidZdIdJ�ZjdKdL� ZkdMdN� ZldOdP� ZmdQdR� ZndSdT� ZodUdV� ZpG dWdX� dX�ZqdS )[z'Sun OS Solaris platform implementation.� N)�
namedtuple)�AF_INET� )�_common)�_psposix)�
_psutil_posix)�
_psutil_sunos)�AF_INET6)� AccessDenied)�
NoSuchProcess)�
ZombieProcess)�debug)�get_procfs_path)�
isfile_strict)�memoize_when_activated)�sockfam_to_enum)�socktype_to_enum)�
usage_percent)�PY3)�FileNotFoundError)�PermissionError)�ProcessLookupError)�b)� CONN_IDLE�
CONN_BOUNDZ PROCFS_PATHl ZIDLEZBOUND� � � � � � � � �
� ) �ppid�rss�vms� create_time�nice� num_threads�status�ttynr�uid�euid�gid�egid� scputimes)�user�system�idleZiowait� pcputimes)r2 r3 �
children_user�children_system�svmem)�total� available�percent�used�free�pmemr& r' �
pmmap_grouped)�pathr& Z anonymous�locked� pmmap_extz addr perms � c C sF t �d�t } t �d�t }}| | }t|| dd�}t| ||||�S )z Report virtual memory metrics.�
SC_PHYS_PAGES�SC_AVPHYS_PAGESr �Zround_)�os�sysconf� PAGE_SIZEr r8 )r9 r= Zavailr< r; � rJ �;/usr/local/lib64/python3.9/site-packages/psutil/_pssunos.py�virtual_memory s
rL c C s t �� \} }tjddtjd ddgtjd�}|�� \}}trL|� t
j j �}|j
dkrdtd|j
��|�� �d �d
d � }|s�d }t|��d }}|D ]D} | �� } | d
d� \}
} |tt|
�d �7 }|tt| �d �7 }q�|| } t| |d
d�}
t�|| ||
| t |t �S )zReport swap memory metrics.z /usr/bin/envzPATH=/usr/sbin:/sbin:%s�PATHZswapz-l)�stdoutr z 'swap -l' failed (retcode=%s)�
r Nz no swap device(s) configuredr r i rF )�cextZswap_mem�
subprocess�PopenrG �environ�PIPE� communicater �decode�sysrN �encoding�
returncode� RuntimeError�strip�split�intr r ZsswaprI )�sinZsout�prN �_�lines�msgr9 r= �line�t�fr< r; rJ rJ rK � swap_memory� s: ��
�rf c C s t �� } tdd� t| � D �� S )z.Return system-wide CPU times as a named tuple.c S s g | ] }t |��qS rJ )�sum��.0�xrJ rJ rK �
<listcomp>� � z cpu_times.<locals>.<listcomp>)rP �
per_cpu_timesr1 �zip��retrJ rJ rK � cpu_times� s rq c C s t �� } dd� | D �S )z6Return system per-CPU times as a list of named tuples.c S s g | ] }t |� �qS rJ )r1 rh rJ rJ rK rk � rl z!per_cpu_times.<locals>.<listcomp>)rP rm ro rJ rJ rK rm � s rm c C s& z t �d�W S ty Y dS 0 dS )z0Return the number of logical CPUs in the system.�SC_NPROCESSORS_ONLNN)rG rH �
ValueErrorrJ rJ rJ rK �cpu_count_logical� s rt c C s t �� S )z-Return the number of CPU cores in the system.)rP �cpu_count_coresrJ rJ rJ rK ru � s ru c C s$ t �� \} }}}d}t�| |||�S )z*Return various CPU stats as a named tuple.r )rP � cpu_statsr Z scpustats)Z ctx_switchesZ
interruptsZsyscallsZ_trapsZsoft_interruptsrJ rJ rK rv � s
�rv Fc
C s� g }t �� }|D ]�}|\}}}}|dkr,d}| s�zt|�js@W qW n@ ty� } z(td||f � W Y d}~qW Y d}~n
d}~0 0 t�||||�} |�| � q|S )z Return system disk partitions.�none� zskipping %r: %sN) rP �disk_partitions�
disk_usager9 �OSErrorr
r Z sdiskpart�append)
�all�retlistZ
partitions� partitionZdeviceZ
mountpointZfstype�opts�errZntuplerJ rJ rK ry � s
" ry ���c
C s t j�� }|dkr |�dd� | |vrFtd| d�dd� |D ��f ��t j| \}}t�|�}t� }|D ]�}|\}} }
} } }
}| |vr�qh|
|vr�qh| t t
fv r�| r�t j | � } | r�t j | � } t |
}
t
| �} t|
�}
|dkr�t �|| |
| | |
|�}nt �|| |
| | |
�}|�|� qht|�S )z�Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
Only INET sockets are returned (UNIX are not).
r� �unixr z+invalid %r kind argument; choose between %sz, c S s g | ] }t |��qS rJ )�reprrh rJ rJ rK rk rl z#net_connections.<locals>.<listcomp>)r Z conn_tmap�copy�poprs �joinrP �net_connections�setr r �addr� TCP_STATUSESr r Zsconn�pconn�add�list)�kind�_pidZcmapZfamilies�types�rawlistrp �item�fd�fam�type_�laddr�raddrr+ �pid�ntrJ rJ rK r� s>
��
r� c C sT t �� } | �� D ]>\}}|\}}}}ttd�r8t�|�}t�||||d�| |< q| S )z)Get NIC stats (isup, duplex, speed, mtu).� NicDuplexrx )rP � net_if_stats�items�hasattrr r� Z snicstats)rp �namer� ZisupZduplex�speedZmturJ rJ rK r� . s
r� c C s t �� S )z:The system boot time expressed in seconds since the epoch.)rP � boot_timerJ rJ rJ rK r� > s r� c C s\ g } t �� }d}|D ]B}|\}}}}}} |s.q||v r:d}t�||||| �}
| �|
� q| S )z:Return currently connected users as a list of namedtuples.)z:0.0z:0� localhost)rP �usersr Zsuserr| ) r~ r� r� r� r2 �tty�hostnameZtstampZ user_processr� r� rJ rJ rK r� C s r� c C s dd� t �tt� ��D �S )z7Returns a list of PIDs currently running on the system.c S s g | ]}|� � rt|��qS rJ )�isdigitr] rh rJ rJ rK rk ] rl zpids.<locals>.<listcomp>)rG �listdirr r rJ rJ rJ rK �pids[ s r� c C s
t �| �S )z&Check for the existence of a unix pid.)r �
pid_exists)r� rJ rJ rK r� ` s r� c s t �� �� fdd��}|S )z�Call callable into a try/except clause and translate ENOENT,
EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
c s� z� | g|�R i |��W S t tfyZ t| j�sDt| j| j��nt| j| j| j��Y nX tyx t | j| j��Y n: t
y� | jdkr�dt � v r�t | j| j��n� � Y n0 d S �Nr ) r r r� r� r �_namer �_ppidr r
r{ r� )�self�args�kwargs��funrJ rK �wrapperj s
z wrap_exceptions.<locals>.wrapper)� functools�wraps)r� r� rJ r� rK �wrap_exceptionse s r� c @ s� e Zd ZdZg d�Zdd� Zdd� Zdd� Zd d
� Ze e
d d � ��Z e e
d
d� ��Z e e
dd� ��Z
e dd� �Ze dd� �Ze dd� �Ze dd� �Ze dd� �Ze dd � �Ze d d � �Ze d d � �Ze d!d"� �Ze d#d$� �Ze d%d&� �Ze d'd(� �Ze d)d*� �Ze d+d,� �Ze d-d.� �Z e d/d0� �Z e Z e d1d2� �Z e d3d4� �Z e d5d6� �Z!d7d8� Z"e dHd:d;��Z#e$d<d=�Z%e$d<d>�Z&e d?d@� �Z'e dAdB� �Z(e dCdD� �Z)e dIdFdG��Z*dES )J�Processz1Wrapper class around underlying C implementation.)�_cacher� r� � _procfs_pathr� c C s || _ d | _d | _t� | _d S �N)r� r� r� r r� )r� r� rJ rJ rK �__init__� s zProcess.__init__c C s t �d| j| jf � dS )z+Raise NSP if the process disappeared on us.�%s/%sN)rG �statr� r� �r� rJ rJ rK �
_assert_alive� s zProcess._assert_alivec C s( | j �| � | j�| � | j�| � d S r� )�_proc_name_and_argsZcache_activate�_proc_basic_info�
_proc_credr� rJ rJ rK �
oneshot_enter� s zProcess.oneshot_enterc C s( | j �| � | j�| � | j�| � d S r� )r� Zcache_deactivater� r� r� rJ rJ rK � oneshot_exit� s zProcess.oneshot_exitc C s t �| j| j�S r� )rP Zproc_name_and_argsr� r� r� rJ rJ rK r� � s zProcess._proc_name_and_argsc C sT | j dkr,tj�d| j| j f �s,t| j ��t�| j | j�}t|�tt �ksPJ �|S )Nr z %s/%s/psinfo)
r� rG r@ �existsr� r
rP Zproc_basic_info�len�
proc_info_map)r� rp rJ rJ rK r� � s �
zProcess._proc_basic_infoc C s t �| j| j�S r� )rP Z proc_credr� r� r� rJ rJ rK r� � s zProcess._proc_credc C s | � � d S r� )r� r� rJ rJ rK r� � s z Process.namec C s8 zt �d| j| jf �W S ty* Y n0 | �� dS )Nz%s/%s/path/a.outrx )rG �readlinkr� r� r{ �cmdliner� rJ rJ rK �exe� s � z Process.exec C s | � � d �d�S )Nr rC )r� r\ r� rJ rJ rK r� � s zProcess.cmdlinec C s t �| j| j�S r� )rP Z proc_environr� r� r� rJ rJ rK rS � s zProcess.environc C s | � � td S )Nr( �r� r� r� rJ rJ rK r( � s zProcess.create_timec C s | � � td S )Nr* r� r� rJ rJ rK r* � s zProcess.num_threadsc C s | � � td S )Nr) r� r� rJ rJ rK �nice_get� s zProcess.nice_getc C s& | j dv rt| j | j��t�| j |�S )N)r r )r� r
r� �
cext_posix� setpriority)r� �valuerJ rJ rK �nice_set� s
zProcess.nice_setc C s | � � td | _| jS )Nr% )r� r� r� r� rJ rJ rK r% � s z Process.ppidc C s^ z| � � \}}}}}}W n6 tyN | �� td }| �� td }d }Y n0 t�|||�S )Nr- r. �r� r
r� r� r Zpuids)r� �real� effective�savedr` rJ rJ rK �uids� s
z Process.uidsc C s^ z| � � \}}}}}}W n6 tyN | �� td }| �� td }d }Y n0 t�|||�S )Nr/ r0 r� )r� r` r� r� r� rJ rJ rK �gids� s
z Process.gidsc
C s\ zt �| j| j�}W n< tyP } z$|jtjkr:ts:d}n� W Y d }~n
d }~0 0 tj |� S )N)� r� r� r� )
rP Zproc_cpu_timesr� r� r{ �errno� EOVERFLOW� IS_64_BITr r5 )r� �timesr� rJ rJ rK rq s zProcess.cpu_timesc C s t �| j| j�S r� )rP Z proc_cpu_numr� r� r� rJ rJ rK �cpu_num s zProcess.cpu_numc C sz | j }d}t| �� td �}|tjkrjdD ]<}z t�d|| j|f �W S t yf d}Y q,Y q,0 q,|rv| �
� d S )NFr, )r r r � z
%s/%d/path/%dT) r� r� r� r� rP ZPRNODEVrG r� r� r r� )r� � procfs_path�
hit_enoentr� rj rJ rJ rK �terminal s
�
zProcess.terminalc C sJ | j }zt�d|| jf �W S tyD t�d|| jf � Y dS 0 d S )Nz%s/%s/path/cwdr� rx )r� rG r� r� r r� )r� r� rJ rJ rK �cwd' s z Process.cwdc C s2 | � � }|td d }|td d }t||�S )Nr& i r' )r� r� r> )r� rp r& r' rJ rJ rK � memory_info4 s zProcess.memory_infoc C s | � � td }t�|d�S )Nr+ �?)r� r� �
PROC_STATUSES�get)r� �coderJ rJ rK r+ = s zProcess.statusc
C s� | j }g }t�d|| jf �}d}|D ]�}t|�}zt�| j||�\}}W n^ ty� } zF|jtj krvt
svW Y d }~q&|jtj kr�d}W Y d }~q&� W Y d }~q&d }~0 0 t �
|||�} |�| � q&|r�| �� |S )Nz %s/%d/lwpFT)r� rG r� r� r] rP Zquery_process_thread�EnvironmentErrorr� r� r� �ENOENTr Zpthreadr| r� )
r� r� rp Ztidsr� �tid�utimeZstimer� r� rJ rJ rK �threadsC s, � zProcess.threadsc C s� g }d}| j }d|| jf }t�d|| jf �D ]f}tj�||�}tj�|�r0zt�|�}W n tyv d}Y q0Y q00 t |�r0|�
t � |t
|��� q0|r�| �� |S )NFz
%s/%d/pathz%s/%d/fdT)r� r� rG r� r@ r� �islinkr� r r r| r Z popenfiler] r� )r� r~ r� r� Zpathdirr� r@ �filerJ rJ rK �
open_filese s"
zProcess.open_filesc c s* dt |�g}tj|tjtjd�}|�� \}}trFdd� ||fD �\}}|jdkr�d|�� v rjt| j | j
��d|�� v r�t | j | j
��t d||f ��|�
d �d
d � }t|�D ]v\}}|�� }|�d �r�|�
d
d
�d
} ||d
�� }
|
dkr�tj}
n|
dk�r
tj}
nd}
dtj|
| dtjfV q�d S )z<Get UNIX sockets used by process by parsing 'pfiles' output.Zpfiles)rN �stderrc s s | ]}|� tjj�V qd S r� )rV rW rN rX rh rJ rJ rK � <genexpr>� s z,Process._get_unix_sockets.<locals>.<genexpr>r zpermission deniedzno such processz%r command error
%srO r Nzsockname: AF_UNIXrC � SOCK_STREAM�
SOCK_DGRAMr� rx )�strrQ rR rT rU r rY �lowerr
r� r� r rZ r\ � enumerate�lstrip�
startswithr[ �socketr� r� �AF_UNIXr � CONN_NONE) r� r� �cmdr_ rN r� ra �irc r@ �typerJ rJ rK �_get_unix_socketsz s6
� �
zProcess._get_unix_sockets�inetc C sP t || jd�}|s(t�d| j| jf � |dv rL|�dd� | �| j�D �� |S )N)r� r� )r} r� c S s g | ]}t j|� �qS rJ )r r� )ri �connrJ rJ rK rk � s �z+Process.net_connections.<locals>.<listcomp>)r� r� rG r� r� �extendr� )r� r� rp rJ rJ rK r� � s
�zProcess.net_connectionsZmmapzpath rss anon lockedz addr perms path rss anon lockedc C s0 dd� }| j }g }zt�| j|�}W nF tyj } z.|jtjkrTtsTg W Y d }~S � W Y d }~n
d }~0 0 d}|D ]�}|\}} }
} } }
}||| �}| �d��szt �
d|| j| f �} W nJ t�y } z0|jtj kr�d|| j| f } d}n� W Y d }~n
d }~0 0 |� ||
| | |
|f� qt|�r,| �
� |S )Nc S s0 dt | �dd � �d�t |�dd � �d�f S )Nz%s-%sr �L)�hexr[ )�start�endrJ rJ rK �toaddr� s �z#Process.memory_maps.<locals>.toaddrF�[z
%s/%s/path/%sT)r� rP Zproc_memory_mapsr� r{ r� r� r� r� rG r� r� r| r� )r� r r� r~ r� r� r� r� r� Zaddrsize�permr� r& ZanonrA rJ rJ rK � memory_maps� s6
� zProcess.memory_mapsc C s t t�d| j| jf ��S )Nz%s/%s/fd)r� rG r� r� r� r� rJ rJ rK �num_fds� s zProcess.num_fdsc C s t jt�| j| j�� S r� )r ZpctxswrP Zproc_num_ctx_switchesr� r� r� rJ rJ rK �num_ctx_switches� s �zProcess.num_ctx_switchesNc C s t �| j|| j�S r� )r Zwait_pidr� r� )r� �timeoutrJ rJ rK �wait� s z Process.wait)r� )N)+�__name__�
__module__� __qualname__�__doc__� __slots__r� r� r� r� r� r r� r� r� r� r� r� rS r( r* r� r� r% r� r� rq r� r� r� r� Zmemory_full_infor+ r� r� r� r� r Znt_mmap_groupedZ nt_mmap_extr r r
r rJ rJ rJ rK r� � s�
!
"
1
r� )F)r� )rr r� r� rG r� rQ rW � collectionsr r rx r r r r� r rP r r
r r r
r r r r r r Z_compatr r r r r Z__extra__all__Z getpagesizerI ZAF_LINK�maxsizer� r r ZSSLEEPZSTATUS_SLEEPINGZSRUNZSTATUS_RUNNINGZSZOMBZ
STATUS_ZOMBIEZSSTOPZSTATUS_STOPPEDZSIDLZ STATUS_IDLEZSONPROCZSWAITZSTATUS_WAITINGr� ZTCPS_ESTABLISHEDZCONN_ESTABLISHEDZ
TCPS_SYN_SENTZ
CONN_SYN_SENTZ
TCPS_SYN_RCVDZ
CONN_SYN_RECVZTCPS_FIN_WAIT_1ZCONN_FIN_WAIT1ZTCPS_FIN_WAIT_2ZCONN_FIN_WAIT2ZTCPS_TIME_WAITZCONN_TIME_WAITZ TCPS_CLOSEDZ
CONN_CLOSEZTCPS_CLOSE_WAITZCONN_CLOSE_WAITZ
TCPS_LAST_ACKZ
CONN_LAST_ACKZ TCPS_LISTENZ CONN_LISTENZ TCPS_CLOSINGZ CONN_CLOSINGZPSUTIL_CONN_NONEr� Z TCPS_IDLEZ
TCPS_BOUNDr� �dictr� r1 r5 r8 r> Zpfullmemr? r� �_fieldsrB rL rf rq rm rt ru rv Zdisk_io_countersrz ry Znet_io_countersZ net_if_addrsr� r� r� r� r� r� r� r� rJ rJ rJ rK �<module> s�
� �����
.
' PK ok\1}:p�; �; ( psutil/__pycache__/_psaix.cpython-39.pycnu �[��� a
��?h�H � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m
Z
ddl m Z ddl m Z
ddl mZ dd l
mZ dd
l
mZ dd l
mZ dd l
mZ dd
l
mZ ddl
mZ ddl
mZ ddl
mZ ddl
mZ ddl
mZ ddlmZ ddlm Z ddlm Z ddlm Z dgZ e e
d�Z!e e
d�Z"e e
d�Z#e�$� Z%ej&Z&e
j'e
j(e
j)e
j*e
j+e
j,e
j-e
j,e
j.e
j/iZ0e
j1e
j2e
j3e
j4e
j5e
j6e
j7e
j8e
j9e
j:e
j;e
j<e
j=e
j>e
j?e
j@e
jAe
jBe
jCe
jDe
jEe
jFe
jGe
jHi ZIeJdddd d d d d d!�ZKed"d#d$g�ZLeLZMed%g d&��ZNed'g d(��ZOd)d*� ZPd+d,� ZQd-d.� ZRd/d0� ZSd1d2� ZTd3d4� ZUd5d6� ZVe
jWZWe jXZXdKd8d9�ZYejZZZe"�r�e
j[Z[dLd;d<�Z\d=d>� Z]d?d@� Z^dAdB� Z_dCdD� Z`dEdF� ZadGdH� ZbG dIdJ� dJ�ZcdS )Mz AIX platform implementation.� N)�
namedtuple� )�_common)�_psposix)� _psutil_aix)�
_psutil_posix)�NIC_DUPLEX_FULL)�NIC_DUPLEX_HALF)�NIC_DUPLEX_UNKNOWN)� AccessDenied)�
NoSuchProcess)�
ZombieProcess)�conn_to_ntuple)�get_procfs_path)�memoize_when_activated)�
usage_percent)�PY3)�FileNotFoundError)�PermissionError)�ProcessLookupErrorZ PROCFS_PATH� proc_threads�net_io_counters�proc_io_counters� � � � � � )�ppid�rss�vms� create_time�nice� num_threads�status�ttynr�pmemr r! � scputimes)�user�system�idleZiowait�svmem)�total� available�percent�used�freec C s4 t �� \} }}}}t| | | dd�}t| ||||�S )Nr �Zround_)�cextZ virtual_memr r, )r- Zavailr1 Z_pinnedZinuser/ � r4 �9/usr/local/lib64/python3.9/site-packages/psutil/_psaix.py�virtual_memoryk s r6 c C s: t �� \} }}}| | }t|| dd�}t�| |||||�S )z=Swap system memory as a (total, used, free, sin, sout) tuple.r r2 )r3 Zswap_memr r Zsswap)r- r1 �sinZsoutr0 r/ r4 r4 r5 � swap_memoryq s r8 c C s t �� } tdd� t| � D �� S )z.Return system-wide CPU times as a named tuple.c S s g | ] }t |��qS r4 )�sum��.0�xr4 r4 r5 �
<listcomp>� � z cpu_times.<locals>.<listcomp>)r3 �
per_cpu_timesr( �zip��retr4 r4 r5 � cpu_times~ s rC c C s t �� } dd� | D �S )z6Return system per-CPU times as a list of named tuples.c S s g | ] }t |� �qS r4 )r( r: r4 r4 r5 r= � r> z!per_cpu_times.<locals>.<listcomp>)r3 r? rA r4 r4 r5 r? � s r? c C s& z t �d�W S ty Y dS 0 dS )z0Return the number of logical CPUs in the system.�SC_NPROCESSORS_ONLNN)�os�sysconf�
ValueErrorr4 r4 r4 r5 �cpu_count_logical� s rH c C st g d�} t j| t jt jd�}|�� \}}trBdd� ||fD �\}}|jdkr\td| |f ��|�� �� }t |�prd S )N)Zlsdevz-Cc� processor��stdout�stderrc s s | ]}|� tjj�V qd S �N��decode�sysrK �encodingr: r4 r4 r5 � <genexpr>� s z"cpu_count_cores.<locals>.<genexpr>r z%r command error
%s)
�
subprocess�Popen�PIPE� communicater �
returncode� RuntimeError�strip�
splitlines�len)�cmd�prK rL Z
processorsr4 r4 r5 �cpu_count_cores� s �
r^ c C s t �� \} }}}t�| |||�S )z*Return various CPU stats as a named tuple.)r3 � cpu_statsr Z scpustats)Z ctx_switchesZ
interruptsZsoft_interruptsZsyscallsr4 r4 r5 r_ � s �r_ Fc C s\ g }t �� }|D ]F}|\}}}}|dkr,d}| s<t|�js<qt�||||�}|�|� q|S )z Return system disk partitions.�none� )r3 �disk_partitions�
disk_usager- r Z sdiskpart�append) �all�retlistZ
partitions� partitionZdeviceZ
mountpointZfstype�opts�ntupler4 r4 r5 rb � s
rb ���c C s� t j}| |vr.td| d�dd� |D ��f ��t j| \}}t�|�}g }|D ]X}|\}} }
} } }
}| |vrnqN|
|vrxqNt|| |
| | |
t|dkr�|ndd�}|�|� qN|S )z�Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
z+invalid %r kind argument; choose between %sz, c S s g | ] }t |��qS r4 )�reprr: r4 r4 r5 r= � r> z#net_connections.<locals>.<listcomp>rj N��pid) r Z conn_tmaprG �joinr3 �net_connectionsr � TCP_STATUSESrd )�kind�_pidZcmapZfamilies�types�rawlistrB �item�fd�fam�type_�laddr�raddrr% rm �ntr4 r4 r5 ro � s8 ��
�
ro c C s� t td�} tdd� t� D ��}i }|D ]�}t�|�}t�|�}d}d}tjdd|gtj tj d�}|�
� \} }
t r�d d
� | |
fD �\} }
|j dkr�t
�d | �} | d ur�t| �d
��}| �d�}d�|�} d|v }
| �|t�}t�|
|||| �||< q&|S )z)Get NIC stats (isup, duplex, speed, mtu).)�FullZHalfc S s g | ] }|d �qS )r r4 r: r4 r4 r5 r= � r> z net_if_stats.<locals>.<listcomp>ra r z/usr/bin/entstatz-drJ c s s | ]}|� tjj�V qd S rM rN r: r4 r4 r5 rR s z net_if_stats.<locals>.<genexpr>z"Running: (\d+) Mbps.*?(\w+) DuplexNr r �,�running)r r �set� net_if_addrs�
cext_posixZ
net_if_mtuZ net_if_flagsrS rT rU rV r rW �re�search�int�grouprn �getr
r Z snicstats)Z
duplex_map�namesrB �nameZmtu�flagsZduplex�speedr] rK rL Z re_resultZ output_flagsZisupr4 r4 r5 � net_if_stats� s<
� �
�
r� c C s t �� S )z:The system boot time expressed in seconds since the epoch.)r3 � boot_timer4 r4 r4 r5 r� s r� c C s\ g } t �� }d}|D ]B}|\}}}}}} |s.q||v r:d}t�||||| �}
| �|
� q| S )z:Return currently connected users as a list of namedtuples.)z:0.0z:0� localhost)r3 �usersr Zsuserrd ) rf rt r� ru r) �tty�hostnameZtstampZ user_processrm r{ r4 r4 r5 r� $ s r� c C s dd� t �t� �D �S )z7Returns a list of PIDs currently running on the system.c S s g | ]}|� � rt|��qS r4 )�isdigitr� r: r4 r4 r5 r= > r> zpids.<locals>.<listcomp>)rE �listdirr r4 r4 r4 r5 �pids< s r� c C s t j�t j�t� t| �d��S )z&Check for the existence of a unix pid.Zpsinfo)rE �path�existsrn r �strrl r4 r4 r5 �
pid_existsA s r� c s t �� �� fdd��}|S )z�Call callable into a try/except clause and translate ENOENT,
EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
c s~ z� | g|�R i |��W S t tfyZ t| j�sDt| j| j��nt| j| j| j��Y n tyx t | j| j��Y n0 d S rM )
r r r� rm r �_namer
�_ppidr r )�self�args�kwargs��funr4 r5 �wrapperK s
z wrap_exceptions.<locals>.wrapper)� functools�wraps)r� r� r4 r� r5 �wrap_exceptionsF s r� c @ sr e Zd ZdZg d�Zdd� Zdd� Zdd� Zee d d
� ��Z
ee d d � ��Z ed
d� �Z edd� �Z
edd� �Zedd� �Zedd� �Zedd� �Zer�edd� �Zed=d d ��Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zed,d-� �Z ed.d/� �Z e Z ed0d1� �Z d2d3� Z ed4d5� �Z!ed6d7� �Z"ed>d9d:��Z#e$�rned;d<� �Z%d8S )?�Processz1Wrapper class around underlying C implementation.)�_cacher� r� � _procfs_pathrm c C s || _ d | _d | _t� | _d S rM )rm r� r� r r� )r� rm r4 r4 r5 �__init__b s zProcess.__init__c C s | j �| � | j�| � d S rM )�_proc_basic_infoZcache_activate�
_proc_cred�r� r4 r4 r5 �
oneshot_enterh s zProcess.oneshot_enterc C s | j �| � | j�| � d S rM )r� Zcache_deactivater� r� r4 r4 r5 � oneshot_exitl s zProcess.oneshot_exitc C s t �| j| j�S rM )r3 Zproc_basic_inform r� r� r4 r4 r5 r� p s zProcess._proc_basic_infoc C s t �| j| j�S rM )r3 Z proc_credrm r� r� r4 r4 r5 r� u s zProcess._proc_credc C s$ | j dkrdS t�| j | j��d�S )Nr Zswapper� )rm r3 Z proc_namer� �rstripr� r4 r4 r5 r� z s
z Process.namec C s� | � � }|sdS |d }tjj|v r�tj�|�sJtj�tj�| �� |��}tj�|�rttj�|�rtt� |tj
�rt|S tj� |�}tj d �
d�D ]<}tj�tj�||��}tj�|�r�t� |tj
�r�| S q�dS )Nra r �PATH�:)�cmdlinerE r� �sep�isabs�abspathrn �cwd�isfile�access�X_OK�basename�environ�split)r� r� �exer� Z possible_exer4 r4 r5 r� � s,
�
� � �
z Process.exec C s t �| j�S rM )r3 Z proc_argsrm r� r4 r4 r5 r� � s zProcess.cmdlinec C s t �| j�S rM )r3 Z proc_environrm r� r4 r4 r5 r� � s zProcess.environc C s | � � td S )Nr" �r� �
proc_info_mapr� r4 r4 r5 r" � s zProcess.create_timec C s | � � td S )Nr$ r� r� r4 r4 r5 r$ � s zProcess.num_threadsc C sV t �| j�}g }|D ]"\}}}t�|||�}|�|� q|sRt�d| j| jf � |S )N�%s/%s) r3 r rm r Zpthreadrd rE �statr� )r� rt rf � thread_id�utimeZstimeri r4 r4 r5 �threads� s zProcess.threads�inetc C s, t || jd�}|s(t�d| j| jf � |S )N)rr r� )ro rm rE r� r� )r� rq rB r4 r4 r5 ro � s zProcess.net_connectionsc C s t �| j�S rM )r� � getpriorityrm r� r4 r4 r5 �nice_get� s zProcess.nice_getc C s t �| j|�S rM )r� � setpriorityrm )r� �valuer4 r4 r5 �nice_set� s zProcess.nice_setc C s | � � td | _| jS )Nr )r� r� r� r� r4 r4 r5 r � s z Process.ppidc C s" | � � \}}}}}}t�|||�S rM �r� r Zpuids)r� �real� effective�saved�_r4 r4 r5 �uids� s z Process.uidsc C s" | � � \}}}}}}t�|||�S rM r� )r� r� r� r� r� r4 r4 r5 �gids� s z Process.gidsc C s t �| j| j�}tj|� S rM )r3 Zproc_cpu_timesrm r� r Z pcputimes)r� �tr4 r4 r5 rC � s zProcess.cpu_timesc C sP | � � td }|d@ d? |d@ B }t�d�D ] }t�|�j|kr.| S q.d S )Nr& l � � i�� z /dev/**/*)r� r� �globrE r� �st_rdev)r� Zttydev�devr4 r4 r5 �terminal� s
zProcess.terminalc C sT | j }z t�d|| jf �}|�d�W S tyN t�d|| jf � Y dS 0 d S )Nz %s/%s/cwd�/r� ra )r� rE �readlinkrm r� r r� )r� Z procfs_path�resultr4 r4 r5 r� � s z Process.cwdc C s2 | � � }|td d }|td d }t||�S )Nr i r! )r� r� r' )r� rB r r! r4 r4 r5 � memory_info s zProcess.memory_infoc C s | � � td }t�|d�S )Nr% �?)r� r� �
PROC_STATUSESr� )r� �coder4 r4 r5 r% s zProcess.statusc C s� t jddt| j�gt jt jd�}|�� \}}trFdd� ||fD �\}}d|�� v r`t| j| j ��t
� d|�}g }|D ]J\}}|� � }|�
d�r�|d d � }|�� d
kr�qt|�t�|t|��� qt|S ) Nz/usr/bin/procfilesz-nrJ c s s | ]}|� tjj�V qd S rM rN r: r4 r4 r5 rR s z%Process.open_files.<locals>.<genexpr>zno such processz(\d+): S_IFREG.*name:(.*)\nz//r zcannot be retrieved)rS rT r� rm rU rV r �lowerr r� r� �findallrY �
startswithrd r Z popenfiler� )r� r] rK rL Z procfilesrf rv r� r4 r4 r5 �
open_files s, � �
zProcess.open_filesc C s( | j dkrdS tt�d| j| j f ��S )Nr z%s/%s/fd)rm r[ rE r� r� r� r4 r4 r5 �num_fds) s
zProcess.num_fdsc C s t jt�| j�� S rM )r Zpctxswr3 Zproc_num_ctx_switchesrm r� r4 r4 r5 �num_ctx_switches/ s zProcess.num_ctx_switchesNc C s t �| j|| j�S rM )r Zwait_pidrm r� )r� �timeoutr4 r4 r5 �wait3 s z Process.waitc C sV zt �| j�\}}}}W n, tyD t| j�s>t| j| j��� Y n0 t�||||�S rM ) r3 r rm �OSErrorr� r r� r Zpio)r� �rcZwc�rb�wbr4 r4 r5 � io_counters9 s
zProcess.io_counters)r� )N)&�__name__�
__module__� __qualname__�__doc__� __slots__r� r� r� r� r r� r� r� r� r� r� r" r$ � HAS_THREADSr� ro r� r� r r� r� rC r� r� r� Zmemory_full_infor% r� r� r� r� �HAS_PROC_IO_COUNTERSr� r4 r4 r4 r5 r� ] sv
r� )F)rj )dr� r� r� rE r� rS rP � collectionsr ra r r r r3 r r� r r r
r r r
r r r r Z_compatr r r r Z__extra__all__�hasattrr� ZHAS_NET_IO_COUNTERSr� Z getpagesizeZ PAGE_SIZEZAF_LINKZSIDLZ STATUS_IDLEZSZOMBZ
STATUS_ZOMBIEZSACTIVEZSTATUS_RUNNINGZSSWAPZSSTOPZSTATUS_STOPPEDr� ZTCPS_ESTABLISHEDZCONN_ESTABLISHEDZ
TCPS_SYN_SENTZ
CONN_SYN_SENTZ
TCPS_SYN_RCVDZ
CONN_SYN_RECVZTCPS_FIN_WAIT_1ZCONN_FIN_WAIT1ZTCPS_FIN_WAIT_2ZCONN_FIN_WAIT2ZTCPS_TIME_WAITZCONN_TIME_WAITZ TCPS_CLOSEDZ
CONN_CLOSEZTCPS_CLOSE_WAITZCONN_CLOSE_WAITZ
TCPS_LAST_ACKZ
CONN_LAST_ACKZ TCPS_LISTENZ CONN_LISTENZ TCPS_CLOSINGZ CONN_CLOSINGZPSUTIL_CONN_NONEZ CONN_NONErp �dictr� r' Zpfullmemr( r, r6 r8 rC r? rH r^ r_ Zdisk_io_countersrc rb r� r ro r� r� r� r� r� r� r� r4 r4 r4 r5 �<module> s�
� ��
!,PK ok\+����� �� * psutil/__pycache__/_pslinux.cpython-39.pycnu �[��� a
��?hZ �
@ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z ddlm Z ddlm!Z! ddlm"Z" ddlm#Z# ddlm$Z$ ddlm%Z% ddlm&Z& ddlm'Z' dd lm(Z( dd lm)Z) dd lm*Z* dd l+m,Z, dd l+m-Z- dd!l+m.Z. dd"l+m/Z/ dd#l+m0Z0 dd$l+m1Z1 e,�r�ddl2Z2ndZ2g d%�Z3d&Z4ej5�6d'e�7� �Z8ej5�6d(e�7� �Z9e:ed)�Z;e:ed*�Z<e�=d+�Z>e�?� Z@daAe jBd,kZCd-ZDe2du �rze
jEZFn e2�Gd.d/eHe
jE�i�ZIeIjFZFe2du �r�dZJdZKd0ZLd1ZMn G d2d3� d3e2jG�ZNeO� �PeNjQ� ejRejSejTejUejVejWejXejXejYejZej[ej\d4� Z]ej^ej_ej`ejaejbejcejdejeejfejgejhd5� Zied6g d7��Zjed8g d9��Zked:g d;��Zled<d=�Zmed>emjnd? �Zoed@g dA��ZpedBdCdD�qepjn� �ZredEg dF��ZsedGg dH��ZtdIdJ� ZudKdL� ZvdMdN� Zwe#dOdP� �Zxz exdQ� W nD ey�y2 Zz z*e dRez � edSdT�dUdUdU�a{W Y dZz[zn
dZz[z0 0 dZ|zddVl}m|Z| W n@ e~�y� ddlZej�ddWdX�Z�e:e�dY��r�d�dZdY�Z|Y n0 e|du�r�e3��d[d\� e�e�D �� d]d^� Z�d_d`� Z�dadb� Z�dcdd� Z�dedf� Z�dgdh� Z�didj� Z�dkdl� Z�dmdn� Z�ej5�6do��sej5�6dp��rdqdr� Z�ndsdr� Z�ej�Z�G dtdu� duey�Z�G dvdw� dw�Z�e�� Z�d�dydz�Z�d{d|� Z�d}d~� Z�ej�Z�d�d�d��Z�G d�d�� d��Z�d�d�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�G d�d�� d��Z�dS )�z Linux platform implementation.� )�divisionN)� defaultdict)�
namedtuple� )�_common)�_psposix)�
_psutil_linux)�
_psutil_posix)�NIC_DUPLEX_FULL)�NIC_DUPLEX_HALF)�NIC_DUPLEX_UNKNOWN)� AccessDenied)�
NoSuchProcess)�
ZombieProcess)�bcat)�cat)�debug)�decode)�get_procfs_path)�
isfile_strict)�memoize)�memoize_when_activated)� open_binary)� open_text)�parse_environ_block)�path_exists_strict)�
supports_ipv6)�
usage_percent)�PY3)�FileNotFoundError)�PermissionError)�ProcessLookupError)�b)�
basestring)Z PROCFS_PATH�IOPRIO_CLASS_NONE�IOPRIO_CLASS_RT�IOPRIO_CLASS_BE�IOPRIO_CLASS_IDLE�CONN_ESTABLISHED�
CONN_SYN_SENT�
CONN_SYN_RECV�CONN_FIN_WAIT1�CONN_FIN_WAIT2�CONN_TIME_WAIT�
CONN_CLOSE�CONN_CLOSE_WAIT�
CONN_LAST_ACK� CONN_LISTEN� CONN_CLOSINGz/sys/class/power_supplyz/proc/%s/smapsz/proc/%s/smaps_rollup�proc_ioprio_get�proc_cpu_affinity_get�
SC_CLK_TCK�littlei �
AddressFamily�AF_LINK� � c @ s e Zd ZdZdZdZdZdS )�
IOPriorityr r r9 r: N)�__name__�
__module__� __qualname__r$ r% r& r' � r? r? �;/usr/local/lib64/python3.9/site-packages/psutil/_pslinux.pyr; y s r; ) �R�S�D�T�t�Z�X�x�K�W�I�P) Z01�02Z03Z04Z05Z06Z07Z08Z09Z0AZ0B�svmem) �total� available�percent�used�free�active�inactive�buffers�cached�shared�slab�sdiskio) �
read_count� write_count�
read_bytes� write_bytesZ read_timeZ
write_timeZread_merged_countZwrite_merged_count� busy_time� popenfile)�path�fd�position�mode�flags�pmemz"rss vms shared text lib data dirty�pfullmem)�uss�pss�swap�
pmmap_grouped) ra �rss�sizeri Z shared_cleanZ shared_dirtyZ
private_cleanZ
private_dirtyZ
referencedZ anonymousrj � pmmap_extz addr perms � �pio)r[ r\ r] r^ Z
read_charsZ write_chars� pcputimes)�user�system�
children_user�children_system�iowaitc C sL t | t�sJ | ��t�| �} | �d�d } | �d�rHt| �sH| dd� } | S )z Wrapper around os.readlink().� r �
(deleted)N���)�
isinstancer# �os�readlink�split�endswithr )ra r? r? r@ r| � s
r| c C sX t jdt jdt jdi}|| t jt jB t jB @ }| t j@ rH|�ddd�}|�dd�}|S )zZConvert file's open() flags into a readable string.
Used by Process.open_files().
�r�wzw+�ar zr+)r{ �O_RDONLY�O_WRONLY�O_RDWR�O_APPEND�replace)re Z modes_maprd r? r? r@ �file_flags_to_mode� s
r� c C s4 | � dd�} d}|r d| }nd| }t�|tj�S )z�Return True if the given name refers to a root device (e.g.
"sda", "nvme0n1") as opposed to a logical partition (e.g. "sda1",
"nvme0n1p1"). If name is a virtual device (e.g. "loop1", "ram")
return True.
�/�!Tz
/sys/block/%sz/sys/block/%s/device)r� r{ �access�F_OK)�nameZincluding_virtualra r? r? r@ �is_storage_device� s
r� c C s� t d| ��$}|�� �� dd� }W d � n1 s60 Y g d�}t|�}|dkrb|�d� |dkrt|�d� |d kr�|�d
� td |�adS ) z�Set a namedtuple of variable fields depending on the CPU times
available on this Linux kernel version which may be:
(user, nice, system, idle, iowait, irq, softirq, [steal, [guest,
[guest_nice]]])
Used by cpu_times() function.
�%s/statr N)rr �nicers �idlerv ZirqZsoftirq� Zsteal� Zguest�
Z
guest_nice� scputimes)r �readliner} �len�appendr r� )� procfs_path�f�values�fieldsZvlenr? r? r@ �set_scputimes_ntuple s 2
r� �/procz ignoring exception on import: %rr� zuser system idle� )�prlimitT)� use_errnor� c C s� G dd� dt j�}|� }|d u r8t�| |d t �|��}n6|� }|d |_|d |_t�| |t �|�t �|��}|dkr�t �� }t|t �
|���|j|jfS )Nc @ s e Zd ZdejfdejfgZdS )z prlimit.<locals>.StructRlimit�rlim_cur�rlim_maxN)r< r= r> �ctypes�
c_longlong�_fields_r? r? r? r@ � StructRlimit> s �r� r r ) r� � Structure�libcr� �byrefr� r� � get_errno�OSErrorr{ �strerror)�pid� resource_�limitsr� �current�ret�newZerrno_r? r? r@ r� = s
�c C s" g | ]}|� d �r|�� r|�qS )ZRLIM)�
startswith�isupper��.0rH r? r? r@ �
<listcomp>Y � r� c
C sB | d }|| � dd� }z | d }| d }| d }W n: tyn } z"td|jd � |W Y d}~S d}~0 0 ztd t� �}W n ty� | Y S 0 d}|�@ |D ]*} | �� } | �d
�r�|t | �
� d �7 }q�W d � n1 s�0 Y |t 9 }|| }
|| } | t | d |�8 } |
| 7 }
|
|t |d
|� 7 }
t |
�S )ay Fallback for kernels < 3.14 where /proc/meminfo does not provide
"MemAvailable", see:
https://blog.famzah.net/2014/09/24/.
This code reimplements the algorithm outlined here:
https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/
commit/?id=34e431b0ae398fc54ea69ff85ec700722c9da773
We use this function also when "MemAvailable" returns 0 (possibly a
kernel bug, see: https://github.com/giampaolo/psutil/issues/1915).
In that case this routine matches "free" CLI tool result ("available"
column).
XXX: on recent kernels this calculation may differ by ~1.5% compared
to "MemAvailable:", as it's calculated slightly differently.
It is still way more realistic than doing (free + cached) though.
See:
* https://gitlab.com/procps-ng/procps/issues/42
* https://github.com/famzah/linux-memavailable-procfs/issues/2
� MemFree:� Cached:r s
Active(file):s Inactive(file):�
SReclaimable:zY%s is missing from /proc/meminfo; using an approximation for calculating available memoryNz %s/zoneinfos lowr r9 g @)
�get�KeyErrorr �argsr r �IOError�stripr� �intr} �PAGESIZE�min) �memsrS �fallbackZlru_active_fileZlru_inactive_fileZslab_reclaimable�errr� Z
watermark_low�line�availZ pagecacher? r? r@ �calculate_avail_vmemb s< ��
4r� c C s� g } i }t dt� ��:}|D ]$}|�� }t|d �d ||d < q W d � n1 sV0 Y |d }|d }z |d }W n ty� d}| �d � Y n0 z |d
}W n ty� d}| �d � Y n0 ||�d d�7 }z |d
} W nD t�y, z |d } W n" t�y& d} | �d� Y n0 Y n0 z |d }
W n" t�y\ d}
| �d� Y n0 z |d } W nT t�y� z |d |d |d } W n" t�y� d} | �d� Y n0 Y n0 z |d } W n t�y� d} Y n0 || | | }
|
dk �r|| }
z |d }W n t�y0 t|�}Y n0 |dk�rDt|�}|dk �r^d}| �d� n||k�rl|}t|| |dd�}| �r�dd � | �t
| �dk�r�d nd f }t j |t
d d � t||||
||
| ||| | � S )!a7 Report virtual memory stats.
This implementation mimics procps-ng-3.3.12, aka "free" CLI tool:
https://gitlab.com/procps-ng/procps/blob/
24fd2605c51fccc375ab0287cec33aa767f06718/proc/sysinfo.c#L778-791
The returned values are supposed to match both "free" and "vmstat -s"
CLI tools.
�
%s/meminfor � r Ns MemTotal:r� s Buffers:rV r� rW r� s Shmem:s
MemShared:rX s Active:rT s Inactive:s Inact_dirty:s Inact_clean:s Inact_laundry:rU s Slab:s
MemAvailable:rP �Zround_z6%s memory stats couldn't be determined and %s set to 0�, �was�werer9 ��
stacklevel)r r r} r� r� r� r� r� r �joinr� �warnings�warn�RuntimeWarningrN )Zmissing_fieldsr� r� r� r� rO rS rV rW rX rT rU rY rR r� rQ �msgr? r? r@ �virtual_memory� s� 8 ���
��r� c
C s� i } t dt� ��:}|D ]$}|�� }t|d �d | |d < qW d � n1 sR0 Y z| d }| d }W n8 ty� t�� \}}}}}}}||9 }||9 }Y n0 || }t||dd�} zt d t� �}W nN t�y }
z4d
d t |
� } t
j | t d d
� d } }
W Y d}
~
n�d}
~
0 0 |�� d } }
|D ]n}|�
d��r`t|�d�d �d d } n&|�
d��r�t|�d�d �d d }
| du�r4|
du�r4 �qȐq4d
} | d7 } t
j | t d d
� d } }
W d � n1 �s�0 Y t�|||| | |
�S )zReturn swap memory metrics.r� r r� r Ns
SwapTotal:s SwapFree:r� z %s/vmstatz,'sin' and 'sout' swap memory stats couldn't z$be determined and were set to 0 (%s)r9 r� s pswpin� � s pswpoutz be determined and were set to 0)r r r} r� r� �cextZ
linux_sysinfor r� �strr� r� r� r� r Zsswap)r� r� r� r� rO rS �_Zunit_multiplierrR rQ r� r� �sinZsoutr? r? r@ � swap_memory' sJ 8
��
(r� c C sr t � } t| � td| �� }|�� �� }W d � n1 s<0 Y |dttj�d � }dd� |D �}t|� S )z�Return a named tuple representing the following system-wide
CPU times:
(user, nice, system, idle, iowait, irq, softirq [steal, [guest,
[guest_nice]]])
Last 3 fields may not be available on all Linux kernel versions.
r� Nr c S s g | ]}t |�t �qS r? ��float� CLOCK_TICKSr� r? r? r@ r� o r� z cpu_times.<locals>.<listcomp>)r r� r r� r} r� r� �_fields)r� r� r� r� r? r? r@ � cpu_timesc s *r� c C s� t � } t| � g }td| ��n}|�� |D ]L}|�d�r,|�� }|dttj�d � }dd� |D �}t|� }|� |� q,|W d � S 1 s�0 Y dS )zfReturn a list of namedtuple representing the CPU times
for every CPU available on the system.
r� s cpur c S s g | ]}t |�t �qS r? r� r� r? r? r@ r� � r� z!per_cpu_times.<locals>.<listcomp>N)
r r� r r� r� r} r� r� r� r� )r� �cpusr� r� r� r� �entryr? r? r@ �
per_cpu_timess s
r� c C s� z t �d�W S ty� d} tdt� ��0}|D ]}|�� �d�r2| d7 } q2W d � n1 sb0 Y | dkr�t�d�}t dt� ��:}|D ]$}|�
d �d }|� |�r�| d7 } q�W d � n1 s�0 Y | dkr�Y dS | Y S 0 dS )
z0Return the number of logical CPUs in the system.�SC_NPROCESSORS_ONLNr �
%s/cpuinfos processorr Nzcpu\dr� ro ) r{ �sysconf�
ValueErrorr r �lowerr� �re�compiler r} �match)�numr� r� �searchr? r? r@ �cpu_count_logical� s$ (
(r� c
C s2 t � } d}d}t�|�p t�|�D ]>}t|��"}| �|�� �� � W d � q"1 sV0 Y q"t| �}|dkrv|S i }i }tdt� ��~}|D ]h}|�� �� }|s�z|d ||d < W n t y� Y n0 i }q�|�
d�r�|� d d
�\} }
t |
�|| < q�W d � n1 �s0 Y t
|�� �}|�p0dS ) z-Return the number of CPU cores in the system.z9/sys/devices/system/cpu/cpu[0-9]*/topology/core_cpus_listz?/sys/devices/system/cpu/cpu[0-9]*/topology/thread_siblings_listNr r� � cpu cores� physical id)r� r� s :r )�set�globr �add�readr� r� r r� r� r� r} r� �sumr� ) �ls�p1�p2ra r� �result�mappingZ current_infor� �key�valuer? r? r@ �cpu_count_cores� s6
2 �
. r c C s� t dt� ���} d}d}d}| D ]r}|�d�r@t|�� d �}n6|�d�r\t|�� d �}n|�d�rvt|�� d �}|dur |dur |dur q�q W d � n1 s�0 Y d}t�||||�S )z*Return various CPU stats as a named tuple.r� Ns ctxtr s intrs softirqr )r r r� r� r} r Z scpustats)r� Z ctx_switchesZ
interruptsZsoft_interruptsr� Zsyscallsr? r? r@ � cpu_stats� s,
���$�r c C sh g } t dt� ��B}|D ],}|�� �d�r| �t|�dd�d �� qW d � n1 sZ0 Y | S )z7Return current CPU frequency from cpuinfo if available.r� s cpu mhz� :r N)r r r� r� r� r� r} )r� r� r� r? r? r@ �_cpu_get_cpuinfo_freq� s :r z'/sys/devices/system/cpu/cpufreq/policy0z$/sys/devices/system/cpu/cpu0/cpufreqc C s& t � } t�d�pt�d�}|jdd� d� g }tjj}t|�D ]�\}}t|�t| �krd| | d }nt||d�dd �}|du r�t||d
�dd �}|du r�d � |�}t
|dd �d kr�|� t �
d
d
d
�� q>d}t|��t|�d }tt||d���d } tt||d���d }
|� t �
||
| �� q>|S )z�Return frequency metrics for all CPUs.
Contrarily to other OSes, Linux updates these values in
real-time.
z,/sys/devices/system/cpu/cpufreq/policy[0-9]*z)/sys/devices/system/cpu/cpu[0-9]*/cpufreqc S s t t�d| ��� �S )Nz[0-9]+)r� r� r� �group)rH r? r? r@ �<lambda>� r� zcpu_freq.<locals>.<lambda>)r� i� Zscaling_cur_freqN�r� Zcpuinfo_cur_freqz$/sys/devices/system/cpu/cpu{}/onlinez0
r� z!can't find current frequency fileZscaling_max_freqZscaling_min_freq)r r� �sortr{ ra r� � enumerater� r �formatr r� r �scpufreq�NotImplementedErrorr� ) Z
cpuinfo_freqs�pathsr� �pjoin�ira �currZ online_pathr� Zmax_Zmin_r? r? r@ �cpu_freq� s8 ��� r c C s dd� t � D �S )z}Alternate implementation using /proc/cpuinfo.
min and max frequencies are not available and are set to None.
c S s g | ]}t �|d d ��qS )r� )r r
r� r? r? r@ r� # r� z cpu_freq.<locals>.<listcomp>)r r? r? r? r@ r s c @ s e Zd ZdS )�_Ipv6UnsupportedErrorN)r< r= r> r? r? r? r@ r . s r c @ sZ e Zd ZdZdd� Zdd� Zdd� Zedd � �Zedd d ��Z edd
d��Z
ddd�Z d
S )�NetConnectionsaw A wrapper on top of /proc/net/* files, retrieving per-process
and system-wide open connections (TCP, UDP, UNIX) similarly to
"netstat -an".
Note: in case of UNIX sockets we're only able to determine the
local endpoint/path, not the one it's connected to.
According to [1] it would be possible but not easily.
[1] http://serverfault.com/a/417946
c C s� dt jt jf}dt jt jf}dt jt jf}dt jt jf}dt jd f}|||||f||f|f|f||f|f|f|f||||f||f||fd� | _d | _d S )N�tcp�tcp6�udp�udp6�unix) �allr �tcp4r r �udp4r r �inetZinet4Zinet6)�socket�AF_INET� SOCK_STREAM�AF_INET6�
SOCK_DGRAM�AF_UNIX�tmap� _procfs_path)�selfr r r r r r? r? r@ �__init__> s$
�
zNetConnections.__init__c C s� t t�}t�d| j|f �D ]�}ztd| j||f �}W nv ttfyR Y q Y q ty� } zF|j t j
krxW Y d }~q |j t j kr�t |� W Y d }~q � W Y d }~q d }~0 0 |�
d�r |dd � d d� }|| �|t|�f� q |S )N�%s/%s/fd� %s/%s/fd/%szsocket:[r� ���)r �listr{ �listdirr# r| r r! r� �errno�EINVAL� ENAMETOOLONGr r� r� r� )r$ r� �inodesrb �inoder� r? r? r@ �get_proc_inodesU s"
z NetConnections.get_proc_inodesc C sF i }t � D ]6}z|�| �|�� W q
tttfy> Y q
Y q
0 q
|S �N)�pids�updater0 r r! r )r$ r. r� r? r? r@ �get_all_inodeso s
z NetConnections.get_all_inodesc C s� | � d�\}}t|d�}|s dS tr.|�d�}|tjkrntrZt�|t� |�ddd� �}q�t�|t� |��}n~t� |�}zRtr�t�tj
t j dgt �
d|��R � �}n$t�tj
t j dgt �
d|��R � �}W n ty� t� s�t�n� Y n0 t�||�S ) a� Accept an "ip:port" address as displayed in /proc/net/*
and convert it into a human readable form, like:
"0500000A:0016" -> ("10.0.0.5", 22)
"0000000000000000FFFF00000100007F:9E49" -> ("::ffff:127.0.0.1", 40521)
The IP address portion is a little or big endian four-byte
hexadecimal number; that is, the least significant byte is listed
first, so we need to reverse the order of the bytes to convert it
to an IP address.
The port is represented as a two-byte hexadecimal number.
Reference:
http://linuxdevcenter.com/pub/a/linux/2000/11/16/LinuxAdmin.html
�:� r? �asciiNr( z>4Iz<4I)r} r� r �encoder r �
LITTLE_ENDIAN� inet_ntop�base64� b16decoder �struct�pack�unpackr� r r r �addr)r@ �family�ip�portr? r? r@ �decode_address s4
�� z NetConnections.decode_addressNc c sN | � d�rtj�| �sdS t| ���}|�� t|d�D ]�\}}z(|�� dd� \
}} }
} }}}}}} W n$ ty� t d| ||f ��Y n0 | |v r�|| d \}
}nd\}
}|dur�||
kr�q8q8|t
j kr�t | } nt
j} z t�| |�} t�|
|�}
W n t�y Y q8Y n0 |||| |
| |
fV q8W d � n1 �s@0 Y dS )z.Parse /proc/net/tcp* and /proc/net/udp* files.�6Nr r� z,error while parsing %s; malformed line %s %rr �Nr( )r~ r{ ra �existsr r� r r} r� � RuntimeErrorr r � TCP_STATUSESr � CONN_NONEr rD r )�filerA �type_r. �
filter_pidr� �linenor� r� �laddr�raddr�statusr/ r� rb r? r? r@ � process_inet� s8 � ��
zNetConnections.process_inetc
c s t | ���}|�� |D ]�}|�� }z |dd� \}}}}}}} W n. tyn d|vrZY qtd| |f ��Y n0 | |v r�|| }
ndg}
|
D ]`\} } |dur�|| kr�q�q�t|�dkr�|d nd }
t�t|��}d }tj }| |||
||| fV q�qW d � n1 �s0 Y dS )
zParse /proc/net/unix files.r � ro z)error while parsing %s; malformed line %rrF Nr� r( � )
r r� r} r� rH r� r Zsocktype_to_enumr� rJ )rK rA r. rM r� r� �tokensr� rL r/ �pairsr� rb ra rP rQ r? r? r@ � process_unix� s2
��
zNetConnections.process_unixc C s || j vr,td|d�dd� | j D ��f ��t� | _|d urP| �|�}|sXg S n| �� }t� }| j | D ]�\}}}d| j|f }|tj tj
fv r�| j |||||d�} n| j ||||d�} | D ]L\}
}}} } }
}|r�t
�|
||| | |
�}nt
�|
||| | |
|�}|�|� q�qht|�S )Nz+invalid %r kind argument; choose between %sr� c S s g | ] }t |��qS r? )�reprr� r? r? r@ r� r� z+NetConnections.retrieve.<locals>.<listcomp>z %s/net/%s)rM )r" r� r� r r# r0 r4 r� r r r rR rW r �pconnZsconnr� r) )r$ �kindr� r. r� Z
proto_namerA rL ra r� rb rO rP rQ Z bound_pid�connr? r? r@ �retrieve s<
��
� ��zNetConnections.retrieve)N)N)N) r< r= r> �__doc__r% r0 r4 � staticmethodrD rR rW r\ r? r? r? r@ r 2 s
4 ) #r r c C s
t �| �S )z$Return system-wide open connections.)�_net_connectionsr\ )rZ r? r? r@ �net_connections) s r` c C s� t dt� ��} | �� }W d � n1 s,0 Y i }|dd� D ]�}|�d�}|dkshJ t|���|d|� �� }||d d� �� �� }tt|�\}}} }
} } }
}}}}}}}}}||||| ||
|f||< qF|S )zsReturn network I/O statistics for every network interface
installed on the system as a dict of raw tuples.
z
%s/net/devNr9 r5 r r ) r r � readlines�rfindrX r� r} �mapr� )r� �lines�retdictr� �colonr� r� Z
bytes_recvZ packets_recvZerrinZdropinZ_fifoinZ_frameinZ
_compressedinZ _multicastinZ
bytes_sentZ packets_sentZerroutZdropoutZ_fifooutZ_collisionsoutZ _carrieroutZ_compressedoutr? r? r@ �net_io_counters. sH &
��
rg c C s� t jtt jtt jti} t� �� }i }|D ]�}z&t �
|�}t � |�}t � |�\}}W n< t
y� } z$|jtjkrr� nt|� W Y d}~q(d}~0 0 d�|�} d|v }
t�|
| | ||| �||< q(|S )z)Get NIC stats (isup, duplex, speed, mtu).N�,�running)r� Z DUPLEX_FULLr
Z DUPLEX_HALFr ZDUPLEX_UNKNOWNr rg �keys�
cext_posixZ
net_if_mtuZ net_if_flagsZnet_if_duplex_speedr� r+ ZENODEVr r� r Z snicstats) Z
duplex_map�namesr� r� Zmture Zduplex�speedr� Z output_flagsZisupr? r? r@ � net_if_stats] s* �
�
rn Fc C s� dd� }dd� }t j�dt� �r*|� }n"t j�d�r>|� }ntdt� ��i }|D ]T}|\
}}}} }
} } }
}}| s~t|�s~qT| t9 } |
t9 }
||| |
| | |
||f ||< qT|S )zcReturn disk I/O statistics for every disk installed on the
system as a dict of raw tuples.
c s sD t dt� ��} | �� }W d � n1 s,0 Y |D �]}|�� }t|�}|dkr�|d }t|d �}tt|dd� �\
}}} }
} } }
}}}n�|dks�|dkr�|d }tt|dd� �\ }}}} }
} } }
}}}nN|dk�r|d }tt|dd � �\}}}
} d } }
} } }n td
| ��|||
|| | |
|| |f
V q:d S ) N� %s/diskstats� r: r9 r� � � rS r z!not sure how to interpret line %r)r r ra r} r� r� rc r� )r� rd r� r� Zflenr� �reads� reads_merged�rbytes�rtime�writes�
writes_merged�wbytes�wtimer� r_ r? r? r@ � read_procfs� s4 &
�
��
�
�z%disk_io_counters.<locals>.read_procfsc s s� t �d�D ]�} t �t j�d| ��D ]�\}}}d|vr6q"tt j�|d��� }|�� �� �� }W d � n1 sn0 Y t j� |�}t
t |d d� �\
}}} }
} } }
}}}||| | |
|
||| |f
V q"q
d S )N�
/sys/block�statr� ) r{ r* �walkra r� r r� r� r} �basenamerc r� )�block�rootr� �filesr� r� r� rs rt ru rv rw rx ry rz r_ r? r? r@ �
read_sysfs� s . � �z$disk_io_counters.<locals>.read_sysfsro r| zC%s/diskstats nor /sys/block filesystem are available on this system)r{ ra rG r r r� �DISK_SECTOR_SIZE)Zperdiskr{ r� �genre r� r� rs rw ru ry rv rz rt rx r_ r? r? r@ �disk_io_counters� s0 - ��� �
r� c @ s@ e Zd ZdZddgZdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�RootFsDeviceFinderaF disk_partitions() may return partitions with device == "/dev/root"
or "rootfs". This container class uses different strategies to try to
obtain the real device path. Resources:
https://bootlin.com/blog/find-root-device/
https://www.systutorials.com/how-to-find-the-disk-where-root-is-on-in-bash-on-linux/.
�major�minorc C s( t �d�j}t �|�| _t �|�| _d S )Nr� )r{ r} �st_devr� r� )r$ �devr? r? r@ r% � s zRootFsDeviceFinder.__init__c C s� t dt� ���}|�� dd � D ]�}|�� }t|�dk r:q |d �� rRt|d �nd }|d �� rnt|d �nd }|d }|| jkr || jkr |r d| W d � S q W d � n1 s�0 Y d S )Nz
%s/partitionsr9 r� r r r: �/dev/%s) r r ra r} r� �isdigitr� r� r� )r$ r� r� r� r� r� r� r? r? r@ �ask_proc_partitions� s z&RootFsDeviceFinder.ask_proc_partitionsc C s� d| j | jf }t|��T}|D ]>}|�d�r |�� �d�d }|r d| W d � S q W d � n1 sr0 Y d S )Nz/sys/dev/block/%s:%s/ueventzDEVNAME=r9 r� )r� r� r r� r� �
rpartition)r$ ra r� r� r� r? r? r@ �ask_sys_dev_block s
z$RootFsDeviceFinder.ask_sys_dev_blockc C s� d| j | jf }t�d�}|D ]�}z t|�}W n tyD Y q Y q 0 |�R |�� �� }||kr�tj �
tj � |��}d| W d � S W d � q 1 s�0 Y q d S )Nz%s:%sz/sys/class/block/*/devr� ) r� r� r� �iglobr r r� r� r{ ra r �dirname)r$ �needler� rK r� �datar� r? r? r@ �ask_sys_class_block s
z&RootFsDeviceFinder.ask_sys_class_blockc
C s� d }|d u rJz | � � }W n0 ttfyH } zt|� W Y d }~n
d }~0 0 |d u r�z | �� }W n0 ttfy� } zt|� W Y d }~n
d }~0 0 |d u r�z | �� }W n0 ttfy� } zt|� W Y d }~n
d }~0 0 |d ur�tj�|�r�|S d S r1 ) r� r� r� r r� r� r{ ra rG )r$ ra r� r? r? r@ �find s$ zRootFsDeviceFinder.findN)
r< r= r> r] � __slots__r% r� r� r� r� r? r? r? r@ r� � s
r� c C s4 t � }t� }| s�td| ��\}|D ]F}|�� }|�d�sH|�|�� � q"|�d�d }|dkr"|�d� q"W d � n1 s~0 Y |dkr�tj� d�r�tj�
d�}ntj�
d | �}g }t � |�}|D ]b} | \}
} }} |
d
kr�d }
|
d v r�t
� �� p�|
}
| �s|
r�||v�rq�t�|
| || �}
|�|
� q�|S )
z8Return mounted disk partitions as a list of namedtuples.z%s/filesystemsZnodev� r ZzfsNr� z /etc/mtabz%s/self/mounts�nonerT )z /dev/rootZrootfs)r� r r r� r� r� r} r{ ra �isfile�realpathr� �disk_partitionsr� r� r Z sdiskpartr� )r Zfstypesr� r� r� ZfstypeZ mounts_path�retlistZ
partitions� partitionZdeviceZ
mountpoint�opts�ntupler? r? r@ r� 5 s8
*
r� c C s` t �t�} t�d�}|�t�d�� ttdd� |D ���}t�d�}t�d�}|D ]"}|� d|�}||vrR|�
|� qR|D �]}z>|d }t t |��d }t
j�t
j�|�d
�}t|��� } W n tttfy� Y qzY n0 t |d d d
�}
t |d d d
�} t|d dd
��� } |
d u�rDzt |
�d }
W n t�yB d }
Y n0 | d u�rxzt | �d } W n t�yv d } Y n0 | | �
| ||
| f� qz|�sXt�d�}tt|��}|D �]�}z<t
j�|d�}t t |��d }t
j�|d�}t|��� } W nB tttf�y4 }
z"t|
� W Y d }
~
�q�W Y d }
~
n
d }
~
0 0 t�|d �}tdd� |D ��}d } d }
|D ]�}t
j�||d �}t|dd
��� }|dk�r�t t
j�||d �d d
�} n$|dk�r�t t
j�||d �d d
�}
|
d u�rzt |
�d }
W n t�y d }
Y n0 | d u�rbzt | �d } W n t�y8 d } Y n0 �qb| | �
d||
| f� �q�t| �S )a� Return hardware (CPU and others) temperatures as a dict
including hardware name, label, current, max and critical
temperatures.
Implementation notes:
- /sys/class/hwmon looks like the most recent interface to
retrieve this info, and this implementation relies on it
only (old distros will probably use something else)
- lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
- /sys/class/thermal/thermal_zone* is another one but it's more
difficult to parse
z /sys/class/hwmon/hwmon*/temp*_*z&/sys/class/hwmon/hwmon*/device/temp*_*c S s g | ]}|� d �d �qS �r� r �r} r� r? r? r@ r� t r� z(sensors_temperatures.<locals>.<listcomp>z5/sys/devices/platform/coretemp.*/hwmon/hwmon*/temp*_*z'/sys/devices/platform/coretemp.*/hwmon/z/sys/class/hwmon/�_inputg @�@r� Z_maxNr Z_crit�_labelrT z /sys/class/thermal/thermal_zone*�temp�typez /trip_point*c S s, g | ]$}d � tj�|��d �dd� ��qS )r� r r: )r� r{ ra r r} )r� �pr? r? r@ r� � s ��_type�critical�_temp�high)� collectionsr r) r� �extend�sortedr� r� r� �subr� r� r r{ ra r� r� r r� r� r� r� r �dict)r� � basenamesZ
basenames2�replr� Zaltname�basera r� � unit_namer� r� �labelr� Z
trip_pathsZ trip_pointsZ
trip_pointZ trip_typer? r? r@ �sensors_temperaturesa s�
�
$�
�
�
r� c C s� t �t�} t�d�}|s"t�d�}ttdd� |D ���}|D ]�}ztt|d ��}W n< tt fy� } z t
|� W Y d}~q<W Y d}~n
d}~0 0 t t j
�t j
�|�d���� }t |d d d
��� }| | �t�||�� q<t| �S ) a� Return hardware fans info (for CPU and other peripherals) as a
dict including hardware label and current speed.
Implementation notes:
- /sys/class/hwmon looks like the most recent interface to
retrieve this info, and this implementation relies on it
only (old distros will probably use something else)
- lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
z /sys/class/hwmon/hwmon*/fan*_*z%/sys/class/hwmon/hwmon*/device/fan*_*c S s g | ]}|� d �d �qS r� r� r� r? r? r@ r� � r� z sensors_fans.<locals>.<listcomp>r� Nr� r� rT r )r� r r) r� r� r� r� r r� r� r r r{ ra r� r� r� r� r Zsfanr� )r� r� r� r� r� r� r� r? r? r@ � sensors_fans� s
" r� c s� t � � � fdd�} dd� t�t�D �}|s.dS tj�tt|�d �}| |d |d �}| |d |d
�}| |d |d �}| |d
�}|dur�|dur�zd| | }W q� ty� d}Y q�0 n tt |d dd��}|dkr�dS d}| tj�td�tj�td��} | du�r| dk}n6t |d dd��
� � � }
|
dk�r>d}n|
dv �rLd}|�rZt j
} nt|du�r�|du�r�zt|| d �} W n t�y� t j} Y n0 n.|du�r�t|d �} | dk �r�t j} nt j} t �|| |�S ) a Return battery information.
Implementation note: it appears /sys/class/power_supply/BAT0/
directory structure may vary and provide files with the same
meaning but under different names, see:
https://github.com/giampaolo/psutil/issues/966.
c sP | D ]F}t |� d�}|� krzt|�W S tyH |�� Y S 0 qdS )zvAttempt to read the content of multiple files which may
not exist. If none of them exist return None.
r N)r r� r� r� )r ra r� ��nullr? r@ �
multi_bcat� s z#sensors_battery.<locals>.multi_bcatc S s& g | ] }|� d �s d|�� v r|�qS )ZBATZbattery)r� r� r� r? r? r@ r� s �z#sensors_battery.<locals>.<listcomp>Nr z /energy_nowz /charge_nowz
/power_nowz /current_nowz /energy_fullz /charge_fullz/time_to_empty_nowg Y@r� z /capacityr( r z
AC0/onlinez AC/onliner z/statusrT Z dischargingF)Zcharging�fullTi �< )�objectr{ r* �POWER_SUPPLY_PATHra r� r� �ZeroDivisionErrorr� r r� r� r ZPOWER_TIME_UNLIMITEDZPOWER_TIME_UNKNOWNZsbattery) r� Zbatsr� Z
energy_nowZ power_nowZ energy_fullZ
time_to_emptyrQ Z
power_pluggedZonlinerQ Zsecsleftr? r� r@ �sensors_battery� sZ
� �
r� c C sH g } t �� }|D ]2}|\}}}}}t�||p.d|||�}| �|� q| S )z:Return currently connected users as a list of namedtuples.N)r� �usersr Zsuserr� ) r� Zrawlist�itemrr �tty�hostnameZtstampr� �ntr? r? r@ r� U s r� c C s� dt � } t| ��^}|D ]<}|�d�rt|�� �� d �}|a| W d � S qtd| ��W d � n1 sv0 Y dS )zAReturn the system boot time expressed in seconds since the epoch.r� s btimer Nz line 'btime' not found in %s)r r r� r� r� r} � BOOT_TIMErH )ra r� r� r� r? r? r@ � boot_time` s
r� c C s dd� t �tt� ��D �S )z7Returns a list of PIDs currently running on the system.c S s g | ]}|� � rt|��qS r? )r� r� r� r? r? r@ r� t r� zpids.<locals>.<listcomp>)r{ r* r" r r? r? r? r@ r2 r s r2 c C s� t �| �sdS z�dt� | f }t|��\}|D ]:}|�d�r,t|�� d �}|| k W d � W S q,td| ��W d � n1 s�0 Y W n ttfy� | t � v Y S 0 dS )zcCheck for the existence of a unix PID. Linux TIDs are not
supported (always return False).
F� %s/%s/statuss Tgid:r Nz'Tgid' line not found in %s)
r �
pid_existsr r r� r� r} r� �EnvironmentErrorr2 )r� ra r� r� Ztgidr? r? r@ r� w s
.r� c
C s� i } t � }t� D ]�}z<td||f ��}|�� }W d � n1 sD0 Y W n ttfyf Y q0 |�d�}||d d� �� }t|d �}|| |< q| S )zsObtain a {pid: ppid, ...} dict for all running processes in
one shot. Used to speed up Process.children().
�
%s/%s/statN� )r9 r ) r r2 r r� r r! rb r} r� )r� r� r� r� r� �rparZdset�ppidr? r? r@ �ppid_map� s
*
r� c s t �� �� fdd��}|S )zlDecorator which translates bare OSError and IOError exceptions
into NoSuchProcess and AccessDenied.
c s� z� | g|�R i |��W S t y8 t| j| j��Y nh ty^ | �� t| j| j��Y nB ty� | �� tj �
d| j | jf �s�t| j| j��� Y n0 d S )N�%s/%s) r r
r� �_namer! �_raise_if_zombier r r{ ra rG r# )r$ r� �kwargs��funr? r@ �wrapper� s z wrap_exceptions.<locals>.wrapper)� functools�wraps)r� r� r? r� r@ �wrap_exceptions� s r� c @ s� e Zd ZdZg d�Zdd� Zdd� Zdd� Zd d
� Ze e
d d � ��Z e e
d
d� ��Z e e
dd� ��Z
dd� Zdd� Ze dd� �Ze dd� �Ze dd� �Ze dd � �Ze d d � �Zej�d e�� �r�e d d!� �Ze d"d#� �Ze d$d%� �Ze ddd'd(��Z e d)d*� �Z e d+d,� �Z e �se �rVd-d.� Z!e e"�#d/�e"�#d0�e"�#d1�fd2d3��Z$e d4d5� �Z%ne Z%e �rle d6d7� �Z&e d8d9� �Z'e e"�#d:�fd;d<��Z(e e"�#d=�fd>d?��Z)e d@dA� �Z*e dBdC� �Z+e dDdE� �Z,e-�r�e dFdG� �Z.e"�#dH�fdIdJ�Z/e dKdL� �Z0e1�re dMdN� �Z2e dOdP� �Z3e4d&u�r.e dedQdR��Z5e dSdT� �Z6e dUdV� �Z7e dfdXdY��Z8e dZd[� �Z9e d\d]� �Z:e e"�#d^�fd_d`��Z;e e"�#da�fdbdc��Z<d&S )g�Processz Linux process implementation.)�_cacher� �_ppidr# r� c C s || _ d | _d | _t� | _d S r1 )r� r� r� r r# )r$ r� r? r? r@ r% � s zProcess.__init__c C s\ zt d| j| jf �}W n ttfy0 Y dS 0 |�d�}||d |d � }|dkS d S )Nr� Fr� r9 r: � Z)r r# r� r� r� rb )r$ r� r� rQ r? r? r@ �
_is_zombie� s
zProcess._is_zombiec C s | � � rt| j| j| j��d S r1 )r� r r� r� r� �r$ r? r? r@ r� � s zProcess._raise_if_zombiec C s t �d| j| jf � dS )z+Raise NSP if the process disappeared on us.r� N)r{ r} r# r� r� r? r? r@ �_raise_if_not_alive� s zProcess._raise_if_not_alivec C s� t d| j| jf �}|�d�}||�d�d |� }||d d� �� }i }||d< |d |d < |d |d
< |d |d < |d
|d< |d |d< |d |d< |d |d< |d |d< |d |d< z|d |d< W n" ty� td� d|d< Y n0 |S ) aY Parse /proc/{pid}/stat file and return a dict with various
process info.
Using "man proc" as a reference: where "man proc" refers to
position N always subtract 3 (e.g ppid position 4 in
'man proc' == position 1 in here).
The return value is cached in case oneshot() ctx manager is
in use.
r� r� � (r r9 Nr� r rQ r� r� �ttynr� �utime� �stime�
�children_utimerq �children_stime� � create_time�$ �cpu_num�' � blkio_ticksz&can't get blkio_ticks, set iowait to 0)r r# r� rb r� r} �
IndexErrorr )r$ r� r� r� r� r� r? r? r@ �_parse_stat_file� s*
zProcess._parse_stat_filec C s@ t d| j| jf ��}|�� W d � S 1 s20 Y dS )z�Read /proc/{pid}/stat file and return its content.
The return value is cached in case oneshot() ctx manager is
in use.
r� N)r r# r� r� �r$ r� r? r? r@ �_read_status_file s zProcess._read_status_filec C sD t d| j| jf �� }|�� �� W d � S 1 s60 Y d S )Nz %s/%s/smaps)r r# r� r� r� r� r? r? r@ �_read_smaps_file s zProcess._read_smaps_filec C s( | j �| � | j�| � | j�| � d S r1 )r� Zcache_activater� r� r� r? r? r@ �
oneshot_enter s zProcess.oneshot_enterc C s( | j �| � | j�| � | j�| � d S r1 )r� Zcache_deactivater� r� r� r? r? r@ � oneshot_exit% s zProcess.oneshot_exitc C s | � � d }trt|�}|S )Nr� )r� r r )r$ r� r? r? r@ r� * s z Process.namec C sZ zt d| j| jf �W S ttfyT | �� tj�d| j| jf �rNY dS � Y n0 d S )Nz %s/%s/exer� rT ) r| r# r� r r! r� r{ ra �lexistsr� r? r? r@ �exe2 s z Process.exec C s� t d| j| jf ��}|�� }W d � n1 s20 Y |sL| �� g S |�d�rZdnd}|�|�rt|d d� }|�|�}|dkr�t|�dkr�d|v r�|�d�}|S )Nz
%s/%s/cmdlinerw ro r( r )r r# r� r� r� r~ r} r� )r$ r� r� �sep�cmdliner? r? r@ r� ? s &
zProcess.cmdlinec C sD t d| j| jf ��}|�� }W d � n1 s20 Y t|�S )Nz
%s/%s/environ)r r# r� r� r )r$ r� r� r? r? r@ �environY s &zProcess.environc C s< t | �� d �}t�� }z
|| W S ty6 Y d S 0 d S )Nr� )r� r� r Zget_terminal_mapr� )r$ Ztty_nrr" r? r? r@ �terminal_ s
zProcess.terminalz /proc/%s/ioc
C s d| j | jf }i }t|��\}|D ]F}|�� }|r"z|�d�\}}W n tyZ Y q"Y q"0 t|�||< q"W d � n1 s~0 Y |s�td| ��z,t|d |d |d |d |d |d �W S t �y } z$td
|j
d ||f ��W Y d }~n
d }~0 0 d S ) Nz%s/%s/ios : z%s file was emptys syscrs syscws
read_bytess write_bytess rchars wcharz1%r field was not found in %s; found fields are %rr ) r# r� r r� r} r� r� rH rp r� r� )r$ �fnamer� r� r� r� r� r� r? r? r@ � io_countersk s8
, ���zProcess.io_countersc C sh | � � }t|d �t }t|d �t }t|d �t }t|d �t }t|d �t }t|||||�S )Nr� r� r� r� r� )r� r� r� rq )r$ r� r� r� r� r� rv r? r? r@ r� � s zProcess.cpu_timesc C s t | �� d �S )zWhat CPU the process is on.r� �r� r� r� r? r? r@ r� � s zProcess.cpu_numNc C s t �| j|| j�S r1 )r Zwait_pidr� r� )r$ �timeoutr? r? r@ �wait� s z Process.waitc C s& t | �� d �}tpt� }|t | S )Nr� )r� r� r� r� r� )r$ �ctimeZbtr? r? r@ r� � s
zProcess.create_timec C st t d| j| jf ��<}dd� |�� �� d d� D �\}}}}}}}W d � n1 sV0 Y t|||||||�S )Nz %s/%s/statmc s s | ]}t |�t V qd S r1 )r� r� r� r? r? r@ � <genexpr>� s z&Process.memory_info.<locals>.<genexpr>rS )r r# r� r� r} rf ) r$ r� Zvmsrl rX �text�libr� Zdirtyr? r? r@ � memory_info� s
�2zProcess.memory_infoc C s� d } }}t d�| j| j���|}|D ]f}|�d�rN|t|�� d �d 7 }q&|�d�rnt|�� d �d }q&|�d�r&t|�� d �d }q&W d � n1 s�0 Y |||fS )Nr z{}/{}/smaps_rollups Private_r r� � Pss:� Swap:)r r r# r� r� r� r} )r$ rh ri rj r� r� r? r? r@ �_parse_smaps_rollup� s �
4zProcess._parse_smaps_rollups \nPrivate.*:\s+(\d+)s \nPss\:\s+(\d+)s \nSwap\:\s+(\d+)c C sZ | � � }ttt|�|���d }ttt|�|���d }ttt|�|���d }|||fS )Nr� )r� r� rc r� �findall)r$ Z _private_reZ_pss_reZ_swap_reZ
smaps_datarh ri rj r? r? r@ � _parse_smaps� s
zProcess._parse_smapsc C sf t r>z| �� \}}}W qL ttfy: | �� \}}}Y qL0 n| �� \}}}| �� }t||||f � S r1 )�HAS_PROC_SMAPS_ROLLUPr r! r r r rg )r$ rh ri rj Z basic_memr? r? r@ �memory_full_info� s zProcess.memory_full_infoc C s^ dd� }| � � }|s | �� g S |�d�}g }|�d�}|g}|||�D �]\}}|�dd�}z|\} }
} } }
}W n( ty� |dg \} }
} } }
}Y n0 |s�d}n2tr�t|�}|�� }|�d �r�t |�s�|dd
� }t| �t|
�||�
d d�|�
d d�|�
d
d�|�
dd�|�
dd�|�
dd�|�
dd�|�
dd�|�
dd�|�
dd�f
}|� |� qH|S )aQ Return process's mapped memory regions as a list of named
tuples. Fields are explained in 'man proc'; here is an updated
(Apr 2012) version: http://goo.gl/fmebo.
/proc/{PID}/smaps does not exist on kernels < 2.6.14 or if
CONFIG_MMU kernel configuration option is not enabled.
c s s� i }| D ]�}|� d d�}|d �d�s@|�� |fV |�|� qz t|d �d ||d < W q ty� |d �d�r~Y qn td| ��Y q0 q|�� |fV d S )N� r r r r� s VmFlags:z#don't know how to interpret line %r)r} r~ �popr� r� r� r� )rd �
current_blockr� r� r� r? r? r@ �
get_blocks s" �� z'Process.memory_maps.<locals>.get_blocks�
r Nr rT z[anon]rx ry s Rss:s Size:r s
Shared_Clean:s
Shared_Dirty:s Private_Clean:s Private_Dirty:s Referenced:s
Anonymous:r ) r� r� r} r r� r r r� r~ r r� r� )r$ r r� rd r� �
first_liner �headerZhfieldsr@ Zperms�_offset�_devZ_inodera r� r? r? r@ � memory_maps sP
�
� zProcess.memory_mapsc C s t d| j| jf �S )Nz %s/%s/cwd)r| r# r� r� r? r? r@ �cwdR s z Process.cwds ctxt_switches:\t(\d+)c C sL | � � }|�|�}|s,td| j| jf ��n t�t|d �t|d ��S d S )Nz�'voluntary_ctxt_switches' and 'nonvoluntary_ctxt_switches'lines were not found in %s/%s/status; the kernel is probably older than 2.6.23r r )r� r
r r# r� r Zpctxswr� )r$ Z _ctxsw_rer� Zctxswr? r? r@ �num_ctx_switchesV s
��zProcess.num_ctx_switchess Threads:\t(\d+)c C s | � � }t|�|�d �S �Nr )r� r� r
)r$ Z_num_threads_rer� r? r? r@ � num_threadse s zProcess.num_threadsc
C s t �d| j| jf �}|�� g }d}|D ]�}d| j| j|f }z8t|�� }|�� �� }W d � n1 sl0 Y W n tt fy� d}Y q*Y n0 ||�
d�d d � }|� d�}t |d �t
} t |d �t
}
t�t|�| |
�} |�| � q*|�r| �� |S )
Nz
%s/%s/taskFz%s/%s/task/%s/statTr� r9 r� r� r� )r{ r* r# r� r r r� r� r r! r� r} r� r� r Zpthreadr� r� r� ) r$ Z
thread_idsr� �
hit_enoent� thread_idr� r� �str� r� r� r� r? r? r@ �threadsm s2 �
.
zProcess.threadsc C s t �| j�S r1 )rk � getpriorityr� r� r? r? r@ �nice_get� s zProcess.nice_getc C s t �| j|�S r1 )rk � setpriorityr� )r$ r� r? r? r@ �nice_set� s zProcess.nice_setc C s t �| j�S r1 )r� r4 r� r� r? r? r@ �cpu_affinity_get� s zProcess.cpu_affinity_gets Cpus_allowed_list:\t(\d+)-(\d+)c C sV | � � }|�|�}|r@ttt|d d �t|d d �d ��S tttt� ���S d S )Nr r )r� r
r) �ranger� r� r� )r$ �_rer� r� r? r? r@ �_get_eligible_cpus� s
*zProcess._get_eligible_cpusc
C s� zt �| j|� W n� ttfy� } zxt|t�s<|jtjkr�| �� }t t
t t � ���}|D ]4}||vrvtd||f ��||vrZtd||f ��qZ� W Y d }~n
d }~0 0 d S )Nz(invalid CPU number %r; choose between %sz0CPU number %r is not eligible; choose between %s)
r� Zproc_cpu_affinity_setr� r� r� rz r+ r, r' �tupler% r� r� )r$ r� r� Z
eligible_cpusZall_cpus�cpur? r? r@ �cpu_affinity_set� s( ����zProcess.cpu_affinity_setc C s, t �| j�\}}td ur t|�}t�||�S r1 )r� r3 r� �enumr; r Zpionice)r$ �ioclassr� r? r? r@ �
ionice_get� s zProcess.ionice_getc C sT |d u r d}|r(|t tfv r(td| ��|dk s8|dkrDd}t|��t�| j||�S )Nr z%r ioclass accepts no valuerS zvalue not in 0-7 range)r' r$ r� r� Zproc_ioprio_setr� )r$ r, r� r� r? r? r@ �
ionice_set� s zProcess.ionice_setc
C s� | j dkrd}t|��zL|d u r.t| j |�W S t|�dkrRddt|� }t|��t| j ||� W n: ty� } z"|jtjkr�| �� � W Y d }~n
d }~0 0 d S )Nr z)can't use prlimit() against PID 0 processr9 z'second argument must be a (soft, hard) z
tuple, got %s) r� r� r� r� rX r� r+ ZENOSYSr� )r$ r� r� r� r� r? r? r@ �rlimit� s"
�� zProcess.rlimitc C s$ | � � d }tr|�� }t�|d�S )NrQ �?)r� r r �
PROC_STATUSESr� )r$ �letterr? r? r@ rQ � s zProcess.statusc
C s� g }t �d| j| jf �}d}|D �]b}d| j| j|f }z t|�}W nz ttfyd d}Y q"Y q" ty� } zF|jtj kr�W Y d }~q"|jtj
kr�t |� W Y d }~q"� W Y d }~q"d }~0 0 |� d�r"t
|�r"d| j| j|f }zXt|��:}t|�� �� d �} t|�� �� d d�}
W d � n1 �s20 Y W n ttf�yZ d}Y q"0 t|
�} t|t|�t| �| |
�} |�| � q"|�r�| �� |S ) Nr& Fr' Tr� z%s/%s/fdinfo/%sr r� )r{ r* r# r� r| r r! r� r+ r, r- r r� r r r� r� r} r� r` r� r� )
r$ r� r� r rb rK ra r� r� �posre rd r� r? r? r@ �
open_files� sJ
�
:
� zProcess.open_filesr c C s t �|| j�}| �� |S r1 )r_ r\ r� r� )r$ rZ r� r? r? r@ r` / s zProcess.net_connectionsc C s t t�d| j| jf ��S )Nr& )r� r{ r* r# r� r� r? r? r@ �num_fds5 s zProcess.num_fdsc C s t | �� d �S )Nr� r� r� r? r? r@ r� 9 s z Process.ppids Uid:\t(\d+)\t(\d+)\t(\d+)c C s6 | � � }|�|�d \}}}t�t|�t|�t|��S r )r� r
r Zpuidsr� )r$ Z_uids_rer� �real� effective�savedr? r? r@ �uids= s z Process.uidss Gid:\t(\d+)\t(\d+)\t(\d+)c C s6 | � � }|�|�d \}}}t�t|�t|�t|��S r )r� r
r Zpgidsr� )r$ Z_gids_rer� r6 r7 r8 r? r? r@ �gidsC s z Process.gids)N)N)r )=r< r= r> r] r� r% r� r� r� r� r r� r� r� r� r� r� r� r� r� r� r{ ra rG �getpidr� r� r� r r� r r �HAS_PROC_SMAPSr r� r� r r
r r r r r r! r# �HAS_CPU_AFFINITYr$ r' r* �HAS_PROC_IO_PRIORITYr- r. r� r/ rQ r4 r` r5 r� r9 r: r? r? r? r@ r� � s� %
�
K
�
�
3
r� )N)r )F)F)�r] �
__future__r r; r� r+ r� r� r{ r� r r= �sysr� r r rT r r r r� r rk r
r r r
r r r r r r r r r r r r r r r r Z_compatr r r r! r" r# r+ Z__extra__all__r� ra rG r; r< r �hasattrr> r= r� r� Z getpagesizer� r� � byteorderr9 r� � AF_PACKETr8 �IntEnumr� r7 r$ r% r& r' r; �globalsr3 � __members__ZSTATUS_RUNNINGZSTATUS_SLEEPINGZSTATUS_DISK_SLEEPZSTATUS_STOPPEDZSTATUS_TRACING_STOPZ
STATUS_ZOMBIEZ STATUS_DEADZSTATUS_WAKE_KILLZ
STATUS_WAKINGZ STATUS_IDLEZ
STATUS_PARKEDr1 r( r) r* r+ r, r- r. r/ r0 r1 r2 rI rN rZ r` rf r� rg rk r� rn rp rq r| r� r� r� � Exceptionr� r� r� �resource� ImportErrorr� �CDLLr� r� �dirr� r� r� r� r� r� r r r r Z net_if_addrsr r r_ r` rg rn �
disk_usager� r� r� r� r� r� r� r� r2 r� r� r� r� r? r? r? r@ �<module> sb
�
�����
���
(
�
@ < +
�
) u
/"
hK
,v _ PK ok\�Dˤ� � * psutil/__pycache__/_psposix.cpython-39.pycnu �[��� a
��?h+ � @ sp d Z ddlZddlZddlZddlZddlZddlmZ ddlmZ ddlm Z ddlm
Z
ddlm Z dd l m
Z
dd
l mZ dd l mZ dd l mZ dd
l mZ ddl mZ ddl mZ er�ddlmZ e
r�ddlZndZg d�Zdd� Zedu�r*eed��r*e�dedd� ej D ���Z dd� Z ndd� Z ddej e edej�e!ej"efd d �Z#d d � Z$e d d!� �Z%dS )"z%Routines common to all posix systems.� N� )�MACOS��TimeoutExpired)�memoize)�
sdiskusage)�
usage_percent)�PY3)�ChildProcessError)�FileNotFoundError)�InterruptedError)�PermissionError)�ProcessLookupError)�unicode)� _psutil_osx)�
pid_exists�wait_pid�
disk_usage�get_terminal_mapc C sL | dkr dS zt �| d� W n& ty0 Y dS tyB Y dS 0 dS dS )z6Check whether pid exists in the current process table.r TFN)�os�killr r
)�pid� r �;/usr/local/lib64/python3.9/site-packages/psutil/_psposix.pyr ( s r �Signals� Negsignalc C s g | ]}|j |j f�qS r )�name�value)�.0�xr r r �
<listcomp>B � r c C s& z
t | �W S ty | Y S 0 dS )z+Convert a negative signal value to an enum.N)r �
ValueError��numr r r �negsig_to_enumE s
r% c C s | S )Nr r# r r r r% N s � monotonicc s� �dkrd}t |��d} d}
�dur8|
tjO }
�� � �� ������fdd�} zt��|
�\} }
W n> ty~ | | �} Y qP ty� |��r�| | �} q�Y dS 0 | dkr�| | �} qPt�|
�r�t�|
�S t�|
�r�t t�
|
� �S t d|
��qPdS )a� Wait for a process PID to terminate.
If the process terminated normally by calling exit(3) or _exit(2),
or by returning from main(), the return value is the positive integer
passed to *exit().
If it was terminated by a signal it returns the negated value of the
signal which caused the termination (e.g. -SIGTERM).
If PID is not a children of os.getpid() (current process) just
wait until the process disappears and return None.
If PID does not exist at all return None immediately.
If *timeout* != None and process is still alive raise TimeoutExpired.
timeout=0 is also possible (either return immediately or raise).
r zcan't wait for PID 0g-C ��6?Nc s6 �d ur �� �kr t ���d���| � � | d d�S )N)r r � g{�G�z�?r )�interval��_min�_sleep�_timerr � proc_nameZstop_at�timeoutr r �sleepw s
zwait_pid.<locals>.sleepz unknown process exit status %r) r" r �WNOHANG�waitpidr r
� WIFEXITED� WEXITSTATUS� WIFSIGNALEDr% �WTERMSIG)r r. r- �_waitpidr, r* r+ Z _pid_exists�msgr( �flagsr/ Zretpid�statusr r) r r R s2
r c C s� t rt�| �}n`zt�| �}W nP tyn t| t�rhz| �t�� �} W n tyZ Y n0 t�| �}n� Y n0 |j |j
}|j |j
}|j |j
}|| }t
r�t�| |�}|| }t||dd�}t||||d�S )a. Return disk usage associated with path.
Note: UNIX usually reserves 5% disk space which is not accessible
by user. In this function "total" and "used" values reflect the
total and used disk space whereas "free" and "percent" represent
the "free" and "used percent" user disk space.
r )Zround_)�total�used�free�percent)r r �statvfs�UnicodeEncodeError�
isinstancer �encode�sys�getfilesystemencoding�f_blocks�f_frsize�f_bfree�f_bavailr r Zdisk_usage_usedr r )�path�str: Z
avail_to_rootZ
avail_to_userr; Z
total_userZusage_percent_userr r r r � s.
�r c C s^ i } t � d�t � d� }|D ]<}|| vs0J |��z|| t�|�j< W q tyV Y q 0 q | S )zNGet a map of device-id -> path as a dict.
Used by Process.terminal().
z /dev/tty*z
/dev/pts/*)�globr �stat�st_rdevr )�retZlsr r r r r � s r )&�__doc__rJ r �signalrB �time�_commonr r r r r Z_compatr r
r r r
r r � r �enum�__all__r �hasattr�IntEnum�dictr r r% r1 �getattr�minr/ r r r r r r r �<module> sR
�
�
_5PK ok\q�-��- �- ) psutil/__pycache__/_compat.cpython-39.pycnu �[��� a
��?h�; � @ s d Z ddlZddlZddlZddlZddlZddlZddlZg d�Zej d dkZ
e � Z e
rze
ZeZeZeZeZdd� ZneZeZeZeZdd� Ze
r�eZneZe e dfd d
�Ze
r�eZeZeZeZeZe Z n�ddl Z e fd d �Z e e �d
d� �Ze e �dd� �Ze e �dd� �Ze e �dd� �Ze e �dd� �Ze e �dd� �Z e �!� dk�r�ze"ej#d��W n2 e �yt Y n e"�y� dZ$e%e$��Y n0 zdd lm&Z& W n� e'�y< zdd l(m)Z) W n e'�y� dd l*m)Z) Y n0 e�+d g d ��Z,G d d!� d!e-�Z.e fe/e
ee0e1d�f�e2e3e1e4fd"d#�Z5d5d&d'�Z&Y n0 zdd(l6m7Z7 W n* e'�yx ej8ej9B dfd)d*�Z7Y n0 zdd+l6m:Z: W n e'�y� d6d-d.�Z:Y n0 zdd/l;m<Z= W n$ e'�y� G d0d1� d1e �Z=Y n0 zdd2lm>Z> W n" e'�y ej?d3d4� �Z>Y n0 dS )7z�Module which provides compatibility with older Python versions.
This is more future-compatible rather than the opposite (prefer latest
Python 3 way of doing things).
� N)�PY3�long�range�super�unicode�
basestring�b� lru_cache�which�get_terminal_size�redirect_stderr�FileNotFoundError�PermissionError�ProcessLookupError�InterruptedError�ChildProcessError�FileExistsError� c C s
| � d�S )Nzlatin-1)�encode��s� r �:/usr/local/lib64/python3.9/site-packages/psutil/_compat.pyr 2 s r c C s | S �Nr r r r r r ; s � c C sd | t u �rHt�|�}z|j|jjd }W n" ttfyL d}t|��Y n0 z
|j }W nB t
tfy� z |j j }W n t
y� d}t|��Y n0 Y n0 |D ]�} | j �
� D ]�}zNt|tj�s�t|t�r�|j}q�z
|j}W q� t
y� |�|| �}Y q�0 q�W n t
tf�y Y q�Y n0 |j|ju r� �q4q�q� �qHq�d}t|��|t u�r\t| |�S t| �S )zuLike Python 3 builtin super(). If called without any arguments
it attempts to infer them at runtime.
r z'super() used in a function with no argsz$super() used in a non-newstyle classz super() called outside a method)� _SENTINEL�sys� _getframe�f_locals�f_code� co_varnames�
IndexError�KeyError� RuntimeError�__mro__�AttributeError� __class__�__dict__�values�
isinstance�types� FunctionType�property�fget�__func__�__get__� TypeError� func_code�_builtin_super)�type_Z type_or_objZ
framedepth�f�msg�mro�methr r r r J sH
r c s � fdd�}|S )Nc s* G � �fdd�d��� �j � _ �j� _� S )Nc s2 e Zd Z�� fdd�ZG �fdd�de�Z� ZS )zE_instance_checking_exception.<locals>.wrapped.<locals>.TemporaryClassc sh t |�dkrNt|d � �rN|d }t|�D ] }|�d�s*t| |t||�� q*nt� | �j|i |�� d S )Nr r �__)�lenr) �dir�
startswith�setattr�getattrr �__init__)�self�args�kwargsZ unwrap_me�attr)�TemporaryClassr& r r r> � s
��zN_instance_checking_exception.<locals>.wrapped.<locals>.TemporaryClass.__init__c s e Zd Z� fdd�Zdd� ZdS )zS_instance_checking_exception.<locals>.wrapped.<locals>.TemporaryClass.__metaclass__c s � |�S r r )�cls�inst��instance_checkerr r �__instancecheck__� s ze_instance_checking_exception.<locals>.wrapped.<locals>.TemporaryClass.__metaclass__.__instancecheck__c S s t �� d }t|| �S �Nr )r �exc_infor) )rD Z classinfo�valuer r r �__subclasscheck__� s ze_instance_checking_exception.<locals>.wrapped.<locals>.TemporaryClass.__metaclass__.__subclasscheck__N)�__name__�
__module__� __qualname__rH rL r rF r r �
__metaclass__� s rP )rM rN rO r> �typerP �
__classcell__r �rC rG )r& r rC � s rC )rM �__doc__rF ��base_exceptionrS r �wrapped� s z-_instance_checking_exception.<locals>.wrappedr )rV rW r rU r � _instance_checking_exception� s rX c C s t | dt�tjkS �N�errno)r= r rZ �ENOENT�rE r r r r
� s r
c C s t | dt�tjkS rY )r= r rZ ZESRCHr\ r r r r � s r c C s t | dt�tjtjfv S rY )r= r rZ �EACCES�EPERMr\ r r r r � s r c C s t | dt�tjkS rY )r= r rZ ZEINTRr\ r r r r � s r c C s t | dt�tjkS rY )r= r rZ �ECHILDr\ r r r r � s r c C s t | dt�tjkS rY )r= r rZ �EEXISTr\ r r r r � s r �CPython�permzbbroken or incompatible Python implementation, see: https://github.com/giampaolo/psutil/issues/1659)r )�RLock� CacheInfo)�hits�misses�maxsize�currsizec @ s$ e Zd ZdZefdd�Zdd� ZdS )�
_HashedSeq�� hashvaluec C s || d d �< ||�| _ d S r rj )r? �tup�hashr r r r> � s z_HashedSeq.__init__c C s | j S r rj )r? r r r �__hash__� s z_HashedSeq.__hash__N)rM rN rO � __slots__rm r> rn r r r r ri � s ri c s� | } |r.||� � �}
| |7 } |
D ] } | | 7 } q |rl| |� fdd�| D ��7 } |r�| |� fdd�|
D ��7 } n$|| �dkr�� | d �|v r�| d S t| �S )Nc 3 s | ]}� |�V qd S r r )�.0�v�rQ r r � <genexpr> � z _make_key.<locals>.<genexpr>c 3 s | ]\}}� |�V qd S r r )rp �krq rr r r rs rt r r )�itemsri ) r@ �kwds�typed�kwd_mark� fasttypes�sorted�tuplerQ r9 �key� sorted_items�itemr rr r � _make_key� s
r� �d Fc s � �fdd�}|S )zLeast-recently-used cache decorator, see:
http://docs.python.org/3/library/functools.html#functools.lru_cache.
c s i �ddg�
d\� �t �
�j�t�t� � g � � � d d g� d d �< � g� d\�����dkrl��
�fdd�}nP�d u r�� ����
� �
��f dd�}n*� ��������� �
�� �
��fdd�}� ��� ��
fdd �}�� � �
fd
d �}�|_||_||_t�|��S ) Nr )r r )r r � r c s" �| i |��}�� d7 < |S rI r )r@ rw �result)�MISSES�stats�
user_functionr r �wrapper s z7lru_cache.<locals>.decorating_function.<locals>.wrapperc s\ �| |��}�|��}|�ur2�� d7 < |S �| i |��}|�|< �� d7 < |S rI r )r@ rw r} r� ) �HITSr� �cache� cache_get�make_key�rootr� rx r� r r r� ! s
c s� |s�r�
| |��}n| }� � � z��|�}|d ur�� \}|\}}}}||�< ||�< |� }| |�< |�< ||�< ||�< �
� d7 < |W � �� S W � �� n
� �� 0 �| i |��}� � � z�� \}|�v r�n����� k�r4|} || �< || �< | � }� d< |� }
d |�< |�< �|
= | �|< n,|� }||||g}| |�< |�< �|< �
� d7 < W � �� n
� �� 0 |S )Nr r )�acquire�release) r@ rw r} �linkr� Z link_prevZ link_nextr� �lastZoldrootZoldkey)r� �KEYr� �NEXT�PREV�RESULT�_lenr� r� �lockr� rg �
nonlocal_rootr� rx r� r r r� . sR �
c s< �� � z$t�� �� �t���W ��� S ��� 0 dS )zReport cache statistics.N)r� �
_CacheInfor9 r� r )r� r� r� r� rg r� r r �
cache_info[ s ��z:lru_cache.<locals>.decorating_function.<locals>.cache_infoc sX �� � z@� �� �d } | | ddg| dd�< ddg�dd�< W ��� n
��� 0 dS )z%Clear the cache and cache statistics.r N)r� �clearr� )r� )r� r� r� r� r r � cache_cleare s z;lru_cache.<locals>.decorating_function.<locals>.cache_clear) r� �getr9 rc � __wrapped__r� r� � functools�update_wrapper)r� r� r� r� �rg rx )r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r �decorating_function s,
*-
z&lru_cache.<locals>.decorating_functionr )rg rx r� r r� r r s ir )r
c s" dd� }t j�� �r&|� |�r"� S dS |du r>t j�dt j�}|sFdS |�t j�}tj dkr�t j
|vrt|� dt j
� t j�dd��t j�}t � fd d
�|D ��r�� g}q fd d �|D �}n� g}t
� }|D ]P}t j�|�}||vr�|�|� |D ](} t j�|| �}
||
|�r�|
S q�q�dS )
aJ Given a command, mode, and a PATH string, return the path which
conforms to the given mode on the PATH, or None if there is no such
file.
`mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
of os.environ.get("PATH"), or can be overridden with a custom search
path.
c S s& t j�| �o$t �| |�o$t j�| � S r )�os�path�exists�access�isdir)�fn�moder r r �
_access_check� s
� �z which.<locals>._access_checkN�PATH�win32r �PATHEXT� c 3 s | ]}� � � �|� � �V qd S r )�lower�endswith�rp �ext��cmdr r rs � rt zwhich.<locals>.<genexpr>c s g | ] }� | �qS r r r� r� r r �
<listcomp>� rt zwhich.<locals>.<listcomp>)r� r� �dirname�environr� �defpath�split�pathsepr �platform�curdir�insert�any�set�normcase�add�join) r� r� r� r� �pathext�files�seenr: �normdir�thefile�namer r� r r
} s8
r
)r ��P � c C sz z dd l }dd l}dd l}W n ty2 | Y S 0 z*|�d|�d|jd��}|d |d fW S tyt | Y S 0 d S )Nr �hhr Z1234)�fcntl�struct�termios� ImportError�unpack�ioctl�
TIOCGWINSZ� Exception)�fallbackr� r� r� �resr r r r � s
� r )�TimeoutExpiredc @ s e Zd ZdS )�SubprocessTimeoutExpiredN)rM rN rO r r r r r� � s r� )r c c s* t j}z| t _| V W |t _n|t _0 d S r )r �stderr)�
new_target�originalr r r r � s
r )r� F)r� )@rT � collections�
contextlibrZ r� r� r r* �__all__� version_infor �objectr �intr r �xrange�strr r r r r2 r
r r r r r r� r� rX �EnvironmentError�python_implementation�OSErrorr` r5 r# r r� � threadingrc Zdummy_threading�
namedtupler� �listri r� � frozensetrQ r{ r| r9 r� �shutilr
�F_OK�X_OKr �
subprocessr� r� r �contextmanagerr r r r �<module> s�
;
� ��
r 5PK ok\<�R R ( psutil/__pycache__/_psbsd.cpython-39.pycnu �[��� a
��?h�} � @ s� d Z ddlZddlZddlZddlZddlmZ ddlmZ ddlm Z ddl
m Z ddl
m Z dd l
m
Z dd
l
mZ dd l mZ dd l mZ dd
l mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl m Z ddl m Z ddl m Z ddl m Z ddl m!Z! g Z"e�r�ej#e j$ej%e j&ej'e j(ej)e j*ej+e j,ej-e j.ej/e j0iZ1n~e�r�ej#e j$ej'e j(ej)e j*ej2e j,ej+e j,ej%e j3ej4e j&iZ1n:e�r�ej#e j$ej'e j(ej)e j*ej+e j,ej%e j3ej4e j&iZ1ej5e j6ej7e j8ej9e j:ej;e j<ej=e j>ej?e j@ejAe jBejCe jDejEe jFejGe jHejIe jJejKe jLi ZMe�N� ZOejPZPeQed�ZReQed �ZSeQed �ZTeQed �ZUeVddd d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6�ZWed7g d8��ZXed9g d:��ZYed;g d<��ZZeZZ[ed=g d>��Z\ed?d@�Z]edAdB�Z^e�r8edCg dD��Z_nedCg dE��Z_dFdG� Z`dHdI� ZadJdK� ZbeR�rndLd� ZcndMd� ZcdNec_ddOdP� Zee�s�e�r�dQdR� ZfndSdR� ZfdTdU� Zge�r�dVdW� Zhne�r�dXdW� ZhdvdYdZ�Zie jjZjejkZkejlZlejmZmd[d\� Znd]d^� Zoe�rd_d`� Zpdadb� Zqdcdd� Zrdedf� Zsedgdh� �Ztdidj� Zue�rDdkdl� Zvne�rTdmdl� Zvne jvZvdndo� Zwdpdq� Zxejydrds� �ZzG dtdu� du�Z{dS )wz5FreeBSD, OpenBSD and NetBSD platforms implementation.� N)� defaultdict)�
namedtuple)� ElementTree� )�_common)�_psposix)� _psutil_bsd)�
_psutil_posix)�FREEBSD)�NETBSD)�OPENBSD)� AccessDenied)�
NoSuchProcess)�
ZombieProcess)� conn_tmap)�conn_to_ntuple)�debug)�memoize)�memoize_when_activated)�
usage_percent)�FileNotFoundError)�PermissionError)�ProcessLookupError)�which�
per_cpu_times�proc_num_threads�proc_open_files� proc_num_fds� � � � � � � � �
� � �
� � � � � � � � � � � )�ppid�status�real_uid�
effective_uid� saved_uid�real_gid�
effective_gid� saved_gid�ttynr� create_time�ctx_switches_vol�ctx_switches_unvol�
read_io_count�write_io_count� user_time�sys_time� ch_user_time� ch_sys_time�rss�vms�memtext�memdata�memstack�cpunum�name�svmem) �total� available�percent�used�free�active�inactive�buffers�cached�shared�wired� scputimes��user�nice�system�idle�irq�pmem)rG rH �text�data�stack� pcputimes)r\ r^ �
children_user�children_system�
pmmap_grouped�*path rss, private, ref_count, shadow_count� pmmap_ext�6addr, perms path rss, private, ref_count, shadow_count�sdiskio)�
read_count� write_count�
read_bytes� write_bytesZ read_timeZ
write_timeZ busy_time)rm rn ro rp c C s� t �� } tr�| \}}}}}}tdd��X}|D ]B}|�d�rPt|�� d �d } q,|�d�r,t|�� d �d }
q,W d � n1 s�0 Y || } || } n,| \}}}}}}} }
|| | } || | } t|| |dd�}
t|| |
| |||| ||
|� S )Nz
/proc/meminfo�rbs Buffers:r i s
MemShared:�Zround_) �cextZ virtual_memr �open�
startswith�int�splitr rN )ZmemrO rS rT rU rY rW �f�linerV rX rR ZavailrQ � rz �9/usr/local/lib64/python3.9/site-packages/psutil/_psbsd.py�virtual_memory� s8
4
�r| c C s4 t �� \} }}}}t|| dd�}t�| |||||�S )z@System swap memory as (total, used, free, sin, sout) namedtuple.r rr )rs Zswap_memr r Zsswap)rO rR rS �sinZsoutrQ rz rz r{ � swap_memory� s r~ c C s" t �� \} }}}}t| ||||�S )z,Return system per-CPU times as a namedtuple.)rs � cpu_timesrZ r[ rz rz r{ r � s r c C s> g } t �� D ],}|\}}}}}t|||||�}| �|� q | S )�(Return system CPU times as a namedtuple.)rs r rZ �append)�retZcpu_tr\ r] r^ r_ r` �itemrz rz r{ r � s c C s2 t � dkrt� gS tjr$d} t| ��dt_t� gS )r� r �&supported only starting from FreeBSD 8T)�cpu_count_logicalr r �
__called__�NotImplementedError)�msgrz rz r{ r
s
Fc C s t �� S )z0Return the number of logical CPUs in the system.)rs r� rz rz rz r{ r� s r� c C s t � dkrdS d S )Nr )r� rz rz rz r{ �cpu_count_cores s r� c C s� d} t �� }|durj|�d�}|dkrj|d|d � }t�|�}z t|�d��pRd} W |�� n
|�� 0 | s|t� dkr|dS | S )z-Return the number of CPU cores in the system.Nz </groups>���r% zgroup/children/group/cpur ) rs Z cpu_topology�rfindr �
fromstring�len�findall�clearr� )r� �s�index�rootrz rz r{ r� $ s
c C s� t rt�� \} }}}}n�tr�t�� \} }}}}}}tdd��4}|D ] }|�d�rBt|�� d �}qBW d � q�1 sv0 Y ntr�t�� \} }}}}}}t �
| |||�S )z*Return various CPU stats as a named tuple.z
/proc/statrq s intrr N) r
rs � cpu_statsr rt ru rv rw r r Z scpustats) ZctxswZintrsZ
soft_intrsZsyscallsZ_trapsZ_faults�_forksrx ry rz rz r{ r� ? s �
2�r� c
C s� g } t � }t|�D ]�}zt�|�\}}W n ty> Y qY n0 |r�z t|�d�d �d�d �}W n ttfy~ d}Y n0 z t|�d�d �d�d �}W n ttfy� d}Y n0 | � t
� |||�� q| S )z�Return frequency metrics for CPUs. As of Dec 2018 only
CPU 0 appears to be supported by FreeBSD and all other cores
match the frequency of CPU 0.
� r� �/r N) r� �rangers �cpu_freqr� rv rw �
IndexError�
ValueErrorr� r �scpufreq)r� �num_cpus�cpu�currentZavailable_freqZmin_freqZmax_freqrz rz r{ r� a s$
r� c C s t t�� �} t�| dd�gS )Ng )�floatrs r� r r� )�currrz rz r{ r� { s c C s@ g }t �� }|D ]*}|\}}}}t�||||�}|�|� q|S )z�Return mounted disk partitions as a list of namedtuples.
'all' argument is ignored, see:
https://github.com/giampaolo/psutil/issues/906.
)rs �disk_partitionsr Z sdiskpartr� ) �all�retlistZ
partitions� partitionZdeviceZ
mountpointZfstype�opts�ntuplerz rz r{ r� � s r� c
C s� t � �� } i }| D ]�}z&t�|�}t�|�}t�|�\}}W n2 tyn } z|jtjkrZ� W Y d}~qd}~0 0 t t
d�r�t
� |�}d� |�}d|v } t
�
| ||||�||< q|S )z)Get NIC stats (isup, duplex, speed, mtu).N� NicDuplex�,�running)�net_io_counters�keys�
cext_posixZ
net_if_mtuZ net_if_flagsZnet_if_duplex_speed�OSError�errnoZENODEV�hasattrr r� �joinZ snicstats)
�namesr� rM Zmtu�flagsZduplex�speed�errZ output_flagsZisuprz rz r{ � net_if_stats� s$
�
r� c
C s� | t jvr*td| d�dd� tD ��f ��t| \}}t� }trPt�d||�}n trbt�d| �}n t�||�}|D ]6}|\}}}} }
} } t |||| |
| t
| �}
|� |
� qrt |�S )z System-wide network connections.�+invalid %r kind argument; choose between %s�, c S s g | ] }t |��qS rz ��repr��.0�xrz rz r{ �
<listcomp>� � z#net_connections.<locals>.<listcomp>r� )
r r r� r� �setr rs �net_connectionsr r � TCP_STATUSES�add�list)�kind�families�typesr� �rawlistr� �fd�fam�type�laddr�raddrr6 �pid�ntrz rz r{ r� � s(
�� � r� c C sb zt �� \} }}W n ty& Y dS 0 |dk}|r<tj}n|dkrLtj}n|d }t�| ||�S )zReturn battery info.Nr r� �< )rs �sensors_batteryr� r ZPOWER_TIME_UNLIMITEDZPOWER_TIME_UNKNOWNZsbattery)rQ ZminsleftZ
power_pluggedZsecsleftrz rz r{ r� � s r� c C st t t�} t� }t|�D ]X}z@t�|�\}}|dkr6d}d| }| d �t�||||�� W q t yl Y q0 q| S )z?Return CPU cores temperatures if available, else an empty dict.r NzCore %sZcoretemp)
r r� r� r� rs Zsensors_cpu_temperaturer� r Zshwtempr� )r� r� r� r� �highrM rz rz r{ �sensors_temperatures� s � r� c C s t �� S )z:The system boot time expressed in seconds since the epoch.)rs � boot_timerz rz rz r{ r� s r� c C sf g } t �� }|D ]P}|\}}}}}|dkr6ts2J �d}|dkr@qt�||pLd|||�}| �|� q| S )z:Return currently connected users as a list of namedtuples.r� N�~)rs �usersr r Zsuserr� ) r� r� r� r\ �tty�hostnameZtstampr� r� rz rz r{ r� s r� c C s@ zt d��� W n& ty$ Y dS ty6 Y dS 0 dS d S )Nr FT)�ProcessrM r r
rz rz rz r{ �
_pid_0_exists s r� c C s* t �� } tr&d| vr&t� r&| �dd� | S )z7Returns a list of PIDs currently running on the system.r )rs �pidsr r� �insert)r� rz rz r{ r� ' s r� c C s t �| �}|s| t� v S dS d S )NT�r �
pid_existsr� �r� �existsrz rz r{ r� 3 s
r� c C s t �| �}|sdS | t� v S d S )NFr� r� rz rz r{ r� > s
c C s> z$t �| �td }t�|�tjkW S ty8 Y dS 0 d S )Nr6 F)rs �proc_oneshot_info�kinfo_proc_map�
PROC_STATUSES�getr �
STATUS_ZOMBIEr� )r� �strz rz r{ � is_zombieL s
r� c s t �� �� fdd��}|S )z`Decorator which translates bare OSError exceptions into
NoSuchProcess and AccessDenied.
c s� z� | g|�R i |��W S t yV t| j�rDt| j| j| j��nt| j| j��Y nX tyt t| j| j��Y n: t y� | jdkr�dt
� v r�t| j| j��n� � Y n0 d S )Nr ) r r� r� r �_name�_ppidr r r
r� r� )�self�args�kwargs��funrz r{ �wrapperY s
z wrap_exceptions.<locals>.wrapper)� functools�wraps)r� r� rz r� r{ �wrap_exceptionsT s r� c c sp z
dV W n` t tfyL t| j�r:t| j| j| j��nt| j| j��Y n tyj t | j| j��Y n0 dS )z8Same as above, for routines relying on reading /proc fs.N)
r r r� r� r r� r� r r r
)�instrz rz r{ �wrap_exceptions_procfso s
r� c @ s� e Zd ZdZg d�Zdd� Zdd� Zeedd� ��Z d d
� Z
d d � Z ed
d� �Z edd� �Z
edd� �Zedd� �Zedd� �Zedd� �Zedd� �Zedd � �Zed d � �Zer�ed d � �Zed!d"� �ZeZed#d$� �Zed%d&� �Zed'd(� �Zed)d*� �Z edLd,d-��Z edMd/d0��Z ed1d2� �Z ed3d4� �Z ed5d6� �Z!ed7d8� �Z"ed9d:� �Z#e$d;d<�Z%e$d;d=�Z&d>d?� Z'e(�r�ed@dA� �Z)ne'Z)e*�r�edBdC� �Z+ne'Z+e�r�edDdE� �Z,edFdG� �Z-edHdI� �Z.edNdJdK��Z/d.S )Or� z1Wrapper class around underlying C implementation.)�_cacher� r� r� c C s || _ d | _d | _d S �N)r� r� r� )r� r� rz rz r{ �__init__� s zProcess.__init__c C s t �| j� dS )z+Raise NSP if the process disappeared on us.N)rs � proc_namer� �r� rz rz r{ �
_assert_alive� s zProcess._assert_alivec C s$ t �| j�}t|�tt�ks J �|S )z;Retrieves multiple process info in one shot as a raw tuple.)rs r� r� r� r� �r� r� rz rz r{ �oneshot� s zProcess.oneshotc C s | j �| � d S r� )r� Zcache_activater� rz rz r{ �
oneshot_enter� s zProcess.oneshot_enterc C s | j �| � d S r� )r� Zcache_deactivater� rz rz r{ � oneshot_exit� s zProcess.oneshot_exitc C s( | � � td }|d ur |S t�| j�S )NrM )r� r� rs r� r� )r� rM rz rz r{ rM � s z Process.namec C s� t r | jdkrdS t�| j�S trj| jdkr0dS t| �� t�d| j �W d � S 1 s^0 Y n | �� }|r�t |d �p�dS dS d S )Nr � z /proc/%s/exe)
r
r� rs Zproc_exer r� �os�readlink�cmdliner )r� r rz rz r{ �exe� s
0z Process.exec
C s� t r| jdkrg S tr�zt�| j�W S ty� } zt|jtjkr�t| j�r^t | j| j
| j ��q�t | j�s|t
| j| j
| j ��q�td| � g W Y d }~S n� W Y d }~q�d }~0 0 n t�| j�S d S )Nr z'ignoring %r and returning an empty list)r r� r rs Z proc_cmdliner� r� �EINVALr� r r� r� r� r r )r� r� rz rz r{ r � s
zProcess.cmdlinec C s t �| j�S r� )rs Z proc_environr� r� rz rz r{ �environ� s zProcess.environc C s< | � � td }t�� }z
|| W S ty6 Y d S 0 d S )Nr= )r� r� r Zget_terminal_map�KeyError)r� Ztty_nrZtmaprz rz r{ �terminal� s
zProcess.terminalc C s | � � td | _| jS )Nr5 )r� r� r� r� rz rz r{ r5 � s z Process.ppidc C s. | � � }t�|td |td |td �S )Nr7 r8 r9 )r� r Zpuidsr� �r� Zrawtuplerz rz r{ �uids� s
�z Process.uidsc C s. | � � }t�|td |td |td �S )Nr: r; r< )r� r Zpgidsr� r rz rz r{ �gids� s
�z Process.gidsc C s8 | � � }t�|td |td |td |td �S )NrC rD rE rF )r� r re r� r rz rz r{ r � s
�zProcess.cpu_timesc C s | � � td S )NrL �r� r� r� rz rz r{ �cpu_num s zProcess.cpu_numc C s@ | � � }t|td |td |td |td |td �S )NrG rH rI rJ rK )r� ra r� r rz rz r{ � memory_info
s
�zProcess.memory_infoc C s | � � td S )Nr> r
r� rz rz r{ r> s zProcess.create_timec C s t rt�| j�S t| �� �S d S r� )�HAS_PROC_NUM_THREADSrs r r� r� �threadsr� rz rz r{ � num_threads s zProcess.num_threadsc C s$ | � � }t�|td |td �S )Nr? r@ )r� r Zpctxswr� r rz rz r{ �num_ctx_switches# s
�zProcess.num_ctx_switchesc C sH t �| j�}g }|D ]"\}}}t�|||�}|�|� qtrD| �� |S r� )rs Z proc_threadsr� r Zpthreadr� r r� )r� r� r� � thread_id�utimeZstimer� rz rz r{ r + s zProcess.threads�inetc C s� |t vr(td|d�dd� t D ��f ��t | \}}g }trLt�| j|�}n&trbt�| j||�}nt�| j||�}|D ]P}|d d� \}}} }
} } t r�||vsv| |vr�qvt
||| |
| | t �}
|� |
� qv| �
� |S )Nr� r� c S s g | ] }t |��qS rz r� r� rz rz r{ r� < r� z+Process.net_connections.<locals>.<listcomp>r" )r r� r� r rs r� r� r Zproc_net_connectionsr
r r� r� r� )r� r� r� r� r� r� r� r� r� r� r� r� r6 r� rz rz r{ r� 7 s0 �� � zProcess.net_connectionsNc C s t �| j|| j�S r� )r Zwait_pidr� r� )r� �timeoutrz rz r{ �waitU s z Process.waitc C s t �| j�S r� )r� � getpriorityr� r� rz rz r{ �nice_getY s zProcess.nice_getc C s t �| j|�S r� )r� � setpriorityr� )r� �valuerz rz r{ �nice_set] s zProcess.nice_setc C s | � � td }t�|d�S )Nr6 �?)r� r� r� r� )r� �coderz rz r{ r6 a s zProcess.statusc C s( | � � }t�|td |td dd�S )NrA rB r� )r� r Zpior� r rz rz r{ � io_countersg s
�zProcess.io_countersc C s: t r| jdkrdS tstr&t�| j�S ttr0dnd��dS )z)Return process current working directory.r r� r� N)r r� r �HAS_PROC_OPEN_FILESrs Zproc_cwdr� r
r� rz rz r{ �cwdq s
�z Process.cwdZmmapri rk c C s t �d S r� )r� r� rz rz r{ �_not_implemented� s zProcess._not_implementedc C s t �| j�}dd� |D �S )z8Return files opened by process as a list of namedtuples.c S s g | ]\}}t �||��qS rz )r Z popenfile)r� �pathr� rz rz r{ r� � r� z&Process.open_files.<locals>.<listcomp>)rs r r� )r� r� rz rz r{ �
open_files� s zProcess.open_filesc C s t �| j�}tr| �� |S )z=Return the number of file descriptors opened by this process.)rs r r� r r� r� rz rz r{ �num_fds� s zProcess.num_fdsc C s t �| j�S r� )rs Zproc_cpu_affinity_getr� r� rz rz r{ �cpu_affinity_get� s zProcess.cpu_affinity_getc
C s� t ttt� ���}|D ] }||vrtd||f ��qzt�| j|� W nZ ty� } zB|j t j
t j fv r�|D ] }||vrltd||f ��ql� W Y d }~n
d }~0 0 d S )Nz#invalid CPU #%i (choose between %s)) �tupler� r� r r� rs Zproc_cpu_affinity_setr� r� r� r ZEDEADLK)r� ZcpusZallcpusr� r� rz rz r{ �cpu_affinity_set� s$
���zProcess.cpu_affinity_setc C s t �| j�S r� )rs Zproc_memory_mapsr� r� rz rz r{ � memory_maps� s zProcess.memory_mapsc C sP |d u rt �| j|�S t|�dkr2tdt|� ��|\}}t �| j|||�S d S )Nr z4second argument must be a (soft, hard) tuple, got %s)rs Zproc_getrlimitr� r� r� r� Zproc_setrlimit)r� �resourceZlimitsZsoft�hardrz rz r{ �rlimit� s ��zProcess.rlimit)r )N)N)0�__name__�
__module__� __qualname__�__doc__� __slots__r� r� r� r r� r� r� rM r r r r r5 r r r r
r r Zmemory_full_infor> r r r r� r r r r6 r r r Znt_mmap_groupedZ nt_mmap_extr r r" �HAS_PROC_NUM_FDSr# r$ r& r' r* rz rz rz r{ r� � s�
��
r� )F)|r. �
contextlibr� r� r� � collectionsr r Z xml.etreer r� r r r rs r r� r
r r r
r r r r r r r r Z_compatr r r r Z__extra__all__ZSIDLZ STATUS_IDLEZSRUNZSTATUS_RUNNINGZSSLEEPZSTATUS_SLEEPINGZSSTOPZSTATUS_STOPPEDZSZOMBr� ZSWAITZSTATUS_WAITINGZSLOCKZ
STATUS_LOCKEDr� ZSDEADZ
STATUS_WAKINGZSONPROCZTCPS_ESTABLISHEDZCONN_ESTABLISHEDZ
TCPS_SYN_SENTZ
CONN_SYN_SENTZTCPS_SYN_RECEIVEDZ
CONN_SYN_RECVZTCPS_FIN_WAIT_1ZCONN_FIN_WAIT1ZTCPS_FIN_WAIT_2ZCONN_FIN_WAIT2ZTCPS_TIME_WAITZCONN_TIME_WAITZ TCPS_CLOSEDZ
CONN_CLOSEZTCPS_CLOSE_WAITZCONN_CLOSE_WAITZ
TCPS_LAST_ACKZ
CONN_LAST_ACKZ TCPS_LISTENZ CONN_LISTENZ TCPS_CLOSINGZ CONN_CLOSINGZPSUTIL_CONN_NONEZ CONN_NONEr� Z getpagesizeZPAGESIZEZAF_LINKr� ZHAS_PER_CPU_TIMESr
r r0 �dictr� rN rZ ra Zpfullmemre rh rj rl r| r~ r r r� r� r� r� r� r� �
disk_usageZdisk_io_countersr� Z net_if_addrsr� r� r� r� r� r� r� r� r� r� r� �contextmanagerr� r� rz rz rz r{ �<module> sB � ��
�
�$�����
/
PK ok\ s�L+t +t psutil/_common.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Common objects shared by __init__.py and _ps*.py modules."""
# Note: this module is imported by setup.py so it should not import
# psutil or third-party modules.
from __future__ import division
from __future__ import print_function
import collections
import contextlib
import errno
import functools
import os
import socket
import stat
import sys
import threading
import warnings
from collections import namedtuple
from socket import AF_INET
from socket import SOCK_DGRAM
from socket import SOCK_STREAM
try:
from socket import AF_INET6
except ImportError:
AF_INET6 = None
try:
from socket import AF_UNIX
except ImportError:
AF_UNIX = None
# can't take it from _common.py as this script is imported by setup.py
PY3 = sys.version_info[0] >= 3
if PY3:
import enum
else:
enum = None
PSUTIL_DEBUG = bool(os.getenv('PSUTIL_DEBUG'))
_DEFAULT = object()
# fmt: off
__all__ = [
# OS constants
'FREEBSD', 'BSD', 'LINUX', 'NETBSD', 'OPENBSD', 'MACOS', 'OSX', 'POSIX',
'SUNOS', 'WINDOWS',
# connection constants
'CONN_CLOSE', 'CONN_CLOSE_WAIT', 'CONN_CLOSING', 'CONN_ESTABLISHED',
'CONN_FIN_WAIT1', 'CONN_FIN_WAIT2', 'CONN_LAST_ACK', 'CONN_LISTEN',
'CONN_NONE', 'CONN_SYN_RECV', 'CONN_SYN_SENT', 'CONN_TIME_WAIT',
# net constants
'NIC_DUPLEX_FULL', 'NIC_DUPLEX_HALF', 'NIC_DUPLEX_UNKNOWN',
# process status constants
'STATUS_DEAD', 'STATUS_DISK_SLEEP', 'STATUS_IDLE', 'STATUS_LOCKED',
'STATUS_RUNNING', 'STATUS_SLEEPING', 'STATUS_STOPPED', 'STATUS_SUSPENDED',
'STATUS_TRACING_STOP', 'STATUS_WAITING', 'STATUS_WAKE_KILL',
'STATUS_WAKING', 'STATUS_ZOMBIE', 'STATUS_PARKED',
# other constants
'ENCODING', 'ENCODING_ERRS', 'AF_INET6',
# named tuples
'pconn', 'pcputimes', 'pctxsw', 'pgids', 'pio', 'pionice', 'popenfile',
'pthread', 'puids', 'sconn', 'scpustats', 'sdiskio', 'sdiskpart',
'sdiskusage', 'snetio', 'snicaddr', 'snicstats', 'sswap', 'suser',
# utility functions
'conn_tmap', 'deprecated_method', 'isfile_strict', 'memoize',
'parse_environ_block', 'path_exists_strict', 'usage_percent',
'supports_ipv6', 'sockfam_to_enum', 'socktype_to_enum', "wrap_numbers",
'open_text', 'open_binary', 'cat', 'bcat',
'bytes2human', 'conn_to_ntuple', 'debug',
# shell utils
'hilite', 'term_supports_colors', 'print_color',
]
# fmt: on
# ===================================================================
# --- OS constants
# ===================================================================
POSIX = os.name == "posix"
WINDOWS = os.name == "nt"
LINUX = sys.platform.startswith("linux")
MACOS = sys.platform.startswith("darwin")
OSX = MACOS # deprecated alias
FREEBSD = sys.platform.startswith(("freebsd", "midnightbsd"))
OPENBSD = sys.platform.startswith("openbsd")
NETBSD = sys.platform.startswith("netbsd")
BSD = FREEBSD or OPENBSD or NETBSD
SUNOS = sys.platform.startswith(("sunos", "solaris"))
AIX = sys.platform.startswith("aix")
# ===================================================================
# --- API constants
# ===================================================================
# Process.status()
STATUS_RUNNING = "running"
STATUS_SLEEPING = "sleeping"
STATUS_DISK_SLEEP = "disk-sleep"
STATUS_STOPPED = "stopped"
STATUS_TRACING_STOP = "tracing-stop"
STATUS_ZOMBIE = "zombie"
STATUS_DEAD = "dead"
STATUS_WAKE_KILL = "wake-kill"
STATUS_WAKING = "waking"
STATUS_IDLE = "idle" # Linux, macOS, FreeBSD
STATUS_LOCKED = "locked" # FreeBSD
STATUS_WAITING = "waiting" # FreeBSD
STATUS_SUSPENDED = "suspended" # NetBSD
STATUS_PARKED = "parked" # Linux
# Process.net_connections() and psutil.net_connections()
CONN_ESTABLISHED = "ESTABLISHED"
CONN_SYN_SENT = "SYN_SENT"
CONN_SYN_RECV = "SYN_RECV"
CONN_FIN_WAIT1 = "FIN_WAIT1"
CONN_FIN_WAIT2 = "FIN_WAIT2"
CONN_TIME_WAIT = "TIME_WAIT"
CONN_CLOSE = "CLOSE"
CONN_CLOSE_WAIT = "CLOSE_WAIT"
CONN_LAST_ACK = "LAST_ACK"
CONN_LISTEN = "LISTEN"
CONN_CLOSING = "CLOSING"
CONN_NONE = "NONE"
# net_if_stats()
if enum is None:
NIC_DUPLEX_FULL = 2
NIC_DUPLEX_HALF = 1
NIC_DUPLEX_UNKNOWN = 0
else:
class NicDuplex(enum.IntEnum):
NIC_DUPLEX_FULL = 2
NIC_DUPLEX_HALF = 1
NIC_DUPLEX_UNKNOWN = 0
globals().update(NicDuplex.__members__)
# sensors_battery()
if enum is None:
POWER_TIME_UNKNOWN = -1
POWER_TIME_UNLIMITED = -2
else:
class BatteryTime(enum.IntEnum):
POWER_TIME_UNKNOWN = -1
POWER_TIME_UNLIMITED = -2
globals().update(BatteryTime.__members__)
# --- others
ENCODING = sys.getfilesystemencoding()
if not PY3:
ENCODING_ERRS = "replace"
else:
try:
ENCODING_ERRS = sys.getfilesystemencodeerrors() # py 3.6
except AttributeError:
ENCODING_ERRS = "surrogateescape" if POSIX else "replace"
# ===================================================================
# --- namedtuples
# ===================================================================
# --- for system functions
# fmt: off
# psutil.swap_memory()
sswap = namedtuple('sswap', ['total', 'used', 'free', 'percent', 'sin',
'sout'])
# psutil.disk_usage()
sdiskusage = namedtuple('sdiskusage', ['total', 'used', 'free', 'percent'])
# psutil.disk_io_counters()
sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
'read_bytes', 'write_bytes',
'read_time', 'write_time'])
# psutil.disk_partitions()
sdiskpart = namedtuple('sdiskpart', ['device', 'mountpoint', 'fstype', 'opts'])
# psutil.net_io_counters()
snetio = namedtuple('snetio', ['bytes_sent', 'bytes_recv',
'packets_sent', 'packets_recv',
'errin', 'errout',
'dropin', 'dropout'])
# psutil.users()
suser = namedtuple('suser', ['name', 'terminal', 'host', 'started', 'pid'])
# psutil.net_connections()
sconn = namedtuple('sconn', ['fd', 'family', 'type', 'laddr', 'raddr',
'status', 'pid'])
# psutil.net_if_addrs()
snicaddr = namedtuple('snicaddr',
['family', 'address', 'netmask', 'broadcast', 'ptp'])
# psutil.net_if_stats()
snicstats = namedtuple('snicstats',
['isup', 'duplex', 'speed', 'mtu', 'flags'])
# psutil.cpu_stats()
scpustats = namedtuple(
'scpustats', ['ctx_switches', 'interrupts', 'soft_interrupts', 'syscalls'])
# psutil.cpu_freq()
scpufreq = namedtuple('scpufreq', ['current', 'min', 'max'])
# psutil.sensors_temperatures()
shwtemp = namedtuple(
'shwtemp', ['label', 'current', 'high', 'critical'])
# psutil.sensors_battery()
sbattery = namedtuple('sbattery', ['percent', 'secsleft', 'power_plugged'])
# psutil.sensors_fans()
sfan = namedtuple('sfan', ['label', 'current'])
# fmt: on
# --- for Process methods
# psutil.Process.cpu_times()
pcputimes = namedtuple(
'pcputimes', ['user', 'system', 'children_user', 'children_system']
)
# psutil.Process.open_files()
popenfile = namedtuple('popenfile', ['path', 'fd'])
# psutil.Process.threads()
pthread = namedtuple('pthread', ['id', 'user_time', 'system_time'])
# psutil.Process.uids()
puids = namedtuple('puids', ['real', 'effective', 'saved'])
# psutil.Process.gids()
pgids = namedtuple('pgids', ['real', 'effective', 'saved'])
# psutil.Process.io_counters()
pio = namedtuple(
'pio', ['read_count', 'write_count', 'read_bytes', 'write_bytes']
)
# psutil.Process.ionice()
pionice = namedtuple('pionice', ['ioclass', 'value'])
# psutil.Process.ctx_switches()
pctxsw = namedtuple('pctxsw', ['voluntary', 'involuntary'])
# psutil.Process.net_connections()
pconn = namedtuple(
'pconn', ['fd', 'family', 'type', 'laddr', 'raddr', 'status']
)
# psutil.net_connections() and psutil.Process.net_connections()
addr = namedtuple('addr', ['ip', 'port'])
# ===================================================================
# --- Process.net_connections() 'kind' parameter mapping
# ===================================================================
conn_tmap = {
"all": ([AF_INET, AF_INET6, AF_UNIX], [SOCK_STREAM, SOCK_DGRAM]),
"tcp": ([AF_INET, AF_INET6], [SOCK_STREAM]),
"tcp4": ([AF_INET], [SOCK_STREAM]),
"udp": ([AF_INET, AF_INET6], [SOCK_DGRAM]),
"udp4": ([AF_INET], [SOCK_DGRAM]),
"inet": ([AF_INET, AF_INET6], [SOCK_STREAM, SOCK_DGRAM]),
"inet4": ([AF_INET], [SOCK_STREAM, SOCK_DGRAM]),
"inet6": ([AF_INET6], [SOCK_STREAM, SOCK_DGRAM]),
}
if AF_INET6 is not None:
conn_tmap.update({
"tcp6": ([AF_INET6], [SOCK_STREAM]),
"udp6": ([AF_INET6], [SOCK_DGRAM]),
})
if AF_UNIX is not None:
conn_tmap.update({"unix": ([AF_UNIX], [SOCK_STREAM, SOCK_DGRAM])})
# =====================================================================
# --- Exceptions
# =====================================================================
class Error(Exception):
"""Base exception class. All other psutil exceptions inherit
from this one.
"""
__module__ = 'psutil'
def _infodict(self, attrs):
info = collections.OrderedDict()
for name in attrs:
value = getattr(self, name, None)
if value: # noqa
info[name] = value
elif name == "pid" and value == 0:
info[name] = value
return info
def __str__(self):
# invoked on `raise Error`
info = self._infodict(("pid", "ppid", "name"))
if info:
details = "(%s)" % ", ".join(
["%s=%r" % (k, v) for k, v in info.items()]
)
else:
details = None
return " ".join([x for x in (getattr(self, "msg", ""), details) if x])
def __repr__(self):
# invoked on `repr(Error)`
info = self._infodict(("pid", "ppid", "name", "seconds", "msg"))
details = ", ".join(["%s=%r" % (k, v) for k, v in info.items()])
return "psutil.%s(%s)" % (self.__class__.__name__, details)
class NoSuchProcess(Error):
"""Exception raised when a process with a certain PID doesn't
or no longer exists.
"""
__module__ = 'psutil'
def __init__(self, pid, name=None, msg=None):
Error.__init__(self)
self.pid = pid
self.name = name
self.msg = msg or "process no longer exists"
def __reduce__(self):
return (self.__class__, (self.pid, self.name, self.msg))
class ZombieProcess(NoSuchProcess):
"""Exception raised when querying a zombie process. This is
raised on macOS, BSD and Solaris only, and not always: depending
on the query the OS may be able to succeed anyway.
On Linux all zombie processes are querable (hence this is never
raised). Windows doesn't have zombie processes.
"""
__module__ = 'psutil'
def __init__(self, pid, name=None, ppid=None, msg=None):
NoSuchProcess.__init__(self, pid, name, msg)
self.ppid = ppid
self.msg = msg or "PID still exists but it's a zombie"
def __reduce__(self):
return (self.__class__, (self.pid, self.name, self.ppid, self.msg))
class AccessDenied(Error):
"""Exception raised when permission to perform an action is denied."""
__module__ = 'psutil'
def __init__(self, pid=None, name=None, msg=None):
Error.__init__(self)
self.pid = pid
self.name = name
self.msg = msg or ""
def __reduce__(self):
return (self.__class__, (self.pid, self.name, self.msg))
class TimeoutExpired(Error):
"""Raised on Process.wait(timeout) if timeout expires and process
is still alive.
"""
__module__ = 'psutil'
def __init__(self, seconds, pid=None, name=None):
Error.__init__(self)
self.seconds = seconds
self.pid = pid
self.name = name
self.msg = "timeout after %s seconds" % seconds
def __reduce__(self):
return (self.__class__, (self.seconds, self.pid, self.name))
# ===================================================================
# --- utils
# ===================================================================
# This should be in _compat.py rather than here, but does not work well
# with setup.py importing this module via a sys.path trick.
if PY3:
if isinstance(__builtins__, dict): # cpython
exec_ = __builtins__["exec"]
else: # pypy
exec_ = getattr(__builtins__, "exec") # noqa
exec_("""def raise_from(value, from_value):
try:
raise value from from_value
finally:
value = None
""")
else:
def raise_from(value, from_value):
raise value
def usage_percent(used, total, round_=None):
"""Calculate percentage usage of 'used' against 'total'."""
try:
ret = (float(used) / total) * 100
except ZeroDivisionError:
return 0.0
else:
if round_ is not None:
ret = round(ret, round_)
return ret
def memoize(fun):
"""A simple memoize decorator for functions supporting (hashable)
positional arguments.
It also provides a cache_clear() function for clearing the cache:
>>> @memoize
... def foo()
... return 1
...
>>> foo()
1
>>> foo.cache_clear()
>>>
It supports:
- functions
- classes (acts as a @singleton)
- staticmethods
- classmethods
It does NOT support:
- methods
"""
@functools.wraps(fun)
def wrapper(*args, **kwargs):
key = (args, frozenset(sorted(kwargs.items())))
try:
return cache[key]
except KeyError:
try:
ret = cache[key] = fun(*args, **kwargs)
except Exception as err: # noqa: BLE001
raise raise_from(err, None)
return ret
def cache_clear():
"""Clear cache."""
cache.clear()
cache = {}
wrapper.cache_clear = cache_clear
return wrapper
def memoize_when_activated(fun):
"""A memoize decorator which is disabled by default. It can be
activated and deactivated on request.
For efficiency reasons it can be used only against class methods
accepting no arguments.
>>> class Foo:
... @memoize
... def foo()
... print(1)
...
>>> f = Foo()
>>> # deactivated (default)
>>> foo()
1
>>> foo()
1
>>>
>>> # activated
>>> foo.cache_activate(self)
>>> foo()
1
>>> foo()
>>> foo()
>>>
"""
@functools.wraps(fun)
def wrapper(self):
try:
# case 1: we previously entered oneshot() ctx
ret = self._cache[fun]
except AttributeError:
# case 2: we never entered oneshot() ctx
try:
return fun(self)
except Exception as err: # noqa: BLE001
raise raise_from(err, None)
except KeyError:
# case 3: we entered oneshot() ctx but there's no cache
# for this entry yet
try:
ret = fun(self)
except Exception as err: # noqa: BLE001
raise raise_from(err, None)
try:
self._cache[fun] = ret
except AttributeError:
# multi-threading race condition, see:
# https://github.com/giampaolo/psutil/issues/1948
pass
return ret
def cache_activate(proc):
"""Activate cache. Expects a Process instance. Cache will be
stored as a "_cache" instance attribute.
"""
proc._cache = {}
def cache_deactivate(proc):
"""Deactivate and clear cache."""
try:
del proc._cache
except AttributeError:
pass
wrapper.cache_activate = cache_activate
wrapper.cache_deactivate = cache_deactivate
return wrapper
def isfile_strict(path):
"""Same as os.path.isfile() but does not swallow EACCES / EPERM
exceptions, see:
http://mail.python.org/pipermail/python-dev/2012-June/120787.html.
"""
try:
st = os.stat(path)
except OSError as err:
if err.errno in (errno.EPERM, errno.EACCES):
raise
return False
else:
return stat.S_ISREG(st.st_mode)
def path_exists_strict(path):
"""Same as os.path.exists() but does not swallow EACCES / EPERM
exceptions. See:
http://mail.python.org/pipermail/python-dev/2012-June/120787.html.
"""
try:
os.stat(path)
except OSError as err:
if err.errno in (errno.EPERM, errno.EACCES):
raise
return False
else:
return True
@memoize
def supports_ipv6():
"""Return True if IPv6 is supported on this platform."""
if not socket.has_ipv6 or AF_INET6 is None:
return False
try:
sock = socket.socket(AF_INET6, socket.SOCK_STREAM)
with contextlib.closing(sock):
sock.bind(("::1", 0))
return True
except socket.error:
return False
def parse_environ_block(data):
"""Parse a C environ block of environment variables into a dictionary."""
# The block is usually raw data from the target process. It might contain
# trailing garbage and lines that do not look like assignments.
ret = {}
pos = 0
# localize global variable to speed up access.
WINDOWS_ = WINDOWS
while True:
next_pos = data.find("\0", pos)
# nul byte at the beginning or double nul byte means finish
if next_pos <= pos:
break
# there might not be an equals sign
equal_pos = data.find("=", pos, next_pos)
if equal_pos > pos:
key = data[pos:equal_pos]
value = data[equal_pos + 1 : next_pos]
# Windows expects environment variables to be uppercase only
if WINDOWS_:
key = key.upper()
ret[key] = value
pos = next_pos + 1
return ret
def sockfam_to_enum(num):
"""Convert a numeric socket family value to an IntEnum member.
If it's not a known member, return the numeric value itself.
"""
if enum is None:
return num
else: # pragma: no cover
try:
return socket.AddressFamily(num)
except ValueError:
return num
def socktype_to_enum(num):
"""Convert a numeric socket type value to an IntEnum member.
If it's not a known member, return the numeric value itself.
"""
if enum is None:
return num
else: # pragma: no cover
try:
return socket.SocketKind(num)
except ValueError:
return num
def conn_to_ntuple(fd, fam, type_, laddr, raddr, status, status_map, pid=None):
"""Convert a raw connection tuple to a proper ntuple."""
if fam in (socket.AF_INET, AF_INET6):
if laddr:
laddr = addr(*laddr)
if raddr:
raddr = addr(*raddr)
if type_ == socket.SOCK_STREAM and fam in (AF_INET, AF_INET6):
status = status_map.get(status, CONN_NONE)
else:
status = CONN_NONE # ignore whatever C returned to us
fam = sockfam_to_enum(fam)
type_ = socktype_to_enum(type_)
if pid is None:
return pconn(fd, fam, type_, laddr, raddr, status)
else:
return sconn(fd, fam, type_, laddr, raddr, status, pid)
def deprecated_method(replacement):
"""A decorator which can be used to mark a method as deprecated
'replcement' is the method name which will be called instead.
"""
def outer(fun):
msg = "%s() is deprecated and will be removed; use %s() instead" % (
fun.__name__,
replacement,
)
if fun.__doc__ is None:
fun.__doc__ = msg
@functools.wraps(fun)
def inner(self, *args, **kwargs):
warnings.warn(msg, category=DeprecationWarning, stacklevel=2)
return getattr(self, replacement)(*args, **kwargs)
return inner
return outer
class _WrapNumbers:
"""Watches numbers so that they don't overflow and wrap
(reset to zero).
"""
def __init__(self):
self.lock = threading.Lock()
self.cache = {}
self.reminders = {}
self.reminder_keys = {}
def _add_dict(self, input_dict, name):
assert name not in self.cache
assert name not in self.reminders
assert name not in self.reminder_keys
self.cache[name] = input_dict
self.reminders[name] = collections.defaultdict(int)
self.reminder_keys[name] = collections.defaultdict(set)
def _remove_dead_reminders(self, input_dict, name):
"""In case the number of keys changed between calls (e.g. a
disk disappears) this removes the entry from self.reminders.
"""
old_dict = self.cache[name]
gone_keys = set(old_dict.keys()) - set(input_dict.keys())
for gone_key in gone_keys:
for remkey in self.reminder_keys[name][gone_key]:
del self.reminders[name][remkey]
del self.reminder_keys[name][gone_key]
def run(self, input_dict, name):
"""Cache dict and sum numbers which overflow and wrap.
Return an updated copy of `input_dict`.
"""
if name not in self.cache:
# This was the first call.
self._add_dict(input_dict, name)
return input_dict
self._remove_dead_reminders(input_dict, name)
old_dict = self.cache[name]
new_dict = {}
for key in input_dict:
input_tuple = input_dict[key]
try:
old_tuple = old_dict[key]
except KeyError:
# The input dict has a new key (e.g. a new disk or NIC)
# which didn't exist in the previous call.
new_dict[key] = input_tuple
continue
bits = []
for i in range(len(input_tuple)):
input_value = input_tuple[i]
old_value = old_tuple[i]
remkey = (key, i)
if input_value < old_value:
# it wrapped!
self.reminders[name][remkey] += old_value
self.reminder_keys[name][key].add(remkey)
bits.append(input_value + self.reminders[name][remkey])
new_dict[key] = tuple(bits)
self.cache[name] = input_dict
return new_dict
def cache_clear(self, name=None):
"""Clear the internal cache, optionally only for function 'name'."""
with self.lock:
if name is None:
self.cache.clear()
self.reminders.clear()
self.reminder_keys.clear()
else:
self.cache.pop(name, None)
self.reminders.pop(name, None)
self.reminder_keys.pop(name, None)
def cache_info(self):
"""Return internal cache dicts as a tuple of 3 elements."""
with self.lock:
return (self.cache, self.reminders, self.reminder_keys)
def wrap_numbers(input_dict, name):
"""Given an `input_dict` and a function `name`, adjust the numbers
which "wrap" (restart from zero) across different calls by adding
"old value" to "new value" and return an updated dict.
"""
with _wn.lock:
return _wn.run(input_dict, name)
_wn = _WrapNumbers()
wrap_numbers.cache_clear = _wn.cache_clear
wrap_numbers.cache_info = _wn.cache_info
# The read buffer size for open() builtin. This (also) dictates how
# much data we read(2) when iterating over file lines as in:
# >>> with open(file) as f:
# ... for line in f:
# ... ...
# Default per-line buffer size for binary files is 1K. For text files
# is 8K. We use a bigger buffer (32K) in order to have more consistent
# results when reading /proc pseudo files on Linux, see:
# https://github.com/giampaolo/psutil/issues/2050
# On Python 2 this also speeds up the reading of big files:
# (namely /proc/{pid}/smaps and /proc/net/*):
# https://github.com/giampaolo/psutil/issues/708
FILE_READ_BUFFER_SIZE = 32 * 1024
def open_binary(fname):
return open(fname, "rb", buffering=FILE_READ_BUFFER_SIZE)
def open_text(fname):
"""On Python 3 opens a file in text mode by using fs encoding and
a proper en/decoding errors handler.
On Python 2 this is just an alias for open(name, 'rt').
"""
if not PY3:
return open(fname, buffering=FILE_READ_BUFFER_SIZE)
# See:
# https://github.com/giampaolo/psutil/issues/675
# https://github.com/giampaolo/psutil/pull/733
fobj = open(
fname,
buffering=FILE_READ_BUFFER_SIZE,
encoding=ENCODING,
errors=ENCODING_ERRS,
)
try:
# Dictates per-line read(2) buffer size. Defaults is 8k. See:
# https://github.com/giampaolo/psutil/issues/2050#issuecomment-1013387546
fobj._CHUNK_SIZE = FILE_READ_BUFFER_SIZE
except AttributeError:
pass
except Exception:
fobj.close()
raise
return fobj
def cat(fname, fallback=_DEFAULT, _open=open_text):
"""Read entire file content and return it as a string. File is
opened in text mode. If specified, `fallback` is the value
returned in case of error, either if the file does not exist or
it can't be read().
"""
if fallback is _DEFAULT:
with _open(fname) as f:
return f.read()
else:
try:
with _open(fname) as f:
return f.read()
except (IOError, OSError):
return fallback
def bcat(fname, fallback=_DEFAULT):
"""Same as above but opens file in binary mode."""
return cat(fname, fallback=fallback, _open=open_binary)
def bytes2human(n, format="%(value).1f%(symbol)s"):
"""Used by various scripts. See: http://goo.gl/zeJZl.
>>> bytes2human(10000)
'9.8K'
>>> bytes2human(100001221)
'95.4M'
"""
symbols = ('B', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y')
prefix = {}
for i, s in enumerate(symbols[1:]):
prefix[s] = 1 << (i + 1) * 10
for symbol in reversed(symbols[1:]):
if abs(n) >= prefix[symbol]:
value = float(n) / prefix[symbol]
return format % locals()
return format % dict(symbol=symbols[0], value=n)
def get_procfs_path():
"""Return updated psutil.PROCFS_PATH constant."""
return sys.modules['psutil'].PROCFS_PATH
if PY3:
def decode(s):
return s.decode(encoding=ENCODING, errors=ENCODING_ERRS)
else:
def decode(s):
return s
# =====================================================================
# --- shell utils
# =====================================================================
@memoize
def term_supports_colors(file=sys.stdout): # pragma: no cover
if os.name == 'nt':
return True
try:
import curses
assert file.isatty()
curses.setupterm()
assert curses.tigetnum("colors") > 0
except Exception: # noqa: BLE001
return False
else:
return True
def hilite(s, color=None, bold=False): # pragma: no cover
"""Return an highlighted version of 'string'."""
if not term_supports_colors():
return s
attr = []
colors = dict(
blue='34',
brown='33',
darkgrey='30',
green='32',
grey='37',
lightblue='36',
red='91',
violet='35',
yellow='93',
)
colors[None] = '29'
try:
color = colors[color]
except KeyError:
raise ValueError(
"invalid color %r; choose between %s" % (list(colors.keys()))
)
attr.append(color)
if bold:
attr.append('1')
return '\x1b[%sm%s\x1b[0m' % (';'.join(attr), s)
def print_color(
s, color=None, bold=False, file=sys.stdout
): # pragma: no cover
"""Print a colorized version of string."""
if not term_supports_colors():
print(s, file=file) # NOQA
elif POSIX:
print(hilite(s, color, bold), file=file) # NOQA
else:
import ctypes
DEFAULT_COLOR = 7
GetStdHandle = ctypes.windll.Kernel32.GetStdHandle
SetConsoleTextAttribute = (
ctypes.windll.Kernel32.SetConsoleTextAttribute
)
colors = dict(green=2, red=4, brown=6, yellow=6)
colors[None] = DEFAULT_COLOR
try:
color = colors[color]
except KeyError:
raise ValueError(
"invalid color %r; choose between %r"
% (color, list(colors.keys()))
)
if bold and color <= 7:
color += 8
handle_id = -12 if file is sys.stderr else -11
GetStdHandle.restype = ctypes.c_ulong
handle = GetStdHandle(handle_id)
SetConsoleTextAttribute(handle, color)
try:
print(s, file=file) # NOQA
finally:
SetConsoleTextAttribute(handle, DEFAULT_COLOR)
def debug(msg):
"""If PSUTIL_DEBUG env var is set, print a debug message to stderr."""
if PSUTIL_DEBUG:
import inspect
fname, lineno, _, _lines, _index = inspect.getframeinfo(
inspect.currentframe().f_back
)
if isinstance(msg, Exception):
if isinstance(msg, (OSError, IOError, EnvironmentError)):
# ...because str(exc) may contain info about the file name
msg = "ignoring %s" % msg
else:
msg = "ignoring %r" % msg
print( # noqa
"psutil-debug [%s:%s]> %s" % (fname, lineno, msg), file=sys.stderr
)
PK ok\�*Ǘ�H �H psutil/_psaix.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'
# Copyright (c) 2017, Arnon Yaari
# All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""AIX platform implementation."""
import functools
import glob
import os
import re
import subprocess
import sys
from collections import namedtuple
from . import _common
from . import _psposix
from . import _psutil_aix as cext
from . import _psutil_posix as cext_posix
from ._common import NIC_DUPLEX_FULL
from ._common import NIC_DUPLEX_HALF
from ._common import NIC_DUPLEX_UNKNOWN
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import ZombieProcess
from ._common import conn_to_ntuple
from ._common import get_procfs_path
from ._common import memoize_when_activated
from ._common import usage_percent
from ._compat import PY3
from ._compat import FileNotFoundError
from ._compat import PermissionError
from ._compat import ProcessLookupError
__extra__all__ = ["PROCFS_PATH"]
# =====================================================================
# --- globals
# =====================================================================
HAS_THREADS = hasattr(cext, "proc_threads")
HAS_NET_IO_COUNTERS = hasattr(cext, "net_io_counters")
HAS_PROC_IO_COUNTERS = hasattr(cext, "proc_io_counters")
PAGE_SIZE = cext_posix.getpagesize()
AF_LINK = cext_posix.AF_LINK
PROC_STATUSES = {
cext.SIDL: _common.STATUS_IDLE,
cext.SZOMB: _common.STATUS_ZOMBIE,
cext.SACTIVE: _common.STATUS_RUNNING,
cext.SSWAP: _common.STATUS_RUNNING, # TODO what status is this?
cext.SSTOP: _common.STATUS_STOPPED,
}
TCP_STATUSES = {
cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
cext.TCPS_SYN_RCVD: _common.CONN_SYN_RECV,
cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
cext.TCPS_CLOSED: _common.CONN_CLOSE,
cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
cext.TCPS_LISTEN: _common.CONN_LISTEN,
cext.TCPS_CLOSING: _common.CONN_CLOSING,
cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
}
proc_info_map = dict(
ppid=0,
rss=1,
vms=2,
create_time=3,
nice=4,
num_threads=5,
status=6,
ttynr=7,
)
# =====================================================================
# --- named tuples
# =====================================================================
# psutil.Process.memory_info()
pmem = namedtuple('pmem', ['rss', 'vms'])
# psutil.Process.memory_full_info()
pfullmem = pmem
# psutil.Process.cpu_times()
scputimes = namedtuple('scputimes', ['user', 'system', 'idle', 'iowait'])
# psutil.virtual_memory()
svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
# =====================================================================
# --- memory
# =====================================================================
def virtual_memory():
total, avail, free, _pinned, inuse = cext.virtual_mem()
percent = usage_percent((total - avail), total, round_=1)
return svmem(total, avail, percent, inuse, free)
def swap_memory():
"""Swap system memory as a (total, used, free, sin, sout) tuple."""
total, free, sin, sout = cext.swap_mem()
used = total - free
percent = usage_percent(used, total, round_=1)
return _common.sswap(total, used, free, percent, sin, sout)
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return system-wide CPU times as a named tuple."""
ret = cext.per_cpu_times()
return scputimes(*[sum(x) for x in zip(*ret)])
def per_cpu_times():
"""Return system per-CPU times as a list of named tuples."""
ret = cext.per_cpu_times()
return [scputimes(*x) for x in ret]
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
try:
return os.sysconf("SC_NPROCESSORS_ONLN")
except ValueError:
# mimic os.cpu_count() behavior
return None
def cpu_count_cores():
cmd = ["lsdev", "-Cc", "processor"]
p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
stdout, stderr = p.communicate()
if PY3:
stdout, stderr = (
x.decode(sys.stdout.encoding) for x in (stdout, stderr)
)
if p.returncode != 0:
raise RuntimeError("%r command error\n%s" % (cmd, stderr))
processors = stdout.strip().splitlines()
return len(processors) or None
def cpu_stats():
"""Return various CPU stats as a named tuple."""
ctx_switches, interrupts, soft_interrupts, syscalls = cext.cpu_stats()
return _common.scpustats(
ctx_switches, interrupts, soft_interrupts, syscalls
)
# =====================================================================
# --- disks
# =====================================================================
disk_io_counters = cext.disk_io_counters
disk_usage = _psposix.disk_usage
def disk_partitions(all=False):
"""Return system disk partitions."""
# TODO - the filtering logic should be better checked so that
# it tries to reflect 'df' as much as possible
retlist = []
partitions = cext.disk_partitions()
for partition in partitions:
device, mountpoint, fstype, opts = partition
if device == 'none':
device = ''
if not all:
# Differently from, say, Linux, we don't have a list of
# common fs types so the best we can do, AFAIK, is to
# filter by filesystem having a total size > 0.
if not disk_usage(mountpoint).total:
continue
ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
retlist.append(ntuple)
return retlist
# =====================================================================
# --- network
# =====================================================================
net_if_addrs = cext_posix.net_if_addrs
if HAS_NET_IO_COUNTERS:
net_io_counters = cext.net_io_counters
def net_connections(kind, _pid=-1):
"""Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
"""
cmap = _common.conn_tmap
if kind not in cmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in cmap]))
)
families, types = _common.conn_tmap[kind]
rawlist = cext.net_connections(_pid)
ret = []
for item in rawlist:
fd, fam, type_, laddr, raddr, status, pid = item
if fam not in families:
continue
if type_ not in types:
continue
nt = conn_to_ntuple(
fd,
fam,
type_,
laddr,
raddr,
status,
TCP_STATUSES,
pid=pid if _pid == -1 else None,
)
ret.append(nt)
return ret
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
duplex_map = {"Full": NIC_DUPLEX_FULL, "Half": NIC_DUPLEX_HALF}
names = set([x[0] for x in net_if_addrs()])
ret = {}
for name in names:
mtu = cext_posix.net_if_mtu(name)
flags = cext_posix.net_if_flags(name)
# try to get speed and duplex
# TODO: rewrite this in C (entstat forks, so use truss -f to follow.
# looks like it is using an undocumented ioctl?)
duplex = ""
speed = 0
p = subprocess.Popen(
["/usr/bin/entstat", "-d", name],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
)
stdout, stderr = p.communicate()
if PY3:
stdout, stderr = (
x.decode(sys.stdout.encoding) for x in (stdout, stderr)
)
if p.returncode == 0:
re_result = re.search(
r"Running: (\d+) Mbps.*?(\w+) Duplex", stdout
)
if re_result is not None:
speed = int(re_result.group(1))
duplex = re_result.group(2)
output_flags = ','.join(flags)
isup = 'running' in flags
duplex = duplex_map.get(duplex, NIC_DUPLEX_UNKNOWN)
ret[name] = _common.snicstats(isup, duplex, speed, mtu, output_flags)
return ret
# =====================================================================
# --- other system functions
# =====================================================================
def boot_time():
"""The system boot time expressed in seconds since the epoch."""
return cext.boot_time()
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
localhost = (':0.0', ':0')
for item in rawlist:
user, tty, hostname, tstamp, user_process, pid = item
# note: the underlying C function includes entries about
# system boot, run level and others. We might want
# to use them in the future.
if not user_process:
continue
if hostname in localhost:
hostname = 'localhost'
nt = _common.suser(user, tty, hostname, tstamp, pid)
retlist.append(nt)
return retlist
# =====================================================================
# --- processes
# =====================================================================
def pids():
"""Returns a list of PIDs currently running on the system."""
return [int(x) for x in os.listdir(get_procfs_path()) if x.isdigit()]
def pid_exists(pid):
"""Check for the existence of a unix pid."""
return os.path.exists(os.path.join(get_procfs_path(), str(pid), "psinfo"))
def wrap_exceptions(fun):
"""Call callable into a try/except clause and translate ENOENT,
EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except (FileNotFoundError, ProcessLookupError):
# ENOENT (no such file or directory) gets raised on open().
# ESRCH (no such process) can get raised on read() if
# process is gone in meantime.
if not pid_exists(self.pid):
raise NoSuchProcess(self.pid, self._name)
else:
raise ZombieProcess(self.pid, self._name, self._ppid)
except PermissionError:
raise AccessDenied(self.pid, self._name)
return wrapper
class Process:
"""Wrapper class around underlying C implementation."""
__slots__ = ["_cache", "_name", "_ppid", "_procfs_path", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
self._procfs_path = get_procfs_path()
def oneshot_enter(self):
self._proc_basic_info.cache_activate(self)
self._proc_cred.cache_activate(self)
def oneshot_exit(self):
self._proc_basic_info.cache_deactivate(self)
self._proc_cred.cache_deactivate(self)
@wrap_exceptions
@memoize_when_activated
def _proc_basic_info(self):
return cext.proc_basic_info(self.pid, self._procfs_path)
@wrap_exceptions
@memoize_when_activated
def _proc_cred(self):
return cext.proc_cred(self.pid, self._procfs_path)
@wrap_exceptions
def name(self):
if self.pid == 0:
return "swapper"
# note: max 16 characters
return cext.proc_name(self.pid, self._procfs_path).rstrip("\x00")
@wrap_exceptions
def exe(self):
# there is no way to get executable path in AIX other than to guess,
# and guessing is more complex than what's in the wrapping class
cmdline = self.cmdline()
if not cmdline:
return ''
exe = cmdline[0]
if os.path.sep in exe:
# relative or absolute path
if not os.path.isabs(exe):
# if cwd has changed, we're out of luck - this may be wrong!
exe = os.path.abspath(os.path.join(self.cwd(), exe))
if (
os.path.isabs(exe)
and os.path.isfile(exe)
and os.access(exe, os.X_OK)
):
return exe
# not found, move to search in PATH using basename only
exe = os.path.basename(exe)
# search for exe name PATH
for path in os.environ["PATH"].split(":"):
possible_exe = os.path.abspath(os.path.join(path, exe))
if os.path.isfile(possible_exe) and os.access(
possible_exe, os.X_OK
):
return possible_exe
return ''
@wrap_exceptions
def cmdline(self):
return cext.proc_args(self.pid)
@wrap_exceptions
def environ(self):
return cext.proc_environ(self.pid)
@wrap_exceptions
def create_time(self):
return self._proc_basic_info()[proc_info_map['create_time']]
@wrap_exceptions
def num_threads(self):
return self._proc_basic_info()[proc_info_map['num_threads']]
if HAS_THREADS:
@wrap_exceptions
def threads(self):
rawlist = cext.proc_threads(self.pid)
retlist = []
for thread_id, utime, stime in rawlist:
ntuple = _common.pthread(thread_id, utime, stime)
retlist.append(ntuple)
# The underlying C implementation retrieves all OS threads
# and filters them by PID. At this point we can't tell whether
# an empty list means there were no connections for process or
# process is no longer active so we force NSP in case the PID
# is no longer there.
if not retlist:
# will raise NSP if process is gone
os.stat('%s/%s' % (self._procfs_path, self.pid))
return retlist
@wrap_exceptions
def net_connections(self, kind='inet'):
ret = net_connections(kind, _pid=self.pid)
# The underlying C implementation retrieves all OS connections
# and filters them by PID. At this point we can't tell whether
# an empty list means there were no connections for process or
# process is no longer active so we force NSP in case the PID
# is no longer there.
if not ret:
# will raise NSP if process is gone
os.stat('%s/%s' % (self._procfs_path, self.pid))
return ret
@wrap_exceptions
def nice_get(self):
return cext_posix.getpriority(self.pid)
@wrap_exceptions
def nice_set(self, value):
return cext_posix.setpriority(self.pid, value)
@wrap_exceptions
def ppid(self):
self._ppid = self._proc_basic_info()[proc_info_map['ppid']]
return self._ppid
@wrap_exceptions
def uids(self):
real, effective, saved, _, _, _ = self._proc_cred()
return _common.puids(real, effective, saved)
@wrap_exceptions
def gids(self):
_, _, _, real, effective, saved = self._proc_cred()
return _common.puids(real, effective, saved)
@wrap_exceptions
def cpu_times(self):
t = cext.proc_cpu_times(self.pid, self._procfs_path)
return _common.pcputimes(*t)
@wrap_exceptions
def terminal(self):
ttydev = self._proc_basic_info()[proc_info_map['ttynr']]
# convert from 64-bit dev_t to 32-bit dev_t and then map the device
ttydev = ((ttydev & 0x0000FFFF00000000) >> 16) | (ttydev & 0xFFFF)
# try to match rdev of /dev/pts/* files ttydev
for dev in glob.glob("/dev/**/*"):
if os.stat(dev).st_rdev == ttydev:
return dev
return None
@wrap_exceptions
def cwd(self):
procfs_path = self._procfs_path
try:
result = os.readlink("%s/%s/cwd" % (procfs_path, self.pid))
return result.rstrip('/')
except FileNotFoundError:
os.stat("%s/%s" % (procfs_path, self.pid)) # raise NSP or AD
return ""
@wrap_exceptions
def memory_info(self):
ret = self._proc_basic_info()
rss = ret[proc_info_map['rss']] * 1024
vms = ret[proc_info_map['vms']] * 1024
return pmem(rss, vms)
memory_full_info = memory_info
@wrap_exceptions
def status(self):
code = self._proc_basic_info()[proc_info_map['status']]
# XXX is '?' legit? (we're not supposed to return it anyway)
return PROC_STATUSES.get(code, '?')
def open_files(self):
# TODO rewrite without using procfiles (stat /proc/pid/fd/* and then
# find matching name of the inode)
p = subprocess.Popen(
["/usr/bin/procfiles", "-n", str(self.pid)],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
)
stdout, stderr = p.communicate()
if PY3:
stdout, stderr = (
x.decode(sys.stdout.encoding) for x in (stdout, stderr)
)
if "no such process" in stderr.lower():
raise NoSuchProcess(self.pid, self._name)
procfiles = re.findall(r"(\d+): S_IFREG.*name:(.*)\n", stdout)
retlist = []
for fd, path in procfiles:
path = path.strip()
if path.startswith("//"):
path = path[1:]
if path.lower() == "cannot be retrieved":
continue
retlist.append(_common.popenfile(path, int(fd)))
return retlist
@wrap_exceptions
def num_fds(self):
if self.pid == 0: # no /proc/0/fd
return 0
return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
@wrap_exceptions
def num_ctx_switches(self):
return _common.pctxsw(*cext.proc_num_ctx_switches(self.pid))
@wrap_exceptions
def wait(self, timeout=None):
return _psposix.wait_pid(self.pid, timeout, self._name)
if HAS_PROC_IO_COUNTERS:
@wrap_exceptions
def io_counters(self):
try:
rc, wc, rb, wb = cext.proc_io_counters(self.pid)
except OSError:
# if process is terminated, proc_io_counters returns OSError
# instead of NSP
if not pid_exists(self.pid):
raise NoSuchProcess(self.pid, self._name)
raise
return _common.pio(rc, wc, rb, wb)
PK ok\,��S? ? psutil/_psosx.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""macOS platform implementation."""
import errno
import functools
import os
from collections import namedtuple
from . import _common
from . import _psposix
from . import _psutil_osx as cext
from . import _psutil_posix as cext_posix
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import ZombieProcess
from ._common import conn_tmap
from ._common import conn_to_ntuple
from ._common import isfile_strict
from ._common import memoize_when_activated
from ._common import parse_environ_block
from ._common import usage_percent
from ._compat import PermissionError
from ._compat import ProcessLookupError
__extra__all__ = []
# =====================================================================
# --- globals
# =====================================================================
PAGESIZE = cext_posix.getpagesize()
AF_LINK = cext_posix.AF_LINK
TCP_STATUSES = {
cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
cext.TCPS_SYN_RECEIVED: _common.CONN_SYN_RECV,
cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
cext.TCPS_CLOSED: _common.CONN_CLOSE,
cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
cext.TCPS_LISTEN: _common.CONN_LISTEN,
cext.TCPS_CLOSING: _common.CONN_CLOSING,
cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
}
PROC_STATUSES = {
cext.SIDL: _common.STATUS_IDLE,
cext.SRUN: _common.STATUS_RUNNING,
cext.SSLEEP: _common.STATUS_SLEEPING,
cext.SSTOP: _common.STATUS_STOPPED,
cext.SZOMB: _common.STATUS_ZOMBIE,
}
kinfo_proc_map = dict(
ppid=0,
ruid=1,
euid=2,
suid=3,
rgid=4,
egid=5,
sgid=6,
ttynr=7,
ctime=8,
status=9,
name=10,
)
pidtaskinfo_map = dict(
cpuutime=0,
cpustime=1,
rss=2,
vms=3,
pfaults=4,
pageins=5,
numthreads=6,
volctxsw=7,
)
# =====================================================================
# --- named tuples
# =====================================================================
# fmt: off
# psutil.cpu_times()
scputimes = namedtuple('scputimes', ['user', 'nice', 'system', 'idle'])
# psutil.virtual_memory()
svmem = namedtuple(
'svmem', ['total', 'available', 'percent', 'used', 'free',
'active', 'inactive', 'wired'])
# psutil.Process.memory_info()
pmem = namedtuple('pmem', ['rss', 'vms', 'pfaults', 'pageins'])
# psutil.Process.memory_full_info()
pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', ))
# fmt: on
# =====================================================================
# --- memory
# =====================================================================
def virtual_memory():
"""System virtual memory as a namedtuple."""
total, active, inactive, wired, free, speculative = cext.virtual_mem()
# This is how Zabbix calculate avail and used mem:
# https://github.com/zabbix/zabbix/blob/trunk/src/libs/zbxsysinfo/
# osx/memory.c
# Also see: https://github.com/giampaolo/psutil/issues/1277
avail = inactive + free
used = active + wired
# This is NOT how Zabbix calculates free mem but it matches "free"
# cmdline utility.
free -= speculative
percent = usage_percent((total - avail), total, round_=1)
return svmem(total, avail, percent, used, free, active, inactive, wired)
def swap_memory():
"""Swap system memory as a (total, used, free, sin, sout) tuple."""
total, used, free, sin, sout = cext.swap_mem()
percent = usage_percent(used, total, round_=1)
return _common.sswap(total, used, free, percent, sin, sout)
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return system CPU times as a namedtuple."""
user, nice, system, idle = cext.cpu_times()
return scputimes(user, nice, system, idle)
def per_cpu_times():
"""Return system CPU times as a named tuple."""
ret = []
for cpu_t in cext.per_cpu_times():
user, nice, system, idle = cpu_t
item = scputimes(user, nice, system, idle)
ret.append(item)
return ret
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
return cext.cpu_count_logical()
def cpu_count_cores():
"""Return the number of CPU cores in the system."""
return cext.cpu_count_cores()
def cpu_stats():
ctx_switches, interrupts, soft_interrupts, syscalls, _traps = (
cext.cpu_stats()
)
return _common.scpustats(
ctx_switches, interrupts, soft_interrupts, syscalls
)
def cpu_freq():
"""Return CPU frequency.
On macOS per-cpu frequency is not supported.
Also, the returned frequency never changes, see:
https://arstechnica.com/civis/viewtopic.php?f=19&t=465002.
"""
curr, min_, max_ = cext.cpu_freq()
return [_common.scpufreq(curr, min_, max_)]
# =====================================================================
# --- disks
# =====================================================================
disk_usage = _psposix.disk_usage
disk_io_counters = cext.disk_io_counters
def disk_partitions(all=False):
"""Return mounted disk partitions as a list of namedtuples."""
retlist = []
partitions = cext.disk_partitions()
for partition in partitions:
device, mountpoint, fstype, opts = partition
if device == 'none':
device = ''
if not all:
if not os.path.isabs(device) or not os.path.exists(device):
continue
ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
retlist.append(ntuple)
return retlist
# =====================================================================
# --- sensors
# =====================================================================
def sensors_battery():
"""Return battery information."""
try:
percent, minsleft, power_plugged = cext.sensors_battery()
except NotImplementedError:
# no power source - return None according to interface
return None
power_plugged = power_plugged == 1
if power_plugged:
secsleft = _common.POWER_TIME_UNLIMITED
elif minsleft == -1:
secsleft = _common.POWER_TIME_UNKNOWN
else:
secsleft = minsleft * 60
return _common.sbattery(percent, secsleft, power_plugged)
# =====================================================================
# --- network
# =====================================================================
net_io_counters = cext.net_io_counters
net_if_addrs = cext_posix.net_if_addrs
def net_connections(kind='inet'):
"""System-wide network connections."""
# Note: on macOS this will fail with AccessDenied unless
# the process is owned by root.
ret = []
for pid in pids():
try:
cons = Process(pid).net_connections(kind)
except NoSuchProcess:
continue
else:
if cons:
for c in cons:
c = list(c) + [pid]
ret.append(_common.sconn(*c))
return ret
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
names = net_io_counters().keys()
ret = {}
for name in names:
try:
mtu = cext_posix.net_if_mtu(name)
flags = cext_posix.net_if_flags(name)
duplex, speed = cext_posix.net_if_duplex_speed(name)
except OSError as err:
# https://github.com/giampaolo/psutil/issues/1279
if err.errno != errno.ENODEV:
raise
else:
if hasattr(_common, 'NicDuplex'):
duplex = _common.NicDuplex(duplex)
output_flags = ','.join(flags)
isup = 'running' in flags
ret[name] = _common.snicstats(
isup, duplex, speed, mtu, output_flags
)
return ret
# =====================================================================
# --- other system functions
# =====================================================================
def boot_time():
"""The system boot time expressed in seconds since the epoch."""
return cext.boot_time()
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
for item in rawlist:
user, tty, hostname, tstamp, pid = item
if tty == '~':
continue # reboot or shutdown
if not tstamp:
continue
nt = _common.suser(user, tty or None, hostname or None, tstamp, pid)
retlist.append(nt)
return retlist
# =====================================================================
# --- processes
# =====================================================================
def pids():
ls = cext.pids()
if 0 not in ls:
# On certain macOS versions pids() C doesn't return PID 0 but
# "ps" does and the process is querable via sysctl():
# https://travis-ci.org/giampaolo/psutil/jobs/309619941
try:
Process(0).create_time()
ls.insert(0, 0)
except NoSuchProcess:
pass
except AccessDenied:
ls.insert(0, 0)
return ls
pid_exists = _psposix.pid_exists
def is_zombie(pid):
try:
st = cext.proc_kinfo_oneshot(pid)[kinfo_proc_map['status']]
return st == cext.SZOMB
except OSError:
return False
def wrap_exceptions(fun):
"""Decorator which translates bare OSError exceptions into
NoSuchProcess and AccessDenied.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except ProcessLookupError:
if is_zombie(self.pid):
raise ZombieProcess(self.pid, self._name, self._ppid)
else:
raise NoSuchProcess(self.pid, self._name)
except PermissionError:
raise AccessDenied(self.pid, self._name)
return wrapper
class Process:
"""Wrapper class around underlying C implementation."""
__slots__ = ["_cache", "_name", "_ppid", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
@wrap_exceptions
@memoize_when_activated
def _get_kinfo_proc(self):
# Note: should work with all PIDs without permission issues.
ret = cext.proc_kinfo_oneshot(self.pid)
assert len(ret) == len(kinfo_proc_map)
return ret
@wrap_exceptions
@memoize_when_activated
def _get_pidtaskinfo(self):
# Note: should work for PIDs owned by user only.
ret = cext.proc_pidtaskinfo_oneshot(self.pid)
assert len(ret) == len(pidtaskinfo_map)
return ret
def oneshot_enter(self):
self._get_kinfo_proc.cache_activate(self)
self._get_pidtaskinfo.cache_activate(self)
def oneshot_exit(self):
self._get_kinfo_proc.cache_deactivate(self)
self._get_pidtaskinfo.cache_deactivate(self)
@wrap_exceptions
def name(self):
name = self._get_kinfo_proc()[kinfo_proc_map['name']]
return name if name is not None else cext.proc_name(self.pid)
@wrap_exceptions
def exe(self):
return cext.proc_exe(self.pid)
@wrap_exceptions
def cmdline(self):
return cext.proc_cmdline(self.pid)
@wrap_exceptions
def environ(self):
return parse_environ_block(cext.proc_environ(self.pid))
@wrap_exceptions
def ppid(self):
self._ppid = self._get_kinfo_proc()[kinfo_proc_map['ppid']]
return self._ppid
@wrap_exceptions
def cwd(self):
return cext.proc_cwd(self.pid)
@wrap_exceptions
def uids(self):
rawtuple = self._get_kinfo_proc()
return _common.puids(
rawtuple[kinfo_proc_map['ruid']],
rawtuple[kinfo_proc_map['euid']],
rawtuple[kinfo_proc_map['suid']],
)
@wrap_exceptions
def gids(self):
rawtuple = self._get_kinfo_proc()
return _common.puids(
rawtuple[kinfo_proc_map['rgid']],
rawtuple[kinfo_proc_map['egid']],
rawtuple[kinfo_proc_map['sgid']],
)
@wrap_exceptions
def terminal(self):
tty_nr = self._get_kinfo_proc()[kinfo_proc_map['ttynr']]
tmap = _psposix.get_terminal_map()
try:
return tmap[tty_nr]
except KeyError:
return None
@wrap_exceptions
def memory_info(self):
rawtuple = self._get_pidtaskinfo()
return pmem(
rawtuple[pidtaskinfo_map['rss']],
rawtuple[pidtaskinfo_map['vms']],
rawtuple[pidtaskinfo_map['pfaults']],
rawtuple[pidtaskinfo_map['pageins']],
)
@wrap_exceptions
def memory_full_info(self):
basic_mem = self.memory_info()
uss = cext.proc_memory_uss(self.pid)
return pfullmem(*basic_mem + (uss,))
@wrap_exceptions
def cpu_times(self):
rawtuple = self._get_pidtaskinfo()
return _common.pcputimes(
rawtuple[pidtaskinfo_map['cpuutime']],
rawtuple[pidtaskinfo_map['cpustime']],
# children user / system times are not retrievable (set to 0)
0.0,
0.0,
)
@wrap_exceptions
def create_time(self):
return self._get_kinfo_proc()[kinfo_proc_map['ctime']]
@wrap_exceptions
def num_ctx_switches(self):
# Unvoluntary value seems not to be available;
# getrusage() numbers seems to confirm this theory.
# We set it to 0.
vol = self._get_pidtaskinfo()[pidtaskinfo_map['volctxsw']]
return _common.pctxsw(vol, 0)
@wrap_exceptions
def num_threads(self):
return self._get_pidtaskinfo()[pidtaskinfo_map['numthreads']]
@wrap_exceptions
def open_files(self):
if self.pid == 0:
return []
files = []
rawlist = cext.proc_open_files(self.pid)
for path, fd in rawlist:
if isfile_strict(path):
ntuple = _common.popenfile(path, fd)
files.append(ntuple)
return files
@wrap_exceptions
def net_connections(self, kind='inet'):
if kind not in conn_tmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in conn_tmap]))
)
families, types = conn_tmap[kind]
rawlist = cext.proc_net_connections(self.pid, families, types)
ret = []
for item in rawlist:
fd, fam, type, laddr, raddr, status = item
nt = conn_to_ntuple(
fd, fam, type, laddr, raddr, status, TCP_STATUSES
)
ret.append(nt)
return ret
@wrap_exceptions
def num_fds(self):
if self.pid == 0:
return 0
return cext.proc_num_fds(self.pid)
@wrap_exceptions
def wait(self, timeout=None):
return _psposix.wait_pid(self.pid, timeout, self._name)
@wrap_exceptions
def nice_get(self):
return cext_posix.getpriority(self.pid)
@wrap_exceptions
def nice_set(self, value):
return cext_posix.setpriority(self.pid, value)
@wrap_exceptions
def status(self):
code = self._get_kinfo_proc()[kinfo_proc_map['status']]
# XXX is '?' legit? (we're not supposed to return it anyway)
return PROC_STATUSES.get(code, '?')
@wrap_exceptions
def threads(self):
rawlist = cext.proc_threads(self.pid)
retlist = []
for thread_id, utime, stime in rawlist:
ntuple = _common.pthread(thread_id, utime, stime)
retlist.append(ntuple)
return retlist
PK ok\݄� � psutil/_psutil_posix.abi3.sonu ȯ�� ELF > �" @ @ 8 @ # " P P ] ] @ @ @ �M �] �] �M �] �] � � 8 8 8 $ $ P�td �B �B �B � � Q�td R�td �M �] �] @ @ GNU �/���Ъ�+���O.����Y * !�8 � � � * . 4 �ȷԸf���W�~� ���:hde���l�H�����������$���r: � � � � B � � � � M < � � � ( � � � � � � - n � 6 N v � � 8 � R " � ~ �4 W � �# � ] p% W � �% ) c P4
� �4 i a @# � ~ �b % j T7 � P5 � p$ � __gmon_start__ _init _fini _ITM_deregisterTMCloneTable _ITM_registerTMCloneTable __cxa_finalize psutil_PyErr_SetFromOSErrnoWithSyscall __errno_location strerror sprintf PyExc_OSError PyObject_CallFunction PyErr_SetObject _Py_Dealloc NoSuchProcess AccessDenied psutil_check_pid_range PyArg_ParseTuple _Py_NoneStruct PyExc_ValueError PyErr_SetString psutil_set_debug PyObject_IsTrue PSUTIL_DEBUG psutil_setup getenv socket strncpy ioctl close Py_BuildValue PyErr_SetFromErrno _Py_TrueStruct _Py_FalseStruct setpriority getnameinfo PyList_New getifaddrs PyList_Append freeifaddrs getpriority PyUnicode_FromString psutil_getpagesize sysconf psutil_pid_exists kill psutil_raise_for_pid PyExc_RuntimeError PyErr_Format PyInit__psutil_posix PyModule_Create2 PyModule_AddIntConstant PyLong_FromLong PyModule_AddObject libpthread.so.0 libc.so.6 GLIBC_2.2.5 GLIBC_2.3 + ui E ; ii
Q ui E �] 0# �] �" �] �] ha VB �a �a �a dB �a `4 �a pB �a �, b |B b ) b �B (b P- @b �B Hb �& `b �B hb & �b �B �b �' �_ �_ �_
�_ �_ �_ �_ �_ �_ 1 �_ & �_ ( ` ` (` 0` 8` @` H` P` X`
`` h` p` . x` �` �` �` �` �` �` �` �` �` �` 0 �` �` �` �` * �` + �` a ! a " a # a $ a % (a ' 0a ( 8a ) H��H��? H��t�+ H��� �5�? �%�? @ �%�? h ����%�? h �����%�? h ����%�? h ����%�? h ����%�? h ����%�? h ����%�? h �p����%�? h �`����%�? h �P����%�? h
�@����%�? h �0����%�? h � ����%z? h
�����%r? h � ����%j? h ���%b? h ����%Z? h �����%R? h ����%J? h ����%B? h ����%:? h ����%2? h ����%*? h �p����%"? h �`����%? h �P����%? h �@����%
? h �0����%? h � ����%�> h �����%�> h � ����%�> h ���%�> h ����%�> h! �����%�> h" ����%�> h# ����%�> h$ ���H�=9@ H�2@ H9�tH�= H��t �� � � � H�= @ H�5@ H)�H��H��?H��H�H�tH�= H��t��f D � � �=�? u/UH�=�< H��t H�=�: �M����h�����? ]� � � � �{���f. � �AUATI��UH�� � ���I��8H�����L��H�5� L��H��1������U 1�L��L�%9< H�5� I�<$���I�<$H��H���
���H��tH�m tH�� 1�]A\A]� � H������H�� 1�]A\A]ÐATH��H�5D 1�USH�� I��L���>���1�L�� H� �; H�5� H�;�.���H�;H��H�����H��tH�m tH�� 1�[]A\�f D H���H���H�� 1�[]A\�f. � ATH��H�5� 1�USH�� I��L�����1�L��
H� ; H�5n H�;���H�;H��H����H��tH�m tH�� 1�[]A\�f D H�����H�� 1�[]A\�f. � H��H��H�5� 1�H�T$ �����t"�D$ ��x*H��: H� H���f. � 1�H���f � H�a: H�52 H�8�Z���1���f D H��H��H�5� 1�H�T$�6�����t2H�|$������x$H�E: ���҉H�&: H� H��� D 1�H���f � H��H�=B �P���H��t
H��9 � 1�H��� � UH��1�H�5� H��@H�T$���A��1�E��tc1Ҿ � �:����Ń��tXL�D$H�t$� L��� �����!� �D$ H��1�������t ����t$ H�=/ 1�����H��@]�f��k���H�$9 H�8���H��@]�f D UH��1�H�5� H��@H�T$���A��1�E��tm1Ҿ � ����Ń��thL�D$H�t$� L���l������ �D$ H��1��������t/�����D$ @tCH�5�8 H�=� 1�� ���H��@]� � ���H�d8 H�8�,���H��@]�f D H�5Q8 H�=� 1�����H��@]� D H��H��H�5 1�H�L$ H�T$����A��1�E��t �T$ �t$1��������tH�8 H� H��� H��7 H�8�����ff. � @ H���� AW��AV��AUATUSH�� ��u\��� � H��E�H��E1�E1�j� H�����H���� H�v7 H� H�� []A\A]A^A_� � ��u�D�w M��t�I��H��N�,7L��L�% D �S H��L��1�H��H������I9�u�K�vL��H�=� �D� 1�����f D H��H�=� 1��g����h���f�H��6 H� � @ AW1�AVAUATUSH��(����H�D$H���� H�|$�c�������f H�l$H���� �, � ��0 H�i6 H� I��I��H��H�uD��M��AUI��L��H�=" 1�����I��XZM���� H�|$L��L�$�t���L�$���� I�*�N I�,$�V H�+�^ I�/�f I�m �n H�m H���w H�}H��t�D�7D�����H;�5 I��t�H���= H�} D�����H��H���E �E��
���H�}(D�����I��H�l5 H� I��M�������E1�H�|$H��t
L�$�^���L�$H�T$H�H�$H��H�� M��t
I�*�B M��t I�,$�R H��t
H�+�c M��t
I�/�t M��t I�m �� H�D$ H�D$H��([]A\A]A^A_� � L���x���I�,$�����L���e���H�+�����H���S���I�/�����L���A���I�m �����L���.���H�m H��������H�l$H���c����s���f D H�}(D���\���I��H�*4 H� I��M���������� D H��L�$���L�$M����������f. � L������� L����M����������f. � L���x�H����������f. � H���X�M����������f. � L���8����� H�|$E1�E1�1�E1�H��� �������f�H�|$E1�E1�E1�H��������H�
3 E1�E1�1�E1�H�8���E1����f�UH��SH����H�T$ H�5� H��� H��1����A��1�E��t!�t$ 1��n�Ƌ��uH�=� 1��8�H��[]ÐH��2 H�8�Q�H��[]�f. � AU1�ATUH��H��@���H��t(I��H�T$1�H��H�5 �?��uI�,$�` E1�H��@L��]A\A]�1Ҿ � ��Ń���T H�t$L�D$� L����� ���D$ H��1������6 �����l$ @���� @���> @���� @���: @���� @�� �� @��@� @�ŀ�R f�� �� f�� �� f�� �! f�� �� f�� �� f�� � f�� @�E f�����H�=� �P�H��H������H��L���i��H�E �W H��H�E �����H�������f�L������� H�=� ���I��H���m���H��L���
��I�E �� H��I�E ����L���[����f D H�=� ��I��H��� ���H��L�����I�E uuH��I�E �����L�����|���f. � H�=N �T�I��H������H��L���m��I�E u%H��I�E �C���L�����6���f. � H��I�E �����L�����z��� D H�=� �t��d��� � H�=� �\�I�,$� ��E1���H��@L��]A\A]�f. � H�=� ��I��H���
���H��L�����I�E �a���H��I�E �����L�����|���f D H�=M �D�I��H�������H��L���]��I�E ����H��I�E �C���L�����6���f D H�=2 ���I��H���m���H��L���
��I�E �����H��I�E �=���L���[��0���L���N����f � H�=� ��I��H���
���H��L������I�E �a���H��I�E ���L��������f D H�=� �D�I��H�������H��L���]���I�E ����H��I�E �����L�������f D H�= ���I��H���m���H��L���
���I�E �����H��I�E �����L���[���f D H�=I ��I��H��� ���H��L������I�E �q���H��I�E �����L��� ����f D H�=t �T�I��H������H��L���m���I�E �!���H��I�E �q���L�����d���f D H�=* ��I��H���}���H��L��� ���I�E ����H��I�E �,���L���k�� ���f D H�=�
��I��H���-���H��L�������I�E �����H��I�E ���L��������f D H�=�
�d�I��H������H��L���}���I�E �1���H��I�E �����L��������f D H�=j
��I��H�������H��L���-���I�E ���H��I�E �~���L���{��q���H��H�E �M���H���`��@���ff. � � ���f D H���w�H�=� H��H��1����f��� 1��f � H��1����A��� E��t*��� ��t ��tH� + H�8����������1�H���f � UH��SH��H���o�� ��tH��H��[]�� ������uH��H��[]�� � H��* H��H�5* H�8H��1�[]��� � AT� H�=�+ � �H���� � H�5� H��I��������� � H�5� L�������� 1�H�5� L�������� � H�5� L���|����l � H�5� L���`����P � H�5� L���D����4 � H�5� L���(���� � H�5� L��� ����� � H�5� L��������� � H�5p L��������� �
H�5a L�������� � H�5R L�������� �
H�5F L������ut� H�5: L���h���u\� H�50 L���P���uD� H�5& L���8���u,H�������H��H��tH�5 L������
� E1�L��A\� H��H��� %s (originated from %s) (is) PSUTIL_DEBUG assume no such process (originated from %s) assume access denied (originated from %s) pid must be a positive integer ii %02x: (siOOOO) socket(SOCK_DGRAM) ioctl(SIOCGIFFLAGS) up broadcast debug loopback pointopoint notrailers noarp promisc allmulti master slave multicast portsel automedia dynamic %s syscall failed RLIMIT_AS RLIMIT_CORE RLIMIT_CPU RLIMIT_DATA RLIMIT_FSIZE RLIMIT_MEMLOCK RLIMIT_NOFILE RLIMIT_NPROC RLIMIT_RSS RLIMIT_STACK RLIMIT_LOCKS RLIMIT_MSGQUEUE RLIMIT_NICE RLIMIT_RTPRIO RLIMIT_RTTIME RLIMIT_SIGPENDING RLIM_INFINITY _psutil_posix getpagesize getpriority net_if_addrs net_if_flags net_if_is_running net_if_mtu setpriority ;� `��� ��� �( ��h @�� ��� �� @� ��, ��` @�| P�� �< ��p �� ��� ��� � ��8 zR x � $ ���` FJ w� ?;*3$" < D ���� B�B�D �G�j
CBBH O CBB< � ���� B�M�A �G�L
CABG O CAB< � @�� B�M�A �G�L
CABG O CAB ��j D q
K F
J $ ��W D F
F F D �) Dd ( \ 8�� A�PP{
AC XA 0 � ��� A�PP�
AI X
AG YA � h�a D H
D ` � �� K�D�E �B(�A0�A8�G�\�H�P�Z
8A0A(B BBBI ������� X < h�� B�D�B �B(�A0�A8�D`]hLpXhA`l
8A0A(B BBBH 0 � ��v A�D�D0S
AAB SAA@ � �� B�D�A �G`y
DBBA �
DBBK ��
$ �� DP < ��W TB< T �i A�D�G O
DAH O
DAL XCA � P� B�� 0# �" �] + ;
T7 �] �] ���o ` � �
[ ` x � � ���o � ���o �o D ���o �] 6 F V f v � � � � � � � � ! ! &! 6! F! V! f! v! �! �! �! �! �! �! �! �! " " &" 6" F" V" f" v" VB ���������a dB `4 pB �, |B ) �B P- �B �& �B & �B �' GCC: (GNU) 10.2.1 20210130 (Red Hat 10.2.1-11) , @# � , p & Q l � ] @# � � � � � � X int W � x �W � �c � � � � � fv W � z bj } \ T� g G � 8 + : W ; W � 5 j; = l� u m@
) ; � n F � �F � �R ; �R �
W
g ^ �} �b �
3� � � � ,W � R � R� R � * W R � L R � N3 R R : v R P R � � l W m � � �
�� � W � 2
� �W �% ) �� �% � U @ � �R p% W �t } � R b �,R C = � �R �h x � W � � �% � f U�TT &B Q�h �% � � �R % j � } �"R � � b �2R � � pid � � �l % � � U�TT �@ Q�l f% � T �@ P �R p$ � �( �� G C exc �R � � msg �
( ��w � � !m �R � � "� !� �R
�$ Uv �$ P � U��wT `@ Q�U �$ 3 T @ Q=R��w �$ Tv #� 9 $- � N sR �# � �L s� G C exc tR � � msg u
( ��w ` � !m zR � � "� !� zR
X$ Uv $ P U��wT 0@ Q�U "$ 3 7 T @ Q3R��w 0$ Tv % \R @# � � \4� I C � ]
( ��w exc dR � � � !m hR � � "0 !� hR " �# Uv T# � a# m x# P 4 U��wT @ R| �# 3 Z T @ R��w �# Tv 8 A � F & Q o � �9 � � � � � X int c � x �c E
�N � �o � �� � � � � R �N � � f� c � z bv G
h� } T �
N I/ � ; � h � Y � R
� � �
�
� �
4 � � q � � �
� � _
�
� ! L
" � # 1 $ � % � & O ' � ( � ) * , + � , } - �
. � / v 0 � 1 � 2 � 3 � 4 0 5 | 6 $ 7 H 8 9 L : p ; � < , < � = � > ? � @ � A � B C 3 D � E � F � G � H ] I � J � K � L / M k
N � O � P Q R # S � T
U F V M W � X � Y 7 Z � [ � \ � ] � ^ � _ � ` � a b � c d C e q f � g � h % i �
j ^ k � l m � n � o � p > q r s � t � u v � w x 3 y y z � { $ | k } ~ ~ K � � � � E � � � � � �
� � � � � q � < � U � �
� 6
� & � � � � � ~ � � � ` � � � � = � K � { � q � � � � �
� � � : � ]
� � � � � � f � � � � � 8 � �
� � p � x � � � � � 3 � $ � � � %
� � � �
� � � � � � L � ' � � � � � P � � 4 � � � O � � � k � � � ^ � �
� f � � � U � � � � � h � Y � � � � � � � � � � � � �
� � � � � � 0@ � 1 G < 3N \ T� g G � 8�
+ : c
; c m � 5
j�
=
lS
u
m� ) � �
n� � � � � � �
� c �
�, 2 c F � � ^
�R X c q � � �
?~ � � � �
�� � & � A 1� � � 9 6
�
7�
� 8�
] 9c
;� 9 = � � (
+U
�
,�
�
-Z
^
.S
�
/
� � U �
0
<�
�
= c
�
> � T h
J
�
K`
�
L� (
j
M� 0
�
NS 8
�
O @
�
P H
�
QF P
1
R � X
S q ` l � �� � �� ? N � � 6 � � � � Q � � � �
8
. 8 W g f N $� z � X L ) � � N ?
y �
I k � 9
H � � G �s
w �?
� �
x
K
� �
9
K
�
� �
�
�
J
�
�
�
| �
�
�
9 �
�
�
� �)
� �?
# �-
z �
h �� �
�
. � �� � ?
� - G � � P G 9 9 � '
� � � � � � � �
� � � \ � � � ' � � �
s
�
& �
1 �
< �
G ) R � ] � h � s � ~ � � � � � @ � 9
N +1
d
� 3 �
- � @ g �� ^ ` � Q ] @� � � o�
O q9
q r9
� sG irq t@ dma u@
� v@ ��
� ��
� �
9 �M H �K
b �K
� �K
�K
�K
! � \ � �c �
�c � �1
w ��
��
� � � (~u
� � �
& � �
&� � ,�
� -�
8
�
! �
� "N
� $�
X
%�
5 .u (
� 8 � 0 � E G { -
� " � x; �g A �
g � � w = � � / w 9 ; � 9 G � 9 � ��
r � 9 � G k � # 3
F
G
�
�
� c
� G
� @
� @
� � g j � P 9 � g@ �a y � @a !� ^ c � � � "� l c � � � # "@ � c � ! � � c $ E
� !� B c !" 9c 4 � � "& �� K � %L
^ � !I 4� t S !k (� � � # "� a c � c !j ) c � c 9 # !� !r c � c c c !t
b c � � � c !* c � � # !�
Kc : � � � !a "� P o !�
Lc p � � o !/ �� � � c � "� � � � � # !N c � � � ! d � � � !� �� � � &� $2
� ! # c v c "U ko . c '� �� P5 �w (mod �� \ X (v �� � � )c5 p � *U @a *T3 )�5 P � *U| *T uA *Q9 )�5 P � *U| *T A *Q4 )�5 P *U| *T �A *Q0 )�5 P E *U| *T �A *Q2 )�5 P o *U| *T �A *Q1 ) 6 P � *U| *T �A *Q8 )(6 P � *U| *T �A *Q7 )D6 P � *U| *T �A *Q6 )`6 P *U| *T �A *Q5 )|6 P A *U| *T �A *Q3 )�6 P k *U| *T �A *Q: )�6 P � *U| *T �A *Q< )�6 P � *U| *T B *Q= )�6 P � *U| *T B *Q> ) 7 P *U| *T (B *Q? )7 P = *U| *T 6B *Q; )(7 : U *U � +?7 *U| *T HB , �� �& � � -} �$� � � -b �4� � � � � � ��.� � c R F (ret � c � � /ifr �M �@0� �)�& � E *U�T*T �B *Q�� )�& � f *U2*T2*Q0 )' 8 � *U�@*Q? )' � � *Uv *T
� )&' � � *Uv )B' t � *U &B 1U' � 1d' � +�' t *U &B ,� �� P- � ��* -} � � -b �/� W M � � � ��.� � c � � (ret � c � � /ifr �M ��.� �� � � .� �\ G ? 0� u2` & .� v� � � )�. K *U| +R1 K *U| 3�* �. � K5 4�* 4�* W S 5� 6�* � � 7�* � � 6�*
+@4 K *Uv 8�* �. � 6�* /
-
9�* �. 6�* T
R
+�. K *Uv )�. 4 *U [A +�. *U| *Tv :�* / / P �: 4�* y
w
4�* �
�
6�* �
�
8�* %/ � ;�* 8�* // ! 6�* 2 0 9�* // ! 6�* W U +E/ K *U} ) / 4 *U �@ +#/ *U| *T} :�* P/ P/ P �? 4�* | z 4�* � � 6�* � � 8�* u/ � ;�* 8�* {/ % 6�* 5 3 9�* {/ % 6�* Z X +�/ K *U} )\/ 4 $ *U �@ +s/ *U| *T} :�* �/ �/ P �D 4�* } 4�* � � 6�* � � 8�* �/ � ;�* 8�* �/ %
6�* 8
6
9�* �/ % 6�* ]
[
+�/ K *U} )�/ 4 ) *U �@ +�/ *U| *T} 3�* �3 ES 4�* �
�
4�* �
�
5 6�* �
�
7�* @ � 6�* ; 9 +0 K *U} 8�* 4 6�* ` ^ 9�* 4 6�* � � +%4 K *U} )�3 4 7 *U QA +4 *U| *T} :�* `0 `0 P X 4�* � � 4�* � � 6�* � 8�* �0 � ;�* 8�* �0 ! 6�* c a 9�* �0 ! 6�* � � +�0 K *U} )l0 4 = *U �@ +�0 *U| *T} :�* �0 �0 P ] 4�* � � 4�* � � 6�* � 8�* �0 � ;�* 8�* �0 ! # 6�* f d 9�* �0 ! 6�* � � +�0 K *U} )�0 4 B *U A +�0 *U| *T} :�* 1 1 J 3b! 4�* � � 4�* � � 6�* 8�* %1 � ;�* 8�* /1 (! 6�* i g 9�* /1 6�* � � +E1 K *U} ) 1 4 G! *U 9A +#1 *U| *T} :�* `1 `1 P 9g" 4�* � � 4�* � � 6�* 8�* �1 �! ;�* 8�* �1 ! -" 6�* l j 9�* �1 ! 6�* � � +�1 K *U} )l1 4 L" *U ?A +�1 *U| *T} :�* �1 �1 P ?l# 4�* � � 4�* � � 6�* 8�* �1 �" ;�* 8�* �1 ! 2# 6�* o m 9�* �1 ! 6�* � � +�1 K *U} )�1 4 Q# *U IA +�1 *U| *T} :�* 2 2 P q$ 4�* � � 4�* � � 6�*
8�* %2 �# ;�* 8�* /2 ! 7$ 6�* r p 9�* /2 ! 6�* � � +E2 K *U} ) 2 4 V$ *U A +#2 *U| *T} :�* P2 P2 P v% 4�* � � 4�* � � 6�*
8�* u2 �$ ;�* 8�* 2 ! <% 6�* u s 9�* 2 ! 6�* � � +�2 K *U} )\2 4 [% *U �B +s2 *U| *T} :�* �2 �2 P {& 4�* � � 4�* � � 6�* 8�* �2 �% ;�* 8�* �2 ! A& 6�* x v 9�* �2 ! 6�* � � +�2 K *U} )�2 4 `& *U A +�2 *U| *T} :�* �2 �2 P !�' 4�* � � 4�* � � 6�* 8�* 3 �& ;�* 8�* 3 ! F' 6�* { y 9�* 3 ! 6�* � � +53 K *U} )�2 4 e' *U !A +3 *U| *T} :�* @3 @3 P '�( 4�* � � 4�* � � 6�* 8�* e3 �' ;�* 8�* o3 ! K( 6�* ~ | 9�* o3 ! 6�* � � +�3 K *U} )L3 4 j( *U )A +c3 *U| *T} :�* �3 �3 P -�) 4�* � � 4�* � � 6�* ! 8�* �3 �( ;�* 8�* �3 ! P) 6�* � 9�* �3 ! 6�* � � +�3 K *U} )�3 4 o) *U 2A +�3 *U| *T} )c- ^ �) *U0 )�- � �) *Uv *T �B *Q�� )�- � �) *U2*T2*Q0 )�- 8 * *U��*Q? )�- � +* *Uv *T
� )�- � C* *Uv ) 0 � b* *U �@ )40 � �* *U �@ +I0 � *Uv <I �c + =� �� =� �0� > �� ?�* >� � � @>� �� @>� �� ,� �� & � �~, -} � � � � -b �-� � � � ��.� � c b X (ret � c � � /ifr �M �@0� �)& � �+ *U�T*T �B *Q�� )6& � �+ *U2*T2*Q0 )T& 8
, *U�@*Q? )j& � ,, *Uv *T
!� )v& � D, *Uv )�& t c, *U �@ 1�& � 1�& � ,� *� ) � ��1 -} * �
-b */� N J B + ��(ifa + � � .� , c � � .� .� j d .9 /� � � .� 0� � � . 1� � � .r 2�
� .� 3� D! *! A� v* 2P �- .� l � Y" Q" 5P .� l � �" �" +(+ K *U�� 2� 3. .� m � %# !# 5� .� m � _# [# +;+ K *U| 2� �. .� n � �# �# 5� .� n � �# �# +M+ K *Us 2� �. .� o �
$ $ 5� .� o � G$ C$ +_+ K *U 2 / .� p � �$ }$ 5 .� p � �$ �$ +r+ K *U} 2@ R/ .� y� �$ �$ +�+ K *U�� 2p �/ .m z� J% D% 5� .� z� �% �% 1, K 2� �/ .m {� �% �% 5 .� {� & & +(, K *U| 2@ 50 .m |� \& V& 5p .� |� �& �& +H, K *Us 2� �0 .m }� �& �& 5� .� }� 2' .' +h, K *U 2 �0 .m ~� l' h' 50 .� ~� �' �' +�+ K *U} )%) ^ �0 *U0 )=) � 1 *U�� )�) t 81 *U �@ *Q~ *R| *Xs *Y )�) Z1 *U��*T�� ) * �1 r1 *T~ )?* �1 �1 *T~ )b* �1 �1 *T~ 1�* � )�+ � �1 *Uv )�+ �1 �1 *T~ 1�, � B �� x2 C� �(�
C� �2c Dbuf �
x2 Derr � c E, � c Dn � - Dlen � - E� �� Dptr � � @>k �2 � �2 F9 � Bg
�� �2 C} �$� Cb �4� Dpid � � E� � c E � c B� �� 3 C} �$� Cb �4� Dpid � � E� � c Go �� `4 ��3 H} �(� �' �' Hb �8� ( ( 1i4 |4 I~4 t *U OA J� ��4 i �R4 Kpid �o d( V( H �&� ) ) 1�4 � L5 � �3 *U�T )5 R4 4 *Us L!5 � /4 *U�T II5 � *T cA *Q�T M� ]c |4 Npid ]� Dret ^ c O� Ho P4
��4 IZ4 *UN P�2 �' a ��5 4�2 �) �) 4�2 0* ** Q�2 �hQ�2 �l6�2 �* |* R�2 �' �' �a5 4�2 �* �* 4�2 �* �* ;�2 ;�2 ;�2 1�' � )�' � �5 *U�T*T �@ *Q�h*R�l +�' � *U0 S�1 ( �c6 T�1 UT
2 TQ2 ��w;"2 ;.2 ;:2 ;D2 ;P2 ;\2 U�1 �( �V
2 V�1 5 Q2 ��w;"2 ;.2 ;:2 QD2 ^;P2 ;\2 9h2 �( ;i2 P�2 �, v �p7 4�2
+ + 4�2 M+ C+ Q3 �\63 �+ �+ R�2 0- 0- �7 4�2 , , 4�2 ;, 9, ;3 ;3 1?- � 1�, � )�, � =7 *Uv *T �@ *Q�\ )- ~ T7 *U0 +(- t *U �@ PR4 �4 W �8 4c4 b, ^, 6o4 �, �, RR4 �4 �4 ]�7 4c4 �, �, ;o4 1�4 � )�4 � 8 *T0 1�4 � Wi _ % % $ > $ > & I : ; 9 I I : ; 9
: ; 9 I8 7 I
< 4 : ;9 I?< 4 : ; 9 I?<
4 : ; 9 I 4 G: ; 9 .?: ;9 'I< I .?: ; 9 '< .?: ; 9 'I< .?: ;9 '< . ?: ; 9 'I< .?: ;9 'I@�B ��1 �� �B .?: ; 9 'I@�B : ; 9 I�B 4 : ; 9 I 4 : ; 9 I�B ��1 �� 1 4 : ; 9 I U !4 : ; 9 I�B " U #I $! I/ %.?: ; 9 'I@�B % : ; 9 I $ > $ > & I I 7 I : ;9 I
> I: ; 9 ( : ; 9
: ; 9 I8 < 'I I ' 4 : ;9 I?< 4 : ; 9 I?< 'I > I: ; 9 > I: ;9 ( ( I ! I/
: ;9 I8
: ; 9 I8 : ; 9
: ; 9 I 4 : ; 9 I 4 : ;9 I !.?: ; 9 'I< ".?: ;9 'I< # $.?: ; 9 '< %.?: ;9 '< &. ?: ; 9 'I< '.?: ;9 'I@�B (4 : ;9 I�B )��1 *�� �B +��1 ,.: ;9 'I@�B - : ;9 I�B .4 : ;9 I�B /4 : ;9 I 0
: ;9 1�� 1 2 U 3 1R�BUX YW 4 1�B 5 U 64 1�B 7 1U 8 1 9 1 : 1R�BX YW ;4 1 <.: ;9 'I = : ;9 I >4 : ;9 I ? @ A
: ;9 B.: ; 9 'I C : ; 9 I D4 : ; 9 I E4 : ; 9 I F! I/ G.: ; 9 'I@�B H : ; 9 I�B I���B1 J.?: ; 9 '@�B K : ; 9 I�B L���B1 M.?: ; 9 'I N : ; 9 I O.?: ; 9 'I@�B P.1@�B Q4 1 R 1R�BX Y W S.1@�B T 1 U 1R�BUX Y W V 1 W. ?<n: ; k . �
psutil /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m _psutil_common.c types.h stdio.h types.h pyport.h time.h object.h pyerrors.h _psutil_common.h stdlib.h modsupport.h abstract.h string.h errno.h = @# � =w: �X:X<� �� I=� X t � � � �$n$\$��� � ;=� X t � � � �#�#\#��� � ;=� X t � � � �8�8yJ
Ct�L��z�4 �Y2�2J
@t�L �
M
t��t� .�� K� Y
� � �
psutil /opt/rh/devtoolset-10/root/usr/lib/gcc/x86_64-redhat-linux/10/include /usr/include/bits /usr/include /usr/include/sys /opt/python/cp36-cp36m/include/python3.6m /usr/include/netinet /usr/include/net /usr/include/asm-generic /usr/include/linux _psutil_posix.c stddef.h types.h stdio.h types.h unistd.h stdint.h pyport.h time.h object.h boolobject.h methodobject.h moduleobject.h pyerrors.h resource.h resource.h socket_type.h sockaddr.h socket.h in.h confname.h if.h ifaddrs.h int-ll64.h types.h
if_packet.h
_psutil_common.h netdb.h listobject.h unicodeobject.h modsupport.h ioctl.h socket.h longobject.h signal.h errno.h <built-in> 3 & �3v
J3v�
J�=-[ /_f sY � t.Z] ' Y �X:�t:z P:z� P�=-[ /[f sY � u.[Y uR� Y �X ztPX:�|f:
J At=-^�ZtKp� t�:
�:s
.:s.
.:s<
� Y � 8 @ � -��
^�
^X #
Y
Y�� �L
IY \K� Y
`� lt�95`5 25* �XY� ��XJ
�� ; B
' �
� � � � � � % L) J � J Z K �q ? 0 �� = � <
�
�tK <�<XX KXK � X � X � X � X � X � � l� � � � � � � � � � % L) J 7�X�
]�
�tK < . t X J t � � � � � � � � � � �z��� A�o;;- D�v
<:�~t:� Z�h >�-^�.L �fp. �f5��5
35) �Y� t��J� =�~� /�f sY ��u X��������������� ��~�� � /Ij��t�� �~@�� � /Ij��� 7��� � /I2��� =��� � /I2��� � ����� / ;Z� ����� � /Ij��� � ��� � /Ij��� � �~�� � /Ij��X � � B��~�� � /Ij��� � �~�� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� � ��� � /Ij��� ��~�� � /Ij��X ���}� >� �> KXu I ��L .j� l Jt=W [
X .\dX
&�h� ./�/ �X g EA
�
t K G? �= I/ X P5 �0 � X� <� � <� <� <� <� <� <� <� <� <� <N <N <N <J
� Y���� < tz_dsttime syscall psutil_setup /project _typeobject _object ob_refcnt double NoSuchProcess Py_ssize_t float _py_xdecref_tmp long long unsigned int timezone unsigned char psutil_set_debug strerror _py_decref_tmp PSUTIL_DEBUG short unsigned int PyObject_IsTrue psutil_PyErr_SetFromOSErrnoWithSyscall tz_minuteswest PyObject_CallFunction AccessDenied psutil/_psutil_common.c ob_type self PyErr_SetObject __errno_location PyObject __ssize_t fullmsg long long int GNU C17 10.2.1 20210130 (Red Hat 10.2.1-11) -mtune=generic -march=x86-64 -g -O3 -fwrapv -fPIC PyArg_ParseTuple PyExc_ValueError _Py_Dealloc short int args PSUTIL_CONN_NONE __pid_t _Py_NoneStruct psutil_check_pid_range PyErr_SetString sprintf getenv PyExc_OSError _SC_EQUIV_CLASS_MAX ifr_ifrn m_copy ifa_addr _SC_THREAD_PRIO_PROTECT sin6_flowinfo ifr_ifru PyModule_Create2 getnameinfo __priority_which_t _SC_VERSION Py_BuildValue _SC_NL_NMAX m_methods _longobject slot _SC_SYNCHRONIZED_IO _SC_THREAD_PRIORITY_SCHEDULING _SC_NPROCESSORS_ONLN sa_data m_base _SC_TIMEOUTS sockaddr _SC_BASE _SC_PII_OSI_COTS sockaddr_un _SC_THREAD_SAFE_FUNCTIONS _SC_ATEXIT_MAX sockaddr_ns _SC_STREAM_MAX ifru_slave psutil_posix_getpriority _SC_PRIORITIZED_IO py_ptp _SC_V6_ILP32_OFF32 _SC_THREAD_SPORADIC_SERVER sll_pkttype __socket_type ifu_dstaddr _SC_SHRT_MIN _SC_USHRT_MAX _SC_NL_TEXTMAX _SC_STREAMS __rlimit_resource IFF_PORTSEL _SC_THREAD_DESTRUCTOR_ITERATIONS _SC_PIPE _SC_BC_DIM_MAX psutil_getpagesize _SC_MAPPED_FILES _SC_2_C_BIND _SC_MQ_OPEN_MAX _SC_XOPEN_SHM _SC_INT_MAX _SC_2_FORT_DEV kill _SC_XOPEN_XPG2 _SC_NZERO _SC_XOPEN_XPG4 IFF_NOTRAILERS _SC_CPUTIME _SC_PII_INTERNET _SC_V7_LP64_OFF64 _SC_LEVEL3_CACHE_SIZE _SC_MB_LEN_MAX ifreq __u6_addr16 __caddr_t _py_tmp sockaddr_ipx sll_hatype getifaddrs ifru_broadaddr _SC_REALTIME_SIGNALS __RLIMIT_LOCKS m_free moduledef py_netmask _SC_DEVICE_SPECIFIC_R uint32_t in_addr_t mem_start _SC_SAVED_IDS __RLIM_NLIMITS _SC_2_C_DEV _SC_XBS5_LPBIG_OFFBIG ob_base _SC_2_C_VERSION _SC_SEM_VALUE_MAX _SC_SCHAR_MAX ifru_map _SC_SSIZE_MAX _SC_2_UPE PyExc_RuntimeError freeifaddrs RLIMIT_CORE ifa_name _SC_INT_MIN _SC_BC_BASE_MAX __u6_addr8 _SC_POLL sysconf ml_flags _SC_SYSTEM_DATABASE_R sockaddr_dl sll_halen __RLIMIT_NPROC _SC_2_LOCALEDEF IFF_MULTICAST sin_family _SC_XOPEN_XPG3 _SC_T_IOV_MAX _SC_LEVEL1_ICACHE_ASSOC in_port_t py_str _SC_SYMLOOP_MAX retval _SC_TRACE_LOG ifa_ifu __u6_addr32 append_flag _SC_THREAD_CPUTIME sin_zero _SC_CHAR_MAX _SC_XBS5_ILP32_OFFBIG _SC_PII_INTERNET_DGRAM s_addr py_address _SC_2_PBS_TRACK __u16 psutil_net_if_flags _SC_FILE_ATTRIBUTES _SC_ASYNCHRONOUS_IO _SC_FSYNC __RLIMIT_NICE sockaddr_inarp _SC_DEVICE_SPECIFIC sockaddr_ax25 ifa_netmask IFF_UP _SC_THREAD_ATTR_STACKSIZE _SC_REGEX_VERSION _SC_MEMLOCK _SC_DELAYTIMER_MAX _SC_LONG_BIT _SC_SEM_NSEMS_MAX sockaddr_iso PyModule_AddObject PyModule_AddIntConstant _SC_XOPEN_STREAMS _SC_LEVEL1_ICACHE_LINESIZE _SC_SIGNALS sll_family __RLIMIT_OFILE IFF_SLAVE ioctl _SC_2_PBS_ACCOUNTING _SC_AIO_MAX _SC_LEVEL2_CACHE_LINESIZE _SC_XOPEN_VERSION mod_methods sa_family_t _SC_CLK_TCK _SC_SHELL sll_protocol _SC_UIO_MAXIOV _SC_TZNAME_MAX ifru_data _SC_SPORADIC_SERVER _SC_MEMLOCK_RANGE _SC_AVPHYS_PAGES __RLIMIT_NLIMITS _SC_V7_ILP32_OFFBIG _SC_PII_XTI close sll_ifindex flag_name sock _SC_V7_LPBIG_OFFBIG _SC_C_LANG_SUPPORT_R SOCK_DCCP _SC_LEVEL3_CACHE_ASSOC uint8_t _SC_FILE_SYSTEM ifru_netmask _SC_PAGESIZE _SC_V6_ILP32_OFFBIG SOCK_PACKET __id_t _SC_SIGQUEUE_MAX _SC_SPAWN psutil_posix_setpriority _SC_DEVICE_IO _SC_V6_LPBIG_OFFBIG _SC_2_VERSION ifru_mtu _SC_LEVEL4_CACHE_SIZE ml_name SOCK_DGRAM m_size IFF_LOOPBACK _SC_USER_GROUPS_R PyModuleDef_Slot visitproc sin_port _SC_LINE_MAX sockaddr_eon psutil/_psutil_posix.c IFF_AUTOMEDIA lladdr py_broadcast _SC_LEVEL1_DCACHE_ASSOC _SC_HOST_NAME_MAX _SC_C_LANG_SUPPORT __RLIMIT_RSS _SC_THREAD_STACK_MIN IFF_RUNNING _SC_SEMAPHORES _SC_UINT_MAX _SC_CHILD_MAX __RLIMIT_MSGQUEUE PyUnicode_FromString _SC_NGROUPS_MAX _SC_SINGLE_PROCESS IFF_ALLMULTI __be16 __in6_u sin_addr _SC_TTY_NAME_MAX _SC_PII_INTERNET_STREAM RLIMIT_AS _SC_MEMORY_PROTECTION PyModuleDef_Base m_name _SC_XOPEN_CRYPT PyCFunction psutil_net_if_is_running ifru_newname _Py_FalseStruct RLIMIT_FSIZE _SC_CHAR_BIT _SC_LEVEL1_DCACHE_SIZE IFF_NOARP _SC_CLOCK_SELECTION m_init ifrn_name sin6_addr psutil_net_if_mtu _SC_TIMERS freefunc _SC_BC_SCALE_MAX _SC_ULONG_MAX uint16_t sin6_port _SC_MQ_PRIO_MAX _SC_TRACE _SC_SPIN_LOCKS ifru_flags addrlen _SC_LEVEL1_DCACHE_LINESIZE _SC_BC_STRING_MAX PyLong_FromLong mem_end SOCK_STREAM RLIMIT_DATA _SC_V7_ILP32_OFF32 _SC_TRACE_SYS_MAX _SC_FD_MGMT _SC_REGEXP sin6_family IFF_PROMISC RLIMIT_CPU PyInit__psutil_posix _SC_LEVEL1_ICACHE_SIZE _SC_ADVISORY_INFO __RLIMIT_RTPRIO _SC_SHRT_MAX _SC_XBS5_LP64_OFF64 __builtin_strncpy _SC_READER_WRITER_LOCKS _SC_SYSTEM_DATABASE _SC_XOPEN_REALTIME_THREADS _SC_THREAD_ROBUST_PRIO_PROTECT _SC_2_CHAR_TERM _SC_PASS_MAX _SC_FIFO m_slots _SC_ARG_MAX ifru_hwaddr ml_doc _SC_2_PBS_CHECKPOINT PyMethodDef _SC_XOPEN_REALTIME PRIO_USER ifru_dstaddr psutil_getpagesize_pywrapper _SC_2_FORT_RUN socket _SC_TRACE_EVENT_FILTER psutil_raise_for_pid _SC_RE_DUP_MAX _SC_SCHAR_MIN sockaddr_in _SC_THREAD_ROBUST_PRIO_INHERIT _SC_THREADS PyList_Append _SC_PII __RLIMIT_SIGPENDING _SC_TRACE_INHERIT _SC_WORD_BIT _SC_XBS5_ILP32_OFF32 _SC_PII_OSI_M RLIMIT_NOFILE m_traverse _SC_2_SW_DEV _SC_OPEN_MAX _SC_XOPEN_UNIX sockaddr_in6 _SC_AIO_LISTIO_MAX PyErr_SetFromErrno _SC_PII_OSI _SC_UCHAR_MAX _SC_MONOTONIC_CLOCK m_clear py_tuple ifaddr SOCK_RAW _SC_PRIORITY_SCHEDULING m_doc _SC_SELECT _SC_NETWORKING _SC_TIMER_MAX _SC_TRACE_EVENT_NAME_MAX _SC_V6_LP64_OFF64 _SC_GETGR_R_SIZE_MAX _SC_LEVEL2_CACHE_SIZE _SC_LOGIN_NAME_MAX _SC_EXPR_NEST_MAX IFF_POINTOPOINT _SC_NPROCESSORS_CONF __RLIMIT_RTTIME ifru_addr __socklen_t traverseproc SOCK_SEQPACKET PRIO_PROCESS sockaddr_at psutil_pid_exists ifa_flags _SC_SS_REPL_MAX _SC_RAW_SOCKETS _SC_BARRIERS _SC_CHAR_MIN _SC_LEVEL4_CACHE_LINESIZE psutil_convert_ipaddr _SC_THREAD_PROCESS_SHARED _SC_NL_MSGMAX _Py_TrueStruct sin6_scope_id m_index _SC_LEVEL4_CACHE_ASSOC _SC_CHARCLASS_NAME_MAX _SC_PII_OSI_CLTS psutil_net_if_addrs py_retlist _SC_TYPED_MEMORY_OBJECTS ml_meth __RLIMIT_MEMLOCK base_addr _SC_2_PBS _SC_PHYS_PAGES IFF_MASTER _SC_PII_SOCKET IFF_DEBUG _SC_MULTI_PROCESS _SC_LEVEL2_CACHE_ASSOC __priority_which sa_family ifmap _SC_THREAD_KEYS_MAX PyErr_Format IFF_BROADCAST _SC_THREAD_THREADS_MAX _SC_GETPW_R_SIZE_MAX ifa_data SOCK_NONBLOCK PRIO_PGRP _SC_2_PBS_MESSAGE _SC_RTSIG_MAX sockaddr_ll _SC_THREAD_ATTR_STACKADDR PyList_New PyModuleDef _SC_FILE_LOCKING _SC_SHARED_MEMORY_OBJECTS _SC_TRACE_NAME_MAX _SC_COLL_WEIGHTS_MAX _SC_XOPEN_ENH_I18N _SC_XOPEN_LEGACY _SC_JOB_CONTROL IFF_DYNAMIC ifa_next RLIMIT_STACK _SC_MESSAGE_PASSING _SC_NL_LANGMAX _SC_IOV_MAX _SC_USER_GROUPS SOCK_CLOEXEC _SC_IPV6 _SC_LEVEL3_CACHE_LINESIZE _SC_2_PBS_LOCATE ifru_ivalue _SC_NL_SETMAX _SC_NL_ARGMAX ifu_broadaddr nic_name _SC_THREAD_PRIO_INHERIT sll_addr _SC_TRACE_USER_EVENT_MAX inquiry sockaddr_x25 SOCK_RDM _SC_AIO_PRIO_DELTA_MAX _SC_XOPEN_XCU_VERSION 0 7 U7 � �U� 0 > T> I UI � �T� X c P � � U� * �U� � � T� � U� * �T� 0 Q UQ � �U� x P � V� � V � � V� � V � � V� � V � � U� & �U� � � P� V
# V � V
# V � � V
# V U G \G � �U� ^ e Pe | V� � V f | V� � V k r V� � V c � P� A \ + > P � � U� � �U� � � T� � U� � �T� � � ��� P B VH T UT i Vj � V % PH T P P T UT E �U� P b Tb � V� � �T�� � V� E �T� P � ��� � P� � V�
��
P
Q
VV
J ��J W VW E �� � � P!
3
P c r Pr � \� D
\V
E \ � � V�
VV
J VW * V � � \� � \4
D
\J W \ � �
[A �* @
[A � � � \* @ \ � � 0�� � P� � V� � 0�* @ V * E V � � V � � V � E
�@ � � E \ � 0� " P" / ]/ E 0� / J ] / J ] J �
�@ � J � \ J _ 0�_ r Pr { ]{ � 0� { � ] { � ] � �
�@ � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] �
%
QA � �
% \ �
�
0��
P ] % 0� �
] * ] * ] V
�
�@ � V
�
\ V
o
0�o
�
P�
�
]�
�
0� �
�
] �
�
] �
�
A � �
�
\ �
�
0��
�
P�
�
]�
�
0� �
�
] �
�
] �
E
9A � �
E \ �
0� " P" / ]/ E 0� / J ] / J ] W �
?A � W � \ W o 0�o � P� � ]� � 0� � � ] � � ] � �
IA � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] � E
A � � E \ � 0� " P" / ]/ E 0� / J ] / J ] J �
�B � J � \ J _ 0�_ r Pr ] � 0� � ] � ] � �
A � � � \ � � 0�� � P� � ]� � 0� � � ] � � ] � 5
!A � � 5
\ � � 0��
P
]
5
0�
:
]
:
] :
�
)A � :
�
\ :
O
0�O
b
Pb
o
]o
�
0� o
�
] o
�
] �
�
2A � �
�
\ �
�
0��
�
P�
�
]�
�
0� �
�
] �
�
] U � �U�
T
U � �T� 8 ��8 S PS � V� � U� � V j u P� � P U � �U� $ T$ � �T� K V � V� � Vm � V Y � ^ ^ ^� � ^m � ^ * < P< �� � �� * � 0�� � P� � Z� � ��� 0� � Z� � �� � 0�m � 0�� � S� � 0�� � Z� � 0� * Y 0�Y � \� � 0�( > P> � \ ( \( 0�� m \m � P� � \� � 0� * Y 0�Y � S� B 0�B N PN � S ; S; � 0�� m Sm � 0�� � S� � P� � 0� * s 0�y � _� e 0�e l Pl | _ � _ M _M � 0�� m _m � 0�� � S� � 0�� � Z� � 0� * s 0�y � ]� p 0� � ] _ ]_ � 0�� � P� m ]m � 0�� � S� � 0�� � Z� � 0� � � Z� � �� ' Z' �� � � Z� � �� ' Z' �� � � \( \ � � \( \ � � S; S � � S; S � � _M _ � � _M _ � � ]_ ] � � ]_ ] � � ��� � Q� m �� � � Z� � Z� Z � � Z� Z � � \� � \ m \ � � \ 6 \ � � S� � S( m S � � S6 V S � � _� � _H m _ � � _V m _ � � ]� � ] � � ]� � ] ` h Uh ~ �U� ` h Th ~ �T� � � U� � S� �U� S ! �U�! C SC I �U� � � T� V U �T� V U ! �T�! D VD H QH I �T� � � U� � �U� � � T� � U� � �T� � � P� � P � � �U� � � �T� � � U� F �U� � � T� . V. / �T�/ E VE F �T� P ' T/ > T / ? �U� / ? V � � U� � �U� � � P� � X � � �U� f r � � k r � � � � � � � � � � � � � � [ f � � � � ( � � ( ; � � ; M � � M _ � � _ r � � � � � � � � � � � � ( � � ( � � ( H � � @ H � � H p � � ` p � � � � � � � � � 4
?
J R � � * E � � * E �
�
* �
8 ` � � D � �
�" T7
@ �B hC �] �] �] �] �_ ` @a �b � �" �" ! �" 7 �b C �] j 0# v �] � � � � � & � � �& � � �' a � ( ) � $ �, v = P- � Q `4 n @a h x �a � � G � � �] � �] � �B � �b � ` � � � 2 G ` | � � � T7 � � P5 � � � P4
& 9 L e u � � � � � � � � �4 i @# � 3 B X h y �4 W � �# � � � � p% W � � � p$ � �b ' 4 I c y % j � " � � �% ) � crtstuff.c deregister_tm_clones __do_global_dtors_aux completed.0 __do_global_dtors_aux_fini_array_entry frame_dummy __frame_dummy_init_array_entry _psutil_common.c _psutil_posix.c psutil_net_if_mtu psutil_net_if_is_running psutil_posix_setpriority psutil_convert_ipaddr psutil_net_if_addrs psutil_posix_getpriority psutil_net_if_flags psutil_getpagesize_pywrapper moduledef mod_methods __FRAME_END__ __dso_handle _DYNAMIC __GNU_EH_FRAME_HDR __TMC_END__ _GLOBAL_OFFSET_TABLE_ getenv@@GLIBC_2.2.5 PyList_New PyModule_AddIntConstant __errno_location@@GLIBC_2.2.5 strncpy@@GLIBC_2.2.5 getpriority@@GLIBC_2.2.5 _ITM_deregisterTMCloneTable PyErr_SetFromErrno _Py_Dealloc PyErr_SetObject _fini PyExc_RuntimeError PyInit__psutil_posix PyErr_SetString PyExc_ValueError setpriority@@GLIBC_2.2.5 psutil_getpagesize ioctl@@GLIBC_2.2.5 close@@GLIBC_2.2.5 getnameinfo@@GLIBC_2.2.5 PyLong_FromLong PyList_Append PyExc_OSError _Py_FalseStruct __gmon_start__ PyObject_CallFunction Py_BuildValue kill@@GLIBC_2.2.5 PyModule_Create2 psutil_raise_for_pid psutil_PyErr_SetFromOSErrnoWithSyscall _Py_NoneStruct getifaddrs@@GLIBC_2.3 PyObject_IsTrue PyArg_ParseTuple psutil_pid_exists NoSuchProcess _Py_TrueStruct freeifaddrs@@GLIBC_2.3 psutil_set_debug PyUnicode_FromString PyModule_AddObject AccessDenied sysconf@@GLIBC_2.2.5 PSUTIL_DEBUG PyErr_Format sprintf@@GLIBC_2.2.5 _ITM_registerTMCloneTable strerror@@GLIBC_2.2.5 psutil_check_pid_range __cxa_finalize@@GLIBC_2.2.5 _init psutil_setup socket@@GLIBC_2.2.5 .symtab .strtab .shstrtab .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .text .fini .rodata .eh_frame_hdr .eh_frame .init_array .fini_array .data.rel.ro .dynamic .got .got.plt .data .bss .comment .debug_aranges .debug_info .debug_abbrev .debug_line .debug_str .debug_loc .debug_ranges 8 8 $ . ���o ` ` ` 8 � � ( @ � � [ H ���o D D n U ���o � � P d � n B � � x x s ` ~ �" �" � � T7 T7 � 2 @ @ � � �B �B � � hC hC � � �] �M � �] �M � �] �M � �] �M � � �_ �O X � ` P @ � @a @Q � � �b �R � 0 �R / � �R ` OS �? ے r # M� 5 / 0 �� M : �� �, E � p @� �
! < � � �
S PK ok\ػ�هc �c psutil/_pssunos.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Sun OS Solaris platform implementation."""
import errno
import functools
import os
import socket
import subprocess
import sys
from collections import namedtuple
from socket import AF_INET
from . import _common
from . import _psposix
from . import _psutil_posix as cext_posix
from . import _psutil_sunos as cext
from ._common import AF_INET6
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import ZombieProcess
from ._common import debug
from ._common import get_procfs_path
from ._common import isfile_strict
from ._common import memoize_when_activated
from ._common import sockfam_to_enum
from ._common import socktype_to_enum
from ._common import usage_percent
from ._compat import PY3
from ._compat import FileNotFoundError
from ._compat import PermissionError
from ._compat import ProcessLookupError
from ._compat import b
__extra__all__ = ["CONN_IDLE", "CONN_BOUND", "PROCFS_PATH"]
# =====================================================================
# --- globals
# =====================================================================
PAGE_SIZE = cext_posix.getpagesize()
AF_LINK = cext_posix.AF_LINK
IS_64_BIT = sys.maxsize > 2**32
CONN_IDLE = "IDLE"
CONN_BOUND = "BOUND"
PROC_STATUSES = {
cext.SSLEEP: _common.STATUS_SLEEPING,
cext.SRUN: _common.STATUS_RUNNING,
cext.SZOMB: _common.STATUS_ZOMBIE,
cext.SSTOP: _common.STATUS_STOPPED,
cext.SIDL: _common.STATUS_IDLE,
cext.SONPROC: _common.STATUS_RUNNING, # same as run
cext.SWAIT: _common.STATUS_WAITING,
}
TCP_STATUSES = {
cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
cext.TCPS_SYN_RCVD: _common.CONN_SYN_RECV,
cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
cext.TCPS_CLOSED: _common.CONN_CLOSE,
cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
cext.TCPS_LISTEN: _common.CONN_LISTEN,
cext.TCPS_CLOSING: _common.CONN_CLOSING,
cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
cext.TCPS_IDLE: CONN_IDLE, # sunos specific
cext.TCPS_BOUND: CONN_BOUND, # sunos specific
}
proc_info_map = dict(
ppid=0,
rss=1,
vms=2,
create_time=3,
nice=4,
num_threads=5,
status=6,
ttynr=7,
uid=8,
euid=9,
gid=10,
egid=11,
)
# =====================================================================
# --- named tuples
# =====================================================================
# psutil.cpu_times()
scputimes = namedtuple('scputimes', ['user', 'system', 'idle', 'iowait'])
# psutil.cpu_times(percpu=True)
pcputimes = namedtuple(
'pcputimes', ['user', 'system', 'children_user', 'children_system']
)
# psutil.virtual_memory()
svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
# psutil.Process.memory_info()
pmem = namedtuple('pmem', ['rss', 'vms'])
pfullmem = pmem
# psutil.Process.memory_maps(grouped=True)
pmmap_grouped = namedtuple(
'pmmap_grouped', ['path', 'rss', 'anonymous', 'locked']
)
# psutil.Process.memory_maps(grouped=False)
pmmap_ext = namedtuple(
'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields)
)
# =====================================================================
# --- memory
# =====================================================================
def virtual_memory():
"""Report virtual memory metrics."""
# we could have done this with kstat, but IMHO this is good enough
total = os.sysconf('SC_PHYS_PAGES') * PAGE_SIZE
# note: there's no difference on Solaris
free = avail = os.sysconf('SC_AVPHYS_PAGES') * PAGE_SIZE
used = total - free
percent = usage_percent(used, total, round_=1)
return svmem(total, avail, percent, used, free)
def swap_memory():
"""Report swap memory metrics."""
sin, sout = cext.swap_mem()
# XXX
# we are supposed to get total/free by doing so:
# http://cvs.opensolaris.org/source/xref/onnv/onnv-gate/
# usr/src/cmd/swap/swap.c
# ...nevertheless I can't manage to obtain the same numbers as 'swap'
# cmdline utility, so let's parse its output (sigh!)
p = subprocess.Popen(
[
'/usr/bin/env',
'PATH=/usr/sbin:/sbin:%s' % os.environ['PATH'],
'swap',
'-l',
],
stdout=subprocess.PIPE,
)
stdout, _ = p.communicate()
if PY3:
stdout = stdout.decode(sys.stdout.encoding)
if p.returncode != 0:
raise RuntimeError("'swap -l' failed (retcode=%s)" % p.returncode)
lines = stdout.strip().split('\n')[1:]
if not lines:
msg = 'no swap device(s) configured'
raise RuntimeError(msg)
total = free = 0
for line in lines:
line = line.split()
t, f = line[3:5]
total += int(int(t) * 512)
free += int(int(f) * 512)
used = total - free
percent = usage_percent(used, total, round_=1)
return _common.sswap(
total, used, free, percent, sin * PAGE_SIZE, sout * PAGE_SIZE
)
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return system-wide CPU times as a named tuple."""
ret = cext.per_cpu_times()
return scputimes(*[sum(x) for x in zip(*ret)])
def per_cpu_times():
"""Return system per-CPU times as a list of named tuples."""
ret = cext.per_cpu_times()
return [scputimes(*x) for x in ret]
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
try:
return os.sysconf("SC_NPROCESSORS_ONLN")
except ValueError:
# mimic os.cpu_count() behavior
return None
def cpu_count_cores():
"""Return the number of CPU cores in the system."""
return cext.cpu_count_cores()
def cpu_stats():
"""Return various CPU stats as a named tuple."""
ctx_switches, interrupts, syscalls, _traps = cext.cpu_stats()
soft_interrupts = 0
return _common.scpustats(
ctx_switches, interrupts, soft_interrupts, syscalls
)
# =====================================================================
# --- disks
# =====================================================================
disk_io_counters = cext.disk_io_counters
disk_usage = _psposix.disk_usage
def disk_partitions(all=False):
"""Return system disk partitions."""
# TODO - the filtering logic should be better checked so that
# it tries to reflect 'df' as much as possible
retlist = []
partitions = cext.disk_partitions()
for partition in partitions:
device, mountpoint, fstype, opts = partition
if device == 'none':
device = ''
if not all:
# Differently from, say, Linux, we don't have a list of
# common fs types so the best we can do, AFAIK, is to
# filter by filesystem having a total size > 0.
try:
if not disk_usage(mountpoint).total:
continue
except OSError as err:
# https://github.com/giampaolo/psutil/issues/1674
debug("skipping %r: %s" % (mountpoint, err))
continue
ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
retlist.append(ntuple)
return retlist
# =====================================================================
# --- network
# =====================================================================
net_io_counters = cext.net_io_counters
net_if_addrs = cext_posix.net_if_addrs
def net_connections(kind, _pid=-1):
"""Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
Only INET sockets are returned (UNIX are not).
"""
cmap = _common.conn_tmap.copy()
if _pid == -1:
cmap.pop('unix', 0)
if kind not in cmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in cmap]))
)
families, types = _common.conn_tmap[kind]
rawlist = cext.net_connections(_pid)
ret = set()
for item in rawlist:
fd, fam, type_, laddr, raddr, status, pid = item
if fam not in families:
continue
if type_ not in types:
continue
# TODO: refactor and use _common.conn_to_ntuple.
if fam in (AF_INET, AF_INET6):
if laddr:
laddr = _common.addr(*laddr)
if raddr:
raddr = _common.addr(*raddr)
status = TCP_STATUSES[status]
fam = sockfam_to_enum(fam)
type_ = socktype_to_enum(type_)
if _pid == -1:
nt = _common.sconn(fd, fam, type_, laddr, raddr, status, pid)
else:
nt = _common.pconn(fd, fam, type_, laddr, raddr, status)
ret.add(nt)
return list(ret)
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
ret = cext.net_if_stats()
for name, items in ret.items():
isup, duplex, speed, mtu = items
if hasattr(_common, 'NicDuplex'):
duplex = _common.NicDuplex(duplex)
ret[name] = _common.snicstats(isup, duplex, speed, mtu, '')
return ret
# =====================================================================
# --- other system functions
# =====================================================================
def boot_time():
"""The system boot time expressed in seconds since the epoch."""
return cext.boot_time()
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
localhost = (':0.0', ':0')
for item in rawlist:
user, tty, hostname, tstamp, user_process, pid = item
# note: the underlying C function includes entries about
# system boot, run level and others. We might want
# to use them in the future.
if not user_process:
continue
if hostname in localhost:
hostname = 'localhost'
nt = _common.suser(user, tty, hostname, tstamp, pid)
retlist.append(nt)
return retlist
# =====================================================================
# --- processes
# =====================================================================
def pids():
"""Returns a list of PIDs currently running on the system."""
return [int(x) for x in os.listdir(b(get_procfs_path())) if x.isdigit()]
def pid_exists(pid):
"""Check for the existence of a unix pid."""
return _psposix.pid_exists(pid)
def wrap_exceptions(fun):
"""Call callable into a try/except clause and translate ENOENT,
EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except (FileNotFoundError, ProcessLookupError):
# ENOENT (no such file or directory) gets raised on open().
# ESRCH (no such process) can get raised on read() if
# process is gone in meantime.
if not pid_exists(self.pid):
raise NoSuchProcess(self.pid, self._name)
else:
raise ZombieProcess(self.pid, self._name, self._ppid)
except PermissionError:
raise AccessDenied(self.pid, self._name)
except OSError:
if self.pid == 0:
if 0 in pids():
raise AccessDenied(self.pid, self._name)
else:
raise
raise
return wrapper
class Process:
"""Wrapper class around underlying C implementation."""
__slots__ = ["_cache", "_name", "_ppid", "_procfs_path", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
self._procfs_path = get_procfs_path()
def _assert_alive(self):
"""Raise NSP if the process disappeared on us."""
# For those C function who do not raise NSP, possibly returning
# incorrect or incomplete result.
os.stat('%s/%s' % (self._procfs_path, self.pid))
def oneshot_enter(self):
self._proc_name_and_args.cache_activate(self)
self._proc_basic_info.cache_activate(self)
self._proc_cred.cache_activate(self)
def oneshot_exit(self):
self._proc_name_and_args.cache_deactivate(self)
self._proc_basic_info.cache_deactivate(self)
self._proc_cred.cache_deactivate(self)
@wrap_exceptions
@memoize_when_activated
def _proc_name_and_args(self):
return cext.proc_name_and_args(self.pid, self._procfs_path)
@wrap_exceptions
@memoize_when_activated
def _proc_basic_info(self):
if self.pid == 0 and not os.path.exists(
'%s/%s/psinfo' % (self._procfs_path, self.pid)
):
raise AccessDenied(self.pid)
ret = cext.proc_basic_info(self.pid, self._procfs_path)
assert len(ret) == len(proc_info_map)
return ret
@wrap_exceptions
@memoize_when_activated
def _proc_cred(self):
return cext.proc_cred(self.pid, self._procfs_path)
@wrap_exceptions
def name(self):
# note: max len == 15
return self._proc_name_and_args()[0]
@wrap_exceptions
def exe(self):
try:
return os.readlink(
"%s/%s/path/a.out" % (self._procfs_path, self.pid)
)
except OSError:
pass # continue and guess the exe name from the cmdline
# Will be guessed later from cmdline but we want to explicitly
# invoke cmdline here in order to get an AccessDenied
# exception if the user has not enough privileges.
self.cmdline()
return ""
@wrap_exceptions
def cmdline(self):
return self._proc_name_and_args()[1].split(' ')
@wrap_exceptions
def environ(self):
return cext.proc_environ(self.pid, self._procfs_path)
@wrap_exceptions
def create_time(self):
return self._proc_basic_info()[proc_info_map['create_time']]
@wrap_exceptions
def num_threads(self):
return self._proc_basic_info()[proc_info_map['num_threads']]
@wrap_exceptions
def nice_get(self):
# Note #1: getpriority(3) doesn't work for realtime processes.
# Psinfo is what ps uses, see:
# https://github.com/giampaolo/psutil/issues/1194
return self._proc_basic_info()[proc_info_map['nice']]
@wrap_exceptions
def nice_set(self, value):
if self.pid in (2, 3):
# Special case PIDs: internally setpriority(3) return ESRCH
# (no such process), no matter what.
# The process actually exists though, as it has a name,
# creation time, etc.
raise AccessDenied(self.pid, self._name)
return cext_posix.setpriority(self.pid, value)
@wrap_exceptions
def ppid(self):
self._ppid = self._proc_basic_info()[proc_info_map['ppid']]
return self._ppid
@wrap_exceptions
def uids(self):
try:
real, effective, saved, _, _, _ = self._proc_cred()
except AccessDenied:
real = self._proc_basic_info()[proc_info_map['uid']]
effective = self._proc_basic_info()[proc_info_map['euid']]
saved = None
return _common.puids(real, effective, saved)
@wrap_exceptions
def gids(self):
try:
_, _, _, real, effective, saved = self._proc_cred()
except AccessDenied:
real = self._proc_basic_info()[proc_info_map['gid']]
effective = self._proc_basic_info()[proc_info_map['egid']]
saved = None
return _common.puids(real, effective, saved)
@wrap_exceptions
def cpu_times(self):
try:
times = cext.proc_cpu_times(self.pid, self._procfs_path)
except OSError as err:
if err.errno == errno.EOVERFLOW and not IS_64_BIT:
# We may get here if we attempt to query a 64bit process
# with a 32bit python.
# Error originates from read() and also tools like "cat"
# fail in the same way (!).
# Since there simply is no way to determine CPU times we
# return 0.0 as a fallback. See:
# https://github.com/giampaolo/psutil/issues/857
times = (0.0, 0.0, 0.0, 0.0)
else:
raise
return _common.pcputimes(*times)
@wrap_exceptions
def cpu_num(self):
return cext.proc_cpu_num(self.pid, self._procfs_path)
@wrap_exceptions
def terminal(self):
procfs_path = self._procfs_path
hit_enoent = False
tty = wrap_exceptions(self._proc_basic_info()[proc_info_map['ttynr']])
if tty != cext.PRNODEV:
for x in (0, 1, 2, 255):
try:
return os.readlink(
'%s/%d/path/%d' % (procfs_path, self.pid, x)
)
except FileNotFoundError:
hit_enoent = True
continue
if hit_enoent:
self._assert_alive()
@wrap_exceptions
def cwd(self):
# /proc/PID/path/cwd may not be resolved by readlink() even if
# it exists (ls shows it). If that's the case and the process
# is still alive return None (we can return None also on BSD).
# Reference: http://goo.gl/55XgO
procfs_path = self._procfs_path
try:
return os.readlink("%s/%s/path/cwd" % (procfs_path, self.pid))
except FileNotFoundError:
os.stat("%s/%s" % (procfs_path, self.pid)) # raise NSP or AD
return ""
@wrap_exceptions
def memory_info(self):
ret = self._proc_basic_info()
rss = ret[proc_info_map['rss']] * 1024
vms = ret[proc_info_map['vms']] * 1024
return pmem(rss, vms)
memory_full_info = memory_info
@wrap_exceptions
def status(self):
code = self._proc_basic_info()[proc_info_map['status']]
# XXX is '?' legit? (we're not supposed to return it anyway)
return PROC_STATUSES.get(code, '?')
@wrap_exceptions
def threads(self):
procfs_path = self._procfs_path
ret = []
tids = os.listdir('%s/%d/lwp' % (procfs_path, self.pid))
hit_enoent = False
for tid in tids:
tid = int(tid)
try:
utime, stime = cext.query_process_thread(
self.pid, tid, procfs_path
)
except EnvironmentError as err:
if err.errno == errno.EOVERFLOW and not IS_64_BIT:
# We may get here if we attempt to query a 64bit process
# with a 32bit python.
# Error originates from read() and also tools like "cat"
# fail in the same way (!).
# Since there simply is no way to determine CPU times we
# return 0.0 as a fallback. See:
# https://github.com/giampaolo/psutil/issues/857
continue
# ENOENT == thread gone in meantime
if err.errno == errno.ENOENT:
hit_enoent = True
continue
raise
else:
nt = _common.pthread(tid, utime, stime)
ret.append(nt)
if hit_enoent:
self._assert_alive()
return ret
@wrap_exceptions
def open_files(self):
retlist = []
hit_enoent = False
procfs_path = self._procfs_path
pathdir = '%s/%d/path' % (procfs_path, self.pid)
for fd in os.listdir('%s/%d/fd' % (procfs_path, self.pid)):
path = os.path.join(pathdir, fd)
if os.path.islink(path):
try:
file = os.readlink(path)
except FileNotFoundError:
hit_enoent = True
continue
else:
if isfile_strict(file):
retlist.append(_common.popenfile(file, int(fd)))
if hit_enoent:
self._assert_alive()
return retlist
def _get_unix_sockets(self, pid):
"""Get UNIX sockets used by process by parsing 'pfiles' output."""
# TODO: rewrite this in C (...but the damn netstat source code
# does not include this part! Argh!!)
cmd = ["pfiles", str(pid)]
p = subprocess.Popen(
cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
stdout, stderr = p.communicate()
if PY3:
stdout, stderr = (
x.decode(sys.stdout.encoding) for x in (stdout, stderr)
)
if p.returncode != 0:
if 'permission denied' in stderr.lower():
raise AccessDenied(self.pid, self._name)
if 'no such process' in stderr.lower():
raise NoSuchProcess(self.pid, self._name)
raise RuntimeError("%r command error\n%s" % (cmd, stderr))
lines = stdout.split('\n')[2:]
for i, line in enumerate(lines):
line = line.lstrip()
if line.startswith('sockname: AF_UNIX'):
path = line.split(' ', 2)[2]
type = lines[i - 2].strip()
if type == 'SOCK_STREAM':
type = socket.SOCK_STREAM
elif type == 'SOCK_DGRAM':
type = socket.SOCK_DGRAM
else:
type = -1
yield (-1, socket.AF_UNIX, type, path, "", _common.CONN_NONE)
@wrap_exceptions
def net_connections(self, kind='inet'):
ret = net_connections(kind, _pid=self.pid)
# The underlying C implementation retrieves all OS connections
# and filters them by PID. At this point we can't tell whether
# an empty list means there were no connections for process or
# process is no longer active so we force NSP in case the PID
# is no longer there.
if not ret:
# will raise NSP if process is gone
os.stat('%s/%s' % (self._procfs_path, self.pid))
# UNIX sockets
if kind in ('all', 'unix'):
ret.extend([
_common.pconn(*conn)
for conn in self._get_unix_sockets(self.pid)
])
return ret
nt_mmap_grouped = namedtuple('mmap', 'path rss anon locked')
nt_mmap_ext = namedtuple('mmap', 'addr perms path rss anon locked')
@wrap_exceptions
def memory_maps(self):
def toaddr(start, end):
return '%s-%s' % (
hex(start)[2:].strip('L'),
hex(end)[2:].strip('L'),
)
procfs_path = self._procfs_path
retlist = []
try:
rawlist = cext.proc_memory_maps(self.pid, procfs_path)
except OSError as err:
if err.errno == errno.EOVERFLOW and not IS_64_BIT:
# We may get here if we attempt to query a 64bit process
# with a 32bit python.
# Error originates from read() and also tools like "cat"
# fail in the same way (!).
# Since there simply is no way to determine CPU times we
# return 0.0 as a fallback. See:
# https://github.com/giampaolo/psutil/issues/857
return []
else:
raise
hit_enoent = False
for item in rawlist:
addr, addrsize, perm, name, rss, anon, locked = item
addr = toaddr(addr, addrsize)
if not name.startswith('['):
try:
name = os.readlink(
'%s/%s/path/%s' % (procfs_path, self.pid, name)
)
except OSError as err:
if err.errno == errno.ENOENT:
# sometimes the link may not be resolved by
# readlink() even if it exists (ls shows it).
# If that's the case we just return the
# unresolved link path.
# This seems an inconsistency with /proc similar
# to: http://goo.gl/55XgO
name = '%s/%s/path/%s' % (procfs_path, self.pid, name)
hit_enoent = True
else:
raise
retlist.append((addr, perm, name, rss, anon, locked))
if hit_enoent:
self._assert_alive()
return retlist
@wrap_exceptions
def num_fds(self):
return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
@wrap_exceptions
def num_ctx_switches(self):
return _common.pctxsw(
*cext.proc_num_ctx_switches(self.pid, self._procfs_path)
)
@wrap_exceptions
def wait(self, timeout=None):
return _psposix.wait_pid(self.pid, timeout, self._name)
PK ok\;�`�} �} psutil/_psbsd.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""FreeBSD, OpenBSD and NetBSD platforms implementation."""
import contextlib
import errno
import functools
import os
from collections import defaultdict
from collections import namedtuple
from xml.etree import ElementTree # noqa ICN001
from . import _common
from . import _psposix
from . import _psutil_bsd as cext
from . import _psutil_posix as cext_posix
from ._common import FREEBSD
from ._common import NETBSD
from ._common import OPENBSD
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import ZombieProcess
from ._common import conn_tmap
from ._common import conn_to_ntuple
from ._common import debug
from ._common import memoize
from ._common import memoize_when_activated
from ._common import usage_percent
from ._compat import FileNotFoundError
from ._compat import PermissionError
from ._compat import ProcessLookupError
from ._compat import which
__extra__all__ = []
# =====================================================================
# --- globals
# =====================================================================
if FREEBSD:
PROC_STATUSES = {
cext.SIDL: _common.STATUS_IDLE,
cext.SRUN: _common.STATUS_RUNNING,
cext.SSLEEP: _common.STATUS_SLEEPING,
cext.SSTOP: _common.STATUS_STOPPED,
cext.SZOMB: _common.STATUS_ZOMBIE,
cext.SWAIT: _common.STATUS_WAITING,
cext.SLOCK: _common.STATUS_LOCKED,
}
elif OPENBSD:
PROC_STATUSES = {
cext.SIDL: _common.STATUS_IDLE,
cext.SSLEEP: _common.STATUS_SLEEPING,
cext.SSTOP: _common.STATUS_STOPPED,
# According to /usr/include/sys/proc.h SZOMB is unused.
# test_zombie_process() shows that SDEAD is the right
# equivalent. Also it appears there's no equivalent of
# psutil.STATUS_DEAD. SDEAD really means STATUS_ZOMBIE.
# cext.SZOMB: _common.STATUS_ZOMBIE,
cext.SDEAD: _common.STATUS_ZOMBIE,
cext.SZOMB: _common.STATUS_ZOMBIE,
# From http://www.eecs.harvard.edu/~margo/cs161/videos/proc.h.txt
# OpenBSD has SRUN and SONPROC: SRUN indicates that a process
# is runnable but *not* yet running, i.e. is on a run queue.
# SONPROC indicates that the process is actually executing on
# a CPU, i.e. it is no longer on a run queue.
# As such we'll map SRUN to STATUS_WAKING and SONPROC to
# STATUS_RUNNING
cext.SRUN: _common.STATUS_WAKING,
cext.SONPROC: _common.STATUS_RUNNING,
}
elif NETBSD:
PROC_STATUSES = {
cext.SIDL: _common.STATUS_IDLE,
cext.SSLEEP: _common.STATUS_SLEEPING,
cext.SSTOP: _common.STATUS_STOPPED,
cext.SZOMB: _common.STATUS_ZOMBIE,
cext.SRUN: _common.STATUS_WAKING,
cext.SONPROC: _common.STATUS_RUNNING,
}
TCP_STATUSES = {
cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
cext.TCPS_SYN_RECEIVED: _common.CONN_SYN_RECV,
cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
cext.TCPS_CLOSED: _common.CONN_CLOSE,
cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
cext.TCPS_LISTEN: _common.CONN_LISTEN,
cext.TCPS_CLOSING: _common.CONN_CLOSING,
cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
}
PAGESIZE = cext_posix.getpagesize()
AF_LINK = cext_posix.AF_LINK
HAS_PER_CPU_TIMES = hasattr(cext, "per_cpu_times")
HAS_PROC_NUM_THREADS = hasattr(cext, "proc_num_threads")
HAS_PROC_OPEN_FILES = hasattr(cext, 'proc_open_files')
HAS_PROC_NUM_FDS = hasattr(cext, 'proc_num_fds')
kinfo_proc_map = dict(
ppid=0,
status=1,
real_uid=2,
effective_uid=3,
saved_uid=4,
real_gid=5,
effective_gid=6,
saved_gid=7,
ttynr=8,
create_time=9,
ctx_switches_vol=10,
ctx_switches_unvol=11,
read_io_count=12,
write_io_count=13,
user_time=14,
sys_time=15,
ch_user_time=16,
ch_sys_time=17,
rss=18,
vms=19,
memtext=20,
memdata=21,
memstack=22,
cpunum=23,
name=24,
)
# =====================================================================
# --- named tuples
# =====================================================================
# fmt: off
# psutil.virtual_memory()
svmem = namedtuple(
'svmem', ['total', 'available', 'percent', 'used', 'free',
'active', 'inactive', 'buffers', 'cached', 'shared', 'wired'])
# psutil.cpu_times()
scputimes = namedtuple(
'scputimes', ['user', 'nice', 'system', 'idle', 'irq'])
# psutil.Process.memory_info()
pmem = namedtuple('pmem', ['rss', 'vms', 'text', 'data', 'stack'])
# psutil.Process.memory_full_info()
pfullmem = pmem
# psutil.Process.cpu_times()
pcputimes = namedtuple('pcputimes',
['user', 'system', 'children_user', 'children_system'])
# psutil.Process.memory_maps(grouped=True)
pmmap_grouped = namedtuple(
'pmmap_grouped', 'path rss, private, ref_count, shadow_count')
# psutil.Process.memory_maps(grouped=False)
pmmap_ext = namedtuple(
'pmmap_ext', 'addr, perms path rss, private, ref_count, shadow_count')
# psutil.disk_io_counters()
if FREEBSD:
sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
'read_bytes', 'write_bytes',
'read_time', 'write_time',
'busy_time'])
else:
sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
'read_bytes', 'write_bytes'])
# fmt: on
# =====================================================================
# --- memory
# =====================================================================
def virtual_memory():
mem = cext.virtual_mem()
if NETBSD:
total, free, active, inactive, wired, cached = mem
# On NetBSD buffers and shared mem is determined via /proc.
# The C ext set them to 0.
with open('/proc/meminfo', 'rb') as f:
for line in f:
if line.startswith(b'Buffers:'):
buffers = int(line.split()[1]) * 1024
elif line.startswith(b'MemShared:'):
shared = int(line.split()[1]) * 1024
# Before avail was calculated as (inactive + cached + free),
# same as zabbix, but it turned out it could exceed total (see
# #2233), so zabbix seems to be wrong. Htop calculates it
# differently, and the used value seem more realistic, so let's
# match htop.
# https://github.com/htop-dev/htop/blob/e7f447b/netbsd/NetBSDProcessList.c#L162 # noqa
# https://github.com/zabbix/zabbix/blob/af5e0f8/src/libs/zbxsysinfo/netbsd/memory.c#L135 # noqa
used = active + wired
avail = total - used
else:
total, free, active, inactive, wired, cached, buffers, shared = mem
# matches freebsd-memory CLI:
# * https://people.freebsd.org/~rse/dist/freebsd-memory
# * https://www.cyberciti.biz/files/scripts/freebsd-memory.pl.txt
# matches zabbix:
# * https://github.com/zabbix/zabbix/blob/af5e0f8/src/libs/zbxsysinfo/freebsd/memory.c#L143 # noqa
avail = inactive + cached + free
used = active + wired + cached
percent = usage_percent((total - avail), total, round_=1)
return svmem(
total,
avail,
percent,
used,
free,
active,
inactive,
buffers,
cached,
shared,
wired,
)
def swap_memory():
"""System swap memory as (total, used, free, sin, sout) namedtuple."""
total, used, free, sin, sout = cext.swap_mem()
percent = usage_percent(used, total, round_=1)
return _common.sswap(total, used, free, percent, sin, sout)
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return system per-CPU times as a namedtuple."""
user, nice, system, idle, irq = cext.cpu_times()
return scputimes(user, nice, system, idle, irq)
if HAS_PER_CPU_TIMES:
def per_cpu_times():
"""Return system CPU times as a namedtuple."""
ret = []
for cpu_t in cext.per_cpu_times():
user, nice, system, idle, irq = cpu_t
item = scputimes(user, nice, system, idle, irq)
ret.append(item)
return ret
else:
# XXX
# Ok, this is very dirty.
# On FreeBSD < 8 we cannot gather per-cpu information, see:
# https://github.com/giampaolo/psutil/issues/226
# If num cpus > 1, on first call we return single cpu times to avoid a
# crash at psutil import time.
# Next calls will fail with NotImplementedError
def per_cpu_times():
"""Return system CPU times as a namedtuple."""
if cpu_count_logical() == 1:
return [cpu_times()]
if per_cpu_times.__called__:
msg = "supported only starting from FreeBSD 8"
raise NotImplementedError(msg)
per_cpu_times.__called__ = True
return [cpu_times()]
per_cpu_times.__called__ = False
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
return cext.cpu_count_logical()
if OPENBSD or NETBSD:
def cpu_count_cores():
# OpenBSD and NetBSD do not implement this.
return 1 if cpu_count_logical() == 1 else None
else:
def cpu_count_cores():
"""Return the number of CPU cores in the system."""
# From the C module we'll get an XML string similar to this:
# http://manpages.ubuntu.com/manpages/precise/man4/smp.4freebsd.html
# We may get None in case "sysctl kern.sched.topology_spec"
# is not supported on this BSD version, in which case we'll mimic
# os.cpu_count() and return None.
ret = None
s = cext.cpu_topology()
if s is not None:
# get rid of padding chars appended at the end of the string
index = s.rfind("</groups>")
if index != -1:
s = s[: index + 9]
root = ElementTree.fromstring(s)
try:
ret = len(root.findall('group/children/group/cpu')) or None
finally:
# needed otherwise it will memleak
root.clear()
if not ret:
# If logical CPUs == 1 it's obvious we' have only 1 core.
if cpu_count_logical() == 1:
return 1
return ret
def cpu_stats():
"""Return various CPU stats as a named tuple."""
if FREEBSD:
# Note: the C ext is returning some metrics we are not exposing:
# traps.
ctxsw, intrs, soft_intrs, syscalls, _traps = cext.cpu_stats()
elif NETBSD:
# XXX
# Note about intrs: the C extension returns 0. intrs
# can be determined via /proc/stat; it has the same value as
# soft_intrs thought so the kernel is faking it (?).
#
# Note about syscalls: the C extension always sets it to 0 (?).
#
# Note: the C ext is returning some metrics we are not exposing:
# traps, faults and forks.
ctxsw, intrs, soft_intrs, syscalls, _traps, _faults, _forks = (
cext.cpu_stats()
)
with open('/proc/stat', 'rb') as f:
for line in f:
if line.startswith(b'intr'):
intrs = int(line.split()[1])
elif OPENBSD:
# Note: the C ext is returning some metrics we are not exposing:
# traps, faults and forks.
ctxsw, intrs, soft_intrs, syscalls, _traps, _faults, _forks = (
cext.cpu_stats()
)
return _common.scpustats(ctxsw, intrs, soft_intrs, syscalls)
if FREEBSD:
def cpu_freq():
"""Return frequency metrics for CPUs. As of Dec 2018 only
CPU 0 appears to be supported by FreeBSD and all other cores
match the frequency of CPU 0.
"""
ret = []
num_cpus = cpu_count_logical()
for cpu in range(num_cpus):
try:
current, available_freq = cext.cpu_freq(cpu)
except NotImplementedError:
continue
if available_freq:
try:
min_freq = int(available_freq.split(" ")[-1].split("/")[0])
except (IndexError, ValueError):
min_freq = None
try:
max_freq = int(available_freq.split(" ")[0].split("/")[0])
except (IndexError, ValueError):
max_freq = None
ret.append(_common.scpufreq(current, min_freq, max_freq))
return ret
elif OPENBSD:
def cpu_freq():
curr = float(cext.cpu_freq())
return [_common.scpufreq(curr, 0.0, 0.0)]
# =====================================================================
# --- disks
# =====================================================================
def disk_partitions(all=False):
"""Return mounted disk partitions as a list of namedtuples.
'all' argument is ignored, see:
https://github.com/giampaolo/psutil/issues/906.
"""
retlist = []
partitions = cext.disk_partitions()
for partition in partitions:
device, mountpoint, fstype, opts = partition
ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
retlist.append(ntuple)
return retlist
disk_usage = _psposix.disk_usage
disk_io_counters = cext.disk_io_counters
# =====================================================================
# --- network
# =====================================================================
net_io_counters = cext.net_io_counters
net_if_addrs = cext_posix.net_if_addrs
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
names = net_io_counters().keys()
ret = {}
for name in names:
try:
mtu = cext_posix.net_if_mtu(name)
flags = cext_posix.net_if_flags(name)
duplex, speed = cext_posix.net_if_duplex_speed(name)
except OSError as err:
# https://github.com/giampaolo/psutil/issues/1279
if err.errno != errno.ENODEV:
raise
else:
if hasattr(_common, 'NicDuplex'):
duplex = _common.NicDuplex(duplex)
output_flags = ','.join(flags)
isup = 'running' in flags
ret[name] = _common.snicstats(
isup, duplex, speed, mtu, output_flags
)
return ret
def net_connections(kind):
"""System-wide network connections."""
if kind not in _common.conn_tmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in conn_tmap]))
)
families, types = conn_tmap[kind]
ret = set()
if OPENBSD:
rawlist = cext.net_connections(-1, families, types)
elif NETBSD:
rawlist = cext.net_connections(-1, kind)
else: # FreeBSD
rawlist = cext.net_connections(families, types)
for item in rawlist:
fd, fam, type, laddr, raddr, status, pid = item
nt = conn_to_ntuple(
fd, fam, type, laddr, raddr, status, TCP_STATUSES, pid
)
ret.add(nt)
return list(ret)
# =====================================================================
# --- sensors
# =====================================================================
if FREEBSD:
def sensors_battery():
"""Return battery info."""
try:
percent, minsleft, power_plugged = cext.sensors_battery()
except NotImplementedError:
# See: https://github.com/giampaolo/psutil/issues/1074
return None
power_plugged = power_plugged == 1
if power_plugged:
secsleft = _common.POWER_TIME_UNLIMITED
elif minsleft == -1:
secsleft = _common.POWER_TIME_UNKNOWN
else:
secsleft = minsleft * 60
return _common.sbattery(percent, secsleft, power_plugged)
def sensors_temperatures():
"""Return CPU cores temperatures if available, else an empty dict."""
ret = defaultdict(list)
num_cpus = cpu_count_logical()
for cpu in range(num_cpus):
try:
current, high = cext.sensors_cpu_temperature(cpu)
if high <= 0:
high = None
name = "Core %s" % cpu
ret["coretemp"].append(
_common.shwtemp(name, current, high, high)
)
except NotImplementedError:
pass
return ret
# =====================================================================
# --- other system functions
# =====================================================================
def boot_time():
"""The system boot time expressed in seconds since the epoch."""
return cext.boot_time()
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
for item in rawlist:
user, tty, hostname, tstamp, pid = item
if pid == -1:
assert OPENBSD
pid = None
if tty == '~':
continue # reboot or shutdown
nt = _common.suser(user, tty or None, hostname, tstamp, pid)
retlist.append(nt)
return retlist
# =====================================================================
# --- processes
# =====================================================================
@memoize
def _pid_0_exists():
try:
Process(0).name()
except NoSuchProcess:
return False
except AccessDenied:
return True
else:
return True
def pids():
"""Returns a list of PIDs currently running on the system."""
ret = cext.pids()
if OPENBSD and (0 not in ret) and _pid_0_exists():
# On OpenBSD the kernel does not return PID 0 (neither does
# ps) but it's actually querable (Process(0) will succeed).
ret.insert(0, 0)
return ret
if NETBSD:
def pid_exists(pid):
exists = _psposix.pid_exists(pid)
if not exists:
# We do this because _psposix.pid_exists() lies in case of
# zombie processes.
return pid in pids()
else:
return True
elif OPENBSD:
def pid_exists(pid):
exists = _psposix.pid_exists(pid)
if not exists:
return False
else:
# OpenBSD seems to be the only BSD platform where
# _psposix.pid_exists() returns True for thread IDs (tids),
# so we can't use it.
return pid in pids()
else: # FreeBSD
pid_exists = _psposix.pid_exists
def is_zombie(pid):
try:
st = cext.proc_oneshot_info(pid)[kinfo_proc_map['status']]
return PROC_STATUSES.get(st) == _common.STATUS_ZOMBIE
except OSError:
return False
def wrap_exceptions(fun):
"""Decorator which translates bare OSError exceptions into
NoSuchProcess and AccessDenied.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except ProcessLookupError:
if is_zombie(self.pid):
raise ZombieProcess(self.pid, self._name, self._ppid)
else:
raise NoSuchProcess(self.pid, self._name)
except PermissionError:
raise AccessDenied(self.pid, self._name)
except OSError:
if self.pid == 0:
if 0 in pids():
raise AccessDenied(self.pid, self._name)
else:
raise
raise
return wrapper
@contextlib.contextmanager
def wrap_exceptions_procfs(inst):
"""Same as above, for routines relying on reading /proc fs."""
try:
yield
except (ProcessLookupError, FileNotFoundError):
# ENOENT (no such file or directory) gets raised on open().
# ESRCH (no such process) can get raised on read() if
# process is gone in meantime.
if is_zombie(inst.pid):
raise ZombieProcess(inst.pid, inst._name, inst._ppid)
else:
raise NoSuchProcess(inst.pid, inst._name)
except PermissionError:
raise AccessDenied(inst.pid, inst._name)
class Process:
"""Wrapper class around underlying C implementation."""
__slots__ = ["_cache", "_name", "_ppid", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
def _assert_alive(self):
"""Raise NSP if the process disappeared on us."""
# For those C function who do not raise NSP, possibly returning
# incorrect or incomplete result.
cext.proc_name(self.pid)
@wrap_exceptions
@memoize_when_activated
def oneshot(self):
"""Retrieves multiple process info in one shot as a raw tuple."""
ret = cext.proc_oneshot_info(self.pid)
assert len(ret) == len(kinfo_proc_map)
return ret
def oneshot_enter(self):
self.oneshot.cache_activate(self)
def oneshot_exit(self):
self.oneshot.cache_deactivate(self)
@wrap_exceptions
def name(self):
name = self.oneshot()[kinfo_proc_map['name']]
return name if name is not None else cext.proc_name(self.pid)
@wrap_exceptions
def exe(self):
if FREEBSD:
if self.pid == 0:
return '' # else NSP
return cext.proc_exe(self.pid)
elif NETBSD:
if self.pid == 0:
# /proc/0 dir exists but /proc/0/exe doesn't
return ""
with wrap_exceptions_procfs(self):
return os.readlink("/proc/%s/exe" % self.pid)
else:
# OpenBSD: exe cannot be determined; references:
# https://chromium.googlesource.com/chromium/src/base/+/
# master/base_paths_posix.cc
# We try our best guess by using which against the first
# cmdline arg (may return None).
cmdline = self.cmdline()
if cmdline:
return which(cmdline[0]) or ""
else:
return ""
@wrap_exceptions
def cmdline(self):
if OPENBSD and self.pid == 0:
return [] # ...else it crashes
elif NETBSD:
# XXX - most of the times the underlying sysctl() call on
# NetBSD and OpenBSD returns a truncated string. Also
# /proc/pid/cmdline behaves the same so it looks like this
# is a kernel bug.
try:
return cext.proc_cmdline(self.pid)
except OSError as err:
if err.errno == errno.EINVAL:
if is_zombie(self.pid):
raise ZombieProcess(self.pid, self._name, self._ppid)
elif not pid_exists(self.pid):
raise NoSuchProcess(self.pid, self._name, self._ppid)
else:
# XXX: this happens with unicode tests. It means the C
# routine is unable to decode invalid unicode chars.
debug("ignoring %r and returning an empty list" % err)
return []
else:
raise
else:
return cext.proc_cmdline(self.pid)
@wrap_exceptions
def environ(self):
return cext.proc_environ(self.pid)
@wrap_exceptions
def terminal(self):
tty_nr = self.oneshot()[kinfo_proc_map['ttynr']]
tmap = _psposix.get_terminal_map()
try:
return tmap[tty_nr]
except KeyError:
return None
@wrap_exceptions
def ppid(self):
self._ppid = self.oneshot()[kinfo_proc_map['ppid']]
return self._ppid
@wrap_exceptions
def uids(self):
rawtuple = self.oneshot()
return _common.puids(
rawtuple[kinfo_proc_map['real_uid']],
rawtuple[kinfo_proc_map['effective_uid']],
rawtuple[kinfo_proc_map['saved_uid']],
)
@wrap_exceptions
def gids(self):
rawtuple = self.oneshot()
return _common.pgids(
rawtuple[kinfo_proc_map['real_gid']],
rawtuple[kinfo_proc_map['effective_gid']],
rawtuple[kinfo_proc_map['saved_gid']],
)
@wrap_exceptions
def cpu_times(self):
rawtuple = self.oneshot()
return _common.pcputimes(
rawtuple[kinfo_proc_map['user_time']],
rawtuple[kinfo_proc_map['sys_time']],
rawtuple[kinfo_proc_map['ch_user_time']],
rawtuple[kinfo_proc_map['ch_sys_time']],
)
if FREEBSD:
@wrap_exceptions
def cpu_num(self):
return self.oneshot()[kinfo_proc_map['cpunum']]
@wrap_exceptions
def memory_info(self):
rawtuple = self.oneshot()
return pmem(
rawtuple[kinfo_proc_map['rss']],
rawtuple[kinfo_proc_map['vms']],
rawtuple[kinfo_proc_map['memtext']],
rawtuple[kinfo_proc_map['memdata']],
rawtuple[kinfo_proc_map['memstack']],
)
memory_full_info = memory_info
@wrap_exceptions
def create_time(self):
return self.oneshot()[kinfo_proc_map['create_time']]
@wrap_exceptions
def num_threads(self):
if HAS_PROC_NUM_THREADS:
# FreeBSD
return cext.proc_num_threads(self.pid)
else:
return len(self.threads())
@wrap_exceptions
def num_ctx_switches(self):
rawtuple = self.oneshot()
return _common.pctxsw(
rawtuple[kinfo_proc_map['ctx_switches_vol']],
rawtuple[kinfo_proc_map['ctx_switches_unvol']],
)
@wrap_exceptions
def threads(self):
# Note: on OpenSBD this (/dev/mem) requires root access.
rawlist = cext.proc_threads(self.pid)
retlist = []
for thread_id, utime, stime in rawlist:
ntuple = _common.pthread(thread_id, utime, stime)
retlist.append(ntuple)
if OPENBSD:
self._assert_alive()
return retlist
@wrap_exceptions
def net_connections(self, kind='inet'):
if kind not in conn_tmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in conn_tmap]))
)
families, types = conn_tmap[kind]
ret = []
if NETBSD:
rawlist = cext.net_connections(self.pid, kind)
elif OPENBSD:
rawlist = cext.net_connections(self.pid, families, types)
else:
rawlist = cext.proc_net_connections(self.pid, families, types)
for item in rawlist:
fd, fam, type, laddr, raddr, status = item[:6]
if FREEBSD:
if (fam not in families) or (type not in types):
continue
nt = conn_to_ntuple(
fd, fam, type, laddr, raddr, status, TCP_STATUSES
)
ret.append(nt)
self._assert_alive()
return ret
@wrap_exceptions
def wait(self, timeout=None):
return _psposix.wait_pid(self.pid, timeout, self._name)
@wrap_exceptions
def nice_get(self):
return cext_posix.getpriority(self.pid)
@wrap_exceptions
def nice_set(self, value):
return cext_posix.setpriority(self.pid, value)
@wrap_exceptions
def status(self):
code = self.oneshot()[kinfo_proc_map['status']]
# XXX is '?' legit? (we're not supposed to return it anyway)
return PROC_STATUSES.get(code, '?')
@wrap_exceptions
def io_counters(self):
rawtuple = self.oneshot()
return _common.pio(
rawtuple[kinfo_proc_map['read_io_count']],
rawtuple[kinfo_proc_map['write_io_count']],
-1,
-1,
)
@wrap_exceptions
def cwd(self):
"""Return process current working directory."""
# sometimes we get an empty string, in which case we turn
# it into None
if OPENBSD and self.pid == 0:
return "" # ...else it would raise EINVAL
elif NETBSD or HAS_PROC_OPEN_FILES:
# FreeBSD < 8 does not support functions based on
# kinfo_getfile() and kinfo_getvmmap()
return cext.proc_cwd(self.pid)
else:
raise NotImplementedError(
"supported only starting from FreeBSD 8" if FREEBSD else ""
)
nt_mmap_grouped = namedtuple(
'mmap', 'path rss, private, ref_count, shadow_count'
)
nt_mmap_ext = namedtuple(
'mmap', 'addr, perms path rss, private, ref_count, shadow_count'
)
def _not_implemented(self):
raise NotImplementedError
# FreeBSD < 8 does not support functions based on kinfo_getfile()
# and kinfo_getvmmap()
if HAS_PROC_OPEN_FILES:
@wrap_exceptions
def open_files(self):
"""Return files opened by process as a list of namedtuples."""
rawlist = cext.proc_open_files(self.pid)
return [_common.popenfile(path, fd) for path, fd in rawlist]
else:
open_files = _not_implemented
# FreeBSD < 8 does not support functions based on kinfo_getfile()
# and kinfo_getvmmap()
if HAS_PROC_NUM_FDS:
@wrap_exceptions
def num_fds(self):
"""Return the number of file descriptors opened by this process."""
ret = cext.proc_num_fds(self.pid)
if NETBSD:
self._assert_alive()
return ret
else:
num_fds = _not_implemented
# --- FreeBSD only APIs
if FREEBSD:
@wrap_exceptions
def cpu_affinity_get(self):
return cext.proc_cpu_affinity_get(self.pid)
@wrap_exceptions
def cpu_affinity_set(self, cpus):
# Pre-emptively check if CPUs are valid because the C
# function has a weird behavior in case of invalid CPUs,
# see: https://github.com/giampaolo/psutil/issues/586
allcpus = tuple(range(len(per_cpu_times())))
for cpu in cpus:
if cpu not in allcpus:
raise ValueError(
"invalid CPU #%i (choose between %s)" % (cpu, allcpus)
)
try:
cext.proc_cpu_affinity_set(self.pid, cpus)
except OSError as err:
# 'man cpuset_setaffinity' about EDEADLK:
# <<the call would leave a thread without a valid CPU to run
# on because the set does not overlap with the thread's
# anonymous mask>>
if err.errno in (errno.EINVAL, errno.EDEADLK):
for cpu in cpus:
if cpu not in allcpus:
raise ValueError(
"invalid CPU #%i (choose between %s)"
% (cpu, allcpus)
)
raise
@wrap_exceptions
def memory_maps(self):
return cext.proc_memory_maps(self.pid)
@wrap_exceptions
def rlimit(self, resource, limits=None):
if limits is None:
return cext.proc_getrlimit(self.pid, resource)
else:
if len(limits) != 2:
raise ValueError(
"second argument must be a (soft, hard) tuple, got %s"
% repr(limits)
)
soft, hard = limits
return cext.proc_setrlimit(self.pid, resource, soft, hard)
PK ok\w�]�� � psutil/_pswindows.pynu �[��� # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Windows platform implementation."""
import contextlib
import errno
import functools
import os
import signal
import sys
import time
from collections import namedtuple
from . import _common
from ._common import ENCODING
from ._common import ENCODING_ERRS
from ._common import AccessDenied
from ._common import NoSuchProcess
from ._common import TimeoutExpired
from ._common import conn_tmap
from ._common import conn_to_ntuple
from ._common import debug
from ._common import isfile_strict
from ._common import memoize
from ._common import memoize_when_activated
from ._common import parse_environ_block
from ._common import usage_percent
from ._compat import PY3
from ._compat import long
from ._compat import lru_cache
from ._compat import range
from ._compat import unicode
from ._psutil_windows import ABOVE_NORMAL_PRIORITY_CLASS
from ._psutil_windows import BELOW_NORMAL_PRIORITY_CLASS
from ._psutil_windows import HIGH_PRIORITY_CLASS
from ._psutil_windows import IDLE_PRIORITY_CLASS
from ._psutil_windows import NORMAL_PRIORITY_CLASS
from ._psutil_windows import REALTIME_PRIORITY_CLASS
try:
from . import _psutil_windows as cext
except ImportError as err:
if (
str(err).lower().startswith("dll load failed")
and sys.getwindowsversion()[0] < 6
):
# We may get here if:
# 1) we are on an old Windows version
# 2) psutil was installed via pip + wheel
# See: https://github.com/giampaolo/psutil/issues/811
msg = "this Windows version is too old (< Windows Vista); "
msg += "psutil 3.4.2 is the latest version which supports Windows "
msg += "2000, XP and 2003 server"
raise RuntimeError(msg)
else:
raise
if PY3:
import enum
else:
enum = None
# process priority constants, import from __init__.py:
# http://msdn.microsoft.com/en-us/library/ms686219(v=vs.85).aspx
# fmt: off
__extra__all__ = [
"win_service_iter", "win_service_get",
# Process priority
"ABOVE_NORMAL_PRIORITY_CLASS", "BELOW_NORMAL_PRIORITY_CLASS",
"HIGH_PRIORITY_CLASS", "IDLE_PRIORITY_CLASS", "NORMAL_PRIORITY_CLASS",
"REALTIME_PRIORITY_CLASS",
# IO priority
"IOPRIO_VERYLOW", "IOPRIO_LOW", "IOPRIO_NORMAL", "IOPRIO_HIGH",
# others
"CONN_DELETE_TCB", "AF_LINK",
]
# fmt: on
# =====================================================================
# --- globals
# =====================================================================
CONN_DELETE_TCB = "DELETE_TCB"
ERROR_PARTIAL_COPY = 299
PYPY = '__pypy__' in sys.builtin_module_names
if enum is None:
AF_LINK = -1
else:
AddressFamily = enum.IntEnum('AddressFamily', {'AF_LINK': -1})
AF_LINK = AddressFamily.AF_LINK
TCP_STATUSES = {
cext.MIB_TCP_STATE_ESTAB: _common.CONN_ESTABLISHED,
cext.MIB_TCP_STATE_SYN_SENT: _common.CONN_SYN_SENT,
cext.MIB_TCP_STATE_SYN_RCVD: _common.CONN_SYN_RECV,
cext.MIB_TCP_STATE_FIN_WAIT1: _common.CONN_FIN_WAIT1,
cext.MIB_TCP_STATE_FIN_WAIT2: _common.CONN_FIN_WAIT2,
cext.MIB_TCP_STATE_TIME_WAIT: _common.CONN_TIME_WAIT,
cext.MIB_TCP_STATE_CLOSED: _common.CONN_CLOSE,
cext.MIB_TCP_STATE_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
cext.MIB_TCP_STATE_LAST_ACK: _common.CONN_LAST_ACK,
cext.MIB_TCP_STATE_LISTEN: _common.CONN_LISTEN,
cext.MIB_TCP_STATE_CLOSING: _common.CONN_CLOSING,
cext.MIB_TCP_STATE_DELETE_TCB: CONN_DELETE_TCB,
cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
}
if enum is not None:
class Priority(enum.IntEnum):
ABOVE_NORMAL_PRIORITY_CLASS = ABOVE_NORMAL_PRIORITY_CLASS
BELOW_NORMAL_PRIORITY_CLASS = BELOW_NORMAL_PRIORITY_CLASS
HIGH_PRIORITY_CLASS = HIGH_PRIORITY_CLASS
IDLE_PRIORITY_CLASS = IDLE_PRIORITY_CLASS
NORMAL_PRIORITY_CLASS = NORMAL_PRIORITY_CLASS
REALTIME_PRIORITY_CLASS = REALTIME_PRIORITY_CLASS
globals().update(Priority.__members__)
if enum is None:
IOPRIO_VERYLOW = 0
IOPRIO_LOW = 1
IOPRIO_NORMAL = 2
IOPRIO_HIGH = 3
else:
class IOPriority(enum.IntEnum):
IOPRIO_VERYLOW = 0
IOPRIO_LOW = 1
IOPRIO_NORMAL = 2
IOPRIO_HIGH = 3
globals().update(IOPriority.__members__)
pinfo_map = dict(
num_handles=0,
ctx_switches=1,
user_time=2,
kernel_time=3,
create_time=4,
num_threads=5,
io_rcount=6,
io_wcount=7,
io_rbytes=8,
io_wbytes=9,
io_count_others=10,
io_bytes_others=11,
num_page_faults=12,
peak_wset=13,
wset=14,
peak_paged_pool=15,
paged_pool=16,
peak_non_paged_pool=17,
non_paged_pool=18,
pagefile=19,
peak_pagefile=20,
mem_private=21,
)
# =====================================================================
# --- named tuples
# =====================================================================
# fmt: off
# psutil.cpu_times()
scputimes = namedtuple('scputimes',
['user', 'system', 'idle', 'interrupt', 'dpc'])
# psutil.virtual_memory()
svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
# psutil.Process.memory_info()
pmem = namedtuple(
'pmem', ['rss', 'vms',
'num_page_faults', 'peak_wset', 'wset', 'peak_paged_pool',
'paged_pool', 'peak_nonpaged_pool', 'nonpaged_pool',
'pagefile', 'peak_pagefile', 'private'])
# psutil.Process.memory_full_info()
pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', ))
# psutil.Process.memory_maps(grouped=True)
pmmap_grouped = namedtuple('pmmap_grouped', ['path', 'rss'])
# psutil.Process.memory_maps(grouped=False)
pmmap_ext = namedtuple(
'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields))
# psutil.Process.io_counters()
pio = namedtuple('pio', ['read_count', 'write_count',
'read_bytes', 'write_bytes',
'other_count', 'other_bytes'])
# fmt: on
# =====================================================================
# --- utils
# =====================================================================
@lru_cache(maxsize=512)
def convert_dos_path(s):
r"""Convert paths using native DOS format like:
"\Device\HarddiskVolume1\Windows\systemew\file.txt"
into:
"C:\Windows\systemew\file.txt".
"""
rawdrive = '\\'.join(s.split('\\')[:3])
driveletter = cext.QueryDosDevice(rawdrive)
remainder = s[len(rawdrive) :]
return os.path.join(driveletter, remainder)
def py2_strencode(s):
"""Encode a unicode string to a byte string by using the default fs
encoding + "replace" error handler.
"""
if PY3:
return s
else:
if isinstance(s, str):
return s
else:
return s.encode(ENCODING, ENCODING_ERRS)
@memoize
def getpagesize():
return cext.getpagesize()
# =====================================================================
# --- memory
# =====================================================================
def virtual_memory():
"""System virtual memory as a namedtuple."""
mem = cext.virtual_mem()
totphys, availphys, _totsys, _availsys = mem
total = totphys
avail = availphys
free = availphys
used = total - avail
percent = usage_percent((total - avail), total, round_=1)
return svmem(total, avail, percent, used, free)
def swap_memory():
"""Swap system memory as a (total, used, free, sin, sout) tuple."""
mem = cext.virtual_mem()
total_phys = mem[0]
total_system = mem[2]
# system memory (commit total/limit) is the sum of physical and swap
# thus physical memory values need to be subtracted to get swap values
total = total_system - total_phys
# commit total is incremented immediately (decrementing free_system)
# while the corresponding free physical value is not decremented until
# pages are accessed, so we can't use free system memory for swap.
# instead, we calculate page file usage based on performance counter
if total > 0:
percentswap = cext.swap_percent()
used = int(0.01 * percentswap * total)
else:
percentswap = 0.0
used = 0
free = total - used
percent = round(percentswap, 1)
return _common.sswap(total, used, free, percent, 0, 0)
# =====================================================================
# --- disk
# =====================================================================
disk_io_counters = cext.disk_io_counters
def disk_usage(path):
"""Return disk usage associated with path."""
if PY3 and isinstance(path, bytes):
# XXX: do we want to use "strict"? Probably yes, in order
# to fail immediately. After all we are accepting input here...
path = path.decode(ENCODING, errors="strict")
total, free = cext.disk_usage(path)
used = total - free
percent = usage_percent(used, total, round_=1)
return _common.sdiskusage(total, used, free, percent)
def disk_partitions(all):
"""Return disk partitions."""
rawlist = cext.disk_partitions(all)
return [_common.sdiskpart(*x) for x in rawlist]
# =====================================================================
# --- CPU
# =====================================================================
def cpu_times():
"""Return system CPU times as a named tuple."""
user, system, idle = cext.cpu_times()
# Internally, GetSystemTimes() is used, and it doesn't return
# interrupt and dpc times. cext.per_cpu_times() does, so we
# rely on it to get those only.
percpu_summed = scputimes(*[sum(n) for n in zip(*cext.per_cpu_times())])
return scputimes(
user, system, idle, percpu_summed.interrupt, percpu_summed.dpc
)
def per_cpu_times():
"""Return system per-CPU times as a list of named tuples."""
ret = []
for user, system, idle, interrupt, dpc in cext.per_cpu_times():
item = scputimes(user, system, idle, interrupt, dpc)
ret.append(item)
return ret
def cpu_count_logical():
"""Return the number of logical CPUs in the system."""
return cext.cpu_count_logical()
def cpu_count_cores():
"""Return the number of CPU cores in the system."""
return cext.cpu_count_cores()
def cpu_stats():
"""Return CPU statistics."""
ctx_switches, interrupts, _dpcs, syscalls = cext.cpu_stats()
soft_interrupts = 0
return _common.scpustats(
ctx_switches, interrupts, soft_interrupts, syscalls
)
def cpu_freq():
"""Return CPU frequency.
On Windows per-cpu frequency is not supported.
"""
curr, max_ = cext.cpu_freq()
min_ = 0.0
return [_common.scpufreq(float(curr), min_, float(max_))]
_loadavg_inititialized = False
def getloadavg():
"""Return the number of processes in the system run queue averaged
over the last 1, 5, and 15 minutes respectively as a tuple.
"""
global _loadavg_inititialized
if not _loadavg_inititialized:
cext.init_loadavg_counter()
_loadavg_inititialized = True
# Drop to 2 decimal points which is what Linux does
raw_loads = cext.getloadavg()
return tuple([round(load, 2) for load in raw_loads])
# =====================================================================
# --- network
# =====================================================================
def net_connections(kind, _pid=-1):
"""Return socket connections. If pid == -1 return system-wide
connections (as opposed to connections opened by one process only).
"""
if kind not in conn_tmap:
raise ValueError(
"invalid %r kind argument; choose between %s"
% (kind, ', '.join([repr(x) for x in conn_tmap]))
)
families, types = conn_tmap[kind]
rawlist = cext.net_connections(_pid, families, types)
ret = set()
for item in rawlist:
fd, fam, type, laddr, raddr, status, pid = item
nt = conn_to_ntuple(
fd,
fam,
type,
laddr,
raddr,
status,
TCP_STATUSES,
pid=pid if _pid == -1 else None,
)
ret.add(nt)
return list(ret)
def net_if_stats():
"""Get NIC stats (isup, duplex, speed, mtu)."""
ret = {}
rawdict = cext.net_if_stats()
for name, items in rawdict.items():
if not PY3:
assert isinstance(name, unicode), type(name)
name = py2_strencode(name)
isup, duplex, speed, mtu = items
if hasattr(_common, 'NicDuplex'):
duplex = _common.NicDuplex(duplex)
ret[name] = _common.snicstats(isup, duplex, speed, mtu, '')
return ret
def net_io_counters():
"""Return network I/O statistics for every network interface
installed on the system as a dict of raw tuples.
"""
ret = cext.net_io_counters()
return dict([(py2_strencode(k), v) for k, v in ret.items()])
def net_if_addrs():
"""Return the addresses associated to each NIC."""
ret = []
for items in cext.net_if_addrs():
items = list(items)
items[0] = py2_strencode(items[0])
ret.append(items)
return ret
# =====================================================================
# --- sensors
# =====================================================================
def sensors_battery():
"""Return battery information."""
# For constants meaning see:
# https://msdn.microsoft.com/en-us/library/windows/desktop/
# aa373232(v=vs.85).aspx
acline_status, flags, percent, secsleft = cext.sensors_battery()
power_plugged = acline_status == 1
no_battery = bool(flags & 128)
charging = bool(flags & 8)
if no_battery:
return None
if power_plugged or charging:
secsleft = _common.POWER_TIME_UNLIMITED
elif secsleft == -1:
secsleft = _common.POWER_TIME_UNKNOWN
return _common.sbattery(percent, secsleft, power_plugged)
# =====================================================================
# --- other system functions
# =====================================================================
_last_btime = 0
def boot_time():
"""The system boot time expressed in seconds since the epoch."""
# This dirty hack is to adjust the precision of the returned
# value which may have a 1 second fluctuation, see:
# https://github.com/giampaolo/psutil/issues/1007
global _last_btime
ret = float(cext.boot_time())
if abs(ret - _last_btime) <= 1:
return _last_btime
else:
_last_btime = ret
return ret
def users():
"""Return currently connected users as a list of namedtuples."""
retlist = []
rawlist = cext.users()
for item in rawlist:
user, hostname, tstamp = item
user = py2_strencode(user)
nt = _common.suser(user, None, hostname, tstamp, None)
retlist.append(nt)
return retlist
# =====================================================================
# --- Windows services
# =====================================================================
def win_service_iter():
"""Yields a list of WindowsService instances."""
for name, display_name in cext.winservice_enumerate():
yield WindowsService(py2_strencode(name), py2_strencode(display_name))
def win_service_get(name):
"""Open a Windows service and return it as a WindowsService instance."""
service = WindowsService(name, None)
service._display_name = service._query_config()['display_name']
return service
class WindowsService: # noqa: PLW1641
"""Represents an installed Windows service."""
def __init__(self, name, display_name):
self._name = name
self._display_name = display_name
def __str__(self):
details = "(name=%r, display_name=%r)" % (
self._name,
self._display_name,
)
return "%s%s" % (self.__class__.__name__, details)
def __repr__(self):
return "<%s at %s>" % (self.__str__(), id(self))
def __eq__(self, other):
# Test for equality with another WindosService object based
# on name.
if not isinstance(other, WindowsService):
return NotImplemented
return self._name == other._name
def __ne__(self, other):
return not self == other
def _query_config(self):
with self._wrap_exceptions():
display_name, binpath, username, start_type = (
cext.winservice_query_config(self._name)
)
# XXX - update _self.display_name?
return dict(
display_name=py2_strencode(display_name),
binpath=py2_strencode(binpath),
username=py2_strencode(username),
start_type=py2_strencode(start_type),
)
def _query_status(self):
with self._wrap_exceptions():
status, pid = cext.winservice_query_status(self._name)
if pid == 0:
pid = None
return dict(status=status, pid=pid)
@contextlib.contextmanager
def _wrap_exceptions(self):
"""Ctx manager which translates bare OSError and WindowsError
exceptions into NoSuchProcess and AccessDenied.
"""
try:
yield
except OSError as err:
if is_permission_err(err):
msg = (
"service %r is not querable (not enough privileges)"
% self._name
)
raise AccessDenied(pid=None, name=self._name, msg=msg)
elif err.winerror in (
cext.ERROR_INVALID_NAME,
cext.ERROR_SERVICE_DOES_NOT_EXIST,
):
msg = "service %r does not exist" % self._name
raise NoSuchProcess(pid=None, name=self._name, msg=msg)
else:
raise
# config query
def name(self):
"""The service name. This string is how a service is referenced
and can be passed to win_service_get() to get a new
WindowsService instance.
"""
return self._name
def display_name(self):
"""The service display name. The value is cached when this class
is instantiated.
"""
return self._display_name
def binpath(self):
"""The fully qualified path to the service binary/exe file as
a string, including command line arguments.
"""
return self._query_config()['binpath']
def username(self):
"""The name of the user that owns this service."""
return self._query_config()['username']
def start_type(self):
"""A string which can either be "automatic", "manual" or
"disabled".
"""
return self._query_config()['start_type']
# status query
def pid(self):
"""The process PID, if any, else None. This can be passed
to Process class to control the service's process.
"""
return self._query_status()['pid']
def status(self):
"""Service status as a string."""
return self._query_status()['status']
def description(self):
"""Service long description."""
return py2_strencode(cext.winservice_query_descr(self.name()))
# utils
def as_dict(self):
"""Utility method retrieving all the information above as a
dictionary.
"""
d = self._query_config()
d.update(self._query_status())
d['name'] = self.name()
d['display_name'] = self.display_name()
d['description'] = self.description()
return d
# actions
# XXX: the necessary C bindings for start() and stop() are
# implemented but for now I prefer not to expose them.
# I may change my mind in the future. Reasons:
# - they require Administrator privileges
# - can't implement a timeout for stop() (unless by using a thread,
# which sucks)
# - would require adding ServiceAlreadyStarted and
# ServiceAlreadyStopped exceptions, adding two new APIs.
# - we might also want to have modify(), which would basically mean
# rewriting win32serviceutil.ChangeServiceConfig, which involves a
# lot of stuff (and API constants which would pollute the API), see:
# http://pyxr.sourceforge.net/PyXR/c/python24/lib/site-packages/
# win32/lib/win32serviceutil.py.html#0175
# - psutil is typically about "read only" monitoring stuff;
# win_service_* APIs should only be used to retrieve a service and
# check whether it's running
# def start(self, timeout=None):
# with self._wrap_exceptions():
# cext.winservice_start(self.name())
# if timeout:
# giveup_at = time.time() + timeout
# while True:
# if self.status() == "running":
# return
# else:
# if time.time() > giveup_at:
# raise TimeoutExpired(timeout)
# else:
# time.sleep(.1)
# def stop(self):
# # Note: timeout is not implemented because it's just not
# # possible, see:
# # http://stackoverflow.com/questions/11973228/
# with self._wrap_exceptions():
# return cext.winservice_stop(self.name())
# =====================================================================
# --- processes
# =====================================================================
pids = cext.pids
pid_exists = cext.pid_exists
ppid_map = cext.ppid_map # used internally by Process.children()
def is_permission_err(exc):
"""Return True if this is a permission error."""
assert isinstance(exc, OSError), exc
if exc.errno in (errno.EPERM, errno.EACCES):
return True
# On Python 2 OSError doesn't always have 'winerror'. Sometimes
# it does, in which case the original exception was WindowsError
# (which is a subclass of OSError).
return getattr(exc, "winerror", -1) in (
cext.ERROR_ACCESS_DENIED,
cext.ERROR_PRIVILEGE_NOT_HELD,
)
def convert_oserror(exc, pid=None, name=None):
"""Convert OSError into NoSuchProcess or AccessDenied."""
assert isinstance(exc, OSError), exc
if is_permission_err(exc):
return AccessDenied(pid=pid, name=name)
if exc.errno == errno.ESRCH:
return NoSuchProcess(pid=pid, name=name)
raise exc
def wrap_exceptions(fun):
"""Decorator which converts OSError into NoSuchProcess or AccessDenied."""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
try:
return fun(self, *args, **kwargs)
except OSError as err:
raise convert_oserror(err, pid=self.pid, name=self._name)
return wrapper
def retry_error_partial_copy(fun):
"""Workaround for https://github.com/giampaolo/psutil/issues/875.
See: https://stackoverflow.com/questions/4457745#4457745.
"""
@functools.wraps(fun)
def wrapper(self, *args, **kwargs):
delay = 0.0001
times = 33
for _ in range(times): # retries for roughly 1 second
try:
return fun(self, *args, **kwargs)
except WindowsError as _:
err = _
if err.winerror == ERROR_PARTIAL_COPY:
time.sleep(delay)
delay = min(delay * 2, 0.04)
continue
raise
msg = (
"{} retried {} times, converted to AccessDenied as it's still"
"returning {}".format(fun, times, err)
)
raise AccessDenied(pid=self.pid, name=self._name, msg=msg)
return wrapper
class Process:
"""Wrapper class around underlying C implementation."""
__slots__ = ["_cache", "_name", "_ppid", "pid"]
def __init__(self, pid):
self.pid = pid
self._name = None
self._ppid = None
# --- oneshot() stuff
def oneshot_enter(self):
self._proc_info.cache_activate(self)
self.exe.cache_activate(self)
def oneshot_exit(self):
self._proc_info.cache_deactivate(self)
self.exe.cache_deactivate(self)
@memoize_when_activated
def _proc_info(self):
"""Return multiple information about this process as a
raw tuple.
"""
ret = cext.proc_info(self.pid)
assert len(ret) == len(pinfo_map)
return ret
def name(self):
"""Return process name, which on Windows is always the final
part of the executable.
"""
# This is how PIDs 0 and 4 are always represented in taskmgr
# and process-hacker.
if self.pid == 0:
return "System Idle Process"
if self.pid == 4:
return "System"
return os.path.basename(self.exe())
@wrap_exceptions
@memoize_when_activated
def exe(self):
if PYPY:
try:
exe = cext.proc_exe(self.pid)
except WindowsError as err:
# 24 = ERROR_TOO_MANY_OPEN_FILES. Not sure why this happens
# (perhaps PyPy's JIT delaying garbage collection of files?).
if err.errno == 24:
debug("%r translated into AccessDenied" % err)
raise AccessDenied(self.pid, self._name)
raise
else:
exe = cext.proc_exe(self.pid)
if not PY3:
exe = py2_strencode(exe)
if exe.startswith('\\'):
return convert_dos_path(exe)
return exe # May be "Registry", "MemCompression", ...
@wrap_exceptions
@retry_error_partial_copy
def cmdline(self):
if cext.WINVER >= cext.WINDOWS_8_1:
# PEB method detects cmdline changes but requires more
# privileges: https://github.com/giampaolo/psutil/pull/1398
try:
ret = cext.proc_cmdline(self.pid, use_peb=True)
except OSError as err:
if is_permission_err(err):
ret = cext.proc_cmdline(self.pid, use_peb=False)
else:
raise
else:
ret = cext.proc_cmdline(self.pid, use_peb=True)
if PY3:
return ret
else:
return [py2_strencode(s) for s in ret]
@wrap_exceptions
@retry_error_partial_copy
def environ(self):
ustr = cext.proc_environ(self.pid)
if ustr and not PY3:
assert isinstance(ustr, unicode), type(ustr)
return parse_environ_block(py2_strencode(ustr))
def ppid(self):
try:
return ppid_map()[self.pid]
except KeyError:
raise NoSuchProcess(self.pid, self._name)
def _get_raw_meminfo(self):
try:
return cext.proc_memory_info(self.pid)
except OSError as err:
if is_permission_err(err):
# TODO: the C ext can probably be refactored in order
# to get this from cext.proc_info()
debug("attempting memory_info() fallback (slower)")
info = self._proc_info()
return (
info[pinfo_map['num_page_faults']],
info[pinfo_map['peak_wset']],
info[pinfo_map['wset']],
info[pinfo_map['peak_paged_pool']],
info[pinfo_map['paged_pool']],
info[pinfo_map['peak_non_paged_pool']],
info[pinfo_map['non_paged_pool']],
info[pinfo_map['pagefile']],
info[pinfo_map['peak_pagefile']],
info[pinfo_map['mem_private']],
)
raise
@wrap_exceptions
def memory_info(self):
# on Windows RSS == WorkingSetSize and VSM == PagefileUsage.
# Underlying C function returns fields of PROCESS_MEMORY_COUNTERS
# struct.
t = self._get_raw_meminfo()
rss = t[2] # wset
vms = t[7] # pagefile
return pmem(*(rss, vms) + t)
@wrap_exceptions
def memory_full_info(self):
basic_mem = self.memory_info()
uss = cext.proc_memory_uss(self.pid)
uss *= getpagesize()
return pfullmem(*basic_mem + (uss,))
def memory_maps(self):
try:
raw = cext.proc_memory_maps(self.pid)
except OSError as err:
# XXX - can't use wrap_exceptions decorator as we're
# returning a generator; probably needs refactoring.
raise convert_oserror(err, self.pid, self._name)
else:
for addr, perm, path, rss in raw:
path = convert_dos_path(path)
if not PY3:
path = py2_strencode(path)
addr = hex(addr)
yield (addr, perm, path, rss)
@wrap_exceptions
def kill(self):
return cext.proc_kill(self.pid)
@wrap_exceptions
def send_signal(self, sig):
if sig == signal.SIGTERM:
cext.proc_kill(self.pid)
# py >= 2.7
elif sig in (
getattr(signal, "CTRL_C_EVENT", object()),
getattr(signal, "CTRL_BREAK_EVENT", object()),
):
os.kill(self.pid, sig)
else:
msg = (
"only SIGTERM, CTRL_C_EVENT and CTRL_BREAK_EVENT signals "
"are supported on Windows"
)
raise ValueError(msg)
@wrap_exceptions
def wait(self, timeout=None):
if timeout is None:
cext_timeout = cext.INFINITE
else:
# WaitForSingleObject() expects time in milliseconds.
cext_timeout = int(timeout * 1000)
timer = getattr(time, 'monotonic', time.time)
stop_at = timer() + timeout if timeout is not None else None
try:
# Exit code is supposed to come from GetExitCodeProcess().
# May also be None if OpenProcess() failed with
# ERROR_INVALID_PARAMETER, meaning PID is already gone.
exit_code = cext.proc_wait(self.pid, cext_timeout)
except cext.TimeoutExpired:
# WaitForSingleObject() returned WAIT_TIMEOUT. Just raise.
raise TimeoutExpired(timeout, self.pid, self._name)
except cext.TimeoutAbandoned:
# WaitForSingleObject() returned WAIT_ABANDONED, see:
# https://github.com/giampaolo/psutil/issues/1224
# We'll just rely on the internal polling and return None
# when the PID disappears. Subprocess module does the same
# (return None):
# https://github.com/python/cpython/blob/
# be50a7b627d0aa37e08fa8e2d5568891f19903ce/
# Lib/subprocess.py#L1193-L1194
exit_code = None
# At this point WaitForSingleObject() returned WAIT_OBJECT_0,
# meaning the process is gone. Stupidly there are cases where
# its PID may still stick around so we do a further internal
# polling.
delay = 0.0001
while True:
if not pid_exists(self.pid):
return exit_code
if stop_at and timer() >= stop_at:
raise TimeoutExpired(timeout, pid=self.pid, name=self._name)
time.sleep(delay)
delay = min(delay * 2, 0.04) # incremental delay
@wrap_exceptions
def username(self):
if self.pid in (0, 4):
return 'NT AUTHORITY\\SYSTEM'
domain, user = cext.proc_username(self.pid)
return py2_strencode(domain) + '\\' + py2_strencode(user)
@wrap_exceptions
def create_time(self, fast_only=False):
# Note: proc_times() not put under oneshot() 'cause create_time()
# is already cached by the main Process class.
try:
_user, _system, created = cext.proc_times(self.pid)
return created
except OSError as err:
if is_permission_err(err):
if fast_only:
raise
debug("attempting create_time() fallback (slower)")
return self._proc_info()[pinfo_map['create_time']]
raise
@wrap_exceptions
def num_threads(self):
return self._proc_info()[pinfo_map['num_threads']]
@wrap_exceptions
def threads(self):
rawlist = cext.proc_threads(self.pid)
retlist = []
for thread_id, utime, stime in rawlist:
ntuple = _common.pthread(thread_id, utime, stime)
retlist.append(ntuple)
return retlist
@wrap_exceptions
def cpu_times(self):
try:
user, system, _created = cext.proc_times(self.pid)
except OSError as err:
if not is_permission_err(err):
raise
debug("attempting cpu_times() fallback (slower)")
info = self._proc_info()
user = info[pinfo_map['user_time']]
system = info[pinfo_map['kernel_time']]
# Children user/system times are not retrievable (set to 0).
return _common.pcputimes(user, system, 0.0, 0.0)
@wrap_exceptions
def suspend(self):
cext.proc_suspend_or_resume(self.pid, True)
@wrap_exceptions
def resume(self):
cext.proc_suspend_or_resume(self.pid, False)
@wrap_exceptions
@retry_error_partial_copy
def cwd(self):
if self.pid in (0, 4):
raise AccessDenied(self.pid, self._name)
# return a normalized pathname since the native C function appends
# "\\" at the and of the path
path = cext.proc_cwd(self.pid)
return py2_strencode(os.path.normpath(path))
@wrap_exceptions
def open_files(self):
if self.pid in (0, 4):
return []
ret = set()
# Filenames come in in native format like:
# "\Device\HarddiskVolume1\Windows\systemew\file.txt"
# Convert the first part in the corresponding drive letter
# (e.g. "C:\") by using Windows's QueryDosDevice()
raw_file_names = cext.proc_open_files(self.pid)
for _file in raw_file_names:
_file = convert_dos_path(_file)
if isfile_strict(_file):
if not PY3:
_file = py2_strencode(_file)
ntuple = _common.popenfile(_file, -1)
ret.add(ntuple)
return list(ret)
@wrap_exceptions
def net_connections(self, kind='inet'):
return net_connections(kind, _pid=self.pid)
@wrap_exceptions
def nice_get(self):
value = cext.proc_priority_get(self.pid)
if enum is not None:
value = Priority(value)
return value
@wrap_exceptions
def nice_set(self, value):
return cext.proc_priority_set(self.pid, value)
@wrap_exceptions
def ionice_get(self):
ret = cext.proc_io_priority_get(self.pid)
if enum is not None:
ret = IOPriority(ret)
return ret
@wrap_exceptions
def ionice_set(self, ioclass, value):
if value:
msg = "value argument not accepted on Windows"
raise TypeError(msg)
if ioclass not in (
IOPRIO_VERYLOW,
IOPRIO_LOW,
IOPRIO_NORMAL,
IOPRIO_HIGH,
):
raise ValueError("%s is not a valid priority" % ioclass)
cext.proc_io_priority_set(self.pid, ioclass)
@wrap_exceptions
def io_counters(self):
try:
ret = cext.proc_io_counters(self.pid)
except OSError as err:
if not is_permission_err(err):
raise
debug("attempting io_counters() fallback (slower)")
info = self._proc_info()
ret = (
info[pinfo_map['io_rcount']],
info[pinfo_map['io_wcount']],
info[pinfo_map['io_rbytes']],
info[pinfo_map['io_wbytes']],
info[pinfo_map['io_count_others']],
info[pinfo_map['io_bytes_others']],
)
return pio(*ret)
@wrap_exceptions
def status(self):
suspended = cext.proc_is_suspended(self.pid)
if suspended:
return _common.STATUS_STOPPED
else:
return _common.STATUS_RUNNING
@wrap_exceptions
def cpu_affinity_get(self):
def from_bitmask(x):
return [i for i in range(64) if (1 << i) & x]
bitmask = cext.proc_cpu_affinity_get(self.pid)
return from_bitmask(bitmask)
@wrap_exceptions
def cpu_affinity_set(self, value):
def to_bitmask(ls):
if not ls:
raise ValueError("invalid argument %r" % ls)
out = 0
for b in ls:
out |= 2**b
return out
# SetProcessAffinityMask() states that ERROR_INVALID_PARAMETER
# is returned for an invalid CPU but this seems not to be true,
# therefore we check CPUs validy beforehand.
allcpus = list(range(len(per_cpu_times())))
for cpu in value:
if cpu not in allcpus:
if not isinstance(cpu, (int, long)):
raise TypeError(
"invalid CPU %r; an integer is required" % cpu
)
else:
raise ValueError("invalid CPU %r" % cpu)
bitmask = to_bitmask(value)
cext.proc_cpu_affinity_set(self.pid, bitmask)
@wrap_exceptions
def num_handles(self):
try:
return cext.proc_num_handles(self.pid)
except OSError as err:
if is_permission_err(err):
debug("attempting num_handles() fallback (slower)")
return self._proc_info()[pinfo_map['num_handles']]
raise
@wrap_exceptions
def num_ctx_switches(self):
ctx_switches = self._proc_info()[pinfo_map['ctx_switches']]
# only voluntary ctx switches are supported
return _common.pctxsw(ctx_switches, 0)
PK ok\�ɞ1� � netifaces-0.11.0.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: bdist_wheel (0.36.2)
Root-Is-Purelib: false
Tag: cp39-cp39-manylinux_2_5_x86_64
Tag: cp39-cp39-manylinux1_x86_64
PK ok\���* * " netifaces-0.11.0.dist-info/LICENSEnu �[��� Copyright (c) 2007-2018 Alastair Houghton
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
PK ok\�zb�
! netifaces-0.11.0.dist-info/RECORDnu �[��� netifaces-0.11.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
netifaces-0.11.0.dist-info/LICENSE,sha256=sguJUWS3K5zAFw5sDWCxT5qqzGhiwFVu7UHqo0iINwU,1066
netifaces-0.11.0.dist-info/METADATA,sha256=6Bt05nLw45zo4zoDnKuyNyFePxJdOG25S1chH-5aRxg,8951
netifaces-0.11.0.dist-info/RECORD,,
netifaces-0.11.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
netifaces-0.11.0.dist-info/WHEEL,sha256=mpPt74xeHFyJyXQeJqOMUfs_5y9wKBGl7ZdT5s47bhE,144
netifaces-0.11.0.dist-info/top_level.txt,sha256=PqMTaIuWtSjkdQHX6lH1Lmpv2aqBUYAGqATB8z3A6TQ,10
netifaces-0.11.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
netifaces.cpython-39-x86_64-linux-gnu.so,sha256=9HiqVAHU4w1_WXrDxHO4U-wqaoOZr3Vzjr9rKPgAqgU,67181
PK ok\t��/�" �" # netifaces-0.11.0.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: netifaces
Version: 0.11.0
Summary: Portable network interface information.
Home-page: https://github.com/al45tair/netifaces
Author: Alastair Houghton
Author-email: alastair@alastairs-place.net
License: MIT License
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: System :: Networking
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
License-File: LICENSE
netifaces 0.10.8
================
+-------------+------------------+
| Linux/macOS | |BuildStatus| |
+-------------+------------------+
| Windows | |WinBuildStatus| |
+-------------+------------------+
.. |BuildStatus| image:: https://travis-ci.org/al45tair/netifaces.svg?branch=master
:target: https://travis-ci.org/al45tair/netifaces
:alt: Build Status (Linux/Mac)
.. |WinBuildStatus| image:: https://ci.appveyor.com/api/projects/status/3ctn1bl0aigpfjoo/branch/master?svg=true
:target: https://ci.appveyor.com/project/al45tair/netifaces/branch/master
:alt: Build Status (Windows)
.. warning::
netifaces needs a new maintainer. al45tair is no longer able to maintain it
or make new releases due to work commitments.
1. What is this?
----------------
It's been annoying me for some time that there's no easy way to get the
address(es) of the machine's network interfaces from Python. There is
a good reason for this difficulty, which is that it is virtually impossible
to do so in a portable manner. However, it seems to me that there should
be a package you can easy_install that will take care of working out the
details of doing so on the machine you're using, then you can get on with
writing Python code without concerning yourself with the nitty gritty of
system-dependent low-level networking APIs.
This package attempts to solve that problem.
2. How do I use it?
-------------------
First you need to install it, which you can do by typing::
tar xvzf netifaces-0.10.8.tar.gz
cd netifaces-0.10.8
python setup.py install
**Note that you will need the relevant developer tools for your platform**,
as netifaces is written in C and installing this way will compile the extension.
Once that's done, you'll need to start Python and do something like the
following::
>>> import netifaces
Then if you enter
>>> netifaces.interfaces()
['lo0', 'gif0', 'stf0', 'en0', 'en1', 'fw0']
you'll see the list of interface identifiers for your machine.
You can ask for the addresses of a particular interface by doing
>>> netifaces.ifaddresses('lo0')
{18: [{'addr': ''}], 2: [{'peer': '127.0.0.1', 'netmask': '255.0.0.0', 'addr': '127.0.0.1'}], 30: [{'peer': '::1', 'netmask': 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff', 'addr': '::1'}, {'peer': '', 'netmask': 'ffff:ffff:ffff:ffff::', 'addr': 'fe80::1%lo0'}]}
Hmmmm. That result looks a bit cryptic; let's break it apart and explain
what each piece means. It returned a dictionary, so let's look there first::
{ 18: [...], 2: [...], 30: [...] }
Each of the numbers refers to a particular address family. In this case, we
have three address families listed; on my system, 18 is ``AF_LINK`` (which means
the link layer interface, e.g. Ethernet), 2 is ``AF_INET`` (normal Internet
addresses), and 30 is ``AF_INET6`` (IPv6).
But wait! Don't use these numbers in your code. The numeric values here are
system dependent; fortunately, I thought of that when writing netifaces, so
the module declares a range of values that you might need. e.g.
>>> netifaces.AF_LINK
18
Again, on your system, the number may be different.
So, what we've established is that the dictionary that's returned has one
entry for each address family for which this interface has an address. Let's
take a look at the ``AF_INET`` addresses now:
>>> addrs = netifaces.ifaddresses('lo0')
>>> addrs[netifaces.AF_INET]
[{'peer': '127.0.0.1', 'netmask': '255.0.0.0', 'addr': '127.0.0.1'}]
You might be wondering why this value is a list. The reason is that it's
possible for an interface to have more than one address, even within the
same family. I'll say that again: *you can have more than one address of
the same type associated with each interface*.
*Asking for "the" address of a particular interface doesn't make sense.*
Right, so, we can see that this particular interface only has one address,
and, because it's a loopback interface, it's point-to-point and therefore
has a *peer* address rather than a broadcast address.
Let's look at a more interesting interface.
>>> addrs = netifaces.ifaddresses('en0')
>>> addrs[netifaces.AF_INET]
[{'broadcast': '10.15.255.255', 'netmask': '255.240.0.0', 'addr': '10.0.1.4'}, {'broadcast': '192.168.0.255', 'addr': '192.168.0.47'}]
This interface has two addresses (see, I told you...) Both of them are
regular IPv4 addresses, although in one case the netmask has been changed
from its default. The netmask *may not* appear on your system if it's set
to the default for the address range.
Because this interface isn't point-to-point, it also has broadcast addresses.
Now, say we want, instead of the IP addresses, to get the MAC address; that
is, the hardware address of the Ethernet adapter running this interface. We
can do
>>> addrs[netifaces.AF_LINK]
[{'addr': '00:12:34:56:78:9a'}]
Note that this may not be available on platforms without getifaddrs(), unless
they happen to implement ``SIOCGIFHWADDR``. Note also that you just get the
address; it's unlikely that you'll see anything else with an ``AF_LINK`` address.
Oh, and don't assume that all ``AF_LINK`` addresses are Ethernet; you might, for
instance, be on a Mac, in which case:
>>> addrs = netifaces.ifaddresses('fw0')
>>> addrs[netifaces.AF_LINK]
[{'addr': '00:12:34:56:78:9a:bc:de'}]
No, that isn't an exceptionally long Ethernet MAC address---it's a FireWire
address.
As of version 0.10.0, you can also obtain a list of gateways on your
machine:
>>> netifaces.gateways()
{2: [('10.0.1.1', 'en0', True), ('10.2.1.1', 'en1', False)], 30: [('fe80::1', 'en0', True)], 'default': { 2: ('10.0.1.1', 'en0'), 30: ('fe80::1', 'en0') }}
This dictionary is keyed on address family---in this case, ``AF_INET``---and
each entry is a list of gateways as ``(address, interface, is_default)`` tuples.
Notice that here we have two separate gateways for IPv4 (``AF_INET``); some
operating systems support configurations like this and can either route packets
based on their source, or based on administratively configured routing tables.
For convenience, we also allow you to index the dictionary with the special
value ``'default'``, which returns a dictionary mapping address families to the
default gateway in each case. Thus you can get the default IPv4 gateway with
>>> gws = netifaces.gateways()
>>> gws['default'][netifaces.AF_INET]
('10.0.1.1', 'en0')
Do note that there may be no default gateway for any given address family;
this is currently very common for IPv6 and much less common for IPv4 but it
can happen even for ``AF_INET``.
BTW, if you're trying to configure your machine to have multiple gateways for
the same address family, it's a very good idea to check the documentation for
your operating system *very* carefully, as some systems become extremely
confused or route packets in a non-obvious manner.
I'm very interested in hearing from anyone (on any platform) for whom the
``gateways()`` method doesn't produce the expected results. It's quite
complicated extracting this information from the operating system (whichever
operating system we're talking about), and so I expect there's at least one
system out there where this just won't work.
3. This is great! What platforms does it work on?
--------------------------------------------------
It gets regular testing on OS X, Linux and Windows. It has also been used
successfully on Solaris, and it's expected to work properly on other UNIX-like
systems as well. If you are running something that is not supported, and
wish to contribute a patch, please use Github to send a pull request.
4. What license is this under?
------------------------------
It's an MIT-style license. See `LICENSE <./LICENSE>`_.
5. Why the jump to 0.10.0?
--------------------------
Because someone released a fork of netifaces with the version 0.9.0.
Hopefully skipping the version number should remove any confusion. In
addition starting with 0.10.0 Python 3 is now supported and other
features/bugfixes have been included as well. See the CHANGELOG for a
more complete list of changes.
PK ok\ $ netifaces-0.11.0.dist-info/REQUESTEDnu �[��� PK ok\�.�
( netifaces-0.11.0.dist-info/top_level.txtnu �[��� netifaces
PK ok\��2 # netifaces-0.11.0.dist-info/zip-safenu �[���
PK ok\� �� $ netifaces-0.11.0.dist-info/INSTALLERnu �[��� pip
PK ok\� 94� � psutil-6.1.0.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: bdist_wheel (0.37.1)
Root-Is-Purelib: false
Tag: cp36-abi3-manylinux_2_12_x86_64
Tag: cp36-abi3-manylinux2010_x86_64
Tag: cp36-abi3-manylinux_2_17_x86_64
Tag: cp36-abi3-manylinux2014_x86_64
PK ok\٘q� psutil-6.1.0.dist-info/LICENSEnu �[��� BSD 3-Clause License
Copyright (c) 2009, Jay Loden, Dave Daeschler, Giampaolo Rodola
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the psutil authors nor the names of its contributors
may be used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
PK ok\W��� � psutil-6.1.0.dist-info/RECORDnu �[��� psutil-6.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
psutil-6.1.0.dist-info/LICENSE,sha256=uJwGOzeG4o4MCjjxkx22H-015p3SopZvvs_-4PRsjRA,1548
psutil-6.1.0.dist-info/METADATA,sha256=9ro1bKVP9BN1l8ocnFXMpsbM_WcqDJdsw3BxHQomUug,22295
psutil-6.1.0.dist-info/RECORD,,
psutil-6.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
psutil-6.1.0.dist-info/WHEEL,sha256=rgpVBmjjvbINeGKCkWEGd3f40VHMTsDkQj1Lgil82zE,221
psutil-6.1.0.dist-info/top_level.txt,sha256=gCNhn57wzksDjSAISmgMJ0aiXzQulk0GJhb2-BAyYgw,7
psutil/__init__.py,sha256=zyBpkEYkWwlvVnnElydLzmm8umVweXlT4HsBzcTBA9c,89154
psutil/__pycache__/__init__.cpython-39.pyc,,
psutil/__pycache__/_common.cpython-39.pyc,,
psutil/__pycache__/_compat.cpython-39.pyc,,
psutil/__pycache__/_psaix.cpython-39.pyc,,
psutil/__pycache__/_psbsd.cpython-39.pyc,,
psutil/__pycache__/_pslinux.cpython-39.pyc,,
psutil/__pycache__/_psosx.cpython-39.pyc,,
psutil/__pycache__/_psposix.cpython-39.pyc,,
psutil/__pycache__/_pssunos.cpython-39.pyc,,
psutil/__pycache__/_pswindows.cpython-39.pyc,,
psutil/_common.py,sha256=KetpFrG7dgXOVqfG9O1XYPlLrGYPnCHUix5i-Kh213s,29739
psutil/_compat.py,sha256=zrxveFAR5_XqDUStcyXmTBk1rWs0jxLIiOjQnj7SwUk,15253
psutil/_psaix.py,sha256=auBiK5gCD4fOjqrjTwckg7wfOHw6vv3f0hIkGvNcBC4,18663
psutil/_psbsd.py,sha256=Yn4F-8jXZdbJ01R5xWfUESXUuhWUKiPa3JL1MiLA7-E,32205
psutil/_pslinux.py,sha256=PNh1dKVJ9rTXWLHAmeOoc00oI-SQ6QeZx0Lnxeh0JnA,88594
psutil/_psosx.py,sha256=js281YWrza5x0_EeYhjLLypDqzmiehZASGpUkxNhKqw,16136
psutil/_psposix.py,sha256=X9rd7WHKQ6mUAn2ihb03MCnzrBtQsrPRkCouExmuagQ,8235
psutil/_pssunos.py,sha256=Jxefif4mydfeOGKsyN7H7L5QVE4QhlhI8YXOX1HVAKI,25479
psutil/_psutil_linux.abi3.so,sha256=UVS0vmhO15bhmHJ-yUC4brnVLWENGD1dChvfRIv1fzI,115320
psutil/_psutil_posix.abi3.so,sha256=bLoKDfoWp8Pmo_QGNDssv7kIOLk2hnF6HZHYlRWatOI,71640
psutil/_pswindows.py,sha256=EPkkDJi0FZUzpkQWfAjk-oK2kvBI8RAhcPEFh3unLFA,38124
psutil/tests/__init__.py,sha256=2A3mFjGilu2GXXJBJaz2KLMime37ulCtgYWzjvrQLag,66696
psutil/tests/__main__.py,sha256=GYT-hlMnWDtybkJ76DqQcjXPr0jnLeZDTe0lVVeDb7o,309
psutil/tests/__pycache__/__init__.cpython-39.pyc,,
psutil/tests/__pycache__/__main__.cpython-39.pyc,,
psutil/tests/__pycache__/test_aix.cpython-39.pyc,,
psutil/tests/__pycache__/test_bsd.cpython-39.pyc,,
psutil/tests/__pycache__/test_connections.cpython-39.pyc,,
psutil/tests/__pycache__/test_contracts.cpython-39.pyc,,
psutil/tests/__pycache__/test_linux.cpython-39.pyc,,
psutil/tests/__pycache__/test_memleaks.cpython-39.pyc,,
psutil/tests/__pycache__/test_misc.cpython-39.pyc,,
psutil/tests/__pycache__/test_osx.cpython-39.pyc,,
psutil/tests/__pycache__/test_posix.cpython-39.pyc,,
psutil/tests/__pycache__/test_process.cpython-39.pyc,,
psutil/tests/__pycache__/test_process_all.cpython-39.pyc,,
psutil/tests/__pycache__/test_sunos.cpython-39.pyc,,
psutil/tests/__pycache__/test_system.cpython-39.pyc,,
psutil/tests/__pycache__/test_testutils.cpython-39.pyc,,
psutil/tests/__pycache__/test_unicode.cpython-39.pyc,,
psutil/tests/__pycache__/test_windows.cpython-39.pyc,,
psutil/tests/test_aix.py,sha256=x-klXNziKeLIj4eF4kPh-mObIlnuoAJWCA9y96JAXoQ,4035
psutil/tests/test_bsd.py,sha256=94Y34BUn0sBw-87NF0IIeU_NanOEwWDImRhkptQ4VYM,20222
psutil/tests/test_connections.py,sha256=gRqGAkbIjidumXVHVzlfZ0yUINAj9sbDeIbAwiGS6K0,21252
psutil/tests/test_contracts.py,sha256=FSFZpNeJumY9Lgerih3079pg4F80TwR7ftNS5nhFhqg,12577
psutil/tests/test_linux.py,sha256=Hng2l3UMYliIOdc3pF0kiWH6FJ0yGdB_WC-jPAPkbDE,91227
psutil/tests/test_memleaks.py,sha256=q6mV6Mtl_GH6HjQs33hrwaX78oSHZ9oojPyDTYLSBRQ,15411
psutil/tests/test_misc.py,sha256=goOFBTKBYJin5INIRttCEbKWOd64l_XenKK689w8zEY,35975
psutil/tests/test_osx.py,sha256=HeEXXZP3wsWdGZKu870nRtw5ndprn3zuqtvr-o9RpRg,6133
psutil/tests/test_posix.py,sha256=O6zAJEES8CrdSg8s3FWiRTv0xmf3B5_D88XAkxiJXYQ,17408
psutil/tests/test_process.py,sha256=tEirr5yZZbfhMtBZ2Ny5w3Xc1zU0L4DXo4eYTuG08go,63086
psutil/tests/test_process_all.py,sha256=SSbBcdjN51FxV9D_ZDsfULWY1xuV0wAlXVo2-8cw_5M,18616
psutil/tests/test_sunos.py,sha256=tf9OOQyidTFA4WAp2eZoewvwXy95MmTD06JURgnH7ig,1192
psutil/tests/test_system.py,sha256=SogWUMyMK_manymW0Jz_atWDLKNbGVl_krMlwP6eu_k,36431
psutil/tests/test_testutils.py,sha256=MQprQYqROcMc_-5e0GT37uukCgmYGhLQfYTx82nqiYg,18585
psutil/tests/test_unicode.py,sha256=OyGLTxCU8WsSGiNYkvZkWtAzl6lZVBt-yixxSyuqXAk,12603
psutil/tests/test_windows.py,sha256=O3Tt5nCaamkdzEcTSjoopp2NoN6tkWQ6Y66GZwSKEqg,34008
PK ok\t�c�W W psutil-6.1.0.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: psutil
Version: 6.1.0
Summary: Cross-platform lib for process and system monitoring in Python.
Home-page: https://github.com/giampaolo/psutil
Author: Giampaolo Rodola
Author-email: g.rodola@gmail.com
License: BSD-3-Clause
Keywords: ps,top,kill,free,lsof,netstat,nice,tty,ionice,uptime,taskmgr,process,df,iotop,iostat,ifconfig,taskset,who,pidof,pmap,smem,pstree,monitoring,ulimit,prlimit,smem,performance,metrics,agent,observability
Platform: Platform Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: Microsoft :: Windows :: Windows 8
Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2003
Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2008
Classifier: Operating System :: Microsoft :: Windows :: Windows Vista
Classifier: Operating System :: Microsoft
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: AIX
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: BSD :: NetBSD
Classifier: Operating System :: POSIX :: BSD :: OpenBSD
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Operating System :: POSIX
Classifier: Programming Language :: C
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Benchmark
Classifier: Topic :: System :: Hardware :: Hardware Drivers
Classifier: Topic :: System :: Hardware
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Networking :: Monitoring :: Hardware Watchdog
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Operating System
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
Description-Content-Type: text/x-rst
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: black ; extra == 'dev'
Requires-Dist: check-manifest ; extra == 'dev'
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: packaging ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: pyperf ; extra == 'dev'
Requires-Dist: pypinfo ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: requests ; extra == 'dev'
Requires-Dist: rstcheck ; extra == 'dev'
Requires-Dist: ruff ; extra == 'dev'
Requires-Dist: sphinx ; extra == 'dev'
Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
Requires-Dist: toml-sort ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'
Requires-Dist: virtualenv ; extra == 'dev'
Requires-Dist: wheel ; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-xdist ; extra == 'test'
Requires-Dist: setuptools ; extra == 'test'
| |downloads| |stars| |forks| |contributors| |coverage|
| |version| |py-versions| |packages| |license|
| |github-actions-wheels| |github-actions-bsd| |appveyor| |doc| |twitter| |tidelift|
.. |downloads| image:: https://img.shields.io/pypi/dm/psutil.svg
:target: https://pepy.tech/project/psutil
:alt: Downloads
.. |stars| image:: https://img.shields.io/github/stars/giampaolo/psutil.svg
:target: https://github.com/giampaolo/psutil/stargazers
:alt: Github stars
.. |forks| image:: https://img.shields.io/github/forks/giampaolo/psutil.svg
:target: https://github.com/giampaolo/psutil/network/members
:alt: Github forks
.. |contributors| image:: https://img.shields.io/github/contributors/giampaolo/psutil.svg
:target: https://github.com/giampaolo/psutil/graphs/contributors
:alt: Contributors
.. |github-actions-wheels| image:: https://img.shields.io/github/actions/workflow/status/giampaolo/psutil/.github/workflows/build.yml.svg?label=Linux%2C%20macOS%2C%20Windows
:target: https://github.com/giampaolo/psutil/actions?query=workflow%3Abuild
:alt: Linux, macOS, Windows
.. |github-actions-bsd| image:: https://img.shields.io/github/actions/workflow/status/giampaolo/psutil/.github/workflows/bsd.yml.svg?label=FreeBSD,%20NetBSD,%20OpenBSD
:target: https://github.com/giampaolo/psutil/actions?query=workflow%3Absd-tests
:alt: FreeBSD, NetBSD, OpenBSD
.. |appveyor| image:: https://img.shields.io/appveyor/build/giampaolo/psutil/master.svg?maxAge=3600&label=Windows%20(py2)
:target: https://ci.appveyor.com/project/giampaolo/psutil
:alt: Windows (Appveyor)
.. |coverage| image:: https://coveralls.io/repos/github/giampaolo/psutil/badge.svg?branch=master
:target: https://coveralls.io/github/giampaolo/psutil?branch=master
:alt: Test coverage (coverall.io)
.. |doc| image:: https://readthedocs.org/projects/psutil/badge/?version=latest
:target: https://psutil.readthedocs.io/en/latest/
:alt: Documentation Status
.. |version| image:: https://img.shields.io/pypi/v/psutil.svg?label=pypi
:target: https://pypi.org/project/psutil
:alt: Latest version
.. |py-versions| image:: https://img.shields.io/pypi/pyversions/psutil.svg
:alt: Supported Python versions
.. |packages| image:: https://repology.org/badge/tiny-repos/python:psutil.svg
:target: https://repology.org/metapackage/python:psutil/versions
:alt: Binary packages
.. |license| image:: https://img.shields.io/pypi/l/psutil.svg
:target: https://github.com/giampaolo/psutil/blob/master/LICENSE
:alt: License
.. |twitter| image:: https://img.shields.io/twitter/follow/grodola.svg?label=follow&style=flat&logo=twitter&logoColor=4FADFF
:target: https://twitter.com/grodola
:alt: Twitter Follow
.. |tidelift| image:: https://tidelift.com/badges/github/giampaolo/psutil?style=flat
:target: https://tidelift.com/subscription/pkg/pypi-psutil?utm_source=pypi-psutil&utm_medium=referral&utm_campaign=readme
:alt: Tidelift
-----
Quick links
===========
- `Home page <https://github.com/giampaolo/psutil>`_
- `Install <https://github.com/giampaolo/psutil/blob/master/INSTALL.rst>`_
- `Documentation <http://psutil.readthedocs.io>`_
- `Download <https://pypi.org/project/psutil/#files>`_
- `Forum <http://groups.google.com/group/psutil/topics>`_
- `StackOverflow <https://stackoverflow.com/questions/tagged/psutil>`_
- `Blog <https://gmpy.dev/tags/psutil>`_
- `What's new <https://github.com/giampaolo/psutil/blob/master/HISTORY.rst>`_
Summary
=======
psutil (process and system utilities) is a cross-platform library for
retrieving information on **running processes** and **system utilization**
(CPU, memory, disks, network, sensors) in Python.
It is useful mainly for **system monitoring**, **profiling and limiting process
resources** and **management of running processes**.
It implements many functionalities offered by classic UNIX command line tools
such as *ps, top, iotop, lsof, netstat, ifconfig, free* and others.
psutil currently supports the following platforms:
- **Linux**
- **Windows**
- **macOS**
- **FreeBSD, OpenBSD**, **NetBSD**
- **Sun Solaris**
- **AIX**
Supported Python versions are **2.7**, **3.6+** and
`PyPy <http://pypy.org/>`__.
Funding
=======
While psutil is free software and will always be, the project would benefit
immensely from some funding.
Keeping up with bug reports and maintenance has become hardly sustainable for
me alone in terms of time.
If you're a company that's making significant use of psutil you can consider
becoming a sponsor via `GitHub Sponsors <https://github.com/sponsors/giampaolo>`__,
`Open Collective <https://opencollective.com/psutil>`__ or
`PayPal <https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=A9ZS7PKKRM3S8>`__
and have your logo displayed in here and psutil `doc <https://psutil.readthedocs.io>`__.
Sponsors
========
.. image:: https://github.com/giampaolo/psutil/raw/master/docs/_static/tidelift-logo.png
:width: 200
:alt: Alternative text
`Add your logo <https://github.com/sponsors/giampaolo>`__.
Example usages
==============
This represents pretty much the whole psutil API.
CPU
---
.. code-block:: python
>>> import psutil
>>>
>>> psutil.cpu_times()
scputimes(user=3961.46, nice=169.729, system=2150.659, idle=16900.540, iowait=629.59, irq=0.0, softirq=19.42, steal=0.0, guest=0, guest_nice=0.0)
>>>
>>> for x in range(3):
... psutil.cpu_percent(interval=1)
...
4.0
5.9
3.8
>>>
>>> for x in range(3):
... psutil.cpu_percent(interval=1, percpu=True)
...
[4.0, 6.9, 3.7, 9.2]
[7.0, 8.5, 2.4, 2.1]
[1.2, 9.0, 9.9, 7.2]
>>>
>>> for x in range(3):
... psutil.cpu_times_percent(interval=1, percpu=False)
...
scputimes(user=1.5, nice=0.0, system=0.5, idle=96.5, iowait=1.5, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
scputimes(user=1.0, nice=0.0, system=0.0, idle=99.0, iowait=0.0, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
scputimes(user=2.0, nice=0.0, system=0.0, idle=98.0, iowait=0.0, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
>>>
>>> psutil.cpu_count()
4
>>> psutil.cpu_count(logical=False)
2
>>>
>>> psutil.cpu_stats()
scpustats(ctx_switches=20455687, interrupts=6598984, soft_interrupts=2134212, syscalls=0)
>>>
>>> psutil.cpu_freq()
scpufreq(current=931.42925, min=800.0, max=3500.0)
>>>
>>> psutil.getloadavg() # also on Windows (emulated)
(3.14, 3.89, 4.67)
Memory
------
.. code-block:: python
>>> psutil.virtual_memory()
svmem(total=10367352832, available=6472179712, percent=37.6, used=8186245120, free=2181107712, active=4748992512, inactive=2758115328, buffers=790724608, cached=3500347392, shared=787554304)
>>> psutil.swap_memory()
sswap(total=2097147904, used=296128512, free=1801019392, percent=14.1, sin=304193536, sout=677842944)
>>>
Disks
-----
.. code-block:: python
>>> psutil.disk_partitions()
[sdiskpart(device='/dev/sda1', mountpoint='/', fstype='ext4', opts='rw,nosuid'),
sdiskpart(device='/dev/sda2', mountpoint='/home', fstype='ext', opts='rw')]
>>>
>>> psutil.disk_usage('/')
sdiskusage(total=21378641920, used=4809781248, free=15482871808, percent=22.5)
>>>
>>> psutil.disk_io_counters(perdisk=False)
sdiskio(read_count=719566, write_count=1082197, read_bytes=18626220032, write_bytes=24081764352, read_time=5023392, write_time=63199568, read_merged_count=619166, write_merged_count=812396, busy_time=4523412)
>>>
Network
-------
.. code-block:: python
>>> psutil.net_io_counters(pernic=True)
{'eth0': netio(bytes_sent=485291293, bytes_recv=6004858642, packets_sent=3251564, packets_recv=4787798, errin=0, errout=0, dropin=0, dropout=0),
'lo': netio(bytes_sent=2838627, bytes_recv=2838627, packets_sent=30567, packets_recv=30567, errin=0, errout=0, dropin=0, dropout=0)}
>>>
>>> psutil.net_connections(kind='tcp')
[sconn(fd=115, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=48776), raddr=addr(ip='93.186.135.91', port=80), status='ESTABLISHED', pid=1254),
sconn(fd=117, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=43761), raddr=addr(ip='72.14.234.100', port=80), status='CLOSING', pid=2987),
...]
>>>
>>> psutil.net_if_addrs()
{'lo': [snicaddr(family=<AddressFamily.AF_INET: 2>, address='127.0.0.1', netmask='255.0.0.0', broadcast='127.0.0.1', ptp=None),
snicaddr(family=<AddressFamily.AF_INET6: 10>, address='::1', netmask='ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff', broadcast=None, ptp=None),
snicaddr(family=<AddressFamily.AF_LINK: 17>, address='00:00:00:00:00:00', netmask=None, broadcast='00:00:00:00:00:00', ptp=None)],
'wlan0': [snicaddr(family=<AddressFamily.AF_INET: 2>, address='192.168.1.3', netmask='255.255.255.0', broadcast='192.168.1.255', ptp=None),
snicaddr(family=<AddressFamily.AF_INET6: 10>, address='fe80::c685:8ff:fe45:641%wlan0', netmask='ffff:ffff:ffff:ffff::', broadcast=None, ptp=None),
snicaddr(family=<AddressFamily.AF_LINK: 17>, address='c4:85:08:45:06:41', netmask=None, broadcast='ff:ff:ff:ff:ff:ff', ptp=None)]}
>>>
>>> psutil.net_if_stats()
{'lo': snicstats(isup=True, duplex=<NicDuplex.NIC_DUPLEX_UNKNOWN: 0>, speed=0, mtu=65536, flags='up,loopback,running'),
'wlan0': snicstats(isup=True, duplex=<NicDuplex.NIC_DUPLEX_FULL: 2>, speed=100, mtu=1500, flags='up,broadcast,running,multicast')}
>>>
Sensors
-------
.. code-block:: python
>>> import psutil
>>> psutil.sensors_temperatures()
{'acpitz': [shwtemp(label='', current=47.0, high=103.0, critical=103.0)],
'asus': [shwtemp(label='', current=47.0, high=None, critical=None)],
'coretemp': [shwtemp(label='Physical id 0', current=52.0, high=100.0, critical=100.0),
shwtemp(label='Core 0', current=45.0, high=100.0, critical=100.0)]}
>>>
>>> psutil.sensors_fans()
{'asus': [sfan(label='cpu_fan', current=3200)]}
>>>
>>> psutil.sensors_battery()
sbattery(percent=93, secsleft=16628, power_plugged=False)
>>>
Other system info
-----------------
.. code-block:: python
>>> import psutil
>>> psutil.users()
[suser(name='giampaolo', terminal='pts/2', host='localhost', started=1340737536.0, pid=1352),
suser(name='giampaolo', terminal='pts/3', host='localhost', started=1340737792.0, pid=1788)]
>>>
>>> psutil.boot_time()
1365519115.0
>>>
Process management
------------------
.. code-block:: python
>>> import psutil
>>> psutil.pids()
[1, 2, 3, 4, 5, 6, 7, 46, 48, 50, 51, 178, 182, 222, 223, 224, 268, 1215,
1216, 1220, 1221, 1243, 1244, 1301, 1601, 2237, 2355, 2637, 2774, 3932,
4176, 4177, 4185, 4187, 4189, 4225, 4243, 4245, 4263, 4282, 4306, 4311,
4312, 4313, 4314, 4337, 4339, 4357, 4358, 4363, 4383, 4395, 4408, 4433,
4443, 4445, 4446, 5167, 5234, 5235, 5252, 5318, 5424, 5644, 6987, 7054,
7055, 7071]
>>>
>>> p = psutil.Process(7055)
>>> p
psutil.Process(pid=7055, name='python3', status='running', started='09:04:44')
>>> p.pid
7055
>>> p.name()
'python3'
>>> p.exe()
'/usr/bin/python3'
>>> p.cwd()
'/home/giampaolo'
>>> p.cmdline()
['/usr/bin/python3', 'main.py']
>>>
>>> p.ppid()
7054
>>> p.parent()
psutil.Process(pid=4699, name='bash', status='sleeping', started='09:06:44')
>>> p.parents()
[psutil.Process(pid=4699, name='bash', started='09:06:44'),
psutil.Process(pid=4689, name='gnome-terminal-server', status='sleeping', started='0:06:44'),
psutil.Process(pid=1, name='systemd', status='sleeping', started='05:56:55')]
>>> p.children(recursive=True)
[psutil.Process(pid=29835, name='python3', status='sleeping', started='11:45:38'),
psutil.Process(pid=29836, name='python3', status='waking', started='11:43:39')]
>>>
>>> p.status()
'running'
>>> p.create_time()
1267551141.5019531
>>> p.terminal()
'/dev/pts/0'
>>>
>>> p.username()
'giampaolo'
>>> p.uids()
puids(real=1000, effective=1000, saved=1000)
>>> p.gids()
pgids(real=1000, effective=1000, saved=1000)
>>>
>>> p.cpu_times()
pcputimes(user=1.02, system=0.31, children_user=0.32, children_system=0.1, iowait=0.0)
>>> p.cpu_percent(interval=1.0)
12.1
>>> p.cpu_affinity()
[0, 1, 2, 3]
>>> p.cpu_affinity([0, 1]) # set
>>> p.cpu_num()
1
>>>
>>> p.memory_info()
pmem(rss=10915840, vms=67608576, shared=3313664, text=2310144, lib=0, data=7262208, dirty=0)
>>> p.memory_full_info() # "real" USS memory usage (Linux, macOS, Win only)
pfullmem(rss=10199040, vms=52133888, shared=3887104, text=2867200, lib=0, data=5967872, dirty=0, uss=6545408, pss=6872064, swap=0)
>>> p.memory_percent()
0.7823
>>> p.memory_maps()
[pmmap_grouped(path='/lib/x8664-linux-gnu/libutil-2.15.so', rss=32768, size=2125824, pss=32768, shared_clean=0, shared_dirty=0, private_clean=20480, private_dirty=12288, referenced=32768, anonymous=12288, swap=0),
pmmap_grouped(path='/lib/x8664-linux-gnu/libc-2.15.so', rss=3821568, size=3842048, pss=3821568, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=3821568, referenced=3575808, anonymous=3821568, swap=0),
pmmap_grouped(path='[heap]', rss=32768, size=139264, pss=32768, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=32768, referenced=32768, anonymous=32768, swap=0),
pmmap_grouped(path='[stack]', rss=2465792, size=2494464, pss=2465792, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=2465792, referenced=2277376, anonymous=2465792, swap=0),
...]
>>>
>>> p.io_counters()
pio(read_count=478001, write_count=59371, read_bytes=700416, write_bytes=69632, read_chars=456232, write_chars=517543)
>>>
>>> p.open_files()
[popenfile(path='/home/giampaolo/monit.py', fd=3, position=0, mode='r', flags=32768),
popenfile(path='/var/log/monit.log', fd=4, position=235542, mode='a', flags=33793)]
>>>
>>> p.net_connections(kind='tcp')
[pconn(fd=115, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=48776), raddr=addr(ip='93.186.135.91', port=80), status='ESTABLISHED'),
pconn(fd=117, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=43761), raddr=addr(ip='72.14.234.100', port=80), status='CLOSING')]
>>>
>>> p.threads()
[pthread(id=5234, user_time=22.5, system_time=9.2891),
pthread(id=5237, user_time=0.0707, system_time=1.1)]
>>>
>>> p.num_threads()
4
>>> p.num_fds()
8
>>> p.num_ctx_switches()
pctxsw(voluntary=78, involuntary=19)
>>>
>>> p.nice()
0
>>> p.nice(10) # set
>>>
>>> p.ionice(psutil.IOPRIO_CLASS_IDLE) # IO priority (Win and Linux only)
>>> p.ionice()
pionice(ioclass=<IOPriority.IOPRIO_CLASS_IDLE: 3>, value=0)
>>>
>>> p.rlimit(psutil.RLIMIT_NOFILE, (5, 5)) # set resource limits (Linux only)
>>> p.rlimit(psutil.RLIMIT_NOFILE)
(5, 5)
>>>
>>> p.environ()
{'LC_PAPER': 'it_IT.UTF-8', 'SHELL': '/bin/bash', 'GREP_OPTIONS': '--color=auto',
'XDG_CONFIG_DIRS': '/etc/xdg/xdg-ubuntu:/usr/share/upstart/xdg:/etc/xdg',
...}
>>>
>>> p.as_dict()
{'status': 'running', 'num_ctx_switches': pctxsw(voluntary=63, involuntary=1), 'pid': 5457, ...}
>>> p.is_running()
True
>>> p.suspend()
>>> p.resume()
>>>
>>> p.terminate()
>>> p.kill()
>>> p.wait(timeout=3)
<Exitcode.EX_OK: 0>
>>>
>>> psutil.test()
USER PID %CPU %MEM VSZ RSS TTY START TIME COMMAND
root 1 0.0 0.0 24584 2240 Jun17 00:00 init
root 2 0.0 0.0 0 0 Jun17 00:00 kthreadd
...
giampaolo 31475 0.0 0.0 20760 3024 /dev/pts/0 Jun19 00:00 python2.4
giampaolo 31721 0.0 2.2 773060 181896 00:04 10:30 chrome
root 31763 0.0 0.0 0 0 00:05 00:00 kworker/0:1
>>>
Further process APIs
--------------------
.. code-block:: python
>>> import psutil
>>> for proc in psutil.process_iter(['pid', 'name']):
... print(proc.info)
...
{'pid': 1, 'name': 'systemd'}
{'pid': 2, 'name': 'kthreadd'}
{'pid': 3, 'name': 'ksoftirqd/0'}
...
>>>
>>> psutil.pid_exists(3)
True
>>>
>>> def on_terminate(proc):
... print("process {} terminated".format(proc))
...
>>> # waits for multiple processes to terminate
>>> gone, alive = psutil.wait_procs(procs_list, timeout=3, callback=on_terminate)
>>>
Windows services
----------------
.. code-block:: python
>>> list(psutil.win_service_iter())
[<WindowsService(name='AeLookupSvc', display_name='Application Experience') at 38850096>,
<WindowsService(name='ALG', display_name='Application Layer Gateway Service') at 38850128>,
<WindowsService(name='APNMCP', display_name='Ask Update Service') at 38850160>,
<WindowsService(name='AppIDSvc', display_name='Application Identity') at 38850192>,
...]
>>> s = psutil.win_service_get('alg')
>>> s.as_dict()
{'binpath': 'C:\\Windows\\System32\\alg.exe',
'description': 'Provides support for 3rd party protocol plug-ins for Internet Connection Sharing',
'display_name': 'Application Layer Gateway Service',
'name': 'alg',
'pid': None,
'start_type': 'manual',
'status': 'stopped',
'username': 'NT AUTHORITY\\LocalService'}
Projects using psutil
=====================
Here's some I find particularly interesting:
- https://github.com/google/grr
- https://github.com/facebook/osquery/
- https://github.com/nicolargo/glances
- https://github.com/aristocratos/bpytop
- https://github.com/Jahaja/psdash
- https://github.com/ajenti/ajenti
- https://github.com/home-assistant/home-assistant/
Portings
========
- Go: https://github.com/shirou/gopsutil
- C: https://github.com/hamon-in/cpslib
- Rust: https://github.com/rust-psutil/rust-psutil
- Nim: https://github.com/johnscillieri/psutil-nim
PK ok\ psutil-6.1.0.dist-info/REQUESTEDnu �[��� PK ok\TFG $ psutil-6.1.0.dist-info/top_level.txtnu �[��� psutil
PK ok\� �� psutil-6.1.0.dist-info/INSTALLERnu �[��� pip
PK @u\ certifi/py.typednu �[��� PK @u\���^ ^ certifi/__init__.pynu �[��� from .core import contents, where
__all__ = ["contents", "where"]
__version__ = "2024.08.30"
PK @u\ ���� � certifi/__main__.pynu �[��� import argparse
from certifi import contents, where
parser = argparse.ArgumentParser()
parser.add_argument("-c", "--contents", action="store_true")
args = parser.parse_args()
if args.contents:
print(contents())
else:
print(where())
PK
@u\b�H + certifi/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h^ � @ s d dl mZmZ ddgZdZdS )� )�contents�wherer r z
2024.08.30N)�corer r �__all__� __version__� r r �:/usr/local/lib/python3.9/site-packages/certifi/__init__.py�<module> s PK @u\�5�!( ( ' certifi/__pycache__/core.cpython-39.pycnu �[��� a
��?hJ � @ s d Z ddlZddlZdd�dd�ZejdkrbddlmZmZ dada e
d�dd �Z e
d�d
d �Z n�ejd kr�dd
lm
ZmZ dada e
d�dd �Z e
d�dd �Z njddlZddlZddlmZ eeje
f Zee
df Zdeee
e
e
d�dd�Ze
d�dd �Z e
d�dd �Z dS )ze
certifi.py
~~~~~~~~~~
This module returns the installation location of cacert.pem or its contents.
� N)�returnc C s t �d d d � d S )N)� _CACERT_CTX�__exit__� r r �6/usr/local/lib/python3.9/site-packages/certifi/core.py�exit_cacert_ctx
s r )� � )�as_file�filesc C s4 t d u r0ttd��d��att�� �a t�t � t S �N�certifi�
cacert.pem)
� _CACERT_PATHr
r �joinpathr �str� __enter__�atexit�registerr r r r r �where s
r c C s t d��d�jdd�S �Nr
r �ascii��encoding)r r � read_textr r r r �contents. s r )r � )�pathr c C s, t d u r(tdd�att�� �a t�t� t S r )r �get_pathr r r r r r r r r r r 8 s
c C s t dddd�S r �r r r r r r R s )�Unionz os.PathLike�utf-8�strict)�package�resourcer �errorsr c C s: t t� |d��}|�� W d � S 1 s,0 Y d S )Nr )�openr �read)r# r$ r r% �datar r r r a s r c C s t j�t�} t j�| d�S )Nr )�osr �dirname�__file__�join)�fr r r r l s c C s t dddd�S r r r r r r r q s )r! r" )�__doc__�sysr r � version_info�importlib.resourcesr
r r r r r r r r r r) �types�typingr �
ModuleType�Package�Resourcer r r r �<module> s>
�� PK @u\x��� � + certifi/__pycache__/__main__.cpython-39.pycnu �[��� a
��?h� � @ sX d dl Z d dlmZmZ e �� Zejdddd� e�� ZejrJe e� � n
e e� � dS )� N)�contents�wherez-cz
--contents�
store_true)�action)
�argparse�certifir r �ArgumentParser�parser� add_argument�
parse_args�args�print� r r �:/usr/local/lib/python3.9/site-packages/certifi/__main__.py�<module> s PK @u\!�AJ J certifi/core.pynu �[��� """
certifi.py
~~~~~~~~~~
This module returns the installation location of cacert.pem or its contents.
"""
import sys
import atexit
def exit_cacert_ctx() -> None:
_CACERT_CTX.__exit__(None, None, None) # type: ignore[union-attr]
if sys.version_info >= (3, 11):
from importlib.resources import as_file, files
_CACERT_CTX = None
_CACERT_PATH = None
def where() -> str:
# This is slightly terrible, but we want to delay extracting the file
# in cases where we're inside of a zipimport situation until someone
# actually calls where(), but we don't want to re-extract the file
# on every call of where(), so we'll do it once then store it in a
# global variable.
global _CACERT_CTX
global _CACERT_PATH
if _CACERT_PATH is None:
# This is slightly janky, the importlib.resources API wants you to
# manage the cleanup of this file, so it doesn't actually return a
# path, it returns a context manager that will give you the path
# when you enter it and will do any cleanup when you leave it. In
# the common case of not needing a temporary file, it will just
# return the file system location and the __exit__() is a no-op.
#
# We also have to hold onto the actual context manager, because
# it will do the cleanup whenever it gets garbage collected, so
# we will also store that at the global level as well.
_CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem"))
_CACERT_PATH = str(_CACERT_CTX.__enter__())
atexit.register(exit_cacert_ctx)
return _CACERT_PATH
def contents() -> str:
return files("certifi").joinpath("cacert.pem").read_text(encoding="ascii")
elif sys.version_info >= (3, 7):
from importlib.resources import path as get_path, read_text
_CACERT_CTX = None
_CACERT_PATH = None
def where() -> str:
# This is slightly terrible, but we want to delay extracting the
# file in cases where we're inside of a zipimport situation until
# someone actually calls where(), but we don't want to re-extract
# the file on every call of where(), so we'll do it once then store
# it in a global variable.
global _CACERT_CTX
global _CACERT_PATH
if _CACERT_PATH is None:
# This is slightly janky, the importlib.resources API wants you
# to manage the cleanup of this file, so it doesn't actually
# return a path, it returns a context manager that will give
# you the path when you enter it and will do any cleanup when
# you leave it. In the common case of not needing a temporary
# file, it will just return the file system location and the
# __exit__() is a no-op.
#
# We also have to hold onto the actual context manager, because
# it will do the cleanup whenever it gets garbage collected, so
# we will also store that at the global level as well.
_CACERT_CTX = get_path("certifi", "cacert.pem")
_CACERT_PATH = str(_CACERT_CTX.__enter__())
atexit.register(exit_cacert_ctx)
return _CACERT_PATH
def contents() -> str:
return read_text("certifi", "cacert.pem", encoding="ascii")
else:
import os
import types
from typing import Union
Package = Union[types.ModuleType, str]
Resource = Union[str, "os.PathLike"]
# This fallback will work for Python versions prior to 3.7 that lack the
# importlib.resources module but relies on the existing `where` function
# so won't address issues with environments like PyOxidizer that don't set
# __file__ on modules.
def read_text(
package: Package,
resource: Resource,
encoding: str = 'utf-8',
errors: str = 'strict'
) -> str:
with open(where(), encoding=encoding) as data:
return data.read()
# If we don't have importlib.resources, then we will just do the old logic
# of assuming we're on the filesystem and munge the path directly.
def where() -> str:
f = os.path.dirname(__file__)
return os.path.join(f, "cacert.pem")
def contents() -> str:
return read_text("certifi", "cacert.pem", encoding="ascii")
PK @u\l�Hڣ� �� certifi/cacert.pemnu �[���
# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
# Label: "GlobalSign Root CA"
# Serial: 4835703278459707669005204
# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a
# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c
# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99
-----BEGIN CERTIFICATE-----
MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
-----END CERTIFICATE-----
# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
# Label: "Entrust.net Premium 2048 Secure Server CA"
# Serial: 946069240
# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90
# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31
# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77
-----BEGIN CERTIFICATE-----
MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML
RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp
bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5
IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp
ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3
MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3
LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp
YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG
A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq
K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe
sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX
MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT
XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/
HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH
4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub
j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo
U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf
zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b
u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+
bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er
fF6adulZkMV8gzURZVE=
-----END CERTIFICATE-----
# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
# Label: "Baltimore CyberTrust Root"
# Serial: 33554617
# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4
# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74
# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb
-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
-----END CERTIFICATE-----
# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
# Label: "Entrust Root Certification Authority"
# Serial: 1164660820
# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4
# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9
# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c
-----BEGIN CERTIFICATE-----
MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC
VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0
Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW
KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl
cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw
NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw
NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy
ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV
BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ
KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo
Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4
4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9
KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI
rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi
94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB
sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi
gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo
kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE
vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA
A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t
O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua
AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP
9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/
eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m
0vdXcDazv/wor3ElhVsT/h5/WrQ8
-----END CERTIFICATE-----
# Issuer: CN=AAA Certificate Services O=Comodo CA Limited
# Subject: CN=AAA Certificate Services O=Comodo CA Limited
# Label: "Comodo AAA Services root"
# Serial: 1
# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0
# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49
# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4
-----BEGIN CERTIFICATE-----
MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb
MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow
GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj
YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL
MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM
GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP
ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua
BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe
3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4
YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR
rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm
ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU
oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v
QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t
b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF
AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q
GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz
Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2
G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi
l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3
smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg==
-----END CERTIFICATE-----
# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited
# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited
# Label: "QuoVadis Root CA 2"
# Serial: 1289
# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b
# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7
# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86
-----BEGIN CERTIFICATE-----
MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV
BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa
GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg
Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J
WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB
rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp
+ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1
ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i
Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz
PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og
/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH
oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI
yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud
EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2
A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL
MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT
ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f
BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn
g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl
fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K
WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha
B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc
hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR
TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD
mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z
ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y
4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza
8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u
-----END CERTIFICATE-----
# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited
# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited
# Label: "QuoVadis Root CA 3"
# Serial: 1478
# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf
# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85
# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35
-----BEGIN CERTIFICATE-----
MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV
BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM
V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB
4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr
H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd
8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv
vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT
mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe
btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc
T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt
WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ
c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A
4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD
VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG
CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0
aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0
aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu
dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw
czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G
A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC
TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg
Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0
7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem
d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd
+LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B
4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN
t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x
DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57
k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s
zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j
Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT
mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
4SVhM7JZG+Ju1zdXtg2pEto=
-----END CERTIFICATE-----
# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
# Label: "XRamp Global CA Root"
# Serial: 107108908803651509692980124233745014957
# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1
# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6
# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2
-----BEGIN CERTIFICATE-----
MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB
gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk
MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY
UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx
NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3
dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy
dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB
dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6
38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP
KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q
DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4
qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa
JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi
PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P
BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs
jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0
eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD
ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR
vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt
qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa
IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy
i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ
O+7ETPTsJ3xCwnR8gooJybQDJbw=
-----END CERTIFICATE-----
# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
# Label: "Go Daddy Class 2 CA"
# Serial: 0
# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67
# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4
# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4
-----BEGIN CERTIFICATE-----
MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh
MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE
YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3
MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo
ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg
MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN
ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA
PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w
wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi
EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY
avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+
YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE
sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h
/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5
IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj
YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD
ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy
OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P
TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ
HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER
dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf
ReYNnyicsbkqWletNw+vHX/bvZ8=
-----END CERTIFICATE-----
# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
# Label: "Starfield Class 2 CA"
# Serial: 0
# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24
# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a
# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58
-----BEGIN CERTIFICATE-----
MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
+lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Assured ID Root CA"
# Serial: 17154717934120587862167794914071425081
# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72
# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43
# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c
-----BEGIN CERTIFICATE-----
MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
+o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Global Root CA"
# Serial: 10944719598952040374951832963794454346
# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e
# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36
# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61
-----BEGIN CERTIFICATE-----
MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
-----END CERTIFICATE-----
# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert High Assurance EV Root CA"
# Serial: 3553400076410547919724730734378100087
# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a
# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25
# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf
-----BEGIN CERTIFICATE-----
MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL
MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm
+9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW
PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM
xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB
Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3
hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg
EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF
MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA
FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec
nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z
eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF
hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2
Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe
vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
+OkuE6N36B9K
-----END CERTIFICATE-----
# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG
# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG
# Label: "SwissSign Gold CA - G2"
# Serial: 13492815561806991280
# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93
# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61
# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95
-----BEGIN CERTIFICATE-----
MIIFujCCA6KgAwIBAgIJALtAHEP1Xk+wMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
BAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxHzAdBgNVBAMTFlN3aXNzU2ln
biBHb2xkIENBIC0gRzIwHhcNMDYxMDI1MDgzMDM1WhcNMzYxMDI1MDgzMDM1WjBF
MQswCQYDVQQGEwJDSDEVMBMGA1UEChMMU3dpc3NTaWduIEFHMR8wHQYDVQQDExZT
d2lzc1NpZ24gR29sZCBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEAr+TufoskDhJuqVAtFkQ7kpJcyrhdhJJCEyq8ZVeCQD5XJM1QiyUqt2/8
76LQwB8CJEoTlo8jE+YoWACjR8cGp4QjK7u9lit/VcyLwVcfDmJlD909Vopz2q5+
bbqBHH5CjCA12UNNhPqE21Is8w4ndwtrvxEvcnifLtg+5hg3Wipy+dpikJKVyh+c
6bM8K8vzARO/Ws/BtQpgvd21mWRTuKCWs2/iJneRjOBiEAKfNA+k1ZIzUd6+jbqE
emA8atufK+ze3gE/bk3lUIbLtK/tREDFylqM2tIrfKjuvqblCqoOpd8FUrdVxyJd
MmqXl2MT28nbeTZ7hTpKxVKJ+STnnXepgv9VHKVxaSvRAiTysybUa9oEVeXBCsdt
MDeQKuSeFDNeFhdVxVu1yzSJkvGdJo+hB9TGsnhQ2wwMC3wLjEHXuendjIj3o02y
MszYF9rNt85mndT9Xv+9lz4pded+p2JYryU0pUHHPbwNUMoDAw8IWh+Vc3hiv69y
FGkOpeUDDniOJihC8AcLYiAQZzlG+qkDzAQ4embvIIO1jEpWjpEA/I5cgt6IoMPi
aG59je883WX0XaxR7ySArqpWl2/5rX3aYT+YdzylkbYcjCbaZaIJbcHiVOO5ykxM
gI93e2CaHt+28kgeDrpOVG2Y4OGiGqJ3UM/EY5LsRxmd6+ZrzsECAwEAAaOBrDCB
qTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUWyV7
lqRlUX64OfPAeGZe6Drn8O4wHwYDVR0jBBgwFoAUWyV7lqRlUX64OfPAeGZe6Drn
8O4wRgYDVR0gBD8wPTA7BglghXQBWQECAQEwLjAsBggrBgEFBQcCARYgaHR0cDov
L3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBACe6
45R88a7A3hfm5djV9VSwg/S7zV4Fe0+fdWavPOhWfvxyeDgD2StiGwC5+OlgzczO
UYrHUDFu4Up+GC9pWbY9ZIEr44OE5iKHjn3g7gKZYbge9LgriBIWhMIxkziWMaa5
O1M/wySTVltpkuzFwbs4AOPsF6m43Md8AYOfMke6UiI0HTJ6CVanfCU2qT1L2sCC
bwq7EsiHSycR+R4tx5M/nttfJmtS2S6K8RTGRI0Vqbe/vd6mGu6uLftIdxf+u+yv
GPUqUfA5hJeVbG4bwyvEdGB5JbAKJ9/fXtI5z0V9QkvfsywexcZdylU6oJxpmo/a
77KwPJ+HbBIrZXAVUjEaJM9vMSNQH4xPjyPDdEFjHFWoFN0+4FFQz/EbMFYOkrCC
hdiDyyJkvC24JdVUorgG6q2SpCSgwYa1ShNqR88uC1aVVMvOmttqtKay20EIhid3
92qgQmwLOM7XdVAyksLfKzAiSNDVQTglXaTpXZ/GlHXQRf0wl0OPkKsKx4ZzYEpp
Ld6leNcG2mqeSz53OiATIgHQv2ieY2BrNU0LbbqhPcCT4H8js1WtciVORvnSFu+w
ZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6LqjviOvrv1vA+ACOzB2+htt
Qc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ
-----END CERTIFICATE-----
# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG
# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG
# Label: "SwissSign Silver CA - G2"
# Serial: 5700383053117599563
# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13
# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb
# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5
-----BEGIN CERTIFICATE-----
MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UE
BhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWdu
IFNpbHZlciBDQSAtIEcyMB4XDTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0Nlow
RzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMY
U3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A
MIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644N0Mv
Fz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7br
YT7QbNHm+/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieF
nbAVlDLaYQ1HTWBCrpJH6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH
6ATK72oxh9TAtvmUcXtnZLi2kUpCe2UuMGoM9ZDulebyzYLs2aFK7PayS+VFheZt
eJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5hqAaEuSh6XzjZG6k4sIN/
c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5FZGkECwJ
MoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRH
HTBsROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTf
jNFusB3hB48IHpmccelM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb6
5i/4z3GcRm25xBWNOHkDRUjvxF3XCO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOB
rDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
F6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRBtjpbO8tFnb0c
wpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0
cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIB
AHPGgeAn0i0P4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShp
WJHckRE1qTodvBqlYJ7YH39FkWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9
xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L3XWgwF15kIwb4FDm3jH+mHtwX6WQ
2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx/uNncqCxv1yL5PqZ
IseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFaDGi8
aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2X
em1ZqSqPe97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQR
dAtq/gsD/KNVV4n+SsuuWxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/
OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJDIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+
hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ubDgEj8Z+7fNzcbBGXJbLy
tGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u
-----END CERTIFICATE-----
# Issuer: CN=SecureTrust CA O=SecureTrust Corporation
# Subject: CN=SecureTrust CA O=SecureTrust Corporation
# Label: "SecureTrust CA"
# Serial: 17199774589125277788362757014266862032
# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1
# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11
# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73
-----BEGIN CERTIFICATE-----
MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI
MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz
MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv
cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN
AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz
Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO
0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao
wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj
7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS
8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT
BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg
JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC
NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3
6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/
3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm
D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS
CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR
3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE=
-----END CERTIFICATE-----
# Issuer: CN=Secure Global CA O=SecureTrust Corporation
# Subject: CN=Secure Global CA O=SecureTrust Corporation
# Label: "Secure Global CA"
# Serial: 9751836167731051554232119481456978597
# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de
# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b
# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69
-----BEGIN CERTIFICATE-----
MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK
MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx
MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg
Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG
SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ
iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa
/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ
jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI
HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7
sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w
gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF
MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw
KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG
AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L
URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO
H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm
I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY
iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc
f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW
-----END CERTIFICATE-----
# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited
# Subject: CN=COMODO Certification Authority O=COMODO CA Limited
# Label: "COMODO Certification Authority"
# Serial: 104350513648249232941998508985834464573
# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75
# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b
# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66
-----BEGIN CERTIFICATE-----
MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB
gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV
BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw
MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl
YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P
RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0
aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3
UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI
2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8
Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp
+2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+
DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O
nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW
/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g
PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u
QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY
SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv
IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/
RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4
zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd
BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB
ZQ==
-----END CERTIFICATE-----
# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
# Label: "COMODO ECC Certification Authority"
# Serial: 41578283867086692638256921589707938090
# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23
# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11
# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7
-----BEGIN CERTIFICATE-----
MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL
MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT
IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw
MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy
ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N
T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR
FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J
cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW
BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm
fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv
GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY=
-----END CERTIFICATE-----
# Issuer: CN=Certigna O=Dhimyotis
# Subject: CN=Certigna O=Dhimyotis
# Label: "Certigna"
# Serial: 18364802974209362175
# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff
# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97
# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV
BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X
DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ
BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3
DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4
QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny
gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw
zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q
130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2
JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw
DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw
ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT
AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj
AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG
9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h
bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc
fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu
HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w
t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw
WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg==
-----END CERTIFICATE-----
# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
# Label: "ePKI Root Certification Authority"
# Serial: 28956088682735189655030529057352760477
# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3
# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0
# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5
-----BEGIN CERTIFICATE-----
MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe
MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe
Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw
IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL
SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF
AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH
SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh
ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X
DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1
TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ
fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA
sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU
WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS
nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH
dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip
NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC
AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF
MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH
ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB
uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl
PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP
JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/
gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2
j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6
5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB
o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS
/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z
Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE
W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D
hNQ+IIX3Sj0rnP0qCglN6oH4EZw=
-----END CERTIFICATE-----
# Issuer: O=certSIGN OU=certSIGN ROOT CA
# Subject: O=certSIGN OU=certSIGN ROOT CA
# Label: "certSIGN ROOT CA"
# Serial: 35210227249154
# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17
# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b
# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb
-----BEGIN CERTIFICATE-----
MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT
AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD
QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP
MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC
ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do
0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ
UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d
RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ
OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv
JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C
AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O
BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ
LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY
MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ
44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I
Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw
i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN
9u6wWk5JRFRYX0KD
-----END CERTIFICATE-----
# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny"
# Serial: 80544274841616
# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88
# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91
# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98
-----BEGIN CERTIFICATE-----
MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG
EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3
MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl
cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR
dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB
pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM
b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm
aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz
IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT
lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz
AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5
VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG
ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2
BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG
AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M
U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh
bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C
+C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC
bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F
uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
-----END CERTIFICATE-----
# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
# Label: "SecureSign RootCA11"
# Serial: 1
# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26
# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3
# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12
-----BEGIN CERTIFICATE-----
MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr
MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG
A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0
MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp
Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD
QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz
i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8
h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV
MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9
UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni
8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC
h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD
VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB
AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm
KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ
X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr
QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5
pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN
QSdJQO7e5iNEOdyhIta6A/I=
-----END CERTIFICATE-----
# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
# Label: "Microsec e-Szigno Root CA 2009"
# Serial: 14014712776195784473
# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1
# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e
# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78
-----BEGIN CERTIFICATE-----
MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD
VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0
ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G
CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y
OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx
FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp
Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o
dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP
kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc
cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U
fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7
N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC
xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1
+rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM
Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG
SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h
mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk
ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775
tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c
2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t
HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
# Label: "GlobalSign Root CA - R3"
# Serial: 4835703278459759426209954
# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28
# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad
# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b
-----BEGIN CERTIFICATE-----
MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
WD9f
-----END CERTIFICATE-----
# Issuer: CN=Izenpe.com O=IZENPE S.A.
# Subject: CN=Izenpe.com O=IZENPE S.A.
# Label: "Izenpe.com"
# Serial: 917563065490389241595536686991402621
# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73
# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19
# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f
-----BEGIN CERTIFICATE-----
MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4
MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6
ZW5wZS5jb20wHhcNMDcxMjEzMTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYD
VQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5j
b20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ03rKDx6sp4boFmVq
scIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAKClaO
xdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6H
LmYRY2xU+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFX
uaOKmMPsOzTFlUFpfnXCPCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQD
yCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxTOTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+
JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbKF7jJeodWLBoBHmy+E60Q
rLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK0GqfvEyN
BjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8L
hij+0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIB
QFqNeb+Lz0vPqhbBleStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+
HMh3/1uaD7euBUbl8agW7EekFwIDAQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2lu
Zm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+SVpFTlBFIFMuQS4gLSBDSUYg
QTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBGNjIgUzgxQzBB
BgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx
MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
AQYwHQYDVR0OBBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUA
A4ICAQB4pgwWSp9MiDrAyw6lFn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWb
laQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbgakEyrkgPH7UIBzg/YsfqikuFgba56
awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8qhT/AQKM6WfxZSzwo
JNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Csg1lw
LDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCT
VyvehQP5aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGk
LhObNA5me0mrZJfQRsN5nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJb
UjWumDqtujWTI6cfSN01RpiyEGjkpTHCClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/
QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZoQ0iy2+tzJOeRf1SktoA+
naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1ZWrOZyGls
QyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw==
-----END CERTIFICATE-----
# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
# Label: "Go Daddy Root Certificate Authority - G2"
# Serial: 0
# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01
# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b
# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da
-----BEGIN CERTIFICATE-----
MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz
NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE
AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw
DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD
E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH
/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy
DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh
GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR
tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA
AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX
WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu
9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr
gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo
2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI
4uJEvlz36hz1
-----END CERTIFICATE-----
# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
# Label: "Starfield Root Certificate Authority - G2"
# Serial: 0
# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96
# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e
# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5
-----BEGIN CERTIFICATE-----
MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx
EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs
ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw
MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6
b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj
aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp
Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg
nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1
HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N
Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN
dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0
HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO
BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G
CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU
sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3
4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg
8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K
pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1
mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0
-----END CERTIFICATE-----
# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
# Label: "Starfield Services Root Certificate Authority - G2"
# Serial: 0
# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2
# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f
# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5
-----BEGIN CERTIFICATE-----
MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx
EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs
ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5
MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD
VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy
ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy
dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI
hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p
OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2
8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K
Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe
hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk
6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw
DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q
AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI
bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB
ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z
qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd
iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn
0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN
sSi6
-----END CERTIFICATE-----
# Issuer: CN=AffirmTrust Commercial O=AffirmTrust
# Subject: CN=AffirmTrust Commercial O=AffirmTrust
# Label: "AffirmTrust Commercial"
# Serial: 8608355977964138876
# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7
# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7
# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7
-----BEGIN CERTIFICATE-----
MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE
BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL
MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP
Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr
ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL
MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1
yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr
VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/
nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG
XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj
vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt
Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g
N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC
nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8=
-----END CERTIFICATE-----
# Issuer: CN=AffirmTrust Networking O=AffirmTrust
# Subject: CN=AffirmTrust Networking O=AffirmTrust
# Label: "AffirmTrust Networking"
# Serial: 8957382827206547757
# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f
# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f
# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b
-----BEGIN CERTIFICATE-----
MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE
BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL
MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y
YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua
kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL
QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp
6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG
yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i
QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO
tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu
QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ
Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u
olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48
x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s=
-----END CERTIFICATE-----
# Issuer: CN=AffirmTrust Premium O=AffirmTrust
# Subject: CN=AffirmTrust Premium O=AffirmTrust
# Label: "AffirmTrust Premium"
# Serial: 7893706540734352110
# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57
# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27
# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a
-----BEGIN CERTIFICATE-----
MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE
BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz
dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG
A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U
cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf
qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ
JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ
+jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS
s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5
HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7
70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG
V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S
qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S
5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia
C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX
OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE
FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2
KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg
Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B
8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ
MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc
0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ
u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF
u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH
YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8
GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO
RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e
KeC2uAloGRwYQw==
-----END CERTIFICATE-----
# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust
# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust
# Label: "AffirmTrust Premium ECC"
# Serial: 8401224907861490260
# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d
# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb
# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23
-----BEGIN CERTIFICATE-----
MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC
VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ
cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ
BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt
VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D
0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9
ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G
A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G
A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs
aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I
flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ==
-----END CERTIFICATE-----
# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
# Label: "Certum Trusted Network CA"
# Serial: 279744
# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78
# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e
# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e
-----BEGIN CERTIFICATE-----
MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM
MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D
ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU
cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3
WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg
Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw
IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B
AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH
UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM
TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU
BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM
kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x
AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV
HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y
sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL
I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8
J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY
VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI
03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw=
-----END CERTIFICATE-----
# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
# Label: "TWCA Root Certification Authority"
# Serial: 1
# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79
# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48
# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44
-----BEGIN CERTIFICATE-----
MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES
MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU
V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz
WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO
LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm
aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE
AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH
K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX
RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z
rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx
3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq
hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC
MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls
XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D
lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn
aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ
YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw==
-----END CERTIFICATE-----
# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
# Label: "Security Communication RootCA2"
# Serial: 0
# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43
# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74
# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6
-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl
MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe
U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX
DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy
dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj
YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV
OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr
zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM
VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ
hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO
ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw
awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs
OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3
DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF
coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc
okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8
t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy
1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/
SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
-----END CERTIFICATE-----
# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
# Label: "Actalis Authentication Root CA"
# Serial: 6271844772424770508
# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6
# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac
# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66
-----BEGIN CERTIFICATE-----
MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE
BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w
MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290
IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC
SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1
ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv
UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX
4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9
KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/
gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb
rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ
51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F
be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe
KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F
v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn
fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7
jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz
ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt
ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL
e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70
jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz
WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V
SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j
pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX
X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok
fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R
K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU
ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU
LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT
LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg==
-----END CERTIFICATE-----
# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
# Label: "Buypass Class 2 Root CA"
# Serial: 2
# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29
# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99
# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48
-----BEGIN CERTIFICATE-----
MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow
TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr
6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV
L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91
1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx
MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ
QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB
arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr
Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi
FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS
P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN
9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP
AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz
uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h
9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s
A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t
OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo
+fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7
KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2
DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us
H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ
I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7
5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h
3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz
Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA=
-----END CERTIFICATE-----
# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
# Label: "Buypass Class 3 Root CA"
# Serial: 2
# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec
# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57
# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d
-----BEGIN CERTIFICATE-----
MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow
TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y
ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E
N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9
tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX
0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c
/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X
KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY
zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS
O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D
34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP
K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3
AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv
Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj
QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV
cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS
IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2
HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa
O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv
033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u
dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE
kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41
3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD
u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq
4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc=
-----END CERTIFICATE-----
# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
# Label: "T-TeleSec GlobalRoot Class 3"
# Serial: 1
# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef
# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1
# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1
OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G
CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN
8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/
RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4
hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5
ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM
EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj
QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1
A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy
WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ
1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30
6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT
91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml
e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p
TpPDpFQUWw==
-----END CERTIFICATE-----
# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
# Label: "D-TRUST Root Class 3 CA 2 2009"
# Serial: 623603
# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f
# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0
# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1
-----BEGIN CERTIFICATE-----
MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF
MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD
bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha
ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM
HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB
BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03
UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42
tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R
ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM
lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp
/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G
A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G
A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj
dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy
MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl
cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js
L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL
BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni
acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0
o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K
zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8
PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y
Johw1+qRzT65ysCQblrGXnRl11z+o+I=
-----END CERTIFICATE-----
# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
# Label: "D-TRUST Root Class 3 CA 2 EV 2009"
# Serial: 623604
# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6
# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83
# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81
-----BEGIN CERTIFICATE-----
MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF
MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD
bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw
NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV
BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI
hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn
ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0
3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z
qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR
p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8
HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw
ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea
HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw
Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh
c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E
RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt
dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku
Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp
3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05
nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF
CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na
xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX
KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1
-----END CERTIFICATE-----
# Issuer: CN=CA Disig Root R2 O=Disig a.s.
# Subject: CN=CA Disig Root R2 O=Disig a.s.
# Label: "CA Disig Root R2"
# Serial: 10572350602393338211
# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03
# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71
# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03
-----BEGIN CERTIFICATE-----
MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV
BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu
MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy
MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx
EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw
ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe
NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH
PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I
x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe
QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR
yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO
QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912
H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ
QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD
i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs
nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1
rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud
DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI
hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM
tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf
GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb
lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka
+elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal
TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i
nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3
gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr
G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os
zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x
L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL
-----END CERTIFICATE-----
# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
# Label: "ACCVRAIZ1"
# Serial: 6828503384748696800
# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02
# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17
# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13
-----BEGIN CERTIFICATE-----
MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE
AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw
CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ
BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND
VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb
qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY
HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo
G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA
lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr
IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/
0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH
k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47
4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO
m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa
cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl
uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI
KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls
ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG
AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2
VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT
VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG
CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA
cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA
QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA
7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA
cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA
QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA
czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu
aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt
aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud
DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF
BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp
D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU
JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m
AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD
vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms
tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH
7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h
I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA
h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF
d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H
pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7
-----END CERTIFICATE-----
# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
# Label: "TWCA Global Root CA"
# Serial: 3262
# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96
# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65
# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b
-----BEGIN CERTIFICATE-----
MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx
EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT
VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5
NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT
B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF
10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz
0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh
MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH
zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc
46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2
yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi
laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP
oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA
BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE
qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm
4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL
1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn
LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF
H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo
RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+
nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh
15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW
6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW
nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j
wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz
aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy
KwbQBM0=
-----END CERTIFICATE-----
# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera
# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera
# Label: "TeliaSonera Root CA v1"
# Serial: 199041966741090107964904287217786801558
# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c
# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37
# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89
-----BEGIN CERTIFICATE-----
MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw
NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv
b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD
VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2
MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F
VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1
7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X
Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+
/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs
81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm
dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe
Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu
sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4
pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs
slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ
arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD
VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG
9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl
dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx
0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj
TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed
Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7
Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI
OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7
vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW
t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn
HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx
SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY=
-----END CERTIFICATE-----
# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
# Label: "T-TeleSec GlobalRoot Class 2"
# Serial: 1
# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a
# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9
# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1
OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G
CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd
AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC
FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi
1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq
jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ
wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj
QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/
WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy
NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC
uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw
IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6
g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN
9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP
BSeOE6Fuwg==
-----END CERTIFICATE-----
# Issuer: CN=Atos TrustedRoot 2011 O=Atos
# Subject: CN=Atos TrustedRoot 2011 O=Atos
# Label: "Atos TrustedRoot 2011"
# Serial: 6643877497813316402
# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56
# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21
# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74
-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE
AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG
EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM
FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC
REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp
Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM
VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+
SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ
4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L
cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi
eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV
HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG
A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3
DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j
vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP
DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc
maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D
lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv
KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed
-----END CERTIFICATE-----
# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
# Label: "QuoVadis Root CA 1 G3"
# Serial: 687049649626669250736271037606554624078720034195
# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab
# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67
# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL
BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00
MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV
wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe
rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341
68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh
4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp
UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o
abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc
3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G
KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt
hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO
Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt
zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD
ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC
MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2
cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN
qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5
YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv
b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2
8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k
NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj
ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp
q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt
nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD
-----END CERTIFICATE-----
# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
# Label: "QuoVadis Root CA 2 G3"
# Serial: 390156079458959257446133169266079962026824725800
# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06
# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36
# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL
BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00
MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf
qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW
n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym
c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+
O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1
o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j
IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq
IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz
8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh
vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l
7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG
cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD
ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66
AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC
roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga
W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n
lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE
+V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV
csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd
dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg
KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM
HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4
WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M
-----END CERTIFICATE-----
# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
# Label: "QuoVadis Root CA 3 G3"
# Serial: 268090761170461462463995952157327242137089239581
# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7
# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d
# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL
BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00
MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR
/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu
FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR
U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c
ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR
FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k
A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw
eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl
sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp
VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q
A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+
ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD
ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px
KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI
FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv
oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg
u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP
0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf
3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl
8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+
DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN
PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/
ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Assured ID Root G2"
# Serial: 15385348160840213938643033620894905419
# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d
# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f
# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85
-----BEGIN CERTIFICATE-----
MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG
EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi
MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA
n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc
biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp
EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA
bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu
YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB
AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW
BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI
QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I
0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni
lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9
B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv
ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo
IhNzbM8m9Yop5w==
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Assured ID Root G3"
# Serial: 15459312981008553731928384953135426796
# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb
# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89
# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2
-----BEGIN CERTIFICATE-----
MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw
CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg
RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV
UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq
hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf
Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q
RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD
AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY
JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv
6pZjamVFkpUBtA==
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Global Root G2"
# Serial: 4293743540046975378534879503202253541
# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44
# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4
# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f
-----BEGIN CERTIFICATE-----
MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH
MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT
MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI
2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx
1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ
q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz
tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ
vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP
BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV
5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY
1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4
NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG
Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91
8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe
pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl
MrY=
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Global Root G3"
# Serial: 7089244469030293291760083333884364146
# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca
# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e
# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0
-----BEGIN CERTIFICATE-----
MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw
CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe
Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw
EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x
IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF
K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG
fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO
Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd
BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx
AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/
oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8
sycX
-----END CERTIFICATE-----
# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
# Label: "DigiCert Trusted Root G4"
# Serial: 7451500558977370777930084869016614236
# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49
# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4
# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88
-----BEGIN CERTIFICATE-----
MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg
RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV
UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y
ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If
xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV
ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO
DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ
jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/
CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi
EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM
fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY
uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK
chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t
9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD
ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2
SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd
+SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc
fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa
sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N
cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N
0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie
4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI
r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1
/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm
gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+
-----END CERTIFICATE-----
# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited
# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited
# Label: "COMODO RSA Certification Authority"
# Serial: 101909084537582093308941363524873193117
# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18
# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4
# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34
-----BEGIN CERTIFICATE-----
MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB
hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5
MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh
dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR
6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X
pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC
9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV
/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf
Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z
+pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w
qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah
SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC
u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf
Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq
crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E
FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB
/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl
wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM
4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV
2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna
FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ
CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK
boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke
jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL
S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb
QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl
0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB
NVOFBkpdn627G190
-----END CERTIFICATE-----
# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
# Label: "USERTrust RSA Certification Authority"
# Serial: 2645093764781058787591871645665788717
# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5
# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e
# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2
-----BEGIN CERTIFICATE-----
MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB
iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl
cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV
BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw
MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV
BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy
dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B
3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY
tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/
Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2
VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT
79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6
c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT
Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l
c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee
UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE
Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd
BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G
A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF
Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO
VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3
ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs
8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR
iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze
Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ
XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/
qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB
VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB
L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG
jjxDah2nGN59PRbxYvnKkKj9
-----END CERTIFICATE-----
# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
# Label: "USERTrust ECC Certification Authority"
# Serial: 123013823720199481456569720443997572134
# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1
# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0
# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a
-----BEGIN CERTIFICATE-----
MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL
MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl
eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT
JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx
MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg
VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm
aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo
I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng
o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G
A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD
VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB
zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW
RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
# Label: "GlobalSign ECC Root CA - R5"
# Serial: 32785792099990507226680698011560947931244
# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08
# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa
# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24
-----BEGIN CERTIFICATE-----
MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk
MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH
bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc
8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke
hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD
VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI
KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg
515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO
xwy8p2Fp8fc74SrL+SvzZpA3
-----END CERTIFICATE-----
# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
# Label: "IdenTrust Commercial Root CA 1"
# Serial: 13298821034946342390520003877796839426
# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7
# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25
# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK
MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu
VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw
MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw
JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT
3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU
+ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp
S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1
bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi
T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL
vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK
Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK
dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT
c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv
l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N
iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD
ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH
6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt
LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93
nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3
+wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK
W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT
AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq
l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG
4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ
mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A
7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H
-----END CERTIFICATE-----
# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
# Label: "IdenTrust Public Sector Root CA 1"
# Serial: 13298821034946342390521976156843933698
# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba
# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd
# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN
MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu
VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN
MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0
MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7
ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy
RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS
bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF
/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R
3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw
EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy
9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V
GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ
2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV
WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD
W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN
AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj
t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV
DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9
TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G
lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW
mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df
WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5
+bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ
tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA
GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv
8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c
-----END CERTIFICATE-----
# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
# Label: "Entrust Root Certification Authority - G2"
# Serial: 1246989352
# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2
# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4
# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39
-----BEGIN CERTIFICATE-----
MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC
VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50
cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs
IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz
dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy
NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu
dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt
dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0
aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj
YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T
RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN
cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW
wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1
U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0
jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP
BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN
BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/
jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ
Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v
1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R
nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH
VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g==
-----END CERTIFICATE-----
# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
# Label: "Entrust Root Certification Authority - EC1"
# Serial: 51543124481930649114116133369
# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc
# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47
# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5
-----BEGIN CERTIFICATE-----
MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG
A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3
d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu
dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq
RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy
MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD
VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0
L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g
Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD
ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi
A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt
ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH
Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O
BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC
R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX
hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G
-----END CERTIFICATE-----
# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority
# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority
# Label: "CFCA EV ROOT"
# Serial: 407555286
# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30
# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83
# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd
-----BEGIN CERTIFICATE-----
MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD
TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y
aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx
MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j
aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP
T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03
sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL
TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5
/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp
7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz
EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt
hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP
a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot
aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg
TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV
PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv
cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL
tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd
BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB
ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT
ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL
jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS
ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy
P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19
xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d
Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN
5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe
/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z
AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ
5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su
-----END CERTIFICATE-----
# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
# Label: "OISTE WISeKey Global Root GB CA"
# Serial: 157768595616588414422159278966750757568
# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d
# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed
# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6
-----BEGIN CERTIFICATE-----
MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt
MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg
Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i
YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x
CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG
b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh
bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3
HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx
WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX
1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk
u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P
99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r
M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw
AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB
BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh
cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5
gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO
ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf
aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic
Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM=
-----END CERTIFICATE-----
# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
# Label: "SZAFIR ROOT CA2"
# Serial: 357043034767186914217277344587386743377558296292
# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99
# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de
# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe
-----BEGIN CERTIFICATE-----
MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL
BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6
ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw
NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L
cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg
Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN
QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT
3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw
3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6
3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5
BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN
XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF
AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw
8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG
nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP
oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy
d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg
LvWpCz/UXeHPhJ/iGcJfitYgHuNztw==
-----END CERTIFICATE-----
# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
# Label: "Certum Trusted Network CA 2"
# Serial: 44979900017204383099463764357512596969
# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2
# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92
# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04
-----BEGIN CERTIFICATE-----
MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB
gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu
QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG
A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz
OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ
VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp
ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3
b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA
DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn
0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB
OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE
fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E
Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m
o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i
sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW
OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez
Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS
adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n
3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC
AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ
F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf
CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29
XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm
djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/
WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb
AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq
P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko
b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj
XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P
5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi
DrW5viSP
-----END CERTIFICATE-----
# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
# Label: "Hellenic Academic and Research Institutions RootCA 2015"
# Serial: 0
# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce
# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6
# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36
-----BEGIN CERTIFICATE-----
MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix
DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k
IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT
N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v
dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG
A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh
ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx
QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC
AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA
4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0
AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10
4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C
ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV
9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD
gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6
Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq
NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko
LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc
Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV
HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd
ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I
XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI
M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot
9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V
Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea
j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh
X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ
l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf
bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4
pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK
e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0
vm9qp/UsQu0yrbYhnr68
-----END CERTIFICATE-----
# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015"
# Serial: 0
# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef
# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66
# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33
-----BEGIN CERTIFICATE-----
MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN
BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl
bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv
b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ
BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj
YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5
MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0
dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg
QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa
jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC
MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi
C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep
lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof
TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR
-----END CERTIFICATE-----
# Issuer: CN=ISRG Root X1 O=Internet Security Research Group
# Subject: CN=ISRG Root X1 O=Internet Security Research Group
# Label: "ISRG Root X1"
# Serial: 172886928669790476064670243504169061120
# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e
# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8
# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6
-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
-----END CERTIFICATE-----
# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
# Label: "AC RAIZ FNMT-RCM"
# Serial: 485876308206448804701554682760554759
# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d
# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20
# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa
-----BEGIN CERTIFICATE-----
MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx
CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ
WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ
BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG
Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/
yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf
BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz
WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF
tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z
374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC
IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL
mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7
wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS
MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2
ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet
UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw
AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H
YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3
LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD
nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1
RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM
LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf
77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N
JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm
fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp
6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp
1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B
9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok
RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv
uu8wd+RU4riEmViAqhOLUTpPSPaLtrM=
-----END CERTIFICATE-----
# Issuer: CN=Amazon Root CA 1 O=Amazon
# Subject: CN=Amazon Root CA 1 O=Amazon
# Label: "Amazon Root CA 1"
# Serial: 143266978916655856878034712317230054538369994
# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6
# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16
# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e
-----BEGIN CERTIFICATE-----
MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF
ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL
MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj
ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM
9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw
IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6
VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L
93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm
jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA
A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI
U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs
N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv
o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU
5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy
rqXRfboQnoZsG4q5WTP468SQvvG5
-----END CERTIFICATE-----
# Issuer: CN=Amazon Root CA 2 O=Amazon
# Subject: CN=Amazon Root CA 2 O=Amazon
# Label: "Amazon Root CA 2"
# Serial: 143266982885963551818349160658925006970653239
# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66
# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a
# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4
-----BEGIN CERTIFICATE-----
MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF
ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL
MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK
gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ
W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg
1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K
8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r
2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me
z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR
8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj
mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz
7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6
+XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI
0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB
Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm
UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2
LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY
+gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS
k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl
7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm
btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl
urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+
fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63
n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE
76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H
9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT
4PsJYGw=
-----END CERTIFICATE-----
# Issuer: CN=Amazon Root CA 3 O=Amazon
# Subject: CN=Amazon Root CA 3 O=Amazon
# Label: "Amazon Root CA 3"
# Serial: 143266986699090766294700635381230934788665930
# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87
# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e
# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4
-----BEGIN CERTIFICATE-----
MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5
MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl
ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j
QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr
ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr
BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM
YyRIHN8wfdVoOw==
-----END CERTIFICATE-----
# Issuer: CN=Amazon Root CA 4 O=Amazon
# Subject: CN=Amazon Root CA 4 O=Amazon
# Label: "Amazon Root CA 4"
# Serial: 143266989758080763974105200630763877849284878
# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd
# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be
# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92
-----BEGIN CERTIFICATE-----
MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5
MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi
9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk
M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB
/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB
MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw
CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW
1KyLa2tJElMzrdfkviT8tQp21KW8EA==
-----END CERTIFICATE-----
# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1"
# Serial: 1
# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49
# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca
# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16
-----BEGIN CERTIFICATE-----
MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx
GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp
bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w
KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0
BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy
dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG
EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll
IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU
QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT
TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg
LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7
a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr
LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr
N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X
YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/
iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f
AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH
V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh
AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf
IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4
lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c
8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf
lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM=
-----END CERTIFICATE-----
# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
# Label: "GDCA TrustAUTH R5 ROOT"
# Serial: 9009899650740120186
# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4
# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4
# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93
-----BEGIN CERTIFICATE-----
MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE
BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ
IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0
MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV
BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w
HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF
AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj
Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj
TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u
KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj
qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm
MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12
ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP
zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk
L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC
jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA
HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC
AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB
/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg
p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm
DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5
COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry
L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf
JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg
IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io
2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV
09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ
XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq
T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe
MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
-----END CERTIFICATE-----
# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
# Label: "SSL.com Root Certification Authority RSA"
# Serial: 8875640296558310041
# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29
# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb
# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69
-----BEGIN CERTIFICATE-----
MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE
BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK
DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp
Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz
OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv
bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN
AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R
xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX
qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC
C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3
6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh
/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF
YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E
JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc
US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8
ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm
+Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi
M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV
HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G
A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV
cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc
Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs
PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/
q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0
cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr
a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I
H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y
K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu
nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf
oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY
Ic2wBlX7Jz9TkHCpBB5XJ7k=
-----END CERTIFICATE-----
# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
# Label: "SSL.com Root Certification Authority ECC"
# Serial: 8495723813297216424
# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e
# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a
# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65
-----BEGIN CERTIFICATE-----
MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC
VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0
aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz
WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0
b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS
b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB
BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI
7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg
CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud
EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD
VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T
kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+
gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl
-----END CERTIFICATE-----
# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
# Label: "SSL.com EV Root Certification Authority RSA R2"
# Serial: 6248227494352943350
# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95
# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a
# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c
-----BEGIN CERTIFICATE-----
MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV
BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE
CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy
dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy
MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G
A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD
DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq
M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf
OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa
4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9
HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR
aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA
b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ
Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV
PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO
pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu
UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY
MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV
HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4
9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW
s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5
Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg
cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM
79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz
/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt
ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm
Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK
QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ
w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi
S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07
mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w==
-----END CERTIFICATE-----
# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
# Label: "SSL.com EV Root Certification Authority ECC"
# Serial: 3182246526754555285
# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90
# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d
# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8
-----BEGIN CERTIFICATE-----
MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC
VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp
Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx
NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv
bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49
AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA
VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku
WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP
MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX
5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ
ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg
h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg==
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
# Label: "GlobalSign Root CA - R6"
# Serial: 1417766617973444989252670301619537
# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae
# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1
# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69
-----BEGIN CERTIFICATE-----
MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg
MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh
bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx
MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET
MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI
xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k
ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD
aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw
LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw
1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX
k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2
SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h
bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n
WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY
rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce
MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD
AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu
bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN
nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt
Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61
55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj
vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf
cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz
oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp
nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs
pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v
JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R
8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4
5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA=
-----END CERTIFICATE-----
# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
# Label: "OISTE WISeKey Global Root GC CA"
# Serial: 44084345621038548146064804565436152554
# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23
# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31
# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d
-----BEGIN CERTIFICATE-----
MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw
CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91
bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg
Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ
BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu
ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS
b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni
eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W
p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E
BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T
rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV
57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg
Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
-----END CERTIFICATE-----
# Issuer: CN=UCA Global G2 Root O=UniTrust
# Subject: CN=UCA Global G2 Root O=UniTrust
# Label: "UCA Global G2 Root"
# Serial: 124779693093741543919145257850076631279
# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8
# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a
# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c
-----BEGIN CERTIFICATE-----
MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9
MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH
bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x
CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds
b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr
b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9
kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm
VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R
VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc
C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj
tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY
D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv
j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl
NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6
iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP
O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/
BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV
ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj
L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5
1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl
1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU
b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV
PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj
y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb
EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg
DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI
+Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy
YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX
UB+K+wb1whnw0A==
-----END CERTIFICATE-----
# Issuer: CN=UCA Extended Validation Root O=UniTrust
# Subject: CN=UCA Extended Validation Root O=UniTrust
# Label: "UCA Extended Validation Root"
# Serial: 106100277556486529736699587978573607008
# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2
# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a
# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24
-----BEGIN CERTIFICATE-----
MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH
MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF
eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx
MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV
BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB
AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog
D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS
sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop
O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk
sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi
c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj
VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz
KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/
TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G
sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs
1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD
fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T
AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN
l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR
ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ
VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5
c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp
4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s
t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj
2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO
vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C
xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx
cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM
fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax
-----END CERTIFICATE-----
# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
# Label: "Certigna Root CA"
# Serial: 269714418870597844693661054334862075617
# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77
# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43
# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68
-----BEGIN CERTIFICATE-----
MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw
WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw
MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x
MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD
VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX
BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw
ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO
ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M
CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu
I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm
TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh
C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf
ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz
IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT
Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k
JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5
hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB
GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of
1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov
L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo
dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr
aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq
hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L
6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG
HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6
0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB
lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi
o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1
gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v
faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63
Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh
jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw
3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
-----END CERTIFICATE-----
# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
# Label: "emSign Root CA - G1"
# Serial: 235931866688319308814040
# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac
# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c
# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67
-----BEGIN CERTIFICATE-----
MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD
VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU
ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH
MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO
MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv
Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN
BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz
f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO
8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq
d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM
tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt
Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB
o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD
AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x
PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM
wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d
GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH
6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby
RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
iN66zB+Afko=
-----END CERTIFICATE-----
# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
# Label: "emSign ECC Root CA - G3"
# Serial: 287880440101571086945156
# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40
# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1
# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b
-----BEGIN CERTIFICATE-----
MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG
EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo
bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ
TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s
b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw
djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0
WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS
fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB
zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq
hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB
CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD
+JbNR6iC8hZVdyR+EhCVBCyj
-----END CERTIFICATE-----
# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
# Label: "emSign Root CA - C1"
# Serial: 825510296613316004955058
# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68
# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01
# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f
-----BEGIN CERTIFICATE-----
MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG
A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg
SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw
MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v
dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ
BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ
HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH
3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH
GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c
xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1
aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq
TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87
/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4
kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG
YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT
+xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo
WXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
-----END CERTIFICATE-----
# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
# Label: "emSign ECC Root CA - C3"
# Serial: 582948710642506000014504
# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5
# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66
# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3
-----BEGIN CERTIFICATE-----
MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG
EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx
IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw
MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND
IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci
MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti
sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O
BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB
Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c
3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J
0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
-----END CERTIFICATE-----
# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post
# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post
# Label: "Hongkong Post Root CA 3"
# Serial: 46170865288971385588281144162979347873371282084
# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0
# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02
# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6
-----BEGIN CERTIFICATE-----
MIIFzzCCA7egAwIBAgIUCBZfikyl7ADJk0DfxMauI7gcWqQwDQYJKoZIhvcNAQEL
BQAwbzELMAkGA1UEBhMCSEsxEjAQBgNVBAgTCUhvbmcgS29uZzESMBAGA1UEBxMJ
SG9uZyBLb25nMRYwFAYDVQQKEw1Ib25na29uZyBQb3N0MSAwHgYDVQQDExdIb25n
a29uZyBQb3N0IFJvb3QgQ0EgMzAeFw0xNzA2MDMwMjI5NDZaFw00MjA2MDMwMjI5
NDZaMG8xCzAJBgNVBAYTAkhLMRIwEAYDVQQIEwlIb25nIEtvbmcxEjAQBgNVBAcT
CUhvbmcgS29uZzEWMBQGA1UEChMNSG9uZ2tvbmcgUG9zdDEgMB4GA1UEAxMXSG9u
Z2tvbmcgUG9zdCBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
AoICAQCziNfqzg8gTr7m1gNt7ln8wlffKWihgw4+aMdoWJwcYEuJQwy51BWy7sFO
dem1p+/l6TWZ5Mwc50tfjTMwIDNT2aa71T4Tjukfh0mtUC1Qyhi+AViiE3CWu4mI
VoBc+L0sPOFMV4i707mV78vH9toxdCim5lSJ9UExyuUmGs2C4HDaOym71QP1mbpV
9WTRYA6ziUm4ii8F0oRFKHyPaFASePwLtVPLwpgchKOesL4jpNrcyCse2m5FHomY
2vkALgbpDDtw1VAliJnLzXNg99X/NWfFobxeq81KuEXryGgeDQ0URhLj0mRiikKY
vLTGCAj4/ahMZJx2Ab0vqWwzD9g/KLg8aQFChn5pwckGyuV6RmXpwtZQQS4/t+Tt
bNe/JgERohYpSms0BpDsE9K2+2p20jzt8NYt3eEV7KObLyzJPivkaTv/ciWxNoZb
x39ri1UbSsUgYT2uy1DhCDq+sI9jQVMwCFk8mB13umOResoQUGC/8Ne8lYePl8X+
l2oBlKN8W4UdKjk60FSh0Tlxnf0h+bV78OLgAo9uliQlLKAeLKjEiafv7ZkGL7YK
TE/bosw3Gq9HhS2KX8Q0NEwA/RiTZxPRN+ZItIsGxVd7GYYKecsAyVKvQv83j+Gj
Hno9UKtjBucVtT+2RTeUN7F+8kjDf8V1/peNRY8apxpyKBpADwIDAQABo2MwYTAP
BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBQXnc0e
i9Y5K3DTXNSguB+wAPzFYTAdBgNVHQ4EFgQUF53NHovWOStw01zUoLgfsAD8xWEw
DQYJKoZIhvcNAQELBQADggIBAFbVe27mIgHSQpsY1Q7XZiNc4/6gx5LS6ZStS6LG
7BJ8dNVI0lkUmcDrudHr9EgwW62nV3OZqdPlt9EuWSRY3GguLmLYauRwCy0gUCCk
MpXRAJi70/33MvJJrsZ64Ee+bs7Lo3I6LWldy8joRTnU+kLBEUx3XZL7av9YROXr
gZ6voJmtvqkBZss4HTzfQx/0TW60uhdG/H39h4F5ag0zD/ov+BS5gLNdTaqX4fnk
GMX41TiMJjz98iji7lpJiCzfeT2OnpA8vUFKOt1b9pq0zj8lMH8yfaIDlNDceqFS
3m6TjRgm/VWsvY+b0s+v54Ysyx8Jb6NvqYTUc79NoXQbTiNg8swOqn+knEwlqLJm
Ozj/2ZQw9nKEvmhVEA/GcywWaZMH/rFF7buiVWqw2rVKAiUnhde3t4ZEFolsgCs+
l6mc1X5VTMbeRRAc6uk7nwNT7u56AQIWeNTowr5GdogTPyK7SBIdUgC0An4hGh6c
JfTzPV4e0hz5sy229zdcxsshTrD3mUcYhcErulWuBurQB7Lcq9CClnXO0lD+mefP
L5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB60PZ2Pierc+xYw5F9KBa
LJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fqdBb9HxEG
mpv0
-----END CERTIFICATE-----
# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
# Label: "Entrust Root Certification Authority - G4"
# Serial: 289383649854506086828220374796556676440
# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88
# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01
# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88
-----BEGIN CERTIFICATE-----
MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw
gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL
Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg
MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw
BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0
MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT
MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1
c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ
bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg
Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ
2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E
T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j
5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM
C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T
DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX
wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A
2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm
nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8
dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl
N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj
c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS
5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS
Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr
hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/
B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI
AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw
H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+
b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk
2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol
IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk
5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY
n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw==
-----END CERTIFICATE-----
# Issuer: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
# Subject: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
# Label: "Microsoft ECC Root Certificate Authority 2017"
# Serial: 136839042543790627607696632466672567020
# MD5 Fingerprint: dd:a1:03:e6:4a:93:10:d1:bf:f0:19:42:cb:fe:ed:67
# SHA1 Fingerprint: 99:9a:64:c3:7f:f4:7d:9f:ab:95:f1:47:69:89:14:60:ee:c4:c3:c5
# SHA256 Fingerprint: 35:8d:f3:9d:76:4a:f9:e1:b7:66:e9:c9:72:df:35:2e:e1:5c:fa:c2:27:af:6a:d1:d7:0e:8e:4a:6e:dc:ba:02
-----BEGIN CERTIFICATE-----
MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQsw
CQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYD
VQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw
MTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4MjMxNjA0WjBlMQswCQYDVQQGEwJV
UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNy
b3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQBgcq
hkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZR
ogPZnZH6thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYb
hGBKia/teQ87zvH2RPUBeMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8E
BTADAQH/MB0GA1UdDgQWBBTIy5lycFIM+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3
FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlfXu5gKcs68tvWMoQZP3zV
L8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaReNtUjGUB
iudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M=
-----END CERTIFICATE-----
# Issuer: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
# Subject: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
# Label: "Microsoft RSA Root Certificate Authority 2017"
# Serial: 40975477897264996090493496164228220339
# MD5 Fingerprint: 10:ff:00:ff:cf:c9:f8:c7:7a:c0:ee:35:8e:c9:0f:47
# SHA1 Fingerprint: 73:a5:e6:4a:3b:ff:83:16:ff:0e:dc:cc:61:8a:90:6e:4e:ae:4d:74
# SHA256 Fingerprint: c7:41:f7:0f:4b:2a:8d:88:bf:2e:71:c1:41:22:ef:53:ef:10:eb:a0:cf:a5:e6:4c:fa:20:f4:18:85:30:73:e0
-----BEGIN CERTIFICATE-----
MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBl
MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw
NAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIwNzE4MjMwMDIzWjBlMQswCQYDVQQG
EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1N
aWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZ
Nt9GkMml7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0
ZdDMbRnMlfl7rEqUrQ7eS0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1
HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw71VdyvD/IybLeS2v4I2wDwAW9lcfNcztm
gGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+dkC0zVJhUXAoP8XFWvLJ
jEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49FyGcohJUc
aDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaG
YaRSMLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6
W6IYZVcSn2i51BVrlMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4K
UGsTuqwPN1q3ErWQgR5WrlcihtnJ0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH
+FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJClTUFLkqqNfs+avNJVgyeY+Q
W5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/
BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC
NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZC
LgLNFgVZJ8og6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OC
gMNPOsduET/m4xaRhPtthH80dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6
tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk+ONVFT24bcMKpBLBaYVu32TxU5nh
SnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex/2kskZGT4d9Mozd2
TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDyAmH3
pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGR
xpl/j8nWZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiApp
GWSZI1b7rCoucL5mxAyE7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9
dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKTc0QWbej09+CVgI+WXTik9KveCjCHk9hN
AHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D5KbvtwEwXlGjefVwaaZB
RA+GsCyRxj3qrg+E
-----END CERTIFICATE-----
# Issuer: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
# Subject: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
# Label: "e-Szigno Root CA 2017"
# Serial: 411379200276854331539784714
# MD5 Fingerprint: de:1f:f6:9e:84:ae:a7:b4:21:ce:1e:58:7d:d1:84:98
# SHA1 Fingerprint: 89:d4:83:03:4f:9e:9a:48:80:5f:72:37:d4:a9:a6:ef:cb:7c:1f:d1
# SHA256 Fingerprint: be:b0:0b:30:83:9b:9b:c3:2c:32:e4:44:79:05:95:06:41:f2:64:21:b1:5e:d0:89:19:8b:51:8a:e2:ea:1b:99
-----BEGIN CERTIFICATE-----
MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNV
BAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRk
LjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJv
b3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZaFw00MjA4MjIxMjA3MDZaMHExCzAJ
BgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMg
THRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25v
IFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtv
xie+RJCxs1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+H
Wyx7xf58etqjYzBhMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
A1UdDgQWBBSHERUI0arBeAyxr87GyZDvvzAEwDAfBgNVHSMEGDAWgBSHERUI0arB
eAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEAtVfd14pVCzbhhkT61Nlo
jbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxOsvxyqltZ
+efcMQ==
-----END CERTIFICATE-----
# Issuer: O=CERTSIGN SA OU=certSIGN ROOT CA G2
# Subject: O=CERTSIGN SA OU=certSIGN ROOT CA G2
# Label: "certSIGN Root CA G2"
# Serial: 313609486401300475190
# MD5 Fingerprint: 8c:f1:75:8a:c6:19:cf:94:b7:f7:65:20:87:c3:97:c7
# SHA1 Fingerprint: 26:f9:93:b4:ed:3d:28:27:b0:b9:4b:a7:e9:15:1d:a3:8d:92:e5:32
# SHA256 Fingerprint: 65:7c:fe:2f:a7:3f:aa:38:46:25:71:f3:32:a2:36:3a:46:fc:e7:02:09:51:71:07:02:cd:fb:b6:ee:da:33:05
-----BEGIN CERTIFICATE-----
MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNV
BAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04g
Uk9PVCBDQSBHMjAeFw0xNzAyMDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJ
BgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJ
R04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDF
dRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05N0Iw
vlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZ
uIt4ImfkabBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhp
n+Sc8CnTXPnGFiWeI8MgwT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKs
cpc/I1mbySKEwQdPzH/iV8oScLumZfNpdWO9lfsbl83kqK/20U6o2YpxJM02PbyW
xPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91QqhngLjYl/rNUssuHLoPj1P
rCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732jcZZroiF
DsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fx
DTvf95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgy
LcsUDFDYg2WD7rlcz8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6C
eWRgKRM+o/1Pcmqr4tTluCRVLERLiohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB
/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSCIS1mxteg4BXrzkwJ
d8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOBywaK8SJJ6ejq
kX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC
b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQl
qiCA2ClV9+BB/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0
OJD7uNGzcgbJceaBxXntC6Z58hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+c
NywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5BiKDUyUM/FHE5r7iOZULJK2v0ZXk
ltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklWatKcsWMy5WHgUyIO
pwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tUSxfj
03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZk
PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE
1LlSVHJ7liXMvGnjSG4N0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MX
QRBdJ3NghVdJIgc=
-----END CERTIFICATE-----
# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
# Label: "Trustwave Global Certification Authority"
# Serial: 1846098327275375458322922162
# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e
# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5
# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8
-----BEGIN CERTIFICATE-----
MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw
CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x
ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1
c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx
OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI
SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI
b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp
Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB
ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn
swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu
7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8
1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW
80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP
JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l
RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw
hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10
coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc
BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n
twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud
EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud
DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W
0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe
uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q
lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB
aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE
sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT
MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe
qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh
VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8
h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9
EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK
yeC2nOnOcXHebD8WpHk=
-----END CERTIFICATE-----
# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
# Label: "Trustwave Global ECC P256 Certification Authority"
# Serial: 4151900041497450638097112925
# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54
# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf
# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4
-----BEGIN CERTIFICATE-----
MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD
VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G
A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG
SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN
FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w
DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw
CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh
DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7
-----END CERTIFICATE-----
# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
# Label: "Trustwave Global ECC P384 Certification Authority"
# Serial: 2704997926503831671788816187
# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6
# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2
# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97
-----BEGIN CERTIFICATE-----
MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD
VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G
A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB
BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ
j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF
1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G
A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3
AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC
MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu
Sw==
-----END CERTIFICATE-----
# Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
# Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
# Label: "NAVER Global Root Certification Authority"
# Serial: 9013692873798656336226253319739695165984492813
# MD5 Fingerprint: c8:7e:41:f6:25:3b:f5:09:b3:17:e8:46:3d:bf:d0:9b
# SHA1 Fingerprint: 8f:6b:f2:a9:27:4a:da:14:a0:c4:f4:8e:61:27:f9:c0:1e:78:5d:d1
# SHA256 Fingerprint: 88:f4:38:dc:f8:ff:d1:fa:8f:42:91:15:ff:e5:f8:2a:e1:e0:6e:0c:70:c3:75:fa:ad:71:7b:34:a4:9e:72:65
-----BEGIN CERTIFICATE-----
MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEM
BQAwaTELMAkGA1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRG
T1JNIENvcnAuMTIwMAYDVQQDDClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0
aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4NDJaFw0zNzA4MTgyMzU5NTlaMGkx
CzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVTUyBQTEFURk9STSBD
b3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlvbiBB
dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVA
iQqrDZBbUGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH
38dq6SZeWYp34+hInDEW+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lE
HoSTGEq0n+USZGnQJoViAbbJAh2+g1G7XNr4rRVqmfeSVPc0W+m/6imBEtRTkZaz
kVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2aacp+yPOiNgSnABIqKYP
szuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4Yb8Obtoq
vC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHf
nZ3zVHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaG
YQ5fG8Ir4ozVu53BA0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo
0es+nPxdGoMuK8u180SdOqcXYZaicdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3a
CJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejyYhbLgGvtPe31HzClrkvJE+2K
AQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNVHQ4EFgQU0p+I
36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB
Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoN
qo0hV4/GPnrK21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatj
cu3cvuzHV+YwIHHW1xDBE1UBjCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm
+LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bxhYTeodoS76TiEJd6eN4MUZeoIUCL
hr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTgE34h5prCy8VCZLQe
lHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTHD8z7
p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8
piKCk5XQA76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLR
LBT/DShycpWbXgnbiUSYqqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX
5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oGI/hGoiLtk/bdmuYqh7GYVPEi92tF4+KO
dh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmgkpzNNIaRkPpkUZ3+/uul
9XXeifdy
-----END CERTIFICATE-----
# Issuer: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
# Subject: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
# Label: "AC RAIZ FNMT-RCM SERVIDORES SEGUROS"
# Serial: 131542671362353147877283741781055151509
# MD5 Fingerprint: 19:36:9c:52:03:2f:d2:d1:bb:23:cc:dd:1e:12:55:bb
# SHA1 Fingerprint: 62:ff:d9:9e:c0:65:0d:03:ce:75:93:d2:ed:3f:2d:32:c9:e3:e5:4a
# SHA256 Fingerprint: 55:41:53:b1:3d:2c:f9:dd:b7:53:bf:be:1a:4e:0a:e0:8d:0a:a4:18:70:58:fe:60:a2:b8:62:b2:e4:b8:7b:cb
-----BEGIN CERTIFICATE-----
MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQsw
CQYDVQQGEwJFUzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgw
FgYDVQRhDA9WQVRFUy1RMjgyNjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1S
Q00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4MTIyMDA5MzczM1oXDTQzMTIyMDA5
MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQtUkNNMQ4wDAYDVQQL
DAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNBQyBS
QUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuB
BAAiA2IABPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LH
sbI6GA60XYyzZl2hNPk2LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oK
Um8BA06Oi6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
VR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqGSM49BAMDA2kAMGYCMQCu
SuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoDzBOQn5IC
MQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJy
v+c=
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign Root R46 O=GlobalSign nv-sa
# Subject: CN=GlobalSign Root R46 O=GlobalSign nv-sa
# Label: "GlobalSign Root R46"
# Serial: 1552617688466950547958867513931858518042577
# MD5 Fingerprint: c4:14:30:e4:fa:66:43:94:2a:6a:1b:24:5f:19:d0:ef
# SHA1 Fingerprint: 53:a2:b0:4b:ca:6b:d6:45:e6:39:8a:8e:c4:0d:d2:bf:77:c3:a2:90
# SHA256 Fingerprint: 4f:a3:12:6d:8d:3a:11:d1:c4:85:5a:4f:80:7c:ba:d6:cf:91:9d:3a:5a:88:b0:3b:ea:2c:63:72:d9:3c:40:c9
-----BEGIN CERTIFICATE-----
MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUA
MEYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYD
VQQDExNHbG9iYWxTaWduIFJvb3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMy
MDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYt
c2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
AQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08EsCVeJ
OaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQG
vGIFAha/r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud
316HCkD7rRlr+/fKYIje2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo
0q3v84RLHIf8E6M6cqJaESvWJ3En7YEtbWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSE
y132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvjK8Cd+RTyG/FWaha/LIWF
zXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD412lPFzYE
+cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCN
I/onccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzs
x2sZy/N78CsHpdlseVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqa
ByFrgY/bxFn63iLABJzjqls2k+g9vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC
4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
HQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEMBQADggIBAHx4
7PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg
JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti
2kM3S+LGteWygxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIk
pnnpHs6i58FZFZ8d4kuaPp92CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRF
FRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZmOUdkLG5NrmJ7v2B0GbhWrJKsFjLt
rWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qqJZ4d16GLuc1CLgSk
ZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwyeqiv5
u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP
4vkYxboznxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6
N3ec592kD3ZDZopD8p/7DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3
vouXsXgxT7PntgMTzlSdriVZzH81Xwj3QEUxeCp6
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign Root E46 O=GlobalSign nv-sa
# Subject: CN=GlobalSign Root E46 O=GlobalSign nv-sa
# Label: "GlobalSign Root E46"
# Serial: 1552617690338932563915843282459653771421763
# MD5 Fingerprint: b5:b8:66:ed:de:08:83:e3:c9:e2:01:34:06:ac:51:6f
# SHA1 Fingerprint: 39:b4:6c:d5:fe:80:06:eb:e2:2f:4a:bb:08:33:a0:af:db:b9:dd:84
# SHA256 Fingerprint: cb:b9:c4:4d:84:b8:04:3e:10:50:ea:31:a6:9f:51:49:55:d7:bf:d2:e2:c6:b4:93:01:01:9a:d6:1d:9f:50:58
-----BEGIN CERTIFICATE-----
MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYx
CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQD
ExNHbG9iYWxTaWduIFJvb3QgRTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAw
MDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2Ex
HDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
IgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkBjtjq
R+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGdd
yXqBPCCjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ
7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZkvLtoURMMA/cVi4RguYv/Uo7njLwcAjA8
+RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A=
-----END CERTIFICATE-----
# Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
# Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
# Label: "ANF Secure Server Root CA"
# Serial: 996390341000653745
# MD5 Fingerprint: 26:a6:44:5a:d9:af:4e:2f:b2:1d:b6:65:b0:4e:e8:96
# SHA1 Fingerprint: 5b:6e:68:d0:cc:15:b6:a0:5f:1e:c1:5f:ae:02:fc:6b:2f:5d:6f:74
# SHA256 Fingerprint: fb:8f:ec:75:91:69:b9:10:6b:1e:51:16:44:c6:18:c5:13:04:37:3f:6c:06:43:08:8d:8b:ef:fd:1b:99:75:99
-----BEGIN CERTIFICATE-----
MIIF7zCCA9egAwIBAgIIDdPjvGz5a7EwDQYJKoZIhvcNAQELBQAwgYQxEjAQBgNV
BAUTCUc2MzI4NzUxMDELMAkGA1UEBhMCRVMxJzAlBgNVBAoTHkFORiBBdXRvcmlk
YWQgZGUgQ2VydGlmaWNhY2lvbjEUMBIGA1UECxMLQU5GIENBIFJhaXoxIjAgBgNV
BAMTGUFORiBTZWN1cmUgU2VydmVyIFJvb3QgQ0EwHhcNMTkwOTA0MTAwMDM4WhcN
MzkwODMwMTAwMDM4WjCBhDESMBAGA1UEBRMJRzYzMjg3NTEwMQswCQYDVQQGEwJF
UzEnMCUGA1UEChMeQU5GIEF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uMRQwEgYD
VQQLEwtBTkYgQ0EgUmFpejEiMCAGA1UEAxMZQU5GIFNlY3VyZSBTZXJ2ZXIgUm9v
dCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANvrayvmZFSVgpCj
cqQZAZ2cC4Ffc0m6p6zzBE57lgvsEeBbphzOG9INgxwruJ4dfkUyYA8H6XdYfp9q
yGFOtibBTI3/TO80sh9l2Ll49a2pcbnvT1gdpd50IJeh7WhM3pIXS7yr/2WanvtH
2Vdy8wmhrnZEE26cLUQ5vPnHO6RYPUG9tMJJo8gN0pcvB2VSAKduyK9o7PQUlrZX
H1bDOZ8rbeTzPvY1ZNoMHKGESy9LS+IsJJ1tk0DrtSOOMspvRdOoiXsezx76W0OL
zc2oD2rKDF65nkeP8Nm2CgtYZRczuSPkdxl9y0oukntPLxB3sY0vaJxizOBQ+OyR
p1RMVwnVdmPF6GUe7m1qzwmd+nxPrWAI/VaZDxUse6mAq4xhj0oHdkLePfTdsiQz
W7i1o0TJrH93PB0j7IKppuLIBkwC/qxcmZkLLxCKpvR/1Yd0DVlJRfbwcVw5Kda/
SiOL9V8BY9KHcyi1Swr1+KuCLH5zJTIdC2MKF4EA/7Z2Xue0sUDKIbvVgFHlSFJn
LNJhiQcND85Cd8BEc5xEUKDbEAotlRyBr+Qc5RQe8TZBAQIvfXOn3kLMTOmJDVb3
n5HUA8ZsyY/b2BzgQJhdZpmYgG4t/wHFzstGH6wCxkPmrqKEPMVOHj1tyRRM4y5B
u8o5vzY8KhmqQYdOpc5LMnndkEl/AgMBAAGjYzBhMB8GA1UdIwQYMBaAFJxf0Gxj
o1+TypOYCK2Mh6UsXME3MB0GA1UdDgQWBBScX9BsY6Nfk8qTmAitjIelLFzBNzAO
BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOC
AgEATh65isagmD9uw2nAalxJUqzLK114OMHVVISfk/CHGT0sZonrDUL8zPB1hT+L
9IBdeeUXZ701guLyPI59WzbLWoAAKfLOKyzxj6ptBZNscsdW699QIyjlRRA96Gej
rw5VD5AJYu9LWaL2U/HANeQvwSS9eS9OICI7/RogsKQOLHDtdD+4E5UGUcjohybK
pFtqFiGS3XNgnhAY3jyB6ugYw3yJ8otQPr0R4hUDqDZ9MwFsSBXXiJCZBMXM5gf0
vPSQ7RPi6ovDj6MzD8EpTBNO2hVWcXNyglD2mjN8orGoGjR0ZVzO0eurU+AagNjq
OknkJjCb5RyKqKkVMoaZkgoQI1YS4PbOTOK7vtuNknMBZi9iPrJyJ0U27U1W45eZ
/zo1PqVUSlJZS2Db7v54EX9K3BR5YLZrZAPbFYPhor72I5dQ8AkzNqdxliXzuUJ9
2zg/LFis6ELhDtjTO0wugumDLmsx2d1Hhk9tl5EuT+IocTUW0fJz/iUrB0ckYyfI
+PbZa/wSMVYIwFNCr5zQM378BvAxRAMU8Vjq8moNqRGyg77FGr8H6lnco4g175x2
MjxNBiLOFeXdntiP2t7SxDnlF4HPOEfrf4htWRvfn0IUrn7PqLBmZdo3r5+qPeoo
tt7VMVgWglvquxl1AnMaykgaIZOQCo6ThKd9OyMYkomgjaw=
-----END CERTIFICATE-----
# Issuer: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
# Subject: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
# Label: "Certum EC-384 CA"
# Serial: 160250656287871593594747141429395092468
# MD5 Fingerprint: b6:65:b3:96:60:97:12:a1:ec:4e:e1:3d:a3:c6:c9:f1
# SHA1 Fingerprint: f3:3e:78:3c:ac:df:f4:a2:cc:ac:67:55:69:56:d7:e5:16:3c:e1:ed
# SHA256 Fingerprint: 6b:32:80:85:62:53:18:aa:50:d1:73:c9:8d:8b:da:09:d5:7e:27:41:3d:11:4c:f7:87:a0:f5:d0:6c:03:0c:f6
-----BEGIN CERTIFICATE-----
MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQsw
CQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScw
JQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMT
EENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2MDcyNDU0WhcNNDMwMzI2MDcyNDU0
WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBT
LkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAX
BgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATE
KI6rGFtqvm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7Tm
Fy8as10CW4kjPMIRBSqniBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68Kj
QjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI0GZnQkdjrzife81r1HfS+8
EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjADVS2m5hjEfO/J
UG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0QoSZ/6vn
nvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k=
-----END CERTIFICATE-----
# Issuer: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
# Subject: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
# Label: "Certum Trusted Root CA"
# Serial: 40870380103424195783807378461123655149
# MD5 Fingerprint: 51:e1:c2:e7:fe:4c:84:af:59:0e:2f:f4:54:6f:ea:29
# SHA1 Fingerprint: c8:83:44:c0:18:ae:9f:cc:f1:87:b7:8f:22:d1:c5:d7:45:84:ba:e5
# SHA256 Fingerprint: fe:76:96:57:38:55:77:3e:37:a9:5e:7a:d4:d9:cc:96:c3:01:57:c1:5d:31:76:5b:a9:b1:57:04:e1:ae:78:fd
-----BEGIN CERTIFICATE-----
MIIFwDCCA6igAwIBAgIQHr9ZULjJgDdMBvfrVU+17TANBgkqhkiG9w0BAQ0FADB6
MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEu
MScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxHzAdBgNV
BAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwHhcNMTgwMzE2MTIxMDEzWhcNNDMw
MzE2MTIxMDEzWjB6MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEg
U3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRo
b3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwggIiMA0GCSqG
SIb3DQEBAQUAA4ICDwAwggIKAoICAQDRLY67tzbqbTeRn06TpwXkKQMlzhyC93yZ
n0EGze2jusDbCSzBfN8pfktlL5On1AFrAygYo9idBcEq2EXxkd7fO9CAAozPOA/q
p1x4EaTByIVcJdPTsuclzxFUl6s1wB52HO8AU5853BSlLCIls3Jy/I2z5T4IHhQq
NwuIPMqw9MjCoa68wb4pZ1Xi/K1ZXP69VyywkI3C7Te2fJmItdUDmj0VDT06qKhF
8JVOJVkdzZhpu9PMMsmN74H+rX2Ju7pgE8pllWeg8xn2A1bUatMn4qGtg/BKEiJ3
HAVz4hlxQsDsdUaakFjgao4rpUYwBI4Zshfjvqm6f1bxJAPXsiEodg42MEx51UGa
mqi4NboMOvJEGyCI98Ul1z3G4z5D3Yf+xOr1Uz5MZf87Sst4WmsXXw3Hw09Omiqi
7VdNIuJGmj8PkTQkfVXjjJU30xrwCSss0smNtA0Aq2cpKNgB9RkEth2+dv5yXMSF
ytKAQd8FqKPVhJBPC/PgP5sZ0jeJP/J7UhyM9uH3PAeXjA6iWYEMspA90+NZRu0P
qafegGtaqge2Gcu8V/OXIXoMsSt0Puvap2ctTMSYnjYJdmZm/Bo/6khUHL4wvYBQ
v3y1zgD2DGHZ5yQD4OMBgQ692IU0iL2yNqh7XAjlRICMb/gv1SHKHRzQ+8S1h9E6
Tsd2tTVItQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSM+xx1
vALTn04uSNn5YFSqxLNP+jAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQENBQAD
ggIBAEii1QALLtA/vBzVtVRJHlpr9OTy4EA34MwUe7nJ+jW1dReTagVphZzNTxl4
WxmB82M+w85bj/UvXgF2Ez8sALnNllI5SW0ETsXpD4YN4fqzX4IS8TrOZgYkNCvo
zMrnadyHncI013nR03e4qllY/p0m+jiGPp2Kh2RX5Rc64vmNueMzeMGQ2Ljdt4NR
5MTMI9UGfOZR0800McD2RrsLrfw9EAUqO0qRJe6M1ISHgCq8CYyqOhNf6DR5UMEQ
GfnTKB7U0VEwKbOukGfWHwpjscWpxkIxYxeU72nLL/qMFH3EQxiJ2fAyQOaA4kZf
5ePBAFmo+eggvIksDkc0C+pXwlM2/KfUrzHN/gLldfq5Jwn58/U7yn2fqSLLiMmq
0Uc9NneoWWRrJ8/vJ8HjJLWG965+Mk2weWjROeiQWMODvA8s1pfrzgzhIMfatz7D
P78v3DSk+yshzWePS/Tj6tQ/50+6uaWTRRxmHyH6ZF5v4HaUMst19W7l9o/HuKTM
qJZ9ZPskWkoDbGs4xugDQ5r3V7mzKWmTOPQD8rv7gmsHINFSH5pkAnuYZttcTVoP
0ISVoDwUQwbKytu4QTbaakRnh6+v40URFWkIsr4WOZckbxJF0WddCajJFdr60qZf
E2Efv4WstK2tBZQIgx51F9NxO5NQI1mg7TyRVJ12AMXDuDjb
-----END CERTIFICATE-----
# Issuer: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
# Subject: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
# Label: "TunTrust Root CA"
# Serial: 108534058042236574382096126452369648152337120275
# MD5 Fingerprint: 85:13:b9:90:5b:36:5c:b6:5e:b8:5a:f8:e0:31:57:b4
# SHA1 Fingerprint: cf:e9:70:84:0f:e0:73:0f:9d:f6:0c:7f:2c:4b:ee:20:46:34:9c:bb
# SHA256 Fingerprint: 2e:44:10:2a:b5:8c:b8:54:19:45:1c:8e:19:d9:ac:f3:66:2c:af:bc:61:4b:6a:53:96:0a:30:f7:d0:e2:eb:41
-----BEGIN CERTIFICATE-----
MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQEL
BQAwYTELMAkGA1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUg
Q2VydGlmaWNhdGlvbiBFbGVjdHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJv
b3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQwNDI2MDg1NzU2WjBhMQswCQYDVQQG
EwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBDZXJ0aWZpY2F0aW9u
IEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZ
n56eY+hz2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd
2JQDoOw05TDENX37Jk0bbjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgF
VwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZ
GoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAdgjH8KcwAWJeRTIAAHDOF
li/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViWVSHbhlnU
r8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2
eY8fTpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIb
MlEsPvLfe/ZdeikZjuXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISg
jwBUFfyRbVinljvrS5YnzWuioYasDXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB
7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwSVXAkPcvCFDVDXSdOvsC9qnyW
5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI04Y+oXNZtPdE
ITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0
90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+z
xiD2BkewhpMl0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYu
QEkHDVneixCwSQXi/5E/S7fdAo74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4
FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRYYdZ2vyJ/0Adqp2RT8JeNnYA/u8EH
22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJpadbGNjHh/PqAulxP
xOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65xxBzn
dFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5
Xc0yGYuPjCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7b
nV2UqL1g52KAdoGDDIzMMEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQ
CvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9zZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZH
u/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3rAZ3r2OvEhJn7wAzMMujj
d9qDRIueVSjAi1jTkD5OGwDxFa2DK5o=
-----END CERTIFICATE-----
# Issuer: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
# Subject: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
# Label: "HARICA TLS RSA Root CA 2021"
# Serial: 76817823531813593706434026085292783742
# MD5 Fingerprint: 65:47:9b:58:86:dd:2c:f0:fc:a2:84:1f:1e:96:c4:91
# SHA1 Fingerprint: 02:2d:05:82:fa:88:ce:14:0c:06:79:de:7f:14:10:e9:45:d7:a5:6d
# SHA256 Fingerprint: d9:5d:0e:8e:da:79:52:5b:f9:be:b1:1b:14:d2:10:0d:32:94:98:5f:0c:62:d9:fa:bd:9c:d9:99:ec:cb:7b:1d
-----BEGIN CERTIFICATE-----
MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBs
MQswCQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
c2VhcmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0Eg
Um9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUzOFoXDTQ1MDIxMzEwNTUzN1owbDEL
MAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl
YXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNBIFJv
b3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569l
mwVnlskNJLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE
4VGC/6zStGndLuwRo0Xua2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uv
a9of08WRiFukiZLRgeaMOVig1mlDqa2YUlhu2wr7a89o+uOkXjpFc5gH6l8Cct4M
pbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K5FrZx40d/JiZ+yykgmvw
Kh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEvdmn8kN3b
LW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcY
AuUR0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqB
AGMUuTNe3QvboEUHGjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYq
E613TBoYm5EPWNgGVMWX+Ko/IIqmhaZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHr
W2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQCPxrvrNQKlr9qEgYRtaQQJKQ
CoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8GA1UdEwEB/wQF
MAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE
AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAU
X15QvWiWkKQUEapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3
f5Z2EMVGpdAgS1D0NTsY9FVqQRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxaja
H6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxDQpSbIPDRzbLrLFPCU3hKTwSUQZqP
JzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcRj88YxeMn/ibvBZ3P
zzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5vZSt
jBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0
/L5H9MG0qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pT
BGIBnfHAT+7hOtSLIBD6Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79
aPib8qXPMThcFarmlwDB31qlpzmq6YR/PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YW
xw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnnkf3/W9b3raYvAwtt41dU
63ZTGI0RmLo=
-----END CERTIFICATE-----
# Issuer: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
# Subject: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
# Label: "HARICA TLS ECC Root CA 2021"
# Serial: 137515985548005187474074462014555733966
# MD5 Fingerprint: ae:f7:4c:e5:66:35:d1:b7:9b:8c:22:93:74:d3:4b:b0
# SHA1 Fingerprint: bc:b0:c1:9d:e9:98:92:70:19:38:57:e9:8d:a7:b4:5d:6e:ee:01:48
# SHA256 Fingerprint: 3f:99:cc:47:4a:cf:ce:4d:fe:d5:87:94:66:5e:47:8d:15:47:73:9f:2e:78:0f:1b:b4:ca:9b:13:30:97:d4:01
-----BEGIN CERTIFICATE-----
MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQsw
CQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2Vh
cmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9v
dCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoXDTQ1MDIxMzExMDEwOVowbDELMAkG
A1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj
aCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJvb3Qg
Q0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7
KKrxcm1lAEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9Y
STHMmE5gEYd103KUkE+bECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUw
AwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQD
AgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAircJRQO9gcS3ujwLEXQNw
SaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/QwCZ61IygN
nxS2PFOiTAZpffpskcYqSUXm7LcT4Tps
-----END CERTIFICATE-----
# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
# Serial: 1977337328857672817
# MD5 Fingerprint: 4e:6e:9b:54:4c:ca:b7:fa:48:e4:90:b1:15:4b:1c:a3
# SHA1 Fingerprint: 0b:be:c2:27:22:49:cb:39:aa:db:35:5c:53:e3:8c:ae:78:ff:b6:fe
# SHA256 Fingerprint: 57:de:05:83:ef:d2:b2:6e:03:61:da:99:da:9d:f4:64:8d:ef:7e:e8:44:1c:3b:72:8a:fa:9b:cd:e0:f9:b2:6a
-----BEGIN CERTIFICATE-----
MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UE
BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1
MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1UdDgQWBBRlzeurNR4APn7VdMAc
tHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4wgZswgZgGBFUd
IAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j
b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABC
AG8AbgBhAG4AbwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAw
ADEANzAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9m
iWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL4QjbEwj4KKE1soCzC1HA01aajTNF
Sa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDbLIpgD7dvlAceHabJ
hfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1ilI45P
Vf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZE
EAEeiGaPcjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV
1aUsIC+nmCjuRfzxuIgALI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2t
CsvMo2ebKHTEm9caPARYpoKdrcd7b/+Alun4jWq9GJAd/0kakFI3ky88Al2CdgtR
5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH9IBk9W6VULgRfhVwOEqw
f9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpfNIbnYrX9
ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNK
GbqEZycPvEJdvSRUDewdcAZfpLz6IHxV
-----END CERTIFICATE-----
# Issuer: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
# Subject: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
# Label: "vTrus ECC Root CA"
# Serial: 630369271402956006249506845124680065938238527194
# MD5 Fingerprint: de:4b:c1:f5:52:8c:9b:43:e1:3e:8f:55:54:17:8d:85
# SHA1 Fingerprint: f6:9c:db:b0:fc:f6:02:13:b6:52:32:a6:a3:91:3f:16:70:da:c3:e1
# SHA256 Fingerprint: 30:fb:ba:2c:32:23:8e:2a:98:54:7a:f9:79:31:e5:50:42:8b:9b:3f:1c:8e:eb:66:33:dc:fa:86:c5:b2:7d:d3
-----BEGIN CERTIFICATE-----
MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMw
RzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAY
BgNVBAMTEXZUcnVzIEVDQyBSb290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDcz
MTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28u
LEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYwEAYHKoZIzj0CAQYF
K4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+cToL0
v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUd
e4BdS49nTPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYD
VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIw
V53dVvHH4+m4SVBrm2nDb+zDfSXkV5UTQJtS0zvzQBm8JsctBp61ezaf9SXUY2sA
AjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQLYgmRWAD5Tfs0aNoJrSEG
GJTO
-----END CERTIFICATE-----
# Issuer: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
# Subject: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
# Label: "vTrus Root CA"
# Serial: 387574501246983434957692974888460947164905180485
# MD5 Fingerprint: b8:c9:37:df:fa:6b:31:84:64:c5:ea:11:6a:1b:75:fc
# SHA1 Fingerprint: 84:1a:69:fb:f5:cd:1a:25:34:13:3d:e3:f8:fc:b8:99:d0:c9:14:b7
# SHA256 Fingerprint: 8a:71:de:65:59:33:6f:42:6c:26:e5:38:80:d0:0d:88:a1:8d:a4:c6:a9:1f:0d:cb:61:94:e2:06:c5:c9:63:87
-----BEGIN CERTIFICATE-----
MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQEL
BQAwQzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4x
FjAUBgNVBAMTDXZUcnVzIFJvb3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMx
MDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoGA1UEChMTaVRydXNDaGluYSBDby4s
THRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQAD
ggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZotsSKYc
IrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykU
AyyNJJrIZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+
GrPSbcKvdmaVayqwlHeFXgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z9
8Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KAYPxMvDVTAWqXcoKv8R1w6Jz1717CbMdH
flqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70kLJrxLT5ZOrpGgrIDajt
J8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2AXPKBlim
0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZN
pGvu/9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQ
UqqzApVg+QxMaPnu1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHW
OXSuTEGC2/KmSNGzm/MzqvOmwMVO9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMB
AAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYgscasGrz2iTAPBgNVHRMBAf8E
BTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAKbqSSaet
8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd
nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1j
bhd47F18iMjrjld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvM
Kar5CKXiNxTKsbhm7xqC5PD48acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIiv
TDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJnxDHO2zTlJQNgJXtxmOTAGytfdELS
S8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554WgicEFOwE30z9J4nfr
I8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4sEb9
b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNB
UvupLnKWnyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1P
Ti07NEPhmg4NpGaXutIcSkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929ven
sBxXVsFy6K2ir40zSbofitzmdHxghm+Hl3s=
-----END CERTIFICATE-----
# Issuer: CN=ISRG Root X2 O=Internet Security Research Group
# Subject: CN=ISRG Root X2 O=Internet Security Research Group
# Label: "ISRG Root X2"
# Serial: 87493402998870891108772069816698636114
# MD5 Fingerprint: d3:9e:c4:1e:23:3c:a6:df:cf:a3:7e:6d:e0:14:e6:e5
# SHA1 Fingerprint: bd:b1:b9:3c:d5:97:8d:45:c6:26:14:55:f8:db:95:c7:5a:d1:53:af
# SHA256 Fingerprint: 69:72:9b:8e:15:a8:6e:fc:17:7a:57:af:b7:17:1d:fc:64:ad:d2:8c:2f:ca:8c:f1:50:7e:34:45:3c:cb:14:70
-----BEGIN CERTIFICATE-----
MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQsw
CQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2gg
R3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00
MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVTMSkwJwYDVQQKEyBJbnRlcm5ldCBT
ZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNSRyBSb290IFgyMHYw
EAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0HttwW
+1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9
ItgKbppbd9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0T
AQH/BAUwAwEB/zAdBgNVHQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZI
zj0EAwMDaAAwZQIwe3lORlCEwkSHRhtFcP9Ymd70/aTSVaYgLXTWNLxBo1BfASdW
tL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5U6VR5CmD1/iQMVtCnwr1
/q4AaOeMSQ+2b1tbFfLn
-----END CERTIFICATE-----
# Issuer: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
# Subject: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
# Label: "HiPKI Root CA - G1"
# Serial: 60966262342023497858655262305426234976
# MD5 Fingerprint: 69:45:df:16:65:4b:e8:68:9a:8f:76:5f:ff:80:9e:d3
# SHA1 Fingerprint: 6a:92:e4:a8:ee:1b:ec:96:45:37:e3:29:57:49:cd:96:e3:e5:d2:60
# SHA256 Fingerprint: f0:15:ce:3c:c2:39:bf:ef:06:4b:e9:f1:d2:c4:17:e1:a0:26:4a:0a:94:be:1f:0c:8d:12:18:64:eb:69:49:cc
-----BEGIN CERTIFICATE-----
MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBP
MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
ZC4xGzAZBgNVBAMMEkhpUEtJIFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRa
Fw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3
YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kgUm9vdCBDQSAtIEcx
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0o9Qw
qNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twv
Vcg3Px+kwJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6
lZgRZq2XNdZ1AYDgr/SEYYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnz
Qs7ZngyzsHeXZJzA9KMuH5UHsBffMNsAGJZMoYFL3QRtU6M9/Aes1MU3guvklQgZ
KILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfdhSi8MEyr48KxRURHH+CK
FgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj1jOXTyFj
HluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDr
y+K49a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ
/W3c1pzAtH2lsN0/Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgM
a/aOEmem8rJY5AIJEzypuxC00jBF8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6
fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
HQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQDAgGGMA0GCSqG
SIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi
7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqc
SE5XCV0vrPSltJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6Fza
ZsT0pPBWGTMpWmWSBUdGSquEwx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9Tc
XzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07QJNBAsNB1CI69aO4I1258EHBGG3zg
iLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv5wiZqAxeJoBF1Pho
L5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+GpzjLrF
Ne85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wr
kkVbbiVghUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+
vhV4nYWBSipX3tUZQ9rbyltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQU
YDksswBVLuT1sw5XxJFBAJw/6KXf6vb/yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ==
-----END CERTIFICATE-----
# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
# Label: "GlobalSign ECC Root CA - R4"
# Serial: 159662223612894884239637590694
# MD5 Fingerprint: 26:29:f8:6d:e1:88:bf:a2:65:7f:aa:c4:cd:0f:7f:fc
# SHA1 Fingerprint: 6b:a0:b0:98:e1:71:ef:5a:ad:fe:48:15:80:77:10:f4:bd:6f:0b:28
# SHA256 Fingerprint: b0:85:d7:0b:96:4f:19:1a:73:e4:af:0d:54:ae:7a:0e:07:aa:fd:af:9b:71:dd:08:62:13:8a:b7:32:5a:24:a2
-----BEGIN CERTIFICATE-----
MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYD
VQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2Jh
bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgw
MTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0g
UjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wWTAT
BgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkWymOx
uYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNV
HQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/
+wpu+74zyTyjhNUwCgYIKoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147
bmF0774BxL4YSFlhgjICICadVGNA3jdgUM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm
-----END CERTIFICATE-----
# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
# Subject: CN=GTS Root R1 O=Google Trust Services LLC
# Label: "GTS Root R1"
# Serial: 159662320309726417404178440727
# MD5 Fingerprint: 05:fe:d0:bf:71:a8:a3:76:63:da:01:e0:d8:52:dc:40
# SHA1 Fingerprint: e5:8c:1c:c4:91:3b:38:63:4b:e9:10:6e:e3:ad:8e:6b:9d:d9:81:4a
# SHA256 Fingerprint: d9:47:43:2a:bd:e7:b7:fa:90:fc:2e:6b:59:10:1b:12:80:e0:e1:c7:e4:e4:0f:a3:c6:88:7f:ff:57:a7:f4:cf
-----BEGIN CERTIFICATE-----
MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQsw
CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
MBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEBAQUA
A4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaMf/vo
27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7w
Cl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjw
TcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0Pfybl
qAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtcvfaH
szVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4Zor8
Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUspzBmk
MiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92
wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70p
aDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrN
VjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQID
AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
FgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBAJ+qQibb
C5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe
QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuy
h6f88/qBVRRiClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM4
7HLwEXWdyzRSjeZ2axfG34arJ45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8J
ZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYciNuaCp+0KueIHoI17eko8cdLiA6Ef
MgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5meLMFrUKTX5hgUvYU/
Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJFfbdT
6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ
0E6yove+7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm
2tIMPNuzjsmhDYAPexZ3FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bb
bP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3gm3c
-----END CERTIFICATE-----
# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
# Subject: CN=GTS Root R2 O=Google Trust Services LLC
# Label: "GTS Root R2"
# Serial: 159662449406622349769042896298
# MD5 Fingerprint: 1e:39:c0:53:e6:1e:29:82:0b:ca:52:55:36:5d:57:dc
# SHA1 Fingerprint: 9a:44:49:76:32:db:de:fa:d0:bc:fb:5a:7b:17:bd:9e:56:09:24:94
# SHA256 Fingerprint: 8d:25:cd:97:22:9d:bf:70:35:6b:da:4e:b3:cc:73:40:31:e2:4c:f0:0f:af:cf:d3:2d:c7:6e:b5:84:1c:7e:a8
-----BEGIN CERTIFICATE-----
MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQsw
CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
MBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUA
A4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3LvCvpt
nfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY
6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAu
MC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7k
RXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXuPuWg
f9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1mKPV
+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K8Yzo
dDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RW
Ir9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKa
G73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCq
gc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwID
AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
FgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBAB/Kzt3H
vqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8
0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyC
B19m3H0Q/gxhswWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2u
NmSRXbBoGOqKYcl3qJfEycel/FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMg
yALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVnjWQye+mew4K6Ki3pHrTgSAai/Gev
HyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y59PYjJbigapordwj6
xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M7YNR
TOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924Sg
JPFI/2R80L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV
7LXTWtiBmelDGDfrs7vRWGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl
6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjWHYbL
-----END CERTIFICATE-----
# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
# Subject: CN=GTS Root R3 O=Google Trust Services LLC
# Label: "GTS Root R3"
# Serial: 159662495401136852707857743206
# MD5 Fingerprint: 3e:e7:9d:58:02:94:46:51:94:e5:e0:22:4a:8b:e7:73
# SHA1 Fingerprint: ed:e5:71:80:2b:c8:92:b9:5b:83:3c:d2:32:68:3f:09:cd:a0:1e:46
# SHA256 Fingerprint: 34:d8:a7:3e:e2:08:d9:bc:db:0d:95:65:20:93:4b:4e:40:e6:94:82:59:6e:8b:6f:73:c8:42:6b:01:0a:6f:48
-----BEGIN CERTIFICATE-----
MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYD
VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
A1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
AAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout736G
jOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL2
4CejQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
BBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7
VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azTL818+FsuVbu/3ZL3pAzcMeGiAjEA/Jdm
ZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV11RZt+cRLInUue4X
-----END CERTIFICATE-----
# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
# Subject: CN=GTS Root R4 O=Google Trust Services LLC
# Label: "GTS Root R4"
# Serial: 159662532700760215368942768210
# MD5 Fingerprint: 43:96:83:77:19:4d:76:b3:9d:65:52:e4:1d:22:a5:e8
# SHA1 Fingerprint: 77:d3:03:67:b5:e0:0c:15:f6:0c:38:61:df:7c:e1:3b:92:46:4d:47
# SHA256 Fingerprint: 34:9d:fa:40:58:c5:e2:63:12:3b:39:8a:e7:95:57:3c:4e:13:13:c8:3f:e6:8f:93:55:6c:d5:e8:03:1b:3c:7d
-----BEGIN CERTIFICATE-----
MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYD
VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
A1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
AATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzuhXyi
QHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvR
HYqjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
BBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D
9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/Cr8deVl5c1RxYIigL9zC2L7F8AjEA8GE8
p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh4rsUecrNIdSUtUlD
-----END CERTIFICATE-----
# Issuer: CN=Telia Root CA v2 O=Telia Finland Oyj
# Subject: CN=Telia Root CA v2 O=Telia Finland Oyj
# Label: "Telia Root CA v2"
# Serial: 7288924052977061235122729490515358
# MD5 Fingerprint: 0e:8f:ac:aa:82:df:85:b1:f4:dc:10:1c:fc:99:d9:48
# SHA1 Fingerprint: b9:99:cd:d1:73:50:8a:c4:47:05:08:9c:8c:88:fb:be:a0:2b:40:cd
# SHA256 Fingerprint: 24:2b:69:74:2f:cb:1e:5b:2a:bf:98:89:8b:94:57:21:87:54:4e:5b:4d:99:11:78:65:73:62:1f:6a:74:b8:2c
-----BEGIN CERTIFICATE-----
MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQx
CzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UE
AwwQVGVsaWEgUm9vdCBDQSB2MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1
NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZ
MBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZIhvcNAQEBBQADggIP
ADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ76zBq
AMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9
vVYiQJ3q9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9
lRdU2HhE8Qx3FZLgmEKnpNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTOD
n3WhUidhOPFZPY5Q4L15POdslv5e2QJltI5c0BE0312/UqeBAMN/mUWZFdUXyApT
7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW5olWK8jjfN7j/4nlNW4o
6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNrRBH0pUPC
TEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6
WT0EBXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63R
DolUK5X6wK0dmBR4M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZI
pEYslOqodmJHixBTB0hXbOKSTbauBcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGj
YzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7Wxy+G2CQ5MB0GA1UdDgQWBBRy
rOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUw
AwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ
8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi
0f6X+J8wfBj5tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMM
A8iZGok1GTzTyVR8qPAs5m4HeW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBS
SRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+Cy748fdHif64W1lZYudogsYMVoe+K
TTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygCQMez2P2ccGrGKMOF
6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15h2Er
3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMt
Ty3EHD70sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pT
VmBds9hCG1xLEooc6+t9xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAW
ysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQraVplI/owd8k+BsHMYeB2F326CjYSlKA
rBPuUBQemMc=
-----END CERTIFICATE-----
# Issuer: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
# Subject: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
# Label: "D-TRUST BR Root CA 1 2020"
# Serial: 165870826978392376648679885835942448534
# MD5 Fingerprint: b5:aa:4b:d5:ed:f7:e3:55:2e:8f:72:0a:f3:75:b8:ed
# SHA1 Fingerprint: 1f:5b:98:f0:e3:b5:f7:74:3c:ed:e6:b0:36:7d:32:cd:f4:09:41:67
# SHA256 Fingerprint: e5:9a:aa:81:60:09:c2:2b:ff:5b:25:ba:d3:7d:f3:06:f0:49:79:7c:1f:81:d8:5a:b0:89:e6:57:bd:8f:00:44
-----BEGIN CERTIFICATE-----
MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQsw
CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
VVNUIEJSIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5
NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
A1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
BAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7dPYS
zuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0
QVK5buXuQqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/
VbNafAkl1bK6CKBrqx9tMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2JyX3Jvb3Rf
Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
dC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
PQQDAwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFW
wKrY7RjEsK70PvomAjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHV
dWNbFJWcHwHP2NVypw87
-----END CERTIFICATE-----
# Issuer: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
# Subject: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
# Label: "D-TRUST EV Root CA 1 2020"
# Serial: 126288379621884218666039612629459926992
# MD5 Fingerprint: 8c:2d:9d:70:9f:48:99:11:06:11:fb:e9:cb:30:c0:6e
# SHA1 Fingerprint: 61:db:8c:21:59:69:03:90:d8:7c:9c:12:86:54:cf:9d:3d:f4:dd:07
# SHA256 Fingerprint: 08:17:0d:1a:a3:64:53:90:1a:2f:95:92:45:e3:47:db:0c:8d:37:ab:aa:bc:56:b8:1a:a1:00:dc:95:89:70:db
-----BEGIN CERTIFICATE-----
MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQsw
CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
VVNUIEVWIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5
NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
A1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
BAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8ZRCC
/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rD
wpdhQntJraOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3
OqQo5FD4pPfsazK2/umLMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2V2X3Jvb3Rf
Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
dC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
PQQDAwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CA
y/m0sRtW9XLS/BnRAjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJb
gfM0agPnIjhQW+0ZT0MW
-----END CERTIFICATE-----
# Issuer: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
# Subject: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
# Label: "DigiCert TLS ECC P384 Root G5"
# Serial: 13129116028163249804115411775095713523
# MD5 Fingerprint: d3:71:04:6a:43:1c:db:a6:59:e1:a8:a3:aa:c5:71:ed
# SHA1 Fingerprint: 17:f3:de:5e:9f:0f:19:e9:8e:f6:1f:32:26:6e:20:c4:07:ae:30:ee
# SHA256 Fingerprint: 01:8e:13:f0:77:25:32:cf:80:9b:d1:b1:72:81:86:72:83:fc:48:c6:e1:3b:e9:c6:98:12:85:4a:49:0c:1b:05
-----BEGIN CERTIFICATE-----
MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQsw
CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURp
Z2lDZXJ0IFRMUyBFQ0MgUDM4NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2
MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ
bmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQgUm9vdCBHNTB2MBAG
ByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1TzvdlHJS
7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp
0zVozptjn4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICIS
B4CIfBFqMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49
BAMDA2gAMGUCMQCJao1H5+z8blUD2WdsJk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQ
LgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIxAJSdYsiJvRmEFOml+wG4
DXZDjC5Ty3zfDBeWUA==
-----END CERTIFICATE-----
# Issuer: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
# Subject: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
# Label: "DigiCert TLS RSA4096 Root G5"
# Serial: 11930366277458970227240571539258396554
# MD5 Fingerprint: ac:fe:f7:34:96:a9:f2:b3:b4:12:4b:e4:27:41:6f:e1
# SHA1 Fingerprint: a7:88:49:dc:5d:7c:75:8c:8c:de:39:98:56:b3:aa:d0:b2:a5:71:35
# SHA256 Fingerprint: 37:1a:00:dc:05:33:b3:72:1a:7e:eb:40:e8:41:9e:70:79:9d:2b:0a:0f:2c:1d:80:69:31:65:f7:ce:c4:ad:75
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBN
MQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMT
HERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcN
NDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQs
IEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS87IE+
ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG0
2C+JFvuUAT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgp
wgscONyfMXdcvyej/Cestyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZM
pG2T6T867jp8nVid9E6P/DsjyG244gXazOvswzH016cpVIDPRFtMbzCe88zdH5RD
nU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnVDdXifBBiqmvwPXbzP6Po
sMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9qTXeXAaDx
Zre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cd
Lvvyz6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvX
KyY//SovcfXWJL5/MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNe
XoVPzthwiHvOAbWWl9fNff2C+MIkwcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPL
tgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4EFgQUUTMc7TZArxfTJc1paPKv
TiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcN
AQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw
GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7H
PNtQOa27PShNlnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLF
O4uJ+DQtpBflF+aZfTCIITfNMBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQ
REtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/u4cnYiWB39yhL/btp/96j1EuMPik
AdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9GOUrYU9DzLjtxpdRv
/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh47a+
p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilw
MUc/dNAUFvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WF
qUITVuwhd4GTWgzqltlJyqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCK
ovfepEWFJqgejF0pW8hL2JpqA15w8oVPbEtoL8pU9ozaMv7Da4M/OMZ+
-----END CERTIFICATE-----
# Issuer: CN=Certainly Root R1 O=Certainly
# Subject: CN=Certainly Root R1 O=Certainly
# Label: "Certainly Root R1"
# Serial: 188833316161142517227353805653483829216
# MD5 Fingerprint: 07:70:d4:3e:82:87:a0:fa:33:36:13:f4:fa:33:e7:12
# SHA1 Fingerprint: a0:50:ee:0f:28:71:f4:27:b2:12:6d:6f:50:96:25:ba:cc:86:42:af
# SHA256 Fingerprint: 77:b8:2c:d8:64:4c:43:05:f7:ac:c5:cb:15:6b:45:67:50:04:03:3d:51:c6:0c:62:02:a8:e0:c3:34:67:d3:a0
-----BEGIN CERTIFICATE-----
MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAw
PTELMAkGA1UEBhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2Vy
dGFpbmx5IFJvb3QgUjEwHhcNMjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9
MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0
YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANA2
1B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O5MQT
vqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbed
aFySpvXl8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b0
1C7jcvk2xusVtyWMOvwlDbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5
r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGIXsXwClTNSaa/ApzSRKft43jvRl5tcdF5
cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkNKPl6I7ENPT2a/Z2B7yyQ
wHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQAjeZjOVJ
6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA
2CnbrlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyH
Wyf5QBGenDPBt+U1VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMR
eiFPCyEQtkA6qyI6BJyLm4SGcprSp6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB
/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTgqj8ljZ9EXME66C6u
d0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAszHQNTVfSVcOQr
PbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d
8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi
1wrykXprOQ4vMMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrd
rRT90+7iIgXr0PK3aBLXWopBGsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9di
taY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+gjwN/KUD+nsa2UUeYNrEjvn8K8l7
lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgHJBu6haEaBQmAupVj
yTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7fpYn
Kx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLy
yCwzk5Iwx06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5n
wXARPbv0+Em34yaXOp/SX3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6
OV+KmalBWQewLK8=
-----END CERTIFICATE-----
# Issuer: CN=Certainly Root E1 O=Certainly
# Subject: CN=Certainly Root E1 O=Certainly
# Label: "Certainly Root E1"
# Serial: 8168531406727139161245376702891150584
# MD5 Fingerprint: 0a:9e:ca:cd:3e:52:50:c6:36:f3:4b:a3:ed:a7:53:e9
# SHA1 Fingerprint: f9:e1:6d:dc:01:89:cf:d5:82:45:63:3e:c5:37:7d:c2:eb:93:6f:2b
# SHA256 Fingerprint: b4:58:5f:22:e4:ac:75:6a:4e:86:12:a1:36:1c:5d:9d:03:1a:93:fd:84:fe:bb:77:8f:a3:06:8b:0f:c4:2d:c2
-----BEGIN CERTIFICATE-----
MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQsw
CQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlu
bHkgUm9vdCBFMTAeFw0yMTA0MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJ
BgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlubHkxGjAYBgNVBAMTEUNlcnRhaW5s
eSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4fxzf7flHh4axpMCK
+IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9YBk2
QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8E
BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4
hevIIgcwCgYIKoZIzj0EAwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozm
ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG
BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
-----END CERTIFICATE-----
# Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
# Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
# Label: "Security Communication RootCA3"
# Serial: 16247922307909811815
# MD5 Fingerprint: 1c:9a:16:ff:9e:5c:e0:4d:8a:14:01:f4:35:5d:29:26
# SHA1 Fingerprint: c3:03:c8:22:74:92:e5:61:a2:9c:5f:79:91:2b:1e:44:13:91:30:3a
# SHA256 Fingerprint: 24:a5:5c:2a:b0:51:44:2d:06:17:76:65:41:23:9a:4a:d0:32:d7:c5:51:75:aa:34:ff:de:2f:bc:4f:5c:52:94
-----BEGIN CERTIFICATE-----
MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNV
BAYTAkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScw
JQYDVQQDEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2
MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc
U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UEAxMeU2VjdXJpdHkg
Q29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4r
CmDvu20rhvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzA
lrenfna84xtSGc4RHwsENPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MG
TfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2/D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF7
9+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGmnpjKIG58u4iFW/vAEGK7
8vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtYXLVqAvO4
g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3we
GVPKp7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst
+3A7caoreyYn8xrC3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M
0V9hvqG8OmpI6iZVIhZdXw3/JzOfGAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQ
T9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0VcwCBEF/VfR2ccCAwEAAaNCMEAw
HQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB/wQEAwIBBjAP
BgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS
YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PA
FNr0Y/Dq9HHuTofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd
9XbXv8S2gVj/yP9kaWJ5rW4OH3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQI
UYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASxYfQAW0q3nHE3GYV5v4GwxxMOdnE+
OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZXSEIx2C/pHF7uNke
gr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml+LLf
iAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUV
nuiZIesnKwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD
2NCcnWXL0CsnMQMeNuE9dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI//
1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm6Vwdp6POXiUyK+OVrCoHzrQoeIY8Laad
TdJ0MN1kURXbg4NR16/9M51NZg==
-----END CERTIFICATE-----
# Issuer: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
# Subject: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
# Label: "Security Communication ECC RootCA1"
# Serial: 15446673492073852651
# MD5 Fingerprint: 7e:43:b0:92:68:ec:05:43:4c:98:ab:5d:35:2e:7e:86
# SHA1 Fingerprint: b8:0e:26:a9:bf:d2:b2:3b:c0:ef:46:c9:ba:c7:bb:f6:1d:0d:41:41
# SHA256 Fingerprint: e7:4f:bd:a5:5b:d5:64:c4:73:a3:6b:44:1a:a7:99:c8:a6:8e:07:74:40:e8:28:8b:9f:a1:e5:0e:4b:ba:ca:11
-----BEGIN CERTIFICATE-----
MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYT
AkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYD
VQQDEyJTZWN1cml0eSBDb21tdW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYx
NjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTELMAkGA1UEBhMCSlAxJTAjBgNVBAoT
HFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNVBAMTIlNlY3VyaXR5
IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
AASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+Cnnfdl
dB9sELLo5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpK
ULGjQjBAMB0GA1UdDgQWBBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8E
BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu
9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3LsnNdo4gIxwwCMQDAqy0O
be0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70eN9k=
-----END CERTIFICATE-----
# Issuer: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
# Subject: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
# Label: "BJCA Global Root CA1"
# Serial: 113562791157148395269083148143378328608
# MD5 Fingerprint: 42:32:99:76:43:33:36:24:35:07:82:9b:28:f9:d0:90
# SHA1 Fingerprint: d5:ec:8d:7b:4c:ba:79:f4:e7:e8:cb:9d:6b:ae:77:83:10:03:21:6a
# SHA256 Fingerprint: f3:89:6f:88:fe:7c:0a:88:27:66:a7:fa:6a:d2:74:9f:b5:7a:7f:3e:98:fb:76:9c:1f:a7:b0:9c:2c:44:d5:ae
-----BEGIN CERTIFICATE-----
MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBU
MQswCQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRI
T1JJVFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAz
MTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJF
SUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2Jh
bCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFmCL3Z
xRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZ
spDyRhySsTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O5
58dnJCNPYwpj9mZ9S1WnP3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgR
at7GGPZHOiJBhyL8xIkoVNiMpTAK+BcWyqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll
5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRjeulumijWML3mG90Vr4Tq
nMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNnMoH1V6XK
V0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/
pj+bOT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZO
z2nxbkRs1CTqjSShGL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXn
jSXWgXSHRtQpdaJCbPdzied9v3pKH9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+
WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMBAAGjQjBAMB0GA1UdDgQWBBTF
7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQE
AwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4
YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3Kli
awLwQ8hOnThJdMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u
+2D2/VnGKhs/I0qUJDAnyIm860Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88
X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuhTaRjAv04l5U/BXCga99igUOLtFkN
SoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW4AB+dAb/OMRyHdOo
P2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmpGQrI
+pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRz
znfSxqxx4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9
eVzYH6Eze9mCUAyTF6ps3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2
YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4SSPfSKcOYKMryMguTjClPPGAyzQWWYezy
r/6zcCwupvI=
-----END CERTIFICATE-----
# Issuer: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
# Subject: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
# Label: "BJCA Global Root CA2"
# Serial: 58605626836079930195615843123109055211
# MD5 Fingerprint: 5e:0a:f6:47:5f:a6:14:e8:11:01:95:3f:4d:01:eb:3c
# SHA1 Fingerprint: f4:27:86:eb:6e:b8:6d:88:31:67:02:fb:ba:66:a4:53:00:aa:7a:a6
# SHA256 Fingerprint: 57:4d:f6:93:1e:27:80:39:66:7b:72:0a:fd:c1:60:0f:c2:7e:b6:6d:d3:09:29:79:fb:73:85:64:87:21:28:82
-----BEGIN CERTIFICATE-----
MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQsw
CQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJ
VFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgy
MVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJ
TkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2JhbCBS
b290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jlSR9B
IgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK+
+kpRuDCK/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJK
sVF/BvDRgh9Obl+rg/xI1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
AgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA
94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8gUXOQwKhbYdDFUDn9hf7B
43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w==
-----END CERTIFICATE-----
# Issuer: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
# Subject: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
# Label: "Sectigo Public Server Authentication Root E46"
# Serial: 88989738453351742415770396670917916916
# MD5 Fingerprint: 28:23:f8:b2:98:5c:37:16:3b:3e:46:13:4e:b0:b3:01
# SHA1 Fingerprint: ec:8a:39:6c:40:f0:2e:bc:42:75:d4:9f:ab:1c:1a:5b:67:be:d2:9a
# SHA256 Fingerprint: c9:0f:26:f0:fb:1b:40:18:b2:22:27:51:9b:5c:a2:b5:3e:2c:a5:b3:be:5c:f1:8e:fe:1b:ef:47:38:0c:53:83
-----BEGIN CERTIFICATE-----
MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQsw
CQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T
ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcN
MjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYG
A1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT
ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
IgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccC
WvkEN/U0NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+
6xnOQ6OjQjBAMB0GA1UdDgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8B
Af8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNnADBkAjAn7qRa
qCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RHlAFWovgzJQxC36oCMB3q
4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21USAGKcw==
-----END CERTIFICATE-----
# Issuer: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
# Subject: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
# Label: "Sectigo Public Server Authentication Root R46"
# Serial: 156256931880233212765902055439220583700
# MD5 Fingerprint: 32:10:09:52:00:d5:7e:6c:43:df:15:c0:b1:16:93:e5
# SHA1 Fingerprint: ad:98:f9:f3:e4:7d:75:3b:65:d4:82:b3:a4:52:17:bb:6e:f5:e4:38
# SHA256 Fingerprint: 7b:b6:47:a6:2a:ee:ac:88:bf:25:7a:a5:22:d0:1f:fe:a3:95:e0:ab:45:c7:3f:93:f6:56:54:ec:38:f2:5a:06
-----BEGIN CERTIFICATE-----
MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBf
MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQD
Ey1TZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYw
HhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEY
MBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1Ymxp
YyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
AQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDa
ef0rty2k1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnz
SDBh+oF8HqcIStw+KxwfGExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xf
iOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMPFF1bFOdLvt30yNoDN9HWOaEhUTCDsG3X
ME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vuZDCQOc2TZYEhMbUjUDM3
IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5QazYw6A3OAS
VYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgE
SJ/AwSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu
+Zd4KKTIRJLpfSYFplhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt
8uaZFURww3y8nDnAtOFr94MlI1fZEoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+L
HaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW6aWWrL3DkJiy4Pmi1KZHQ3xt
zwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWIIUkwDgYDVR0P
AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c
mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQ
YKlJfp/imTYpE0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52
gDY9hAaLMyZlbcp+nv4fjFg4exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZA
Fv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M0ejf5lG5Nkc/kLnHvALcWxxPDkjB
JYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI84HxZmduTILA7rpX
DhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9mpFui
TdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5
dHn5HrwdVw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65
LvKRRFHQV80MNNVIIb/bE/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp
0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmmJ1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAY
QqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL
-----END CERTIFICATE-----
# Issuer: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
# Subject: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
# Label: "SSL.com TLS RSA Root CA 2022"
# Serial: 148535279242832292258835760425842727825
# MD5 Fingerprint: d8:4e:c6:59:30:d8:fe:a0:d6:7a:5a:2c:2c:69:78:da
# SHA1 Fingerprint: ec:2c:83:40:72:af:26:95:10:ff:0e:f2:03:ee:31:70:f6:78:9d:ca
# SHA256 Fingerprint: 8f:af:7d:2e:2c:b4:70:9b:b8:e0:b3:36:66:bf:75:a5:dd:45:b5:de:48:0f:8e:a8:d4:bf:e6:be:bc:17:f2:ed
-----BEGIN CERTIFICATE-----
MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBO
MQswCQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQD
DBxTU0wuY29tIFRMUyBSU0EgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloX
DTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jw
b3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJvb3QgQ0EgMjAyMjCC
AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u9nTP
L3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OY
t6/wNr/y7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0ins
S657Lb85/bRi3pZ7QcacoOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3
PnxEX4MN8/HdIGkWCVDi1FW24IBydm5MR7d1VVm0U3TZlMZBrViKMWYPHqIbKUBO
L9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDGD6C1vBdOSHtRwvzpXGk3
R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEWTO6Af77w
dr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS
+YCk8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYS
d66UNHsef8JmAOSqg+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoG
AtUjHBPW6dvbxrB6y3snm/vg1UYk7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2f
gTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
BBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsuN+7jhHonLs0Z
NbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt
hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsM
QtfhWsSWTVTNj8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvf
R4iyrT7gJ4eLSYwfqUdYe5byiB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJ
DPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjUo3KUQyxi4U5cMj29TH0ZR6LDSeeW
P4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqoENjwuSfr98t67wVy
lrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7EgkaibMOlq
bLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2w
AgDHbICivRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3q
r5nsLFR+jM4uElZI7xc7P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sji
Mho6/4UIyYOf8kpIEFR3N+2ivEC+5BB09+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU
98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA=
-----END CERTIFICATE-----
# Issuer: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
# Subject: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
# Label: "SSL.com TLS ECC Root CA 2022"
# Serial: 26605119622390491762507526719404364228
# MD5 Fingerprint: 99:d7:5c:f1:51:36:cc:e9:ce:d9:19:2e:77:71:56:c5
# SHA1 Fingerprint: 9f:5f:d9:1a:54:6d:f5:0c:71:f0:ee:7a:bd:17:49:98:84:73:e2:39
# SHA256 Fingerprint: c3:2f:fd:9f:46:f9:36:d1:6c:36:73:99:09:59:43:4b:9a:d6:0a:af:bb:9e:7c:f3:36:54:f1:44:cc:1b:a1:43
-----BEGIN CERTIFICATE-----
MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQsw
CQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxT
U0wuY29tIFRMUyBFQ0MgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2
MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3Jh
dGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3QgQ0EgMjAyMjB2MBAG
ByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWyJGYm
acCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFN
SeR7T5v15wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSME
GDAWgBSJjy+j6CugFFR781a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NW
uCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp
15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w7deedWo1dlJF4AIxAMeN
b0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5Zn6g6g==
-----END CERTIFICATE-----
# Issuer: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
# Subject: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
# Label: "Atos TrustedRoot Root CA ECC TLS 2021"
# Serial: 81873346711060652204712539181482831616
# MD5 Fingerprint: 16:9f:ad:f1:70:ad:79:d6:ed:29:b4:d1:c5:79:70:a8
# SHA1 Fingerprint: 9e:bc:75:10:42:b3:02:f3:81:f4:f7:30:62:d4:8f:c3:a7:51:b2:dd
# SHA256 Fingerprint: b2:fa:e5:3e:14:cc:d7:ab:92:12:06:47:01:ae:27:9c:1d:89:88:fa:cb:77:5f:a8:a0:08:91:4e:66:39:88:a8
-----BEGIN CERTIFICATE-----
MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4w
LAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0w
CwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0
MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBF
Q0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMHYwEAYHKoZI
zj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6KDP/X
tXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4
AjJn8ZQSb+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2
KCXWfeBmmnoJsmo7jjPXNtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMD
aAAwZQIwW5kp85wxtolrbNa9d+F851F+uDrNozZffPc8dz7kUK2o59JZDCaOMDtu
CCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGYa3cpetskz2VAv9LcjBHo
9H1/IISpQuQo
-----END CERTIFICATE-----
# Issuer: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
# Subject: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
# Label: "Atos TrustedRoot Root CA RSA TLS 2021"
# Serial: 111436099570196163832749341232207667876
# MD5 Fingerprint: d4:d3:46:b8:9a:c0:9c:76:5d:9e:3a:c3:b9:99:31:d2
# SHA1 Fingerprint: 18:52:3b:0d:06:37:e4:d6:3a:df:23:e4:98:fb:5b:16:fb:86:74:48
# SHA256 Fingerprint: 81:a9:08:8e:a5:9f:b3:64:c5:48:a6:f8:55:59:09:9b:6f:04:05:ef:bf:18:e5:32:4e:c9:f4:57:ba:00:11:2f
-----BEGIN CERTIFICATE-----
MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBM
MS4wLAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIx
MQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00
MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBD
QSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMIICIjAN
BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BBl01Z
4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYv
Ye+W/CBGvevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZ
kmGbzSoXfduP9LVq6hdKZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDs
GY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt0xU6kGpn8bRrZtkh68rZYnxGEFzedUln
nkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVKPNe0OwANwI8f4UDErmwh
3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMYsluMWuPD
0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzy
geBYBr3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8
ANSbhqRAvNncTFd+rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezB
c6eUWsuSZIKmAMFwoW4sKeFYV+xafJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lI
pw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
dEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB
DAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS
4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPs
o0UvFJ/1TCplQ3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJ
qM7F78PRreBrAwA0JrRUITWXAdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuyw
xfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9GslA9hGCZcbUztVdF5kJHdWoOsAgM
rr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2VktafcxBPTy+av5EzH4
AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9qTFsR
0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuY
o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5
dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE
oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ==
-----END CERTIFICATE-----
# Issuer: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
# Subject: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
# Label: "TrustAsia Global Root CA G3"
# Serial: 576386314500428537169965010905813481816650257167
# MD5 Fingerprint: 30:42:1b:b7:bb:81:75:35:e4:16:4f:53:d2:94:de:04
# SHA1 Fingerprint: 63:cf:b6:c1:27:2b:56:e4:88:8e:1c:23:9a:b6:2e:81:47:24:c3:c7
# SHA256 Fingerprint: e0:d3:22:6a:eb:11:63:c2:e4:8f:f9:be:3b:50:b4:c6:43:1b:e7:bb:1e:ac:c5:c3:6b:5d:5e:c5:09:03:9a:08
-----BEGIN CERTIFICATE-----
MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEM
BQAwWjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dp
ZXMsIEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAe
Fw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEwMTlaMFoxCzAJBgNVBAYTAkNOMSUw
IwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtU
cnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUAA4IC
DwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNS
T1QY4SxzlZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqK
AtCWHwDNBSHvBm3dIZwZQ0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1
nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/VP68czH5GX6zfZBCK70bwkPAPLfSIC7Ep
qq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1AgdB4SQXMeJNnKziyhWTXA
yB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm9WAPzJMs
hH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gX
zhqcD0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAv
kV34PmVACxmZySYgWmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msT
f9FkPz2ccEblooV7WIQn3MSAPmeamseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jA
uPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCFTIcQcf+eQxuulXUtgQIDAQAB
o2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj7zjKsK5Xf/Ih
MBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E
BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4
wM8zAQLpw6o1D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2
XFNFV1pF1AWZLy4jVe5jaN/TG3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1
JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNjduMNhXJEIlU/HHzp/LgV6FL6qj6j
ITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstlcHboCoWASzY9M/eV
VHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys+TIx
xHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1on
AX1daBli2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d
7XB4tmBZrOFdRWOPyN9yaFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2Ntjj
gKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsASZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV
+Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFRJQJ6+N1rZdVtTTDIZbpo
FGWsJwt0ivKH
-----END CERTIFICATE-----
# Issuer: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
# Subject: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
# Label: "TrustAsia Global Root CA G4"
# Serial: 451799571007117016466790293371524403291602933463
# MD5 Fingerprint: 54:dd:b2:d7:5f:d8:3e:ed:7c:e0:0b:2e:cc:ed:eb:eb
# SHA1 Fingerprint: 57:73:a5:61:5d:80:b2:e6:ac:38:82:fc:68:07:31:ac:9f:b5:92:5a
# SHA256 Fingerprint: be:4b:56:cb:50:56:c0:13:6a:52:6d:f4:44:50:8d:aa:36:a0:b5:4f:42:e4:ac:38:f7:2a:f4:70:e4:79:65:4c
-----BEGIN CERTIFICATE-----
MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMw
WjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMs
IEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0y
MTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJaMFoxCzAJBgNVBAYTAkNOMSUwIwYD
VQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtUcnVz
dEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATx
s8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbw
LxYI+hW8m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJij
YzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mD
pm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/pDHel4NZg6ZvccveMA4GA1UdDwEB/wQE
AwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AAbbd+NvBNEU/zy4k6LHiR
UKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xkdUfFVZDj
/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA==
-----END CERTIFICATE-----
# Issuer: CN=CommScope Public Trust ECC Root-01 O=CommScope
# Subject: CN=CommScope Public Trust ECC Root-01 O=CommScope
# Label: "CommScope Public Trust ECC Root-01"
# Serial: 385011430473757362783587124273108818652468453534
# MD5 Fingerprint: 3a:40:a7:fc:03:8c:9c:38:79:2f:3a:a2:6c:b6:0a:16
# SHA1 Fingerprint: 07:86:c0:d8:dd:8e:c0:80:98:06:98:d0:58:7a:ef:de:a6:cc:a2:5d
# SHA256 Fingerprint: 11:43:7c:da:7b:b4:5e:41:36:5f:45:b3:9a:38:98:6b:0d:e0:0d:ef:34:8e:0c:7b:b0:87:36:33:80:0b:c3:8b
-----BEGIN CERTIFICATE-----
MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMw
TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNa
Fw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDEw
djAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLxeP0C
flfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJE
hRGnSjot6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggq
hkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg
2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liWpDVfG2XqYZpwI7UNo5uS
Um9poIyNStDuiw7LR47QjRE=
-----END CERTIFICATE-----
# Issuer: CN=CommScope Public Trust ECC Root-02 O=CommScope
# Subject: CN=CommScope Public Trust ECC Root-02 O=CommScope
# Label: "CommScope Public Trust ECC Root-02"
# Serial: 234015080301808452132356021271193974922492992893
# MD5 Fingerprint: 59:b0:44:d5:65:4d:b8:5c:55:19:92:02:b6:d1:94:b2
# SHA1 Fingerprint: 3c:3f:ef:57:0f:fe:65:93:86:9e:a0:fe:b0:f6:ed:8e:d1:13:c7:e5
# SHA256 Fingerprint: 2f:fb:7f:81:3b:bb:b3:c8:9a:b4:e8:16:2d:0f:16:d7:15:09:a8:30:cc:9d:73:c2:62:e5:14:08:75:d1:ad:4a
-----BEGIN CERTIFICATE-----
MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMw
TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRa
Fw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDIw
djAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/MMDAL
j2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmU
v4RDsNuESgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggq
hkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/n
ich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs73u1Z/GtMMH9ZzkXpc2AV
mkzw5l4lIhVtwodZ0LKOag==
-----END CERTIFICATE-----
# Issuer: CN=CommScope Public Trust RSA Root-01 O=CommScope
# Subject: CN=CommScope Public Trust RSA Root-01 O=CommScope
# Label: "CommScope Public Trust RSA Root-01"
# Serial: 354030733275608256394402989253558293562031411421
# MD5 Fingerprint: 0e:b4:15:bc:87:63:5d:5d:02:73:d4:26:38:68:73:d8
# SHA1 Fingerprint: 6d:0a:5f:f7:b4:23:06:b4:85:b3:b7:97:64:fc:ac:75:f5:33:f2:93
# SHA256 Fingerprint: 02:bd:f9:6e:2a:45:dd:9b:f1:8f:c7:e1:db:df:21:a0:37:9b:a3:c9:c2:61:03:44:cf:d8:d6:06:fe:c1:ed:81
-----BEGIN CERTIFICATE-----
MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQEL
BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1
NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
MDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45FtnYSk
YZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslh
suitQDy6uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0al
DrJLpA6lfO741GIDuZNqihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3Oj
WiE260f6GBfZumbCk6SP/F2krfxQapWsvCQz0b2If4b19bJzKo98rwjyGpg/qYFl
P8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/cZip8UlF1y5mO6D1cv547
KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTifBSeolz7p
UcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/
kQO9lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JO
Hg9O5j9ZpSPcPYeoKFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkB
Ea801M/XrmLTBQe0MXXgDW1XT2mH+VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6U
CBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm45P3luG0wDQYJ
KoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6
NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQ
nmhUQo8mUuJM3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+
QgvfKNmwrZggvkN80V4aCRckjXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2v
trV0KnahP/t1MJ+UXjulYPPLXAziDslg+MkfFoom3ecnf+slpoq9uC02EJqxWE2a
aE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/WNyVntHKLr4W96ioD
j8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+o/E4
Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0w
lREQKC6/oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHn
YfkUyq+Dj7+vsQpZXdxc1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVoc
icCMb3SgazNNtQEo/a2tiRc7ppqEvOuM6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw
-----END CERTIFICATE-----
# Issuer: CN=CommScope Public Trust RSA Root-02 O=CommScope
# Subject: CN=CommScope Public Trust RSA Root-02 O=CommScope
# Label: "CommScope Public Trust RSA Root-02"
# Serial: 480062499834624527752716769107743131258796508494
# MD5 Fingerprint: e1:29:f9:62:7b:76:e2:96:6d:f3:d4:d7:0f:ae:1f:aa
# SHA1 Fingerprint: ea:b0:e2:52:1b:89:93:4c:11:68:f2:d8:9a:ac:22:4c:a3:8a:57:ae
# SHA256 Fingerprint: ff:e9:43:d7:93:42:4b:4f:7c:44:0c:1c:3d:64:8d:53:63:f3:4b:82:dc:87:aa:7a:9f:11:8f:c5:de:e1:01:f1
-----BEGIN CERTIFICATE-----
MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQEL
BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2
NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
MDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3VrCLE
NQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0
kyI9p+Kx7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1C
rWDaSWqVcN3SAOLMV2MCe5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxz
hkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2WWy09X6GDRl224yW4fKcZgBzqZUPckXk2
LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rpM9kzXzehxfCrPfp4sOcs
n/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIfhs1w/tku
FT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5
kQMreyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3
wNemKfrb3vOTlycEVS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6v
wQcQeKwRoi9C8DfF8rhW3Q5iLc4tVn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs
5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7GxcJXvYXowDQYJ
KoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB
KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3
+VGXu6TwYofF1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbyme
APnCKfWxkxlSaRosTKCL4BWaMS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3Nyq
pgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xdgSGn2rtO/+YHqP65DSdsu3BaVXoT
6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2OHG1QAk8mGEPej1WF
sQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+NmYWvt
PjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2d
lklyALKrdVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670
v64fG9PiO/yzcnMcmyiQiRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17O
rg3bhzjlP1v9mxnhMUF6cKojawHhRUzNlM47ni3niAIi9G7oyOzWPPO5std3eqx7
-----END CERTIFICATE-----
# Issuer: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
# Subject: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
# Label: "Telekom Security TLS ECC Root 2020"
# Serial: 72082518505882327255703894282316633856
# MD5 Fingerprint: c1:ab:fe:6a:10:2c:03:8d:bc:1c:22:32:c0:85:a7:fd
# SHA1 Fingerprint: c0:f8:96:c5:a9:3b:01:06:21:07:da:18:42:48:bc:e9:9d:88:d5:ec
# SHA256 Fingerprint: 57:8a:f4:de:d0:85:3f:4e:59:98:db:4a:ea:f9:cb:ea:8d:94:5f:60:b6:20:a3:8d:1a:3c:13:b2:bc:7b:a8:e1
-----BEGIN CERTIFICATE-----
MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQsw
CQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBH
bWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIw
MB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIzNTk1OVowYzELMAkGA1UEBhMCREUx
JzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkGA1UE
AwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqGSM49
AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/O
tdKPD/M12kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDP
f8iAC8GXs7s1J8nCG6NCMEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6f
MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2cA
MGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZMo7k+5Dck2TOrbRBR2Di
z6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdUga/sf+Rn
27iQ7t0l
-----END CERTIFICATE-----
# Issuer: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
# Subject: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
# Label: "Telekom Security TLS RSA Root 2023"
# Serial: 44676229530606711399881795178081572759
# MD5 Fingerprint: bf:5b:eb:54:40:cd:48:71:c4:20:8d:7d:de:0a:42:f2
# SHA1 Fingerprint: 54:d3:ac:b3:bd:57:56:f6:85:9d:ce:e5:c3:21:e2:d4:ad:83:d0:93
# SHA256 Fingerprint: ef:c6:5c:ad:bb:59:ad:b6:ef:e8:4d:a2:23:11:b3:56:24:b7:1b:3b:1e:a0:da:8b:66:55:17:4e:c8:97:86:46
-----BEGIN CERTIFICATE-----
MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBj
MQswCQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0
eSBHbWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAy
MDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMyNzIzNTk1OVowYzELMAkGA1UEBhMC
REUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkG
A1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9
cUD/h3VCKSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHV
cp6R+SPWcHu79ZvB7JPPGeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMA
U6DksquDOFczJZSfvkgdmOGjup5czQRxUX11eKvzWarE4GC+j4NSuHUaQTXtvPM6
Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWol8hHD/BeEIvnHRz+sTug
BTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9FIS3R/qy
8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73J
co4vzLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg
8qKrBC7m8kwOFjQgrIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8
rFEz0ciD0cmfHdRHNCk+y7AO+oMLKFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12
mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7SWWO/gLCMk3PLNaaZlSJhZQNg
+y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtqeX
gj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2
p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQ
pGv7qHBFfLp+sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm
9S3ul0A8Yute1hTWjOKWi0FpkzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErw
M807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy/SKE8YXJN3nptT+/XOR0so8RYgDd
GGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4mZqTuXNnQkYRIer+
CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtzaL1t
xKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+
w6jv/naaoqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aK
L4x35bcF7DvB7L6Gs4a8wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+lj
X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q
ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm
dTdmQRCsu/WU48IxK63nI1bMNSWSs1A=
-----END CERTIFICATE-----
# Issuer: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA
# Subject: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA
# Label: "FIRMAPROFESIONAL CA ROOT-A WEB"
# Serial: 65916896770016886708751106294915943533
# MD5 Fingerprint: 82:b2:ad:45:00:82:b0:66:63:f8:5f:c3:67:4e:ce:a3
# SHA1 Fingerprint: a8:31:11:74:a6:14:15:0d:ca:77:dd:0e:e4:0c:5d:58:fc:a0:72:a5
# SHA256 Fingerprint: be:f2:56:da:f2:6e:9c:69:bd:ec:16:02:35:97:98:f3:ca:f7:18:21:a0:3e:01:82:57:c5:3c:65:61:7f:3d:4a
-----BEGIN CERTIFICATE-----
MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
IFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2WhcNNDcwMzMxMDkwMTM2WjBuMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
IFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zf
e9MEkVz6iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6C
cyvHZpsKjECcfIr28jlgst7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB
/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FDY1w8ndYn81LsF7Kpryz3dvgwHQYDVR0O
BBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjO
PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw
hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG
XSaQpYXFuXqUPoeovQA=
-----END CERTIFICATE-----
# Issuer: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA
# Subject: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA
# Label: "TWCA CYBER Root CA"
# Serial: 85076849864375384482682434040119489222
# MD5 Fingerprint: 0b:33:a0:97:52:95:d4:a9:fd:bb:db:6e:a3:55:5b:51
# SHA1 Fingerprint: f6:b1:1c:1a:83:38:e9:7b:db:b3:a8:c8:33:24:e0:2d:9c:7f:26:66
# SHA256 Fingerprint: 3f:63:bb:28:14:be:17:4e:c8:b6:43:9c:f0:8d:6d:56:f0:b7:c4:05:88:3a:56:48:a3:34:42:4d:6b:3e:c5:58
-----BEGIN CERTIFICATE-----
MIIFjTCCA3WgAwIBAgIQQAE0jMIAAAAAAAAAATzyxjANBgkqhkiG9w0BAQwFADBQ
MQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290
IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3QgQ0EwHhcNMjIxMTIyMDY1NDI5
WhcNNDcxMTIyMTU1OTU5WjBQMQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FO
LUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3Qg
Q0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDG+Moe2Qkgfh1sTs6P
40czRJzHyWmqOlt47nDSkvgEs1JSHWdyKKHfi12VCv7qze33Kc7wb3+szT3vsxxF
avcokPFhV8UMxKNQXd7UtcsZyoC5dc4pztKFIuwCY8xEMCDa6pFbVuYdHNWdZsc/
34bKS1PE2Y2yHer43CdTo0fhYcx9tbD47nORxc5zb87uEB8aBs/pJ2DFTxnk684i
JkXXYJndzk834H/nY62wuFm40AZoNWDTNq5xQwTxaWV4fPMf88oon1oglWa0zbfu
j3ikRRjpJi+NmykosaS3Om251Bw4ckVYsV7r8Cibt4LK/c/WMw+f+5eesRycnupf
Xtuq3VTpMCEobY5583WSjCb+3MX2w7DfRFlDo7YDKPYIMKoNM+HvnKkHIuNZW0CP
2oi3aQiotyMuRAlZN1vH4xfyIutuOVLF3lSnmMlLIJXcRolftBL5hSmO68gnFSDA
S9TMfAxsNAwmmyYxpjyn9tnQS6Jk/zuZQXLB4HCX8SS7K8R0IrGsayIyJNN4KsDA
oS/xUgXJP+92ZuJF2A09rZXIx4kmyA+upwMu+8Ff+iDhcK2wZSA3M2Cw1a/XDBzC
kHDXShi8fgGwsOsVHkQGzaRP6AzRwyAQ4VRlnrZR0Bp2a0JaWHY06rc3Ga4udfmW
5cFZ95RXKSWNOkyrTZpB0F8mAwIDAQABo2MwYTAOBgNVHQ8BAf8EBAMCAQYwDwYD
VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSdhWEUfMFib5do5E83QOGt4A1WNzAd
BgNVHQ4EFgQUnYVhFHzBYm+XaORPN0DhreANVjcwDQYJKoZIhvcNAQEMBQADggIB
AGSPesRiDrWIzLjHhg6hShbNcAu3p4ULs3a2D6f/CIsLJc+o1IN1KriWiLb73y0t
tGlTITVX1olNc79pj3CjYcya2x6a4CD4bLubIp1dhDGaLIrdaqHXKGnK/nZVekZn
68xDiBaiA9a5F/gZbG0jAn/xX9AKKSM70aoK7akXJlQKTcKlTfjF/biBzysseKNn
TKkHmvPfXvt89YnNdJdhEGoHK4Fa0o635yDRIG4kqIQnoVesqlVYL9zZyvpoBJ7t
RCT5dEA7IzOrg1oYJkK2bVS1FmAwbLGg+LhBoF1JSdJlBTrq/p1hvIbZv97Tujqx
f36SNI7JAG7cmL3c7IAFrQI932XtCwP39xaEBDG6k5TY8hL4iuO/Qq+n1M0RFxbI
Qh0UqEL20kCGoE8jypZFVmAGzbdVAaYBlGX+bgUJurSkquLvWL69J1bY73NxW0Qz
8ppy6rBePm6pUlvscG21h483XjyMnM7k8M4MZ0HMzvaAq07MTFb1wWFZk7Q+ptq4
NxKfKjLji7gh7MMrZQzvIt6IKTtM1/r+t+FHvpw+PoP7UV31aPcuIYXcv/Fa4nzX
xeSDwWrruoBa3lwtcHb4yOWHh8qgnaHlIhInD0Q9HWzq1MKLL295q39QpsQZp6F6
t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X
-----END CERTIFICATE-----
# Issuer: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd.
# Subject: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd.
# Label: "SecureSign Root CA12"
# Serial: 587887345431707215246142177076162061960426065942
# MD5 Fingerprint: c6:89:ca:64:42:9b:62:08:49:0b:1e:7f:e9:07:3d:e8
# SHA1 Fingerprint: 7a:22:1e:3d:de:1b:06:ac:9e:c8:47:70:16:8e:3c:e5:f7:6b:06:f4
# SHA256 Fingerprint: 3f:03:4b:b5:70:4d:44:b2:d0:85:45:a0:20:57:de:93:eb:f3:90:5f:ce:72:1a:cb:c7:30:c0:6d:da:ee:90:4e
-----BEGIN CERTIFICATE-----
MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQEL
BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u
LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgw
NTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD
eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS
b290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3emhF
KxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mt
p7JIKwccJ/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zd
J1M3s6oYwlkm7Fsf0uZlfO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gur
FzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBFEaCeVESE99g2zvVQR9wsMJvuwPWW0v4J
hscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1UefNzFJM3IFTQy2VYzxV4+K
h9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
AgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsF
AAOCAQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6Ld
mmQOmFxv3Y67ilQiLUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJ
mBClnW8Zt7vPemVV2zfrPIpyMpcemik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA
8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPSvWKErI4cqc1avTc7bgoitPQV
55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhgaaaI5gdka9at/
yOPiZwud9AzqVN/Ssq+xIvEg37xEHA==
-----END CERTIFICATE-----
# Issuer: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd.
# Subject: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd.
# Label: "SecureSign Root CA14"
# Serial: 575790784512929437950770173562378038616896959179
# MD5 Fingerprint: 71:0d:72:fa:92:19:65:5e:89:04:ac:16:33:f0:bc:d5
# SHA1 Fingerprint: dd:50:c0:f7:79:b3:64:2e:74:a2:b8:9d:9f:d3:40:dd:bb:f0:f2:4f
# SHA256 Fingerprint: 4b:00:9c:10:34:49:4f:9a:b5:6b:ba:3b:a1:d6:27:31:fc:4d:20:d8:95:5a:dc:ec:10:a9:25:60:72:61:e3:38
-----BEGIN CERTIFICATE-----
MIIFcjCCA1qgAwIBAgIUZNtaDCBO6Ncpd8hQJ6JaJ90t8sswDQYJKoZIhvcNAQEM
BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u
LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNDAeFw0yMDA0MDgw
NzA2MTlaFw00NTA0MDgwNzA2MTlaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD
eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS
b290IENBMTQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDF0nqh1oq/
FjHQmNE6lPxauG4iwWL3pwon71D2LrGeaBLwbCRjOfHw3xDG3rdSINVSW0KZnvOg
vlIfX8xnbacuUKLBl422+JX1sLrcneC+y9/3OPJH9aaakpUqYllQC6KxNedlsmGy
6pJxaeQp8E+BgQQ8sqVb1MWoWWd7VRxJq3qdwudzTe/NCcLEVxLbAQ4jeQkHO6Lo
/IrPj8BGJJw4J+CDnRugv3gVEOuGTgpa/d/aLIJ+7sr2KeH6caH3iGicnPCNvg9J
kdjqOvn90Ghx2+m1K06Ckm9mH+Dw3EzsytHqunQG+bOEkJTRX45zGRBdAuVwpcAQ
0BB8b8VYSbSwbprafZX1zNoCr7gsfXmPvkPx+SgojQlD+Ajda8iLLCSxjVIHvXib
y8posqTdDEx5YMaZ0ZPxMBoH064iwurO8YQJzOAUbn8/ftKChazcqRZOhaBgy/ac
18izju3Gm5h1DVXoX+WViwKkrkMpKBGk5hIwAUt1ax5mnXkvpXYvHUC0bcl9eQjs
0Wq2XSqypWa9a4X0dFbD9ed1Uigspf9mR6XU/v6eVL9lfgHWMI+lNpyiUBzuOIAB
SMbHdPTGrMNASRZhdCyvjG817XsYAFs2PJxQDcqSMxDxJklt33UkN4Ii1+iW/RVL
ApY+B3KVfqs9TC7XyvDf4Fg/LS8EmjijAQIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUBpOjCl4oaTeqYR3r6/wtbyPk
86AwDQYJKoZIhvcNAQEMBQADggIBAJaAcgkGfpzMkwQWu6A6jZJOtxEaCnFxEM0E
rX+lRVAQZk5KQaID2RFPeje5S+LGjzJmdSX7684/AykmjbgWHfYfM25I5uj4V7Ib
ed87hwriZLoAymzvftAj63iP/2SbNDefNWWipAA9EiOWWF3KY4fGoweITedpdopT
zfFP7ELyk+OZpDc8h7hi2/DsHzc/N19DzFGdtfCXwreFamgLRB7lUe6TzktuhsHS
DCRZNhqfLJGP4xjblJUK7ZGqDpncllPjYYPGFrojutzdfhrGe0K22VoF3Jpf1d+4
2kd92jjbrDnVHmtsKheMYc2xbXIBw8MgAGJoFjHVdqqGuw6qnsb58Nn4DSEC5MUo
FlkRudlpcyqSeLiSV5sI8jrlL5WwWLdrIBRtFO8KvH7YVdiI2i/6GaX7i+B/OfVy
K4XELKzvGUWSTLNhB9xNH27SgRNcmvMSZ4PPmz+Ln52kuaiWA3rF7iDeM9ovnhp6
dB7h7sxaOgTdsxoEqBRjrLdHEoOabPXm6RUVkRqEGQ6UROcSjiVbgGcZ3GOTEAtl
Lor6CZpO2oYofaphNdgOpygau1LgePhsumywbrmHXumZNTfxPWQrqaA0k89jL9WB
365jJ6UeTo3cKXhZ+PmhIIynJkBugnLNeLLIjzwec+fBH7/PzqUqm9tEZDKgu39c
JRNItX+S
-----END CERTIFICATE-----
# Issuer: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd.
# Subject: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd.
# Label: "SecureSign Root CA15"
# Serial: 126083514594751269499665114766174399806381178503
# MD5 Fingerprint: 13:30:fc:c4:62:a6:a9:de:b5:c1:68:af:b5:d2:31:47
# SHA1 Fingerprint: cb:ba:83:c8:c1:5a:5d:f1:f9:73:6f:ca:d7:ef:28:13:06:4a:07:7d
# SHA256 Fingerprint: e7:78:f0:f0:95:fe:84:37:29:cd:1a:00:82:17:9e:53:14:a9:c2:91:44:28:05:e1:fb:1d:8f:b6:b8:88:6c:3a
-----BEGIN CERTIFICATE-----
MIICIzCCAamgAwIBAgIUFhXHw9hJp75pDIqI7fBw+d23PocwCgYIKoZIzj0EAwMw
UTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBM
dGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNTAeFw0yMDA0MDgwODMy
NTZaFw00NTA0MDgwODMyNTZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpDeWJl
cnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBSb290
IENBMTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQLUHSNZDKZmbPSYAi4Io5GdCx4
wCtELW1fHcmuS1Iggz24FG1Th2CeX2yF2wYUleDHKP+dX+Sq8bOLbe1PL0vJSpSR
ZHX+AezB2Ot6lHhWGENfa4HL9rzatAy2KZMIaY+jQjBAMA8GA1UdEwEB/wQFMAMB
Af8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT
9DAKBggqhkjOPQQDAwNoADBlAjEA2S6Jfl5OpBEHvVnCB96rMjhTKkZEBhd6zlHp
4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJSwdLZrWeqrqgHkHZAXQ6
bkU6iYAZezKYVWOr62Nuk22rGwlgMU4=
-----END CERTIFICATE-----
PK @u\o��4\ \ distro-1.9.0.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: bdist_wheel (0.42.0)
Root-Is-Purelib: true
Tag: py3-none-any
PK !@u\�[�=, =, distro-1.9.0.dist-info/LICENSEnu �[��� Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "{}"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright {yyyy} {name of copyright owner}
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
PK #@u\�e _� � distro-1.9.0.dist-info/RECORDnu �[��� ../../../bin/distro,sha256=6XbzdM4pKDrvNJcJIdM6ElyLIuSHQLFlXI5QqD6IVX4,212
distro-1.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
distro-1.9.0.dist-info/LICENSE,sha256=y16Ofl9KOYjhBjwULGDcLfdWBfTEZRXnduOspt-XbhQ,11325
distro-1.9.0.dist-info/METADATA,sha256=MWMqst5VkRMQkbM5e9zfeXcYV52Fp1GG8Gg53QwJ6B0,6791
distro-1.9.0.dist-info/RECORD,,
distro-1.9.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
distro-1.9.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
distro-1.9.0.dist-info/entry_points.txt,sha256=3ObjqQMbh1xeQQwsWtgbfDNDMDD-EbggR1Oj_z8s9hc,46
distro-1.9.0.dist-info/top_level.txt,sha256=ikde_V_XEdSBqaGd5tEriN_wzYHLgTX_zVtlsGLHvwQ,7
distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981
distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64
distro/__pycache__/__init__.cpython-39.pyc,,
distro/__pycache__/__main__.cpython-39.pyc,,
distro/__pycache__/distro.cpython-39.pyc,,
distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430
distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
PK &@u\�û�� � distro-1.9.0.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: distro
Version: 1.9.0
Summary: Distro - an OS platform information API
Home-page: https://github.com/python-distro/distro
Author: Nir Cohen
Author-email: nir36g@gmail.com
License: Apache License, Version 2.0
Platform: All
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: BSD :: NetBSD
Classifier: Operating System :: POSIX :: BSD :: OpenBSD
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Operating System
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Distro - an OS platform information API
=======================================
[](https://github.com/python-distro/distro/actions/workflows/ci.yaml)
[](https://pypi.python.org/pypi/distro)
[](https://img.shields.io/pypi/pyversions/distro.svg)
[](https://codecov.io/github/python-distro/distro?branch=master)
[](https://pypi.python.org/pypi/distro)
[](http://distro.readthedocs.io/en/latest/)
`distro` provides information about the
OS distribution it runs on, such as a reliable machine-readable ID, or
version information.
It is the recommended replacement for Python's original
[`platform.linux_distribution`](https://docs.python.org/3.7/library/platform.html#platform.linux_distribution)
function (removed in Python 3.8). It also provides much more functionality
which isn't necessarily Python bound, like a command-line interface.
Distro currently supports Linux and BSD based systems but [Windows and OS X support](https://github.com/python-distro/distro/issues/177) is also planned.
For Python 2.6 support, see https://github.com/python-distro/distro/tree/python2.6-support
## Installation
Installation of the latest released version from PyPI:
```shell
pip install distro
```
Installation of the latest development version:
```shell
pip install https://github.com/python-distro/distro/archive/master.tar.gz
```
To use as a standalone script, download `distro.py` directly:
```shell
curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
python distro.py
```
``distro`` is safe to vendor within projects that do not wish to add
dependencies.
```shell
cd myproject
curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
```
## Usage
```bash
$ distro
Name: Antergos Linux
Version: 2015.10 (ISO-Rolling)
Codename: ISO-Rolling
$ distro -j
{
"codename": "ISO-Rolling",
"id": "antergos",
"like": "arch",
"version": "16.9",
"version_parts": {
"build_number": "",
"major": "16",
"minor": "9"
}
}
$ python
>>> import distro
>>> distro.name(pretty=True)
'CentOS Linux 8'
>>> distro.id()
'centos'
>>> distro.version(best=True)
'8.4.2105'
```
## Documentation
On top of the aforementioned API, several more functions are available. For a complete description of the
API, see the [latest API documentation](http://distro.readthedocs.org/en/latest/).
## Background
An alternative implementation became necessary because Python 3.5 deprecated
this function, and Python 3.8 removed it altogether. Its predecessor function
[`platform.dist`](https://docs.python.org/3.7/library/platform.html#platform.dist)
was already deprecated since Python 2.6 and removed in Python 3.8. Still, there
are many cases in which access to that information is needed. See [Python issue
1322](https://bugs.python.org/issue1322) for more information.
The `distro` package implements a robust and inclusive way of retrieving the
information about a distribution based on new standards and old methods,
namely from these data sources (from high to low precedence):
* The os-release file `/etc/os-release` if present, with a fall-back on `/usr/lib/os-release` if needed.
* The output of the `lsb_release` command, if available.
* The distro release file (`/etc/*(-|_)(release|version)`), if present.
* The `uname` command for BSD based distrubtions.
## Python and Distribution Support
`distro` is supported and tested on Python 3.6+ and PyPy and on any
distribution that provides one or more of the data sources covered.
This package is tested with test data that mimics the exact behavior of the data sources of [a number of Linux distributions](https://github.com/python-distro/distro/tree/master/tests/resources/distros).
## Testing
```shell
git clone git@github.com:python-distro/distro.git
cd distro
pip install tox
tox
```
## Contributions
Pull requests are always welcome to deal with specific distributions or just
for general merriment.
See [CONTRIBUTIONS](https://github.com/python-distro/distro/blob/master/CONTRIBUTING.md) for contribution info.
Reference implementations for supporting additional distributions and file
formats can be found here:
* https://github.com/saltstack/salt/blob/develop/salt/grains/core.py#L1172
* https://github.com/chef/ohai/blob/master/lib/ohai/plugins/linux/platform.rb
* https://github.com/ansible/ansible/blob/devel/lib/ansible/module_utils/facts/system/distribution.py
* https://github.com/puppetlabs/facter/blob/master/lib/src/facts/linux/os_linux.cc
## Package manager distributions
* https://src.fedoraproject.org/rpms/python-distro
* https://www.archlinux.org/packages/community/any/python-distro/
* https://launchpad.net/ubuntu/+source/python-distro
* https://packages.debian.org/stable/python3-distro
* https://packages.gentoo.org/packages/dev-python/distro
* https://pkgs.org/download/python3-distro
* https://slackbuilds.org/repository/14.2/python/python-distro/
PK (@u\ distro-1.9.0.dist-info/REQUESTEDnu �[��� PK (@u\�f�� $ distro-1.9.0.dist-info/top_level.txtnu �[��� distro
PK ,@u\���. . ' distro-1.9.0.dist-info/entry_points.txtnu �[��� [console_scripts]
distro = distro.distro:main
PK .@u\� �� distro-1.9.0.dist-info/INSTALLERnu �[��� pip
PK 3@u\ I��\ \ future-1.0.0.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: bdist_wheel (0.41.2)
Root-Is-Purelib: true
Tag: py3-none-any
PK 6@u\�E+��z �z future-1.0.0.dist-info/RECORDnu �[��� ../../../bin/futurize,sha256=sXCNiOHh_TxI0O2jpXervN8SaTGHsk3s7DWZVaVd7ps,215
../../../bin/pasteurize,sha256=Z6X36i6UI3tjKEgkWJ-dYlE1hFprHZZaMzOq0Pr6yu8,217
future-1.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
future-1.0.0.dist-info/LICENSE.txt,sha256=vroEEDw6n_-Si1nHfV--sDo-S9DXrD0eH4mUoh4w7js,1075
future-1.0.0.dist-info/METADATA,sha256=MNNaUKMRbZAmVYq5Am_-1NtYZ1ViECpSa8VsQjXbkT4,3959
future-1.0.0.dist-info/RECORD,,
future-1.0.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future-1.0.0.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
future-1.0.0.dist-info/entry_points.txt,sha256=U9LtP60KSNXoj58mzV5TbotBF371gTWzrKrzJIH80Kw,88
future-1.0.0.dist-info/top_level.txt,sha256=DT0C3az2gb-uJaj-fs0h4WwHYlJVDp0EvLdud1y5Zyw,38
future/__init__.py,sha256=T9PNLu6ycmVtpETLxRurmufuRAaosICWmWdAExZb5a8,2938
future/__pycache__/__init__.cpython-39.pyc,,
future/backports/__init__.py,sha256=5QXvQ_jc5Xx6p4dSaHnZXPZazBEunKDKhbUjxZ0XD1I,530
future/backports/__pycache__/__init__.cpython-39.pyc,,
future/backports/__pycache__/_markupbase.cpython-39.pyc,,
future/backports/__pycache__/datetime.cpython-39.pyc,,
future/backports/__pycache__/misc.cpython-39.pyc,,
future/backports/__pycache__/socket.cpython-39.pyc,,
future/backports/__pycache__/socketserver.cpython-39.pyc,,
future/backports/__pycache__/total_ordering.cpython-39.pyc,,
future/backports/_markupbase.py,sha256=MDPTCykLq4J7Aea3PvYotATEE0CG4R_SjlxfJaLXTJM,16215
future/backports/datetime.py,sha256=jITCStolfadhCEhejFd99wCo59mBDF0Ruj8l7QcG7Ms,75553
future/backports/email/__init__.py,sha256=eH3AJr3FkuBy_D6yS1V2K76Q2CQ93y2zmAMWmn8FbHI,2269
future/backports/email/__pycache__/__init__.cpython-39.pyc,,
future/backports/email/__pycache__/_encoded_words.cpython-39.pyc,,
future/backports/email/__pycache__/_header_value_parser.cpython-39.pyc,,
future/backports/email/__pycache__/_parseaddr.cpython-39.pyc,,
future/backports/email/__pycache__/_policybase.cpython-39.pyc,,
future/backports/email/__pycache__/base64mime.cpython-39.pyc,,
future/backports/email/__pycache__/charset.cpython-39.pyc,,
future/backports/email/__pycache__/encoders.cpython-39.pyc,,
future/backports/email/__pycache__/errors.cpython-39.pyc,,
future/backports/email/__pycache__/feedparser.cpython-39.pyc,,
future/backports/email/__pycache__/generator.cpython-39.pyc,,
future/backports/email/__pycache__/header.cpython-39.pyc,,
future/backports/email/__pycache__/headerregistry.cpython-39.pyc,,
future/backports/email/__pycache__/iterators.cpython-39.pyc,,
future/backports/email/__pycache__/message.cpython-39.pyc,,
future/backports/email/__pycache__/parser.cpython-39.pyc,,
future/backports/email/__pycache__/policy.cpython-39.pyc,,
future/backports/email/__pycache__/quoprimime.cpython-39.pyc,,
future/backports/email/__pycache__/utils.cpython-39.pyc,,
future/backports/email/_encoded_words.py,sha256=m1vTRfxAQdg4VyWO7PF-1ih1mmq97V-BPyHHkuEwSME,8443
future/backports/email/_header_value_parser.py,sha256=GmSdr5PpG3xzedMiElSJOsQ6IwE3Tl5SNwp4m6ZT4aE,104692
future/backports/email/_parseaddr.py,sha256=KewEnos0YDM-SYX503z7E1MmVbG5VRaKjxjcl0Ipjbs,17389
future/backports/email/_policybase.py,sha256=2lJD9xouiz4uHvWGQ6j1nwlwWVQGwwzpy5JZoeQqhUc,14647
future/backports/email/base64mime.py,sha256=gXZFxh66jk6D2UqAmjRbmmyhOXbGUWZmFcdVOIolaYE,3761
future/backports/email/charset.py,sha256=CfE4iV2zAq6MQC0CHXHLnwTNW71zmhNITbzOcfxE4vY,17439
future/backports/email/encoders.py,sha256=Nn4Pcx1rOdRgoSIzB6T5RWHl5zxClbf32wgE6D0tUt8,2800
future/backports/email/errors.py,sha256=tRX8PP5g7mk2bAxL1jTCYrbfhD2gPZFNrh4_GJRM8OQ,3680
future/backports/email/feedparser.py,sha256=bvmhb4cdY-ipextPK2K2sDgMsNvTspmuQfYyCxc4zSc,22736
future/backports/email/generator.py,sha256=lpaLhZHneguvZ2QgRu7Figkjb7zmY28AGhj9iZTdI7s,19520
future/backports/email/header.py,sha256=uBHbNKO-yx5I9KBflernJpyy3fX4gImCB1QE7ICApLs,24448
future/backports/email/headerregistry.py,sha256=ZPbvLKXD0NMLSU4jXlVHfGyGcLMrFm-GQVURu_XHj88,20637
future/backports/email/iterators.py,sha256=kMRYFGy3SVVpo7HG7JJr2ZAlOoaX6CVPzKYwDSvLfV0,2348
future/backports/email/message.py,sha256=I6WW5cZDza7uwLOGJSvsDhGZC9K_Q570Lk2gt_vDUXM,35237
future/backports/email/mime/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/backports/email/mime/__pycache__/__init__.cpython-39.pyc,,
future/backports/email/mime/__pycache__/application.cpython-39.pyc,,
future/backports/email/mime/__pycache__/audio.cpython-39.pyc,,
future/backports/email/mime/__pycache__/base.cpython-39.pyc,,
future/backports/email/mime/__pycache__/image.cpython-39.pyc,,
future/backports/email/mime/__pycache__/message.cpython-39.pyc,,
future/backports/email/mime/__pycache__/multipart.cpython-39.pyc,,
future/backports/email/mime/__pycache__/nonmultipart.cpython-39.pyc,,
future/backports/email/mime/__pycache__/text.cpython-39.pyc,,
future/backports/email/mime/application.py,sha256=m-5a4mSxu2E32XAImnp9x9eMVX5Vme2iNgn2dMMNyss,1401
future/backports/email/mime/audio.py,sha256=2ognalFRadcsUYQYMUZbjv5i1xJbFhQN643doMuI7M4,2815
future/backports/email/mime/base.py,sha256=wV3ClQyMsOqmkXSXbk_wd_zPoPTvBx8kAIzq3rdM4lE,875
future/backports/email/mime/image.py,sha256=DpQk1sB-IMmO43AF4uadsXyf_y5TdEzJLfyhqR48bIw,1907
future/backports/email/mime/message.py,sha256=pFsMhXW07aRjsLq1peO847PApWFAl28-Z2Z7BP1Dn74,1429
future/backports/email/mime/multipart.py,sha256=j4Lf_sJmuwTbfgdQ6R35_t1_ha2DynJBJDvpjwbNObE,1699
future/backports/email/mime/nonmultipart.py,sha256=Ciba1Z8d2yLDDpxgDJuk3Bb-TqcpE9HCd8KfbW5vgl4,832
future/backports/email/mime/text.py,sha256=zV98BjoR4S_nX8c47x43LnsnifeGhIfNGwSAh575bs0,1552
future/backports/email/parser.py,sha256=NpTjmvjv6YDH6eImMJEYiIn_K7qe9-pPz3DmzTdMZUU,5310
future/backports/email/policy.py,sha256=gpcbhVRXuCohkK6MUqopTs1lv4E4-ZVUO6OVncoGEJE,8823
future/backports/email/quoprimime.py,sha256=w93W5XgdFpyGaDqDBJrnXF_v_npH5r20WuAxmrAzyQg,10923
future/backports/email/utils.py,sha256=vpfN0E8UjNbNw-2NFBQGCo4TNgrghMsqzpEYW5C_fBs,14270
future/backports/html/__init__.py,sha256=FKwqFtWMCoGNkhU97OPnR1fZSh6etAKfN1FU1KvXcV8,924
future/backports/html/__pycache__/__init__.cpython-39.pyc,,
future/backports/html/__pycache__/entities.cpython-39.pyc,,
future/backports/html/__pycache__/parser.cpython-39.pyc,,
future/backports/html/entities.py,sha256=kzoRnQyGk_3DgoucHLhL5QL1pglK9nvmxhPIGZFDTnc,75428
future/backports/html/parser.py,sha256=G2tUObvbHSotNt06JLY-BP1swaZNfDYFd_ENWDjPmRg,19770
future/backports/http/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/backports/http/__pycache__/__init__.cpython-39.pyc,,
future/backports/http/__pycache__/client.cpython-39.pyc,,
future/backports/http/__pycache__/cookiejar.cpython-39.pyc,,
future/backports/http/__pycache__/cookies.cpython-39.pyc,,
future/backports/http/__pycache__/server.cpython-39.pyc,,
future/backports/http/client.py,sha256=76EbhEZOtvdHFcU-jrjivoff13oQ9IMbdkZEdf5kQzQ,47602
future/backports/http/cookiejar.py,sha256=jqb27uvv8wB2mJm6kF9aC0w7B03nO6rzQ0_CF35yArg,76608
future/backports/http/cookies.py,sha256=DsyDUGDEbCXAA9Jq6suswSc76uSZqUu39adDDNj8XGw,21581
future/backports/http/server.py,sha256=1CaMxgzHf9lYhmTJyE7topgjRIlIn9cnjgw8YEvwJV4,45523
future/backports/misc.py,sha256=EGnCVRmU-_7xrzss1rqqCqwqlQVywaPAxxLogBeNpw4,33063
future/backports/socket.py,sha256=DH1V6IjKPpJ0tln8bYvxvQ7qnvZG-UoQtMA5yVleHiU,15663
future/backports/socketserver.py,sha256=Twvyk5FqVnOeiNcbVsyMDPTF1mNlkKfyofG7tKxTdD8,24286
future/backports/test/__init__.py,sha256=9dXxIZnkI095YfHC-XIaVF6d31GjeY1Ag8TEzcFgepM,264
future/backports/test/__pycache__/__init__.cpython-39.pyc,,
future/backports/test/__pycache__/pystone.cpython-39.pyc,,
future/backports/test/__pycache__/ssl_servers.cpython-39.pyc,,
future/backports/test/__pycache__/support.cpython-39.pyc,,
future/backports/test/badcert.pem,sha256=JioQeRZkHH8hGsWJjAF3U1zQvcWqhyzG6IOEJpTY9SE,1928
future/backports/test/badkey.pem,sha256=gaBK9px_gG7DmrLKxfD6f6i-toAmARBTVfs-YGFRQF0,2162
future/backports/test/dh512.pem,sha256=dUTsjtLbK-femrorUrTGF8qvLjhTiT_n4Uo5V6u__Gs,402
future/backports/test/https_svn_python_org_root.pem,sha256=wOB3Onnc62Iu9kEFd8GcHhd_suucYjpJNA3jyfHeJWA,2569
future/backports/test/keycert.passwd.pem,sha256=ZBfnVLpbBtAOf_2gCdiQ-yrBHmRsNzSf8VC3UpQZIjg,1830
future/backports/test/keycert.pem,sha256=xPXi5idPcQVbrhgxBqF2TNGm6sSZ2aLVVEt6DWzplL8,1783
future/backports/test/keycert2.pem,sha256=DB46FEAYv8BWwQJ-5RzC696FxPN7CON-Qsi-R4poJgc,1795
future/backports/test/nokia.pem,sha256=s00x0uPDSaa5DHJ_CwzlVhg3OVdJ47f4zgqQdd0SAfQ,1923
future/backports/test/nullbytecert.pem,sha256=NFRYWhmP_qT3jGfVjR6-iaC-EQdhIFjiXtTLN5ZPKnE,5435
future/backports/test/nullcert.pem,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/backports/test/pystone.py,sha256=fvyoJ_tVovTNaxbJmdJMwr9F6SngY-U4ibULnd_wUqA,7427
future/backports/test/sha256.pem,sha256=3wB-GQqEc7jq-PYwYAQaPbtTvvr7stk_DVmZxFgehfA,8344
future/backports/test/ssl_cert.pem,sha256=M607jJNeIeHG9BlTf_jaQkPJI4nOxSJPn-zmEAaW43M,867
future/backports/test/ssl_key.passwd.pem,sha256=I_WH4sBw9Vs9Z-BvmuXY0aw8tx8avv6rm5UL4S_pP00,963
future/backports/test/ssl_key.pem,sha256=VKGU-R3UYaZpVTXl7chWl4vEYEDeob69SfvRTQ8aq_4,916
future/backports/test/ssl_servers.py,sha256=-pd7HMZljuZfFRAbCAiAP_2G04orITJFj-S9ddr6o84,7209
future/backports/test/support.py,sha256=oTQ09QrLcbmFZXhMGqPz3VrYZddgxpJGEJPQhwfiG2k,69620
future/backports/total_ordering.py,sha256=O3M57_IisQ-zW5hW20uxkfk4fTGsr0EF2tAKx3BksQo,1929
future/backports/urllib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/backports/urllib/__pycache__/__init__.cpython-39.pyc,,
future/backports/urllib/__pycache__/error.cpython-39.pyc,,
future/backports/urllib/__pycache__/parse.cpython-39.pyc,,
future/backports/urllib/__pycache__/request.cpython-39.pyc,,
future/backports/urllib/__pycache__/response.cpython-39.pyc,,
future/backports/urllib/__pycache__/robotparser.cpython-39.pyc,,
future/backports/urllib/error.py,sha256=ktikuK9ag4lS4f8Z0k5p1F11qF40N2AiOtjbXiF97ew,2715
future/backports/urllib/parse.py,sha256=67avrYqV1UK7i_22goRUrvJ8SffzjRdTja9wzq_ynXY,35792
future/backports/urllib/request.py,sha256=aR9ZMzfhV1C2Qk3wFsGvkwxqtdPTdsJVGRt5DUCwgJ8,96276
future/backports/urllib/response.py,sha256=ooQyswwbb-9N6IVi1Kwjss1aR-Kvm8ZNezoyVEonp8c,3180
future/backports/urllib/robotparser.py,sha256=pnAGTbKhdbCq_9yMZp7m8hj5q_NJpyQX6oQIZuYcnkw,6865
future/backports/xmlrpc/__init__.py,sha256=h61ciVTdVvu8oEUXv4dHf_Tc5XUXDH3RKB1-8fQhSsg,38
future/backports/xmlrpc/__pycache__/__init__.cpython-39.pyc,,
future/backports/xmlrpc/__pycache__/client.cpython-39.pyc,,
future/backports/xmlrpc/__pycache__/server.cpython-39.pyc,,
future/backports/xmlrpc/client.py,sha256=TIHPztKRlrStphmO_PfYOQxsy2xugzWKz77STC1OZ1U,48175
future/backports/xmlrpc/server.py,sha256=W_RW5hgYbNV2LGbnvngzm7akacRdK-XFY-Cy2HL-qsY,37285
future/builtins/__init__.py,sha256=rDAHzkhfXHSaye72FgzQz-HPN3yYBu-VXSs5PUJGA6o,1688
future/builtins/__pycache__/__init__.cpython-39.pyc,,
future/builtins/__pycache__/disabled.cpython-39.pyc,,
future/builtins/__pycache__/iterators.cpython-39.pyc,,
future/builtins/__pycache__/misc.cpython-39.pyc,,
future/builtins/__pycache__/new_min_max.cpython-39.pyc,,
future/builtins/__pycache__/newnext.cpython-39.pyc,,
future/builtins/__pycache__/newround.cpython-39.pyc,,
future/builtins/__pycache__/newsuper.cpython-39.pyc,,
future/builtins/disabled.py,sha256=Ysq74bsmwntpq7dzkwTAD7IHKrkXy66vJlPshVwgVBI,2109
future/builtins/iterators.py,sha256=l1Zawm2x82oqOuGGtCZRE76Ej98sMlHQwu9fZLK5RrA,1396
future/builtins/misc.py,sha256=hctlKKWUyN0Eoodxg4ySQHEqARTukOLR4L5K5c6PW9k,4550
future/builtins/new_min_max.py,sha256=7qQ4iiG4GDgRzjPzzzmg9pdby35Mtt6xNOOsyqHnIGY,1757
future/builtins/newnext.py,sha256=oxXB8baXqJv29YG40aCS9UXk9zObyoOjya8BJ7NdBJM,2009
future/builtins/newround.py,sha256=7YTWjBgfIAvSEl7hLCWgemhjqdKtzohbO18yMErKz4E,3190
future/builtins/newsuper.py,sha256=3Ygqq-8l3wh9gNvGbW5nAiTYT5WxxgSKN6RhNj7qi74,3849
future/moves/__init__.py,sha256=MsAW69Xp_fqUo4xODufcKM6AZf-ozHaz44WPZdsDFJA,220
future/moves/__pycache__/__init__.cpython-39.pyc,,
future/moves/__pycache__/_dummy_thread.cpython-39.pyc,,
future/moves/__pycache__/_markupbase.cpython-39.pyc,,
future/moves/__pycache__/_thread.cpython-39.pyc,,
future/moves/__pycache__/builtins.cpython-39.pyc,,
future/moves/__pycache__/collections.cpython-39.pyc,,
future/moves/__pycache__/configparser.cpython-39.pyc,,
future/moves/__pycache__/copyreg.cpython-39.pyc,,
future/moves/__pycache__/itertools.cpython-39.pyc,,
future/moves/__pycache__/multiprocessing.cpython-39.pyc,,
future/moves/__pycache__/pickle.cpython-39.pyc,,
future/moves/__pycache__/queue.cpython-39.pyc,,
future/moves/__pycache__/reprlib.cpython-39.pyc,,
future/moves/__pycache__/socketserver.cpython-39.pyc,,
future/moves/__pycache__/subprocess.cpython-39.pyc,,
future/moves/__pycache__/sys.cpython-39.pyc,,
future/moves/__pycache__/winreg.cpython-39.pyc,,
future/moves/_dummy_thread.py,sha256=ULUtLk1Luw9I1h-YPitnU3gqCbvNPoKC28N_Bk8jkR8,348
future/moves/_markupbase.py,sha256=W9wh_Gu3jDAMIhVBV1ZnCkJwYLHRk_v_su_HLALBkZQ,171
future/moves/_thread.py,sha256=rwY7L4BZMFPlrp_i6T2Un4_iKYwnrXJ-yV6FJZN8YDo,163
future/moves/builtins.py,sha256=4sjjKiylecJeL9da_RaBZjdymX2jtMs84oA9lCqb4Ug,281
future/moves/collections.py,sha256=OKQ-TfUgms_2bnZRn4hrclLDoiN2i-HSWcjs3BC2iY8,417
future/moves/configparser.py,sha256=TNy226uCbljjU-DjAVo7j7Effbj5zxXvDh0SdXehbzk,146
future/moves/copyreg.py,sha256=Y3UjLXIMSOxZggXtvZucE9yv4tkKZtVan45z8eix4sU,438
future/moves/dbm/__init__.py,sha256=_VkvQHC2UcIgZFPRroiX_P0Fs7HNqS_69flR0-oq2B8,488
future/moves/dbm/__pycache__/__init__.cpython-39.pyc,,
future/moves/dbm/__pycache__/dumb.cpython-39.pyc,,
future/moves/dbm/__pycache__/gnu.cpython-39.pyc,,
future/moves/dbm/__pycache__/ndbm.cpython-39.pyc,,
future/moves/dbm/dumb.py,sha256=HKdjjtO3EyP9EKi1Hgxh_eUU6yCQ0fBX9NN3n-zb8JE,166
future/moves/dbm/gnu.py,sha256=XoCSEpZ2QaOgo2h1m80GW7NUgj_b93BKtbcuwgtnaKo,162
future/moves/dbm/ndbm.py,sha256=OFnreyo_1YHDBl5YUm9gCzKlN1MHgWbfSQAZVls2jaM,162
future/moves/html/__init__.py,sha256=BSUFSHxXf2kGvHozlnrB1nn6bPE6p4PpN3DwA_Z5geo,1016
future/moves/html/__pycache__/__init__.cpython-39.pyc,,
future/moves/html/__pycache__/entities.cpython-39.pyc,,
future/moves/html/__pycache__/parser.cpython-39.pyc,,
future/moves/html/entities.py,sha256=lVvchdjK_RzRj759eg4RMvGWHfgBbj0tKGOoZ8dbRyY,177
future/moves/html/parser.py,sha256=V2XpHLKLCxQum3N9xlO3IUccAD7BIykZMqdEcWET3vY,167
future/moves/http/__init__.py,sha256=Mx1v_Tcks4udHCtDM8q2xnYUiQ01gD7EpPyeQwsP3-Q,71
future/moves/http/__pycache__/__init__.cpython-39.pyc,,
future/moves/http/__pycache__/client.cpython-39.pyc,,
future/moves/http/__pycache__/cookiejar.cpython-39.pyc,,
future/moves/http/__pycache__/cookies.cpython-39.pyc,,
future/moves/http/__pycache__/server.cpython-39.pyc,,
future/moves/http/client.py,sha256=hqEBq7GDXZidd1AscKnSyjSoMcuj8rERqGTmD7VheDQ,165
future/moves/http/cookiejar.py,sha256=Frr9ZZCg-145ymy0VGpiPJhvBEpJtVqRBYPaKhgT1Z4,173
future/moves/http/cookies.py,sha256=PPrHa1_oDbu3D_BhJGc6PvMgY1KoxyYq1jqeJwEcMvE,233
future/moves/http/server.py,sha256=8YQlSCShjAsB5rr5foVvZgp3IzwYFvTmGZCHhBSDtaI,606
future/moves/itertools.py,sha256=PVxFHRlBQl9ElS0cuGFPcUtj53eHX7Z1DmggzGfgQ6c,158
future/moves/multiprocessing.py,sha256=4L37igVf2NwBhXqmCHRA3slZ7lJeiQLzZdrGSGOOZ08,191
future/moves/pickle.py,sha256=r8j9skzfE8ZCeHyh_OB-WucOkRTIHN7zpRM7l7V3qS4,229
future/moves/queue.py,sha256=uxvLCChF-zxWWgrY1a_wxt8rp2jILdwO4PrnkBW6VTE,160
future/moves/reprlib.py,sha256=Nt5sUgMQ3jeVIukqSHOvB0UIsl6Y5t-mmT_13mpZmiY,161
future/moves/socketserver.py,sha256=v8ZLurDxHOgsubYm1iefjlpnnJQcx2VuRUGt9FCJB9k,174
future/moves/subprocess.py,sha256=oqRSMfFZkxM4MXkt3oD5N6eBwmmJ6rQ9KPhvSQKT_hM,251
future/moves/sys.py,sha256=HOMRX4Loim75FMbWawd3oEwuGNJR-ClMREEFkVpBsRs,132
future/moves/test/__init__.py,sha256=yB9F-fDQpzu1v8cBoKgIrL2ScUNqjlkqEztYrGVCQ-0,110
future/moves/test/__pycache__/__init__.cpython-39.pyc,,
future/moves/test/__pycache__/support.cpython-39.pyc,,
future/moves/test/support.py,sha256=TG5h0FVGwyJGtKQEXMhWtD4G9WZagHrMI_CeL9NlZYc,484
future/moves/tkinter/__init__.py,sha256=jV9vDx3wRl0bsoclU8oSe-5SqHQ3YpCbStmqtXnq1p4,620
future/moves/tkinter/__pycache__/__init__.cpython-39.pyc,,
future/moves/tkinter/__pycache__/colorchooser.cpython-39.pyc,,
future/moves/tkinter/__pycache__/commondialog.cpython-39.pyc,,
future/moves/tkinter/__pycache__/constants.cpython-39.pyc,,
future/moves/tkinter/__pycache__/dialog.cpython-39.pyc,,
future/moves/tkinter/__pycache__/dnd.cpython-39.pyc,,
future/moves/tkinter/__pycache__/filedialog.cpython-39.pyc,,
future/moves/tkinter/__pycache__/font.cpython-39.pyc,,
future/moves/tkinter/__pycache__/messagebox.cpython-39.pyc,,
future/moves/tkinter/__pycache__/scrolledtext.cpython-39.pyc,,
future/moves/tkinter/__pycache__/simpledialog.cpython-39.pyc,,
future/moves/tkinter/__pycache__/tix.cpython-39.pyc,,
future/moves/tkinter/__pycache__/ttk.cpython-39.pyc,,
future/moves/tkinter/colorchooser.py,sha256=kprlmpRtvDbW5Gq43H1mi2KmNJ2kuzLQOba0a5EwDkU,333
future/moves/tkinter/commondialog.py,sha256=mdUbq1IZqOGaSA7_8R367IukDCsMfzXiVHrTQQpp7Z0,333
future/moves/tkinter/constants.py,sha256=0qRUrZLRPdVxueABL9KTzzEWEsk6xM1rOjxK6OHxXtA,324
future/moves/tkinter/dialog.py,sha256=ksp-zvs-_A90P9RNHS8S27f1k8f48zG2Bel2jwZV5y0,311
future/moves/tkinter/dnd.py,sha256=C_Ah0Urnyf2XKE5u-oP6mWi16RzMSXgMA1uhBSAwKY8,306
future/moves/tkinter/filedialog.py,sha256=yNr30k-hDY1aMJHNsKqRqHqOOlzYKCubfQ3HjY1ZlrE,534
future/moves/tkinter/font.py,sha256=TXarflhJRxqepaRNSDw6JFUVGz5P1T1C4_uF9VRqj3w,309
future/moves/tkinter/messagebox.py,sha256=WJt4t83kLmr_UnpCWFuLoyazZr3wAUOEl6ADn3osoEA,327
future/moves/tkinter/scrolledtext.py,sha256=DRzN8aBAlDBUo1B2KDHzdpRSzXBfH4rOOz0iuHXbQcg,329
future/moves/tkinter/simpledialog.py,sha256=6MhuVhZCJV4XfPpPSUWKlDLLGEi0Y2ZlGQ9TbsmJFL0,329
future/moves/tkinter/tix.py,sha256=aNeOfbWSGmcN69UmEGf4tJ-QIxLT6SU5ynzm1iWgepA,302
future/moves/tkinter/ttk.py,sha256=rRrJpDjcP2gjQNukECu4F026P-CkW-3Ca2tN6Oia-Fw,302
future/moves/urllib/__init__.py,sha256=yB9F-fDQpzu1v8cBoKgIrL2ScUNqjlkqEztYrGVCQ-0,110
future/moves/urllib/__pycache__/__init__.cpython-39.pyc,,
future/moves/urllib/__pycache__/error.cpython-39.pyc,,
future/moves/urllib/__pycache__/parse.cpython-39.pyc,,
future/moves/urllib/__pycache__/request.cpython-39.pyc,,
future/moves/urllib/__pycache__/response.cpython-39.pyc,,
future/moves/urllib/__pycache__/robotparser.cpython-39.pyc,,
future/moves/urllib/error.py,sha256=gfrKzv-6W5OjzNIfjvJaQkxABRLym2KwjfKFXSdDB60,479
future/moves/urllib/parse.py,sha256=xLLUMIIB5MreCdYzRZ5zIRWrhTRCoMO8RZEH4WPFQDY,1045
future/moves/urllib/request.py,sha256=ttIzq60PwjRyrLQUGdAtfYvs4fziVwvcLe2Kw-hvE0g,3496
future/moves/urllib/response.py,sha256=ZEZML0FpbB--GIeBFPvSzbtlVJ6EsR4tCI4qB7D8sFQ,342
future/moves/urllib/robotparser.py,sha256=j24p6dMNzUpGZtT3BQxwRoE-F88iWmBpKgu0tRV61FQ,179
future/moves/winreg.py,sha256=2zNAG59QI7vFlCj7kqDh0JrAYTpexOnI55PEAIjYhqo,163
future/moves/xmlrpc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/moves/xmlrpc/__pycache__/__init__.cpython-39.pyc,,
future/moves/xmlrpc/__pycache__/client.cpython-39.pyc,,
future/moves/xmlrpc/__pycache__/server.cpython-39.pyc,,
future/moves/xmlrpc/client.py,sha256=2PfnL5IbKVwdKP7C8B1OUviEtuBObwoH4pAPfvHIvQc,143
future/moves/xmlrpc/server.py,sha256=ESDXdpUgTKyeFmCDSnJmBp8zONjJklsRJOvy4OtaALc,143
future/standard_library/__init__.py,sha256=Nwbaqikyeh77wSiro-BHNjSsCmSmuLGAe91d4c5q_QE,28065
future/standard_library/__pycache__/__init__.cpython-39.pyc,,
future/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
future/tests/__pycache__/__init__.cpython-39.pyc,,
future/tests/__pycache__/base.cpython-39.pyc,,
future/tests/base.py,sha256=7LTAKHJgUxOwmffD1kgcErVt2VouKcldPnq4iruqk_k,19956
future/types/__init__.py,sha256=5fBxWqf_OTQ8jZ7k2TS34rFH14togeR488F4zBHIQ-s,6831
future/types/__pycache__/__init__.cpython-39.pyc,,
future/types/__pycache__/newbytes.cpython-39.pyc,,
future/types/__pycache__/newdict.cpython-39.pyc,,
future/types/__pycache__/newint.cpython-39.pyc,,
future/types/__pycache__/newlist.cpython-39.pyc,,
future/types/__pycache__/newmemoryview.cpython-39.pyc,,
future/types/__pycache__/newobject.cpython-39.pyc,,
future/types/__pycache__/newopen.cpython-39.pyc,,
future/types/__pycache__/newrange.cpython-39.pyc,,
future/types/__pycache__/newstr.cpython-39.pyc,,
future/types/newbytes.py,sha256=D_kNDD9sbNJir2cUxxePiAuw2OW5irxVnu55uHmuK9E,16303
future/types/newdict.py,sha256=go-Lbl2MRWZJJRlwTAUlJNJRkg986YYeV0jCqEUEFNc,2011
future/types/newint.py,sha256=HH90HS2Y1ApS02LDpKzqt9V1Lwtp6tktMIYjavZUIh8,13406
future/types/newlist.py,sha256=-H5-fXodd-UQgTFnZBJdwE68CrgIL_jViYdv4w7q2rU,2284
future/types/newmemoryview.py,sha256=LnARgiKqQ2zLwwDZ3owu1atoonPQkOneWMfxJCwB4_o,712
future/types/newobject.py,sha256=AX_n8GwlDR2IY-xIwZCvu0Olj_Ca2aS57nlTihnFr-I,3358
future/types/newopen.py,sha256=lcRNHWZ1UjEn_0_XKis1ZA5U6l-4c-CHlC0WX1sY4NI,810
future/types/newrange.py,sha256=fcCL1imqqH-lqWsY9Lnml9d-WbJOtXrayAUPoUbM7Ck,5296
future/types/newstr.py,sha256=e0brkurI0IK--4ToQEO4Cz1FECZav4CyUGMKxlrcmK4,15758
future/utils/__init__.py,sha256=Er_tUl6bS4xp7_M1Z3hZrgM9hAGrRUvCAdcHDRgSOdE,21960
future/utils/__pycache__/__init__.cpython-39.pyc,,
future/utils/__pycache__/surrogateescape.cpython-39.pyc,,
future/utils/surrogateescape.py,sha256=7u4V4XlW83P5YSAJS2f92YUF8vsWthsiTnmAshOJL_M,6097
libfuturize/__init__.py,sha256=CZA_KgvTQOPAY1_MrlJeQ6eMh2Eei4_KIv4JuyAkpfw,31
libfuturize/__pycache__/__init__.cpython-39.pyc,,
libfuturize/__pycache__/fixer_util.cpython-39.pyc,,
libfuturize/__pycache__/main.cpython-39.pyc,,
libfuturize/fixer_util.py,sha256=hOmX8XLnicGJ6RGwlUxslhuhzhPc0cZimlylFQAeDOo,17357
libfuturize/fixes/__init__.py,sha256=5KEpUnjVsFCCsr_-zrikvJbLf9zslEJnFTH_5pBc33I,5236
libfuturize/fixes/__pycache__/__init__.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_UserDict.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_absolute_import.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_add__future__imports_except_unicode_literals.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_basestring.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_bytes.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_cmp.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_division.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_division_safe.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_execfile.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_future_builtins.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_future_standard_library.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_future_standard_library_urllib.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_input.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_metaclass.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_next_call.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_object.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_oldstr_wrap.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_order___future__imports.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_print.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_print_with_import.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_raise.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_remove_old__future__imports.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_unicode_keep_u.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_unicode_literals_import.cpython-39.pyc,,
libfuturize/fixes/__pycache__/fix_xrange_with_import.cpython-39.pyc,,
libfuturize/fixes/fix_UserDict.py,sha256=jL4jXnGaUQTkG8RKfGXbU_HVTkB3MWZMQwUkqMAjB6I,3840
libfuturize/fixes/fix_absolute_import.py,sha256=vkrF2FyQR5lSz2WmdqywzkEJVTC0eq4gh_REWBKHh7w,3140
libfuturize/fixes/fix_add__future__imports_except_unicode_literals.py,sha256=Fr219VAzR8KWXc2_bfiqLl10EgxAWjL6cI3Mowt--VU,662
libfuturize/fixes/fix_basestring.py,sha256=bHkKuMzhr5FMXwjXlMOjsod4S3rQkVdbzhoWV4-tl3Y,394
libfuturize/fixes/fix_bytes.py,sha256=AhzOJes6EnPwgzboDjvURANbWKqciG6ZGaYW07PYQK8,685
libfuturize/fixes/fix_cmp.py,sha256=Blq_Z0IGkYiKS83QzZ5wUgpJyZfQiZoEsWJ1VPyXgFY,701
libfuturize/fixes/fix_division.py,sha256=gnrAi7stquiVUyi_De1H8q--43iQaSUX0CjnOmQ6O2w,228
libfuturize/fixes/fix_division_safe.py,sha256=oz407p0Woc2EKw7jZHUL4CpDs81FFpekRum58NKsNp4,3631
libfuturize/fixes/fix_execfile.py,sha256=I5AcJ6vPZ7i70TChaq9inxqnZ4C04-yJyfAItGa8E3c,921
libfuturize/fixes/fix_future_builtins.py,sha256=QBCRpD9XA7tbtfP4wmOF2DXquB4lq-eupkQj-QAxp0s,2027
libfuturize/fixes/fix_future_standard_library.py,sha256=FVtflFt38efHe_SEX6k3m6IYAtKWjA4rAPZrlCv6yA0,733
libfuturize/fixes/fix_future_standard_library_urllib.py,sha256=Rf81XcAXA-vwNvrhskf5sLExbR--Wkr5fiUcMYGAKzs,1001
libfuturize/fixes/fix_input.py,sha256=bhaPNtMrZNbjWIDQCR7Iue5BxBj4rf0RJQ9_jiwvb-s,687
libfuturize/fixes/fix_metaclass.py,sha256=_CS1NDXYM-Mh6xpogLK_GtYx3rUUptu1-Z0Rx3lC9eQ,9570
libfuturize/fixes/fix_next_call.py,sha256=01STG86Av9o5QcpQDJ6UbPhvxt9kKrkatiPeddXRgvA,3158
libfuturize/fixes/fix_object.py,sha256=qalFIjn0VTWXG5sGOOoCvO65omjX5_9d40SUpwUjBdw,407
libfuturize/fixes/fix_oldstr_wrap.py,sha256=UCR6Q2l-pVqJSrRTnQAWMlaqBoX7oX1VpG_w6Q0XcyY,1214
libfuturize/fixes/fix_order___future__imports.py,sha256=ACUCw5NEGWvj6XA9rNj8BYha3ktxLvkM5Ssh5cyV644,829
libfuturize/fixes/fix_print.py,sha256=nbJdv5DbxtWzJIRIQ0tr7FfGkMkHScJTLzvpxv_hSNw,3881
libfuturize/fixes/fix_print_with_import.py,sha256=hVWn70Q1DPMUiHMyEqgUx-6sM1AylLj78v9pMc4LFw8,735
libfuturize/fixes/fix_raise.py,sha256=CkjqiSvHHD-enaLxYMkH-Nsi92NGShFLWd3fG-exmI4,3904
libfuturize/fixes/fix_remove_old__future__imports.py,sha256=j4EC1KEVgXhuQAqhYHnAruUjW6uczPjV_fTCSOLMuAw,851
libfuturize/fixes/fix_unicode_keep_u.py,sha256=M8fcFxHeFnWVOKoQRpkMsnpd9qmUFubI2oFhO4ZPk7A,779
libfuturize/fixes/fix_unicode_literals_import.py,sha256=wq-hb-9Yx3Az4ol-ylXZJPEDZ81EaPZeIy5VvpA0CEY,367
libfuturize/fixes/fix_xrange_with_import.py,sha256=f074qStjMz3OtLjt1bKKZSxQnRbbb7HzEbqHt9wgqdw,479
libfuturize/main.py,sha256=feICmcv0dzWhutvwz0unnIVxusbSlQZFDaxObkHebs8,13733
libpasteurize/__init__.py,sha256=CZA_KgvTQOPAY1_MrlJeQ6eMh2Eei4_KIv4JuyAkpfw,31
libpasteurize/__pycache__/__init__.cpython-39.pyc,,
libpasteurize/__pycache__/main.cpython-39.pyc,,
libpasteurize/fixes/__init__.py,sha256=ccdv-2MGjQMbq8XuEZBndHmbzGRrZnabksjXZLUv044,3719
libpasteurize/fixes/__pycache__/__init__.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/feature_base.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_add_all__future__imports.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_add_all_future_builtins.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_add_future_standard_library_import.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_annotations.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_division.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_features.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_fullargspec.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_future_builtins.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_getcwd.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_imports.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_imports2.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_kwargs.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_memoryview.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_metaclass.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_newstyle.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_next.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_printfunction.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_raise.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_raise_.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_throw.cpython-39.pyc,,
libpasteurize/fixes/__pycache__/fix_unpacking.cpython-39.pyc,,
libpasteurize/fixes/feature_base.py,sha256=v7yLjBDBUPeNUc-YHGGlIsJDOQzFAM4Vo0RN5F1JHVU,1723
libpasteurize/fixes/fix_add_all__future__imports.py,sha256=mHet1LgbHn9GfgCYGNZXKo-rseDWreAvUcAjZwdgeTE,676
libpasteurize/fixes/fix_add_all_future_builtins.py,sha256=scfkY-Sz5j0yDtLYls2ENOcqEMPVxeDm9gFYYPINPB8,1269
libpasteurize/fixes/fix_add_future_standard_library_import.py,sha256=thTRbkBzy_SJjZ0bJteTp0sBTx8Wr69xFakH4styf7Y,663
libpasteurize/fixes/fix_annotations.py,sha256=VT_AorKY9AYWYZUZ17_CeUrJlEA7VGkwVLDQlwD1Bxo,1581
libpasteurize/fixes/fix_division.py,sha256=_TD_c5KniAYqEm11O7NJF0v2WEhYSNkRGcKG_94ZOas,904
libpasteurize/fixes/fix_features.py,sha256=NZn0n34_MYZpLNwyP1Tf51hOiN58Rg7A8tA9pK1S8-c,2675
libpasteurize/fixes/fix_fullargspec.py,sha256=VlZuIU6QNrClmRuvC4mtLICL3yMCi-RcGCnS9fD4b-Q,438
libpasteurize/fixes/fix_future_builtins.py,sha256=SlCK9I9u05m19Lr1wxlJxF8toZ5yu0yXBeDLxUN9_fw,1450
libpasteurize/fixes/fix_getcwd.py,sha256=uebvTvFboLqsROFCwdnzoP6ThziM0skz9TDXHoJcFsQ,873
libpasteurize/fixes/fix_imports.py,sha256=KH4Q-qMzsuN5VcfE1ZGS337yHhxbgrmLoRtpHtr2A94,5026
libpasteurize/fixes/fix_imports2.py,sha256=bs2V5Yv0v_8xLx-lNj9kNEAK2dLYXUXkZ2hxECg01CU,8580
libpasteurize/fixes/fix_kwargs.py,sha256=NB_Ap8YJk-9ncoJRbOiPY_VMIigFgVB8m8AuY29DDhE,5991
libpasteurize/fixes/fix_memoryview.py,sha256=Fwayx_ezpr22tbJ0-QrKdJ-FZTpU-m7y78l1h_N4xxc,551
libpasteurize/fixes/fix_metaclass.py,sha256=IcE2KjaDG8jUR3FYXECzOC_cr2pr5r95W1NTbMrK8Wc,3260
libpasteurize/fixes/fix_newstyle.py,sha256=78sazKOHm9DUoMyW4VdvQpMXZhicbXzorVPRhBpSUrM,888
libpasteurize/fixes/fix_next.py,sha256=VHqcyORRNVqKJ51jJ1OkhwxHuXRgp8qaldyqcMvA4J0,1233
libpasteurize/fixes/fix_printfunction.py,sha256=NDIfqVmUJBG3H9E6nrnN0cWZK8ch9pL4F-nMexdsa38,401
libpasteurize/fixes/fix_raise.py,sha256=zQ_AcMsGmCbtKMgrxZGcHLYNscw6tqXFvHQxgqtNbU8,1099
libpasteurize/fixes/fix_raise_.py,sha256=9STp633frUfYASjYzqhwxx_MXePNmMhfJClowRj8FLY,1225
libpasteurize/fixes/fix_throw.py,sha256=_ZREVre-WttUvk4sWjrqUNqm9Q1uFaATECN0_-PXKbk,835
libpasteurize/fixes/fix_unpacking.py,sha256=xZqxMYHgdeuIkermtY-evisvcKlGCPi5vg5t5pt-XCY,6041
libpasteurize/main.py,sha256=dVHYTQQeJonuOFDNrenJZl-rKHgOQKRMPP1OqnJogWQ,8186
past/__init__.py,sha256=2DxcQt5zgPH-e-TSDS2l7hI94A9eG7pPgD-V5FgH084,2892
past/__pycache__/__init__.cpython-39.pyc,,
past/builtins/__init__.py,sha256=7j_4OsUlN6q2eKr14do7mRQ1GwXRoXAMUR0A1fJpAls,1805
past/builtins/__pycache__/__init__.cpython-39.pyc,,
past/builtins/__pycache__/misc.cpython-39.pyc,,
past/builtins/__pycache__/noniterators.cpython-39.pyc,,
past/builtins/misc.py,sha256=I76Mpx_3wnHpJg7Ub9SZOBRqEFo02YgimZJpfoq17_0,5598
past/builtins/noniterators.py,sha256=LtdELnd7KyYdXg7GkW25cgkEPUC0ggZ5AYMtDe9N95I,9370
past/translation/__init__.py,sha256=oTtrOHD8ToM9c9RXat_BhjKhN33N7_Vg4HGS0if-UbU,14914
past/translation/__pycache__/__init__.cpython-39.pyc,,
past/types/__init__.py,sha256=RyJlgqg9uJ8oF-kJT9QlfhfdmhiMh3fShmtvd2CQycY,879
past/types/__pycache__/__init__.cpython-39.pyc,,
past/types/__pycache__/basestring.cpython-39.pyc,,
past/types/__pycache__/olddict.cpython-39.pyc,,
past/types/__pycache__/oldstr.cpython-39.pyc,,
past/types/basestring.py,sha256=lO66aHgOV02vka6kosnR6GWK0iNC0G28Nugb1MP69-E,774
past/types/olddict.py,sha256=0YtffZ55VY6AyQ_rwu4DZ4vcRsp6dz-dQzczeyN8hLk,2721
past/types/oldstr.py,sha256=JuF8VBBI4OGSgZ3PyhU6LxSAiTfEWzdHUx0Hwg13WSY,4333
past/utils/__init__.py,sha256=e8l1sOfdiDJ3dkckBWLNWvC1ahC5BX5haHC2TGdNgA8,2633
past/utils/__pycache__/__init__.cpython-39.pyc,,
PK 9@u\���w w future-1.0.0.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: future
Version: 1.0.0
Summary: Clean single-source support for Python 3 and 2
Home-page: https://python-future.org
Author: Ed Schofield
Author-email: ed@pythoncharmers.com
License: MIT
Project-URL: Source, https://github.com/PythonCharmers/python-future
Keywords: future past python3 migration futurize backport six 2to3 modernize pasteurize 3to2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 6 - Mature
Classifier: Intended Audience :: Developers
Requires-Python: >=2.6, !=3.0.*, !=3.1.*, !=3.2.*
License-File: LICENSE.txt
future: Easy, safe support for Python 2/3 compatibility
=======================================================
``future`` is the missing compatibility layer between Python 2 and Python
3. It allows you to use a single, clean Python 3.x-compatible codebase to
support both Python 2 and Python 3 with minimal overhead.
It is designed to be used as follows::
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from builtins import (
bytes, dict, int, list, object, range, str,
ascii, chr, hex, input, next, oct, open,
pow, round, super,
filter, map, zip)
followed by predominantly standard, idiomatic Python 3 code that then runs
similarly on Python 2.6/2.7 and Python 3.3+.
The imports have no effect on Python 3. On Python 2, they shadow the
corresponding builtins, which normally have different semantics on Python 3
versus 2, to provide their Python 3 semantics.
Standard library reorganization
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
``future`` supports the standard library reorganization (PEP 3108) through the
following Py3 interfaces:
>>> # Top-level packages with Py3 names provided on Py2:
>>> import html.parser
>>> import queue
>>> import tkinter.dialog
>>> import xmlrpc.client
>>> # etc.
>>> # Aliases provided for extensions to existing Py2 module names:
>>> from future.standard_library import install_aliases
>>> install_aliases()
>>> from collections import Counter, OrderedDict # backported to Py2.6
>>> from collections import UserDict, UserList, UserString
>>> import urllib.request
>>> from itertools import filterfalse, zip_longest
>>> from subprocess import getoutput, getstatusoutput
Automatic conversion
--------------------
An included script called `futurize
<https://python-future.org/automatic_conversion.html>`_ aids in converting
code (from either Python 2 or Python 3) to code compatible with both
platforms. It is similar to ``python-modernize`` but goes further in
providing Python 3 compatibility through the use of the backported types
and builtin functions in ``future``.
Documentation
-------------
See: https://python-future.org
Credits
-------
:Author: Ed Schofield, Jordan M. Adler, et al
:Sponsor: Python Charmers: https://pythoncharmers.com
:Others: See docs/credits.rst or https://python-future.org/credits.html
Licensing
---------
Copyright 2013-2024 Python Charmers, Australia.
The software is distributed under an MIT licence. See LICENSE.txt.
PK ;@u\�l�3 3 " future-1.0.0.dist-info/LICENSE.txtnu �[��� Copyright (c) 2013-2024 Python Charmers, Australia
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
PK @@u\ future-1.0.0.dist-info/REQUESTEDnu �[��� PK @@u\Z�w�& & $ future-1.0.0.dist-info/top_level.txtnu �[��� future
libfuturize
libpasteurize
past
PK B@u\}
�=X X ' future-1.0.0.dist-info/entry_points.txtnu �[��� [console_scripts]
futurize = libfuturize.main:main
pasteurize = libpasteurize.main:main
PK E@u\� �� future-1.0.0.dist-info/INSTALLERnu �[��� pip
PK J@u\E���
configparser.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Convenience module importing everything from backports.configparser."""
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
from backports.configparser import (
RawConfigParser,
ConfigParser,
SafeConfigParser,
SectionProxy,
Interpolation,
BasicInterpolation,
ExtendedInterpolation,
LegacyInterpolation,
NoSectionError,
DuplicateSectionError,
DuplicateOptionError,
NoOptionError,
InterpolationError,
InterpolationMissingOptionError,
InterpolationSyntaxError,
InterpolationDepthError,
ParsingError,
MissingSectionHeaderError,
ConverterMapping,
DEFAULTSECT,
MAX_INTERPOLATION_DEPTH,
)
from backports.configparser import Error, _UNSET, _default_dict, _ChainMap # noqa: F401
__all__ = [
"NoSectionError",
"DuplicateOptionError",
"DuplicateSectionError",
"NoOptionError",
"InterpolationError",
"InterpolationDepthError",
"InterpolationMissingOptionError",
"InterpolationSyntaxError",
"ParsingError",
"MissingSectionHeaderError",
"ConfigParser",
"SafeConfigParser",
"RawConfigParser",
"Interpolation",
"BasicInterpolation",
"ExtendedInterpolation",
"LegacyInterpolation",
"SectionProxy",
"ConverterMapping",
"DEFAULTSECT",
"MAX_INTERPOLATION_DEPTH",
]
# NOTE: names missing from __all__ imported anyway for backwards compatibility.
PK P@u\�9J�� � ' __pycache__/configparser.cpython-39.pycnu �[��� a
��?h
� @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlm Z m Z m Z m Z g d�Z d S )
zDConvenience module importing everything from backports.configparser.� )�absolute_import)�division)�print_function)�unicode_literals)�RawConfigParser� ConfigParser�SafeConfigParser� SectionProxy�
Interpolation�BasicInterpolation�ExtendedInterpolation�LegacyInterpolation�NoSectionError�DuplicateSectionError�DuplicateOptionError�
NoOptionError�InterpolationError� InterpolationMissingOptionError�InterpolationSyntaxError�InterpolationDepthError� ParsingError�MissingSectionHeaderError�ConverterMapping� DEFAULTSECT�MAX_INTERPOLATION_DEPTH)�Error�_UNSET�
_default_dict� _ChainMap)r r r r r r r r r r r r r r
r r r
r r r r N)!�__doc__�
__future__r r r r Zbackports.configparserr r r r r
r r r
r r r r r r r r r r r r r r r r r �__all__� r" r" �6/usr/local/lib/python3.9/site-packages/configparser.py�<module> s \PK U@u\�P2�\ \ " configparser-5.2.0.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: bdist_wheel (0.37.0)
Root-Is-Purelib: true
Tag: py3-none-any
PK W@u\�Yď $ configparser-5.2.0.dist-info/LICENSEnu �[��� Copyright Jason R. Coombs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.
PK Z@u\��� � # configparser-5.2.0.dist-info/RECORDnu �[��� __pycache__/configparser.cpython-39.pyc,,
backports/configparser/__init__.py,sha256=zjgAe9lH7_cTCyt7e-iyfyi007PfaMAVPhJCjM_TUPs,54655
backports/configparser/__pycache__/__init__.cpython-39.pyc,,
backports/configparser/__pycache__/compat.cpython-39.pyc,,
backports/configparser/compat.py,sha256=Z3Fo6AI4BfFRfNd9Fj8n1Yw2NW2r112uQTFEnF659Lc,404
configparser-5.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
configparser-5.2.0.dist-info/LICENSE,sha256=2z8CRrH5J48VhFuZ_sR4uLUG63ZIeZNyL4xuJUKF-vg,1050
configparser-5.2.0.dist-info/METADATA,sha256=4MeDipErpJIH61Zwu6BQ9f951Qu5HRg5RKFu3LYNZck,11053
configparser-5.2.0.dist-info/RECORD,,
configparser-5.2.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
configparser-5.2.0.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92
configparser-5.2.0.dist-info/top_level.txt,sha256=mIs8gajd7cvEWhVluv4u6ocaHw_TJ9rOrpkZEFv-7Hc,23
configparser.py,sha256=4VADEswCwzy_RDVgvje3BmZhD6iwo3k4EkUZcgzLD4M,1546
PK \@u\�J��-+ -+ % configparser-5.2.0.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: configparser
Version: 5.2.0
Summary: Updated configparser from Python 3.8 for Python 2.6+.
Home-page: https://github.com/jaraco/configparser/
Author: Łukasz Langa
Author-email: lukasz@langa.pl
Maintainer: Jason R. Coombs
Maintainer-email: jaraco@jaraco.com
License: UNKNOWN
Keywords: configparser ini parsing conf cfg configuration file
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6
License-File: LICENSE
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Requires-Dist: jaraco.packaging (>=8.2) ; extra == 'docs'
Requires-Dist: rst.linker (>=1.9) ; extra == 'docs'
Requires-Dist: jaraco.tidelift (>=1.4) ; extra == 'docs'
Provides-Extra: testing
Requires-Dist: pytest (>=6) ; extra == 'testing'
Requires-Dist: pytest-checkdocs (>=2.4) ; extra == 'testing'
Requires-Dist: pytest-flake8 ; extra == 'testing'
Requires-Dist: pytest-cov ; extra == 'testing'
Requires-Dist: pytest-enabler (>=1.0.1) ; extra == 'testing'
Requires-Dist: types-backports ; extra == 'testing'
Requires-Dist: pytest-black (>=0.3.7) ; (platform_python_implementation != "PyPy") and extra == 'testing'
Requires-Dist: pytest-mypy ; (platform_python_implementation != "PyPy") and extra == 'testing'
.. image:: https://img.shields.io/pypi/v/configparser.svg
:target: `PyPI link`_
.. image:: https://img.shields.io/pypi/pyversions/configparser.svg
:target: `PyPI link`_
.. _PyPI link: https://pypi.org/project/configparser
.. image:: https://github.com/jaraco/configparser/workflows/tests/badge.svg
:target: https://github.com/jaraco/configparser/actions?query=workflow%3A%22tests%22
:alt: tests
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
:alt: Code style: Black
.. image:: https://readthedocs.org/projects/configparser/badge/?version=latest
:target: https://configparser.readthedocs.io/en/latest/?badge=latest
.. image:: https://img.shields.io/badge/skeleton-2021-informational
:target: https://blog.jaraco.com/skeleton
.. image:: https://tidelift.com/badges/package/pypi/configparser
:target: https://tidelift.com/subscription/pkg/pypi-configparser?utm_source=pypi-configparser&utm_medium=readme
This package is a backport of the refreshed and enhanced ConfigParser from
later Python versions. To use the backport instead of the built-in version,
simply import it explicitly as a backport::
from backports import configparser
To use the backport on Python 2 and the built-in version on
Python 3, use the standard invocation::
import configparser
For detailed documentation consult the vanilla version at
http://docs.python.org/3/library/configparser.html.
Why you'll love ``configparser``
--------------------------------
Whereas almost completely compatible with its older brother, ``configparser``
sports a bunch of interesting new features:
* full mapping protocol access (`more info
<http://docs.python.org/3/library/configparser.html#mapping-protocol-access>`_)::
>>> parser = ConfigParser()
>>> parser.read_string("""
[DEFAULT]
location = upper left
visible = yes
editable = no
color = blue
[main]
title = Main Menu
color = green
[options]
title = Options
""")
>>> parser['main']['color']
'green'
>>> parser['main']['editable']
'no'
>>> section = parser['options']
>>> section['title']
'Options'
>>> section['title'] = 'Options (editable: %(editable)s)'
>>> section['title']
'Options (editable: no)'
* there's now one default ``ConfigParser`` class, which basically is the old
``SafeConfigParser`` with a bunch of tweaks which make it more predictable for
users. Don't need interpolation? Simply use
``ConfigParser(interpolation=None)``, no need to use a distinct
``RawConfigParser`` anymore.
* the parser is highly `customizable upon instantiation
<http://docs.python.org/3/library/configparser.html#customizing-parser-behaviour>`__
supporting things like changing option delimiters, comment characters, the
name of the DEFAULT section, the interpolation syntax, etc.
* you can easily create your own interpolation syntax but there are two powerful
implementations built-in (`more info
<http://docs.python.org/3/library/configparser.html#interpolation-of-values>`__):
* the classic ``%(string-like)s`` syntax (called ``BasicInterpolation``)
* a new ``${buildout:like}`` syntax (called ``ExtendedInterpolation``)
* fallback values may be specified in getters (`more info
<http://docs.python.org/3/library/configparser.html#fallback-values>`__)::
>>> config.get('closet', 'monster',
... fallback='No such things as monsters')
'No such things as monsters'
* ``ConfigParser`` objects can now read data directly `from strings
<http://docs.python.org/3/library/configparser.html#configparser.ConfigParser.read_string>`__
and `from dictionaries
<http://docs.python.org/3/library/configparser.html#configparser.ConfigParser.read_dict>`__.
That means importing configuration from JSON or specifying default values for
the whole configuration (multiple sections) is now a single line of code. Same
goes for copying data from another ``ConfigParser`` instance, thanks to its
mapping protocol support.
* many smaller tweaks, updates and fixes
A few words about Unicode
-------------------------
``configparser`` comes from Python 3 and as such it works well with Unicode.
The library is generally cleaned up in terms of internal data storage and
reading/writing files. There are a couple of incompatibilities with the old
``ConfigParser`` due to that. However, the work required to migrate is well
worth it as it shows the issues that would likely come up during migration of
your project to Python 3.
The design assumes that Unicode strings are used whenever possible [1]_. That
gives you the certainty that what's stored in a configuration object is text.
Once your configuration is read, the rest of your application doesn't have to
deal with encoding issues. All you have is text [2]_. The only two phases when
you should explicitly state encoding is when you either read from an external
source (e.g. a file) or write back.
Versioning
----------
This project uses `semver <https://semver.org/spec/v2.0.0.html>`_ to
communicate the impact of various releases while periodically syncing
with the upstream implementation in CPython.
The `history <https://configparser.readthedocs.io/en/latest/history.html>`_
serves as a reference indicating which versions incorporate
which upstream functionality.
Prior to the ``4.0.0`` release, `another scheme
<https://github.com/jaraco/configparser/blob/3.8.1/README.rst#versioning>`_
was used to associate the CPython and backports releases.
Maintenance
-----------
This backport was originally authored by Łukasz Langa, the current vanilla
``configparser`` maintainer for CPython and is currently maintained by
Jason R. Coombs:
* `configparser repository <https://github.com/jaraco/configparser>`_
* `configparser issue tracker <https://github.com/jaraco/configparser/issues>`_
For Enterprise
==============
Available as part of the Tidelift Subscription.
This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
`Learn more <https://tidelift.com/subscription/pkg/pypi-configparser?utm_source=pypi-configparser&utm_medium=referral&utm_campaign=github>`_.
Security Contact
----------------
To report a security vulnerability, please use the
`Tidelift security contact <https://tidelift.com/security>`_.
Tidelift will coordinate the fix and disclosure.
Conversion Process
------------------
This section is technical and should bother you only if you are wondering how
this backport is produced. If the implementation details of this backport are
not important for you, feel free to ignore the following content.
The project takes the following branching approach:
* The ``3.x`` branch holds unchanged files synchronized from the upstream
CPython repository. The synchronization is currently done by manually copying
the required files and stating from which CPython changeset they come.
* The ``main`` branch holds a version of the ``3.x`` code with some tweaks
that make it compatible with older Pythons. Code on this branch must work
on all supported Python versions. Test with ``tox`` or in CI.
The process works like this:
1. In the ``3.x`` branch, run ``pip-run -- sync-upstream.py``, which
downloads the latest stable release of Python and copies the relevant
files from there into their new locations and then commits those
changes with a nice reference to the relevant upstream commit hash.
2. Check for new names in ``__all__`` and update imports in
``configparser.py`` accordingly. Optionally, run the tests on a late
Python 3. Commit.
3. Merge the new commit to ``main``. Run tests. Commit.
4. Make any compatibility changes on ``main``. Run tests. Commit.
5. Update the docs and release the new version.
Footnotes
---------
.. [1] To somewhat ease migration, passing bytestrings is still supported but
they are converted to Unicode for internal storage anyway. This means
that for the vast majority of strings used in configuration files, it
won't matter if you pass them as bytestrings or Unicode. However, if you
pass a bytestring that cannot be converted to Unicode using the naive
ASCII codec, a ``UnicodeDecodeError`` will be raised. This is purposeful
and helps you manage proper encoding for all content you store in
memory, read from various sources and write back.
.. [2] Life gets much easier when you understand that you basically manage
**text** in your application. You don't care about bytes but about
letters. In that regard the concept of content encoding is meaningless.
The only time when you deal with raw bytes is when you write the data to
a file. Then you have to specify how your text should be encoded. On
the other end, to get meaningful text from a file, the application
reading it has to know which encoding was used during its creation. But
once the bytes are read and properly decoded, all you have is text. This
is especially powerful when you start interacting with multiple data
sources. Even if each of them uses a different encoding, inside your
application data is held in abstract text form. You can program your
business logic without worrying about which data came from which source.
You can freely exchange the data you store between sources. Only
reading/writing files requires encoding your text to bytes.
PK a@u\ & configparser-5.2.0.dist-info/REQUESTEDnu �[��� PK a@u\� * configparser-5.2.0.dist-info/top_level.txtnu �[��� backports
configparser
PK c@u\� �� & configparser-5.2.0.dist-info/INSTALLERnu �[��� pip
PK i@u\h��[ [ ! certifi-2024.8.30.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: setuptools (74.0.0)
Root-Is-Purelib: true
Tag: py3-none-any
PK k@u\�+2� � # certifi-2024.8.30.dist-info/LICENSEnu �[��� This package contains a modified version of ca-bundle.crt:
ca-bundle.crt -- Bundle of CA Root Certificates
This is a bundle of X.509 certificates of public Certificate Authorities
(CA). These were automatically extracted from Mozilla's root certificates
file (certdata.txt). This file can be found in the mozilla source tree:
https://hg.mozilla.org/mozilla-central/file/tip/security/nss/lib/ckfw/builtins/certdata.txt
It contains the certificates in PEM format and therefore
can be directly used with curl / libcurl / php_curl, or with
an Apache+mod_ssl webserver for SSL client authentication.
Just configure this file as the SSLCACertificateFile.#
***** BEGIN LICENSE BLOCK *****
This Source Code Form is subject to the terms of the Mozilla Public License,
v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain
one at http://mozilla.org/MPL/2.0/.
***** END LICENSE BLOCK *****
@(#) $RCSfile: certdata.txt,v $ $Revision: 1.80 $ $Date: 2011/11/03 15:11:58 $
PK n@u\���%O O " certifi-2024.8.30.dist-info/RECORDnu �[��� certifi-2024.8.30.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
certifi-2024.8.30.dist-info/LICENSE,sha256=6TcW2mucDVpKHfYP5pWzcPBpVgPSH2-D8FPkLPwQyvc,989
certifi-2024.8.30.dist-info/METADATA,sha256=GhBHRVUN6a4ZdUgE_N5wmukJfyuoE-QyIl8Y3ifNQBM,2222
certifi-2024.8.30.dist-info/RECORD,,
certifi-2024.8.30.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
certifi-2024.8.30.dist-info/WHEEL,sha256=UvcQYKBHoFqaQd6LKyqHw9fxEolWLQnlzP0h_LgJAfI,91
certifi-2024.8.30.dist-info/top_level.txt,sha256=KMu4vUCfsjLrkPbSNdgdekS-pVJzBAJFO__nI8NF6-U,8
certifi/__init__.py,sha256=p_GYZrjUwPBUhpLlCZoGb0miKBKSqDAyZC5DvIuqbHQ,94
certifi/__main__.py,sha256=xBBoj905TUWBLRGANOcf7oi6e-3dMP4cEoG9OyMs11g,243
certifi/__pycache__/__init__.cpython-39.pyc,,
certifi/__pycache__/__main__.cpython-39.pyc,,
certifi/__pycache__/core.cpython-39.pyc,,
certifi/cacert.pem,sha256=lO3rZukXdPyuk6BWUJFOKQliWaXH6HGh9l1GGrUgG0c,299427
certifi/core.py,sha256=qRDDFyXVJwTB_EmoGppaXU_R9qCZvhl-EzxPMuV3nTA,4426
certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
PK p@u\�AϺ� � $ certifi-2024.8.30.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: certifi
Version: 2024.8.30
Summary: Python package for providing Mozilla's CA Bundle.
Home-page: https://github.com/certifi/python-certifi
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: MPL-2.0
Project-URL: Source, https://github.com/certifi/python-certifi
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.6
License-File: LICENSE
Certifi: Python SSL Certificates
================================
Certifi provides Mozilla's carefully curated collection of Root Certificates for
validating the trustworthiness of SSL certificates while verifying the identity
of TLS hosts. It has been extracted from the `Requests`_ project.
Installation
------------
``certifi`` is available on PyPI. Simply install it with ``pip``::
$ pip install certifi
Usage
-----
To reference the installed certificate authority (CA) bundle, you can use the
built-in function::
>>> import certifi
>>> certifi.where()
'/usr/local/lib/python3.7/site-packages/certifi/cacert.pem'
Or from the command line::
$ python -m certifi
/usr/local/lib/python3.7/site-packages/certifi/cacert.pem
Enjoy!
.. _`Requests`: https://requests.readthedocs.io/en/master/
Addition/Removal of Certificates
--------------------------------
Certifi does not support any addition/removal or other modification of the
CA trust store content. This project is intended to provide a reliable and
highly portable root of trust to python deployments. Look to upstream projects
for methods to use alternate trust.
PK s@u\ % certifi-2024.8.30.dist-info/REQUESTEDnu �[��� PK s@u\]�� ) certifi-2024.8.30.dist-info/top_level.txtnu �[��� certifi
PK u@u\� �� % certifi-2024.8.30.dist-info/INSTALLERnu �[��� pip
PK {@u\
^��L L past/__init__.pynu �[��� # coding=utf-8
"""
past: compatibility with Python 2 from Python 3
===============================================
``past`` is a package to aid with Python 2/3 compatibility. Whereas ``future``
contains backports of Python 3 constructs to Python 2, ``past`` provides
implementations of some Python 2 constructs in Python 3 and tools to import and
run Python 2 code in Python 3. It is intended to be used sparingly, as a way of
running old Python 2 code from Python 3 until the code is ported properly.
Potential uses for libraries:
- as a step in porting a Python 2 codebase to Python 3 (e.g. with the ``futurize`` script)
- to provide Python 3 support for previously Python 2-only libraries with the
same APIs as on Python 2 -- particularly with regard to 8-bit strings (the
``past.builtins.str`` type).
- to aid in providing minimal-effort Python 3 support for applications using
libraries that do not yet wish to upgrade their code properly to Python 3, or
wish to upgrade it gradually to Python 3 style.
Here are some code examples that run identically on Python 3 and 2::
>>> from past.builtins import str as oldstr
>>> philosopher = oldstr(u'\u5b54\u5b50'.encode('utf-8'))
>>> # This now behaves like a Py2 byte-string on both Py2 and Py3.
>>> # For example, indexing returns a Python 2-like string object, not
>>> # an integer:
>>> philosopher[0]
'\xe5'
>>> type(philosopher[0])
<past.builtins.oldstr>
>>> # List-producing versions of range, reduce, map, filter
>>> from past.builtins import range, reduce
>>> range(10)
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
>>> reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])
15
>>> # Other functions removed in Python 3 are resurrected ...
>>> from past.builtins import execfile
>>> execfile('myfile.py')
>>> from past.builtins import raw_input
>>> name = raw_input('What is your name? ')
What is your name? [cursor]
>>> from past.builtins import reload
>>> reload(mymodule) # equivalent to imp.reload(mymodule) in Python 3
>>> from past.builtins import xrange
>>> for i in xrange(10):
... pass
It also provides import hooks so you can import and use Python 2 modules like
this::
$ python3
>>> from past.translation import autotranslate
>>> authotranslate('mypy2module')
>>> import mypy2module
until the authors of the Python 2 modules have upgraded their code. Then, for
example::
>>> mypy2module.func_taking_py2_string(oldstr(b'abcd'))
Credits
-------
:Author: Ed Schofield, Jordan M. Adler, et al
:Sponsor: Python Charmers: https://pythoncharmers.com
Licensing
---------
Copyright 2013-2024 Python Charmers, Australia.
The software is distributed under an MIT licence. See LICENSE.txt.
"""
from future import __version__, __copyright__, __license__
__title__ = 'past'
__author__ = 'Ed Schofield'
PK �@u\8�p�B: B: past/translation/__init__.pynu �[��� # -*- coding: utf-8 -*-
"""
past.translation
==================
The ``past.translation`` package provides an import hook for Python 3 which
transparently runs ``futurize`` fixers over Python 2 code on import to convert
print statements into functions, etc.
It is intended to assist users in migrating to Python 3.x even if some
dependencies still only support Python 2.x.
Usage
-----
Once your Py2 package is installed in the usual module search path, the import
hook is invoked as follows:
>>> from past.translation import autotranslate
>>> autotranslate('mypackagename')
Or:
>>> autotranslate(['mypackage1', 'mypackage2'])
You can unregister the hook using::
>>> from past.translation import remove_hooks
>>> remove_hooks()
Author: Ed Schofield.
Inspired by and based on ``uprefix`` by Vinay M. Sajip.
"""
import sys
# imp was deprecated in python 3.6
if sys.version_info >= (3, 6):
import importlib as imp
else:
import imp
import logging
import os
import copy
from lib2to3.pgen2.parse import ParseError
from lib2to3.refactor import RefactoringTool
from libfuturize import fixes
try:
from importlib.machinery import (
PathFinder,
SourceFileLoader,
)
except ImportError:
PathFinder = None
SourceFileLoader = object
if sys.version_info[:2] < (3, 4):
import imp
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
myfixes = (list(fixes.libfuturize_fix_names_stage1) +
list(fixes.lib2to3_fix_names_stage1) +
list(fixes.libfuturize_fix_names_stage2) +
list(fixes.lib2to3_fix_names_stage2))
# We detect whether the code is Py2 or Py3 by applying certain lib2to3 fixers
# to it. If the diff is empty, it's Python 3 code.
py2_detect_fixers = [
# From stage 1:
'lib2to3.fixes.fix_apply',
# 'lib2to3.fixes.fix_dict', # TODO: add support for utils.viewitems() etc. and move to stage2
'lib2to3.fixes.fix_except',
'lib2to3.fixes.fix_execfile',
'lib2to3.fixes.fix_exitfunc',
'lib2to3.fixes.fix_funcattrs',
'lib2to3.fixes.fix_filter',
'lib2to3.fixes.fix_has_key',
'lib2to3.fixes.fix_idioms',
'lib2to3.fixes.fix_import', # makes any implicit relative imports explicit. (Use with ``from __future__ import absolute_import)
'lib2to3.fixes.fix_intern',
'lib2to3.fixes.fix_isinstance',
'lib2to3.fixes.fix_methodattrs',
'lib2to3.fixes.fix_ne',
'lib2to3.fixes.fix_numliterals', # turns 1L into 1, 0755 into 0o755
'lib2to3.fixes.fix_paren',
'lib2to3.fixes.fix_print',
'lib2to3.fixes.fix_raise', # uses incompatible with_traceback() method on exceptions
'lib2to3.fixes.fix_renames',
'lib2to3.fixes.fix_reduce',
# 'lib2to3.fixes.fix_set_literal', # this is unnecessary and breaks Py2.6 support
'lib2to3.fixes.fix_repr',
'lib2to3.fixes.fix_standarderror',
'lib2to3.fixes.fix_sys_exc',
'lib2to3.fixes.fix_throw',
'lib2to3.fixes.fix_tuple_params',
'lib2to3.fixes.fix_types',
'lib2to3.fixes.fix_ws_comma',
'lib2to3.fixes.fix_xreadlines',
# From stage 2:
'lib2to3.fixes.fix_basestring',
# 'lib2to3.fixes.fix_buffer', # perhaps not safe. Test this.
# 'lib2to3.fixes.fix_callable', # not needed in Py3.2+
# 'lib2to3.fixes.fix_dict', # TODO: add support for utils.viewitems() etc.
'lib2to3.fixes.fix_exec',
# 'lib2to3.fixes.fix_future', # we don't want to remove __future__ imports
'lib2to3.fixes.fix_getcwdu',
# 'lib2to3.fixes.fix_imports', # called by libfuturize.fixes.fix_future_standard_library
# 'lib2to3.fixes.fix_imports2', # we don't handle this yet (dbm)
# 'lib2to3.fixes.fix_input',
# 'lib2to3.fixes.fix_itertools',
# 'lib2to3.fixes.fix_itertools_imports',
'lib2to3.fixes.fix_long',
# 'lib2to3.fixes.fix_map',
# 'lib2to3.fixes.fix_metaclass', # causes SyntaxError in Py2! Use the one from ``six`` instead
'lib2to3.fixes.fix_next',
'lib2to3.fixes.fix_nonzero', # TODO: add a decorator for mapping __bool__ to __nonzero__
# 'lib2to3.fixes.fix_operator', # we will need support for this by e.g. extending the Py2 operator module to provide those functions in Py3
'lib2to3.fixes.fix_raw_input',
# 'lib2to3.fixes.fix_unicode', # strips off the u'' prefix, which removes a potentially helpful source of information for disambiguating unicode/byte strings
# 'lib2to3.fixes.fix_urllib',
'lib2to3.fixes.fix_xrange',
# 'lib2to3.fixes.fix_zip',
]
class RTs:
"""
A namespace for the refactoring tools. This avoids creating these at
the module level, which slows down the module import. (See issue #117).
There are two possible grammars: with or without the print statement.
Hence we have two possible refactoring tool implementations.
"""
_rt = None
_rtp = None
_rt_py2_detect = None
_rtp_py2_detect = None
@staticmethod
def setup():
"""
Call this before using the refactoring tools to create them on demand
if needed.
"""
if None in [RTs._rt, RTs._rtp]:
RTs._rt = RefactoringTool(myfixes)
RTs._rtp = RefactoringTool(myfixes, {'print_function': True})
@staticmethod
def setup_detect_python2():
"""
Call this before using the refactoring tools to create them on demand
if needed.
"""
if None in [RTs._rt_py2_detect, RTs._rtp_py2_detect]:
RTs._rt_py2_detect = RefactoringTool(py2_detect_fixers)
RTs._rtp_py2_detect = RefactoringTool(py2_detect_fixers,
{'print_function': True})
# We need to find a prefix for the standard library, as we don't want to
# process any files there (they will already be Python 3).
#
# The following method is used by Sanjay Vinip in uprefix. This fails for
# ``conda`` environments:
# # In a non-pythonv virtualenv, sys.real_prefix points to the installed Python.
# # In a pythonv venv, sys.base_prefix points to the installed Python.
# # Outside a virtual environment, sys.prefix points to the installed Python.
# if hasattr(sys, 'real_prefix'):
# _syslibprefix = sys.real_prefix
# else:
# _syslibprefix = getattr(sys, 'base_prefix', sys.prefix)
# Instead, we use the portion of the path common to both the stdlib modules
# ``math`` and ``urllib``.
def splitall(path):
"""
Split a path into all components. From Python Cookbook.
"""
allparts = []
while True:
parts = os.path.split(path)
if parts[0] == path: # sentinel for absolute paths
allparts.insert(0, parts[0])
break
elif parts[1] == path: # sentinel for relative paths
allparts.insert(0, parts[1])
break
else:
path = parts[0]
allparts.insert(0, parts[1])
return allparts
def common_substring(s1, s2):
"""
Returns the longest common substring to the two strings, starting from the
left.
"""
chunks = []
path1 = splitall(s1)
path2 = splitall(s2)
for (dir1, dir2) in zip(path1, path2):
if dir1 != dir2:
break
chunks.append(dir1)
return os.path.join(*chunks)
# _stdlibprefix = common_substring(math.__file__, urllib.__file__)
def detect_python2(source, pathname):
"""
Returns a bool indicating whether we think the code is Py2
"""
RTs.setup_detect_python2()
try:
tree = RTs._rt_py2_detect.refactor_string(source, pathname)
except ParseError as e:
if e.msg != 'bad input' or e.value != '=':
raise
tree = RTs._rtp.refactor_string(source, pathname)
if source != str(tree)[:-1]: # remove added newline
# The above fixers made changes, so we conclude it's Python 2 code
logger.debug('Detected Python 2 code: {0}'.format(pathname))
return True
else:
logger.debug('Detected Python 3 code: {0}'.format(pathname))
return False
def transform(source, pathname):
# This implementation uses lib2to3,
# you can override and use something else
# if that's better for you
# lib2to3 likes a newline at the end
RTs.setup()
source += '\n'
try:
tree = RTs._rt.refactor_string(source, pathname)
except ParseError as e:
if e.msg != 'bad input' or e.value != '=':
raise
tree = RTs._rtp.refactor_string(source, pathname)
# could optimise a bit for only doing str(tree) if
# getattr(tree, 'was_changed', False) returns True
return str(tree)[:-1] # remove added newline
class PastSourceFileLoader(SourceFileLoader):
exclude_paths = []
include_paths = []
def _convert_needed(self):
fullname = self.name
if any(fullname.startswith(path) for path in self.exclude_paths):
convert = False
elif any(fullname.startswith(path) for path in self.include_paths):
convert = True
else:
convert = False
return convert
def _exec_transformed_module(self, module):
source = self.get_source(self.name)
pathname = self.path
if detect_python2(source, pathname):
source = transform(source, pathname)
code = compile(source, pathname, "exec")
exec(code, module.__dict__)
# For Python 3.3
def load_module(self, fullname):
logger.debug("Running load_module for %s", fullname)
if fullname in sys.modules:
mod = sys.modules[fullname]
else:
if self._convert_needed():
logger.debug("Autoconverting %s", fullname)
mod = imp.new_module(fullname)
sys.modules[fullname] = mod
# required by PEP 302
mod.__file__ = self.path
mod.__loader__ = self
if self.is_package(fullname):
mod.__path__ = []
mod.__package__ = fullname
else:
mod.__package__ = fullname.rpartition('.')[0]
self._exec_transformed_module(mod)
else:
mod = super().load_module(fullname)
return mod
# For Python >=3.4
def exec_module(self, module):
logger.debug("Running exec_module for %s", module)
if self._convert_needed():
logger.debug("Autoconverting %s", self.name)
self._exec_transformed_module(module)
else:
super().exec_module(module)
class Py2Fixer(object):
"""
An import hook class that uses lib2to3 for source-to-source translation of
Py2 code to Py3.
"""
# See the comments on :class:future.standard_library.RenameImport.
# We add this attribute here so remove_hooks() and install_hooks() can
# unambiguously detect whether the import hook is installed:
PY2FIXER = True
def __init__(self):
self.found = None
self.base_exclude_paths = ['future', 'past']
self.exclude_paths = copy.copy(self.base_exclude_paths)
self.include_paths = []
def include(self, paths):
"""
Pass in a sequence of module names such as 'plotrique.plotting' that,
if present at the leftmost side of the full package name, would
specify the module to be transformed from Py2 to Py3.
"""
self.include_paths += paths
def exclude(self, paths):
"""
Pass in a sequence of strings such as 'mymodule' that, if
present at the leftmost side of the full package name, would cause
the module not to undergo any source transformation.
"""
self.exclude_paths += paths
# For Python 3.3
def find_module(self, fullname, path=None):
logger.debug("Running find_module: (%s, %s)", fullname, path)
loader = PathFinder.find_module(fullname, path)
if not loader:
logger.debug("Py2Fixer could not find %s", fullname)
return None
loader.__class__ = PastSourceFileLoader
loader.exclude_paths = self.exclude_paths
loader.include_paths = self.include_paths
return loader
# For Python >=3.4
def find_spec(self, fullname, path=None, target=None):
logger.debug("Running find_spec: (%s, %s, %s)", fullname, path, target)
spec = PathFinder.find_spec(fullname, path, target)
if not spec:
logger.debug("Py2Fixer could not find %s", fullname)
return None
spec.loader.__class__ = PastSourceFileLoader
spec.loader.exclude_paths = self.exclude_paths
spec.loader.include_paths = self.include_paths
return spec
_hook = Py2Fixer()
def install_hooks(include_paths=(), exclude_paths=()):
if isinstance(include_paths, str):
include_paths = (include_paths,)
if isinstance(exclude_paths, str):
exclude_paths = (exclude_paths,)
assert len(include_paths) + len(exclude_paths) > 0, 'Pass at least one argument'
_hook.include(include_paths)
_hook.exclude(exclude_paths)
# _hook.debug = debug
enable = sys.version_info[0] >= 3 # enabled for all 3.x+
if enable and _hook not in sys.meta_path:
sys.meta_path.insert(0, _hook) # insert at beginning. This could be made a parameter
# We could return the hook when there are ways of configuring it
#return _hook
def remove_hooks():
if _hook in sys.meta_path:
sys.meta_path.remove(_hook)
def detect_hooks():
"""
Returns True if the import hooks are installed, False if not.
"""
return _hook in sys.meta_path
# present = any([hasattr(hook, 'PY2FIXER') for hook in sys.meta_path])
# return present
class hooks(object):
"""
Acts as a context manager. Use like this:
>>> from past import translation
>>> with translation.hooks():
... import mypy2module
>>> import requests # py2/3 compatible anyway
>>> # etc.
"""
def __enter__(self):
self.hooks_were_installed = detect_hooks()
install_hooks()
return self
def __exit__(self, *args):
if not self.hooks_were_installed:
remove_hooks()
class suspend_hooks(object):
"""
Acts as a context manager. Use like this:
>>> from past import translation
>>> translation.install_hooks()
>>> import http.client
>>> # ...
>>> with translation.suspend_hooks():
>>> import requests # or others that support Py2/3
If the hooks were disabled before the context, they are not installed when
the context is left.
"""
def __enter__(self):
self.hooks_were_installed = detect_hooks()
remove_hooks()
return self
def __exit__(self, *args):
if self.hooks_were_installed:
install_hooks()
# alias
autotranslate = install_hooks
PK �@u\��!��+ �+ 4 past/translation/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hB: � @ s� d Z ddlZejdkr ddlZnddlZddlZddlZddlZddlm Z ddl
m Z ddl m
Z
zddlmZmZ W n ey� dZeZY n0 ejdd� d k r�ddlZe�e�Ze�ej� ee
j�ee
j� ee
j� ee
j � Z g d
�Z G d d � d �Z d
d� Z dd� Z!dd� Z"dd� Z#G dd� de�Z$G dd� de�Z%e%� Z&d$dd�Z'd d � Z(d d � Z)G d d!� d!e�Z*G d"d#� d#e�Z+e'Z,dS )%a'
past.translation
==================
The ``past.translation`` package provides an import hook for Python 3 which
transparently runs ``futurize`` fixers over Python 2 code on import to convert
print statements into functions, etc.
It is intended to assist users in migrating to Python 3.x even if some
dependencies still only support Python 2.x.
Usage
-----
Once your Py2 package is installed in the usual module search path, the import
hook is invoked as follows:
>>> from past.translation import autotranslate
>>> autotranslate('mypackagename')
Or:
>>> autotranslate(['mypackage1', 'mypackage2'])
You can unregister the hook using::
>>> from past.translation import remove_hooks
>>> remove_hooks()
Author: Ed Schofield.
Inspired by and based on ``uprefix`` by Vinay M. Sajip.
� N)� � )�
ParseError)�RefactoringTool)�fixes)�
PathFinder�SourceFileLoader� )r � )#zlib2to3.fixes.fix_applyzlib2to3.fixes.fix_exceptzlib2to3.fixes.fix_execfilezlib2to3.fixes.fix_exitfunczlib2to3.fixes.fix_funcattrszlib2to3.fixes.fix_filterzlib2to3.fixes.fix_has_keyzlib2to3.fixes.fix_idiomszlib2to3.fixes.fix_importzlib2to3.fixes.fix_internz lib2to3.fixes.fix_isinstancez lib2to3.fixes.fix_methodattrszlib2to3.fixes.fix_nez lib2to3.fixes.fix_numliteralszlib2to3.fixes.fix_parenzlib2to3.fixes.fix_printzlib2to3.fixes.fix_raisezlib2to3.fixes.fix_renameszlib2to3.fixes.fix_reducezlib2to3.fixes.fix_reprz lib2to3.fixes.fix_standarderrorzlib2to3.fixes.fix_sys_exczlib2to3.fixes.fix_throwz lib2to3.fixes.fix_tuple_paramszlib2to3.fixes.fix_typeszlib2to3.fixes.fix_ws_commaz lib2to3.fixes.fix_xreadlinesz lib2to3.fixes.fix_basestringzlib2to3.fixes.fix_execzlib2to3.fixes.fix_getcwduzlib2to3.fixes.fix_longzlib2to3.fixes.fix_nextzlib2to3.fixes.fix_nonzerozlib2to3.fixes.fix_raw_inputzlib2to3.fixes.fix_xrangec @ s8 e Zd ZdZdZdZdZdZedd� �Z edd� �Z
dS )�RTsa&
A namespace for the refactoring tools. This avoids creating these at
the module level, which slows down the module import. (See issue #117).
There are two possible grammars: with or without the print statement.
Hence we have two possible refactoring tool implementations.
Nc C s. dt jt jfv r*tt�t _ttddi�t _dS �zj
Call this before using the refactoring tools to create them on demand
if needed.
N�print_functionT)r �_rt�_rtpr �myfixes� r r �C/usr/local/lib/python3.9/site-packages/past/translation/__init__.py�setup� s
z RTs.setupc C s. dt jt jfv r*tt�t _ttddi�t _dS r )r �_rt_py2_detect�_rtp_py2_detectr �py2_detect_fixersr r r r �setup_detect_python2� s
�zRTs.setup_detect_python2) �__name__�
__module__� __qualname__�__doc__r r r r � staticmethodr r r r r r r � s
r c C sn g }t j�| �}|d | kr0|�d|d � qjq|d | krP|�d|d � qjq|d } |�d|d � q|S )zA
Split a path into all components. From Python Cookbook.
r � )�os�path�split�insert)r Zallparts�partsr r r �splitall� s r# c C sJ g }t | �}t |�}t||�D ] \}}||kr2 q>|�|� q tjj|� S )z^
Returns the longest common substring to the two strings, starting from the
left.
)r# �zip�appendr r �join)�s1�s2�chunksZpath1Zpath2Zdir1Zdir2r r r �common_substring� s r* c
C s� t �� zt j�| |�}W nH tyb } z0|jdks>|jdkr@� t j�| |�}W Y d}~n
d}~0 0 | t|�dd� kr�t �
d� |�� dS t �
d� |�� dS dS ) zD
Returns a bool indicating whether we think the code is Py2
� bad input�=N���zDetected Python 2 code: {0}TzDetected Python 3 code: {0}F) r r r �refactor_stringr �msg�valuer �str�logger�debug�format��source�pathname�tree�er r r �detect_python2� s $r: c
C s| t �� | d7 } zt j�| |�}W nH tyj } z0|jdksF|jdkrH� t j�| |�}W Y d }~n
d }~0 0 t|�d d� S )N�
r+ r, r- ) r r r r. r r/ r0 r r1 r5 r r r � transform� s $r< c s@ e Zd Zg Zg Zdd� Zdd� Z� fdd�Z� fdd�Z� Z S ) �PastSourceFileLoaderc sJ | j � t� fdd�| jD ��r$d}n"t� fdd�| jD ��rBd}nd}|S )Nc 3 s | ]}� � |�V qd S �N��
startswith��.0r ��fullnamer r � <genexpr> � z7PastSourceFileLoader._convert_needed.<locals>.<genexpr>Fc 3 s | ]}� � |�V qd S r> r? rA rC r r rE
rF T)�name�any�
exclude_paths�
include_paths)�self�convertr rC r �_convert_needed s z$PastSourceFileLoader._convert_neededc C sB | � | j�}| j}t||�r&t||�}t||d�}t||j� d S )N�exec)�
get_sourcerG r r: r< �compilerN �__dict__)rK �moduler6 r7 �coder r r �_exec_transformed_module s
z-PastSourceFileLoader._exec_transformed_modulec s� t �d|� |tjv r"tj| }nv| �� r�t �d|� t�|�}|tj|< | j|_| |_ | �
|�rpg |_ ||_ n|�
d�d |_ | �|� n t� �|�}|S )NzRunning load_module for %s�Autoconverting %s�.r )r2 r3 �sys�modulesrM �impZ
new_moduler �__file__�
__loader__�
is_package�__path__� __package__�
rpartitionrT �super� load_module)rK rD �mod�� __class__r r ra s
z PastSourceFileLoader.load_modulec s> t �d|� | �� r.t �d| j� | �|� n t� �|� d S )NzRunning exec_module for %srU )r2 r3 rM rG rT r` � exec_module)rK rR rc r r re 4 s
z PastSourceFileLoader.exec_module)
r r r rI rJ rM rT ra re �
__classcell__r r rc r r= s
r= c @ s@ e Zd ZdZdZdd� Zdd� Zdd� Zdd
d �Zdd d
�Z d S )�Py2Fixerzi
An import hook class that uses lib2to3 for source-to-source translation of
Py2 code to Py3.
Tc C s( d | _ ddg| _t�| j�| _g | _d S )N�futureZpast)�foundZbase_exclude_paths�copyrI rJ �rK r r r �__init__H s
zPy2Fixer.__init__c C s | j |7 _ dS )z�
Pass in a sequence of module names such as 'plotrique.plotting' that,
if present at the leftmost side of the full package name, would
specify the module to be transformed from Py2 to Py3.
N)rJ �rK �pathsr r r �includeN s zPy2Fixer.includec C s | j |7 _ dS )z�
Pass in a sequence of strings such as 'mymodule' that, if
present at the leftmost side of the full package name, would cause
the module not to undergo any source transformation.
N)rI rm r r r �excludeV s zPy2Fixer.excludeNc C sH t �d||� t�||�}|s.t �d|� d S t|_| j|_| j|_|S )Nz Running find_module: (%s, %s)�Py2Fixer could not find %s)r2 r3 r � find_moduler= rd rI rJ )rK rD r �loaderr r r rr _ s zPy2Fixer.find_modulec C sR t �d|||� t�|||�}|s2t �d|� d S t|j_| j|j_| j|j_|S )Nz Running find_spec: (%s, %s, %s)rq ) r2 r3 r � find_specr= rs rd rI rJ )rK rD r �target�specr r r rt k s
zPy2Fixer.find_spec)N)NN)
r r r r ZPY2FIXERrl ro rp rr rt r r r r rg = s
rg r c C s~ t | t�r| f} t |t�r |f}t| �t|� dks<J d��t�| � t�|� tjd dk}|rzttjvrztj� dt� d S )Nr zPass at least one argumentr )
�
isinstancer1 �len�_hookro rp rW � version_info� meta_pathr! )rJ rI �enabler r r �
install_hooksz s
r} c C s t tjv rtj�t � d S r> )ry rW r{ �remover r r r � remove_hooks� s
r c C s
t tjv S )zG
Returns True if the import hooks are installed, False if not.
)ry rW r{ r r r r � detect_hooks� s r� c @ s e Zd ZdZdd� Zdd� ZdS )�hooksz�
Acts as a context manager. Use like this:
>>> from past import translation
>>> with translation.hooks():
... import mypy2module
>>> import requests # py2/3 compatible anyway
>>> # etc.
c C s t � | _t� | S r> )r� �hooks_were_installedr} rk r r r � __enter__� s zhooks.__enter__c G s | j s t� d S r> )r� r �rK �argsr r r �__exit__� s zhooks.__exit__N�r r r r r� r� r r r r r� � s r� c @ s e Zd ZdZdd� Zdd� ZdS )�
suspend_hooksax
Acts as a context manager. Use like this:
>>> from past import translation
>>> translation.install_hooks()
>>> import http.client
>>> # ...
>>> with translation.suspend_hooks():
>>> import requests # or others that support Py2/3
If the hooks were disabled before the context, they are not installed when
the context is left.
c C s t � | _t� | S r> )r� r� r rk r r r r� � s zsuspend_hooks.__enter__c G s | j r t� d S r> )r� r} r� r r r r� � s zsuspend_hooks.__exit__Nr� r r r r r� � s
r� )r r )-r rW rz � importlibrY �loggingr rj Zlib2to3.pgen2.parser �lib2to3.refactorr Z libfuturizer �importlib.machineryr r � ImportError�object� getLoggerr r2 �setLevel�DEBUG�listZ libfuturize_fix_names_stage1Zlib2to3_fix_names_stage1Z libfuturize_fix_names_stage2Zlib2to3_fix_names_stage2r r r r# r* r: r< r= rg ry r} r r� r� r� Z
autotranslater r r r �<module> sR !
��� ;58:
PK �@u\zD�� � past/builtins/misc.pynu �[��� from __future__ import unicode_literals
import inspect
import sys
import math
import numbers
from future.utils import PY2, PY3, exec_
if PY2:
from collections import Mapping
else:
from collections.abc import Mapping
if PY3:
import builtins
from collections.abc import Mapping
def apply(f, *args, **kw):
return f(*args, **kw)
from past.builtins import str as oldstr
def chr(i):
"""
Return a byte-string of one character with ordinal i; 0 <= i <= 256
"""
return oldstr(bytes((i,)))
def cmp(x, y):
"""
cmp(x, y) -> integer
Return negative if x<y, zero if x==y, positive if x>y.
Python2 had looser comparison allowing cmp None and non Numerical types and collections.
Try to match the old behavior
"""
if isinstance(x, set) and isinstance(y, set):
raise TypeError('cannot compare sets using cmp()',)
try:
if isinstance(x, numbers.Number) and math.isnan(x):
if not isinstance(y, numbers.Number):
raise TypeError('cannot compare float("nan"), {type_y} with cmp'.format(type_y=type(y)))
if isinstance(y, int):
return 1
else:
return -1
if isinstance(y, numbers.Number) and math.isnan(y):
if not isinstance(x, numbers.Number):
raise TypeError('cannot compare {type_x}, float("nan") with cmp'.format(type_x=type(x)))
if isinstance(x, int):
return -1
else:
return 1
return (x > y) - (x < y)
except TypeError:
if x == y:
return 0
type_order = [
type(None),
numbers.Number,
dict, list,
set,
(str, bytes),
]
x_type_index = y_type_index = None
for i, type_match in enumerate(type_order):
if isinstance(x, type_match):
x_type_index = i
if isinstance(y, type_match):
y_type_index = i
if cmp(x_type_index, y_type_index) == 0:
if isinstance(x, bytes) and isinstance(y, str):
return cmp(x.decode('ascii'), y)
if isinstance(y, bytes) and isinstance(x, str):
return cmp(x, y.decode('ascii'))
elif isinstance(x, list):
# if both arguments are lists take the comparison of the first non equal value
for x_elem, y_elem in zip(x, y):
elem_cmp_val = cmp(x_elem, y_elem)
if elem_cmp_val != 0:
return elem_cmp_val
# if all elements are equal, return equal/0
return 0
elif isinstance(x, dict):
if len(x) != len(y):
return cmp(len(x), len(y))
else:
x_key = min(a for a in x if a not in y or x[a] != y[a])
y_key = min(b for b in y if b not in x or x[b] != y[b])
if x_key != y_key:
return cmp(x_key, y_key)
else:
return cmp(x[x_key], y[y_key])
return cmp(x_type_index, y_type_index)
from sys import intern
def oct(number):
"""oct(number) -> string
Return the octal representation of an integer
"""
return '0' + builtins.oct(number)[2:]
raw_input = input
# imp was deprecated in python 3.6
if sys.version_info >= (3, 6):
from importlib import reload
else:
# for python2, python3 <= 3.4
from imp import reload
unicode = str
unichr = chr
xrange = range
else:
import __builtin__
from collections import Mapping
apply = __builtin__.apply
chr = __builtin__.chr
cmp = __builtin__.cmp
execfile = __builtin__.execfile
intern = __builtin__.intern
oct = __builtin__.oct
raw_input = __builtin__.raw_input
reload = __builtin__.reload
unicode = __builtin__.unicode
unichr = __builtin__.unichr
xrange = __builtin__.xrange
if PY3:
def execfile(filename, myglobals=None, mylocals=None):
"""
Read and execute a Python script from a file in the given namespaces.
The globals and locals are dictionaries, defaulting to the current
globals and locals. If only globals is given, locals defaults to it.
"""
if myglobals is None:
# There seems to be no alternative to frame hacking here.
caller_frame = inspect.stack()[1]
myglobals = caller_frame[0].f_globals
mylocals = caller_frame[0].f_locals
elif mylocals is None:
# Only if myglobals is given do we set mylocals to it.
mylocals = myglobals
if not isinstance(myglobals, Mapping):
raise TypeError('globals must be a mapping')
if not isinstance(mylocals, Mapping):
raise TypeError('locals must be a mapping')
with open(filename, "rb") as fin:
source = fin.read()
code = compile(source, filename, "exec")
exec_(code, myglobals, mylocals)
if PY3:
__all__ = ['apply', 'chr', 'cmp', 'execfile', 'intern', 'raw_input',
'reload', 'unichr', 'unicode', 'xrange']
else:
__all__ = []
PK �@u\J�< �$ �$ past/builtins/noniterators.pynu �[��� """
This module is designed to be used as follows::
from past.builtins.noniterators import filter, map, range, reduce, zip
And then, for example::
assert isinstance(range(5), list)
The list-producing functions this brings in are::
- ``filter``
- ``map``
- ``range``
- ``reduce``
- ``zip``
"""
from __future__ import division, absolute_import, print_function
from itertools import chain, starmap
import itertools # since zip_longest doesn't exist on Py2
from past.types import basestring
from past.utils import PY3
def flatmap(f, items):
return chain.from_iterable(map(f, items))
if PY3:
import builtins
# list-producing versions of the major Python iterating functions
def oldfilter(*args):
"""
filter(function or None, sequence) -> list, tuple, or string
Return those items of sequence for which function(item) is true.
If function is None, return the items that are true. If sequence
is a tuple or string, return the same type, else return a list.
"""
mytype = type(args[1])
if isinstance(args[1], basestring):
return mytype().join(builtins.filter(*args))
elif isinstance(args[1], (tuple, list)):
return mytype(builtins.filter(*args))
else:
# Fall back to list. Is this the right thing to do?
return list(builtins.filter(*args))
# This is surprisingly difficult to get right. For example, the
# solutions here fail with the test cases in the docstring below:
# http://stackoverflow.com/questions/8072755/
def oldmap(func, *iterables):
"""
map(function, sequence[, sequence, ...]) -> list
Return a list of the results of applying the function to the
items of the argument sequence(s). If more than one sequence is
given, the function is called with an argument list consisting of
the corresponding item of each sequence, substituting None for
missing values when not all sequences have the same length. If
the function is None, return a list of the items of the sequence
(or a list of tuples if more than one sequence).
Test cases:
>>> oldmap(None, 'hello world')
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>>> oldmap(None, range(4))
[0, 1, 2, 3]
More test cases are in test_past.test_builtins.
"""
zipped = itertools.zip_longest(*iterables)
l = list(zipped)
if len(l) == 0:
return []
if func is None:
result = l
else:
result = list(starmap(func, l))
# Inspect to see whether it's a simple sequence of tuples
try:
if max([len(item) for item in result]) == 1:
return list(chain.from_iterable(result))
# return list(flatmap(func, result))
except TypeError as e:
# Simple objects like ints have no len()
pass
return result
############################
### For reference, the source code for Py2.7 map function:
# static PyObject *
# builtin_map(PyObject *self, PyObject *args)
# {
# typedef struct {
# PyObject *it; /* the iterator object */
# int saw_StopIteration; /* bool: did the iterator end? */
# } sequence;
#
# PyObject *func, *result;
# sequence *seqs = NULL, *sqp;
# Py_ssize_t n, len;
# register int i, j;
#
# n = PyTuple_Size(args);
# if (n < 2) {
# PyErr_SetString(PyExc_TypeError,
# "map() requires at least two args");
# return NULL;
# }
#
# func = PyTuple_GetItem(args, 0);
# n--;
#
# if (func == Py_None) {
# if (PyErr_WarnPy3k("map(None, ...) not supported in 3.x; "
# "use list(...)", 1) < 0)
# return NULL;
# if (n == 1) {
# /* map(None, S) is the same as list(S). */
# return PySequence_List(PyTuple_GetItem(args, 1));
# }
# }
#
# /* Get space for sequence descriptors. Must NULL out the iterator
# * pointers so that jumping to Fail_2 later doesn't see trash.
# */
# if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
# PyErr_NoMemory();
# return NULL;
# }
# for (i = 0; i < n; ++i) {
# seqs[i].it = (PyObject*)NULL;
# seqs[i].saw_StopIteration = 0;
# }
#
# /* Do a first pass to obtain iterators for the arguments, and set len
# * to the largest of their lengths.
# */
# len = 0;
# for (i = 0, sqp = seqs; i < n; ++i, ++sqp) {
# PyObject *curseq;
# Py_ssize_t curlen;
#
# /* Get iterator. */
# curseq = PyTuple_GetItem(args, i+1);
# sqp->it = PyObject_GetIter(curseq);
# if (sqp->it == NULL) {
# static char errmsg[] =
# "argument %d to map() must support iteration";
# char errbuf[sizeof(errmsg) + 25];
# PyOS_snprintf(errbuf, sizeof(errbuf), errmsg, i+2);
# PyErr_SetString(PyExc_TypeError, errbuf);
# goto Fail_2;
# }
#
# /* Update len. */
# curlen = _PyObject_LengthHint(curseq, 8);
# if (curlen > len)
# len = curlen;
# }
#
# /* Get space for the result list. */
# if ((result = (PyObject *) PyList_New(len)) == NULL)
# goto Fail_2;
#
# /* Iterate over the sequences until all have stopped. */
# for (i = 0; ; ++i) {
# PyObject *alist, *item=NULL, *value;
# int numactive = 0;
#
# if (func == Py_None && n == 1)
# alist = NULL;
# else if ((alist = PyTuple_New(n)) == NULL)
# goto Fail_1;
#
# for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
# if (sqp->saw_StopIteration) {
# Py_INCREF(Py_None);
# item = Py_None;
# }
# else {
# item = PyIter_Next(sqp->it);
# if (item)
# ++numactive;
# else {
# if (PyErr_Occurred()) {
# Py_XDECREF(alist);
# goto Fail_1;
# }
# Py_INCREF(Py_None);
# item = Py_None;
# sqp->saw_StopIteration = 1;
# }
# }
# if (alist)
# PyTuple_SET_ITEM(alist, j, item);
# else
# break;
# }
#
# if (!alist)
# alist = item;
#
# if (numactive == 0) {
# Py_DECREF(alist);
# break;
# }
#
# if (func == Py_None)
# value = alist;
# else {
# value = PyEval_CallObject(func, alist);
# Py_DECREF(alist);
# if (value == NULL)
# goto Fail_1;
# }
# if (i >= len) {
# int status = PyList_Append(result, value);
# Py_DECREF(value);
# if (status < 0)
# goto Fail_1;
# }
# else if (PyList_SetItem(result, i, value) < 0)
# goto Fail_1;
# }
#
# if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
# goto Fail_1;
#
# goto Succeed;
#
# Fail_1:
# Py_DECREF(result);
# Fail_2:
# result = NULL;
# Succeed:
# assert(seqs);
# for (i = 0; i < n; ++i)
# Py_XDECREF(seqs[i].it);
# PyMem_DEL(seqs);
# return result;
# }
def oldrange(*args, **kwargs):
return list(builtins.range(*args, **kwargs))
def oldzip(*args, **kwargs):
return list(builtins.zip(*args, **kwargs))
filter = oldfilter
map = oldmap
range = oldrange
from functools import reduce
zip = oldzip
__all__ = ['filter', 'map', 'range', 'reduce', 'zip']
else:
import __builtin__
# Python 2-builtin ranges produce lists
filter = __builtin__.filter
map = __builtin__.map
range = __builtin__.range
reduce = __builtin__.reduce
zip = __builtin__.zip
__all__ = []
PK �@u\�Q�|
past/builtins/__init__.pynu �[��� """
A resurrection of some old functions from Python 2 for use in Python 3. These
should be used sparingly, to help with porting efforts, since code using them
is no longer standard Python 3 code.
This module provides the following:
1. Implementations of these builtin functions which have no equivalent on Py3:
- apply
- chr
- cmp
- execfile
2. Aliases:
- intern <- sys.intern
- raw_input <- input
- reduce <- functools.reduce
- reload <- imp.reload
- unichr <- chr
- unicode <- str
- xrange <- range
3. List-producing versions of the corresponding Python 3 iterator-producing functions:
- filter
- map
- range
- zip
4. Forward-ported Py2 types:
- basestring
- dict
- str
- long
- unicode
"""
from future.utils import PY3
from past.builtins.noniterators import (filter, map, range, reduce, zip)
# from past.builtins.misc import (ascii, hex, input, oct, open)
if PY3:
from past.types import (basestring,
olddict as dict,
oldstr as str,
long,
unicode)
else:
from __builtin__ import (basestring, dict, str, long, unicode)
from past.builtins.misc import (apply, chr, cmp, execfile, intern, oct,
raw_input, reload, unichr, unicode, xrange)
from past import utils
if utils.PY3:
# We only import names that shadow the builtins on Py3. No other namespace
# pollution on Py3.
# Only shadow builtins on Py3; no new names
__all__ = ['filter', 'map', 'range', 'reduce', 'zip',
'basestring', 'dict', 'str', 'long', 'unicode',
'apply', 'chr', 'cmp', 'execfile', 'intern', 'raw_input',
'reload', 'unichr', 'xrange'
]
else:
# No namespace pollution on Py2
__all__ = []
PK �@u\�5� D D 1 past/builtins/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h
� @ s� d Z ddlmZ ddlmZmZmZmZmZ erNddl m
Z
m Z m
ZmZmZ n ddlm
Z
m Z mZmZmZ ddlmZmZmZmZmZmZmZmZmZmZm Z ddl m Z e jr�g d�Z ng Z d S )
a�
A resurrection of some old functions from Python 2 for use in Python 3. These
should be used sparingly, to help with porting efforts, since code using them
is no longer standard Python 3 code.
This module provides the following:
1. Implementations of these builtin functions which have no equivalent on Py3:
- apply
- chr
- cmp
- execfile
2. Aliases:
- intern <- sys.intern
- raw_input <- input
- reduce <- functools.reduce
- reload <- imp.reload
- unichr <- chr
- unicode <- str
- xrange <- range
3. List-producing versions of the corresponding Python 3 iterator-producing functions:
- filter
- map
- range
- zip
4. Forward-ported Py2 types:
- basestring
- dict
- str
- long
- unicode
� )�PY3)�filter�map�range�reduce�zip)�
basestring�olddict�oldstr�long�unicode)r �dict�strr r ) �apply�chr�cmp�execfile�intern�oct� raw_input�reload�unichrr �xrange)�utils)r r r r r r r
r r r r r r r r r r r r N) �__doc__Z future.utilsr Zpast.builtins.noniteratorsr r r r r Z
past.typesr r r
r
r r r � __builtin__Zpast.builtins.miscr r r r r r r r r r Zpastr �__all__� r r �@/usr/local/lib/python3.9/site-packages/past/builtins/__init__.py�<module> s ) 4
PK �@u\��Z�� � - past/builtins/__pycache__/misc.cpython-39.pycnu �[��� a
��?h� � @ sb d dl mZ d dlZd dlZd dlZd dlZd dlmZmZm Z erRd dl
m Z n d dl m Z er�d dl
Z
d dl m Z dd� Zd dlmZ dd � Zd
d � Zd d lmZ d
d� ZeZejdkr�d dlmZ n d dlmZ eZ eZ e Z nVd dl Z d dl
m Z e jZe jZe jZe j!Z!e jZe jZe jZe jZe j Z e j Z e j Z e�rJddd�Z!e�rZg d�Z"ng Z"dS )� )�unicode_literalsN)�PY2�PY3�exec_)�Mappingc O s | |i |��S �N� )�f�args�kwr r �</usr/local/lib/python3.9/site-packages/past/builtins/misc.py�apply s r
)�strc C s t t| f��S )zU
Return a byte-string of one character with ordinal i; 0 <= i <= 256
)�oldstr�bytes)�ir r r �chr s r c
s� t � t�r t �t�r td��z�t � tj�rjt�� �rjt �tj�sTtdjt��d���t �t �rdW dS W dS t �tj�r�t���r�t � tj�s�tdjt� �d���t � t �r�W dS W dS � �k� �k W S t�y� � �kr�Y dS td �tjt
t tt t
fg}d }}t|�D ]*\}}t � |��r&|}t �|��r|}�qt||�dk�r|t � t
��rvt �t ��rvt� �d
��� Y S t �t
��r�t � t ��r�t� ��d
�� Y S t � t ��r�t� ��D ]*\}}t||�} | dk�r�| Y S �q�Y dS t � t
��r|t� �t��k�r tt� �t��� Y S t� �fd d �� D ��}
t� �fd
d ��D ��} |
| k�rft|
| � Y S t� |
�| � Y S t||� Y S 0 d S )z�
cmp(x, y) -> integer
Return negative if x<y, zero if x==y, positive if x>y.
Python2 had looser comparison allowing cmp None and non Numerical types and collections.
Try to match the old behavior
z cannot compare sets using cmp()z.cannot compare float("nan"), {type_y} with cmp)Ztype_y� ���z.cannot compare {type_x}, float("nan") with cmp)Ztype_xr N�asciic 3 s* | ]"}|�vs � | �| kr|V qd S r r )�.0�a��x�yr r � <genexpr>Z � zcmp.<locals>.<genexpr>c 3 s* | ]"}|� vs � | �| kr|V qd S r r )r �br r r r [ r )�
isinstance�set� TypeError�numbers�Number�math�isnan�format�type�int�dict�listr r � enumerate�cmp�decode�zip�len�min) r r Z
type_orderZ x_type_indexZ y_type_indexr Z
type_matchZx_elemZy_elemZ elem_cmp_valZx_keyZy_keyr r r r+ sf
�
r+ )�internc C s dt �| �dd� S )zUoct(number) -> string
Return the octal representation of an integer
�0� N)�builtins�oct)�numberr r r r4 d s r4 )� � )�reloadc C s� |du r*t �� d }|d j}|d j}n |du r6|}t|t�sHtd��t|t�sZtd��t| d��}|�� }W d � n1 s�0 Y t || d�}t
|||� dS )z�
Read and execute a Python script from a file in the given namespaces.
The globals and locals are dictionaries, defaulting to the current
globals and locals. If only globals is given, locals defaults to it.
Nr r zglobals must be a mappingzlocals must be a mapping�rb�exec) �inspect�stack� f_globals�f_localsr r r �open�read�compiler )�filenameZ myglobalsZmylocalsZ caller_frameZfin�source�coder r r �execfile� s
& rE )
r
r r+ rE r0 � raw_inputr8 �unichr�unicode�xrange)NN)#�
__future__r r; �sysr# r! Z future.utilsr r r � collectionsr �collections.abcr3 r
Z
past.builtinsr r r r+ r0 r4 �inputrF � version_info� importlibr8 �imprH rG �rangerI � __builtin__rE �__all__r r r r �<module> sT C
PK �@u\93]�� � 5 past/builtins/__pycache__/noniterators.cpython-39.pycnu �[��� a
��?h�$ � @ s� d Z ddlmZmZmZ ddlmZmZ ddlZddlm Z ddl
m Z dd� Z e r�ddl
Z
d d
� Zd d � Zd
d� Zdd� ZeZeZeZddlmZ eZg d�Zn*ddlZejZejZejZejZejZg ZdS )a,
This module is designed to be used as follows::
from past.builtins.noniterators import filter, map, range, reduce, zip
And then, for example::
assert isinstance(range(5), list)
The list-producing functions this brings in are::
- ``filter``
- ``map``
- ``range``
- ``reduce``
- ``zip``
� )�division�absolute_import�print_function)�chain�starmapN)�
basestring)�PY3c C s t �t| |��S �N)r �
from_iterable�map)�f�items� r �D/usr/local/lib/python3.9/site-packages/past/builtins/noniterators.py�flatmap s r c G s^ t | d �}t| d t�r,|� �tj| � �S t| d ttf�rL|tj| � �S ttj| � �S dS )a*
filter(function or None, sequence) -> list, tuple, or string
Return those items of sequence for which function(item) is true.
If function is None, return the items that are true. If sequence
is a tuple or string, return the same type, else return a list.
� N)�type�
isinstancer �join�builtins�filter�tuple�list)�argsZmytyper r r � oldfilter$ s r c
G s� t j|� }t|�}t|�dkr"g S | du r0|}ntt| |��}z*tdd� |D ��dkrftt�|��W S W n$ ty� } z W Y d}~n
d}~0 0 |S )a
map(function, sequence[, sequence, ...]) -> list
Return a list of the results of applying the function to the
items of the argument sequence(s). If more than one sequence is
given, the function is called with an argument list consisting of
the corresponding item of each sequence, substituting None for
missing values when not all sequences have the same length. If
the function is None, return a list of the items of the sequence
(or a list of tuples if more than one sequence).
Test cases:
>>> oldmap(None, 'hello world')
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>>> oldmap(None, range(4))
[0, 1, 2, 3]
More test cases are in test_past.test_builtins.
r Nc S s g | ] }t |��qS r )�len)�.0�itemr r r �
<listcomp>X � zoldmap.<locals>.<listcomp>r ) � itertools� zip_longestr r r �maxr r
� TypeError)�func� iterablesZzipped�l�result�er r r �oldmap8 s
r) c O s t tj| i |���S r )r r �range�r �kwargsr r r �oldrange� s r- c O s t tj| i |���S r )r r �zipr+ r r r �oldzip� s r/ )�reduce)r r r* r0 r. )�__doc__�
__future__r r r r r r Z
past.typesr Z
past.utilsr r r r r) r- r/ r r r* � functoolsr0 r. �__all__� __builtin__r r r r �<module> s4 D
PK �@u\���$� � ( past/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hL � @ s$ d Z ddlmZmZmZ dZdZdS )u�
past: compatibility with Python 2 from Python 3
===============================================
``past`` is a package to aid with Python 2/3 compatibility. Whereas ``future``
contains backports of Python 3 constructs to Python 2, ``past`` provides
implementations of some Python 2 constructs in Python 3 and tools to import and
run Python 2 code in Python 3. It is intended to be used sparingly, as a way of
running old Python 2 code from Python 3 until the code is ported properly.
Potential uses for libraries:
- as a step in porting a Python 2 codebase to Python 3 (e.g. with the ``futurize`` script)
- to provide Python 3 support for previously Python 2-only libraries with the
same APIs as on Python 2 -- particularly with regard to 8-bit strings (the
``past.builtins.str`` type).
- to aid in providing minimal-effort Python 3 support for applications using
libraries that do not yet wish to upgrade their code properly to Python 3, or
wish to upgrade it gradually to Python 3 style.
Here are some code examples that run identically on Python 3 and 2::
>>> from past.builtins import str as oldstr
>>> philosopher = oldstr(u'孔子'.encode('utf-8'))
>>> # This now behaves like a Py2 byte-string on both Py2 and Py3.
>>> # For example, indexing returns a Python 2-like string object, not
>>> # an integer:
>>> philosopher[0]
'å'
>>> type(philosopher[0])
<past.builtins.oldstr>
>>> # List-producing versions of range, reduce, map, filter
>>> from past.builtins import range, reduce
>>> range(10)
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
>>> reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])
15
>>> # Other functions removed in Python 3 are resurrected ...
>>> from past.builtins import execfile
>>> execfile('myfile.py')
>>> from past.builtins import raw_input
>>> name = raw_input('What is your name? ')
What is your name? [cursor]
>>> from past.builtins import reload
>>> reload(mymodule) # equivalent to imp.reload(mymodule) in Python 3
>>> from past.builtins import xrange
>>> for i in xrange(10):
... pass
It also provides import hooks so you can import and use Python 2 modules like
this::
$ python3
>>> from past.translation import autotranslate
>>> authotranslate('mypy2module')
>>> import mypy2module
until the authors of the Python 2 modules have upgraded their code. Then, for
example::
>>> mypy2module.func_taking_py2_string(oldstr(b'abcd'))
Credits
-------
:Author: Ed Schofield, Jordan M. Adler, et al
:Sponsor: Python Charmers: https://pythoncharmers.com
Licensing
---------
Copyright 2013-2024 Python Charmers, Australia.
The software is distributed under an MIT licence. See LICENSE.txt.
� )� __version__�
__copyright__� __license__Zpastz Ed SchofieldN)�__doc__�futurer r r � __title__�
__author__� r r �7/usr/local/lib/python3.9/site-packages/past/__init__.py�<module> s UPK �@u\ZF2 past/types/basestring.pynu �[��� """
An implementation of the basestring type for Python 3
Example use:
>>> s = b'abc'
>>> assert isinstance(s, basestring)
>>> from past.types import str as oldstr
>>> s2 = oldstr(b'abc')
>>> assert isinstance(s2, basestring)
"""
import sys
from past.utils import with_metaclass, PY2
if PY2:
str = unicode
ver = sys.version_info[:2]
class BaseBaseString(type):
def __instancecheck__(cls, instance):
return isinstance(instance, (bytes, str))
def __subclasscheck__(cls, subclass):
return super(BaseBaseString, cls).__subclasscheck__(subclass) or issubclass(subclass, (bytes, str))
class basestring(with_metaclass(BaseBaseString)):
"""
A minimal backport of the Python 2 basestring type to Py3
"""
__all__ = ['basestring']
PK �@u\� Wo o past/types/__init__.pynu �[��� """
Forward-ports of types from Python 2 for use with Python 3:
- ``basestring``: equivalent to ``(str, bytes)`` in ``isinstance`` checks
- ``dict``: with list-producing .keys() etc. methods
- ``str``: bytes-like, but iterating over them doesn't product integers
- ``long``: alias of Py3 int with ``L`` suffix in the ``repr``
- ``unicode``: alias of Py3 str with ``u`` prefix in the ``repr``
"""
from past import utils
if utils.PY2:
import __builtin__
basestring = __builtin__.basestring
dict = __builtin__.dict
str = __builtin__.str
long = __builtin__.long
unicode = __builtin__.unicode
__all__ = []
else:
from .basestring import basestring
from .olddict import olddict
from .oldstr import oldstr
long = int
unicode = str
# from .unicode import unicode
__all__ = ['basestring', 'olddict', 'oldstr', 'long', 'unicode']
PK �@u\�
��
�
past/types/olddict.pynu �[��� """
A dict subclass for Python 3 that behaves like Python 2's dict
Example use:
>>> from past.builtins import dict
>>> d1 = dict() # instead of {} for an empty dict
>>> d2 = dict(key1='value1', key2='value2')
The keys, values and items methods now return lists on Python 3.x and there are
methods for iterkeys, itervalues, iteritems, and viewkeys etc.
>>> for d in (d1, d2):
... assert isinstance(d.keys(), list)
... assert isinstance(d.values(), list)
... assert isinstance(d.items(), list)
"""
import sys
from past.utils import with_metaclass
_builtin_dict = dict
ver = sys.version_info[:2]
class BaseOldDict(type):
def __instancecheck__(cls, instance):
return isinstance(instance, _builtin_dict)
class olddict(with_metaclass(BaseOldDict, _builtin_dict)):
"""
A backport of the Python 3 dict object to Py2
"""
iterkeys = _builtin_dict.keys
viewkeys = _builtin_dict.keys
def keys(self):
return list(super(olddict, self).keys())
itervalues = _builtin_dict.values
viewvalues = _builtin_dict.values
def values(self):
return list(super(olddict, self).values())
iteritems = _builtin_dict.items
viewitems = _builtin_dict.items
def items(self):
return list(super(olddict, self).items())
def has_key(self, k):
"""
D.has_key(k) -> True if D has a key k, else False
"""
return k in self
# def __new__(cls, *args, **kwargs):
# """
# dict() -> new empty dictionary
# dict(mapping) -> new dictionary initialized from a mapping object's
# (key, value) pairs
# dict(iterable) -> new dictionary initialized as if via:
# d = {}
# for k, v in iterable:
# d[k] = v
# dict(**kwargs) -> new dictionary initialized with the name=value pairs
# in the keyword argument list. For example: dict(one=1, two=2)
# """
#
# if len(args) == 0:
# return super(olddict, cls).__new__(cls)
# # Was: elif isinstance(args[0], newbytes):
# # We use type() instead of the above because we're redefining
# # this to be True for all unicode string subclasses. Warning:
# # This may render newstr un-subclassable.
# elif type(args[0]) == olddict:
# return args[0]
# # elif isinstance(args[0], _builtin_dict):
# # value = args[0]
# else:
# value = args[0]
# return super(olddict, cls).__new__(cls, value)
def __native__(self):
"""
Hook for the past.utils.native() function
"""
return super(oldbytes, self)
__all__ = ['olddict']
PK �@u\,#l� � past/types/oldstr.pynu �[��� """
Pure-Python implementation of a Python 2-like str object for Python 3.
"""
from numbers import Integral
from past.utils import PY2, with_metaclass
if PY2:
from collections import Iterable
else:
from collections.abc import Iterable
_builtin_bytes = bytes
class BaseOldStr(type):
def __instancecheck__(cls, instance):
return isinstance(instance, _builtin_bytes)
def unescape(s):
r"""
Interprets strings with escape sequences
Example:
>>> s = unescape(r'abc\\def') # i.e. 'abc\\\\def'
>>> print(s)
'abc\def'
>>> s2 = unescape('abc\\ndef')
>>> len(s2)
8
>>> print(s2)
abc
def
"""
return s.encode().decode('unicode_escape')
class oldstr(with_metaclass(BaseOldStr, _builtin_bytes)):
"""
A forward port of the Python 2 8-bit string object to Py3
"""
# Python 2 strings have no __iter__ method:
@property
def __iter__(self):
raise AttributeError
def __dir__(self):
return [thing for thing in dir(_builtin_bytes) if thing != '__iter__']
# def __new__(cls, *args, **kwargs):
# """
# From the Py3 bytes docstring:
# bytes(iterable_of_ints) -> bytes
# bytes(string, encoding[, errors]) -> bytes
# bytes(bytes_or_buffer) -> immutable copy of bytes_or_buffer
# bytes(int) -> bytes object of size given by the parameter initialized with null bytes
# bytes() -> empty bytes object
#
# Construct an immutable array of bytes from:
# - an iterable yielding integers in range(256)
# - a text string encoded using the specified encoding
# - any object implementing the buffer API.
# - an integer
# """
#
# if len(args) == 0:
# return super(newbytes, cls).__new__(cls)
# # Was: elif isinstance(args[0], newbytes):
# # We use type() instead of the above because we're redefining
# # this to be True for all unicode string subclasses. Warning:
# # This may render newstr un-subclassable.
# elif type(args[0]) == newbytes:
# return args[0]
# elif isinstance(args[0], _builtin_bytes):
# value = args[0]
# elif isinstance(args[0], unicode):
# if 'encoding' not in kwargs:
# raise TypeError('unicode string argument without an encoding')
# ###
# # Was: value = args[0].encode(**kwargs)
# # Python 2.6 string encode() method doesn't take kwargs:
# # Use this instead:
# newargs = [kwargs['encoding']]
# if 'errors' in kwargs:
# newargs.append(kwargs['errors'])
# value = args[0].encode(*newargs)
# ###
# elif isinstance(args[0], Iterable):
# if len(args[0]) == 0:
# # What is this?
# raise ValueError('unknown argument type')
# elif len(args[0]) > 0 and isinstance(args[0][0], Integral):
# # It's a list of integers
# value = b''.join([chr(x) for x in args[0]])
# else:
# raise ValueError('item cannot be interpreted as an integer')
# elif isinstance(args[0], Integral):
# if args[0] < 0:
# raise ValueError('negative count')
# value = b'\x00' * args[0]
# else:
# value = args[0]
# return super(newbytes, cls).__new__(cls, value)
def __repr__(self):
s = super(oldstr, self).__repr__() # e.g. b'abc' on Py3, b'abc' on Py3
return s[1:]
def __str__(self):
s = super(oldstr, self).__str__() # e.g. "b'abc'" or "b'abc\\ndef'
# TODO: fix this:
assert s[:2] == "b'" and s[-1] == "'"
return unescape(s[2:-1]) # e.g. 'abc' or 'abc\ndef'
def __getitem__(self, y):
if isinstance(y, Integral):
return super(oldstr, self).__getitem__(slice(y, y+1))
else:
return super(oldstr, self).__getitem__(y)
def __getslice__(self, *args):
return self.__getitem__(slice(*args))
def __contains__(self, key):
if isinstance(key, int):
return False
def __native__(self):
return bytes(self)
__all__ = ['oldstr']
PK �@u\��ջc c . past/types/__pycache__/__init__.cpython-39.pycnu �[��� a
��?ho � @ sz d Z ddlmZ ejrBddlZejZejZejZejZej Z g Z
n4ddlmZ ddl m Z ddl m Z e
ZeZ g d�Z
dS ) a�
Forward-ports of types from Python 2 for use with Python 3:
- ``basestring``: equivalent to ``(str, bytes)`` in ``isinstance`` checks
- ``dict``: with list-producing .keys() etc. methods
- ``str``: bytes-like, but iterating over them doesn't product integers
- ``long``: alias of Py3 int with ``L`` suffix in the ``repr``
- ``unicode``: alias of Py3 str with ``u`` prefix in the ``repr``
� )�utilsN� )�
basestring)�olddict)�oldstr)r r r �long�unicode)�__doc__Zpastr �PY2� __builtin__r �dict�strr r �__all__r r �int� r r �=/usr/local/lib/python3.9/site-packages/past/types/__init__.py�<module> s PK �@u\�g�T T , past/types/__pycache__/oldstr.cpython-39.pycnu �[��� a
��?h� � @ sz d Z ddlmZ ddlmZmZ er2ddlmZ n ddlmZ e Z
G dd� de �Z dd� Z
G d d
� d
ee e
��Zd
gZd S ) zH
Pure-Python implementation of a Python 2-like str object for Python 3.
� )�Integral)�PY2�with_metaclass)�Iterablec @ s e Zd Zdd� ZdS )�
BaseOldStrc C s
t |t�S �N)�
isinstance�_builtin_bytes)�cls�instance� r �;/usr/local/lib/python3.9/site-packages/past/types/oldstr.py�__instancecheck__ s z BaseOldStr.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r
r s r c C s | � � �d�S )z�
Interprets strings with escape sequences
Example:
>>> s = unescape(r'abc\\def') # i.e. 'abc\\\\def'
>>> print(s)
'abc\def'
>>> s2 = unescape('abc\\ndef')
>>> len(s2)
8
>>> print(s2)
abc
def
�unicode_escape)�encode�decode)�sr r r
�unescape s r c sd e Zd ZdZedd� �Zdd� Z� fdd�Z� fdd �Z� fd
d �Z d d
� Z
dd� Z dd� Z � Z
S )�oldstrzC
A forward port of the Python 2 8-bit string object to Py3
c C s t �d S r )�AttributeError��selfr r r
�__iter__- s zoldstr.__iter__c C s dd� t t�D �S )Nc S s g | ]}|d kr|�qS )r r )�.0�thingr r r
�
<listcomp>2 � z"oldstr.__dir__.<locals>.<listcomp>)�dirr r r r r
�__dir__1 s zoldstr.__dir__c s t t| ��� }|dd � S �N� )�superr �__repr__�r r �� __class__r r
r% l s zoldstr.__repr__c s> t t| ��� }|d d� dkr*|d dks.J �t|dd� �S )N� zb'����')r$ r �__str__r r& r' r r
r, p s zoldstr.__str__c s8 t |t�r$tt| ��t||d ��S tt| ��|�S d S r" )r r r$ r � __getitem__�slice)r �yr' r r
r- v s
zoldstr.__getitem__c G s | � t|� �S r )r- r. )r �argsr r r
� __getslice__| s zoldstr.__getslice__c C s t |t�rdS d S )NF)r �int)r �keyr r r
� __contains__ s
zoldstr.__contains__c C s t | �S r )�bytesr r r r
�
__native__� s zoldstr.__native__)r r r �__doc__�propertyr r! r% r, r- r1 r4 r6 �
__classcell__r r r' r
r ( s
; r N)r7 Znumbersr Z
past.utilsr r � collectionsr �collections.abcr5 r �typer r r �__all__r r r r
�<module> s _PK �@u\Y�ױ1 1 - past/types/__pycache__/olddict.cpython-39.pycnu �[��� a
��?h�
� @ sZ d Z ddlZddlmZ eZejdd� ZG dd� de�Z G dd� dee e��Z
dgZ dS ) a�
A dict subclass for Python 3 that behaves like Python 2's dict
Example use:
>>> from past.builtins import dict
>>> d1 = dict() # instead of {} for an empty dict
>>> d2 = dict(key1='value1', key2='value2')
The keys, values and items methods now return lists on Python 3.x and there are
methods for iterkeys, itervalues, iteritems, and viewkeys etc.
>>> for d in (d1, d2):
... assert isinstance(d.keys(), list)
... assert isinstance(d.values(), list)
... assert isinstance(d.items(), list)
� N)�with_metaclass� c @ s e Zd Zdd� ZdS )� BaseOldDictc C s
t |t�S �N)�
isinstance�
_builtin_dict)�cls�instance� r
�</usr/local/lib/python3.9/site-packages/past/types/olddict.py�__instancecheck__ s z BaseOldDict.__instancecheck__N)�__name__�
__module__� __qualname__r r
r
r
r r s r c sp e Zd ZdZejZejZ� fdd�ZejZ ejZ
� fdd�Zej Z ej Z
� fdd�Z dd � Z� fd
d �Z� ZS ) �olddictz7
A backport of the Python 3 dict object to Py2
c s t tt| ��� �S r )�list�superr �keys��self�� __class__r
r r ( s z olddict.keysc s t tt| ��� �S r )r r r �valuesr r r
r r . s zolddict.valuesc s t tt| ��� �S r )r r r �itemsr r r
r r 4 s z
olddict.itemsc C s || v S )zC
D.has_key(k) -> True if D has a key k, else False
r
)r �kr
r
r �has_key7 s zolddict.has_keyc s
t t| �S )z;
Hook for the past.utils.native() function
)r Zoldbytesr r r
r �
__native__Y s zolddict.__native__)r
r r �__doc__r r �iterkeys�viewkeysr �
itervalues�
viewvaluesr � iteritems� viewitemsr r �
__classcell__r
r
r r r ! s "r ) r �sysZ
past.utilsr �dictr � version_info�ver�typer r �__all__r
r
r
r �<module> s ?PK �@u\�3L` ` 0 past/types/__pycache__/basestring.cpython-39.pycnu �[��� a
��?h � @ s` d Z ddlZddlmZmZ er$eZejdd� ZG dd� de �Z
G dd� dee
��Z dgZ dS ) z�
An implementation of the basestring type for Python 3
Example use:
>>> s = b'abc'
>>> assert isinstance(s, basestring)
>>> from past.types import str as oldstr
>>> s2 = oldstr(b'abc')
>>> assert isinstance(s2, basestring)
� N)�with_metaclass�PY2� c s$ e Zd Zdd� Z� fdd�Z� ZS )�BaseBaseStringc C s t |ttf�S �N)�
isinstance�bytes�str)�cls�instance� r �?/usr/local/lib/python3.9/site-packages/past/types/basestring.py�__instancecheck__ s z BaseBaseString.__instancecheck__c s t t| ��|�p t|ttf�S r )�superr �__subclasscheck__�
issubclassr r )r
�subclass�� __class__r r
r s z BaseBaseString.__subclasscheck__)�__name__�
__module__� __qualname__r r �
__classcell__r r r r
r s r c @ s e Zd ZdZdS )�
basestringzC
A minimal backport of the Python 2 basestring type to Py3
N)r r r �__doc__r r r r
r s r )
r �sysZ
past.utilsr r �unicoder � version_info�ver�typer r �__all__r r r r
�<module> s
PK �@u\�ߵ�I
I
past/utils/__init__.pynu �[��� """
Various non-built-in utility functions and definitions for Py2
compatibility in Py3.
For example:
>>> # The old_div() function behaves like Python 2's / operator
>>> # without "from __future__ import division"
>>> from past.utils import old_div
>>> old_div(3, 2) # like 3/2 in Py2
0
>>> old_div(3, 2.0) # like 3/2.0 in Py2
1.5
"""
import sys
import numbers
PY3 = sys.version_info[0] >= 3
PY2 = sys.version_info[0] == 2
PYPY = hasattr(sys, 'pypy_translation_info')
def with_metaclass(meta, *bases):
"""
Function from jinja2/_compat.py. License: BSD.
Use it like this::
class BaseForm(object):
pass
class FormType(type):
pass
class Form(with_metaclass(FormType, BaseForm)):
pass
This requires a bit of explanation: the basic idea is to make a
dummy metaclass for one level of class instantiation that replaces
itself with the actual metaclass. Because of internal type checks
we also need to make sure that we downgrade the custom metaclass
for one level to something closer to type (that's why __call__ and
__init__ comes back from type etc.).
This has the advantage over six.with_metaclass of not introducing
dummy classes into the final MRO.
"""
class metaclass(meta):
__call__ = type.__call__
__init__ = type.__init__
def __new__(cls, name, this_bases, d):
if this_bases is None:
return type.__new__(cls, name, (), d)
return meta(name, bases, d)
return metaclass('temporary_class', None, {})
def native(obj):
"""
On Py2, this is a no-op: native(obj) -> obj
On Py3, returns the corresponding native Py3 types that are
superclasses for forward-ported objects from Py2:
>>> from past.builtins import str, dict
>>> native(str(b'ABC')) # Output on Py3 follows. On Py2, output is 'ABC'
b'ABC'
>>> type(native(str(b'ABC')))
bytes
Existing native types on Py3 will be returned unchanged:
>>> type(native(b'ABC'))
bytes
"""
if hasattr(obj, '__native__'):
return obj.__native__()
else:
return obj
# An alias for future.utils.old_div():
def old_div(a, b):
"""
Equivalent to ``a / b`` on Python 2 without ``from __future__ import
division``.
TODO: generalize this to other objects (like arrays etc.)
"""
if isinstance(a, numbers.Integral) and isinstance(b, numbers.Integral):
return a // b
else:
return a / b
__all__ = ['PY3', 'PY2', 'PYPY', 'with_metaclass', 'native', 'old_div']
PK �@u\���� � . past/utils/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hI
� @ s^ d Z ddlZddlZejd dkZejd dkZeed�Zdd� Zdd � Z d
d � Z
g d �Z dS )
aj
Various non-built-in utility functions and definitions for Py2
compatibility in Py3.
For example:
>>> # The old_div() function behaves like Python 2's / operator
>>> # without "from __future__ import division"
>>> from past.utils import old_div
>>> old_div(3, 2) # like 3/2 in Py2
0
>>> old_div(3, 2.0) # like 3/2.0 in Py2
1.5
� N� � Zpypy_translation_infoc s" G � �fdd�d��}|ddi �S )a�
Function from jinja2/_compat.py. License: BSD.
Use it like this::
class BaseForm(object):
pass
class FormType(type):
pass
class Form(with_metaclass(FormType, BaseForm)):
pass
This requires a bit of explanation: the basic idea is to make a
dummy metaclass for one level of class instantiation that replaces
itself with the actual metaclass. Because of internal type checks
we also need to make sure that we downgrade the custom metaclass
for one level to something closer to type (that's why __call__ and
__init__ comes back from type etc.).
This has the advantage over six.with_metaclass of not introducing
dummy classes into the final MRO.
c s& e Zd ZejZejZ� �fdd�ZdS )z!with_metaclass.<locals>.metaclassc s$ |d u rt �| |d|�S �|� |�S )N� )�type�__new__)�cls�name�
this_bases�d��bases�metar �=/usr/local/lib/python3.9/site-packages/past/utils/__init__.pyr 4 s z)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__� __qualname__r �__call__�__init__r r r r r � metaclass1 s r �temporary_classNr )r
r r r r r �with_metaclass s r c C s t | d�r| �� S | S dS )a�
On Py2, this is a no-op: native(obj) -> obj
On Py3, returns the corresponding native Py3 types that are
superclasses for forward-ported objects from Py2:
>>> from past.builtins import str, dict
>>> native(str(b'ABC')) # Output on Py3 follows. On Py2, output is 'ABC'
b'ABC'
>>> type(native(str(b'ABC')))
bytes
Existing native types on Py3 will be returned unchanged:
>>> type(native(b'ABC'))
bytes
�
__native__N)�hasattrr )�objr r r �native; s
r c C s, t | tj�r t |tj�r | | S | | S dS )z�
Equivalent to ``a / b`` on Python 2 without ``from __future__ import
division``.
TODO: generalize this to other objects (like arrays etc.)
N)�
isinstance�numbers�Integral)�a�br r r �old_divU s r )�PY3�PY2�PYPYr r r ) �__doc__�sysr � version_infor! r" r r# r r r �__all__r r r r �<module> s
# PK �@u\�졀� � " backports/configparser/__init__.pynu �[��� """Configuration file parser.
A configuration file consists of sections, lead by a "[section]" header,
and followed by "name: value" entries, with continuations and such in
the style of RFC 822.
Intrinsic defaults can be specified by passing them into the
ConfigParser constructor as a dictionary.
class:
ConfigParser -- responsible for parsing a list of
configuration files, and managing the parsed database.
methods:
__init__(defaults=None, dict_type=_default_dict, allow_no_value=False,
delimiters=('=', ':'), comment_prefixes=('#', ';'),
inline_comment_prefixes=None, strict=True,
empty_lines_in_values=True, default_section='DEFAULT',
interpolation=<unset>, converters=<unset>):
Create the parser. When `defaults' is given, it is initialized into the
dictionary or intrinsic defaults. The keys must be strings, the values
must be appropriate for %()s string interpolation.
When `dict_type' is given, it will be used to create the dictionary
objects for the list of sections, for the options within a section, and
for the default values.
When `delimiters' is given, it will be used as the set of substrings
that divide keys from values.
When `comment_prefixes' is given, it will be used as the set of
substrings that prefix comments in empty lines. Comments can be
indented.
When `inline_comment_prefixes' is given, it will be used as the set of
substrings that prefix comments in non-empty lines.
When `strict` is True, the parser won't allow for any section or option
duplicates while reading from a single source (file, string or
dictionary). Default is True.
When `empty_lines_in_values' is False (default: True), each empty line
marks the end of an option. Otherwise, internal empty lines of
a multiline option are kept as part of the value.
When `allow_no_value' is True (default: False), options without
values are accepted; the value presented for these is None.
When `default_section' is given, the name of the special section is
named accordingly. By default it is called ``"DEFAULT"`` but this can
be customized to point to any other valid section name. Its current
value can be retrieved using the ``parser_instance.default_section``
attribute and may be modified at runtime.
When `interpolation` is given, it should be an Interpolation subclass
instance. It will be used as the handler for option value
pre-processing when using getters. RawConfigParser objects don't do
any sort of interpolation, whereas ConfigParser uses an instance of
BasicInterpolation. The library also provides a ``zc.buildbot``
inspired ExtendedInterpolation implementation.
When `converters` is given, it should be a dictionary where each key
represents the name of a type converter and each value is a callable
implementing the conversion from string to the desired datatype. Every
converter gets its corresponding get*() method on the parser object and
section proxies.
sections()
Return all the configuration section names, sans DEFAULT.
has_section(section)
Return whether the given section exists.
has_option(section, option)
Return whether the given option exists in the given section.
options(section)
Return list of configuration options for the named section.
read(filenames, encoding=None)
Read and parse the iterable of named configuration files, given by
name. A single filename is also allowed. Non-existing files
are ignored. Return list of successfully read files.
read_file(f, filename=None)
Read and parse one configuration file, given as a file object.
The filename defaults to f.name; it is only used in error
messages (if f has no `name' attribute, the string `<???>' is used).
read_string(string)
Read configuration from a given string.
read_dict(dictionary)
Read configuration from a dictionary. Keys are section names,
values are dictionaries with keys and values that should be present
in the section. If the used dictionary type preserves order, sections
and their keys will be added in order. Values are automatically
converted to strings.
get(section, option, raw=False, vars=None, fallback=_UNSET)
Return a string value for the named option. All % interpolations are
expanded in the return values, based on the defaults passed into the
constructor and the DEFAULT section. Additional substitutions may be
provided using the `vars' argument, which must be a dictionary whose
contents override any pre-existing defaults. If `option' is a key in
`vars', the value from `vars' is used.
getint(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to an integer.
getfloat(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to a float.
getboolean(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to a boolean (currently case
insensitively defined as 0, false, no, off for False, and 1, true,
yes, on for True). Returns False or True.
items(section=_UNSET, raw=False, vars=None)
If section is given, return a list of tuples with (name, value) for
each option in the section. Otherwise, return a list of tuples with
(section_name, section_proxy) for each section, including DEFAULTSECT.
remove_section(section)
Remove the given file section and all its options.
remove_option(section, option)
Remove the given option from the given section.
set(section, option, value)
Set the given option.
write(fp, space_around_delimiters=True)
Write the configuration state in .ini format. If
`space_around_delimiters' is True (the default), delimiters
between keys and values are surrounded by spaces.
"""
from collections.abc import MutableMapping
from collections import ChainMap as _ChainMap
import functools
from .compat import io
import itertools
import os
import re
import sys
import warnings
__all__ = [
"NoSectionError",
"DuplicateOptionError",
"DuplicateSectionError",
"NoOptionError",
"InterpolationError",
"InterpolationDepthError",
"InterpolationMissingOptionError",
"InterpolationSyntaxError",
"ParsingError",
"MissingSectionHeaderError",
"ConfigParser",
"SafeConfigParser",
"RawConfigParser",
"Interpolation",
"BasicInterpolation",
"ExtendedInterpolation",
"LegacyInterpolation",
"SectionProxy",
"ConverterMapping",
"DEFAULTSECT",
"MAX_INTERPOLATION_DEPTH",
]
_default_dict = dict
DEFAULTSECT = "DEFAULT"
MAX_INTERPOLATION_DEPTH = 10
# exception classes
class Error(Exception):
"""Base class for ConfigParser exceptions."""
def __init__(self, msg=''):
self.message = msg
Exception.__init__(self, msg)
def __repr__(self):
return self.message
__str__ = __repr__
class NoSectionError(Error):
"""Raised when no section matches a requested option."""
def __init__(self, section):
Error.__init__(self, 'No section: %r' % (section,))
self.section = section
self.args = (section,)
class DuplicateSectionError(Error):
"""Raised when a section is repeated in an input source.
Possible repetitions that raise this exception are: multiple creation
using the API or in strict parsers when a section is found more than once
in a single input file, string or dictionary.
"""
def __init__(self, section, source=None, lineno=None):
msg = [repr(section), " already exists"]
if source is not None:
message = ["While reading from ", repr(source)]
if lineno is not None:
message.append(" [line {0:2d}]".format(lineno))
message.append(": section ")
message.extend(msg)
msg = message
else:
msg.insert(0, "Section ")
Error.__init__(self, "".join(msg))
self.section = section
self.source = source
self.lineno = lineno
self.args = (section, source, lineno)
class DuplicateOptionError(Error):
"""Raised by strict parsers when an option is repeated in an input source.
Current implementation raises this exception only when an option is found
more than once in a single file, string or dictionary.
"""
def __init__(self, section, option, source=None, lineno=None):
msg = [repr(option), " in section ", repr(section), " already exists"]
if source is not None:
message = ["While reading from ", repr(source)]
if lineno is not None:
message.append(" [line {0:2d}]".format(lineno))
message.append(": option ")
message.extend(msg)
msg = message
else:
msg.insert(0, "Option ")
Error.__init__(self, "".join(msg))
self.section = section
self.option = option
self.source = source
self.lineno = lineno
self.args = (section, option, source, lineno)
class NoOptionError(Error):
"""A requested option was not found."""
def __init__(self, option, section):
Error.__init__(self, "No option %r in section: %r" % (option, section))
self.option = option
self.section = section
self.args = (option, section)
class InterpolationError(Error):
"""Base class for interpolation-related exceptions."""
def __init__(self, option, section, msg):
Error.__init__(self, msg)
self.option = option
self.section = section
self.args = (option, section, msg)
class InterpolationMissingOptionError(InterpolationError):
"""A string substitution required a setting which was not available."""
def __init__(self, option, section, rawval, reference):
msg = (
"Bad value substitution: option {!r} in section {!r} contains "
"an interpolation key {!r} which is not a valid option name. "
"Raw value: {!r}".format(option, section, reference, rawval)
)
InterpolationError.__init__(self, option, section, msg)
self.reference = reference
self.args = (option, section, rawval, reference)
class InterpolationSyntaxError(InterpolationError):
"""Raised when the source text contains invalid syntax.
Current implementation raises this exception when the source text into
which substitutions are made does not conform to the required syntax.
"""
class InterpolationDepthError(InterpolationError):
"""Raised when substitutions are nested too deeply."""
def __init__(self, option, section, rawval):
msg = (
"Recursion limit exceeded in value substitution: option {!r} "
"in section {!r} contains an interpolation key which "
"cannot be substituted in {} steps. Raw value: {!r}"
"".format(option, section, MAX_INTERPOLATION_DEPTH, rawval)
)
InterpolationError.__init__(self, option, section, msg)
self.args = (option, section, rawval)
class ParsingError(Error):
"""Raised when a configuration file does not follow legal syntax."""
def __init__(self, source=None, filename=None):
# Exactly one of `source'/`filename' arguments has to be given.
# `filename' kept for compatibility.
if filename and source:
raise ValueError(
"Cannot specify both `filename' and `source'. " "Use `source'."
)
elif not filename and not source:
raise ValueError("Required argument `source' not given.")
elif filename:
source = filename
Error.__init__(self, 'Source contains parsing errors: %r' % source)
self.source = source
self.errors = []
self.args = (source,)
@property
def filename(self):
"""Deprecated, use `source'."""
warnings.warn(
"The 'filename' attribute will be removed in future versions. "
"Use 'source' instead.",
DeprecationWarning,
stacklevel=2,
)
return self.source
@filename.setter
def filename(self, value):
"""Deprecated, user `source'."""
warnings.warn(
"The 'filename' attribute will be removed in future versions. "
"Use 'source' instead.",
DeprecationWarning,
stacklevel=2,
)
self.source = value
def append(self, lineno, line):
self.errors.append((lineno, line))
self.message += '\n\t[line %2d]: %s' % (lineno, line)
class MissingSectionHeaderError(ParsingError):
"""Raised when a key-value pair is found before any section header."""
def __init__(self, filename, lineno, line):
Error.__init__(
self,
'File contains no section headers.\nfile: %r, line: %d\n%r'
% (filename, lineno, line),
)
self.source = filename
self.lineno = lineno
self.line = line
self.args = (filename, lineno, line)
# Used in parser getters to indicate the default behaviour when a specific
# option is not found it to raise an exception. Created to enable `None' as
# a valid fallback value.
_UNSET = object()
class Interpolation:
"""Dummy interpolation that passes the value through with no changes."""
def before_get(self, parser, section, option, value, defaults):
return value
def before_set(self, parser, section, option, value):
return value
def before_read(self, parser, section, option, value):
return value
def before_write(self, parser, section, option, value):
return value
class BasicInterpolation(Interpolation):
"""Interpolation as implemented in the classic ConfigParser.
The option values can contain format strings which refer to other values in
the same section, or values in the special default section.
For example:
something: %(dir)s/whatever
would resolve the "%(dir)s" to the value of dir. All reference
expansions are done late, on demand. If a user needs to use a bare % in
a configuration file, she can escape it by writing %%. Other % usage
is considered a user error and raises `InterpolationSyntaxError'."""
_KEYCRE = re.compile(r"%\(([^)]+)\)s")
def before_get(self, parser, section, option, value, defaults):
L = []
self._interpolate_some(parser, option, L, value, section, defaults, 1)
return ''.join(L)
def before_set(self, parser, section, option, value):
tmp_value = value.replace('%%', '') # escaped percent signs
tmp_value = self._KEYCRE.sub('', tmp_value) # valid syntax
if '%' in tmp_value:
raise ValueError(
"invalid interpolation syntax in %r at "
"position %d" % (value, tmp_value.find('%'))
)
return value
def _interpolate_some( # noqa: C901
self, parser, option, accum, rest, section, map, depth
):
rawval = parser.get(section, option, raw=True, fallback=rest)
if depth > MAX_INTERPOLATION_DEPTH:
raise InterpolationDepthError(option, section, rawval)
while rest:
p = rest.find("%")
if p < 0:
accum.append(rest)
return
if p > 0:
accum.append(rest[:p])
rest = rest[p:]
# p is no longer used
c = rest[1:2]
if c == "%":
accum.append("%")
rest = rest[2:]
elif c == "(":
m = self._KEYCRE.match(rest)
if m is None:
raise InterpolationSyntaxError(
option,
section,
"bad interpolation variable reference %r" % rest,
)
var = parser.optionxform(m.group(1))
rest = rest[m.end() :]
try:
v = map[var]
except KeyError:
raise InterpolationMissingOptionError(
option, section, rawval, var
) from None
if "%" in v:
self._interpolate_some(
parser, option, accum, v, section, map, depth + 1
)
else:
accum.append(v)
else:
raise InterpolationSyntaxError(
option,
section,
"'%%' must be followed by '%%' or '(', " "found: %r" % (rest,),
)
class ExtendedInterpolation(Interpolation):
"""Advanced variant of interpolation, supports the syntax used by
`zc.buildout'. Enables interpolation between sections."""
_KEYCRE = re.compile(r"\$\{([^}]+)\}")
def before_get(self, parser, section, option, value, defaults):
L = []
self._interpolate_some(parser, option, L, value, section, defaults, 1)
return ''.join(L)
def before_set(self, parser, section, option, value):
tmp_value = value.replace('$$', '') # escaped dollar signs
tmp_value = self._KEYCRE.sub('', tmp_value) # valid syntax
if '$' in tmp_value:
raise ValueError(
"invalid interpolation syntax in %r at "
"position %d" % (value, tmp_value.find('$'))
)
return value
def _interpolate_some( # noqa: C901
self, parser, option, accum, rest, section, map, depth
):
rawval = parser.get(section, option, raw=True, fallback=rest)
if depth > MAX_INTERPOLATION_DEPTH:
raise InterpolationDepthError(option, section, rawval)
while rest:
p = rest.find("$")
if p < 0:
accum.append(rest)
return
if p > 0:
accum.append(rest[:p])
rest = rest[p:]
# p is no longer used
c = rest[1:2]
if c == "$":
accum.append("$")
rest = rest[2:]
elif c == "{":
m = self._KEYCRE.match(rest)
if m is None:
raise InterpolationSyntaxError(
option,
section,
"bad interpolation variable reference %r" % rest,
)
path = m.group(1).split(':')
rest = rest[m.end() :]
sect = section
opt = option
try:
if len(path) == 1:
opt = parser.optionxform(path[0])
v = map[opt]
elif len(path) == 2:
sect = path[0]
opt = parser.optionxform(path[1])
v = parser.get(sect, opt, raw=True)
else:
raise InterpolationSyntaxError(
option, section, "More than one ':' found: %r" % (rest,)
)
except (KeyError, NoSectionError, NoOptionError):
raise InterpolationMissingOptionError(
option, section, rawval, ":".join(path)
) from None
if "$" in v:
self._interpolate_some(
parser,
opt,
accum,
v,
sect,
dict(parser.items(sect, raw=True)),
depth + 1,
)
else:
accum.append(v)
else:
raise InterpolationSyntaxError(
option,
section,
"'$' must be followed by '$' or '{', " "found: %r" % (rest,),
)
class LegacyInterpolation(Interpolation):
"""Deprecated interpolation used in old versions of ConfigParser.
Use BasicInterpolation or ExtendedInterpolation instead."""
_KEYCRE = re.compile(r"%\(([^)]*)\)s|.")
def before_get(self, parser, section, option, value, vars):
rawval = value
depth = MAX_INTERPOLATION_DEPTH
while depth: # Loop through this until it's done
depth -= 1
if value and "%(" in value:
replace = functools.partial(self._interpolation_replace, parser=parser)
value = self._KEYCRE.sub(replace, value)
try:
value = value % vars
except KeyError as e:
raise InterpolationMissingOptionError(
option, section, rawval, e.args[0]
) from None
else:
break
if value and "%(" in value:
raise InterpolationDepthError(option, section, rawval)
return value
def before_set(self, parser, section, option, value):
return value
@staticmethod
def _interpolation_replace(match, parser):
s = match.group(1)
if s is None:
return match.group()
else:
return "%%(%s)s" % parser.optionxform(s)
class RawConfigParser(MutableMapping):
"""ConfigParser that does not do interpolation."""
# Regular expressions for parsing section headers and options
_SECT_TMPL = r"""
\[ # [
(?P<header>.+) # very permissive!
\] # ]
"""
_OPT_TMPL = r"""
(?P<option>.*?) # very permissive!
\s*(?P<vi>{delim})\s* # any number of space/tab,
# followed by any of the
# allowed delimiters,
# followed by any space/tab
(?P<value>.*)$ # everything up to eol
"""
_OPT_NV_TMPL = r"""
(?P<option>.*?) # very permissive!
\s*(?: # any number of space/tab,
(?P<vi>{delim})\s* # optionally followed by
# any of the allowed
# delimiters, followed by any
# space/tab
(?P<value>.*))?$ # everything up to eol
"""
# Interpolation algorithm to be used if the user does not specify another
_DEFAULT_INTERPOLATION = Interpolation()
# Compiled regular expression for matching sections
SECTCRE = re.compile(_SECT_TMPL, re.VERBOSE)
# Compiled regular expression for matching options with typical separators
OPTCRE = re.compile(_OPT_TMPL.format(delim="=|:"), re.VERBOSE)
# Compiled regular expression for matching options with optional values
# delimited using typical separators
OPTCRE_NV = re.compile(_OPT_NV_TMPL.format(delim="=|:"), re.VERBOSE)
# Compiled regular expression for matching leading whitespace in a line
NONSPACECRE = re.compile(r"\S")
# Possible boolean values in the configuration.
BOOLEAN_STATES = {
'1': True,
'yes': True,
'true': True,
'on': True,
'0': False,
'no': False,
'false': False,
'off': False,
}
def __init__(
self,
defaults=None,
dict_type=_default_dict,
allow_no_value=False,
*,
delimiters=('=', ':'),
comment_prefixes=('#', ';'),
inline_comment_prefixes=None,
strict=True,
empty_lines_in_values=True,
default_section=DEFAULTSECT,
interpolation=_UNSET,
converters=_UNSET,
):
self._dict = dict_type
self._sections = self._dict()
self._defaults = self._dict()
self._converters = ConverterMapping(self)
self._proxies = self._dict()
self._proxies[default_section] = SectionProxy(self, default_section)
self._delimiters = tuple(delimiters)
if delimiters == ('=', ':'):
self._optcre = self.OPTCRE_NV if allow_no_value else self.OPTCRE
else:
d = "|".join(re.escape(d) for d in delimiters)
if allow_no_value:
self._optcre = re.compile(self._OPT_NV_TMPL.format(delim=d), re.VERBOSE)
else:
self._optcre = re.compile(self._OPT_TMPL.format(delim=d), re.VERBOSE)
self._comment_prefixes = tuple(comment_prefixes or ())
self._inline_comment_prefixes = tuple(inline_comment_prefixes or ())
self._strict = strict
self._allow_no_value = allow_no_value
self._empty_lines_in_values = empty_lines_in_values
self.default_section = default_section
self._interpolation = interpolation
if self._interpolation is _UNSET:
self._interpolation = self._DEFAULT_INTERPOLATION
if self._interpolation is None:
self._interpolation = Interpolation()
if converters is not _UNSET:
self._converters.update(converters)
if defaults:
self._read_defaults(defaults)
def defaults(self):
return self._defaults
def sections(self):
"""Return a list of section names, excluding [DEFAULT]"""
# self._sections will never have [DEFAULT] in it
return list(self._sections.keys())
def add_section(self, section):
"""Create a new section in the configuration.
Raise DuplicateSectionError if a section by the specified name
already exists. Raise ValueError if name is DEFAULT.
"""
if section == self.default_section:
raise ValueError('Invalid section name: %r' % section)
if section in self._sections:
raise DuplicateSectionError(section)
self._sections[section] = self._dict()
self._proxies[section] = SectionProxy(self, section)
def has_section(self, section):
"""Indicate whether the named section is present in the configuration.
The DEFAULT section is not acknowledged.
"""
return section in self._sections
def options(self, section):
"""Return a list of option names for the given section name."""
try:
opts = self._sections[section].copy()
except KeyError:
raise NoSectionError(section) from None
opts.update(self._defaults)
return list(opts.keys())
def read(self, filenames, encoding=None):
"""Read and parse a filename or an iterable of filenames.
Files that cannot be opened are silently ignored; this is
designed so that you can specify an iterable of potential
configuration file locations (e.g. current directory, user's
home directory, systemwide directory), and all existing
configuration files in the iterable will be read. A single
filename may also be given.
Return list of successfully read files.
"""
if isinstance(filenames, (str, bytes, os.PathLike)):
filenames = [filenames]
encoding = io.text_encoding(encoding)
read_ok = []
for filename in filenames:
try:
with open(filename, encoding=encoding) as fp:
self._read(fp, filename)
except OSError:
continue
if isinstance(filename, os.PathLike):
filename = os.fspath(filename)
read_ok.append(filename)
return read_ok
def read_file(self, f, source=None):
"""Like read() but the argument must be a file-like object.
The `f' argument must be iterable, returning one line at a time.
Optional second argument is the `source' specifying the name of the
file being read. If not given, it is taken from f.name. If `f' has no
`name' attribute, `<???>' is used.
"""
if source is None:
try:
source = f.name
except AttributeError:
source = '<???>'
self._read(f, source)
def read_string(self, string, source='<string>'):
"""Read configuration from a given string."""
sfile = io.StringIO(string)
self.read_file(sfile, source)
def read_dict(self, dictionary, source='<dict>'):
"""Read configuration from a dictionary.
Keys are section names, values are dictionaries with keys and values
that should be present in the section. If the used dictionary type
preserves order, sections and their keys will be added in order.
All types held in the dictionary are converted to strings during
reading, including section names, option names and keys.
Optional second argument is the `source' specifying the name of the
dictionary being read.
"""
elements_added = set()
for section, keys in dictionary.items():
section = str(section)
try:
self.add_section(section)
except (DuplicateSectionError, ValueError):
if self._strict and section in elements_added:
raise
elements_added.add(section)
for key, value in keys.items():
key = self.optionxform(str(key))
if value is not None:
value = str(value)
if self._strict and (section, key) in elements_added:
raise DuplicateOptionError(section, key, source)
elements_added.add((section, key))
self.set(section, key, value)
def readfp(self, fp, filename=None):
"""Deprecated, use read_file instead."""
warnings.warn(
"This method will be removed in future versions. "
"Use 'parser.read_file()' instead.",
DeprecationWarning,
stacklevel=2,
)
self.read_file(fp, source=filename)
def get(self, section, option, *, raw=False, vars=None, fallback=_UNSET):
"""Get an option value for a given section.
If `vars' is provided, it must be a dictionary. The option is looked up
in `vars' (if provided), `section', and in `DEFAULTSECT' in that order.
If the key is not found and `fallback' is provided, it is used as
a fallback value. `None' can be provided as a `fallback' value.
If interpolation is enabled and the optional argument `raw' is False,
all interpolations are expanded in the return values.
Arguments `raw', `vars', and `fallback' are keyword only.
The section DEFAULT is special.
"""
try:
d = self._unify_values(section, vars)
except NoSectionError:
if fallback is _UNSET:
raise
else:
return fallback
option = self.optionxform(option)
try:
value = d[option]
except KeyError:
if fallback is _UNSET:
raise NoOptionError(option, section)
else:
return fallback
if raw or value is None:
return value
else:
return self._interpolation.before_get(self, section, option, value, d)
def _get(self, section, conv, option, **kwargs):
return conv(self.get(section, option, **kwargs))
def _get_conv(
self, section, option, conv, *, raw=False, vars=None, fallback=_UNSET, **kwargs
):
try:
return self._get(section, conv, option, raw=raw, vars=vars, **kwargs)
except (NoSectionError, NoOptionError):
if fallback is _UNSET:
raise
return fallback
# getint, getfloat and getboolean provided directly for backwards compat
def getint(
self, section, option, *, raw=False, vars=None, fallback=_UNSET, **kwargs
):
return self._get_conv(
section, option, int, raw=raw, vars=vars, fallback=fallback, **kwargs
)
def getfloat(
self, section, option, *, raw=False, vars=None, fallback=_UNSET, **kwargs
):
return self._get_conv(
section, option, float, raw=raw, vars=vars, fallback=fallback, **kwargs
)
def getboolean(
self, section, option, *, raw=False, vars=None, fallback=_UNSET, **kwargs
):
return self._get_conv(
section,
option,
self._convert_to_boolean,
raw=raw,
vars=vars,
fallback=fallback,
**kwargs,
)
def items(self, section=_UNSET, raw=False, vars=None):
"""Return a list of (name, value) tuples for each option in a section.
All % interpolations are expanded in the return values, based on the
defaults passed into the constructor, unless the optional argument
`raw' is true. Additional substitutions may be provided using the
`vars' argument, which must be a dictionary whose contents overrides
any pre-existing defaults.
The section DEFAULT is special.
"""
if section is _UNSET:
return super(RawConfigParser, self).items()
d = self._defaults.copy()
try:
d.update(self._sections[section])
except KeyError:
if section != self.default_section:
raise NoSectionError(section)
orig_keys = list(d.keys())
# Update with the entry specific variables
if vars:
for key, value in vars.items():
d[self.optionxform(key)] = value
def value_getter_interp(option):
return self._interpolation.before_get(self, section, option, d[option], d)
def value_getter_raw(option):
return d[option]
value_getter = value_getter_raw if raw else value_getter_interp
return [(option, value_getter(option)) for option in orig_keys]
def popitem(self):
"""Remove a section from the parser and return it as
a (section_name, section_proxy) tuple. If no section is present, raise
KeyError.
The section DEFAULT is never returned because it cannot be removed.
"""
for key in self.sections():
value = self[key]
del self[key]
return key, value
raise KeyError
def optionxform(self, optionstr):
return optionstr.lower()
def has_option(self, section, option):
"""Check for the existence of a given option in a given section.
If the specified `section' is None or an empty string, DEFAULT is
assumed. If the specified `section' does not exist, returns False."""
if not section or section == self.default_section:
option = self.optionxform(option)
return option in self._defaults
elif section not in self._sections:
return False
else:
option = self.optionxform(option)
return option in self._sections[section] or option in self._defaults
def set(self, section, option, value=None):
"""Set an option."""
if value:
value = self._interpolation.before_set(self, section, option, value)
if not section or section == self.default_section:
sectdict = self._defaults
else:
try:
sectdict = self._sections[section]
except KeyError:
raise NoSectionError(section) from None
sectdict[self.optionxform(option)] = value
def write(self, fp, space_around_delimiters=True):
"""Write an .ini-format representation of the configuration state.
If `space_around_delimiters' is True (the default), delimiters
between keys and values are surrounded by spaces.
Please note that comments in the original configuration file are not
preserved when writing the configuration back.
"""
if space_around_delimiters:
d = " {} ".format(self._delimiters[0])
else:
d = self._delimiters[0]
if self._defaults:
self._write_section(fp, self.default_section, self._defaults.items(), d)
for section in self._sections:
self._write_section(fp, section, self._sections[section].items(), d)
def _write_section(self, fp, section_name, section_items, delimiter):
"""Write a single section to the specified `fp'."""
fp.write("[{}]\n".format(section_name))
for key, value in section_items:
value = self._interpolation.before_write(self, section_name, key, value)
if value is not None or not self._allow_no_value:
value = delimiter + str(value).replace('\n', '\n\t')
else:
value = ""
fp.write("{}{}\n".format(key, value))
fp.write("\n")
def remove_option(self, section, option):
"""Remove an option."""
if not section or section == self.default_section:
sectdict = self._defaults
else:
try:
sectdict = self._sections[section]
except KeyError:
raise NoSectionError(section) from None
option = self.optionxform(option)
existed = option in sectdict
if existed:
del sectdict[option]
return existed
def remove_section(self, section):
"""Remove a file section."""
existed = section in self._sections
if existed:
del self._sections[section]
del self._proxies[section]
return existed
def __getitem__(self, key):
if key != self.default_section and not self.has_section(key):
raise KeyError(key)
return self._proxies[key]
def __setitem__(self, key, value):
# To conform with the mapping protocol, overwrites existing values in
# the section.
if key in self and self[key] is value:
return
# XXX this is not atomic if read_dict fails at any point. Then again,
# no update method in configparser is atomic in this implementation.
if key == self.default_section:
self._defaults.clear()
elif key in self._sections:
self._sections[key].clear()
self.read_dict({key: value})
def __delitem__(self, key):
if key == self.default_section:
raise ValueError("Cannot remove the default section.")
if not self.has_section(key):
raise KeyError(key)
self.remove_section(key)
def __contains__(self, key):
return key == self.default_section or self.has_section(key)
def __len__(self):
return len(self._sections) + 1 # the default section
def __iter__(self):
# XXX does it break when underlying container state changed?
return itertools.chain((self.default_section,), self._sections.keys())
def _read(self, fp, fpname): # noqa: C901
"""Parse a sectioned configuration file.
Each section in a configuration file contains a header, indicated by
a name in square brackets (`[]'), plus key/value options, indicated by
`name' and `value' delimited with a specific substring (`=' or `:' by
default).
Values can span multiple lines, as long as they are indented deeper
than the first line of the value. Depending on the parser's mode, blank
lines may be treated as parts of multiline values or ignored.
Configuration files may include comments, prefixed by specific
characters (`#' and `;' by default). Comments may appear on their own
in an otherwise empty line or may be entered in lines holding values or
section names. Please note that comments get stripped off when reading
configuration files.
"""
elements_added = set()
cursect = None # None, or a dictionary
sectname = None
optname = None
lineno = 0
indent_level = 0
e = None # None, or an exception
for lineno, line in enumerate(fp, start=1):
comment_start = sys.maxsize
# strip inline comments
inline_prefixes = {p: -1 for p in self._inline_comment_prefixes}
while comment_start == sys.maxsize and inline_prefixes:
next_prefixes = {}
for prefix, index in inline_prefixes.items():
index = line.find(prefix, index + 1)
if index == -1:
continue
next_prefixes[prefix] = index
if index == 0 or (index > 0 and line[index - 1].isspace()):
comment_start = min(comment_start, index)
inline_prefixes = next_prefixes
# strip full line comments
for prefix in self._comment_prefixes:
if line.strip().startswith(prefix):
comment_start = 0
break
if comment_start == sys.maxsize:
comment_start = None
value = line[:comment_start].strip()
if not value:
if self._empty_lines_in_values:
# add empty line to the value, but only if there was no
# comment on the line
if (
comment_start is None
and cursect is not None
and optname
and cursect[optname] is not None
):
cursect[optname].append('') # newlines added at join
else:
# empty line marks end of value
indent_level = sys.maxsize
continue
# continuation line?
first_nonspace = self.NONSPACECRE.search(line)
cur_indent_level = first_nonspace.start() if first_nonspace else 0
if cursect is not None and optname and cur_indent_level > indent_level:
cursect[optname].append(value)
# a section header or option header?
else:
indent_level = cur_indent_level
# is it a section header?
mo = self.SECTCRE.match(value)
if mo:
sectname = mo.group('header')
if sectname in self._sections:
if self._strict and sectname in elements_added:
raise DuplicateSectionError(sectname, fpname, lineno)
cursect = self._sections[sectname]
elements_added.add(sectname)
elif sectname == self.default_section:
cursect = self._defaults
else:
cursect = self._dict()
self._sections[sectname] = cursect
self._proxies[sectname] = SectionProxy(self, sectname)
elements_added.add(sectname)
# So sections can't start with a continuation line
optname = None
# no section header in the file?
elif cursect is None:
raise MissingSectionHeaderError(fpname, lineno, line)
# an option line?
else:
mo = self._optcre.match(value)
if mo:
optname, vi, optval = mo.group('option', 'vi', 'value')
if not optname:
e = self._handle_error(e, fpname, lineno, line)
optname = self.optionxform(optname.rstrip())
if self._strict and (sectname, optname) in elements_added:
raise DuplicateOptionError(
sectname, optname, fpname, lineno
)
elements_added.add((sectname, optname))
# This check is fine because the OPTCRE cannot
# match if it would set optval to None
if optval is not None:
optval = optval.strip()
cursect[optname] = [optval]
else:
# valueless option handling
cursect[optname] = None
else:
# a non-fatal parsing error occurred. set up the
# exception but keep going. the exception will be
# raised at the end of the file and will contain a
# list of all bogus lines
e = self._handle_error(e, fpname, lineno, line)
self._join_multiline_values()
# if any parsing errors occurred, raise an exception
if e:
raise e
def _join_multiline_values(self):
defaults = self.default_section, self._defaults
all_sections = itertools.chain((defaults,), self._sections.items())
for section, options in all_sections:
for name, val in options.items():
if isinstance(val, list):
val = '\n'.join(val).rstrip()
options[name] = self._interpolation.before_read(
self, section, name, val
)
def _read_defaults(self, defaults):
"""Read the defaults passed in the initializer.
Note: values can be non-string."""
for key, value in defaults.items():
self._defaults[self.optionxform(key)] = value
def _handle_error(self, exc, fpname, lineno, line):
if not exc:
exc = ParsingError(fpname)
exc.append(lineno, repr(line))
return exc
def _unify_values(self, section, vars):
"""Create a sequence of lookups with 'vars' taking priority over
the 'section' which takes priority over the DEFAULTSECT.
"""
sectiondict = {}
try:
sectiondict = self._sections[section]
except KeyError:
if section != self.default_section:
raise NoSectionError(section)
# Update with the entry specific variables
vardict = {}
if vars:
for key, value in vars.items():
if value is not None:
value = str(value)
vardict[self.optionxform(key)] = value
return _ChainMap(vardict, sectiondict, self._defaults)
def _convert_to_boolean(self, value):
"""Return a boolean value translating from other types if necessary."""
if value.lower() not in self.BOOLEAN_STATES:
raise ValueError('Not a boolean: %s' % value)
return self.BOOLEAN_STATES[value.lower()]
def _validate_value_types(self, *, section="", option="", value=""):
"""Raises a TypeError for non-string values.
The only legal non-string value if we allow valueless
options is None, so we need to check if the value is a
string if:
- we do not allow valueless options, or
- we allow valueless options but the value is not None
For compatibility reasons this method is not used in classic set()
for RawConfigParsers. It is invoked in every case for mapping protocol
access and in ConfigParser.set().
"""
if not isinstance(section, str):
raise TypeError("section names must be strings")
if not isinstance(option, str):
raise TypeError("option keys must be strings")
if not self._allow_no_value or value:
if not isinstance(value, str):
raise TypeError("option values must be strings")
@property
def converters(self):
return self._converters
class ConfigParser(RawConfigParser):
"""ConfigParser implementing interpolation."""
_DEFAULT_INTERPOLATION = BasicInterpolation()
def set(self, section, option, value=None):
"""Set an option. Extends RawConfigParser.set by validating type and
interpolation syntax on the value."""
self._validate_value_types(option=option, value=value)
super().set(section, option, value)
def add_section(self, section):
"""Create a new section in the configuration. Extends
RawConfigParser.add_section by validating if the section name is
a string."""
self._validate_value_types(section=section)
super().add_section(section)
def _read_defaults(self, defaults):
"""Reads the defaults passed in the initializer, implicitly converting
values to strings like the rest of the API.
Does not perform interpolation for backwards compatibility.
"""
try:
hold_interpolation = self._interpolation
self._interpolation = Interpolation()
self.read_dict({self.default_section: defaults})
finally:
self._interpolation = hold_interpolation
class SafeConfigParser(ConfigParser):
"""ConfigParser alias for backwards compatibility purposes."""
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
warnings.warn(
"The SafeConfigParser class has been renamed to ConfigParser "
"in Python 3.2. This alias will be removed in future versions."
" Use ConfigParser directly instead.",
DeprecationWarning,
stacklevel=2,
)
class SectionProxy(MutableMapping):
"""A proxy for a single section from a parser."""
def __init__(self, parser, name):
"""Creates a view on a section of the specified `name` in `parser`."""
self._parser = parser
self._name = name
for conv in parser.converters:
key = 'get' + conv
getter = functools.partial(self.get, _impl=getattr(parser, key))
setattr(self, key, getter)
def __repr__(self):
return '<Section: {}>'.format(self._name)
def __getitem__(self, key):
if not self._parser.has_option(self._name, key):
raise KeyError(key)
return self._parser.get(self._name, key)
def __setitem__(self, key, value):
self._parser._validate_value_types(option=key, value=value)
return self._parser.set(self._name, key, value)
def __delitem__(self, key):
if not (
self._parser.has_option(self._name, key)
and self._parser.remove_option(self._name, key)
):
raise KeyError(key)
def __contains__(self, key):
return self._parser.has_option(self._name, key)
def __len__(self):
return len(self._options())
def __iter__(self):
return self._options().__iter__()
def _options(self):
if self._name != self._parser.default_section:
return self._parser.options(self._name)
else:
return self._parser.defaults()
@property
def parser(self):
# The parser object of the proxy is read-only.
return self._parser
@property
def name(self):
# The name of the section on a proxy is read-only.
return self._name
def get(self, option, fallback=None, *, raw=False, vars=None, _impl=None, **kwargs):
"""Get an option value.
Unless `fallback` is provided, `None` will be returned if the option
is not found.
"""
# If `_impl` is provided, it should be a getter method on the parser
# object that provides the desired type conversion.
if not _impl:
_impl = self._parser.get
return _impl(
self._name, option, raw=raw, vars=vars, fallback=fallback, **kwargs
)
class ConverterMapping(MutableMapping):
"""Enables reuse of get*() methods between the parser and section proxies.
If a parser class implements a getter directly, the value for the given
key will be ``None``. The presence of the converter name here enables
section proxies to find and use the implementation on the parser class.
"""
GETTERCRE = re.compile(r"^get(?P<name>.+)$")
def __init__(self, parser):
self._parser = parser
self._data = {}
for getter in dir(self._parser):
m = self.GETTERCRE.match(getter)
if not m or not callable(getattr(self._parser, getter)):
continue
self._data[m.group('name')] = None # See class docstring.
def __getitem__(self, key):
return self._data[key]
def __setitem__(self, key, value):
try:
k = 'get' + key
except TypeError:
raise ValueError(
'Incompatible key: {} (type: {})' ''.format(key, type(key))
)
if k == 'get':
raise ValueError('Incompatible key: cannot use "" as a name')
self._data[key] = value
func = functools.partial(self._parser._get_conv, conv=value)
func.converter = value
setattr(self._parser, k, func)
for proxy in self._parser.values():
getter = functools.partial(proxy.get, _impl=func)
setattr(proxy, k, getter)
def __delitem__(self, key):
try:
k = 'get' + (key or None)
except TypeError:
raise KeyError(key)
del self._data[key]
for inst in itertools.chain((self._parser,), self._parser.values()):
try:
delattr(inst, k)
except AttributeError:
# don't raise since the entry was present in _data, silently
# clean up
continue
def __iter__(self):
return iter(self._data)
def __len__(self):
return len(self._data)
PK �@u\���� � 8 backports/configparser/__pycache__/compat.cpython-39.pycnu �[��� a
��?h� � @ s2 d dl Z d dlZddd�Zdd� Zeeed�ZdS ) � N� c C s | S )zE
Stubbed version of io.text_encoding as found in Python 3.10
� )�encoding�
stacklevelr r �G/usr/local/lib/python3.9/site-packages/backports/configparser/compat.py�
text_encoding s r c K s6 t j| j| jd�}t|��|� t|��t| �� |S )N)�doc)�types�
ModuleType�__name__�__doc__�vars�update)�mod�defaults�copyr r r � copy_module s r )r )r )r �io�_ior r r r r r �<module> s
PK �@u\HEʷ�� �� : backports/configparser/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZ ddlmZ ddlZddlmZ ddl Z ddl
Z
ddl Z ddl Z ddl
Z
g d�ZeZdZd ZG d
d � d e�ZG d d
� d
e�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�Z G d d � d e�Z G d d � d e �Z e � Z G d d!� d!�Z!G d"d#� d#e!�Z"G d$d%� d%e!�Z#G d&d'� d'e!�Z$G d(d)� d)e�Z%G d*d+� d+e%�Z&G d,d-� d-e&�Z'G d.d/� d/e�Z(G d0d1� d1e�Z)dS )2a� Configuration file parser.
A configuration file consists of sections, lead by a "[section]" header,
and followed by "name: value" entries, with continuations and such in
the style of RFC 822.
Intrinsic defaults can be specified by passing them into the
ConfigParser constructor as a dictionary.
class:
ConfigParser -- responsible for parsing a list of
configuration files, and managing the parsed database.
methods:
__init__(defaults=None, dict_type=_default_dict, allow_no_value=False,
delimiters=('=', ':'), comment_prefixes=('#', ';'),
inline_comment_prefixes=None, strict=True,
empty_lines_in_values=True, default_section='DEFAULT',
interpolation=<unset>, converters=<unset>):
Create the parser. When `defaults' is given, it is initialized into the
dictionary or intrinsic defaults. The keys must be strings, the values
must be appropriate for %()s string interpolation.
When `dict_type' is given, it will be used to create the dictionary
objects for the list of sections, for the options within a section, and
for the default values.
When `delimiters' is given, it will be used as the set of substrings
that divide keys from values.
When `comment_prefixes' is given, it will be used as the set of
substrings that prefix comments in empty lines. Comments can be
indented.
When `inline_comment_prefixes' is given, it will be used as the set of
substrings that prefix comments in non-empty lines.
When `strict` is True, the parser won't allow for any section or option
duplicates while reading from a single source (file, string or
dictionary). Default is True.
When `empty_lines_in_values' is False (default: True), each empty line
marks the end of an option. Otherwise, internal empty lines of
a multiline option are kept as part of the value.
When `allow_no_value' is True (default: False), options without
values are accepted; the value presented for these is None.
When `default_section' is given, the name of the special section is
named accordingly. By default it is called ``"DEFAULT"`` but this can
be customized to point to any other valid section name. Its current
value can be retrieved using the ``parser_instance.default_section``
attribute and may be modified at runtime.
When `interpolation` is given, it should be an Interpolation subclass
instance. It will be used as the handler for option value
pre-processing when using getters. RawConfigParser objects don't do
any sort of interpolation, whereas ConfigParser uses an instance of
BasicInterpolation. The library also provides a ``zc.buildbot``
inspired ExtendedInterpolation implementation.
When `converters` is given, it should be a dictionary where each key
represents the name of a type converter and each value is a callable
implementing the conversion from string to the desired datatype. Every
converter gets its corresponding get*() method on the parser object and
section proxies.
sections()
Return all the configuration section names, sans DEFAULT.
has_section(section)
Return whether the given section exists.
has_option(section, option)
Return whether the given option exists in the given section.
options(section)
Return list of configuration options for the named section.
read(filenames, encoding=None)
Read and parse the iterable of named configuration files, given by
name. A single filename is also allowed. Non-existing files
are ignored. Return list of successfully read files.
read_file(f, filename=None)
Read and parse one configuration file, given as a file object.
The filename defaults to f.name; it is only used in error
messages (if f has no `name' attribute, the string `<???>' is used).
read_string(string)
Read configuration from a given string.
read_dict(dictionary)
Read configuration from a dictionary. Keys are section names,
values are dictionaries with keys and values that should be present
in the section. If the used dictionary type preserves order, sections
and their keys will be added in order. Values are automatically
converted to strings.
get(section, option, raw=False, vars=None, fallback=_UNSET)
Return a string value for the named option. All % interpolations are
expanded in the return values, based on the defaults passed into the
constructor and the DEFAULT section. Additional substitutions may be
provided using the `vars' argument, which must be a dictionary whose
contents override any pre-existing defaults. If `option' is a key in
`vars', the value from `vars' is used.
getint(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to an integer.
getfloat(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to a float.
getboolean(section, options, raw=False, vars=None, fallback=_UNSET)
Like get(), but convert value to a boolean (currently case
insensitively defined as 0, false, no, off for False, and 1, true,
yes, on for True). Returns False or True.
items(section=_UNSET, raw=False, vars=None)
If section is given, return a list of tuples with (name, value) for
each option in the section. Otherwise, return a list of tuples with
(section_name, section_proxy) for each section, including DEFAULTSECT.
remove_section(section)
Remove the given file section and all its options.
remove_option(section, option)
Remove the given option from the given section.
set(section, option, value)
Set the given option.
write(fp, space_around_delimiters=True)
Write the configuration state in .ini format. If
`space_around_delimiters' is True (the default), delimiters
between keys and values are surrounded by spaces.
� )�MutableMapping)�ChainMapN� )�io)�NoSectionError�DuplicateOptionError�DuplicateSectionError�
NoOptionError�InterpolationError�InterpolationDepthError� InterpolationMissingOptionError�InterpolationSyntaxError� ParsingError�MissingSectionHeaderError� ConfigParser�SafeConfigParser�RawConfigParser�
Interpolation�BasicInterpolation�ExtendedInterpolation�LegacyInterpolation� SectionProxy�ConverterMapping� DEFAULTSECT�MAX_INTERPOLATION_DEPTH�DEFAULT�
c @ s& e Zd ZdZddd�Zdd� ZeZdS ) �Errorz'Base class for ConfigParser exceptions.� c C s || _ t�| |� d S �N)�message� Exception�__init__)�self�msg� r% �I/usr/local/lib/python3.9/site-packages/backports/configparser/__init__.pyr" � s zError.__init__c C s | j S r )r �r# r% r% r& �__repr__� s zError.__repr__N)r )�__name__�
__module__� __qualname__�__doc__r" r( �__str__r% r% r% r& r � s
r c @ s e Zd ZdZdd� ZdS )r z2Raised when no section matches a requested option.c C s$ t �| d|f � || _|f| _d S )NzNo section: %r)r r" �section�args�r# r. r% r% r& r" � s zNoSectionError.__init__N�r) r* r+ r, r" r% r% r% r& r � s r c @ s e Zd ZdZddd�ZdS )r a Raised when a section is repeated in an input source.
Possible repetitions that raise this exception are: multiple creation
using the API or in strict parsers when a section is found more than once
in a single input file, string or dictionary.
Nc C s� t |�dg}|d urRdt |�g}|d ur8|�d�|�� |�d� |�|� |}n |�dd� t�| d�|�� || _|| _ || _
|||f| _ d S )N� already exists�While reading from � [line {0:2d}]z
: section r zSection r ) �repr�append�format�extend�insertr r" �joinr. �source�linenor/ )r# r. r; r< r$ r r% r% r& r" � s
z DuplicateSectionError.__init__)NNr1 r% r% r% r& r � s r c @ s e Zd ZdZddd�ZdS )r z�Raised by strict parsers when an option is repeated in an input source.
Current implementation raises this exception only when an option is found
more than once in a single file, string or dictionary.
Nc C s� t |�dt |�dg}|d urZdt |�g}|d ur@|�d�|�� |�d� |�|� |}n |�dd� t�| d�|�� || _|| _ || _
|| _ ||||f| _ d S ) Nz in section r2 r3 r4 z : option r zOption r )
r5 r6 r7 r8 r9 r r" r: r. �optionr; r< r/ )r# r. r= r; r< r$ r r% r% r& r" � s
z DuplicateOptionError.__init__)NNr1 r% r% r% r& r � s r c @ s e Zd ZdZdd� ZdS )r z!A requested option was not found.c C s. t �| d||f � || _|| _||f| _d S )NzNo option %r in section: %r�r r" r= r. r/ )r# r= r. r% r% r& r" s zNoOptionError.__init__Nr1 r% r% r% r& r s r c @ s e Zd ZdZdd� ZdS )r
z0Base class for interpolation-related exceptions.c C s( t �| |� || _|| _|||f| _d S r r> )r# r= r. r$ r% r% r& r" s zInterpolationError.__init__Nr1 r% r% r% r& r
s r
c @ s e Zd ZdZdd� ZdS )r zAA string substitution required a setting which was not available.c C s8 d� ||||�}t�| |||� || _||||f| _d S )Nz�Bad value substitution: option {!r} in section {!r} contains an interpolation key {!r} which is not a valid option name. Raw value: {!r})r7 r
r" � referencer/ )r# r= r. �rawvalr? r$ r% r% r& r" s ��z(InterpolationMissingOptionError.__init__Nr1 r% r% r% r& r s r c @ s e Zd ZdZdS )r
z�Raised when the source text contains invalid syntax.
Current implementation raises this exception when the source text into
which substitutions are made does not conform to the required syntax.
N)r) r* r+ r, r% r% r% r& r
# s r
c @ s e Zd ZdZdd� ZdS )r z0Raised when substitutions are nested too deeply.c C s0 d� ||t|�}t�| |||� |||f| _d S )Nz�Recursion limit exceeded in value substitution: option {!r} in section {!r} contains an interpolation key which cannot be substituted in {} steps. Raw value: {!r})r7 r r
r" r/ )r# r= r. r@ r$ r% r% r& r" . s ��z InterpolationDepthError.__init__Nr1 r% r% r% r& r + s r c @ s< e Zd ZdZd
dd�Zedd� �Zejdd� �Zdd � ZdS ) r z>Raised when a configuration file does not follow legal syntax.Nc C sT |r|rt d��n|s$|s$t d��n|r,|}t�| d| � || _g | _|f| _d S )Nz:Cannot specify both `filename' and `source'. Use `source'.z%Required argument `source' not given.z"Source contains parsing errors: %r)�
ValueErrorr r" r; �errorsr/ )r# r; �filenamer% r% r& r" < s �
zParsingError.__init__c C s t jdtdd� | jS )zDeprecated, use `source'.�SThe 'filename' attribute will be removed in future versions. Use 'source' instead.� ��
stacklevel��warnings�warn�DeprecationWarningr; r' r% r% r& rC L s �zParsingError.filenamec C s t jdtdd� || _dS )zDeprecated, user `source'.rD rE rF NrH �r# �valuer% r% r& rC W s �c C s* | j �||f� | jd||f 7 _d S )Nz
[line %2d]: %s)rB r6 r )r# r< �liner% r% r& r6 b s zParsingError.append)NN) r) r* r+ r, r" �propertyrC �setterr6 r% r% r% r& r 9 s
r c @ s e Zd ZdZdd� ZdS )r z@Raised when a key-value pair is found before any section header.c C s8 t �| d|||f � || _|| _|| _|||f| _d S )Nz7File contains no section headers.
file: %r, line: %d
%r)r r" r; r< rN r/ )r# rC r< rN r% r% r& r" j s ��z"MissingSectionHeaderError.__init__Nr1 r% r% r% r& r g s r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r zBDummy interpolation that passes the value through with no changes.c C s |S r r% )r# �parserr. r= rM �defaultsr% r% r& �
before_get s zInterpolation.before_getc C s |S r r% �r# rQ r. r= rM r% r% r& �
before_set� s zInterpolation.before_setc C s |S r r% rT r% r% r& � before_read� s zInterpolation.before_readc C s |S r r% rT r% r% r& � before_write� s zInterpolation.before_writeN)r) r* r+ r, rS rU rV rW r% r% r% r& r | s
r c @ s2 e Zd ZdZe�d�Zdd� Zdd� Zdd� Z d S )
r a! Interpolation as implemented in the classic ConfigParser.
The option values can contain format strings which refer to other values in
the same section, or values in the special default section.
For example:
something: %(dir)s/whatever
would resolve the "%(dir)s" to the value of dir. All reference
expansions are done late, on demand. If a user needs to use a bare % in
a configuration file, she can escape it by writing %%. Other % usage
is considered a user error and raises `InterpolationSyntaxError'.z
%\(([^)]+)\)sc C s$ g }| � ||||||d� d�|�S �Nr r ��_interpolate_somer: �r# rQ r. r= rM rR �Lr% r% r& rS � s z BasicInterpolation.before_getc C s< |� dd�}| j�d|�}d|v r8td||�d�f ��|S )Nz%%r �%�1invalid interpolation syntax in %r at position %d��replace�_KEYCRE�subrA �find�r# rQ r. r= rM � tmp_valuer% r% r& rU � s ��z BasicInterpolation.before_setc
C sh |j ||d|d�}|tkr&t|||��|�rd|�d�} | dk rL|�|� d S | dkrr|�|d | � � || d � }|dd� }
|
dkr�|�d� |dd � }q&|
dk�rP| j�|�} | d u r�t||d| ��|�| � d��} || �
� d � }z || }
W n$ t �y t |||| �d �Y n0 d|
v �rD| �
||||
|||d � n
|�|
� q&t||d |f ��q&d S )
NT��raw�fallbackr] r r rE �(�'bad interpolation variable reference %rz/'%%' must be followed by '%%' or '(', found: %r)�getr r rc r6 ra �matchr
� optionxform�group�end�KeyErrorr rZ )r# rQ r= �accum�restr. �map�depthr@ �p�c�m�var�vr% r% r& rZ � sV
� ��
� �z$BasicInterpolation._interpolate_someN�
r) r* r+ r, �re�compilera rS rU rZ r% r% r% r& r � s
r c @ s2 e Zd ZdZe�d�Zdd� Zdd� Zdd� Z d S )
r zyAdvanced variant of interpolation, supports the syntax used by
`zc.buildout'. Enables interpolation between sections.z
\$\{([^}]+)\}c C s$ g }| � ||||||d� d�|�S rX rY r[ r% r% r& rS � s z ExtendedInterpolation.before_getc C s< |� dd�}| j�d|�}d|v r8td||�d�f ��|S )Nz$$r �$r^ r_ rd r% r% r& rU � s ��z ExtendedInterpolation.before_setc C s� |j ||d|d�}|tkr&t|||��|�r�|�d�} | dk rL|�|� d S | dkrr|�|d | � � || d � }|dd� }
|
dkr�|�d� |dd � }q&|
dk�r�| j�|�} | d u r�t||d| ��| �d�� d �} || �
� d � }|}
|}zrt | �dk�r |� | d �}|| }nHt | �dk�rR| d }
|� | d �}|j |
|dd
�}nt||d |f ��W n0 t
ttf�y� t|||d �| ��d �Y n0 d|v �r�| �|||||
t|j|
dd
��|d � n
|�|� q&t||d |f ��q&d S )
NTrf r} r r rE �{rj �:)rg zMore than one ':' found: %rz-'$' must be followed by '$' or '{', found: %r)rk r r rc r6 ra rl r
rn �splitro �lenrm rp r r r r: rZ �dict�items)r# rQ r= rq rr r. rs rt r@ ru rv rw �path�sect�optry r% r% r& rZ � sx
�
���
�
�z'ExtendedInterpolation._interpolate_someNrz r% r% r% r& r � s
r c @ s6 e Zd ZdZe�d�Zdd� Zdd� Ze dd� �Z
d S )
r z{Deprecated interpolation used in old versions of ConfigParser.
Use BasicInterpolation or ExtendedInterpolation instead.z%\(([^)]*)\)s|.c
C s� |}t }|r�|d8 }|r�d|v r�tj| j|d�}| j�||�}z || }W q� ty� } z"t|||| jd �d �W Y d } ~ q�d } ~ 0 0 qq�q|r�d|v r�t |||��|S )Nr z%()rQ r )
r � functools�partial�_interpolation_replacera rb rp r r/ r )
r# rQ r. r= rM �varsr@ rt r` �er% r% r& rS ; s& �� z LegacyInterpolation.before_getc C s |S r r% rT r% r% r& rU O s z LegacyInterpolation.before_setc C s, | � d�}|d u r| � � S d|�|� S d S )Nr z%%(%s)s)rn rm )rl rQ �sr% r% r& r� R s
z*LegacyInterpolation._interpolation_replaceN) r) r* r+ r, r{ r| ra rS rU � staticmethodr� r% r% r% r& r 5 s
r c
s6 e Zd ZdZdZdZdZe� Ze �
ee j �Z e �
ej
dd�e j �Ze �
ej
dd�e j �Ze �
d�Zddddd d d d d
�Zd ed fd d
d ddeeed�dd�Zdd� Zdd� Zdd� Zdd� Zdd� Zdddd �Zded d �Z dfd d!�Z dgd#d$�Z dhd%d&�Z d d ed'�d(d)�Z d*d+� Z!d d ed'�d,d-�Z"d d ed'�d.d/�Z#d d ed'�d0d1�Z$d d ed'�d2d3�Z%ed d f� fd4d5� Z&d6d7� Z'd8d9� Z(d:d;� Z)did<d=�Z*djd>d?�Z+d@dA� Z,dBdC� Z-dDdE� Z.dFdG� Z/dHdI� Z0dJdK� Z1dLdM� Z2dNdO� Z3dPdQ� Z4dRdS� Z5dTdU� Z6dVdW� Z7dXdY� Z8dZd[� Z9d\d]� Z:d^d^d^d_�d`da�Z;e<dbdc� �Z=� Z>S )kr z,ConfigParser that does not do interpolation.z�
\[ # [
(?P<header>.+) # very permissive!
\] # ]
a�
(?P<option>.*?) # very permissive!
\s*(?P<vi>{delim})\s* # any number of space/tab,
# followed by any of the
# allowed delimiters,
# followed by any space/tab
(?P<value>.*)$ # everything up to eol
a�
(?P<option>.*?) # very permissive!
\s*(?: # any number of space/tab,
(?P<vi>{delim})\s* # optionally followed by
# any of the allowed
# delimiters, followed by any
# space/tab
(?P<value>.*))?$ # everything up to eol
z=|:��delimz\STF)�1�yes�true�on�0�no�false�offN��=r )�#�;)�
delimiters�comment_prefixes�inline_comment_prefixes�strict�empty_lines_in_values�default_section�
interpolation�
convertersc
C s< || _ | � � | _| � � | _t| �| _| � � | _t| | �| j| < t|�| _|dkrd|rZ| j n| j
| _ nNd� dd� |D ��} |r�t
�| jj| d�t
j�| _ nt
�| jj| d�t
j�| _ t|p�d�| _t|p�d�| _|| _|| _|| _| | _|
| _| jtu r�| j| _| jd u �rt � | _| tu�r(| j� | � |�r8| � |� d S )Nr� �|c s s | ]}t �|�V qd S r )r{ �escape)�.0�dr% r% r& � <genexpr>� � z+RawConfigParser.__init__.<locals>.<genexpr>r� r% ) �_dict� _sections� _defaultsr � _converters�_proxiesr �tuple� _delimiters� OPTCRE_NV�OPTCRE�_optcrer: r{ r| � _OPT_NV_TMPLr7 �VERBOSE� _OPT_TMPL�_comment_prefixes�_inline_comment_prefixes�_strict�_allow_no_value�_empty_lines_in_valuesr� �_interpolation�_UNSET�_DEFAULT_INTERPOLATIONr �update�_read_defaults)
r# rR � dict_type�allow_no_valuer� r� r� r� r� r� r� r� r� r% r% r& r" � s8
zRawConfigParser.__init__c C s | j S r )r� r' r% r% r& rR � s zRawConfigParser.defaultsc C s t | j�� �S )z3Return a list of section names, excluding [DEFAULT])�listr� �keysr' r% r% r& �sections� s zRawConfigParser.sectionsc C sJ || j krtd| ��|| jv r(t|��| �� | j|< t| |�| j|< dS )z�Create a new section in the configuration.
Raise DuplicateSectionError if a section by the specified name
already exists. Raise ValueError if name is DEFAULT.
zInvalid section name: %rN)r� rA r� r r� r r� r0 r% r% r& � add_section� s
zRawConfigParser.add_sectionc C s
|| j v S )z~Indicate whether the named section is present in the configuration.
The DEFAULT section is not acknowledged.
)r� r0 r% r% r& � has_section� s zRawConfigParser.has_sectionc C sH z| j | �� }W n ty. t|�d�Y n0 |�| j� t|�� �S )z9Return a list of option names for the given section name.N)r� �copyrp r r� r� r� r� )r# r. �optsr% r% r& �options� s zRawConfigParser.optionsc C s� t |tttjf�r|g}t�|�}g }|D ]x}z<t||d�� }| �||� W d � n1 s^0 Y W n t y� Y q*Y n0 t |tj�r�t�
|�}|� |� q*|S )a� Read and parse a filename or an iterable of filenames.
Files that cannot be opened are silently ignored; this is
designed so that you can specify an iterable of potential
configuration file locations (e.g. current directory, user's
home directory, systemwide directory), and all existing
configuration files in the iterable will be read. A single
filename may also be given.
Return list of successfully read files.
)�encodingN) �
isinstance�str�bytes�os�PathLiker Z
text_encoding�open�_read�OSError�fspathr6 )r# � filenamesr� �read_okrC �fpr% r% r& �read� s
.
zRawConfigParser.readc C s: |du r*z
|j }W n ty( d}Y n0 | �||� dS )aP Like read() but the argument must be a file-like object.
The `f' argument must be iterable, returning one line at a time.
Optional second argument is the `source' specifying the name of the
file being read. If not given, it is taken from f.name. If `f' has no
`name' attribute, `<???>' is used.
Nz<???>)�name�AttributeErrorr� )r# �fr; r% r% r& � read_file� s
zRawConfigParser.read_file�<string>c C s t �|�}| �||� dS )z'Read configuration from a given string.N)r �StringIOr� )r# �stringr; �sfiler% r% r& � read_string s
zRawConfigParser.read_string�<dict>c
C s� t � }|�� D ]�\}}t|�}z| �|� W n& ttfyR | jrN||v rN� Y n0 |�|� |�� D ]`\}}| �t|��}|dur�t|�}| jr�||f|v r�t |||��|�||f� | � |||� qfqdS )a Read configuration from a dictionary.
Keys are section names, values are dictionaries with keys and values
that should be present in the section. If the used dictionary type
preserves order, sections and their keys will be added in order.
All types held in the dictionary are converted to strings during
reading, including section names, option names and keys.
Optional second argument is the `source' specifying the name of the
dictionary being read.
N)
�setr� r� r� r rA r� �addrm r )r# �
dictionaryr; �elements_addedr. r� �keyrM r% r% r& � read_dict s"
zRawConfigParser.read_dictc C s" t jdtdd� | j||d� dS )z"Deprecated, use read_file instead.zRThis method will be removed in future versions. Use 'parser.read_file()' instead.rE rF )r; N)rI rJ rK r� )r# r� rC r% r% r& �readfp/ s �zRawConfigParser.readfp�rg r� rh c C s� z| � ||�}W n& ty6 |tu r*� n| Y S Y n0 | �|�}z || }W n. ty| |tu rpt||��n| Y S Y n0 |s�|du r�|S | j�| ||||�S dS )a] Get an option value for a given section.
If `vars' is provided, it must be a dictionary. The option is looked up
in `vars' (if provided), `section', and in `DEFAULTSECT' in that order.
If the key is not found and `fallback' is provided, it is used as
a fallback value. `None' can be provided as a `fallback' value.
If interpolation is enabled and the optional argument `raw' is False,
all interpolations are expanded in the return values.
Arguments `raw', `vars', and `fallback' are keyword only.
The section DEFAULT is special.
N)�
_unify_valuesr r� rm rp r r� rS )r# r. r= rg r� rh r� rM r% r% r& rk 9 s
zRawConfigParser.getc K s || j ||fi |���S r )rk )r# r. �convr= �kwargsr% r% r& �_get] s zRawConfigParser._getc K sH z | j |||f||d�|��W S ttfyB |tu r:� | Y S 0 d S )N)rg r� )r� r r r� )r# r. r= r� rg r� rh r� r% r% r& � _get_conv` s zRawConfigParser._get_convc K s | j ||tf|||d�|��S �Nr� )r� �int�r# r. r= rg r� rh r� r% r% r& �getintk s ���zRawConfigParser.getintc K s | j ||tf|||d�|��S r� )r� �floatr� r% r% r& �getfloatr s ���zRawConfigParser.getfloatc K s | j ||| jf|||d�|��S r� )r� �_convert_to_booleanr� r% r% r& �
getbooleany s ���zRawConfigParser.getbooleanc s� �t u rtt���� S �j�� � z� ��j� � W n$ tyX ��j krTt
���Y n0 t � � � �}|r�|�� D ]\}}|� ��
|�< qr� ��fdd�}� fdd�}|r�|n|��fdd�|D �S )a� Return a list of (name, value) tuples for each option in a section.
All % interpolations are expanded in the return values, based on the
defaults passed into the constructor, unless the optional argument
`raw' is true. Additional substitutions may be provided using the
`vars' argument, which must be a dictionary whose contents overrides
any pre-existing defaults.
The section DEFAULT is special.
c s �j ���| � | � �S r )r� rS �r= )r� r. r# r% r& �value_getter_interp� s z2RawConfigParser.items.<locals>.value_getter_interpc s � | S r r% r� )r� r% r& �value_getter_raw� s z/RawConfigParser.items.<locals>.value_getter_rawc s g | ]}|� |�f�qS r% r% )r� r= )� value_getterr% r& �
<listcomp>� r� z)RawConfigParser.items.<locals>.<listcomp>)r� �superr r� r� r� r� r� rp r� r r� r� rm ) r# r. rg r� � orig_keysr� rM r� r� �� __class__)r� r. r# r� r& r� � s
zRawConfigParser.itemsc C s. | � � D ] }| | }| |= ||f S t�dS )z�Remove a section from the parser and return it as
a (section_name, section_proxy) tuple. If no section is present, raise
KeyError.
The section DEFAULT is never returned because it cannot be removed.
N)r� rp �r# r� rM r% r% r& �popitem� s
zRawConfigParser.popitemc C s |� � S r )�lower)r# � optionstrr% r% r& rm � s zRawConfigParser.optionxformc C sV |r|| j kr"| �|�}|| jv S || jvr0dS | �|�}|| j| v pP|| jv S dS )z�Check for the existence of a given option in a given section.
If the specified `section' is None or an empty string, DEFAULT is
assumed. If the specified `section' does not exist, returns False.FN)r� rm r� r� )r# r. r= r% r% r& �
has_option� s
zRawConfigParser.has_optionc C sj |r| j �| |||�}|r$|| jkr,| j}n,z| j| }W n tyV t|�d�Y n0 ||| �|�< dS )zSet an option.N)r� rU r� r� r� rp r rm )r# r. r= rM �sectdictr% r% r& r� � s zRawConfigParser.setc C sh |rd� | jd �}n
| jd }| jr>| �|| j| j�� |� | jD ] }| �||| j| �� |� qDdS )aO Write an .ini-format representation of the configuration state.
If `space_around_delimiters' is True (the default), delimiters
between keys and values are surrounded by spaces.
Please note that comments in the original configuration file are not
preserved when writing the configuration back.
z {} r N)r7 r� r� �_write_sectionr� r� r� )r# r� �space_around_delimitersr� r. r% r% r& �write� s
zRawConfigParser.writec C sx |� d�|�� |D ]T\}}| j�| |||�}|dus<| jsR|t|��dd� }nd}|� d�||�� q|� d� dS )z-Write a single section to the specified `fp'.z[{}]
N�
z
r z{}{}
)r r7 r� rW r� r� r` )r# r� � section_name�
section_items� delimiterr� rM r% r% r& r � s z RawConfigParser._write_sectionc C sb |r|| j kr| j}n,z| j| }W n ty@ t|�d�Y n0 | �|�}||v }|r^||= |S )zRemove an option.N)r� r� r� rp r rm )r# r. r= r �existedr% r% r& �
remove_option� s
z RawConfigParser.remove_optionc C s" || j v }|r | j |= | j|= |S )zRemove a file section.)r� r� )r# r. r r% r% r& �remove_section s
z RawConfigParser.remove_sectionc C s& || j kr | �|�s t|��| j| S r )r� r� rp r� �r# r� r% r% r& � __getitem__ s zRawConfigParser.__getitem__c C sX || v r| | |u rd S || j kr.| j�� n|| jv rF| j| �� | �||i� d S r )r� r� �clearr� r� r r% r% r& � __setitem__
s
zRawConfigParser.__setitem__c C s2 || j krtd��| �|�s$t|��| �|� d S )Nz"Cannot remove the default section.)r� rA r� rp r r r% r% r& � __delitem__ s
zRawConfigParser.__delitem__c C s || j kp| �|�S r )r� r� r r% r% r& � __contains__! s z RawConfigParser.__contains__c C s t | j�d S )Nr )r� r� r' r% r% r& �__len__$ s zRawConfigParser.__len__c C s t �| jf| j�� �S r )� itertools�chainr� r� r� r' r% r% r& �__iter__' s zRawConfigParser.__iter__c C s t � }d}d}d}d}d}d} t|dd�D �]�\}}
tj} dd� | jD �} | tjkr�| r�i }
| �� D ]T\}}|
�||d �}|dkr�qd||
|< |dks�|dkrd|
|d �� rdt| |�} qd|
} qJ| j D ]}|
�
� � |�r�d} q�q�| tjkr�d} |
d| � �
� }|�sN| j �rF| du �rL|du�rL|�rL|| du�rL|| �
d� q*tj}q*| j�|
�}|�rh|�� nd}|du�r�|�r�||k�r�|| �
|� q*|}| j�|�}|�r<|�d �}|| jv �r�| j�r�||v �r�t|||��| j| }|�|� n@|| jk�r
| j}n,| �� }|| j|< t| |�| j |< |�|� d}q*|du �rTt |||
��q*| j �|�}|�r�|�d
d d �\}}}|�s�| � | |||
�} | � |�!� �}| j�r�||f|v �r�t"||||��|�||f� |du�r�|�
� }|g||< nd||< q*| � | |||
�} q*| �#� | �r | �dS )
a` Parse a sectioned configuration file.
Each section in a configuration file contains a header, indicated by
a name in square brackets (`[]'), plus key/value options, indicated by
`name' and `value' delimited with a specific substring (`=' or `:' by
default).
Values can span multiple lines, as long as they are indented deeper
than the first line of the value. Depending on the parser's mode, blank
lines may be treated as parts of multiline values or ignored.
Configuration files may include comments, prefixed by specific
characters (`#' and `;' by default). Comments may appear on their own
in an otherwise empty line or may be entered in lines holding values or
section names. Please note that comments get stripped off when reading
configuration files.
Nr r )�startc S s i | ]
}|d �qS )���r% )r� ru r% r% r& �
<dictcomp>G r� z)RawConfigParser._read.<locals>.<dictcomp>r r �headerr= �virM )$r� � enumerate�sys�maxsizer� r� rc �isspace�minr� �strip�
startswithr� r6 � NONSPACECRE�searchr �SECTCRErl rn r� r� r r� r� r� r� r r� r r� �
_handle_errorrm �rstripr �_join_multiline_values)r# r� �fpnamer� �cursect�sectname�optnamer< � indent_levelr� rN �
comment_start�inline_prefixes�
next_prefixes�prefix�indexrM �first_nonspace�cur_indent_level�mor �optvalr% r% r& r� + s�
���
�
�
zRawConfigParser._readc C sr | j | jf}t�|f| j�� �}|D ]H\}}|�� D ]6\}}t|t�rTd�|�� � }| j
� | |||�||< q4q$d S )Nr
) r� r� r r r� r� r� r� r: r+ r� rV )r# rR � all_sectionsr. r� r� �valr% r% r& r, � s
�z&RawConfigParser._join_multiline_valuesc C s& |� � D ]\}}|| j| �|�< qdS )zTRead the defaults passed in the initializer.
Note: values can be non-string.N)r� r� rm )r# rR r� rM r% r% r& r� � s z RawConfigParser._read_defaultsc C s |s t |�}|�|t|�� |S r )r r6 r5 )r# �excr- r< rN r% r% r& r* � s z RawConfigParser._handle_errorc C s~ i }z| j | }W n$ ty6 || jkr2t|��Y n0 i }|rp|�� D ]&\}}|dur`t|�}||| �|�< qHt||| j�S )z�Create a sequence of lookups with 'vars' taking priority over
the 'section' which takes priority over the DEFAULTSECT.
N) r� rp r� r r� r� rm � _ChainMapr� )r# r. r� � sectiondict�vardictr� rM r% r% r& r� � s
z RawConfigParser._unify_valuesc C s( |� � | jvrtd| ��| j|� � S )zAReturn a boolean value translating from other types if necessary.zNot a boolean: %s)r �BOOLEAN_STATESrA rL r% r% r& r� � s z#RawConfigParser._convert_to_booleanr )r. r= rM c C sD t |t�std��t |t�s$td��| jr.|r@t |t�s@td��dS )a� Raises a TypeError for non-string values.
The only legal non-string value if we allow valueless
options is None, so we need to check if the value is a
string if:
- we do not allow valueless options, or
- we allow valueless options but the value is not None
For compatibility reasons this method is not used in classic set()
for RawConfigParsers. It is invoked in every case for mapping protocol
access and in ConfigParser.set().
z section names must be stringszoption keys must be stringsz option values must be stringsN)r� r� � TypeErrorr� �r# r. r= rM r% r% r& �_validate_value_types� s
z%RawConfigParser._validate_value_typesc C s | j S r )r� r' r% r% r& r� � s zRawConfigParser.converters)N)N)r� )r� )N)N)T)?r) r* r+ r, �
_SECT_TMPLr� r� r r� r{ r| r� r) r7 r� r� r' rA �
_default_dictr r� r" rR r� r� r� r� r� r� r� r� r� rk r� r� r� r� r� r� r rm r r� r r r r r r r r r r r� r, r� r* r� r� rD rO r� �
__classcell__r% r% r� r& r [ s�
�
�� /
$� � � �
#
{ r c s< e Zd ZdZe� Zd � fdd� Z� fdd�Zdd� Z� Z S )
r z(ConfigParser implementing interpolation.Nc s" | j ||d� t� �|||� dS )zmSet an option. Extends RawConfigParser.set by validating type and
interpolation syntax on the value.�r= rM N)rD r� r� rC r� r% r& r� � s zConfigParser.setc s | j |d� t� �|� dS )z�Create a new section in the configuration. Extends
RawConfigParser.add_section by validating if the section name is
a string.)r. N)rD r� r� r0 r� r% r& r� � s zConfigParser.add_sectionc C s6 z(| j }t� | _ | �| j|i� W || _ n|| _ 0 dS )z�Reads the defaults passed in the initializer, implicitly converting
values to strings like the rest of the API.
Does not perform interpolation for backwards compatibility.
N)r� r r� r� )r# rR �hold_interpolationr% r% r& r� s
zConfigParser._read_defaults)N)
r) r* r+ r, r r� r� r� r� rG r% r% r� r& r � s
r c s e Zd ZdZ� fdd�Z� ZS )r z8ConfigParser alias for backwards compatibility purposes.c s& t � j|i |�� tjdtdd� d S )Nz�The SafeConfigParser class has been renamed to ConfigParser in Python 3.2. This alias will be removed in future versions. Use ConfigParser directly instead.rE rF )r� r" rI rJ rK )r# r/ r� r� r% r& r" s �zSafeConfigParser.__init__)r) r* r+ r, r" rG r% r% r� r& r s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z e
dd� �Ze
dd� �Zd dddd�dd �ZdS ) r z+A proxy for a single section from a parser.c C sF || _ || _|jD ].}d| }tj| jt||�d�}t| ||� qdS )z@Creates a view on a section of the specified `name` in `parser`.rk ��_implN)�_parser�_namer� r� r� rk �getattr�setattr)r# rQ r� r� r� �getterr% r% r& r" " s
zSectionProxy.__init__c C s d� | j�S )Nz
<Section: {}>)r7 rM r' r% r% r& r( + s zSectionProxy.__repr__c C s( | j �| j|�st|��| j �| j|�S r )rL r rM rp rk r r% r% r& r . s zSectionProxy.__getitem__c C s" | j j||d� | j �| j||�S )NrH )rL rD r� rM r r% r% r& r 3 s zSectionProxy.__setitem__c C s, | j �| j|�r | j �| j|�s(t|��d S r )rL r rM r rp r r% r% r& r 7 s
��zSectionProxy.__delitem__c C s | j �| j|�S r )rL r rM r r% r% r& r > s zSectionProxy.__contains__c C s t | �� �S r )r� �_optionsr' r% r% r& r A s zSectionProxy.__len__c C s | � � �� S r )rQ r r' r% r% r& r D s zSectionProxy.__iter__c C s* | j | jjkr | j�| j �S | j�� S d S r )rM rL r� r� rR r' r% r% r& rQ G s zSectionProxy._optionsc C s | j S r )rL r' r% r% r& rQ M s zSectionProxy.parserc C s | j S r )rM r' r% r% r& r� R s zSectionProxy.nameNF)rg r� rK c K s( |s | j j}|| j|f|||d�|��S )z�Get an option value.
Unless `fallback` is provided, `None` will be returned if the option
is not found.
r� )rL rk rM )r# r= rh rg r� rK r� r% r% r& rk W s ���zSectionProxy.get)N)r) r* r+ r, r" r( r r r r r r rQ rO rQ r� rk r% r% r% r& r s
r c @ sJ e Zd ZdZe�d�Zdd� Zdd� Zdd� Z d d
� Z
d d � Z d
d� Z dS )r a/ Enables reuse of get*() methods between the parser and section proxies.
If a parser class implements a getter directly, the value for the given
key will be ``None``. The presence of the converter name here enables
section proxies to find and use the implementation on the parser class.
z^get(?P<name>.+)$c C sR || _ i | _t| j �D ]6}| j�|�}|rtt| j |��s<qd | j|�d�< qd S )Nr� )rL �_data�dir� GETTERCRErl �callablerN rn )r# rQ rP rw r% r% r& r" q s zConverterMapping.__init__c C s
| j | S r )rR r r% r% r& r z s z ConverterMapping.__getitem__c C s� z d| }W n& t y2 td�|t|����Y n0 |dkrDtd��|| j|< tj| jj|d�}||_ t
| j||� | j� � D ] }tj|j |d�}t
|||� q~d S )Nrk z Incompatible key: {} (type: {})z)Incompatible key: cannot use "" as a name)r� rJ )
rB rA r7 �typerR r� r� rL r� � converterrO �valuesrk )r# r� rM �k�func�proxyrP r% r% r& r } s �
z ConverterMapping.__setitem__c C sz zd|p
d }W n t y* t|��Y n0 | j|= t�| jf| j�� �D ]*}zt||� W qJ tyr Y qJY qJ0 qJd S )Nrk ) rB rp rR r r rL rX �delattrr� )r# r� rY �instr% r% r& r � s z ConverterMapping.__delitem__c C s
t | j�S r )�iterrR r' r% r% r& r � s zConverterMapping.__iter__c C s
t | j�S r )r� rR r' r% r% r& r � s zConverterMapping.__len__N)
r) r* r+ r, r{ r| rT r" r r r r r r% r% r% r& r g s
r )*r, �collections.abcr � collectionsr r> r� �compatr r r� r{ r! rI �__all__r� rF r r r! r r r r r r
r r
r r r �objectr� r r r r r r r r r r% r% r% r& �<module> sP
.QX& HPK �@u\�($K� � backports/configparser/compat.pynu �[��� import types
import io as _io
def text_encoding(encoding, stacklevel=2):
"""
Stubbed version of io.text_encoding as found in Python 3.10
"""
return encoding
def copy_module(mod, **defaults):
copy = types.ModuleType(mod.__name__, doc=mod.__doc__)
vars(copy).update(defaults)
vars(copy).update(vars(mod))
return copy
io = copy_module(_io, text_encoding=text_encoding)
PK �@u\�V� � E libfuturize/fixes/fix_add__future__imports_except_unicode_literals.pynu �[��� """
Fixer for adding:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
This is "stage 1": hopefully uncontroversial changes.
Stage 2 adds ``unicode_literals``.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import future_import
class FixAddFutureImportsExceptUnicodeLiterals(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 9
def transform(self, node, results):
# Reverse order:
future_import(u"absolute_import", node)
future_import(u"division", node)
future_import(u"print_function", node)
PK �@u\Ʉf � � ! libfuturize/fixes/fix_division.pynu �[��� """
UNFINISHED
For the ``future`` package.
Adds this import line:
from __future__ import division
at the top so the code runs identically on Py3 and Py2.6/2.7
"""
from libpasteurize.fixes.fix_division import FixDivision
PK �@u\�:�{� � libfuturize/fixes/fix_bytes.pynu �[��� """Optional fixer that changes all unprefixed string literals "..." to b"...".
br'abcd' is a SyntaxError on Python 2 but valid on Python 3.
ur'abcd' is a SyntaxError on Python 3 but valid on Python 2.
"""
from __future__ import unicode_literals
import re
from lib2to3.pgen2 import token
from lib2to3 import fixer_base
_literal_re = re.compile(r"[^bBuUrR]?[\'\"]")
class FixBytes(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "STRING"
def transform(self, node, results):
if node.type == token.STRING:
if _literal_re.match(node.value):
new = node.clone()
new.value = u'b' + new.value
return new
PK �@u\C��V V " libfuturize/fixes/fix_next_call.pynu �[��� """
Based on fix_next.py by Collin Winter.
Replaces it.next() -> next(it), per PEP 3114.
Unlike fix_next.py, this fixer doesn't replace the name of a next method with __next__,
which would break Python 2 compatibility without further help from fixers in
stage 2.
"""
# Local imports
from lib2to3.pgen2 import token
from lib2to3.pygram import python_symbols as syms
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, Call, find_binding
bind_warning = "Calls to builtin next() possibly shadowed by global binding"
class FixNextCall(fixer_base.BaseFix):
BM_compatible = True
PATTERN = """
power< base=any+ trailer< '.' attr='next' > trailer< '(' ')' > >
|
power< head=any+ trailer< '.' attr='next' > not trailer< '(' ')' > >
|
global=global_stmt< 'global' any* 'next' any* >
"""
order = "pre" # Pre-order tree traversal
def start_tree(self, tree, filename):
super(FixNextCall, self).start_tree(tree, filename)
n = find_binding('next', tree)
if n:
self.warning(n, bind_warning)
self.shadowed_next = True
else:
self.shadowed_next = False
def transform(self, node, results):
assert results
base = results.get("base")
attr = results.get("attr")
name = results.get("name")
if base:
if self.shadowed_next:
# Omit this:
# attr.replace(Name("__next__", prefix=attr.prefix))
pass
else:
base = [n.clone() for n in base]
base[0].prefix = ""
node.replace(Call(Name("next", prefix=node.prefix), base))
elif name:
# Omit this:
# n = Name("__next__", prefix=name.prefix)
# name.replace(n)
pass
elif attr:
# We don't do this transformation if we're assigning to "x.next".
# Unfortunately, it doesn't seem possible to do this in PATTERN,
# so it's being done here.
if is_assign_target(node):
head = results["head"]
if "".join([str(n) for n in head]).strip() == '__builtin__':
self.warning(node, bind_warning)
return
# Omit this:
# attr.replace(Name("__next__"))
elif "global" in results:
self.warning(node, bind_warning)
self.shadowed_next = True
### The following functions help test if node is part of an assignment
### target.
def is_assign_target(node):
assign = find_assign(node)
if assign is None:
return False
for child in assign.children:
if child.type == token.EQUAL:
return False
elif is_subtree(child, node):
return True
return False
def find_assign(node):
if node.type == syms.expr_stmt:
return node
if node.type == syms.simple_stmt or node.parent is None:
return None
return find_assign(node.parent)
def is_subtree(root, node):
if root == node:
return True
return any(is_subtree(c, node) for c in root.children)
PK �@u\D�;� ! libfuturize/fixes/fix_UserDict.pynu �[��� """Fix UserDict.
Incomplete!
TODO: base this on fix_urllib perhaps?
"""
# Local imports
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, attr_chain
from lib2to3.fixes.fix_imports import alternates, build_pattern, FixImports
MAPPING = {'UserDict': 'collections',
}
# def alternates(members):
# return "(" + "|".join(map(repr, members)) + ")"
#
#
# def build_pattern(mapping=MAPPING):
# mod_list = ' | '.join(["module_name='%s'" % key for key in mapping])
# bare_names = alternates(mapping.keys())
#
# yield """name_import=import_name< 'import' ((%s) |
# multiple_imports=dotted_as_names< any* (%s) any* >) >
# """ % (mod_list, mod_list)
# yield """import_from< 'from' (%s) 'import' ['(']
# ( any | import_as_name< any 'as' any > |
# import_as_names< any* >) [')'] >
# """ % mod_list
# yield """import_name< 'import' (dotted_as_name< (%s) 'as' any > |
# multiple_imports=dotted_as_names<
# any* dotted_as_name< (%s) 'as' any > any* >) >
# """ % (mod_list, mod_list)
#
# # Find usages of module members in code e.g. thread.foo(bar)
# yield "power< bare_with_attr=(%s) trailer<'.' any > any* >" % bare_names
# class FixUserDict(fixer_base.BaseFix):
class FixUserdict(FixImports):
BM_compatible = True
keep_line_order = True
# This is overridden in fix_imports2.
mapping = MAPPING
# We want to run this fixer late, so fix_import doesn't try to make stdlib
# renames into relative imports.
run_order = 6
def build_pattern(self):
return "|".join(build_pattern(self.mapping))
def compile_pattern(self):
# We override this, so MAPPING can be pragmatically altered and the
# changes will be reflected in PATTERN.
self.PATTERN = self.build_pattern()
super(FixImports, self).compile_pattern()
# Don't match the node if it's within another match.
def match(self, node):
match = super(FixImports, self).match
results = match(node)
if results:
# Module usage could be in the trailer of an attribute lookup, so we
# might have nested matches when "bare_with_attr" is present.
if "bare_with_attr" not in results and \
any(match(obj) for obj in attr_chain(node, "parent")):
return False
return results
return False
def start_tree(self, tree, filename):
super(FixImports, self).start_tree(tree, filename)
self.replace = {}
def transform(self, node, results):
import_mod = results.get("module_name")
if import_mod:
mod_name = import_mod.value
new_name = unicode(self.mapping[mod_name])
import_mod.replace(Name(new_name, prefix=import_mod.prefix))
if "name_import" in results:
# If it's not a "from x import x, y" or "import x as y" import,
# marked its usage to be replaced.
self.replace[mod_name] = new_name
if "multiple_imports" in results:
# This is a nasty hack to fix multiple imports on a line (e.g.,
# "import StringIO, urlparse"). The problem is that I can't
# figure out an easy way to make a pattern recognize the keys of
# MAPPING randomly sprinkled in an import statement.
results = self.match(node)
if results:
self.transform(node, results)
else:
# Replace usage of the module.
bare_name = results["bare_with_attr"][0]
new_name = self.replace.get(bare_name.value)
if new_name:
bare_name.replace(Name(new_name, prefix=bare_name.prefix))
PK �@u\;�"4t t libfuturize/fixes/__init__.pynu �[��� import sys
from lib2to3 import refactor
# The following fixers are "safe": they convert Python 2 code to more
# modern Python 2 code. They should be uncontroversial to apply to most
# projects that are happy to drop support for Py2.5 and below. Applying
# them first will reduce the size of the patch set for the real porting.
lib2to3_fix_names_stage1 = set([
'lib2to3.fixes.fix_apply',
'lib2to3.fixes.fix_except',
'lib2to3.fixes.fix_exec',
'lib2to3.fixes.fix_exitfunc',
'lib2to3.fixes.fix_funcattrs',
'lib2to3.fixes.fix_has_key',
'lib2to3.fixes.fix_idioms',
# 'lib2to3.fixes.fix_import', # makes any implicit relative imports explicit. (Use with ``from __future__ import absolute_import)
'lib2to3.fixes.fix_intern',
'lib2to3.fixes.fix_isinstance',
'lib2to3.fixes.fix_methodattrs',
'lib2to3.fixes.fix_ne',
# 'lib2to3.fixes.fix_next', # would replace ``next`` method names
# with ``__next__``.
'lib2to3.fixes.fix_numliterals', # turns 1L into 1, 0755 into 0o755
'lib2to3.fixes.fix_paren',
# 'lib2to3.fixes.fix_print', # see the libfuturize fixer that also
# adds ``from __future__ import print_function``
# 'lib2to3.fixes.fix_raise', # uses incompatible with_traceback() method on exceptions
'lib2to3.fixes.fix_reduce', # reduce is available in functools on Py2.6/Py2.7
'lib2to3.fixes.fix_renames', # sys.maxint -> sys.maxsize
# 'lib2to3.fixes.fix_set_literal', # this is unnecessary and breaks Py2.6 support
'lib2to3.fixes.fix_repr',
'lib2to3.fixes.fix_standarderror',
'lib2to3.fixes.fix_sys_exc',
'lib2to3.fixes.fix_throw',
'lib2to3.fixes.fix_tuple_params',
'lib2to3.fixes.fix_types',
'lib2to3.fixes.fix_ws_comma', # can perhaps decrease readability: see issue #58
'lib2to3.fixes.fix_xreadlines',
])
# The following fixers add a dependency on the ``future`` package on order to
# support Python 2:
lib2to3_fix_names_stage2 = set([
# 'lib2to3.fixes.fix_buffer', # perhaps not safe. Test this.
# 'lib2to3.fixes.fix_callable', # not needed in Py3.2+
'lib2to3.fixes.fix_dict', # TODO: add support for utils.viewitems() etc. and move to stage2
# 'lib2to3.fixes.fix_execfile', # some problems: see issue #37.
# We use a custom fixer instead (see below)
# 'lib2to3.fixes.fix_future', # we don't want to remove __future__ imports
'lib2to3.fixes.fix_getcwdu',
# 'lib2to3.fixes.fix_imports', # called by libfuturize.fixes.fix_future_standard_library
# 'lib2to3.fixes.fix_imports2', # we don't handle this yet (dbm)
# 'lib2to3.fixes.fix_input', # Called conditionally by libfuturize.fixes.fix_input
'lib2to3.fixes.fix_itertools',
'lib2to3.fixes.fix_itertools_imports',
'lib2to3.fixes.fix_filter',
'lib2to3.fixes.fix_long',
'lib2to3.fixes.fix_map',
# 'lib2to3.fixes.fix_metaclass', # causes SyntaxError in Py2! Use the one from ``six`` instead
'lib2to3.fixes.fix_next',
'lib2to3.fixes.fix_nonzero', # TODO: cause this to import ``object`` and/or add a decorator for mapping __bool__ to __nonzero__
'lib2to3.fixes.fix_operator', # we will need support for this by e.g. extending the Py2 operator module to provide those functions in Py3
'lib2to3.fixes.fix_raw_input',
# 'lib2to3.fixes.fix_unicode', # strips off the u'' prefix, which removes a potentially helpful source of information for disambiguating unicode/byte strings
# 'lib2to3.fixes.fix_urllib', # included in libfuturize.fix_future_standard_library_urllib
# 'lib2to3.fixes.fix_xrange', # custom one because of a bug with Py3.3's lib2to3
'lib2to3.fixes.fix_zip',
])
libfuturize_fix_names_stage1 = set([
'libfuturize.fixes.fix_absolute_import',
'libfuturize.fixes.fix_next_call', # obj.next() -> next(obj). Unlike
# lib2to3.fixes.fix_next, doesn't change
# the ``next`` method to ``__next__``.
'libfuturize.fixes.fix_print_with_import',
'libfuturize.fixes.fix_raise',
# 'libfuturize.fixes.fix_order___future__imports', # TODO: consolidate to a single line to simplify testing
])
libfuturize_fix_names_stage2 = set([
'libfuturize.fixes.fix_basestring',
# 'libfuturize.fixes.fix_add__future__imports_except_unicode_literals', # just in case
'libfuturize.fixes.fix_cmp',
'libfuturize.fixes.fix_division_safe',
'libfuturize.fixes.fix_execfile',
'libfuturize.fixes.fix_future_builtins',
'libfuturize.fixes.fix_future_standard_library',
'libfuturize.fixes.fix_future_standard_library_urllib',
'libfuturize.fixes.fix_input',
'libfuturize.fixes.fix_metaclass',
'libpasteurize.fixes.fix_newstyle',
'libfuturize.fixes.fix_object',
# 'libfuturize.fixes.fix_order___future__imports', # TODO: consolidate to a single line to simplify testing
'libfuturize.fixes.fix_unicode_keep_u',
# 'libfuturize.fixes.fix_unicode_literals_import',
'libfuturize.fixes.fix_xrange_with_import', # custom one because of a bug with Py3.3's lib2to3
])
PK �@u\����� � + libfuturize/fixes/fix_xrange_with_import.pynu �[��� """
For the ``future`` package.
Turns any xrange calls into range calls and adds this import line:
from builtins import range
at the top.
"""
from lib2to3.fixes.fix_xrange import FixXrange
from libfuturize.fixer_util import touch_import_top
class FixXrangeWithImport(FixXrange):
def transform(self, node, results):
result = super(FixXrangeWithImport, self).transform(node, results)
touch_import_top('builtins', 'range', node)
return result
PK �@u\Fy �� � ! libfuturize/fixes/fix_execfile.pynu �[��� # coding: utf-8
"""
Fixer for the execfile() function on Py2, which was removed in Py3.
The Lib/lib2to3/fixes/fix_execfile.py module has some problems: see
python-future issue #37. This fixer merely imports execfile() from
past.builtins and leaves the code alone.
Adds this import line::
from past.builtins import execfile
for the function execfile() that was removed from Py3.
"""
from __future__ import unicode_literals
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
expression = "name='execfile'"
class FixExecfile(fixer_base.BaseFix):
BM_compatible = True
run_order = 9
PATTERN = """
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
""".format(expression)
def transform(self, node, results):
name = results["name"]
touch_import_top(u'past.builtins', name.value, node)
PK �@u\���@ @ libfuturize/fixes/fix_raise.pynu �[��� """Fixer for 'raise E, V'
From Armin Ronacher's ``python-modernize``.
raise -> raise
raise E -> raise E
raise E, 5 -> raise E(5)
raise E, 5, T -> raise E(5).with_traceback(T)
raise E, None, T -> raise E.with_traceback(T)
raise (((E, E'), E''), E'''), 5 -> raise E(5)
raise "foo", V, T -> warns about string exceptions
raise E, (V1, V2) -> raise E(V1, V2)
raise E, (V1, V2), T -> raise E(V1, V2).with_traceback(T)
CAVEATS:
1) "raise E, V, T" cannot be translated safely in general. If V
is not a tuple or a (number, string, None) literal, then:
raise E, V, T -> from future.utils import raise_
raise_(E, V, T)
"""
# Author: Collin Winter, Armin Ronacher, Mark Huang
# Local imports
from lib2to3 import pytree, fixer_base
from lib2to3.pgen2 import token
from lib2to3.fixer_util import Name, Call, is_tuple, Comma, Attr, ArgList
from libfuturize.fixer_util import touch_import_top
class FixRaise(fixer_base.BaseFix):
BM_compatible = True
PATTERN = """
raise_stmt< 'raise' exc=any [',' val=any [',' tb=any]] >
"""
def transform(self, node, results):
syms = self.syms
exc = results["exc"].clone()
if exc.type == token.STRING:
msg = "Python 3 does not support string exceptions"
self.cannot_convert(node, msg)
return
# Python 2 supports
# raise ((((E1, E2), E3), E4), E5), V
# as a synonym for
# raise E1, V
# Since Python 3 will not support this, we recurse down any tuple
# literals, always taking the first element.
if is_tuple(exc):
while is_tuple(exc):
# exc.children[1:-1] is the unparenthesized tuple
# exc.children[1].children[0] is the first element of the tuple
exc = exc.children[1].children[0].clone()
exc.prefix = u" "
if "tb" in results:
tb = results["tb"].clone()
else:
tb = None
if "val" in results:
val = results["val"].clone()
if is_tuple(val):
# Assume that exc is a subclass of Exception and call exc(*val).
args = [c.clone() for c in val.children[1:-1]]
exc = Call(exc, args)
elif val.type in (token.NUMBER, token.STRING):
# Handle numeric and string literals specially, e.g.
# "raise Exception, 5" -> "raise Exception(5)".
val.prefix = u""
exc = Call(exc, [val])
elif val.type == token.NAME and val.value == u"None":
# Handle None specially, e.g.
# "raise Exception, None" -> "raise Exception".
pass
else:
# val is some other expression. If val evaluates to an instance
# of exc, it should just be raised. If val evaluates to None,
# a default instance of exc should be raised (as above). If val
# evaluates to a tuple, exc(*val) should be called (as
# above). Otherwise, exc(val) should be called. We can only
# tell what to do at runtime, so defer to future.utils.raise_(),
# which handles all of these cases.
touch_import_top(u"future.utils", u"raise_", node)
exc.prefix = u""
args = [exc, Comma(), val]
if tb is not None:
args += [Comma(), tb]
return Call(Name(u"raise_"), args, prefix=node.prefix)
if tb is not None:
tb.prefix = ""
exc_list = Attr(exc, Name('with_traceback')) + [ArgList([tb])]
else:
exc_list = [exc]
return pytree.Node(syms.raise_stmt,
[Name(u"raise")] + exc_list,
prefix=node.prefix)
PK Au\�H{l� � libfuturize/fixes/fix_input.pynu �[��� """
Fixer for input.
Does a check for `from builtins import input` before running the lib2to3 fixer.
The fixer will not run when the input is already present.
this:
a = input()
becomes:
from builtins import input
a = eval(input())
and this:
from builtins import input
a = input()
becomes (no change):
from builtins import input
a = input()
"""
import lib2to3.fixes.fix_input
from lib2to3.fixer_util import does_tree_import
class FixInput(lib2to3.fixes.fix_input.FixInput):
def transform(self, node, results):
if does_tree_import('builtins', 'input', node):
return
return super(FixInput, self).transform(node, results)
PK Au\�rؑ� � libfuturize/fixes/fix_cmp.pynu �[��� # coding: utf-8
"""
Fixer for the cmp() function on Py2, which was removed in Py3.
Adds this import line::
from past.builtins import cmp
if cmp() is called in the code.
"""
from __future__ import unicode_literals
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
expression = "name='cmp'"
class FixCmp(fixer_base.BaseFix):
BM_compatible = True
run_order = 9
PATTERN = """
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
""".format(expression)
def transform(self, node, results):
name = results["name"]
touch_import_top(u'past.builtins', name.value, node)
PK Au\��z� � : libfuturize/fixes/__pycache__/fix_next_call.cpython-39.pycnu �[��� a
��?hV � @ sn d Z ddlmZ ddlmZ ddlmZ ddlm Z m
Z
m Z dZ G dd� dej
�Zd d
� Zd d � Zd
d� ZdS )a
Based on fix_next.py by Collin Winter.
Replaces it.next() -> next(it), per PEP 3114.
Unlike fix_next.py, this fixer doesn't replace the name of a next method with __next__,
which would break Python 2 compatibility without further help from fixers in
stage 2.
� )�token)�python_symbols)�
fixer_base)�Name�Call� find_bindingz;Calls to builtin next() possibly shadowed by global bindingc s0 e Zd ZdZdZdZ� fdd�Zdd� Z� ZS )� FixNextCallTz�
power< base=any+ trailer< '.' attr='next' > trailer< '(' ')' > >
|
power< head=any+ trailer< '.' attr='next' > not trailer< '(' ')' > >
|
global=global_stmt< 'global' any* 'next' any* >
�prec s> t t| ��||� td|�}|r4| �|t� d| _nd| _d S )N�nextTF)�superr �
start_treer �warning� bind_warning�
shadowed_next)�self�tree�filename�n�� __class__� �I/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_next_call.pyr s
zFixNextCall.start_treec C s� |sJ �|� d�}|� d�}|� d�}|rf| jr2q�dd� |D �}d|d _|�ttd|jd �|�� nb|rln\|r�t|�r�|d
}d�d d� |D ���� d kr�| � |t
� d S nd
|v r�| � |t
� d| _d S )N�base�attr�namec S s g | ] }|� � �qS r )�clone��.0r r r r �
<listcomp>7 � z)FixNextCall.transform.<locals>.<listcomp>� r r
)�prefix�headc S s g | ] }t |��qS r )�strr r r r r E r � __builtin__�globalT) �getr r! �replacer r �is_assign_target�join�stripr
r )r �node�resultsr r r r" r r r � transform* s*
zFixNextCall.transform) �__name__�
__module__� __qualname__Z
BM_compatibleZPATTERN�orderr r- �
__classcell__r r r r r s
r c C sF t | �}|d u rdS |jD ]&}|jtjkr0 dS t|| �r dS qdS )NFT)� find_assign�children�typer �EQUAL�
is_subtree)r+ Zassign�childr r r r( R s
r( c C s4 | j tjkr| S | j tjks&| jd u r*d S t| j�S �N)r5 �symsZ expr_stmtZ simple_stmt�parentr3 �r+ r r r r3 ^ s
r3 c s$ | � kr dS t � fdd�| jD ��S )NTc 3 s | ]}t |� �V qd S r9 )r7 )r �cr< r r � <genexpr>h r z is_subtree.<locals>.<genexpr>)�anyr4 )�rootr+ r r< r r7 e s r7 N)�__doc__Z
lib2to3.pgen2r Zlib2to3.pygramr r: Zlib2to3r Zlib2to3.fixer_utilr r r r ZBaseFixr r( r3 r7 r r r r �<module> s > PK Au\���� � @ libfuturize/fixes/__pycache__/fix_future_builtins.cpython-39.pycnu �[��� a
��?h� � @ sz d Z ddlmZ ddlmZ ddlmZ ddlm Z m
Z
m Z ddl m
Z
d�� Zd�d d
� eD ��ZG d d � d ej�Zd
S )z�
For the ``future`` package.
Adds this import line::
from builtins import XYZ
for each of the functions XYZ that is used in the module.
Adds these imports after any other imports (in an initial block of them).
� )�unicode_literals)�
fixer_base)�python_symbols)�Name�Call�in_special_context)�touch_import_topzsfilter map zip
ascii chr hex input next oct
bytes range str raw_input�|c C s g | ]}d � |��qS )z
name='{0}')�format)�.0�name� r
�O/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_future_builtins.py�
<listcomp>$ � r c @ s& e Zd ZdZdZd�e�Zdd� ZdS )�FixFutureBuiltinsT� z�
power<
({0}) trailer< '(' [arglist=any] ')' >
rest=any* >
|
power<
'map' trailer< '(' [arglist=any] ')' >
>
c C s |d }t d|j|� d S )Nr �builtins)r �value)�self�node�resultsr r
r
r � transform8 s zFixFutureBuiltins.transformN) �__name__�
__module__� __qualname__Z
BM_compatibleZ run_orderr
�
expressionZPATTERNr r
r
r
r r ' s �
r N)�__doc__�
__future__r Zlib2to3r Zlib2to3.pygramr ZsymsZlib2to3.fixer_utilr r r Zlibfuturize.fixer_utilr �splitZreplaced_builtin_fns�joinr ZBaseFixr r
r
r
r �<module> s PK
Au\�#�j j O libfuturize/fixes/__pycache__/fix_future_standard_library_urllib.cpython-39.pycnu �[��� a
��?h� � @ s4 d Z ddlmZ ddlmZmZ G dd� de�ZdS )a
For the ``future`` package.
A special fixer that ensures that these lines have been added::
from future import standard_library
standard_library.install_hooks()
even if the only module imported was ``urllib``, in which case the regular fixer
wouldn't have added these lines.
� )� FixUrllib)�touch_import_top� find_rootc s e Zd ZdZ� fdd�Z� ZS )� FixFutureStandardLibraryUrllib� c s* t |�}tt| ��||�}tdd|� |S )N�futureZstandard_library)r �superr � transformr )�self�node�results�root�result�� __class__� �^/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_future_standard_library_urllib.pyr s z(FixFutureStandardLibraryUrllib.transform)�__name__�
__module__� __qualname__Z run_orderr �
__classcell__r r r r r s r N)�__doc__Zlib2to3.fixes.fix_urllibr Zlibfuturize.fixer_utilr r r r r r r �<module> s
PK Au\�ڌ�� � 5 libfuturize/fixes/__pycache__/__init__.cpython-39.pycnu �[��� a
��?ht � @ sH d dl Z d dlmZ eg d��Zeg d��Zeg d��Zeg d��ZdS )� N)�refactor)zlib2to3.fixes.fix_applyzlib2to3.fixes.fix_exceptzlib2to3.fixes.fix_execzlib2to3.fixes.fix_exitfunczlib2to3.fixes.fix_funcattrszlib2to3.fixes.fix_has_keyzlib2to3.fixes.fix_idiomszlib2to3.fixes.fix_internz lib2to3.fixes.fix_isinstancez lib2to3.fixes.fix_methodattrszlib2to3.fixes.fix_nez lib2to3.fixes.fix_numliteralszlib2to3.fixes.fix_parenzlib2to3.fixes.fix_reducezlib2to3.fixes.fix_renameszlib2to3.fixes.fix_reprz lib2to3.fixes.fix_standarderrorzlib2to3.fixes.fix_sys_exczlib2to3.fixes.fix_throwz lib2to3.fixes.fix_tuple_paramszlib2to3.fixes.fix_typeszlib2to3.fixes.fix_ws_commaz lib2to3.fixes.fix_xreadlines) zlib2to3.fixes.fix_dictzlib2to3.fixes.fix_getcwduzlib2to3.fixes.fix_itertoolsz#lib2to3.fixes.fix_itertools_importszlib2to3.fixes.fix_filterzlib2to3.fixes.fix_longzlib2to3.fixes.fix_mapzlib2to3.fixes.fix_nextzlib2to3.fixes.fix_nonzerozlib2to3.fixes.fix_operatorzlib2to3.fixes.fix_raw_inputzlib2to3.fixes.fix_zip)z%libfuturize.fixes.fix_absolute_importz libfuturize.fixes.fix_next_callz'libfuturize.fixes.fix_print_with_importzlibfuturize.fixes.fix_raise)
z libfuturize.fixes.fix_basestringzlibfuturize.fixes.fix_cmpz#libfuturize.fixes.fix_division_safez libfuturize.fixes.fix_execfilez%libfuturize.fixes.fix_future_builtinsz-libfuturize.fixes.fix_future_standard_libraryz4libfuturize.fixes.fix_future_standard_library_urllibzlibfuturize.fixes.fix_inputz libfuturize.fixes.fix_metaclassz libpasteurize.fixes.fix_newstylez libfuturize.fixes.fix_objectz$libfuturize.fixes.fix_unicode_keep_uz(libfuturize.fixes.fix_xrange_with_import)�sysZlib2to3r �setZlib2to3_fix_names_stage1Zlib2to3_fix_names_stage2Z libfuturize_fix_names_stage1Z libfuturize_fix_names_stage2� r r �D/usr/local/lib/python3.9/site-packages/libfuturize/fixes/__init__.py�<module> s
#
PK Au\��� � 9 libfuturize/fixes/__pycache__/fix_division.cpython-39.pycnu �[��� a
��?h� � @ s d Z ddlmZ dS )z�
UNFINISHED
For the ``future`` package.
Adds this import line:
from __future__ import division
at the top so the code runs identically on Py3 and Py2.6/2.7
� )� FixDivisionN)�__doc__Z libpasteurize.fixes.fix_divisionr � r r �H/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_division.py�<module> s PK Au\;�ě� � ? libfuturize/fixes/__pycache__/fix_unicode_keep_u.cpython-39.pycnu �[��� a
��?h � @ s< d Z ddlmZ ddlmZ ddd�ZG dd� dej�Zd S )
at Fixer that changes unicode to str and unichr to chr, but -- unlike the
lib2to3 fix_unicode.py fixer, does not change u"..." into "...".
The reason is that Py3.3+ supports the u"..." string prefix, and, if
present, the prefix may provide useful information for disambiguating
between byte strings and unicode strings, which is often the hardest part
of the porting task.
� )�token)�
fixer_base�chr�str)�unichr�unicodec @ s e Zd ZdZdZdd� ZdS )�FixUnicodeKeepUTz'unicode' | 'unichr'c C s( |j tjkr$|�� }t|j |_|S d S )N)�typer �NAME�clone�_mapping�value)�self�node�results�new� r �N/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_unicode_keep_u.py� transform s zFixUnicodeKeepU.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr r r r r r s r N)�__doc__Z
lib2to3.pgen2r Zlib2to3r r ZBaseFixr r r r r �<module> s
PK Au\uj4E H libfuturize/fixes/__pycache__/fix_order___future__imports.cpython-39.pycnu �[��� a
��?h= � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )aE
UNFINISHED
Fixer for turning multiple lines like these:
from __future__ import division
from __future__ import absolute_import
from __future__ import print_function
into a single line like this:
from __future__ import (absolute_import, division, print_function)
This helps with testing of ``futurize``.
� )�
fixer_base)�
future_importc @ s e Zd ZdZdZdZdd� ZdS )�FixOrderFutureImportsTZ
file_input�
c C s d S )N� )�self�node�resultsr r �W/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_order___future__imports.py� transform" s z FixOrderFutureImports.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr r r r r
r s
r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r r r r
�<module> s PK Au\;�� 9 libfuturize/fixes/__pycache__/fix_execfile.cpython-39.pycnu �[��� a
��?h� � @ sB d Z ddlmZ ddlmZ ddlmZ dZG dd� dej�Z dS ) ao
Fixer for the execfile() function on Py2, which was removed in Py3.
The Lib/lib2to3/fixes/fix_execfile.py module has some problems: see
python-future issue #37. This fixer merely imports execfile() from
past.builtins and leaves the code alone.
Adds this import line::
from past.builtins import execfile
for the function execfile() that was removed from Py3.
� )�unicode_literals)�
fixer_base)�touch_import_topzname='execfile'c @ s& e Zd ZdZdZd�e�Zdd� ZdS )� FixExecfileT� zs
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
c C s |d }t d|j|� d S )N�namez
past.builtins)r �value)�self�node�resultsr � r �H/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_execfile.py� transform# s zFixExecfile.transformN) �__name__�
__module__� __qualname__Z
BM_compatibleZ run_order�format�
expressionZPATTERNr r r r r
r s �r N)
�__doc__�
__future__r Zlib2to3r Zlibfuturize.fixer_utilr r ZBaseFixr r r r r
�<module> s
PK Au\�� � 6 libfuturize/fixes/__pycache__/fix_raise.cpython-39.pycnu �[��� a
��?h@ � @ sb d Z ddlmZmZ ddlmZ ddlmZmZm Z m
Z
m Z m Z ddl
mZ G dd� dej�ZdS ) a� Fixer for 'raise E, V'
From Armin Ronacher's ``python-modernize``.
raise -> raise
raise E -> raise E
raise E, 5 -> raise E(5)
raise E, 5, T -> raise E(5).with_traceback(T)
raise E, None, T -> raise E.with_traceback(T)
raise (((E, E'), E''), E'''), 5 -> raise E(5)
raise "foo", V, T -> warns about string exceptions
raise E, (V1, V2) -> raise E(V1, V2)
raise E, (V1, V2), T -> raise E(V1, V2).with_traceback(T)
CAVEATS:
1) "raise E, V, T" cannot be translated safely in general. If V
is not a tuple or a (number, string, None) literal, then:
raise E, V, T -> from future.utils import raise_
raise_(E, V, T)
� )�pytree�
fixer_base)�token)�Name�Call�is_tuple�Comma�Attr�ArgList)�touch_import_topc @ s e Zd ZdZdZdd� ZdS )�FixRaiseTzB
raise_stmt< 'raise' exc=any [',' val=any [',' tb=any]] >
c
C s� | j }|d �� }|jtjkr2d}| �||� d S t|�r^t|�rX|jd jd �� }q:d|_d|v rt|d �� }nd }d|v �rB|d �� }t|�r�dd � |jdd
� D �}t ||�}n�|jtj
tjfv r�d |_t ||g�}nb|jtj kr�|j d kr�nJt
d
d|� d |_|t� |g}|d u�r.|t� |g7 }t td�||jd�S |d u�rnd |_t|td��t|g�g } n|g} tj|jtd�g| |jd�S )N�excz+Python 3 does not support string exceptions� r � �tb�valc S s g | ] }|� � �qS � )�clone)�.0�cr r �E/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_raise.py�
<listcomp>I � z&FixRaise.transform.<locals>.<listcomp>���� �Nonez future.utilsZraise_)�prefix�with_traceback�raise)�symsr �typer �STRINGZcannot_convertr �childrenr r �NUMBER�NAME�valuer r r r r
r �NodeZ
raise_stmt)
�self�node�resultsr r
�msgr r �argsZexc_listr r r � transform* sJ
�zFixRaise.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr, r r r r r # s r N)�__doc__Zlib2to3r r Z
lib2to3.pgen2r Zlib2to3.fixer_utilr r r r r r
Zlibfuturize.fixer_utilr ZBaseFixr r r r r �<module> s
PK $Au\v�OC 7 libfuturize/fixes/__pycache__/fix_object.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )zf
Fixer that adds ``from builtins import object`` if there is a line
like this:
class Foo(object):
� )�
fixer_base��touch_import_topc @ s e Zd ZdZdd� ZdS )� FixObjectz<classdef< 'class' NAME '(' name='object' ')' colon=':' any >c C s t dd|� d S )N�builtins�objectr )�self�node�results� r �F/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_object.py� transform s zFixObject.transformN)�__name__�
__module__� __qualname__ZPATTERNr
r r r r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r r r r �<module> s PK 'Au\�&D�3 3 4 libfuturize/fixes/__pycache__/fix_cmp.cpython-39.pycnu �[��� a
��?h� � @ sB d Z ddlmZ ddlmZ ddlmZ dZG dd� dej�Z dS ) z�
Fixer for the cmp() function on Py2, which was removed in Py3.
Adds this import line::
from past.builtins import cmp
if cmp() is called in the code.
� )�unicode_literals)�
fixer_base)�touch_import_topz
name='cmp'c @ s& e Zd ZdZdZd�e�Zdd� ZdS )�FixCmpT� zs
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
c C s |d }t d|j|� d S )N�namez
past.builtins)r �value)�self�node�resultsr � r �C/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_cmp.py� transform s zFixCmp.transformN) �__name__�
__module__� __qualname__Z
BM_compatibleZ run_order�format�
expressionZPATTERNr r r r r
r s �r N)
�__doc__�
__future__r Zlib2to3r Zlibfuturize.fixer_utilr r ZBaseFixr r r r r
�<module> s
PK *Au\�#N� 6 libfuturize/fixes/__pycache__/fix_bytes.cpython-39.pycnu �[��� a
��?h� � @ sP d Z ddlmZ ddlZddlmZ ddlmZ e�d�Z G dd� dej
�Z dS ) z�Optional fixer that changes all unprefixed string literals "..." to b"...".
br'abcd' is a SyntaxError on Python 2 but valid on Python 3.
ur'abcd' is a SyntaxError on Python 3 but valid on Python 2.
� )�unicode_literalsN)�token)�
fixer_basez[^bBuUrR]?[\'\"]c @ s e Zd ZdZdZdd� ZdS )�FixBytesT�STRINGc C s4 |j tjkr0t�|j�r0|�� }d|j |_|S d S )N�b)�typer r � _literal_re�match�value�clone)�self�node�results�new� r �E/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_bytes.py� transform s
zFixBytes.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr r r r r r s r ) �__doc__�
__future__r �reZ
lib2to3.pgen2r Zlib2to3r �compiler ZBaseFixr r r r r �<module> s
PK ,Au\�o��e
e
6 libfuturize/fixes/__pycache__/fix_print.cpython-39.pycnu �[��� a
��?h) � @ s\ d Z ddlmZmZmZ ddlmZ ddlmZm Z m
Z
m Z e� d�Z
G dd� dej�ZdS ) a, Fixer for print.
Change:
"print" into "print()"
"print ..." into "print(...)"
"print(...)" not changed
"print ... ," into "print(..., end=' ')"
"print >>x, ..." into "print(..., file=x)"
No changes are applied if print_function is imported from __future__
� )�patcomp�pytree�
fixer_base)�token)�Name�Call�Comma�Stringz8atom< '(' [arith_expr|atom|power|term|STRING|NAME] ')' >c @ s$ e Zd ZdZdZdd� Zdd� ZdS )�FixPrintTzP
simple_stmt< any* bare='print' any* > | print_stmt
c C s� |sJ �|� d�}|r4|�ttd�g |jd�� d S |jd td�ksJJ �|jdd � }t|�dkrvt�|d �rvd S d } }}|r�|d t � kr�|d d� }d}dd � |d �
� D �}|r�|d j d d
kr�|d j d d� d v r�d
}|�r2|d t �
tjd�k�r2t|�dk�sJ �|d �� }|dd � }dd � |D �} | �rPd
| d _|d u�sn|d u�sn|d u�r�|d u�r�| �| dtt|��� |d u�r�| �| dtt|��� |d u�r�| �| d|� ttd�| �}
|j|
_|
S )NZbare�print)�prefixr � ���� c S s g | ]}|j tjkr|�qS � )�typer �STRING)�.0Zleafr r �E/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_print.py�
<listcomp>? � z&FixPrint.transform.<locals>.<listcomp>�r���)z\tz\nz\r� z>>� � c S s g | ] }|� � �qS r )�clone)r �argr r r r K r �sep�end�file)�get�replacer r r �children�len� parend_expr�matchr Zleaves�valuer �Leafr �
RIGHTSHIFTr � add_kwargr �repr) �self�node�resultsZ
bare_print�argsr r r Z
string_leavesZl_argsZn_stmtr r r � transform$ sP
� ���
zFixPrint.transformc C sN d|_ t�| jjt|�t�tjd�|f�}|r@|� t
� � d|_ |� |� d S )Nr �=r ) r r �NodeZsyms�argumentr r( r �EQUAL�appendr )r, Zl_nodesZs_kwdZn_exprZ
n_argumentr r r r* ^ s
�� zFixPrint.add_kwargN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr0 r* r r r r r
s :r
N)�__doc__Zlib2to3r r r Z
lib2to3.pgen2r Zlib2to3.fixer_utilr r r r �compile_patternr% ZBaseFixr
r r r r �<module> s �PK /Au\���� � : libfuturize/fixes/__pycache__/fix_metaclass.cpython-39.pycnu �[��� a
��?hb% � @ s� d Z ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
mZ dd� Zdd� Zd d
� Zd d � Zd
d� Zdd� ZG dd� dej�ZdS )a� Fixer for __metaclass__ = X -> (future.utils.with_metaclass(X)) methods.
The various forms of classef (inherits nothing, inherits once, inherints
many) don't parse the same in the CST so we look at ALL classes for
a __metaclass__ and if we find one normalize the inherits to all be
an arglist.
For one-liner classes ('class X: pass') there is no indent/dedent so
we normalize those into having a suite.
Moving the __metaclass__ into the classdef can also cause the class
body to be empty so there is some special casing for that as well.
This fixer also tries very hard to keep original indenting and spacing
in all those corner cases.
� )�
fixer_base)�token) �Name�syms�Node�Leaf� touch_import�Call�String�Comma� parenthesizec C sz | j D ]n}|jtjkr"t|� S |jtjkr|j r|j d }|jtjkr|j r|j d }t|t�r|j dkr dS qdS )z� we have to check the cls_node without changing it.
There are two possibilities:
1) clsdef => suite => simple_stmt => expr_stmt => Leaf('__meta')
2) clsdef => simple_stmt => expr_stmt => Leaf('__meta')
r �
__metaclass__TF)
�children�typer �suite�
has_metaclass� simple_stmt� expr_stmt�
isinstancer �value)�parent�node� expr_nodeZ left_side� r �I/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_metaclass.pyr & s
�r c C s� | j D ]}|jtjkr dS qt| j �D ]\}}|jtjkr( qJq(td��ttjg �}| j |d d� r�| j |d }|� |�
� � |� � qV| � |� |}dS )zf one-line classes don't get a suite in the parse tree so we add
one to normalize the tree
NzNo class suite and no ':'!� ) r r r r � enumerater �COLON�
ValueErrorr � append_child�clone�remove)�cls_noder �ir � move_noder r r �fixup_parse_tree9 s
r% c
C s� t |j�D ]\}}|jtjkr
q(q
dS |�� ttjg �}ttj |g�}|j|d� rz|j| }|�
|� � � |�� qJ| � ||� |jd jd }|jd jd } | j
|_
dS )z� if there is a semi-colon all the parts count as part of the same
simple_stmt. We just want the __metaclass__ part so we move
everything efter the semi-colon into its own simple_stmt node
Nr )r r r r �SEMIr! r r r r r r � insert_child�prefix)
r r# Z stmt_nodeZsemi_indr Znew_exprZnew_stmtr$ Z new_leaf1Z old_leaf1r r r �fixup_simple_stmtS s
r) c C s* | j r&| j d jtjkr&| j d �� d S )N���)r r r �NEWLINEr! )r r r r �remove_trailing_newlinek s r, c c s� | j D ]}|jtjkr q$qtd��tt|j ��D ]t\}}|jtjkr2|j r2|j d }|jtjkr2|j r2|j d }t |t
�r2|j dkr2t |||� t
|� |||fV q2d S )NzNo class suite!r r
)r r r r r �listr r r r r r r) r, )r" r r# Z simple_noder Z left_noder r r �
find_metasp s
� r. c C sz | j ddd� }|r,|�� }|jtjkrq,q|rv|�� }t|t�r^|jtjkr^|jrZd|_dS |� |j ddd� � q,dS )z� If an INDENT is followed by a thing with a prefix then nuke the prefix
Otherwise we get in trouble when removing __metaclass__ at suite start
Nr* � )
r �popr r �INDENTr r �DEDENTr( �extend)r Zkidsr r r r � fixup_indent� s r4 c @ s e Zd ZdZdZdd� ZdS )� FixMetaclassTz
classdef<any*>
c C s� t |�s d S t|� d }t|�D ]\}}}|}|�� q |jd j}t|j�dkr�|jd jtjkrp|jd }n(|jd � � } t
tj| g�}|� d|� n�t|j�dkr�t
tjg �}|� d|� nZt|j�dk�rt
tjg �}|� dt
tjd�� |� d|� |� dt
tjd�� ntd ��|jd jd }
d
|
_|
j} td d |� |jd jd � � } d
| _| g}
|j�r�t|j�dk�r�|jd � � }d|_nVt|� � �}d|_ttd�td�t� |t� t
tjt
tjd�t
tj d�gdd�gdd�}|
� t� |g� |� ttd |jd�|
�� t |� |j�sX|�� t
|d�}| |_|� |� |� t
tj!d�� nbt|j�dk�r�|jd jtj"k�r�|jd jtj#k�r�t
|d�}|� d|� |� dt
tj!d�� d S )Nr � � � � � �)�(zUnexpected class definition� metaclassz future.utils�with_metaclassr/ r � r z 'NewBase'�{�})r( �pass�
���r* )$r r% r. r! r r �lenr �arglistr r Z set_childr' r r �RPAR�LPARr r r( r r r r r
r Zatom�LBRACE�RBRACEr3 �replacer4 r r+ r1 r2 )�selfr �resultsZlast_metaclassr r# �stmt� text_typerF r Zmeta_txtZorig_meta_prefixr= � arguments�base�basesZ pass_leafr r r � transform� s�
��
� �
��
zFixMetaclass.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNrS r r r r r5 � s r5 N)�__doc__Zlib2to3r Zlib2to3.pygramr Zlib2to3.fixer_utilr r r r r r r
r r r r% r) r, r. r4 ZBaseFixr5 r r r r �<module> s ,PK 1Au\�"8�� � 9 libfuturize/fixes/__pycache__/fix_UserDict.cpython-39.pycnu �[��� a
��?h � @ sP d Z ddlmZ ddlmZmZ ddlmZmZm Z ddiZ
G dd� de �Z d S )
zCFix UserDict.
Incomplete!
TODO: base this on fix_urllib perhaps?
� )�
fixer_base)�Name�
attr_chain)�
alternates�
build_pattern�
FixImports�UserDict� collectionsc sT e Zd ZdZdZeZdZdd� Z� fdd�Z � fdd�Z
� fd d
�Z d d � Z � Z
S )
� FixUserdictT� c C s d� t| j��S )N�|)�joinr �mapping��self� r �H/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_UserDict.pyr 5 s zFixUserdict.build_patternc s | � � | _tt| ��� d S �N)r ZPATTERN�superr �compile_patternr �� __class__r r r 8 s
zFixUserdict.compile_patternc sH t t| �j� � |�}|rDd|vr@t� fdd�t|d�D ��r@dS |S dS )N�bare_with_attrc 3 s | ]}� |�V qd S r r )�.0�obj��matchr r � <genexpr>F � z$FixUserdict.match.<locals>.<genexpr>�parentF)r r r �anyr )r �node�resultsr r r r ? s �zFixUserdict.matchc s t t| ��||� i | _d S r )r r �
start_tree�replace)r �tree�filenamer r r r# K s zFixUserdict.start_treec C s� |� d�}|rl|j}t| j| �}|�t||jd�� d|v rH|| j|< d|v r�| �|�}|r�| �||� n2|d d }| j� |j�}|r�|�t||jd�� d S )N� module_name)�prefixZ name_importZmultiple_importsr r ) �get�value�unicoder r$ r r( r � transform)r r! r" Z
import_mod�mod_name�new_nameZ bare_namer r r r, O s
zFixUserdict.transform)�__name__�
__module__� __qualname__Z
BM_compatibleZkeep_line_order�MAPPINGr Z run_orderr r r r# r, �
__classcell__r r r r r
* s r
N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r Zlib2to3.fixes.fix_importsr r r r2 r
r r r r �<module> s
PK 4Au\�+�( ( H libfuturize/fixes/__pycache__/fix_future_standard_library.cpython-39.pycnu �[��� a
��?h� � @ s0 d Z ddlmZ ddlmZ G dd� de�ZdS )a
For the ``future`` package.
Changes any imports needed to reflect the standard library reorganization. Also
Also adds these import lines:
from future import standard_library
standard_library.install_aliases()
after any __future__ imports but before any other imports.
� )�
FixImports)�touch_import_topc s e Zd ZdZ� fdd�Z� ZS )�FixFutureStandardLibrary� c s" t t| ��||�}tdd|� |S )N�futureZstandard_library)�superr � transformr )�self�node�results�result�� __class__� �W/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_future_standard_library.pyr s z"FixFutureStandardLibrary.transform)�__name__�
__module__� __qualname__Z run_orderr �
__classcell__r r r
r r s r N)�__doc__Zlib2to3.fixes.fix_importsr Zlibfuturize.fixer_utilr r r r r r �<module> s PK 7Au\�ú�k k C libfuturize/fixes/__pycache__/fix_xrange_with_import.cpython-39.pycnu �[��� a
��?h� � @ s0 d Z ddlmZ ddlmZ G dd� de�ZdS )z�
For the ``future`` package.
Turns any xrange calls into range calls and adds this import line:
from builtins import range
at the top.
� )� FixXrange)�touch_import_topc s e Zd Z� fdd�Z� ZS )�FixXrangeWithImportc s" t t| ��||�}tdd|� |S )N�builtins�range)�superr � transformr )�self�node�results�result�� __class__� �R/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_xrange_with_import.pyr s z FixXrangeWithImport.transform)�__name__�
__module__� __qualname__r �
__classcell__r r r
r r s r N)�__doc__Zlib2to3.fixes.fix_xranger Zlibfuturize.fixer_utilr r r r r r �<module> s
PK :Au\�h�, , 6 libfuturize/fixes/__pycache__/fix_input.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlZddlmZ G dd� dejjj�ZdS )aq
Fixer for input.
Does a check for `from builtins import input` before running the lib2to3 fixer.
The fixer will not run when the input is already present.
this:
a = input()
becomes:
from builtins import input
a = eval(input())
and this:
from builtins import input
a = input()
becomes (no change):
from builtins import input
a = input()
� N)�does_tree_importc s e Zd Z� fdd�Z� ZS )�FixInputc s" t dd|�rd S tt| ��||�S )N�builtins�input)r �superr � transform)�self�node�results�� __class__� �E/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_input.pyr s zFixInput.transform)�__name__�
__module__� __qualname__r �
__classcell__r
r
r r r s r )�__doc__Zlib2to3.fixes.fix_inputZlib2to3Zlib2to3.fixer_utilr �fixesZ fix_inputr r
r
r
r �<module> s PK =Au\X�Xeb b < libfuturize/fixes/__pycache__/fix_oldstr_wrap.cpython-39.pycnu �[��� a
��?h� � @ sp d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl
m Z m Z m
Z
e�d�ZG d d
� d
ej�ZdS ) a
For the ``future`` package.
Adds this import line:
from past.builtins import str as oldstr
at the top and wraps any unadorned string literals 'abc' or explicit byte-string
literals b'abc' in oldstr() calls so the code has the same behaviour on Py3 as
on Py2.6/2.7.
� )�unicode_literalsN)�
fixer_base)�token)�syms)�
future_import�touch_import_top�wrap_in_fn_callz[^uUrR]?[\'\"]c @ s e Zd ZdZdZdd� ZdS )�
FixOldstrWrapT�STRINGc C sX |j tjkrTtdd|� t�|j�rT|�� }d|_d|j |_t d|g|jd�}|S d S )Nz
past.typesZoldstr� �b)�prefix)
�typer r
r � _literal_re�match�value�cloner
r )�self�node�results�new�wrapped� r �K/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_oldstr_wrap.py� transform s zFixOldstrWrap.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr r r r r r s r )�__doc__�
__future__r �reZlib2to3r Z
lib2to3.pgen2r Zlib2to3.fixer_utilr Zlibfuturize.fixer_utilr r r �compiler ZBaseFixr r r r r �<module> s
PK AAu\�JD;� � @ libfuturize/fixes/__pycache__/fix_absolute_import.cpython-39.pycnu �[��� a
��?hD � @ sd d Z ddlmZmZmZmZ ddlmZ ddlm Z m
Z
ddlm Z ddl m
Z
G dd� de�Zd S )
a�
Fixer for import statements, with a __future__ import line.
Based on lib2to3/fixes/fix_import.py, but extended slightly so it also
supports Cython modules.
If spam is being imported from the local directory, this import:
from spam import eggs
becomes:
from __future__ import absolute_import
from .spam import eggs
and this import:
import spam
becomes:
from __future__ import absolute_import
from . import spam
� )�dirname�join�exists�sep)� FixImport)�
FromImport�syms)�traverse_imports)�
future_importc @ s e Zd ZdZdd� Zdd� ZdS )�FixAbsoluteImport� c C s� | j r
dS |d }|jtjkr`t|d�s4|jd }q | �|j�r�d|j |_|�� t d|� ndd}d}t
|�D ]}| �|�r�d}qpd}qp|r�|r�| � |d � dS t d|g�}|j
|_
t d|� |S dS )
z�
Copied from FixImport.transform(), but with this line added in
any modules that had implicit relative imports changed:
from __future__ import absolute_import"
N�imp�valuer �.�absolute_importFTz#absolute and local imports together)�skip�typer Z import_from�hasattr�children�probably_a_local_importr �changedr
r �warningr �prefix)�self�node�resultsr
Z
have_localZ
have_absolute�mod_name�new� r �O/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_absolute_import.py� transform s0
zFixAbsoluteImport.transformc C sv |� d�rdS |�dd�d }t| j�}t||�}ttt|�d��sHdS dtddd d
d fD ]}t|| �rZ d S qZdS )
zq
Like the corresponding method in the base class, but this also
supports Cython modules.
r F� r z __init__.pyz.pyz.pycz.soz.slz.pydz.pyxT)�
startswith�splitr �filenamer r r )r Zimp_name� base_path�extr r r r I s
z)FixAbsoluteImport.probably_a_local_importN)�__name__�
__module__� __qualname__Z run_orderr r r r r r r s *r N)�__doc__�os.pathr r r r Zlib2to3.fixes.fix_importr Zlib2to3.fixer_utilr r r Zlibfuturize.fixer_utilr
r r r r r �<module> s PK DAu\Iڭ ; libfuturize/fixes/__pycache__/fix_basestring.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )zd
Fixer that adds ``from past.builtins import basestring`` if there is a
reference to ``basestring``
� )�
fixer_base��touch_import_topc @ s e Zd ZdZdZdd� ZdS )�
FixBasestringTz 'basestring'c C s t dd|� d S )Nz
past.builtins�
basestringr )�self�node�results� r
�J/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_basestring.py� transform s zFixBasestring.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNr r
r
r
r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK FAu\�&�˰ � B libfuturize/fixes/__pycache__/fix_print_with_import.cpython-39.pycnu �[��� a
��?h� � @ s0 d Z ddlmZ ddlmZ G dd� de�ZdS )z�
For the ``future`` package.
Turns any print statements into functions and adds this import line:
from __future__ import print_function
at the top to retain compatibility with Python 2.6+.
� )�FixPrint)�
future_importc s e Zd ZdZ� fdd�Z� ZS )�FixPrintWithImport� c s t d|� tt| ��||�}|S )N�print_function)r �superr � transform)�self�node�resultsZn_stmt�� __class__� �Q/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_print_with_import.pyr s
z FixPrintWithImport.transform)�__name__�
__module__� __qualname__Z run_orderr �
__classcell__r r r r r s r N)�__doc__Zlibfuturize.fixes.fix_printr Zlibfuturize.fixer_utilr r r r r r �<module> s
PK IAu\H�aU) ) ] libfuturize/fixes/__pycache__/fix_add__future__imports_except_unicode_literals.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )z�
Fixer for adding:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
This is "stage 1": hopefully uncontroversial changes.
Stage 2 adds ``unicode_literals``.
� )�
fixer_base��
future_importc @ s e Zd ZdZdZdZdd� ZdS )�(FixAddFutureImportsExceptUnicodeLiteralsTZ
file_input� c C s" t d|� t d|� t d|� d S )N�absolute_import�division�print_functionr )�self�node�results� r
�l/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_add__future__imports_except_unicode_literals.py� transform s
z2FixAddFutureImportsExceptUnicodeLiterals.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr r
r
r
r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK KAu\ Yu � � > libfuturize/fixes/__pycache__/fix_division_safe.cpython-39.pycnu �[��� a
��?h/ � @ s| d Z ddlZddlmZmZmZ ddlmZ ddlm Z m
Z
m Z m Z dd� Z
e�d�Zd d
� Zd d � ZG d
d� dej�ZdS )aL
For the ``future`` package.
Adds this import line:
from __future__ import division
at the top and changes any old-style divisions to be calls to
past.utils.old_div so the code runs as before on Py2.6/2.7 and has the same
behaviour on Py3.
If "from __future__ import division" is already in effect, this fixer does
nothing.
� N)�Leaf�Node�Comma)�
fixer_base)�token�
future_import�touch_import_top�wrap_in_fn_callc C s, t j}| j|ko*| jj|k o*| jj|k S )zw
__future__.division redefines the meaning of a single slash for division,
so we match that and only that.
)r �SLASH�type� next_sibling� prev_sibling)�nodeZslash� r �M/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_division_safe.py�match_division s �r z^[0-9]*[.][0-9]*$c C s t | j�pt | j�S )N)�
_is_floatyr
r )r r r r � is_floaty" s r c C sV t | t�r| d } t | t�r(t�| j�S t | t�rRt | jd t�rR| jd jdkS dS )Nr �floatF)�
isinstance�listr �const_re�match�valuer �children)�exprr r r r & s
r c s: e Zd ZdZejZdZ� fdd�Zdd� Z dd� Z
� Z S ) �FixDivisionSafe� z4
term<(not('/') any)+ '/' ((not('/') any))>
c s" t t| ��||� d|jv | _dS )zO
Skip this fixer if "__future__.division" is already imported.
�divisionN)�superr �
start_treeZfuture_features�skip)�self�tree�name�� __class__r r r > s zFixDivisionSafe.start_treec C s� |j | jjkr�d}d}g }|jD ]b}|r.d}q t|�rtt|�std}d|d _td|t� |j �
� g |jd�g}d}q |� |�
� � q |r�t t
d�r�t
|j ||jd�S t
|j |�S dS ) z�
Since the tree needs to be fixed once and only once if and only if it
matches, we can start discarding matches after the first.
FT� r �old_div)�prefix�fixers_applied)r* )r ZsymsZtermr r r r) r r r �clone�append�hasattrr r* )r" r �matchedr! r �childr r r r E s,
�
zFixDivisionSafe.matchc C s$ | j r
d S td|� tdd|� |S )Nr z
past.utilsr( )r! r r )r" r �resultsr r r � transformh s
zFixDivisionSafe.transform) �__name__�
__module__� __qualname__Z run_orderr r
Z _accept_typeZPATTERNr r r1 �
__classcell__r r r% r r 4 s #r )�__doc__�reZlib2to3.fixer_utilr r r Zlib2to3r Zlibfuturize.fixer_utilr r r r r �compiler r r ZBaseFixr r r r r �<module> s
PK NAu\;ɧ�� � L libfuturize/fixes/__pycache__/fix_remove_old__future__imports.cpython-39.pycnu �[��� a
��?hS � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )a�
Fixer for removing any of these lines:
from __future__ import with_statement
from __future__ import nested_scopes
from __future__ import generators
The reason is that __future__ imports like these are required to be the first
line of code (after docstrings) on Python 2.6+, which can get in the way.
These imports are always enabled in Python 2.6+, which is the minimum sane
version to target for Py2/3 compatibility.
� )�
fixer_base��remove_future_importc @ s e Zd ZdZdZdZdd� ZdS )�FixRemoveOldFutureImportsTZ
file_input� c C s" t d|� t d|� t d|� d S )N�with_statement�
nested_scopes�
generatorsr )�self�node�results� r
�[/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_remove_old__future__imports.py� transform s
z#FixRemoveOldFutureImports.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr r
r
r
r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK PAu\�ވ H libfuturize/fixes/__pycache__/fix_unicode_literals_import.cpython-39.pycnu �[��� a
��?ho � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )zA
Adds this import:
from __future__ import unicode_literals
� )�
fixer_base��
future_importc @ s e Zd ZdZdZdZdd� ZdS )�FixUnicodeLiteralsImportTZ
file_input� c C s t d|� d S )N�unicode_literalsr )�self�node�results� r �W/usr/local/lib/python3.9/site-packages/libfuturize/fixes/fix_unicode_literals_import.py� transform s z"FixUnicodeLiteralsImport.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr
r r r r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r r r r �<module> s PK VAu\*�� � $ libfuturize/fixes/fix_oldstr_wrap.pynu �[��� """
For the ``future`` package.
Adds this import line:
from past.builtins import str as oldstr
at the top and wraps any unadorned string literals 'abc' or explicit byte-string
literals b'abc' in oldstr() calls so the code has the same behaviour on Py3 as
on Py2.6/2.7.
"""
from __future__ import unicode_literals
import re
from lib2to3 import fixer_base
from lib2to3.pgen2 import token
from lib2to3.fixer_util import syms
from libfuturize.fixer_util import (future_import, touch_import_top,
wrap_in_fn_call)
_literal_re = re.compile(r"[^uUrR]?[\'\"]")
class FixOldstrWrap(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "STRING"
def transform(self, node, results):
if node.type == token.STRING:
touch_import_top(u'past.types', u'oldstr', node)
if _literal_re.match(node.value):
new = node.clone()
# Strip any leading space or comments:
# TODO: check: do we really want to do this?
new.prefix = u''
new.value = u'b' + new.value
wrapped = wrap_in_fn_call("oldstr", [new], prefix=node.prefix)
return wrapped
PK XAu\�S��b% b% " libfuturize/fixes/fix_metaclass.pynu �[��� # coding: utf-8
"""Fixer for __metaclass__ = X -> (future.utils.with_metaclass(X)) methods.
The various forms of classef (inherits nothing, inherits once, inherints
many) don't parse the same in the CST so we look at ALL classes for
a __metaclass__ and if we find one normalize the inherits to all be
an arglist.
For one-liner classes ('class X: pass') there is no indent/dedent so
we normalize those into having a suite.
Moving the __metaclass__ into the classdef can also cause the class
body to be empty so there is some special casing for that as well.
This fixer also tries very hard to keep original indenting and spacing
in all those corner cases.
"""
# This is a derived work of Lib/lib2to3/fixes/fix_metaclass.py under the
# copyright of the Python Software Foundation, licensed under the Python
# Software Foundation License 2.
#
# Copyright notice:
#
# Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
# 2011, 2012, 2013 Python Software Foundation. All rights reserved.
#
# Full license text: http://docs.python.org/3.4/license.html
# Author: Jack Diederich, Daniel Neuhäuser
# Local imports
from lib2to3 import fixer_base
from lib2to3.pygram import token
from lib2to3.fixer_util import Name, syms, Node, Leaf, touch_import, Call, \
String, Comma, parenthesize
def has_metaclass(parent):
""" we have to check the cls_node without changing it.
There are two possibilities:
1) clsdef => suite => simple_stmt => expr_stmt => Leaf('__meta')
2) clsdef => simple_stmt => expr_stmt => Leaf('__meta')
"""
for node in parent.children:
if node.type == syms.suite:
return has_metaclass(node)
elif node.type == syms.simple_stmt and node.children:
expr_node = node.children[0]
if expr_node.type == syms.expr_stmt and expr_node.children:
left_side = expr_node.children[0]
if isinstance(left_side, Leaf) and \
left_side.value == '__metaclass__':
return True
return False
def fixup_parse_tree(cls_node):
""" one-line classes don't get a suite in the parse tree so we add
one to normalize the tree
"""
for node in cls_node.children:
if node.type == syms.suite:
# already in the preferred format, do nothing
return
# !%@#! one-liners have no suite node, we have to fake one up
for i, node in enumerate(cls_node.children):
if node.type == token.COLON:
break
else:
raise ValueError("No class suite and no ':'!")
# move everything into a suite node
suite = Node(syms.suite, [])
while cls_node.children[i+1:]:
move_node = cls_node.children[i+1]
suite.append_child(move_node.clone())
move_node.remove()
cls_node.append_child(suite)
node = suite
def fixup_simple_stmt(parent, i, stmt_node):
""" if there is a semi-colon all the parts count as part of the same
simple_stmt. We just want the __metaclass__ part so we move
everything efter the semi-colon into its own simple_stmt node
"""
for semi_ind, node in enumerate(stmt_node.children):
if node.type == token.SEMI: # *sigh*
break
else:
return
node.remove() # kill the semicolon
new_expr = Node(syms.expr_stmt, [])
new_stmt = Node(syms.simple_stmt, [new_expr])
while stmt_node.children[semi_ind:]:
move_node = stmt_node.children[semi_ind]
new_expr.append_child(move_node.clone())
move_node.remove()
parent.insert_child(i, new_stmt)
new_leaf1 = new_stmt.children[0].children[0]
old_leaf1 = stmt_node.children[0].children[0]
new_leaf1.prefix = old_leaf1.prefix
def remove_trailing_newline(node):
if node.children and node.children[-1].type == token.NEWLINE:
node.children[-1].remove()
def find_metas(cls_node):
# find the suite node (Mmm, sweet nodes)
for node in cls_node.children:
if node.type == syms.suite:
break
else:
raise ValueError("No class suite!")
# look for simple_stmt[ expr_stmt[ Leaf('__metaclass__') ] ]
for i, simple_node in list(enumerate(node.children)):
if simple_node.type == syms.simple_stmt and simple_node.children:
expr_node = simple_node.children[0]
if expr_node.type == syms.expr_stmt and expr_node.children:
# Check if the expr_node is a simple assignment.
left_node = expr_node.children[0]
if isinstance(left_node, Leaf) and \
left_node.value == u'__metaclass__':
# We found a assignment to __metaclass__.
fixup_simple_stmt(node, i, simple_node)
remove_trailing_newline(simple_node)
yield (node, i, simple_node)
def fixup_indent(suite):
""" If an INDENT is followed by a thing with a prefix then nuke the prefix
Otherwise we get in trouble when removing __metaclass__ at suite start
"""
kids = suite.children[::-1]
# find the first indent
while kids:
node = kids.pop()
if node.type == token.INDENT:
break
# find the first Leaf
while kids:
node = kids.pop()
if isinstance(node, Leaf) and node.type != token.DEDENT:
if node.prefix:
node.prefix = u''
return
else:
kids.extend(node.children[::-1])
class FixMetaclass(fixer_base.BaseFix):
BM_compatible = True
PATTERN = """
classdef<any*>
"""
def transform(self, node, results):
if not has_metaclass(node):
return
fixup_parse_tree(node)
# find metaclasses, keep the last one
last_metaclass = None
for suite, i, stmt in find_metas(node):
last_metaclass = stmt
stmt.remove()
text_type = node.children[0].type # always Leaf(nnn, 'class')
# figure out what kind of classdef we have
if len(node.children) == 7:
# Node(classdef, ['class', 'name', '(', arglist, ')', ':', suite])
# 0 1 2 3 4 5 6
if node.children[3].type == syms.arglist:
arglist = node.children[3]
# Node(classdef, ['class', 'name', '(', 'Parent', ')', ':', suite])
else:
parent = node.children[3].clone()
arglist = Node(syms.arglist, [parent])
node.set_child(3, arglist)
elif len(node.children) == 6:
# Node(classdef, ['class', 'name', '(', ')', ':', suite])
# 0 1 2 3 4 5
arglist = Node(syms.arglist, [])
node.insert_child(3, arglist)
elif len(node.children) == 4:
# Node(classdef, ['class', 'name', ':', suite])
# 0 1 2 3
arglist = Node(syms.arglist, [])
node.insert_child(2, Leaf(token.RPAR, u')'))
node.insert_child(2, arglist)
node.insert_child(2, Leaf(token.LPAR, u'('))
else:
raise ValueError("Unexpected class definition")
# now stick the metaclass in the arglist
meta_txt = last_metaclass.children[0].children[0]
meta_txt.value = 'metaclass'
orig_meta_prefix = meta_txt.prefix
# Was: touch_import(None, u'future.utils', node)
touch_import(u'future.utils', u'with_metaclass', node)
metaclass = last_metaclass.children[0].children[2].clone()
metaclass.prefix = u''
arguments = [metaclass]
if arglist.children:
if len(arglist.children) == 1:
base = arglist.children[0].clone()
base.prefix = u' '
else:
# Unfortunately six.with_metaclass() only allows one base
# class, so we have to dynamically generate a base class if
# there is more than one.
bases = parenthesize(arglist.clone())
bases.prefix = u' '
base = Call(Name('type'), [
String("'NewBase'"),
Comma(),
bases,
Comma(),
Node(
syms.atom,
[Leaf(token.LBRACE, u'{'), Leaf(token.RBRACE, u'}')],
prefix=u' '
)
], prefix=u' ')
arguments.extend([Comma(), base])
arglist.replace(Call(
Name(u'with_metaclass', prefix=arglist.prefix),
arguments
))
fixup_indent(suite)
# check for empty suite
if not suite.children:
# one-liner that was just __metaclass_
suite.remove()
pass_leaf = Leaf(text_type, u'pass')
pass_leaf.prefix = orig_meta_prefix
node.append_child(pass_leaf)
node.append_child(Leaf(token.NEWLINE, u'\n'))
elif len(suite.children) > 1 and \
(suite.children[-2].type == token.INDENT and
suite.children[-1].type == token.DEDENT):
# there was only one line in the class body and it was __metaclass__
pass_leaf = Leaf(text_type, u'pass')
suite.insert_child(-1, pass_leaf)
suite.insert_child(-1, Leaf(token.NEWLINE, u'\n'))
PK [Au\9�k0� � # libfuturize/fixes/fix_basestring.pynu �[��� """
Fixer that adds ``from past.builtins import basestring`` if there is a
reference to ``basestring``
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
class FixBasestring(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "'basestring'"
def transform(self, node, results):
touch_import_top(u'past.builtins', 'basestring', node)
PK ]Au\C5��) ) libfuturize/fixes/fix_print.pynu �[��� # Copyright 2006 Google, Inc. All Rights Reserved.
# Licensed to PSF under a Contributor Agreement.
"""Fixer for print.
Change:
"print" into "print()"
"print ..." into "print(...)"
"print(...)" not changed
"print ... ," into "print(..., end=' ')"
"print >>x, ..." into "print(..., file=x)"
No changes are applied if print_function is imported from __future__
"""
# Local imports
from lib2to3 import patcomp, pytree, fixer_base
from lib2to3.pgen2 import token
from lib2to3.fixer_util import Name, Call, Comma, String
# from libmodernize import add_future
parend_expr = patcomp.compile_pattern(
"""atom< '(' [arith_expr|atom|power|term|STRING|NAME] ')' >"""
)
class FixPrint(fixer_base.BaseFix):
BM_compatible = True
PATTERN = """
simple_stmt< any* bare='print' any* > | print_stmt
"""
def transform(self, node, results):
assert results
bare_print = results.get("bare")
if bare_print:
# Special-case print all by itself.
bare_print.replace(Call(Name(u"print"), [],
prefix=bare_print.prefix))
# The "from __future__ import print_function"" declaration is added
# by the fix_print_with_import fixer, so we skip it here.
# add_future(node, u'print_function')
return
assert node.children[0] == Name(u"print")
args = node.children[1:]
if len(args) == 1 and parend_expr.match(args[0]):
# We don't want to keep sticking parens around an
# already-parenthesised expression.
return
sep = end = file = None
if args and args[-1] == Comma():
args = args[:-1]
end = " "
# try to determine if the string ends in a non-space whitespace character, in which
# case there should be no space at the end of the conversion
string_leaves = [leaf for leaf in args[-1].leaves() if leaf.type == token.STRING]
if (
string_leaves
and string_leaves[-1].value[0] != "r" # "raw" string
and string_leaves[-1].value[-3:-1] in (r"\t", r"\n", r"\r")
):
end = ""
if args and args[0] == pytree.Leaf(token.RIGHTSHIFT, u">>"):
assert len(args) >= 2
file = args[1].clone()
args = args[3:] # Strip a possible comma after the file expression
# Now synthesize a print(args, sep=..., end=..., file=...) node.
l_args = [arg.clone() for arg in args]
if l_args:
l_args[0].prefix = u""
if sep is not None or end is not None or file is not None:
if sep is not None:
self.add_kwarg(l_args, u"sep", String(repr(sep)))
if end is not None:
self.add_kwarg(l_args, u"end", String(repr(end)))
if file is not None:
self.add_kwarg(l_args, u"file", file)
n_stmt = Call(Name(u"print"), l_args)
n_stmt.prefix = node.prefix
# Note that there are corner cases where adding this future-import is
# incorrect, for example when the file also has a 'print ()' statement
# that was intended to print "()".
# add_future(node, u'print_function')
return n_stmt
def add_kwarg(self, l_nodes, s_kwd, n_expr):
# XXX All this prefix-setting may lose comments (though rarely)
n_expr.prefix = u""
n_argument = pytree.Node(self.syms.argument,
(Name(s_kwd),
pytree.Leaf(token.EQUAL, u"="),
n_expr))
if l_nodes:
l_nodes.append(Comma())
n_argument.prefix = u" "
l_nodes.append(n_argument)
PK bAu\��em� � 7 libfuturize/fixes/fix_future_standard_library_urllib.pynu �[��� """
For the ``future`` package.
A special fixer that ensures that these lines have been added::
from future import standard_library
standard_library.install_hooks()
even if the only module imported was ``urllib``, in which case the regular fixer
wouldn't have added these lines.
"""
from lib2to3.fixes.fix_urllib import FixUrllib
from libfuturize.fixer_util import touch_import_top, find_root
class FixFutureStandardLibraryUrllib(FixUrllib): # not a subclass of FixImports
run_order = 8
def transform(self, node, results):
# transform_member() in lib2to3/fixes/fix_urllib.py breaks node so find_root(node)
# no longer works after the super() call below. So we find the root first:
root = find_root(node)
result = super(FixFutureStandardLibraryUrllib, self).transform(node, results)
# TODO: add a blank line between any __future__ imports and this?
touch_import_top(u'future', u'standard_library', root)
return result
PK dAu\6<��� � 0 libfuturize/fixes/fix_future_standard_library.pynu �[��� """
For the ``future`` package.
Changes any imports needed to reflect the standard library reorganization. Also
Also adds these import lines:
from future import standard_library
standard_library.install_aliases()
after any __future__ imports but before any other imports.
"""
from lib2to3.fixes.fix_imports import FixImports
from libfuturize.fixer_util import touch_import_top
class FixFutureStandardLibrary(FixImports):
run_order = 8
def transform(self, node, results):
result = super(FixFutureStandardLibrary, self).transform(node, results)
# TODO: add a blank line between any __future__ imports and this?
touch_import_top(u'future', u'standard_library', node)
return result
PK gAu\�䭫� � * libfuturize/fixes/fix_print_with_import.pynu �[��� """
For the ``future`` package.
Turns any print statements into functions and adds this import line:
from __future__ import print_function
at the top to retain compatibility with Python 2.6+.
"""
from libfuturize.fixes.fix_print import FixPrint
from libfuturize.fixer_util import future_import
class FixPrintWithImport(FixPrint):
run_order = 7
def transform(self, node, results):
# Add the __future__ import first. (Otherwise any shebang or encoding
# comment line attached as a prefix to the print statement will be
# copied twice and appear twice.)
future_import(u'print_function', node)
n_stmt = super(FixPrintWithImport, self).transform(node, results)
return n_stmt
PK jAu\/�D�S S 4 libfuturize/fixes/fix_remove_old__future__imports.pynu �[��� """
Fixer for removing any of these lines:
from __future__ import with_statement
from __future__ import nested_scopes
from __future__ import generators
The reason is that __future__ imports like these are required to be the first
line of code (after docstrings) on Python 2.6+, which can get in the way.
These imports are always enabled in Python 2.6+, which is the minimum sane
version to target for Py2/3 compatibility.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import remove_future_import
class FixRemoveOldFutureImports(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 1
def transform(self, node, results):
remove_future_import(u"with_statement", node)
remove_future_import(u"nested_scopes", node)
remove_future_import(u"generators", node)
PK lAu\]�md/ / & libfuturize/fixes/fix_division_safe.pynu �[��� """
For the ``future`` package.
Adds this import line:
from __future__ import division
at the top and changes any old-style divisions to be calls to
past.utils.old_div so the code runs as before on Py2.6/2.7 and has the same
behaviour on Py3.
If "from __future__ import division" is already in effect, this fixer does
nothing.
"""
import re
from lib2to3.fixer_util import Leaf, Node, Comma
from lib2to3 import fixer_base
from libfuturize.fixer_util import (token, future_import, touch_import_top,
wrap_in_fn_call)
def match_division(node):
u"""
__future__.division redefines the meaning of a single slash for division,
so we match that and only that.
"""
slash = token.SLASH
return node.type == slash and not node.next_sibling.type == slash and \
not node.prev_sibling.type == slash
const_re = re.compile('^[0-9]*[.][0-9]*$')
def is_floaty(node):
return _is_floaty(node.prev_sibling) or _is_floaty(node.next_sibling)
def _is_floaty(expr):
if isinstance(expr, list):
expr = expr[0]
if isinstance(expr, Leaf):
# If it's a leaf, let's see if it's a numeric constant containing a '.'
return const_re.match(expr.value)
elif isinstance(expr, Node):
# If the expression is a node, let's see if it's a direct cast to float
if isinstance(expr.children[0], Leaf):
return expr.children[0].value == u'float'
return False
class FixDivisionSafe(fixer_base.BaseFix):
# BM_compatible = True
run_order = 4 # this seems to be ignored?
_accept_type = token.SLASH
PATTERN = """
term<(not('/') any)+ '/' ((not('/') any))>
"""
def start_tree(self, tree, name):
"""
Skip this fixer if "__future__.division" is already imported.
"""
super(FixDivisionSafe, self).start_tree(tree, name)
self.skip = "division" in tree.future_features
def match(self, node):
u"""
Since the tree needs to be fixed once and only once if and only if it
matches, we can start discarding matches after the first.
"""
if node.type == self.syms.term:
matched = False
skip = False
children = []
for child in node.children:
if skip:
skip = False
continue
if match_division(child) and not is_floaty(child):
matched = True
# Strip any leading space for the first number:
children[0].prefix = u''
children = [wrap_in_fn_call("old_div",
children + [Comma(), child.next_sibling.clone()],
prefix=node.prefix)]
skip = True
else:
children.append(child.clone())
if matched:
# In Python 2.6, `Node` does not have the fixers_applied attribute
# https://github.com/python/cpython/blob/8493c0cd66cfc181ac1517268a74f077e9998701/Lib/lib2to3/pytree.py#L235
if hasattr(Node, "fixers_applied"):
return Node(node.type, children, fixers_applied=node.fixers_applied)
else:
return Node(node.type, children)
return False
def transform(self, node, results):
if self.skip:
return
future_import(u"division", node)
touch_import_top(u'past.utils', u'old_div', node)
return results
PK oAu\��� ' libfuturize/fixes/fix_unicode_keep_u.pynu �[��� """Fixer that changes unicode to str and unichr to chr, but -- unlike the
lib2to3 fix_unicode.py fixer, does not change u"..." into "...".
The reason is that Py3.3+ supports the u"..." string prefix, and, if
present, the prefix may provide useful information for disambiguating
between byte strings and unicode strings, which is often the hardest part
of the porting task.
"""
from lib2to3.pgen2 import token
from lib2to3 import fixer_base
_mapping = {u"unichr" : u"chr", u"unicode" : u"str"}
class FixUnicodeKeepU(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "'unicode' | 'unichr'"
def transform(self, node, results):
if node.type == token.NAME:
new = node.clone()
new.value = _mapping[node.value]
return new
PK qAu\ 5�Io o 0 libfuturize/fixes/fix_unicode_literals_import.pynu �[��� """
Adds this import:
from __future__ import unicode_literals
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import future_import
class FixUnicodeLiteralsImport(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 9
def transform(self, node, results):
future_import(u"unicode_literals", node)
PK tAu\H�(�� � ( libfuturize/fixes/fix_future_builtins.pynu �[��� """
For the ``future`` package.
Adds this import line::
from builtins import XYZ
for each of the functions XYZ that is used in the module.
Adds these imports after any other imports (in an initial block of them).
"""
from __future__ import unicode_literals
from lib2to3 import fixer_base
from lib2to3.pygram import python_symbols as syms
from lib2to3.fixer_util import Name, Call, in_special_context
from libfuturize.fixer_util import touch_import_top
# All builtins are:
# from future.builtins.iterators import (filter, map, zip)
# from future.builtins.misc import (ascii, chr, hex, input, isinstance, oct, open, round, super)
# from future.types import (bytes, dict, int, range, str)
# We don't need isinstance any more.
replaced_builtin_fns = '''filter map zip
ascii chr hex input next oct
bytes range str raw_input'''.split()
# This includes raw_input as a workaround for the
# lib2to3 fixer for raw_input on Py3 (only), allowing
# the correct import to be included. (Py3 seems to run
# the fixers the wrong way around, perhaps ignoring the
# run_order class attribute below ...)
expression = '|'.join(["name='{0}'".format(name) for name in replaced_builtin_fns])
class FixFutureBuiltins(fixer_base.BaseFix):
BM_compatible = True
run_order = 7
# Currently we only match uses as a function. This doesn't match e.g.:
# if isinstance(s, str):
# ...
PATTERN = """
power<
({0}) trailer< '(' [arglist=any] ')' >
rest=any* >
|
power<
'map' trailer< '(' [arglist=any] ')' >
>
""".format(expression)
def transform(self, node, results):
name = results["name"]
touch_import_top(u'builtins', name.value, node)
# name.replace(Name(u"input", prefix=name.prefix))
PK vAu\:m�� � libfuturize/fixes/fix_object.pynu �[��� """
Fixer that adds ``from builtins import object`` if there is a line
like this:
class Foo(object):
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
class FixObject(fixer_base.BaseFix):
PATTERN = u"classdef< 'class' NAME '(' name='object' ')' colon=':' any >"
def transform(self, node, results):
touch_import_top(u'builtins', 'object', node)
PK yAu\���/D D ( libfuturize/fixes/fix_absolute_import.pynu �[��� """
Fixer for import statements, with a __future__ import line.
Based on lib2to3/fixes/fix_import.py, but extended slightly so it also
supports Cython modules.
If spam is being imported from the local directory, this import:
from spam import eggs
becomes:
from __future__ import absolute_import
from .spam import eggs
and this import:
import spam
becomes:
from __future__ import absolute_import
from . import spam
"""
from os.path import dirname, join, exists, sep
from lib2to3.fixes.fix_import import FixImport
from lib2to3.fixer_util import FromImport, syms
from lib2to3.fixes.fix_import import traverse_imports
from libfuturize.fixer_util import future_import
class FixAbsoluteImport(FixImport):
run_order = 9
def transform(self, node, results):
"""
Copied from FixImport.transform(), but with this line added in
any modules that had implicit relative imports changed:
from __future__ import absolute_import"
"""
if self.skip:
return
imp = results['imp']
if node.type == syms.import_from:
# Some imps are top-level (eg: 'import ham')
# some are first level (eg: 'import ham.eggs')
# some are third level (eg: 'import ham.eggs as spam')
# Hence, the loop
while not hasattr(imp, 'value'):
imp = imp.children[0]
if self.probably_a_local_import(imp.value):
imp.value = u"." + imp.value
imp.changed()
future_import(u"absolute_import", node)
else:
have_local = False
have_absolute = False
for mod_name in traverse_imports(imp):
if self.probably_a_local_import(mod_name):
have_local = True
else:
have_absolute = True
if have_absolute:
if have_local:
# We won't handle both sibling and absolute imports in the
# same statement at the moment.
self.warning(node, "absolute and local imports together")
return
new = FromImport(u".", [imp])
new.prefix = node.prefix
future_import(u"absolute_import", node)
return new
def probably_a_local_import(self, imp_name):
"""
Like the corresponding method in the base class, but this also
supports Cython modules.
"""
if imp_name.startswith(u"."):
# Relative imports are certainly not local imports.
return False
imp_name = imp_name.split(u".", 1)[0]
base_path = dirname(self.filename)
base_path = join(base_path, imp_name)
# If there is no __init__.py next to the file its not in a package
# so can't be a relative import.
if not exists(join(dirname(base_path), "__init__.py")):
return False
for ext in [".py", sep, ".pyc", ".so", ".sl", ".pyd", ".pyx"]:
if exists(base_path + ext):
return True
return False
PK {Au\ �h= = 0 libfuturize/fixes/fix_order___future__imports.pynu �[��� """
UNFINISHED
Fixer for turning multiple lines like these:
from __future__ import division
from __future__ import absolute_import
from __future__ import print_function
into a single line like this:
from __future__ import (absolute_import, division, print_function)
This helps with testing of ``futurize``.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import future_import
class FixOrderFutureImports(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 10
# def match(self, node):
# """
# Match only once per file
# """
# if hasattr(node, 'type') and node.type == syms.file_input:
# return True
# return False
def transform(self, node, results):
# TODO # write me
pass
PK �Au\ 4R libfuturize/__init__.pynu �[��� # empty to make this a package
PK �Au\��D� � / libfuturize/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �>/usr/local/lib/python3.9/site-packages/libfuturize/__init__.py�<module> � PK �Au\i{< ;% ;% + libfuturize/__pycache__/main.cpython-39.pycnu �[��� a
��?h�5 � @ s� d Z ddlmZmZmZ ddlZddlmZ ddlZddl Z ddl
Z
ddl Z ddl m
Z
mZ ddlmZ ddlmZmZmZmZ dZd d d
�ZdS ) a�
futurize: automatic conversion to clean 2/3 code using ``python-future``
======================================================================
Like Armin Ronacher's modernize.py, ``futurize`` attempts to produce clean
standard Python 3 code that runs on both Py2 and Py3.
One pass
--------
Use it like this on Python 2 code:
$ futurize --verbose mypython2script.py
This will attempt to port the code to standard Py3 code that also
provides Py2 compatibility with the help of the right imports from
``future``.
To write changes to the files, use the -w flag.
Two stages
----------
The ``futurize`` script can also be called in two separate stages. First:
$ futurize --stage1 mypython2script.py
This produces more modern Python 2 code that is not yet compatible with Python
3. The tests should still run and the diff should be uncontroversial to apply to
most Python projects that are willing to drop support for Python 2.5 and lower.
After this, the recommended approach is to explicitly mark all strings that must
be byte-strings with a b'' prefix and all text (unicode) strings with a u''
prefix, and then invoke the second stage of Python 2 to 2/3 conversion with::
$ futurize --stage2 mypython2script.py
Stage 2 adds a dependency on ``future``. It converts most remaining Python
2-specific code to Python 3 code and adds appropriate imports from ``future``
to restore Py2 support.
The command above leaves all unadorned string literals as native strings
(byte-strings on Py2, unicode strings on Py3). If instead you would like all
unadorned string literals to be promoted to unicode, you can also pass this
flag:
$ futurize --stage2 --unicode-literals mypython2script.py
This adds the declaration ``from __future__ import unicode_literals`` to the
top of each file, which implicitly declares all unadorned string literals to be
unicode strings (``unicode`` on Py2).
All imports
-----------
The --all-imports option forces adding all ``__future__`` imports,
``builtins`` imports, and standard library aliases, even if they don't
seem necessary for the current state of each module. (This can simplify
testing, and can reduce the need to think about Py2 compatibility when editing
the code further.)
� )�absolute_import�print_function�unicode_literalsN)� __version__)�warn�StdoutRefactoringTool)�refactor)�lib2to3_fix_names_stage1�lib2to3_fix_names_stage2� libfuturize_fix_names_stage1� libfuturize_fix_names_stage2zlibfuturize.fixesc s� t jdd�}|jddddd� |jdd dd
d� |jd d dd
d� |jddddd� |jddddd� |jddddd� |jdddg dd� |jd d d d d d!d"� |jd#d$dg d%d� |jd&d'dd(d� |jd)d*dd+d� |jd,d-dd.d� |jd/dd0d� |jd1d2dd3d� |jd4d5dd6d7d� |jd8d9d d:d;d<d=� |jd>d?dd@d� |jdAd d:d;dBd=� i }d6}|�| �\}} |j�r�dC|dD< |j�s�tdE� dC|_|j�r�|j�s�|� dF� |j
�r�|j�s�|� dG� |j�s�|j �r�tdH� |j�s |j�r |� dI� dJ| v �r(dC}|j�r(t dKt
jdL� dMS |j�r8dC|dN< |j�rFtjntj}tjdO|dP� t�dQ�}|j�st|j�r�|jdRu �s�J �d6|_ndC|_t� }|j�s�|j�r�|�t� |�t � |j�s�|j�r�|�t � |�t � |j �r�|� dS� |j!�rt t"� dTS |j#�r8t dU� t$|�D ]}t |� �q | �s8dTS | �s^t dVt
jdL� t dWt
jdL� dMS t� } |j%D ]�� dX� v �r�| � � � nx� fdYdZ�|D �}
t&|
�d k�r�t d[d\�'d]d^� |
D �� t
jdL� dMS t&|
�dTk�r�t d_t
jdL� dMS | � |
dT � �qjt� } |j(�rX|j�r*d`} | � | da � n.db} | � | dc � | � | dd � | � | de � t� }
|j)�rhd6}|j)D ]�� � dfk�r�dC}n�dX� v �r�|
� � � nx� fdgdZ�|D �}
t&|
�d k�r�t d[d\�'dhd^� |
D �� t
jdL� dMS t&|
�dTk�rt d_t
jdL� dMS |
� |
dT � �qpt&|
| @ �dTk�rRt did\�'djd^� |
| @ D �� t
jdL� dMS |�rb|�*|
�n|
}n
|�*|
�}|| B | }t+j,�-| �}|�r�|�.t+j/��s�t+j,�0|��s�t+j,�1|�}|j�r�|�2t+j/�}|�3dk|j|� t4j5j6�r�i }n|j
|j|dl�}t7t$|�|t$|
�|j|j fi |��}|j8�s�|�r:|�9� nPz|�:| |jdR|j;� W n6 t:j<�y� |j;d k�stJ �t dmt
jdL� Y d S 0 |�=� t>t?|j8��S )nz�Main program.
Args:
fixer_pkg: the name of a package where the fixers are located.
args: optional; a list of command line arguments. If omitted,
sys.argv[1:] is used.
Returns a suggested exit status (0, 1, 2).
z futurize [options] file|dir ...)�usagez-Vz --version�
store_truez%Report the version number of futurize)�action�helpz-az
--all-importsz4Add all __future__ and future imports to each modulez-1z--stage1zZModernize Python 2 code only; no compatibility with Python 3 (or dependency on ``future``)z-2z--stage2z^Take modernized (stage1) code and add a dependency on ``future`` to provide Py3 compatibility.z-0z
--both-stageszApply both stages 1 and 2z-uz--unicode-literalsz{Add ``from __future__ import unicode_literals`` to implicitly convert all unadorned string literals '' into unicode stringsz-fz--fix�appendz�Each FIX specifies a transformation; default: all.
Either use '-f division -f metaclass' etc. or use the fully-qualified module name: '-f lib2to3.fixes.fix_types -f libfuturize.fixes.fix_unicode_keep_u')r �defaultr z-jz --processes�store� �intzRun 2to3 concurrently)r r �typer z-xz--nofixz Prevent a fixer from being run.z-lz --list-fixesz List available transformationsz-pz--print-functionz0Modify the grammar so that print() is a functionz-vz --verbosezMore verbose loggingz
--no-diffsz#Don't show diffs of the refactoringz-wz--writezWrite back modified filesz-nz --nobackupsFz'Don't write backups for modified files.z-oz --output-dir�str� zpPut output files in this directory instead of overwriting the input files. Requires -n. For Python >= 2.7 only.)r r r r z-Wz--write-unchanged-fileszYAlso write files even if no changes were required (useful with --output-dir); implies -w.z --add-suffixz�Append this string to all output filenames. Requires -n if non-empty. For Python >= 2.7 only.ex: --add-suffix='3' will generate .py3 files.T�write_unchanged_filesz&--write-unchanged-files/-W implies -w.z%Can't use --output-dir/-o without -n.z"Can't use --add-suffix without -n.z@not writing files and not printing diffs; that's not very usefulzCan't use -n without -w�-zCan't write to stdin.)�file� r z%(name)s: %(message)s)�format�levelzlibfuturize.mainNz-libfuturize.fixes.fix_unicode_literals_importr z2Available transformations for the -f/--fix option:z1At least one file or directory argument required.zUse --help to show usage.z.fix_c s g | ]}|� d �� ��r|�qS �zfix_{0}��endswithr ��.0�f��fix� �:/usr/local/lib/python3.9/site-packages/libfuturize/main.py�
<listcomp>� s �zmain.<locals>.<listcomp>zOAmbiguous fixer name. Choose a fully qualified module name instead from these:
�
c s s | ]}d | V qdS �z Nr' �r# Zmyfr' r' r( � <genexpr>� � zmain.<locals>.<genexpr>z1Unknown fixer. Use --list-fixes or -l for a list.zlibfuturize.fixes.Z0fix_add__future__imports_except_unicode_literalszlibpasteurize.fixes.Z fix_add_all__future__importsZ&fix_add_future_standard_library_importZfix_add_all_future_builtins�allc s g | ]}|� d �� ��r|�qS r r r" r% r' r( r) � s �c s s | ]}d | V qdS r+ r' r, r' r' r( r- r. z[Conflicting usage: the following fixers have been simultaneously requested and disallowed:
c s s | ]}d | V qdS r+ r' r, r' r' r( r- r. z7Output in %r will mirror the input directory %r layout.)Z
append_suffix�
output_dir�input_base_dirz+Sorry, -j isn't supported on this platform.)@�optparse� OptionParser�
add_option�
parse_argsr �writer r0 Z nobackups�errorZ
add_suffixZno_diffs�print�sys�stderrr �verbose�logging�DEBUG�INFO� basicConfig� getLoggerZstage1Zstage2Z both_stages�set�updater r r
r r �add�versionr Z
list_fixes�sortedZnofix�len�joinZ all_importsr& �union�os�path� commonprefixr! �sep�isdir�dirname�rstrip�info�future�utilsZPY26r �errors�refactor_stdinr Z processesZMultiprocessingUnsupportedZ summarizer �bool)�args�parser�flagsrT �optionsr �loggerZ avail_fixesZfixnameZunwanted_fixes�foundZ extra_fixes�prefix�explicitZ all_present� requested� fixer_namesr1 � extra_kwargs�rtr' r% r( �mainT s�
�
�
�
�
�
� � � �
�
�
��
� � �
� �
�
����
�����
� �
�
��
��rb )N)�__doc__�
__future__r r r Z future.utilsrQ r r9 r< r2 rI Z lib2to3.mainr r Zlib2to3r Zlibfuturize.fixesr r
r r Z fixer_pkgrb r' r' r' r( �<module> s ? PK �Au\� �QQ. Q. 1 libfuturize/__pycache__/fixer_util.cpython-39.pycnu �[��� a
��?h�C � @ s@ d Z ddlmZmZmZmZmZmZmZm Z ddl
m Z m Z ddl
mZ ddl
mZ ddlZdd� Zd3d d
�Zd4d d �Zd5d
d�Zdd� Zdd� Zdd� Zdd� Zd6dd�Zejej ej ej ej fZ ej!ej"fZ#dd� Z$d7dd �Z%d d � Z&d d � Z'd!d"� Z(d#d$� Z)d%d&� Z*d'd(� Z+d)d*� Z,d+Z-d,Z.d-d.� Z/d/d0� Z0d8d1d2�Z1dS )9z�
Utility functions from 2to3, 3to2 and python-modernize (and some home-grown
ones).
Licences:
2to3: PSF License v2
3to2: Apache Software License (from 3to2/setup.py)
python-modernize licence: BSD (from python-modernize/LICENSE)
� )�
FromImport�Newline� is_import� find_root�does_tree_import�Call�Name�Comma)�Leaf�Node)�python_symbols)�tokenNc s~ d� v r � S � � d�r"� dd� � � fdd�|D �}t|�dkr^tdd �d
d � |D �� ��nt|�d krrtd
��|d S dS )al
Examples:
>>> canonical_fix_name('fix_wrap_text_literals')
'libfuturize.fixes.fix_wrap_text_literals'
>>> canonical_fix_name('wrap_text_literals')
'libfuturize.fixes.fix_wrap_text_literals'
>>> canonical_fix_name('wrap_te')
ValueError("unknown fixer name")
>>> canonical_fix_name('wrap')
ValueError("ambiguous fixer name")
z.fix_Zfix_� Nc s g | ]}|� d �� ��r|�qS )zfix_{0})�endswith�format)�.0�f��fix� �@/usr/local/lib/python3.9/site-packages/libfuturize/fixer_util.py�
<listcomp>( s �z&canonical_fix_name.<locals>.<listcomp>� zOAmbiguous fixer name. Choose a fully qualified module name instead from these:
�
c s s | ]}d | V qdS )z Nr )r Zmyfr r r � <genexpr>- � z%canonical_fix_name.<locals>.<genexpr>r z1Unknown fixer. Use --list-fixes or -l for a list.)�
startswith�len�
ValueError�join)r Z avail_fixes�foundr r r �canonical_fix_name s
� r! c C s t tjd| d�S )N�*��prefix)r
r
�STARr# r r r �Star6 s r& c C s t tjd| d�S )Nz**r# )r
r
�
DOUBLESTARr# r r r �
DoubleStar9 s r( c C s t tjd| d�S )N�-r# )r
r
�MINUSr# r r r �Minus< s r+ c C s. g }| D ]}|� |� |� t� � q|d= |S )z{
Accepts/turns: (Name, Name, ..., Name, Name)
Returns/into: (Name, Comma, Name, Comma, ..., Name, Comma, Name)
���)�appendr )ZleafsZ new_leafsZleafr r r � commatize? s
r. c C sx | j dur | j jtjkr | j } q | j du r.dS | jtjkr@| jS | jdur`| jjtjkr`| jjS | jdu rndS | jS dS )zf
Returns the indentation for this node
Iff a node is in a suite, then it has indentation.
N� ) �parent�type�syms�suiter
�INDENT�valueZ prev_siblingr$ ��noder r r � indentationK s
r8 c C s2 t | �}tdd� |�� D ��}|s&dS t|�S dS )a
Dirty little trick to get the difference between each indentation level
Implemented by finding the shortest indentation string
(technically, the "least" of all of the indentation strings, but
tabs and spaces mixed won't get this far, so those are synonymous.)
c s s | ]}|j tjkr|jV qd S �N)r1 r
r4 r5 �r �ir r r r i r z#indentation_step.<locals>.<genexpr>z N)r �setZ pre_order�min)r7 �rZ all_indentsr r r �indentation_step` s
r? c C s� | j D ]}|jtjkr dS qt| j �D ]\}}|jtjkr( qJq(td��ttjt � t
tj t |�t
|� �g�}| j |d }|�� d|_|�|� | �|� dS )zj
Turn the stuff after the first colon in parent's children
into a suite, if it wasn't already
NzNo class suite and no ':'!r r/ )�childrenr1 r2 r3 � enumerater
�COLONr r r r
r4 r8 r? �remover$ Z append_child)r0 r7 r; r3 Zone_noder r r �suitifyp s
&
rD c C sN |du r d}t d|d�| g}|durB|�t ddd�t |dd�g� ttj|�S )z�
Accepts a package (Name node), name to import it as (string), and
optional prefix and returns a node:
import <package> [as <as_name>]
Nr/ �importr# �as� )r �extendr r2 � import_name)�package�as_namer$ r@ r r r �
NameImport� s
�rL c c s | j tv sJ �| j}|j tjkrD|j}|j tjkr6qDn|V |j}q| j}|j tjksZJ �|j}|durv|V |j}q`|j}|j t v r�|}|jdur�|jV |j}q�|j}|j}|du r�dS |j t v r�|j tj
kr�|V |j}|du r�|j}|j}|du r�q�q�dS )z�
Generator yields all nodes for which a node (an import_stmt) has scope
The purpose of this is for a call to _find() on each of them
N) r1 �
_import_stmts� next_siblingr
�SEMI�NEWLINEr0 r2 � simple_stmt�_compound_stmtsr3 )r7 �testZnxtr0 �context�c�pr r r �import_binding_scope� sB
rW c C sD t | �}t ddd�}t |dd�}ttj|||g�}|d ur@||_|S )NrF rG r# )r r r2 �import_as_namer$ )�namerK r$ �new_nameZnew_asZ new_as_name�new_noder r r � ImportAsName� s r\ c C s, | j tjko*t| j�dko*| jd j tjkS )z<
Returns True if the node appears to be a docstring
r )r1 r2 rQ r r@ r
�STRINGr6 r r r � is_docstring� s
��r^ c C s� t |�}td| |�rdS d}t|j�D ]D\}}t|�s>t|�rB|}t|�rLq&t|�}|s\ ql| |v r& dS q&tdt t
j | dd�g�}|dkr�|dkr�|jd j |_ d|jd _ |t
� g}|�|ttj|�� dS )z
This seems to work
�
__future__NrG r# r r/ )r r rA r@ �is_shebang_comment�is_encoding_commentr^ �check_future_importr r
r
�NAMEr$ r � insert_childr r2 rQ )�featurer7 �rootZshebang_encoding_idx�idx�names�import_r@ r r r �
future_import� s(
rj c C s� t |�}td| |�rdS d}t|j�D ]8\}}|jtjkr&|jr&|jd jtjkr&|d } q`q&|j|d� D ]*}|jtj kr�|d7 }qn|j
}d|_
q�qnd}t dt tj
| dd�g�}|t� g}|�|ttj||d�� dS )zD
An alternative to future_import() which might not work ...
r_ Nr r r/ rG r# )r r rA r@ r1 r2 rQ r
r] rP r$ r r
rc r rd r ) re r7 rf �
insert_posrg Z thing_afterr$ ri r@ r r r �future_import2 s* �
rl c C s� dd� | D �} t dd� |D ��}t| �D ]R\}}|jtjkrj|jd jtjkrj|jd j}|jd ||< q(|| }|||< q(|S )z/
Parse a list of arguments into a dict
c S s g | ]}|j tjkr|�qS r )r1 r
�COMMAr: r r r r 2 r z parse_args.<locals>.<listcomp>c S s g | ] }|d f�qS r9 r )r �kr r r r 4 r r r � ) �dictrA r1 r2 �argumentr@ r
�EQUALr5 )Zarglist�schemeZ ret_mappingr; �argZslotr r r �
parse_args. s
ru c C s | j tjko | jo t| jd �S )Nr )r1 r2 rQ r@ r r6 r r r �is_import_stmtH s �rv c C s t |�}t| ||�rdS d}dD ]}td||�r d} q:q |r�d\}}t|j�D ]>\}}t|�rP|}|} |r�|j}| d7 } t|�sh| }q�qh q�qP|dus�J �|dus�J �|}
n4t|j�D ]$\}}|jtjkr� q�t |�s� q�q�|}
g } | du �rt
tj t t
jd�t t
j|d d
�g�} n�t| t t
j|d d
�g�} |d k�r�t
tjt
tjt t
jd �t
tjt t
jd �t t
jd
�g�t
tjt t
jd�t t
jd�g�g�g�}
|
t� g} | t� g}|j|
j}d|j|
_|�|
t
tj||d
�� t| �dk�r�|�|
d t
tj| �� dS )a� Works like `does_tree_import` but adds an import statement at the
top if it was not imported (but below any __future__ imports) and below any
comments such as shebang lines).
Based on lib2to3.fixer_util.touch_import()
Calling this multiple times adds the imports in reverse order.
Also adds "standard_library.install_aliases()" after "from future import
standard_library". This should probably be factored into another function.
NF)�absolute_import�division�print_function�unicode_literalsr_ T)NNr rE rG r# Zstandard_library�.Zinstall_aliases�(�)r/ r )r r rA r@ rb rN r1 r2 rQ r^ r rI r
r
rc r �power�trailer�DOT�LPAR�RPARr r$ rd r )rJ Zname_to_importr7 rf r rY �start�endrg Zidx2rk Zchildren_hooksri Z
install_hooksZchildren_importZ
old_prefixr r r �touch_import_topM sr
�
�
����
r� c C sT | }| j tjkr| js t� S | jd } | j tjkrRt| jd d�rR| jd jdksXt� S | jd j tj krv| jd } n
| jd } | j tj
kr�t� }| jD ]P}|j tj kr�|� |j� q�|j tj
kr�|jd }|j tj ks�J �|� |j� q�|S | j tj
k�r$| jd } | j tj k�sJ �t| jg�S | j tj k�r>t| jg�S d�sPJ d| ��d S )
zZIf this is a future import, return set of symbols that are imported,
else return None.r r r5 r_ � r Fzstrange import: %sN)r1 r2 rQ r@ r< � import_from�hasattrr5 r
r� Zimport_as_namesrc �addrX )r7 Zsavenode�result�nr r r rb � s<
��
rb z ^#!.*pythonz^#.*coding[:=]\s*([-\w.]+)c C s t t�t| j��S )z�
Comments are prefixes for Leaf nodes. Returns whether the given node has a
prefix that looks like a shebang line or an encoding line:
#!/usr/bin/env python
#!/usr/bin/python3
)�bool�re�match�
SHEBANG_REGEXr$ r6 r r r r` � s r` c C s t t�t| j��S )a
Comments are prefixes for Leaf nodes. Returns whether the given node has a
prefix that looks like an encoding line:
# coding: utf-8
# encoding: utf-8
# -*- coding: <encoding name> -*-
# vim: set fileencoding=<encoding name> :
)r� r� r� �ENCODING_REGEXr$ r6 r r r ra � s
ra c C sH t |�dksJ �t |�dkr2|\}}|t� |g}n|}tt| �||d�S )z�
Example:
>>> wrap_in_fn_call("oldstr", (arg,))
oldstr(arg)
>>> wrap_in_fn_call("olddiv", (arg1, arg2))
olddiv(arg1, arg2)
>>> wrap_in_fn_call("olddiv", [arg1, comma, arg2, comma, arg3])
olddiv(arg1, arg2, arg3)
r ro r# )r r r r )�fn_name�argsr$ �expr1Zexpr2Znewargsr r r �wrap_in_fn_call� s r� )N)N)N)NN)N)N)2�__doc__Zlib2to3.fixer_utilr r r r r r r r Zlib2to3.pytreer
r Zlib2to3.pygramr r2 r
r� r! r& r( r+ r. r8 r? rD rL Zif_stmtZ
while_stmtZfor_stmtZtry_stmtZ with_stmtrR rI r� rM rW r\ r^ rj rl ru rv r� rb r� r� r` ra r� r r r r �<module> s<
( "
;
( b)
PK �Au\j��/�C �C libfuturize/fixer_util.pynu �[��� """
Utility functions from 2to3, 3to2 and python-modernize (and some home-grown
ones).
Licences:
2to3: PSF License v2
3to2: Apache Software License (from 3to2/setup.py)
python-modernize licence: BSD (from python-modernize/LICENSE)
"""
from lib2to3.fixer_util import (FromImport, Newline, is_import,
find_root, does_tree_import,
Call, Name, Comma)
from lib2to3.pytree import Leaf, Node
from lib2to3.pygram import python_symbols as syms
from lib2to3.pygram import token
import re
def canonical_fix_name(fix, avail_fixes):
"""
Examples:
>>> canonical_fix_name('fix_wrap_text_literals')
'libfuturize.fixes.fix_wrap_text_literals'
>>> canonical_fix_name('wrap_text_literals')
'libfuturize.fixes.fix_wrap_text_literals'
>>> canonical_fix_name('wrap_te')
ValueError("unknown fixer name")
>>> canonical_fix_name('wrap')
ValueError("ambiguous fixer name")
"""
if ".fix_" in fix:
return fix
else:
if fix.startswith('fix_'):
fix = fix[4:]
# Infer the full module name for the fixer.
# First ensure that no names clash (e.g.
# lib2to3.fixes.fix_blah and libfuturize.fixes.fix_blah):
found = [f for f in avail_fixes
if f.endswith('fix_{0}'.format(fix))]
if len(found) > 1:
raise ValueError("Ambiguous fixer name. Choose a fully qualified "
"module name instead from these:\n" +
"\n".join(" " + myf for myf in found))
elif len(found) == 0:
raise ValueError("Unknown fixer. Use --list-fixes or -l for a list.")
return found[0]
## These functions are from 3to2 by Joe Amenta:
def Star(prefix=None):
return Leaf(token.STAR, u'*', prefix=prefix)
def DoubleStar(prefix=None):
return Leaf(token.DOUBLESTAR, u'**', prefix=prefix)
def Minus(prefix=None):
return Leaf(token.MINUS, u'-', prefix=prefix)
def commatize(leafs):
"""
Accepts/turns: (Name, Name, ..., Name, Name)
Returns/into: (Name, Comma, Name, Comma, ..., Name, Comma, Name)
"""
new_leafs = []
for leaf in leafs:
new_leafs.append(leaf)
new_leafs.append(Comma())
del new_leafs[-1]
return new_leafs
def indentation(node):
"""
Returns the indentation for this node
Iff a node is in a suite, then it has indentation.
"""
while node.parent is not None and node.parent.type != syms.suite:
node = node.parent
if node.parent is None:
return u""
# The first three children of a suite are NEWLINE, INDENT, (some other node)
# INDENT.value contains the indentation for this suite
# anything after (some other node) has the indentation as its prefix.
if node.type == token.INDENT:
return node.value
elif node.prev_sibling is not None and node.prev_sibling.type == token.INDENT:
return node.prev_sibling.value
elif node.prev_sibling is None:
return u""
else:
return node.prefix
def indentation_step(node):
"""
Dirty little trick to get the difference between each indentation level
Implemented by finding the shortest indentation string
(technically, the "least" of all of the indentation strings, but
tabs and spaces mixed won't get this far, so those are synonymous.)
"""
r = find_root(node)
# Collect all indentations into one set.
all_indents = set(i.value for i in r.pre_order() if i.type == token.INDENT)
if not all_indents:
# nothing is indented anywhere, so we get to pick what we want
return u" " # four spaces is a popular convention
else:
return min(all_indents)
def suitify(parent):
"""
Turn the stuff after the first colon in parent's children
into a suite, if it wasn't already
"""
for node in parent.children:
if node.type == syms.suite:
# already in the preferred format, do nothing
return
# One-liners have no suite node, we have to fake one up
for i, node in enumerate(parent.children):
if node.type == token.COLON:
break
else:
raise ValueError(u"No class suite and no ':'!")
# Move everything into a suite node
suite = Node(syms.suite, [Newline(), Leaf(token.INDENT, indentation(node) + indentation_step(node))])
one_node = parent.children[i+1]
one_node.remove()
one_node.prefix = u''
suite.append_child(one_node)
parent.append_child(suite)
def NameImport(package, as_name=None, prefix=None):
"""
Accepts a package (Name node), name to import it as (string), and
optional prefix and returns a node:
import <package> [as <as_name>]
"""
if prefix is None:
prefix = u""
children = [Name(u"import", prefix=prefix), package]
if as_name is not None:
children.extend([Name(u"as", prefix=u" "),
Name(as_name, prefix=u" ")])
return Node(syms.import_name, children)
_compound_stmts = (syms.if_stmt, syms.while_stmt, syms.for_stmt, syms.try_stmt, syms.with_stmt)
_import_stmts = (syms.import_name, syms.import_from)
def import_binding_scope(node):
"""
Generator yields all nodes for which a node (an import_stmt) has scope
The purpose of this is for a call to _find() on each of them
"""
# import_name / import_from are small_stmts
assert node.type in _import_stmts
test = node.next_sibling
# A small_stmt can only be followed by a SEMI or a NEWLINE.
while test.type == token.SEMI:
nxt = test.next_sibling
# A SEMI can only be followed by a small_stmt or a NEWLINE
if nxt.type == token.NEWLINE:
break
else:
yield nxt
# A small_stmt can only be followed by either a SEMI or a NEWLINE
test = nxt.next_sibling
# Covered all subsequent small_stmts after the import_stmt
# Now to cover all subsequent stmts after the parent simple_stmt
parent = node.parent
assert parent.type == syms.simple_stmt
test = parent.next_sibling
while test is not None:
# Yes, this will yield NEWLINE and DEDENT. Deal with it.
yield test
test = test.next_sibling
context = parent.parent
# Recursively yield nodes following imports inside of a if/while/for/try/with statement
if context.type in _compound_stmts:
# import is in a one-liner
c = context
while c.next_sibling is not None:
yield c.next_sibling
c = c.next_sibling
context = context.parent
# Can't chain one-liners on one line, so that takes care of that.
p = context.parent
if p is None:
return
# in a multi-line suite
while p.type in _compound_stmts:
if context.type == syms.suite:
yield context
context = context.next_sibling
if context is None:
context = p.parent
p = context.parent
if p is None:
break
def ImportAsName(name, as_name, prefix=None):
new_name = Name(name)
new_as = Name(u"as", prefix=u" ")
new_as_name = Name(as_name, prefix=u" ")
new_node = Node(syms.import_as_name, [new_name, new_as, new_as_name])
if prefix is not None:
new_node.prefix = prefix
return new_node
def is_docstring(node):
"""
Returns True if the node appears to be a docstring
"""
return (node.type == syms.simple_stmt and
len(node.children) > 0 and node.children[0].type == token.STRING)
def future_import(feature, node):
"""
This seems to work
"""
root = find_root(node)
if does_tree_import(u"__future__", feature, node):
return
# Look for a shebang or encoding line
shebang_encoding_idx = None
for idx, node in enumerate(root.children):
# Is it a shebang or encoding line?
if is_shebang_comment(node) or is_encoding_comment(node):
shebang_encoding_idx = idx
if is_docstring(node):
# skip over docstring
continue
names = check_future_import(node)
if not names:
# not a future statement; need to insert before this
break
if feature in names:
# already imported
return
import_ = FromImport(u'__future__', [Leaf(token.NAME, feature, prefix=" ")])
if shebang_encoding_idx == 0 and idx == 0:
# If this __future__ import would go on the first line,
# detach the shebang / encoding prefix from the current first line.
# and attach it to our new __future__ import node.
import_.prefix = root.children[0].prefix
root.children[0].prefix = u''
# End the __future__ import line with a newline and add a blank line
# afterwards:
children = [import_ , Newline()]
root.insert_child(idx, Node(syms.simple_stmt, children))
def future_import2(feature, node):
"""
An alternative to future_import() which might not work ...
"""
root = find_root(node)
if does_tree_import(u"__future__", feature, node):
return
insert_pos = 0
for idx, node in enumerate(root.children):
if node.type == syms.simple_stmt and node.children and \
node.children[0].type == token.STRING:
insert_pos = idx + 1
break
for thing_after in root.children[insert_pos:]:
if thing_after.type == token.NEWLINE:
insert_pos += 1
continue
prefix = thing_after.prefix
thing_after.prefix = u""
break
else:
prefix = u""
import_ = FromImport(u"__future__", [Leaf(token.NAME, feature, prefix=u" ")])
children = [import_, Newline()]
root.insert_child(insert_pos, Node(syms.simple_stmt, children, prefix=prefix))
def parse_args(arglist, scheme):
u"""
Parse a list of arguments into a dict
"""
arglist = [i for i in arglist if i.type != token.COMMA]
ret_mapping = dict([(k, None) for k in scheme])
for i, arg in enumerate(arglist):
if arg.type == syms.argument and arg.children[1].type == token.EQUAL:
# argument < NAME '=' any >
slot = arg.children[0].value
ret_mapping[slot] = arg.children[2]
else:
slot = scheme[i]
ret_mapping[slot] = arg
return ret_mapping
# def is_import_from(node):
# """Returns true if the node is a statement "from ... import ..."
# """
# return node.type == syms.import_from
def is_import_stmt(node):
return (node.type == syms.simple_stmt and node.children and
is_import(node.children[0]))
def touch_import_top(package, name_to_import, node):
"""Works like `does_tree_import` but adds an import statement at the
top if it was not imported (but below any __future__ imports) and below any
comments such as shebang lines).
Based on lib2to3.fixer_util.touch_import()
Calling this multiple times adds the imports in reverse order.
Also adds "standard_library.install_aliases()" after "from future import
standard_library". This should probably be factored into another function.
"""
root = find_root(node)
if does_tree_import(package, name_to_import, root):
return
# Ideally, we would look for whether futurize --all-imports has been run,
# as indicated by the presence of ``from builtins import (ascii, ...,
# zip)`` -- and, if it has, we wouldn't import the name again.
# Look for __future__ imports and insert below them
found = False
for name in ['absolute_import', 'division', 'print_function',
'unicode_literals']:
if does_tree_import('__future__', name, root):
found = True
break
if found:
# At least one __future__ import. We want to loop until we've seen them
# all.
start, end = None, None
for idx, node in enumerate(root.children):
if check_future_import(node):
start = idx
# Start looping
idx2 = start
while node:
node = node.next_sibling
idx2 += 1
if not check_future_import(node):
end = idx2
break
break
assert start is not None
assert end is not None
insert_pos = end
else:
# No __future__ imports.
# We look for a docstring and insert the new node below that. If no docstring
# exists, just insert the node at the top.
for idx, node in enumerate(root.children):
if node.type != syms.simple_stmt:
break
if not is_docstring(node):
# This is the usual case.
break
insert_pos = idx
children_hooks = []
if package is None:
import_ = Node(syms.import_name, [
Leaf(token.NAME, u"import"),
Leaf(token.NAME, name_to_import, prefix=u" ")
])
else:
import_ = FromImport(package, [Leaf(token.NAME, name_to_import, prefix=u" ")])
if name_to_import == u'standard_library':
# Add:
# standard_library.install_aliases()
# after:
# from future import standard_library
install_hooks = Node(syms.simple_stmt,
[Node(syms.power,
[Leaf(token.NAME, u'standard_library'),
Node(syms.trailer, [Leaf(token.DOT, u'.'),
Leaf(token.NAME, u'install_aliases')]),
Node(syms.trailer, [Leaf(token.LPAR, u'('),
Leaf(token.RPAR, u')')])
])
]
)
children_hooks = [install_hooks, Newline()]
# FromImport(package, [Leaf(token.NAME, name_to_import, prefix=u" ")])
children_import = [import_, Newline()]
old_prefix = root.children[insert_pos].prefix
root.children[insert_pos].prefix = u''
root.insert_child(insert_pos, Node(syms.simple_stmt, children_import, prefix=old_prefix))
if len(children_hooks) > 0:
root.insert_child(insert_pos + 1, Node(syms.simple_stmt, children_hooks))
## The following functions are from python-modernize by Armin Ronacher:
# (a little edited).
def check_future_import(node):
"""If this is a future import, return set of symbols that are imported,
else return None."""
# node should be the import statement here
savenode = node
if not (node.type == syms.simple_stmt and node.children):
return set()
node = node.children[0]
# now node is the import_from node
if not (node.type == syms.import_from and
# node.type == token.NAME and # seems to break it
hasattr(node.children[1], 'value') and
node.children[1].value == u'__future__'):
return set()
if node.children[3].type == token.LPAR:
node = node.children[4]
else:
node = node.children[3]
# now node is the import_as_name[s]
if node.type == syms.import_as_names:
result = set()
for n in node.children:
if n.type == token.NAME:
result.add(n.value)
elif n.type == syms.import_as_name:
n = n.children[0]
assert n.type == token.NAME
result.add(n.value)
return result
elif node.type == syms.import_as_name:
node = node.children[0]
assert node.type == token.NAME
return set([node.value])
elif node.type == token.NAME:
return set([node.value])
else:
# TODO: handle brackets like this:
# from __future__ import (absolute_import, division)
assert False, "strange import: %s" % savenode
SHEBANG_REGEX = r'^#!.*python'
ENCODING_REGEX = r"^#.*coding[:=]\s*([-\w.]+)"
def is_shebang_comment(node):
"""
Comments are prefixes for Leaf nodes. Returns whether the given node has a
prefix that looks like a shebang line or an encoding line:
#!/usr/bin/env python
#!/usr/bin/python3
"""
return bool(re.match(SHEBANG_REGEX, node.prefix))
def is_encoding_comment(node):
"""
Comments are prefixes for Leaf nodes. Returns whether the given node has a
prefix that looks like an encoding line:
# coding: utf-8
# encoding: utf-8
# -*- coding: <encoding name> -*-
# vim: set fileencoding=<encoding name> :
"""
return bool(re.match(ENCODING_REGEX, node.prefix))
def wrap_in_fn_call(fn_name, args, prefix=None):
"""
Example:
>>> wrap_in_fn_call("oldstr", (arg,))
oldstr(arg)
>>> wrap_in_fn_call("olddiv", (arg1, arg2))
olddiv(arg1, arg2)
>>> wrap_in_fn_call("olddiv", [arg1, comma, arg2, comma, arg3])
olddiv(arg1, arg2, arg3)
"""
assert len(args) > 0
if len(args) == 2:
expr1, expr2 = args
newargs = [expr1, Comma(), expr2]
else:
newargs = args
return Call(Name(fn_name), newargs, prefix=prefix)
PK �Au\�BPs�5 �5 libfuturize/main.pynu �[��� """
futurize: automatic conversion to clean 2/3 code using ``python-future``
======================================================================
Like Armin Ronacher's modernize.py, ``futurize`` attempts to produce clean
standard Python 3 code that runs on both Py2 and Py3.
One pass
--------
Use it like this on Python 2 code:
$ futurize --verbose mypython2script.py
This will attempt to port the code to standard Py3 code that also
provides Py2 compatibility with the help of the right imports from
``future``.
To write changes to the files, use the -w flag.
Two stages
----------
The ``futurize`` script can also be called in two separate stages. First:
$ futurize --stage1 mypython2script.py
This produces more modern Python 2 code that is not yet compatible with Python
3. The tests should still run and the diff should be uncontroversial to apply to
most Python projects that are willing to drop support for Python 2.5 and lower.
After this, the recommended approach is to explicitly mark all strings that must
be byte-strings with a b'' prefix and all text (unicode) strings with a u''
prefix, and then invoke the second stage of Python 2 to 2/3 conversion with::
$ futurize --stage2 mypython2script.py
Stage 2 adds a dependency on ``future``. It converts most remaining Python
2-specific code to Python 3 code and adds appropriate imports from ``future``
to restore Py2 support.
The command above leaves all unadorned string literals as native strings
(byte-strings on Py2, unicode strings on Py3). If instead you would like all
unadorned string literals to be promoted to unicode, you can also pass this
flag:
$ futurize --stage2 --unicode-literals mypython2script.py
This adds the declaration ``from __future__ import unicode_literals`` to the
top of each file, which implicitly declares all unadorned string literals to be
unicode strings (``unicode`` on Py2).
All imports
-----------
The --all-imports option forces adding all ``__future__`` imports,
``builtins`` imports, and standard library aliases, even if they don't
seem necessary for the current state of each module. (This can simplify
testing, and can reduce the need to think about Py2 compatibility when editing
the code further.)
"""
from __future__ import (absolute_import, print_function, unicode_literals)
import future.utils
from future import __version__
import sys
import logging
import optparse
import os
from lib2to3.main import warn, StdoutRefactoringTool
from lib2to3 import refactor
from libfuturize.fixes import (lib2to3_fix_names_stage1,
lib2to3_fix_names_stage2,
libfuturize_fix_names_stage1,
libfuturize_fix_names_stage2)
fixer_pkg = 'libfuturize.fixes'
def main(args=None):
"""Main program.
Args:
fixer_pkg: the name of a package where the fixers are located.
args: optional; a list of command line arguments. If omitted,
sys.argv[1:] is used.
Returns a suggested exit status (0, 1, 2).
"""
# Set up option parser
parser = optparse.OptionParser(usage="futurize [options] file|dir ...")
parser.add_option("-V", "--version", action="store_true",
help="Report the version number of futurize")
parser.add_option("-a", "--all-imports", action="store_true",
help="Add all __future__ and future imports to each module")
parser.add_option("-1", "--stage1", action="store_true",
help="Modernize Python 2 code only; no compatibility with Python 3 (or dependency on ``future``)")
parser.add_option("-2", "--stage2", action="store_true",
help="Take modernized (stage1) code and add a dependency on ``future`` to provide Py3 compatibility.")
parser.add_option("-0", "--both-stages", action="store_true",
help="Apply both stages 1 and 2")
parser.add_option("-u", "--unicode-literals", action="store_true",
help="Add ``from __future__ import unicode_literals`` to implicitly convert all unadorned string literals '' into unicode strings")
parser.add_option("-f", "--fix", action="append", default=[],
help="Each FIX specifies a transformation; default: all.\nEither use '-f division -f metaclass' etc. or use the fully-qualified module name: '-f lib2to3.fixes.fix_types -f libfuturize.fixes.fix_unicode_keep_u'")
parser.add_option("-j", "--processes", action="store", default=1,
type="int", help="Run 2to3 concurrently")
parser.add_option("-x", "--nofix", action="append", default=[],
help="Prevent a fixer from being run.")
parser.add_option("-l", "--list-fixes", action="store_true",
help="List available transformations")
parser.add_option("-p", "--print-function", action="store_true",
help="Modify the grammar so that print() is a function")
parser.add_option("-v", "--verbose", action="store_true",
help="More verbose logging")
parser.add_option("--no-diffs", action="store_true",
help="Don't show diffs of the refactoring")
parser.add_option("-w", "--write", action="store_true",
help="Write back modified files")
parser.add_option("-n", "--nobackups", action="store_true", default=False,
help="Don't write backups for modified files.")
parser.add_option("-o", "--output-dir", action="store", type="str",
default="", help="Put output files in this directory "
"instead of overwriting the input files. Requires -n. "
"For Python >= 2.7 only.")
parser.add_option("-W", "--write-unchanged-files", action="store_true",
help="Also write files even if no changes were required"
" (useful with --output-dir); implies -w.")
parser.add_option("--add-suffix", action="store", type="str", default="",
help="Append this string to all output filenames."
" Requires -n if non-empty. For Python >= 2.7 only."
"ex: --add-suffix='3' will generate .py3 files.")
# Parse command line arguments
flags = {}
refactor_stdin = False
options, args = parser.parse_args(args)
if options.write_unchanged_files:
flags["write_unchanged_files"] = True
if not options.write:
warn("--write-unchanged-files/-W implies -w.")
options.write = True
# If we allowed these, the original files would be renamed to backup names
# but not replaced.
if options.output_dir and not options.nobackups:
parser.error("Can't use --output-dir/-o without -n.")
if options.add_suffix and not options.nobackups:
parser.error("Can't use --add-suffix without -n.")
if not options.write and options.no_diffs:
warn("not writing files and not printing diffs; that's not very useful")
if not options.write and options.nobackups:
parser.error("Can't use -n without -w")
if "-" in args:
refactor_stdin = True
if options.write:
print("Can't write to stdin.", file=sys.stderr)
return 2
# Is this ever necessary?
if options.print_function:
flags["print_function"] = True
# Set up logging handler
level = logging.DEBUG if options.verbose else logging.INFO
logging.basicConfig(format='%(name)s: %(message)s', level=level)
logger = logging.getLogger('libfuturize.main')
if options.stage1 or options.stage2:
assert options.both_stages is None
options.both_stages = False
else:
options.both_stages = True
avail_fixes = set()
if options.stage1 or options.both_stages:
avail_fixes.update(lib2to3_fix_names_stage1)
avail_fixes.update(libfuturize_fix_names_stage1)
if options.stage2 or options.both_stages:
avail_fixes.update(lib2to3_fix_names_stage2)
avail_fixes.update(libfuturize_fix_names_stage2)
if options.unicode_literals:
avail_fixes.add('libfuturize.fixes.fix_unicode_literals_import')
if options.version:
print(__version__)
return 0
if options.list_fixes:
print("Available transformations for the -f/--fix option:")
# for fixname in sorted(refactor.get_all_fix_names(fixer_pkg)):
for fixname in sorted(avail_fixes):
print(fixname)
if not args:
return 0
if not args:
print("At least one file or directory argument required.",
file=sys.stderr)
print("Use --help to show usage.", file=sys.stderr)
return 2
unwanted_fixes = set()
for fix in options.nofix:
if ".fix_" in fix:
unwanted_fixes.add(fix)
else:
# Infer the full module name for the fixer.
# First ensure that no names clash (e.g.
# lib2to3.fixes.fix_blah and libfuturize.fixes.fix_blah):
found = [f for f in avail_fixes
if f.endswith('fix_{0}'.format(fix))]
if len(found) > 1:
print("Ambiguous fixer name. Choose a fully qualified "
"module name instead from these:\n" +
"\n".join(" " + myf for myf in found),
file=sys.stderr)
return 2
elif len(found) == 0:
print("Unknown fixer. Use --list-fixes or -l for a list.",
file=sys.stderr)
return 2
unwanted_fixes.add(found[0])
extra_fixes = set()
if options.all_imports:
if options.stage1:
prefix = 'libfuturize.fixes.'
extra_fixes.add(prefix +
'fix_add__future__imports_except_unicode_literals')
else:
# In case the user hasn't run stage1 for some reason:
prefix = 'libpasteurize.fixes.'
extra_fixes.add(prefix + 'fix_add_all__future__imports')
extra_fixes.add(prefix + 'fix_add_future_standard_library_import')
extra_fixes.add(prefix + 'fix_add_all_future_builtins')
explicit = set()
if options.fix:
all_present = False
for fix in options.fix:
if fix == 'all':
all_present = True
else:
if ".fix_" in fix:
explicit.add(fix)
else:
# Infer the full module name for the fixer.
# First ensure that no names clash (e.g.
# lib2to3.fixes.fix_blah and libfuturize.fixes.fix_blah):
found = [f for f in avail_fixes
if f.endswith('fix_{0}'.format(fix))]
if len(found) > 1:
print("Ambiguous fixer name. Choose a fully qualified "
"module name instead from these:\n" +
"\n".join(" " + myf for myf in found),
file=sys.stderr)
return 2
elif len(found) == 0:
print("Unknown fixer. Use --list-fixes or -l for a list.",
file=sys.stderr)
return 2
explicit.add(found[0])
if len(explicit & unwanted_fixes) > 0:
print("Conflicting usage: the following fixers have been "
"simultaneously requested and disallowed:\n" +
"\n".join(" " + myf for myf in (explicit & unwanted_fixes)),
file=sys.stderr)
return 2
requested = avail_fixes.union(explicit) if all_present else explicit
else:
requested = avail_fixes.union(explicit)
fixer_names = (requested | extra_fixes) - unwanted_fixes
input_base_dir = os.path.commonprefix(args)
if (input_base_dir and not input_base_dir.endswith(os.sep)
and not os.path.isdir(input_base_dir)):
# One or more similar names were passed, their directory is the base.
# os.path.commonprefix() is ignorant of path elements, this corrects
# for that weird API.
input_base_dir = os.path.dirname(input_base_dir)
if options.output_dir:
input_base_dir = input_base_dir.rstrip(os.sep)
logger.info('Output in %r will mirror the input directory %r layout.',
options.output_dir, input_base_dir)
# Initialize the refactoring tool
if future.utils.PY26:
extra_kwargs = {}
else:
extra_kwargs = {
'append_suffix': options.add_suffix,
'output_dir': options.output_dir,
'input_base_dir': input_base_dir,
}
rt = StdoutRefactoringTool(
sorted(fixer_names), flags, sorted(explicit),
options.nobackups, not options.no_diffs,
**extra_kwargs)
# Refactor all files and directories passed as arguments
if not rt.errors:
if refactor_stdin:
rt.refactor_stdin()
else:
try:
rt.refactor(args, options.write, None,
options.processes)
except refactor.MultiprocessingUnsupported:
assert options.processes > 1
print("Sorry, -j isn't " \
"supported on this platform.", file=sys.stderr)
return 1
rt.summarize()
# Return error status (0 if rt.errors is zero)
return int(bool(rt.errors))
PK �Au\ future/tests/__init__.pynu �[��� PK �Au\�:�x� � 0 future/tests/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �?/usr/local/lib/python3.9/site-packages/future/tests/__init__.py�<module> � PK �Au\�o�A A , future/tests/__pycache__/base.cpython-39.pycnu �[��� a
��?h�M � @ s� d dl mZmZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
m Z d dl m
Z
mZmZmZmZ d dlmZmZmZ er�d dlZdd� Zdd � ZG d
d � d e�ZG d d
� d
e�ZG dd� de�ZG dd� dej �Z e� ed�Z dd� Z dd� Z!dd� Z"dd� Z#e$ej d��s(ej j%ej _&d$d d �Z'e$ej d ��sNe
ej d e'� G d d � d e(�Z)G d d!� d!e)�Z*d%d"d#�Z+e$ej d#��s�e
ej d#e+� dS )&� )�print_function�absolute_importN)�dedent)� bind_method�PY26�PY3�PY2�PY27)� check_output�STDOUT�CalledProcessErrorc C s | � d�r| dd� } t| �S )z,
Removes any leading
and dedents.
�
� N)�
startswithr )�code� r �;/usr/local/lib/python3.9/site-packages/future/tests/base.py�
reformat_code s
r c sd | � d�� dd� t� �D �}dd� t� �D �}dd� t� �D �}| �� | ksTJ d��dd� }d d
� }||�||�ks|J d ��t� fd d�|D ��}tt||��}t� fd
d�|D ��}tt||��} t� fdd�|D ��}
tt||
��} g } tt� ��D ]`}
|
|v �r| �||
� q�|
|v �r0| �| |
� q�|
|v �rJ| �| |
� q�| �� |
� q�d� | �S )a
Returns the code block with any ``__future__`` import lines sorted, and
then any ``future`` import lines sorted, then any ``builtins`` import lines
sorted.
This only sorts the lines within the expected blocks.
See test_order_future_lines() for an example.
r
c S s g | ]\}}|� d �r|�qS )�from __future__ import �r ��.0�i�liner r r �
<listcomp>* s
�z&order_future_lines.<locals>.<listcomp>c S s( g | ] \}}|� d �s |� d�r|�qS )z from futurez from pastr r r r r r - s
�c S s g | ]\}}|� d �r|�qS )z
from builtinsr r r r r r 1 s
�zIinternal usage error: dedent the code before calling order_future_lines()c S s t | �dkrt| �S dS )Nr )�len�max�Znumbersr r r �mymax7 s z!order_future_lines.<locals>.mymaxc S s t | �dkrt| �S td�S )Nr �inf)r �min�floatr r r r �mymin: s z!order_future_lines.<locals>.myminz2the __future__ and future imports are out of orderc s g | ] }� | �qS r r �r r ��linesr r r C � c s g | ] }� | �qS r r r# r$ r r r F r& c s g | ] }� | �qS r r r# r$ r r r I r& )
�split� enumerate�lstrip�sorted�dict�zip�ranger �append�join)r Zuufuture_line_numbersZfuture_line_numbersZbuiltins_line_numbersr r" ZuulZsorted_uufuture_lines�flZsorted_future_lines�blZsorted_builtins_lines� new_linesr r r$ r �order_future_lines s4
�
r3 c @ s" e Zd ZdZddd�Zdd� ZdS )�VerboseCalledProcessErrorz�
Like CalledProcessError, but it displays more information (message and
script output) for diagnosing test failures etc.
Nc C s || _ || _|| _|| _d S �N)�msg�
returncode�cmd�output)�selfr6 r7 r8 r9 r r r �__init__` s z"VerboseCalledProcessError.__init__c C s d| j | j| j| jf S )Nz>Command '%s' failed with exit status %d
Message: %s
Output: %s)r8 r7 r6 r9 )r: r r r �__str__f s �z!VerboseCalledProcessError.__str__)N)�__name__�
__module__� __qualname__�__doc__r; r< r r r r r4 [ s
r4 c @ s e Zd ZdS )�
FuturizeErrorN�r= r> r? r r r r rA j s rA c @ s e Zd ZdS )�PasteurizeErrorNrB r r r r rC m s rC c @ st e Zd ZdZdd� Zddd�Zd d d
�Zd d � Zd d
d�Zdd� Z d dd�Z
d dd�Z d dd�Z de
jfdd�ZdS )!� CodeHandlerzt
Handy mixin for test classes for writing / reading / futurizing /
running .py files in the test suite.
c C sj t d�| _t d�| _tjg| _t�� tj j
| _ t� d�}|rXdt�
� tj | i| _ndt�
� i| _dS )zi
The outputs from the various futurize stages should have the
following headers:
z�
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
a4
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
from future import standard_library
standard_library.install_aliases()
from builtins import *
�
PYTHONPATHN)r �headers1�headers2�sys�
executable� interpreters�tempfile�mkdtemp�os�path�sep�tempdir�getenv�getcwd�pathsep�env)r: Zpypathr r r �setUpv s
zCodeHandler.setUp�r � FTc C sP |r t |�}| �|� | j||||d� | �� }|rL| jD ]} | j| d�}
q:|S )a�
Converts the code block using ``futurize`` and returns the
resulting code.
Passing stages=[1] or stages=[2] passes the flag ``--stage1`` or
``stage2`` to ``futurize``. Passing both stages runs ``futurize``
with both stages by default.
If from3 is False, runs ``futurize``, converting from Python 2 to
both 2 and 3. If from3 is True, runs ``pasteurize`` to convert
from Python 3 to both 2 and 3.
Optionally reformats the code block first using the reformat() function.
If run is True, runs the resulting code under all Python
interpreters in self.interpreters.
)�stages� all_imports�from3� conservative)� interpreter)r �_write_test_script�_futurize_test_script�_read_test_scriptrJ �_run_test_script) r: r rX rY rZ Zreformat�runr[ r9 r\ �_r r r �convert� s
�
zCodeHandler.convertc C sp |r| � |�}| � |�}t|t�r6t|t�s6|�d�}t|t�rTt|t�sT|�d�}| �t|�� �|�� � dS )a�
Compares whether the code blocks are equal. If not, raises an
exception so the test fails. Ignores any trailing whitespace like
blank lines.
If ignore_imports is True, passes the code blocks into the
strip_future_imports method.
If one code block is a unicode string and the other a
byte-string, it assumes the byte-string is encoded as utf-8.
�utf-8N)�strip_future_imports�
isinstance�bytes�decode� assertEqualr3 �rstrip)r: r9 �expected�ignore_importsr r r �compare� s
�zCodeHandler.comparec C s` g }|� d�D ]F}|�d�s|�d�s|�d�sd|v sd|v s|�d�s|�|� qd�|�S )a
Strips any of these import lines:
from __future__ import <anything>
from future <anything>
from future.<anything>
from builtins <anything>
or any line containing:
install_hooks()
or:
install_aliases()
Limitation: doesn't handle imports split across multiple lines like
this:
from __future__ import (absolute_import, division, print_function,
unicode_literals)
r
r z from future zfrom builtins zinstall_hooks()zinstall_aliases()z from future.)r' r r. r/ )r: r r9 r r r r re � s
����� z CodeHandler.strip_future_importsc C s` | j ||||||d�} |r0d|v r(| jn| j}
nd}
t|�} |
| v rHd}
| j| |
| |d� dS )a<
Convenience method that calls convert() and compare().
Reformats the code blocks automatically using the reformat_code()
function.
If all_imports is passed, we add the appropriate import headers
for the stage(s) selected to the ``expected`` code-block, so they
needn't appear repeatedly in the test code.
If ignore_imports is True, ignores the presence of any lines
beginning:
from __future__ import ...
from future import ...
for the purpose of the comparison.
)rX rY rZ ra r[ rW � )rl N)rc rG rF r rm ) r: �beforerk rX rY rl rZ ra r[ r9 �headersZ reformattedr r r �
convert_check� s
� �zCodeHandler.convert_checkc K s | j ||fi |�� dS )ze
Convenience method to ensure the code is unchanged by the
futurize process.
N)rq )r: r �kwargsr r r � unchanged s zCodeHandler.unchanged�mytestscript.pyc C s\ t |t�r|�d�}tj| j| ddd�� }|�t|�� W d � n1 sN0 Y dS )z�
Dedents the given code (a multiline string) and writes it out to
a file in a temporary folder like /tmp/tmpUDCn7x/mytestscript.py.
rd �wt��encodingN)rf rg rh �io�openrP �writer )r: r �filename�fr r r r] ! s
z CodeHandler._write_test_scriptc C sB t j| j| ddd��}|�� }W d � n1 s40 Y |S )N�rtrd rv )rx ry rP �read)r: r{ r| Z newsourcer r r r_ , s &z CodeHandler._read_test_scriptc C sX g }t |�}|r|�d� |r$d}nNd}|dgkr>|�d� n&|dgkrT|�d� n|ddgksdJ �|rr|�d� | j| }tj|g| d |g } zt| t| jd
�}
W n� t�yR } z�t |��4} d d �
| �d
| j |d| � � f }
W d � n1 s�0 Y d|v �rt nt
}t| d��s(d | _||
| j| j| jd��W Y d } ~ n
d } ~ 0 0 |
S )Nz
--all-importsz
pasteurize.pyz futurize.pyr z--stage1rW z--stage2z--conservativez-w)�stderrrT �8Error running the command %s
%s
Contents of file %s:
%s� �env=%s� ----
%s
----Zfuturizer9 �r9 )�listr. rP rH rI r
r rT r ry r/ r~ rA rC �hasattrr9 r7 r8 )r: r{ rX rY rZ r[ �params�script�fnZ call_argsr9 �er| r6 Z
ErrorClassr r r r^ 1 s@
��" ,z!CodeHandler._futurize_test_scriptc C s� | j | }zt||g| jtd�}W n� ty� } z�t|��8}dd�||g�d| j |d|�� f }W d � n1 sx0 Y t|d�s�d |_ t
||j |j |j d��W Y d }~n
d }~0 0 |S )N)rT r r� r� r� r� r9 r� )
rP r
rT r r ry r/ r~ r� r9 r4 r7 r8 )r: r{ r\ r� r9 r� r| r6 r r r r` ` s$
�
��"
,z CodeHandler._run_test_scriptN)rV FFTTF)T)rV FTFTF)rt )rt )rt rV FFF)r= r> r? r@ rU rc rm re rq rs r] r_ r^ rH rI r` r r r r rD q s* + �
" �
#
�
/�rD z#this test is known to fail on Py2.6c C s t s| S t�| �S r5 )r �unittest�expectedFailure��funcr r r �expectedFailurePY3 s r� c C s t s| S t�| �S r5 )r r� r� r� r r r �expectedFailurePY26� s r� c C s t s| S t�| �S r5 )r r� r� r� r r r �expectedFailurePY27� s r� c C s t s| S t�| �S r5 )r r� r� r� r r r �expectedFailurePY2� s r� �assertRaisesRegexc C sT t |ttf�r$|sJ d��t�|�}|�|�sP|p4d}d||j|f }| �|��dS )z=Fail the test unless the text matches the regular expression.z!expected_regex must not be empty.zRegex didn't matchz%s: %r not found in %rN)rf �str�unicode�re�compile�search�pattern�failureException)r: �text�expected_regexr6 r r r � assertRegex� s
r� c @ s& e Zd Zddd�Zdd� Zdd� ZdS ) �_AssertRaisesBaseContextNc C sn || _ || _|d ur@z |j| _W qF ty< t|�| _Y qF0 nd | _t|ttf�r^t� |�}|| _
d | _ d S r5 ) rk � test_caser= �obj_name�AttributeErrorr� rf rg r� r� r� r6 )r: rk r� � callable_objr� r r r r; � s
z!_AssertRaisesBaseContext.__init__c C s | j �| j|�}| j �|��d S r5 )r� Z_formatMessager6 r� )r: Z standardMsgr6 r r r �
_raiseFailure� s z&_AssertRaisesBaseContext._raiseFailurec C sP |du r|� dd�| _| S | � ||i |�� W d � n1 sB0 Y dS )z�
If callable_obj is None, assertRaises/Warns is being used as a
context manager, so check for a 'msg' kwarg and return self.
If callable_obj is not None, call it passing args and kwargs.
Nr6 )�popr6 )r: �namer� �argsrr r r r �handle� s
z _AssertRaisesBaseContext.handle)NN)r= r> r? r; r� r� r r r r r� � s
�
r� c @ s e Zd ZdZdd� Zdd� ZdS )�_AssertWarnsContextzBA context manager used to implement TestCase.assertWarns* methods.c C sN t j�� D ]}t|dd �r
i |_q
tjdd�| _| j�� | _t� d| j
� | S )N�__warningregistry__T)�record�always) rH �modules�values�getattrr� �warnings�catch_warnings�warnings_manager� __enter__� simplefilterrk )r: �vr r r r� � s z _AssertWarnsContext.__enter__c C s� | j �|||� |d ur d S z | jj}W n tyD t| j�}Y n0 d }| jD ]Z}|j}t|| j�shqP|d u rt|}| j d ur�| j �
t|��s�qP|| _ |j | _ |j
| _
d S |d ur�| �d�| j jt|��� | jr�| �d�|| j�� n| �d�|�� d S )Nz"{}" does not match "{}"z{} not triggered by {}z{} not triggered)r� �__exit__rk r= r� r� r� �messagerf r� r� �warningr{ �linenor� �formatr� r� )r: �exc_type� exc_value�tbZexc_nameZfirst_matching�m�wr r r r� � s>
� �
�z _AssertWarnsContext.__exit__N)r= r> r? r@ r� r� r r r r r� � s r� c O s t || |�}|�d|||�S )a� Fail unless a warning of class warnClass is triggered
by callable_obj when invoked with arguments args and keyword
arguments kwargs. If a different type of warning is
triggered, it will not be handled: depending on the other
warning filtering rules in effect, it might be silenced, printed
out, or raised as an exception.
If called with callable_obj omitted or None, will return a
context object used like this::
with self.assertWarns(SomeWarning):
do_something()
An optional keyword argument 'msg' can be provided when assertWarns
is used as a context object.
The context manager keeps a reference to the first matching
warning as the 'warning' attribute; similarly, the 'filename'
and 'lineno' attributes give you information about the line
of Python code from which the warning was triggered.
This allows you to inspect the warning after the assertion::
with self.assertWarns(SomeWarning) as cm:
do_something()
the_warning = cm.warning
self.assertEqual(the_warning.some_attribute, 147)
� assertWarns)r� r� )r: Zexpected_warningr� r� rr �contextr r r r� � s r� )N)N),�
__future__r r rM rK r� rH r� r� rx �textwrapr Z future.utilsr r r r r Zfuture.moves.subprocessr
r r Z unittest2r r3 r4 rA rC ZTestCaserD ZskipIfZskip26r� r� r� r� r� ZassertRaisesRegexpr� r� �objectr� r� r� r r r r �<module> sF @
"1
PK �Au\t�{��M �M future/tests/base.pynu �[��� from __future__ import print_function, absolute_import
import os
import tempfile
import unittest
import sys
import re
import warnings
import io
from textwrap import dedent
from future.utils import bind_method, PY26, PY3, PY2, PY27
from future.moves.subprocess import check_output, STDOUT, CalledProcessError
if PY26:
import unittest2 as unittest
def reformat_code(code):
"""
Removes any leading \n and dedents.
"""
if code.startswith('\n'):
code = code[1:]
return dedent(code)
def order_future_lines(code):
"""
Returns the code block with any ``__future__`` import lines sorted, and
then any ``future`` import lines sorted, then any ``builtins`` import lines
sorted.
This only sorts the lines within the expected blocks.
See test_order_future_lines() for an example.
"""
# We need .splitlines(keepends=True), which doesn't exist on Py2,
# so we use this instead:
lines = code.split('\n')
uufuture_line_numbers = [i for i, line in enumerate(lines)
if line.startswith('from __future__ import ')]
future_line_numbers = [i for i, line in enumerate(lines)
if line.startswith('from future')
or line.startswith('from past')]
builtins_line_numbers = [i for i, line in enumerate(lines)
if line.startswith('from builtins')]
assert code.lstrip() == code, ('internal usage error: '
'dedent the code before calling order_future_lines()')
def mymax(numbers):
return max(numbers) if len(numbers) > 0 else 0
def mymin(numbers):
return min(numbers) if len(numbers) > 0 else float('inf')
assert mymax(uufuture_line_numbers) <= mymin(future_line_numbers), \
'the __future__ and future imports are out of order'
# assert mymax(future_line_numbers) <= mymin(builtins_line_numbers), \
# 'the future and builtins imports are out of order'
uul = sorted([lines[i] for i in uufuture_line_numbers])
sorted_uufuture_lines = dict(zip(uufuture_line_numbers, uul))
fl = sorted([lines[i] for i in future_line_numbers])
sorted_future_lines = dict(zip(future_line_numbers, fl))
bl = sorted([lines[i] for i in builtins_line_numbers])
sorted_builtins_lines = dict(zip(builtins_line_numbers, bl))
# Replace the old unsorted "from __future__ import ..." lines with the
# new sorted ones:
new_lines = []
for i in range(len(lines)):
if i in uufuture_line_numbers:
new_lines.append(sorted_uufuture_lines[i])
elif i in future_line_numbers:
new_lines.append(sorted_future_lines[i])
elif i in builtins_line_numbers:
new_lines.append(sorted_builtins_lines[i])
else:
new_lines.append(lines[i])
return '\n'.join(new_lines)
class VerboseCalledProcessError(CalledProcessError):
"""
Like CalledProcessError, but it displays more information (message and
script output) for diagnosing test failures etc.
"""
def __init__(self, msg, returncode, cmd, output=None):
self.msg = msg
self.returncode = returncode
self.cmd = cmd
self.output = output
def __str__(self):
return ("Command '%s' failed with exit status %d\nMessage: %s\nOutput: %s"
% (self.cmd, self.returncode, self.msg, self.output))
class FuturizeError(VerboseCalledProcessError):
pass
class PasteurizeError(VerboseCalledProcessError):
pass
class CodeHandler(unittest.TestCase):
"""
Handy mixin for test classes for writing / reading / futurizing /
running .py files in the test suite.
"""
def setUp(self):
"""
The outputs from the various futurize stages should have the
following headers:
"""
# After stage1:
# TODO: use this form after implementing a fixer to consolidate
# __future__ imports into a single line:
# self.headers1 = """
# from __future__ import absolute_import, division, print_function
# """
self.headers1 = reformat_code("""
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
""")
# After stage2 --all-imports:
# TODO: use this form after implementing a fixer to consolidate
# __future__ imports into a single line:
# self.headers2 = """
# from __future__ import (absolute_import, division,
# print_function, unicode_literals)
# from future import standard_library
# from future.builtins import *
# """
self.headers2 = reformat_code("""
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
from future import standard_library
standard_library.install_aliases()
from builtins import *
""")
self.interpreters = [sys.executable]
self.tempdir = tempfile.mkdtemp() + os.path.sep
pypath = os.getenv('PYTHONPATH')
if pypath:
self.env = {'PYTHONPATH': os.getcwd() + os.pathsep + pypath}
else:
self.env = {'PYTHONPATH': os.getcwd()}
def convert(self, code, stages=(1, 2), all_imports=False, from3=False,
reformat=True, run=True, conservative=False):
"""
Converts the code block using ``futurize`` and returns the
resulting code.
Passing stages=[1] or stages=[2] passes the flag ``--stage1`` or
``stage2`` to ``futurize``. Passing both stages runs ``futurize``
with both stages by default.
If from3 is False, runs ``futurize``, converting from Python 2 to
both 2 and 3. If from3 is True, runs ``pasteurize`` to convert
from Python 3 to both 2 and 3.
Optionally reformats the code block first using the reformat() function.
If run is True, runs the resulting code under all Python
interpreters in self.interpreters.
"""
if reformat:
code = reformat_code(code)
self._write_test_script(code)
self._futurize_test_script(stages=stages, all_imports=all_imports,
from3=from3, conservative=conservative)
output = self._read_test_script()
if run:
for interpreter in self.interpreters:
_ = self._run_test_script(interpreter=interpreter)
return output
def compare(self, output, expected, ignore_imports=True):
"""
Compares whether the code blocks are equal. If not, raises an
exception so the test fails. Ignores any trailing whitespace like
blank lines.
If ignore_imports is True, passes the code blocks into the
strip_future_imports method.
If one code block is a unicode string and the other a
byte-string, it assumes the byte-string is encoded as utf-8.
"""
if ignore_imports:
output = self.strip_future_imports(output)
expected = self.strip_future_imports(expected)
if isinstance(output, bytes) and not isinstance(expected, bytes):
output = output.decode('utf-8')
if isinstance(expected, bytes) and not isinstance(output, bytes):
expected = expected.decode('utf-8')
self.assertEqual(order_future_lines(output.rstrip()),
expected.rstrip())
def strip_future_imports(self, code):
"""
Strips any of these import lines:
from __future__ import <anything>
from future <anything>
from future.<anything>
from builtins <anything>
or any line containing:
install_hooks()
or:
install_aliases()
Limitation: doesn't handle imports split across multiple lines like
this:
from __future__ import (absolute_import, division, print_function,
unicode_literals)
"""
output = []
# We need .splitlines(keepends=True), which doesn't exist on Py2,
# so we use this instead:
for line in code.split('\n'):
if not (line.startswith('from __future__ import ')
or line.startswith('from future ')
or line.startswith('from builtins ')
or 'install_hooks()' in line
or 'install_aliases()' in line
# but don't match "from future_builtins" :)
or line.startswith('from future.')):
output.append(line)
return '\n'.join(output)
def convert_check(self, before, expected, stages=(1, 2), all_imports=False,
ignore_imports=True, from3=False, run=True,
conservative=False):
"""
Convenience method that calls convert() and compare().
Reformats the code blocks automatically using the reformat_code()
function.
If all_imports is passed, we add the appropriate import headers
for the stage(s) selected to the ``expected`` code-block, so they
needn't appear repeatedly in the test code.
If ignore_imports is True, ignores the presence of any lines
beginning:
from __future__ import ...
from future import ...
for the purpose of the comparison.
"""
output = self.convert(before, stages=stages, all_imports=all_imports,
from3=from3, run=run, conservative=conservative)
if all_imports:
headers = self.headers2 if 2 in stages else self.headers1
else:
headers = ''
reformatted = reformat_code(expected)
if headers in reformatted:
headers = ''
self.compare(output, headers + reformatted,
ignore_imports=ignore_imports)
def unchanged(self, code, **kwargs):
"""
Convenience method to ensure the code is unchanged by the
futurize process.
"""
self.convert_check(code, code, **kwargs)
def _write_test_script(self, code, filename='mytestscript.py'):
"""
Dedents the given code (a multiline string) and writes it out to
a file in a temporary folder like /tmp/tmpUDCn7x/mytestscript.py.
"""
if isinstance(code, bytes):
code = code.decode('utf-8')
# Be explicit about encoding the temp file as UTF-8 (issue #63):
with io.open(self.tempdir + filename, 'wt', encoding='utf-8') as f:
f.write(dedent(code))
def _read_test_script(self, filename='mytestscript.py'):
with io.open(self.tempdir + filename, 'rt', encoding='utf-8') as f:
newsource = f.read()
return newsource
def _futurize_test_script(self, filename='mytestscript.py', stages=(1, 2),
all_imports=False, from3=False,
conservative=False):
params = []
stages = list(stages)
if all_imports:
params.append('--all-imports')
if from3:
script = 'pasteurize.py'
else:
script = 'futurize.py'
if stages == [1]:
params.append('--stage1')
elif stages == [2]:
params.append('--stage2')
else:
assert stages == [1, 2]
if conservative:
params.append('--conservative')
# No extra params needed
# Absolute file path:
fn = self.tempdir + filename
call_args = [sys.executable, script] + params + ['-w', fn]
try:
output = check_output(call_args, stderr=STDOUT, env=self.env)
except CalledProcessError as e:
with open(fn) as f:
msg = (
'Error running the command %s\n'
'%s\n'
'Contents of file %s:\n'
'\n'
'%s') % (
' '.join(call_args),
'env=%s' % self.env,
fn,
'----\n%s\n----' % f.read(),
)
ErrorClass = (FuturizeError if 'futurize' in script else PasteurizeError)
if not hasattr(e, 'output'):
# The attribute CalledProcessError.output doesn't exist on Py2.6
e.output = None
raise ErrorClass(msg, e.returncode, e.cmd, output=e.output)
return output
def _run_test_script(self, filename='mytestscript.py',
interpreter=sys.executable):
# Absolute file path:
fn = self.tempdir + filename
try:
output = check_output([interpreter, fn],
env=self.env, stderr=STDOUT)
except CalledProcessError as e:
with open(fn) as f:
msg = (
'Error running the command %s\n'
'%s\n'
'Contents of file %s:\n'
'\n'
'%s') % (
' '.join([interpreter, fn]),
'env=%s' % self.env,
fn,
'----\n%s\n----' % f.read(),
)
if not hasattr(e, 'output'):
# The attribute CalledProcessError.output doesn't exist on Py2.6
e.output = None
raise VerboseCalledProcessError(msg, e.returncode, e.cmd, output=e.output)
return output
# Decorator to skip some tests on Python 2.6 ...
skip26 = unittest.skipIf(PY26, "this test is known to fail on Py2.6")
def expectedFailurePY3(func):
if not PY3:
return func
return unittest.expectedFailure(func)
def expectedFailurePY26(func):
if not PY26:
return func
return unittest.expectedFailure(func)
def expectedFailurePY27(func):
if not PY27:
return func
return unittest.expectedFailure(func)
def expectedFailurePY2(func):
if not PY2:
return func
return unittest.expectedFailure(func)
# Renamed in Py3.3:
if not hasattr(unittest.TestCase, 'assertRaisesRegex'):
unittest.TestCase.assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
# From Py3.3:
def assertRegex(self, text, expected_regex, msg=None):
"""Fail the test unless the text matches the regular expression."""
if isinstance(expected_regex, (str, unicode)):
assert expected_regex, "expected_regex must not be empty."
expected_regex = re.compile(expected_regex)
if not expected_regex.search(text):
msg = msg or "Regex didn't match"
msg = '%s: %r not found in %r' % (msg, expected_regex.pattern, text)
raise self.failureException(msg)
if not hasattr(unittest.TestCase, 'assertRegex'):
bind_method(unittest.TestCase, 'assertRegex', assertRegex)
class _AssertRaisesBaseContext(object):
def __init__(self, expected, test_case, callable_obj=None,
expected_regex=None):
self.expected = expected
self.test_case = test_case
if callable_obj is not None:
try:
self.obj_name = callable_obj.__name__
except AttributeError:
self.obj_name = str(callable_obj)
else:
self.obj_name = None
if isinstance(expected_regex, (bytes, str)):
expected_regex = re.compile(expected_regex)
self.expected_regex = expected_regex
self.msg = None
def _raiseFailure(self, standardMsg):
msg = self.test_case._formatMessage(self.msg, standardMsg)
raise self.test_case.failureException(msg)
def handle(self, name, callable_obj, args, kwargs):
"""
If callable_obj is None, assertRaises/Warns is being used as a
context manager, so check for a 'msg' kwarg and return self.
If callable_obj is not None, call it passing args and kwargs.
"""
if callable_obj is None:
self.msg = kwargs.pop('msg', None)
return self
with self:
callable_obj(*args, **kwargs)
class _AssertWarnsContext(_AssertRaisesBaseContext):
"""A context manager used to implement TestCase.assertWarns* methods."""
def __enter__(self):
# The __warningregistry__'s need to be in a pristine state for tests
# to work properly.
for v in sys.modules.values():
if getattr(v, '__warningregistry__', None):
v.__warningregistry__ = {}
self.warnings_manager = warnings.catch_warnings(record=True)
self.warnings = self.warnings_manager.__enter__()
warnings.simplefilter("always", self.expected)
return self
def __exit__(self, exc_type, exc_value, tb):
self.warnings_manager.__exit__(exc_type, exc_value, tb)
if exc_type is not None:
# let unexpected exceptions pass through
return
try:
exc_name = self.expected.__name__
except AttributeError:
exc_name = str(self.expected)
first_matching = None
for m in self.warnings:
w = m.message
if not isinstance(w, self.expected):
continue
if first_matching is None:
first_matching = w
if (self.expected_regex is not None and
not self.expected_regex.search(str(w))):
continue
# store warning for later retrieval
self.warning = w
self.filename = m.filename
self.lineno = m.lineno
return
# Now we simply try to choose a helpful failure message
if first_matching is not None:
self._raiseFailure('"{}" does not match "{}"'.format(
self.expected_regex.pattern, str(first_matching)))
if self.obj_name:
self._raiseFailure("{} not triggered by {}".format(exc_name,
self.obj_name))
else:
self._raiseFailure("{} not triggered".format(exc_name))
def assertWarns(self, expected_warning, callable_obj=None, *args, **kwargs):
"""Fail unless a warning of class warnClass is triggered
by callable_obj when invoked with arguments args and keyword
arguments kwargs. If a different type of warning is
triggered, it will not be handled: depending on the other
warning filtering rules in effect, it might be silenced, printed
out, or raised as an exception.
If called with callable_obj omitted or None, will return a
context object used like this::
with self.assertWarns(SomeWarning):
do_something()
An optional keyword argument 'msg' can be provided when assertWarns
is used as a context object.
The context manager keeps a reference to the first matching
warning as the 'warning' attribute; similarly, the 'filename'
and 'lineno' attributes give you information about the line
of Python code from which the warning was triggered.
This allows you to inspect the warning after the assertion::
with self.assertWarns(SomeWarning) as cm:
do_something()
the_warning = cm.warning
self.assertEqual(the_warning.some_attribute, 147)
"""
context = _AssertWarnsContext(expected_warning, self, callable_obj)
return context.handle('assertWarns', callable_obj, args, kwargs)
if not hasattr(unittest.TestCase, 'assertWarns'):
bind_method(unittest.TestCase, 'assertWarns', assertWarns)
PK �Au\fa�z z future/__init__.pynu �[��� """
future: Easy, safe support for Python 2/3 compatibility
=======================================================
``future`` is the missing compatibility layer between Python 2 and Python
3. It allows you to use a single, clean Python 3.x-compatible codebase to
support both Python 2 and Python 3 with minimal overhead.
It is designed to be used as follows::
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from builtins import (
bytes, dict, int, list, object, range, str,
ascii, chr, hex, input, next, oct, open,
pow, round, super,
filter, map, zip)
followed by predominantly standard, idiomatic Python 3 code that then runs
similarly on Python 2.6/2.7 and Python 3.3+.
The imports have no effect on Python 3. On Python 2, they shadow the
corresponding builtins, which normally have different semantics on Python 3
versus 2, to provide their Python 3 semantics.
Standard library reorganization
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
``future`` supports the standard library reorganization (PEP 3108) through the
following Py3 interfaces:
>>> # Top-level packages with Py3 names provided on Py2:
>>> import html.parser
>>> import queue
>>> import tkinter.dialog
>>> import xmlrpc.client
>>> # etc.
>>> # Aliases provided for extensions to existing Py2 module names:
>>> from future.standard_library import install_aliases
>>> install_aliases()
>>> from collections import Counter, OrderedDict # backported to Py2.6
>>> from collections import UserDict, UserList, UserString
>>> import urllib.request
>>> from itertools import filterfalse, zip_longest
>>> from subprocess import getoutput, getstatusoutput
Automatic conversion
--------------------
An included script called `futurize
<https://python-future.org/automatic_conversion.html>`_ aids in converting
code (from either Python 2 or Python 3) to code compatible with both
platforms. It is similar to ``python-modernize`` but goes further in
providing Python 3 compatibility through the use of the backported types
and builtin functions in ``future``.
Documentation
-------------
See: https://python-future.org
Credits
-------
:Author: Ed Schofield, Jordan M. Adler, et al
:Sponsor: Python Charmers: https://pythoncharmers.com
:Others: See docs/credits.rst or https://python-future.org/credits.html
Licensing
---------
Copyright 2013-2024 Python Charmers, Australia.
The software is distributed under an MIT licence. See LICENSE.txt.
"""
__title__ = 'future'
__author__ = 'Ed Schofield'
__license__ = 'MIT'
__copyright__ = 'Copyright 2013-2024 Python Charmers (https://pythoncharmers.com)'
__ver_major__ = 1
__ver_minor__ = 0
__ver_patch__ = 0
__ver_sub__ = ''
__version__ = "%d.%d.%d%s" % (__ver_major__, __ver_minor__,
__ver_patch__, __ver_sub__)
PK �Au\n�� � � future/builtins/misc.pynu �[��� """
A module that brings in equivalents of various modified Python 3 builtins
into Py2. Has no effect on Py3.
The builtin functions are:
- ``ascii`` (from Py2's future_builtins module)
- ``hex`` (from Py2's future_builtins module)
- ``oct`` (from Py2's future_builtins module)
- ``chr`` (equivalent to ``unichr`` on Py2)
- ``input`` (equivalent to ``raw_input`` on Py2)
- ``next`` (calls ``__next__`` if it exists, else ``next`` method)
- ``open`` (equivalent to io.open on Py2)
- ``super`` (backport of Py3's magic zero-argument super() function
- ``round`` (new "Banker's Rounding" behaviour from Py3)
- ``max`` (new default option from Py3.4)
- ``min`` (new default option from Py3.4)
``isinstance`` is also currently exported for backwards compatibility
with v0.8.2, although this has been deprecated since v0.9.
input()
-------
Like the new ``input()`` function from Python 3 (without eval()), except
that it returns bytes. Equivalent to Python 2's ``raw_input()``.
Warning: By default, importing this module *removes* the old Python 2
input() function entirely from ``__builtin__`` for safety. This is
because forgetting to import the new ``input`` from ``future`` might
otherwise lead to a security vulnerability (shell injection) on Python 2.
To restore it, you can retrieve it yourself from
``__builtin__._old_input``.
Fortunately, ``input()`` seems to be seldom used in the wild in Python
2...
"""
from future import utils
if utils.PY2:
from io import open
from future_builtins import ascii, oct, hex
from __builtin__ import unichr as chr, pow as _builtin_pow
import __builtin__
# Only for backward compatibility with future v0.8.2:
isinstance = __builtin__.isinstance
# Warning: Python 2's input() is unsafe and MUST not be able to be used
# accidentally by someone who expects Python 3 semantics but forgets
# to import it on Python 2. Versions of ``future`` prior to 0.11
# deleted it from __builtin__. Now we keep in __builtin__ but shadow
# the name like all others. Just be sure to import ``input``.
input = raw_input
from future.builtins.newnext import newnext as next
from future.builtins.newround import newround as round
from future.builtins.newsuper import newsuper as super
from future.builtins.new_min_max import newmax as max
from future.builtins.new_min_max import newmin as min
from future.types.newint import newint
_SENTINEL = object()
def pow(x, y, z=_SENTINEL):
"""
pow(x, y[, z]) -> number
With two arguments, equivalent to x**y. With three arguments,
equivalent to (x**y) % z, but may be more efficient (e.g. for ints).
"""
# Handle newints
if isinstance(x, newint):
x = long(x)
if isinstance(y, newint):
y = long(y)
if isinstance(z, newint):
z = long(z)
try:
if z == _SENTINEL:
return _builtin_pow(x, y)
else:
return _builtin_pow(x, y, z)
except ValueError:
if z == _SENTINEL:
return _builtin_pow(x+0j, y)
else:
return _builtin_pow(x+0j, y, z)
# ``future`` doesn't support Py3.0/3.1. If we ever did, we'd add this:
# callable = __builtin__.callable
__all__ = ['ascii', 'chr', 'hex', 'input', 'isinstance', 'next', 'oct',
'open', 'pow', 'round', 'super', 'max', 'min']
else:
import builtins
ascii = builtins.ascii
chr = builtins.chr
hex = builtins.hex
input = builtins.input
next = builtins.next
# Only for backward compatibility with future v0.8.2:
isinstance = builtins.isinstance
oct = builtins.oct
open = builtins.open
pow = builtins.pow
round = builtins.round
super = builtins.super
if utils.PY34_PLUS:
max = builtins.max
min = builtins.min
__all__ = []
else:
from future.builtins.new_min_max import newmax as max
from future.builtins.new_min_max import newmin as min
__all__ = ['min', 'max']
# The callable() function was removed from Py3.0 and 3.1 and
# reintroduced into Py3.2+. ``future`` doesn't support Py3.0/3.1. If we ever
# did, we'd add this:
# try:
# callable = builtins.callable
# except AttributeError:
# # Definition from Pandas
# def callable(obj):
# return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
# __all__.append('callable')
PK �Au\���� � future/builtins/new_min_max.pynu �[��� import itertools
from future import utils
if utils.PY2:
from __builtin__ import max as _builtin_max, min as _builtin_min
else:
from builtins import max as _builtin_max, min as _builtin_min
_SENTINEL = object()
def newmin(*args, **kwargs):
return new_min_max(_builtin_min, *args, **kwargs)
def newmax(*args, **kwargs):
return new_min_max(_builtin_max, *args, **kwargs)
def new_min_max(_builtin_func, *args, **kwargs):
"""
To support the argument "default" introduced in python 3.4 for min and max
:param _builtin_func: builtin min or builtin max
:param args:
:param kwargs:
:return: returns the min or max based on the arguments passed
"""
for key, _ in kwargs.items():
if key not in set(['key', 'default']):
raise TypeError('Illegal argument %s', key)
if len(args) == 0:
raise TypeError
if len(args) != 1 and kwargs.get('default', _SENTINEL) is not _SENTINEL:
raise TypeError
if len(args) == 1:
iterator = iter(args[0])
try:
first = next(iterator)
except StopIteration:
if kwargs.get('default', _SENTINEL) is not _SENTINEL:
return kwargs.get('default')
else:
raise ValueError('{}() arg is an empty sequence'.format(_builtin_func.__name__))
else:
iterator = itertools.chain([first], iterator)
if kwargs.get('key') is not None:
return _builtin_func(iterator, key=kwargs.get('key'))
else:
return _builtin_func(iterator)
if len(args) > 1:
if kwargs.get('key') is not None:
return _builtin_func(args, key=kwargs.get('key'))
else:
return _builtin_func(args)
PK �Au\6���= = future/builtins/disabled.pynu �[��� """
This disables builtin functions (and one exception class) which are
removed from Python 3.3.
This module is designed to be used like this::
from future.builtins.disabled import *
This disables the following obsolete Py2 builtin functions::
apply, cmp, coerce, execfile, file, input, long,
raw_input, reduce, reload, unicode, xrange
We don't hack __builtin__, which is very fragile because it contaminates
imported modules too. Instead, we just create new functions with
the same names as the obsolete builtins from Python 2 which raise
NameError exceptions when called.
Note that both ``input()`` and ``raw_input()`` are among the disabled
functions (in this module). Although ``input()`` exists as a builtin in
Python 3, the Python 2 ``input()`` builtin is unsafe to use because it
can lead to shell injection. Therefore we shadow it by default upon ``from
future.builtins.disabled import *``, in case someone forgets to import our
replacement ``input()`` somehow and expects Python 3 semantics.
See the ``future.builtins.misc`` module for a working version of
``input`` with Python 3 semantics.
(Note that callable() is not among the functions disabled; this was
reintroduced into Python 3.2.)
This exception class is also disabled:
StandardError
"""
from __future__ import division, absolute_import, print_function
from future import utils
OBSOLETE_BUILTINS = ['apply', 'chr', 'cmp', 'coerce', 'execfile', 'file',
'input', 'long', 'raw_input', 'reduce', 'reload',
'unicode', 'xrange', 'StandardError']
def disabled_function(name):
'''
Returns a function that cannot be called
'''
def disabled(*args, **kwargs):
'''
A function disabled by the ``future`` module. This function is
no longer a builtin in Python 3.
'''
raise NameError('obsolete Python 2 builtin {0} is disabled'.format(name))
return disabled
if not utils.PY3:
for fname in OBSOLETE_BUILTINS:
locals()[fname] = disabled_function(fname)
__all__ = OBSOLETE_BUILTINS
else:
__all__ = []
PK �Au\�C � � future/builtins/__init__.pynu �[��� """
A module that brings in equivalents of the new and modified Python 3
builtins into Py2. Has no effect on Py3.
See the docs `here <https://python-future.org/what-else.html>`_
(``docs/what-else.rst``) for more information.
"""
from future.builtins.iterators import (filter, map, zip)
# The isinstance import is no longer needed. We provide it only for
# backward-compatibility with future v0.8.2. It will be removed in future v1.0.
from future.builtins.misc import (ascii, chr, hex, input, isinstance, next,
oct, open, pow, round, super, max, min)
from future.utils import PY3
if PY3:
import builtins
bytes = builtins.bytes
dict = builtins.dict
int = builtins.int
list = builtins.list
object = builtins.object
range = builtins.range
str = builtins.str
__all__ = []
else:
from future.types import (newbytes as bytes,
newdict as dict,
newint as int,
newlist as list,
newobject as object,
newrange as range,
newstr as str)
from future import utils
if not utils.PY3:
# We only import names that shadow the builtins on Py2. No other namespace
# pollution on Py2.
# Only shadow builtins on Py2; no new names
__all__ = ['filter', 'map', 'zip',
'ascii', 'chr', 'hex', 'input', 'next', 'oct', 'open', 'pow',
'round', 'super',
'bytes', 'dict', 'int', 'list', 'object', 'range', 'str', 'max', 'min'
]
else:
# No namespace pollution on Py3
__all__ = []
PK �Au\�& t t future/builtins/iterators.pynu �[��� """
This module is designed to be used as follows::
from future.builtins.iterators import *
And then, for example::
for i in range(10**15):
pass
for (a, b) in zip(range(10**15), range(-10**15, 0)):
pass
Note that this is standard Python 3 code, plus some imports that do
nothing on Python 3.
The iterators this brings in are::
- ``range``
- ``filter``
- ``map``
- ``zip``
On Python 2, ``range`` is a pure-Python backport of Python 3's ``range``
iterator with slicing support. The other iterators (``filter``, ``map``,
``zip``) are from the ``itertools`` module on Python 2. On Python 3 these
are available in the module namespace but not exported for * imports via
__all__ (zero no namespace pollution).
Note that these are also available in the standard library
``future_builtins`` module on Python 2 -- but not Python 3, so using
the standard library version is not portable, nor anywhere near complete.
"""
from __future__ import division, absolute_import, print_function
import itertools
from future import utils
if not utils.PY3:
filter = itertools.ifilter
map = itertools.imap
from future.types import newrange as range
zip = itertools.izip
__all__ = ['filter', 'map', 'range', 'zip']
else:
import builtins
filter = builtins.filter
map = builtins.map
range = builtins.range
zip = builtins.zip
__all__ = []
PK �Au\�Kh � � future/builtins/newnext.pynu �[��� '''
This module provides a newnext() function in Python 2 that mimics the
behaviour of ``next()`` in Python 3, falling back to Python 2's behaviour for
compatibility if this fails.
``newnext(iterator)`` calls the iterator's ``__next__()`` method if it exists. If this
doesn't exist, it falls back to calling a ``next()`` method.
For example:
>>> class Odds(object):
... def __init__(self, start=1):
... self.value = start - 2
... def __next__(self): # note the Py3 interface
... self.value += 2
... return self.value
... def __iter__(self):
... return self
...
>>> iterator = Odds()
>>> next(iterator)
1
>>> next(iterator)
3
If you are defining your own custom iterator class as above, it is preferable
to explicitly decorate the class with the @implements_iterator decorator from
``future.utils`` as follows:
>>> @implements_iterator
... class Odds(object):
... # etc
... pass
This next() function is primarily for consuming iterators defined in Python 3
code elsewhere that we would like to run on Python 2 or 3.
'''
_builtin_next = next
_SENTINEL = object()
def newnext(iterator, default=_SENTINEL):
"""
next(iterator[, default])
Return the next item from the iterator. If default is given and the iterator
is exhausted, it is returned instead of raising StopIteration.
"""
# args = []
# if default is not _SENTINEL:
# args.append(default)
try:
try:
return iterator.__next__()
except AttributeError:
try:
return iterator.next()
except AttributeError:
raise TypeError("'{0}' object is not an iterator".format(
iterator.__class__.__name__))
except StopIteration as e:
if default is _SENTINEL:
raise e
else:
return default
__all__ = ['newnext']
PK �Au\g��}� � 3 future/builtins/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZmZmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ ddlmZ er�ddlZejZejZejZejZejZejZej Z g Z n$ddl m Zm Zm!Zm"Zm#Zm$Zm%Z ddl&m'Z' e'js�g d�Z ng Z dS ) z�
A module that brings in equivalents of the new and modified Python 3
builtins into Py2. Has no effect on Py3.
See the docs `here <https://python-future.org/what-else.html>`_
(``docs/what-else.rst``) for more information.
� )�filter�map�zip)
�ascii�chr�hex�input�
isinstance�next�oct�open�pow�round�super�max�min)�PY3N)�newbytes�newdict�newint�newlist� newobject�newrange�newstr)�utils)r r r r r r r r
r r r
r r �bytes�dict�int�list�object�range�strr r )(�__doc__Zfuture.builtins.iteratorsr r r Zfuture.builtins.miscr r r r r r
r r r
r r r r Z future.utilsr �builtinsr r r r r r r! �__all__Z future.typesr r r r r r r �futurer � r& r& �B/usr/local/lib/python3.9/site-packages/future/builtins/__init__.py�<module> s$ < $
PK �Au\�^ �� � 4 future/builtins/__pycache__/iterators.cpython-39.pycnu �[��� a
��?ht � @ s� d Z ddlmZmZmZ ddlZddlmZ ejsZej Z
ej Z ddl
mZ ejZg d�Zn$ddlZej
Z
ej Z ejZejZg ZdS )a�
This module is designed to be used as follows::
from future.builtins.iterators import *
And then, for example::
for i in range(10**15):
pass
for (a, b) in zip(range(10**15), range(-10**15, 0)):
pass
Note that this is standard Python 3 code, plus some imports that do
nothing on Python 3.
The iterators this brings in are::
- ``range``
- ``filter``
- ``map``
- ``zip``
On Python 2, ``range`` is a pure-Python backport of Python 3's ``range``
iterator with slicing support. The other iterators (``filter``, ``map``,
``zip``) are from the ``itertools`` module on Python 2. On Python 3 these
are available in the module namespace but not exported for * imports via
__all__ (zero no namespace pollution).
Note that these are also available in the standard library
``future_builtins`` module on Python 2 -- but not Python 3, so using
the standard library version is not portable, nor anywhere near complete.
� )�division�absolute_import�print_functionN)�utils)�newrange)�filter�map�range�zip)�__doc__�
__future__r r r � itertools�futurer �PY3�ifilterr �imapr Z future.typesr r �izipr
�__all__�builtins� r r �C/usr/local/lib/python3.9/site-packages/future/builtins/iterators.py�<module> s "
PK �Au\0D � � 3 future/builtins/__pycache__/newsuper.cpython-39.pycnu �[��� a
��?h � @ sh d Z ddlmZ ddlZddlmZ ddlmZmZ e Z
e � Z e e dfdd�Z
d d
� Zd d � ZdgZdS )
ah
This module provides a newsuper() function in Python 2 that mimics the
behaviour of super() in Python 3. It is designed to be used as follows:
from __future__ import division, absolute_import, print_function
from future.builtins import super
And then, for example:
class VerboseList(list):
def append(self, item):
print('Adding an item')
super().append(item) # new simpler super() function
Importing this module on Python 3 has no effect.
This is based on (i.e. almost identical to) Ryan Kelly's magicsuper
module here:
https://github.com/rfk/magicsuper.git
Excerpts from Ryan's docstring:
"Of course, you can still explicitly pass in the arguments if you want
to do something strange. Sometimes you really do want that, e.g. to
skip over some classes in the method resolution order.
"How does it work? By inspecting the calling frame to determine the
function object being executed and the object on which it's being
called, and then walking the object's __mro__ chain to find out where
that function was defined. Yuck, but it seems to work..."
� )�absolute_importN)� FunctionType)�PY3�PY26� c C s� | t u r�t�|�}z|j|jjd }W n ttfyF td��Y n0 zt ||j�} W n^ t
tt fy� zt |j |j�} W n2 t
y� td��Y n t y� td��Y n0 Y n0 |t ur�t
| |�S t
| �S )z�Like builtin super(), but capable of magic.
This acts just like the builtin super() function, but if called
without any arguments it attempts to infer them at runtime.
r z'super() used in a function with no argsz$super() used with an old-style classz super() called outside a method)� _SENTINEL�sys� _getframe�f_locals�f_code� co_varnames�
IndexError�KeyError� RuntimeError�
find_owner�AttributeError� TypeError� __class__�_builtin_super)�typZ type_or_obj�
framedepth�f� r �B/usr/local/lib/python3.9/site-packages/future/builtins/newsuper.py�newsuper- s$
r c C s� | j D ]�}|j�� D ]�}zLt|t�sbt|t�r6|j}qz
|j}W q ty^ |� | |�}Y q0 qW n tt
fy~ Y qY n0 |j |u r| S qqt
�dS )z=Find the class that owns the currently-executing method.
N) �__mro__�__dict__�values�
isinstancer �property�fget�__func__r �__get__r � func_code)�cls�coder �methr r r r O s
r c O s, t �d�}|jj}ttdd�|�| i |��S )Nr � )r )r r r �co_name�getattrr )�args�kwdsr �nmr r r �supermk s
r- )�__doc__�
__future__r r �typesr Z future.utilsr r �superr �objectr r r r- �__all__r r r r �<module> s ! " PK �Au\���V 3 future/builtins/__pycache__/disabled.cpython-39.pycnu �[��� a
��?h= � @ s` d Z ddlmZmZmZ ddlmZ g d�Zdd� Zej sXeD ]Z
ee
�e � e
< q>eZ ng Z dS )a�
This disables builtin functions (and one exception class) which are
removed from Python 3.3.
This module is designed to be used like this::
from future.builtins.disabled import *
This disables the following obsolete Py2 builtin functions::
apply, cmp, coerce, execfile, file, input, long,
raw_input, reduce, reload, unicode, xrange
We don't hack __builtin__, which is very fragile because it contaminates
imported modules too. Instead, we just create new functions with
the same names as the obsolete builtins from Python 2 which raise
NameError exceptions when called.
Note that both ``input()`` and ``raw_input()`` are among the disabled
functions (in this module). Although ``input()`` exists as a builtin in
Python 3, the Python 2 ``input()`` builtin is unsafe to use because it
can lead to shell injection. Therefore we shadow it by default upon ``from
future.builtins.disabled import *``, in case someone forgets to import our
replacement ``input()`` somehow and expects Python 3 semantics.
See the ``future.builtins.misc`` module for a working version of
``input`` with Python 3 semantics.
(Note that callable() is not among the functions disabled; this was
reintroduced into Python 3.2.)
This exception class is also disabled:
StandardError
� )�division�absolute_import�print_function)�utils)�apply�chr�cmpZcoerceZexecfile�file�input�long� raw_input�reduce�reload�unicode�xrange�
StandardErrorc s � fdd�}|S )z2
Returns a function that cannot be called
c s t d�� ���dS )zy
A function disabled by the ``future`` module. This function is
no longer a builtin in Python 3.
z)obsolete Python 2 builtin {0} is disabledN)� NameError�format)�args�kwargs��name� �B/usr/local/lib/python3.9/site-packages/future/builtins/disabled.py�disabled4 s z#disabled_function.<locals>.disabledr )r r r r r �disabled_function0 s r N)
�__doc__�
__future__r r r �futurer ZOBSOLETE_BUILTINSr �PY3�fname�locals�__all__r r r r �<module> s %
PK �Au\��]+� � / future/builtins/__pycache__/misc.cpython-39.pycnu �[��� a
��?h� � @ sD d Z ddlmZ ejr�ddlmZ ddlmZmZm Z ddl
m Z m
Z ddl
Z
e
jZeZddlmZ ddlmZ dd lmZ dd
lm Z dd lm Z dd l m!Z! e"� Z#e#fd
d�Z
g d�Z$n�ddl%Z%e%jZe%j Z e%j Z e%jZe%jZe%jZe%jZe%jZe%j
Z
e%jZe%jZej&�r e%j Z e%j Z g Z$n dd
lm Z dd lm Z ddgZ$dS )a�
A module that brings in equivalents of various modified Python 3 builtins
into Py2. Has no effect on Py3.
The builtin functions are:
- ``ascii`` (from Py2's future_builtins module)
- ``hex`` (from Py2's future_builtins module)
- ``oct`` (from Py2's future_builtins module)
- ``chr`` (equivalent to ``unichr`` on Py2)
- ``input`` (equivalent to ``raw_input`` on Py2)
- ``next`` (calls ``__next__`` if it exists, else ``next`` method)
- ``open`` (equivalent to io.open on Py2)
- ``super`` (backport of Py3's magic zero-argument super() function
- ``round`` (new "Banker's Rounding" behaviour from Py3)
- ``max`` (new default option from Py3.4)
- ``min`` (new default option from Py3.4)
``isinstance`` is also currently exported for backwards compatibility
with v0.8.2, although this has been deprecated since v0.9.
input()
-------
Like the new ``input()`` function from Python 3 (without eval()), except
that it returns bytes. Equivalent to Python 2's ``raw_input()``.
Warning: By default, importing this module *removes* the old Python 2
input() function entirely from ``__builtin__`` for safety. This is
because forgetting to import the new ``input`` from ``future`` might
otherwise lead to a security vulnerability (shell injection) on Python 2.
To restore it, you can retrieve it yourself from
``__builtin__._old_input``.
Fortunately, ``input()`` seems to be seldom used in the wild in Python
2...
� )�utils)�open)�ascii�oct�hex)�unichr�powN)�newnext)�newround)�newsuper)�newmax)�newmin)�newintc C s� t | t�rt| �} t |t�r$t|�}t |t�r6t|�}z&|tkrLt| |�W S t| ||�W S W n@ ty� |tkr�t| d |� Y S t| d ||� Y S Y n0 dS )z�
pow(x, y[, z]) -> number
With two arguments, equivalent to x**y. With three arguments,
equivalent to (x**y) % z, but may be more efficient (e.g. for ints).
y N)�
isinstancer �long� _SENTINEL� _builtin_pow�
ValueError)�x�y�z� r �>/usr/local/lib/python3.9/site-packages/future/builtins/misc.pyr F s
r )
r �chrr �inputr �nextr r r �round�super�max�minr r )'�__doc__�futurer �PY2�ior Zfuture_builtinsr r r � __builtin__r r r r r � raw_inputr Zfuture.builtins.newnextr r Zfuture.builtins.newroundr
r Zfuture.builtins.newsuperr r Zfuture.builtins.new_min_maxr r r
r Zfuture.types.newintr �objectr �__all__�builtinsZ PY34_PLUSr r r r �<module> sH (
PK �Au\~"=,�
�
3 future/builtins/__pycache__/newround.cpython-39.pycnu �[��� a
��?hv � @ sP d Z ddlmZ ddlmZmZmZ ddlmZm Z d
dd�Z
dd � Z dgZ dS ) zD
``python-future``: pure Python implementation of Python 3 round().
� )�division)�PYPY�PY26� bind_method)�Decimal�ROUND_HALF_EVENNc C s� d}|du rd}d}t | d�r(| �|�S td�| }dtt| ��v rNt| �} t| t�r^| }ntsnt�| �}nt | �}|dk r�t
|| �| }n|j |t d�}|r�t
|�S t|�S dS ) a�
See Python 3 documentation: uses Banker's Rounding.
Delegates to the __round__ method if for some reason this exists.
If not, rounds a number to a given precision in decimal digits (default
0 digits). This returns an int when called with one argument,
otherwise the same type as the number. ndigits may be negative.
See the test_round method in future/tests/test_builtins.py for
examples.
FNTr � __round__�10Znumpy)�rounding)�hasattrr r �repr�type�float�
isinstancer �
from_float�
from_float_26�newround�quantizer �int)�number�ndigitsZ
return_int�exponent�d�result� r �B/usr/local/lib/python3.9/site-packages/future/builtins/newround.pyr
s(
r c C s� ddl }ddlm} t| ttf�r*t| �S |�| �s>|�| �rJtt | ��S |�
d| �dkr`d}nd}t | �� � \}}dd� }||�d }||t
|d| �| �}|S ) a� Converts a float to a decimal number, exactly.
Note that Decimal.from_float(0.1) is not the same as Decimal('0.1').
Since 0.1 is not exactly representable in binary floating point, the
value is stored as the nearest representable value which is
0x1.999999999999ap-4. The exact equivalent of the value in decimal
is 0.1000000000000000055511151231257827021181583404541015625.
>>> Decimal.from_float(0.1)
Decimal('0.1000000000000000055511151231257827021181583404541015625')
>>> Decimal.from_float(float('nan'))
Decimal('NaN')
>>> Decimal.from_float(float('inf'))
Decimal('Infinity')
>>> Decimal.from_float(-float('inf'))
Decimal('-Infinity')
>>> Decimal.from_float(-0.0)
Decimal('-0')
r N)�_dec_from_tripleg �?� c S s$ | dkr t tt| ���d S dS d S )Nr � )�len�bin�abs)r r r r �
bit_length_ s z!from_float_26.<locals>.bit_length� )�math�decimalr r r �longr �isinf�isnanr �copysignr! �as_integer_ratio�str) �fZ_mathr �sign�nr r" �kr r r r r = s r )N)
�__doc__�
__future__r Z future.utilsr r r r% r r r r �__all__r r r r �<module> s
0,PK �Au\5��� � 2 future/builtins/__pycache__/newnext.cpython-39.pycnu �[��� a
��?h� � @ s$ d Z eZe� Zefdd�ZdgZdS )a�
This module provides a newnext() function in Python 2 that mimics the
behaviour of ``next()`` in Python 3, falling back to Python 2's behaviour for
compatibility if this fails.
``newnext(iterator)`` calls the iterator's ``__next__()`` method if it exists. If this
doesn't exist, it falls back to calling a ``next()`` method.
For example:
>>> class Odds(object):
... def __init__(self, start=1):
... self.value = start - 2
... def __next__(self): # note the Py3 interface
... self.value += 2
... return self.value
... def __iter__(self):
... return self
...
>>> iterator = Odds()
>>> next(iterator)
1
>>> next(iterator)
3
If you are defining your own custom iterator class as above, it is preferable
to explicitly decorate the class with the @implements_iterator decorator from
``future.utils`` as follows:
>>> @implements_iterator
... class Odds(object):
... # etc
... pass
This next() function is primarily for consuming iterators defined in Python 3
code elsewhere that we would like to run on Python 2 or 3.
c C s� zZz | � � W W S tyV z| �� W Y W S tyP td�| jj���Y n0 Y n0 W nB ty� } z*|tu rx|�n|W Y d}~S W Y d}~n
d}~0 0 dS )z�
next(iterator[, default])
Return the next item from the iterator. If default is given and the iterator
is exhausted, it is returned instead of raising StopIteration.
z '{0}' object is not an iteratorN) �__next__�AttributeError�next� TypeError�format� __class__�__name__�
StopIteration� _SENTINEL)�iterator�default�e� r
�A/usr/local/lib/python3.9/site-packages/future/builtins/newnext.py�newnext+ s �r N)�__doc__r Z
_builtin_next�objectr r �__all__r
r
r
r �<module> s & PK �Au\��Ï 6 future/builtins/__pycache__/new_min_max.cpython-39.pycnu �[��� a
��?h� � @ s^ d dl Z d dlmZ ejr,d dlmZmZ nd dl mZmZ e
� Z dd� Z dd� Z
dd � ZdS )
� N)�utils)�max�minc O s t tg| �R i |��S �N)� new_min_max� _builtin_min��args�kwargs� r �E/usr/local/lib/python3.9/site-packages/future/builtins/new_min_max.py�newmin s r
c O s t tg| �R i |��S r )r � _builtin_maxr r r r �newmax s r c O s4 |� � D ]"\}}|tddg�vrtd|��qt|�dkr<t�t|�dkr\|�dt�tur\t�t|�dkr�t|d �}z t|�}W n@ ty� |�dt�tur�|�d� Y S t d�
| j ���Y n0 t �
|g|�}|�d�dur�| ||�d�d�S | |�S t|�dk�r0|�d�du�r(| ||�d�d�S | |�S dS ) z�
To support the argument "default" introduced in python 3.4 for min and max
:param _builtin_func: builtin min or builtin max
:param args:
:param kwargs:
:return: returns the min or max based on the arguments passed
�key�defaultzIllegal argument %sr � z {}() arg is an empty sequenceN)r )�items�set� TypeError�len�get� _SENTINEL�iter�next�
StopIteration�
ValueError�format�__name__� itertools�chain)Z
_builtin_funcr r
r �_�iterator�firstr r r r s. r )r �futurer �PY2� __builtin__r r r r �builtins�objectr r
r r r r r r �<module> s PK �Au\�� � future/builtins/newsuper.pynu �[��� '''
This module provides a newsuper() function in Python 2 that mimics the
behaviour of super() in Python 3. It is designed to be used as follows:
from __future__ import division, absolute_import, print_function
from future.builtins import super
And then, for example:
class VerboseList(list):
def append(self, item):
print('Adding an item')
super().append(item) # new simpler super() function
Importing this module on Python 3 has no effect.
This is based on (i.e. almost identical to) Ryan Kelly's magicsuper
module here:
https://github.com/rfk/magicsuper.git
Excerpts from Ryan's docstring:
"Of course, you can still explicitly pass in the arguments if you want
to do something strange. Sometimes you really do want that, e.g. to
skip over some classes in the method resolution order.
"How does it work? By inspecting the calling frame to determine the
function object being executed and the object on which it's being
called, and then walking the object's __mro__ chain to find out where
that function was defined. Yuck, but it seems to work..."
'''
from __future__ import absolute_import
import sys
from types import FunctionType
from future.utils import PY3, PY26
_builtin_super = super
_SENTINEL = object()
def newsuper(typ=_SENTINEL, type_or_obj=_SENTINEL, framedepth=1):
'''Like builtin super(), but capable of magic.
This acts just like the builtin super() function, but if called
without any arguments it attempts to infer them at runtime.
'''
# Infer the correct call if used without arguments.
if typ is _SENTINEL:
# We'll need to do some frame hacking.
f = sys._getframe(framedepth)
try:
# Get the function's first positional argument.
type_or_obj = f.f_locals[f.f_code.co_varnames[0]]
except (IndexError, KeyError,):
raise RuntimeError('super() used in a function with no args')
try:
typ = find_owner(type_or_obj, f.f_code)
except (AttributeError, RuntimeError, TypeError):
# see issues #160, #267
try:
typ = find_owner(type_or_obj.__class__, f.f_code)
except AttributeError:
raise RuntimeError('super() used with an old-style class')
except TypeError:
raise RuntimeError('super() called outside a method')
# Dispatch to builtin super().
if type_or_obj is not _SENTINEL:
return _builtin_super(typ, type_or_obj)
return _builtin_super(typ)
def find_owner(cls, code):
'''Find the class that owns the currently-executing method.
'''
for typ in cls.__mro__:
for meth in typ.__dict__.values():
# Drill down through any wrappers to the underlying func.
# This handles e.g. classmethod() and staticmethod().
try:
while not isinstance(meth,FunctionType):
if isinstance(meth, property):
# Calling __get__ on the property will invoke
# user code which might throw exceptions or have
# side effects
meth = meth.fget
else:
try:
meth = meth.__func__
except AttributeError:
meth = meth.__get__(cls, typ)
except (AttributeError, TypeError):
continue
if meth.func_code is code:
return typ # Aha! Found you.
# Not found! Move onto the next class in MRO.
raise TypeError
def superm(*args, **kwds):
f = sys._getframe(1)
nm = f.f_code.co_name
return getattr(newsuper(framedepth=2),nm)(*args, **kwds)
__all__ = ['newsuper']
PK �Au\�H��v v future/builtins/newround.pynu �[��� """
``python-future``: pure Python implementation of Python 3 round().
"""
from __future__ import division
from future.utils import PYPY, PY26, bind_method
# Use the decimal module for simplicity of implementation (and
# hopefully correctness).
from decimal import Decimal, ROUND_HALF_EVEN
def newround(number, ndigits=None):
"""
See Python 3 documentation: uses Banker's Rounding.
Delegates to the __round__ method if for some reason this exists.
If not, rounds a number to a given precision in decimal digits (default
0 digits). This returns an int when called with one argument,
otherwise the same type as the number. ndigits may be negative.
See the test_round method in future/tests/test_builtins.py for
examples.
"""
return_int = False
if ndigits is None:
return_int = True
ndigits = 0
if hasattr(number, '__round__'):
return number.__round__(ndigits)
exponent = Decimal('10') ** (-ndigits)
# Work around issue #24: round() breaks on PyPy with NumPy's types
# Also breaks on CPython with NumPy's specialized int types like uint64
if 'numpy' in repr(type(number)):
number = float(number)
if isinstance(number, Decimal):
d = number
else:
if not PY26:
d = Decimal.from_float(number)
else:
d = from_float_26(number)
if ndigits < 0:
result = newround(d / exponent) * exponent
else:
result = d.quantize(exponent, rounding=ROUND_HALF_EVEN)
if return_int:
return int(result)
else:
return float(result)
### From Python 2.7's decimal.py. Only needed to support Py2.6:
def from_float_26(f):
"""Converts a float to a decimal number, exactly.
Note that Decimal.from_float(0.1) is not the same as Decimal('0.1').
Since 0.1 is not exactly representable in binary floating point, the
value is stored as the nearest representable value which is
0x1.999999999999ap-4. The exact equivalent of the value in decimal
is 0.1000000000000000055511151231257827021181583404541015625.
>>> Decimal.from_float(0.1)
Decimal('0.1000000000000000055511151231257827021181583404541015625')
>>> Decimal.from_float(float('nan'))
Decimal('NaN')
>>> Decimal.from_float(float('inf'))
Decimal('Infinity')
>>> Decimal.from_float(-float('inf'))
Decimal('-Infinity')
>>> Decimal.from_float(-0.0)
Decimal('-0')
"""
import math as _math
from decimal import _dec_from_triple # only available on Py2.6 and Py2.7 (not 3.3)
if isinstance(f, (int, long)): # handle integer inputs
return Decimal(f)
if _math.isinf(f) or _math.isnan(f): # raises TypeError if not a float
return Decimal(repr(f))
if _math.copysign(1.0, f) == 1.0:
sign = 0
else:
sign = 1
n, d = abs(f).as_integer_ratio()
# int.bit_length() method doesn't exist on Py2.6:
def bit_length(d):
if d != 0:
return len(bin(abs(d))) - 2
else:
return 0
k = bit_length(d) - 1
result = _dec_from_triple(sign, str(n*5**k), -k)
return result
__all__ = ['newround']
PK �Au\�D�� � * future/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hz � @ s8 d Z dZdZdZdZdZdZdZdZdeeeef Z d S )
a
future: Easy, safe support for Python 2/3 compatibility
=======================================================
``future`` is the missing compatibility layer between Python 2 and Python
3. It allows you to use a single, clean Python 3.x-compatible codebase to
support both Python 2 and Python 3 with minimal overhead.
It is designed to be used as follows::
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from builtins import (
bytes, dict, int, list, object, range, str,
ascii, chr, hex, input, next, oct, open,
pow, round, super,
filter, map, zip)
followed by predominantly standard, idiomatic Python 3 code that then runs
similarly on Python 2.6/2.7 and Python 3.3+.
The imports have no effect on Python 3. On Python 2, they shadow the
corresponding builtins, which normally have different semantics on Python 3
versus 2, to provide their Python 3 semantics.
Standard library reorganization
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
``future`` supports the standard library reorganization (PEP 3108) through the
following Py3 interfaces:
>>> # Top-level packages with Py3 names provided on Py2:
>>> import html.parser
>>> import queue
>>> import tkinter.dialog
>>> import xmlrpc.client
>>> # etc.
>>> # Aliases provided for extensions to existing Py2 module names:
>>> from future.standard_library import install_aliases
>>> install_aliases()
>>> from collections import Counter, OrderedDict # backported to Py2.6
>>> from collections import UserDict, UserList, UserString
>>> import urllib.request
>>> from itertools import filterfalse, zip_longest
>>> from subprocess import getoutput, getstatusoutput
Automatic conversion
--------------------
An included script called `futurize
<https://python-future.org/automatic_conversion.html>`_ aids in converting
code (from either Python 2 or Python 3) to code compatible with both
platforms. It is similar to ``python-modernize`` but goes further in
providing Python 3 compatibility through the use of the backported types
and builtin functions in ``future``.
Documentation
-------------
See: https://python-future.org
Credits
-------
:Author: Ed Schofield, Jordan M. Adler, et al
:Sponsor: Python Charmers: https://pythoncharmers.com
:Others: See docs/credits.rst or https://python-future.org/credits.html
Licensing
---------
Copyright 2013-2024 Python Charmers, Australia.
The software is distributed under an MIT licence. See LICENSE.txt.
�futurez Ed Schofield�MITz@Copyright 2013-2024 Python Charmers (https://pythoncharmers.com)� � � z
%d.%d.%d%sN)
�__doc__� __title__�
__author__� __license__�
__copyright__Z
__ver_major__Z
__ver_minor__Z
__ver_patch__Z __ver_sub__� __version__� r r �9/usr/local/lib/python3.9/site-packages/future/__init__.py�<module> s R�PK �Au\Nw��* * future/types/newopen.pynu �[��� """
A substitute for the Python 3 open() function.
Note that io.open() is more complete but maybe slower. Even so, the
completeness may be a better default. TODO: compare these
"""
_builtin_open = open
class newopen(object):
"""Wrapper providing key part of Python 3 open() interface.
From IPython's py3compat.py module. License: BSD.
"""
def __init__(self, fname, mode="r", encoding="utf-8"):
self.f = _builtin_open(fname, mode)
self.enc = encoding
def write(self, s):
return self.f.write(s.encode(self.enc))
def read(self, size=-1):
return self.f.read(size).decode(self.enc)
def close(self):
return self.f.close()
def __enter__(self):
return self
def __exit__(self, etype, value, traceback):
self.f.close()
PK �Au\l��9�= �= future/types/newstr.pynu �[��� """
This module redefines ``str`` on Python 2.x to be a subclass of the Py2
``unicode`` type that behaves like the Python 3.x ``str``.
The main differences between ``newstr`` and Python 2.x's ``unicode`` type are
the stricter type-checking and absence of a `u''` prefix in the representation.
It is designed to be used together with the ``unicode_literals`` import
as follows:
>>> from __future__ import unicode_literals
>>> from builtins import str, isinstance
On Python 3.x and normally on Python 2.x, these expressions hold
>>> str('blah') is 'blah'
True
>>> isinstance('blah', str)
True
However, on Python 2.x, with this import:
>>> from __future__ import unicode_literals
the same expressions are False:
>>> str('blah') is 'blah'
False
>>> isinstance('blah', str)
False
This module is designed to be imported together with ``unicode_literals`` on
Python 2 to bring the meaning of ``str`` back into alignment with unprefixed
string literals (i.e. ``unicode`` subclasses).
Note that ``str()`` (and ``print()``) would then normally call the
``__unicode__`` method on objects in Python 2. To define string
representations of your objects portably across Py3 and Py2, use the
:func:`python_2_unicode_compatible` decorator in :mod:`future.utils`.
"""
from numbers import Number
from future.utils import PY3, istext, with_metaclass, isnewbytes
from future.types import no, issubset
from future.types.newobject import newobject
if PY3:
# We'll probably never use newstr on Py3 anyway...
unicode = str
from collections.abc import Iterable
else:
from collections import Iterable
class BaseNewStr(type):
def __instancecheck__(cls, instance):
if cls == newstr:
return isinstance(instance, unicode)
else:
return issubclass(instance.__class__, cls)
class newstr(with_metaclass(BaseNewStr, unicode)):
"""
A backport of the Python 3 str object to Py2
"""
no_convert_msg = "Can't convert '{0}' object to str implicitly"
def __new__(cls, *args, **kwargs):
"""
From the Py3 str docstring:
str(object='') -> str
str(bytes_or_buffer[, encoding[, errors]]) -> str
Create a new string object from the given object. If encoding or
errors is specified, then the object must expose a data buffer
that will be decoded using the given encoding and error handler.
Otherwise, returns the result of object.__str__() (if defined)
or repr(object).
encoding defaults to sys.getdefaultencoding().
errors defaults to 'strict'.
"""
if len(args) == 0:
return super(newstr, cls).__new__(cls)
# Special case: If someone requests str(str(u'abc')), return the same
# object (same id) for consistency with Py3.3. This is not true for
# other objects like list or dict.
elif type(args[0]) == newstr and cls == newstr:
return args[0]
elif isinstance(args[0], unicode):
value = args[0]
elif isinstance(args[0], bytes): # i.e. Py2 bytes or newbytes
if 'encoding' in kwargs or len(args) > 1:
value = args[0].decode(*args[1:], **kwargs)
else:
value = args[0].__str__()
else:
value = args[0]
return super(newstr, cls).__new__(cls, value)
def __repr__(self):
"""
Without the u prefix
"""
value = super(newstr, self).__repr__()
# assert value[0] == u'u'
return value[1:]
def __getitem__(self, y):
"""
Warning: Python <= 2.7.6 has a bug that causes this method never to be called
when y is a slice object. Therefore the type of newstr()[:2] is wrong
(unicode instead of newstr).
"""
return newstr(super(newstr, self).__getitem__(y))
def __contains__(self, key):
errmsg = "'in <string>' requires string as left operand, not {0}"
# Don't use isinstance() here because we only want to catch
# newstr, not Python 2 unicode:
if type(key) == newstr:
newkey = key
elif isinstance(key, unicode) or isinstance(key, bytes) and not isnewbytes(key):
newkey = newstr(key)
else:
raise TypeError(errmsg.format(type(key)))
return issubset(list(newkey), list(self))
@no('newbytes')
def __add__(self, other):
return newstr(super(newstr, self).__add__(other))
@no('newbytes')
def __radd__(self, left):
" left + self "
try:
return newstr(left) + self
except:
return NotImplemented
def __mul__(self, other):
return newstr(super(newstr, self).__mul__(other))
def __rmul__(self, other):
return newstr(super(newstr, self).__rmul__(other))
def join(self, iterable):
errmsg = 'sequence item {0}: expected unicode string, found bytes'
for i, item in enumerate(iterable):
# Here we use type() rather than isinstance() because
# __instancecheck__ is being overridden. E.g.
# isinstance(b'abc', newbytes) is True on Py2.
if isnewbytes(item):
raise TypeError(errmsg.format(i))
# Support use as a staticmethod: str.join('-', ['a', 'b'])
if type(self) == newstr:
return newstr(super(newstr, self).join(iterable))
else:
return newstr(super(newstr, newstr(self)).join(iterable))
@no('newbytes')
def find(self, sub, *args):
return super(newstr, self).find(sub, *args)
@no('newbytes')
def rfind(self, sub, *args):
return super(newstr, self).rfind(sub, *args)
@no('newbytes', (1, 2))
def replace(self, old, new, *args):
return newstr(super(newstr, self).replace(old, new, *args))
def decode(self, *args):
raise AttributeError("decode method has been disabled in newstr")
def encode(self, encoding='utf-8', errors='strict'):
"""
Returns bytes
Encode S using the codec registered for encoding. Default encoding
is 'utf-8'. errors may be given to set a different error
handling scheme. Default is 'strict' meaning that encoding errors raise
a UnicodeEncodeError. Other possible values are 'ignore', 'replace' and
'xmlcharrefreplace' as well as any other name registered with
codecs.register_error that can handle UnicodeEncodeErrors.
"""
from future.types.newbytes import newbytes
# Py2 unicode.encode() takes encoding and errors as optional parameter,
# not keyword arguments as in Python 3 str.
# For the surrogateescape error handling mechanism, the
# codecs.register_error() function seems to be inadequate for an
# implementation of it when encoding. (Decoding seems fine, however.)
# For example, in the case of
# u'\udcc3'.encode('ascii', 'surrogateescape_handler')
# after registering the ``surrogateescape_handler`` function in
# future.utils.surrogateescape, both Python 2.x and 3.x raise an
# exception anyway after the function is called because the unicode
# string it has to return isn't encodable strictly as ASCII.
if errors == 'surrogateescape':
if encoding == 'utf-16':
# Known to fail here. See test_encoding_works_normally()
raise NotImplementedError('FIXME: surrogateescape handling is '
'not yet implemented properly')
# Encode char by char, building up list of byte-strings
mybytes = []
for c in self:
code = ord(c)
if 0xD800 <= code <= 0xDCFF:
mybytes.append(newbytes([code - 0xDC00]))
else:
mybytes.append(c.encode(encoding=encoding))
return newbytes(b'').join(mybytes)
return newbytes(super(newstr, self).encode(encoding, errors))
@no('newbytes', 1)
def startswith(self, prefix, *args):
if isinstance(prefix, Iterable):
for thing in prefix:
if isnewbytes(thing):
raise TypeError(self.no_convert_msg.format(type(thing)))
return super(newstr, self).startswith(prefix, *args)
@no('newbytes', 1)
def endswith(self, prefix, *args):
# Note we need the decorator above as well as the isnewbytes()
# check because prefix can be either a bytes object or e.g. a
# tuple of possible prefixes. (If it's a bytes object, each item
# in it is an int.)
if isinstance(prefix, Iterable):
for thing in prefix:
if isnewbytes(thing):
raise TypeError(self.no_convert_msg.format(type(thing)))
return super(newstr, self).endswith(prefix, *args)
@no('newbytes', 1)
def split(self, sep=None, maxsplit=-1):
# Py2 unicode.split() takes maxsplit as an optional parameter,
# not as a keyword argument as in Python 3 str.
parts = super(newstr, self).split(sep, maxsplit)
return [newstr(part) for part in parts]
@no('newbytes', 1)
def rsplit(self, sep=None, maxsplit=-1):
# Py2 unicode.rsplit() takes maxsplit as an optional parameter,
# not as a keyword argument as in Python 3 str.
parts = super(newstr, self).rsplit(sep, maxsplit)
return [newstr(part) for part in parts]
@no('newbytes', 1)
def partition(self, sep):
parts = super(newstr, self).partition(sep)
return tuple(newstr(part) for part in parts)
@no('newbytes', 1)
def rpartition(self, sep):
parts = super(newstr, self).rpartition(sep)
return tuple(newstr(part) for part in parts)
@no('newbytes', 1)
def index(self, sub, *args):
"""
Like newstr.find() but raise ValueError when the substring is not
found.
"""
pos = self.find(sub, *args)
if pos == -1:
raise ValueError('substring not found')
return pos
def splitlines(self, keepends=False):
"""
S.splitlines(keepends=False) -> list of strings
Return a list of the lines in S, breaking at line boundaries.
Line breaks are not included in the resulting list unless keepends
is given and true.
"""
# Py2 unicode.splitlines() takes keepends as an optional parameter,
# not as a keyword argument as in Python 3 str.
parts = super(newstr, self).splitlines(keepends)
return [newstr(part) for part in parts]
def __eq__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__eq__(other)
else:
return NotImplemented
def __hash__(self):
if (isinstance(self, unicode) or
isinstance(self, bytes) and not isnewbytes(self)):
return super(newstr, self).__hash__()
else:
raise NotImplementedError()
def __ne__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__ne__(other)
else:
return True
unorderable_err = 'unorderable types: str() and {0}'
def __lt__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__lt__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __le__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__le__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __gt__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__gt__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __ge__(self, other):
if (isinstance(other, unicode) or
isinstance(other, bytes) and not isnewbytes(other)):
return super(newstr, self).__ge__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __getattribute__(self, name):
"""
A trick to cause the ``hasattr`` builtin-fn to return False for
the 'decode' method on Py2.
"""
if name in ['decode', u'decode']:
raise AttributeError("decode method has been disabled in newstr")
return super(newstr, self).__getattribute__(name)
def __native__(self):
"""
A hook for the future.utils.native() function.
"""
return unicode(self)
@staticmethod
def maketrans(x, y=None, z=None):
"""
Return a translation table usable for str.translate().
If there is only one argument, it must be a dictionary mapping Unicode
ordinals (integers) or characters to Unicode ordinals, strings or None.
Character keys will be then converted to ordinals.
If there are two arguments, they must be strings of equal length, and
in the resulting dictionary, each character in x will be mapped to the
character at the same position in y. If there is a third argument, it
must be a string, whose characters will be mapped to None in the result.
"""
if y is None:
assert z is None
if not isinstance(x, dict):
raise TypeError('if you give only one argument to maketrans it must be a dict')
result = {}
for (key, value) in x.items():
if len(key) > 1:
raise ValueError('keys in translate table must be strings or integers')
result[ord(key)] = value
else:
if not isinstance(x, unicode) and isinstance(y, unicode):
raise TypeError('x and y must be unicode strings')
if not len(x) == len(y):
raise ValueError('the first two maketrans arguments must have equal length')
result = {}
for (xi, yi) in zip(x, y):
if len(xi) > 1:
raise ValueError('keys in translate table must be strings or integers')
result[ord(xi)] = ord(yi)
if z is not None:
for char in z:
result[ord(char)] = None
return result
def translate(self, table):
"""
S.translate(table) -> str
Return a copy of the string S, where all characters have been mapped
through the given translation table, which must be a mapping of
Unicode ordinals to Unicode ordinals, strings, or None.
Unmapped characters are left untouched. Characters mapped to None
are deleted.
"""
l = []
for c in self:
if ord(c) in table:
val = table[ord(c)]
if val is None:
continue
elif isinstance(val, unicode):
l.append(val)
else:
l.append(chr(val))
else:
l.append(c)
return ''.join(l)
def isprintable(self):
raise NotImplementedError('fixme')
def isidentifier(self):
raise NotImplementedError('fixme')
def format_map(self):
raise NotImplementedError('fixme')
__all__ = ['newstr']
PK �Au\��]� � future/types/__init__.pynu �[��� """
This module contains backports the data types that were significantly changed
in the transition from Python 2 to Python 3.
- an implementation of Python 3's bytes object (pure Python subclass of
Python 2's builtin 8-bit str type)
- an implementation of Python 3's str object (pure Python subclass of
Python 2's builtin unicode type)
- a backport of the range iterator from Py3 with slicing support
It is used as follows::
from __future__ import division, absolute_import, print_function
from builtins import bytes, dict, int, range, str
to bring in the new semantics for these functions from Python 3. And
then, for example::
b = bytes(b'ABCD')
assert list(b) == [65, 66, 67, 68]
assert repr(b) == "b'ABCD'"
assert [65, 66] in b
# These raise TypeErrors:
# b + u'EFGH'
# b.split(u'B')
# bytes(b',').join([u'Fred', u'Bill'])
s = str(u'ABCD')
# These raise TypeErrors:
# s.join([b'Fred', b'Bill'])
# s.startswith(b'A')
# b'B' in s
# s.find(b'A')
# s.replace(u'A', b'a')
# This raises an AttributeError:
# s.decode('utf-8')
assert repr(s) == 'ABCD' # consistent repr with Py3 (no u prefix)
for i in range(10**11)[:10]:
pass
and::
class VerboseList(list):
def append(self, item):
print('Adding an item')
super().append(item) # new simpler super() function
For more information:
---------------------
- future.types.newbytes
- future.types.newdict
- future.types.newint
- future.types.newobject
- future.types.newrange
- future.types.newstr
Notes
=====
range()
-------
``range`` is a custom class that backports the slicing behaviour from
Python 3 (based on the ``xrange`` module by Dan Crosta). See the
``newrange`` module docstring for more details.
super()
-------
``super()`` is based on Ryan Kelly's ``magicsuper`` module. See the
``newsuper`` module docstring for more details.
round()
-------
Python 3 modifies the behaviour of ``round()`` to use "Banker's Rounding".
See http://stackoverflow.com/a/10825998. See the ``newround`` module
docstring for more details.
"""
from __future__ import absolute_import, division, print_function
import functools
from numbers import Integral
from future import utils
# Some utility functions to enforce strict type-separation of unicode str and
# bytes:
def disallow_types(argnums, disallowed_types):
"""
A decorator that raises a TypeError if any of the given numbered
arguments is of the corresponding given type (e.g. bytes or unicode
string).
For example:
@disallow_types([0, 1], [unicode, bytes])
def f(a, b):
pass
raises a TypeError when f is called if a unicode object is passed as
`a` or a bytes object is passed as `b`.
This also skips over keyword arguments, so
@disallow_types([0, 1], [unicode, bytes])
def g(a, b=None):
pass
doesn't raise an exception if g is called with only one argument a,
e.g.:
g(b'Byte string')
Example use:
>>> class newbytes(object):
... @disallow_types([1], [unicode])
... def __add__(self, other):
... pass
>>> newbytes('1234') + u'1234' #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
TypeError: can't concat 'bytes' to (unicode) str
"""
def decorator(function):
@functools.wraps(function)
def wrapper(*args, **kwargs):
# These imports are just for this decorator, and are defined here
# to prevent circular imports:
from .newbytes import newbytes
from .newint import newint
from .newstr import newstr
errmsg = "argument can't be {0}"
for (argnum, mytype) in zip(argnums, disallowed_types):
# Handle the case where the type is passed as a string like 'newbytes'.
if isinstance(mytype, str) or isinstance(mytype, bytes):
mytype = locals()[mytype]
# Only restrict kw args only if they are passed:
if len(args) <= argnum:
break
# Here we use type() rather than isinstance() because
# __instancecheck__ is being overridden. E.g.
# isinstance(b'abc', newbytes) is True on Py2.
if type(args[argnum]) == mytype:
raise TypeError(errmsg.format(mytype))
return function(*args, **kwargs)
return wrapper
return decorator
def no(mytype, argnums=(1,)):
"""
A shortcut for the disallow_types decorator that disallows only one type
(in any position in argnums).
Example use:
>>> class newstr(object):
... @no('bytes')
... def __add__(self, other):
... pass
>>> newstr(u'1234') + b'1234' #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
TypeError: argument can't be bytes
The object can also be passed directly, but passing the string helps
to prevent circular import problems.
"""
if isinstance(argnums, Integral):
argnums = (argnums,)
disallowed_types = [mytype] * len(argnums)
return disallow_types(argnums, disallowed_types)
def issubset(list1, list2):
"""
Examples:
>>> issubset([], [65, 66, 67])
True
>>> issubset([65], [65, 66, 67])
True
>>> issubset([65, 66], [65, 66, 67])
True
>>> issubset([65, 67], [65, 66, 67])
False
"""
n = len(list1)
for startpos in range(len(list2) - n + 1):
if list2[startpos:startpos+n] == list1:
return True
return False
if utils.PY3:
import builtins
bytes = builtins.bytes
dict = builtins.dict
int = builtins.int
list = builtins.list
object = builtins.object
range = builtins.range
str = builtins.str
# The identity mapping
newtypes = {bytes: bytes,
dict: dict,
int: int,
list: list,
object: object,
range: range,
str: str}
__all__ = ['newtypes']
else:
from .newbytes import newbytes
from .newdict import newdict
from .newint import newint
from .newlist import newlist
from .newrange import newrange
from .newobject import newobject
from .newstr import newstr
newtypes = {bytes: newbytes,
dict: newdict,
int: newint,
long: newint,
list: newlist,
object: newobject,
range: newrange,
str: newbytes,
unicode: newstr}
__all__ = ['newbytes', 'newdict', 'newint', 'newlist', 'newrange', 'newstr', 'newtypes']
PK �Au\#6�� � future/types/newrange.pynu �[��� """
Nearly identical to xrange.py, by Dan Crosta, from
https://github.com/dcrosta/xrange.git
This is included here in the ``future`` package rather than pointed to as
a dependency because there is no package for ``xrange`` on PyPI. It is
also tweaked to appear like a regular Python 3 ``range`` object rather
than a Python 2 xrange.
From Dan Crosta's README:
"A pure-Python implementation of Python 2.7's xrange built-in, with
some features backported from the Python 3.x range built-in (which
replaced xrange) in that version."
Read more at
https://late.am/post/2012/06/18/what-the-heck-is-an-xrange
"""
from __future__ import absolute_import
from future.utils import PY2
if PY2:
from collections import Sequence, Iterator
else:
from collections.abc import Sequence, Iterator
from itertools import islice
from future.backports.misc import count # with step parameter on Py2.6
# For backward compatibility with python-future versions < 0.14.4:
_count = count
class newrange(Sequence):
"""
Pure-Python backport of Python 3's range object. See `the CPython
documentation for details:
<http://docs.python.org/py3k/library/functions.html#range>`_
"""
def __init__(self, *args):
if len(args) == 1:
start, stop, step = 0, args[0], 1
elif len(args) == 2:
start, stop, step = args[0], args[1], 1
elif len(args) == 3:
start, stop, step = args
else:
raise TypeError('range() requires 1-3 int arguments')
try:
start, stop, step = int(start), int(stop), int(step)
except ValueError:
raise TypeError('an integer is required')
if step == 0:
raise ValueError('range() arg 3 must not be zero')
elif step < 0:
stop = min(stop, start)
else:
stop = max(stop, start)
self._start = start
self._stop = stop
self._step = step
self._len = (stop - start) // step + bool((stop - start) % step)
@property
def start(self):
return self._start
@property
def stop(self):
return self._stop
@property
def step(self):
return self._step
def __repr__(self):
if self._step == 1:
return 'range(%d, %d)' % (self._start, self._stop)
return 'range(%d, %d, %d)' % (self._start, self._stop, self._step)
def __eq__(self, other):
return (isinstance(other, newrange) and
(self._len == 0 == other._len or
(self._start, self._step, self._len) ==
(other._start, other._step, other._len)))
def __len__(self):
return self._len
def index(self, value):
"""Return the 0-based position of integer `value` in
the sequence this range represents."""
try:
diff = value - self._start
except TypeError:
raise ValueError('%r is not in range' % value)
quotient, remainder = divmod(diff, self._step)
if remainder == 0 and 0 <= quotient < self._len:
return abs(quotient)
raise ValueError('%r is not in range' % value)
def count(self, value):
"""Return the number of occurrences of integer `value`
in the sequence this range represents."""
# a value can occur exactly zero or one times
return int(value in self)
def __contains__(self, value):
"""Return ``True`` if the integer `value` occurs in
the sequence this range represents."""
try:
self.index(value)
return True
except ValueError:
return False
def __reversed__(self):
return iter(self[::-1])
def __getitem__(self, index):
"""Return the element at position ``index`` in the sequence
this range represents, or raise :class:`IndexError` if the
position is out of range."""
if isinstance(index, slice):
return self.__getitem_slice(index)
if index < 0:
# negative indexes access from the end
index = self._len + index
if index < 0 or index >= self._len:
raise IndexError('range object index out of range')
return self._start + index * self._step
def __getitem_slice(self, slce):
"""Return a range which represents the requested slce
of the sequence represented by this range.
"""
scaled_indices = (self._step * n for n in slce.indices(self._len))
start_offset, stop_offset, new_step = scaled_indices
return newrange(self._start + start_offset,
self._start + stop_offset,
new_step)
def __iter__(self):
"""Return an iterator which enumerates the elements of the
sequence this range represents."""
return range_iterator(self)
class range_iterator(Iterator):
"""An iterator for a :class:`range`.
"""
def __init__(self, range_):
self._stepper = islice(count(range_.start, range_.step), len(range_))
def __iter__(self):
return self
def __next__(self):
return next(self._stepper)
def next(self):
return next(self._stepper)
__all__ = ['newrange']
PK �Au\�� �� � future/types/newmemoryview.pynu �[��� """
A pretty lame implementation of a memoryview object for Python 2.6.
"""
from numbers import Integral
import string
from future.utils import istext, isbytes, PY2, with_metaclass
from future.types import no, issubset
if PY2:
from collections import Iterable
else:
from collections.abc import Iterable
# class BaseNewBytes(type):
# def __instancecheck__(cls, instance):
# return isinstance(instance, _builtin_bytes)
class newmemoryview(object): # with_metaclass(BaseNewBytes, _builtin_bytes)):
"""
A pretty lame backport of the Python 2.7 and Python 3.x
memoryviewview object to Py2.6.
"""
def __init__(self, obj):
return obj
__all__ = ['newmemoryview']
PK �Au\���� � future/types/newlist.pynu �[��� """
A list subclass for Python 2 that behaves like Python 3's list.
The primary difference is that lists have a .copy() method in Py3.
Example use:
>>> from builtins import list
>>> l1 = list() # instead of {} for an empty list
>>> l1.append('hello')
>>> l2 = l1.copy()
"""
import sys
import copy
from future.utils import with_metaclass
from future.types.newobject import newobject
_builtin_list = list
ver = sys.version_info[:2]
class BaseNewList(type):
def __instancecheck__(cls, instance):
if cls == newlist:
return isinstance(instance, _builtin_list)
else:
return issubclass(instance.__class__, cls)
class newlist(with_metaclass(BaseNewList, _builtin_list)):
"""
A backport of the Python 3 list object to Py2
"""
def copy(self):
"""
L.copy() -> list -- a shallow copy of L
"""
return copy.copy(self)
def clear(self):
"""L.clear() -> None -- remove all items from L"""
for i in range(len(self)):
self.pop()
def __new__(cls, *args, **kwargs):
"""
list() -> new empty list
list(iterable) -> new list initialized from iterable's items
"""
if len(args) == 0:
return super(newlist, cls).__new__(cls)
elif type(args[0]) == newlist:
value = args[0]
else:
value = args[0]
return super(newlist, cls).__new__(cls, value)
def __add__(self, value):
return newlist(super(newlist, self).__add__(value))
def __radd__(self, left):
" left + self "
try:
return newlist(left) + self
except:
return NotImplemented
def __getitem__(self, y):
"""
x.__getitem__(y) <==> x[y]
Warning: a bug in Python 2.x prevents indexing via a slice from
returning a newlist object.
"""
if isinstance(y, slice):
return newlist(super(newlist, self).__getitem__(y))
else:
return super(newlist, self).__getitem__(y)
def __native__(self):
"""
Hook for the future.utils.native() function
"""
return list(self)
def __nonzero__(self):
return len(self) > 0
__all__ = ['newlist']
PK �Au\�pU�^4 ^4 future/types/newint.pynu �[��� """
Backport of Python 3's int, based on Py2's long.
They are very similar. The most notable difference is:
- representation: trailing L in Python 2 removed in Python 3
"""
from __future__ import division
import struct
from future.types.newbytes import newbytes
from future.types.newobject import newobject
from future.utils import PY3, isint, istext, isbytes, with_metaclass, native
if PY3:
long = int
from collections.abc import Iterable
else:
from collections import Iterable
class BaseNewInt(type):
def __instancecheck__(cls, instance):
if cls == newint:
# Special case for Py2 short or long int
return isinstance(instance, (int, long))
else:
return issubclass(instance.__class__, cls)
class newint(with_metaclass(BaseNewInt, long)):
"""
A backport of the Python 3 int object to Py2
"""
def __new__(cls, x=0, base=10):
"""
From the Py3 int docstring:
| int(x=0) -> integer
| int(x, base=10) -> integer
|
| Convert a number or string to an integer, or return 0 if no
| arguments are given. If x is a number, return x.__int__(). For
| floating point numbers, this truncates towards zero.
|
| If x is not a number or if base is given, then x must be a string,
| bytes, or bytearray instance representing an integer literal in the
| given base. The literal can be preceded by '+' or '-' and be
| surrounded by whitespace. The base defaults to 10. Valid bases are
| 0 and 2-36. Base 0 means to interpret the base from the string as an
| integer literal.
| >>> int('0b100', base=0)
| 4
"""
try:
val = x.__int__()
except AttributeError:
val = x
else:
if not isint(val):
raise TypeError('__int__ returned non-int ({0})'.format(
type(val)))
if base != 10:
# Explicit base
if not (istext(val) or isbytes(val) or isinstance(val, bytearray)):
raise TypeError(
"int() can't convert non-string with explicit base")
try:
return super(newint, cls).__new__(cls, val, base)
except TypeError:
return super(newint, cls).__new__(cls, newbytes(val), base)
# After here, base is 10
try:
return super(newint, cls).__new__(cls, val)
except TypeError:
# Py2 long doesn't handle bytearray input with an explicit base, so
# handle this here.
# Py3: int(bytearray(b'10'), 2) == 2
# Py2: int(bytearray(b'10'), 2) == 2 raises TypeError
# Py2: long(bytearray(b'10'), 2) == 2 raises TypeError
try:
return super(newint, cls).__new__(cls, newbytes(val))
except:
raise TypeError("newint argument must be a string or a number,"
"not '{0}'".format(type(val)))
def __repr__(self):
"""
Without the L suffix
"""
value = super(newint, self).__repr__()
assert value[-1] == 'L'
return value[:-1]
def __add__(self, other):
value = super(newint, self).__add__(other)
if value is NotImplemented:
return long(self) + other
return newint(value)
def __radd__(self, other):
value = super(newint, self).__radd__(other)
if value is NotImplemented:
return other + long(self)
return newint(value)
def __sub__(self, other):
value = super(newint, self).__sub__(other)
if value is NotImplemented:
return long(self) - other
return newint(value)
def __rsub__(self, other):
value = super(newint, self).__rsub__(other)
if value is NotImplemented:
return other - long(self)
return newint(value)
def __mul__(self, other):
value = super(newint, self).__mul__(other)
if isint(value):
return newint(value)
elif value is NotImplemented:
return long(self) * other
return value
def __rmul__(self, other):
value = super(newint, self).__rmul__(other)
if isint(value):
return newint(value)
elif value is NotImplemented:
return other * long(self)
return value
def __div__(self, other):
# We override this rather than e.g. relying on object.__div__ or
# long.__div__ because we want to wrap the value in a newint()
# call if other is another int
value = long(self) / other
if isinstance(other, (int, long)):
return newint(value)
else:
return value
def __rdiv__(self, other):
value = other / long(self)
if isinstance(other, (int, long)):
return newint(value)
else:
return value
def __idiv__(self, other):
# long has no __idiv__ method. Use __itruediv__ and cast back to
# newint:
value = self.__itruediv__(other)
if isinstance(other, (int, long)):
return newint(value)
else:
return value
def __truediv__(self, other):
value = super(newint, self).__truediv__(other)
if value is NotImplemented:
value = long(self) / other
return value
def __rtruediv__(self, other):
return super(newint, self).__rtruediv__(other)
def __itruediv__(self, other):
# long has no __itruediv__ method
mylong = long(self)
mylong /= other
return mylong
def __floordiv__(self, other):
return newint(super(newint, self).__floordiv__(other))
def __rfloordiv__(self, other):
return newint(super(newint, self).__rfloordiv__(other))
def __ifloordiv__(self, other):
# long has no __ifloordiv__ method
mylong = long(self)
mylong //= other
return newint(mylong)
def __mod__(self, other):
value = super(newint, self).__mod__(other)
if value is NotImplemented:
return long(self) % other
return newint(value)
def __rmod__(self, other):
value = super(newint, self).__rmod__(other)
if value is NotImplemented:
return other % long(self)
return newint(value)
def __divmod__(self, other):
value = super(newint, self).__divmod__(other)
if value is NotImplemented:
mylong = long(self)
return (mylong // other, mylong % other)
return (newint(value[0]), newint(value[1]))
def __rdivmod__(self, other):
value = super(newint, self).__rdivmod__(other)
if value is NotImplemented:
mylong = long(self)
return (other // mylong, other % mylong)
return (newint(value[0]), newint(value[1]))
def __pow__(self, other):
value = super(newint, self).__pow__(other)
if value is NotImplemented:
return long(self) ** other
return newint(value)
def __rpow__(self, other):
value = super(newint, self).__rpow__(other)
if isint(value):
return newint(value)
elif value is NotImplemented:
return other ** long(self)
return value
def __lshift__(self, other):
if not isint(other):
raise TypeError(
"unsupported operand type(s) for <<: '%s' and '%s'" %
(type(self).__name__, type(other).__name__))
return newint(super(newint, self).__lshift__(other))
def __rshift__(self, other):
if not isint(other):
raise TypeError(
"unsupported operand type(s) for >>: '%s' and '%s'" %
(type(self).__name__, type(other).__name__))
return newint(super(newint, self).__rshift__(other))
def __and__(self, other):
if not isint(other):
raise TypeError(
"unsupported operand type(s) for &: '%s' and '%s'" %
(type(self).__name__, type(other).__name__))
return newint(super(newint, self).__and__(other))
def __or__(self, other):
if not isint(other):
raise TypeError(
"unsupported operand type(s) for |: '%s' and '%s'" %
(type(self).__name__, type(other).__name__))
return newint(super(newint, self).__or__(other))
def __xor__(self, other):
if not isint(other):
raise TypeError(
"unsupported operand type(s) for ^: '%s' and '%s'" %
(type(self).__name__, type(other).__name__))
return newint(super(newint, self).__xor__(other))
def __neg__(self):
return newint(super(newint, self).__neg__())
def __pos__(self):
return newint(super(newint, self).__pos__())
def __abs__(self):
return newint(super(newint, self).__abs__())
def __invert__(self):
return newint(super(newint, self).__invert__())
def __int__(self):
return self
def __nonzero__(self):
return self.__bool__()
def __bool__(self):
"""
So subclasses can override this, Py3-style
"""
if PY3:
return super(newint, self).__bool__()
return super(newint, self).__nonzero__()
def __native__(self):
return long(self)
def to_bytes(self, length, byteorder='big', signed=False):
"""
Return an array of bytes representing an integer.
The integer is represented using length bytes. An OverflowError is
raised if the integer is not representable with the given number of
bytes.
The byteorder argument determines the byte order used to represent the
integer. If byteorder is 'big', the most significant byte is at the
beginning of the byte array. If byteorder is 'little', the most
significant byte is at the end of the byte array. To request the native
byte order of the host system, use `sys.byteorder' as the byte order value.
The signed keyword-only argument determines whether two's complement is
used to represent the integer. If signed is False and a negative integer
is given, an OverflowError is raised.
"""
if length < 0:
raise ValueError("length argument must be non-negative")
if length == 0 and self == 0:
return newbytes()
if signed and self < 0:
bits = length * 8
num = (2**bits) + self
if num <= 0:
raise OverflowError("int too small to convert")
else:
if self < 0:
raise OverflowError("can't convert negative int to unsigned")
num = self
if byteorder not in ('little', 'big'):
raise ValueError("byteorder must be either 'little' or 'big'")
h = b'%x' % num
s = newbytes((b'0'*(len(h) % 2) + h).zfill(length*2).decode('hex'))
if signed:
high_set = s[0] & 0x80
if self > 0 and high_set:
raise OverflowError("int too big to convert")
if self < 0 and not high_set:
raise OverflowError("int too small to convert")
if len(s) > length:
raise OverflowError("int too big to convert")
return s if byteorder == 'big' else s[::-1]
@classmethod
def from_bytes(cls, mybytes, byteorder='big', signed=False):
"""
Return the integer represented by the given array of bytes.
The mybytes argument must either support the buffer protocol or be an
iterable object producing bytes. Bytes and bytearray are examples of
built-in objects that support the buffer protocol.
The byteorder argument determines the byte order used to represent the
integer. If byteorder is 'big', the most significant byte is at the
beginning of the byte array. If byteorder is 'little', the most
significant byte is at the end of the byte array. To request the native
byte order of the host system, use `sys.byteorder' as the byte order value.
The signed keyword-only argument indicates whether two's complement is
used to represent the integer.
"""
if byteorder not in ('little', 'big'):
raise ValueError("byteorder must be either 'little' or 'big'")
if isinstance(mybytes, unicode):
raise TypeError("cannot convert unicode objects to bytes")
# mybytes can also be passed as a sequence of integers on Py3.
# Test for this:
elif isinstance(mybytes, Iterable):
mybytes = newbytes(mybytes)
b = mybytes if byteorder == 'big' else mybytes[::-1]
if len(b) == 0:
b = b'\x00'
# The encode() method has been disabled by newbytes, but Py2's
# str has it:
num = int(native(b).encode('hex'), 16)
if signed and (b[0] & 0x80):
num = num - (2 ** (len(b)*8))
return cls(num)
# def _twos_comp(val, bits):
# """compute the 2's compliment of int value val"""
# if( (val&(1<<(bits-1))) != 0 ):
# val = val - (1<<bits)
# return val
__all__ = ['newint']
PK �Au\E[�]� � future/types/newdict.pynu �[��� """
A dict subclass for Python 2 that behaves like Python 3's dict
Example use:
>>> from builtins import dict
>>> d1 = dict() # instead of {} for an empty dict
>>> d2 = dict(key1='value1', key2='value2')
The keys, values and items methods now return iterators on Python 2.x
(with set-like behaviour on Python 2.7).
>>> for d in (d1, d2):
... assert not isinstance(d.keys(), list)
... assert not isinstance(d.values(), list)
... assert not isinstance(d.items(), list)
"""
import sys
from future.utils import with_metaclass
from future.types.newobject import newobject
_builtin_dict = dict
ver = sys.version_info
class BaseNewDict(type):
def __instancecheck__(cls, instance):
if cls == newdict:
return isinstance(instance, _builtin_dict)
else:
return issubclass(instance.__class__, cls)
class newdict(with_metaclass(BaseNewDict, _builtin_dict)):
"""
A backport of the Python 3 dict object to Py2
"""
if ver >= (3,):
# Inherit items, keys and values from `dict` in 3.x
pass
elif ver >= (2, 7):
items = dict.viewitems
keys = dict.viewkeys
values = dict.viewvalues
else:
items = dict.iteritems
keys = dict.iterkeys
values = dict.itervalues
def __new__(cls, *args, **kwargs):
"""
dict() -> new empty dictionary
dict(mapping) -> new dictionary initialized from a mapping object's
(key, value) pairs
dict(iterable) -> new dictionary initialized as if via:
d = {}
for k, v in iterable:
d[k] = v
dict(**kwargs) -> new dictionary initialized with the name=value pairs
in the keyword argument list. For example: dict(one=1, two=2)
"""
return super(newdict, cls).__new__(cls, *args)
def __native__(self):
"""
Hook for the future.utils.native() function
"""
return dict(self)
__all__ = ['newdict']
PK Bu\�
P^ ^ 0 future/types/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s: d Z ddlmZmZmZ ddlZddlmZ ddlm Z dd� Z
dd d
�Z d d � Z e j
r�ddlZejZejZejZejZejZejZejZeeeeeeeeeeeeeeiZd
gZn�ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z ddl m Z ddl m Z eeeeeee eeeee ee eee e i Zg d�ZdS )aY
This module contains backports the data types that were significantly changed
in the transition from Python 2 to Python 3.
- an implementation of Python 3's bytes object (pure Python subclass of
Python 2's builtin 8-bit str type)
- an implementation of Python 3's str object (pure Python subclass of
Python 2's builtin unicode type)
- a backport of the range iterator from Py3 with slicing support
It is used as follows::
from __future__ import division, absolute_import, print_function
from builtins import bytes, dict, int, range, str
to bring in the new semantics for these functions from Python 3. And
then, for example::
b = bytes(b'ABCD')
assert list(b) == [65, 66, 67, 68]
assert repr(b) == "b'ABCD'"
assert [65, 66] in b
# These raise TypeErrors:
# b + u'EFGH'
# b.split(u'B')
# bytes(b',').join([u'Fred', u'Bill'])
s = str(u'ABCD')
# These raise TypeErrors:
# s.join([b'Fred', b'Bill'])
# s.startswith(b'A')
# b'B' in s
# s.find(b'A')
# s.replace(u'A', b'a')
# This raises an AttributeError:
# s.decode('utf-8')
assert repr(s) == 'ABCD' # consistent repr with Py3 (no u prefix)
for i in range(10**11)[:10]:
pass
and::
class VerboseList(list):
def append(self, item):
print('Adding an item')
super().append(item) # new simpler super() function
For more information:
---------------------
- future.types.newbytes
- future.types.newdict
- future.types.newint
- future.types.newobject
- future.types.newrange
- future.types.newstr
Notes
=====
range()
-------
``range`` is a custom class that backports the slicing behaviour from
Python 3 (based on the ``xrange`` module by Dan Crosta). See the
``newrange`` module docstring for more details.
super()
-------
``super()`` is based on Ryan Kelly's ``magicsuper`` module. See the
``newsuper`` module docstring for more details.
round()
-------
Python 3 modifies the behaviour of ``round()`` to use "Banker's Rounding".
See http://stackoverflow.com/a/10825998. See the ``newround`` module
docstring for more details.
� )�absolute_import�division�print_functionN)�Integral)�utilsc s � �fdd�}|S )a�
A decorator that raises a TypeError if any of the given numbered
arguments is of the corresponding given type (e.g. bytes or unicode
string).
For example:
@disallow_types([0, 1], [unicode, bytes])
def f(a, b):
pass
raises a TypeError when f is called if a unicode object is passed as
`a` or a bytes object is passed as `b`.
This also skips over keyword arguments, so
@disallow_types([0, 1], [unicode, bytes])
def g(a, b=None):
pass
doesn't raise an exception if g is called with only one argument a,
e.g.:
g(b'Byte string')
Example use:
>>> class newbytes(object):
... @disallow_types([1], [unicode])
... def __add__(self, other):
... pass
>>> newbytes('1234') + u'1234' #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
TypeError: can't concat 'bytes' to (unicode) str
c s t �� ���� fdd��}|S )Nc s� ddl m } ddlm} ddlm} d}t� ��D ]T\}}t|t�sNt|t�rXt� | }t| �|krh q�t | | �|kr2t
|� |���q2�| i |��S )N� ��newbytes��newint��newstrzargument can't be {0}) r r r
�zip�
isinstance�str�bytes�locals�len�type� TypeError�format)�args�kwargsr r r
�errmsgZargnum�mytype)�argnums�disallowed_types�function� �?/usr/local/lib/python3.9/site-packages/future/types/__init__.py�wrapper� s
z2disallow_types.<locals>.decorator.<locals>.wrapper)� functools�wraps)r r �r r )r r � decorator� s z!disallow_types.<locals>.decoratorr )r r r$ r r# r �disallow_typesd s ' r% �r c C s( t |t�r|f}| gt|� }t||�S )a
A shortcut for the disallow_types decorator that disallows only one type
(in any position in argnums).
Example use:
>>> class newstr(object):
... @no('bytes')
... def __add__(self, other):
... pass
>>> newstr(u'1234') + b'1234' #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
TypeError: argument can't be bytes
The object can also be passed directly, but passing the string helps
to prevent circular import problems.
)r r r r% )r r r r r r �no� s
r' c C s@ t | �}tt |�| d �D ] }|||| � | kr dS q dS )z�
Examples:
>>> issubset([], [65, 66, 67])
True
>>> issubset([65], [65, 66, 67])
True
>>> issubset([65, 66], [65, 66, 67])
True
>>> issubset([65, 67], [65, 66, 67])
False
r TF)r �range)Zlist1Zlist2�n�startposr r r �issubset� s
r+ �newtypesr r )�newdictr
)�newlist)�newrange)� newobjectr )r r- r r. r/ r
r, )r& )!�__doc__�
__future__r r r r! Znumbersr �futurer r% r' r+ �PY3�builtinsr �dict�int�list�objectr( r r, �__all__r r- r r. r/ r0 r
�long�unicoder r r r �<module> sV Y F
� �
PK Bu\��r�) ) / future/types/__pycache__/newopen.cpython-39.pycnu �[��� a
��?h* � @ s d Z eZG dd� de�ZdS )z�
A substitute for the Python 3 open() function.
Note that io.open() is more complete but maybe slower. Even so, the
completeness may be a better default. TODO: compare these
c @ sD e Zd ZdZddd�Zdd� Zdd d
�Zd d � Zd
d� Zdd� Z dS )�newopenztWrapper providing key part of Python 3 open() interface.
From IPython's py3compat.py module. License: BSD.
�r�utf-8c C s t ||�| _|| _d S �N)�
_builtin_open�f�enc)�self�fname�mode�encoding� r �>/usr/local/lib/python3.9/site-packages/future/types/newopen.py�__init__ s znewopen.__init__c C s | j �|�| j��S r )r �write�encoder )r �sr r r
r s z
newopen.write���c C s | j �|��| j�S r )r �read�decoder )r �sizer r r
r s z newopen.readc C s
| j �� S r �r �close�r r r r
r s z
newopen.closec C s | S r r r r r r
� __enter__ s znewopen.__enter__c C s | j �� d S r r )r �etype�value� tracebackr r r
�__exit__ s znewopen.__exit__N)r r )r )
�__name__�
__module__� __qualname__�__doc__r r r r r r r r r r
r
s
r N)r! �openr �objectr r r r r
�<module> s PK Bu\�<� � / future/types/__pycache__/newlist.cpython-39.pycnu �[��� a
��?h� � @ sn d Z ddlZddlZddlmZ ddlmZ eZej dd� Z
G dd� de �Z G dd � d ee e��Z
d gZdS )
a
A list subclass for Python 2 that behaves like Python 3's list.
The primary difference is that lists have a .copy() method in Py3.
Example use:
>>> from builtins import list
>>> l1 = list() # instead of {} for an empty list
>>> l1.append('hello')
>>> l2 = l1.copy()
� N)�with_metaclass)� newobject� c @ s e Zd Zdd� ZdS )� BaseNewListc C s" | t krt|t�S t|j| �S d S �N)�newlist�
isinstance�
_builtin_list�
issubclass� __class__)�cls�instance� r �>/usr/local/lib/python3.9/site-packages/future/types/newlist.py�__instancecheck__ s
z BaseNewList.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r r s r c s` e Zd ZdZdd� Zdd� Z� fdd�Z� fdd �Zd
d � Z� fd d
�Z dd� Z
dd� Z � Z S )r z7
A backport of the Python 3 list object to Py2
c C s
t � | �S )z9
L.copy() -> list -- a shallow copy of L
)�copy��selfr r r r & s z newlist.copyc C s t t| ��D ] }| �� q dS )z,L.clear() -> None -- remove all items from LN)�range�len�pop)r �ir r r �clear, s z
newlist.clearc sP t |�dkr tt| ��| �S t|d �tkr6|d }n|d }tt| ��| |�S )zo
list() -> new empty list
list(iterable) -> new list initialized from iterable's items
r )r �superr �__new__�type)r �args�kwargs�value�r r r r 1 s
znewlist.__new__c s t tt | ��|��S r )r r �__add__)r r! r" r r r# ? s znewlist.__add__c C s$ zt |�| W S t Y S 0 dS )z
left + self N)r �NotImplemented)r �leftr r r �__radd__B s znewlist.__radd__c s2 t |t�r ttt| ��|��S tt| ��|�S dS )z�
x.__getitem__(y) <==> x[y]
Warning: a bug in Python 2.x prevents indexing via a slice from
returning a newlist object.
N)r �slicer r � __getitem__)r �yr" r r r( I s
znewlist.__getitem__c C s t | �S )z=
Hook for the future.utils.native() function
)�listr r r r �
__native__U s znewlist.__native__c C s t | �dkS )Nr )r r r r r � __nonzero__[ s znewlist.__nonzero__)
r r r �__doc__r r r r# r& r( r+ r, �
__classcell__r r r" r r " s r )r- �sysr Z future.utilsr Zfuture.types.newobjectr r* r � version_info�verr r r �__all__r r r r �<module> s =PK Bu\^�Ty1 1 . future/types/__pycache__/newint.cpython-39.pycnu �[��� a
��?h^4 � @ s� d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z m
Z
m Z m Z m
Z
mZ e rfeZddlmZ n ddlmZ G dd � d e�ZG d
d � d e
ee��Zd gZdS ) z�
Backport of Python 3's int, based on Py2's long.
They are very similar. The most notable difference is:
- representation: trailing L in Python 2 removed in Python 3
� )�divisionN)�newbytes)� newobject)�PY3�isint�istext�isbytes�with_metaclass�native)�Iterablec @ s e Zd Zdd� ZdS )�
BaseNewIntc C s& | t krt|ttf�S t|j| �S d S �N)�newint�
isinstance�int�long�
issubclass� __class__)�cls�instance� r �=/usr/local/lib/python3.9/site-packages/future/types/newint.py�__instancecheck__ s z BaseNewInt.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r r s r c s� e Zd ZdZdR� fdd� Z� fdd�Z� fdd �Z� fd
d �Z� fd d
�Z� fdd�Z � fdd�Z
� fdd�Z dd� Z dd� Z
dd� Z� fdd�Z� fd d �Zd d � Z� fd d!�Z� fd"d#�Zd$d%� Z� fd&d'�Z� fd(d)�Z� fd*d+�Z� fd,d-�Z� fd.d/�Z� fd0d1�Z� fd2d3�Z� fd4d5�Z � fd6d7�Z � fd8d9�Z � fd:d;�Z � fd<d=�Z � fd>d?�Z!� fd@dA�Z"� fdBdC�Z#dDdE� Z$dFdG� Z%� fdHdI�Z&dJdK� Z'dSdNdO�Z(e)dTdPdQ��Z*� Z+S )Ur z6
A backport of the Python 3 int object to Py2
r �
c s z |� � }W n ty" |}Y n 0 t|�s>td�t|����|dkr�t|�sht|�sht|t �shtd��zt
t | �� | ||�W S ty� t
t | �� | t
|�|� Y S 0 zt
t | �� | |�W S t�y z t
t | �� | t
|��W Y S td�t|����Y n0 Y n0 dS )a.
From the Py3 int docstring:
| int(x=0) -> integer
| int(x, base=10) -> integer
|
| Convert a number or string to an integer, or return 0 if no
| arguments are given. If x is a number, return x.__int__(). For
| floating point numbers, this truncates towards zero.
|
| If x is not a number or if base is given, then x must be a string,
| bytes, or bytearray instance representing an integer literal in the
| given base. The literal can be preceded by '+' or '-' and be
| surrounded by whitespace. The base defaults to 10. Valid bases are
| 0 and 2-36. Base 0 means to interpret the base from the string as an
| integer literal.
| >>> int('0b100', base=0)
| 4
z __int__ returned non-int ({0})r z1int() can't convert non-string with explicit basez6newint argument must be a string or a number,not '{0}'N)�__int__�AttributeErrorr � TypeError�format�typer r r � bytearray�superr �__new__r )r �x�base�val�r r r r$ % s4
�� �znewint.__new__c s* t t| ��� }|d dks J �|dd� S )z&
Without the L suffix
����LN)r# r �__repr__)�self�valuer( r r r+ [ s znewint.__repr__c s, t t| ��|�}|tu r$t| �| S t|�S r
)r# r �__add__�NotImplementedr �r, �otherr- r( r r r. c s znewint.__add__c s, t t| ��|�}|tu r$|t| � S t|�S r
)r# r �__radd__r/ r r0 r( r r r2 i s znewint.__radd__c s, t t| ��|�}|tu r$t| �| S t|�S r
)r# r �__sub__r/ r r0 r( r r r3 o s znewint.__sub__c s, t t| ��|�}|tu r$|t| � S t|�S r
)r# r �__rsub__r/ r r0 r( r r r4 u s znewint.__rsub__c s8 t t| ��|�}t|�r t|�S |tu r4t| �| S |S r
)r# r �__mul__r r/ r r0 r( r r r5 { s znewint.__mul__c s8 t t| ��|�}t|�r t|�S |tu r4|t| � S |S r
)r# r �__rmul__r r/ r r0 r( r r r6 � s znewint.__rmul__c C s* t | �| }t|tt f�r"t|�S |S d S r
�r r r r r0 r r r �__div__� s znewint.__div__c C s* |t | � }t|tt f�r"t|�S |S d S r
r7 r0 r r r �__rdiv__� s znewint.__rdiv__c C s( | � |�}t|ttf�r t|�S |S d S r
)� __itruediv__r r r r r0 r r r �__idiv__� s
znewint.__idiv__c s( t t| ��|�}|tu r$t| �| }|S r
)r# r � __truediv__r/ r r0 r( r r r< � s znewint.__truediv__c s t t| ��|�S r
)r# r � __rtruediv__�r, r1 r( r r r= � s znewint.__rtruediv__c C s t | �}|| }|S r
�r �r, r1 �mylongr r r r: � s znewint.__itruediv__c s t tt | ��|��S r
)r r# � __floordiv__r> r( r r rB � s znewint.__floordiv__c s t tt | ��|��S r
)r r# �
__rfloordiv__r> r( r r rC � s znewint.__rfloordiv__c C s t | �}|| }t|�S r
)r r r@ r r r �
__ifloordiv__� s znewint.__ifloordiv__c s, t t| ��|�}|tu r$t| �| S t|�S r
)r# r �__mod__r/ r r0 r( r r rE � s znewint.__mod__c s, t t| ��|�}|tu r$|t| � S t|�S r
)r# r �__rmod__r/ r r0 r( r r rF � s znewint.__rmod__c sH t t| ��|�}|tu r0t| �}|| || fS t|d �t|d �fS �Nr � )r# r �
__divmod__r/ r �r, r1 r- rA r( r r rI � s
znewint.__divmod__c sH t t| ��|�}|tu r0t| �}|| || fS t|d �t|d �fS rG )r# r � __rdivmod__r/ r rJ r( r r rK � s
znewint.__rdivmod__c s, t t| ��|�}|tu r$t| �| S t|�S r
)r# r �__pow__r/ r r0 r( r r rL � s znewint.__pow__c s8 t t| ��|�}t|�r t|�S |tu r4|t| � S |S r
)r# r �__rpow__r r/ r r0 r( r r rM � s znewint.__rpow__c s8 t |�s$tdt| �jt|�jf ��ttt| ��|��S )Nz1unsupported operand type(s) for <<: '%s' and '%s')r r r! r r r# �
__lshift__r> r( r r rN � s ��znewint.__lshift__c s8 t |�s$tdt| �jt|�jf ��ttt| ��|��S )Nz1unsupported operand type(s) for >>: '%s' and '%s')r r r! r r r# �
__rshift__r> r( r r rO � s ��znewint.__rshift__c s8 t |�s$tdt| �jt|�jf ��ttt| ��|��S )Nz0unsupported operand type(s) for &: '%s' and '%s')r r r! r r r# �__and__r> r( r r rP � s ��znewint.__and__c s8 t |�s$tdt| �jt|�jf ��ttt| ��|��S )Nz0unsupported operand type(s) for |: '%s' and '%s')r r r! r r r# �__or__r> r( r r rQ � s ��z
newint.__or__c s8 t |�s$tdt| �jt|�jf ��ttt| ��|��S )Nz0unsupported operand type(s) for ^: '%s' and '%s')r r r! r r r# �__xor__r> r( r r rR s ��znewint.__xor__c s t tt | ��� �S r
)r r# �__neg__�r, r( r r rS s znewint.__neg__c s t tt | ��� �S r
)r r# �__pos__rT r( r r rU s znewint.__pos__c s t tt | ��� �S r
)r r# �__abs__rT r( r r rV s znewint.__abs__c s t tt | ��� �S r
)r r# �
__invert__rT r( r r rW s znewint.__invert__c C s | S r
r rT r r r r s znewint.__int__c C s | � � S r
)�__bool__rT r r r � __nonzero__ s znewint.__nonzero__c s t rtt| ��� S tt| ��� S )z<
So subclasses can override this, Py3-style
)r r# r rX rY rT r( r r rX s znewint.__bool__c C s t | �S r
r? rT r r r �
__native__& s znewint.__native__�bigFc C s |dk rt d��|dkr&| dkr&t� S |rX| dk rX|d }d| | }|dkrltd��n| dk rhtd��| }|dvr|t d��d | }td
t|�d | �|d ��d ��}|r�|d d @ }| dkr�|r�td
��| dk r�|s�td��t|�|kr�td
��|dk�r|S |ddd� S )aG
Return an array of bytes representing an integer.
The integer is represented using length bytes. An OverflowError is
raised if the integer is not representable with the given number of
bytes.
The byteorder argument determines the byte order used to represent the
integer. If byteorder is 'big', the most significant byte is at the
beginning of the byte array. If byteorder is 'little', the most
significant byte is at the end of the byte array. To request the native
byte order of the host system, use `sys.byteorder' as the byte order value.
The signed keyword-only argument determines whether two's complement is
used to represent the integer. If signed is False and a negative integer
is given, an OverflowError is raised.
r z$length argument must be non-negative� � zint too small to convertz&can't convert negative int to unsigned��littler[ �*byteorder must be either 'little' or 'big's %x� 0�hex� zint too big to convertr[ Nr) )�
ValueErrorr �
OverflowError�len�zfill�decode) r, �length� byteorder�signed�bits�num�h�sZhigh_setr r r �to_bytes) s2
( znewint.to_bytesc C s� |dvrt d��t|t�r$td��nt|t�r6t|�}|dkrB|n |ddd� }t|�dkr`d}tt|�� d �d
�}|r�|d d @ r�|d t|�d
}| |�S )a'
Return the integer represented by the given array of bytes.
The mybytes argument must either support the buffer protocol or be an
iterable object producing bytes. Bytes and bytearray are examples of
built-in objects that support the buffer protocol.
The byteorder argument determines the byte order used to represent the
integer. If byteorder is 'big', the most significant byte is at the
beginning of the byte array. If byteorder is 'little', the most
significant byte is at the end of the byte array. To request the native
byte order of the host system, use `sys.byteorder' as the byte order value.
The signed keyword-only argument indicates whether two's complement is
used to represent the integer.
r^ r` z'cannot convert unicode objects to bytesr[ Nr) r � rb � rc r] r\ )
rd r �unicoder r r rf r r
�encode)r Zmybytesrj rk �brm r r r �
from_bytesV s
znewint.from_bytes)r r )r[ F)r[ F),r r r �__doc__r$ r+ r. r2 r3 r4 r5 r6 r8 r9 r; r< r= r: rB rC rD rE rF rI rK rL rM rN rO rP rQ rR rS rU rV rW r rY rX rZ rp � classmethodrv �
__classcell__r r r( r r ! sP 6
-r )rw �
__future__r �structZfuture.types.newbytesr Zfuture.types.newobjectr Z future.utilsr r r r r r
r r �collections.abcr � collectionsr! r r �__all__r r r r �<module> s cPK Bu\h/�P
P
1 future/types/__pycache__/newobject.cpython-39.pycnu �[��� a
��?h
� @ s d Z G dd� de�ZdgZdS )u�
An object subclass for Python 2 that gives new-style classes written in the
style of Python 3 (with ``__next__`` and unicode-returning ``__str__`` methods)
the appropriate Python 2-style ``next`` and ``__unicode__`` methods for compatible.
Example use::
from builtins import object
my_unicode_str = u'Unicode string: 孔子'
class A(object):
def __str__(self):
return my_unicode_str
a = A()
print(str(a))
# On Python 2, these relations hold:
assert unicode(a) == my_unicode_string
assert str(a) == my_unicode_string.encode('utf-8')
Another example::
from builtins import object
class Upper(object):
def __init__(self, iterable):
self._iter = iter(iterable)
def __next__(self): # note the Py3 interface
return next(self._iter).upper()
def __iter__(self):
return self
assert list(Upper('hello')) == list('HELLO')
c @ s< e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zg Z d S )
� newobjectz�
A magical object class that provides Python 2 compatibility methods::
next
__unicode__
__nonzero__
Subclasses of this class can merely define the Python 3 methods (__next__,
__str__, and __bool__).
c C s$ t | d�rt| ��| �S td��d S )N�__next__z newobject is not an iterator)�hasattr�typer � TypeError��self� r �@/usr/local/lib/python3.9/site-packages/future/types/newobject.py�next3 s
znewobject.nextc C s> t | d�rt| ��| �}nt| �}t|t�r0|S |�d�S d S )N�__str__zutf-8)r r r �str�
isinstance�unicode�decode)r �sr r r � __unicode__8 s
znewobject.__unicode__c C s4 t | d�rt| ��| �S t | d�r0t| ��| �S dS )N�__bool__�__len__T)r r r r r r r r � __nonzero__D s
znewobject.__nonzero__c C s t | d�stS | �� S )N�__int__)r �NotImplementedr r r r r �__long__S s
znewobject.__long__c C s t | �S )z=
Hook for the future.utils.native() function
)�objectr r r r �
__native__m s znewobject.__native__N)
�__name__�
__module__� __qualname__�__doc__r
r r r r � __slots__r r r r r ) s r N)r r r �__all__r r r r �<module> s (LPK Bu\ %��� � 5 future/types/__pycache__/newmemoryview.cpython-39.pycnu �[��� a
��?h� � @ sx d Z ddlmZ ddlZddlmZmZmZmZ ddl m
Z
m Z erRddl m
Z
n ddlm
Z
G dd� de�ZdgZdS ) zE
A pretty lame implementation of a memoryview object for Python 2.6.
� )�IntegralN)�istext�isbytes�PY2�with_metaclass)�no�issubset)�Iterablec @ s e Zd ZdZdd� ZdS )�
newmemoryviewze
A pretty lame backport of the Python 2.7 and Python 3.x
memoryviewview object to Py2.6.
c C s |S )N� )�self�objr r �D/usr/local/lib/python3.9/site-packages/future/types/newmemoryview.py�__init__ s znewmemoryview.__init__N)�__name__�
__module__� __qualname__�__doc__r r r r r r
s r
)r Znumbersr �stringZ future.utilsr r r r Z future.typesr r � collectionsr �collections.abc�objectr
�__all__r r r r �<module> s PK Bu\�7�d� � / future/types/__pycache__/newdict.cpython-39.pycnu �[��� a
��?h� � @ s^ d Z ddlZddlmZ ddlmZ eZejZ G dd� de
�Z G dd� dee e��Z dgZ
dS ) a�
A dict subclass for Python 2 that behaves like Python 3's dict
Example use:
>>> from builtins import dict
>>> d1 = dict() # instead of {} for an empty dict
>>> d2 = dict(key1='value1', key2='value2')
The keys, values and items methods now return iterators on Python 2.x
(with set-like behaviour on Python 2.7).
>>> for d in (d1, d2):
... assert not isinstance(d.keys(), list)
... assert not isinstance(d.values(), list)
... assert not isinstance(d.items(), list)
� N)�with_metaclass)� newobjectc @ s e Zd Zdd� ZdS )� BaseNewDictc C s" | t krt|t�S t|j| �S d S )N)�newdict�
isinstance�
_builtin_dict�
issubclass� __class__)�cls�instance� r �>/usr/local/lib/python3.9/site-packages/future/types/newdict.py�__instancecheck__ s
z BaseNewDict.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r
r s r c s` e Zd ZdZedkrn.edkr2ejZejZ ej
Z nej Zej
Z ejZ � fdd�Zdd� Z� ZS )r z7
A backport of the Python 3 dict object to Py2
)� )� � c s t t| �j| g|�R � S )a�
dict() -> new empty dictionary
dict(mapping) -> new dictionary initialized from a mapping object's
(key, value) pairs
dict(iterable) -> new dictionary initialized as if via:
d = {}
for k, v in iterable:
d[k] = v
dict(**kwargs) -> new dictionary initialized with the name=value pairs
in the keyword argument list. For example: dict(one=1, two=2)
)�superr �__new__)r
�args�kwargs�r r r
r 6 s
znewdict.__new__c C s t | �S )z=
Hook for the future.utils.native() function
)�dict)�selfr r r
�
__native__E s znewdict.__native__)r r r �__doc__�verr � viewitems�items�viewkeys�keys�
viewvalues�values� iteritems�iterkeys�
itervaluesr r �
__classcell__r r r r
r % s r )r �sysZ future.utilsr Zfuture.types.newobjectr r r � version_infor �typer r �__all__r r r r
�<module> s 'PK Bu\�U`� � 0 future/types/__pycache__/newrange.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZ ddlmZ er2ddlmZmZ nddlmZmZ ddl m
Z
ddl m Z e Z
G dd� de�ZG d d
� d
e�ZdgZd S ) aw
Nearly identical to xrange.py, by Dan Crosta, from
https://github.com/dcrosta/xrange.git
This is included here in the ``future`` package rather than pointed to as
a dependency because there is no package for ``xrange`` on PyPI. It is
also tweaked to appear like a regular Python 3 ``range`` object rather
than a Python 2 xrange.
From Dan Crosta's README:
"A pure-Python implementation of Python 2.7's xrange built-in, with
some features backported from the Python 3.x range built-in (which
replaced xrange) in that version."
Read more at
https://late.am/post/2012/06/18/what-the-heck-is-an-xrange
� )�absolute_import)�PY2)�Sequence�Iterator)�islice)�countc @ s� e Zd ZdZdd� Zedd� �Zedd� �Zedd � �Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zd d � Zd S ) �newrangez�
Pure-Python backport of Python 3's range object. See `the CPython
documentation for details:
<http://docs.python.org/py3k/library/functions.html#range>`_
c G s t |�dkr"d|d d }}}nFt |�dkrH|d |d d }}}n t |�dkr`|\}}}ntd��z t|�t|�t|� }}}W n ty� td��Y n0 |dkr�td��n |dk r�t||�}n
t||�}|| _|| _|| _|| | t || | � | _
d S )N� r � � z"range() requires 1-3 int argumentszan integer is requiredz range() arg 3 must not be zero) �len� TypeError�int�
ValueError�min�max�_start�_stop�_step�bool�_len)�self�args�start�stop�step� r �?/usr/local/lib/python3.9/site-packages/future/types/newrange.py�__init__* s(
znewrange.__init__c C s | j S �N)r �r r r r r E s znewrange.startc C s | j S r )r r r r r r I s z
newrange.stopc C s | j S r �r r r r r r M s z
newrange.stepc C s. | j dkrd| j| jf S d| j| j| j f S )Nr z
range(%d, %d)zrange(%d, %d, %d))r r r r r r r �__repr__Q s
znewrange.__repr__c C sF t |t�oD| jd ko |jkn pD| j| j| jf|j|j|jfkS )Nr )�
isinstancer r r r )r �otherr r r �__eq__V s
��znewrange.__eq__c C s | j S r )r r r r r �__len__\ s znewrange.__len__c C sx z|| j }W n ty, td| ��Y n0 t|| j�\}}|dkrhd| kr\| jk rhn nt|�S td| ��dS )z]Return the 0-based position of integer `value` in
the sequence this range represents.z%r is not in ranger N)r r
r �divmodr r �abs)r �value�diffZquotient� remainderr r r �index_ s "znewrange.indexc C s t || v �S )zbReturn the number of occurrences of integer `value`
in the sequence this range represents.)r �r r) r r r r k s znewrange.countc C s* z| � |� W dS ty$ Y dS 0 dS )z\Return ``True`` if the integer `value` occurs in
the sequence this range represents.TFN)r, r r- r r r � __contains__q s
znewrange.__contains__c C s t | d d d� �S )N���)�iterr r r r � __reversed__z s znewrange.__reversed__c C sP t |t�r| �|�S |dk r&| j| }|dk s8|| jkr@td��| j|| j S )z�Return the element at position ``index`` in the sequence
this range represents, or raise :class:`IndexError` if the
position is out of range.r z range object index out of range)r# �slice�_newrange__getitem_slicer �
IndexErrorr r )r r, r r r � __getitem__} s
znewrange.__getitem__c s< � fdd�|� � j�D �}|\}}}t� j| � j| |�S )znReturn a range which represents the requested slce
of the sequence represented by this range.
c 3 s | ]}� j | V qd S r r! )�.0�nr r r � <genexpr>� � z+newrange.__getitem_slice.<locals>.<genexpr>)�indicesr r r )r ZslceZscaled_indicesZ start_offsetZ stop_offsetZnew_stepr r r Z__getitem_slice� s
�znewrange.__getitem_slicec C s t | �S )z_Return an iterator which enumerates the elements of the
sequence this range represents.)�range_iteratorr r r r �__iter__� s znewrange.__iter__N)�__name__�
__module__� __qualname__�__doc__r �propertyr r r r" r% r& r, r r. r1 r5 r3 r< r r r r r # s$
r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r; z&An iterator for a :class:`range`.
c C s t t|j|j�t|��| _d S r )r r r r r �_stepper)r Zrange_r r r r � s zrange_iterator.__init__c C s | S r r r r r r r< � s zrange_iterator.__iter__c C s
t | j�S r ��nextrB r r r r �__next__� s zrange_iterator.__next__c C s
t | j�S r rC r r r r rD � s zrange_iterator.nextN)r= r> r? r@ r r< rE rD r r r r r; � s
r; N)r@ �
__future__r Z future.utilsr � collectionsr r �collections.abc� itertoolsr Zfuture.backports.miscr �_countr r; �__all__r r r r �<module> s wPK Bu\w��/�8 �8 . future/types/__pycache__/newstr.cpython-39.pycnu �[��� a
��?h�= � @ s� d Z ddlmZ ddlmZmZmZmZ ddlm Z m
Z
ddl m Z erZe
ZddlmZ n ddlmZ G dd� de�ZG d d
� d
eee��Zd
gZd S ) a
This module redefines ``str`` on Python 2.x to be a subclass of the Py2
``unicode`` type that behaves like the Python 3.x ``str``.
The main differences between ``newstr`` and Python 2.x's ``unicode`` type are
the stricter type-checking and absence of a `u''` prefix in the representation.
It is designed to be used together with the ``unicode_literals`` import
as follows:
>>> from __future__ import unicode_literals
>>> from builtins import str, isinstance
On Python 3.x and normally on Python 2.x, these expressions hold
>>> str('blah') is 'blah'
True
>>> isinstance('blah', str)
True
However, on Python 2.x, with this import:
>>> from __future__ import unicode_literals
the same expressions are False:
>>> str('blah') is 'blah'
False
>>> isinstance('blah', str)
False
This module is designed to be imported together with ``unicode_literals`` on
Python 2 to bring the meaning of ``str`` back into alignment with unprefixed
string literals (i.e. ``unicode`` subclasses).
Note that ``str()`` (and ``print()``) would then normally call the
``__unicode__`` method on objects in Python 2. To define string
representations of your objects portably across Py3 and Py2, use the
:func:`python_2_unicode_compatible` decorator in :mod:`future.utils`.
� )�Number)�PY3�istext�with_metaclass�
isnewbytes)�no�issubset)� newobject)�Iterablec @ s e Zd Zdd� ZdS )�
BaseNewStrc C s" | t krt|t�S t|j| �S d S �N)�newstr�
isinstance�unicode�
issubclass� __class__)�cls�instance� r �=/usr/local/lib/python3.9/site-packages/future/types/newstr.py�__instancecheck__; s
z BaseNewStr.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r r : s r c s" e Zd ZdZdZ� fdd�Z� fdd�Z� fdd�Zd d
� Ze d �� fd d
��Z
e d �dd� �Z � fdd�Z � fdd�Z
� fdd�Ze d �� fdd��Ze d �� fdd��Ze d d�� fdd ��Zd d � ZdT� fd!d"� Ze d d#�� fd$d%��Ze d d#�� fd&d'��Ze d d#�dU� fd*d+� �Ze d d#�dV� fd,d-� �Ze d d#�� fd.d/��Ze d d#�� fd0d1��Ze d d#�d2d3� �ZdW� fd5d6� Z� fd7d8�Z � fd9d:�Z � fd;d<�Z d=Z � fd>d?�Z � fd@dA�Z!� fdBdC�Z"� fdDdE�Z#� fdFdG�Z$dHdI� Z%e&dXdJdK��Z'dLdM� Z(dNdO� Z)dPdQ� Z*dRdS� Z+� Z,S )Yr
z6
A backport of the Python 3 str object to Py2
z,Can't convert '{0}' object to str implicitlyc s� t |�dkr tt| ��| �S t|d �tkr<| tkr<|d S t|d t�rT|d }nVt|d t�r�d|v svt |�dkr�|d j|dd� i |��}q�|d � � }n|d }tt| ��| |�S )a/
From the Py3 str docstring:
str(object='') -> str
str(bytes_or_buffer[, encoding[, errors]]) -> str
Create a new string object from the given object. If encoding or
errors is specified, then the object must expose a data buffer
that will be decoded using the given encoding and error handler.
Otherwise, returns the result of object.__str__() (if defined)
or repr(object).
encoding defaults to sys.getdefaultencoding().
errors defaults to 'strict'.
r �encoding� N)
�len�superr
�__new__�typer r �bytes�decode�__str__)r �args�kwargs�value�r r r r H s
znewstr.__new__c s t t| ��� }|dd� S )z&
Without the u prefix
r N)r r
�__repr__)�selfr% r& r r r' j s znewstr.__repr__c s t tt | ��|��S )z�
Warning: Python <= 2.7.6 has a bug that causes this method never to be called
when y is a slice object. Therefore the type of newstr()[:2] is wrong
(unicode instead of newstr).
)r
r � __getitem__)r( �yr& r r r) s s znewstr.__getitem__c C s` d}t |�tkr|}n8t|t�s2t|t�r<t|�s<t|�}nt|�t |����tt |�t | ��S )Nz6'in <string>' requires string as left operand, not {0})
r r
r r r r � TypeError�formatr �list)r( �key�errmsgZnewkeyr r r � __contains__{ s
znewstr.__contains__�newbytesc s t tt | ��|��S r )r
r �__add__�r( �otherr& r r r2 � s znewstr.__add__c C s$ zt |�| W S t Y S 0 dS )z
left + self N)r
�NotImplemented)r( �leftr r r �__radd__� s znewstr.__radd__c s t tt | ��|��S r )r
r �__mul__r3 r& r r r8 � s znewstr.__mul__c s t tt | ��|��S r )r
r �__rmul__r3 r& r r r9 � s znewstr.__rmul__c sh d}t |�D ] \}}t|�r t|�|���q t| �tkrLttt| ��|��S tttt| ���|��S d S )Nz7sequence item {0}: expected unicode string, found bytes)� enumerater r+ r, r r
r �join)r( �iterabler/ �i�itemr& r r r; � s z newstr.joinc s t t| �j|g|�R � S r )r r
�find�r( �subr# r& r r r? � s z newstr.findc s t t| �j|g|�R � S r )r r
�rfindr@ r& r r rB � s z newstr.rfind)r � c s t tt | �j||g|�R � �S r )r
r �replace)r( �old�newr# r& r r rD � s znewstr.replacec G s t d��d S )N�)decode method has been disabled in newstr)�AttributeError)r( r# r r r r! � s z
newstr.decode�utf-8�strictc s� ddl m} |dkr�|dkr$td��g }| D ]L}t|�}d| krLdkrfn n|�||d g�� q,|�|j|d �� q,|d
��|�S |tt| ��||��S ) a�
Returns bytes
Encode S using the codec registered for encoding. Default encoding
is 'utf-8'. errors may be given to set a different error
handling scheme. Default is 'strict' meaning that encoding errors raise
a UnicodeEncodeError. Other possible values are 'ignore', 'replace' and
'xmlcharrefreplace' as well as any other name registered with
codecs.register_error that can handle UnicodeEncodeErrors.
r )r1 �surrogateescapezutf-16z?FIXME: surrogateescape handling is not yet implemented properlyi � i�� i � )r � ) Zfuture.types.newbytesr1 �NotImplementedError�ord�append�encoder; r r
)r( r �errorsr1 Zmybytes�c�coder& r r rP � s z
newstr.encoder c sH t |t�r0|D ] }t|�rt| j�t|����qtt| �j |g|�R � S r )
r r
r r+ �no_convert_msgr, r r r
�
startswith�r( �prefixr# �thingr& r r rU � s
znewstr.startswithc sH t |t�r0|D ] }t|�rt| j�t|����qtt| �j |g|�R � S r )
r r
r r+ rT r, r r r
�endswithrV r& r r rY � s
znewstr.endswithN���c s t t| ��||�}dd� |D �S )Nc S s g | ] }t |��qS r �r
��.0�partr r r �
<listcomp>� rL z newstr.split.<locals>.<listcomp>)r r
�split�r( �sep�maxsplit�partsr& r r r` � s z newstr.splitc s t t| ��||�}dd� |D �S )Nc S s g | ] }t |��qS r r[ r\ r r r r_ � rL z!newstr.rsplit.<locals>.<listcomp>)r r
�rsplitra r& r r re � s z
newstr.rsplitc s" t t| ��|�}tdd� |D ��S )Nc s s | ]}t |�V qd S r r[ r\ r r r � <genexpr> rL z#newstr.partition.<locals>.<genexpr>)r r
� partition�tuple�r( rb rd r& r r rg s znewstr.partitionc s" t t| ��|�}tdd� |D ��S )Nc s s | ]}t |�V qd S r r[ r\ r r r rf rL z$newstr.rpartition.<locals>.<genexpr>)r r
�
rpartitionrh ri r& r r rj s znewstr.rpartitionc G s& | j |g|�R � }|dkr"td��|S )zb
Like newstr.find() but raise ValueError when the substring is not
found.
rZ zsubstring not found)r? �
ValueError)r( rA r# �posr r r �index s z newstr.indexFc s t t| ��|�}dd� |D �S )z�
S.splitlines(keepends=False) -> list of strings
Return a list of the lines in S, breaking at line boundaries.
Line breaks are not included in the resulting list unless keepends
is given and true.
c S s g | ] }t |��qS r r[ r\ r r r r_ ! rL z%newstr.splitlines.<locals>.<listcomp>)r r
�
splitlines)r( �keependsrd r& r r rn s
znewstr.splitlinesc s4 t |t�s t |t�r,t|�s,tt| ��|�S tS d S r )r r r r r r
�__eq__r5 r3 r& r r rp # s
��z
newstr.__eq__c s4 t | t�s t | t�r*t| �s*tt| ��� S t� �d S r )r r r r r r
�__hash__rM �r( r& r r rq * s
��znewstr.__hash__c s4 t |t�s t |t�r,t|�s,tt| ��|�S dS d S )NT)r r r r r r
�__ne__r3 r& r r rs 1 s
��z
newstr.__ne__z unorderable types: str() and {0}c sD t |t�s t |t�r,t|�s,tt| ��|�S t| j� t
|����d S r ) r r r r r r
�__lt__r+ �unorderable_errr, r r3 r& r r rt : s
��z
newstr.__lt__c sD t |t�s t |t�r,t|�s,tt| ��|�S t| j� t
|����d S r ) r r r r r r
�__le__r+ ru r, r r3 r& r r rv @ s
��z
newstr.__le__c sD t |t�s t |t�r,t|�s,tt| ��|�S t| j� t
|����d S r ) r r r r r r
�__gt__r+ ru r, r r3 r& r r rw F s
��z
newstr.__gt__c sD t |t�s t |t�r,t|�s,tt| ��|�S t| j� t
|����d S r ) r r r r r r
�__ge__r+ ru r, r r3 r& r r rx L s
��z
newstr.__ge__c s |dv rt d��tt| ��|�S )zu
A trick to cause the ``hasattr`` builtin-fn to return False for
the 'decode' method on Py2.
)r! r! rG )rH r r
�__getattribute__)r( �namer& r r ry R s znewstr.__getattribute__c C s t | �S )z@
A hook for the future.utils.native() function.
)r rr r r r �
__native__[ s znewstr.__native__c C s� |du r^|du sJ �t | t�s&td��i }| �� D ](\}}t|�dkrNtd��||t|�< q2npt | t�szt |t�rztd��t| �t|�ks�td��i }t| |�D ],\}}t|�dkr�td��t|�|t|�< q�|dur�|D ]}d|t|�< q�|S )a_
Return a translation table usable for str.translate().
If there is only one argument, it must be a dictionary mapping Unicode
ordinals (integers) or characters to Unicode ordinals, strings or None.
Character keys will be then converted to ordinals.
If there are two arguments, they must be strings of equal length, and
in the resulting dictionary, each character in x will be mapped to the
character at the same position in y. If there is a third argument, it
must be a string, whose characters will be mapped to None in the result.
Nz<if you give only one argument to maketrans it must be a dictr z3keys in translate table must be strings or integersz x and y must be unicode stringsz8the first two maketrans arguments must have equal length) r �dictr+ �itemsr rk rN r �zip) �xr* �z�resultr. r% �xi�yi�charr r r � maketransa s,
znewstr.maketransc C sl g }| D ]X}t |�|v rV|t |� }|du r0qq`t|t�rF|�|� q`|�t|�� q|�|� qd�|�S )a`
S.translate(table) -> str
Return a copy of the string S, where all characters have been mapped
through the given translation table, which must be a mapping of
Unicode ordinals to Unicode ordinals, strings, or None.
Unmapped characters are left untouched. Characters mapped to None
are deleted.
N� )rN r r rO �chrr; )r( �table�lrR �valr r r � translate� s
znewstr.translatec C s t d��d S �NZfixme�rM rr r r r � isprintable� s znewstr.isprintablec C s t d��d S r� r� rr r r r � isidentifier� s znewstr.isidentifierc C s t d��d S r� r� rr r r r �
format_map� s znewstr.format_map)rI rJ )NrZ )NrZ )F)NN)-r r r �__doc__rT r r' r) r0 r r2 r7 r8 r9 r; r? rB rD r! rP rU rY r` re rg rj rm rn rp rq rs ru rt rv rw rx ry r{ � staticmethodr� r� r� r� r� �
__classcell__r r r& r r
B sh "
)
&r
N)r� Znumbersr Z future.utilsr r r r Z future.typesr r Zfuture.types.newobjectr �strr �collections.abcr
� collectionsr r r
�__all__r r r r �<module> s * jPK Bu\�JB�7 �7 0 future/types/__pycache__/newbytes.cpython-39.pycnu �[��� a
��?h�? � @ s� d Z ddlmZ ddlZddlZddlmZmZmZm Z m
Z
ddl m Z m
Z
ddlmZ erjddlmZ n ddlmZ eZe r�eZG dd � d e�Zd
d � ZG d d
� d
e
ee��Zd
gZdS )z�
Pure-Python implementation of a Python 3-like bytes object for Python 2.
Why do this? Without it, the Python 2 bytes object is a very, very
different beast to the Python 3 bytes object.
� )�IntegralN)�istext�isbytes�PY2�PY3�with_metaclass)�no�issubset)� newobject)�Iterablec @ s e Zd Zdd� ZdS )� BaseNewBytesc C s" | t krt|t�S t|j| �S d S �N)�newbytes�
isinstance�_builtin_bytes�
issubclass� __class__)�cls�instance� r �?/usr/local/lib/python3.9/site-packages/future/types/newbytes.py�__instancecheck__ s
z BaseNewBytes.__instancecheck__N)�__name__�
__module__� __qualname__r r r r r r s r c C s t | t�r| �d�S t| �S d S )N�ascii)r �str�encode�chr)�xr r r �_newchr% s
r c s� e Zd ZdZ� fdd�Z� fdd�Z� fdd�Z� fdd �Zd
d � Zd d
� Z e
e �� fdd��Z e
e �dd� �Z
e
e �� fdd��Ze
e �� fdd��Zdd� Zdd� Z� fdd�Zed d � �Ze
e �� fd d ��Ze
e �� fd d!��Ze
e d"�� fd#d$��Zd%d&� Zd\� fd)d*� Ze
e �� fd+d,��Ze
e �� fd-d.��Ze
e �d]� fd1d2� �Z d^� fd4d5� Z e
e �d_� fd6d7� �Z e
e �� fd8d9��Z e
e �� fd:d;��Z e
e d<�d=d>� �Z!e
e �� fd?d@��Z"� fdAdB�Z#� fdCdD�Z$dEZ%� fdFdG�Z&� fdHdI�Z'� fdJdK�Z(� fdLdM�Z)� fdNdO�Z*� fdPdQ�Z+e
e �d`� fdRdS� �Z,e
e �da� fdTdU� �Z-� fdVdW�Z.e
e �� fdXdY��Z/ee
e �dZd[� ��Z0� Z1S )br z8
A backport of the Python 3 bytes object to Py2
c s d}d}t |�dkr$tt| ��| �S t |�dkrTt|�}t |�dkrL|�� }|�� }t|d �tkrl|d S t|d t�r�|d }�nXt|d t ��r*z<d|v r�|du s�J �|d }d|v r�|du s�J �|d }W n t
y� t d��Y n0 |du �r t d��|g}|du�r|� |� |d j
|� }n�t|d d ��rH|d �� }n�t|d t��r�t |d �dk�rpd
}n0ztd d � |d D ��}W n td
��Y n0 n<t|d t��r�|d dk �r�td��d|d }n|d }t|�tk�r�t�|�S tt| ��| |�S dS )aK
From the Py3 bytes docstring:
bytes(iterable_of_ints) -> bytes
bytes(string, encoding[, errors]) -> bytes
bytes(bytes_or_buffer) -> immutable copy of bytes_or_buffer
bytes(int) -> bytes object of size given by the parameter initialized with null bytes
bytes() -> empty bytes object
Construct an immutable array of bytes from:
- an iterable yielding integers in range(256)
- a text string encoded using the specified encoding
- any object implementing the buffer API.
- an integer
Nr � � �encoding�errorsz#Argument given by name and positionz+unicode string argument without an encoding� __bytes__� c S s g | ] }t |��qS r )r )�.0r r r r �
<listcomp>w r& z$newbytes.__new__.<locals>.<listcomp>z bytes must be in range(0, 256)znegative count� )�len�superr �__new__�list�pop�typer r �unicode�AssertionError� TypeError�appendr �hasattrr% r � bytearray�
ValueErrorr �copy)r �args�kwargsr# r$ �valueZnewargs�r r r r, 0 s\
znewbytes.__new__c s dt t| ��� S )N�b)r+ r �__repr__��selfr; r r r= � s znewbytes.__repr__c s dd� tt| ��� � S )Nr< z'{0}')�formatr+ r �__str__r> r; r r rA � s znewbytes.__str__c s. t t| ��|�}t|t�r"t|�S t|�S d S r
)r+ r � __getitem__r r �ord)r? �yr: r; r r rB � s
znewbytes.__getitem__c G s | � t|� �S r
)rB �slice�r? r8 r r r � __getslice__� s znewbytes.__getslice__c C sB t |t�rt|g�}nt|�tkr(|}nt|�}tt|�t| ��S r
)r �intr r/ r r- )r? �keyZ newbyteskeyr r r � __contains__� s
znewbytes.__contains__c s t tt | ��|��S r
)r r+ �__add__�r? �otherr; r r rK � s znewbytes.__add__c C s t |�| S r
�r )r? �leftr r r �__radd__� s znewbytes.__radd__c s t tt | ��|��S r
)r r+ �__mul__rL r; r r rQ � s znewbytes.__mul__c s t tt | ��|��S r
)r r+ �__rmul__rL r; r r rR � s znewbytes.__rmul__c C s� t |t�rt�|�}n�t |t�rVg }|D ]"}t |t�r@t�|�}|�|� q(t|�}nBt|jd�r�t|jd�r�|�� D ] \}}t |t�rvt�|�||< qvt� | |�S )NrB � iteritems)
r r r rA �tupler3 r4 r rS �__mod__)r? �valsZnewvals�v�kr r r rU � s
�
znewbytes.__mod__c C s
| � |�S r
)rU rL r r r �__imod__� s znewbytes.__imod__c sj d}t |�st|�r(t|�dt|����t|�D ]$\}}t|�r0t|�|t|����q0ttt| ��|��S )Nz,sequence item {0}: expected bytes, {1} foundr ) r r r2 r@ r/ � enumerater r+ �join)r? Ziterable_of_bytes�errmsg�i�itemr; r r r[ � s z
newbytes.joinc C s | |� dd��d��S )N� � �hex)�replace�decode)r �stringr r r �fromhex� s znewbytes.fromhexc s t t| �j|g|�R � S r
)r+ r �find�r? �subr8 r; r r rf � s z
newbytes.findc s t t| �j|g|�R � S r
)r+ r �rfindrg r; r r ri � s znewbytes.rfind)� r! c s t tt | �j||g|�R � �S r
)r r+ rb )r? �old�newr8 r; r r rb � s znewbytes.replacec G s t d��d S )N�+encode method has been disabled in newbytes)�AttributeErrorrF r r r r � s znewbytes.encode�utf-8�strictc s< ddl m} |dkr&ddlm} |� |tt| ��||��S )a�
Returns a newstr (i.e. unicode subclass)
Decode B using the codec registered for encoding. Default encoding
is 'utf-8'. errors may be given to set a different error
handling scheme. Default is 'strict' meaning that encoding errors raise
a UnicodeDecodeError. Other possible values are 'ignore' and 'replace'
as well as any other name registered with codecs.register_error that is
able to handle UnicodeDecodeErrors.
r )�newstr�surrogateescape)�register_surrogateescape)Zfuture.types.newstrrq Z future.utils.surrogateescapers r+ r rc )r? r# r$ rq rs r; r r rc � s
znewbytes.decodec s t t| �j|g|�R � S r
)r+ r �
startswith�r? �prefixr8 r; r r rt s znewbytes.startswithc s t t| �j|g|�R � S r
)r+ r �endswithru r; r r rw s znewbytes.endswithN���c s t t| ��||�}dd� |D �S )Nc S s g | ] }t |��qS r rN �r' �partr r r r( ' r& z"newbytes.split.<locals>.<listcomp>)r+ r �split�r? �sep�maxsplit�partsr; r r r{ " s znewbytes.splitFc s t t| ��|�}dd� |D �S )z�
B.splitlines([keepends]) -> list of lines
Return a list of the lines in B, breaking at line boundaries.
Line breaks are not included in the resulting list unless keepends
is given and true.
c S s g | ] }t |��qS r rN ry r r r r( 4 r& z'newbytes.splitlines.<locals>.<listcomp>)r+ r �
splitlines)r? �keependsr r; r r r� ) s
znewbytes.splitlinesc s t t| ��||�}dd� |D �S )Nc S s g | ] }t |��qS r rN ry r r r r( ; r& z#newbytes.rsplit.<locals>.<listcomp>)r+ r �rsplitr| r; r r r� 6 s znewbytes.rsplitc s" t t| ��|�}tdd� |D ��S )Nc s s | ]}t |�V qd S r
rN ry r r r � <genexpr>@ r& z%newbytes.partition.<locals>.<genexpr>)r+ r � partitionrT �r? r} r r; r r r� = s znewbytes.partitionc s" t t| ��|�}tdd� |D ��S )Nc s s | ]}t |�V qd S r
rN ry r r r r� E r& z&newbytes.rpartition.<locals>.<genexpr>)r+ r �
rpartitionrT r� r; r r r� B s znewbytes.rpartition)rj c G s& | j |g|�R � }|dkr"td��dS )z�
S.rindex(sub [,start [,end]]) -> int
Like S.rfind() but raise ValueError when the substring is not found.
rx �substring not foundN)ri r6 )r? rh r8 �posr r r �rindexG s znewbytes.rindexc s� t |t�rpt|�dkr&dt| � }}n4t|�dkr<|d }n t|�dkrR|\}}ntd��t| �||� �|�S t |t�s�z| �|�}W n ttfy� td��Y n0 zt t
| �j|g|�R � W S ty� td��Y n0 dS )z�
Returns index of sub in bytes.
Raises ValueError if byte is not in bytes and TypeError if can't
be converted bytes or its length is not 1.
r rj r! ztakes at most 3 argumentszcan't convert sub to bytesr� N) r rH r* r2 r- �index�bytesr r6 r+ r )r? rh r8 �start�endr; r r r� R s$
znewbytes.indexc s& t |ttf�r tt| ��|�S dS d S )NF)r r r5 r+ r �__eq__rL r; r r r� m s znewbytes.__eq__c s" t |t�rtt| ��|�S dS d S )NT)r r r+ r �__ne__rL r; r r r� s s
znewbytes.__ne__z"unorderable types: bytes() and {0}c s2 t |t�rtt| ��|�S t| j�t|����d S r
) r r r+ r �__lt__r2 �unorderable_errr@ r/ rL r; r r r� { s
znewbytes.__lt__c s2 t |t�rtt| ��|�S t| j�t|����d S r
) r r r+ r �__le__r2 r� r@ r/ rL r; r r r� � s
znewbytes.__le__c s2 t |t�rtt| ��|�S t| j�t|����d S r
) r r r+ r �__gt__r2 r� r@ r/ rL r; r r r� � s
znewbytes.__gt__c s2 t |t�rtt| ��|�S t| j�t|����d S r
) r r r+ r �__ge__r2 r� r@ r/ rL r; r r r� � s
znewbytes.__ge__c s t t| ��� S r
)r+ r rA r> r; r r �
__native__� s znewbytes.__native__c s |dv rt d��tt| ��|�S )zu
A trick to cause the ``hasattr`` builtin-fn to return False for
the 'encode' method on Py2.
)r r rm )rn r+ r �__getattribute__)r? �namer; r r r� � s znewbytes.__getattribute__c s t tt | ��|��S )z�
Strip trailing bytes contained in the argument.
If the argument is omitted, strip trailing ASCII whitespace.
)r r+ �rstrip�r? Zbytes_to_stripr; r r r� � s znewbytes.rstripc s t tt | ��|��S )z�
Strip leading and trailing bytes contained in the argument.
If the argument is omitted, strip trailing ASCII whitespace.
)r r+ �stripr� r; r r r� � s znewbytes.stripc s t tt | ��� �S )zv
b.lower() -> copy of b
Return a copy of b with all ASCII characters converted to lowercase.
)r r+ �lowerr> r; r r r� � s znewbytes.lowerc s t tt | ��� �S )zv
b.upper() -> copy of b
Return a copy of b with all ASCII characters converted to uppercase.
)r r+ �upperr> r; r r r� � s znewbytes.upperc C s t t�||��S )aT
B.maketrans(frm, to) -> translation table
Return a translation table (a bytes object of length 256) suitable
for use in the bytes or bytearray translate method where each byte
in frm is mapped to the byte at the same position in to.
The bytes objects frm and to must be of the same length.
)r rd � maketrans)r �frm�tor r r r� � s znewbytes.maketrans)ro rp )Nrx )F)Nrx )N)N)2r r r �__doc__r, r= rA rB rG rJ r r0 rK rP rQ rR rU rY r[ � classmethodre rf ri rb r rc rt rw r{ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �
__classcell__r r r; r r , s� Z
1
r ) r� Znumbersr rd r7 Z future.utilsr r r r r Z future.typesr r Zfuture.types.newobjectr
� collectionsr �collections.abcr� r r r0 r/ r r r �__all__r r r r �<module> s& #PK Bu\ ���? �? future/types/newbytes.pynu �[��� """
Pure-Python implementation of a Python 3-like bytes object for Python 2.
Why do this? Without it, the Python 2 bytes object is a very, very
different beast to the Python 3 bytes object.
"""
from numbers import Integral
import string
import copy
from future.utils import istext, isbytes, PY2, PY3, with_metaclass
from future.types import no, issubset
from future.types.newobject import newobject
if PY2:
from collections import Iterable
else:
from collections.abc import Iterable
_builtin_bytes = bytes
if PY3:
# We'll probably never use newstr on Py3 anyway...
unicode = str
class BaseNewBytes(type):
def __instancecheck__(cls, instance):
if cls == newbytes:
return isinstance(instance, _builtin_bytes)
else:
return issubclass(instance.__class__, cls)
def _newchr(x):
if isinstance(x, str): # this happens on pypy
return x.encode('ascii')
else:
return chr(x)
class newbytes(with_metaclass(BaseNewBytes, _builtin_bytes)):
"""
A backport of the Python 3 bytes object to Py2
"""
def __new__(cls, *args, **kwargs):
"""
From the Py3 bytes docstring:
bytes(iterable_of_ints) -> bytes
bytes(string, encoding[, errors]) -> bytes
bytes(bytes_or_buffer) -> immutable copy of bytes_or_buffer
bytes(int) -> bytes object of size given by the parameter initialized with null bytes
bytes() -> empty bytes object
Construct an immutable array of bytes from:
- an iterable yielding integers in range(256)
- a text string encoded using the specified encoding
- any object implementing the buffer API.
- an integer
"""
encoding = None
errors = None
if len(args) == 0:
return super(newbytes, cls).__new__(cls)
elif len(args) >= 2:
args = list(args)
if len(args) == 3:
errors = args.pop()
encoding=args.pop()
# Was: elif isinstance(args[0], newbytes):
# We use type() instead of the above because we're redefining
# this to be True for all unicode string subclasses. Warning:
# This may render newstr un-subclassable.
if type(args[0]) == newbytes:
# Special-case: for consistency with Py3.3, we return the same object
# (with the same id) if a newbytes object is passed into the
# newbytes constructor.
return args[0]
elif isinstance(args[0], _builtin_bytes):
value = args[0]
elif isinstance(args[0], unicode):
try:
if 'encoding' in kwargs:
assert encoding is None
encoding = kwargs['encoding']
if 'errors' in kwargs:
assert errors is None
errors = kwargs['errors']
except AssertionError:
raise TypeError('Argument given by name and position')
if encoding is None:
raise TypeError('unicode string argument without an encoding')
###
# Was: value = args[0].encode(**kwargs)
# Python 2.6 string encode() method doesn't take kwargs:
# Use this instead:
newargs = [encoding]
if errors is not None:
newargs.append(errors)
value = args[0].encode(*newargs)
###
elif hasattr(args[0], '__bytes__'):
value = args[0].__bytes__()
elif isinstance(args[0], Iterable):
if len(args[0]) == 0:
# This could be an empty list or tuple. Return b'' as on Py3.
value = b''
else:
# Was: elif len(args[0])>0 and isinstance(args[0][0], Integral):
# # It's a list of integers
# But then we can't index into e.g. frozensets. Try to proceed
# anyway.
try:
value = bytearray([_newchr(x) for x in args[0]])
except:
raise ValueError('bytes must be in range(0, 256)')
elif isinstance(args[0], Integral):
if args[0] < 0:
raise ValueError('negative count')
value = b'\x00' * args[0]
else:
value = args[0]
if type(value) == newbytes:
# Above we use type(...) rather than isinstance(...) because the
# newbytes metaclass overrides __instancecheck__.
# oldbytes(value) gives the wrong thing on Py2: the same
# result as str(value) on Py3, e.g. "b'abc'". (Issue #193).
# So we handle this case separately:
return copy.copy(value)
else:
return super(newbytes, cls).__new__(cls, value)
def __repr__(self):
return 'b' + super(newbytes, self).__repr__()
def __str__(self):
return 'b' + "'{0}'".format(super(newbytes, self).__str__())
def __getitem__(self, y):
value = super(newbytes, self).__getitem__(y)
if isinstance(y, Integral):
return ord(value)
else:
return newbytes(value)
def __getslice__(self, *args):
return self.__getitem__(slice(*args))
def __contains__(self, key):
if isinstance(key, int):
newbyteskey = newbytes([key])
# Don't use isinstance() here because we only want to catch
# newbytes, not Python 2 str:
elif type(key) == newbytes:
newbyteskey = key
else:
newbyteskey = newbytes(key)
return issubset(list(newbyteskey), list(self))
@no(unicode)
def __add__(self, other):
return newbytes(super(newbytes, self).__add__(other))
@no(unicode)
def __radd__(self, left):
return newbytes(left) + self
@no(unicode)
def __mul__(self, other):
return newbytes(super(newbytes, self).__mul__(other))
@no(unicode)
def __rmul__(self, other):
return newbytes(super(newbytes, self).__rmul__(other))
def __mod__(self, vals):
if isinstance(vals, newbytes):
vals = _builtin_bytes.__str__(vals)
elif isinstance(vals, tuple):
newvals = []
for v in vals:
if isinstance(v, newbytes):
v = _builtin_bytes.__str__(v)
newvals.append(v)
vals = tuple(newvals)
elif (hasattr(vals.__class__, '__getitem__') and
hasattr(vals.__class__, 'iteritems')):
for k, v in vals.iteritems():
if isinstance(v, newbytes):
vals[k] = _builtin_bytes.__str__(v)
return _builtin_bytes.__mod__(self, vals)
def __imod__(self, other):
return self.__mod__(other)
def join(self, iterable_of_bytes):
errmsg = 'sequence item {0}: expected bytes, {1} found'
if isbytes(iterable_of_bytes) or istext(iterable_of_bytes):
raise TypeError(errmsg.format(0, type(iterable_of_bytes)))
for i, item in enumerate(iterable_of_bytes):
if istext(item):
raise TypeError(errmsg.format(i, type(item)))
return newbytes(super(newbytes, self).join(iterable_of_bytes))
@classmethod
def fromhex(cls, string):
# Only on Py2:
return cls(string.replace(' ', '').decode('hex'))
@no(unicode)
def find(self, sub, *args):
return super(newbytes, self).find(sub, *args)
@no(unicode)
def rfind(self, sub, *args):
return super(newbytes, self).rfind(sub, *args)
@no(unicode, (1, 2))
def replace(self, old, new, *args):
return newbytes(super(newbytes, self).replace(old, new, *args))
def encode(self, *args):
raise AttributeError("encode method has been disabled in newbytes")
def decode(self, encoding='utf-8', errors='strict'):
"""
Returns a newstr (i.e. unicode subclass)
Decode B using the codec registered for encoding. Default encoding
is 'utf-8'. errors may be given to set a different error
handling scheme. Default is 'strict' meaning that encoding errors raise
a UnicodeDecodeError. Other possible values are 'ignore' and 'replace'
as well as any other name registered with codecs.register_error that is
able to handle UnicodeDecodeErrors.
"""
# Py2 str.encode() takes encoding and errors as optional parameter,
# not keyword arguments as in Python 3 str.
from future.types.newstr import newstr
if errors == 'surrogateescape':
from future.utils.surrogateescape import register_surrogateescape
register_surrogateescape()
return newstr(super(newbytes, self).decode(encoding, errors))
# This is currently broken:
# # We implement surrogateescape error handling here in addition rather
# # than relying on the custom error handler from
# # future.utils.surrogateescape to be registered globally, even though
# # that is fine in the case of decoding. (But not encoding: see the
# # comments in newstr.encode()``.)
#
# if errors == 'surrogateescape':
# # Decode char by char
# mybytes = []
# for code in self:
# # Code is an int
# if 0x80 <= code <= 0xFF:
# b = 0xDC00 + code
# elif code <= 0x7F:
# b = _unichr(c).decode(encoding=encoding)
# else:
# # # It may be a bad byte
# # FIXME: What to do in this case? See the Py3 docs / tests.
# # # Try swallowing it.
# # continue
# # print("RAISE!")
# raise NotASurrogateError
# mybytes.append(b)
# return newbytes(mybytes)
# return newbytes(super(newstr, self).decode(encoding, errors))
@no(unicode)
def startswith(self, prefix, *args):
return super(newbytes, self).startswith(prefix, *args)
@no(unicode)
def endswith(self, prefix, *args):
return super(newbytes, self).endswith(prefix, *args)
@no(unicode)
def split(self, sep=None, maxsplit=-1):
# Py2 str.split() takes maxsplit as an optional parameter, not as a
# keyword argument as in Python 3 bytes.
parts = super(newbytes, self).split(sep, maxsplit)
return [newbytes(part) for part in parts]
def splitlines(self, keepends=False):
"""
B.splitlines([keepends]) -> list of lines
Return a list of the lines in B, breaking at line boundaries.
Line breaks are not included in the resulting list unless keepends
is given and true.
"""
# Py2 str.splitlines() takes keepends as an optional parameter,
# not as a keyword argument as in Python 3 bytes.
parts = super(newbytes, self).splitlines(keepends)
return [newbytes(part) for part in parts]
@no(unicode)
def rsplit(self, sep=None, maxsplit=-1):
# Py2 str.rsplit() takes maxsplit as an optional parameter, not as a
# keyword argument as in Python 3 bytes.
parts = super(newbytes, self).rsplit(sep, maxsplit)
return [newbytes(part) for part in parts]
@no(unicode)
def partition(self, sep):
parts = super(newbytes, self).partition(sep)
return tuple(newbytes(part) for part in parts)
@no(unicode)
def rpartition(self, sep):
parts = super(newbytes, self).rpartition(sep)
return tuple(newbytes(part) for part in parts)
@no(unicode, (1,))
def rindex(self, sub, *args):
'''
S.rindex(sub [,start [,end]]) -> int
Like S.rfind() but raise ValueError when the substring is not found.
'''
pos = self.rfind(sub, *args)
if pos == -1:
raise ValueError('substring not found')
@no(unicode)
def index(self, sub, *args):
'''
Returns index of sub in bytes.
Raises ValueError if byte is not in bytes and TypeError if can't
be converted bytes or its length is not 1.
'''
if isinstance(sub, int):
if len(args) == 0:
start, end = 0, len(self)
elif len(args) == 1:
start = args[0]
elif len(args) == 2:
start, end = args
else:
raise TypeError('takes at most 3 arguments')
return list(self)[start:end].index(sub)
if not isinstance(sub, bytes):
try:
sub = self.__class__(sub)
except (TypeError, ValueError):
raise TypeError("can't convert sub to bytes")
try:
return super(newbytes, self).index(sub, *args)
except ValueError:
raise ValueError('substring not found')
def __eq__(self, other):
if isinstance(other, (_builtin_bytes, bytearray)):
return super(newbytes, self).__eq__(other)
else:
return False
def __ne__(self, other):
if isinstance(other, _builtin_bytes):
return super(newbytes, self).__ne__(other)
else:
return True
unorderable_err = 'unorderable types: bytes() and {0}'
def __lt__(self, other):
if isinstance(other, _builtin_bytes):
return super(newbytes, self).__lt__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __le__(self, other):
if isinstance(other, _builtin_bytes):
return super(newbytes, self).__le__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __gt__(self, other):
if isinstance(other, _builtin_bytes):
return super(newbytes, self).__gt__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __ge__(self, other):
if isinstance(other, _builtin_bytes):
return super(newbytes, self).__ge__(other)
raise TypeError(self.unorderable_err.format(type(other)))
def __native__(self):
# We can't just feed a newbytes object into str(), because
# newbytes.__str__() returns e.g. "b'blah'", consistent with Py3 bytes.
return super(newbytes, self).__str__()
def __getattribute__(self, name):
"""
A trick to cause the ``hasattr`` builtin-fn to return False for
the 'encode' method on Py2.
"""
if name in ['encode', u'encode']:
raise AttributeError("encode method has been disabled in newbytes")
return super(newbytes, self).__getattribute__(name)
@no(unicode)
def rstrip(self, bytes_to_strip=None):
"""
Strip trailing bytes contained in the argument.
If the argument is omitted, strip trailing ASCII whitespace.
"""
return newbytes(super(newbytes, self).rstrip(bytes_to_strip))
@no(unicode)
def strip(self, bytes_to_strip=None):
"""
Strip leading and trailing bytes contained in the argument.
If the argument is omitted, strip trailing ASCII whitespace.
"""
return newbytes(super(newbytes, self).strip(bytes_to_strip))
def lower(self):
"""
b.lower() -> copy of b
Return a copy of b with all ASCII characters converted to lowercase.
"""
return newbytes(super(newbytes, self).lower())
@no(unicode)
def upper(self):
"""
b.upper() -> copy of b
Return a copy of b with all ASCII characters converted to uppercase.
"""
return newbytes(super(newbytes, self).upper())
@classmethod
@no(unicode)
def maketrans(cls, frm, to):
"""
B.maketrans(frm, to) -> translation table
Return a translation table (a bytes object of length 256) suitable
for use in the bytes or bytearray translate method where each byte
in frm is mapped to the byte at the same position in to.
The bytes objects frm and to must be of the same length.
"""
return newbytes(string.maketrans(frm, to))
__all__ = ['newbytes']
PK Bu\��l�
future/types/newobject.pynu �[��� """
An object subclass for Python 2 that gives new-style classes written in the
style of Python 3 (with ``__next__`` and unicode-returning ``__str__`` methods)
the appropriate Python 2-style ``next`` and ``__unicode__`` methods for compatible.
Example use::
from builtins import object
my_unicode_str = u'Unicode string: \u5b54\u5b50'
class A(object):
def __str__(self):
return my_unicode_str
a = A()
print(str(a))
# On Python 2, these relations hold:
assert unicode(a) == my_unicode_string
assert str(a) == my_unicode_string.encode('utf-8')
Another example::
from builtins import object
class Upper(object):
def __init__(self, iterable):
self._iter = iter(iterable)
def __next__(self): # note the Py3 interface
return next(self._iter).upper()
def __iter__(self):
return self
assert list(Upper('hello')) == list('HELLO')
"""
class newobject(object):
"""
A magical object class that provides Python 2 compatibility methods::
next
__unicode__
__nonzero__
Subclasses of this class can merely define the Python 3 methods (__next__,
__str__, and __bool__).
"""
def next(self):
if hasattr(self, '__next__'):
return type(self).__next__(self)
raise TypeError('newobject is not an iterator')
def __unicode__(self):
# All subclasses of the builtin object should have __str__ defined.
# Note that old-style classes do not have __str__ defined.
if hasattr(self, '__str__'):
s = type(self).__str__(self)
else:
s = str(self)
if isinstance(s, unicode):
return s
else:
return s.decode('utf-8')
def __nonzero__(self):
if hasattr(self, '__bool__'):
return type(self).__bool__(self)
if hasattr(self, '__len__'):
return type(self).__len__(self)
# object has no __nonzero__ method
return True
# Are these ever needed?
# def __div__(self):
# return self.__truediv__()
# def __idiv__(self, other):
# return self.__itruediv__(other)
def __long__(self):
if not hasattr(self, '__int__'):
return NotImplemented
return self.__int__() # not type(self).__int__(self)
# def __new__(cls, *args, **kwargs):
# """
# dict() -> new empty dictionary
# dict(mapping) -> new dictionary initialized from a mapping object's
# (key, value) pairs
# dict(iterable) -> new dictionary initialized as if via:
# d = {}
# for k, v in iterable:
# d[k] = v
# dict(**kwargs) -> new dictionary initialized with the name=value pairs
# in the keyword argument list. For example: dict(one=1, two=2)
# """
# if len(args) == 0:
# return super(newdict, cls).__new__(cls)
# elif type(args[0]) == newdict:
# return args[0]
# else:
# value = args[0]
# return super(newdict, cls).__new__(cls, value)
def __native__(self):
"""
Hook for the future.utils.native() function
"""
return object(self)
__slots__ = []
__all__ = ['newobject']
PK %Bu\��>��m �m # future/standard_library/__init__.pynu �[��� """
Python 3 reorganized the standard library (PEP 3108). This module exposes
several standard library modules to Python 2 under their new Python 3
names.
It is designed to be used as follows::
from future import standard_library
standard_library.install_aliases()
And then these normal Py3 imports work on both Py3 and Py2::
import builtins
import copyreg
import queue
import reprlib
import socketserver
import winreg # on Windows only
import test.support
import html, html.parser, html.entities
import http, http.client, http.server
import http.cookies, http.cookiejar
import urllib.parse, urllib.request, urllib.response, urllib.error, urllib.robotparser
import xmlrpc.client, xmlrpc.server
import _thread
import _dummy_thread
import _markupbase
from itertools import filterfalse, zip_longest
from sys import intern
from collections import UserDict, UserList, UserString
from collections import OrderedDict, Counter, ChainMap # even on Py2.6
from subprocess import getoutput, getstatusoutput
from subprocess import check_output # even on Py2.6
from multiprocessing import SimpleQueue
(The renamed modules and functions are still available under their old
names on Python 2.)
This is a cleaner alternative to this idiom (see
http://docs.pythonsprints.com/python3_porting/py-porting.html)::
try:
import queue
except ImportError:
import Queue as queue
Limitations
-----------
We don't currently support these modules, but would like to::
import dbm
import dbm.dumb
import dbm.gnu
import collections.abc # on Py33
import pickle # should (optionally) bring in cPickle on Python 2
"""
from __future__ import absolute_import, division, print_function
import sys
import logging
# imp was deprecated in python 3.6
if sys.version_info >= (3, 6):
import importlib as imp
else:
import imp
import contextlib
import copy
import os
# Make a dedicated logger; leave the root logger to be configured
# by the application.
flog = logging.getLogger('future_stdlib')
_formatter = logging.Formatter(logging.BASIC_FORMAT)
_handler = logging.StreamHandler()
_handler.setFormatter(_formatter)
flog.addHandler(_handler)
flog.setLevel(logging.WARN)
from future.utils import PY2, PY3
# The modules that are defined under the same names on Py3 but with
# different contents in a significant way (e.g. submodules) are:
# pickle (fast one)
# dbm
# urllib
# test
# email
REPLACED_MODULES = set(['test', 'urllib', 'pickle', 'dbm']) # add email and dbm when we support it
# The following module names are not present in Python 2.x, so they cause no
# potential clashes between the old and new names:
# http
# html
# tkinter
# xmlrpc
# Keys: Py2 / real module names
# Values: Py3 / simulated module names
RENAMES = {
# 'cStringIO': 'io', # there's a new io module in Python 2.6
# that provides StringIO and BytesIO
# 'StringIO': 'io', # ditto
# 'cPickle': 'pickle',
'__builtin__': 'builtins',
'copy_reg': 'copyreg',
'Queue': 'queue',
'future.moves.socketserver': 'socketserver',
'ConfigParser': 'configparser',
'repr': 'reprlib',
'multiprocessing.queues': 'multiprocessing',
# 'FileDialog': 'tkinter.filedialog',
# 'tkFileDialog': 'tkinter.filedialog',
# 'SimpleDialog': 'tkinter.simpledialog',
# 'tkSimpleDialog': 'tkinter.simpledialog',
# 'tkColorChooser': 'tkinter.colorchooser',
# 'tkCommonDialog': 'tkinter.commondialog',
# 'Dialog': 'tkinter.dialog',
# 'Tkdnd': 'tkinter.dnd',
# 'tkFont': 'tkinter.font',
# 'tkMessageBox': 'tkinter.messagebox',
# 'ScrolledText': 'tkinter.scrolledtext',
# 'Tkconstants': 'tkinter.constants',
# 'Tix': 'tkinter.tix',
# 'ttk': 'tkinter.ttk',
# 'Tkinter': 'tkinter',
'_winreg': 'winreg',
'thread': '_thread',
'dummy_thread': '_dummy_thread' if sys.version_info < (3, 9) else '_thread',
# 'anydbm': 'dbm', # causes infinite import loop
# 'whichdb': 'dbm', # causes infinite import loop
# anydbm and whichdb are handled by fix_imports2
# 'dbhash': 'dbm.bsd',
# 'dumbdbm': 'dbm.dumb',
# 'dbm': 'dbm.ndbm',
# 'gdbm': 'dbm.gnu',
'future.moves.xmlrpc': 'xmlrpc',
# 'future.backports.email': 'email', # for use by urllib
# 'DocXMLRPCServer': 'xmlrpc.server',
# 'SimpleXMLRPCServer': 'xmlrpc.server',
# 'httplib': 'http.client',
# 'htmlentitydefs' : 'html.entities',
# 'HTMLParser' : 'html.parser',
# 'Cookie': 'http.cookies',
# 'cookielib': 'http.cookiejar',
# 'BaseHTTPServer': 'http.server',
# 'SimpleHTTPServer': 'http.server',
# 'CGIHTTPServer': 'http.server',
# 'future.backports.test': 'test', # primarily for renaming test_support to support
# 'commands': 'subprocess',
# 'urlparse' : 'urllib.parse',
# 'robotparser' : 'urllib.robotparser',
# 'abc': 'collections.abc', # for Py33
# 'future.utils.six.moves.html': 'html',
# 'future.utils.six.moves.http': 'http',
'future.moves.html': 'html',
'future.moves.http': 'http',
# 'future.backports.urllib': 'urllib',
# 'future.utils.six.moves.urllib': 'urllib',
'future.moves._markupbase': '_markupbase',
}
# It is complicated and apparently brittle to mess around with the
# ``sys.modules`` cache in order to support "import urllib" meaning two
# different things (Py2.7 urllib and backported Py3.3-like urllib) in different
# contexts. So we require explicit imports for these modules.
assert len(set(RENAMES.values()) & set(REPLACED_MODULES)) == 0
# Harmless renames that we can insert.
# These modules need names from elsewhere being added to them:
# subprocess: should provide getoutput and other fns from commands
# module but these fns are missing: getstatus, mk2arg,
# mkarg
# re: needs an ASCII constant that works compatibly with Py3
# etc: see lib2to3/fixes/fix_imports.py
# (New module name, new object name, old module name, old object name)
MOVES = [('collections', 'UserList', 'UserList', 'UserList'),
('collections', 'UserDict', 'UserDict', 'UserDict'),
('collections', 'UserString','UserString', 'UserString'),
('collections', 'ChainMap', 'future.backports.misc', 'ChainMap'),
('itertools', 'filterfalse','itertools', 'ifilterfalse'),
('itertools', 'zip_longest','itertools', 'izip_longest'),
('sys', 'intern','__builtin__', 'intern'),
('multiprocessing', 'SimpleQueue', 'multiprocessing.queues', 'SimpleQueue'),
# The re module has no ASCII flag in Py2, but this is the default.
# Set re.ASCII to a zero constant. stat.ST_MODE just happens to be one
# (and it exists on Py2.6+).
('re', 'ASCII','stat', 'ST_MODE'),
('base64', 'encodebytes','base64', 'encodestring'),
('base64', 'decodebytes','base64', 'decodestring'),
('subprocess', 'getoutput', 'commands', 'getoutput'),
('subprocess', 'getstatusoutput', 'commands', 'getstatusoutput'),
('subprocess', 'check_output', 'future.backports.misc', 'check_output'),
('math', 'ceil', 'future.backports.misc', 'ceil'),
('collections', 'OrderedDict', 'future.backports.misc', 'OrderedDict'),
('collections', 'Counter', 'future.backports.misc', 'Counter'),
('collections', 'ChainMap', 'future.backports.misc', 'ChainMap'),
('itertools', 'count', 'future.backports.misc', 'count'),
('reprlib', 'recursive_repr', 'future.backports.misc', 'recursive_repr'),
('functools', 'cmp_to_key', 'future.backports.misc', 'cmp_to_key'),
# This is no use, since "import urllib.request" etc. still fails:
# ('urllib', 'error', 'future.moves.urllib', 'error'),
# ('urllib', 'parse', 'future.moves.urllib', 'parse'),
# ('urllib', 'request', 'future.moves.urllib', 'request'),
# ('urllib', 'response', 'future.moves.urllib', 'response'),
# ('urllib', 'robotparser', 'future.moves.urllib', 'robotparser'),
]
# A minimal example of an import hook:
# class WarnOnImport(object):
# def __init__(self, *args):
# self.module_names = args
#
# def find_module(self, fullname, path=None):
# if fullname in self.module_names:
# self.path = path
# return self
# return None
#
# def load_module(self, name):
# if name in sys.modules:
# return sys.modules[name]
# module_info = imp.find_module(name, self.path)
# module = imp.load_module(name, *module_info)
# sys.modules[name] = module
# flog.warning("Imported deprecated module %s", name)
# return module
class RenameImport(object):
"""
A class for import hooks mapping Py3 module names etc. to the Py2 equivalents.
"""
# Different RenameImport classes are created when importing this module from
# different source files. This causes isinstance(hook, RenameImport) checks
# to produce inconsistent results. We add this RENAMER attribute here so
# remove_hooks() and install_hooks() can find instances of these classes
# easily:
RENAMER = True
def __init__(self, old_to_new):
'''
Pass in a dictionary-like object mapping from old names to new
names. E.g. {'ConfigParser': 'configparser', 'cPickle': 'pickle'}
'''
self.old_to_new = old_to_new
both = set(old_to_new.keys()) & set(old_to_new.values())
assert (len(both) == 0 and
len(set(old_to_new.values())) == len(old_to_new.values())), \
'Ambiguity in renaming (handler not implemented)'
self.new_to_old = dict((new, old) for (old, new) in old_to_new.items())
def find_module(self, fullname, path=None):
# Handles hierarchical importing: package.module.module2
new_base_names = set([s.split('.')[0] for s in self.new_to_old])
# Before v0.12: Was: if fullname in set(self.old_to_new) | new_base_names:
if fullname in new_base_names:
return self
return None
def load_module(self, name):
path = None
if name in sys.modules:
return sys.modules[name]
elif name in self.new_to_old:
# New name. Look up the corresponding old (Py2) name:
oldname = self.new_to_old[name]
module = self._find_and_load_module(oldname)
# module.__future_module__ = True
else:
module = self._find_and_load_module(name)
# In any case, make it available under the requested (Py3) name
sys.modules[name] = module
return module
def _find_and_load_module(self, name, path=None):
"""
Finds and loads it. But if there's a . in the name, handles it
properly.
"""
bits = name.split('.')
while len(bits) > 1:
# Treat the first bit as a package
packagename = bits.pop(0)
package = self._find_and_load_module(packagename, path)
try:
path = package.__path__
except AttributeError:
# This could be e.g. moves.
flog.debug('Package {0} has no __path__.'.format(package))
if name in sys.modules:
return sys.modules[name]
flog.debug('What to do here?')
name = bits[0]
module_info = imp.find_module(name, path)
return imp.load_module(name, *module_info)
class hooks(object):
"""
Acts as a context manager. Saves the state of sys.modules and restores it
after the 'with' block.
Use like this:
>>> from future import standard_library
>>> with standard_library.hooks():
... import http.client
>>> import requests
For this to work, http.client will be scrubbed from sys.modules after the
'with' block. That way the modules imported in the 'with' block will
continue to be accessible in the current namespace but not from any
imported modules (like requests).
"""
def __enter__(self):
# flog.debug('Entering hooks context manager')
self.old_sys_modules = copy.copy(sys.modules)
self.hooks_were_installed = detect_hooks()
# self.scrubbed = scrub_py2_sys_modules()
install_hooks()
return self
def __exit__(self, *args):
# flog.debug('Exiting hooks context manager')
# restore_sys_modules(self.scrubbed)
if not self.hooks_were_installed:
remove_hooks()
# scrub_future_sys_modules()
# Sanity check for is_py2_stdlib_module(): We aren't replacing any
# builtin modules names:
if PY2:
assert len(set(RENAMES.values()) & set(sys.builtin_module_names)) == 0
def is_py2_stdlib_module(m):
"""
Tries to infer whether the module m is from the Python 2 standard library.
This may not be reliable on all systems.
"""
if PY3:
return False
if not 'stdlib_path' in is_py2_stdlib_module.__dict__:
stdlib_files = [contextlib.__file__, os.__file__, copy.__file__]
stdlib_paths = [os.path.split(f)[0] for f in stdlib_files]
if not len(set(stdlib_paths)) == 1:
# This seems to happen on travis-ci.org. Very strange. We'll try to
# ignore it.
flog.warn('Multiple locations found for the Python standard '
'library: %s' % stdlib_paths)
# Choose the first one arbitrarily
is_py2_stdlib_module.stdlib_path = stdlib_paths[0]
if m.__name__ in sys.builtin_module_names:
return True
if hasattr(m, '__file__'):
modpath = os.path.split(m.__file__)
if (modpath[0].startswith(is_py2_stdlib_module.stdlib_path) and
'site-packages' not in modpath[0]):
return True
return False
def scrub_py2_sys_modules():
"""
Removes any Python 2 standard library modules from ``sys.modules`` that
would interfere with Py3-style imports using import hooks. Examples are
modules with the same names (like urllib or email).
(Note that currently import hooks are disabled for modules like these
with ambiguous names anyway ...)
"""
if PY3:
return {}
scrubbed = {}
for modulename in REPLACED_MODULES & set(RENAMES.keys()):
if not modulename in sys.modules:
continue
module = sys.modules[modulename]
if is_py2_stdlib_module(module):
flog.debug('Deleting (Py2) {} from sys.modules'.format(modulename))
scrubbed[modulename] = sys.modules[modulename]
del sys.modules[modulename]
return scrubbed
def scrub_future_sys_modules():
"""
Deprecated.
"""
return {}
class suspend_hooks(object):
"""
Acts as a context manager. Use like this:
>>> from future import standard_library
>>> standard_library.install_hooks()
>>> import http.client
>>> # ...
>>> with standard_library.suspend_hooks():
>>> import requests # incompatible with ``future``'s standard library hooks
If the hooks were disabled before the context, they are not installed when
the context is left.
"""
def __enter__(self):
self.hooks_were_installed = detect_hooks()
remove_hooks()
# self.scrubbed = scrub_future_sys_modules()
return self
def __exit__(self, *args):
if self.hooks_were_installed:
install_hooks()
# restore_sys_modules(self.scrubbed)
def restore_sys_modules(scrubbed):
"""
Add any previously scrubbed modules back to the sys.modules cache,
but only if it's safe to do so.
"""
clash = set(sys.modules) & set(scrubbed)
if len(clash) != 0:
# If several, choose one arbitrarily to raise an exception about
first = list(clash)[0]
raise ImportError('future module {} clashes with Py2 module'
.format(first))
sys.modules.update(scrubbed)
def install_aliases():
"""
Monkey-patches the standard library in Py2.6/7 to provide
aliases for better Py3 compatibility.
"""
if PY3:
return
# if hasattr(install_aliases, 'run_already'):
# return
for (newmodname, newobjname, oldmodname, oldobjname) in MOVES:
__import__(newmodname)
# We look up the module in sys.modules because __import__ just returns the
# top-level package:
newmod = sys.modules[newmodname]
# newmod.__future_module__ = True
__import__(oldmodname)
oldmod = sys.modules[oldmodname]
obj = getattr(oldmod, oldobjname)
setattr(newmod, newobjname, obj)
# Hack for urllib so it appears to have the same structure on Py2 as on Py3
import urllib
from future.backports.urllib import request
from future.backports.urllib import response
from future.backports.urllib import parse
from future.backports.urllib import error
from future.backports.urllib import robotparser
urllib.request = request
urllib.response = response
urllib.parse = parse
urllib.error = error
urllib.robotparser = robotparser
sys.modules['urllib.request'] = request
sys.modules['urllib.response'] = response
sys.modules['urllib.parse'] = parse
sys.modules['urllib.error'] = error
sys.modules['urllib.robotparser'] = robotparser
# Patch the test module so it appears to have the same structure on Py2 as on Py3
try:
import test
except ImportError:
pass
try:
from future.moves.test import support
except ImportError:
pass
else:
test.support = support
sys.modules['test.support'] = support
# Patch the dbm module so it appears to have the same structure on Py2 as on Py3
try:
import dbm
except ImportError:
pass
else:
from future.moves.dbm import dumb
dbm.dumb = dumb
sys.modules['dbm.dumb'] = dumb
try:
from future.moves.dbm import gnu
except ImportError:
pass
else:
dbm.gnu = gnu
sys.modules['dbm.gnu'] = gnu
try:
from future.moves.dbm import ndbm
except ImportError:
pass
else:
dbm.ndbm = ndbm
sys.modules['dbm.ndbm'] = ndbm
# install_aliases.run_already = True
def install_hooks():
"""
This function installs the future.standard_library import hook into
sys.meta_path.
"""
if PY3:
return
install_aliases()
flog.debug('sys.meta_path was: {0}'.format(sys.meta_path))
flog.debug('Installing hooks ...')
# Add it unless it's there already
newhook = RenameImport(RENAMES)
if not detect_hooks():
sys.meta_path.append(newhook)
flog.debug('sys.meta_path is now: {0}'.format(sys.meta_path))
def enable_hooks():
"""
Deprecated. Use install_hooks() instead. This will be removed by
``future`` v1.0.
"""
install_hooks()
def remove_hooks(scrub_sys_modules=False):
"""
This function removes the import hook from sys.meta_path.
"""
if PY3:
return
flog.debug('Uninstalling hooks ...')
# Loop backwards, so deleting items keeps the ordering:
for i, hook in list(enumerate(sys.meta_path))[::-1]:
if hasattr(hook, 'RENAMER'):
del sys.meta_path[i]
# Explicit is better than implicit. In the future the interface should
# probably change so that scrubbing the import hooks requires a separate
# function call. Left as is for now for backward compatibility with
# v0.11.x.
if scrub_sys_modules:
scrub_future_sys_modules()
def disable_hooks():
"""
Deprecated. Use remove_hooks() instead. This will be removed by
``future`` v1.0.
"""
remove_hooks()
def detect_hooks():
"""
Returns True if the import hooks are installed, False if not.
"""
flog.debug('Detecting hooks ...')
present = any([hasattr(hook, 'RENAMER') for hook in sys.meta_path])
if present:
flog.debug('Detected.')
else:
flog.debug('Not detected.')
return present
# As of v0.12, this no longer happens implicitly:
# if not PY3:
# install_hooks()
if not hasattr(sys, 'py2_modules'):
sys.py2_modules = {}
def cache_py2_modules():
"""
Currently this function is unneeded, as we are not attempting to provide import hooks
for modules with ambiguous names: email, urllib, pickle.
"""
if len(sys.py2_modules) != 0:
return
assert not detect_hooks()
import urllib
sys.py2_modules['urllib'] = urllib
import email
sys.py2_modules['email'] = email
import pickle
sys.py2_modules['pickle'] = pickle
# Not all Python installations have test module. (Anaconda doesn't, for example.)
# try:
# import test
# except ImportError:
# sys.py2_modules['test'] = None
# sys.py2_modules['test'] = test
# import dbm
# sys.py2_modules['dbm'] = dbm
def import_(module_name, backport=False):
"""
Pass a (potentially dotted) module name of a Python 3 standard library
module. This function imports the module compatibly on Py2 and Py3 and
returns the top-level module.
Example use:
>>> http = import_('http.client')
>>> http = import_('http.server')
>>> urllib = import_('urllib.request')
Then:
>>> conn = http.client.HTTPConnection(...)
>>> response = urllib.request.urlopen('http://mywebsite.com')
>>> # etc.
Use as follows:
>>> package_name = import_(module_name)
On Py3, equivalent to this:
>>> import module_name
On Py2, equivalent to this if backport=False:
>>> from future.moves import module_name
or to this if backport=True:
>>> from future.backports import module_name
except that it also handles dotted module names such as ``http.client``
The effect then is like this:
>>> from future.backports import module
>>> from future.backports.module import submodule
>>> module.submodule = submodule
Note that this would be a SyntaxError in Python:
>>> from future.backports import http.client
"""
# Python 2.6 doesn't have importlib in the stdlib, so it requires
# the backported ``importlib`` package from PyPI as a dependency to use
# this function:
import importlib
if PY3:
return __import__(module_name)
else:
# client.blah = blah
# Then http.client = client
# etc.
if backport:
prefix = 'future.backports'
else:
prefix = 'future.moves'
parts = prefix.split('.') + module_name.split('.')
modules = []
for i, part in enumerate(parts):
sofar = '.'.join(parts[:i+1])
modules.append(importlib.import_module(sofar))
for i, part in reversed(list(enumerate(parts))):
if i == 0:
break
setattr(modules[i-1], part, modules[i])
# Return the next-most top-level module after future.backports / future.moves:
return modules[2]
def from_import(module_name, *symbol_names, **kwargs):
"""
Example use:
>>> HTTPConnection = from_import('http.client', 'HTTPConnection')
>>> HTTPServer = from_import('http.server', 'HTTPServer')
>>> urlopen, urlparse = from_import('urllib.request', 'urlopen', 'urlparse')
Equivalent to this on Py3:
>>> from module_name import symbol_names[0], symbol_names[1], ...
and this on Py2:
>>> from future.moves.module_name import symbol_names[0], ...
or:
>>> from future.backports.module_name import symbol_names[0], ...
except that it also handles dotted module names such as ``http.client``.
"""
if PY3:
return __import__(module_name)
else:
if 'backport' in kwargs and bool(kwargs['backport']):
prefix = 'future.backports'
else:
prefix = 'future.moves'
parts = prefix.split('.') + module_name.split('.')
module = importlib.import_module(prefix + '.' + module_name)
output = [getattr(module, name) for name in symbol_names]
if len(output) == 1:
return output[0]
else:
return output
class exclude_local_folder_imports(object):
"""
A context-manager that prevents standard library modules like configparser
from being imported from the local python-future source folder on Py3.
(This was need prior to v0.16.0 because the presence of a configparser
folder would otherwise have prevented setuptools from running on Py3. Maybe
it's not needed any more?)
"""
def __init__(self, *args):
assert len(args) > 0
self.module_names = args
# Disallow dotted module names like http.client:
if any(['.' in m for m in self.module_names]):
raise NotImplementedError('Dotted module names are not supported')
def __enter__(self):
self.old_sys_path = copy.copy(sys.path)
self.old_sys_modules = copy.copy(sys.modules)
if sys.version_info[0] < 3:
return
# The presence of all these indicates we've found our source folder,
# because `builtins` won't have been installed in site-packages by setup.py:
FUTURE_SOURCE_SUBFOLDERS = ['future', 'past', 'libfuturize', 'libpasteurize', 'builtins']
# Look for the future source folder:
for folder in self.old_sys_path:
if all([os.path.exists(os.path.join(folder, subfolder))
for subfolder in FUTURE_SOURCE_SUBFOLDERS]):
# Found it. Remove it.
sys.path.remove(folder)
# Ensure we import the system module:
for m in self.module_names:
# Delete the module and any submodules from sys.modules:
# for key in list(sys.modules):
# if key == m or key.startswith(m + '.'):
# try:
# del sys.modules[key]
# except KeyError:
# pass
try:
module = __import__(m, level=0)
except ImportError:
# There's a problem importing the system module. E.g. the
# winreg module is not available except on Windows.
pass
def __exit__(self, *args):
# Restore sys.path and sys.modules:
sys.path = self.old_sys_path
for m in set(self.old_sys_modules.keys()) - set(sys.modules.keys()):
sys.modules[m] = self.old_sys_modules[m]
TOP_LEVEL_MODULES = ['builtins',
'copyreg',
'html',
'http',
'queue',
'reprlib',
'socketserver',
'test',
'tkinter',
'winreg',
'xmlrpc',
'_dummy_thread',
'_markupbase',
'_thread',
]
def import_top_level_modules():
with exclude_local_folder_imports(*TOP_LEVEL_MODULES):
for m in TOP_LEVEL_MODULES:
try:
__import__(m)
except ImportError: # e.g. winreg
pass
PK *Bu\��um�H �H ; future/standard_library/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h�m � @ s d Z ddlmZmZmZ ddlZddlZejdkr<ddlZ nddl Z ddl
Z
ddl Z ddl Z e�
d�Ze�ej�Ze�� Ze�e� e�e� e�ej� ddlmZmZ eg d��Z dd d
d d d
dddejdk r�dndddddd�Z e ee � � �ee �@ �dk�sJ �g d�Z G dd� de!�Z"G dd � d e!�Z#e�rZe ee � � �eej$�@ �dk�sZJ �d d � Z%d d � Z&d!d"� Z'G d#d$� d$e!�Z(d%d&� Z)d'd(� Z*d)d*� Z+d+d,� Z,d@d.d/�Z-d0d1� Z.d2d3� Z/e0ed4��s�i e_1d5d6� Z2dAd7d8�Z3d9d:� Z4G d;d<� d<e!�Z5g d=�Z6d>d?� Z7dS )Ba�
Python 3 reorganized the standard library (PEP 3108). This module exposes
several standard library modules to Python 2 under their new Python 3
names.
It is designed to be used as follows::
from future import standard_library
standard_library.install_aliases()
And then these normal Py3 imports work on both Py3 and Py2::
import builtins
import copyreg
import queue
import reprlib
import socketserver
import winreg # on Windows only
import test.support
import html, html.parser, html.entities
import http, http.client, http.server
import http.cookies, http.cookiejar
import urllib.parse, urllib.request, urllib.response, urllib.error, urllib.robotparser
import xmlrpc.client, xmlrpc.server
import _thread
import _dummy_thread
import _markupbase
from itertools import filterfalse, zip_longest
from sys import intern
from collections import UserDict, UserList, UserString
from collections import OrderedDict, Counter, ChainMap # even on Py2.6
from subprocess import getoutput, getstatusoutput
from subprocess import check_output # even on Py2.6
from multiprocessing import SimpleQueue
(The renamed modules and functions are still available under their old
names on Python 2.)
This is a cleaner alternative to this idiom (see
http://docs.pythonsprints.com/python3_porting/py-porting.html)::
try:
import queue
except ImportError:
import Queue as queue
Limitations
-----------
We don't currently support these modules, but would like to::
import dbm
import dbm.dumb
import dbm.gnu
import collections.abc # on Py33
import pickle # should (optionally) bring in cPickle on Python 2
� )�absolute_import�division�print_functionN)� � Z
future_stdlib)�PY2�PY3)�test�urllib�pickle�dbm�builtins�copyreg�queue� socketserver� configparser�reprlib�multiprocessing�winreg�_thread)r � �
_dummy_thread�xmlrpc�html�http� _markupbase)� __builtin__�copy_reg�Queuezfuture.moves.socketserver� ConfigParser�repr�multiprocessing.queues�_winreg�thread� dummy_threadzfuture.moves.xmlrpczfuture.moves.htmlzfuture.moves.httpzfuture.moves._markupbase))� collections�UserListr& r& )r% �UserDictr' r' )r% �
UserStringr( r( �r% �ChainMap�future.backports.miscr* )� itertools� filterfalser, � ifilterfalse)r, � zip_longestr, � izip_longest)�sys�internr r2 )r � SimpleQueuer! r3 )�re�ASCII�stat�ST_MODE)�base64� encodebytesr8 � encodestring)r8 � decodebytesr8 � decodestring)�
subprocess� getoutput�commandsr> )r= �getstatusoutputr? r@ )r= � check_outputr+ rA )�math�ceilr+ rC )r% � OrderedDictr+ rD )r% �Counterr+ rE r) )r, �countr+ rF )r �recursive_reprr+ rG )� functools�
cmp_to_keyr+ rI c @ s8 e Zd ZdZdZdd� Zd dd�Zdd � Zd
d
d �ZdS )� RenameImportzX
A class for import hooks mapping Py3 module names etc. to the Py2 equivalents.
Tc C sj || _ t|�� �t|�� �@ }t|�dkrFtt|�� ��t|�� �ksNJ d��tdd� |�� D ��| _dS )z�
Pass in a dictionary-like object mapping from old names to new
names. E.g. {'ConfigParser': 'configparser', 'cPickle': 'pickle'}
r z/Ambiguity in renaming (handler not implemented)c s s | ]\}}||fV qd S �N� )�.0�old�newrL rL �J/usr/local/lib/python3.9/site-packages/future/standard_library/__init__.py� <genexpr> � z(RenameImport.__init__.<locals>.<genexpr>N)�
old_to_new�set�keys�values�len�dict�items�
new_to_old)�selfrS ZbothrL rL rP �__init__� s ��zRenameImport.__init__Nc C s$ t dd� | jD ��}||v r | S d S )Nc S s g | ]}|� d �d �qS )�.r )�split)rM �srL rL rP �
<listcomp> rR z,RenameImport.find_module.<locals>.<listcomp>)rT rZ )r[ �fullname�pathZnew_base_namesrL rL rP � find_module s zRenameImport.find_modulec C sP d }|t jv rt j| S || jv r8| j| }| �|�}n
| �|�}|t j|< |S rK )r1 �modulesrZ �_find_and_load_module)r[ �namerb Zoldname�modulerL rL rP � load_module s
zRenameImport.load_modulec C s� |� d�}t|�dkr~|�d�}| �||�}z
|j}W q
tyz t�d�|�� |t j
v rlt j
| Y S t�d� Y q
0 q
|d }t � ||�}t j
|g|�R � S )zb
Finds and loads it. But if there's a . in the name, handles it
properly.
r] � r z Package {0} has no __path__.zWhat to do here?)r^ rW �popre �__path__�AttributeError�flog�debug�formatr1 rd �imprc rh )r[ rf rb �bitsZ packagename�packageZ module_inforL rL rP re s
z"RenameImport._find_and_load_module)N)N) �__name__�
__module__� __qualname__�__doc__�RENAMERr\ rc rh re rL rL rL rP rJ � s
rJ c @ s e Zd ZdZdd� Zdd� ZdS )�hooksa
Acts as a context manager. Saves the state of sys.modules and restores it
after the 'with' block.
Use like this:
>>> from future import standard_library
>>> with standard_library.hooks():
... import http.client
>>> import requests
For this to work, http.client will be scrubbed from sys.modules after the
'with' block. That way the modules imported in the 'with' block will
continue to be accessible in the current namespace but not from any
imported modules (like requests).
c C s t � tj�| _t� | _t� | S rK )�copyr1 rd �old_sys_modules� detect_hooks�hooks_were_installed�
install_hooks�r[ rL rL rP � __enter__G s zhooks.__enter__c G s | j s t� d S rK )r| � remove_hooks�r[ �argsrL rL rP �__exit__O s zhooks.__exit__N�rs rt ru rv r r� rL rL rL rP rx 6 s rx c C s� t rdS dtjvrXtjtjtjg}dd� |D �}tt|��dksNt �
d| � |d t_ | j t
jv rhdS t| d �r�tj�| j�}|d �tj �r�d
|d vr�dS dS ) z�
Tries to infer whether the module m is from the Python 2 standard library.
This may not be reliable on all systems.
F� stdlib_pathc S s g | ]}t j�|�d �qS )r )�osrb r^ )rM �frL rL rP r` e rR z(is_py2_stdlib_module.<locals>.<listcomp>ri z<Multiple locations found for the Python standard library: %sr T�__file__z
site-packages)r �is_py2_stdlib_module�__dict__�
contextlibr� r� ry rW rT rm �warnr� rs r1 �builtin_module_names�hasattrrb r^ �
startswith)�mZ stdlib_filesZ stdlib_paths�modpathrL rL rP r� \ s&
�
�r� c C sj t ri S i } ttt�� �@ D ]H}|tjvr,q tj| }t|�r t� d�
|�� tj| | |< tj|= q | S )aE
Removes any Python 2 standard library modules from ``sys.modules`` that
would interfere with Py3-style imports using import hooks. Examples are
modules with the same names (like urllib or email).
(Note that currently import hooks are disabled for modules like these
with ambiguous names anyway ...)
z"Deleting (Py2) {} from sys.modules) r �REPLACED_MODULESrT �RENAMESrU r1 rd r� rm rn ro )�scrubbed�
modulenamerg rL rL rP �scrub_py2_sys_modulesz s
r� c C s i S )z
Deprecated.
rL rL rL rL rP �scrub_future_sys_modules� s r� c @ s e Zd ZdZdd� Zdd� ZdS )�
suspend_hooksa�
Acts as a context manager. Use like this:
>>> from future import standard_library
>>> standard_library.install_hooks()
>>> import http.client
>>> # ...
>>> with standard_library.suspend_hooks():
>>> import requests # incompatible with ``future``'s standard library hooks
If the hooks were disabled before the context, they are not installed when
the context is left.
c C s t � | _t� | S rK )r{ r| r� r~ rL rL rP r � s zsuspend_hooks.__enter__c G s | j r t� d S rK )r| r} r� rL rL rP r� � s zsuspend_hooks.__exit__Nr� rL rL rL rP r� � s
r� c C sH t tj�t | �@ }t|�dkr8t|�d }td�|���tj�| � dS )zp
Add any previously scrubbed modules back to the sys.modules cache,
but only if it's safe to do so.
r z(future module {} clashes with Py2 moduleN)rT r1 rd rW �list� ImportErrorro �update)r� Zclash�firstrL rL rP �restore_sys_modules� s �r� c C s� t rdS tD ]F\} }}}t| � tj| }t|� tj| }t||�}t|||� q ddl}ddlm } ddlm
} ddlm }
ddlm } ddlm
} ||_ | |_
|
|_ | |_ | |_
|tjd< | tjd < |
tjd
< | tjd < | tjd < z ddl}
W n t�y Y n0 zdd
lm} W n t�y. Y n0 ||
_|tjd< z ddl}W n t�y` Y n�0 ddlm} ||_|tjd< zddlm} W n t�y� Y n0 ||_|tjd< zddlm} W n t�y� Y n0 ||_|tjd< dS )zm
Monkey-patches the standard library in Py2.6/7 to provide
aliases for better Py3 compatibility.
Nr )�request)�response)�parse)�error)� robotparserzurllib.requestzurllib.responsez urllib.parsez urllib.errorzurllib.robotparser)�supportz test.support)�dumbzdbm.dumb)�gnuzdbm.gnu)�ndbmzdbm.ndbm)r �MOVES�
__import__r1 rd �getattr�setattrr
Zfuture.backports.urllibr� r� r� r� r� r r� Zfuture.moves.testr� r Zfuture.moves.dbmr� r� r� )Z
newmodnameZ
newobjnameZ
oldmodnameZ
oldobjnameZnewmodZoldmod�objr
r� r� r� r� r� r r� r r� r� r� rL rL rP �install_aliases� sl
r� c C sZ t rdS t� t�d�tj�� t�d� tt�} t � sDtj�
| � t�d�tj�� dS )z`
This function installs the future.standard_library import hook into
sys.meta_path.
Nzsys.meta_path was: {0}zInstalling hooks ...zsys.meta_path is now: {0}) r r� rm rn ro r1 � meta_pathrJ r� r{ �append)ZnewhookrL rL rP r} s
r} c C s
t � dS )z_
Deprecated. Use install_hooks() instead. This will be removed by
``future`` v1.0.
N)r} rL rL rL rP � enable_hooks% s r� Fc C sT t rdS t�d� tttj��ddd� D ]\}}t|d�r*tj|= q*| rPt� dS )zC
This function removes the import hook from sys.meta_path.
NzUninstalling hooks ...���rw ) r rm rn r� � enumerater1 r� r� r� )Zscrub_sys_modules�i�hookrL rL rP r� - s
r� c C s
t � dS )z^
Deprecated. Use remove_hooks() instead. This will be removed by
``future`` v1.0.
N)r� rL rL rL rP �
disable_hooksA s r� c C s< t �d� tdd� tjD ��} | r.t �d� n
t �d� | S )zG
Returns True if the import hooks are installed, False if not.
zDetecting hooks ...c S s g | ]}t |d ��qS )rw )r� )rM r� rL rL rP r` N rR z detect_hooks.<locals>.<listcomp>z Detected.z
Not detected.)rm rn �anyr1 r� )ZpresentrL rL rP r{ I s
r{ � py2_modulesc C sV t tj�dkrdS t� r J �ddl} | tjd< ddl}|tjd< ddl}|tjd< dS )z�
Currently this function is unneeded, as we are not attempting to provide import hooks
for modules with ambiguous names: email, urllib, pickle.
r Nr
�emailr )rW r1 r� r{ r
r� r )r
r� r rL rL rP �cache_py2_modules^ s
r� c C s� ddl }trt| �S |r d}nd}|�d�| �d� }g }t|�D ].\}}d�|d|d � �}|�|�|�� qBtt t|���D ],\}}|dkr� q�t
||d ||| � q�|d S dS )a�
Pass a (potentially dotted) module name of a Python 3 standard library
module. This function imports the module compatibly on Py2 and Py3 and
returns the top-level module.
Example use:
>>> http = import_('http.client')
>>> http = import_('http.server')
>>> urllib = import_('urllib.request')
Then:
>>> conn = http.client.HTTPConnection(...)
>>> response = urllib.request.urlopen('http://mywebsite.com')
>>> # etc.
Use as follows:
>>> package_name = import_(module_name)
On Py3, equivalent to this:
>>> import module_name
On Py2, equivalent to this if backport=False:
>>> from future.moves import module_name
or to this if backport=True:
>>> from future.backports import module_name
except that it also handles dotted module names such as ``http.client``
The effect then is like this:
>>> from future.backports import module
>>> from future.backports.module import submodule
>>> module.submodule = submodule
Note that this would be a SyntaxError in Python:
>>> from future.backports import http.client
r N�future.backports� future.movesr] ri � ) � importlibr r� r^ r� �joinr� �
import_module�reversedr� r� ) � module_name�backportr� �prefix�partsrd r� �partZsofarrL rL rP �import_z s .r� c s~ t r t| �S d|v r&t|d �r&d}nd}|�d�| �d� }t�|d | �� � fdd�|D �}t|�dkrv|d S |S d S )
aa
Example use:
>>> HTTPConnection = from_import('http.client', 'HTTPConnection')
>>> HTTPServer = from_import('http.server', 'HTTPServer')
>>> urlopen, urlparse = from_import('urllib.request', 'urlopen', 'urlparse')
Equivalent to this on Py3:
>>> from module_name import symbol_names[0], symbol_names[1], ...
and this on Py2:
>>> from future.moves.module_name import symbol_names[0], ...
or:
>>> from future.backports.module_name import symbol_names[0], ...
except that it also handles dotted module names such as ``http.client``.
r� r� r� r] c s g | ]}t � |��qS rL )r� )rM rf �rg rL rP r` � rR z from_import.<locals>.<listcomp>ri r N)r r� �boolr^ r� r� rW )r� Z symbol_names�kwargsr� r� �outputrL r� rP � from_import� s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � exclude_local_folder_importsaZ
A context-manager that prevents standard library modules like configparser
from being imported from the local python-future source folder on Py3.
(This was need prior to v0.16.0 because the presence of a configparser
folder would otherwise have prevented setuptools from running on Py3. Maybe
it's not needed any more?)
c G s6 t |�dksJ �|| _tdd� | jD ��r2td��d S )Nr c S s g | ] }d |v �qS )r] rL )rM r� rL rL rP r` � rR z9exclude_local_folder_imports.__init__.<locals>.<listcomp>z%Dotted module names are not supported)rW � module_namesr� �NotImplementedErrorr� rL rL rP r\ � s z%exclude_local_folder_imports.__init__c s� t � tj�| _t � tj�| _tjd dk r.d S g d�}| jD ]&� t� fdd�|D ��r<tj�� � q<| j D ](}zt
|dd�}W qj t y� Y qj0 qjd S )Nr r )�futureZpastZ libfuturizeZ
libpasteurizer
c s" g | ]}t j�t j�� |���qS rL )r� rb �existsr� )rM Z subfolder��folderrL rP r` s �z:exclude_local_folder_imports.__enter__.<locals>.<listcomp>)�level) ry r1 rb � old_sys_pathrd rz � version_info�all�remover� r� r� )r[ ZFUTURE_SOURCE_SUBFOLDERSr� rg rL r� rP r � s
�
z&exclude_local_folder_imports.__enter__c G s> | j t_t| j�� �ttj�� � D ]}| j| tj|< q$d S rK )r� r1 rb rT rz rU rd )r[ r� r� rL rL rP r� s z%exclude_local_folder_imports.__exit__N)rs rt ru rv r\ r r� rL rL rL rP r� � s r� )r
r r r r r r r �tkinterr r r r r c
C sV t t� �: tD ]$} z t| � W q ty0 Y q0 qW d � n1 sH0 Y d S rK )r� �TOP_LEVEL_MODULESr� r� )r� rL rL rP �import_top_level_modules/ s
r� )F)F)8rv �
__future__r r r r1 �loggingr� r� rp r� ry r� � getLoggerrm � Formatter� BASIC_FORMATZ
_formatter�
StreamHandlerZ_handler� setFormatter�
addHandler�setLevel�WARNZ future.utilsr r rT r� r� rW rV r� �objectrJ rx r� r� r� r� r� r� r� r} r� r� r� r{ r� r� r� r� r� r� r� r� rL rL rL rP �<module> sr =
�D"
7F"$ P
I&6PK 1Bu\�W��� � future/moves/_markupbase.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from _markupbase import *
else:
__future_module__ = True
from markupbase import *
PK 7Bu\���Q� � future/moves/http/client.pynu �[��� from future.utils import PY3
if PY3:
from http.client import *
else:
from httplib import *
from httplib import HTTPMessage
__future_module__ = True
PK 9Bu\�h�� � future/moves/http/cookiejar.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from http.cookiejar import *
else:
__future_module__ = True
from cookielib import *
PK <Bu\+�͉G G future/moves/http/__init__.pynu �[��� from future.utils import PY3
if not PY3:
__future_module__ = True
PK CBu\�=�P P 6 future/moves/http/__pycache__/cookiejar.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �http.cookiejarZ__future_module__� cookielib� r r �E/usr/local/lib/python3.9/site-packages/future/moves/http/cookiejar.py�<module> s
PK EBu\C^Dl� � 5 future/moves/http/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hG � @ s d dl mZ esdZdS )� )�PY3TN)Z future.utilsr Z__future_module__� r r �D/usr/local/lib/python3.9/site-packages/future/moves/http/__init__.py�<module> s PK HBu\��8 8 3 future/moves/http/__pycache__/client.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ erd dlT nd dlT d dlmZ dZdS )� )�PY3)�*)� HTTPMessageTN)Z future.utilsr � http.client�httplibr Z__future_module__� r r �B/usr/local/lib/python3.9/site-packages/future/moves/http/client.py�<module> s
PK JBu\NPLf f 4 future/moves/http/__pycache__/cookies.cpython-39.pycnu �[��� a
��?h� � @ sB d dl mZ d dlmZ er&d dlT ndZd dlT d dlmZ dS )� )�absolute_import)�PY3)�*T)�MorselN)�
__future__r Z future.utilsr � http.cookiesZ__future_module__�Cookier � r r �C/usr/local/lib/python3.9/site-packages/future/moves/http/cookies.py�<module> s
PK MBu\)�R�# # 3 future/moves/http/__pycache__/server.cpython-39.pycnu �[��� a
��?h^ � @ s� d dl mZ d dlmZ er&d dlT nddZd dlT d dlT d dlT zd dlm Z W n6 e
y� zd dlm Z W n e
y� Y n0 Y n0 dS )� )�absolute_import)�PY3)�*T)�_url_collapse_path)�_url_collapse_path_splitN) �
__future__r Z future.utilsr Z http.serverZ__future_module__�BaseHTTPServer�
CGIHTTPServer�SimpleHTTPServerr � ImportErrorr � r r �B/usr/local/lib/python3.9/site-packages/future/moves/http/server.py�<module> s
PK PBu\���� � future/moves/http/cookies.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from http.cookies import *
else:
__future_module__ = True
from Cookie import *
from Cookie import Morsel # left out of __all__ on Py2.7!
PK RBu\m�[�^ ^ future/moves/http/server.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from http.server import *
else:
__future_module__ = True
from BaseHTTPServer import *
from CGIHTTPServer import *
from SimpleHTTPServer import *
try:
from CGIHTTPServer import _url_collapse_path # needed for a test
except ImportError:
try:
# Python 2.7.0 to 2.7.3
from CGIHTTPServer import (
_url_collapse_path_split as _url_collapse_path)
except ImportError:
# Doesn't exist on Python 2.6.x. Ignore it.
pass
PK UBu\��Q � � future/moves/copyreg.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
import copyreg, sys
# A "*" import uses Python 3's copyreg.__all__ which does not include
# all public names in the API surface for copyreg, this avoids that
# problem by just making our module _be_ a reference to the actual module.
sys.modules['future.moves.copyreg'] = copyreg
else:
__future_module__ = True
from copy_reg import *
PK ZBu\��NƱ � future/moves/html/entities.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from html.entities import *
else:
__future_module__ = True
from htmlentitydefs import *
PK \Bu\�ù�� � future/moves/html/__init__.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
__future_module__ = True
if PY3:
from html import *
else:
# cgi.escape isn't good enough for the single Py3.3 html test to pass.
# Define it inline here instead. From the Py3.4 stdlib. Note that the
# html.escape() function from the Py3.3 stdlib is not suitable for use on
# Py2.x.
"""
General functions for HTML manipulation.
"""
def escape(s, quote=True):
"""
Replace special characters "&", "<" and ">" to HTML-safe sequences.
If the optional flag quote is true (the default), the quotation mark
characters, both double quote (") and single quote (') characters are also
translated.
"""
s = s.replace("&", "&") # Must be done first!
s = s.replace("<", "<")
s = s.replace(">", ">")
if quote:
s = s.replace('"', """)
s = s.replace('\'', "'")
return s
__all__ = ['escape']
PK cBu\�|�WC C 5 future/moves/html/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s> d dl mZ d dlmZ dZer*d dlT nddd�ZdgZdS ) � )�absolute_import)�PY3T)�*c C sD | � dd�} | � dd�} | � dd�} |r@| � dd�} | � d d
�} | S ) a
Replace special characters "&", "<" and ">" to HTML-safe sequences.
If the optional flag quote is true (the default), the quotation mark
characters, both double quote (") and single quote (') characters are also
translated.
�&z&�<z<�>z>�"z"�'z')�replace)�s�quote� r
�D/usr/local/lib/python3.9/site-packages/future/moves/html/__init__.py�escape s r N)T)�
__future__r Z future.utilsr Z__future_module__�htmlr �__all__r
r
r
r �<module> s
PK fBu\�� �S S 5 future/moves/html/__pycache__/entities.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �
html.entitiesZ__future_module__�htmlentitydefs� r r �D/usr/local/lib/python3.9/site-packages/future/moves/html/entities.py�<module> s
PK iBu\ \��K K 3 future/moves/html/__pycache__/parser.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ dZer*d dlT nd dlT dS )� )�absolute_import)�PY3T)�*N)�
__future__r Z future.utilsr Z__future_module__� html.parser�
HTMLParser� r r �B/usr/local/lib/python3.9/site-packages/future/moves/html/parser.py�<module> s
PK kBu\^�R@� � future/moves/html/parser.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
__future_module__ = True
if PY3:
from html.parser import *
else:
from HTMLParser import *
PK pBu\+<b�D D ! future/moves/tkinter/constants.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.constants import *
else:
try:
from Tkconstants import *
except ImportError:
raise ImportError('The Tkconstants module is missing. Does your Py2 '
'installation include tkinter?')
PK sBu\�U��5 5 future/moves/tkinter/font.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.font import *
else:
try:
from tkFont import *
except ImportError:
raise ImportError('The tkFont module is missing. Does your Py2 '
'installation include tkinter?')
PK uBu\�3�G G " future/moves/tkinter/messagebox.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.messagebox import *
else:
try:
from tkMessageBox import *
except ImportError:
raise ImportError('The tkMessageBox module is missing. Does your Py2 '
'installation include tkinter?')
PK xBu\%{0v2 2 future/moves/tkinter/dnd.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.dnd import *
else:
try:
from Tkdnd import *
except ImportError:
raise ImportError('The Tkdnd module is missing. Does your Py2 '
'installation include tkinter?')
PK {Bu\9� �. . future/moves/tkinter/ttk.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.ttk import *
else:
try:
from ttk import *
except ImportError:
raise ImportError('The ttk module is missing. Does your Py2 '
'installation include tkinter?')
PK }Bu\���l l future/moves/tkinter/__init__.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
__future_module__ = True
if not PY3:
from Tkinter import *
from Tkinter import (_cnfmerge, _default_root, _flatten,
_support_default_root, _test,
_tkinter, _setit)
try: # >= 2.7.4
from Tkinter import (_join)
except ImportError:
pass
try: # >= 2.7.4
from Tkinter import (_stringify)
except ImportError:
pass
try: # >= 2.7.9
from Tkinter import (_splitdict)
except ImportError:
pass
else:
from tkinter import *
PK �Bu\���7 7 future/moves/tkinter/dialog.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.dialog import *
else:
try:
from Dialog import *
except ImportError:
raise ImportError('The Dialog module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\ ǚ� � 6 future/moves/tkinter/__pycache__/dialog.cpython-39.pycnu �[��� a
��?h7 � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zIThe Dialog module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.dialog�Dialog� ImportError� r r �E/usr/local/lib/python3.9/site-packages/future/moves/tkinter/dialog.py�<module> s
PK �Bu\�"`� � < future/moves/tkinter/__pycache__/commondialog.cpython-39.pycnu �[��� a
��?hM � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zQThe tkCommonDialog module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.commondialog�tkCommonDialog� ImportError� r r �K/usr/local/lib/python3.9/site-packages/future/moves/tkinter/commondialog.py�<module> s
PK �Bu\��,� � 8 future/moves/tkinter/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hl � @ s� d dl mZ d dlmZ dZes�d dlT d dlmZmZmZm Z m
Z
m Z m Z zd dlm
Z
W n eyn Y n0 zd dlmZ W n ey� Y n0 zd dlmZ W q� ey� Y q�0 nd dlT d S )
� )�absolute_import)�PY3T)�*)� _cnfmerge�
_default_root�_flatten�_support_default_root�_test�_tkinter�_setit)�_join)�
_stringify)�
_splitdictN)�
__future__r Z future.utilsr Z__future_module__�Tkinterr r r r r r
r r � ImportErrorr
r �tkinter� r r �G/usr/local/lib/python3.9/site-packages/future/moves/tkinter/__init__.py�<module> s$ $ PK �Bu\���� � 4 future/moves/tkinter/__pycache__/font.cpython-39.pycnu �[��� a
��?h5 � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zIThe tkFont module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Z tkinter.font�tkFont� ImportError� r r �C/usr/local/lib/python3.9/site-packages/future/moves/tkinter/font.py�<module> s
PK �Bu\dtO�� � : future/moves/tkinter/__pycache__/messagebox.cpython-39.pycnu �[��� a
��?hG � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zOThe tkMessageBox module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.messagebox� tkMessageBox� ImportError� r r �I/usr/local/lib/python3.9/site-packages/future/moves/tkinter/messagebox.py�<module> s
PK �Bu\���c� � < future/moves/tkinter/__pycache__/colorchooser.cpython-39.pycnu �[��� a
��?hM � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zQThe tkColorChooser module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.colorchooser�tkColorChooser� ImportError� r r �K/usr/local/lib/python3.9/site-packages/future/moves/tkinter/colorchooser.py�<module> s
PK �Bu\���� � 3 future/moves/tkinter/__pycache__/tix.cpython-39.pycnu �[��� a
��?h. � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zFThe Tix module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Z tkinter.tix�Tix� ImportError� r r �B/usr/local/lib/python3.9/site-packages/future/moves/tkinter/tix.py�<module> s
PK �Bu\�5��� � 3 future/moves/tkinter/__pycache__/ttk.cpython-39.pycnu �[��� a
��?h. � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zFThe ttk module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Z tkinter.ttk�ttk� ImportError� r r �B/usr/local/lib/python3.9/site-packages/future/moves/tkinter/ttk.py�<module> s
PK �Bu\�&�P P : future/moves/tkinter/__pycache__/filedialog.cpython-39.pycnu �[��� a
��?h � @ sz d dl mZ d dlmZ er&d dlT nPz d dlT W n eyL ed��Y n0 z d dlT W n eyt ed��Y n0 dS )� )�absolute_import)�PY3)�*zMThe FileDialog module is missing. Does your Py2 installation include tkinter?zOThe tkFileDialog module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.filedialog�
FileDialog� ImportError� tkFileDialog� r r �I/usr/local/lib/python3.9/site-packages/future/moves/tkinter/filedialog.py�<module> s
PK �Bu\��� � 3 future/moves/tkinter/__pycache__/dnd.cpython-39.pycnu �[��� a
��?h2 � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zHThe Tkdnd module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Z tkinter.dnd�Tkdnd� ImportError� r r �B/usr/local/lib/python3.9/site-packages/future/moves/tkinter/dnd.py�<module> s
PK �Bu\5þ� � 9 future/moves/tkinter/__pycache__/constants.cpython-39.pycnu �[��� a
��?hD � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zNThe Tkconstants module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.constants� Tkconstants� ImportError� r r �H/usr/local/lib/python3.9/site-packages/future/moves/tkinter/constants.py�<module> s
PK �Bu\� ml� � < future/moves/tkinter/__pycache__/scrolledtext.cpython-39.pycnu �[��� a
��?hI � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zOThe ScrolledText module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.scrolledtext� ScrolledText� ImportError� r r �K/usr/local/lib/python3.9/site-packages/future/moves/tkinter/scrolledtext.py�<module> s
PK �Bu\P�[$� � < future/moves/tkinter/__pycache__/simpledialog.cpython-39.pycnu �[��� a
��?hI � @ sR d dl mZ d dlmZ er&d dlT n(z d dlT W n eyL ed��Y n0 dS )� )�absolute_import)�PY3)�*zOThe SimpleDialog module is missing. Does your Py2 installation include tkinter?N)�
__future__r Z future.utilsr Ztkinter.simpledialog� SimpleDialog� ImportError� r r �K/usr/local/lib/python3.9/site-packages/future/moves/tkinter/simpledialog.py�<module> s
PK �Bu\�Ka;I I $ future/moves/tkinter/scrolledtext.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.scrolledtext import *
else:
try:
from ScrolledText import *
except ImportError:
raise ImportError('The ScrolledText module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\�"��I I $ future/moves/tkinter/simpledialog.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.simpledialog import *
else:
try:
from SimpleDialog import *
except ImportError:
raise ImportError('The SimpleDialog module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\�ޝM M $ future/moves/tkinter/commondialog.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.commondialog import *
else:
try:
from tkCommonDialog import *
except ImportError:
raise ImportError('The tkCommonDialog module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\hu'%. . future/moves/tkinter/tix.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.tix import *
else:
try:
from Tix import *
except ImportError:
raise ImportError('The Tix module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\ްs " future/moves/tkinter/filedialog.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.filedialog import *
else:
try:
from FileDialog import *
except ImportError:
raise ImportError('The FileDialog module is missing. Does your Py2 '
'installation include tkinter?')
try:
from tkFileDialog import *
except ImportError:
raise ImportError('The tkFileDialog module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\{<N\M M $ future/moves/tkinter/colorchooser.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from tkinter.colorchooser import *
else:
try:
from tkColorChooser import *
except ImportError:
raise ImportError('The tkColorChooser module is missing. Does your Py2 '
'installation include tkinter?')
PK �Bu\) � � � future/moves/queue.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from queue import *
else:
__future_module__ = True
from Queue import *
PK �Bu\5�K� � future/moves/subprocess.pynu �[��� from __future__ import absolute_import
from future.utils import PY2, PY26
from subprocess import *
if PY2:
__future_module__ = True
from commands import getoutput, getstatusoutput
if PY26:
from future.backports.misc import check_output
PK �Bu\]�)� future/moves/builtins.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from builtins import *
else:
__future_module__ = True
from __builtin__ import *
# Overwrite any old definitions with the equivalent future.builtins ones:
from future.builtins import *
PK �Bu\'���� � future/moves/__init__.pynu �[��� # future.moves package
from __future__ import absolute_import
import sys
__future_module__ = True
from future.standard_library import import_top_level_modules
if sys.version_info[0] >= 3:
import_top_level_modules()
PK �Bu\�b�� � future/moves/dbm/gnu.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from dbm.gnu import *
else:
__future_module__ = True
from gdbm import *
PK �Bu\��Y�� � future/moves/dbm/ndbm.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from dbm.ndbm import *
else:
__future_module__ = True
from dbm import *
PK �Bu\���� � future/moves/dbm/__init__.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from dbm import *
else:
__future_module__ = True
from whichdb import *
from anydbm import *
# Py3.3's dbm/__init__.py imports ndbm but doesn't expose it via __all__.
# In case some (badly written) code depends on dbm.ndbm after import dbm,
# we simulate this:
if PY3:
from dbm import ndbm
else:
try:
from future.moves.dbm import ndbm
except ImportError:
ndbm = None
PK �Bu\�k�� � 4 future/moves/dbm/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ sx d dl mZ d dlmZ er&d dlT ndZd dlT d dlT erLd dlmZ n(zd dl mZ W n e
yr dZY n0 dS )� )�absolute_import)�PY3)�*T)�ndbmN) �
__future__r Z future.utilsr �dbmZ__future_module__�whichdb�anydbmr Zfuture.moves.dbm� ImportError� r r �C/usr/local/lib/python3.9/site-packages/future/moves/dbm/__init__.py�<module> s
PK �Bu\�|Eu> > 0 future/moves/dbm/__pycache__/ndbm.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr Zdbm.ndbmZ__future_module__�dbm� r r �?/usr/local/lib/python3.9/site-packages/future/moves/dbm/ndbm.py�<module> s
PK �Bu\��)�= = / future/moves/dbm/__pycache__/gnu.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr Zdbm.gnuZ__future_module__�gdbm� r r �>/usr/local/lib/python3.9/site-packages/future/moves/dbm/gnu.py�<module> s
PK �Bu\ �'�B B 0 future/moves/dbm/__pycache__/dumb.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr Zdbm.dumbZ__future_module__�dumbdbm� r r �?/usr/local/lib/python3.9/site-packages/future/moves/dbm/dumb.py�<module> s
PK �Bu\]
E�� � future/moves/dbm/dumb.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from dbm.dumb import *
else:
__future_module__ = True
from dumbdbm import *
PK �Bu\���6� � future/moves/winreg.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from winreg import *
else:
__future_module__ = True
from _winreg import *
PK �Bu\^CZے � future/moves/configparser.pynu �[��� from __future__ import absolute_import
from future.utils import PY2
if PY2:
from ConfigParser import *
else:
from configparser import *
PK �Bu\��3N� � future/moves/pickle.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from pickle import *
else:
__future_module__ = True
try:
from cPickle import *
except ImportError:
from pickle import *
PK �Bu\�=�� � 2 future/moves/__pycache__/subprocess.cpython-39.pycnu �[��� a
��?h� � @ sP d dl mZ d dlmZmZ d dlT er<dZd dlmZm Z erLd dl
m Z dS )� )�absolute_import)�PY2�PY26)�*T)� getoutput�getstatusoutput)� check_outputN) �
__future__r Z future.utilsr r �
subprocessZ__future_module__�commandsr r Zfuture.backports.miscr � r r �A/usr/local/lib/python3.9/site-packages/future/moves/subprocess.py�<module> s PK �Bu\�8 n? ? / future/moves/__pycache__/_thread.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �_threadZ__future_module__�thread� r r �>/usr/local/lib/python3.9/site-packages/future/moves/_thread.py�<module> s
PK �Bu\�L��` ` 3 future/moves/__pycache__/collections.cpython-39.pycnu �[��� a
��?h� � @ s� d dl mZ d dlZd dlmZmZ dZd dlT erXd dlmZ d dl m Z d dl
m
Z
erld d l m Z m
Z
ejd
k r�d d l mZmZ dS ) � )�absolute_importN)�PY2�PY26T)�*)�UserDict)�UserList)�
UserString)� OrderedDict�Counter)� r )�ChainMap�_count_elements)�
__future__r �sysZ future.utilsr r Z__future_module__� collectionsr r r Zfuture.backports.miscr r
� version_infor r
� r r �B/usr/local/lib/python3.9/site-packages/future/moves/collections.py�<module> s
PK �Bu\�I�h h 0 future/moves/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s< d dl mZ d dlZdZd dlmZ ejd dkr8e� dS )� )�absolute_importNT)�import_top_level_modules� )�
__future__r �sysZ__future_module__Zfuture.standard_libraryr � version_info� r r �?/usr/local/lib/python3.9/site-packages/future/moves/__init__.py�<module> s
PK �Bu\���À � 5 future/moves/__pycache__/_dummy_thread.cpython-39.pycnu �[��� a
��?h\ � @ sH d dl mZ d dlmZmZ er*d dlT ner8d dlT n dZd dlT dS )� )�absolute_import)�PY3� PY39_PLUS)�*TN) �
__future__r Z future.utilsr r �_thread�
_dummy_threadZ__future_module__� dummy_thread� r
r
�D/usr/local/lib/python3.9/site-packages/future/moves/_dummy_thread.py�<module> s
PK �Bu\֙/�R R 1 future/moves/__pycache__/itertools.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl mZ d dlT z eZeZW n ey2 Y n0 dS )� )�absolute_import)�*N)�
__future__r � itertools� izip_longest� zip_longest� ifilterfalse� filterfalse� NameError� r r �@/usr/local/lib/python3.9/site-packages/future/moves/itertools.py�<module> s PK �Bu\&��n3 3 + future/moves/__pycache__/sys.cpython-39.pycnu �[��� a
��?h� � @ s4 d dl mZ d dlmZ d dlT er0d dlmZ dS )� )�absolute_import)�PY2)�*)�internN)�
__future__r Z future.utilsr �sys� __builtin__r � r r �:/usr/local/lib/python3.9/site-packages/future/moves/sys.py�<module> s PK Cu\���: : - future/moves/__pycache__/queue.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �queueZ__future_module__�Queue� r r �</usr/local/lib/python3.9/site-packages/future/moves/queue.py�<module> s
PK Cu\�L��O O 4 future/moves/__pycache__/socketserver.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr � socketserverZ__future_module__� SocketServer� r r �C/usr/local/lib/python3.9/site-packages/future/moves/socketserver.py�<module> s
PK Cu\ ���K K 3 future/moves/__pycache__/_markupbase.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr � _markupbaseZ__future_module__�
markupbase� r r �B/usr/local/lib/python3.9/site-packages/future/moves/_markupbase.py�<module> s
PK Cu\; �E= = / future/moves/__pycache__/reprlib.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �reprlibZ__future_module__�repr� r r �>/usr/local/lib/python3.9/site-packages/future/moves/reprlib.py�<module> s
PK
Cu\�ok5 5 4 future/moves/__pycache__/configparser.cpython-39.pycnu �[��� a
��?h� � @ s2 d dl mZ d dlmZ er&d dlT nd dlT dS )� )�absolute_import)�PY2)�*N)�
__future__r Z future.utilsr � ConfigParser� configparser� r r �C/usr/local/lib/python3.9/site-packages/future/moves/configparser.py�<module> s
PK
Cu\���> > . future/moves/__pycache__/winreg.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �winregZ__future_module__�_winreg� r r �=/usr/local/lib/python3.9/site-packages/future/moves/winreg.py�<module> s
PK Cu\��@u u 7 future/moves/__pycache__/multiprocessing.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl mZ d dlmZ d dlT es4dZd dlmZ dS )� )�absolute_import)�PY3)�*T)� SimpleQueueN)�
__future__r Z future.utilsr �multiprocessingZ__future_module__Zmultiprocessing.queuesr � r r �F/usr/local/lib/python3.9/site-packages/future/moves/multiprocessing.py�<module> s
PK Cu\�S�{a a 0 future/moves/__pycache__/builtins.cpython-39.pycnu �[��� a
��?h � @ s> d dl mZ d dlmZ er&d dlT ndZd dlT d dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �builtinsZ__future_module__� __builtin__Zfuture.builtins� r r �?/usr/local/lib/python3.9/site-packages/future/moves/builtins.py�<module> s
PK Cu\^,�q q . future/moves/__pycache__/pickle.cpython-39.pycnu �[��� a
��?h� � @ sV d dl mZ d dlmZ er&d dlT n,dZz d dlT W n eyP d dlT Y n0 dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr �pickleZ__future_module__�cPickle� ImportError� r r �=/usr/local/lib/python3.9/site-packages/future/moves/pickle.py�<module> s
PK Cu\��n�y y / future/moves/__pycache__/copyreg.cpython-39.pycnu �[��� a
��?h� � @ sH d dl mZ d dlmZ er8d dlZd dlZeejd< n dZd dlT dS )� )�absolute_import)�PY3Nzfuture.moves.copyregT)�*) �
__future__r Z future.utilsr �copyreg�sys�modulesZ__future_module__�copy_reg� r
r
�>/usr/local/lib/python3.9/site-packages/future/moves/copyreg.py�<module> s PK !Cu\w�
�� � future/moves/multiprocessing.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
from multiprocessing import *
if not PY3:
__future_module__ = True
from multiprocessing.queues import SimpleQueue
PK #Cu\�,�� � future/moves/collections.pynu �[��� from __future__ import absolute_import
import sys
from future.utils import PY2, PY26
__future_module__ = True
from collections import *
if PY2:
from UserDict import UserDict
from UserList import UserList
from UserString import UserString
if PY26:
from future.backports.misc import OrderedDict, Counter
if sys.version_info < (3, 3):
from future.backports.misc import ChainMap, _count_elements
PK &Cu\��\ \ future/moves/_dummy_thread.pynu �[��� from __future__ import absolute_import
from future.utils import PY3, PY39_PLUS
if PY39_PLUS:
# _dummy_thread and dummy_threading modules were both deprecated in
# Python 3.7 and removed in Python 3.9
from _thread import *
elif PY3:
from _dummy_thread import *
else:
__future_module__ = True
from dummy_thread import *
PK +Cu\�
� � future/moves/xmlrpc/client.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from xmlrpc.client import *
else:
from xmlrpclib import *
PK /Cu\ future/moves/xmlrpc/__init__.pynu �[��� PK 2Cu\@֟�� � 7 future/moves/xmlrpc/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �F/usr/local/lib/python3.9/site-packages/future/moves/xmlrpc/__init__.py�<module> � PK 4Cu\�ז4 4 5 future/moves/xmlrpc/__pycache__/client.cpython-39.pycnu �[��� a
��?h� � @ s2 d dl mZ d dlmZ er&d dlT nd dlT dS )� )�absolute_import)�PY3)�*N)�
__future__r Z future.utilsr �
xmlrpc.client� xmlrpclib� r r �D/usr/local/lib/python3.9/site-packages/future/moves/xmlrpc/client.py�<module> s
PK 7Cu\���n4 4 5 future/moves/xmlrpc/__pycache__/server.cpython-39.pycnu �[��� a
��?h� � @ s2 d dl mZ d dlmZ er&d dlT nd dlT dS )� )�absolute_import)�PY3)�*N)�
__future__r Z future.utilsr Z
xmlrpc.server� xmlrpclib� r r �D/usr/local/lib/python3.9/site-packages/future/moves/xmlrpc/server.py�<module> s
PK 9Cu\k\�!� � future/moves/xmlrpc/server.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from xmlrpc.server import *
else:
from xmlrpclib import *
PK <Cu\��
� � future/moves/sys.pynu �[��� from __future__ import absolute_import
from future.utils import PY2
from sys import *
if PY2:
from __builtin__ import intern
PK CCu\�} �V V future/moves/urllib/response.pynu �[��� from future import standard_library
from future.utils import PY3
if PY3:
from urllib.response import *
else:
__future_module__ = True
with standard_library.suspend_hooks():
from urllib import (addbase,
addclosehook,
addinfo,
addinfourl)
PK ECu\�U�jn n future/moves/urllib/__init__.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if not PY3:
__future_module__ = True
PK KCu\>�$ $ 6 future/moves/urllib/__pycache__/request.cpython-39.pycnu �[��� a
��?h�
� @ s d dl mZ d dlmZ d dlmZ er�d dlT d dlmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZ d dlmZmZmZmZmZm Z m Z m Z m Z m Z m!Z! nRdZ"e� �8 d dl#T d dl$T d dlT d dl#m%Z% e%Z W d � n1 s�0 Y d S )
� )�absolute_import)�
suspend_hooks)�PY3)�*)�
getproxies� pathname2url� proxy_bypass�quote� request_host�thishost�unquote� url2pathname�
urlcleanup�urljoin�urlopen�urlparse� urlretrieve�urlsplit�
urlunparse) � splitattr� splithost� splitpasswd� splitport�
splitquery�splittag� splittype� splituser�
splitvalue�to_bytes�unwrapT)�toBytesN)&�
__future__r Zfuture.standard_libraryr Z future.utilsr �urllib.requestr r r r r
r r r
r r r r r r r � urllib.parser r r r r r r r r r r Z__future_module__�urllib�urllib2r � r& r& �E/usr/local/lib/python3.9/site-packages/future/moves/urllib/request.py�<module> s D6 PK MCu\�`�g 4 future/moves/urllib/__pycache__/error.cpython-39.pycnu �[��� a
��?h� � @ s| d dl mZ d dlmZ d dlmZ er2d dlT nFdZe� �, d dlm Z d dl
m Z m Z W d � n1 sn0 Y dS ) � )�absolute_import)�
suspend_hooks)�PY3)�*T)�ContentTooShortError)�URLError� HTTPErrorN)
�
__future__r Zfuture.standard_libraryr Z future.utilsr � urllib.errorZ__future_module__�urllibr �urllib2r r � r
r
�C/usr/local/lib/python3.9/site-packages/future/moves/urllib/error.py�<module> s
PK PCu\���BZ Z : future/moves/urllib/__pycache__/robotparser.cpython-39.pycnu �[��� a
��?h� � @ s6 d dl mZ d dlmZ er&d dlT n dZd dlT dS )� )�absolute_import)�PY3)�*TN)�
__future__r Z future.utilsr Zurllib.robotparserZ__future_module__� robotparser� r r �I/usr/local/lib/python3.9/site-packages/future/moves/urllib/robotparser.py�<module> s
PK RCu\�V". 7 future/moves/urllib/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hn � @ s$ d dl mZ d dlmZ es dZdS )� )�absolute_import)�PY3TN)�
__future__r Z future.utilsr Z__future_module__� r r �F/usr/local/lib/python3.9/site-packages/future/moves/urllib/__init__.py�<module> s PK UCu\�g�9� � 4 future/moves/urllib/__pycache__/parse.cpython-39.pycnu �[��� a
��?h � @ s� d dl mZ d dlmZ d dlmZ er2d dlT nzdZd dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ e� �0 d dlmZmZmZmZmZmZ W d � n1 s�0 Y dS ) � )�absolute_import)�
suspend_hooks)�PY3)�*T)
� ParseResult� SplitResult�parse_qs� parse_qsl� urldefrag�urljoin�urlparse�urlsplit�
urlunparse�
urlunsplit)�quote�
quote_plus�unquote� unquote_plus� urlencode�
splitqueryN)�
__future__r Zfuture.standard_libraryr Z future.utilsr � urllib.parseZ__future_module__r r r r r r
r r
r r �urllibr r r r r r � r r �C/usr/local/lib/python3.9/site-packages/future/moves/urllib/parse.py�<module> s
0 PK WCu\9<��� � 7 future/moves/urllib/__pycache__/response.cpython-39.pycnu �[��� a
��?hV � @ sn d dl mZ d dlmZ er&d dlT nDdZe�� �( d dlmZm Z m
Z
m Z W d � n1 s`0 Y dS )� )�standard_library)�PY3)�*T)�addbase� addclosehook�addinfo�
addinfourlN) �futurer Z future.utilsr �urllib.responseZ__future_module__Z
suspend_hooks�urllibr r r r � r r �F/usr/local/lib/python3.9/site-packages/future/moves/urllib/response.py�<module> s
PK ZCu\7�<�� � future/moves/urllib/error.pynu �[��� from __future__ import absolute_import
from future.standard_library import suspend_hooks
from future.utils import PY3
if PY3:
from urllib.error import *
else:
__future_module__ = True
# We use this method to get at the original Py2 urllib before any renaming magic
# ContentTooShortError = sys.py2_modules['urllib'].ContentTooShortError
with suspend_hooks():
from urllib import ContentTooShortError
from urllib2 import URLError, HTTPError
PK ]Cu\�s6� future/moves/urllib/parse.pynu �[��� from __future__ import absolute_import
from future.standard_library import suspend_hooks
from future.utils import PY3
if PY3:
from urllib.parse import *
else:
__future_module__ = True
from urlparse import (ParseResult, SplitResult, parse_qs, parse_qsl,
urldefrag, urljoin, urlparse, urlsplit,
urlunparse, urlunsplit)
# we use this method to get at the original py2 urllib before any renaming
# quote = sys.py2_modules['urllib'].quote
# quote_plus = sys.py2_modules['urllib'].quote_plus
# unquote = sys.py2_modules['urllib'].unquote
# unquote_plus = sys.py2_modules['urllib'].unquote_plus
# urlencode = sys.py2_modules['urllib'].urlencode
# splitquery = sys.py2_modules['urllib'].splitquery
with suspend_hooks():
from urllib import (quote,
quote_plus,
unquote,
unquote_plus,
urlencode,
splitquery)
PK aCu\���
�
future/moves/urllib/request.pynu �[��� from __future__ import absolute_import
from future.standard_library import suspend_hooks
from future.utils import PY3
if PY3:
from urllib.request import *
# This aren't in __all__:
from urllib.request import (getproxies,
pathname2url,
proxy_bypass,
quote,
request_host,
thishost,
unquote,
url2pathname,
urlcleanup,
urljoin,
urlopen,
urlparse,
urlretrieve,
urlsplit,
urlunparse)
from urllib.parse import (splitattr,
splithost,
splitpasswd,
splitport,
splitquery,
splittag,
splittype,
splituser,
splitvalue,
to_bytes,
unwrap)
else:
__future_module__ = True
with suspend_hooks():
from urllib import *
from urllib2 import *
from urlparse import *
# Rename:
from urllib import toBytes # missing from __all__ on Py2.6
to_bytes = toBytes
# from urllib import (pathname2url,
# url2pathname,
# getproxies,
# urlretrieve,
# urlcleanup,
# URLopener,
# FancyURLopener,
# proxy_bypass)
# from urllib2 import (
# AbstractBasicAuthHandler,
# AbstractDigestAuthHandler,
# BaseHandler,
# CacheFTPHandler,
# FileHandler,
# FTPHandler,
# HTTPBasicAuthHandler,
# HTTPCookieProcessor,
# HTTPDefaultErrorHandler,
# HTTPDigestAuthHandler,
# HTTPErrorProcessor,
# HTTPHandler,
# HTTPPasswordMgr,
# HTTPPasswordMgrWithDefaultRealm,
# HTTPRedirectHandler,
# HTTPSHandler,
# URLError,
# build_opener,
# install_opener,
# OpenerDirector,
# ProxyBasicAuthHandler,
# ProxyDigestAuthHandler,
# ProxyHandler,
# Request,
# UnknownHandler,
# urlopen,
# )
# from urlparse import (
# urldefrag
# urljoin,
# urlparse,
# urlunparse,
# urlsplit,
# urlunsplit,
# parse_qs,
# parse_q"
# )
PK dCu\|�� � " future/moves/urllib/robotparser.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from urllib.robotparser import *
else:
__future_module__ = True
from robotparser import *
PK fCu\�_�� � future/moves/itertools.pynu �[��� from __future__ import absolute_import
from itertools import *
try:
zip_longest = izip_longest
filterfalse = ifilterfalse
except NameError:
pass
PK kCu\�U�jn n future/moves/test/__init__.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if not PY3:
__future_module__ = True
PK nCu\���� � future/moves/test/support.pynu �[��� from __future__ import absolute_import
import sys
from future.standard_library import suspend_hooks
from future.utils import PY3
if PY3:
from test.support import *
if sys.version_info[:2] >= (3, 10):
from test.support.os_helper import (
EnvironmentVarGuard,
TESTFN,
)
from test.support.warnings_helper import check_warnings
else:
__future_module__ = True
with suspend_hooks():
from test.test_support import *
PK sCu\��H� 5 future/moves/test/__pycache__/__init__.cpython-39.pycnu �[��� a
��?hn � @ s$ d dl mZ d dlmZ es dZdS )� )�absolute_import)�PY3TN)�
__future__r Z future.utilsr Z__future_module__� r r �D/usr/local/lib/python3.9/site-packages/future/moves/test/__init__.py�<module> s PK vCu\d�5a� � 4 future/moves/test/__pycache__/support.cpython-39.pycnu �[��� a
��?h� � @ s� d dl mZ d dlZd dlmZ d dlmZ erhd dlT ejdd� dkr�d dl m
Z
m Z d d l m
Z
n2d
Ze� � d dlT W d � n1 s�0 Y dS ) � )�absolute_importN)�
suspend_hooks)�PY3)�*� )� �
)�EnvironmentVarGuard�TESTFN)�check_warningsT)�
__future__r �sysZfuture.standard_libraryr Z future.utilsr Z test.support� version_infoZtest.support.os_helperr r
Z test.support.warnings_helperr Z__future_module__Ztest.test_support� r r �C/usr/local/lib/python3.9/site-packages/future/moves/test/support.py�<module> s PK yCu\Z9�p� � future/moves/socketserver.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from socketserver import *
else:
__future_module__ = True
from SocketServer import *
PK {Cu\ ��>� � future/moves/_thread.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from _thread import *
else:
__future_module__ = True
from thread import *
PK �Cu\�65�� � future/moves/reprlib.pynu �[��� from __future__ import absolute_import
from future.utils import PY3
if PY3:
from reprlib import *
else:
__future_module__ = True
from repr import *
PK �Cu\"vDW? W? future/backports/_markupbase.pynu �[��� """Shared support for scanning document type declarations in HTML and XHTML.
Backported for python-future from Python 3.3. Reason: ParserBase is an
old-style class in the Python 2.7 source of markupbase.py, which I suspect
might be the cause of sporadic unit-test failures on travis-ci.org with
test_htmlparser.py. The test failures look like this:
======================================================================
ERROR: test_attr_entity_replacement (future.tests.test_htmlparser.AttributesStrictTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 661, in test_attr_entity_replacement
[("starttag", "a", [("b", "&><\"'")])])
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 93, in _run_check
collector = self.get_collector()
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 617, in get_collector
return EventCollector(strict=True)
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 27, in __init__
html.parser.HTMLParser.__init__(self, *args, **kw)
File "/home/travis/build/edschofield/python-future/future/backports/html/parser.py", line 135, in __init__
self.reset()
File "/home/travis/build/edschofield/python-future/future/backports/html/parser.py", line 143, in reset
_markupbase.ParserBase.reset(self)
TypeError: unbound method reset() must be called with ParserBase instance as first argument (got EventCollector instance instead)
This module is used as a foundation for the html.parser module. It has no
documented public API and should not be used directly.
"""
import re
_declname_match = re.compile(r'[a-zA-Z][-_.a-zA-Z0-9]*\s*').match
_declstringlit_match = re.compile(r'(\'[^\']*\'|"[^"]*")\s*').match
_commentclose = re.compile(r'--\s*>')
_markedsectionclose = re.compile(r']\s*]\s*>')
# An analysis of the MS-Word extensions is available at
# http://www.planetpublish.com/xmlarena/xap/Thursday/WordtoXML.pdf
_msmarkedsectionclose = re.compile(r']\s*>')
del re
class ParserBase(object):
"""Parser base class which provides some common support methods used
by the SGML/HTML and XHTML parsers."""
def __init__(self):
if self.__class__ is ParserBase:
raise RuntimeError(
"_markupbase.ParserBase must be subclassed")
def error(self, message):
raise NotImplementedError(
"subclasses of ParserBase must override error()")
def reset(self):
self.lineno = 1
self.offset = 0
def getpos(self):
"""Return current line number and offset."""
return self.lineno, self.offset
# Internal -- update line number and offset. This should be
# called for each piece of data exactly once, in order -- in other
# words the concatenation of all the input strings to this
# function should be exactly the entire input.
def updatepos(self, i, j):
if i >= j:
return j
rawdata = self.rawdata
nlines = rawdata.count("\n", i, j)
if nlines:
self.lineno = self.lineno + nlines
pos = rawdata.rindex("\n", i, j) # Should not fail
self.offset = j-(pos+1)
else:
self.offset = self.offset + j-i
return j
_decl_otherchars = ''
# Internal -- parse declaration (for use by subclasses).
def parse_declaration(self, i):
# This is some sort of declaration; in "HTML as
# deployed," this should only be the document type
# declaration ("<!DOCTYPE html...>").
# ISO 8879:1986, however, has more complex
# declaration syntax for elements in <!...>, including:
# --comment--
# [marked section]
# name in the following list: ENTITY, DOCTYPE, ELEMENT,
# ATTLIST, NOTATION, SHORTREF, USEMAP,
# LINKTYPE, LINK, IDLINK, USELINK, SYSTEM
rawdata = self.rawdata
j = i + 2
assert rawdata[i:j] == "<!", "unexpected call to parse_declaration"
if rawdata[j:j+1] == ">":
# the empty comment <!>
return j + 1
if rawdata[j:j+1] in ("-", ""):
# Start of comment followed by buffer boundary,
# or just a buffer boundary.
return -1
# A simple, practical version could look like: ((name|stringlit) S*) + '>'
n = len(rawdata)
if rawdata[j:j+2] == '--': #comment
# Locate --.*-- as the body of the comment
return self.parse_comment(i)
elif rawdata[j] == '[': #marked section
# Locate [statusWord [...arbitrary SGML...]] as the body of the marked section
# Where statusWord is one of TEMP, CDATA, IGNORE, INCLUDE, RCDATA
# Note that this is extended by Microsoft Office "Save as Web" function
# to include [if...] and [endif].
return self.parse_marked_section(i)
else: #all other declaration elements
decltype, j = self._scan_name(j, i)
if j < 0:
return j
if decltype == "doctype":
self._decl_otherchars = ''
while j < n:
c = rawdata[j]
if c == ">":
# end of declaration syntax
data = rawdata[i+2:j]
if decltype == "doctype":
self.handle_decl(data)
else:
# According to the HTML5 specs sections "8.2.4.44 Bogus
# comment state" and "8.2.4.45 Markup declaration open
# state", a comment token should be emitted.
# Calling unknown_decl provides more flexibility though.
self.unknown_decl(data)
return j + 1
if c in "\"'":
m = _declstringlit_match(rawdata, j)
if not m:
return -1 # incomplete
j = m.end()
elif c in "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ":
name, j = self._scan_name(j, i)
elif c in self._decl_otherchars:
j = j + 1
elif c == "[":
# this could be handled in a separate doctype parser
if decltype == "doctype":
j = self._parse_doctype_subset(j + 1, i)
elif decltype in set(["attlist", "linktype", "link", "element"]):
# must tolerate []'d groups in a content model in an element declaration
# also in data attribute specifications of attlist declaration
# also link type declaration subsets in linktype declarations
# also link attribute specification lists in link declarations
self.error("unsupported '[' char in %s declaration" % decltype)
else:
self.error("unexpected '[' char in declaration")
else:
self.error(
"unexpected %r char in declaration" % rawdata[j])
if j < 0:
return j
return -1 # incomplete
# Internal -- parse a marked section
# Override this to handle MS-word extension syntax <![if word]>content<![endif]>
def parse_marked_section(self, i, report=1):
rawdata= self.rawdata
assert rawdata[i:i+3] == '<![', "unexpected call to parse_marked_section()"
sectName, j = self._scan_name( i+3, i )
if j < 0:
return j
if sectName in set(["temp", "cdata", "ignore", "include", "rcdata"]):
# look for standard ]]> ending
match= _markedsectionclose.search(rawdata, i+3)
elif sectName in set(["if", "else", "endif"]):
# look for MS Office ]> ending
match= _msmarkedsectionclose.search(rawdata, i+3)
else:
self.error('unknown status keyword %r in marked section' % rawdata[i+3:j])
if not match:
return -1
if report:
j = match.start(0)
self.unknown_decl(rawdata[i+3: j])
return match.end(0)
# Internal -- parse comment, return length or -1 if not terminated
def parse_comment(self, i, report=1):
rawdata = self.rawdata
if rawdata[i:i+4] != '<!--':
self.error('unexpected call to parse_comment()')
match = _commentclose.search(rawdata, i+4)
if not match:
return -1
if report:
j = match.start(0)
self.handle_comment(rawdata[i+4: j])
return match.end(0)
# Internal -- scan past the internal subset in a <!DOCTYPE declaration,
# returning the index just past any whitespace following the trailing ']'.
def _parse_doctype_subset(self, i, declstartpos):
rawdata = self.rawdata
n = len(rawdata)
j = i
while j < n:
c = rawdata[j]
if c == "<":
s = rawdata[j:j+2]
if s == "<":
# end of buffer; incomplete
return -1
if s != "<!":
self.updatepos(declstartpos, j + 1)
self.error("unexpected char in internal subset (in %r)" % s)
if (j + 2) == n:
# end of buffer; incomplete
return -1
if (j + 4) > n:
# end of buffer; incomplete
return -1
if rawdata[j:j+4] == "<!--":
j = self.parse_comment(j, report=0)
if j < 0:
return j
continue
name, j = self._scan_name(j + 2, declstartpos)
if j == -1:
return -1
if name not in set(["attlist", "element", "entity", "notation"]):
self.updatepos(declstartpos, j + 2)
self.error(
"unknown declaration %r in internal subset" % name)
# handle the individual names
meth = getattr(self, "_parse_doctype_" + name)
j = meth(j, declstartpos)
if j < 0:
return j
elif c == "%":
# parameter entity reference
if (j + 1) == n:
# end of buffer; incomplete
return -1
s, j = self._scan_name(j + 1, declstartpos)
if j < 0:
return j
if rawdata[j] == ";":
j = j + 1
elif c == "]":
j = j + 1
while j < n and rawdata[j].isspace():
j = j + 1
if j < n:
if rawdata[j] == ">":
return j
self.updatepos(declstartpos, j)
self.error("unexpected char after internal subset")
else:
return -1
elif c.isspace():
j = j + 1
else:
self.updatepos(declstartpos, j)
self.error("unexpected char %r in internal subset" % c)
# end of buffer reached
return -1
# Internal -- scan past <!ELEMENT declarations
def _parse_doctype_element(self, i, declstartpos):
name, j = self._scan_name(i, declstartpos)
if j == -1:
return -1
# style content model; just skip until '>'
rawdata = self.rawdata
if '>' in rawdata[j:]:
return rawdata.find(">", j) + 1
return -1
# Internal -- scan past <!ATTLIST declarations
def _parse_doctype_attlist(self, i, declstartpos):
rawdata = self.rawdata
name, j = self._scan_name(i, declstartpos)
c = rawdata[j:j+1]
if c == "":
return -1
if c == ">":
return j + 1
while 1:
# scan a series of attribute descriptions; simplified:
# name type [value] [#constraint]
name, j = self._scan_name(j, declstartpos)
if j < 0:
return j
c = rawdata[j:j+1]
if c == "":
return -1
if c == "(":
# an enumerated type; look for ')'
if ")" in rawdata[j:]:
j = rawdata.find(")", j) + 1
else:
return -1
while rawdata[j:j+1].isspace():
j = j + 1
if not rawdata[j:]:
# end of buffer, incomplete
return -1
else:
name, j = self._scan_name(j, declstartpos)
c = rawdata[j:j+1]
if not c:
return -1
if c in "'\"":
m = _declstringlit_match(rawdata, j)
if m:
j = m.end()
else:
return -1
c = rawdata[j:j+1]
if not c:
return -1
if c == "#":
if rawdata[j:] == "#":
# end of buffer
return -1
name, j = self._scan_name(j + 1, declstartpos)
if j < 0:
return j
c = rawdata[j:j+1]
if not c:
return -1
if c == '>':
# all done
return j + 1
# Internal -- scan past <!NOTATION declarations
def _parse_doctype_notation(self, i, declstartpos):
name, j = self._scan_name(i, declstartpos)
if j < 0:
return j
rawdata = self.rawdata
while 1:
c = rawdata[j:j+1]
if not c:
# end of buffer; incomplete
return -1
if c == '>':
return j + 1
if c in "'\"":
m = _declstringlit_match(rawdata, j)
if not m:
return -1
j = m.end()
else:
name, j = self._scan_name(j, declstartpos)
if j < 0:
return j
# Internal -- scan past <!ENTITY declarations
def _parse_doctype_entity(self, i, declstartpos):
rawdata = self.rawdata
if rawdata[i:i+1] == "%":
j = i + 1
while 1:
c = rawdata[j:j+1]
if not c:
return -1
if c.isspace():
j = j + 1
else:
break
else:
j = i
name, j = self._scan_name(j, declstartpos)
if j < 0:
return j
while 1:
c = self.rawdata[j:j+1]
if not c:
return -1
if c in "'\"":
m = _declstringlit_match(rawdata, j)
if m:
j = m.end()
else:
return -1 # incomplete
elif c == ">":
return j + 1
else:
name, j = self._scan_name(j, declstartpos)
if j < 0:
return j
# Internal -- scan a name token and the new position and the token, or
# return -1 if we've reached the end of the buffer.
def _scan_name(self, i, declstartpos):
rawdata = self.rawdata
n = len(rawdata)
if i == n:
return None, -1
m = _declname_match(rawdata, i)
if m:
s = m.group()
name = s.strip()
if (i + len(s)) == n:
return None, -1 # end of buffer
return name.lower(), m.end()
else:
self.updatepos(declstartpos, i)
self.error("expected name token at %r"
% rawdata[declstartpos:declstartpos+20])
# To be overridden -- handlers for unknown objects
def unknown_decl(self, data):
pass
PK �Cu\Sq"l'� '� future/backports/misc.pynu �[��� """
Miscellaneous function (re)definitions from the Py3.4+ standard library
for Python 2.6/2.7.
- math.ceil (for Python 2.7)
- collections.OrderedDict (for Python 2.6)
- collections.Counter (for Python 2.6)
- collections.ChainMap (for all versions prior to Python 3.3)
- itertools.count (for Python 2.6, with step parameter)
- subprocess.check_output (for Python 2.6)
- reprlib.recursive_repr (for Python 2.6+)
- functools.cmp_to_key (for Python 2.6)
"""
from __future__ import absolute_import
import subprocess
from math import ceil as oldceil
from operator import itemgetter as _itemgetter, eq as _eq
import sys
import heapq as _heapq
from _weakref import proxy as _proxy
from itertools import repeat as _repeat, chain as _chain, starmap as _starmap
from socket import getaddrinfo, SOCK_STREAM, error, socket
from future.utils import iteritems, itervalues, PY2, PY26, PY3
if PY2:
from collections import Mapping, MutableMapping
else:
from collections.abc import Mapping, MutableMapping
def ceil(x):
"""
Return the ceiling of x as an int.
This is the smallest integral value >= x.
"""
return int(oldceil(x))
########################################################################
### reprlib.recursive_repr decorator from Py3.4
########################################################################
from itertools import islice
if PY26:
# itertools.count in Py 2.6 doesn't accept a step parameter
def count(start=0, step=1):
while True:
yield start
start += step
else:
from itertools import count
if PY3:
try:
from _thread import get_ident
except ImportError:
from _dummy_thread import get_ident
else:
try:
from thread import get_ident
except ImportError:
from dummy_thread import get_ident
def recursive_repr(fillvalue='...'):
'Decorator to make a repr function return fillvalue for a recursive call'
def decorating_function(user_function):
repr_running = set()
def wrapper(self):
key = id(self), get_ident()
if key in repr_running:
return fillvalue
repr_running.add(key)
try:
result = user_function(self)
finally:
repr_running.discard(key)
return result
# Can't use functools.wraps() here because of bootstrap issues
wrapper.__module__ = getattr(user_function, '__module__')
wrapper.__doc__ = getattr(user_function, '__doc__')
wrapper.__name__ = getattr(user_function, '__name__')
wrapper.__annotations__ = getattr(user_function, '__annotations__', {})
return wrapper
return decorating_function
# OrderedDict Shim from Raymond Hettinger, python core dev
# http://code.activestate.com/recipes/576693-ordered-dictionary-for-py24/
# here to support version 2.6.
################################################################################
### OrderedDict
################################################################################
class _Link(object):
__slots__ = 'prev', 'next', 'key', '__weakref__'
class OrderedDict(dict):
'Dictionary that remembers insertion order'
# An inherited dict maps keys to values.
# The inherited dict provides __getitem__, __len__, __contains__, and get.
# The remaining methods are order-aware.
# Big-O running times for all methods are the same as regular dictionaries.
# The internal self.__map dict maps keys to links in a doubly linked list.
# The circular doubly linked list starts and ends with a sentinel element.
# The sentinel element never gets deleted (this simplifies the algorithm).
# The sentinel is in self.__hardroot with a weakref proxy in self.__root.
# The prev links are weakref proxies (to prevent circular references).
# Individual links are kept alive by the hard reference in self.__map.
# Those hard references disappear when a key is deleted from an OrderedDict.
def __init__(*args, **kwds):
'''Initialize an ordered dictionary. The signature is the same as
regular dictionaries, but keyword arguments are not recommended because
their insertion order is arbitrary.
'''
if not args:
raise TypeError("descriptor '__init__' of 'OrderedDict' object "
"needs an argument")
self = args[0]
args = args[1:]
if len(args) > 1:
raise TypeError('expected at most 1 arguments, got %d' % len(args))
try:
self.__root
except AttributeError:
self.__hardroot = _Link()
self.__root = root = _proxy(self.__hardroot)
root.prev = root.next = root
self.__map = {}
self.__update(*args, **kwds)
def __setitem__(self, key, value,
dict_setitem=dict.__setitem__, proxy=_proxy, Link=_Link):
'od.__setitem__(i, y) <==> od[i]=y'
# Setting a new item creates a new link at the end of the linked list,
# and the inherited dictionary is updated with the new key/value pair.
if key not in self:
self.__map[key] = link = Link()
root = self.__root
last = root.prev
link.prev, link.next, link.key = last, root, key
last.next = link
root.prev = proxy(link)
dict_setitem(self, key, value)
def __delitem__(self, key, dict_delitem=dict.__delitem__):
'od.__delitem__(y) <==> del od[y]'
# Deleting an existing item uses self.__map to find the link which gets
# removed by updating the links in the predecessor and successor nodes.
dict_delitem(self, key)
link = self.__map.pop(key)
link_prev = link.prev
link_next = link.next
link_prev.next = link_next
link_next.prev = link_prev
def __iter__(self):
'od.__iter__() <==> iter(od)'
# Traverse the linked list in order.
root = self.__root
curr = root.next
while curr is not root:
yield curr.key
curr = curr.next
def __reversed__(self):
'od.__reversed__() <==> reversed(od)'
# Traverse the linked list in reverse order.
root = self.__root
curr = root.prev
while curr is not root:
yield curr.key
curr = curr.prev
def clear(self):
'od.clear() -> None. Remove all items from od.'
root = self.__root
root.prev = root.next = root
self.__map.clear()
dict.clear(self)
def popitem(self, last=True):
'''od.popitem() -> (k, v), return and remove a (key, value) pair.
Pairs are returned in LIFO order if last is true or FIFO order if false.
'''
if not self:
raise KeyError('dictionary is empty')
root = self.__root
if last:
link = root.prev
link_prev = link.prev
link_prev.next = root
root.prev = link_prev
else:
link = root.next
link_next = link.next
root.next = link_next
link_next.prev = root
key = link.key
del self.__map[key]
value = dict.pop(self, key)
return key, value
def move_to_end(self, key, last=True):
'''Move an existing element to the end (or beginning if last==False).
Raises KeyError if the element does not exist.
When last=True, acts like a fast version of self[key]=self.pop(key).
'''
link = self.__map[key]
link_prev = link.prev
link_next = link.next
link_prev.next = link_next
link_next.prev = link_prev
root = self.__root
if last:
last = root.prev
link.prev = last
link.next = root
last.next = root.prev = link
else:
first = root.next
link.prev = root
link.next = first
root.next = first.prev = link
def __sizeof__(self):
sizeof = sys.getsizeof
n = len(self) + 1 # number of links including root
size = sizeof(self.__dict__) # instance dictionary
size += sizeof(self.__map) * 2 # internal dict and inherited dict
size += sizeof(self.__hardroot) * n # link objects
size += sizeof(self.__root) * n # proxy objects
return size
update = __update = MutableMapping.update
keys = MutableMapping.keys
values = MutableMapping.values
items = MutableMapping.items
__ne__ = MutableMapping.__ne__
__marker = object()
def pop(self, key, default=__marker):
'''od.pop(k[,d]) -> v, remove specified key and return the corresponding
value. If key is not found, d is returned if given, otherwise KeyError
is raised.
'''
if key in self:
result = self[key]
del self[key]
return result
if default is self.__marker:
raise KeyError(key)
return default
def setdefault(self, key, default=None):
'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od'
if key in self:
return self[key]
self[key] = default
return default
@recursive_repr()
def __repr__(self):
'od.__repr__() <==> repr(od)'
if not self:
return '%s()' % (self.__class__.__name__,)
return '%s(%r)' % (self.__class__.__name__, list(self.items()))
def __reduce__(self):
'Return state information for pickling'
inst_dict = vars(self).copy()
for k in vars(OrderedDict()):
inst_dict.pop(k, None)
return self.__class__, (), inst_dict or None, None, iter(self.items())
def copy(self):
'od.copy() -> a shallow copy of od'
return self.__class__(self)
@classmethod
def fromkeys(cls, iterable, value=None):
'''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S.
If not specified, the value defaults to None.
'''
self = cls()
for key in iterable:
self[key] = value
return self
def __eq__(self, other):
'''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive
while comparison to a regular mapping is order-insensitive.
'''
if isinstance(other, OrderedDict):
return dict.__eq__(self, other) and all(map(_eq, self, other))
return dict.__eq__(self, other)
# {{{ http://code.activestate.com/recipes/576611/ (r11)
try:
from operator import itemgetter
from heapq import nlargest
except ImportError:
pass
########################################################################
### Counter
########################################################################
def _count_elements(mapping, iterable):
'Tally elements from the iterable.'
mapping_get = mapping.get
for elem in iterable:
mapping[elem] = mapping_get(elem, 0) + 1
class Counter(dict):
'''Dict subclass for counting hashable items. Sometimes called a bag
or multiset. Elements are stored as dictionary keys and their counts
are stored as dictionary values.
>>> c = Counter('abcdeabcdabcaba') # count elements from a string
>>> c.most_common(3) # three most common elements
[('a', 5), ('b', 4), ('c', 3)]
>>> sorted(c) # list all unique elements
['a', 'b', 'c', 'd', 'e']
>>> ''.join(sorted(c.elements())) # list elements with repetitions
'aaaaabbbbcccdde'
>>> sum(c.values()) # total of all counts
15
>>> c['a'] # count of letter 'a'
5
>>> for elem in 'shazam': # update counts from an iterable
... c[elem] += 1 # by adding 1 to each element's count
>>> c['a'] # now there are seven 'a'
7
>>> del c['b'] # remove all 'b'
>>> c['b'] # now there are zero 'b'
0
>>> d = Counter('simsalabim') # make another counter
>>> c.update(d) # add in the second counter
>>> c['a'] # now there are nine 'a'
9
>>> c.clear() # empty the counter
>>> c
Counter()
Note: If a count is set to zero or reduced to zero, it will remain
in the counter until the entry is deleted or the counter is cleared:
>>> c = Counter('aaabbc')
>>> c['b'] -= 2 # reduce the count of 'b' by two
>>> c.most_common() # 'b' is still in, but its count is zero
[('a', 3), ('c', 1), ('b', 0)]
'''
# References:
# http://en.wikipedia.org/wiki/Multiset
# http://www.gnu.org/software/smalltalk/manual-base/html_node/Bag.html
# http://www.demo2s.com/Tutorial/Cpp/0380__set-multiset/Catalog0380__set-multiset.htm
# http://code.activestate.com/recipes/259174/
# Knuth, TAOCP Vol. II section 4.6.3
def __init__(*args, **kwds):
'''Create a new, empty Counter object. And if given, count elements
from an input iterable. Or, initialize the count from another mapping
of elements to their counts.
>>> c = Counter() # a new, empty counter
>>> c = Counter('gallahad') # a new counter from an iterable
>>> c = Counter({'a': 4, 'b': 2}) # a new counter from a mapping
>>> c = Counter(a=4, b=2) # a new counter from keyword args
'''
if not args:
raise TypeError("descriptor '__init__' of 'Counter' object "
"needs an argument")
self = args[0]
args = args[1:]
if len(args) > 1:
raise TypeError('expected at most 1 arguments, got %d' % len(args))
super(Counter, self).__init__()
self.update(*args, **kwds)
def __missing__(self, key):
'The count of elements not in the Counter is zero.'
# Needed so that self[missing_item] does not raise KeyError
return 0
def most_common(self, n=None):
'''List the n most common elements and their counts from the most
common to the least. If n is None, then list all element counts.
>>> Counter('abcdeabcdabcaba').most_common(3)
[('a', 5), ('b', 4), ('c', 3)]
'''
# Emulate Bag.sortedByCount from Smalltalk
if n is None:
return sorted(self.items(), key=_itemgetter(1), reverse=True)
return _heapq.nlargest(n, self.items(), key=_itemgetter(1))
def elements(self):
'''Iterator over elements repeating each as many times as its count.
>>> c = Counter('ABCABC')
>>> sorted(c.elements())
['A', 'A', 'B', 'B', 'C', 'C']
# Knuth's example for prime factors of 1836: 2**2 * 3**3 * 17**1
>>> prime_factors = Counter({2: 2, 3: 3, 17: 1})
>>> product = 1
>>> for factor in prime_factors.elements(): # loop over factors
... product *= factor # and multiply them
>>> product
1836
Note, if an element's count has been set to zero or is a negative
number, elements() will ignore it.
'''
# Emulate Bag.do from Smalltalk and Multiset.begin from C++.
return _chain.from_iterable(_starmap(_repeat, self.items()))
# Override dict methods where necessary
@classmethod
def fromkeys(cls, iterable, v=None):
# There is no equivalent method for counters because setting v=1
# means that no element can have a count greater than one.
raise NotImplementedError(
'Counter.fromkeys() is undefined. Use Counter(iterable) instead.')
def update(*args, **kwds):
'''Like dict.update() but add counts instead of replacing them.
Source can be an iterable, a dictionary, or another Counter instance.
>>> c = Counter('which')
>>> c.update('witch') # add elements from another iterable
>>> d = Counter('watch')
>>> c.update(d) # add elements from another counter
>>> c['h'] # four 'h' in which, witch, and watch
4
'''
# The regular dict.update() operation makes no sense here because the
# replace behavior results in the some of original untouched counts
# being mixed-in with all of the other counts for a mismash that
# doesn't have a straight-forward interpretation in most counting
# contexts. Instead, we implement straight-addition. Both the inputs
# and outputs are allowed to contain zero and negative counts.
if not args:
raise TypeError("descriptor 'update' of 'Counter' object "
"needs an argument")
self = args[0]
args = args[1:]
if len(args) > 1:
raise TypeError('expected at most 1 arguments, got %d' % len(args))
iterable = args[0] if args else None
if iterable is not None:
if isinstance(iterable, Mapping):
if self:
self_get = self.get
for elem, count in iterable.items():
self[elem] = count + self_get(elem, 0)
else:
super(Counter, self).update(iterable) # fast path when counter is empty
else:
_count_elements(self, iterable)
if kwds:
self.update(kwds)
def subtract(*args, **kwds):
'''Like dict.update() but subtracts counts instead of replacing them.
Counts can be reduced below zero. Both the inputs and outputs are
allowed to contain zero and negative counts.
Source can be an iterable, a dictionary, or another Counter instance.
>>> c = Counter('which')
>>> c.subtract('witch') # subtract elements from another iterable
>>> c.subtract(Counter('watch')) # subtract elements from another counter
>>> c['h'] # 2 in which, minus 1 in witch, minus 1 in watch
0
>>> c['w'] # 1 in which, minus 1 in witch, minus 1 in watch
-1
'''
if not args:
raise TypeError("descriptor 'subtract' of 'Counter' object "
"needs an argument")
self = args[0]
args = args[1:]
if len(args) > 1:
raise TypeError('expected at most 1 arguments, got %d' % len(args))
iterable = args[0] if args else None
if iterable is not None:
self_get = self.get
if isinstance(iterable, Mapping):
for elem, count in iterable.items():
self[elem] = self_get(elem, 0) - count
else:
for elem in iterable:
self[elem] = self_get(elem, 0) - 1
if kwds:
self.subtract(kwds)
def copy(self):
'Return a shallow copy.'
return self.__class__(self)
def __reduce__(self):
return self.__class__, (dict(self),)
def __delitem__(self, elem):
'Like dict.__delitem__() but does not raise KeyError for missing values.'
if elem in self:
super(Counter, self).__delitem__(elem)
def __repr__(self):
if not self:
return '%s()' % self.__class__.__name__
try:
items = ', '.join(map('%r: %r'.__mod__, self.most_common()))
return '%s({%s})' % (self.__class__.__name__, items)
except TypeError:
# handle case where values are not orderable
return '{0}({1!r})'.format(self.__class__.__name__, dict(self))
# Multiset-style mathematical operations discussed in:
# Knuth TAOCP Volume II section 4.6.3 exercise 19
# and at http://en.wikipedia.org/wiki/Multiset
#
# Outputs guaranteed to only include positive counts.
#
# To strip negative and zero counts, add-in an empty counter:
# c += Counter()
def __add__(self, other):
'''Add counts from two counters.
>>> Counter('abbb') + Counter('bcc')
Counter({'b': 4, 'c': 2, 'a': 1})
'''
if not isinstance(other, Counter):
return NotImplemented
result = Counter()
for elem, count in self.items():
newcount = count + other[elem]
if newcount > 0:
result[elem] = newcount
for elem, count in other.items():
if elem not in self and count > 0:
result[elem] = count
return result
def __sub__(self, other):
''' Subtract count, but keep only results with positive counts.
>>> Counter('abbbc') - Counter('bccd')
Counter({'b': 2, 'a': 1})
'''
if not isinstance(other, Counter):
return NotImplemented
result = Counter()
for elem, count in self.items():
newcount = count - other[elem]
if newcount > 0:
result[elem] = newcount
for elem, count in other.items():
if elem not in self and count < 0:
result[elem] = 0 - count
return result
def __or__(self, other):
'''Union is the maximum of value in either of the input counters.
>>> Counter('abbb') | Counter('bcc')
Counter({'b': 3, 'c': 2, 'a': 1})
'''
if not isinstance(other, Counter):
return NotImplemented
result = Counter()
for elem, count in self.items():
other_count = other[elem]
newcount = other_count if count < other_count else count
if newcount > 0:
result[elem] = newcount
for elem, count in other.items():
if elem not in self and count > 0:
result[elem] = count
return result
def __and__(self, other):
''' Intersection is the minimum of corresponding counts.
>>> Counter('abbb') & Counter('bcc')
Counter({'b': 1})
'''
if not isinstance(other, Counter):
return NotImplemented
result = Counter()
for elem, count in self.items():
other_count = other[elem]
newcount = count if count < other_count else other_count
if newcount > 0:
result[elem] = newcount
return result
def __pos__(self):
'Adds an empty counter, effectively stripping negative and zero counts'
return self + Counter()
def __neg__(self):
'''Subtracts from an empty counter. Strips positive and zero counts,
and flips the sign on negative counts.
'''
return Counter() - self
def _keep_positive(self):
'''Internal method to strip elements with a negative or zero count'''
nonpositive = [elem for elem, count in self.items() if not count > 0]
for elem in nonpositive:
del self[elem]
return self
def __iadd__(self, other):
'''Inplace add from another counter, keeping only positive counts.
>>> c = Counter('abbb')
>>> c += Counter('bcc')
>>> c
Counter({'b': 4, 'c': 2, 'a': 1})
'''
for elem, count in other.items():
self[elem] += count
return self._keep_positive()
def __isub__(self, other):
'''Inplace subtract counter, but keep only results with positive counts.
>>> c = Counter('abbbc')
>>> c -= Counter('bccd')
>>> c
Counter({'b': 2, 'a': 1})
'''
for elem, count in other.items():
self[elem] -= count
return self._keep_positive()
def __ior__(self, other):
'''Inplace union is the maximum of value from either counter.
>>> c = Counter('abbb')
>>> c |= Counter('bcc')
>>> c
Counter({'b': 3, 'c': 2, 'a': 1})
'''
for elem, other_count in other.items():
count = self[elem]
if other_count > count:
self[elem] = other_count
return self._keep_positive()
def __iand__(self, other):
'''Inplace intersection is the minimum of corresponding counts.
>>> c = Counter('abbb')
>>> c &= Counter('bcc')
>>> c
Counter({'b': 1})
'''
for elem, count in self.items():
other_count = other[elem]
if other_count < count:
self[elem] = other_count
return self._keep_positive()
def check_output(*popenargs, **kwargs):
"""
For Python 2.6 compatibility: see
http://stackoverflow.com/questions/4814970/
"""
if 'stdout' in kwargs:
raise ValueError('stdout argument not allowed, it will be overridden.')
process = subprocess.Popen(stdout=subprocess.PIPE, *popenargs, **kwargs)
output, unused_err = process.communicate()
retcode = process.poll()
if retcode:
cmd = kwargs.get("args")
if cmd is None:
cmd = popenargs[0]
raise subprocess.CalledProcessError(retcode, cmd)
return output
def count(start=0, step=1):
"""
``itertools.count`` in Py 2.6 doesn't accept a step
parameter. This is an enhanced version of ``itertools.count``
for Py2.6 equivalent to ``itertools.count`` in Python 2.7+.
"""
while True:
yield start
start += step
########################################################################
### ChainMap (helper for configparser and string.Template)
### From the Py3.4 source code. See also:
### https://github.com/kkxue/Py2ChainMap/blob/master/py2chainmap.py
########################################################################
class ChainMap(MutableMapping):
''' A ChainMap groups multiple dicts (or other mappings) together
to create a single, updateable view.
The underlying mappings are stored in a list. That list is public and can
accessed or updated using the *maps* attribute. There is no other state.
Lookups search the underlying mappings successively until a key is found.
In contrast, writes, updates, and deletions only operate on the first
mapping.
'''
def __init__(self, *maps):
'''Initialize a ChainMap by setting *maps* to the given mappings.
If no mappings are provided, a single empty dictionary is used.
'''
self.maps = list(maps) or [{}] # always at least one map
def __missing__(self, key):
raise KeyError(key)
def __getitem__(self, key):
for mapping in self.maps:
try:
return mapping[key] # can't use 'key in mapping' with defaultdict
except KeyError:
pass
return self.__missing__(key) # support subclasses that define __missing__
def get(self, key, default=None):
return self[key] if key in self else default
def __len__(self):
return len(set().union(*self.maps)) # reuses stored hash values if possible
def __iter__(self):
return iter(set().union(*self.maps))
def __contains__(self, key):
return any(key in m for m in self.maps)
def __bool__(self):
return any(self.maps)
# Py2 compatibility:
__nonzero__ = __bool__
@recursive_repr()
def __repr__(self):
return '{0.__class__.__name__}({1})'.format(
self, ', '.join(map(repr, self.maps)))
@classmethod
def fromkeys(cls, iterable, *args):
'Create a ChainMap with a single dict created from the iterable.'
return cls(dict.fromkeys(iterable, *args))
def copy(self):
'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]'
return self.__class__(self.maps[0].copy(), *self.maps[1:])
__copy__ = copy
def new_child(self, m=None): # like Django's Context.push()
'''
New ChainMap with a new map followed by all previous maps. If no
map is provided, an empty dict is used.
'''
if m is None:
m = {}
return self.__class__(m, *self.maps)
@property
def parents(self): # like Django's Context.pop()
'New ChainMap from maps[1:].'
return self.__class__(*self.maps[1:])
def __setitem__(self, key, value):
self.maps[0][key] = value
def __delitem__(self, key):
try:
del self.maps[0][key]
except KeyError:
raise KeyError('Key not found in the first mapping: {0!r}'.format(key))
def popitem(self):
'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.'
try:
return self.maps[0].popitem()
except KeyError:
raise KeyError('No keys found in the first mapping.')
def pop(self, key, *args):
'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].'
try:
return self.maps[0].pop(key, *args)
except KeyError:
raise KeyError('Key not found in the first mapping: {0!r}'.format(key))
def clear(self):
'Clear maps[0], leaving maps[1:] intact.'
self.maps[0].clear()
# Re-use the same sentinel as in the Python stdlib socket module:
from socket import _GLOBAL_DEFAULT_TIMEOUT
# Was: _GLOBAL_DEFAULT_TIMEOUT = object()
def create_connection(address, timeout=_GLOBAL_DEFAULT_TIMEOUT,
source_address=None):
"""Backport of 3-argument create_connection() for Py2.6.
Connect to *address* and return the socket object.
Convenience function. Connect to *address* (a 2-tuple ``(host,
port)``) and return the socket object. Passing the optional
*timeout* parameter will set the timeout on the socket instance
before attempting to connect. If no *timeout* is supplied, the
global default timeout setting returned by :func:`getdefaulttimeout`
is used. If *source_address* is set it must be a tuple of (host, port)
for the socket to bind as a source address before making the connection.
An host of '' or port 0 tells the OS to use the default.
"""
host, port = address
err = None
for res in getaddrinfo(host, port, 0, SOCK_STREAM):
af, socktype, proto, canonname, sa = res
sock = None
try:
sock = socket(af, socktype, proto)
if timeout is not _GLOBAL_DEFAULT_TIMEOUT:
sock.settimeout(timeout)
if source_address:
sock.bind(source_address)
sock.connect(sa)
return sock
except error as _:
err = _
if sock is not None:
sock.close()
if err is not None:
raise err
else:
raise error("getaddrinfo returns an empty list")
# Backport from Py2.7 for Py2.6:
def cmp_to_key(mycmp):
"""Convert a cmp= function into a key= function"""
class K(object):
__slots__ = ['obj']
def __init__(self, obj, *args):
self.obj = obj
def __lt__(self, other):
return mycmp(self.obj, other.obj) < 0
def __gt__(self, other):
return mycmp(self.obj, other.obj) > 0
def __eq__(self, other):
return mycmp(self.obj, other.obj) == 0
def __le__(self, other):
return mycmp(self.obj, other.obj) <= 0
def __ge__(self, other):
return mycmp(self.obj, other.obj) >= 0
def __ne__(self, other):
return mycmp(self.obj, other.obj) != 0
def __hash__(self):
raise TypeError('hash not implemented')
return K
# Back up our definitions above in case they're useful
_OrderedDict = OrderedDict
_Counter = Counter
_check_output = check_output
_count = count
_ceil = ceil
__count_elements = _count_elements
_recursive_repr = recursive_repr
_ChainMap = ChainMap
_create_connection = create_connection
_cmp_to_key = cmp_to_key
# Overwrite the definitions above with the usual ones
# from the standard library:
if sys.version_info >= (2, 7):
from collections import OrderedDict, Counter
from itertools import count
from functools import cmp_to_key
try:
from subprocess import check_output
except ImportError:
# Not available. This happens with Google App Engine: see issue #231
pass
from socket import create_connection
if sys.version_info >= (3, 0):
from math import ceil
from collections import _count_elements
if sys.version_info >= (3, 3):
from reprlib import recursive_repr
from collections import ChainMap
PK �Cu\2�� � future/backports/http/client.pynu �[��� """HTTP/1.1 client library
A backport of the Python 3.3 http/client.py module for python-future.
<intro stuff goes here>
<other stuff, too>
HTTPConnection goes through a number of "states", which define when a client
may legally make another request or fetch the response for a particular
request. This diagram details these state transitions:
(null)
|
| HTTPConnection()
v
Idle
|
| putrequest()
v
Request-started
|
| ( putheader() )* endheaders()
v
Request-sent
|
| response = getresponse()
v
Unread-response [Response-headers-read]
|\____________________
| |
| response.read() | putrequest()
v v
Idle Req-started-unread-response
______/|
/ |
response.read() | | ( putheader() )* endheaders()
v v
Request-started Req-sent-unread-response
|
| response.read()
v
Request-sent
This diagram presents the following rules:
-- a second request may not be started until {response-headers-read}
-- a response [object] cannot be retrieved until {request-sent}
-- there is no differentiation between an unread response body and a
partially read response body
Note: this enforcement is applied by the HTTPConnection class. The
HTTPResponse class does not enforce this state machine, which
implies sophisticated clients may accelerate the request/response
pipeline. Caution should be taken, though: accelerating the states
beyond the above pattern may imply knowledge of the server's
connection-close behavior for certain requests. For example, it
is impossible to tell whether the server will close the connection
UNTIL the response headers have been read; this means that further
requests cannot be placed into the pipeline until it is known that
the server will NOT be closing the connection.
Logical State __state __response
------------- ------- ----------
Idle _CS_IDLE None
Request-started _CS_REQ_STARTED None
Request-sent _CS_REQ_SENT None
Unread-response _CS_IDLE <response_class>
Req-started-unread-response _CS_REQ_STARTED <response_class>
Req-sent-unread-response _CS_REQ_SENT <response_class>
"""
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from future.builtins import bytes, int, str, super
from future.utils import PY2
from future.backports.email import parser as email_parser
from future.backports.email import message as email_message
from future.backports.misc import create_connection as socket_create_connection
import io
import os
import socket
from future.backports.urllib.parse import urlsplit
import warnings
from array import array
if PY2:
from collections import Iterable
else:
from collections.abc import Iterable
__all__ = ["HTTPResponse", "HTTPConnection",
"HTTPException", "NotConnected", "UnknownProtocol",
"UnknownTransferEncoding", "UnimplementedFileMode",
"IncompleteRead", "InvalidURL", "ImproperConnectionState",
"CannotSendRequest", "CannotSendHeader", "ResponseNotReady",
"BadStatusLine", "error", "responses"]
HTTP_PORT = 80
HTTPS_PORT = 443
_UNKNOWN = 'UNKNOWN'
# connection states
_CS_IDLE = 'Idle'
_CS_REQ_STARTED = 'Request-started'
_CS_REQ_SENT = 'Request-sent'
# status codes
# informational
CONTINUE = 100
SWITCHING_PROTOCOLS = 101
PROCESSING = 102
# successful
OK = 200
CREATED = 201
ACCEPTED = 202
NON_AUTHORITATIVE_INFORMATION = 203
NO_CONTENT = 204
RESET_CONTENT = 205
PARTIAL_CONTENT = 206
MULTI_STATUS = 207
IM_USED = 226
# redirection
MULTIPLE_CHOICES = 300
MOVED_PERMANENTLY = 301
FOUND = 302
SEE_OTHER = 303
NOT_MODIFIED = 304
USE_PROXY = 305
TEMPORARY_REDIRECT = 307
# client error
BAD_REQUEST = 400
UNAUTHORIZED = 401
PAYMENT_REQUIRED = 402
FORBIDDEN = 403
NOT_FOUND = 404
METHOD_NOT_ALLOWED = 405
NOT_ACCEPTABLE = 406
PROXY_AUTHENTICATION_REQUIRED = 407
REQUEST_TIMEOUT = 408
CONFLICT = 409
GONE = 410
LENGTH_REQUIRED = 411
PRECONDITION_FAILED = 412
REQUEST_ENTITY_TOO_LARGE = 413
REQUEST_URI_TOO_LONG = 414
UNSUPPORTED_MEDIA_TYPE = 415
REQUESTED_RANGE_NOT_SATISFIABLE = 416
EXPECTATION_FAILED = 417
UNPROCESSABLE_ENTITY = 422
LOCKED = 423
FAILED_DEPENDENCY = 424
UPGRADE_REQUIRED = 426
PRECONDITION_REQUIRED = 428
TOO_MANY_REQUESTS = 429
REQUEST_HEADER_FIELDS_TOO_LARGE = 431
# server error
INTERNAL_SERVER_ERROR = 500
NOT_IMPLEMENTED = 501
BAD_GATEWAY = 502
SERVICE_UNAVAILABLE = 503
GATEWAY_TIMEOUT = 504
HTTP_VERSION_NOT_SUPPORTED = 505
INSUFFICIENT_STORAGE = 507
NOT_EXTENDED = 510
NETWORK_AUTHENTICATION_REQUIRED = 511
# Mapping status codes to official W3C names
responses = {
100: 'Continue',
101: 'Switching Protocols',
200: 'OK',
201: 'Created',
202: 'Accepted',
203: 'Non-Authoritative Information',
204: 'No Content',
205: 'Reset Content',
206: 'Partial Content',
300: 'Multiple Choices',
301: 'Moved Permanently',
302: 'Found',
303: 'See Other',
304: 'Not Modified',
305: 'Use Proxy',
306: '(Unused)',
307: 'Temporary Redirect',
400: 'Bad Request',
401: 'Unauthorized',
402: 'Payment Required',
403: 'Forbidden',
404: 'Not Found',
405: 'Method Not Allowed',
406: 'Not Acceptable',
407: 'Proxy Authentication Required',
408: 'Request Timeout',
409: 'Conflict',
410: 'Gone',
411: 'Length Required',
412: 'Precondition Failed',
413: 'Request Entity Too Large',
414: 'Request-URI Too Long',
415: 'Unsupported Media Type',
416: 'Requested Range Not Satisfiable',
417: 'Expectation Failed',
428: 'Precondition Required',
429: 'Too Many Requests',
431: 'Request Header Fields Too Large',
500: 'Internal Server Error',
501: 'Not Implemented',
502: 'Bad Gateway',
503: 'Service Unavailable',
504: 'Gateway Timeout',
505: 'HTTP Version Not Supported',
511: 'Network Authentication Required',
}
# maximal amount of data to read at one time in _safe_read
MAXAMOUNT = 1048576
# maximal line length when calling readline().
_MAXLINE = 65536
_MAXHEADERS = 100
class HTTPMessage(email_message.Message):
# XXX The only usage of this method is in
# http.server.CGIHTTPRequestHandler. Maybe move the code there so
# that it doesn't need to be part of the public API. The API has
# never been defined so this could cause backwards compatibility
# issues.
def getallmatchingheaders(self, name):
"""Find all header lines matching a given header name.
Look through the list of headers and find all lines matching a given
header name (and their continuation lines). A list of the lines is
returned, without interpretation. If the header does not occur, an
empty list is returned. If the header occurs multiple times, all
occurrences are returned. Case is not important in the header name.
"""
name = name.lower() + ':'
n = len(name)
lst = []
hit = 0
for line in self.keys():
if line[:n].lower() == name:
hit = 1
elif not line[:1].isspace():
hit = 0
if hit:
lst.append(line)
return lst
def parse_headers(fp, _class=HTTPMessage):
"""Parses only RFC2822 headers from a file pointer.
email Parser wants to see strings rather than bytes.
But a TextIOWrapper around self.rfile would buffer too many bytes
from the stream, bytes which we later need to read as bytes.
So we read the correct bytes here, as bytes, for email Parser
to parse.
"""
headers = []
while True:
line = fp.readline(_MAXLINE + 1)
if len(line) > _MAXLINE:
raise LineTooLong("header line")
headers.append(line)
if len(headers) > _MAXHEADERS:
raise HTTPException("got more than %d headers" % _MAXHEADERS)
if line in (b'\r\n', b'\n', b''):
break
hstring = bytes(b'').join(headers).decode('iso-8859-1')
return email_parser.Parser(_class=_class).parsestr(hstring)
_strict_sentinel = object()
class HTTPResponse(io.RawIOBase):
# See RFC 2616 sec 19.6 and RFC 1945 sec 6 for details.
# The bytes from the socket object are iso-8859-1 strings.
# See RFC 2616 sec 2.2 which notes an exception for MIME-encoded
# text following RFC 2047. The basic status line parsing only
# accepts iso-8859-1.
def __init__(self, sock, debuglevel=0, strict=_strict_sentinel, method=None, url=None):
# If the response includes a content-length header, we need to
# make sure that the client doesn't read more than the
# specified number of bytes. If it does, it will block until
# the server times out and closes the connection. This will
# happen if a self.fp.read() is done (without a size) whether
# self.fp is buffered or not. So, no self.fp.read() by
# clients unless they know what they are doing.
self.fp = sock.makefile("rb")
self.debuglevel = debuglevel
if strict is not _strict_sentinel:
warnings.warn("the 'strict' argument isn't supported anymore; "
"http.client now always assumes HTTP/1.x compliant servers.",
DeprecationWarning, 2)
self._method = method
# The HTTPResponse object is returned via urllib. The clients
# of http and urllib expect different attributes for the
# headers. headers is used here and supports urllib. msg is
# provided as a backwards compatibility layer for http
# clients.
self.headers = self.msg = None
# from the Status-Line of the response
self.version = _UNKNOWN # HTTP-Version
self.status = _UNKNOWN # Status-Code
self.reason = _UNKNOWN # Reason-Phrase
self.chunked = _UNKNOWN # is "chunked" being used?
self.chunk_left = _UNKNOWN # bytes left to read in current chunk
self.length = _UNKNOWN # number of bytes left in response
self.will_close = _UNKNOWN # conn will close at end of response
def _read_status(self):
line = str(self.fp.readline(_MAXLINE + 1), "iso-8859-1")
if len(line) > _MAXLINE:
raise LineTooLong("status line")
if self.debuglevel > 0:
print("reply:", repr(line))
if not line:
# Presumably, the server closed the connection before
# sending a valid response.
raise BadStatusLine(line)
try:
version, status, reason = line.split(None, 2)
except ValueError:
try:
version, status = line.split(None, 1)
reason = ""
except ValueError:
# empty version will cause next test to fail.
version = ""
if not version.startswith("HTTP/"):
self._close_conn()
raise BadStatusLine(line)
# The status code is a three-digit number
try:
status = int(status)
if status < 100 or status > 999:
raise BadStatusLine(line)
except ValueError:
raise BadStatusLine(line)
return version, status, reason
def begin(self):
if self.headers is not None:
# we've already started reading the response
return
# read until we get a non-100 response
while True:
version, status, reason = self._read_status()
if status != CONTINUE:
break
# skip the header from the 100 response
while True:
skip = self.fp.readline(_MAXLINE + 1)
if len(skip) > _MAXLINE:
raise LineTooLong("header line")
skip = skip.strip()
if not skip:
break
if self.debuglevel > 0:
print("header:", skip)
self.code = self.status = status
self.reason = reason.strip()
if version in ("HTTP/1.0", "HTTP/0.9"):
# Some servers might still return "0.9", treat it as 1.0 anyway
self.version = 10
elif version.startswith("HTTP/1."):
self.version = 11 # use HTTP/1.1 code for HTTP/1.x where x>=1
else:
raise UnknownProtocol(version)
self.headers = self.msg = parse_headers(self.fp)
if self.debuglevel > 0:
for hdr in self.headers:
print("header:", hdr, end=" ")
# are we using the chunked-style of transfer encoding?
tr_enc = self.headers.get("transfer-encoding")
if tr_enc and tr_enc.lower() == "chunked":
self.chunked = True
self.chunk_left = None
else:
self.chunked = False
# will the connection close at the end of the response?
self.will_close = self._check_close()
# do we have a Content-Length?
# NOTE: RFC 2616, S4.4, #3 says we ignore this if tr_enc is "chunked"
self.length = None
length = self.headers.get("content-length")
# are we using the chunked-style of transfer encoding?
tr_enc = self.headers.get("transfer-encoding")
if length and not self.chunked:
try:
self.length = int(length)
except ValueError:
self.length = None
else:
if self.length < 0: # ignore nonsensical negative lengths
self.length = None
else:
self.length = None
# does the body have a fixed length? (of zero)
if (status == NO_CONTENT or status == NOT_MODIFIED or
100 <= status < 200 or # 1xx codes
self._method == "HEAD"):
self.length = 0
# if the connection remains open, and we aren't using chunked, and
# a content-length was not provided, then assume that the connection
# WILL close.
if (not self.will_close and
not self.chunked and
self.length is None):
self.will_close = True
def _check_close(self):
conn = self.headers.get("connection")
if self.version == 11:
# An HTTP/1.1 proxy is assumed to stay open unless
# explicitly closed.
conn = self.headers.get("connection")
if conn and "close" in conn.lower():
return True
return False
# Some HTTP/1.0 implementations have support for persistent
# connections, using rules different than HTTP/1.1.
# For older HTTP, Keep-Alive indicates persistent connection.
if self.headers.get("keep-alive"):
return False
# At least Akamai returns a "Connection: Keep-Alive" header,
# which was supposed to be sent by the client.
if conn and "keep-alive" in conn.lower():
return False
# Proxy-Connection is a netscape hack.
pconn = self.headers.get("proxy-connection")
if pconn and "keep-alive" in pconn.lower():
return False
# otherwise, assume it will close
return True
def _close_conn(self):
fp = self.fp
self.fp = None
fp.close()
def close(self):
super().close() # set "closed" flag
if self.fp:
self._close_conn()
# These implementations are for the benefit of io.BufferedReader.
# XXX This class should probably be revised to act more like
# the "raw stream" that BufferedReader expects.
def flush(self):
super().flush()
if self.fp:
self.fp.flush()
def readable(self):
return True
# End of "raw stream" methods
def isclosed(self):
"""True if the connection is closed."""
# NOTE: it is possible that we will not ever call self.close(). This
# case occurs when will_close is TRUE, length is None, and we
# read up to the last byte, but NOT past it.
#
# IMPLIES: if will_close is FALSE, then self.close() will ALWAYS be
# called, meaning self.isclosed() is meaningful.
return self.fp is None
def read(self, amt=None):
if self.fp is None:
return bytes(b"")
if self._method == "HEAD":
self._close_conn()
return bytes(b"")
if amt is not None:
# Amount is given, so call base class version
# (which is implemented in terms of self.readinto)
return bytes(super(HTTPResponse, self).read(amt))
else:
# Amount is not given (unbounded read) so we must check self.length
# and self.chunked
if self.chunked:
return self._readall_chunked()
if self.length is None:
s = self.fp.read()
else:
try:
s = self._safe_read(self.length)
except IncompleteRead:
self._close_conn()
raise
self.length = 0
self._close_conn() # we read everything
return bytes(s)
def readinto(self, b):
if self.fp is None:
return 0
if self._method == "HEAD":
self._close_conn()
return 0
if self.chunked:
return self._readinto_chunked(b)
if self.length is not None:
if len(b) > self.length:
# clip the read to the "end of response"
b = memoryview(b)[0:self.length]
# we do not use _safe_read() here because this may be a .will_close
# connection, and the user is reading more bytes than will be provided
# (for example, reading in 1k chunks)
if PY2:
data = self.fp.read(len(b))
n = len(data)
b[:n] = data
else:
n = self.fp.readinto(b)
if not n and b:
# Ideally, we would raise IncompleteRead if the content-length
# wasn't satisfied, but it might break compatibility.
self._close_conn()
elif self.length is not None:
self.length -= n
if not self.length:
self._close_conn()
return n
def _read_next_chunk_size(self):
# Read the next chunk size from the file
line = self.fp.readline(_MAXLINE + 1)
if len(line) > _MAXLINE:
raise LineTooLong("chunk size")
i = line.find(b";")
if i >= 0:
line = line[:i] # strip chunk-extensions
try:
return int(line, 16)
except ValueError:
# close the connection as protocol synchronisation is
# probably lost
self._close_conn()
raise
def _read_and_discard_trailer(self):
# read and discard trailer up to the CRLF terminator
### note: we shouldn't have any trailers!
while True:
line = self.fp.readline(_MAXLINE + 1)
if len(line) > _MAXLINE:
raise LineTooLong("trailer line")
if not line:
# a vanishingly small number of sites EOF without
# sending the trailer
break
if line in (b'\r\n', b'\n', b''):
break
def _readall_chunked(self):
assert self.chunked != _UNKNOWN
chunk_left = self.chunk_left
value = []
while True:
if chunk_left is None:
try:
chunk_left = self._read_next_chunk_size()
if chunk_left == 0:
break
except ValueError:
raise IncompleteRead(bytes(b'').join(value))
value.append(self._safe_read(chunk_left))
# we read the whole chunk, get another
self._safe_read(2) # toss the CRLF at the end of the chunk
chunk_left = None
self._read_and_discard_trailer()
# we read everything; close the "file"
self._close_conn()
return bytes(b'').join(value)
def _readinto_chunked(self, b):
assert self.chunked != _UNKNOWN
chunk_left = self.chunk_left
total_bytes = 0
mvb = memoryview(b)
while True:
if chunk_left is None:
try:
chunk_left = self._read_next_chunk_size()
if chunk_left == 0:
break
except ValueError:
raise IncompleteRead(bytes(b[0:total_bytes]))
if len(mvb) < chunk_left:
n = self._safe_readinto(mvb)
self.chunk_left = chunk_left - n
return total_bytes + n
elif len(mvb) == chunk_left:
n = self._safe_readinto(mvb)
self._safe_read(2) # toss the CRLF at the end of the chunk
self.chunk_left = None
return total_bytes + n
else:
temp_mvb = mvb[0:chunk_left]
n = self._safe_readinto(temp_mvb)
mvb = mvb[n:]
total_bytes += n
# we read the whole chunk, get another
self._safe_read(2) # toss the CRLF at the end of the chunk
chunk_left = None
self._read_and_discard_trailer()
# we read everything; close the "file"
self._close_conn()
return total_bytes
def _safe_read(self, amt):
"""Read the number of bytes requested, compensating for partial reads.
Normally, we have a blocking socket, but a read() can be interrupted
by a signal (resulting in a partial read).
Note that we cannot distinguish between EOF and an interrupt when zero
bytes have been read. IncompleteRead() will be raised in this
situation.
This function should be used when <amt> bytes "should" be present for
reading. If the bytes are truly not available (due to EOF), then the
IncompleteRead exception can be used to detect the problem.
"""
s = []
while amt > 0:
chunk = self.fp.read(min(amt, MAXAMOUNT))
if not chunk:
raise IncompleteRead(bytes(b'').join(s), amt)
s.append(chunk)
amt -= len(chunk)
return bytes(b"").join(s)
def _safe_readinto(self, b):
"""Same as _safe_read, but for reading into a buffer."""
total_bytes = 0
mvb = memoryview(b)
while total_bytes < len(b):
if MAXAMOUNT < len(mvb):
temp_mvb = mvb[0:MAXAMOUNT]
if PY2:
data = self.fp.read(len(temp_mvb))
n = len(data)
temp_mvb[:n] = data
else:
n = self.fp.readinto(temp_mvb)
else:
if PY2:
data = self.fp.read(len(mvb))
n = len(data)
mvb[:n] = data
else:
n = self.fp.readinto(mvb)
if not n:
raise IncompleteRead(bytes(mvb[0:total_bytes]), len(b))
mvb = mvb[n:]
total_bytes += n
return total_bytes
def fileno(self):
return self.fp.fileno()
def getheader(self, name, default=None):
if self.headers is None:
raise ResponseNotReady()
headers = self.headers.get_all(name) or default
if isinstance(headers, str) or not hasattr(headers, '__iter__'):
return headers
else:
return ', '.join(headers)
def getheaders(self):
"""Return list of (header, value) tuples."""
if self.headers is None:
raise ResponseNotReady()
return list(self.headers.items())
# We override IOBase.__iter__ so that it doesn't check for closed-ness
def __iter__(self):
return self
# For compatibility with old-style urllib responses.
def info(self):
return self.headers
def geturl(self):
return self.url
def getcode(self):
return self.status
class HTTPConnection(object):
_http_vsn = 11
_http_vsn_str = 'HTTP/1.1'
response_class = HTTPResponse
default_port = HTTP_PORT
auto_open = 1
debuglevel = 0
def __init__(self, host, port=None, strict=_strict_sentinel,
timeout=socket._GLOBAL_DEFAULT_TIMEOUT, source_address=None):
if strict is not _strict_sentinel:
warnings.warn("the 'strict' argument isn't supported anymore; "
"http.client now always assumes HTTP/1.x compliant servers.",
DeprecationWarning, 2)
self.timeout = timeout
self.source_address = source_address
self.sock = None
self._buffer = []
self.__response = None
self.__state = _CS_IDLE
self._method = None
self._tunnel_host = None
self._tunnel_port = None
self._tunnel_headers = {}
self._set_hostport(host, port)
def set_tunnel(self, host, port=None, headers=None):
""" Sets up the host and the port for the HTTP CONNECT Tunnelling.
The headers argument should be a mapping of extra HTTP headers
to send with the CONNECT request.
"""
self._tunnel_host = host
self._tunnel_port = port
if headers:
self._tunnel_headers = headers
else:
self._tunnel_headers.clear()
def _set_hostport(self, host, port):
if port is None:
i = host.rfind(':')
j = host.rfind(']') # ipv6 addresses have [...]
if i > j:
try:
port = int(host[i+1:])
except ValueError:
if host[i+1:] == "": # http://foo.com:/ == http://foo.com/
port = self.default_port
else:
raise InvalidURL("nonnumeric port: '%s'" % host[i+1:])
host = host[:i]
else:
port = self.default_port
if host and host[0] == '[' and host[-1] == ']':
host = host[1:-1]
self.host = host
self.port = port
def set_debuglevel(self, level):
self.debuglevel = level
def _tunnel(self):
self._set_hostport(self._tunnel_host, self._tunnel_port)
connect_str = "CONNECT %s:%d HTTP/1.0\r\n" % (self.host, self.port)
connect_bytes = connect_str.encode("ascii")
self.send(connect_bytes)
for header, value in self._tunnel_headers.items():
header_str = "%s: %s\r\n" % (header, value)
header_bytes = header_str.encode("latin-1")
self.send(header_bytes)
self.send(bytes(b'\r\n'))
response = self.response_class(self.sock, method=self._method)
(version, code, message) = response._read_status()
if code != 200:
self.close()
raise socket.error("Tunnel connection failed: %d %s" % (code,
message.strip()))
while True:
line = response.fp.readline(_MAXLINE + 1)
if len(line) > _MAXLINE:
raise LineTooLong("header line")
if not line:
# for sites which EOF without sending a trailer
break
if line in (b'\r\n', b'\n', b''):
break
def connect(self):
"""Connect to the host and port specified in __init__."""
self.sock = socket_create_connection((self.host,self.port),
self.timeout, self.source_address)
if self._tunnel_host:
self._tunnel()
def close(self):
"""Close the connection to the HTTP server."""
if self.sock:
self.sock.close() # close it manually... there may be other refs
self.sock = None
if self.__response:
self.__response.close()
self.__response = None
self.__state = _CS_IDLE
def send(self, data):
"""Send `data' to the server.
``data`` can be a string object, a bytes object, an array object, a
file-like object that supports a .read() method, or an iterable object.
"""
if self.sock is None:
if self.auto_open:
self.connect()
else:
raise NotConnected()
if self.debuglevel > 0:
print("send:", repr(data))
blocksize = 8192
# Python 2.7 array objects have a read method which is incompatible
# with the 2-arg calling syntax below.
if hasattr(data, "read") and not isinstance(data, array):
if self.debuglevel > 0:
print("sendIng a read()able")
encode = False
try:
mode = data.mode
except AttributeError:
# io.BytesIO and other file-like objects don't have a `mode`
# attribute.
pass
else:
if "b" not in mode:
encode = True
if self.debuglevel > 0:
print("encoding file using iso-8859-1")
while 1:
datablock = data.read(blocksize)
if not datablock:
break
if encode:
datablock = datablock.encode("iso-8859-1")
self.sock.sendall(datablock)
return
try:
self.sock.sendall(data)
except TypeError:
if isinstance(data, Iterable):
for d in data:
self.sock.sendall(d)
else:
raise TypeError("data should be a bytes-like object "
"or an iterable, got %r" % type(data))
def _output(self, s):
"""Add a line of output to the current request buffer.
Assumes that the line does *not* end with \\r\\n.
"""
self._buffer.append(s)
def _send_output(self, message_body=None):
"""Send the currently buffered request and clear the buffer.
Appends an extra \\r\\n to the buffer.
A message_body may be specified, to be appended to the request.
"""
self._buffer.extend((bytes(b""), bytes(b"")))
msg = bytes(b"\r\n").join(self._buffer)
del self._buffer[:]
# If msg and message_body are sent in a single send() call,
# it will avoid performance problems caused by the interaction
# between delayed ack and the Nagle algorithm.
if isinstance(message_body, bytes):
msg += message_body
message_body = None
self.send(msg)
if message_body is not None:
# message_body was not a string (i.e. it is a file), and
# we must run the risk of Nagle.
self.send(message_body)
def putrequest(self, method, url, skip_host=0, skip_accept_encoding=0):
"""Send a request to the server.
`method' specifies an HTTP request method, e.g. 'GET'.
`url' specifies the object being requested, e.g. '/index.html'.
`skip_host' if True does not add automatically a 'Host:' header
`skip_accept_encoding' if True does not add automatically an
'Accept-Encoding:' header
"""
# if a prior response has been completed, then forget about it.
if self.__response and self.__response.isclosed():
self.__response = None
# in certain cases, we cannot issue another request on this connection.
# this occurs when:
# 1) we are in the process of sending a request. (_CS_REQ_STARTED)
# 2) a response to a previous request has signalled that it is going
# to close the connection upon completion.
# 3) the headers for the previous response have not been read, thus
# we cannot determine whether point (2) is true. (_CS_REQ_SENT)
#
# if there is no prior response, then we can request at will.
#
# if point (2) is true, then we will have passed the socket to the
# response (effectively meaning, "there is no prior response"), and
# will open a new one when a new request is made.
#
# Note: if a prior response exists, then we *can* start a new request.
# We are not allowed to begin fetching the response to this new
# request, however, until that prior response is complete.
#
if self.__state == _CS_IDLE:
self.__state = _CS_REQ_STARTED
else:
raise CannotSendRequest(self.__state)
# Save the method we use, we need it later in the response phase
self._method = method
if not url:
url = '/'
request = '%s %s %s' % (method, url, self._http_vsn_str)
# Non-ASCII characters should have been eliminated earlier
self._output(request.encode('ascii'))
if self._http_vsn == 11:
# Issue some standard headers for better HTTP/1.1 compliance
if not skip_host:
# this header is issued *only* for HTTP/1.1
# connections. more specifically, this means it is
# only issued when the client uses the new
# HTTPConnection() class. backwards-compat clients
# will be using HTTP/1.0 and those clients may be
# issuing this header themselves. we should NOT issue
# it twice; some web servers (such as Apache) barf
# when they see two Host: headers
# If we need a non-standard port,include it in the
# header. If the request is going through a proxy,
# but the host of the actual URL, not the host of the
# proxy.
netloc = ''
if url.startswith('http'):
nil, netloc, nil, nil, nil = urlsplit(url)
if netloc:
try:
netloc_enc = netloc.encode("ascii")
except UnicodeEncodeError:
netloc_enc = netloc.encode("idna")
self.putheader('Host', netloc_enc)
else:
try:
host_enc = self.host.encode("ascii")
except UnicodeEncodeError:
host_enc = self.host.encode("idna")
# As per RFC 273, IPv6 address should be wrapped with []
# when used as Host header
if self.host.find(':') >= 0:
host_enc = bytes(b'[' + host_enc + b']')
if self.port == self.default_port:
self.putheader('Host', host_enc)
else:
host_enc = host_enc.decode("ascii")
self.putheader('Host', "%s:%s" % (host_enc, self.port))
# note: we are assuming that clients will not attempt to set these
# headers since *this* library must deal with the
# consequences. this also means that when the supporting
# libraries are updated to recognize other forms, then this
# code should be changed (removed or updated).
# we only want a Content-Encoding of "identity" since we don't
# support encodings such as x-gzip or x-deflate.
if not skip_accept_encoding:
self.putheader('Accept-Encoding', 'identity')
# we can accept "chunked" Transfer-Encodings, but no others
# NOTE: no TE header implies *only* "chunked"
#self.putheader('TE', 'chunked')
# if TE is supplied in the header, then it must appear in a
# Connection header.
#self.putheader('Connection', 'TE')
else:
# For HTTP/1.0, the server will assume "not chunked"
pass
def putheader(self, header, *values):
"""Send a request header line to the server.
For example: h.putheader('Accept', 'text/html')
"""
if self.__state != _CS_REQ_STARTED:
raise CannotSendHeader()
if hasattr(header, 'encode'):
header = header.encode('ascii')
values = list(values)
for i, one_value in enumerate(values):
if hasattr(one_value, 'encode'):
values[i] = one_value.encode('latin-1')
elif isinstance(one_value, int):
values[i] = str(one_value).encode('ascii')
value = bytes(b'\r\n\t').join(values)
header = header + bytes(b': ') + value
self._output(header)
def endheaders(self, message_body=None):
"""Indicate that the last header line has been sent to the server.
This method sends the request to the server. The optional message_body
argument can be used to pass a message body associated with the
request. The message body will be sent in the same packet as the
message headers if it is a string, otherwise it is sent as a separate
packet.
"""
if self.__state == _CS_REQ_STARTED:
self.__state = _CS_REQ_SENT
else:
raise CannotSendHeader()
self._send_output(message_body)
def request(self, method, url, body=None, headers={}):
"""Send a complete request to the server."""
self._send_request(method, url, body, headers)
def _set_content_length(self, body):
# Set the content-length based on the body.
thelen = None
try:
thelen = str(len(body))
except TypeError as te:
# If this is a file-like object, try to
# fstat its file descriptor
try:
thelen = str(os.fstat(body.fileno()).st_size)
except (AttributeError, OSError):
# Don't send a length if this failed
if self.debuglevel > 0: print("Cannot stat!!")
if thelen is not None:
self.putheader('Content-Length', thelen)
def _send_request(self, method, url, body, headers):
# Honor explicitly requested Host: and Accept-Encoding: headers.
header_names = dict.fromkeys([k.lower() for k in headers])
skips = {}
if 'host' in header_names:
skips['skip_host'] = 1
if 'accept-encoding' in header_names:
skips['skip_accept_encoding'] = 1
self.putrequest(method, url, **skips)
if body is not None and ('content-length' not in header_names):
self._set_content_length(body)
for hdr, value in headers.items():
self.putheader(hdr, value)
if isinstance(body, str):
# RFC 2616 Section 3.7.1 says that text default has a
# default charset of iso-8859-1.
body = body.encode('iso-8859-1')
self.endheaders(body)
def getresponse(self):
"""Get the response from the server.
If the HTTPConnection is in the correct state, returns an
instance of HTTPResponse or of whatever object is returned by
class the response_class variable.
If a request has not been sent or if a previous response has
not be handled, ResponseNotReady is raised. If the HTTP
response indicates that the connection should be closed, then
it will be closed before the response is returned. When the
connection is closed, the underlying socket is closed.
"""
# if a prior response has been completed, then forget about it.
if self.__response and self.__response.isclosed():
self.__response = None
# if a prior response exists, then it must be completed (otherwise, we
# cannot read this response's header to determine the connection-close
# behavior)
#
# note: if a prior response existed, but was connection-close, then the
# socket and response were made independent of this HTTPConnection
# object since a new request requires that we open a whole new
# connection
#
# this means the prior response had one of two states:
# 1) will_close: this connection was reset and the prior socket and
# response operate independently
# 2) persistent: the response was retained and we await its
# isclosed() status to become true.
#
if self.__state != _CS_REQ_SENT or self.__response:
raise ResponseNotReady(self.__state)
if self.debuglevel > 0:
response = self.response_class(self.sock, self.debuglevel,
method=self._method)
else:
response = self.response_class(self.sock, method=self._method)
response.begin()
assert response.will_close != _UNKNOWN
self.__state = _CS_IDLE
if response.will_close:
# this effectively passes the connection to the response
self.close()
else:
# remember this, so we can tell when it is complete
self.__response = response
return response
try:
import ssl
from ssl import SSLContext
except ImportError:
pass
else:
class HTTPSConnection(HTTPConnection):
"This class allows communication via SSL."
default_port = HTTPS_PORT
# XXX Should key_file and cert_file be deprecated in favour of context?
def __init__(self, host, port=None, key_file=None, cert_file=None,
strict=_strict_sentinel, timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
source_address=None, **_3to2kwargs):
if 'check_hostname' in _3to2kwargs: check_hostname = _3to2kwargs['check_hostname']; del _3to2kwargs['check_hostname']
else: check_hostname = None
if 'context' in _3to2kwargs: context = _3to2kwargs['context']; del _3to2kwargs['context']
else: context = None
super(HTTPSConnection, self).__init__(host, port, strict, timeout,
source_address)
self.key_file = key_file
self.cert_file = cert_file
if context is None:
# Some reasonable defaults
context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
context.options |= ssl.OP_NO_SSLv2
will_verify = context.verify_mode != ssl.CERT_NONE
if check_hostname is None:
check_hostname = will_verify
elif check_hostname and not will_verify:
raise ValueError("check_hostname needs a SSL context with "
"either CERT_OPTIONAL or CERT_REQUIRED")
if key_file or cert_file:
context.load_cert_chain(cert_file, key_file)
self._context = context
self._check_hostname = check_hostname
def connect(self):
"Connect to a host on a given (SSL) port."
sock = socket_create_connection((self.host, self.port),
self.timeout, self.source_address)
if self._tunnel_host:
self.sock = sock
self._tunnel()
server_hostname = self.host if ssl.HAS_SNI else None
self.sock = self._context.wrap_socket(sock,
server_hostname=server_hostname)
try:
if self._check_hostname:
ssl.match_hostname(self.sock.getpeercert(), self.host)
except Exception:
self.sock.shutdown(socket.SHUT_RDWR)
self.sock.close()
raise
__all__.append("HTTPSConnection")
# ######################################
# # We use the old HTTPSConnection class from Py2.7, because ssl.SSLContext
# # doesn't exist in the Py2.7 stdlib
# class HTTPSConnection(HTTPConnection):
# "This class allows communication via SSL."
# default_port = HTTPS_PORT
# def __init__(self, host, port=None, key_file=None, cert_file=None,
# strict=None, timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
# source_address=None):
# HTTPConnection.__init__(self, host, port, strict, timeout,
# source_address)
# self.key_file = key_file
# self.cert_file = cert_file
# def connect(self):
# "Connect to a host on a given (SSL) port."
# sock = socket_create_connection((self.host, self.port),
# self.timeout, self.source_address)
# if self._tunnel_host:
# self.sock = sock
# self._tunnel()
# self.sock = ssl.wrap_socket(sock, self.key_file, self.cert_file)
# __all__.append("HTTPSConnection")
# ######################################
class HTTPException(Exception):
# Subclasses that define an __init__ must call Exception.__init__
# or define self.args. Otherwise, str() will fail.
pass
class NotConnected(HTTPException):
pass
class InvalidURL(HTTPException):
pass
class UnknownProtocol(HTTPException):
def __init__(self, version):
self.args = version,
self.version = version
class UnknownTransferEncoding(HTTPException):
pass
class UnimplementedFileMode(HTTPException):
pass
class IncompleteRead(HTTPException):
def __init__(self, partial, expected=None):
self.args = partial,
self.partial = partial
self.expected = expected
def __repr__(self):
if self.expected is not None:
e = ', %i more expected' % self.expected
else:
e = ''
return 'IncompleteRead(%i bytes read%s)' % (len(self.partial), e)
def __str__(self):
return repr(self)
class ImproperConnectionState(HTTPException):
pass
class CannotSendRequest(ImproperConnectionState):
pass
class CannotSendHeader(ImproperConnectionState):
pass
class ResponseNotReady(ImproperConnectionState):
pass
class BadStatusLine(HTTPException):
def __init__(self, line):
if not line:
line = repr(line)
self.args = line,
self.line = line
class LineTooLong(HTTPException):
def __init__(self, line_type):
HTTPException.__init__(self, "got more than %d bytes when reading %s"
% (_MAXLINE, line_type))
# for backwards compatibility
error = HTTPException
PK �Cu\3�2�@+ @+ " future/backports/http/cookiejar.pynu �[��� r"""HTTP cookie handling for web clients.
This is a backport of the Py3.3 ``http.cookiejar`` module for
python-future.
This module has (now fairly distant) origins in Gisle Aas' Perl module
HTTP::Cookies, from the libwww-perl library.
Docstrings, comments and debug strings in this code refer to the
attributes of the HTTP cookie system as cookie-attributes, to distinguish
them clearly from Python attributes.
Class diagram (note that BSDDBCookieJar and the MSIE* classes are not
distributed with the Python standard library, but are available from
http://wwwsearch.sf.net/):
CookieJar____
/ \ \
FileCookieJar \ \
/ | \ \ \
MozillaCookieJar | LWPCookieJar \ \
| | \
| ---MSIEBase | \
| / | | \
| / MSIEDBCookieJar BSDDBCookieJar
|/
MSIECookieJar
"""
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
from future.builtins import filter, int, map, open, str
from future.utils import as_native_str, PY2
__all__ = ['Cookie', 'CookieJar', 'CookiePolicy', 'DefaultCookiePolicy',
'FileCookieJar', 'LWPCookieJar', 'LoadError', 'MozillaCookieJar']
import copy
import datetime
import re
if PY2:
re.ASCII = 0
import time
from future.backports.urllib.parse import urlparse, urlsplit, quote
from future.backports.http.client import HTTP_PORT
try:
import threading as _threading
except ImportError:
import dummy_threading as _threading
from calendar import timegm
debug = False # set to True to enable debugging via the logging module
logger = None
def _debug(*args):
if not debug:
return
global logger
if not logger:
import logging
logger = logging.getLogger("http.cookiejar")
return logger.debug(*args)
DEFAULT_HTTP_PORT = str(HTTP_PORT)
MISSING_FILENAME_TEXT = ("a filename was not supplied (nor was the CookieJar "
"instance initialised with one)")
def _warn_unhandled_exception():
# There are a few catch-all except: statements in this module, for
# catching input that's bad in unexpected ways. Warn if any
# exceptions are caught there.
import io, warnings, traceback
f = io.StringIO()
traceback.print_exc(None, f)
msg = f.getvalue()
warnings.warn("http.cookiejar bug!\n%s" % msg, stacklevel=2)
# Date/time conversion
# -----------------------------------------------------------------------------
EPOCH_YEAR = 1970
def _timegm(tt):
year, month, mday, hour, min, sec = tt[:6]
if ((year >= EPOCH_YEAR) and (1 <= month <= 12) and (1 <= mday <= 31) and
(0 <= hour <= 24) and (0 <= min <= 59) and (0 <= sec <= 61)):
return timegm(tt)
else:
return None
DAYS = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
MONTHS_LOWER = []
for month in MONTHS: MONTHS_LOWER.append(month.lower())
def time2isoz(t=None):
"""Return a string representing time in seconds since epoch, t.
If the function is called without an argument, it will use the current
time.
The format of the returned string is like "YYYY-MM-DD hh:mm:ssZ",
representing Universal Time (UTC, aka GMT). An example of this format is:
1994-11-24 08:49:37Z
"""
if t is None:
dt = datetime.datetime.utcnow()
else:
dt = datetime.datetime.utcfromtimestamp(t)
return "%04d-%02d-%02d %02d:%02d:%02dZ" % (
dt.year, dt.month, dt.day, dt.hour, dt.minute, dt.second)
def time2netscape(t=None):
"""Return a string representing time in seconds since epoch, t.
If the function is called without an argument, it will use the current
time.
The format of the returned string is like this:
Wed, DD-Mon-YYYY HH:MM:SS GMT
"""
if t is None:
dt = datetime.datetime.utcnow()
else:
dt = datetime.datetime.utcfromtimestamp(t)
return "%s %02d-%s-%04d %02d:%02d:%02d GMT" % (
DAYS[dt.weekday()], dt.day, MONTHS[dt.month-1],
dt.year, dt.hour, dt.minute, dt.second)
UTC_ZONES = {"GMT": None, "UTC": None, "UT": None, "Z": None}
TIMEZONE_RE = re.compile(r"^([-+])?(\d\d?):?(\d\d)?$", re.ASCII)
def offset_from_tz_string(tz):
offset = None
if tz in UTC_ZONES:
offset = 0
else:
m = TIMEZONE_RE.search(tz)
if m:
offset = 3600 * int(m.group(2))
if m.group(3):
offset = offset + 60 * int(m.group(3))
if m.group(1) == '-':
offset = -offset
return offset
def _str2time(day, mon, yr, hr, min, sec, tz):
# translate month name to number
# month numbers start with 1 (January)
try:
mon = MONTHS_LOWER.index(mon.lower())+1
except ValueError:
# maybe it's already a number
try:
imon = int(mon)
except ValueError:
return None
if 1 <= imon <= 12:
mon = imon
else:
return None
# make sure clock elements are defined
if hr is None: hr = 0
if min is None: min = 0
if sec is None: sec = 0
yr = int(yr)
day = int(day)
hr = int(hr)
min = int(min)
sec = int(sec)
if yr < 1000:
# find "obvious" year
cur_yr = time.localtime(time.time())[0]
m = cur_yr % 100
tmp = yr
yr = yr + cur_yr - m
m = m - tmp
if abs(m) > 50:
if m > 0: yr = yr + 100
else: yr = yr - 100
# convert UTC time tuple to seconds since epoch (not timezone-adjusted)
t = _timegm((yr, mon, day, hr, min, sec, tz))
if t is not None:
# adjust time using timezone string, to get absolute time since epoch
if tz is None:
tz = "UTC"
tz = tz.upper()
offset = offset_from_tz_string(tz)
if offset is None:
return None
t = t - offset
return t
STRICT_DATE_RE = re.compile(
r"^[SMTWF][a-z][a-z], (\d\d) ([JFMASOND][a-z][a-z]) "
"(\d\d\d\d) (\d\d):(\d\d):(\d\d) GMT$", re.ASCII)
WEEKDAY_RE = re.compile(
r"^(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)[a-z]*,?\s*", re.I | re.ASCII)
LOOSE_HTTP_DATE_RE = re.compile(
r"""^
(\d\d?) # day
(?:\s+|[-\/])
(\w+) # month
(?:\s+|[-\/])
(\d+) # year
(?:
(?:\s+|:) # separator before clock
(\d\d?):(\d\d) # hour:min
(?::(\d\d))? # optional seconds
)? # optional clock
\s*
(?:
([-+]?\d{2,4}|(?![APap][Mm]\b)[A-Za-z]+) # timezone
\s*
)?
(?:
\(\w+\) # ASCII representation of timezone in parens.
\s*
)?$""", re.X | re.ASCII)
def http2time(text):
"""Returns time in seconds since epoch of time represented by a string.
Return value is an integer.
None is returned if the format of str is unrecognized, the time is outside
the representable range, or the timezone string is not recognized. If the
string contains no timezone, UTC is assumed.
The timezone in the string may be numerical (like "-0800" or "+0100") or a
string timezone (like "UTC", "GMT", "BST" or "EST"). Currently, only the
timezone strings equivalent to UTC (zero offset) are known to the function.
The function loosely parses the following formats:
Wed, 09 Feb 1994 22:23:32 GMT -- HTTP format
Tuesday, 08-Feb-94 14:15:29 GMT -- old rfc850 HTTP format
Tuesday, 08-Feb-1994 14:15:29 GMT -- broken rfc850 HTTP format
09 Feb 1994 22:23:32 GMT -- HTTP format (no weekday)
08-Feb-94 14:15:29 GMT -- rfc850 format (no weekday)
08-Feb-1994 14:15:29 GMT -- broken rfc850 format (no weekday)
The parser ignores leading and trailing whitespace. The time may be
absent.
If the year is given with only 2 digits, the function will select the
century that makes the year closest to the current date.
"""
# fast exit for strictly conforming string
m = STRICT_DATE_RE.search(text)
if m:
g = m.groups()
mon = MONTHS_LOWER.index(g[1].lower()) + 1
tt = (int(g[2]), mon, int(g[0]),
int(g[3]), int(g[4]), float(g[5]))
return _timegm(tt)
# No, we need some messy parsing...
# clean up
text = text.lstrip()
text = WEEKDAY_RE.sub("", text, 1) # Useless weekday
# tz is time zone specifier string
day, mon, yr, hr, min, sec, tz = [None]*7
# loose regexp parse
m = LOOSE_HTTP_DATE_RE.search(text)
if m is not None:
day, mon, yr, hr, min, sec, tz = m.groups()
else:
return None # bad format
return _str2time(day, mon, yr, hr, min, sec, tz)
ISO_DATE_RE = re.compile(
"""^
(\d{4}) # year
[-\/]?
(\d\d?) # numerical month
[-\/]?
(\d\d?) # day
(?:
(?:\s+|[-:Tt]) # separator before clock
(\d\d?):?(\d\d) # hour:min
(?::?(\d\d(?:\.\d*)?))? # optional seconds (and fractional)
)? # optional clock
\s*
(?:
([-+]?\d\d?:?(:?\d\d)?
|Z|z) # timezone (Z is "zero meridian", i.e. GMT)
\s*
)?$""", re.X | re. ASCII)
def iso2time(text):
"""
As for http2time, but parses the ISO 8601 formats:
1994-02-03 14:15:29 -0100 -- ISO 8601 format
1994-02-03 14:15:29 -- zone is optional
1994-02-03 -- only date
1994-02-03T14:15:29 -- Use T as separator
19940203T141529Z -- ISO 8601 compact format
19940203 -- only date
"""
# clean up
text = text.lstrip()
# tz is time zone specifier string
day, mon, yr, hr, min, sec, tz = [None]*7
# loose regexp parse
m = ISO_DATE_RE.search(text)
if m is not None:
# XXX there's an extra bit of the timezone I'm ignoring here: is
# this the right thing to do?
yr, mon, day, hr, min, sec, tz, _ = m.groups()
else:
return None # bad format
return _str2time(day, mon, yr, hr, min, sec, tz)
# Header parsing
# -----------------------------------------------------------------------------
def unmatched(match):
"""Return unmatched part of re.Match object."""
start, end = match.span(0)
return match.string[:start]+match.string[end:]
HEADER_TOKEN_RE = re.compile(r"^\s*([^=\s;,]+)")
HEADER_QUOTED_VALUE_RE = re.compile(r"^\s*=\s*\"([^\"\\]*(?:\\.[^\"\\]*)*)\"")
HEADER_VALUE_RE = re.compile(r"^\s*=\s*([^\s;,]*)")
HEADER_ESCAPE_RE = re.compile(r"\\(.)")
def split_header_words(header_values):
r"""Parse header values into a list of lists containing key,value pairs.
The function knows how to deal with ",", ";" and "=" as well as quoted
values after "=". A list of space separated tokens are parsed as if they
were separated by ";".
If the header_values passed as argument contains multiple values, then they
are treated as if they were a single value separated by comma ",".
This means that this function is useful for parsing header fields that
follow this syntax (BNF as from the HTTP/1.1 specification, but we relax
the requirement for tokens).
headers = #header
header = (token | parameter) *( [";"] (token | parameter))
token = 1*<any CHAR except CTLs or separators>
separators = "(" | ")" | "<" | ">" | "@"
| "," | ";" | ":" | "\" | <">
| "/" | "[" | "]" | "?" | "="
| "{" | "}" | SP | HT
quoted-string = ( <"> *(qdtext | quoted-pair ) <"> )
qdtext = <any TEXT except <">>
quoted-pair = "\" CHAR
parameter = attribute "=" value
attribute = token
value = token | quoted-string
Each header is represented by a list of key/value pairs. The value for a
simple token (not part of a parameter) is None. Syntactically incorrect
headers will not necessarily be parsed as you would want.
This is easier to describe with some examples:
>>> split_header_words(['foo="bar"; port="80,81"; discard, bar=baz'])
[[('foo', 'bar'), ('port', '80,81'), ('discard', None)], [('bar', 'baz')]]
>>> split_header_words(['text/html; charset="iso-8859-1"'])
[[('text/html', None), ('charset', 'iso-8859-1')]]
>>> split_header_words([r'Basic realm="\"foo\bar\""'])
[[('Basic', None), ('realm', '"foobar"')]]
"""
assert not isinstance(header_values, str)
result = []
for text in header_values:
orig_text = text
pairs = []
while text:
m = HEADER_TOKEN_RE.search(text)
if m:
text = unmatched(m)
name = m.group(1)
m = HEADER_QUOTED_VALUE_RE.search(text)
if m: # quoted value
text = unmatched(m)
value = m.group(1)
value = HEADER_ESCAPE_RE.sub(r"\1", value)
else:
m = HEADER_VALUE_RE.search(text)
if m: # unquoted value
text = unmatched(m)
value = m.group(1)
value = value.rstrip()
else:
# no value, a lone token
value = None
pairs.append((name, value))
elif text.lstrip().startswith(","):
# concatenated headers, as per RFC 2616 section 4.2
text = text.lstrip()[1:]
if pairs: result.append(pairs)
pairs = []
else:
# skip junk
non_junk, nr_junk_chars = re.subn("^[=\s;]*", "", text)
assert nr_junk_chars > 0, (
"split_header_words bug: '%s', '%s', %s" %
(orig_text, text, pairs))
text = non_junk
if pairs: result.append(pairs)
return result
HEADER_JOIN_ESCAPE_RE = re.compile(r"([\"\\])")
def join_header_words(lists):
"""Do the inverse (almost) of the conversion done by split_header_words.
Takes a list of lists of (key, value) pairs and produces a single header
value. Attribute values are quoted if needed.
>>> join_header_words([[("text/plain", None), ("charset", "iso-8859/1")]])
'text/plain; charset="iso-8859/1"'
>>> join_header_words([[("text/plain", None)], [("charset", "iso-8859/1")]])
'text/plain, charset="iso-8859/1"'
"""
headers = []
for pairs in lists:
attr = []
for k, v in pairs:
if v is not None:
if not re.search(r"^\w+$", v):
v = HEADER_JOIN_ESCAPE_RE.sub(r"\\\1", v) # escape " and \
v = '"%s"' % v
k = "%s=%s" % (k, v)
attr.append(k)
if attr: headers.append("; ".join(attr))
return ", ".join(headers)
def strip_quotes(text):
if text.startswith('"'):
text = text[1:]
if text.endswith('"'):
text = text[:-1]
return text
def parse_ns_headers(ns_headers):
"""Ad-hoc parser for Netscape protocol cookie-attributes.
The old Netscape cookie format for Set-Cookie can for instance contain
an unquoted "," in the expires field, so we have to use this ad-hoc
parser instead of split_header_words.
XXX This may not make the best possible effort to parse all the crap
that Netscape Cookie headers contain. Ronald Tschalar's HTTPClient
parser is probably better, so could do worse than following that if
this ever gives any trouble.
Currently, this is also used for parsing RFC 2109 cookies.
"""
known_attrs = ("expires", "domain", "path", "secure",
# RFC 2109 attrs (may turn up in Netscape cookies, too)
"version", "port", "max-age")
result = []
for ns_header in ns_headers:
pairs = []
version_set = False
for ii, param in enumerate(re.split(r";\s*", ns_header)):
param = param.rstrip()
if param == "": continue
if "=" not in param:
k, v = param, None
else:
k, v = re.split(r"\s*=\s*", param, 1)
k = k.lstrip()
if ii != 0:
lc = k.lower()
if lc in known_attrs:
k = lc
if k == "version":
# This is an RFC 2109 cookie.
v = strip_quotes(v)
version_set = True
if k == "expires":
# convert expires date to seconds since epoch
v = http2time(strip_quotes(v)) # None if invalid
pairs.append((k, v))
if pairs:
if not version_set:
pairs.append(("version", "0"))
result.append(pairs)
return result
IPV4_RE = re.compile(r"\.\d+$", re.ASCII)
def is_HDN(text):
"""Return True if text is a host domain name."""
# XXX
# This may well be wrong. Which RFC is HDN defined in, if any (for
# the purposes of RFC 2965)?
# For the current implementation, what about IPv6? Remember to look
# at other uses of IPV4_RE also, if change this.
if IPV4_RE.search(text):
return False
if text == "":
return False
if text[0] == "." or text[-1] == ".":
return False
return True
def domain_match(A, B):
"""Return True if domain A domain-matches domain B, according to RFC 2965.
A and B may be host domain names or IP addresses.
RFC 2965, section 1:
Host names can be specified either as an IP address or a HDN string.
Sometimes we compare one host name with another. (Such comparisons SHALL
be case-insensitive.) Host A's name domain-matches host B's if
* their host name strings string-compare equal; or
* A is a HDN string and has the form NB, where N is a non-empty
name string, B has the form .B', and B' is a HDN string. (So,
x.y.com domain-matches .Y.com but not Y.com.)
Note that domain-match is not a commutative operation: a.b.c.com
domain-matches .c.com, but not the reverse.
"""
# Note that, if A or B are IP addresses, the only relevant part of the
# definition of the domain-match algorithm is the direct string-compare.
A = A.lower()
B = B.lower()
if A == B:
return True
if not is_HDN(A):
return False
i = A.rfind(B)
if i == -1 or i == 0:
# A does not have form NB, or N is the empty string
return False
if not B.startswith("."):
return False
if not is_HDN(B[1:]):
return False
return True
def liberal_is_HDN(text):
"""Return True if text is a sort-of-like a host domain name.
For accepting/blocking domains.
"""
if IPV4_RE.search(text):
return False
return True
def user_domain_match(A, B):
"""For blocking/accepting domains.
A and B may be host domain names or IP addresses.
"""
A = A.lower()
B = B.lower()
if not (liberal_is_HDN(A) and liberal_is_HDN(B)):
if A == B:
# equal IP addresses
return True
return False
initial_dot = B.startswith(".")
if initial_dot and A.endswith(B):
return True
if not initial_dot and A == B:
return True
return False
cut_port_re = re.compile(r":\d+$", re.ASCII)
def request_host(request):
"""Return request-host, as defined by RFC 2965.
Variation from RFC: returned value is lowercased, for convenient
comparison.
"""
url = request.get_full_url()
host = urlparse(url)[1]
if host == "":
host = request.get_header("Host", "")
# remove port, if present
host = cut_port_re.sub("", host, 1)
return host.lower()
def eff_request_host(request):
"""Return a tuple (request-host, effective request-host name).
As defined by RFC 2965, except both are lowercased.
"""
erhn = req_host = request_host(request)
if req_host.find(".") == -1 and not IPV4_RE.search(req_host):
erhn = req_host + ".local"
return req_host, erhn
def request_path(request):
"""Path component of request-URI, as defined by RFC 2965."""
url = request.get_full_url()
parts = urlsplit(url)
path = escape_path(parts.path)
if not path.startswith("/"):
# fix bad RFC 2396 absoluteURI
path = "/" + path
return path
def request_port(request):
host = request.host
i = host.find(':')
if i >= 0:
port = host[i+1:]
try:
int(port)
except ValueError:
_debug("nonnumeric port: '%s'", port)
return None
else:
port = DEFAULT_HTTP_PORT
return port
# Characters in addition to A-Z, a-z, 0-9, '_', '.', and '-' that don't
# need to be escaped to form a valid HTTP URL (RFCs 2396 and 1738).
HTTP_PATH_SAFE = "%/;:@&=+$,!~*'()"
ESCAPED_CHAR_RE = re.compile(r"%([0-9a-fA-F][0-9a-fA-F])")
def uppercase_escaped_char(match):
return "%%%s" % match.group(1).upper()
def escape_path(path):
"""Escape any invalid characters in HTTP URL, and uppercase all escapes."""
# There's no knowing what character encoding was used to create URLs
# containing %-escapes, but since we have to pick one to escape invalid
# path characters, we pick UTF-8, as recommended in the HTML 4.0
# specification:
# http://www.w3.org/TR/REC-html40/appendix/notes.html#h-B.2.1
# And here, kind of: draft-fielding-uri-rfc2396bis-03
# (And in draft IRI specification: draft-duerst-iri-05)
# (And here, for new URI schemes: RFC 2718)
path = quote(path, HTTP_PATH_SAFE)
path = ESCAPED_CHAR_RE.sub(uppercase_escaped_char, path)
return path
def reach(h):
"""Return reach of host h, as defined by RFC 2965, section 1.
The reach R of a host name H is defined as follows:
* If
- H is the host domain name of a host; and,
- H has the form A.B; and
- A has no embedded (that is, interior) dots; and
- B has at least one embedded dot, or B is the string "local".
then the reach of H is .B.
* Otherwise, the reach of H is H.
>>> reach("www.acme.com")
'.acme.com'
>>> reach("acme.com")
'acme.com'
>>> reach("acme.local")
'.local'
"""
i = h.find(".")
if i >= 0:
#a = h[:i] # this line is only here to show what a is
b = h[i+1:]
i = b.find(".")
if is_HDN(h) and (i >= 0 or b == "local"):
return "."+b
return h
def is_third_party(request):
"""
RFC 2965, section 3.3.6:
An unverifiable transaction is to a third-party host if its request-
host U does not domain-match the reach R of the request-host O in the
origin transaction.
"""
req_host = request_host(request)
if not domain_match(req_host, reach(request.get_origin_req_host())):
return True
else:
return False
class Cookie(object):
"""HTTP Cookie.
This class represents both Netscape and RFC 2965 cookies.
This is deliberately a very simple class. It just holds attributes. It's
possible to construct Cookie instances that don't comply with the cookie
standards. CookieJar.make_cookies is the factory function for Cookie
objects -- it deals with cookie parsing, supplying defaults, and
normalising to the representation used in this class. CookiePolicy is
responsible for checking them to see whether they should be accepted from
and returned to the server.
Note that the port may be present in the headers, but unspecified ("Port"
rather than"Port=80", for example); if this is the case, port is None.
"""
def __init__(self, version, name, value,
port, port_specified,
domain, domain_specified, domain_initial_dot,
path, path_specified,
secure,
expires,
discard,
comment,
comment_url,
rest,
rfc2109=False,
):
if version is not None: version = int(version)
if expires is not None: expires = int(expires)
if port is None and port_specified is True:
raise ValueError("if port is None, port_specified must be false")
self.version = version
self.name = name
self.value = value
self.port = port
self.port_specified = port_specified
# normalise case, as per RFC 2965 section 3.3.3
self.domain = domain.lower()
self.domain_specified = domain_specified
# Sigh. We need to know whether the domain given in the
# cookie-attribute had an initial dot, in order to follow RFC 2965
# (as clarified in draft errata). Needed for the returned $Domain
# value.
self.domain_initial_dot = domain_initial_dot
self.path = path
self.path_specified = path_specified
self.secure = secure
self.expires = expires
self.discard = discard
self.comment = comment
self.comment_url = comment_url
self.rfc2109 = rfc2109
self._rest = copy.copy(rest)
def has_nonstandard_attr(self, name):
return name in self._rest
def get_nonstandard_attr(self, name, default=None):
return self._rest.get(name, default)
def set_nonstandard_attr(self, name, value):
self._rest[name] = value
def is_expired(self, now=None):
if now is None: now = time.time()
if (self.expires is not None) and (self.expires <= now):
return True
return False
def __str__(self):
if self.port is None: p = ""
else: p = ":"+self.port
limit = self.domain + p + self.path
if self.value is not None:
namevalue = "%s=%s" % (self.name, self.value)
else:
namevalue = self.name
return "<Cookie %s for %s>" % (namevalue, limit)
@as_native_str()
def __repr__(self):
args = []
for name in ("version", "name", "value",
"port", "port_specified",
"domain", "domain_specified", "domain_initial_dot",
"path", "path_specified",
"secure", "expires", "discard", "comment", "comment_url",
):
attr = getattr(self, name)
### Python-Future:
# Avoid u'...' prefixes for unicode strings:
if isinstance(attr, str):
attr = str(attr)
###
args.append(str("%s=%s") % (name, repr(attr)))
args.append("rest=%s" % repr(self._rest))
args.append("rfc2109=%s" % repr(self.rfc2109))
return "Cookie(%s)" % ", ".join(args)
class CookiePolicy(object):
"""Defines which cookies get accepted from and returned to server.
May also modify cookies, though this is probably a bad idea.
The subclass DefaultCookiePolicy defines the standard rules for Netscape
and RFC 2965 cookies -- override that if you want a customised policy.
"""
def set_ok(self, cookie, request):
"""Return true if (and only if) cookie should be accepted from server.
Currently, pre-expired cookies never get this far -- the CookieJar
class deletes such cookies itself.
"""
raise NotImplementedError()
def return_ok(self, cookie, request):
"""Return true if (and only if) cookie should be returned to server."""
raise NotImplementedError()
def domain_return_ok(self, domain, request):
"""Return false if cookies should not be returned, given cookie domain.
"""
return True
def path_return_ok(self, path, request):
"""Return false if cookies should not be returned, given cookie path.
"""
return True
class DefaultCookiePolicy(CookiePolicy):
"""Implements the standard rules for accepting and returning cookies."""
DomainStrictNoDots = 1
DomainStrictNonDomain = 2
DomainRFC2965Match = 4
DomainLiberal = 0
DomainStrict = DomainStrictNoDots|DomainStrictNonDomain
def __init__(self,
blocked_domains=None, allowed_domains=None,
netscape=True, rfc2965=False,
rfc2109_as_netscape=None,
hide_cookie2=False,
strict_domain=False,
strict_rfc2965_unverifiable=True,
strict_ns_unverifiable=False,
strict_ns_domain=DomainLiberal,
strict_ns_set_initial_dollar=False,
strict_ns_set_path=False,
):
"""Constructor arguments should be passed as keyword arguments only."""
self.netscape = netscape
self.rfc2965 = rfc2965
self.rfc2109_as_netscape = rfc2109_as_netscape
self.hide_cookie2 = hide_cookie2
self.strict_domain = strict_domain
self.strict_rfc2965_unverifiable = strict_rfc2965_unverifiable
self.strict_ns_unverifiable = strict_ns_unverifiable
self.strict_ns_domain = strict_ns_domain
self.strict_ns_set_initial_dollar = strict_ns_set_initial_dollar
self.strict_ns_set_path = strict_ns_set_path
if blocked_domains is not None:
self._blocked_domains = tuple(blocked_domains)
else:
self._blocked_domains = ()
if allowed_domains is not None:
allowed_domains = tuple(allowed_domains)
self._allowed_domains = allowed_domains
def blocked_domains(self):
"""Return the sequence of blocked domains (as a tuple)."""
return self._blocked_domains
def set_blocked_domains(self, blocked_domains):
"""Set the sequence of blocked domains."""
self._blocked_domains = tuple(blocked_domains)
def is_blocked(self, domain):
for blocked_domain in self._blocked_domains:
if user_domain_match(domain, blocked_domain):
return True
return False
def allowed_domains(self):
"""Return None, or the sequence of allowed domains (as a tuple)."""
return self._allowed_domains
def set_allowed_domains(self, allowed_domains):
"""Set the sequence of allowed domains, or None."""
if allowed_domains is not None:
allowed_domains = tuple(allowed_domains)
self._allowed_domains = allowed_domains
def is_not_allowed(self, domain):
if self._allowed_domains is None:
return False
for allowed_domain in self._allowed_domains:
if user_domain_match(domain, allowed_domain):
return False
return True
def set_ok(self, cookie, request):
"""
If you override .set_ok(), be sure to call this method. If it returns
false, so should your subclass (assuming your subclass wants to be more
strict about which cookies to accept).
"""
_debug(" - checking cookie %s=%s", cookie.name, cookie.value)
assert cookie.name is not None
for n in "version", "verifiability", "name", "path", "domain", "port":
fn_name = "set_ok_"+n
fn = getattr(self, fn_name)
if not fn(cookie, request):
return False
return True
def set_ok_version(self, cookie, request):
if cookie.version is None:
# Version is always set to 0 by parse_ns_headers if it's a Netscape
# cookie, so this must be an invalid RFC 2965 cookie.
_debug(" Set-Cookie2 without version attribute (%s=%s)",
cookie.name, cookie.value)
return False
if cookie.version > 0 and not self.rfc2965:
_debug(" RFC 2965 cookies are switched off")
return False
elif cookie.version == 0 and not self.netscape:
_debug(" Netscape cookies are switched off")
return False
return True
def set_ok_verifiability(self, cookie, request):
if request.unverifiable and is_third_party(request):
if cookie.version > 0 and self.strict_rfc2965_unverifiable:
_debug(" third-party RFC 2965 cookie during "
"unverifiable transaction")
return False
elif cookie.version == 0 and self.strict_ns_unverifiable:
_debug(" third-party Netscape cookie during "
"unverifiable transaction")
return False
return True
def set_ok_name(self, cookie, request):
# Try and stop servers setting V0 cookies designed to hack other
# servers that know both V0 and V1 protocols.
if (cookie.version == 0 and self.strict_ns_set_initial_dollar and
cookie.name.startswith("$")):
_debug(" illegal name (starts with '$'): '%s'", cookie.name)
return False
return True
def set_ok_path(self, cookie, request):
if cookie.path_specified:
req_path = request_path(request)
if ((cookie.version > 0 or
(cookie.version == 0 and self.strict_ns_set_path)) and
not req_path.startswith(cookie.path)):
_debug(" path attribute %s is not a prefix of request "
"path %s", cookie.path, req_path)
return False
return True
def set_ok_domain(self, cookie, request):
if self.is_blocked(cookie.domain):
_debug(" domain %s is in user block-list", cookie.domain)
return False
if self.is_not_allowed(cookie.domain):
_debug(" domain %s is not in user allow-list", cookie.domain)
return False
if cookie.domain_specified:
req_host, erhn = eff_request_host(request)
domain = cookie.domain
if self.strict_domain and (domain.count(".") >= 2):
# XXX This should probably be compared with the Konqueror
# (kcookiejar.cpp) and Mozilla implementations, but it's a
# losing battle.
i = domain.rfind(".")
j = domain.rfind(".", 0, i)
if j == 0: # domain like .foo.bar
tld = domain[i+1:]
sld = domain[j+1:i]
if sld.lower() in ("co", "ac", "com", "edu", "org", "net",
"gov", "mil", "int", "aero", "biz", "cat", "coop",
"info", "jobs", "mobi", "museum", "name", "pro",
"travel", "eu") and len(tld) == 2:
# domain like .co.uk
_debug(" country-code second level domain %s", domain)
return False
if domain.startswith("."):
undotted_domain = domain[1:]
else:
undotted_domain = domain
embedded_dots = (undotted_domain.find(".") >= 0)
if not embedded_dots and domain != ".local":
_debug(" non-local domain %s contains no embedded dot",
domain)
return False
if cookie.version == 0:
if (not erhn.endswith(domain) and
(not erhn.startswith(".") and
not ("."+erhn).endswith(domain))):
_debug(" effective request-host %s (even with added "
"initial dot) does not end with %s",
erhn, domain)
return False
if (cookie.version > 0 or
(self.strict_ns_domain & self.DomainRFC2965Match)):
if not domain_match(erhn, domain):
_debug(" effective request-host %s does not domain-match "
"%s", erhn, domain)
return False
if (cookie.version > 0 or
(self.strict_ns_domain & self.DomainStrictNoDots)):
host_prefix = req_host[:-len(domain)]
if (host_prefix.find(".") >= 0 and
not IPV4_RE.search(req_host)):
_debug(" host prefix %s for domain %s contains a dot",
host_prefix, domain)
return False
return True
def set_ok_port(self, cookie, request):
if cookie.port_specified:
req_port = request_port(request)
if req_port is None:
req_port = "80"
else:
req_port = str(req_port)
for p in cookie.port.split(","):
try:
int(p)
except ValueError:
_debug(" bad port %s (not numeric)", p)
return False
if p == req_port:
break
else:
_debug(" request port (%s) not found in %s",
req_port, cookie.port)
return False
return True
def return_ok(self, cookie, request):
"""
If you override .return_ok(), be sure to call this method. If it
returns false, so should your subclass (assuming your subclass wants to
be more strict about which cookies to return).
"""
# Path has already been checked by .path_return_ok(), and domain
# blocking done by .domain_return_ok().
_debug(" - checking cookie %s=%s", cookie.name, cookie.value)
for n in "version", "verifiability", "secure", "expires", "port", "domain":
fn_name = "return_ok_"+n
fn = getattr(self, fn_name)
if not fn(cookie, request):
return False
return True
def return_ok_version(self, cookie, request):
if cookie.version > 0 and not self.rfc2965:
_debug(" RFC 2965 cookies are switched off")
return False
elif cookie.version == 0 and not self.netscape:
_debug(" Netscape cookies are switched off")
return False
return True
def return_ok_verifiability(self, cookie, request):
if request.unverifiable and is_third_party(request):
if cookie.version > 0 and self.strict_rfc2965_unverifiable:
_debug(" third-party RFC 2965 cookie during unverifiable "
"transaction")
return False
elif cookie.version == 0 and self.strict_ns_unverifiable:
_debug(" third-party Netscape cookie during unverifiable "
"transaction")
return False
return True
def return_ok_secure(self, cookie, request):
if cookie.secure and request.type != "https":
_debug(" secure cookie with non-secure request")
return False
return True
def return_ok_expires(self, cookie, request):
if cookie.is_expired(self._now):
_debug(" cookie expired")
return False
return True
def return_ok_port(self, cookie, request):
if cookie.port:
req_port = request_port(request)
if req_port is None:
req_port = "80"
for p in cookie.port.split(","):
if p == req_port:
break
else:
_debug(" request port %s does not match cookie port %s",
req_port, cookie.port)
return False
return True
def return_ok_domain(self, cookie, request):
req_host, erhn = eff_request_host(request)
domain = cookie.domain
# strict check of non-domain cookies: Mozilla does this, MSIE5 doesn't
if (cookie.version == 0 and
(self.strict_ns_domain & self.DomainStrictNonDomain) and
not cookie.domain_specified and domain != erhn):
_debug(" cookie with unspecified domain does not string-compare "
"equal to request domain")
return False
if cookie.version > 0 and not domain_match(erhn, domain):
_debug(" effective request-host name %s does not domain-match "
"RFC 2965 cookie domain %s", erhn, domain)
return False
if cookie.version == 0 and not ("."+erhn).endswith(domain):
_debug(" request-host %s does not match Netscape cookie domain "
"%s", req_host, domain)
return False
return True
def domain_return_ok(self, domain, request):
# Liberal check of. This is here as an optimization to avoid
# having to load lots of MSIE cookie files unless necessary.
req_host, erhn = eff_request_host(request)
if not req_host.startswith("."):
req_host = "."+req_host
if not erhn.startswith("."):
erhn = "."+erhn
if not (req_host.endswith(domain) or erhn.endswith(domain)):
#_debug(" request domain %s does not match cookie domain %s",
# req_host, domain)
return False
if self.is_blocked(domain):
_debug(" domain %s is in user block-list", domain)
return False
if self.is_not_allowed(domain):
_debug(" domain %s is not in user allow-list", domain)
return False
return True
def path_return_ok(self, path, request):
_debug("- checking cookie path=%s", path)
req_path = request_path(request)
if not req_path.startswith(path):
_debug(" %s does not path-match %s", req_path, path)
return False
return True
def vals_sorted_by_key(adict):
keys = sorted(adict.keys())
return map(adict.get, keys)
def deepvalues(mapping):
"""Iterates over nested mapping, depth-first, in sorted order by key."""
values = vals_sorted_by_key(mapping)
for obj in values:
mapping = False
try:
obj.items
except AttributeError:
pass
else:
mapping = True
for subobj in deepvalues(obj):
yield subobj
if not mapping:
yield obj
# Used as second parameter to dict.get() method, to distinguish absent
# dict key from one with a None value.
class Absent(object): pass
class CookieJar(object):
"""Collection of HTTP cookies.
You may not need to know about this class: try
urllib.request.build_opener(HTTPCookieProcessor).open(url).
"""
non_word_re = re.compile(r"\W")
quote_re = re.compile(r"([\"\\])")
strict_domain_re = re.compile(r"\.?[^.]*")
domain_re = re.compile(r"[^.]*")
dots_re = re.compile(r"^\.+")
magic_re = re.compile(r"^\#LWP-Cookies-(\d+\.\d+)", re.ASCII)
def __init__(self, policy=None):
if policy is None:
policy = DefaultCookiePolicy()
self._policy = policy
self._cookies_lock = _threading.RLock()
self._cookies = {}
def set_policy(self, policy):
self._policy = policy
def _cookies_for_domain(self, domain, request):
cookies = []
if not self._policy.domain_return_ok(domain, request):
return []
_debug("Checking %s for cookies to return", domain)
cookies_by_path = self._cookies[domain]
for path in cookies_by_path.keys():
if not self._policy.path_return_ok(path, request):
continue
cookies_by_name = cookies_by_path[path]
for cookie in cookies_by_name.values():
if not self._policy.return_ok(cookie, request):
_debug(" not returning cookie")
continue
_debug(" it's a match")
cookies.append(cookie)
return cookies
def _cookies_for_request(self, request):
"""Return a list of cookies to be returned to server."""
cookies = []
for domain in self._cookies.keys():
cookies.extend(self._cookies_for_domain(domain, request))
return cookies
def _cookie_attrs(self, cookies):
"""Return a list of cookie-attributes to be returned to server.
like ['foo="bar"; $Path="/"', ...]
The $Version attribute is also added when appropriate (currently only
once per request).
"""
# add cookies in order of most specific (ie. longest) path first
cookies.sort(key=lambda a: len(a.path), reverse=True)
version_set = False
attrs = []
for cookie in cookies:
# set version of Cookie header
# XXX
# What should it be if multiple matching Set-Cookie headers have
# different versions themselves?
# Answer: there is no answer; was supposed to be settled by
# RFC 2965 errata, but that may never appear...
version = cookie.version
if not version_set:
version_set = True
if version > 0:
attrs.append("$Version=%s" % version)
# quote cookie value if necessary
# (not for Netscape protocol, which already has any quotes
# intact, due to the poorly-specified Netscape Cookie: syntax)
if ((cookie.value is not None) and
self.non_word_re.search(cookie.value) and version > 0):
value = self.quote_re.sub(r"\\\1", cookie.value)
else:
value = cookie.value
# add cookie-attributes to be returned in Cookie header
if cookie.value is None:
attrs.append(cookie.name)
else:
attrs.append("%s=%s" % (cookie.name, value))
if version > 0:
if cookie.path_specified:
attrs.append('$Path="%s"' % cookie.path)
if cookie.domain.startswith("."):
domain = cookie.domain
if (not cookie.domain_initial_dot and
domain.startswith(".")):
domain = domain[1:]
attrs.append('$Domain="%s"' % domain)
if cookie.port is not None:
p = "$Port"
if cookie.port_specified:
p = p + ('="%s"' % cookie.port)
attrs.append(p)
return attrs
def add_cookie_header(self, request):
"""Add correct Cookie: header to request (urllib.request.Request object).
The Cookie2 header is also added unless policy.hide_cookie2 is true.
"""
_debug("add_cookie_header")
self._cookies_lock.acquire()
try:
self._policy._now = self._now = int(time.time())
cookies = self._cookies_for_request(request)
attrs = self._cookie_attrs(cookies)
if attrs:
if not request.has_header("Cookie"):
request.add_unredirected_header(
"Cookie", "; ".join(attrs))
# if necessary, advertise that we know RFC 2965
if (self._policy.rfc2965 and not self._policy.hide_cookie2 and
not request.has_header("Cookie2")):
for cookie in cookies:
if cookie.version != 1:
request.add_unredirected_header("Cookie2", '$Version="1"')
break
finally:
self._cookies_lock.release()
self.clear_expired_cookies()
def _normalized_cookie_tuples(self, attrs_set):
"""Return list of tuples containing normalised cookie information.
attrs_set is the list of lists of key,value pairs extracted from
the Set-Cookie or Set-Cookie2 headers.
Tuples are name, value, standard, rest, where name and value are the
cookie name and value, standard is a dictionary containing the standard
cookie-attributes (discard, secure, version, expires or max-age,
domain, path and port) and rest is a dictionary containing the rest of
the cookie-attributes.
"""
cookie_tuples = []
boolean_attrs = "discard", "secure"
value_attrs = ("version",
"expires", "max-age",
"domain", "path", "port",
"comment", "commenturl")
for cookie_attrs in attrs_set:
name, value = cookie_attrs[0]
# Build dictionary of standard cookie-attributes (standard) and
# dictionary of other cookie-attributes (rest).
# Note: expiry time is normalised to seconds since epoch. V0
# cookies should have the Expires cookie-attribute, and V1 cookies
# should have Max-Age, but since V1 includes RFC 2109 cookies (and
# since V0 cookies may be a mish-mash of Netscape and RFC 2109), we
# accept either (but prefer Max-Age).
max_age_set = False
bad_cookie = False
standard = {}
rest = {}
for k, v in cookie_attrs[1:]:
lc = k.lower()
# don't lose case distinction for unknown fields
if lc in value_attrs or lc in boolean_attrs:
k = lc
if k in boolean_attrs and v is None:
# boolean cookie-attribute is present, but has no value
# (like "discard", rather than "port=80")
v = True
if k in standard:
# only first value is significant
continue
if k == "domain":
if v is None:
_debug(" missing value for domain attribute")
bad_cookie = True
break
# RFC 2965 section 3.3.3
v = v.lower()
if k == "expires":
if max_age_set:
# Prefer max-age to expires (like Mozilla)
continue
if v is None:
_debug(" missing or invalid value for expires "
"attribute: treating as session cookie")
continue
if k == "max-age":
max_age_set = True
try:
v = int(v)
except ValueError:
_debug(" missing or invalid (non-numeric) value for "
"max-age attribute")
bad_cookie = True
break
# convert RFC 2965 Max-Age to seconds since epoch
# XXX Strictly you're supposed to follow RFC 2616
# age-calculation rules. Remember that zero Max-Age is a
# is a request to discard (old and new) cookie, though.
k = "expires"
v = self._now + v
if (k in value_attrs) or (k in boolean_attrs):
if (v is None and
k not in ("port", "comment", "commenturl")):
_debug(" missing value for %s attribute" % k)
bad_cookie = True
break
standard[k] = v
else:
rest[k] = v
if bad_cookie:
continue
cookie_tuples.append((name, value, standard, rest))
return cookie_tuples
def _cookie_from_cookie_tuple(self, tup, request):
# standard is dict of standard cookie-attributes, rest is dict of the
# rest of them
name, value, standard, rest = tup
domain = standard.get("domain", Absent)
path = standard.get("path", Absent)
port = standard.get("port", Absent)
expires = standard.get("expires", Absent)
# set the easy defaults
version = standard.get("version", None)
if version is not None:
try:
version = int(version)
except ValueError:
return None # invalid version, ignore cookie
secure = standard.get("secure", False)
# (discard is also set if expires is Absent)
discard = standard.get("discard", False)
comment = standard.get("comment", None)
comment_url = standard.get("commenturl", None)
# set default path
if path is not Absent and path != "":
path_specified = True
path = escape_path(path)
else:
path_specified = False
path = request_path(request)
i = path.rfind("/")
if i != -1:
if version == 0:
# Netscape spec parts company from reality here
path = path[:i]
else:
path = path[:i+1]
if len(path) == 0: path = "/"
# set default domain
domain_specified = domain is not Absent
# but first we have to remember whether it starts with a dot
domain_initial_dot = False
if domain_specified:
domain_initial_dot = bool(domain.startswith("."))
if domain is Absent:
req_host, erhn = eff_request_host(request)
domain = erhn
elif not domain.startswith("."):
domain = "."+domain
# set default port
port_specified = False
if port is not Absent:
if port is None:
# Port attr present, but has no value: default to request port.
# Cookie should then only be sent back on that port.
port = request_port(request)
else:
port_specified = True
port = re.sub(r"\s+", "", port)
else:
# No port attr present. Cookie can be sent back on any port.
port = None
# set default expires and discard
if expires is Absent:
expires = None
discard = True
elif expires <= self._now:
# Expiry date in past is request to delete cookie. This can't be
# in DefaultCookiePolicy, because can't delete cookies there.
try:
self.clear(domain, path, name)
except KeyError:
pass
_debug("Expiring cookie, domain='%s', path='%s', name='%s'",
domain, path, name)
return None
return Cookie(version,
name, value,
port, port_specified,
domain, domain_specified, domain_initial_dot,
path, path_specified,
secure,
expires,
discard,
comment,
comment_url,
rest)
def _cookies_from_attrs_set(self, attrs_set, request):
cookie_tuples = self._normalized_cookie_tuples(attrs_set)
cookies = []
for tup in cookie_tuples:
cookie = self._cookie_from_cookie_tuple(tup, request)
if cookie: cookies.append(cookie)
return cookies
def _process_rfc2109_cookies(self, cookies):
rfc2109_as_ns = getattr(self._policy, 'rfc2109_as_netscape', None)
if rfc2109_as_ns is None:
rfc2109_as_ns = not self._policy.rfc2965
for cookie in cookies:
if cookie.version == 1:
cookie.rfc2109 = True
if rfc2109_as_ns:
# treat 2109 cookies as Netscape cookies rather than
# as RFC2965 cookies
cookie.version = 0
def make_cookies(self, response, request):
"""Return sequence of Cookie objects extracted from response object."""
# get cookie-attributes for RFC 2965 and Netscape protocols
headers = response.info()
rfc2965_hdrs = headers.get_all("Set-Cookie2", [])
ns_hdrs = headers.get_all("Set-Cookie", [])
rfc2965 = self._policy.rfc2965
netscape = self._policy.netscape
if ((not rfc2965_hdrs and not ns_hdrs) or
(not ns_hdrs and not rfc2965) or
(not rfc2965_hdrs and not netscape) or
(not netscape and not rfc2965)):
return [] # no relevant cookie headers: quick exit
try:
cookies = self._cookies_from_attrs_set(
split_header_words(rfc2965_hdrs), request)
except Exception:
_warn_unhandled_exception()
cookies = []
if ns_hdrs and netscape:
try:
# RFC 2109 and Netscape cookies
ns_cookies = self._cookies_from_attrs_set(
parse_ns_headers(ns_hdrs), request)
except Exception:
_warn_unhandled_exception()
ns_cookies = []
self._process_rfc2109_cookies(ns_cookies)
# Look for Netscape cookies (from Set-Cookie headers) that match
# corresponding RFC 2965 cookies (from Set-Cookie2 headers).
# For each match, keep the RFC 2965 cookie and ignore the Netscape
# cookie (RFC 2965 section 9.1). Actually, RFC 2109 cookies are
# bundled in with the Netscape cookies for this purpose, which is
# reasonable behaviour.
if rfc2965:
lookup = {}
for cookie in cookies:
lookup[(cookie.domain, cookie.path, cookie.name)] = None
def no_matching_rfc2965(ns_cookie, lookup=lookup):
key = ns_cookie.domain, ns_cookie.path, ns_cookie.name
return key not in lookup
ns_cookies = filter(no_matching_rfc2965, ns_cookies)
if ns_cookies:
cookies.extend(ns_cookies)
return cookies
def set_cookie_if_ok(self, cookie, request):
"""Set a cookie if policy says it's OK to do so."""
self._cookies_lock.acquire()
try:
self._policy._now = self._now = int(time.time())
if self._policy.set_ok(cookie, request):
self.set_cookie(cookie)
finally:
self._cookies_lock.release()
def set_cookie(self, cookie):
"""Set a cookie, without checking whether or not it should be set."""
c = self._cookies
self._cookies_lock.acquire()
try:
if cookie.domain not in c: c[cookie.domain] = {}
c2 = c[cookie.domain]
if cookie.path not in c2: c2[cookie.path] = {}
c3 = c2[cookie.path]
c3[cookie.name] = cookie
finally:
self._cookies_lock.release()
def extract_cookies(self, response, request):
"""Extract cookies from response, where allowable given the request."""
_debug("extract_cookies: %s", response.info())
self._cookies_lock.acquire()
try:
self._policy._now = self._now = int(time.time())
for cookie in self.make_cookies(response, request):
if self._policy.set_ok(cookie, request):
_debug(" setting cookie: %s", cookie)
self.set_cookie(cookie)
finally:
self._cookies_lock.release()
def clear(self, domain=None, path=None, name=None):
"""Clear some cookies.
Invoking this method without arguments will clear all cookies. If
given a single argument, only cookies belonging to that domain will be
removed. If given two arguments, cookies belonging to the specified
path within that domain are removed. If given three arguments, then
the cookie with the specified name, path and domain is removed.
Raises KeyError if no matching cookie exists.
"""
if name is not None:
if (domain is None) or (path is None):
raise ValueError(
"domain and path must be given to remove a cookie by name")
del self._cookies[domain][path][name]
elif path is not None:
if domain is None:
raise ValueError(
"domain must be given to remove cookies by path")
del self._cookies[domain][path]
elif domain is not None:
del self._cookies[domain]
else:
self._cookies = {}
def clear_session_cookies(self):
"""Discard all session cookies.
Note that the .save() method won't save session cookies anyway, unless
you ask otherwise by passing a true ignore_discard argument.
"""
self._cookies_lock.acquire()
try:
for cookie in self:
if cookie.discard:
self.clear(cookie.domain, cookie.path, cookie.name)
finally:
self._cookies_lock.release()
def clear_expired_cookies(self):
"""Discard all expired cookies.
You probably don't need to call this method: expired cookies are never
sent back to the server (provided you're using DefaultCookiePolicy),
this method is called by CookieJar itself every so often, and the
.save() method won't save expired cookies anyway (unless you ask
otherwise by passing a true ignore_expires argument).
"""
self._cookies_lock.acquire()
try:
now = time.time()
for cookie in self:
if cookie.is_expired(now):
self.clear(cookie.domain, cookie.path, cookie.name)
finally:
self._cookies_lock.release()
def __iter__(self):
return deepvalues(self._cookies)
def __len__(self):
"""Return number of contained cookies."""
i = 0
for cookie in self: i = i + 1
return i
@as_native_str()
def __repr__(self):
r = []
for cookie in self: r.append(repr(cookie))
return "<%s[%s]>" % (self.__class__, ", ".join(r))
def __str__(self):
r = []
for cookie in self: r.append(str(cookie))
return "<%s[%s]>" % (self.__class__, ", ".join(r))
# derives from IOError for backwards-compatibility with Python 2.4.0
class LoadError(IOError): pass
class FileCookieJar(CookieJar):
"""CookieJar that can be loaded from and saved to a file."""
def __init__(self, filename=None, delayload=False, policy=None):
"""
Cookies are NOT loaded from the named file until either the .load() or
.revert() method is called.
"""
CookieJar.__init__(self, policy)
if filename is not None:
try:
filename+""
except:
raise ValueError("filename must be string-like")
self.filename = filename
self.delayload = bool(delayload)
def save(self, filename=None, ignore_discard=False, ignore_expires=False):
"""Save cookies to a file."""
raise NotImplementedError()
def load(self, filename=None, ignore_discard=False, ignore_expires=False):
"""Load cookies from a file."""
if filename is None:
if self.filename is not None: filename = self.filename
else: raise ValueError(MISSING_FILENAME_TEXT)
f = open(filename)
try:
self._really_load(f, filename, ignore_discard, ignore_expires)
finally:
f.close()
def revert(self, filename=None,
ignore_discard=False, ignore_expires=False):
"""Clear all cookies and reload cookies from a saved file.
Raises LoadError (or IOError) if reversion is not successful; the
object's state will not be altered if this happens.
"""
if filename is None:
if self.filename is not None: filename = self.filename
else: raise ValueError(MISSING_FILENAME_TEXT)
self._cookies_lock.acquire()
try:
old_state = copy.deepcopy(self._cookies)
self._cookies = {}
try:
self.load(filename, ignore_discard, ignore_expires)
except (LoadError, IOError):
self._cookies = old_state
raise
finally:
self._cookies_lock.release()
def lwp_cookie_str(cookie):
"""Return string representation of Cookie in an the LWP cookie file format.
Actually, the format is extended a bit -- see module docstring.
"""
h = [(cookie.name, cookie.value),
("path", cookie.path),
("domain", cookie.domain)]
if cookie.port is not None: h.append(("port", cookie.port))
if cookie.path_specified: h.append(("path_spec", None))
if cookie.port_specified: h.append(("port_spec", None))
if cookie.domain_initial_dot: h.append(("domain_dot", None))
if cookie.secure: h.append(("secure", None))
if cookie.expires: h.append(("expires",
time2isoz(float(cookie.expires))))
if cookie.discard: h.append(("discard", None))
if cookie.comment: h.append(("comment", cookie.comment))
if cookie.comment_url: h.append(("commenturl", cookie.comment_url))
keys = sorted(cookie._rest.keys())
for k in keys:
h.append((k, str(cookie._rest[k])))
h.append(("version", str(cookie.version)))
return join_header_words([h])
class LWPCookieJar(FileCookieJar):
"""
The LWPCookieJar saves a sequence of "Set-Cookie3" lines.
"Set-Cookie3" is the format used by the libwww-perl library, not known
to be compatible with any browser, but which is easy to read and
doesn't lose information about RFC 2965 cookies.
Additional methods
as_lwp_str(ignore_discard=True, ignore_expired=True)
"""
def as_lwp_str(self, ignore_discard=True, ignore_expires=True):
"""Return cookies as a string of "\\n"-separated "Set-Cookie3" headers.
ignore_discard and ignore_expires: see docstring for FileCookieJar.save
"""
now = time.time()
r = []
for cookie in self:
if not ignore_discard and cookie.discard:
continue
if not ignore_expires and cookie.is_expired(now):
continue
r.append("Set-Cookie3: %s" % lwp_cookie_str(cookie))
return "\n".join(r+[""])
def save(self, filename=None, ignore_discard=False, ignore_expires=False):
if filename is None:
if self.filename is not None: filename = self.filename
else: raise ValueError(MISSING_FILENAME_TEXT)
f = open(filename, "w")
try:
# There really isn't an LWP Cookies 2.0 format, but this indicates
# that there is extra information in here (domain_dot and
# port_spec) while still being compatible with libwww-perl, I hope.
f.write("#LWP-Cookies-2.0\n")
f.write(self.as_lwp_str(ignore_discard, ignore_expires))
finally:
f.close()
def _really_load(self, f, filename, ignore_discard, ignore_expires):
magic = f.readline()
if not self.magic_re.search(magic):
msg = ("%r does not look like a Set-Cookie3 (LWP) format "
"file" % filename)
raise LoadError(msg)
now = time.time()
header = "Set-Cookie3:"
boolean_attrs = ("port_spec", "path_spec", "domain_dot",
"secure", "discard")
value_attrs = ("version",
"port", "path", "domain",
"expires",
"comment", "commenturl")
try:
while 1:
line = f.readline()
if line == "": break
if not line.startswith(header):
continue
line = line[len(header):].strip()
for data in split_header_words([line]):
name, value = data[0]
standard = {}
rest = {}
for k in boolean_attrs:
standard[k] = False
for k, v in data[1:]:
if k is not None:
lc = k.lower()
else:
lc = None
# don't lose case distinction for unknown fields
if (lc in value_attrs) or (lc in boolean_attrs):
k = lc
if k in boolean_attrs:
if v is None: v = True
standard[k] = v
elif k in value_attrs:
standard[k] = v
else:
rest[k] = v
h = standard.get
expires = h("expires")
discard = h("discard")
if expires is not None:
expires = iso2time(expires)
if expires is None:
discard = True
domain = h("domain")
domain_specified = domain.startswith(".")
c = Cookie(h("version"), name, value,
h("port"), h("port_spec"),
domain, domain_specified, h("domain_dot"),
h("path"), h("path_spec"),
h("secure"),
expires,
discard,
h("comment"),
h("commenturl"),
rest)
if not ignore_discard and c.discard:
continue
if not ignore_expires and c.is_expired(now):
continue
self.set_cookie(c)
except IOError:
raise
except Exception:
_warn_unhandled_exception()
raise LoadError("invalid Set-Cookie3 format file %r: %r" %
(filename, line))
class MozillaCookieJar(FileCookieJar):
"""
WARNING: you may want to backup your browser's cookies file if you use
this class to save cookies. I *think* it works, but there have been
bugs in the past!
This class differs from CookieJar only in the format it uses to save and
load cookies to and from a file. This class uses the Mozilla/Netscape
`cookies.txt' format. lynx uses this file format, too.
Don't expect cookies saved while the browser is running to be noticed by
the browser (in fact, Mozilla on unix will overwrite your saved cookies if
you change them on disk while it's running; on Windows, you probably can't
save at all while the browser is running).
Note that the Mozilla/Netscape format will downgrade RFC2965 cookies to
Netscape cookies on saving.
In particular, the cookie version and port number information is lost,
together with information about whether or not Path, Port and Discard were
specified by the Set-Cookie2 (or Set-Cookie) header, and whether or not the
domain as set in the HTTP header started with a dot (yes, I'm aware some
domains in Netscape files start with a dot and some don't -- trust me, you
really don't want to know any more about this).
Note that though Mozilla and Netscape use the same format, they use
slightly different headers. The class saves cookies using the Netscape
header by default (Mozilla can cope with that).
"""
magic_re = re.compile("#( Netscape)? HTTP Cookie File")
header = """\
# Netscape HTTP Cookie File
# http://www.netscape.com/newsref/std/cookie_spec.html
# This is a generated file! Do not edit.
"""
def _really_load(self, f, filename, ignore_discard, ignore_expires):
now = time.time()
magic = f.readline()
if not self.magic_re.search(magic):
f.close()
raise LoadError(
"%r does not look like a Netscape format cookies file" %
filename)
try:
while 1:
line = f.readline()
if line == "": break
# last field may be absent, so keep any trailing tab
if line.endswith("\n"): line = line[:-1]
# skip comments and blank lines XXX what is $ for?
if (line.strip().startswith(("#", "$")) or
line.strip() == ""):
continue
domain, domain_specified, path, secure, expires, name, value = \
line.split("\t")
secure = (secure == "TRUE")
domain_specified = (domain_specified == "TRUE")
if name == "":
# cookies.txt regards 'Set-Cookie: foo' as a cookie
# with no name, whereas http.cookiejar regards it as a
# cookie with no value.
name = value
value = None
initial_dot = domain.startswith(".")
assert domain_specified == initial_dot
discard = False
if expires == "":
expires = None
discard = True
# assume path_specified is false
c = Cookie(0, name, value,
None, False,
domain, domain_specified, initial_dot,
path, False,
secure,
expires,
discard,
None,
None,
{})
if not ignore_discard and c.discard:
continue
if not ignore_expires and c.is_expired(now):
continue
self.set_cookie(c)
except IOError:
raise
except Exception:
_warn_unhandled_exception()
raise LoadError("invalid Netscape format cookies file %r: %r" %
(filename, line))
def save(self, filename=None, ignore_discard=False, ignore_expires=False):
if filename is None:
if self.filename is not None: filename = self.filename
else: raise ValueError(MISSING_FILENAME_TEXT)
f = open(filename, "w")
try:
f.write(self.header)
now = time.time()
for cookie in self:
if not ignore_discard and cookie.discard:
continue
if not ignore_expires and cookie.is_expired(now):
continue
if cookie.secure: secure = "TRUE"
else: secure = "FALSE"
if cookie.domain.startswith("."): initial_dot = "TRUE"
else: initial_dot = "FALSE"
if cookie.expires is not None:
expires = str(cookie.expires)
else:
expires = ""
if cookie.value is None:
# cookies.txt regards 'Set-Cookie: foo' as a cookie
# with no name, whereas http.cookiejar regards it as a
# cookie with no value.
name = ""
value = cookie.name
else:
name = cookie.name
value = cookie.value
f.write(
"\t".join([cookie.domain, initial_dot, cookie.path,
secure, expires, name, value])+
"\n")
finally:
f.close()
PK �Cu\ ! future/backports/http/__init__.pynu �[��� PK �Cu\af��z� z� : future/backports/http/__pycache__/cookiejar.cpython-39.pycnu �[��� a
��?h@+ � @ sn d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZm Z m
Z
m Z ddl m
Z
mZ g d�Zdd lZdd lZdd lZer�de_dd lZdd
lmZmZmZ dd lmZ z dd lZ W n e y� dd l Z Y n0 dd l m Z d
Z!d a"dd� Z#e e�Z$dZ%dd� Z&dZ'dd� Z(g d�Z)g d�Z*g Z+e*D ]Z,e+�-e,�.� � �q.dmdd�Z/dndd�Z0d d d d d �Z1e�2d ej�Z3d d � Z4d d!� Z5e�2d"ej�Z6e�2d#ej7ejB �Z8e�2d$ej9ejB �Z:d%d&� Z;e�2d'ej9ejB �Z<d(d)� Z=d*d+� Z>e�2d,�Z?e�2d-�Z@e�2d.�ZAe�2d/�ZBd0d1� ZCe�2d2�ZDd3d4� ZEd5d6� ZFd7d8� ZGe�2d9ej�ZHd:d;� ZId<d=� ZJd>d?� ZKd@dA� ZLe�2dBej�ZMdCdD� ZNdEdF� ZOdGdH� ZPdIdJ� ZQdKZRe�2dL�ZSdMdN� ZTdOdP� ZUdQdR� ZVdSdT� ZWG dUdV� dVeX�ZYG dWdX� dXeX�ZZG dYdZ� dZeZ�Z[d[d\� Z\d]d^� Z]G d_d`� d`eX�Z^G dadb� dbeX�Z_G dcdd� dde`�ZaG dedf� dfe_�Zbdgdh� ZcG didj� djeb�ZdG dkdl� dleb�Zed S )oa� HTTP cookie handling for web clients.
This is a backport of the Py3.3 ``http.cookiejar`` module for
python-future.
This module has (now fairly distant) origins in Gisle Aas' Perl module
HTTP::Cookies, from the libwww-perl library.
Docstrings, comments and debug strings in this code refer to the
attributes of the HTTP cookie system as cookie-attributes, to distinguish
them clearly from Python attributes.
Class diagram (note that BSDDBCookieJar and the MSIE* classes are not
distributed with the Python standard library, but are available from
http://wwwsearch.sf.net/):
CookieJar____
/ \ \
FileCookieJar \ \
/ | \ \ \
MozillaCookieJar | LWPCookieJar \ \
| | \
| ---MSIEBase | \
| / | | \
| / MSIEDBCookieJar BSDDBCookieJar
|/
MSIECookieJar
� )�unicode_literals)�print_function)�division)�absolute_import)�filter�int�map�open�str)�
as_native_str�PY2)�Cookie� CookieJar� CookiePolicy�DefaultCookiePolicy�
FileCookieJar� LWPCookieJar� LoadError�MozillaCookieJarN)�urlparse�urlsplit�quote)� HTTP_PORT)�timegmFc G s( t sd S ts dd l}|�d�atj | � S )Nr zhttp.cookiejar)�debug�logger�logging� getLogger)�argsr � r �I/usr/local/lib/python3.9/site-packages/future/backports/http/cookiejar.py�_debug: s
r! zQa filename was not supplied (nor was the CookieJar instance initialised with one)c C sJ dd l } dd l}dd l}| �� }|�d |� |�� }|jd| dd� d S )Nr zhttp.cookiejar bug!
%s� )�
stacklevel)�io�warnings� traceback�StringIO� print_exc�getvalue�warn)r$ r% r& �f�msgr r r �_warn_unhandled_exceptionH s
r- i� c C s� | d d� \}}}}}}|t kr�d| kr4dkr�n nhd| krLdkr�n nPd| krddkr�n n8d| kr|dkr�n n d| kr�dkr�n nt| �S d S d S ) N� � � � r � �; �= )�
EPOCH_YEARr )�tt�year�month�mday�hour�min�secr r r �_timegmW s 8��
��
��
r= )�Mon�Tue�Wed�Thu�Fri�Sat�Sun) �Jan�Feb�Mar�Apr�May�Jun�Jul�Aug�Sep�Oct�Nov�Decc C s@ | du rt j �� }n t j �| �}d|j|j|j|j|j|jf S )aH Return a string representing time in seconds since epoch, t.
If the function is called without an argument, it will use the current
time.
The format of the returned string is like "YYYY-MM-DD hh:mm:ssZ",
representing Universal Time (UTC, aka GMT). An example of this format is:
1994-11-24 08:49:37Z
Nz %04d-%02d-%02d %02d:%02d:%02dZ) �datetime�utcnow�utcfromtimestampr7 r8 �dayr: �minute�second��t�dtr r r � time2isoze s �rZ c C sR | du rt j �� }n t j �| �}dt|�� |jt|jd |j|j |j
|j f S )z�Return a string representing time in seconds since epoch, t.
If the function is called without an argument, it will use the current
time.
The format of the returned string is like this:
Wed, DD-Mon-YYYY HH:MM:SS GMT
Nz"%s %02d-%s-%04d %02d:%02d:%02d GMTr/ ) rQ rR rS �DAYS�weekdayrT �MONTHSr8 r7 r: rU rV rW r r r �
time2netscapex s �r^ )�GMT�UTC�UT�Zz^([-+])?(\d\d?):?(\d\d)?$c C sj d }| t v rd}nTt�| �}|rfdt|�d�� }|�d�rR|dt|�d�� }|�d�dkrf| }|S )Nr i r" � �< r/ �-)� UTC_ZONES� TIMEZONE_RE�searchr �group)�tz�offset�mr r r �offset_from_tz_string� s
rm c
C s| zt �|�� �d }W nZ typ z t|�}W n tyF Y Y d S 0 d| kr\dkrfn n|}nY d S Y n0 |d u r~d}|d u r�d}|d u r�d}t|�}t| �} t|�}t|�}t|�}|dk �r$t�t�� �d }|d } |}
|| | }| |
} t| �dk�r$| dk�r |d }n|d }t||| ||||f�} | d u�rx|d u �rRd}|� � }t
|�} | d u �rpd S | | } | S )Nr/ r0 r i� �d �2 r` ) � MONTHS_LOWER�index�lower�
ValueErrorr �time� localtime�absr= �upperrm )
rT �mon�yr�hrr; r< rj �imon�cur_yrrl �tmprX rk r r r � _str2time� sJ
r~ zV^[SMTWF][a-z][a-z], (\d\d) ([JFMASOND][a-z][a-z]) (\d\d\d\d) (\d\d):(\d\d):(\d\d) GMT$z+^(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)[a-z]*,?\s*a� ^
(\d\d?) # day
(?:\s+|[-\/])
(\w+) # month
(?:\s+|[-\/])
(\d+) # year
(?:
(?:\s+|:) # separator before clock
(\d\d?):(\d\d) # hour:min
(?::(\d\d))? # optional seconds
)? # optional clock
\s*
(?:
([-+]?\d{2,4}|(?![APap][Mm]\b)[A-Za-z]+) # timezone
\s*
)?
(?:
\(\w+\) # ASCII representation of timezone in parens.
\s*
)?$c C s� t �| �}|rl|�� }t�|d �� �d }t|d �|t|d �t|d �t|d �t|d �f}t|�S | � � } t
� d| d�} dgd \}}}}}} }
t �| �}|dur�|�� \}}}}}} }
ndS t
|||||| |
�S )
a� Returns time in seconds since epoch of time represented by a string.
Return value is an integer.
None is returned if the format of str is unrecognized, the time is outside
the representable range, or the timezone string is not recognized. If the
string contains no timezone, UTC is assumed.
The timezone in the string may be numerical (like "-0800" or "+0100") or a
string timezone (like "UTC", "GMT", "BST" or "EST"). Currently, only the
timezone strings equivalent to UTC (zero offset) are known to the function.
The function loosely parses the following formats:
Wed, 09 Feb 1994 22:23:32 GMT -- HTTP format
Tuesday, 08-Feb-94 14:15:29 GMT -- old rfc850 HTTP format
Tuesday, 08-Feb-1994 14:15:29 GMT -- broken rfc850 HTTP format
09 Feb 1994 22:23:32 GMT -- HTTP format (no weekday)
08-Feb-94 14:15:29 GMT -- rfc850 format (no weekday)
08-Feb-1994 14:15:29 GMT -- broken rfc850 format (no weekday)
The parser ignores leading and trailing whitespace. The time may be
absent.
If the year is given with only 2 digits, the function will select the
century that makes the year closest to the current date.
r/ r" r rc � � � N� )�STRICT_DATE_RErh �groupsrp rq rr r �floatr= �lstrip�
WEEKDAY_RE�sub�LOOSE_HTTP_DATE_REr~ ) �textrl �grx r6 rT ry rz r; r< rj r r r � http2time� s
�
r� a� ^
(\d{4}) # year
[-\/]?
(\d\d?) # numerical month
[-\/]?
(\d\d?) # day
(?:
(?:\s+|[-:Tt]) # separator before clock
(\d\d?):?(\d\d) # hour:min
(?::?(\d\d(?:\.\d*)?))? # optional seconds (and fractional)
)? # optional clock
\s*
(?:
([-+]?\d\d?:?(:?\d\d)?
|Z|z) # timezone (Z is "zero meridian", i.e. GMT)
\s*
)?$c
C sd | � � } dgd \}}}}}}}t�| �}|durL|�� \}}}}}}}} ndS t|||||||�S )av
As for http2time, but parses the ISO 8601 formats:
1994-02-03 14:15:29 -0100 -- ISO 8601 format
1994-02-03 14:15:29 -- zone is optional
1994-02-03 -- only date
1994-02-03T14:15:29 -- Use T as separator
19940203T141529Z -- ISO 8601 compact format
19940203 -- only date
Nr� )r� � ISO_DATE_RErh r� r~ )
r� rT rx ry rz r; r< rj rl �_r r r �iso2time6 s
r� c C s* | � d�\}}| jd|� | j|d� S )z)Return unmatched part of re.Match object.r N)�span�string)�match�start�endr r r � unmatchedW s r� z^\s*([^=\s;,]+)z&^\s*=\s*\"([^\"\\]*(?:\\.[^\"\\]*)*)\"z^\s*=\s*([^\s;,]*)z\\(.)c
C s0 t | t�rJ �g }| D �]}|}g }|�r t�|�}|r�t|�}|�d�}t�|�}|rxt|�}|�d�}t�d|�}n.t �|�}|r�t|�}|�d�}|�
� }nd}|� ||f� q$|� � �
d�r�|� � dd� }|r�|� |� g }q$t�dd|�\}} | dk�sJ d|||f ��|}q$|r|� |� q|S ) am Parse header values into a list of lists containing key,value pairs.
The function knows how to deal with ",", ";" and "=" as well as quoted
values after "=". A list of space separated tokens are parsed as if they
were separated by ";".
If the header_values passed as argument contains multiple values, then they
are treated as if they were a single value separated by comma ",".
This means that this function is useful for parsing header fields that
follow this syntax (BNF as from the HTTP/1.1 specification, but we relax
the requirement for tokens).
headers = #header
header = (token | parameter) *( [";"] (token | parameter))
token = 1*<any CHAR except CTLs or separators>
separators = "(" | ")" | "<" | ">" | "@"
| "," | ";" | ":" | "\" | <">
| "/" | "[" | "]" | "?" | "="
| "{" | "}" | SP | HT
quoted-string = ( <"> *(qdtext | quoted-pair ) <"> )
qdtext = <any TEXT except <">>
quoted-pair = "\" CHAR
parameter = attribute "=" value
attribute = token
value = token | quoted-string
Each header is represented by a list of key/value pairs. The value for a
simple token (not part of a parameter) is None. Syntactically incorrect
headers will not necessarily be parsed as you would want.
This is easier to describe with some examples:
>>> split_header_words(['foo="bar"; port="80,81"; discard, bar=baz'])
[[('foo', 'bar'), ('port', '80,81'), ('discard', None)], [('bar', 'baz')]]
>>> split_header_words(['text/html; charset="iso-8859-1"'])
[[('text/html', None), ('charset', 'iso-8859-1')]]
>>> split_header_words([r'Basic realm="\"foo\bar\""'])
[[('Basic', None), ('realm', '"foobar"')]]
r/ z\1N�,z^[=\s;]*r� r z&split_header_words bug: '%s', '%s', %s)�
isinstancer
�HEADER_TOKEN_RErh r� ri �HEADER_QUOTED_VALUE_RE�HEADER_ESCAPE_REr� �HEADER_VALUE_RE�rstrip�appendr� �
startswith�re�subn)
�
header_values�resultr� � orig_text�pairsrl �name�value�non_junk�
nr_junk_charsr r r �split_header_words` sF -
��r� �([\"\\])c C s| g }| D ]h}g }|D ]F\}}|durPt �d|�sDt�d|�}d| }d||f }|�|� q|r|�d�|�� qd�|�S )a� Do the inverse (almost) of the conversion done by split_header_words.
Takes a list of lists of (key, value) pairs and produces a single header
value. Attribute values are quoted if needed.
>>> join_header_words([[("text/plain", None), ("charset", "iso-8859/1")]])
'text/plain; charset="iso-8859/1"'
>>> join_header_words([[("text/plain", None)], [("charset", "iso-8859/1")]])
'text/plain, charset="iso-8859/1"'
Nz^\w+$�\\\1z"%s"�%s=%s�; �, )r� rh �HEADER_JOIN_ESCAPE_REr� r� �join)�lists�headersr� �attr�k�vr r r �join_header_words� s r� c C s0 | � d�r| dd � } | �d�r,| d d� } | S )N�"r/ ���)r� �endswith�r� r r r � strip_quotes� s
r� c C s� d}g }| D ]�}g }d}t t�d|��D ]�\}}|�� }|dkrBq(d|vrV|d }} nt�d|d�\}} |�� }|d kr�|�� }
|
|v r�|
}|d
kr�t| �} d }|d kr�tt| ��} |�|| f� q(|r |s�|�d
� |�|� q |S )a5 Ad-hoc parser for Netscape protocol cookie-attributes.
The old Netscape cookie format for Set-Cookie can for instance contain
an unquoted "," in the expires field, so we have to use this ad-hoc
parser instead of split_header_words.
XXX This may not make the best possible effort to parse all the crap
that Netscape Cookie headers contain. Ronald Tschalar's HTTPClient
parser is probably better, so could do worse than following that if
this ever gives any trouble.
Currently, this is also used for parsing RFC 2109 cookies.
)�expires�domain�path�secure�version�port�max-ageFz;\s*r� �=Nz\s*=\s*r/ r r� Tr� )r� �0) � enumerater� �splitr� r� rr r� r� r� ) �
ns_headers� known_attrsr� � ns_headerr� � version_set�ii�paramr� r� �lcr r r �parse_ns_headers� s6
r� z\.\d+$c C s: t �| �rdS | dkrdS | d dks2| d dkr6dS dS )z*Return True if text is a host domain name.Fr� r �.r� T��IPV4_RErh r� r r r �is_HDN s
r� c C sl | � � } |� � }| |kr dS t| �s(dS | �|�}|dksB|dkrFdS |�d�sTdS t|dd� �shdS dS )a� Return True if domain A domain-matches domain B, according to RFC 2965.
A and B may be host domain names or IP addresses.
RFC 2965, section 1:
Host names can be specified either as an IP address or a HDN string.
Sometimes we compare one host name with another. (Such comparisons SHALL
be case-insensitive.) Host A's name domain-matches host B's if
* their host name strings string-compare equal; or
* A is a HDN string and has the form NB, where N is a non-empty
name string, B has the form .B', and B' is a HDN string. (So,
x.y.com domain-matches .Y.com but not Y.com.)
Note that domain-match is not a commutative operation: a.b.c.com
domain-matches .c.com, but not the reverse.
TFr� r r� r/ N)rr r� �rfindr� )�A�B�ir r r � domain_match s
r� c C s t �| �rdS dS )zdReturn True if text is a sort-of-like a host domain name.
For accepting/blocking domains.
FTr� r� r r r �liberal_is_HDNA s
r� c C s` | � � } |� � }t| �r t|�s0| |kr,dS dS |�d�}|rL| �|�rLdS |s\| |kr\dS dS )z\For blocking/accepting domains.
A and B may be host domain names or IP addresses.
TFr� )rr r� r� r� )r� r� � initial_dotr r r �user_domain_matchK s
r� z:\d+$c C s> | � � }t|�d }|dkr(| �dd�}t�d|d�}|�� S )z�Return request-host, as defined by RFC 2965.
Variation from RFC: returned value is lowercased, for convenient
comparison.
r/ r� �Host)� get_full_urlr �
get_header� cut_port_rer� rr )�request�url�hostr r r � request_host` s r� c C s4 t | � }}|�d�dkr,t�|�s,|d }||fS )zzReturn a tuple (request-host, effective request-host name).
As defined by RFC 2965, except both are lowercased.
r� r� �.local)r� �findr� rh )r� �erhn�req_hostr r r �eff_request_hostp s r� c C s0 | � � }t|�}t|j�}|�d�s,d| }|S )z6Path component of request-URI, as defined by RFC 2965.�/)r� r � escape_pathr� r� )r� r� �partsr� r r r � request_path{ s
r� c C s^ | j }|�d�}|dkrV||d d � }z t|� W qZ tyR td|� Y d S 0 nt}|S )N�:r r/ znonnumeric port: '%s')r� r� r rs r! �DEFAULT_HTTP_PORT)r� r� r� r� r r r � request_port� s
r� z%/;:@&=+$,!~*'()z%([0-9a-fA-F][0-9a-fA-F])c C s d| � d��� S )Nz%%%sr/ )ri rw )r� r r r �uppercase_escaped_char� s r� c C s t | t�} t�t| �} | S )zEEscape any invalid characters in HTTP URL, and uppercase all escapes.)r �HTTP_PATH_SAFE�ESCAPED_CHAR_REr� r� )r� r r r r� � s
r� c C sP | � d�}|dkrL| |d d� }|� d�}t| �rL|dksD|dkrLd| S | S )aB Return reach of host h, as defined by RFC 2965, section 1.
The reach R of a host name H is defined as follows:
* If
- H is the host domain name of a host; and,
- H has the form A.B; and
- A has no embedded (that is, interior) dots; and
- B has at least one embedded dot, or B is the string "local".
then the reach of H is .B.
* Otherwise, the reach of H is H.
>>> reach("www.acme.com")
'.acme.com'
>>> reach("acme.com")
'acme.com'
>>> reach("acme.local")
'.local'
r� r r/ N�local)r� r� )�hr� �br r r �reach� s
r� c C s& t | �}t|t| �� ��s dS dS dS )z�
RFC 2965, section 3.3.6:
An unverifiable transaction is to a third-party host if its request-
host U does not domain-match the reach R of the request-host O in the
origin transaction.
TFN)r� r� r� �get_origin_req_host)r� r� r r r �is_third_party� s
r� c @ sT e Zd ZdZddd�Zdd� Zddd �Zd
d � Zdd d
�Zdd� Z e
� dd� �Z dS )r
a� HTTP Cookie.
This class represents both Netscape and RFC 2965 cookies.
This is deliberately a very simple class. It just holds attributes. It's
possible to construct Cookie instances that don't comply with the cookie
standards. CookieJar.make_cookies is the factory function for Cookie
objects -- it deals with cookie parsing, supplying defaults, and
normalising to the representation used in this class. CookiePolicy is
responsible for checking them to see whether they should be accepted from
and returned to the server.
Note that the port may be present in the headers, but unspecified ("Port"
rather than"Port=80", for example); if this is the case, port is None.
Fc C s� |d urt |�}| d ur t | �} |d u r8|du r8td��|| _|| _|| _|| _|| _|�� | _|| _ || _
| | _ |
| _ | | _
| | _|
| _|| _|| _|| _t�|�| _d S )NTz-if port is None, port_specified must be false)r rs r� r� r� r� �port_specifiedrr r� �domain_specified�domain_initial_dotr� �path_specifiedr� r� �discard�comment� comment_url�rfc2109�copy�_rest)�selfr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �restr� r r r �__init__� s*
zCookie.__init__c C s
|| j v S �N�r )r r� r r r �has_nonstandard_attr s zCookie.has_nonstandard_attrNc C s | j �||�S r )r �get)r r� �defaultr r r �get_nonstandard_attr s zCookie.get_nonstandard_attrc C s || j |< d S r r )r r� r� r r r �set_nonstandard_attr s zCookie.set_nonstandard_attrc C s, |d u rt � � }| jd ur(| j|kr(dS dS �NTF)rt r� )r �nowr r r �
is_expired s zCookie.is_expiredc C sX | j d u rd}n
d| j }| j| | j }| jd urFd| j| jf }n| j}d||f S )Nr� r� r� z<Cookie %s for %s>)r� r� r� r� r� )r �p�limit� namevaluer r r �__str__$ s
zCookie.__str__c C sz g }dD ]:}t | |�}t|t�r(t|�}|�td�|t|�f � q|�dt| j� � |�dt| j� � dd�|� S )N)r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� zrest=%sz
rfc2109=%sz
Cookie(%s)r� )�getattrr� r
r� �reprr r� r� )r r r� r� r r r �__repr__. s
zCookie.__repr__)F)N)N) �__name__�
__module__� __qualname__�__doc__r r r
r r r r r r r r r r
� s �
*
r
c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r a Defines which cookies get accepted from and returned to server.
May also modify cookies, though this is probably a bad idea.
The subclass DefaultCookiePolicy defines the standard rules for Netscape
and RFC 2965 cookies -- override that if you want a customised policy.
c C s
t � �dS )z�Return true if (and only if) cookie should be accepted from server.
Currently, pre-expired cookies never get this far -- the CookieJar
class deletes such cookies itself.
N��NotImplementedError�r �cookier� r r r �set_okL s zCookiePolicy.set_okc C s
t � �dS )zAReturn true if (and only if) cookie should be returned to server.Nr r r r r � return_okU s zCookiePolicy.return_okc C s dS )zMReturn false if cookies should not be returned, given cookie domain.
Tr )r r� r� r r r �domain_return_okY s z CookiePolicy.domain_return_okc C s dS )zKReturn false if cookies should not be returned, given cookie path.
Tr )r r� r� r r r �path_return_ok^ s zCookiePolicy.path_return_okN)r r r r r r r r! r r r r r C s
r c @ s� e Zd ZdZdZdZdZdZeeB Zdddddddddeddf d d
�Z d d � Z
d
d� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Z d1d2� Z d3d4� Z d5d6� Z dS )7r zBImplements the standard rules for accepting and returning cookies.r/ r" r r NTFc
C sp || _ || _|| _|| _|| _|| _| | _|
| _| | _| | _ |durPt
|�| _ nd| _ |durft
|�}|| _ dS )zAConstructor arguments should be passed as keyword arguments only.Nr )
�netscape�rfc2965�rfc2109_as_netscape� hide_cookie2�
strict_domain�strict_rfc2965_unverifiable�strict_ns_unverifiable�strict_ns_domain� strict_ns_set_initial_dollar�strict_ns_set_path�tuple�_blocked_domains�_allowed_domains)
r �blocked_domains�allowed_domainsr" r# r$ r% r& r' r( r) r* r+ r r r r n s
z DefaultCookiePolicy.__init__c C s | j S )z4Return the sequence of blocked domains (as a tuple).)r- �r r r r r/ � s z#DefaultCookiePolicy.blocked_domainsc C s t |�| _dS )z$Set the sequence of blocked domains.N)r, r- )r r/ r r r �set_blocked_domains� s z'DefaultCookiePolicy.set_blocked_domainsc C s | j D ]}t||�r dS qdS r )r- r� )r r� �blocked_domainr r r �
is_blocked� s
z DefaultCookiePolicy.is_blockedc C s | j S )z=Return None, or the sequence of allowed domains (as a tuple).)r. r1 r r r r0 � s z#DefaultCookiePolicy.allowed_domainsc C s |durt |�}|| _dS )z-Set the sequence of allowed domains, or None.N)r, r. )r r0 r r r �set_allowed_domains� s z'DefaultCookiePolicy.set_allowed_domainsc C s. | j d u rdS | j D ]}t||�r dS qdS )NFT)r. r� )r r� �allowed_domainr r r �is_not_allowed� s
z"DefaultCookiePolicy.is_not_allowedc C sN t d|j|j� |jdus J �dD ]&}d| }t| |�}|||�s" dS q"dS )z�
If you override .set_ok(), be sure to call this method. If it returns
false, so should your subclass (assuming your subclass wants to be more
strict about which cookies to accept).
� - checking cookie %s=%sN)r� �
verifiabilityr� r� r� r� �set_ok_FT�r! r� r� r �r r r� �n�fn_name�fnr r r r � s
zDefaultCookiePolicy.set_okc C sZ |j d u r td|j|j� dS |j dkr:| js:td� dS |j dkrV| jsVtd� dS dS )Nz0 Set-Cookie2 without version attribute (%s=%s)Fr �$ RFC 2965 cookies are switched off�$ Netscape cookies are switched offT)r� r! r� r� r# r" r r r r �set_ok_version� s
�z"DefaultCookiePolicy.set_ok_versionc C sJ |j rFt|�rF|jdkr*| jr*td� dS |jdkrF| jrFtd� dS dS �Nr z> third-party RFC 2965 cookie during unverifiable transactionFz> third-party Netscape cookie during unverifiable transactionT�� unverifiabler� r� r' r! r( r r r r �set_ok_verifiability� s z(DefaultCookiePolicy.set_ok_verifiabilityc C s0 |j dkr,| jr,|j�d�r,td|j� dS dS )Nr �$z' illegal name (starts with '$'): '%s'FT)r� r* r� r� r! r r r r � set_ok_name� s
� z DefaultCookiePolicy.set_ok_namec C sJ |j rFt|�}|jdks(|jdkrF| jrF|�|j�sFtd|j|� dS dS )Nr z7 path attribute %s is not a prefix of request path %sFT)r� r� r� r+ r� r� r! )r r r� �req_pathr r r � set_ok_path� s
��
��z DefaultCookiePolicy.set_ok_pathc
C s� | � |j�r td|j� dS | �|j�r8td|j� dS |j�r�t|�\}}|j}| jr�|�d�dkr�|�d�}|�dd|�}|dkr�||d d � }||d |� } | � � dv r�t
|�dkr�td |� dS |� d�r�|dd � }
n|}
|
� d�dk} | �s|d
k�rtd |� dS |j
dk�rX|�|��sX|� d��sXd| �|��sXtd ||� dS |j
dk�sr| j| j@ �r�t||��s�td
||� dS |j
dk�s�| j| j@ �r�|d t
|� � } | � d�dk�r�t�|��s�td| |� dS dS )N�" domain %s is in user block-listF�& domain %s is not in user allow-listr� r" r r/ )�co�ac�com�edu�org�net�gov�milr �aero�biz�cat�coop�info�jobs�mobi�museumr� �pro�travel�euz& country-code second level domain %sr� z/ non-local domain %s contains no embedded dotzO effective request-host %s (even with added initial dot) does not end with %sz5 effective request-host %s does not domain-match %sz. host prefix %s for domain %s contains a dotT)r4 r� r! r7 r� r� r& �countr� rr �lenr� r� r� r� r) �DomainRFC2965Matchr� �DomainStrictNoDotsr� rh )
r r r� r� r� r� r� �j�tld�sld�undotted_domain�
embedded_dots� host_prefixr r r �
set_ok_domain� sv
�
� � ��
� �
���z!DefaultCookiePolicy.set_ok_domainc C s� |j r�t|�}|d u r d}nt|�}|j�d�D ]>}z t|� W n ty` td|� Y dS 0 ||kr0 q�q0td||j� dS dS )N�80r� z bad port %s (not numeric)Fz$ request port (%s) not found in %sT)r� r� r
r� r� r rs r! �r r r� �req_portr r r r � set_ok_port* s$
�z DefaultCookiePolicy.set_ok_portc C s@ t d|j|j� dD ]&}d| }t| |�}|||�s dS qdS )z�
If you override .return_ok(), be sure to call this method. If it
returns false, so should your subclass (assuming your subclass wants to
be more strict about which cookies to return).
r8 )r� r9 r� r� r� r� �
return_ok_FTr; r< r r r r ? s
z DefaultCookiePolicy.return_okc C s< |j dkr | js td� dS |j dkr8| js8td� dS dS )Nr r@ FrA T)r� r# r! r" r r r r �return_ok_versionQ s z%DefaultCookiePolicy.return_ok_versionc C sJ |j rFt|�rF|jdkr*| jr*td� dS |jdkrF| jrFtd� dS dS rC rD r r r r �return_ok_verifiabilityZ s z+DefaultCookiePolicy.return_ok_verifiabilityc C s |j r |jdkr td� dS dS )N�httpsz( secure cookie with non-secure requestFT)r� �typer! r r r r �return_ok_securef s z$DefaultCookiePolicy.return_ok_securec C s |� | j�rtd� dS dS )Nz cookie expiredFT)r �_nowr! r r r r �return_ok_expiresl s z%DefaultCookiePolicy.return_ok_expiresc C sN |j rJt|�}|d u rd}|j �d�D ]}||kr& qJq&td||j � dS dS )Nrk r� z0 request port %s does not match cookie port %sFT)r� r� r� r! rl r r r �return_ok_portr s �z"DefaultCookiePolicy.return_ok_portc C s� t |�\}}|j}|jdkrB| j| j@ rB|jsB||krBtd� dS |jdkrft||�sftd||� dS |jdkr�d| �|�s�td||� dS dS )Nr zQ cookie with unspecified domain does not string-compare equal to request domainFzQ effective request-host name %s does not domain-match RFC 2965 cookie domain %sr� z; request-host %s does not match Netscape cookie domain %sT) r� r� r� r) �DomainStrictNonDomainr� r! r� r� )r r r� r� r� r� r r r �return_ok_domain� s,
�����z$DefaultCookiePolicy.return_ok_domainc C s| t |�\}}|�d�s d| }|�d�s0d| }|�|�sH|�|�sHdS | �|�r`td|� dS | �|�rxtd|� dS dS )Nr� FrK rL T)r� r� r� r4 r! r7 )r r� r� r� r� r r r r � s
z$DefaultCookiePolicy.domain_return_okc C s0 t d|� t|�}|�|�s,t d||� dS dS )Nz- checking cookie path=%sz %s does not path-match %sFT)r! r� r� )r r� r� rI r r r r! � s
z"DefaultCookiePolicy.path_return_ok) r r r r rc rx rb �
DomainLiberal� DomainStrictr r/ r2 r4 r0 r5 r7 r rB rF rH rJ rj rn r rp rq rt rv rw ry r r! r r r r r d sN �
! ; r c C s t | �� �}t| j|�S r )�sorted�keysr r )�adictr} r r r �vals_sorted_by_key� s r c c sZ t | �}|D ]H}d} z
|j W n ty0 Y n0 d} t|�D ]
}|V q>| s |V q dS )zBIterates over nested mapping, depth-first, in sorted order by key.FTN)r �items�AttributeError�
deepvalues)�mapping�values�objZsubobjr r r r� � s
r� c @ s e Zd ZdS )�AbsentN�r r r r r r r r� � � r� c @ s e Zd ZdZe�d�Ze�d�Ze�d�Ze�d�Z e�d�Z
e�dej �Z d3d d
�Z
d d � Zd
d� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd4d%d&�Zd'd(� Z d)d*� Z d+d,� Z d-d.� Z e � d/d0� �Z!d1d2� Z"dS )5r z�Collection of HTTP cookies.
You may not need to know about this class: try
urllib.request.build_opener(HTTPCookieProcessor).open(url).
z\Wr� z\.?[^.]*z[^.]*z^\.+z^\#LWP-Cookies-(\d+\.\d+)Nc C s( |d u rt � }|| _t�� | _i | _d S r )r �_policy�
_threading�RLock�
_cookies_lock�_cookies�r �policyr r r r � s
zCookieJar.__init__c C s
|| _ d S r )r� r� r r r �
set_policy� s zCookieJar.set_policyc C s� g }| j �||�sg S td|� | j| }|�� D ]T}| j �||�sFq2|| }|�� D ].}| j �||�srtd� qVtd� |�|� qVq2|S )Nz!Checking %s for cookies to returnz not returning cookiez it's a match) r� r r! r� r} r! r� r r� )r r� r� �cookies�cookies_by_pathr� �cookies_by_namer r r r �_cookies_for_domain� s
z CookieJar._cookies_for_domainc C s* g }| j �� D ]}|�| �||�� q|S )z2Return a list of cookies to be returned to server.)r� r} �extendr� )r r� r� r� r r r �_cookies_for_request� s z CookieJar._cookies_for_requestc C s< |j dd� dd� d}g }|D �]}|j}|sHd}|dkrH|�d| � |jdurz| j�|j�rz|dkrz| j�d |j�}n|j}|jdu r�|�|j� n|�d
|j|f � |dkr |j r�|�d |j
� |j � d ��r|j }|j
s�|� d �r�|d
d� }|�d| � |jdur d}|j�r,|d|j }|�|� q |S )z�Return a list of cookie-attributes to be returned to server.
like ['foo="bar"; $Path="/"', ...]
The $Version attribute is also added when appropriate (currently only
once per request).
c S s
t | j�S r )ra r� )�ar r r �<lambda> r� z)CookieJar._cookie_attrs.<locals>.<lambda>T)�key�reverseFr z $Version=%sNr� r� z
$Path="%s"r� r/ z $Domain="%s"z$Portz="%s")�sortr� r� r� � non_word_rerh �quote_rer� r� r� r� r� r� r� r� r� ) r r� r� �attrsr r� r� r� r r r r �
_cookie_attrs sF
��
�
zCookieJar._cookie_attrsc C s� t d� | j�� z�tt�� � | j_| _| �|�}| �|�}|r^|� d�s^|�
dd� |�� | jj r�| jj
s�|� d�s�|D ] }|jdkr||�
dd� q�q|W | j�� n | j�� 0 | �� dS )z�Add correct Cookie: header to request (urllib.request.Request object).
The Cookie2 header is also added unless policy.hide_cookie2 is true.
�add_cookie_headerr
r� �Cookie2r/ z $Version="1"N)r! r� �acquirer rt r� ru r� r� �
has_header�add_unredirected_headerr� r# r% r� �release�clear_expired_cookies)r r� r� r� r r r r r� < s(
��
zCookieJar.add_cookie_headerc
C s� g }d}d}|D �]x}|d \}}d}d} i }
i } |dd� D �].\} }
| � � }||v s`||v rd|} | |v rx|
du rxd}
| |
v r�q>| dkr�|
du r�td � d} �qp|
� � }
| d
kr�|r�q>|
du r�td � q>| d k�r d}z t|
�}
W n( t�y td
� d} Y �qpY n0 d
} | j|
}
| |v �s2| |v �rf|
du �r\| dv�r\td| � d} �qp|
|
| < q>|
| | < q>| �rxq|�|||
| f� q|S )a Return list of tuples containing normalised cookie information.
attrs_set is the list of lists of key,value pairs extracted from
the Set-Cookie or Set-Cookie2 headers.
Tuples are name, value, standard, rest, where name and value are the
cookie name and value, standard is a dictionary containing the standard
cookie-attributes (discard, secure, version, expires or max-age,
domain, path and port) and rest is a dictionary containing the rest of
the cookie-attributes.
)r� r� )r� r� r� r� r� r� r� �
commenturlr Fr/ NTr� z% missing value for domain attributer� zM missing or invalid value for expires attribute: treating as session cookier� z? missing or invalid (non-numeric) value for max-age attribute)r� r� r� z! missing value for %s attribute)rr r! r rs ru r� )r � attrs_set�
cookie_tuples�
boolean_attrs� value_attrs� cookie_attrsr� r� � max_age_set�
bad_cookie�standardr r� r� r� r r r �_normalized_cookie_tuples] sh
�
z#CookieJar._normalized_cookie_tuplesc C s" |\}}}}|� dt�}|� dt�}|� dt�} |� dt�}
|� dd �} | d urrz t| �} W n typ Y d S 0 |� dd�} |� dd�}
|� d d �}|� d
d �}|tur�|d kr�d }t|�}nXd}t|�}|�d
�}|dk�r| dkr�|d |� }n|d |d � }t|�dk�rd
}|tu}d}|�r8t|� d��}|tu �rTt
|�\}}|}n|� d��shd| }d}| tu�r�| d u �r�t |�} nd }t �
dd | �} nd } |
tu �r�d }
d }
nF|
| jk�r�z| �|||� W n t�y� Y n0 td|||� d S t| ||| ||||||| |
|
|||�S )Nr� r� r� r� r� r� Fr� r� r� r� Tr� r� r r/ r� z\s+z2Expiring cookie, domain='%s', path='%s', name='%s')r r� r rs r� r� r� ra �boolr� r� r� r� r� ru �clear�KeyErrorr! r
)r �tupr� r� r� r� r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r �_cookie_from_cookie_tuple� s�
��z#CookieJar._cookie_from_cookie_tuplec C s6 | � |�}g }|D ] }| �||�}|r|�|� q|S r )r� r� r� )r r� r� r� r� r� r r r r �_cookies_from_attrs_set s
z!CookieJar._cookies_from_attrs_setc C sH t | jdd �}|d u r | jj }|D ] }|jdkr$d|_|r$d|_q$d S )Nr$ r/ Tr )r r� r# r� r� )r r� �
rfc2109_as_nsr r r r �_process_rfc2109_cookies# s
z"CookieJar._process_rfc2109_cookiesc
C s |� � }|�dg �}|�dg �}| jj}| jj}|s8|rP|s@|rP|sH|rP|sT|sTg S z| �t|�|�}W n ty� t� g }Y n0 |�r |�r z| �t |�|�} W n ty� t� g } Y n0 | �
| � |�r i }
|D ]} d|
| j | j | j
f< q�|
fdd�} t| | �} | �r |�| � |S )zAReturn sequence of Cookie objects extracted from response object.z Set-Cookie2z
Set-CookieNc S s | j | j| jf}||vS r )r� r� r� )� ns_cookie�lookupr� r r r �no_matching_rfc2965[ s z3CookieJar.make_cookies.<locals>.no_matching_rfc2965)rY �get_allr� r# r" r� r� � Exceptionr- r� r� r� r� r� r r� )
r �responser� r� � rfc2965_hdrs�ns_hdrsr# r" r� �
ns_cookiesr� r r� r r r � make_cookies/ sX �������
�
zCookieJar.make_cookiesc C sX | j �� z<tt�� � | j_| _| j�||�r:| �|� W | j �� n | j �� 0 dS )z-Set a cookie if policy says it's OK to do so.N) r� r� r rt r� ru r �
set_cookier� r r r r �set_cookie_if_oke s
zCookieJar.set_cookie_if_okc C sv | j }| j�� zT|j|vr&i ||j< ||j }|j|vrDi ||j< ||j }|||j< W | j�� n | j�� 0 dS )z?Set a cookie, without checking whether or not it should be set.N)r� r� r� r� r� r� r� )r r �c�c2�c3r r r r� r s
zCookieJar.set_cookiec C s� t d|�� � | j�� zXtt�� � | j_| _| �||�D ]&}| j� ||�r<t d|� | �
|� q<W | j� � n | j� � 0 dS )zAExtract cookies from response, where allowable given the request.zextract_cookies: %sz setting cookie: %sN) r! rY r� r� r rt r� ru r� r r� r� )r r� r� r r r r �extract_cookies s
zCookieJar.extract_cookiesc C st |dur2|du s|du r t d��| j| | |= n>|durX|du rJt d��| j| |= n|durj| j|= ni | _dS )a� Clear some cookies.
Invoking this method without arguments will clear all cookies. If
given a single argument, only cookies belonging to that domain will be
removed. If given two arguments, cookies belonging to the specified
path within that domain are removed. If given three arguments, then
the cookie with the specified name, path and domain is removed.
Raises KeyError if no matching cookie exists.
Nz8domain and path must be given to remove a cookie by namez.domain must be given to remove cookies by path)rs r� )r r� r� r� r r r r� � s ��
zCookieJar.clearc C sN | j �� z2| D ] }|jr| �|j|j|j� qW | j �� n | j �� 0 dS )z�Discard all session cookies.
Note that the .save() method won't save session cookies anyway, unless
you ask otherwise by passing a true ignore_discard argument.
N)r� r� r� r� r� r� r� r� )r r r r r �clear_session_cookies� s
z CookieJar.clear_session_cookiesc C sZ | j �� z>t�� }| D ]"}|�|�r| �|j|j|j� qW | j �� n | j �� 0 dS )a� Discard all expired cookies.
You probably don't need to call this method: expired cookies are never
sent back to the server (provided you're using DefaultCookiePolicy),
this method is called by CookieJar itself every so often, and the
.save() method won't save expired cookies anyway (unless you ask
otherwise by passing a true ignore_expires argument).
N) r� r� rt r r� r� r� r� r� )r r
r r r r r� � s
z CookieJar.clear_expired_cookiesc C s
t | j�S r )r� r� r1 r r r �__iter__� s zCookieJar.__iter__c C s d}| D ] }|d }q|S )z#Return number of contained cookies.r r/ r )r r� r r r r �__len__� s zCookieJar.__len__c C s0 g }| D ]}|� t|�� qd| jd�|�f S �Nz<%s[%s]>r� )r� r � __class__r� �r �rr r r r r � s zCookieJar.__repr__c C s0 g }| D ]}|� t|�� qd| jd�|�f S r� )r� r
r� r� r� r r r r � s zCookieJar.__str__)N)NNN)#r r r r r� �compiler� r� �strict_domain_re� domain_re�dots_re�ASCII�magic_rer r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r � s:
;!a\ 6
r c @ s e Zd ZdS )r Nr� r r r r r � r� r c @ s8 e Zd ZdZd dd�Zd
dd�Zddd �Zdd
d �ZdS )r z6CookieJar that can be loaded from and saved to a file.NFc C sJ t �| |� |dur6z |d W n td��Y n0 || _t|�| _dS )z}
Cookies are NOT loaded from the named file until either the .load() or
.revert() method is called.
Nr� z filename must be string-like)r r rs �filenamer� � delayload)r r� r� r� r r r r � s zFileCookieJar.__init__c C s
t � �dS )zSave cookies to a file.Nr )r r� �ignore_discard�ignore_expiresr r r �save� s zFileCookieJar.savec C sV |du r"| j dur| j }ntt��t|�}z | �||||� W |�� n
|�� 0 dS )zLoad cookies from a file.N)r� rs �MISSING_FILENAME_TEXTr � _really_load�close�r r� r� r� r+ r r r �load� s zFileCookieJar.loadc C s� |du r"| j dur| j }ntt��| j�� zRt�| j�}i | _z| �|||� W n t t
fyp || _� Y n0 W | j� � n | j� � 0 dS )z�Clear all cookies and reload cookies from a saved file.
Raises LoadError (or IOError) if reversion is not successful; the
object's state will not be altered if this happens.
N) r� rs r� r� r� r �deepcopyr� r� r �IOErrorr� )r r� r� r� � old_stater r r �revert s
zFileCookieJar.revert)NFN)NFF)NFF)NFF)r r r r r r� r� r� r r r r r � s
�r c C s | j | jfd| jfd| jfg}| jdur8|�d| jf� | jrH|�d� | jrX|�d� | jrh|�d� | j rx|�d� | j
r�|�d t t | j
��f� | j
r�|�d
� | jr�|�d | jf� | jr�|�d | jf� t| j�� �}|D ] }|�|t| j| �f� q�|�d
t| j�f� t|g�S )z�Return string representation of Cookie in an the LWP cookie file format.
Actually, the format is extended a bit -- see module docstring.
r� r� Nr� )� path_specN)� port_specN)�
domain_dotN)r� Nr� )r� Nr� r� r� )r� r� r� r� r� r� r� r� r� r� r� rZ r� r� r� r� r| r r} r
r� r� )r r� r} r� r r r �lwp_cookie_str s(
� �r� c @ s, e Zd ZdZd dd�Zd dd�Zd d
� ZdS )
r a[
The LWPCookieJar saves a sequence of "Set-Cookie3" lines.
"Set-Cookie3" is the format used by the libwww-perl library, not known
to be compatible with any browser, but which is easy to read and
doesn't lose information about RFC 2965 cookies.
Additional methods
as_lwp_str(ignore_discard=True, ignore_expired=True)
Tc C sT t � � }g }| D ]2}|s |jr q|s0|�|�r0q|�dt|� � qd�|dg �S )z�Return cookies as a string of "\n"-separated "Set-Cookie3" headers.
ignore_discard and ignore_expires: see docstring for FileCookieJar.save
zSet-Cookie3: %s�
r� )rt r� r r� r� r� )r r� r� r
r� r r r r �
as_lwp_strH s
zLWPCookieJar.as_lwp_strNFc C sd |d u r"| j d ur| j }ntt��t|d�}z(|�d� |�| �||�� W |�� n
|�� 0 d S )N�wz#LWP-Cookies-2.0
)r� rs r� r �writer� r� r� r r r r� X s
zLWPCookieJar.savec C s, |� � }| j�|�s$d| }t|��t�� }d}d} d}
�z�|� � } | dkrP�q�| �|�s\q<| t|�d � �� } t| g�D �]f} | d \}
}i }i }| D ] }d||< q�| dd � D ]n\}}|d ur�|� � }nd }||
v s�|| v r�|}|| v �r|d u r�d }|||< q�||
v �r|||< q�|||< q�|j
}|d
�}|d �}|d u�rJt |�}|d u �rXd }|d �}|�d
�}t |d�|
||d�|d�|||d�|d�|d�|d�|||d�|d�|�}|�s�|j
�r�qz|�s�|�|��r�qz| �|� qzq<W n> t�y� � Y n* t�y& t� td|| f ��Y n0 d S )Nz5%r does not look like a Set-Cookie3 (LWP) format filez Set-Cookie3:)r� r� r� r� r� )r� r� r� r� r� r� r� r� r Fr/ Tr� r� r� r� r� r� r� r� r� r� r� r� r� z&invalid Set-Cookie3 format file %r: %r)�readliner� rh r rt r� ra �stripr� rr r r� r
r� r r� r� r� r- )r r+ r� r� r� �magicr, r
�headerr� r� �line�datar� r� r� r r� r� r� r� r� r� r� r� r� r r r r� g s� �
�
�zLWPCookieJar._really_load)TT)NFF)r r r r r� r� r� r r r r r ; s
r c @ s0 e Zd ZdZe�d�ZdZdd� Zd
dd �Z dS ) r a�
WARNING: you may want to backup your browser's cookies file if you use
this class to save cookies. I *think* it works, but there have been
bugs in the past!
This class differs from CookieJar only in the format it uses to save and
load cookies to and from a file. This class uses the Mozilla/Netscape
`cookies.txt' format. lynx uses this file format, too.
Don't expect cookies saved while the browser is running to be noticed by
the browser (in fact, Mozilla on unix will overwrite your saved cookies if
you change them on disk while it's running; on Windows, you probably can't
save at all while the browser is running).
Note that the Mozilla/Netscape format will downgrade RFC2965 cookies to
Netscape cookies on saving.
In particular, the cookie version and port number information is lost,
together with information about whether or not Path, Port and Discard were
specified by the Set-Cookie2 (or Set-Cookie) header, and whether or not the
domain as set in the HTTP header started with a dot (yes, I'm aware some
domains in Netscape files start with a dot and some don't -- trust me, you
really don't want to know any more about this).
Note that though Mozilla and Netscape use the same format, they use
slightly different headers. The class saves cookies using the Netscape
header by default (Mozilla can cope with that).
z #( Netscape)? HTTP Cookie Filez~# Netscape HTTP Cookie File
# http://www.netscape.com/newsref/std/cookie_spec.html
# This is a generated file! Do not edit.
c C sx t � � }|�� }| j�|�s0|�� td| ���z|�� }|dkrH�q2|�d�r^|d d� }|�� �d�s4|�� dkrzq4|� d�\}} }
} } }
}| dk} | dk} |
dkr�|}
d }|�d�}| |ks�J �d }| dkr�d } d
}t
d |
|d d || ||
d | | |d d i �}|�s|j �rq4|�s&|� |��r&q4| �
|� q4W n> t�yJ � Y n* t�yr t� td ||f ��Y n0 d S )
Nz4%r does not look like a Netscape format cookies filer� r� r� )�#rG � �TRUEr� FTr z+invalid Netscape format cookies file %r: %r)rt r� r� rh r� r r� r� r� r� r
r� r r� r� r� r- )r r+ r� r� r� r
r� r� r� r� r� r� r� r� r� r� r� r� r r r r� � sj ��
��
�
�z MozillaCookieJar._really_loadNFc C s
|d u r"| j d ur| j }ntt��t|d�}z�|�| j� t�� }| D ]�}|sV|jrVqF|sf|�|�rfqF|j rrd}nd}|j
� d�r�d}nd}|j d ur�t
|j �} nd} |jd u r�d}
|j} n |j}
|j} |�d�|j
||j|| |
| g�d � qFW |�� n
|�� 0 d S )Nr� r� �FALSEr� r� r� r� )r� rs r� r r� r� rt r� r r� r� r� r� r
r� r� r� r� r� ) r r� r� r� r+ r
r r� r� r� r� r� r r r r� s@
���zMozillaCookieJar.save)NFF)
r r r r r� r� r� r� r� r� r r r r r � s
Br )N)N)fr �
__future__r r r r Zfuture.builtinsr r r r r
Z future.utilsr r �__all__r rQ r� r� rt Z future.backports.urllib.parser r r Z future.backports.http.clientr � threadingr� � ImportErrorZdummy_threading�calendarr r r r! r� r� r- r5 r= r[ r] rp r8 r� rr rZ r^ rf r� rg rm r~ r� �Ir� �Xr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �objectr
r r r r� r� r r� r r r� r r r r r r �<module> s�
5� �
�8
�!
U
4'
#h! S = |PK �Cu\�NTs� � 9 future/backports/http/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �H/usr/local/lib/python3.9/site-packages/future/backports/http/__init__.py�<module> � PK �Cu\ Ko�
x
x 7 future/backports/http/__pycache__/client.cpython-39.pycnu �[��� a
��?h� � . @ s� d Z ddlmZmZmZmZ ddlmZmZm Z m
Z
ddl m Z ddl
mZ ddl
mZ ddlmZ ddlZddlZddlZdd lmZ ddlZdd
lmZ e r�dd l m Z n dd l m Z g d �Z d
Z dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.d Z/d Z0d Z1d Z2d Z3d!Z4d"Z5d#Z6d$Z7d%Z8d&Z9d'Z:d(Z;d)Z<d*Z=d+Z>d,Z?d-Z@d.ZAd/ZBd0ZCd1ZDd2ZEd3ZFd4ZGd5ZHd6ZId7ZJd8ZKd9ZLd:ZMd;ZNd<ZOd=ZPd>ZQd?ZRd@ZSdAZTdBZUdCZVdDZWdEZXdFZYdGZZdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdu�-Z[dvZ\dwZ]dZ^G dxdy� dyej_�Z`e`fdzd{�Zaeb� ZcG d|d}� d}ejd�ZeG d~d� deb�ZfzddlgZgdd�lgmhZh W n ei�y� Y n 0 G d�d�� d�ef�Zje �kd�� G d�d�� d�el�ZmG d�d�� d�em�ZnG d�d�� d�em�ZoG d�d�� d�em�ZpG d�d�� d�em�ZqG d�d�� d�em�ZrG d�d�� d�em�ZsG d�d�� d�em�ZtG d�d�� d�et�ZuG d�d�� d�et�ZvG d�d�� d�et�ZwG d�d�� d�em�ZxG d�d�� d�em�ZyemZzdS )�aD
HTTP/1.1 client library
A backport of the Python 3.3 http/client.py module for python-future.
<intro stuff goes here>
<other stuff, too>
HTTPConnection goes through a number of "states", which define when a client
may legally make another request or fetch the response for a particular
request. This diagram details these state transitions:
(null)
|
| HTTPConnection()
v
Idle
|
| putrequest()
v
Request-started
|
| ( putheader() )* endheaders()
v
Request-sent
|
| response = getresponse()
v
Unread-response [Response-headers-read]
|\____________________
| |
| response.read() | putrequest()
v v
Idle Req-started-unread-response
______/|
/ |
response.read() | | ( putheader() )* endheaders()
v v
Request-started Req-sent-unread-response
|
| response.read()
v
Request-sent
This diagram presents the following rules:
-- a second request may not be started until {response-headers-read}
-- a response [object] cannot be retrieved until {request-sent}
-- there is no differentiation between an unread response body and a
partially read response body
Note: this enforcement is applied by the HTTPConnection class. The
HTTPResponse class does not enforce this state machine, which
implies sophisticated clients may accelerate the request/response
pipeline. Caution should be taken, though: accelerating the states
beyond the above pattern may imply knowledge of the server's
connection-close behavior for certain requests. For example, it
is impossible to tell whether the server will close the connection
UNTIL the response headers have been read; this means that further
requests cannot be placed into the pipeline until it is known that
the server will NOT be closing the connection.
Logical State __state __response
------------- ------- ----------
Idle _CS_IDLE None
Request-started _CS_REQ_STARTED None
Request-sent _CS_REQ_SENT None
Unread-response _CS_IDLE <response_class>
Req-started-unread-response _CS_REQ_STARTED <response_class>
Req-sent-unread-response _CS_REQ_SENT <response_class>
� )�absolute_import�division�print_function�unicode_literals)�bytes�int�str�super)�PY2)�parser)�message)�create_connectionN)�urlsplit)�array)�Iterable)� HTTPResponse�HTTPConnection�
HTTPException� NotConnected�UnknownProtocol�UnknownTransferEncoding�UnimplementedFileMode�IncompleteRead�
InvalidURL�ImproperConnectionState�CannotSendRequest�CannotSendHeader�ResponseNotReady�
BadStatusLine�error� responses�P i� �UNKNOWN�IdlezRequest-startedz Request-sent�d �e �f �� �� �� �� �� �� �� �� �� �, �- �. �/ �0 �1 �3 � � � � � � � � � � � � � � � � � � i� i� i� i� � � � �� � � � � � i� i� � �ContinuezSwitching Protocols�OK�Created�Acceptedz Non-Authoritative Informationz
No Contentz
Reset ContentzPartial ContentzMultiple ChoiceszMoved Permanently�Foundz See Otherz Not Modifiedz Use Proxyz(Unused)zTemporary Redirectz Bad Request� UnauthorizedzPayment Required� Forbiddenz Not FoundzMethod Not AllowedzNot Acceptablez Proxy Authentication RequiredzRequest Timeout�Conflict�GonezLength RequiredzPrecondition FailedzRequest Entity Too LargezRequest-URI Too LongzUnsupported Media Typez Requested Range Not SatisfiablezExpectation FailedzPrecondition RequiredzToo Many Requestsz Request Header Fields Too LargezInternal Server ErrorzNot Implementedz Bad GatewayzService UnavailablezGateway TimeoutzHTTP Version Not Supportedz Network Authentication Required)-r$ r% r' r( r) r* r+ r, r- r0 r1 r2 r3 r4 r5 i2 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR i i c @ s e Zd Zdd� ZdS )� HTTPMessagec C sj |� � d }t|�}g }d}| �� D ]@}|d|� � � |krBd}n|dd� �� sVd}|r$|�|� q$|S )a� Find all header lines matching a given header name.
Look through the list of headers and find all lines matching a given
header name (and their continuation lines). A list of the lines is
returned, without interpretation. If the header does not occur, an
empty list is returned. If the header occurs multiple times, all
occurrences are returned. Case is not important in the header name.
�:r N� )�lower�len�keys�isspace�append)�self�name�n�lst�hit�line� rj �F/usr/local/lib/python3.9/site-packages/future/backports/http/client.py�getallmatchingheaders� s
z!HTTPMessage.getallmatchingheadersN)�__name__�
__module__� __qualname__rl rj rj rj rk r\ � s r\ c C sz g }| � td �}t|�tkr&td��|�|� t|�tkrHtdt ��|dv rqTqtd��|�� d�}t
j |d�� |�S )aG Parses only RFC2822 headers from a file pointer.
email Parser wants to see strings rather than bytes.
But a TextIOWrapper around self.rfile would buffer too many bytes
from the stream, bytes which we later need to read as bytes.
So we read the correct bytes here, as bytes, for email Parser
to parse.
r^ � header linezgot more than %d headers��
�
� rt �
iso-8859-1)�_class)
�readline�_MAXLINEr` � LineTooLongrc � _MAXHEADERSr r �join�decode� email_parser�Parser�parsestr)�fprv �headersri �hstringrj rj rk �
parse_headers s
r� c s� e Zd Zdeddfdd�Zdd� Zdd� Zd d
� Zd d � Z� fd
d�Z � fdd�Z
dd� Z dd� Z d3� fdd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd4d'd(�Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Z� Z S )5r r Nc C sh |� d�| _|| _|tur(t�dtd� || _d | _| _ t
| _ t
| _ t
| _
t
| _t
| _t
| _t
| _d S )N�rb�ithe 'strict' argument isn't supported anymore; http.client now always assumes HTTP/1.x compliant servers.� )�makefiler� �
debuglevel�_strict_sentinel�warnings�warn�DeprecationWarning�_methodr� �msg�_UNKNOWN�version�status�reason�chunked�
chunk_left�length�
will_close)rd �sockr� �strict�method�urlrj rj rk �__init__* s � zHTTPResponse.__init__c C s t | j�td �d�}t|�tkr*td��| jdkrBtdt|�� |sNt |��z|�
d d�\}}}W nB t y� z|�
d d�\}}d}W n t y� d}Y n0 Y n0 |� d�s�| �
� t |��z$t|�}|d k s�|d
kr�t |��W n t �y t |��Y n0 |||fS ) Nr^ ru z status liner zreply:r� � zHTTP/r$ i� )r r� rw rx r` ry r� �print�reprr �split�
ValueError�
startswith� _close_connr )rd ri r� r� r� rj rj rk � _read_statusL s2
zHTTPResponse._read_statusc C s� | j d urd S | �� \}}}|tkr&qp| j�td �}t|�tkrJtd��|�� }|sXq| j dkr&t
d|� q&q| | _ | _ |�� | _
|dv r�d| _n|�d�r�d| _nt|��t| j� | _ | _| j dkr�| j D ]}t
d|d d
� q�| j �d �}|�r|�� d k�rd
| _d | _nd| _| �� | _d | _| j �d�}| j �d �}|�r�| j�s�zt|�| _W n t�yx d | _Y n0 | jdk �r�d | _nd | _|t k�s�|t k�s�d| k�r�dk �s�n | j dk�r�d| _| j�s�| j�s�| jd u �r�d
| _d S )Nr^ rp r zheader:)zHTTP/1.0zHTTP/0.9�
zHTTP/1.� � )�endztransfer-encodingr� TF�content-lengthr$ r' �HEAD) r� r� �CONTINUEr� rw rx r` ry �stripr� r� �coder� r� r� r� r r� r� �getr_ r� r� � _check_closer� r� r r� �
NO_CONTENT� NOT_MODIFIEDr� )rd r� r� r� �skip�hdr�tr_encr� rj rj rk �beginl sn
�
�
���zHTTPResponse.beginc C s� | j �d�}| jdkr:| j �d�}|r6d|�� v r6dS dS | j �d�rJdS |r^d|�� v r^dS | j �d�}|r~d|�� v r~dS dS )N�
connectionr� �closeTFz
keep-alivezproxy-connection)r� r� r� r_ )rd �conn�pconnrj rj rk r� � s
zHTTPResponse._check_closec C s | j }d | _ |�� d S �N)r� r� )rd r� rj rj rk r� � s zHTTPResponse._close_connc s t � �� | jr| �� d S r� )r r� r� r� �rd �� __class__rj rk r� � s
zHTTPResponse.closec s t � �� | jr| j�� d S r� )r �flushr� r� r� rj rk r� � s
zHTTPResponse.flushc C s dS )NTrj r� rj rj rk �readable� s zHTTPResponse.readablec C s
| j du S )z!True if the connection is closed.N)r� r� rj rj rk �isclosed� s zHTTPResponse.isclosedc s� | j d u rtd�S | jdkr,| �� td�S |d urHttt| ��|��S | jrV| �� S | j d u rl| j �� }n4z| �
| j �}W n t y� | �� � Y n0 d| _ | �� t|�S d S )Nrt r� r ) r� r r� r� r r �readr� �_readall_chunkedr� �
_safe_readr )rd �amt�sr� rj rk r� � s&
zHTTPResponse.readc C s� | j d u rdS | jdkr$| �� dS | jr4| �|�S | jd ur^t|�| jkr^t|�d| j� }tr�| j � t|��}t|�}||d |�< n | j �
|�}|s�|r�| �� n&| jd ur�| j|8 _| js�| �� |S )Nr r� ) r� r� r� r� �_readinto_chunkedr� r` �
memoryviewr
r� �readinto)rd �b�datarf rj rj rk r� s,
zHTTPResponse.readintoc C sp | j �td �}t|�tkr$td��|�d�}|dkrB|d |� }z t|d�W S tyj | �� � Y n0 d S )Nr^ z
chunk size� ;r � ) r� rw rx r` ry �findr r� r� )rd ri �irj rj rk �_read_next_chunk_sizeA s
z"HTTPResponse._read_next_chunk_sizec C s: | j �td �}t|�tkr$td��|s*q6|dv r q6q d S )Nr^ z trailer linerq )r� rw rx r` ry �rd ri rj rj rk �_read_and_discard_trailerQ s z&HTTPResponse._read_and_discard_trailerc C s� | j tksJ �| j}g }|d u r^z| �� }|dkr6W q~W n$ ty\ ttd��|���Y n0 |�| � |�� | � d� d }q| �
� | � � td��|�S )Nr rt r� ) r� r� r� r� r� r r r{ rc r� r� r� )rd r� �valuerj rj rk r� _ s
z HTTPResponse._readall_chunkedc C s | j tksJ �| j}d}t|�}|d u rhz| �� }|dkr>W q�W n& tyf tt|d|� ���Y n0 t|�|k r�| � |�}|| | _|| S t|�|kr�| � |�}| �
d� d | _|| S |d|� }| � |�}||d � }||7 }| �
d� d }q | � � | � � |S )Nr r� )
r� r� r� r� r� r� r r r` �_safe_readintor� r� r� )rd r� r� � total_bytes�mvbrf �temp_mvbrj rj rk r� x s:
z HTTPResponse._readinto_chunkedc C s\ g }|dkrN| j �t|t��}|s6ttd��|�|��|�|� |t|�8 }qtd��|�S )aV Read the number of bytes requested, compensating for partial reads.
Normally, we have a blocking socket, but a read() can be interrupted
by a signal (resulting in a partial read).
Note that we cannot distinguish between EOF and an interrupt when zero
bytes have been read. IncompleteRead() will be raised in this
situation.
This function should be used when <amt> bytes "should" be present for
reading. If the bytes are truly not available (due to EOF), then the
IncompleteRead exception can be used to detect the problem.
r rt ) r� r� �min� MAXAMOUNTr r r{ rc r` )rd r� r� �chunkrj rj rk r� � s
zHTTPResponse._safe_readc C s� d}t |�}|t|�k r�tt|�k rh|dt� }trZ| j�t|��}t|�}||d|�< q�| j�|�}n6tr�| j�t|��}t|�}||d|�< n | j�|�}|s�tt|d|� �t|���||d� }||7 }q |S )z2Same as _safe_read, but for reading into a buffer.r N) r� r` r� r
r� r� r� r r )rd r� r� r� r� r� rf rj rj rk r� � s(
zHTTPResponse._safe_readintoc C s
| j �� S r� )r� �filenor� rj rj rk r� � s zHTTPResponse.filenoc C sF | j d u rt� �| j �|�p |}t|t�s4t|d�s8|S d�|�S d S )N�__iter__z, )r� r �get_all�
isinstancer �hasattrr{ )rd re �defaultr� rj rj rk � getheader� s
zHTTPResponse.getheaderc C s | j du rt� �t| j �� �S )z&Return list of (header, value) tuples.N)r� r �list�itemsr� rj rj rk �
getheaders� s
zHTTPResponse.getheadersc C s | S r� rj r� rj rj rk r� � s zHTTPResponse.__iter__c C s | j S r� )r� r� rj rj rk �info� s zHTTPResponse.infoc C s | j S r� )r� r� rj rj rk �geturl� s zHTTPResponse.geturlc C s | j S r� )r� r� rj rj rk �getcode� s zHTTPResponse.getcode)N)N) rm rn ro r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �
__classcell__rj rj r� rk r ! s0 " P
%)
r c @ s� e Zd ZdZdZeZeZdZ dZ
de e j
dfdd�Zd(dd �Zd
d � Zd d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zd)dd�Zd*dd�Zd d � Zd+d d �Zdi fd d!�Zd"d#� Z d$d%� Z d&d'� Z dS ),r r� zHTTP/1.1r^ r Nc C sb |t urt�dtd� || _|| _d | _g | _d | _t | _
d | _ d | _ d | _
i | _| �||� d S )Nr� r� )r� r� r� r� �timeout�source_addressr� �_buffer�_HTTPConnection__response�_CS_IDLE�_HTTPConnection__stater� � _tunnel_host� _tunnel_port�_tunnel_headers�
_set_hostport)rd �host�portr� r� r� rj rj rk r� � s �zHTTPConnection.__init__c C s& || _ || _|r|| _n
| j�� dS )z� Sets up the host and the port for the HTTP CONNECT Tunnelling.
The headers argument should be a mapping of extra HTTP headers
to send with the CONNECT request.
N)r� r� r� �clear)rd r� r� r� rj rj rk �
set_tunnel s
zHTTPConnection.set_tunnelc C s� |d u r�|� d�}|� d�}||kr�zt||d d � �}W nF ty� ||d d � dkrf| j}ntd||d d � ��Y n0 |d |� }n| j}|r�|d dkr�|d dkr�|dd� }|| _|| _d S ) Nr] �]r^ r� znonnumeric port: '%s'r �[���)�rfindr r� � default_portr r� r� )rd r� r� r� �jrj rj rk r� s
z HTTPConnection._set_hostportc C s
|| _ d S r� )r� )rd �levelrj rj rk �set_debuglevel2 s z HTTPConnection.set_debuglevelc C s� | � | j| j� d| j| jf }|�d�}| �|� | j�� D ](\}}d||f }|�d�}| �|� q>| �t d�� | j
| j | j d�}|�
� \}} }
| dkr�| �� t�d| |
�� f ��|j�td �} t| �tkr�td
��| s�q�| d v r�q�q�d S ) NzCONNECT %s:%d HTTP/1.0
�asciiz%s: %s
�latin-1rr �r� r' z Tunnel connection failed: %d %sr^ rp rq )r� r� r� r� r� �encode�sendr� r� r �response_classr� r� r� r� �socketr r� r� rw rx r` ry ) rd Z connect_strZ
connect_bytes�headerr� Z
header_str� header_bytes�responser� r� r ri rj rj rk �_tunnel5 s.
� zHTTPConnection._tunnelc C s, t | j| jf| j| j�| _| jr(| �� dS )z3Connect to the host and port specified in __init__.N)�socket_create_connectionr� r� r� r� r� r� r r� rj rj rk �connectQ s
�zHTTPConnection.connectc C s6 | j r| j �� d| _ | jr,| j�� d| _t| _dS )z(Close the connection to the HTTP server.N)r� r� r� r� r� r� rj rj rk r� X s
zHTTPConnection.closec C s2 | j du r | jr| �� nt� �| jdkr8tdt|�� d}t|d�r�t|t �s�| jdkrbtd� d}z
|j
}W n t y� Y n 0 d|vr�d }| jdkr�td
� |� |�}|s�q�|r�|�
d �}| j �|� q�dS z| j �|� W nJ t�y, t|t��r|D ]}| j �|� �qntd t|� ��Y n0 dS )
z�Send `data' to the server.
``data`` can be a string object, a bytes object, an array object, a
file-like object that supports a .read() method, or an iterable object.
Nr zsend:i r� zsendIng a read()ableFr� Tz encoding file using iso-8859-1ru z9data should be a bytes-like object or an iterable, got %r)r� � auto_openr r r� r� r� r� r� r �mode�AttributeErrorr� r �sendall� TypeErrorr �type)rd r� � blocksizer r � datablock�drj rj rk r b sF
�zHTTPConnection.sendc C s | j �|� dS )zuAdd a line of output to the current request buffer.
Assumes that the line does *not* end with \r\n.
N)r� rc )rd r� rj rj rk �_output� s zHTTPConnection._outputc C sj | j �td�td�f� td��| j �}| j dd�= t|t�rJ||7 }d}| �|� |durf| �|� dS )z�Send the currently buffered request and clear the buffer.
Appends an extra \r\n to the buffer.
A message_body may be specified, to be appended to the request.
rt rr N)r� �extendr r{ r� r )rd � message_bodyr� rj rj rk � _send_output� s
zHTTPConnection._send_outputc
C sv | j r| j �� rd| _ | jtkr(t| _n
t| j��|| _|s@d}d||| jf }| �|� d�� | j
dk�rr|�s^d}|� d�r�t |�\}}}}}|r�z|� d�}W n t
y� |� d�}Y n0 | �d |� n�z| j� d�} W n t
y� | j� d�} Y n0 | j�d
�d k�r"td | d
�} | j| jk�r>| �d | � n | �d�} | �d d| | jf � |�sr| �dd� n dS )a` Send a request to the server.
`method' specifies an HTTP request method, e.g. 'GET'.
`url' specifies the object being requested, e.g. '/index.html'.
`skip_host' if True does not add automatically a 'Host:' header
`skip_accept_encoding' if True does not add automatically an
'Accept-Encoding:' header
N�/z%s %s %sr� r� r� �http�idna�Hostr] r � [� ]z%s:%szAccept-Encoding�identity)r� r� r� r� �_CS_REQ_STARTEDr r� �
_http_vsn_strr r � _http_vsnr� r �UnicodeEncodeError� putheaderr� r� r r� r� r| )
rd r� r� � skip_host�skip_accept_encoding�request�netloc�nil�
netloc_enc�host_encrj rj rk �
putrequest� sD
zHTTPConnection.putrequestc G s� | j tkrt� �t|d�r$|�d�}t|�}t|�D ]>\}}t|d�rV|�d�||< q4t|t�r4t |��d�||< q4t
d�� |�}|t
d� | }| � |� dS )zkSend a request header line to the server.
For example: h.putheader('Accept', 'text/html')
r r� r� s
s : N)
r� r r r� r r� � enumerater� r r r r{ r )rd r �valuesr� � one_valuer� rj rj rk r" $ s
zHTTPConnection.putheaderc C s& | j tkrt| _ nt� �| �|� dS )a� Indicate that the last header line has been sent to the server.
This method sends the request to the server. The optional message_body
argument can be used to pass a message body associated with the
request. The message body will be sent in the same packet as the
message headers if it is a string, otherwise it is sent as a separate
packet.
N)r� r � _CS_REQ_SENTr r )rd r rj rj rk �
endheaders8 s
zHTTPConnection.endheadersc C s | � ||||� dS )z&Send a complete request to the server.N)�
_send_request)rd r� r� �bodyr� rj rj rk r% G s zHTTPConnection.requestc C s� d }zt t|��}W nf tyz } zNzt t�|�� �j�}W n( ttfyd | j dkr`t
d� Y n0 W Y d }~n
d }~0 0 |d ur�| � d|� d S )Nr z
Cannot stat!!zContent-Length) r r` r �os�fstatr� �st_sizer �OSErrorr� r� r" )rd r1 Zthelen�terj rj rk �_set_content_lengthK s .z"HTTPConnection._set_content_lengthc C s� t �dd� |D ��}i }d|v r(d|d< d|v r8d|d< | j||fi |�� |d urfd|vrf| �|� |�� D ]\}}| �||� qnt|t�r�|�d �}| � |� d S )
Nc S s g | ] }|� � �qS rj )r_ )�.0�krj rj rk �
<listcomp>^ rt z0HTTPConnection._send_request.<locals>.<listcomp>r� r^ r# zaccept-encodingr$ r� ru )
�dict�fromkeysr* r7 r� r" r� r r r/ ) rd r� r� r1 r� � header_names�skipsr� r� rj rj rk r0 \ s
z HTTPConnection._send_requestc C s� | j r| j �� rd| _ | jtks&| j r0t| j��| jdkrR| j| j| j| jd�}n| j| j| jd�}|� � |j
t kszJ �t | _|j
r�| �
� n|| _ |S )a/ Get the response from the server.
If the HTTPConnection is in the correct state, returns an
instance of HTTPResponse or of whatever object is returned by
class the response_class variable.
If a request has not been sent or if a previous response has
not be handled, ResponseNotReady is raised. If the HTTP
response indicates that the connection should be closed, then
it will be closed before the response is returned. When the
connection is closed, the underlying socket is closed.
Nr r� )r� r� r� r. r r� r r� r� r� r� r� r� r� )rd r rj rj rk � getresponseq s
�
zHTTPConnection.getresponse)NN)N)r r )N) rm rn ro r r r r � HTTP_PORTr� r
r� r� r �_GLOBAL_DEFAULT_TIMEOUTr� r� r� r� r r r� r r r r* r" r/ r% r7 r0 r? rj rj rj rk r � s2 �
2
t
r )�
SSLContextc s< e Zd ZdZeZdddeejdf� fdd� Z dd� Z
� Z S )�HTTPSConnectionz(This class allows communication via SSL.Nc s� d|v r|d } |d= nd } d|v r4|d }
|d= nd }
t t| ��|||||� || _|| _|
d u r�t�tj�}
|
jtj O _|
j
tj k} | d u r�| } n| r�| s�t d��|s�|r�|
�
||� |
| _| | _d S )N�check_hostname�contextzMcheck_hostname needs a SSL context with either CERT_OPTIONAL or CERT_REQUIRED)r rC r� �key_file� cert_file�sslrB �PROTOCOL_SSLv23�options� OP_NO_SSLv2� verify_mode� CERT_NONEr� �load_cert_chain�_context�_check_hostname) rd r� r� rF rG r� r� r� Z _3to2kwargsrD rE � will_verifyr� rj rk r� � s* � zHTTPSConnection.__init__c C s� t | j| jf| j| j�}| jr,|| _| �� tj r8| jnd}| j
j ||d�| _z | j rjt�
| j�� | j� W n, ty� | j�tj� | j�� � Y n0 dS )z(Connect to a host on a given (SSL) port.N)�server_hostname)r r� r� r� r� r� r� r rH �HAS_SNIrO � wrap_socketrP �match_hostname� getpeercert� Exception�shutdownr � SHUT_RDWRr� )rd r� rR rj rj rk r � s" ��
zHTTPSConnection.connect) rm rn ro �__doc__�
HTTPS_PORTr� r� r rA r� r r� rj rj r� rk rC � s �rC c @ s e Zd ZdS )r N�rm rn ro rj rj rj rk r s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r
s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r
s r c @ s e Zd Zdd� ZdS )r c C s |f| _ || _d S r� )�argsr� )rd r� rj rj rk r� s zUnknownProtocol.__init__N�rm rn ro r� rj rj rj rk r s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r s r c @ s& e Zd Zddd�Zdd� Zdd� ZdS ) r Nc C s |f| _ || _|| _d S r� )r] �partial�expected)rd r_ r` rj rj rk r� s zIncompleteRead.__init__c C s, | j d urd| j }nd}dt| j�|f S )Nz, %i more expectedr� z IncompleteRead(%i bytes read%s))r` r` r_ )rd �erj rj rk �__repr__ s
zIncompleteRead.__repr__c C s t | �S r� )r� r� rj rj rk �__str__& s zIncompleteRead.__str__)N)rm rn ro r� rb rc rj rj rj rk r s
r c @ s e Zd ZdS )r Nr\ rj rj rj rk r ) s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r , s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r / s r c @ s e Zd ZdS )r Nr\ rj rj rj rk r 2 s r c @ s e Zd Zdd� ZdS )r c C s |s t |�}|f| _|| _d S r� )r� r] ri r� rj rj rk r� 6 s zBadStatusLine.__init__Nr^ rj rj rj rk r 5 s r c @ s e Zd Zdd� ZdS )ry c C s t �| dt|f � d S )Nz&got more than %d bytes when reading %s)r r� rx )rd � line_typerj rj rk r� = s �zLineTooLong.__init__Nr^ rj rj rj rk ry < s ry ){rZ �
__future__r r r r Zfuture.builtinsr r r r Z future.utilsr
Zfuture.backports.emailr r} r Z
email_messageZfuture.backports.miscr
r �ior2 r Z future.backports.urllib.parser r� r � collectionsr �collections.abc�__all__r@ r[ r� r� r r. r� �SWITCHING_PROTOCOLS�
PROCESSINGrT �CREATED�ACCEPTED� NON_AUTHORITATIVE_INFORMATIONr� �
RESET_CONTENT�PARTIAL_CONTENT� MULTI_STATUS�IM_USED�MULTIPLE_CHOICES�MOVED_PERMANENTLY�FOUND� SEE_OTHERr� � USE_PROXY�TEMPORARY_REDIRECT� BAD_REQUEST� UNAUTHORIZED�PAYMENT_REQUIRED� FORBIDDEN� NOT_FOUND�METHOD_NOT_ALLOWED�NOT_ACCEPTABLE� PROXY_AUTHENTICATION_REQUIRED�REQUEST_TIMEOUT�CONFLICT�GONE�LENGTH_REQUIRED�PRECONDITION_FAILED�REQUEST_ENTITY_TOO_LARGE�REQUEST_URI_TOO_LONG�UNSUPPORTED_MEDIA_TYPE� REQUESTED_RANGE_NOT_SATISFIABLE�EXPECTATION_FAILED�UNPROCESSABLE_ENTITY�LOCKED�FAILED_DEPENDENCY�UPGRADE_REQUIRED�PRECONDITION_REQUIRED�TOO_MANY_REQUESTS� REQUEST_HEADER_FIELDS_TOO_LARGE�INTERNAL_SERVER_ERROR�NOT_IMPLEMENTED� BAD_GATEWAY�SERVICE_UNAVAILABLE�GATEWAY_TIMEOUT�HTTP_VERSION_NOT_SUPPORTED�INSUFFICIENT_STORAGE� NOT_EXTENDED� NETWORK_AUTHENTICATION_REQUIREDr r� rx rz �Messager\ r� �objectr� � RawIOBaser r rH rB � ImportErrorrC rc rW r r r r r r r r r r r r ry r rj rj rj rk �<module> s8 F �5 V 76
!PK �Cu\C��.�? �? 8 future/backports/http/__pycache__/cookies.cpython-39.pycnu �[��� a
��?hMT � � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZm Z m
Z
ddl m Z m
Z
ddlZe rnde_ddlZg d �Zd
jZd jZd jZG d
d� de�Zejej d Zddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d���Zefd�d��Z e� d��Z e� d��Z d�d�� Z g d��Z!g d��Z"de!e"fd�d��Z#G d�d�� d�e�Z$d�Z%e� d�e% d� e% d� ej�Z&G d�dDŽ d�e�Z'G d�dɄ d�e'�Z(dS )�af
http.cookies module ported to python-future from Py3.3
Here's a sample session to show how to use this module.
At the moment, this is the only documentation.
The Basics
----------
Importing is easy...
>>> from http import cookies
Most of the time you start by creating a cookie.
>>> C = cookies.SimpleCookie()
Once you've created your Cookie, you can add values just as if it were
a dictionary.
>>> C = cookies.SimpleCookie()
>>> C["fig"] = "newton"
>>> C["sugar"] = "wafer"
>>> C.output()
'Set-Cookie: fig=newton\r\nSet-Cookie: sugar=wafer'
Notice that the printable representation of a Cookie is the
appropriate format for a Set-Cookie: header. This is the
default behavior. You can change the header and printed
attributes by using the .output() function
>>> C = cookies.SimpleCookie()
>>> C["rocky"] = "road"
>>> C["rocky"]["path"] = "/cookie"
>>> print(C.output(header="Cookie:"))
Cookie: rocky=road; Path=/cookie
>>> print(C.output(attrs=[], header="Cookie:"))
Cookie: rocky=road
The load() method of a Cookie extracts cookies from a string. In a
CGI script, you would use this method to extract the cookies from the
HTTP_COOKIE environment variable.
>>> C = cookies.SimpleCookie()
>>> C.load("chips=ahoy; vienna=finger")
>>> C.output()
'Set-Cookie: chips=ahoy\r\nSet-Cookie: vienna=finger'
The load() method is darn-tootin smart about identifying cookies
within a string. Escaped quotation marks, nested semicolons, and other
such trickeries do not confuse it.
>>> C = cookies.SimpleCookie()
>>> C.load('keebler="E=everybody; L=\\"Loves\\"; fudge=\\012;";')
>>> print(C)
Set-Cookie: keebler="E=everybody; L=\"Loves\"; fudge=\012;"
Each element of the Cookie also supports all of the RFC 2109
Cookie attributes. Here's an example which sets the Path
attribute.
>>> C = cookies.SimpleCookie()
>>> C["oreo"] = "doublestuff"
>>> C["oreo"]["path"] = "/"
>>> print(C)
Set-Cookie: oreo=doublestuff; Path=/
Each dictionary element has a 'value' attribute, which gives you
back the value associated with the key.
>>> C = cookies.SimpleCookie()
>>> C["twix"] = "none for you"
>>> C["twix"].value
'none for you'
The SimpleCookie expects that all values should be standard strings.
Just to be sure, SimpleCookie invokes the str() builtin to convert
the value to a string, when the values are set dictionary-style.
>>> C = cookies.SimpleCookie()
>>> C["number"] = 7
>>> C["string"] = "seven"
>>> C["number"].value
'7'
>>> C["string"].value
'seven'
>>> C.output()
'Set-Cookie: number=7\r\nSet-Cookie: string=seven'
Finis.
� )�unicode_literals)�print_function)�division)�absolute_import)�chr�dict�int�str)�PY2�
as_native_strN)� CookieError�
BaseCookie� SimpleCookie� z; � c @ s e Zd ZdS )r N)�__name__�
__module__� __qualname__� r r �G/usr/local/lib/python3.9/site-packages/future/backports/http/cookies.pyr � s r z!#$%&'*+-.^_`|~:z\000z\001z\002z\003z\004z\005z\006z\007z\010z\011z\012z\013z\014z\015z\016z\017z\020z\021z\022z\023z\024z\025z\026z\027z\030z\031z\032z\033z\034z\035z\036z\037z\054z\073�\"z\\z\177z\200z\201z\202z\203z\204z\205z\206z\207z\210z\211z\212z\213z\214z\215z\216z\217z\220z\221z\222z\223z\224z\225z\226z\227z\230z\231z\232z\233z\234z\235z\236z\237z\240z\241z\242z\243z\244z\245z\246z\247z\250z\251z\252z\253z\254z\255z\256z\257z\260z\261z\262z\263z\264z\265z\266z\267z\270z\271z\272z\273z\274z\275z\276z\277z\300z\301z\302z\303z\304z\305z\306z\307z\310z\311z\312z\313z\314z\315z\316z\317z\320z\321z\322z\323z\324z\325z\326z\327z\330z\331z\332z\333z\334z\335z\336z\337z\340z\341z\342z\343z\344z\345z\346z\347z\350z\351z\352z\353z\354z\355z\356z\357z\360z\361z\362z\363z\364z\365z\366z\367z\370z\371z\372z\373z\374z\375z\376z\377)�� ��������� �
� � �
��������������� � � � �,�;�"�\�� � � � � �
� � � � � � � � � � � � � � � � � � � � � � � � � � � � ¡� ¢� £� ¤� ¥� ¦� §� ¨� ©� ª� «� ¬� � ®� ¯� °� ±� ²� ³� ´� µ� ¶� ·� ¸� ¹� º� »� ¼� ½� ¾� ¿� À� Á� Â� Ã� Ä� Å� Æ� Ç� È� É� Ê� Ë� Ì� Í� Î� Ï� Ð� Ñ� Ò� Ó� Ô� Õ� Ö� ×� Ø� Ù� Ú� Û� Ü� Ý� Þ� ß� à� á� â� ã� ä� å� æ� ç� è� é� ê� ë� ì� í� î� ï� ð� ñ� ò� ó� ô� õ� ö� ÷� ø� ù� ú� û� ü� ý� þ� ÿc s8 t � fdd�| D ��r| S dtdd� | D �� d S dS )z�Quote a string for use in a cookie header.
If the string does not need to be double-quoted, then just return the
string. Otherwise, surround the string in doublequotes and quote
(with a \) special characters.
c 3 s | ]}|� v V qd S �Nr ��.0�c��
LegalCharsr r � <genexpr>� � z_quote.<locals>.<genexpr>r9 c s s | ]}t �||�V qd S r� )� _Translator�get)r� �sr r r r� � r� N)�all� _nulljoin)r r� r r� r �_quote� s r� z\\[0-3][0-7][0-7]z[\\].c C sB t | �dk r| S | d dks(| d dkr,| S | dd� } d}t | �}g }d| kr^|k �r:n n�t�| |�}t�| |�}|s�|s�|�| |d � � �q:d }}|r�|�d�}|r�|�d�}|r�|r�||k r�|�| ||� � |�| |d � |d }qH|�| ||� � |�tt| |d |d � d��� |d }qHt|�S )N� r r9 ���� � � ) �len�
_OctalPatt�search�
_QuotePatt�append�startr r r� )�mystr�i�n�resZo_matchZq_match�j�kr r r �_unquote� s6
$
r� )�Mon�Tue�Wed�Thu�Fri�Sat�Sun)
N�Jan�Feb�Mar�Apr�May�Jun�Jul�Aug�Sep�Oct�Nov�Decc C sR ddl m}m } |� }||| �\ }}}} }
} } }
}d|| ||| || |
| f S )Nr )�gmtime�timez#%s, %02d %3s %4d %02d:%02d:%02d GMT)r� r� )�future� weekdayname� monthnamer� r� �now�year�month�day�hh�mm�ss�wd�y�zr r r �_getdate3 s �r� c @ s� e Zd ZdZdddddddd d
�Zeddg�Zd d � Zd
d� Zdd� Z e
fdd�Zd dd�Z e Z e
� dd� �Zd dd�Zd dd �ZdS ) �Morsela� A class to hold ONE (key, value) pair.
In a cookie, each such pair may have several attributes, so this class is
used to keep the attributes associated with the appropriate key,value pair.
This class also includes a coded_value attribute, which is used to hold
the network representation of the value. This is most useful when Python
objects are pickled for network transit.
�expires�Path�Comment�DomainzMax-Age�secure�httponly�Version)r �path�comment�domain�max-ager r �versionc C s0 d | _ | _| _| jD ]}t�| |d� qd S )Nr )�key�value� coded_value� _reservedr � __setitem__)�selfr r r r �__init__^ s
zMorsel.__init__c C s0 |� � }|| jvr td| ��t�| ||� d S )NzInvalid Attribute %s)�lowerr r r r )r �K�Vr r r r f s
zMorsel.__setitem__c C s |� � | jv S r� )r r )r r r r r �
isReservedKeyl s zMorsel.isReservedKeyc sR |� � | jv rtd| ��t� fdd�|D ��r<td| ��|| _|| _|| _d S )Nz!Attempt to set a reserved key: %sc 3 s | ]}|� vV qd S r� r r� r� r r r� t r� z Morsel.set.<locals>.<genexpr>zIllegal key value: %s)r r r �anyr r
r )r r �val� coded_valr� r r� r �seto s z
Morsel.setN� Set-Cookie:c C s d|| � |�f S )Nz%s %s)� OutputString)r �attrs�headerr r r �output| s z
Morsel.outputc C s> t r t| jt�r t| j�}n| j}d| jjt| j�t|�f S )Nz <%s: %s=%s>) r
�
isinstancer
�unicoder � __class__r r �repr�r r r r r �__repr__� s �zMorsel.__repr__c C s d| � |��dd� S )Nz�
<script type="text/javascript">
<!-- begin hiding
document.cookie = "%s";
// end hiding -->
</script>
r9 r )r �replace)r r r r r � js_output� s �zMorsel.js_outputc C s g }|j }|d| j| jf � |d u r,| j}t| �� �}|D ]�\}}|dkrNq<||vrXq<|dkr�t|t�r�|d| j| t|�f � q<|dkr�t|t�r�|d| j| |f � q<|dkr�|t | j| �� q<|dkr�|t | j| �� q<|d| j| |f � q<t
|�S )N�%s=%sr r r
z%s=%dr r ) r� r r r �sorted�itemsr r r� r �_semispacejoin)r r �resultr� r* r r
r r r r � s* zMorsel.OutputString)Nr )N)N)r r r �__doc__r r �_flagsr r r � _LegalCharsr �__str__r r% r' r r r r r r� ; s* �
r� z.[\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\=]z~
(?x) # This is a verbose pattern
(?P<key> # Start of group 'key'
a +? # Any word of at least one letter
) # End of group 'key'
( # Optional group: there may not be a value.
\s*=\s* # Equal Sign
(?P<val> # Start of group 'val'
"(?:[^\\"]|\\.)*" # Any doublequoted string
| # or
\w{3},\s[\w\d\s-]{9,11}\s[\d:]{8}\sGMT # Special case for "expires" attr
| # or
a, * # Any word or empty string
) # End of group 'val'
)? # End of optional value group
\s* # Any number of spaces.
(\s+|;|$) # Ending either at space, semicolon, or EOS.
c @ st e Zd ZdZdd� Zdd� Zddd�Zd d
� Zd d � Zddd�Z e Z
e � dd� �Z ddd�Z
dd� Zefdd�ZdS ) r
z'A container class for a set of Morsels.c C s ||fS )a
real_value, coded_value = value_decode(STRING)
Called prior to setting a cookie's value from the network
representation. The VALUE is the value read from HTTP
header.
Override this function to modify the behavior of cookies.
r r$ r r r � value_decode� s zBaseCookie.value_decodec C s t |�}||fS )z�real_value, coded_value = value_encode(VALUE)
Called prior to setting a cookie's value from the dictionary
representation. The VALUE is the value being assigned.
Override this function to modify the behavior of cookies.
)r �r r �strvalr r r � value_encode� s zBaseCookie.value_encodeNc C s |r| � |� d S r� )�load)r �inputr r r r � s zBaseCookie.__init__c C s. | � |t� �}|�|||� t�| ||� dS )z+Private method for setting a cookie's valueN)r� r� r r r )r r �
real_valuer �Mr r r �__set� s zBaseCookie.__setc C s | � |�\}}| �|||� dS )z Dictionary style assignment.N)r4 �_BaseCookie__set)r r r
�rval�cvalr r r r � s zBaseCookie.__setitem__r �
c C s: g }t | �� �}|D ]\}}|�|�||�� q|�|�S )z"Return a string suitable for HTTP.)r) r* r� r �join)r r r �sepr, r* r r
r r r r � s
zBaseCookie.outputc C sn g }t | �� �}|D ]D\}}tr8t|jt�r8t|j�}n|j}|�dt|�t|�f � qd| j j
t |�f S )Nr( z<%s: %s>) r) r* r
r r
r! r r� r# r" r �
_spacejoin)r �lr* r r
r r r r r% s zBaseCookie.__repr__c C s6 g }t | �� �}|D ]\}}|�|�|�� qt|�S )z(Return a string suitable for JavaScript.)r) r* r� r' r� )r r r, r* r r
r r r r' s
zBaseCookie.js_outputc C s4 t |t�r| �|� n|�� D ]\}}|| |< q dS )z�Load cookies from a string (presumably HTTP_COOKIE) or
from a dictionary. Loading cookies from a dictionary 'd'
is equivalent to calling:
map(Cookie.__setitem__, d.keys(), d.values())
N)r r �_BaseCookie__parse_stringr* )r �rawdatar r
r r r r5 s
zBaseCookie.loadc C s� d}t |�}d }d| kr$|k r�n n�|�||�}|s:q�|�d�|�d� }}|�d�}|d dkr||r�|||dd � < q|�� tjv r�|r�|d u r�|�� tjv r�d||< q�t|�||< q|d ur| � |�\} }
| �
|| |
� | | }qd S )Nr r r �$r� T) r� r� �group�endr r� r r. r� r1 r: ) r r� �pattr� r� r8 �matchr r
r; r< r r r �__parse_string& s,
zBaseCookie.__parse_string)N)Nr r= )N)r r r r- r1 r4 r r: r r r0 r r% r' r5 �_CookiePatternrB r r r r r
� s
r
c @ s e Zd ZdZdd� Zdd� ZdS )r z�
SimpleCookie supports strings as cookie values. When setting
the value using the dictionary assignment notation, SimpleCookie
calls the builtin str() to convert the value to a string. Values
received from HTTP are kept as strings.
c C s t |�|fS r� )r� r$ r r r r1 Q s zSimpleCookie.value_decodec C s t |�}|t|�fS r� )r r� r2 r r r r4 T s zSimpleCookie.value_encodeN)r r r r- r1 r4 r r r r r J s r ))r- �
__future__r r r r Zfuture.builtinsr r r r Z future.utilsr
r �re�ASCII�string�__all__r> r� r+ r@ � Exceptionr �
ascii_letters�digitsr/ r� r� �compiler� r� r� � _weekdayname�
_monthnamer� r� Z_LegalCharsPattrJ r
r r r r r �<module>' s� [ �A
2 �� � ��tPK �Cu\#@ACz� z� 7 future/backports/http/__pycache__/server.cpython-39.pycnu �[��� a
��?hӱ � @ s� d Z ddlmZmZmZmZ ddlmZ ddlT dZ ddgZ
ddl m Z dd l
mZ dd
lmZ dd l mZ dd lZdd lZdd lZdd lZdd lZdd lZdd lZdd lZdd l Z dd l Z dd l Z d
Z dZ dd� Z!G dd� dej"�Z#G dd� dej$�Z%G dd� de%�Z&dd� Z'd a(dd� Z)dd� Z*G dd � d e&�Z+e%e#d d fd d �Z,e-d!k�r�e �.� Z/e/j0d"d#d$d%� e/j0d&d'd e1d(d)d*� e/�2� Z3e3j4�r�e,e+e3j5d+� ne,e&e3j5d+� d S ),aQ HTTP server classes.
From Python 3.3
Note: BaseHTTPRequestHandler doesn't implement any HTTP request; see
SimpleHTTPRequestHandler for simple implementations of GET, HEAD and POST,
and CGIHTTPRequestHandler for CGI scripts.
It does, however, optionally implement HTTP/1.1 persistent connections,
as of version 0.3.
Notes on CGIHTTPRequestHandler
------------------------------
This class implements GET and POST requests to cgi-bin scripts.
If the os.fork() function is not present (e.g. on Windows),
subprocess.Popen() is used as a fallback, with slightly altered semantics.
In all cases, the implementation is intentionally naive -- all
requests are executed synchronously.
SECURITY WARNING: DON'T USE THIS CODE UNLESS YOU ARE INSIDE A FIREWALL
-- it may execute arbitrary Python code or external programs.
Note that status code 200 is sent prior to execution of a CGI script, so
scripts cannot send other status codes such as 302 (redirect).
XXX To do:
- log requests even later (to capture byte count)
- log user-agent header and other interesting goodies
- send error log to separate file
� )�absolute_import�division�print_function�unicode_literals)�utils)�*z0.6�
HTTPServer�BaseHTTPRequestHandler��html)�client)�parse)� socketserverNa� <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<title>Error response</title>
</head>
<body>
<h1>Error response</h1>
<p>Error code: %(code)d</p>
<p>Message: %(message)s.</p>
<p>Error code explanation: %(code)s - %(explain)s.</p>
</body>
</html>
ztext/html;charset=utf-8c C s | � dd�� dd�� dd�S )N�&z&�<z<�>z>)�replacer
� r �F/usr/local/lib/python3.9/site-packages/future/backports/http/server.py� _quote_html� s r c @ s e Zd ZdZdd� ZdS )r � c C s8 t j�| � | j�� dd� \}}t�|�| _|| _dS )z.Override server_bind to store the server name.N� )r � TCPServer� server_bind�socket� getsockname�getfqdn� server_name� server_port)�self�host�portr r r r � s zHTTPServer.server_bindN)�__name__�
__module__� __qualname__�allow_reuse_addressr r r r r r � s c - @ s@ e Zd ZdZdej�� d Zde Z e
Z e Z
dZdd� Zdd � Zd
d � Zd d
� ZdZdd�Zd[dd�Zd\dd�Zdd� Zdd� Zdd� Zd]d d �Zd d � Zd d!� Zd"d#� Z d^d$d%�Z d&d'� Z g d(�Z g d)�Z d*d+� Z!d,Z"e#j$Z%d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdY�,Z&dS )_r a� HTTP request handler base class.
The following explanation of HTTP serves to guide you through the
code as well as to expose any misunderstandings I may have about
HTTP (so you don't need to read the code to figure out I'm wrong
:-).
HTTP (HyperText Transfer Protocol) is an extensible protocol on
top of a reliable stream transport (e.g. TCP/IP). The protocol
recognizes three parts to a request:
1. One line identifying the request type and path
2. An optional set of RFC-822-style headers
3. An optional data part
The headers and data are separated by a blank line.
The first line of the request has the form
<command> <path> <version>
where <command> is a (case-sensitive) keyword such as GET or POST,
<path> is a string containing path information for the request,
and <version> should be the string "HTTP/1.0" or "HTTP/1.1".
<path> is encoded using the URL encoding scheme (using %xx to signify
the ASCII character with hex code xx).
The specification specifies that lines are separated by CRLF but
for compatibility with the widest range of clients recommends
servers also handle LF. Similarly, whitespace in the request line
is treated sensibly (allowing multiple spaces between components
and allowing trailing whitespace).
Similarly, for output, lines ought to be separated by CRLF pairs
but most clients grok LF characters just fine.
If the first line of the request has the form
<command> <path>
(i.e. <version> is left out) then this is assumed to be an HTTP
0.9 request; this form has no optional headers and data part and
the reply consists of just the data.
The reply form of the HTTP 1.x protocol again has three parts:
1. One line giving the response code
2. An optional set of RFC-822-style headers
3. The data
Again, the headers and data are separated by a blank line.
The response code line has the form
<version> <responsecode> <responsestring>
where <version> is the protocol version ("HTTP/1.0" or "HTTP/1.1"),
<responsecode> is a 3-digit response code indicating success or
failure of the request, and <responsestring> is an optional
human-readable string explaining what the response code means.
This server parses the request and the headers, and then calls a
function specific to the request type (<command>). Specifically,
a request SPAM will be handled by a method do_SPAM(). If no
such method exists the server sends an error response to the
client. If it exists, it is called with no arguments:
do_SPAM()
Note that the request name is case sensitive (i.e. SPAM and spam
are different requests).
The various request details are stored in instance variables:
- client_address is the client IP address in the form (host,
port);
- command, path and version are the broken-down request line;
- headers is an instance of email.message.Message (or a derived
class) containing the header information;
- rfile is a file object open for reading positioned at the
start of the optional input data part;
- wfile is a file object open for writing.
IT IS IMPORTANT TO ADHERE TO THE PROTOCOL FOR WRITING!
The first thing to be written must be the response line. Then
follow 0 or more header lines, then a blank line, and then the
actual data (if any). The meaning of the header lines depends on
the command executed by the server; in most cases, when data is
returned, there should be at least one header line of the form
Content-type: <type>/<subtype>
where <type> and <subtype> should be registered MIME types,
e.g. "text/html" or "text/plain".
zPython/r z BaseHTTP/�HTTP/0.9c
C s\ d| _ | j | _}d| _t| jd�}|�d�}|| _|�� }t |�dk�r$|\}}}|dd� dkrx| �
dd | � d
S zF|�d d�d }|�d �}t |�d
kr�t �t |d �t |d �f}W n( t t
fy� | �
dd | � Y d
S 0 |dk�r| jdk�rd| _|dk�r~| �
dd| � d
S nZt |�d
k�r`|\}}d| _|dk�r~| �
dd| � d
S n |�sjd
S | �
dd| � d
S ||| | _ | _| _ztj| j| jd�| _W n$ tj�y� | �
dd� Y d
S 0 | j�dd�}|�� dk�r�d| _n |�� d k�r| jdk�rd| _| j�d d�} | �� d k�rX| jdk�rX| jdk�rX| �� �sXd
S d S ) a' Parse a request (internal).
The request should be stored in self.raw_requestline; the results
are in self.command, self.path, self.request_version and
self.headers.
Return True for success, False for failure; on failure, an
error is sent back.
Nr z
iso-8859-1z
� � zHTTP/� zBad request version (%r)F�/�.r r )r r zHTTP/1.1)r r � zInvalid HTTP Version (%s)�GETz Bad HTTP/0.9 request type (%r)zBad request syntax (%r))�_classz
Line too long�
Connection� �close�
keep-aliveZExpectz 100-continueT)�command�default_request_version�request_version�close_connection�str�raw_requestline�rstrip� requestline�split�len�
send_error�
ValueError�int�
IndexError�protocol_version�path� http_client�
parse_headers�rfile� MessageClass�headers� LineTooLong�get�lower�handle_expect_100)
r �versionr: �wordsr3 rB Zbase_version_numberZversion_numberZconntype�expectr r r �
parse_request s�
�
�� ���
z$BaseHTTPRequestHandler.parse_requestc C s | � d� | �� dS )a7 Decide what to do with an "Expect: 100-continue" header.
If the client is expecting a 100 Continue response, we must
respond with either a 100 Continue or a final response before
waiting for the request body. The default is to always respond
with a 100 Continue. You can behave differently (for example,
reject unauthorized requests) by overriding this method.
This method should either return True (possibly after sending
a 100 Continue response) or send an error response and return
False.
�d T)�send_response_only�
flush_headers�r r r r rK ] s
z(BaseHTTPRequestHandler.handle_expect_100c
C s� z�| j �d�| _t| j�dkr@d| _d| _d| _| �d� W dS | jsRd| _W dS | � � s`W dS d| j }t
| |�s�| �dd | j � W dS t | |�}|� | j �
� W n: tjy� } z | �d
|� d| _W Y d}~dS d}~0 0 dS ) z�Handle a single HTTP request.
You normally don't need to override this method; see the class
__doc__ string for information on how to handle specific HTTP
commands such as GET and POST.
i i r0 � Nr Zdo_� zUnsupported method (%r)zRequest timed out: %r)rE �readliner8 r< r: r5 r3 r= r6 rO �hasattr�getattr�wfile�flushr �timeout� log_error)r Zmname�method�er r r �handle_one_requesto s0
z)BaseHTTPRequestHandler.handle_one_requestc C s" d| _ | �� | j s | �� qdS )z&Handle multiple requests if necessary.r N)r6 r_ rS r r r �handle� s z BaseHTTPRequestHandler.handleNc C s� z| j | \}}W n ty, d\}}Y n0 |du r:|}|}| �d||� | j|t|�|d� }| �||� | �d| j� | �dd� | �� | j dkr�|d kr�|d
vr�| j
� |� d d �� dS )
a� Send and log an error reply.
Arguments are the error code, and a detailed message.
The detailed message defaults to the short entry matching the
response code.
This sends an error response (so it must be called before any
output has been generated), logs the error, and finally sends
a piece of HTML explaining the error to the user.
)�???ra Nzcode %d, message %s)�code�message�explainz Content-Typer/ r1 �HEAD�� )�� �0 zUTF-8r )
� responses�KeyErrorr\ �error_message_formatr �
send_response� send_header�error_content_type� end_headersr3 rY �write�encode)r rb rc ZshortmsgZlongmsgrd �contentr r r r= � s"
� z!BaseHTTPRequestHandler.send_errorc C s: | � |� | �||� | �d| �� � | �d| �� � dS )z�Add the response header to the headers buffer and log the
response code.
Also send two standard headers with the server software
version and the current date.
�Server�DateN)� log_requestrQ rm �version_string�date_time_string�r rb rc r r r rl � s
z$BaseHTTPRequestHandler.send_responsec C sd |du r&|| j v r"| j | d }nd}| jdkr`t| d�s@g | _| j�d| j||f �dd�� dS ) z Send the response header only.Nr r0 r& �_headers_bufferz
%s %d %s
�latin-1�strict)ri r5 rW ry �appendrA rq rx r r r rQ � s
��z)BaseHTTPRequestHandler.send_response_onlyc C sl | j dkr6t| d�sg | _| j�d||f �dd�� |�� dkrh|�� dkrVd| _n|�� d krhd
| _d S ) z)Send a MIME header to the headers buffer.r& ry z%s: %s
rz r{ �
connectionr1 r r2 r N)r5 rW ry r| rq rJ r6 )r �keyword�valuer r r rm � s
� z"BaseHTTPRequestHandler.send_headerc C s" | j dkr | j�d� | �� dS )z,Send the blank line ending the MIME headers.r& s
N)r5 ry r| rR rS r r r ro � s
z"BaseHTTPRequestHandler.end_headersc C s( t | d�r$| j�d�| j�� g | _d S )Nry � )rW rY rp �joinry rS r r r rR � s
z$BaseHTTPRequestHandler.flush_headers�-c C s | � d| jt|�t|�� dS )zNLog an accepted request.
This is called by send_response().
z
"%s" %s %sN)� log_messager: r7 )r rb �sizer r r ru � s �z"BaseHTTPRequestHandler.log_requestc G s | j |g|�R � dS )z�Log an error.
This is called when a request cannot be fulfilled. By
default it passes the message on to log_message().
Arguments are the same as for log_message().
XXX This should go to the separate error log.
N)r� �r �format�argsr r r r\ � s z BaseHTTPRequestHandler.log_errorc G s& t j�d| �� | �� || f � dS )a� Log an arbitrary message.
This is used by all other logging functions. Override
it if you have specific logging wishes.
The first argument, FORMAT, is a format string for the
message to be logged. If the format string contains
any % escapes requiring parameters, they should be
specified as subsequent arguments (it's just like
printf!).
The client ip and current date/time are prefixed to
every message.
z%s - - [%s] %s
N)�sys�stderrrp �address_string�log_date_time_stringr� r r r r� s ��z"BaseHTTPRequestHandler.log_messagec C s | j d | j S )z*Return the server software version string.� )�server_version� sys_versionrS r r r rv s z%BaseHTTPRequestHandler.version_stringc C sR |du rt � � }t �|�\ }}}}}}}} }
d| j| || j| ||||f } | S )z@Return the current date and time formatted for a message header.Nz#%s, %02d %3s %4d %02d:%02d:%02d GMT)�time�gmtime� weekdayname� monthname) r � timestamp�year�month�day�hh�mm�ss�wd�y�z�sr r r rw s �z'BaseHTTPRequestHandler.date_time_stringc C sB t � � }t �|�\ }}}}}}}} }
d|| j| ||||f } | S )z.Return the current time formatted for logging.z %02d/%3s/%04d %02d:%02d:%02d)r� � localtimer� ) r �nowr� r� r� r� r� r� �xr� r� r� r r r r� * s �z+BaseHTTPRequestHandler.log_date_time_string)�Mon�Tue�Wed�Thu�Fri�Sat�Sun)
N�Jan�Feb�Mar�Apr�May�Jun�Jul�Aug�Sep�Oct�Nov�Decc C s
| j d S )zReturn the client address.r )�client_addressrS r r r r� 8 s z%BaseHTTPRequestHandler.address_string�HTTP/1.0)�Continuez!Request received, please continue)zSwitching Protocolsz.Switching to new protocol; obey Upgrade header)�OKz#Request fulfilled, document follows)�Createdz Document created, URL follows)�Acceptedz/Request accepted, processing continues off-line)z Non-Authoritative Informationz Request fulfilled from cache)z
No Contentz"Request fulfilled, nothing follows)z
Reset Contentz#Clear input form for further input.)zPartial ContentzPartial content follows.)zMultiple Choicesz,Object has several resources -- see URI list)zMoved Permanentlyz(Object moved permanently -- see URI list)�Found�(Object moved temporarily -- see URI list)z See Otherz'Object moved -- see Method and URL list)z Not Modifiedz)Document has not changed since given time)z Use ProxyzAYou must use proxy specified in Location to access this resource.)zTemporary Redirectr� )z Bad Requestz(Bad request syntax or unsupported method)� Unauthorizedz*No permission -- see authorization schemes)zPayment Requiredz"No payment -- see charging schemes)� Forbiddenz0Request forbidden -- authorization will not help)z Not Foundz Nothing matches the given URI)zMethod Not Allowedz.Specified method is invalid for this resource.)zNot Acceptablez&URI not available in preferred format.)z Proxy Authentication Requiredz8You must authenticate with this proxy before proceeding.)zRequest Timeoutz#Request timed out; try again later.)�ConflictzRequest conflict.)�Gonez6URI no longer exists and has been permanently removed.)zLength Requiredz#Client must specify Content-Length.)zPrecondition Failedz!Precondition in headers is false.)zRequest Entity Too LargezEntity is too large.)zRequest-URI Too LongzURI is too long.)zUnsupported Media Typez"Entity body in unsupported format.)z Requested Range Not Satisfiablez Cannot satisfy request range.)zExpectation Failedz(Expect condition could not be satisfied.)zPrecondition Requiredz9The origin server requires the request to be conditional.)zToo Many RequestszPThe user has sent too many requests in a given amount of time ("rate limiting").)z Request Header Fields Too LargezWThe server is unwilling to process the request because its header fields are too large.)zInternal Server Errorz Server got itself in trouble)zNot Implementedz&Server does not support this operation)z Bad Gatewayz,Invalid responses from another server/proxy.)zService Unavailablez8The server cannot process the request due to a high load)zGateway Timeoutz4The gateway server did not receive a timely response)zHTTP Version Not SupportedzCannot fulfill request.)z Network Authentication Requiredz8The client needs to authenticate to gain network access.),rP �e rf �� �� �� rg �� �� i, �- i. i/ rh i1 i3 r) i� i� � � i� i� i� i� i� i� i� i� i� rT i� i� i� i� i� i� i� rU i� i� i� r, i� )N)N)N)r� r� )N)'r" r# r$ �__doc__r� rL r; r� � __version__r� �DEFAULT_ERROR_MESSAGErk �DEFAULT_ERROR_CONTENT_TYPErn r4 rO rK r_ r` r= rl rQ rm ro rR ru r\ r� rv rw r� r� r� r� rA rC � HTTPMessagerF ri r r r r r � s� gQ#
�c @ s| e Zd ZdZde Zdd� Zdd� Zdd� Zd d
� Z d d � Z
d
d� Z dd� Z e
jsZe
�� e
j�� Ze�ddddd�� dS )�SimpleHTTPRequestHandleraW Simple HTTP request handler with GET and HEAD commands.
This serves files from the current directory and any of its
subdirectories. The MIME type for files is determined by
calling the .guess_type() method.
The GET and HEAD requests are identical except that the HEAD
request omits the actual contents of the file.
z SimpleHTTP/c C s& | � � }|r"| �|| j� |�� dS )zServe a GET request.N)� send_head�copyfilerY r1 �r �fr r r �do_GET� s z SimpleHTTPRequestHandler.do_GETc C s | � � }|r|�� dS )zServe a HEAD request.N)r� r1 r� r r r �do_HEAD� s z SimpleHTTPRequestHandler.do_HEADc C s | � | j�}d}tj�|�r�| j�d�sP| �d� | �d| jd � | �� dS dD ]&}tj�||�}tj� |�rT|} q�qT| �
|�S | � |�}zt |d�}W n t
y� | �dd� Y dS 0 | �d � | �d
|� t�|�� �}| �d t|d �� | �d
| �|j�� | �� |S )a{ Common code for GET and HEAD commands.
This sends the response code and MIME headers.
Return value is either a file object (which has to be copied
to the outputfile by the caller unless the command was HEAD,
and must be closed by the caller under all circumstances), or
None, in which case the caller has nothing further to do.
Nr* r� ZLocation)z
index.htmlz index.htm�rbr� zFile not foundrf � Content-type�Content-Length� z
Last-Modified)�translate_pathrB �os�isdir�endswithrl rm ro r� �exists�list_directory�
guess_type�open�IOErrorr= �fstat�filenor7 rw �st_mtime)r rB r� �index�ctype�fsr r r r� � s6
z"SimpleHTTPRequestHandler.send_headc
C s� zt �|�}W n" t jy0 | �dd� Y dS 0 |jdd� d� g }t�t�| j ��}t
� � }d| }|� d� |� d � |� d
| � |� d | � |� d | � |� d
� |D ]j}t j �
||�}| } }
t j �|�r�|d } |d }
t j �|��r |d } |� dt�|
�t�| �f � q�|� d� d�
|��|�} t�� } | �| � | �d� | �d� | �dd| � | �dtt| ��� | �� | S )z�Helper to produce a directory listing (absent index.html).
Return value is either a file object, or None (indicating an
error). In either case, the headers are sent, making the
interface the same as for send_head().
r� z No permission to list directoryNc S s | � � S )N)rJ )�ar r r �<lambda>� r� z9SimpleHTTPRequestHandler.list_directory.<locals>.<lambda>)�keyzDirectory listing for %szZ<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">z
<html>
<head>z@<meta http-equiv="Content-Type" content="text/html; charset=%s">z<title>%s</title>
</head>z<body>
<h1>%s</h1>z <hr>
<ul>r* �@z <li><a href="%s">%s</a></li>z</ul>
<hr>
</body>
</html>
�
r rf r� ztext/html; charset=%sr� )r� �listdir�errorr= �sortr �escape� urllib_parse�unquoterB r� �getfilesystemencodingr| r� r� �islink�quoterq �io�BytesIOrp �seekrl rm r7 r< ro )
r rB �list�rZ displaypath�enc�title�name�fullnameZ displayname�linkname�encodedr� r r r r� � sN
�
�
z'SimpleHTTPRequestHandler.list_directoryc C s� |� dd�d }|� dd�d }t�t�|��}|� d�}td|�}t�� }|D ]D}tj� |�\}}tj� |�\}}|tj
tj fv r�qPtj� ||�}qP|S )z�Translate a /-separated PATH to the local filename syntax.
Components that mean special things to the local file system
(e.g. drive or directory names) are ignored. (XXX They should
probably be diagnosed.)
�?r r �#r* N)
r; � posixpath�normpathr� r� �filterr� �getcwdrB �
splitdrive�curdir�pardirr� )r rB rM �word�drive�headr r r r�
s
z'SimpleHTTPRequestHandler.translate_pathc C s t �||� dS )a� Copy all data between two file objects.
The SOURCE argument is a file object open for reading
(or anything with a read() method) and the DESTINATION
argument is a file object open for writing (or
anything with a write() method).
The only reason for overriding this would be to change
the block size or perhaps to replace newlines by CRLF
-- note however that this the default server uses this
to copy binary data as well.
N)�shutil� copyfileobj)r �sourceZ
outputfiler r r r� # s z!SimpleHTTPRequestHandler.copyfilec C sL t �|�\}}|| jv r"| j| S |�� }|| jv r>| j| S | jd S dS )a� Guess the type of a file.
Argument is a PATH (a filename).
Return value is a string of the form type/subtype,
usable for a MIME Content-type header.
The default implementation looks the file's extension
up in the table self.extensions_map, using application/octet-stream
as a default; however it would be permissible (if
slow) to look inside the data to make a better guess.
r0 N)r �splitext�extensions_maprJ )r rB �base�extr r r r� 3 s
z#SimpleHTTPRequestHandler.guess_typezapplication/octet-streamz
text/plain)r0 �.pyz.cz.hN)r" r# r$ r� r� r� r� r� r� r� r� r� r� � mimetypes�inited�init� types_map�copyr �updater r r r r� � s$ )4
�r� c C s� | � d�}g }|dd� D ],}|dkr0|�� q|r|dkr|�|� q|r||�� }|r�|dkrn|�� d}q�|dkr�d}nd}dd�|� |f}d�|�}|S )a`
Given a URL path, remove extra '/'s and '.' path elements and collapse
any '..' references and returns a colllapsed path.
Implements something akin to RFC-2396 5.2 step 6 to parse relative paths.
The utility of this function is limited to is_cgi method and helps
preventing some security attacks.
Returns: A tuple of (head, tail) where tail is everything after the final /
and head is everything before it. Head will always start with a '/' and,
if it contains anything else, never have a trailing '/'.
Raises: IndexError if too many '..' occur within the path.
r* N���z..r+ r0 )r; �popr| r� )rB �
path_partsZ
head_parts�partZ tail_partZ splitpath�collapsed_pathr r r �_url_collapse_pathX s&
r c C sn t rt S z ddl} W n ty( Y dS 0 z| �d�d a W n, tyh dtdd� | �� D �� a Y n0 t S ) z$Internal routine to get nobody's uidr Nr �nobodyr r c s s | ]}|d V qdS )r Nr )�.0r� r r r � <genexpr>� r� z nobody_uid.<locals>.<genexpr>)r! �pwd� ImportError�getpwnamrj �max�getpwall)r$ r r r �
nobody_uid� s r) c C s t �| t j�S )zTest for executable file.)r� �access�X_OK)rB r r r �
executable� s r, c @ sV e Zd ZdZeed�ZdZdd� Zdd� Z dd � Z
d
d gZ d d
� Z dd� Z
dd� ZdS )�CGIHTTPRequestHandlerz�Complete HTTP server with GET, HEAD and POST commands.
GET and HEAD also support running CGI scripts.
The POST command is *only* implemented for CGI scripts.
�forkr c C s" | � � r| �� n | �dd� dS )zRServe a POST request.
This is only implemented for CGI scripts.
rU z Can only POST to CGI scriptsN)�is_cgi�run_cgir= rS r r r �do_POST� s
z CGIHTTPRequestHandler.do_POSTc C s | � � r| �� S t�| �S dS )z-Version of send_head that support CGI scriptsN)r/ r0 r� r� rS r r r r� � s z CGIHTTPRequestHandler.send_headc C sP t | j�}|�dd�}|d|� ||d d� }}|| jv rL||f| _dS dS )a3 Test whether self.path corresponds to a CGI script.
Returns True and updates the cgi_info attribute to the tuple
(dir, rest) if self.path requires running a CGI script.
Returns False otherwise.
If any exception is raised, the caller should assume that
self.path was rejected as invalid and act accordingly.
The default implementation tests whether the normalized url
path begins with one of the strings in self.cgi_directories
(and the next character is a '/' or the end of the string).
r* r NTF)r rB �find�cgi_directories�cgi_info)r r Zdir_sepr �tailr r r r/ � s
z CGIHTTPRequestHandler.is_cgiz/cgi-binz/htbinc C s t |�S )z1Test whether argument path is an executable file.)r, )r rB r r r �
is_executable� s z#CGIHTTPRequestHandler.is_executablec C s t j�|�\}}|�� dv S )z.Test whether argument path is a Python script.)r z.pyw)r� rB r rJ )r rB r r5 r r r � is_python� s z CGIHTTPRequestHandler.is_pythonc ( C s� | j }| j\}}|�dt|�d �}|dkr�|d|� }||d d� }| �|�}tj �|�r�|| }}|�dt|�d �}q$q�q$|�d�}|dkr�|d|� ||d d� }}nd}|�d�}|dkr�|d|� ||d� } }n
|d } }|d | }
| �|
�} tj �| ��s(| � dd|
� dS tj �
| ��sJ| � d d
|
� dS | � |
�} | j �sb| �s�| �
| ��s�| � d d |
� dS t�tj�}
| �� |
d < | jj|
d
< d|
d< | j|
d< t| jj�|
d< | j|
d< t�|�}||
d< | �|�|
d< |
|
d< |�r||
d< | jd |
d< | j� d�}|�r�|� � }t|�dk�r�ddl }ddl }|d |
d< |d � � dk�r�z<|d �!d �}t"j#�r�|�$|��%d �}n|�&|��%d �}W n |j't(f�y� Y n&0 |� d �}t|�dk�r�|d |
d < | j� d �du �r
| j�)� |
d < n| jd |
d < | j� d!�}|�r2||
d"< | j� d#�}|�rL||
d$< g }| j�*d%�D ]>}|dd� d&v �r�|�+|�,� � n||d'd� � d(� }�q\d(�-|�|
d)< | j� d*�}|�r�||
d+< t.d| j�/d,g ��}d-�-|�}|�r�||
d.< d/D ]}|
�0|d� �q�| �1d0d1� | �2� |�3d2d3�}| j �rL| g}d4|v�rJ|�+|� t4� } | j5�6� t�7� } | dk�r�t�8| d�\} } t9�9| j:gg g d�d �r�| j:�;d��s|�q��q|| �r�| �<d5| � dS z\zt�=| � W n tj>�y� Y n0 t�?| j:�@� d� t�?| j5�@� d� t�A| ||
� W n( | j�B| jC| j� t�Dd6� Y n0 �n�ddlE} | g} | � | ��r�tFjG}!|!� � �Hd7��r�|!dd8� |!d9d� }!|!d:g| } d4|v�r�| �+|� | �Id;| �J| �� z tK|�}"W n tLtMf�y� d}"Y n0 | jN| | jO| jO| jO|
d<�}#| j� � d=k�r2|"dk�r2| j:�;|"�}$nd}$t9�9| j:jPgg g d�d �rj| j:jP�Qd��s6�qj�q6|#�R|$�\}%}&| j5�S|%� |&�r�| �<d>|&� |#jT�U� |#jV�U� |#jW}'|'�r�| �<d5|'� n
| �Id?� dS )@zExecute a CGI script.r* r r Nr r0 r� zNo such CGI script (%r)r� z#CGI script is not a plain file (%r)z!CGI script is not executable (%r)�SERVER_SOFTWAREZ SERVER_NAMEzCGI/1.1ZGATEWAY_INTERFACEZSERVER_PROTOCOLZ SERVER_PORT�REQUEST_METHODZ PATH_INFOZPATH_TRANSLATEDZ SCRIPT_NAME� QUERY_STRINGZ REMOTE_ADDR�
authorizationr Z AUTH_TYPE�basic�ascii�:Z REMOTE_USERz content-type� CONTENT_TYPEzcontent-length�CONTENT_LENGTH�referer� HTTP_REFERER�acceptz
� �,Z HTTP_ACCEPTz
user-agent�HTTP_USER_AGENT�cookiez, � HTTP_COOKIE)r: Z REMOTE_HOSTr@ rF rH rB rf zScript output follows�+r� �=zCGI script exit status %#x� zw.exe������z-uz command: %s)�stdin�stdoutr� �env�postz%szCGI script exited OK)XrB r4 r2 r< r� r� r� �rfindr� r= �isfiler7 � have_forkr6 r �deepcopy�environrv �serverr rA r7 r r3 r� r� r� rG rI r; �base64�binasciirJ rq r �PY3� decodebytes�decode� decodestring�Error� UnicodeError�get_content_type�getallmatchingheadersr| �stripr� r �get_all�
setdefaultrl rR r r) rY rZ r. �waitpid�selectrE �readr\ �setuidr� �dup2r� �execve� handle_error�request�_exit�
subprocessr� r, r� r� � list2cmdliner? � TypeErrorr> �Popen�PIPE�_sock�recv� communicaterp r� r1 rO �
returncode)(r rB �dir�rest�iZnextdirZnextrestZ scriptdir�query�scriptZ
scriptnameZ
scriptfileZispyrP Zuqrestr; rX rY �lengthrA rC �lineZua�coZ
cookie_str�kZ
decoded_queryr� r! �pid�stsrn ZcmdlineZinterp�nbytes�p�datarO r� �statusr r r r0 � s@
�
�
�
�
�
z CGIHTTPRequestHandler.run_cgiN)r" r# r$ r� rW r� rT �rbufsizer1 r� r/ r3 r6 r7 r0 r r r r r- � s
r- r� i@ c C sx d|f}|| _ ||| �}|j�� }td|d d|d d� z |�� W n, tyr td� |�� t�d� Y n0 dS ) zTest the HTTP request handler class.
This runs an HTTP server on port 8000 (or the first command line
argument).
r0 zServing HTTP onr r! r z...z&
Keyboard interrupt received, exiting.N) rA r r �print�
serve_forever�KeyboardInterrupt� server_closer� �exit)� HandlerClassZ ServerClass�protocolr! �server_addressZhttpd�sar r r �test� s
r� �__main__z--cgi�
store_truezRun as CGI Server)�action�helpr! �storer z&Specify alternate port [default: 8000])r� �default�type�nargsr� )r� r! )6r� �
__future__r r r r �futurer Zfuture.builtinsr� �__all__Zfuture.backportsr Zfuture.backports.httpr rC Zfuture.backports.urllibr
r� r r� r r� r rf r
r r� r� r �argparser� r� r r r �StreamRequestHandlerr r� r r! r) r, r- r� r" �ArgumentParser�parser� add_argumentr? �
parse_argsr� �cgir! r r r r �<module> sn # 3 E+ �
��PK �Cu\���2MT MT future/backports/http/cookies.pynu �[��� ####
# Copyright 2000 by Timothy O'Malley <timo@alum.mit.edu>
#
# All Rights Reserved
#
# Permission to use, copy, modify, and distribute this software
# and its documentation for any purpose and without fee is hereby
# granted, provided that the above copyright notice appear in all
# copies and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Timothy O'Malley not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# Timothy O'Malley DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
# SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
# AND FITNESS, IN NO EVENT SHALL Timothy O'Malley BE LIABLE FOR
# ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
# PERFORMANCE OF THIS SOFTWARE.
#
####
#
# Id: Cookie.py,v 2.29 2000/08/23 05:28:49 timo Exp
# by Timothy O'Malley <timo@alum.mit.edu>
#
# Cookie.py is a Python module for the handling of HTTP
# cookies as a Python dictionary. See RFC 2109 for more
# information on cookies.
#
# The original idea to treat Cookies as a dictionary came from
# Dave Mitchell (davem@magnet.com) in 1995, when he released the
# first version of nscookie.py.
#
####
r"""
http.cookies module ported to python-future from Py3.3
Here's a sample session to show how to use this module.
At the moment, this is the only documentation.
The Basics
----------
Importing is easy...
>>> from http import cookies
Most of the time you start by creating a cookie.
>>> C = cookies.SimpleCookie()
Once you've created your Cookie, you can add values just as if it were
a dictionary.
>>> C = cookies.SimpleCookie()
>>> C["fig"] = "newton"
>>> C["sugar"] = "wafer"
>>> C.output()
'Set-Cookie: fig=newton\r\nSet-Cookie: sugar=wafer'
Notice that the printable representation of a Cookie is the
appropriate format for a Set-Cookie: header. This is the
default behavior. You can change the header and printed
attributes by using the .output() function
>>> C = cookies.SimpleCookie()
>>> C["rocky"] = "road"
>>> C["rocky"]["path"] = "/cookie"
>>> print(C.output(header="Cookie:"))
Cookie: rocky=road; Path=/cookie
>>> print(C.output(attrs=[], header="Cookie:"))
Cookie: rocky=road
The load() method of a Cookie extracts cookies from a string. In a
CGI script, you would use this method to extract the cookies from the
HTTP_COOKIE environment variable.
>>> C = cookies.SimpleCookie()
>>> C.load("chips=ahoy; vienna=finger")
>>> C.output()
'Set-Cookie: chips=ahoy\r\nSet-Cookie: vienna=finger'
The load() method is darn-tootin smart about identifying cookies
within a string. Escaped quotation marks, nested semicolons, and other
such trickeries do not confuse it.
>>> C = cookies.SimpleCookie()
>>> C.load('keebler="E=everybody; L=\\"Loves\\"; fudge=\\012;";')
>>> print(C)
Set-Cookie: keebler="E=everybody; L=\"Loves\"; fudge=\012;"
Each element of the Cookie also supports all of the RFC 2109
Cookie attributes. Here's an example which sets the Path
attribute.
>>> C = cookies.SimpleCookie()
>>> C["oreo"] = "doublestuff"
>>> C["oreo"]["path"] = "/"
>>> print(C)
Set-Cookie: oreo=doublestuff; Path=/
Each dictionary element has a 'value' attribute, which gives you
back the value associated with the key.
>>> C = cookies.SimpleCookie()
>>> C["twix"] = "none for you"
>>> C["twix"].value
'none for you'
The SimpleCookie expects that all values should be standard strings.
Just to be sure, SimpleCookie invokes the str() builtin to convert
the value to a string, when the values are set dictionary-style.
>>> C = cookies.SimpleCookie()
>>> C["number"] = 7
>>> C["string"] = "seven"
>>> C["number"].value
'7'
>>> C["string"].value
'seven'
>>> C.output()
'Set-Cookie: number=7\r\nSet-Cookie: string=seven'
Finis.
"""
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
from future.builtins import chr, dict, int, str
from future.utils import PY2, as_native_str
#
# Import our required modules
#
import re
if PY2:
re.ASCII = 0 # for py2 compatibility
import string
__all__ = ["CookieError", "BaseCookie", "SimpleCookie"]
_nulljoin = ''.join
_semispacejoin = '; '.join
_spacejoin = ' '.join
#
# Define an exception visible to External modules
#
class CookieError(Exception):
pass
# These quoting routines conform to the RFC2109 specification, which in
# turn references the character definitions from RFC2068. They provide
# a two-way quoting algorithm. Any non-text character is translated
# into a 4 character sequence: a forward-slash followed by the
# three-digit octal equivalent of the character. Any '\' or '"' is
# quoted with a preceeding '\' slash.
#
# These are taken from RFC2068 and RFC2109.
# _LegalChars is the list of chars which don't require "'s
# _Translator hash-table for fast quoting
#
_LegalChars = string.ascii_letters + string.digits + "!#$%&'*+-.^_`|~:"
_Translator = {
'\000' : '\\000', '\001' : '\\001', '\002' : '\\002',
'\003' : '\\003', '\004' : '\\004', '\005' : '\\005',
'\006' : '\\006', '\007' : '\\007', '\010' : '\\010',
'\011' : '\\011', '\012' : '\\012', '\013' : '\\013',
'\014' : '\\014', '\015' : '\\015', '\016' : '\\016',
'\017' : '\\017', '\020' : '\\020', '\021' : '\\021',
'\022' : '\\022', '\023' : '\\023', '\024' : '\\024',
'\025' : '\\025', '\026' : '\\026', '\027' : '\\027',
'\030' : '\\030', '\031' : '\\031', '\032' : '\\032',
'\033' : '\\033', '\034' : '\\034', '\035' : '\\035',
'\036' : '\\036', '\037' : '\\037',
# Because of the way browsers really handle cookies (as opposed
# to what the RFC says) we also encode , and ;
',' : '\\054', ';' : '\\073',
'"' : '\\"', '\\' : '\\\\',
'\177' : '\\177', '\200' : '\\200', '\201' : '\\201',
'\202' : '\\202', '\203' : '\\203', '\204' : '\\204',
'\205' : '\\205', '\206' : '\\206', '\207' : '\\207',
'\210' : '\\210', '\211' : '\\211', '\212' : '\\212',
'\213' : '\\213', '\214' : '\\214', '\215' : '\\215',
'\216' : '\\216', '\217' : '\\217', '\220' : '\\220',
'\221' : '\\221', '\222' : '\\222', '\223' : '\\223',
'\224' : '\\224', '\225' : '\\225', '\226' : '\\226',
'\227' : '\\227', '\230' : '\\230', '\231' : '\\231',
'\232' : '\\232', '\233' : '\\233', '\234' : '\\234',
'\235' : '\\235', '\236' : '\\236', '\237' : '\\237',
'\240' : '\\240', '\241' : '\\241', '\242' : '\\242',
'\243' : '\\243', '\244' : '\\244', '\245' : '\\245',
'\246' : '\\246', '\247' : '\\247', '\250' : '\\250',
'\251' : '\\251', '\252' : '\\252', '\253' : '\\253',
'\254' : '\\254', '\255' : '\\255', '\256' : '\\256',
'\257' : '\\257', '\260' : '\\260', '\261' : '\\261',
'\262' : '\\262', '\263' : '\\263', '\264' : '\\264',
'\265' : '\\265', '\266' : '\\266', '\267' : '\\267',
'\270' : '\\270', '\271' : '\\271', '\272' : '\\272',
'\273' : '\\273', '\274' : '\\274', '\275' : '\\275',
'\276' : '\\276', '\277' : '\\277', '\300' : '\\300',
'\301' : '\\301', '\302' : '\\302', '\303' : '\\303',
'\304' : '\\304', '\305' : '\\305', '\306' : '\\306',
'\307' : '\\307', '\310' : '\\310', '\311' : '\\311',
'\312' : '\\312', '\313' : '\\313', '\314' : '\\314',
'\315' : '\\315', '\316' : '\\316', '\317' : '\\317',
'\320' : '\\320', '\321' : '\\321', '\322' : '\\322',
'\323' : '\\323', '\324' : '\\324', '\325' : '\\325',
'\326' : '\\326', '\327' : '\\327', '\330' : '\\330',
'\331' : '\\331', '\332' : '\\332', '\333' : '\\333',
'\334' : '\\334', '\335' : '\\335', '\336' : '\\336',
'\337' : '\\337', '\340' : '\\340', '\341' : '\\341',
'\342' : '\\342', '\343' : '\\343', '\344' : '\\344',
'\345' : '\\345', '\346' : '\\346', '\347' : '\\347',
'\350' : '\\350', '\351' : '\\351', '\352' : '\\352',
'\353' : '\\353', '\354' : '\\354', '\355' : '\\355',
'\356' : '\\356', '\357' : '\\357', '\360' : '\\360',
'\361' : '\\361', '\362' : '\\362', '\363' : '\\363',
'\364' : '\\364', '\365' : '\\365', '\366' : '\\366',
'\367' : '\\367', '\370' : '\\370', '\371' : '\\371',
'\372' : '\\372', '\373' : '\\373', '\374' : '\\374',
'\375' : '\\375', '\376' : '\\376', '\377' : '\\377'
}
def _quote(str, LegalChars=_LegalChars):
r"""Quote a string for use in a cookie header.
If the string does not need to be double-quoted, then just return the
string. Otherwise, surround the string in doublequotes and quote
(with a \) special characters.
"""
if all(c in LegalChars for c in str):
return str
else:
return '"' + _nulljoin(_Translator.get(s, s) for s in str) + '"'
_OctalPatt = re.compile(r"\\[0-3][0-7][0-7]")
_QuotePatt = re.compile(r"[\\].")
def _unquote(mystr):
# If there aren't any doublequotes,
# then there can't be any special characters. See RFC 2109.
if len(mystr) < 2:
return mystr
if mystr[0] != '"' or mystr[-1] != '"':
return mystr
# We have to assume that we must decode this string.
# Down to work.
# Remove the "s
mystr = mystr[1:-1]
# Check for special sequences. Examples:
# \012 --> \n
# \" --> "
#
i = 0
n = len(mystr)
res = []
while 0 <= i < n:
o_match = _OctalPatt.search(mystr, i)
q_match = _QuotePatt.search(mystr, i)
if not o_match and not q_match: # Neither matched
res.append(mystr[i:])
break
# else:
j = k = -1
if o_match:
j = o_match.start(0)
if q_match:
k = q_match.start(0)
if q_match and (not o_match or k < j): # QuotePatt matched
res.append(mystr[i:k])
res.append(mystr[k+1])
i = k + 2
else: # OctalPatt matched
res.append(mystr[i:j])
res.append(chr(int(mystr[j+1:j+4], 8)))
i = j + 4
return _nulljoin(res)
# The _getdate() routine is used to set the expiration time in the cookie's HTTP
# header. By default, _getdate() returns the current time in the appropriate
# "expires" format for a Set-Cookie header. The one optional argument is an
# offset from now, in seconds. For example, an offset of -3600 means "one hour
# ago". The offset may be a floating point number.
#
_weekdayname = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
_monthname = [None,
'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
def _getdate(future=0, weekdayname=_weekdayname, monthname=_monthname):
from time import gmtime, time
now = time()
year, month, day, hh, mm, ss, wd, y, z = gmtime(now + future)
return "%s, %02d %3s %4d %02d:%02d:%02d GMT" % \
(weekdayname[wd], day, monthname[month], year, hh, mm, ss)
class Morsel(dict):
"""A class to hold ONE (key, value) pair.
In a cookie, each such pair may have several attributes, so this class is
used to keep the attributes associated with the appropriate key,value pair.
This class also includes a coded_value attribute, which is used to hold
the network representation of the value. This is most useful when Python
objects are pickled for network transit.
"""
# RFC 2109 lists these attributes as reserved:
# path comment domain
# max-age secure version
#
# For historical reasons, these attributes are also reserved:
# expires
#
# This is an extension from Microsoft:
# httponly
#
# This dictionary provides a mapping from the lowercase
# variant on the left to the appropriate traditional
# formatting on the right.
_reserved = {
"expires" : "expires",
"path" : "Path",
"comment" : "Comment",
"domain" : "Domain",
"max-age" : "Max-Age",
"secure" : "secure",
"httponly" : "httponly",
"version" : "Version",
}
_flags = set(['secure', 'httponly'])
def __init__(self):
# Set defaults
self.key = self.value = self.coded_value = None
# Set default attributes
for key in self._reserved:
dict.__setitem__(self, key, "")
def __setitem__(self, K, V):
K = K.lower()
if not K in self._reserved:
raise CookieError("Invalid Attribute %s" % K)
dict.__setitem__(self, K, V)
def isReservedKey(self, K):
return K.lower() in self._reserved
def set(self, key, val, coded_val, LegalChars=_LegalChars):
# First we verify that the key isn't a reserved word
# Second we make sure it only contains legal characters
if key.lower() in self._reserved:
raise CookieError("Attempt to set a reserved key: %s" % key)
if any(c not in LegalChars for c in key):
raise CookieError("Illegal key value: %s" % key)
# It's a good key, so save it.
self.key = key
self.value = val
self.coded_value = coded_val
def output(self, attrs=None, header="Set-Cookie:"):
return "%s %s" % (header, self.OutputString(attrs))
__str__ = output
@as_native_str()
def __repr__(self):
if PY2 and isinstance(self.value, unicode):
val = str(self.value) # make it a newstr to remove the u prefix
else:
val = self.value
return '<%s: %s=%s>' % (self.__class__.__name__,
str(self.key), repr(val))
def js_output(self, attrs=None):
# Print javascript
return """
<script type="text/javascript">
<!-- begin hiding
document.cookie = \"%s\";
// end hiding -->
</script>
""" % (self.OutputString(attrs).replace('"', r'\"'))
def OutputString(self, attrs=None):
# Build up our result
#
result = []
append = result.append
# First, the key=value pair
append("%s=%s" % (self.key, self.coded_value))
# Now add any defined attributes
if attrs is None:
attrs = self._reserved
items = sorted(self.items())
for key, value in items:
if value == "":
continue
if key not in attrs:
continue
if key == "expires" and isinstance(value, int):
append("%s=%s" % (self._reserved[key], _getdate(value)))
elif key == "max-age" and isinstance(value, int):
append("%s=%d" % (self._reserved[key], value))
elif key == "secure":
append(str(self._reserved[key]))
elif key == "httponly":
append(str(self._reserved[key]))
else:
append("%s=%s" % (self._reserved[key], value))
# Return the result
return _semispacejoin(result)
#
# Pattern for finding cookie
#
# This used to be strict parsing based on the RFC2109 and RFC2068
# specifications. I have since discovered that MSIE 3.0x doesn't
# follow the character rules outlined in those specs. As a
# result, the parsing rules here are less strict.
#
_LegalCharsPatt = r"[\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\=]"
_CookiePattern = re.compile(r"""
(?x) # This is a verbose pattern
(?P<key> # Start of group 'key'
""" + _LegalCharsPatt + r"""+? # Any word of at least one letter
) # End of group 'key'
( # Optional group: there may not be a value.
\s*=\s* # Equal Sign
(?P<val> # Start of group 'val'
"(?:[^\\"]|\\.)*" # Any doublequoted string
| # or
\w{3},\s[\w\d\s-]{9,11}\s[\d:]{8}\sGMT # Special case for "expires" attr
| # or
""" + _LegalCharsPatt + r"""* # Any word or empty string
) # End of group 'val'
)? # End of optional value group
\s* # Any number of spaces.
(\s+|;|$) # Ending either at space, semicolon, or EOS.
""", re.ASCII) # May be removed if safe.
# At long last, here is the cookie class. Using this class is almost just like
# using a dictionary. See this module's docstring for example usage.
#
class BaseCookie(dict):
"""A container class for a set of Morsels."""
def value_decode(self, val):
"""real_value, coded_value = value_decode(STRING)
Called prior to setting a cookie's value from the network
representation. The VALUE is the value read from HTTP
header.
Override this function to modify the behavior of cookies.
"""
return val, val
def value_encode(self, val):
"""real_value, coded_value = value_encode(VALUE)
Called prior to setting a cookie's value from the dictionary
representation. The VALUE is the value being assigned.
Override this function to modify the behavior of cookies.
"""
strval = str(val)
return strval, strval
def __init__(self, input=None):
if input:
self.load(input)
def __set(self, key, real_value, coded_value):
"""Private method for setting a cookie's value"""
M = self.get(key, Morsel())
M.set(key, real_value, coded_value)
dict.__setitem__(self, key, M)
def __setitem__(self, key, value):
"""Dictionary style assignment."""
rval, cval = self.value_encode(value)
self.__set(key, rval, cval)
def output(self, attrs=None, header="Set-Cookie:", sep="\015\012"):
"""Return a string suitable for HTTP."""
result = []
items = sorted(self.items())
for key, value in items:
result.append(value.output(attrs, header))
return sep.join(result)
__str__ = output
@as_native_str()
def __repr__(self):
l = []
items = sorted(self.items())
for key, value in items:
if PY2 and isinstance(value.value, unicode):
val = str(value.value) # make it a newstr to remove the u prefix
else:
val = value.value
l.append('%s=%s' % (str(key), repr(val)))
return '<%s: %s>' % (self.__class__.__name__, _spacejoin(l))
def js_output(self, attrs=None):
"""Return a string suitable for JavaScript."""
result = []
items = sorted(self.items())
for key, value in items:
result.append(value.js_output(attrs))
return _nulljoin(result)
def load(self, rawdata):
"""Load cookies from a string (presumably HTTP_COOKIE) or
from a dictionary. Loading cookies from a dictionary 'd'
is equivalent to calling:
map(Cookie.__setitem__, d.keys(), d.values())
"""
if isinstance(rawdata, str):
self.__parse_string(rawdata)
else:
# self.update() wouldn't call our custom __setitem__
for key, value in rawdata.items():
self[key] = value
return
def __parse_string(self, mystr, patt=_CookiePattern):
i = 0 # Our starting point
n = len(mystr) # Length of string
M = None # current morsel
while 0 <= i < n:
# Start looking for a cookie
match = patt.search(mystr, i)
if not match:
# No more cookies
break
key, value = match.group("key"), match.group("val")
i = match.end(0)
# Parse the key, value in case it's metainfo
if key[0] == "$":
# We ignore attributes which pertain to the cookie
# mechanism as a whole. See RFC 2109.
# (Does anyone care?)
if M:
M[key[1:]] = value
elif key.lower() in Morsel._reserved:
if M:
if value is None:
if key.lower() in Morsel._flags:
M[key] = True
else:
M[key] = _unquote(value)
elif value is not None:
rval, cval = self.value_decode(value)
self.__set(key, rval, cval)
M = self[key]
class SimpleCookie(BaseCookie):
"""
SimpleCookie supports strings as cookie values. When setting
the value using the dictionary assignment notation, SimpleCookie
calls the builtin str() to convert the value to a string. Values
received from HTTP are kept as strings.
"""
def value_decode(self, val):
return _unquote(val), val
def value_encode(self, val):
strval = str(val)
return strval, _quote(strval)
PK �Cu\��Vӱ ӱ future/backports/http/server.pynu �[��� """HTTP server classes.
From Python 3.3
Note: BaseHTTPRequestHandler doesn't implement any HTTP request; see
SimpleHTTPRequestHandler for simple implementations of GET, HEAD and POST,
and CGIHTTPRequestHandler for CGI scripts.
It does, however, optionally implement HTTP/1.1 persistent connections,
as of version 0.3.
Notes on CGIHTTPRequestHandler
------------------------------
This class implements GET and POST requests to cgi-bin scripts.
If the os.fork() function is not present (e.g. on Windows),
subprocess.Popen() is used as a fallback, with slightly altered semantics.
In all cases, the implementation is intentionally naive -- all
requests are executed synchronously.
SECURITY WARNING: DON'T USE THIS CODE UNLESS YOU ARE INSIDE A FIREWALL
-- it may execute arbitrary Python code or external programs.
Note that status code 200 is sent prior to execution of a CGI script, so
scripts cannot send other status codes such as 302 (redirect).
XXX To do:
- log requests even later (to capture byte count)
- log user-agent header and other interesting goodies
- send error log to separate file
"""
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from future import utils
from future.builtins import *
# See also:
#
# HTTP Working Group T. Berners-Lee
# INTERNET-DRAFT R. T. Fielding
# <draft-ietf-http-v10-spec-00.txt> H. Frystyk Nielsen
# Expires September 8, 1995 March 8, 1995
#
# URL: http://www.ics.uci.edu/pub/ietf/http/draft-ietf-http-v10-spec-00.txt
#
# and
#
# Network Working Group R. Fielding
# Request for Comments: 2616 et al
# Obsoletes: 2068 June 1999
# Category: Standards Track
#
# URL: http://www.faqs.org/rfcs/rfc2616.html
# Log files
# ---------
#
# Here's a quote from the NCSA httpd docs about log file format.
#
# | The logfile format is as follows. Each line consists of:
# |
# | host rfc931 authuser [DD/Mon/YYYY:hh:mm:ss] "request" ddd bbbb
# |
# | host: Either the DNS name or the IP number of the remote client
# | rfc931: Any information returned by identd for this person,
# | - otherwise.
# | authuser: If user sent a userid for authentication, the user name,
# | - otherwise.
# | DD: Day
# | Mon: Month (calendar name)
# | YYYY: Year
# | hh: hour (24-hour format, the machine's timezone)
# | mm: minutes
# | ss: seconds
# | request: The first line of the HTTP request as sent by the client.
# | ddd: the status code returned by the server, - if not available.
# | bbbb: the total number of bytes sent,
# | *not including the HTTP/1.0 header*, - if not available
# |
# | You can determine the name of the file accessed through request.
#
# (Actually, the latter is only true if you know the server configuration
# at the time the request was made!)
__version__ = "0.6"
__all__ = ["HTTPServer", "BaseHTTPRequestHandler"]
from future.backports import html
from future.backports.http import client as http_client
from future.backports.urllib import parse as urllib_parse
from future.backports import socketserver
import io
import mimetypes
import os
import posixpath
import select
import shutil
import socket # For gethostbyaddr()
import sys
import time
import copy
import argparse
# Default error message template
DEFAULT_ERROR_MESSAGE = """\
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<title>Error response</title>
</head>
<body>
<h1>Error response</h1>
<p>Error code: %(code)d</p>
<p>Message: %(message)s.</p>
<p>Error code explanation: %(code)s - %(explain)s.</p>
</body>
</html>
"""
DEFAULT_ERROR_CONTENT_TYPE = "text/html;charset=utf-8"
def _quote_html(html):
return html.replace("&", "&").replace("<", "<").replace(">", ">")
class HTTPServer(socketserver.TCPServer):
allow_reuse_address = 1 # Seems to make sense in testing environment
def server_bind(self):
"""Override server_bind to store the server name."""
socketserver.TCPServer.server_bind(self)
host, port = self.socket.getsockname()[:2]
self.server_name = socket.getfqdn(host)
self.server_port = port
class BaseHTTPRequestHandler(socketserver.StreamRequestHandler):
"""HTTP request handler base class.
The following explanation of HTTP serves to guide you through the
code as well as to expose any misunderstandings I may have about
HTTP (so you don't need to read the code to figure out I'm wrong
:-).
HTTP (HyperText Transfer Protocol) is an extensible protocol on
top of a reliable stream transport (e.g. TCP/IP). The protocol
recognizes three parts to a request:
1. One line identifying the request type and path
2. An optional set of RFC-822-style headers
3. An optional data part
The headers and data are separated by a blank line.
The first line of the request has the form
<command> <path> <version>
where <command> is a (case-sensitive) keyword such as GET or POST,
<path> is a string containing path information for the request,
and <version> should be the string "HTTP/1.0" or "HTTP/1.1".
<path> is encoded using the URL encoding scheme (using %xx to signify
the ASCII character with hex code xx).
The specification specifies that lines are separated by CRLF but
for compatibility with the widest range of clients recommends
servers also handle LF. Similarly, whitespace in the request line
is treated sensibly (allowing multiple spaces between components
and allowing trailing whitespace).
Similarly, for output, lines ought to be separated by CRLF pairs
but most clients grok LF characters just fine.
If the first line of the request has the form
<command> <path>
(i.e. <version> is left out) then this is assumed to be an HTTP
0.9 request; this form has no optional headers and data part and
the reply consists of just the data.
The reply form of the HTTP 1.x protocol again has three parts:
1. One line giving the response code
2. An optional set of RFC-822-style headers
3. The data
Again, the headers and data are separated by a blank line.
The response code line has the form
<version> <responsecode> <responsestring>
where <version> is the protocol version ("HTTP/1.0" or "HTTP/1.1"),
<responsecode> is a 3-digit response code indicating success or
failure of the request, and <responsestring> is an optional
human-readable string explaining what the response code means.
This server parses the request and the headers, and then calls a
function specific to the request type (<command>). Specifically,
a request SPAM will be handled by a method do_SPAM(). If no
such method exists the server sends an error response to the
client. If it exists, it is called with no arguments:
do_SPAM()
Note that the request name is case sensitive (i.e. SPAM and spam
are different requests).
The various request details are stored in instance variables:
- client_address is the client IP address in the form (host,
port);
- command, path and version are the broken-down request line;
- headers is an instance of email.message.Message (or a derived
class) containing the header information;
- rfile is a file object open for reading positioned at the
start of the optional input data part;
- wfile is a file object open for writing.
IT IS IMPORTANT TO ADHERE TO THE PROTOCOL FOR WRITING!
The first thing to be written must be the response line. Then
follow 0 or more header lines, then a blank line, and then the
actual data (if any). The meaning of the header lines depends on
the command executed by the server; in most cases, when data is
returned, there should be at least one header line of the form
Content-type: <type>/<subtype>
where <type> and <subtype> should be registered MIME types,
e.g. "text/html" or "text/plain".
"""
# The Python system version, truncated to its first component.
sys_version = "Python/" + sys.version.split()[0]
# The server software version. You may want to override this.
# The format is multiple whitespace-separated strings,
# where each string is of the form name[/version].
server_version = "BaseHTTP/" + __version__
error_message_format = DEFAULT_ERROR_MESSAGE
error_content_type = DEFAULT_ERROR_CONTENT_TYPE
# The default request version. This only affects responses up until
# the point where the request line is parsed, so it mainly decides what
# the client gets back when sending a malformed request line.
# Most web servers default to HTTP 0.9, i.e. don't send a status line.
default_request_version = "HTTP/0.9"
def parse_request(self):
"""Parse a request (internal).
The request should be stored in self.raw_requestline; the results
are in self.command, self.path, self.request_version and
self.headers.
Return True for success, False for failure; on failure, an
error is sent back.
"""
self.command = None # set in case of error on the first line
self.request_version = version = self.default_request_version
self.close_connection = 1
requestline = str(self.raw_requestline, 'iso-8859-1')
requestline = requestline.rstrip('\r\n')
self.requestline = requestline
words = requestline.split()
if len(words) == 3:
command, path, version = words
if version[:5] != 'HTTP/':
self.send_error(400, "Bad request version (%r)" % version)
return False
try:
base_version_number = version.split('/', 1)[1]
version_number = base_version_number.split(".")
# RFC 2145 section 3.1 says there can be only one "." and
# - major and minor numbers MUST be treated as
# separate integers;
# - HTTP/2.4 is a lower version than HTTP/2.13, which in
# turn is lower than HTTP/12.3;
# - Leading zeros MUST be ignored by recipients.
if len(version_number) != 2:
raise ValueError
version_number = int(version_number[0]), int(version_number[1])
except (ValueError, IndexError):
self.send_error(400, "Bad request version (%r)" % version)
return False
if version_number >= (1, 1) and self.protocol_version >= "HTTP/1.1":
self.close_connection = 0
if version_number >= (2, 0):
self.send_error(505,
"Invalid HTTP Version (%s)" % base_version_number)
return False
elif len(words) == 2:
command, path = words
self.close_connection = 1
if command != 'GET':
self.send_error(400,
"Bad HTTP/0.9 request type (%r)" % command)
return False
elif not words:
return False
else:
self.send_error(400, "Bad request syntax (%r)" % requestline)
return False
self.command, self.path, self.request_version = command, path, version
# Examine the headers and look for a Connection directive.
try:
self.headers = http_client.parse_headers(self.rfile,
_class=self.MessageClass)
except http_client.LineTooLong:
self.send_error(400, "Line too long")
return False
conntype = self.headers.get('Connection', "")
if conntype.lower() == 'close':
self.close_connection = 1
elif (conntype.lower() == 'keep-alive' and
self.protocol_version >= "HTTP/1.1"):
self.close_connection = 0
# Examine the headers and look for an Expect directive
expect = self.headers.get('Expect', "")
if (expect.lower() == "100-continue" and
self.protocol_version >= "HTTP/1.1" and
self.request_version >= "HTTP/1.1"):
if not self.handle_expect_100():
return False
return True
def handle_expect_100(self):
"""Decide what to do with an "Expect: 100-continue" header.
If the client is expecting a 100 Continue response, we must
respond with either a 100 Continue or a final response before
waiting for the request body. The default is to always respond
with a 100 Continue. You can behave differently (for example,
reject unauthorized requests) by overriding this method.
This method should either return True (possibly after sending
a 100 Continue response) or send an error response and return
False.
"""
self.send_response_only(100)
self.flush_headers()
return True
def handle_one_request(self):
"""Handle a single HTTP request.
You normally don't need to override this method; see the class
__doc__ string for information on how to handle specific HTTP
commands such as GET and POST.
"""
try:
self.raw_requestline = self.rfile.readline(65537)
if len(self.raw_requestline) > 65536:
self.requestline = ''
self.request_version = ''
self.command = ''
self.send_error(414)
return
if not self.raw_requestline:
self.close_connection = 1
return
if not self.parse_request():
# An error code has been sent, just exit
return
mname = 'do_' + self.command
if not hasattr(self, mname):
self.send_error(501, "Unsupported method (%r)" % self.command)
return
method = getattr(self, mname)
method()
self.wfile.flush() #actually send the response if not already done.
except socket.timeout as e:
#a read or a write timed out. Discard this connection
self.log_error("Request timed out: %r", e)
self.close_connection = 1
return
def handle(self):
"""Handle multiple requests if necessary."""
self.close_connection = 1
self.handle_one_request()
while not self.close_connection:
self.handle_one_request()
def send_error(self, code, message=None):
"""Send and log an error reply.
Arguments are the error code, and a detailed message.
The detailed message defaults to the short entry matching the
response code.
This sends an error response (so it must be called before any
output has been generated), logs the error, and finally sends
a piece of HTML explaining the error to the user.
"""
try:
shortmsg, longmsg = self.responses[code]
except KeyError:
shortmsg, longmsg = '???', '???'
if message is None:
message = shortmsg
explain = longmsg
self.log_error("code %d, message %s", code, message)
# using _quote_html to prevent Cross Site Scripting attacks (see bug #1100201)
content = (self.error_message_format %
{'code': code, 'message': _quote_html(message), 'explain': explain})
self.send_response(code, message)
self.send_header("Content-Type", self.error_content_type)
self.send_header('Connection', 'close')
self.end_headers()
if self.command != 'HEAD' and code >= 200 and code not in (204, 304):
self.wfile.write(content.encode('UTF-8', 'replace'))
def send_response(self, code, message=None):
"""Add the response header to the headers buffer and log the
response code.
Also send two standard headers with the server software
version and the current date.
"""
self.log_request(code)
self.send_response_only(code, message)
self.send_header('Server', self.version_string())
self.send_header('Date', self.date_time_string())
def send_response_only(self, code, message=None):
"""Send the response header only."""
if message is None:
if code in self.responses:
message = self.responses[code][0]
else:
message = ''
if self.request_version != 'HTTP/0.9':
if not hasattr(self, '_headers_buffer'):
self._headers_buffer = []
self._headers_buffer.append(("%s %d %s\r\n" %
(self.protocol_version, code, message)).encode(
'latin-1', 'strict'))
def send_header(self, keyword, value):
"""Send a MIME header to the headers buffer."""
if self.request_version != 'HTTP/0.9':
if not hasattr(self, '_headers_buffer'):
self._headers_buffer = []
self._headers_buffer.append(
("%s: %s\r\n" % (keyword, value)).encode('latin-1', 'strict'))
if keyword.lower() == 'connection':
if value.lower() == 'close':
self.close_connection = 1
elif value.lower() == 'keep-alive':
self.close_connection = 0
def end_headers(self):
"""Send the blank line ending the MIME headers."""
if self.request_version != 'HTTP/0.9':
self._headers_buffer.append(b"\r\n")
self.flush_headers()
def flush_headers(self):
if hasattr(self, '_headers_buffer'):
self.wfile.write(b"".join(self._headers_buffer))
self._headers_buffer = []
def log_request(self, code='-', size='-'):
"""Log an accepted request.
This is called by send_response().
"""
self.log_message('"%s" %s %s',
self.requestline, str(code), str(size))
def log_error(self, format, *args):
"""Log an error.
This is called when a request cannot be fulfilled. By
default it passes the message on to log_message().
Arguments are the same as for log_message().
XXX This should go to the separate error log.
"""
self.log_message(format, *args)
def log_message(self, format, *args):
"""Log an arbitrary message.
This is used by all other logging functions. Override
it if you have specific logging wishes.
The first argument, FORMAT, is a format string for the
message to be logged. If the format string contains
any % escapes requiring parameters, they should be
specified as subsequent arguments (it's just like
printf!).
The client ip and current date/time are prefixed to
every message.
"""
sys.stderr.write("%s - - [%s] %s\n" %
(self.address_string(),
self.log_date_time_string(),
format%args))
def version_string(self):
"""Return the server software version string."""
return self.server_version + ' ' + self.sys_version
def date_time_string(self, timestamp=None):
"""Return the current date and time formatted for a message header."""
if timestamp is None:
timestamp = time.time()
year, month, day, hh, mm, ss, wd, y, z = time.gmtime(timestamp)
s = "%s, %02d %3s %4d %02d:%02d:%02d GMT" % (
self.weekdayname[wd],
day, self.monthname[month], year,
hh, mm, ss)
return s
def log_date_time_string(self):
"""Return the current time formatted for logging."""
now = time.time()
year, month, day, hh, mm, ss, x, y, z = time.localtime(now)
s = "%02d/%3s/%04d %02d:%02d:%02d" % (
day, self.monthname[month], year, hh, mm, ss)
return s
weekdayname = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
monthname = [None,
'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
def address_string(self):
"""Return the client address."""
return self.client_address[0]
# Essentially static class variables
# The version of the HTTP protocol we support.
# Set this to HTTP/1.1 to enable automatic keepalive
protocol_version = "HTTP/1.0"
# MessageClass used to parse headers
MessageClass = http_client.HTTPMessage
# Table mapping response codes to messages; entries have the
# form {code: (shortmessage, longmessage)}.
# See RFC 2616 and 6585.
responses = {
100: ('Continue', 'Request received, please continue'),
101: ('Switching Protocols',
'Switching to new protocol; obey Upgrade header'),
200: ('OK', 'Request fulfilled, document follows'),
201: ('Created', 'Document created, URL follows'),
202: ('Accepted',
'Request accepted, processing continues off-line'),
203: ('Non-Authoritative Information', 'Request fulfilled from cache'),
204: ('No Content', 'Request fulfilled, nothing follows'),
205: ('Reset Content', 'Clear input form for further input.'),
206: ('Partial Content', 'Partial content follows.'),
300: ('Multiple Choices',
'Object has several resources -- see URI list'),
301: ('Moved Permanently', 'Object moved permanently -- see URI list'),
302: ('Found', 'Object moved temporarily -- see URI list'),
303: ('See Other', 'Object moved -- see Method and URL list'),
304: ('Not Modified',
'Document has not changed since given time'),
305: ('Use Proxy',
'You must use proxy specified in Location to access this '
'resource.'),
307: ('Temporary Redirect',
'Object moved temporarily -- see URI list'),
400: ('Bad Request',
'Bad request syntax or unsupported method'),
401: ('Unauthorized',
'No permission -- see authorization schemes'),
402: ('Payment Required',
'No payment -- see charging schemes'),
403: ('Forbidden',
'Request forbidden -- authorization will not help'),
404: ('Not Found', 'Nothing matches the given URI'),
405: ('Method Not Allowed',
'Specified method is invalid for this resource.'),
406: ('Not Acceptable', 'URI not available in preferred format.'),
407: ('Proxy Authentication Required', 'You must authenticate with '
'this proxy before proceeding.'),
408: ('Request Timeout', 'Request timed out; try again later.'),
409: ('Conflict', 'Request conflict.'),
410: ('Gone',
'URI no longer exists and has been permanently removed.'),
411: ('Length Required', 'Client must specify Content-Length.'),
412: ('Precondition Failed', 'Precondition in headers is false.'),
413: ('Request Entity Too Large', 'Entity is too large.'),
414: ('Request-URI Too Long', 'URI is too long.'),
415: ('Unsupported Media Type', 'Entity body in unsupported format.'),
416: ('Requested Range Not Satisfiable',
'Cannot satisfy request range.'),
417: ('Expectation Failed',
'Expect condition could not be satisfied.'),
428: ('Precondition Required',
'The origin server requires the request to be conditional.'),
429: ('Too Many Requests', 'The user has sent too many requests '
'in a given amount of time ("rate limiting").'),
431: ('Request Header Fields Too Large', 'The server is unwilling to '
'process the request because its header fields are too large.'),
500: ('Internal Server Error', 'Server got itself in trouble'),
501: ('Not Implemented',
'Server does not support this operation'),
502: ('Bad Gateway', 'Invalid responses from another server/proxy.'),
503: ('Service Unavailable',
'The server cannot process the request due to a high load'),
504: ('Gateway Timeout',
'The gateway server did not receive a timely response'),
505: ('HTTP Version Not Supported', 'Cannot fulfill request.'),
511: ('Network Authentication Required',
'The client needs to authenticate to gain network access.'),
}
class SimpleHTTPRequestHandler(BaseHTTPRequestHandler):
"""Simple HTTP request handler with GET and HEAD commands.
This serves files from the current directory and any of its
subdirectories. The MIME type for files is determined by
calling the .guess_type() method.
The GET and HEAD requests are identical except that the HEAD
request omits the actual contents of the file.
"""
server_version = "SimpleHTTP/" + __version__
def do_GET(self):
"""Serve a GET request."""
f = self.send_head()
if f:
self.copyfile(f, self.wfile)
f.close()
def do_HEAD(self):
"""Serve a HEAD request."""
f = self.send_head()
if f:
f.close()
def send_head(self):
"""Common code for GET and HEAD commands.
This sends the response code and MIME headers.
Return value is either a file object (which has to be copied
to the outputfile by the caller unless the command was HEAD,
and must be closed by the caller under all circumstances), or
None, in which case the caller has nothing further to do.
"""
path = self.translate_path(self.path)
f = None
if os.path.isdir(path):
if not self.path.endswith('/'):
# redirect browser - doing basically what apache does
self.send_response(301)
self.send_header("Location", self.path + "/")
self.end_headers()
return None
for index in "index.html", "index.htm":
index = os.path.join(path, index)
if os.path.exists(index):
path = index
break
else:
return self.list_directory(path)
ctype = self.guess_type(path)
try:
f = open(path, 'rb')
except IOError:
self.send_error(404, "File not found")
return None
self.send_response(200)
self.send_header("Content-type", ctype)
fs = os.fstat(f.fileno())
self.send_header("Content-Length", str(fs[6]))
self.send_header("Last-Modified", self.date_time_string(fs.st_mtime))
self.end_headers()
return f
def list_directory(self, path):
"""Helper to produce a directory listing (absent index.html).
Return value is either a file object, or None (indicating an
error). In either case, the headers are sent, making the
interface the same as for send_head().
"""
try:
list = os.listdir(path)
except os.error:
self.send_error(404, "No permission to list directory")
return None
list.sort(key=lambda a: a.lower())
r = []
displaypath = html.escape(urllib_parse.unquote(self.path))
enc = sys.getfilesystemencoding()
title = 'Directory listing for %s' % displaypath
r.append('<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" '
'"http://www.w3.org/TR/html4/strict.dtd">')
r.append('<html>\n<head>')
r.append('<meta http-equiv="Content-Type" '
'content="text/html; charset=%s">' % enc)
r.append('<title>%s</title>\n</head>' % title)
r.append('<body>\n<h1>%s</h1>' % title)
r.append('<hr>\n<ul>')
for name in list:
fullname = os.path.join(path, name)
displayname = linkname = name
# Append / for directories or @ for symbolic links
if os.path.isdir(fullname):
displayname = name + "/"
linkname = name + "/"
if os.path.islink(fullname):
displayname = name + "@"
# Note: a link to a directory displays with @ and links with /
r.append('<li><a href="%s">%s</a></li>'
% (urllib_parse.quote(linkname), html.escape(displayname)))
# # Use this instead:
# r.append('<li><a href="%s">%s</a></li>'
# % (urllib.quote(linkname), cgi.escape(displayname)))
r.append('</ul>\n<hr>\n</body>\n</html>\n')
encoded = '\n'.join(r).encode(enc)
f = io.BytesIO()
f.write(encoded)
f.seek(0)
self.send_response(200)
self.send_header("Content-type", "text/html; charset=%s" % enc)
self.send_header("Content-Length", str(len(encoded)))
self.end_headers()
return f
def translate_path(self, path):
"""Translate a /-separated PATH to the local filename syntax.
Components that mean special things to the local file system
(e.g. drive or directory names) are ignored. (XXX They should
probably be diagnosed.)
"""
# abandon query parameters
path = path.split('?',1)[0]
path = path.split('#',1)[0]
path = posixpath.normpath(urllib_parse.unquote(path))
words = path.split('/')
words = filter(None, words)
path = os.getcwd()
for word in words:
drive, word = os.path.splitdrive(word)
head, word = os.path.split(word)
if word in (os.curdir, os.pardir): continue
path = os.path.join(path, word)
return path
def copyfile(self, source, outputfile):
"""Copy all data between two file objects.
The SOURCE argument is a file object open for reading
(or anything with a read() method) and the DESTINATION
argument is a file object open for writing (or
anything with a write() method).
The only reason for overriding this would be to change
the block size or perhaps to replace newlines by CRLF
-- note however that this the default server uses this
to copy binary data as well.
"""
shutil.copyfileobj(source, outputfile)
def guess_type(self, path):
"""Guess the type of a file.
Argument is a PATH (a filename).
Return value is a string of the form type/subtype,
usable for a MIME Content-type header.
The default implementation looks the file's extension
up in the table self.extensions_map, using application/octet-stream
as a default; however it would be permissible (if
slow) to look inside the data to make a better guess.
"""
base, ext = posixpath.splitext(path)
if ext in self.extensions_map:
return self.extensions_map[ext]
ext = ext.lower()
if ext in self.extensions_map:
return self.extensions_map[ext]
else:
return self.extensions_map['']
if not mimetypes.inited:
mimetypes.init() # try to read system mime.types
extensions_map = mimetypes.types_map.copy()
extensions_map.update({
'': 'application/octet-stream', # Default
'.py': 'text/plain',
'.c': 'text/plain',
'.h': 'text/plain',
})
# Utilities for CGIHTTPRequestHandler
def _url_collapse_path(path):
"""
Given a URL path, remove extra '/'s and '.' path elements and collapse
any '..' references and returns a colllapsed path.
Implements something akin to RFC-2396 5.2 step 6 to parse relative paths.
The utility of this function is limited to is_cgi method and helps
preventing some security attacks.
Returns: A tuple of (head, tail) where tail is everything after the final /
and head is everything before it. Head will always start with a '/' and,
if it contains anything else, never have a trailing '/'.
Raises: IndexError if too many '..' occur within the path.
"""
# Similar to os.path.split(os.path.normpath(path)) but specific to URL
# path semantics rather than local operating system semantics.
path_parts = path.split('/')
head_parts = []
for part in path_parts[:-1]:
if part == '..':
head_parts.pop() # IndexError if more '..' than prior parts
elif part and part != '.':
head_parts.append( part )
if path_parts:
tail_part = path_parts.pop()
if tail_part:
if tail_part == '..':
head_parts.pop()
tail_part = ''
elif tail_part == '.':
tail_part = ''
else:
tail_part = ''
splitpath = ('/' + '/'.join(head_parts), tail_part)
collapsed_path = "/".join(splitpath)
return collapsed_path
nobody = None
def nobody_uid():
"""Internal routine to get nobody's uid"""
global nobody
if nobody:
return nobody
try:
import pwd
except ImportError:
return -1
try:
nobody = pwd.getpwnam('nobody')[2]
except KeyError:
nobody = 1 + max(x[2] for x in pwd.getpwall())
return nobody
def executable(path):
"""Test for executable file."""
return os.access(path, os.X_OK)
class CGIHTTPRequestHandler(SimpleHTTPRequestHandler):
"""Complete HTTP server with GET, HEAD and POST commands.
GET and HEAD also support running CGI scripts.
The POST command is *only* implemented for CGI scripts.
"""
# Determine platform specifics
have_fork = hasattr(os, 'fork')
# Make rfile unbuffered -- we need to read one line and then pass
# the rest to a subprocess, so we can't use buffered input.
rbufsize = 0
def do_POST(self):
"""Serve a POST request.
This is only implemented for CGI scripts.
"""
if self.is_cgi():
self.run_cgi()
else:
self.send_error(501, "Can only POST to CGI scripts")
def send_head(self):
"""Version of send_head that support CGI scripts"""
if self.is_cgi():
return self.run_cgi()
else:
return SimpleHTTPRequestHandler.send_head(self)
def is_cgi(self):
"""Test whether self.path corresponds to a CGI script.
Returns True and updates the cgi_info attribute to the tuple
(dir, rest) if self.path requires running a CGI script.
Returns False otherwise.
If any exception is raised, the caller should assume that
self.path was rejected as invalid and act accordingly.
The default implementation tests whether the normalized url
path begins with one of the strings in self.cgi_directories
(and the next character is a '/' or the end of the string).
"""
collapsed_path = _url_collapse_path(self.path)
dir_sep = collapsed_path.find('/', 1)
head, tail = collapsed_path[:dir_sep], collapsed_path[dir_sep+1:]
if head in self.cgi_directories:
self.cgi_info = head, tail
return True
return False
cgi_directories = ['/cgi-bin', '/htbin']
def is_executable(self, path):
"""Test whether argument path is an executable file."""
return executable(path)
def is_python(self, path):
"""Test whether argument path is a Python script."""
head, tail = os.path.splitext(path)
return tail.lower() in (".py", ".pyw")
def run_cgi(self):
"""Execute a CGI script."""
path = self.path
dir, rest = self.cgi_info
i = path.find('/', len(dir) + 1)
while i >= 0:
nextdir = path[:i]
nextrest = path[i+1:]
scriptdir = self.translate_path(nextdir)
if os.path.isdir(scriptdir):
dir, rest = nextdir, nextrest
i = path.find('/', len(dir) + 1)
else:
break
# find an explicit query string, if present.
i = rest.rfind('?')
if i >= 0:
rest, query = rest[:i], rest[i+1:]
else:
query = ''
# dissect the part after the directory name into a script name &
# a possible additional path, to be stored in PATH_INFO.
i = rest.find('/')
if i >= 0:
script, rest = rest[:i], rest[i:]
else:
script, rest = rest, ''
scriptname = dir + '/' + script
scriptfile = self.translate_path(scriptname)
if not os.path.exists(scriptfile):
self.send_error(404, "No such CGI script (%r)" % scriptname)
return
if not os.path.isfile(scriptfile):
self.send_error(403, "CGI script is not a plain file (%r)" %
scriptname)
return
ispy = self.is_python(scriptname)
if self.have_fork or not ispy:
if not self.is_executable(scriptfile):
self.send_error(403, "CGI script is not executable (%r)" %
scriptname)
return
# Reference: http://hoohoo.ncsa.uiuc.edu/cgi/env.html
# XXX Much of the following could be prepared ahead of time!
env = copy.deepcopy(os.environ)
env['SERVER_SOFTWARE'] = self.version_string()
env['SERVER_NAME'] = self.server.server_name
env['GATEWAY_INTERFACE'] = 'CGI/1.1'
env['SERVER_PROTOCOL'] = self.protocol_version
env['SERVER_PORT'] = str(self.server.server_port)
env['REQUEST_METHOD'] = self.command
uqrest = urllib_parse.unquote(rest)
env['PATH_INFO'] = uqrest
env['PATH_TRANSLATED'] = self.translate_path(uqrest)
env['SCRIPT_NAME'] = scriptname
if query:
env['QUERY_STRING'] = query
env['REMOTE_ADDR'] = self.client_address[0]
authorization = self.headers.get("authorization")
if authorization:
authorization = authorization.split()
if len(authorization) == 2:
import base64, binascii
env['AUTH_TYPE'] = authorization[0]
if authorization[0].lower() == "basic":
try:
authorization = authorization[1].encode('ascii')
if utils.PY3:
# In Py3.3, was:
authorization = base64.decodebytes(authorization).\
decode('ascii')
else:
# Backport to Py2.7:
authorization = base64.decodestring(authorization).\
decode('ascii')
except (binascii.Error, UnicodeError):
pass
else:
authorization = authorization.split(':')
if len(authorization) == 2:
env['REMOTE_USER'] = authorization[0]
# XXX REMOTE_IDENT
if self.headers.get('content-type') is None:
env['CONTENT_TYPE'] = self.headers.get_content_type()
else:
env['CONTENT_TYPE'] = self.headers['content-type']
length = self.headers.get('content-length')
if length:
env['CONTENT_LENGTH'] = length
referer = self.headers.get('referer')
if referer:
env['HTTP_REFERER'] = referer
accept = []
for line in self.headers.getallmatchingheaders('accept'):
if line[:1] in "\t\n\r ":
accept.append(line.strip())
else:
accept = accept + line[7:].split(',')
env['HTTP_ACCEPT'] = ','.join(accept)
ua = self.headers.get('user-agent')
if ua:
env['HTTP_USER_AGENT'] = ua
co = filter(None, self.headers.get_all('cookie', []))
cookie_str = ', '.join(co)
if cookie_str:
env['HTTP_COOKIE'] = cookie_str
# XXX Other HTTP_* headers
# Since we're setting the env in the parent, provide empty
# values to override previously set values
for k in ('QUERY_STRING', 'REMOTE_HOST', 'CONTENT_LENGTH',
'HTTP_USER_AGENT', 'HTTP_COOKIE', 'HTTP_REFERER'):
env.setdefault(k, "")
self.send_response(200, "Script output follows")
self.flush_headers()
decoded_query = query.replace('+', ' ')
if self.have_fork:
# Unix -- fork as we should
args = [script]
if '=' not in decoded_query:
args.append(decoded_query)
nobody = nobody_uid()
self.wfile.flush() # Always flush before forking
pid = os.fork()
if pid != 0:
# Parent
pid, sts = os.waitpid(pid, 0)
# throw away additional data [see bug #427345]
while select.select([self.rfile], [], [], 0)[0]:
if not self.rfile.read(1):
break
if sts:
self.log_error("CGI script exit status %#x", sts)
return
# Child
try:
try:
os.setuid(nobody)
except os.error:
pass
os.dup2(self.rfile.fileno(), 0)
os.dup2(self.wfile.fileno(), 1)
os.execve(scriptfile, args, env)
except:
self.server.handle_error(self.request, self.client_address)
os._exit(127)
else:
# Non-Unix -- use subprocess
import subprocess
cmdline = [scriptfile]
if self.is_python(scriptfile):
interp = sys.executable
if interp.lower().endswith("w.exe"):
# On Windows, use python.exe, not pythonw.exe
interp = interp[:-5] + interp[-4:]
cmdline = [interp, '-u'] + cmdline
if '=' not in query:
cmdline.append(query)
self.log_message("command: %s", subprocess.list2cmdline(cmdline))
try:
nbytes = int(length)
except (TypeError, ValueError):
nbytes = 0
p = subprocess.Popen(cmdline,
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
env = env
)
if self.command.lower() == "post" and nbytes > 0:
data = self.rfile.read(nbytes)
else:
data = None
# throw away additional data [see bug #427345]
while select.select([self.rfile._sock], [], [], 0)[0]:
if not self.rfile._sock.recv(1):
break
stdout, stderr = p.communicate(data)
self.wfile.write(stdout)
if stderr:
self.log_error('%s', stderr)
p.stderr.close()
p.stdout.close()
status = p.returncode
if status:
self.log_error("CGI script exit status %#x", status)
else:
self.log_message("CGI script exited OK")
def test(HandlerClass = BaseHTTPRequestHandler,
ServerClass = HTTPServer, protocol="HTTP/1.0", port=8000):
"""Test the HTTP request handler class.
This runs an HTTP server on port 8000 (or the first command line
argument).
"""
server_address = ('', port)
HandlerClass.protocol_version = protocol
httpd = ServerClass(server_address, HandlerClass)
sa = httpd.socket.getsockname()
print("Serving HTTP on", sa[0], "port", sa[1], "...")
try:
httpd.serve_forever()
except KeyboardInterrupt:
print("\nKeyboard interrupt received, exiting.")
httpd.server_close()
sys.exit(0)
if __name__ == '__main__':
parser = argparse.ArgumentParser()
parser.add_argument('--cgi', action='store_true',
help='Run as CGI Server')
parser.add_argument('port', action='store',
default=8000, type=int,
nargs='?',
help='Specify alternate port [default: 8000]')
args = parser.parse_args()
if args.cgi:
test(HandlerClass=CGIHTTPRequestHandler, port=args.port)
else:
test(HandlerClass=SimpleHTTPRequestHandler, port=args.port)
PK �Cu\\�m�& �& ! future/backports/html/entities.pynu �[��� """HTML character entity references.
Backported for python-future from Python 3.3
"""
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from future.builtins import *
# maps the HTML entity name to the Unicode codepoint
name2codepoint = {
'AElig': 0x00c6, # latin capital letter AE = latin capital ligature AE, U+00C6 ISOlat1
'Aacute': 0x00c1, # latin capital letter A with acute, U+00C1 ISOlat1
'Acirc': 0x00c2, # latin capital letter A with circumflex, U+00C2 ISOlat1
'Agrave': 0x00c0, # latin capital letter A with grave = latin capital letter A grave, U+00C0 ISOlat1
'Alpha': 0x0391, # greek capital letter alpha, U+0391
'Aring': 0x00c5, # latin capital letter A with ring above = latin capital letter A ring, U+00C5 ISOlat1
'Atilde': 0x00c3, # latin capital letter A with tilde, U+00C3 ISOlat1
'Auml': 0x00c4, # latin capital letter A with diaeresis, U+00C4 ISOlat1
'Beta': 0x0392, # greek capital letter beta, U+0392
'Ccedil': 0x00c7, # latin capital letter C with cedilla, U+00C7 ISOlat1
'Chi': 0x03a7, # greek capital letter chi, U+03A7
'Dagger': 0x2021, # double dagger, U+2021 ISOpub
'Delta': 0x0394, # greek capital letter delta, U+0394 ISOgrk3
'ETH': 0x00d0, # latin capital letter ETH, U+00D0 ISOlat1
'Eacute': 0x00c9, # latin capital letter E with acute, U+00C9 ISOlat1
'Ecirc': 0x00ca, # latin capital letter E with circumflex, U+00CA ISOlat1
'Egrave': 0x00c8, # latin capital letter E with grave, U+00C8 ISOlat1
'Epsilon': 0x0395, # greek capital letter epsilon, U+0395
'Eta': 0x0397, # greek capital letter eta, U+0397
'Euml': 0x00cb, # latin capital letter E with diaeresis, U+00CB ISOlat1
'Gamma': 0x0393, # greek capital letter gamma, U+0393 ISOgrk3
'Iacute': 0x00cd, # latin capital letter I with acute, U+00CD ISOlat1
'Icirc': 0x00ce, # latin capital letter I with circumflex, U+00CE ISOlat1
'Igrave': 0x00cc, # latin capital letter I with grave, U+00CC ISOlat1
'Iota': 0x0399, # greek capital letter iota, U+0399
'Iuml': 0x00cf, # latin capital letter I with diaeresis, U+00CF ISOlat1
'Kappa': 0x039a, # greek capital letter kappa, U+039A
'Lambda': 0x039b, # greek capital letter lambda, U+039B ISOgrk3
'Mu': 0x039c, # greek capital letter mu, U+039C
'Ntilde': 0x00d1, # latin capital letter N with tilde, U+00D1 ISOlat1
'Nu': 0x039d, # greek capital letter nu, U+039D
'OElig': 0x0152, # latin capital ligature OE, U+0152 ISOlat2
'Oacute': 0x00d3, # latin capital letter O with acute, U+00D3 ISOlat1
'Ocirc': 0x00d4, # latin capital letter O with circumflex, U+00D4 ISOlat1
'Ograve': 0x00d2, # latin capital letter O with grave, U+00D2 ISOlat1
'Omega': 0x03a9, # greek capital letter omega, U+03A9 ISOgrk3
'Omicron': 0x039f, # greek capital letter omicron, U+039F
'Oslash': 0x00d8, # latin capital letter O with stroke = latin capital letter O slash, U+00D8 ISOlat1
'Otilde': 0x00d5, # latin capital letter O with tilde, U+00D5 ISOlat1
'Ouml': 0x00d6, # latin capital letter O with diaeresis, U+00D6 ISOlat1
'Phi': 0x03a6, # greek capital letter phi, U+03A6 ISOgrk3
'Pi': 0x03a0, # greek capital letter pi, U+03A0 ISOgrk3
'Prime': 0x2033, # double prime = seconds = inches, U+2033 ISOtech
'Psi': 0x03a8, # greek capital letter psi, U+03A8 ISOgrk3
'Rho': 0x03a1, # greek capital letter rho, U+03A1
'Scaron': 0x0160, # latin capital letter S with caron, U+0160 ISOlat2
'Sigma': 0x03a3, # greek capital letter sigma, U+03A3 ISOgrk3
'THORN': 0x00de, # latin capital letter THORN, U+00DE ISOlat1
'Tau': 0x03a4, # greek capital letter tau, U+03A4
'Theta': 0x0398, # greek capital letter theta, U+0398 ISOgrk3
'Uacute': 0x00da, # latin capital letter U with acute, U+00DA ISOlat1
'Ucirc': 0x00db, # latin capital letter U with circumflex, U+00DB ISOlat1
'Ugrave': 0x00d9, # latin capital letter U with grave, U+00D9 ISOlat1
'Upsilon': 0x03a5, # greek capital letter upsilon, U+03A5 ISOgrk3
'Uuml': 0x00dc, # latin capital letter U with diaeresis, U+00DC ISOlat1
'Xi': 0x039e, # greek capital letter xi, U+039E ISOgrk3
'Yacute': 0x00dd, # latin capital letter Y with acute, U+00DD ISOlat1
'Yuml': 0x0178, # latin capital letter Y with diaeresis, U+0178 ISOlat2
'Zeta': 0x0396, # greek capital letter zeta, U+0396
'aacute': 0x00e1, # latin small letter a with acute, U+00E1 ISOlat1
'acirc': 0x00e2, # latin small letter a with circumflex, U+00E2 ISOlat1
'acute': 0x00b4, # acute accent = spacing acute, U+00B4 ISOdia
'aelig': 0x00e6, # latin small letter ae = latin small ligature ae, U+00E6 ISOlat1
'agrave': 0x00e0, # latin small letter a with grave = latin small letter a grave, U+00E0 ISOlat1
'alefsym': 0x2135, # alef symbol = first transfinite cardinal, U+2135 NEW
'alpha': 0x03b1, # greek small letter alpha, U+03B1 ISOgrk3
'amp': 0x0026, # ampersand, U+0026 ISOnum
'and': 0x2227, # logical and = wedge, U+2227 ISOtech
'ang': 0x2220, # angle, U+2220 ISOamso
'aring': 0x00e5, # latin small letter a with ring above = latin small letter a ring, U+00E5 ISOlat1
'asymp': 0x2248, # almost equal to = asymptotic to, U+2248 ISOamsr
'atilde': 0x00e3, # latin small letter a with tilde, U+00E3 ISOlat1
'auml': 0x00e4, # latin small letter a with diaeresis, U+00E4 ISOlat1
'bdquo': 0x201e, # double low-9 quotation mark, U+201E NEW
'beta': 0x03b2, # greek small letter beta, U+03B2 ISOgrk3
'brvbar': 0x00a6, # broken bar = broken vertical bar, U+00A6 ISOnum
'bull': 0x2022, # bullet = black small circle, U+2022 ISOpub
'cap': 0x2229, # intersection = cap, U+2229 ISOtech
'ccedil': 0x00e7, # latin small letter c with cedilla, U+00E7 ISOlat1
'cedil': 0x00b8, # cedilla = spacing cedilla, U+00B8 ISOdia
'cent': 0x00a2, # cent sign, U+00A2 ISOnum
'chi': 0x03c7, # greek small letter chi, U+03C7 ISOgrk3
'circ': 0x02c6, # modifier letter circumflex accent, U+02C6 ISOpub
'clubs': 0x2663, # black club suit = shamrock, U+2663 ISOpub
'cong': 0x2245, # approximately equal to, U+2245 ISOtech
'copy': 0x00a9, # copyright sign, U+00A9 ISOnum
'crarr': 0x21b5, # downwards arrow with corner leftwards = carriage return, U+21B5 NEW
'cup': 0x222a, # union = cup, U+222A ISOtech
'curren': 0x00a4, # currency sign, U+00A4 ISOnum
'dArr': 0x21d3, # downwards double arrow, U+21D3 ISOamsa
'dagger': 0x2020, # dagger, U+2020 ISOpub
'darr': 0x2193, # downwards arrow, U+2193 ISOnum
'deg': 0x00b0, # degree sign, U+00B0 ISOnum
'delta': 0x03b4, # greek small letter delta, U+03B4 ISOgrk3
'diams': 0x2666, # black diamond suit, U+2666 ISOpub
'divide': 0x00f7, # division sign, U+00F7 ISOnum
'eacute': 0x00e9, # latin small letter e with acute, U+00E9 ISOlat1
'ecirc': 0x00ea, # latin small letter e with circumflex, U+00EA ISOlat1
'egrave': 0x00e8, # latin small letter e with grave, U+00E8 ISOlat1
'empty': 0x2205, # empty set = null set = diameter, U+2205 ISOamso
'emsp': 0x2003, # em space, U+2003 ISOpub
'ensp': 0x2002, # en space, U+2002 ISOpub
'epsilon': 0x03b5, # greek small letter epsilon, U+03B5 ISOgrk3
'equiv': 0x2261, # identical to, U+2261 ISOtech
'eta': 0x03b7, # greek small letter eta, U+03B7 ISOgrk3
'eth': 0x00f0, # latin small letter eth, U+00F0 ISOlat1
'euml': 0x00eb, # latin small letter e with diaeresis, U+00EB ISOlat1
'euro': 0x20ac, # euro sign, U+20AC NEW
'exist': 0x2203, # there exists, U+2203 ISOtech
'fnof': 0x0192, # latin small f with hook = function = florin, U+0192 ISOtech
'forall': 0x2200, # for all, U+2200 ISOtech
'frac12': 0x00bd, # vulgar fraction one half = fraction one half, U+00BD ISOnum
'frac14': 0x00bc, # vulgar fraction one quarter = fraction one quarter, U+00BC ISOnum
'frac34': 0x00be, # vulgar fraction three quarters = fraction three quarters, U+00BE ISOnum
'frasl': 0x2044, # fraction slash, U+2044 NEW
'gamma': 0x03b3, # greek small letter gamma, U+03B3 ISOgrk3
'ge': 0x2265, # greater-than or equal to, U+2265 ISOtech
'gt': 0x003e, # greater-than sign, U+003E ISOnum
'hArr': 0x21d4, # left right double arrow, U+21D4 ISOamsa
'harr': 0x2194, # left right arrow, U+2194 ISOamsa
'hearts': 0x2665, # black heart suit = valentine, U+2665 ISOpub
'hellip': 0x2026, # horizontal ellipsis = three dot leader, U+2026 ISOpub
'iacute': 0x00ed, # latin small letter i with acute, U+00ED ISOlat1
'icirc': 0x00ee, # latin small letter i with circumflex, U+00EE ISOlat1
'iexcl': 0x00a1, # inverted exclamation mark, U+00A1 ISOnum
'igrave': 0x00ec, # latin small letter i with grave, U+00EC ISOlat1
'image': 0x2111, # blackletter capital I = imaginary part, U+2111 ISOamso
'infin': 0x221e, # infinity, U+221E ISOtech
'int': 0x222b, # integral, U+222B ISOtech
'iota': 0x03b9, # greek small letter iota, U+03B9 ISOgrk3
'iquest': 0x00bf, # inverted question mark = turned question mark, U+00BF ISOnum
'isin': 0x2208, # element of, U+2208 ISOtech
'iuml': 0x00ef, # latin small letter i with diaeresis, U+00EF ISOlat1
'kappa': 0x03ba, # greek small letter kappa, U+03BA ISOgrk3
'lArr': 0x21d0, # leftwards double arrow, U+21D0 ISOtech
'lambda': 0x03bb, # greek small letter lambda, U+03BB ISOgrk3
'lang': 0x2329, # left-pointing angle bracket = bra, U+2329 ISOtech
'laquo': 0x00ab, # left-pointing double angle quotation mark = left pointing guillemet, U+00AB ISOnum
'larr': 0x2190, # leftwards arrow, U+2190 ISOnum
'lceil': 0x2308, # left ceiling = apl upstile, U+2308 ISOamsc
'ldquo': 0x201c, # left double quotation mark, U+201C ISOnum
'le': 0x2264, # less-than or equal to, U+2264 ISOtech
'lfloor': 0x230a, # left floor = apl downstile, U+230A ISOamsc
'lowast': 0x2217, # asterisk operator, U+2217 ISOtech
'loz': 0x25ca, # lozenge, U+25CA ISOpub
'lrm': 0x200e, # left-to-right mark, U+200E NEW RFC 2070
'lsaquo': 0x2039, # single left-pointing angle quotation mark, U+2039 ISO proposed
'lsquo': 0x2018, # left single quotation mark, U+2018 ISOnum
'lt': 0x003c, # less-than sign, U+003C ISOnum
'macr': 0x00af, # macron = spacing macron = overline = APL overbar, U+00AF ISOdia
'mdash': 0x2014, # em dash, U+2014 ISOpub
'micro': 0x00b5, # micro sign, U+00B5 ISOnum
'middot': 0x00b7, # middle dot = Georgian comma = Greek middle dot, U+00B7 ISOnum
'minus': 0x2212, # minus sign, U+2212 ISOtech
'mu': 0x03bc, # greek small letter mu, U+03BC ISOgrk3
'nabla': 0x2207, # nabla = backward difference, U+2207 ISOtech
'nbsp': 0x00a0, # no-break space = non-breaking space, U+00A0 ISOnum
'ndash': 0x2013, # en dash, U+2013 ISOpub
'ne': 0x2260, # not equal to, U+2260 ISOtech
'ni': 0x220b, # contains as member, U+220B ISOtech
'not': 0x00ac, # not sign, U+00AC ISOnum
'notin': 0x2209, # not an element of, U+2209 ISOtech
'nsub': 0x2284, # not a subset of, U+2284 ISOamsn
'ntilde': 0x00f1, # latin small letter n with tilde, U+00F1 ISOlat1
'nu': 0x03bd, # greek small letter nu, U+03BD ISOgrk3
'oacute': 0x00f3, # latin small letter o with acute, U+00F3 ISOlat1
'ocirc': 0x00f4, # latin small letter o with circumflex, U+00F4 ISOlat1
'oelig': 0x0153, # latin small ligature oe, U+0153 ISOlat2
'ograve': 0x00f2, # latin small letter o with grave, U+00F2 ISOlat1
'oline': 0x203e, # overline = spacing overscore, U+203E NEW
'omega': 0x03c9, # greek small letter omega, U+03C9 ISOgrk3
'omicron': 0x03bf, # greek small letter omicron, U+03BF NEW
'oplus': 0x2295, # circled plus = direct sum, U+2295 ISOamsb
'or': 0x2228, # logical or = vee, U+2228 ISOtech
'ordf': 0x00aa, # feminine ordinal indicator, U+00AA ISOnum
'ordm': 0x00ba, # masculine ordinal indicator, U+00BA ISOnum
'oslash': 0x00f8, # latin small letter o with stroke, = latin small letter o slash, U+00F8 ISOlat1
'otilde': 0x00f5, # latin small letter o with tilde, U+00F5 ISOlat1
'otimes': 0x2297, # circled times = vector product, U+2297 ISOamsb
'ouml': 0x00f6, # latin small letter o with diaeresis, U+00F6 ISOlat1
'para': 0x00b6, # pilcrow sign = paragraph sign, U+00B6 ISOnum
'part': 0x2202, # partial differential, U+2202 ISOtech
'permil': 0x2030, # per mille sign, U+2030 ISOtech
'perp': 0x22a5, # up tack = orthogonal to = perpendicular, U+22A5 ISOtech
'phi': 0x03c6, # greek small letter phi, U+03C6 ISOgrk3
'pi': 0x03c0, # greek small letter pi, U+03C0 ISOgrk3
'piv': 0x03d6, # greek pi symbol, U+03D6 ISOgrk3
'plusmn': 0x00b1, # plus-minus sign = plus-or-minus sign, U+00B1 ISOnum
'pound': 0x00a3, # pound sign, U+00A3 ISOnum
'prime': 0x2032, # prime = minutes = feet, U+2032 ISOtech
'prod': 0x220f, # n-ary product = product sign, U+220F ISOamsb
'prop': 0x221d, # proportional to, U+221D ISOtech
'psi': 0x03c8, # greek small letter psi, U+03C8 ISOgrk3
'quot': 0x0022, # quotation mark = APL quote, U+0022 ISOnum
'rArr': 0x21d2, # rightwards double arrow, U+21D2 ISOtech
'radic': 0x221a, # square root = radical sign, U+221A ISOtech
'rang': 0x232a, # right-pointing angle bracket = ket, U+232A ISOtech
'raquo': 0x00bb, # right-pointing double angle quotation mark = right pointing guillemet, U+00BB ISOnum
'rarr': 0x2192, # rightwards arrow, U+2192 ISOnum
'rceil': 0x2309, # right ceiling, U+2309 ISOamsc
'rdquo': 0x201d, # right double quotation mark, U+201D ISOnum
'real': 0x211c, # blackletter capital R = real part symbol, U+211C ISOamso
'reg': 0x00ae, # registered sign = registered trade mark sign, U+00AE ISOnum
'rfloor': 0x230b, # right floor, U+230B ISOamsc
'rho': 0x03c1, # greek small letter rho, U+03C1 ISOgrk3
'rlm': 0x200f, # right-to-left mark, U+200F NEW RFC 2070
'rsaquo': 0x203a, # single right-pointing angle quotation mark, U+203A ISO proposed
'rsquo': 0x2019, # right single quotation mark, U+2019 ISOnum
'sbquo': 0x201a, # single low-9 quotation mark, U+201A NEW
'scaron': 0x0161, # latin small letter s with caron, U+0161 ISOlat2
'sdot': 0x22c5, # dot operator, U+22C5 ISOamsb
'sect': 0x00a7, # section sign, U+00A7 ISOnum
'shy': 0x00ad, # soft hyphen = discretionary hyphen, U+00AD ISOnum
'sigma': 0x03c3, # greek small letter sigma, U+03C3 ISOgrk3
'sigmaf': 0x03c2, # greek small letter final sigma, U+03C2 ISOgrk3
'sim': 0x223c, # tilde operator = varies with = similar to, U+223C ISOtech
'spades': 0x2660, # black spade suit, U+2660 ISOpub
'sub': 0x2282, # subset of, U+2282 ISOtech
'sube': 0x2286, # subset of or equal to, U+2286 ISOtech
'sum': 0x2211, # n-ary sumation, U+2211 ISOamsb
'sup': 0x2283, # superset of, U+2283 ISOtech
'sup1': 0x00b9, # superscript one = superscript digit one, U+00B9 ISOnum
'sup2': 0x00b2, # superscript two = superscript digit two = squared, U+00B2 ISOnum
'sup3': 0x00b3, # superscript three = superscript digit three = cubed, U+00B3 ISOnum
'supe': 0x2287, # superset of or equal to, U+2287 ISOtech
'szlig': 0x00df, # latin small letter sharp s = ess-zed, U+00DF ISOlat1
'tau': 0x03c4, # greek small letter tau, U+03C4 ISOgrk3
'there4': 0x2234, # therefore, U+2234 ISOtech
'theta': 0x03b8, # greek small letter theta, U+03B8 ISOgrk3
'thetasym': 0x03d1, # greek small letter theta symbol, U+03D1 NEW
'thinsp': 0x2009, # thin space, U+2009 ISOpub
'thorn': 0x00fe, # latin small letter thorn with, U+00FE ISOlat1
'tilde': 0x02dc, # small tilde, U+02DC ISOdia
'times': 0x00d7, # multiplication sign, U+00D7 ISOnum
'trade': 0x2122, # trade mark sign, U+2122 ISOnum
'uArr': 0x21d1, # upwards double arrow, U+21D1 ISOamsa
'uacute': 0x00fa, # latin small letter u with acute, U+00FA ISOlat1
'uarr': 0x2191, # upwards arrow, U+2191 ISOnum
'ucirc': 0x00fb, # latin small letter u with circumflex, U+00FB ISOlat1
'ugrave': 0x00f9, # latin small letter u with grave, U+00F9 ISOlat1
'uml': 0x00a8, # diaeresis = spacing diaeresis, U+00A8 ISOdia
'upsih': 0x03d2, # greek upsilon with hook symbol, U+03D2 NEW
'upsilon': 0x03c5, # greek small letter upsilon, U+03C5 ISOgrk3
'uuml': 0x00fc, # latin small letter u with diaeresis, U+00FC ISOlat1
'weierp': 0x2118, # script capital P = power set = Weierstrass p, U+2118 ISOamso
'xi': 0x03be, # greek small letter xi, U+03BE ISOgrk3
'yacute': 0x00fd, # latin small letter y with acute, U+00FD ISOlat1
'yen': 0x00a5, # yen sign = yuan sign, U+00A5 ISOnum
'yuml': 0x00ff, # latin small letter y with diaeresis, U+00FF ISOlat1
'zeta': 0x03b6, # greek small letter zeta, U+03B6 ISOgrk3
'zwj': 0x200d, # zero width joiner, U+200D NEW RFC 2070
'zwnj': 0x200c, # zero width non-joiner, U+200C NEW RFC 2070
}
# maps the HTML5 named character references to the equivalent Unicode character(s)
html5 = {
'Aacute': '\xc1',
'aacute': '\xe1',
'Aacute;': '\xc1',
'aacute;': '\xe1',
'Abreve;': '\u0102',
'abreve;': '\u0103',
'ac;': '\u223e',
'acd;': '\u223f',
'acE;': '\u223e\u0333',
'Acirc': '\xc2',
'acirc': '\xe2',
'Acirc;': '\xc2',
'acirc;': '\xe2',
'acute': '\xb4',
'acute;': '\xb4',
'Acy;': '\u0410',
'acy;': '\u0430',
'AElig': '\xc6',
'aelig': '\xe6',
'AElig;': '\xc6',
'aelig;': '\xe6',
'af;': '\u2061',
'Afr;': '\U0001d504',
'afr;': '\U0001d51e',
'Agrave': '\xc0',
'agrave': '\xe0',
'Agrave;': '\xc0',
'agrave;': '\xe0',
'alefsym;': '\u2135',
'aleph;': '\u2135',
'Alpha;': '\u0391',
'alpha;': '\u03b1',
'Amacr;': '\u0100',
'amacr;': '\u0101',
'amalg;': '\u2a3f',
'AMP': '&',
'amp': '&',
'AMP;': '&',
'amp;': '&',
'And;': '\u2a53',
'and;': '\u2227',
'andand;': '\u2a55',
'andd;': '\u2a5c',
'andslope;': '\u2a58',
'andv;': '\u2a5a',
'ang;': '\u2220',
'ange;': '\u29a4',
'angle;': '\u2220',
'angmsd;': '\u2221',
'angmsdaa;': '\u29a8',
'angmsdab;': '\u29a9',
'angmsdac;': '\u29aa',
'angmsdad;': '\u29ab',
'angmsdae;': '\u29ac',
'angmsdaf;': '\u29ad',
'angmsdag;': '\u29ae',
'angmsdah;': '\u29af',
'angrt;': '\u221f',
'angrtvb;': '\u22be',
'angrtvbd;': '\u299d',
'angsph;': '\u2222',
'angst;': '\xc5',
'angzarr;': '\u237c',
'Aogon;': '\u0104',
'aogon;': '\u0105',
'Aopf;': '\U0001d538',
'aopf;': '\U0001d552',
'ap;': '\u2248',
'apacir;': '\u2a6f',
'apE;': '\u2a70',
'ape;': '\u224a',
'apid;': '\u224b',
'apos;': "'",
'ApplyFunction;': '\u2061',
'approx;': '\u2248',
'approxeq;': '\u224a',
'Aring': '\xc5',
'aring': '\xe5',
'Aring;': '\xc5',
'aring;': '\xe5',
'Ascr;': '\U0001d49c',
'ascr;': '\U0001d4b6',
'Assign;': '\u2254',
'ast;': '*',
'asymp;': '\u2248',
'asympeq;': '\u224d',
'Atilde': '\xc3',
'atilde': '\xe3',
'Atilde;': '\xc3',
'atilde;': '\xe3',
'Auml': '\xc4',
'auml': '\xe4',
'Auml;': '\xc4',
'auml;': '\xe4',
'awconint;': '\u2233',
'awint;': '\u2a11',
'backcong;': '\u224c',
'backepsilon;': '\u03f6',
'backprime;': '\u2035',
'backsim;': '\u223d',
'backsimeq;': '\u22cd',
'Backslash;': '\u2216',
'Barv;': '\u2ae7',
'barvee;': '\u22bd',
'Barwed;': '\u2306',
'barwed;': '\u2305',
'barwedge;': '\u2305',
'bbrk;': '\u23b5',
'bbrktbrk;': '\u23b6',
'bcong;': '\u224c',
'Bcy;': '\u0411',
'bcy;': '\u0431',
'bdquo;': '\u201e',
'becaus;': '\u2235',
'Because;': '\u2235',
'because;': '\u2235',
'bemptyv;': '\u29b0',
'bepsi;': '\u03f6',
'bernou;': '\u212c',
'Bernoullis;': '\u212c',
'Beta;': '\u0392',
'beta;': '\u03b2',
'beth;': '\u2136',
'between;': '\u226c',
'Bfr;': '\U0001d505',
'bfr;': '\U0001d51f',
'bigcap;': '\u22c2',
'bigcirc;': '\u25ef',
'bigcup;': '\u22c3',
'bigodot;': '\u2a00',
'bigoplus;': '\u2a01',
'bigotimes;': '\u2a02',
'bigsqcup;': '\u2a06',
'bigstar;': '\u2605',
'bigtriangledown;': '\u25bd',
'bigtriangleup;': '\u25b3',
'biguplus;': '\u2a04',
'bigvee;': '\u22c1',
'bigwedge;': '\u22c0',
'bkarow;': '\u290d',
'blacklozenge;': '\u29eb',
'blacksquare;': '\u25aa',
'blacktriangle;': '\u25b4',
'blacktriangledown;': '\u25be',
'blacktriangleleft;': '\u25c2',
'blacktriangleright;': '\u25b8',
'blank;': '\u2423',
'blk12;': '\u2592',
'blk14;': '\u2591',
'blk34;': '\u2593',
'block;': '\u2588',
'bne;': '=\u20e5',
'bnequiv;': '\u2261\u20e5',
'bNot;': '\u2aed',
'bnot;': '\u2310',
'Bopf;': '\U0001d539',
'bopf;': '\U0001d553',
'bot;': '\u22a5',
'bottom;': '\u22a5',
'bowtie;': '\u22c8',
'boxbox;': '\u29c9',
'boxDL;': '\u2557',
'boxDl;': '\u2556',
'boxdL;': '\u2555',
'boxdl;': '\u2510',
'boxDR;': '\u2554',
'boxDr;': '\u2553',
'boxdR;': '\u2552',
'boxdr;': '\u250c',
'boxH;': '\u2550',
'boxh;': '\u2500',
'boxHD;': '\u2566',
'boxHd;': '\u2564',
'boxhD;': '\u2565',
'boxhd;': '\u252c',
'boxHU;': '\u2569',
'boxHu;': '\u2567',
'boxhU;': '\u2568',
'boxhu;': '\u2534',
'boxminus;': '\u229f',
'boxplus;': '\u229e',
'boxtimes;': '\u22a0',
'boxUL;': '\u255d',
'boxUl;': '\u255c',
'boxuL;': '\u255b',
'boxul;': '\u2518',
'boxUR;': '\u255a',
'boxUr;': '\u2559',
'boxuR;': '\u2558',
'boxur;': '\u2514',
'boxV;': '\u2551',
'boxv;': '\u2502',
'boxVH;': '\u256c',
'boxVh;': '\u256b',
'boxvH;': '\u256a',
'boxvh;': '\u253c',
'boxVL;': '\u2563',
'boxVl;': '\u2562',
'boxvL;': '\u2561',
'boxvl;': '\u2524',
'boxVR;': '\u2560',
'boxVr;': '\u255f',
'boxvR;': '\u255e',
'boxvr;': '\u251c',
'bprime;': '\u2035',
'Breve;': '\u02d8',
'breve;': '\u02d8',
'brvbar': '\xa6',
'brvbar;': '\xa6',
'Bscr;': '\u212c',
'bscr;': '\U0001d4b7',
'bsemi;': '\u204f',
'bsim;': '\u223d',
'bsime;': '\u22cd',
'bsol;': '\\',
'bsolb;': '\u29c5',
'bsolhsub;': '\u27c8',
'bull;': '\u2022',
'bullet;': '\u2022',
'bump;': '\u224e',
'bumpE;': '\u2aae',
'bumpe;': '\u224f',
'Bumpeq;': '\u224e',
'bumpeq;': '\u224f',
'Cacute;': '\u0106',
'cacute;': '\u0107',
'Cap;': '\u22d2',
'cap;': '\u2229',
'capand;': '\u2a44',
'capbrcup;': '\u2a49',
'capcap;': '\u2a4b',
'capcup;': '\u2a47',
'capdot;': '\u2a40',
'CapitalDifferentialD;': '\u2145',
'caps;': '\u2229\ufe00',
'caret;': '\u2041',
'caron;': '\u02c7',
'Cayleys;': '\u212d',
'ccaps;': '\u2a4d',
'Ccaron;': '\u010c',
'ccaron;': '\u010d',
'Ccedil': '\xc7',
'ccedil': '\xe7',
'Ccedil;': '\xc7',
'ccedil;': '\xe7',
'Ccirc;': '\u0108',
'ccirc;': '\u0109',
'Cconint;': '\u2230',
'ccups;': '\u2a4c',
'ccupssm;': '\u2a50',
'Cdot;': '\u010a',
'cdot;': '\u010b',
'cedil': '\xb8',
'cedil;': '\xb8',
'Cedilla;': '\xb8',
'cemptyv;': '\u29b2',
'cent': '\xa2',
'cent;': '\xa2',
'CenterDot;': '\xb7',
'centerdot;': '\xb7',
'Cfr;': '\u212d',
'cfr;': '\U0001d520',
'CHcy;': '\u0427',
'chcy;': '\u0447',
'check;': '\u2713',
'checkmark;': '\u2713',
'Chi;': '\u03a7',
'chi;': '\u03c7',
'cir;': '\u25cb',
'circ;': '\u02c6',
'circeq;': '\u2257',
'circlearrowleft;': '\u21ba',
'circlearrowright;': '\u21bb',
'circledast;': '\u229b',
'circledcirc;': '\u229a',
'circleddash;': '\u229d',
'CircleDot;': '\u2299',
'circledR;': '\xae',
'circledS;': '\u24c8',
'CircleMinus;': '\u2296',
'CirclePlus;': '\u2295',
'CircleTimes;': '\u2297',
'cirE;': '\u29c3',
'cire;': '\u2257',
'cirfnint;': '\u2a10',
'cirmid;': '\u2aef',
'cirscir;': '\u29c2',
'ClockwiseContourIntegral;': '\u2232',
'CloseCurlyDoubleQuote;': '\u201d',
'CloseCurlyQuote;': '\u2019',
'clubs;': '\u2663',
'clubsuit;': '\u2663',
'Colon;': '\u2237',
'colon;': ':',
'Colone;': '\u2a74',
'colone;': '\u2254',
'coloneq;': '\u2254',
'comma;': ',',
'commat;': '@',
'comp;': '\u2201',
'compfn;': '\u2218',
'complement;': '\u2201',
'complexes;': '\u2102',
'cong;': '\u2245',
'congdot;': '\u2a6d',
'Congruent;': '\u2261',
'Conint;': '\u222f',
'conint;': '\u222e',
'ContourIntegral;': '\u222e',
'Copf;': '\u2102',
'copf;': '\U0001d554',
'coprod;': '\u2210',
'Coproduct;': '\u2210',
'COPY': '\xa9',
'copy': '\xa9',
'COPY;': '\xa9',
'copy;': '\xa9',
'copysr;': '\u2117',
'CounterClockwiseContourIntegral;': '\u2233',
'crarr;': '\u21b5',
'Cross;': '\u2a2f',
'cross;': '\u2717',
'Cscr;': '\U0001d49e',
'cscr;': '\U0001d4b8',
'csub;': '\u2acf',
'csube;': '\u2ad1',
'csup;': '\u2ad0',
'csupe;': '\u2ad2',
'ctdot;': '\u22ef',
'cudarrl;': '\u2938',
'cudarrr;': '\u2935',
'cuepr;': '\u22de',
'cuesc;': '\u22df',
'cularr;': '\u21b6',
'cularrp;': '\u293d',
'Cup;': '\u22d3',
'cup;': '\u222a',
'cupbrcap;': '\u2a48',
'CupCap;': '\u224d',
'cupcap;': '\u2a46',
'cupcup;': '\u2a4a',
'cupdot;': '\u228d',
'cupor;': '\u2a45',
'cups;': '\u222a\ufe00',
'curarr;': '\u21b7',
'curarrm;': '\u293c',
'curlyeqprec;': '\u22de',
'curlyeqsucc;': '\u22df',
'curlyvee;': '\u22ce',
'curlywedge;': '\u22cf',
'curren': '\xa4',
'curren;': '\xa4',
'curvearrowleft;': '\u21b6',
'curvearrowright;': '\u21b7',
'cuvee;': '\u22ce',
'cuwed;': '\u22cf',
'cwconint;': '\u2232',
'cwint;': '\u2231',
'cylcty;': '\u232d',
'Dagger;': '\u2021',
'dagger;': '\u2020',
'daleth;': '\u2138',
'Darr;': '\u21a1',
'dArr;': '\u21d3',
'darr;': '\u2193',
'dash;': '\u2010',
'Dashv;': '\u2ae4',
'dashv;': '\u22a3',
'dbkarow;': '\u290f',
'dblac;': '\u02dd',
'Dcaron;': '\u010e',
'dcaron;': '\u010f',
'Dcy;': '\u0414',
'dcy;': '\u0434',
'DD;': '\u2145',
'dd;': '\u2146',
'ddagger;': '\u2021',
'ddarr;': '\u21ca',
'DDotrahd;': '\u2911',
'ddotseq;': '\u2a77',
'deg': '\xb0',
'deg;': '\xb0',
'Del;': '\u2207',
'Delta;': '\u0394',
'delta;': '\u03b4',
'demptyv;': '\u29b1',
'dfisht;': '\u297f',
'Dfr;': '\U0001d507',
'dfr;': '\U0001d521',
'dHar;': '\u2965',
'dharl;': '\u21c3',
'dharr;': '\u21c2',
'DiacriticalAcute;': '\xb4',
'DiacriticalDot;': '\u02d9',
'DiacriticalDoubleAcute;': '\u02dd',
'DiacriticalGrave;': '`',
'DiacriticalTilde;': '\u02dc',
'diam;': '\u22c4',
'Diamond;': '\u22c4',
'diamond;': '\u22c4',
'diamondsuit;': '\u2666',
'diams;': '\u2666',
'die;': '\xa8',
'DifferentialD;': '\u2146',
'digamma;': '\u03dd',
'disin;': '\u22f2',
'div;': '\xf7',
'divide': '\xf7',
'divide;': '\xf7',
'divideontimes;': '\u22c7',
'divonx;': '\u22c7',
'DJcy;': '\u0402',
'djcy;': '\u0452',
'dlcorn;': '\u231e',
'dlcrop;': '\u230d',
'dollar;': '$',
'Dopf;': '\U0001d53b',
'dopf;': '\U0001d555',
'Dot;': '\xa8',
'dot;': '\u02d9',
'DotDot;': '\u20dc',
'doteq;': '\u2250',
'doteqdot;': '\u2251',
'DotEqual;': '\u2250',
'dotminus;': '\u2238',
'dotplus;': '\u2214',
'dotsquare;': '\u22a1',
'doublebarwedge;': '\u2306',
'DoubleContourIntegral;': '\u222f',
'DoubleDot;': '\xa8',
'DoubleDownArrow;': '\u21d3',
'DoubleLeftArrow;': '\u21d0',
'DoubleLeftRightArrow;': '\u21d4',
'DoubleLeftTee;': '\u2ae4',
'DoubleLongLeftArrow;': '\u27f8',
'DoubleLongLeftRightArrow;': '\u27fa',
'DoubleLongRightArrow;': '\u27f9',
'DoubleRightArrow;': '\u21d2',
'DoubleRightTee;': '\u22a8',
'DoubleUpArrow;': '\u21d1',
'DoubleUpDownArrow;': '\u21d5',
'DoubleVerticalBar;': '\u2225',
'DownArrow;': '\u2193',
'Downarrow;': '\u21d3',
'downarrow;': '\u2193',
'DownArrowBar;': '\u2913',
'DownArrowUpArrow;': '\u21f5',
'DownBreve;': '\u0311',
'downdownarrows;': '\u21ca',
'downharpoonleft;': '\u21c3',
'downharpoonright;': '\u21c2',
'DownLeftRightVector;': '\u2950',
'DownLeftTeeVector;': '\u295e',
'DownLeftVector;': '\u21bd',
'DownLeftVectorBar;': '\u2956',
'DownRightTeeVector;': '\u295f',
'DownRightVector;': '\u21c1',
'DownRightVectorBar;': '\u2957',
'DownTee;': '\u22a4',
'DownTeeArrow;': '\u21a7',
'drbkarow;': '\u2910',
'drcorn;': '\u231f',
'drcrop;': '\u230c',
'Dscr;': '\U0001d49f',
'dscr;': '\U0001d4b9',
'DScy;': '\u0405',
'dscy;': '\u0455',
'dsol;': '\u29f6',
'Dstrok;': '\u0110',
'dstrok;': '\u0111',
'dtdot;': '\u22f1',
'dtri;': '\u25bf',
'dtrif;': '\u25be',
'duarr;': '\u21f5',
'duhar;': '\u296f',
'dwangle;': '\u29a6',
'DZcy;': '\u040f',
'dzcy;': '\u045f',
'dzigrarr;': '\u27ff',
'Eacute': '\xc9',
'eacute': '\xe9',
'Eacute;': '\xc9',
'eacute;': '\xe9',
'easter;': '\u2a6e',
'Ecaron;': '\u011a',
'ecaron;': '\u011b',
'ecir;': '\u2256',
'Ecirc': '\xca',
'ecirc': '\xea',
'Ecirc;': '\xca',
'ecirc;': '\xea',
'ecolon;': '\u2255',
'Ecy;': '\u042d',
'ecy;': '\u044d',
'eDDot;': '\u2a77',
'Edot;': '\u0116',
'eDot;': '\u2251',
'edot;': '\u0117',
'ee;': '\u2147',
'efDot;': '\u2252',
'Efr;': '\U0001d508',
'efr;': '\U0001d522',
'eg;': '\u2a9a',
'Egrave': '\xc8',
'egrave': '\xe8',
'Egrave;': '\xc8',
'egrave;': '\xe8',
'egs;': '\u2a96',
'egsdot;': '\u2a98',
'el;': '\u2a99',
'Element;': '\u2208',
'elinters;': '\u23e7',
'ell;': '\u2113',
'els;': '\u2a95',
'elsdot;': '\u2a97',
'Emacr;': '\u0112',
'emacr;': '\u0113',
'empty;': '\u2205',
'emptyset;': '\u2205',
'EmptySmallSquare;': '\u25fb',
'emptyv;': '\u2205',
'EmptyVerySmallSquare;': '\u25ab',
'emsp13;': '\u2004',
'emsp14;': '\u2005',
'emsp;': '\u2003',
'ENG;': '\u014a',
'eng;': '\u014b',
'ensp;': '\u2002',
'Eogon;': '\u0118',
'eogon;': '\u0119',
'Eopf;': '\U0001d53c',
'eopf;': '\U0001d556',
'epar;': '\u22d5',
'eparsl;': '\u29e3',
'eplus;': '\u2a71',
'epsi;': '\u03b5',
'Epsilon;': '\u0395',
'epsilon;': '\u03b5',
'epsiv;': '\u03f5',
'eqcirc;': '\u2256',
'eqcolon;': '\u2255',
'eqsim;': '\u2242',
'eqslantgtr;': '\u2a96',
'eqslantless;': '\u2a95',
'Equal;': '\u2a75',
'equals;': '=',
'EqualTilde;': '\u2242',
'equest;': '\u225f',
'Equilibrium;': '\u21cc',
'equiv;': '\u2261',
'equivDD;': '\u2a78',
'eqvparsl;': '\u29e5',
'erarr;': '\u2971',
'erDot;': '\u2253',
'Escr;': '\u2130',
'escr;': '\u212f',
'esdot;': '\u2250',
'Esim;': '\u2a73',
'esim;': '\u2242',
'Eta;': '\u0397',
'eta;': '\u03b7',
'ETH': '\xd0',
'eth': '\xf0',
'ETH;': '\xd0',
'eth;': '\xf0',
'Euml': '\xcb',
'euml': '\xeb',
'Euml;': '\xcb',
'euml;': '\xeb',
'euro;': '\u20ac',
'excl;': '!',
'exist;': '\u2203',
'Exists;': '\u2203',
'expectation;': '\u2130',
'ExponentialE;': '\u2147',
'exponentiale;': '\u2147',
'fallingdotseq;': '\u2252',
'Fcy;': '\u0424',
'fcy;': '\u0444',
'female;': '\u2640',
'ffilig;': '\ufb03',
'fflig;': '\ufb00',
'ffllig;': '\ufb04',
'Ffr;': '\U0001d509',
'ffr;': '\U0001d523',
'filig;': '\ufb01',
'FilledSmallSquare;': '\u25fc',
'FilledVerySmallSquare;': '\u25aa',
'fjlig;': 'fj',
'flat;': '\u266d',
'fllig;': '\ufb02',
'fltns;': '\u25b1',
'fnof;': '\u0192',
'Fopf;': '\U0001d53d',
'fopf;': '\U0001d557',
'ForAll;': '\u2200',
'forall;': '\u2200',
'fork;': '\u22d4',
'forkv;': '\u2ad9',
'Fouriertrf;': '\u2131',
'fpartint;': '\u2a0d',
'frac12': '\xbd',
'frac12;': '\xbd',
'frac13;': '\u2153',
'frac14': '\xbc',
'frac14;': '\xbc',
'frac15;': '\u2155',
'frac16;': '\u2159',
'frac18;': '\u215b',
'frac23;': '\u2154',
'frac25;': '\u2156',
'frac34': '\xbe',
'frac34;': '\xbe',
'frac35;': '\u2157',
'frac38;': '\u215c',
'frac45;': '\u2158',
'frac56;': '\u215a',
'frac58;': '\u215d',
'frac78;': '\u215e',
'frasl;': '\u2044',
'frown;': '\u2322',
'Fscr;': '\u2131',
'fscr;': '\U0001d4bb',
'gacute;': '\u01f5',
'Gamma;': '\u0393',
'gamma;': '\u03b3',
'Gammad;': '\u03dc',
'gammad;': '\u03dd',
'gap;': '\u2a86',
'Gbreve;': '\u011e',
'gbreve;': '\u011f',
'Gcedil;': '\u0122',
'Gcirc;': '\u011c',
'gcirc;': '\u011d',
'Gcy;': '\u0413',
'gcy;': '\u0433',
'Gdot;': '\u0120',
'gdot;': '\u0121',
'gE;': '\u2267',
'ge;': '\u2265',
'gEl;': '\u2a8c',
'gel;': '\u22db',
'geq;': '\u2265',
'geqq;': '\u2267',
'geqslant;': '\u2a7e',
'ges;': '\u2a7e',
'gescc;': '\u2aa9',
'gesdot;': '\u2a80',
'gesdoto;': '\u2a82',
'gesdotol;': '\u2a84',
'gesl;': '\u22db\ufe00',
'gesles;': '\u2a94',
'Gfr;': '\U0001d50a',
'gfr;': '\U0001d524',
'Gg;': '\u22d9',
'gg;': '\u226b',
'ggg;': '\u22d9',
'gimel;': '\u2137',
'GJcy;': '\u0403',
'gjcy;': '\u0453',
'gl;': '\u2277',
'gla;': '\u2aa5',
'glE;': '\u2a92',
'glj;': '\u2aa4',
'gnap;': '\u2a8a',
'gnapprox;': '\u2a8a',
'gnE;': '\u2269',
'gne;': '\u2a88',
'gneq;': '\u2a88',
'gneqq;': '\u2269',
'gnsim;': '\u22e7',
'Gopf;': '\U0001d53e',
'gopf;': '\U0001d558',
'grave;': '`',
'GreaterEqual;': '\u2265',
'GreaterEqualLess;': '\u22db',
'GreaterFullEqual;': '\u2267',
'GreaterGreater;': '\u2aa2',
'GreaterLess;': '\u2277',
'GreaterSlantEqual;': '\u2a7e',
'GreaterTilde;': '\u2273',
'Gscr;': '\U0001d4a2',
'gscr;': '\u210a',
'gsim;': '\u2273',
'gsime;': '\u2a8e',
'gsiml;': '\u2a90',
'GT': '>',
'gt': '>',
'GT;': '>',
'Gt;': '\u226b',
'gt;': '>',
'gtcc;': '\u2aa7',
'gtcir;': '\u2a7a',
'gtdot;': '\u22d7',
'gtlPar;': '\u2995',
'gtquest;': '\u2a7c',
'gtrapprox;': '\u2a86',
'gtrarr;': '\u2978',
'gtrdot;': '\u22d7',
'gtreqless;': '\u22db',
'gtreqqless;': '\u2a8c',
'gtrless;': '\u2277',
'gtrsim;': '\u2273',
'gvertneqq;': '\u2269\ufe00',
'gvnE;': '\u2269\ufe00',
'Hacek;': '\u02c7',
'hairsp;': '\u200a',
'half;': '\xbd',
'hamilt;': '\u210b',
'HARDcy;': '\u042a',
'hardcy;': '\u044a',
'hArr;': '\u21d4',
'harr;': '\u2194',
'harrcir;': '\u2948',
'harrw;': '\u21ad',
'Hat;': '^',
'hbar;': '\u210f',
'Hcirc;': '\u0124',
'hcirc;': '\u0125',
'hearts;': '\u2665',
'heartsuit;': '\u2665',
'hellip;': '\u2026',
'hercon;': '\u22b9',
'Hfr;': '\u210c',
'hfr;': '\U0001d525',
'HilbertSpace;': '\u210b',
'hksearow;': '\u2925',
'hkswarow;': '\u2926',
'hoarr;': '\u21ff',
'homtht;': '\u223b',
'hookleftarrow;': '\u21a9',
'hookrightarrow;': '\u21aa',
'Hopf;': '\u210d',
'hopf;': '\U0001d559',
'horbar;': '\u2015',
'HorizontalLine;': '\u2500',
'Hscr;': '\u210b',
'hscr;': '\U0001d4bd',
'hslash;': '\u210f',
'Hstrok;': '\u0126',
'hstrok;': '\u0127',
'HumpDownHump;': '\u224e',
'HumpEqual;': '\u224f',
'hybull;': '\u2043',
'hyphen;': '\u2010',
'Iacute': '\xcd',
'iacute': '\xed',
'Iacute;': '\xcd',
'iacute;': '\xed',
'ic;': '\u2063',
'Icirc': '\xce',
'icirc': '\xee',
'Icirc;': '\xce',
'icirc;': '\xee',
'Icy;': '\u0418',
'icy;': '\u0438',
'Idot;': '\u0130',
'IEcy;': '\u0415',
'iecy;': '\u0435',
'iexcl': '\xa1',
'iexcl;': '\xa1',
'iff;': '\u21d4',
'Ifr;': '\u2111',
'ifr;': '\U0001d526',
'Igrave': '\xcc',
'igrave': '\xec',
'Igrave;': '\xcc',
'igrave;': '\xec',
'ii;': '\u2148',
'iiiint;': '\u2a0c',
'iiint;': '\u222d',
'iinfin;': '\u29dc',
'iiota;': '\u2129',
'IJlig;': '\u0132',
'ijlig;': '\u0133',
'Im;': '\u2111',
'Imacr;': '\u012a',
'imacr;': '\u012b',
'image;': '\u2111',
'ImaginaryI;': '\u2148',
'imagline;': '\u2110',
'imagpart;': '\u2111',
'imath;': '\u0131',
'imof;': '\u22b7',
'imped;': '\u01b5',
'Implies;': '\u21d2',
'in;': '\u2208',
'incare;': '\u2105',
'infin;': '\u221e',
'infintie;': '\u29dd',
'inodot;': '\u0131',
'Int;': '\u222c',
'int;': '\u222b',
'intcal;': '\u22ba',
'integers;': '\u2124',
'Integral;': '\u222b',
'intercal;': '\u22ba',
'Intersection;': '\u22c2',
'intlarhk;': '\u2a17',
'intprod;': '\u2a3c',
'InvisibleComma;': '\u2063',
'InvisibleTimes;': '\u2062',
'IOcy;': '\u0401',
'iocy;': '\u0451',
'Iogon;': '\u012e',
'iogon;': '\u012f',
'Iopf;': '\U0001d540',
'iopf;': '\U0001d55a',
'Iota;': '\u0399',
'iota;': '\u03b9',
'iprod;': '\u2a3c',
'iquest': '\xbf',
'iquest;': '\xbf',
'Iscr;': '\u2110',
'iscr;': '\U0001d4be',
'isin;': '\u2208',
'isindot;': '\u22f5',
'isinE;': '\u22f9',
'isins;': '\u22f4',
'isinsv;': '\u22f3',
'isinv;': '\u2208',
'it;': '\u2062',
'Itilde;': '\u0128',
'itilde;': '\u0129',
'Iukcy;': '\u0406',
'iukcy;': '\u0456',
'Iuml': '\xcf',
'iuml': '\xef',
'Iuml;': '\xcf',
'iuml;': '\xef',
'Jcirc;': '\u0134',
'jcirc;': '\u0135',
'Jcy;': '\u0419',
'jcy;': '\u0439',
'Jfr;': '\U0001d50d',
'jfr;': '\U0001d527',
'jmath;': '\u0237',
'Jopf;': '\U0001d541',
'jopf;': '\U0001d55b',
'Jscr;': '\U0001d4a5',
'jscr;': '\U0001d4bf',
'Jsercy;': '\u0408',
'jsercy;': '\u0458',
'Jukcy;': '\u0404',
'jukcy;': '\u0454',
'Kappa;': '\u039a',
'kappa;': '\u03ba',
'kappav;': '\u03f0',
'Kcedil;': '\u0136',
'kcedil;': '\u0137',
'Kcy;': '\u041a',
'kcy;': '\u043a',
'Kfr;': '\U0001d50e',
'kfr;': '\U0001d528',
'kgreen;': '\u0138',
'KHcy;': '\u0425',
'khcy;': '\u0445',
'KJcy;': '\u040c',
'kjcy;': '\u045c',
'Kopf;': '\U0001d542',
'kopf;': '\U0001d55c',
'Kscr;': '\U0001d4a6',
'kscr;': '\U0001d4c0',
'lAarr;': '\u21da',
'Lacute;': '\u0139',
'lacute;': '\u013a',
'laemptyv;': '\u29b4',
'lagran;': '\u2112',
'Lambda;': '\u039b',
'lambda;': '\u03bb',
'Lang;': '\u27ea',
'lang;': '\u27e8',
'langd;': '\u2991',
'langle;': '\u27e8',
'lap;': '\u2a85',
'Laplacetrf;': '\u2112',
'laquo': '\xab',
'laquo;': '\xab',
'Larr;': '\u219e',
'lArr;': '\u21d0',
'larr;': '\u2190',
'larrb;': '\u21e4',
'larrbfs;': '\u291f',
'larrfs;': '\u291d',
'larrhk;': '\u21a9',
'larrlp;': '\u21ab',
'larrpl;': '\u2939',
'larrsim;': '\u2973',
'larrtl;': '\u21a2',
'lat;': '\u2aab',
'lAtail;': '\u291b',
'latail;': '\u2919',
'late;': '\u2aad',
'lates;': '\u2aad\ufe00',
'lBarr;': '\u290e',
'lbarr;': '\u290c',
'lbbrk;': '\u2772',
'lbrace;': '{',
'lbrack;': '[',
'lbrke;': '\u298b',
'lbrksld;': '\u298f',
'lbrkslu;': '\u298d',
'Lcaron;': '\u013d',
'lcaron;': '\u013e',
'Lcedil;': '\u013b',
'lcedil;': '\u013c',
'lceil;': '\u2308',
'lcub;': '{',
'Lcy;': '\u041b',
'lcy;': '\u043b',
'ldca;': '\u2936',
'ldquo;': '\u201c',
'ldquor;': '\u201e',
'ldrdhar;': '\u2967',
'ldrushar;': '\u294b',
'ldsh;': '\u21b2',
'lE;': '\u2266',
'le;': '\u2264',
'LeftAngleBracket;': '\u27e8',
'LeftArrow;': '\u2190',
'Leftarrow;': '\u21d0',
'leftarrow;': '\u2190',
'LeftArrowBar;': '\u21e4',
'LeftArrowRightArrow;': '\u21c6',
'leftarrowtail;': '\u21a2',
'LeftCeiling;': '\u2308',
'LeftDoubleBracket;': '\u27e6',
'LeftDownTeeVector;': '\u2961',
'LeftDownVector;': '\u21c3',
'LeftDownVectorBar;': '\u2959',
'LeftFloor;': '\u230a',
'leftharpoondown;': '\u21bd',
'leftharpoonup;': '\u21bc',
'leftleftarrows;': '\u21c7',
'LeftRightArrow;': '\u2194',
'Leftrightarrow;': '\u21d4',
'leftrightarrow;': '\u2194',
'leftrightarrows;': '\u21c6',
'leftrightharpoons;': '\u21cb',
'leftrightsquigarrow;': '\u21ad',
'LeftRightVector;': '\u294e',
'LeftTee;': '\u22a3',
'LeftTeeArrow;': '\u21a4',
'LeftTeeVector;': '\u295a',
'leftthreetimes;': '\u22cb',
'LeftTriangle;': '\u22b2',
'LeftTriangleBar;': '\u29cf',
'LeftTriangleEqual;': '\u22b4',
'LeftUpDownVector;': '\u2951',
'LeftUpTeeVector;': '\u2960',
'LeftUpVector;': '\u21bf',
'LeftUpVectorBar;': '\u2958',
'LeftVector;': '\u21bc',
'LeftVectorBar;': '\u2952',
'lEg;': '\u2a8b',
'leg;': '\u22da',
'leq;': '\u2264',
'leqq;': '\u2266',
'leqslant;': '\u2a7d',
'les;': '\u2a7d',
'lescc;': '\u2aa8',
'lesdot;': '\u2a7f',
'lesdoto;': '\u2a81',
'lesdotor;': '\u2a83',
'lesg;': '\u22da\ufe00',
'lesges;': '\u2a93',
'lessapprox;': '\u2a85',
'lessdot;': '\u22d6',
'lesseqgtr;': '\u22da',
'lesseqqgtr;': '\u2a8b',
'LessEqualGreater;': '\u22da',
'LessFullEqual;': '\u2266',
'LessGreater;': '\u2276',
'lessgtr;': '\u2276',
'LessLess;': '\u2aa1',
'lesssim;': '\u2272',
'LessSlantEqual;': '\u2a7d',
'LessTilde;': '\u2272',
'lfisht;': '\u297c',
'lfloor;': '\u230a',
'Lfr;': '\U0001d50f',
'lfr;': '\U0001d529',
'lg;': '\u2276',
'lgE;': '\u2a91',
'lHar;': '\u2962',
'lhard;': '\u21bd',
'lharu;': '\u21bc',
'lharul;': '\u296a',
'lhblk;': '\u2584',
'LJcy;': '\u0409',
'ljcy;': '\u0459',
'Ll;': '\u22d8',
'll;': '\u226a',
'llarr;': '\u21c7',
'llcorner;': '\u231e',
'Lleftarrow;': '\u21da',
'llhard;': '\u296b',
'lltri;': '\u25fa',
'Lmidot;': '\u013f',
'lmidot;': '\u0140',
'lmoust;': '\u23b0',
'lmoustache;': '\u23b0',
'lnap;': '\u2a89',
'lnapprox;': '\u2a89',
'lnE;': '\u2268',
'lne;': '\u2a87',
'lneq;': '\u2a87',
'lneqq;': '\u2268',
'lnsim;': '\u22e6',
'loang;': '\u27ec',
'loarr;': '\u21fd',
'lobrk;': '\u27e6',
'LongLeftArrow;': '\u27f5',
'Longleftarrow;': '\u27f8',
'longleftarrow;': '\u27f5',
'LongLeftRightArrow;': '\u27f7',
'Longleftrightarrow;': '\u27fa',
'longleftrightarrow;': '\u27f7',
'longmapsto;': '\u27fc',
'LongRightArrow;': '\u27f6',
'Longrightarrow;': '\u27f9',
'longrightarrow;': '\u27f6',
'looparrowleft;': '\u21ab',
'looparrowright;': '\u21ac',
'lopar;': '\u2985',
'Lopf;': '\U0001d543',
'lopf;': '\U0001d55d',
'loplus;': '\u2a2d',
'lotimes;': '\u2a34',
'lowast;': '\u2217',
'lowbar;': '_',
'LowerLeftArrow;': '\u2199',
'LowerRightArrow;': '\u2198',
'loz;': '\u25ca',
'lozenge;': '\u25ca',
'lozf;': '\u29eb',
'lpar;': '(',
'lparlt;': '\u2993',
'lrarr;': '\u21c6',
'lrcorner;': '\u231f',
'lrhar;': '\u21cb',
'lrhard;': '\u296d',
'lrm;': '\u200e',
'lrtri;': '\u22bf',
'lsaquo;': '\u2039',
'Lscr;': '\u2112',
'lscr;': '\U0001d4c1',
'Lsh;': '\u21b0',
'lsh;': '\u21b0',
'lsim;': '\u2272',
'lsime;': '\u2a8d',
'lsimg;': '\u2a8f',
'lsqb;': '[',
'lsquo;': '\u2018',
'lsquor;': '\u201a',
'Lstrok;': '\u0141',
'lstrok;': '\u0142',
'LT': '<',
'lt': '<',
'LT;': '<',
'Lt;': '\u226a',
'lt;': '<',
'ltcc;': '\u2aa6',
'ltcir;': '\u2a79',
'ltdot;': '\u22d6',
'lthree;': '\u22cb',
'ltimes;': '\u22c9',
'ltlarr;': '\u2976',
'ltquest;': '\u2a7b',
'ltri;': '\u25c3',
'ltrie;': '\u22b4',
'ltrif;': '\u25c2',
'ltrPar;': '\u2996',
'lurdshar;': '\u294a',
'luruhar;': '\u2966',
'lvertneqq;': '\u2268\ufe00',
'lvnE;': '\u2268\ufe00',
'macr': '\xaf',
'macr;': '\xaf',
'male;': '\u2642',
'malt;': '\u2720',
'maltese;': '\u2720',
'Map;': '\u2905',
'map;': '\u21a6',
'mapsto;': '\u21a6',
'mapstodown;': '\u21a7',
'mapstoleft;': '\u21a4',
'mapstoup;': '\u21a5',
'marker;': '\u25ae',
'mcomma;': '\u2a29',
'Mcy;': '\u041c',
'mcy;': '\u043c',
'mdash;': '\u2014',
'mDDot;': '\u223a',
'measuredangle;': '\u2221',
'MediumSpace;': '\u205f',
'Mellintrf;': '\u2133',
'Mfr;': '\U0001d510',
'mfr;': '\U0001d52a',
'mho;': '\u2127',
'micro': '\xb5',
'micro;': '\xb5',
'mid;': '\u2223',
'midast;': '*',
'midcir;': '\u2af0',
'middot': '\xb7',
'middot;': '\xb7',
'minus;': '\u2212',
'minusb;': '\u229f',
'minusd;': '\u2238',
'minusdu;': '\u2a2a',
'MinusPlus;': '\u2213',
'mlcp;': '\u2adb',
'mldr;': '\u2026',
'mnplus;': '\u2213',
'models;': '\u22a7',
'Mopf;': '\U0001d544',
'mopf;': '\U0001d55e',
'mp;': '\u2213',
'Mscr;': '\u2133',
'mscr;': '\U0001d4c2',
'mstpos;': '\u223e',
'Mu;': '\u039c',
'mu;': '\u03bc',
'multimap;': '\u22b8',
'mumap;': '\u22b8',
'nabla;': '\u2207',
'Nacute;': '\u0143',
'nacute;': '\u0144',
'nang;': '\u2220\u20d2',
'nap;': '\u2249',
'napE;': '\u2a70\u0338',
'napid;': '\u224b\u0338',
'napos;': '\u0149',
'napprox;': '\u2249',
'natur;': '\u266e',
'natural;': '\u266e',
'naturals;': '\u2115',
'nbsp': '\xa0',
'nbsp;': '\xa0',
'nbump;': '\u224e\u0338',
'nbumpe;': '\u224f\u0338',
'ncap;': '\u2a43',
'Ncaron;': '\u0147',
'ncaron;': '\u0148',
'Ncedil;': '\u0145',
'ncedil;': '\u0146',
'ncong;': '\u2247',
'ncongdot;': '\u2a6d\u0338',
'ncup;': '\u2a42',
'Ncy;': '\u041d',
'ncy;': '\u043d',
'ndash;': '\u2013',
'ne;': '\u2260',
'nearhk;': '\u2924',
'neArr;': '\u21d7',
'nearr;': '\u2197',
'nearrow;': '\u2197',
'nedot;': '\u2250\u0338',
'NegativeMediumSpace;': '\u200b',
'NegativeThickSpace;': '\u200b',
'NegativeThinSpace;': '\u200b',
'NegativeVeryThinSpace;': '\u200b',
'nequiv;': '\u2262',
'nesear;': '\u2928',
'nesim;': '\u2242\u0338',
'NestedGreaterGreater;': '\u226b',
'NestedLessLess;': '\u226a',
'NewLine;': '\n',
'nexist;': '\u2204',
'nexists;': '\u2204',
'Nfr;': '\U0001d511',
'nfr;': '\U0001d52b',
'ngE;': '\u2267\u0338',
'nge;': '\u2271',
'ngeq;': '\u2271',
'ngeqq;': '\u2267\u0338',
'ngeqslant;': '\u2a7e\u0338',
'nges;': '\u2a7e\u0338',
'nGg;': '\u22d9\u0338',
'ngsim;': '\u2275',
'nGt;': '\u226b\u20d2',
'ngt;': '\u226f',
'ngtr;': '\u226f',
'nGtv;': '\u226b\u0338',
'nhArr;': '\u21ce',
'nharr;': '\u21ae',
'nhpar;': '\u2af2',
'ni;': '\u220b',
'nis;': '\u22fc',
'nisd;': '\u22fa',
'niv;': '\u220b',
'NJcy;': '\u040a',
'njcy;': '\u045a',
'nlArr;': '\u21cd',
'nlarr;': '\u219a',
'nldr;': '\u2025',
'nlE;': '\u2266\u0338',
'nle;': '\u2270',
'nLeftarrow;': '\u21cd',
'nleftarrow;': '\u219a',
'nLeftrightarrow;': '\u21ce',
'nleftrightarrow;': '\u21ae',
'nleq;': '\u2270',
'nleqq;': '\u2266\u0338',
'nleqslant;': '\u2a7d\u0338',
'nles;': '\u2a7d\u0338',
'nless;': '\u226e',
'nLl;': '\u22d8\u0338',
'nlsim;': '\u2274',
'nLt;': '\u226a\u20d2',
'nlt;': '\u226e',
'nltri;': '\u22ea',
'nltrie;': '\u22ec',
'nLtv;': '\u226a\u0338',
'nmid;': '\u2224',
'NoBreak;': '\u2060',
'NonBreakingSpace;': '\xa0',
'Nopf;': '\u2115',
'nopf;': '\U0001d55f',
'not': '\xac',
'Not;': '\u2aec',
'not;': '\xac',
'NotCongruent;': '\u2262',
'NotCupCap;': '\u226d',
'NotDoubleVerticalBar;': '\u2226',
'NotElement;': '\u2209',
'NotEqual;': '\u2260',
'NotEqualTilde;': '\u2242\u0338',
'NotExists;': '\u2204',
'NotGreater;': '\u226f',
'NotGreaterEqual;': '\u2271',
'NotGreaterFullEqual;': '\u2267\u0338',
'NotGreaterGreater;': '\u226b\u0338',
'NotGreaterLess;': '\u2279',
'NotGreaterSlantEqual;': '\u2a7e\u0338',
'NotGreaterTilde;': '\u2275',
'NotHumpDownHump;': '\u224e\u0338',
'NotHumpEqual;': '\u224f\u0338',
'notin;': '\u2209',
'notindot;': '\u22f5\u0338',
'notinE;': '\u22f9\u0338',
'notinva;': '\u2209',
'notinvb;': '\u22f7',
'notinvc;': '\u22f6',
'NotLeftTriangle;': '\u22ea',
'NotLeftTriangleBar;': '\u29cf\u0338',
'NotLeftTriangleEqual;': '\u22ec',
'NotLess;': '\u226e',
'NotLessEqual;': '\u2270',
'NotLessGreater;': '\u2278',
'NotLessLess;': '\u226a\u0338',
'NotLessSlantEqual;': '\u2a7d\u0338',
'NotLessTilde;': '\u2274',
'NotNestedGreaterGreater;': '\u2aa2\u0338',
'NotNestedLessLess;': '\u2aa1\u0338',
'notni;': '\u220c',
'notniva;': '\u220c',
'notnivb;': '\u22fe',
'notnivc;': '\u22fd',
'NotPrecedes;': '\u2280',
'NotPrecedesEqual;': '\u2aaf\u0338',
'NotPrecedesSlantEqual;': '\u22e0',
'NotReverseElement;': '\u220c',
'NotRightTriangle;': '\u22eb',
'NotRightTriangleBar;': '\u29d0\u0338',
'NotRightTriangleEqual;': '\u22ed',
'NotSquareSubset;': '\u228f\u0338',
'NotSquareSubsetEqual;': '\u22e2',
'NotSquareSuperset;': '\u2290\u0338',
'NotSquareSupersetEqual;': '\u22e3',
'NotSubset;': '\u2282\u20d2',
'NotSubsetEqual;': '\u2288',
'NotSucceeds;': '\u2281',
'NotSucceedsEqual;': '\u2ab0\u0338',
'NotSucceedsSlantEqual;': '\u22e1',
'NotSucceedsTilde;': '\u227f\u0338',
'NotSuperset;': '\u2283\u20d2',
'NotSupersetEqual;': '\u2289',
'NotTilde;': '\u2241',
'NotTildeEqual;': '\u2244',
'NotTildeFullEqual;': '\u2247',
'NotTildeTilde;': '\u2249',
'NotVerticalBar;': '\u2224',
'npar;': '\u2226',
'nparallel;': '\u2226',
'nparsl;': '\u2afd\u20e5',
'npart;': '\u2202\u0338',
'npolint;': '\u2a14',
'npr;': '\u2280',
'nprcue;': '\u22e0',
'npre;': '\u2aaf\u0338',
'nprec;': '\u2280',
'npreceq;': '\u2aaf\u0338',
'nrArr;': '\u21cf',
'nrarr;': '\u219b',
'nrarrc;': '\u2933\u0338',
'nrarrw;': '\u219d\u0338',
'nRightarrow;': '\u21cf',
'nrightarrow;': '\u219b',
'nrtri;': '\u22eb',
'nrtrie;': '\u22ed',
'nsc;': '\u2281',
'nsccue;': '\u22e1',
'nsce;': '\u2ab0\u0338',
'Nscr;': '\U0001d4a9',
'nscr;': '\U0001d4c3',
'nshortmid;': '\u2224',
'nshortparallel;': '\u2226',
'nsim;': '\u2241',
'nsime;': '\u2244',
'nsimeq;': '\u2244',
'nsmid;': '\u2224',
'nspar;': '\u2226',
'nsqsube;': '\u22e2',
'nsqsupe;': '\u22e3',
'nsub;': '\u2284',
'nsubE;': '\u2ac5\u0338',
'nsube;': '\u2288',
'nsubset;': '\u2282\u20d2',
'nsubseteq;': '\u2288',
'nsubseteqq;': '\u2ac5\u0338',
'nsucc;': '\u2281',
'nsucceq;': '\u2ab0\u0338',
'nsup;': '\u2285',
'nsupE;': '\u2ac6\u0338',
'nsupe;': '\u2289',
'nsupset;': '\u2283\u20d2',
'nsupseteq;': '\u2289',
'nsupseteqq;': '\u2ac6\u0338',
'ntgl;': '\u2279',
'Ntilde': '\xd1',
'ntilde': '\xf1',
'Ntilde;': '\xd1',
'ntilde;': '\xf1',
'ntlg;': '\u2278',
'ntriangleleft;': '\u22ea',
'ntrianglelefteq;': '\u22ec',
'ntriangleright;': '\u22eb',
'ntrianglerighteq;': '\u22ed',
'Nu;': '\u039d',
'nu;': '\u03bd',
'num;': '#',
'numero;': '\u2116',
'numsp;': '\u2007',
'nvap;': '\u224d\u20d2',
'nVDash;': '\u22af',
'nVdash;': '\u22ae',
'nvDash;': '\u22ad',
'nvdash;': '\u22ac',
'nvge;': '\u2265\u20d2',
'nvgt;': '>\u20d2',
'nvHarr;': '\u2904',
'nvinfin;': '\u29de',
'nvlArr;': '\u2902',
'nvle;': '\u2264\u20d2',
'nvlt;': '<\u20d2',
'nvltrie;': '\u22b4\u20d2',
'nvrArr;': '\u2903',
'nvrtrie;': '\u22b5\u20d2',
'nvsim;': '\u223c\u20d2',
'nwarhk;': '\u2923',
'nwArr;': '\u21d6',
'nwarr;': '\u2196',
'nwarrow;': '\u2196',
'nwnear;': '\u2927',
'Oacute': '\xd3',
'oacute': '\xf3',
'Oacute;': '\xd3',
'oacute;': '\xf3',
'oast;': '\u229b',
'ocir;': '\u229a',
'Ocirc': '\xd4',
'ocirc': '\xf4',
'Ocirc;': '\xd4',
'ocirc;': '\xf4',
'Ocy;': '\u041e',
'ocy;': '\u043e',
'odash;': '\u229d',
'Odblac;': '\u0150',
'odblac;': '\u0151',
'odiv;': '\u2a38',
'odot;': '\u2299',
'odsold;': '\u29bc',
'OElig;': '\u0152',
'oelig;': '\u0153',
'ofcir;': '\u29bf',
'Ofr;': '\U0001d512',
'ofr;': '\U0001d52c',
'ogon;': '\u02db',
'Ograve': '\xd2',
'ograve': '\xf2',
'Ograve;': '\xd2',
'ograve;': '\xf2',
'ogt;': '\u29c1',
'ohbar;': '\u29b5',
'ohm;': '\u03a9',
'oint;': '\u222e',
'olarr;': '\u21ba',
'olcir;': '\u29be',
'olcross;': '\u29bb',
'oline;': '\u203e',
'olt;': '\u29c0',
'Omacr;': '\u014c',
'omacr;': '\u014d',
'Omega;': '\u03a9',
'omega;': '\u03c9',
'Omicron;': '\u039f',
'omicron;': '\u03bf',
'omid;': '\u29b6',
'ominus;': '\u2296',
'Oopf;': '\U0001d546',
'oopf;': '\U0001d560',
'opar;': '\u29b7',
'OpenCurlyDoubleQuote;': '\u201c',
'OpenCurlyQuote;': '\u2018',
'operp;': '\u29b9',
'oplus;': '\u2295',
'Or;': '\u2a54',
'or;': '\u2228',
'orarr;': '\u21bb',
'ord;': '\u2a5d',
'order;': '\u2134',
'orderof;': '\u2134',
'ordf': '\xaa',
'ordf;': '\xaa',
'ordm': '\xba',
'ordm;': '\xba',
'origof;': '\u22b6',
'oror;': '\u2a56',
'orslope;': '\u2a57',
'orv;': '\u2a5b',
'oS;': '\u24c8',
'Oscr;': '\U0001d4aa',
'oscr;': '\u2134',
'Oslash': '\xd8',
'oslash': '\xf8',
'Oslash;': '\xd8',
'oslash;': '\xf8',
'osol;': '\u2298',
'Otilde': '\xd5',
'otilde': '\xf5',
'Otilde;': '\xd5',
'otilde;': '\xf5',
'Otimes;': '\u2a37',
'otimes;': '\u2297',
'otimesas;': '\u2a36',
'Ouml': '\xd6',
'ouml': '\xf6',
'Ouml;': '\xd6',
'ouml;': '\xf6',
'ovbar;': '\u233d',
'OverBar;': '\u203e',
'OverBrace;': '\u23de',
'OverBracket;': '\u23b4',
'OverParenthesis;': '\u23dc',
'par;': '\u2225',
'para': '\xb6',
'para;': '\xb6',
'parallel;': '\u2225',
'parsim;': '\u2af3',
'parsl;': '\u2afd',
'part;': '\u2202',
'PartialD;': '\u2202',
'Pcy;': '\u041f',
'pcy;': '\u043f',
'percnt;': '%',
'period;': '.',
'permil;': '\u2030',
'perp;': '\u22a5',
'pertenk;': '\u2031',
'Pfr;': '\U0001d513',
'pfr;': '\U0001d52d',
'Phi;': '\u03a6',
'phi;': '\u03c6',
'phiv;': '\u03d5',
'phmmat;': '\u2133',
'phone;': '\u260e',
'Pi;': '\u03a0',
'pi;': '\u03c0',
'pitchfork;': '\u22d4',
'piv;': '\u03d6',
'planck;': '\u210f',
'planckh;': '\u210e',
'plankv;': '\u210f',
'plus;': '+',
'plusacir;': '\u2a23',
'plusb;': '\u229e',
'pluscir;': '\u2a22',
'plusdo;': '\u2214',
'plusdu;': '\u2a25',
'pluse;': '\u2a72',
'PlusMinus;': '\xb1',
'plusmn': '\xb1',
'plusmn;': '\xb1',
'plussim;': '\u2a26',
'plustwo;': '\u2a27',
'pm;': '\xb1',
'Poincareplane;': '\u210c',
'pointint;': '\u2a15',
'Popf;': '\u2119',
'popf;': '\U0001d561',
'pound': '\xa3',
'pound;': '\xa3',
'Pr;': '\u2abb',
'pr;': '\u227a',
'prap;': '\u2ab7',
'prcue;': '\u227c',
'prE;': '\u2ab3',
'pre;': '\u2aaf',
'prec;': '\u227a',
'precapprox;': '\u2ab7',
'preccurlyeq;': '\u227c',
'Precedes;': '\u227a',
'PrecedesEqual;': '\u2aaf',
'PrecedesSlantEqual;': '\u227c',
'PrecedesTilde;': '\u227e',
'preceq;': '\u2aaf',
'precnapprox;': '\u2ab9',
'precneqq;': '\u2ab5',
'precnsim;': '\u22e8',
'precsim;': '\u227e',
'Prime;': '\u2033',
'prime;': '\u2032',
'primes;': '\u2119',
'prnap;': '\u2ab9',
'prnE;': '\u2ab5',
'prnsim;': '\u22e8',
'prod;': '\u220f',
'Product;': '\u220f',
'profalar;': '\u232e',
'profline;': '\u2312',
'profsurf;': '\u2313',
'prop;': '\u221d',
'Proportion;': '\u2237',
'Proportional;': '\u221d',
'propto;': '\u221d',
'prsim;': '\u227e',
'prurel;': '\u22b0',
'Pscr;': '\U0001d4ab',
'pscr;': '\U0001d4c5',
'Psi;': '\u03a8',
'psi;': '\u03c8',
'puncsp;': '\u2008',
'Qfr;': '\U0001d514',
'qfr;': '\U0001d52e',
'qint;': '\u2a0c',
'Qopf;': '\u211a',
'qopf;': '\U0001d562',
'qprime;': '\u2057',
'Qscr;': '\U0001d4ac',
'qscr;': '\U0001d4c6',
'quaternions;': '\u210d',
'quatint;': '\u2a16',
'quest;': '?',
'questeq;': '\u225f',
'QUOT': '"',
'quot': '"',
'QUOT;': '"',
'quot;': '"',
'rAarr;': '\u21db',
'race;': '\u223d\u0331',
'Racute;': '\u0154',
'racute;': '\u0155',
'radic;': '\u221a',
'raemptyv;': '\u29b3',
'Rang;': '\u27eb',
'rang;': '\u27e9',
'rangd;': '\u2992',
'range;': '\u29a5',
'rangle;': '\u27e9',
'raquo': '\xbb',
'raquo;': '\xbb',
'Rarr;': '\u21a0',
'rArr;': '\u21d2',
'rarr;': '\u2192',
'rarrap;': '\u2975',
'rarrb;': '\u21e5',
'rarrbfs;': '\u2920',
'rarrc;': '\u2933',
'rarrfs;': '\u291e',
'rarrhk;': '\u21aa',
'rarrlp;': '\u21ac',
'rarrpl;': '\u2945',
'rarrsim;': '\u2974',
'Rarrtl;': '\u2916',
'rarrtl;': '\u21a3',
'rarrw;': '\u219d',
'rAtail;': '\u291c',
'ratail;': '\u291a',
'ratio;': '\u2236',
'rationals;': '\u211a',
'RBarr;': '\u2910',
'rBarr;': '\u290f',
'rbarr;': '\u290d',
'rbbrk;': '\u2773',
'rbrace;': '}',
'rbrack;': ']',
'rbrke;': '\u298c',
'rbrksld;': '\u298e',
'rbrkslu;': '\u2990',
'Rcaron;': '\u0158',
'rcaron;': '\u0159',
'Rcedil;': '\u0156',
'rcedil;': '\u0157',
'rceil;': '\u2309',
'rcub;': '}',
'Rcy;': '\u0420',
'rcy;': '\u0440',
'rdca;': '\u2937',
'rdldhar;': '\u2969',
'rdquo;': '\u201d',
'rdquor;': '\u201d',
'rdsh;': '\u21b3',
'Re;': '\u211c',
'real;': '\u211c',
'realine;': '\u211b',
'realpart;': '\u211c',
'reals;': '\u211d',
'rect;': '\u25ad',
'REG': '\xae',
'reg': '\xae',
'REG;': '\xae',
'reg;': '\xae',
'ReverseElement;': '\u220b',
'ReverseEquilibrium;': '\u21cb',
'ReverseUpEquilibrium;': '\u296f',
'rfisht;': '\u297d',
'rfloor;': '\u230b',
'Rfr;': '\u211c',
'rfr;': '\U0001d52f',
'rHar;': '\u2964',
'rhard;': '\u21c1',
'rharu;': '\u21c0',
'rharul;': '\u296c',
'Rho;': '\u03a1',
'rho;': '\u03c1',
'rhov;': '\u03f1',
'RightAngleBracket;': '\u27e9',
'RightArrow;': '\u2192',
'Rightarrow;': '\u21d2',
'rightarrow;': '\u2192',
'RightArrowBar;': '\u21e5',
'RightArrowLeftArrow;': '\u21c4',
'rightarrowtail;': '\u21a3',
'RightCeiling;': '\u2309',
'RightDoubleBracket;': '\u27e7',
'RightDownTeeVector;': '\u295d',
'RightDownVector;': '\u21c2',
'RightDownVectorBar;': '\u2955',
'RightFloor;': '\u230b',
'rightharpoondown;': '\u21c1',
'rightharpoonup;': '\u21c0',
'rightleftarrows;': '\u21c4',
'rightleftharpoons;': '\u21cc',
'rightrightarrows;': '\u21c9',
'rightsquigarrow;': '\u219d',
'RightTee;': '\u22a2',
'RightTeeArrow;': '\u21a6',
'RightTeeVector;': '\u295b',
'rightthreetimes;': '\u22cc',
'RightTriangle;': '\u22b3',
'RightTriangleBar;': '\u29d0',
'RightTriangleEqual;': '\u22b5',
'RightUpDownVector;': '\u294f',
'RightUpTeeVector;': '\u295c',
'RightUpVector;': '\u21be',
'RightUpVectorBar;': '\u2954',
'RightVector;': '\u21c0',
'RightVectorBar;': '\u2953',
'ring;': '\u02da',
'risingdotseq;': '\u2253',
'rlarr;': '\u21c4',
'rlhar;': '\u21cc',
'rlm;': '\u200f',
'rmoust;': '\u23b1',
'rmoustache;': '\u23b1',
'rnmid;': '\u2aee',
'roang;': '\u27ed',
'roarr;': '\u21fe',
'robrk;': '\u27e7',
'ropar;': '\u2986',
'Ropf;': '\u211d',
'ropf;': '\U0001d563',
'roplus;': '\u2a2e',
'rotimes;': '\u2a35',
'RoundImplies;': '\u2970',
'rpar;': ')',
'rpargt;': '\u2994',
'rppolint;': '\u2a12',
'rrarr;': '\u21c9',
'Rrightarrow;': '\u21db',
'rsaquo;': '\u203a',
'Rscr;': '\u211b',
'rscr;': '\U0001d4c7',
'Rsh;': '\u21b1',
'rsh;': '\u21b1',
'rsqb;': ']',
'rsquo;': '\u2019',
'rsquor;': '\u2019',
'rthree;': '\u22cc',
'rtimes;': '\u22ca',
'rtri;': '\u25b9',
'rtrie;': '\u22b5',
'rtrif;': '\u25b8',
'rtriltri;': '\u29ce',
'RuleDelayed;': '\u29f4',
'ruluhar;': '\u2968',
'rx;': '\u211e',
'Sacute;': '\u015a',
'sacute;': '\u015b',
'sbquo;': '\u201a',
'Sc;': '\u2abc',
'sc;': '\u227b',
'scap;': '\u2ab8',
'Scaron;': '\u0160',
'scaron;': '\u0161',
'sccue;': '\u227d',
'scE;': '\u2ab4',
'sce;': '\u2ab0',
'Scedil;': '\u015e',
'scedil;': '\u015f',
'Scirc;': '\u015c',
'scirc;': '\u015d',
'scnap;': '\u2aba',
'scnE;': '\u2ab6',
'scnsim;': '\u22e9',
'scpolint;': '\u2a13',
'scsim;': '\u227f',
'Scy;': '\u0421',
'scy;': '\u0441',
'sdot;': '\u22c5',
'sdotb;': '\u22a1',
'sdote;': '\u2a66',
'searhk;': '\u2925',
'seArr;': '\u21d8',
'searr;': '\u2198',
'searrow;': '\u2198',
'sect': '\xa7',
'sect;': '\xa7',
'semi;': ';',
'seswar;': '\u2929',
'setminus;': '\u2216',
'setmn;': '\u2216',
'sext;': '\u2736',
'Sfr;': '\U0001d516',
'sfr;': '\U0001d530',
'sfrown;': '\u2322',
'sharp;': '\u266f',
'SHCHcy;': '\u0429',
'shchcy;': '\u0449',
'SHcy;': '\u0428',
'shcy;': '\u0448',
'ShortDownArrow;': '\u2193',
'ShortLeftArrow;': '\u2190',
'shortmid;': '\u2223',
'shortparallel;': '\u2225',
'ShortRightArrow;': '\u2192',
'ShortUpArrow;': '\u2191',
'shy': '\xad',
'shy;': '\xad',
'Sigma;': '\u03a3',
'sigma;': '\u03c3',
'sigmaf;': '\u03c2',
'sigmav;': '\u03c2',
'sim;': '\u223c',
'simdot;': '\u2a6a',
'sime;': '\u2243',
'simeq;': '\u2243',
'simg;': '\u2a9e',
'simgE;': '\u2aa0',
'siml;': '\u2a9d',
'simlE;': '\u2a9f',
'simne;': '\u2246',
'simplus;': '\u2a24',
'simrarr;': '\u2972',
'slarr;': '\u2190',
'SmallCircle;': '\u2218',
'smallsetminus;': '\u2216',
'smashp;': '\u2a33',
'smeparsl;': '\u29e4',
'smid;': '\u2223',
'smile;': '\u2323',
'smt;': '\u2aaa',
'smte;': '\u2aac',
'smtes;': '\u2aac\ufe00',
'SOFTcy;': '\u042c',
'softcy;': '\u044c',
'sol;': '/',
'solb;': '\u29c4',
'solbar;': '\u233f',
'Sopf;': '\U0001d54a',
'sopf;': '\U0001d564',
'spades;': '\u2660',
'spadesuit;': '\u2660',
'spar;': '\u2225',
'sqcap;': '\u2293',
'sqcaps;': '\u2293\ufe00',
'sqcup;': '\u2294',
'sqcups;': '\u2294\ufe00',
'Sqrt;': '\u221a',
'sqsub;': '\u228f',
'sqsube;': '\u2291',
'sqsubset;': '\u228f',
'sqsubseteq;': '\u2291',
'sqsup;': '\u2290',
'sqsupe;': '\u2292',
'sqsupset;': '\u2290',
'sqsupseteq;': '\u2292',
'squ;': '\u25a1',
'Square;': '\u25a1',
'square;': '\u25a1',
'SquareIntersection;': '\u2293',
'SquareSubset;': '\u228f',
'SquareSubsetEqual;': '\u2291',
'SquareSuperset;': '\u2290',
'SquareSupersetEqual;': '\u2292',
'SquareUnion;': '\u2294',
'squarf;': '\u25aa',
'squf;': '\u25aa',
'srarr;': '\u2192',
'Sscr;': '\U0001d4ae',
'sscr;': '\U0001d4c8',
'ssetmn;': '\u2216',
'ssmile;': '\u2323',
'sstarf;': '\u22c6',
'Star;': '\u22c6',
'star;': '\u2606',
'starf;': '\u2605',
'straightepsilon;': '\u03f5',
'straightphi;': '\u03d5',
'strns;': '\xaf',
'Sub;': '\u22d0',
'sub;': '\u2282',
'subdot;': '\u2abd',
'subE;': '\u2ac5',
'sube;': '\u2286',
'subedot;': '\u2ac3',
'submult;': '\u2ac1',
'subnE;': '\u2acb',
'subne;': '\u228a',
'subplus;': '\u2abf',
'subrarr;': '\u2979',
'Subset;': '\u22d0',
'subset;': '\u2282',
'subseteq;': '\u2286',
'subseteqq;': '\u2ac5',
'SubsetEqual;': '\u2286',
'subsetneq;': '\u228a',
'subsetneqq;': '\u2acb',
'subsim;': '\u2ac7',
'subsub;': '\u2ad5',
'subsup;': '\u2ad3',
'succ;': '\u227b',
'succapprox;': '\u2ab8',
'succcurlyeq;': '\u227d',
'Succeeds;': '\u227b',
'SucceedsEqual;': '\u2ab0',
'SucceedsSlantEqual;': '\u227d',
'SucceedsTilde;': '\u227f',
'succeq;': '\u2ab0',
'succnapprox;': '\u2aba',
'succneqq;': '\u2ab6',
'succnsim;': '\u22e9',
'succsim;': '\u227f',
'SuchThat;': '\u220b',
'Sum;': '\u2211',
'sum;': '\u2211',
'sung;': '\u266a',
'sup1': '\xb9',
'sup1;': '\xb9',
'sup2': '\xb2',
'sup2;': '\xb2',
'sup3': '\xb3',
'sup3;': '\xb3',
'Sup;': '\u22d1',
'sup;': '\u2283',
'supdot;': '\u2abe',
'supdsub;': '\u2ad8',
'supE;': '\u2ac6',
'supe;': '\u2287',
'supedot;': '\u2ac4',
'Superset;': '\u2283',
'SupersetEqual;': '\u2287',
'suphsol;': '\u27c9',
'suphsub;': '\u2ad7',
'suplarr;': '\u297b',
'supmult;': '\u2ac2',
'supnE;': '\u2acc',
'supne;': '\u228b',
'supplus;': '\u2ac0',
'Supset;': '\u22d1',
'supset;': '\u2283',
'supseteq;': '\u2287',
'supseteqq;': '\u2ac6',
'supsetneq;': '\u228b',
'supsetneqq;': '\u2acc',
'supsim;': '\u2ac8',
'supsub;': '\u2ad4',
'supsup;': '\u2ad6',
'swarhk;': '\u2926',
'swArr;': '\u21d9',
'swarr;': '\u2199',
'swarrow;': '\u2199',
'swnwar;': '\u292a',
'szlig': '\xdf',
'szlig;': '\xdf',
'Tab;': '\t',
'target;': '\u2316',
'Tau;': '\u03a4',
'tau;': '\u03c4',
'tbrk;': '\u23b4',
'Tcaron;': '\u0164',
'tcaron;': '\u0165',
'Tcedil;': '\u0162',
'tcedil;': '\u0163',
'Tcy;': '\u0422',
'tcy;': '\u0442',
'tdot;': '\u20db',
'telrec;': '\u2315',
'Tfr;': '\U0001d517',
'tfr;': '\U0001d531',
'there4;': '\u2234',
'Therefore;': '\u2234',
'therefore;': '\u2234',
'Theta;': '\u0398',
'theta;': '\u03b8',
'thetasym;': '\u03d1',
'thetav;': '\u03d1',
'thickapprox;': '\u2248',
'thicksim;': '\u223c',
'ThickSpace;': '\u205f\u200a',
'thinsp;': '\u2009',
'ThinSpace;': '\u2009',
'thkap;': '\u2248',
'thksim;': '\u223c',
'THORN': '\xde',
'thorn': '\xfe',
'THORN;': '\xde',
'thorn;': '\xfe',
'Tilde;': '\u223c',
'tilde;': '\u02dc',
'TildeEqual;': '\u2243',
'TildeFullEqual;': '\u2245',
'TildeTilde;': '\u2248',
'times': '\xd7',
'times;': '\xd7',
'timesb;': '\u22a0',
'timesbar;': '\u2a31',
'timesd;': '\u2a30',
'tint;': '\u222d',
'toea;': '\u2928',
'top;': '\u22a4',
'topbot;': '\u2336',
'topcir;': '\u2af1',
'Topf;': '\U0001d54b',
'topf;': '\U0001d565',
'topfork;': '\u2ada',
'tosa;': '\u2929',
'tprime;': '\u2034',
'TRADE;': '\u2122',
'trade;': '\u2122',
'triangle;': '\u25b5',
'triangledown;': '\u25bf',
'triangleleft;': '\u25c3',
'trianglelefteq;': '\u22b4',
'triangleq;': '\u225c',
'triangleright;': '\u25b9',
'trianglerighteq;': '\u22b5',
'tridot;': '\u25ec',
'trie;': '\u225c',
'triminus;': '\u2a3a',
'TripleDot;': '\u20db',
'triplus;': '\u2a39',
'trisb;': '\u29cd',
'tritime;': '\u2a3b',
'trpezium;': '\u23e2',
'Tscr;': '\U0001d4af',
'tscr;': '\U0001d4c9',
'TScy;': '\u0426',
'tscy;': '\u0446',
'TSHcy;': '\u040b',
'tshcy;': '\u045b',
'Tstrok;': '\u0166',
'tstrok;': '\u0167',
'twixt;': '\u226c',
'twoheadleftarrow;': '\u219e',
'twoheadrightarrow;': '\u21a0',
'Uacute': '\xda',
'uacute': '\xfa',
'Uacute;': '\xda',
'uacute;': '\xfa',
'Uarr;': '\u219f',
'uArr;': '\u21d1',
'uarr;': '\u2191',
'Uarrocir;': '\u2949',
'Ubrcy;': '\u040e',
'ubrcy;': '\u045e',
'Ubreve;': '\u016c',
'ubreve;': '\u016d',
'Ucirc': '\xdb',
'ucirc': '\xfb',
'Ucirc;': '\xdb',
'ucirc;': '\xfb',
'Ucy;': '\u0423',
'ucy;': '\u0443',
'udarr;': '\u21c5',
'Udblac;': '\u0170',
'udblac;': '\u0171',
'udhar;': '\u296e',
'ufisht;': '\u297e',
'Ufr;': '\U0001d518',
'ufr;': '\U0001d532',
'Ugrave': '\xd9',
'ugrave': '\xf9',
'Ugrave;': '\xd9',
'ugrave;': '\xf9',
'uHar;': '\u2963',
'uharl;': '\u21bf',
'uharr;': '\u21be',
'uhblk;': '\u2580',
'ulcorn;': '\u231c',
'ulcorner;': '\u231c',
'ulcrop;': '\u230f',
'ultri;': '\u25f8',
'Umacr;': '\u016a',
'umacr;': '\u016b',
'uml': '\xa8',
'uml;': '\xa8',
'UnderBar;': '_',
'UnderBrace;': '\u23df',
'UnderBracket;': '\u23b5',
'UnderParenthesis;': '\u23dd',
'Union;': '\u22c3',
'UnionPlus;': '\u228e',
'Uogon;': '\u0172',
'uogon;': '\u0173',
'Uopf;': '\U0001d54c',
'uopf;': '\U0001d566',
'UpArrow;': '\u2191',
'Uparrow;': '\u21d1',
'uparrow;': '\u2191',
'UpArrowBar;': '\u2912',
'UpArrowDownArrow;': '\u21c5',
'UpDownArrow;': '\u2195',
'Updownarrow;': '\u21d5',
'updownarrow;': '\u2195',
'UpEquilibrium;': '\u296e',
'upharpoonleft;': '\u21bf',
'upharpoonright;': '\u21be',
'uplus;': '\u228e',
'UpperLeftArrow;': '\u2196',
'UpperRightArrow;': '\u2197',
'Upsi;': '\u03d2',
'upsi;': '\u03c5',
'upsih;': '\u03d2',
'Upsilon;': '\u03a5',
'upsilon;': '\u03c5',
'UpTee;': '\u22a5',
'UpTeeArrow;': '\u21a5',
'upuparrows;': '\u21c8',
'urcorn;': '\u231d',
'urcorner;': '\u231d',
'urcrop;': '\u230e',
'Uring;': '\u016e',
'uring;': '\u016f',
'urtri;': '\u25f9',
'Uscr;': '\U0001d4b0',
'uscr;': '\U0001d4ca',
'utdot;': '\u22f0',
'Utilde;': '\u0168',
'utilde;': '\u0169',
'utri;': '\u25b5',
'utrif;': '\u25b4',
'uuarr;': '\u21c8',
'Uuml': '\xdc',
'uuml': '\xfc',
'Uuml;': '\xdc',
'uuml;': '\xfc',
'uwangle;': '\u29a7',
'vangrt;': '\u299c',
'varepsilon;': '\u03f5',
'varkappa;': '\u03f0',
'varnothing;': '\u2205',
'varphi;': '\u03d5',
'varpi;': '\u03d6',
'varpropto;': '\u221d',
'vArr;': '\u21d5',
'varr;': '\u2195',
'varrho;': '\u03f1',
'varsigma;': '\u03c2',
'varsubsetneq;': '\u228a\ufe00',
'varsubsetneqq;': '\u2acb\ufe00',
'varsupsetneq;': '\u228b\ufe00',
'varsupsetneqq;': '\u2acc\ufe00',
'vartheta;': '\u03d1',
'vartriangleleft;': '\u22b2',
'vartriangleright;': '\u22b3',
'Vbar;': '\u2aeb',
'vBar;': '\u2ae8',
'vBarv;': '\u2ae9',
'Vcy;': '\u0412',
'vcy;': '\u0432',
'VDash;': '\u22ab',
'Vdash;': '\u22a9',
'vDash;': '\u22a8',
'vdash;': '\u22a2',
'Vdashl;': '\u2ae6',
'Vee;': '\u22c1',
'vee;': '\u2228',
'veebar;': '\u22bb',
'veeeq;': '\u225a',
'vellip;': '\u22ee',
'Verbar;': '\u2016',
'verbar;': '|',
'Vert;': '\u2016',
'vert;': '|',
'VerticalBar;': '\u2223',
'VerticalLine;': '|',
'VerticalSeparator;': '\u2758',
'VerticalTilde;': '\u2240',
'VeryThinSpace;': '\u200a',
'Vfr;': '\U0001d519',
'vfr;': '\U0001d533',
'vltri;': '\u22b2',
'vnsub;': '\u2282\u20d2',
'vnsup;': '\u2283\u20d2',
'Vopf;': '\U0001d54d',
'vopf;': '\U0001d567',
'vprop;': '\u221d',
'vrtri;': '\u22b3',
'Vscr;': '\U0001d4b1',
'vscr;': '\U0001d4cb',
'vsubnE;': '\u2acb\ufe00',
'vsubne;': '\u228a\ufe00',
'vsupnE;': '\u2acc\ufe00',
'vsupne;': '\u228b\ufe00',
'Vvdash;': '\u22aa',
'vzigzag;': '\u299a',
'Wcirc;': '\u0174',
'wcirc;': '\u0175',
'wedbar;': '\u2a5f',
'Wedge;': '\u22c0',
'wedge;': '\u2227',
'wedgeq;': '\u2259',
'weierp;': '\u2118',
'Wfr;': '\U0001d51a',
'wfr;': '\U0001d534',
'Wopf;': '\U0001d54e',
'wopf;': '\U0001d568',
'wp;': '\u2118',
'wr;': '\u2240',
'wreath;': '\u2240',
'Wscr;': '\U0001d4b2',
'wscr;': '\U0001d4cc',
'xcap;': '\u22c2',
'xcirc;': '\u25ef',
'xcup;': '\u22c3',
'xdtri;': '\u25bd',
'Xfr;': '\U0001d51b',
'xfr;': '\U0001d535',
'xhArr;': '\u27fa',
'xharr;': '\u27f7',
'Xi;': '\u039e',
'xi;': '\u03be',
'xlArr;': '\u27f8',
'xlarr;': '\u27f5',
'xmap;': '\u27fc',
'xnis;': '\u22fb',
'xodot;': '\u2a00',
'Xopf;': '\U0001d54f',
'xopf;': '\U0001d569',
'xoplus;': '\u2a01',
'xotime;': '\u2a02',
'xrArr;': '\u27f9',
'xrarr;': '\u27f6',
'Xscr;': '\U0001d4b3',
'xscr;': '\U0001d4cd',
'xsqcup;': '\u2a06',
'xuplus;': '\u2a04',
'xutri;': '\u25b3',
'xvee;': '\u22c1',
'xwedge;': '\u22c0',
'Yacute': '\xdd',
'yacute': '\xfd',
'Yacute;': '\xdd',
'yacute;': '\xfd',
'YAcy;': '\u042f',
'yacy;': '\u044f',
'Ycirc;': '\u0176',
'ycirc;': '\u0177',
'Ycy;': '\u042b',
'ycy;': '\u044b',
'yen': '\xa5',
'yen;': '\xa5',
'Yfr;': '\U0001d51c',
'yfr;': '\U0001d536',
'YIcy;': '\u0407',
'yicy;': '\u0457',
'Yopf;': '\U0001d550',
'yopf;': '\U0001d56a',
'Yscr;': '\U0001d4b4',
'yscr;': '\U0001d4ce',
'YUcy;': '\u042e',
'yucy;': '\u044e',
'yuml': '\xff',
'Yuml;': '\u0178',
'yuml;': '\xff',
'Zacute;': '\u0179',
'zacute;': '\u017a',
'Zcaron;': '\u017d',
'zcaron;': '\u017e',
'Zcy;': '\u0417',
'zcy;': '\u0437',
'Zdot;': '\u017b',
'zdot;': '\u017c',
'zeetrf;': '\u2128',
'ZeroWidthSpace;': '\u200b',
'Zeta;': '\u0396',
'zeta;': '\u03b6',
'Zfr;': '\u2128',
'zfr;': '\U0001d537',
'ZHcy;': '\u0416',
'zhcy;': '\u0436',
'zigrarr;': '\u21dd',
'Zopf;': '\u2124',
'zopf;': '\U0001d56b',
'Zscr;': '\U0001d4b5',
'zscr;': '\U0001d4cf',
'zwj;': '\u200d',
'zwnj;': '\u200c',
}
# maps the Unicode codepoint to the HTML entity name
codepoint2name = {}
# maps the HTML entity name to the character
# (or a character reference if the character is outside the Latin-1 range)
entitydefs = {}
for (name, codepoint) in name2codepoint.items():
codepoint2name[codepoint] = name
entitydefs[name] = chr(codepoint)
del name, codepoint
PK �Cu\Qޅ� � ! future/backports/html/__init__.pynu �[��� """
General functions for HTML manipulation, backported from Py3.
Note that this uses Python 2.7 code with the corresponding Python 3
module names and locations.
"""
from __future__ import unicode_literals
_escape_map = {ord('&'): '&', ord('<'): '<', ord('>'): '>'}
_escape_map_full = {ord('&'): '&', ord('<'): '<', ord('>'): '>',
ord('"'): '"', ord('\''): '''}
# NB: this is a candidate for a bytes/string polymorphic interface
def escape(s, quote=True):
"""
Replace special characters "&", "<" and ">" to HTML-safe sequences.
If the optional flag quote is true (the default), the quotation mark
characters, both double quote (") and single quote (') characters are also
translated.
"""
assert not isinstance(s, bytes), 'Pass a unicode string'
if quote:
return s.translate(_escape_map_full)
return s.translate(_escape_map)
PK �Cu\���e� � 9 future/backports/html/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� �
@ sf d Z ddlmZ ed�ded�ded�diZed�ded�ded�ded �d
ed �d iZddd�ZdS )z�
General functions for HTML manipulation, backported from Py3.
Note that this uses Python 2.7 code with the corresponding Python 3
module names and locations.
� )�unicode_literals�&z&�<z<�>z>�"z"�'z'Tc C s* t | t�rJ d��|r | �t�S | �t�S )z�
Replace special characters "&", "<" and ">" to HTML-safe sequences.
If the optional flag quote is true (the default), the quotation mark
characters, both double quote (") and single quote (') characters are also
translated.
zPass a unicode string)�
isinstance�bytes� translate�_escape_map_full� _escape_map)�s�quote� r �H/usr/local/lib/python3.9/site-packages/future/backports/html/__init__.py�escape s
r N)T)�__doc__�
__future__r �ordr r r r r r r �<module> s �PK �Cu\�L��(� (� 9 future/backports/html/__pycache__/entities.cpython-39.pycnu �[��� a
��?h�& � � @ sD% d Z ddlmZmZmZmZ ddlT dddddd d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d ��Z�d�d�d�d�d�d�d�d�d�d�d �d�d �d
�d
�d �d �d
�d�d
�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d �d �d �d �d!�d"�d!�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7�d8�d9�d:�d;�d�d6�d9�d0�d<�d0�d<�d=�d>�d?�d@�d6�dA�dB�dC�dB�dC�dD�dE�dD�dE�dF�dG�dH�dI�dJ�dK�dL�dM�dN�dO�dP�dQ�dQ�dR�dS�dH�dT�dU�dV�dW�dW�dW�dX�dI�dY�dY�dZ�d[�d\�d]�d^�d_�d`�da�db�dc�dd�de�df�dg�dh�di�dj�dk�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dv�dw�dx�dy�dz�d{�d|�d}�d~�d�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dJ�d��d��d��d��dY�d��d��dK�dL�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdʐdɐdʐdːd̐d͐dΐdϐdАdѐdҐdҐdҐdӐdԐdԐdՐdՐdŐddאdؐdِdِdڐdېdܐdݐdސdߐd�d�d�d�d�d�d�d�d�d�d�dސd�d�d�d�d�d�d�d�d�d�d�d?�d?�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d �d �d�d�d�d�d�dF�d�d�d�d�d�d�d �d
�d �d �d
�d�d�d�d�d�d�d�d�dA�d�d�d�d�d�d�d �d�d�d �d �d �d �d�d�d �d �d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�d/�d0�d��d1�d"�d2�d3�d4�d5�d5�d6�d7�d8�d9�d:�d;�d<�d=�d>�d?�d
�d@�d,�dA�dB�dC�dC�dC�dD�dD�dE�d1�dF�dG�dH�dH�dH�dI�dI�dJ�dK�dL�dM�dN�dO�dP�dE�d@�dQ�dR�dS�dR�dT�dU�dV�dP�d��dE�d&�dW�dX�d)�dY�dZ�d[�d\�d]�d^�d_�d`�d'�d&�d'�da�db�dc�d2�d>�d?�dd�de�df�dg�dh�di�dj�dk�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dv�dw�dx�dq�db�dy�dz�d{�d|�d}�d~�d�d~�d�d��d��d��d��d��d��d��d��d��d��d��d4�d��dS�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dR�d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdÐd��d��d��d��dĐdŐdƐdǐdȐdɐdʐdːd̐d͐do�dΐdϐdАdѐdҐdӐdԐdՐdՐddאdؐdِdڐdڐdېdܐdܐdݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�dؐd�d�d�d�d�dF�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d �d�d�d�d�d�d�d�d�d�d �d
�d �d �d
�d�d�d�d�d�d�d�d�d�d�d�dA�d��d��d��d�d �d��d�d�d�d�d�d�d �d �d �d�d �d �d �d �d �d!�d�d"�d �d��d��d �d�d#�d#�dĐd$�dڐd%�d&�d'�dX�d(�d)�d*�d+�d,�d-�d.�d/�d/�d0�d1�d2�d3�d%�d4�d5�d6�d7�d8�d9�d:�d;�d<�d��d%�d=�d,�d>�d?�d��d��d@�d(�dA�dB�dA�dB�dC�dD�dE�dD�dE�dF�dG�dH�dI�dJ�dK�dK�dX�dL�dM�dN�dO�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dL�dW�dX�dL�dP�dY�dL�dZ�d[�d\�d\�d��d]�d^�d_�dZ�d`�da�db�dc�da�db�d`�dd�de�dC�df�dg�dh�di�dj�dk�dl�dm�dn�de�do�do�dY�dp�d��dq�dr�ds�dt�d��df�du�dv�dw�dx�dy�dz�dy�dz�d{�d|�d}�d~�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dW�d��d��d��d��d8�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dd��dÐdĐdŐdƐdV�dǐdȐdɐdʐdːd��d��dW�d��d��d̐d��dd͐dΐd>�dϐdАdf�dѐdҐd(�dX�d(�d̐dӐd*�dԐd*�dՐddאdؐdِdڐdېdܐdݐdސdѐdߐd�d�dːdʐd�d�d�d�d�d�d�d�d��d�d�d�d�dʐd�d�d�d�d�d�d�dАd�d�d�d�d�df�dѐd�d�d�d��d��d��dҐdL�d��d��d��d��d��d��d��d��d��d��d��d��d��d �d�d�d͐d�dY�d�d�dZ�d�d�d�d[�d�d��d�d�d �d
�d �d �d
�d�d�d�d�d�dn�d�d�d̐dn�dӐd�d�d�d�d��d�d�d�d�d�d�d��d �d �d �d �d �d �d �d��d �d!�d"�d�dאd#�d$�d%�d&�dڐdr�d'�d(�d)�d*�d*�d+�d+�d,�d-�d-�d.�d/�d/�dl�dՐd0�d1�d2�d3�d4�d5�d6�d#�d7�d8�d9�d:�d;�d<�d<�d=�d@�d>�dՐdՐd?�d��dT�d@�dA�dB�d0�dA�dC�dD�dE�dA�d8�dF�d�dG�dH�dI�dI�d6�dJ�dK�dL�dM�dN�dO�dP�dM�dQ�dQ�dR�dS�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�d`�da�db�dc�dd�dd�de�df�df�df�df�dg�dh�di�d�d��dj�dk�dk�dl�dm�dn�do�do�dn�dp�dp�dq�dr�ds�dt�dt�du�dv�dw�dx�dy�dz�d{�dy�d|�d}�d~�d�d��d��d��d~�d�dv�dw�d��d��d��d��d��d��d��d��d��d��d��d��d��d��dS�dR�d��d��d��d��dg�d��d��d��da�di�dk�dt�do�dn�du�d��dp�dr�dT�dU�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d[�dM�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdʐdːd̐d͐dΐdϐdАdѐdҐdӐdԐdՐddאdؐdِdِdڐdېdܐdېdܐd�d�dݐdސdݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��dߐd�d�d�d�d�d��d�d��d��d��d��d�d��d��d��dƐd �d��d�d��d��d�d �d�d�d�d�d�d�d�d�d�d�d�d�d�d �d
�d �d
�d �d �d
�d �d
�d�d�d�d�d�d�d�d�d�d�d�d�d`�d�d�d`�d�d�d�d�d�d�d �d �d �d�d �d �d!�d"�d#�d$�d8�d%�d&�d'�dd(�d,�d)�d,�d*�d+�d��d,�dU�d-�d.�d/�d/�d/�d0�d1�d/�d2�d2�d3�d4�d5�d5�d6�d7�d8�d9�d:�d;�d7�d8�d9�d7�d;�d9�d<�d;�d=�d>�d?�d<�d@�dA�d3�d=�d>�d?�dB�dB�dC�dD�dE�dF�d�dF�dF�d<�dG�dH�dI�dJ�dK�dL�dM�dN�dQ�dO�dP�dQ�dR�dS�d:�dT�dU�d��dV�dV�dV�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�d`�d^�da�da�db�d\�dc�dd�de�df�dg�dh�d9�d�di�dj�dk�dl�dm�dn�do�dp�dO�dm�d+�dm�dq�dr�ds�dt�du�dv�dw�dx�dy�dz�d{�dr�d|�d}�d~�d�d�d�d��d��d��d��d��d��d��d�d�d�d�dy�dӐdy�d��d��d��d��d��di�d��d��d��d��d��d^�dc�d\�dc�de�d��dl�d{�d��d��d?�d��d��di�d��d��d��d��dm�d��d/�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dW�d��d��d��d��d��ds�d�d�d��d��d��d��ds�d��d��d��d��d��d��d �d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdʐdV�dːd4�d̐d�d�d͐d͐dΐdϐdM�dM�dАdѐdҐd�dӐdԐdՐddאd'�d��d=�d`�dc�dؐdِdِdڐdېdܐdܐdݐdސdߐdߐd�d�d�d�d�d�d�d��d��dM�d�d�d=�d�d�d�d�d�d�d�d�d�d�d�d�d�d`�d��d��d��d��d[�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��do�do�dc�d��d��dM�d�d �d �d�dg�d��d$�d+�d�d�d�d�d�d�d�d �d
�d �d �d�d�d�d�d�d
�d �d
�d�d�d��d��d��d��d��d��dǐd��dÐdĐdŐdǐdy�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d �d �d �d �d!�d"�d�d�d�d�d!�d �d#�d$�d%�d5�d&�d�d�d'�d(�d(�d)�d*�d+�d,�d�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7�d7�d7�d8�d9�d:�d:�d6�dݐd;�d<�d<�d6�dݐd=�d>�d=�d>�dݐdB�dߐd��d6�d?�d?�d��d@�dA�dR�dh�dk�dB�dC�dD�dE�dF�dϐdG�dH�dH�dI�dx�d&�dڐdJ�d��d��dK�dJ�dL�d3�dM�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�dX�d]�d��db�dY�dZ�dY�dZ�d[�d^�dؐd\�d]�d^�d_�d`�da�db�da�db�dc�dd�de�df�dg�dh�di�dj�dk�dl�dm�dl�dm�dn�dݐd��do�dp�dp�dq�dr�ds�dt�dE�dE�d�du�dR�dv�db�dw�dx�dy�dz�d{�dؐd^�dؐd|�de�d}�d_�d}�dh�dݐd��dw�dِdd�d~�d�d~�d��d�d�d0�d��d��d��d��d��d��d��d��d��d��d��d��dI�dp�d��d��d��d��d��d��d��d��d��d��d$�d(�dF�d_�d}�d��dܐd��d��d��d��d:�dؐd��d��d��d��d��d��d��d��d]�d��d��dk�d��d��d��d��d��d��d��d��d=�d��d��d��d$�d��d��dؐd��d��d��d��dF�d��d��d��d��d��d��d��d��d��d��d��d��dl�d �d��d��d��d��d��d��d��d��d��d��d��d`�da�db�dh�d��d��dZ�d�d��d��dY�d�d�d��dc�d��d��dd�de�d[�d�d��d��df�dj�di�dk�dl�d��d��d��d��d��ddÐdĐdŐdƐdǐdǐdȐdɐdʐdːd̐d͐dΐdϐdАdѐdҐdӐdҐdԐdՐddאdؐdِdڐdېdܐdf�dݐdސdܐdߐd�d�d�dc�d�d�d�d�d�d���Zi Z i Z
e� � D ] \Z Z
e e e
< ee
�e
e < �%q[ [
�d�S (� zPHTML character entity references.
Backported for python-future from Python 3.3
� )�absolute_import�division�print_function�unicode_literals)�*�� � �� � i� �� �� �� i� �� i� i! i� �� �� �� �� i� i� �� i� �� �� �� i� �� i� i� i� �� i� iR �� �� �� i� i� �� �� �� i� i� i3 i� i� i` i� �� i� i� �� �� �� i� �� i� �� ix i� �� �� � �� �� i5! i� �& i'" i " �� iH" �� �� i i� � i" i)" �� � � i� i� ic& iE" � i�! i*" � i�! i i�! � i� if& � �� �� �� i" i i i� ia" i� �� �� i� i" i� i " � � � iD i� ie" �> i�! i�! ie& i& �� �� � �� i! i " i+" i� � i" �� i� i�! i� i)# � i�! i# i id" i
# i" i�% i i9 i �< � i � � i" i� i" � i i`" i " � i " i�" �� i� �� �� iS �� i> i� i� i�" i(" � � � � i�" � � i" i0 i�" i� i� i� � � i2 i" i " i� �" i�! i" i*# � i�! i # i i ! � i # i� i i: i i ia i�" � � i� i� i<" i`& i�" i�" i" i�" � � � i�" �� i� i4" i� i� i � i� �� i"! i�! � i�! � � � i� i� � i! i� � � � i� i
i )��AElig�Aacute�Acirc�Agrave�Alpha�Aring�Atilde�Auml�Beta�Ccedil�Chi�Dagger�Delta�ETH�Eacute�Ecirc�Egrave�Epsilon�Eta�Euml�Gamma�Iacute�Icirc�Igrave�Iota�Iuml�Kappa�Lambda�Mu�Ntilde�Nu�OElig�Oacute�Ocirc�Ograve�Omega�Omicron�Oslash�Otilde�Ouml�Phi�Pi�Prime�Psi�Rho�Scaron�Sigma�THORN�Tau�Theta�Uacute�Ucirc�Ugrave�Upsilon�Uuml�Xi�Yacute�Yuml�Zeta�aacute�acirc�acute�aelig�agrave�alefsym�alpha�amp�and�ang�aring�asymp�atilde�auml�bdquo�beta�brvbar�bull�cap�ccedil�cedil�cent�chi�circ�clubs�cong�copy�crarr�cup�curren�dArr�dagger�darr�deg�delta�diams�divide�eacute�ecirc�egrave�empty�emsp�ensp�epsilon�equiv�eta�eth�euml�euro�exist�fnof�forall�frac12�frac14�frac34�frasl�gamma�ge�gt�hArr�harr�hearts�hellip�iacute�icirc�iexcl�igrave�image�infin�int�iota�iquest�isin�iuml�kappa�lArr�lambda�lang�laquo�larr�lceil�ldquo�le�lfloor�lowast�loz�lrm�lsaquo�lsquo�lt�macr�mdash�micro�middot�minus�mu�nabla�nbsp�ndash�ne�ni�not�notin�nsub�ntilde�nu�oacute�ocirc�oelig�ograve�oline�omega�omicron�oplus�or�ordf�ordm�oslash�otilde�otimes�ouml�para�part�permil�perp�phi�pi�piv�plusmn�pound�prime�prod�prop�psi�quot�rArr�radic�rang�raquo�rarr�rceil�rdquo�real�reg�rfloor�rho�rlm�rsaquo�rsquo�sbquo�scaron�sdot�sect�shy�sigma�sigmaf�sim�spades�sub�sube�sum�sup�sup1�sup2�sup3�supe�szlig�tau�there4�theta�thetasym�thinsp�thorn�tilde�times�trade�uArr�uacute�uarr�ucirc�ugrave�uml�upsih�upsilon�uuml�weierp�xi�yacute�yen�yuml�zeta�zwj�zwnj� Á� áu Ău ău ∾u ∿u ∾̳� Â� â� ´u Аu а� Æ� æu u 𝔄u 𝔞� À� àu ℵu Αu αu Āu āu ⨿�&u ⩓u ∧u ⩕u ⩜u ⩘u ⩚u ∠u ⦤u ∡u ⦨u ⦩u ⦪u ⦫u ⦬u ⦭u ⦮u ⦯u ∟u ⊾u ⦝u ∢� Åu ⍼u Ąu ąu 𝔸u 𝕒u ≈u ⩯u ⩰u ≊u ≋�'� åu 𝒜u 𝒶u ≔r u ≍� Ã� ã� Ä� äu ∳u ⨑u ≌u ϶u ‵u ∽u ⋍u ∖u ⫧u ⊽u ⌆u ⌅u ⎵u ⎶u Бu бu „u ∵u ⦰u ℬu Βu βu ℶu ≬u 𝔅u 𝔟u ⋂u ◯u ⋃u ⨀u ⨁u ⨂u ⨆u ★u ▽u △u ⨄u ⋁u ⋀u ⤍u ⧫u ▪u ▴u ▾u ◂u ▸u ␣u ▒u ░u ▓u █u =⃥u ≡⃥u ⫭u ⌐u 𝔹u 𝕓u ⊥u ⋈u ⧉u ╗u ╖u ╕u ┐u ╔u ╓u ╒u ┌u ═u ─u ╦u ╤u ╥u ┬u ╩u ╧u ╨u ┴u ⊟u ⊞u ⊠u ╝u ╜u ╛u ┘u ╚u ╙u ╘u └u ║u │u ╬u ╫u ╪u ┼u ╣u ╢u ╡u ┤u ╠u ╟u ╞u ├u ˘� ¦u 𝒷u ⁏�\u ⧅u ⟈u •u ≎u ⪮u ≏u Ću ću ⋒u ∩u ⩄u ⩉u ⩋u ⩇u ⩀u ⅅu ∩︀u ⁁u ˇu ℭu ⩍u Ču č� Ç� çu Ĉu ĉu ∰u ⩌u ⩐u Ċu ċ� ¸u ⦲� ¢� ·u 𝔠u Чu чu ✓u Χu χu ○u ˆu ≗u ↺u ↻u ⊛u ⊚u ⊝u ⊙� ®u Ⓢu ⊖u ⊕u ⊗u ⧃u ⨐u ⫯u ⧂u ∲u ”u ’u ♣u ∷�:u ⩴�,�@u ∁u ∘u ℂu ≅u ⩭u ≡u ∯u ∮u 𝕔u ∐� ©u ℗u ↵u ⨯u ✗u 𝒞u 𝒸u ⫏u ⫑u ⫐u ⫒u ⋯u ⤸u ⤵u ⋞u ⋟u ↶u ⤽u ⋓u ∪u ⩈u ⩆u ⩊u ⊍u ⩅u ∪︀u ↷u ⤼u ⋎u ⋏� ¤u ∱u ⌭u ‡u †u ℸu ↡u ⇓u ↓u ‐u ⫤u ⊣u ⤏u ˝u Ďu ďu Дu дu ⅆu ⇊u ⤑u ⩷� °u ∇u Δu δu ⦱u ⥿u 𝔇u 𝔡u ⥥u ⇃u ⇂u ˙�`u ˜u ⋄u ♦� ¨u ϝu ⋲� ÷u ⋇u Ђu ђu ⌞u ⌍�$u 𝔻u 𝕕u ⃜u ≐u ≑u ∸u ∔u ⊡u ⇐u ⇔u ⟸u ⟺u ⟹u ⇒u ⊨u ⇑u ⇕u ∥u ⤓u ⇵u ̑u ⥐u ⥞u ↽u ⥖u ⥟u ⇁u ⥗u ⊤u ↧u ⤐u ⌟u ⌌u 𝒟u 𝒹u Ѕu ѕu ⧶u Đu đu ⋱u ▿u ⥯u ⦦u Џu џu ⟿� É� éu ⩮u Ěu ěu ≖� Ê� êu ≕u Эu эu Ėu ėu ⅇu ≒u 𝔈u 𝔢u ⪚� È� èu ⪖u ⪘u ⪙u ∈u ⏧u ℓu ⪕u ⪗u Ēu ēu ∅u ◻u ▫u u u u Ŋu ŋu u Ęu ęu 𝔼u 𝕖u ⋕u ⧣u ⩱u εu Εu ϵu ≂u ⩵�=u ≟u ⇌u ⩸u ⧥u ⥱u ≓u ℰu ℯu ⩳u Ηu η� Ð� ð� Ë� ëu €�!u ∃u Фu фu ♀u ffiu ffu fflu 𝔉u 𝔣u fiu ◼�fju ♭u flu ▱u ƒu 𝔽u 𝕗u ∀u ⋔u ⫙u ℱu ⨍� ½u ⅓� ¼u ⅕u ⅙u ⅛u ⅔u ⅖� ¾u ⅗u ⅜u ⅘u ⅚u ⅝u ⅞u ⁄u ⌢u 𝒻u ǵu Γu γu Ϝu ⪆u Ğu ğu Ģu Ĝu ĝu Гu гu Ġu ġu ≧u ≥u ⪌u ⋛u ⩾u ⪩u ⪀u ⪂u ⪄u ⋛︀u ⪔u 𝔊u 𝔤u ⋙u ≫u ℷu Ѓu ѓu ≷u ⪥u ⪒u ⪤u ⪊u ≩u ⪈u ⋧u 𝔾u 𝕘u ⪢u ≳u 𝒢u ℊu ⪎u ⪐�>u ⪧u ⩺u ⋗u ⦕u ⩼u ⥸u ≩︀u u ℋu Ъu ъu ↔u ⥈u ↭�^u ℏu Ĥu ĥu ♥u …u ⊹u ℌu 𝔥u ⤥u ⤦u ⇿u ∻u ↩u ↪u ℍu 𝕙u ―u 𝒽u Ħu ħu ⁃� Í� íu � Î� îu Иu иu İu Еu е� ¡u ℑu 𝔦� Ì� ìu ⅈu ⨌u ∭u ⧜u ℩u IJu iju Īu īu ℐu ıu ⊷u Ƶu ℅u ∞u ⧝u ∬u ∫u ⊺u ℤu ⨗u ⨼u u Ёu ёu Įu įu 𝕀u 𝕚u Ιu ι� ¿u 𝒾u ⋵u ⋹u ⋴u ⋳u Ĩu ĩu Іu і� Ï� ïu Ĵu ĵu Йu йu 𝔍u 𝔧u ȷu 𝕁u 𝕛u 𝒥u 𝒿u Јu јu Єu єu Κu κu ϰu Ķu ķu Кu кu 𝔎u 𝔨u ĸu Хu хu Ќu ќu 𝕂u 𝕜u 𝒦u 𝓀u ⇚u Ĺu ĺu ⦴u ℒu Λu λu ⟪u ⟨u ⦑u ⪅� «u ↞u ←u ⇤u ⤟u ⤝u ↫u ⤹u ⥳u ↢u ⪫u ⤛u ⤙u ⪭u ⪭︀u ⤎u ⤌u ❲�{�[u ⦋u ⦏u ⦍u Ľu ľu Ļu ļu ⌈u Лu лu ⤶u “u ⥧u ⥋u ↲u ≦u ≤u ⇆u ⟦u ⥡u ⥙u ⌊u ↼u ⇇u ⇋u ⥎u ↤u ⥚u ⋋u ⊲u ⧏u ⊴u ⥑u ⥠u ↿u ⥘u ⥒u ⪋u ⋚u ⩽u ⪨u ⩿u ⪁u ⪃u ⋚︀u ⪓u ⋖u ≶u ⪡u ≲u ⥼u 𝔏u 𝔩u ⪑u ⥢u ⥪u ▄u Љu љu ⋘u ≪u ⥫u ◺u Ŀu ŀu ⎰u ⪉u ≨u ⪇u ⋦u ⟬u ⇽u ⟵u ⟷u ⟼u ⟶u ↬u ⦅u 𝕃u 𝕝u ⨭u ⨴u ∗�_u ↙u ↘u ◊�(u ⦓u ⥭u u ⊿u ‹u 𝓁u ↰u ⪍u ⪏u ‘u ‚u Łu ł�<u ⪦u ⩹u ⋉u ⥶u ⩻u ◃u ⦖u ⥊u ⥦u ≨︀� ¯u ♂u ✠u ⤅u ↦u ↥u ▮u ⨩u Мu мu —u ∺u u ℳu 𝔐u 𝔪u ℧� µu ∣u ⫰u −u ⨪u ∓u ⫛u ⊧u 𝕄u 𝕞u 𝓂u Μu μu ⊸u Ńu ńu ∠⃒u ≉u ⩰̸u ≋̸u ʼnu ♮u ℕ� u ≎̸u ≏̸u ⩃u Ňu ňu Ņu ņu ≇u ⩭̸u ⩂u Нu нu –u ≠u ⤤u ⇗u ↗u ≐̸u u ≢u ⤨u ≂̸�
u ∄u 𝔑u 𝔫u ≧̸u ≱u ⩾̸u ⋙̸u ≵u ≫⃒u ≯u ≫̸u ⇎u ↮u ⫲u ∋u ⋼u ⋺u Њu њu ⇍u ↚u ‥u ≦̸u ≰u ⩽̸u ≮u ⋘̸u ≴u ≪⃒u ⋪u ⋬u ≪̸u ∤u u 𝕟� ¬u ⫬u ≭u ∦u ∉u ≹u ⋵̸u ⋹̸u ⋷u ⋶u ⧏̸u ≸u ⪢̸u ⪡̸u ∌u ⋾u ⋽u ⊀u ⪯̸u ⋠u ⋫u ⧐̸u ⋭u ⊏̸u ⋢u ⊐̸u ⋣u ⊂⃒u ⊈u ⊁u ⪰̸u ⋡u ≿̸u ⊃⃒u ⊉u ≁u ≄u ⫽⃥u ∂̸u ⨔u ⇏u ↛u ⤳̸u ↝̸u 𝒩u 𝓃u ⊄u ⫅̸u ⊅u ⫆̸� Ñ� ñu Νu ν�#u №u u ≍⃒u ⊯u ⊮u ⊭u ⊬u ≥⃒u >⃒u ⤄u ⧞u ⤂u ≤⃒u <⃒u ⊴⃒u ⤃u ⊵⃒u ∼⃒u ⤣u ⇖u ↖u ⤧� Ó� ó� Ô� ôu Оu оu Őu őu ⨸u ⦼u Œu œu ⦿u 𝔒u 𝔬u ˛� Ò� òu ⧁u ⦵u Ωu ⦾u ⦻u ‾u ⧀u Ōu ōu ωu Οu οu ⦶u 𝕆u 𝕠u ⦷u ⦹u ⩔u ∨u ⩝u ℴ� ª� ºu ⊶u ⩖u ⩗u ⩛u 𝒪� Ø� øu ⊘� Õ� õu ⨷u ⨶� Ö� öu ⌽u ⏞u ⎴u ⏜� ¶u ⫳u ⫽u ∂u Пu п�%�.u ‰u ‱u 𝔓u 𝔭u Φu φu ϕu ☎u Πu πu ϖu ℎ�+u ⨣u ⨢u ⨥u ⩲� ±u ⨦u ⨧u ⨕u ℙu 𝕡� £u ⪻u ≺u ⪷u ≼u ⪳u ⪯u ≾u ⪹u ⪵u ⋨u ″u ′u ∏u ⌮u ⌒u ⌓u ∝u ⊰u 𝒫u 𝓅u Ψu ψu u 𝔔u 𝔮u ℚu 𝕢u ⁗u 𝒬u 𝓆u ⨖�?�"u ⇛u ∽̱u Ŕu ŕu √u ⦳u ⟫u ⟩u ⦒u ⦥� »u ↠u →u ⥵u ⇥u ⤠u ⤳u ⤞u ⥅u ⥴u ⤖u ↣u ↝u ⤜u ⤚u ∶u ❳�}�]u ⦌u ⦎u ⦐u Řu řu Ŗu ŗu ⌉u Рu рu ⤷u ⥩u ↳u ℜu ℛu ℝu ▭u ⥽u ⌋u 𝔯u ⥤u ⇀u ⥬u Ρu ρu ϱu ⇄u ⟧u ⥝u ⥕u ⇉u ⊢u ⥛u ⋌u ⊳u ⧐u ⊵u ⥏u ⥜u ↾u ⥔u ⥓u ˚u u ⎱u ⫮u ⟭u ⇾u ⦆u 𝕣u ⨮u ⨵u ⥰�)u ⦔u ⨒u ›u 𝓇u ↱u ⋊u ▹u ⧎u ⧴u ⥨u ℞u Śu śu ⪼u ≻u ⪸u Šu šu ≽u ⪴u ⪰u Şu şu Ŝu ŝu ⪺u ⪶u ⋩u ⨓u ≿u Сu сu ⋅u ⩦u ⇘� §�;u ⤩u ✶u 𝔖u 𝔰u ♯u Щu щu Шu шu ↑� u Σu σu ςu ∼u ⩪u ≃u ⪞u ⪠u ⪝u ⪟u ≆u ⨤u ⥲u ⨳u ⧤u ⌣u ⪪u ⪬u ⪬︀u Ьu ь�/u ⧄u ⌿u 𝕊u 𝕤u ♠u ⊓u ⊓︀u ⊔u ⊔︀u ⊏u ⊑u ⊐u ⊒u □u 𝒮u 𝓈u ⋆u ☆u ⋐u ⊂u ⪽u ⫅u ⊆u ⫃u ⫁u ⫋u ⊊u ⪿u ⥹u ⫇u ⫕u ⫓u ∑u ♪� ¹� ²� ³u ⋑u ⊃u ⪾u ⫘u ⫆u ⊇u ⫄u ⟉u ⫗u ⥻u ⫂u ⫌u ⊋u ⫀u ⫈u ⫔u ⫖u ⇙u ⤪� ß� u ⌖u Τu τu Ťu ťu Ţu ţu Тu тu ⃛u ⌕u 𝔗u 𝔱u ∴u Θu θu ϑu u � Þ� þ� ×u ⨱u ⨰u ⌶u ⫱u 𝕋u 𝕥u ⫚u ‴u ™u ▵u ≜u ◬u ⨺u ⨹u ⧍u ⨻u ⏢u 𝒯u 𝓉u Цu цu Ћu ћu Ŧu ŧ� Ú� úu ↟u ⥉u Ўu ўu Ŭu ŭ� Û� ûu Уu уu ⇅u Űu űu ⥮u ⥾u 𝔘u 𝔲� Ù� ùu ⥣u ▀u ⌜u ⌏u ◸u Ūu ūu ⏟u ⏝u ⊎u Ųu ųu 𝕌u 𝕦u ⤒u ↕u ϒu υu Υu ⇈u ⌝u ⌎u Ůu ůu ◹u 𝒰u 𝓊u ⋰u Ũu ũ� Ü� üu ⦧u ⦜u ⊊︀u ⫋︀u ⊋︀u ⫌︀u ⫫u ⫨u ⫩u Вu вu ⊫u ⊩u ⫦u ⊻u ≚u ⋮u ‖�|u ❘u ≀u 𝔙u 𝔳u 𝕍u 𝕧u 𝒱u 𝓋u ⊪u ⦚u Ŵu ŵu ⩟u ≙u ℘u 𝔚u 𝔴u 𝕎u 𝕨u 𝒲u 𝓌u 𝔛u 𝔵u Ξu ξu ⋻u 𝕏u 𝕩u 𝒳u 𝓍� Ý� ýu Яu яu Ŷu ŷu Ыu ы� ¥u 𝔜u 𝔶u Їu їu 𝕐u 𝕪u 𝒴u 𝓎u Юu ю� ÿu Ÿu Źu źu Žu žu Зu зu Żu żu ℨu Ζu ζu 𝔷u Жu жu ⇝u 𝕫u 𝒵u 𝓏u u (� rl r� zAacute;zaacute;zAbreve;zabreve;zac;zacd;zacE;rm r� zAcirc;zacirc;r� zacute;zAcy;zacy;rk r� zAElig;zaelig;zaf;zAfr;zafr;rn r� zAgrave;zagrave;zalefsym;zaleph;zAlpha;zalpha;zAmacr;zamacr;zamalg;�AMPr� zAMP;zamp;zAnd;zand;zandand;zandd;z andslope;zandv;zang;zange;zangle;zangmsd;z angmsdaa;z angmsdab;z angmsdac;z angmsdad;z angmsdae;z angmsdaf;z angmsdag;z angmsdah;zangrt;zangrtvb;z angrtvbd;zangsph;zangst;zangzarr;zAogon;zaogon;zAopf;zaopf;zap;zapacir;zapE;zape;zapid;zapos;zApplyFunction;zapprox;z approxeq;rp r� zAring;zaring;zAscr;zascr;zAssign;zast;zasymp;zasympeq;rq r� zAtilde;zatilde;rr r� zAuml;zauml;z awconint;zawint;z backcong;z backepsilon;z
backprime;zbacksim;z
backsimeq;z
Backslash;zBarv;zbarvee;zBarwed;zbarwed;z barwedge;zbbrk;z bbrktbrk;zbcong;zBcy;zbcy;zbdquo;zbecaus;zBecause;zbecause;zbemptyv;zbepsi;zbernou;z Bernoullis;zBeta;zbeta;zbeth;zbetween;zBfr;zbfr;zbigcap;zbigcirc;zbigcup;zbigodot;z bigoplus;z
bigotimes;z bigsqcup;zbigstar;zbigtriangledown;zbigtriangleup;z biguplus;zbigvee;z bigwedge;zbkarow;z
blacklozenge;z blacksquare;zblacktriangle;zblacktriangledown;zblacktriangleleft;zblacktriangleright;zblank;zblk12;zblk14;zblk34;zblock;zbne;zbnequiv;zbNot;zbnot;zBopf;zbopf;zbot;zbottom;zbowtie;zboxbox;zboxDL;zboxDl;zboxdL;zboxdl;zboxDR;zboxDr;zboxdR;zboxdr;zboxH;zboxh;zboxHD;zboxHd;zboxhD;zboxhd;zboxHU;zboxHu;zboxhU;zboxhu;z boxminus;zboxplus;z boxtimes;zboxUL;zboxUl;zboxuL;zboxul;zboxUR;zboxUr;zboxuR;zboxur;zboxV;zboxv;zboxVH;zboxVh;zboxvH;zboxvh;zboxVL;zboxVl;zboxvL;zboxvl;zboxVR;zboxVr;zboxvR;zboxvr;zbprime;zBreve;zbreve;r� zbrvbar;zBscr;zbscr;zbsemi;zbsim;zbsime;zbsol;zbsolb;z bsolhsub;zbull;zbullet;zbump;zbumpE;zbumpe;zBumpeq;zbumpeq;zCacute;zcacute;zCap;zcap;zcapand;z capbrcup;zcapcap;zcapcup;zcapdot;zCapitalDifferentialD;zcaps;zcaret;zcaron;zCayleys;zccaps;zCcaron;zccaron;rt r� zCcedil;zccedil;zCcirc;zccirc;zCconint;zccups;zccupssm;zCdot;zcdot;r� zcedil;zCedilla;zcemptyv;r� zcent;z
CenterDot;z
centerdot;zCfr;zcfr;zCHcy;zchcy;zcheck;z
checkmark;zChi;zchi;zcir;zcirc;zcirceq;zcirclearrowleft;zcirclearrowright;z circledast;z circledcirc;z circleddash;z
CircleDot;z circledR;z circledS;z CircleMinus;z CirclePlus;z CircleTimes;zcirE;zcire;z cirfnint;zcirmid;zcirscir;zClockwiseContourIntegral;zCloseCurlyDoubleQuote;zCloseCurlyQuote;zclubs;z clubsuit;zColon;zcolon;zColone;zcolone;zcoloneq;zcomma;zcommat;zcomp;zcompfn;z complement;z
complexes;zcong;zcongdot;z
Congruent;zConint;zconint;zContourIntegral;zCopf;zcopf;zcoprod;z
Coproduct;�COPYr� zCOPY;zcopy;zcopysr;z CounterClockwiseContourIntegral;zcrarr;zCross;zcross;zCscr;zcscr;zcsub;zcsube;zcsup;zcsupe;zctdot;zcudarrl;zcudarrr;zcuepr;zcuesc;zcularr;zcularrp;zCup;zcup;z cupbrcap;zCupCap;zcupcap;zcupcup;zcupdot;zcupor;zcups;zcurarr;zcurarrm;z curlyeqprec;z curlyeqsucc;z curlyvee;z curlywedge;r� zcurren;zcurvearrowleft;zcurvearrowright;zcuvee;zcuwed;z cwconint;zcwint;zcylcty;zDagger;zdagger;zdaleth;zDarr;zdArr;zdarr;zdash;zDashv;zdashv;zdbkarow;zdblac;zDcaron;zdcaron;zDcy;zdcy;zDD;zdd;zddagger;zddarr;z DDotrahd;zddotseq;r� zdeg;zDel;zDelta;zdelta;zdemptyv;zdfisht;zDfr;zdfr;zdHar;zdharl;zdharr;zDiacriticalAcute;zDiacriticalDot;zDiacriticalDoubleAcute;zDiacriticalGrave;zDiacriticalTilde;zdiam;zDiamond;zdiamond;z diamondsuit;zdiams;zdie;zDifferentialD;zdigamma;zdisin;zdiv;r� zdivide;zdivideontimes;zdivonx;zDJcy;zdjcy;zdlcorn;zdlcrop;zdollar;zDopf;zdopf;zDot;zdot;zDotDot;zdoteq;z doteqdot;z DotEqual;z dotminus;zdotplus;z
dotsquare;zdoublebarwedge;zDoubleContourIntegral;z
DoubleDot;zDoubleDownArrow;zDoubleLeftArrow;zDoubleLeftRightArrow;zDoubleLeftTee;zDoubleLongLeftArrow;zDoubleLongLeftRightArrow;zDoubleLongRightArrow;zDoubleRightArrow;zDoubleRightTee;zDoubleUpArrow;zDoubleUpDownArrow;zDoubleVerticalBar;z
DownArrow;z
Downarrow;z
downarrow;z
DownArrowBar;zDownArrowUpArrow;z
DownBreve;zdowndownarrows;zdownharpoonleft;zdownharpoonright;zDownLeftRightVector;zDownLeftTeeVector;zDownLeftVector;zDownLeftVectorBar;zDownRightTeeVector;zDownRightVector;zDownRightVectorBar;zDownTee;z
DownTeeArrow;z drbkarow;zdrcorn;zdrcrop;zDscr;zdscr;zDScy;zdscy;zdsol;zDstrok;zdstrok;zdtdot;zdtri;zdtrif;zduarr;zduhar;zdwangle;zDZcy;zdzcy;z dzigrarr;ry r� zEacute;zeacute;zeaster;zEcaron;zecaron;zecir;rz r� zEcirc;zecirc;zecolon;zEcy;zecy;zeDDot;zEdot;zeDot;zedot;zee;zefDot;zEfr;zefr;zeg;r{ r� zEgrave;zegrave;zegs;zegsdot;zel;zElement;z elinters;zell;zels;zelsdot;zEmacr;zemacr;zempty;z emptyset;zEmptySmallSquare;zemptyv;zEmptyVerySmallSquare;zemsp13;zemsp14;zemsp;zENG;zeng;zensp;zEogon;zeogon;zEopf;zeopf;zepar;zeparsl;zeplus;zepsi;zEpsilon;zepsilon;zepsiv;zeqcirc;zeqcolon;zeqsim;z eqslantgtr;z eqslantless;zEqual;zequals;z EqualTilde;zequest;z Equilibrium;zequiv;zequivDD;z eqvparsl;zerarr;zerDot;zEscr;zescr;zesdot;zEsim;zesim;zEta;zeta;rx r� zETH;zeth;r~ r� zEuml;zeuml;zeuro;zexcl;zexist;zExists;z expectation;z
ExponentialE;z
exponentiale;zfallingdotseq;zFcy;zfcy;zfemale;zffilig;zfflig;zffllig;zFfr;zffr;zfilig;zFilledSmallSquare;zFilledVerySmallSquare;zfjlig;zflat;zfllig;zfltns;zfnof;zFopf;zfopf;zForAll;zforall;zfork;zforkv;z Fouriertrf;z fpartint;r� zfrac12;zfrac13;r� zfrac14;zfrac15;zfrac16;zfrac18;zfrac23;zfrac25;r� zfrac34;zfrac35;zfrac38;zfrac45;zfrac56;zfrac58;zfrac78;zfrasl;zfrown;zFscr;zfscr;zgacute;zGamma;zgamma;zGammad;zgammad;zgap;zGbreve;zgbreve;zGcedil;zGcirc;zgcirc;zGcy;zgcy;zGdot;zgdot;zgE;zge;zgEl;zgel;zgeq;zgeqq;z geqslant;zges;zgescc;zgesdot;zgesdoto;z gesdotol;zgesl;zgesles;zGfr;zgfr;zGg;zgg;zggg;zgimel;zGJcy;zgjcy;zgl;zgla;zglE;zglj;zgnap;z gnapprox;zgnE;zgne;zgneq;zgneqq;zgnsim;zGopf;zgopf;zgrave;z
GreaterEqual;zGreaterEqualLess;zGreaterFullEqual;zGreaterGreater;z GreaterLess;zGreaterSlantEqual;z
GreaterTilde;zGscr;zgscr;zgsim;zgsime;zgsiml;�GTr� zGT;zGt;zgt;zgtcc;zgtcir;zgtdot;zgtlPar;zgtquest;z
gtrapprox;zgtrarr;zgtrdot;z
gtreqless;z gtreqqless;zgtrless;zgtrsim;z
gvertneqq;zgvnE;zHacek;zhairsp;zhalf;zhamilt;zHARDcy;zhardcy;zhArr;zharr;zharrcir;zharrw;zHat;zhbar;zHcirc;zhcirc;zhearts;z
heartsuit;zhellip;zhercon;zHfr;zhfr;z
HilbertSpace;z hksearow;z hkswarow;zhoarr;zhomtht;zhookleftarrow;zhookrightarrow;zHopf;zhopf;zhorbar;zHorizontalLine;zHscr;zhscr;zhslash;zHstrok;zhstrok;z
HumpDownHump;z
HumpEqual;zhybull;zhyphen;r� r� zIacute;ziacute;zic;r� r� zIcirc;zicirc;zIcy;zicy;zIdot;zIEcy;ziecy;r� ziexcl;ziff;zIfr;zifr;r� r� zIgrave;zigrave;zii;ziiiint;ziiint;ziinfin;ziiota;zIJlig;zijlig;zIm;zImacr;zimacr;zimage;z ImaginaryI;z imagline;z imagpart;zimath;zimof;zimped;zImplies;zin;zincare;zinfin;z infintie;zinodot;zInt;zint;zintcal;z integers;z Integral;z intercal;z
Intersection;z intlarhk;zintprod;zInvisibleComma;zInvisibleTimes;zIOcy;ziocy;zIogon;ziogon;zIopf;ziopf;zIota;ziota;ziprod;r� ziquest;zIscr;ziscr;zisin;zisindot;zisinE;zisins;zisinsv;zisinv;zit;zItilde;zitilde;zIukcy;ziukcy;r� r� zIuml;ziuml;zJcirc;zjcirc;zJcy;zjcy;zJfr;zjfr;zjmath;zJopf;zjopf;zJscr;zjscr;zJsercy;zjsercy;zJukcy;zjukcy;zKappa;zkappa;zkappav;zKcedil;zkcedil;zKcy;zkcy;zKfr;zkfr;zkgreen;zKHcy;zkhcy;zKJcy;zkjcy;zKopf;zkopf;zKscr;zkscr;zlAarr;zLacute;zlacute;z laemptyv;zlagran;zLambda;zlambda;zLang;zlang;zlangd;zlangle;zlap;z Laplacetrf;r� zlaquo;zLarr;zlArr;zlarr;zlarrb;zlarrbfs;zlarrfs;zlarrhk;zlarrlp;zlarrpl;zlarrsim;zlarrtl;zlat;zlAtail;zlatail;zlate;zlates;zlBarr;zlbarr;zlbbrk;zlbrace;zlbrack;zlbrke;zlbrksld;zlbrkslu;zLcaron;zlcaron;zLcedil;zlcedil;zlceil;zlcub;zLcy;zlcy;zldca;zldquo;zldquor;zldrdhar;z ldrushar;zldsh;zlE;zle;zLeftAngleBracket;z
LeftArrow;z
Leftarrow;z
leftarrow;z
LeftArrowBar;zLeftArrowRightArrow;zleftarrowtail;z LeftCeiling;zLeftDoubleBracket;zLeftDownTeeVector;zLeftDownVector;zLeftDownVectorBar;z
LeftFloor;zleftharpoondown;zleftharpoonup;zleftleftarrows;zLeftRightArrow;zLeftrightarrow;zleftrightarrow;zleftrightarrows;zleftrightharpoons;zleftrightsquigarrow;zLeftRightVector;zLeftTee;z
LeftTeeArrow;zLeftTeeVector;zleftthreetimes;z
LeftTriangle;zLeftTriangleBar;zLeftTriangleEqual;zLeftUpDownVector;zLeftUpTeeVector;z
LeftUpVector;zLeftUpVectorBar;z LeftVector;zLeftVectorBar;zlEg;zleg;zleq;zleqq;z leqslant;zles;zlescc;zlesdot;zlesdoto;z lesdotor;zlesg;zlesges;z lessapprox;zlessdot;z
lesseqgtr;z lesseqqgtr;zLessEqualGreater;zLessFullEqual;z LessGreater;zlessgtr;z LessLess;zlesssim;zLessSlantEqual;z
LessTilde;zlfisht;zlfloor;zLfr;zlfr;zlg;zlgE;zlHar;zlhard;zlharu;zlharul;zlhblk;zLJcy;zljcy;zLl;zll;zllarr;z llcorner;z Lleftarrow;zllhard;zlltri;zLmidot;zlmidot;zlmoust;z lmoustache;zlnap;z lnapprox;zlnE;zlne;zlneq;zlneqq;zlnsim;zloang;zloarr;zlobrk;zLongLeftArrow;zLongleftarrow;zlongleftarrow;zLongLeftRightArrow;zLongleftrightarrow;zlongleftrightarrow;z longmapsto;zLongRightArrow;zLongrightarrow;zlongrightarrow;zlooparrowleft;zlooparrowright;zlopar;zLopf;zlopf;zloplus;zlotimes;zlowast;zlowbar;zLowerLeftArrow;zLowerRightArrow;zloz;zlozenge;zlozf;zlpar;zlparlt;zlrarr;z lrcorner;zlrhar;zlrhard;zlrm;zlrtri;zlsaquo;zLscr;zlscr;zLsh;zlsh;zlsim;zlsime;zlsimg;zlsqb;zlsquo;zlsquor;zLstrok;zlstrok;�LTr� zLT;zLt;zlt;zltcc;zltcir;zltdot;zlthree;zltimes;zltlarr;zltquest;zltri;zltrie;zltrif;zltrPar;z lurdshar;zluruhar;z
lvertneqq;zlvnE;r zmacr;zmale;zmalt;zmaltese;zMap;zmap;zmapsto;z mapstodown;z mapstoleft;z mapstoup;zmarker;zmcomma;zMcy;zmcy;zmdash;zmDDot;zmeasuredangle;z MediumSpace;z
Mellintrf;zMfr;zmfr;zmho;r zmicro;zmid;zmidast;zmidcir;r zmiddot;zminus;zminusb;zminusd;zminusdu;z
MinusPlus;zmlcp;zmldr;zmnplus;zmodels;zMopf;zmopf;zmp;zMscr;zmscr;zmstpos;zMu;zmu;z multimap;zmumap;znabla;zNacute;znacute;znang;znap;znapE;znapid;znapos;znapprox;znatur;znatural;z naturals;r znbsp;znbump;znbumpe;zncap;zNcaron;zncaron;zNcedil;zncedil;zncong;z ncongdot;zncup;zNcy;zncy;zndash;zne;znearhk;zneArr;znearr;znearrow;znedot;zNegativeMediumSpace;zNegativeThickSpace;zNegativeThinSpace;zNegativeVeryThinSpace;znequiv;znesear;znesim;zNestedGreaterGreater;zNestedLessLess;zNewLine;znexist;znexists;zNfr;znfr;zngE;znge;zngeq;zngeqq;z
ngeqslant;znges;znGg;zngsim;znGt;zngt;zngtr;znGtv;znhArr;znharr;znhpar;zni;znis;znisd;zniv;zNJcy;znjcy;znlArr;znlarr;znldr;znlE;znle;z nLeftarrow;z nleftarrow;znLeftrightarrow;znleftrightarrow;znleq;znleqq;z
nleqslant;znles;znless;znLl;znlsim;znLt;znlt;znltri;znltrie;znLtv;znmid;zNoBreak;zNonBreakingSpace;zNopf;znopf;r zNot;znot;z
NotCongruent;z
NotCupCap;zNotDoubleVerticalBar;z NotElement;z NotEqual;zNotEqualTilde;z
NotExists;z NotGreater;zNotGreaterEqual;zNotGreaterFullEqual;zNotGreaterGreater;zNotGreaterLess;zNotGreaterSlantEqual;zNotGreaterTilde;zNotHumpDownHump;z
NotHumpEqual;znotin;z notindot;znotinE;znotinva;znotinvb;znotinvc;zNotLeftTriangle;zNotLeftTriangleBar;zNotLeftTriangleEqual;zNotLess;z
NotLessEqual;zNotLessGreater;z NotLessLess;zNotLessSlantEqual;z
NotLessTilde;zNotNestedGreaterGreater;zNotNestedLessLess;znotni;znotniva;znotnivb;znotnivc;z NotPrecedes;zNotPrecedesEqual;zNotPrecedesSlantEqual;zNotReverseElement;zNotRightTriangle;zNotRightTriangleBar;zNotRightTriangleEqual;zNotSquareSubset;zNotSquareSubsetEqual;zNotSquareSuperset;zNotSquareSupersetEqual;z
NotSubset;zNotSubsetEqual;z NotSucceeds;zNotSucceedsEqual;zNotSucceedsSlantEqual;zNotSucceedsTilde;z NotSuperset;zNotSupersetEqual;z NotTilde;zNotTildeEqual;zNotTildeFullEqual;zNotTildeTilde;zNotVerticalBar;znpar;z
nparallel;znparsl;znpart;znpolint;znpr;znprcue;znpre;znprec;znpreceq;znrArr;znrarr;znrarrc;znrarrw;z nRightarrow;z nrightarrow;znrtri;znrtrie;znsc;znsccue;znsce;zNscr;znscr;z
nshortmid;znshortparallel;znsim;znsime;znsimeq;znsmid;znspar;znsqsube;znsqsupe;znsub;znsubE;znsube;znsubset;z
nsubseteq;z nsubseteqq;znsucc;znsucceq;znsup;znsupE;znsupe;znsupset;z
nsupseteq;z nsupseteqq;zntgl;r� r zNtilde;zntilde;zntlg;zntriangleleft;zntrianglelefteq;zntriangleright;zntrianglerighteq;zNu;znu;znum;znumero;znumsp;znvap;znVDash;znVdash;znvDash;znvdash;znvge;znvgt;znvHarr;znvinfin;znvlArr;znvle;znvlt;znvltrie;znvrArr;znvrtrie;znvsim;znwarhk;znwArr;znwarr;znwarrow;znwnear;r� r zOacute;zoacute;zoast;zocir;r� r zOcirc;zocirc;zOcy;zocy;zodash;zOdblac;zodblac;zodiv;zodot;zodsold;zOElig;zoelig;zofcir;zOfr;zofr;zogon;r� r zOgrave;zograve;zogt;zohbar;zohm;zoint;zolarr;zolcir;zolcross;zoline;zolt;zOmacr;zomacr;zOmega;zomega;zOmicron;zomicron;zomid;zominus;zOopf;zoopf;zopar;zOpenCurlyDoubleQuote;zOpenCurlyQuote;zoperp;zoplus;zOr;zor;zorarr;zord;zorder;zorderof;r zordf;r zordm;zorigof;zoror;zorslope;zorv;zoS;zOscr;zoscr;r� r zOslash;zoslash;zosol;r� r zOtilde;zotilde;zOtimes;zotimes;z otimesas;r� r zOuml;zouml;zovbar;zOverBar;z
OverBrace;z OverBracket;zOverParenthesis;zpar;r zpara;z parallel;zparsim;zparsl;zpart;z PartialD;zPcy;zpcy;zpercnt;zperiod;zpermil;zperp;zpertenk;zPfr;zpfr;zPhi;zphi;zphiv;zphmmat;zphone;zPi;zpi;z
pitchfork;zpiv;zplanck;zplanckh;zplankv;zplus;z plusacir;zplusb;zpluscir;zplusdo;zplusdu;zpluse;z
PlusMinus;r& zplusmn;zplussim;zplustwo;zpm;zPoincareplane;z pointint;zPopf;zpopf;r' zpound;zPr;zpr;zprap;zprcue;zprE;zpre;zprec;z precapprox;z preccurlyeq;z Precedes;zPrecedesEqual;zPrecedesSlantEqual;zPrecedesTilde;zpreceq;z precnapprox;z precneqq;z precnsim;zprecsim;zPrime;zprime;zprimes;zprnap;zprnE;zprnsim;zprod;zProduct;z profalar;z profline;z profsurf;zprop;z Proportion;z
Proportional;zpropto;zprsim;zprurel;zPscr;zpscr;zPsi;zpsi;zpuncsp;zQfr;zqfr;zqint;zQopf;zqopf;zqprime;zQscr;zqscr;z quaternions;zquatint;zquest;zquesteq;�QUOTr, zQUOT;zquot;zrAarr;zrace;zRacute;zracute;zradic;z raemptyv;zRang;zrang;zrangd;zrange;zrangle;r0 zraquo;zRarr;zrArr;zrarr;zrarrap;zrarrb;zrarrbfs;zrarrc;zrarrfs;zrarrhk;zrarrlp;zrarrpl;zrarrsim;zRarrtl;zrarrtl;zrarrw;zrAtail;zratail;zratio;z
rationals;zRBarr;zrBarr;zrbarr;zrbbrk;zrbrace;zrbrack;zrbrke;zrbrksld;zrbrkslu;zRcaron;zrcaron;zRcedil;zrcedil;zrceil;zrcub;zRcy;zrcy;zrdca;zrdldhar;zrdquo;zrdquor;zrdsh;zRe;zreal;zrealine;z realpart;zreals;zrect;�REGr5 zREG;zreg;zReverseElement;zReverseEquilibrium;zReverseUpEquilibrium;zrfisht;zrfloor;zRfr;zrfr;zrHar;zrhard;zrharu;zrharul;zRho;zrho;zrhov;zRightAngleBracket;z RightArrow;z Rightarrow;z rightarrow;zRightArrowBar;zRightArrowLeftArrow;zrightarrowtail;z
RightCeiling;zRightDoubleBracket;zRightDownTeeVector;zRightDownVector;zRightDownVectorBar;z RightFloor;zrightharpoondown;zrightharpoonup;zrightleftarrows;zrightleftharpoons;zrightrightarrows;zrightsquigarrow;z RightTee;zRightTeeArrow;zRightTeeVector;zrightthreetimes;zRightTriangle;zRightTriangleBar;zRightTriangleEqual;zRightUpDownVector;zRightUpTeeVector;zRightUpVector;zRightUpVectorBar;z RightVector;zRightVectorBar;zring;z
risingdotseq;zrlarr;zrlhar;zrlm;zrmoust;z rmoustache;zrnmid;zroang;zroarr;zrobrk;zropar;zRopf;zropf;zroplus;zrotimes;z
RoundImplies;zrpar;zrpargt;z rppolint;zrrarr;z Rrightarrow;zrsaquo;zRscr;zrscr;zRsh;zrsh;zrsqb;zrsquo;zrsquor;zrthree;zrtimes;zrtri;zrtrie;zrtrif;z rtriltri;z RuleDelayed;zruluhar;zrx;zSacute;zsacute;zsbquo;zSc;zsc;zscap;zScaron;zscaron;zsccue;zscE;zsce;zScedil;zscedil;zScirc;zscirc;zscnap;zscnE;zscnsim;z scpolint;zscsim;zScy;zscy;zsdot;zsdotb;zsdote;zsearhk;zseArr;zsearr;zsearrow;r> zsect;zsemi;zseswar;z setminus;zsetmn;zsext;zSfr;zsfr;zsfrown;zsharp;zSHCHcy;zshchcy;zSHcy;zshcy;zShortDownArrow;zShortLeftArrow;z shortmid;zshortparallel;zShortRightArrow;z
ShortUpArrow;r? zshy;zSigma;zsigma;zsigmaf;zsigmav;zsim;zsimdot;zsime;zsimeq;zsimg;zsimgE;zsiml;zsimlE;zsimne;zsimplus;zsimrarr;zslarr;z SmallCircle;zsmallsetminus;zsmashp;z smeparsl;zsmid;zsmile;zsmt;zsmte;zsmtes;zSOFTcy;zsoftcy;zsol;zsolb;zsolbar;zSopf;zsopf;zspades;z
spadesuit;zspar;zsqcap;zsqcaps;zsqcup;zsqcups;zSqrt;zsqsub;zsqsube;z sqsubset;z sqsubseteq;zsqsup;zsqsupe;z sqsupset;z sqsupseteq;zsqu;zSquare;zsquare;zSquareIntersection;z
SquareSubset;zSquareSubsetEqual;zSquareSuperset;zSquareSupersetEqual;z SquareUnion;zsquarf;zsquf;zsrarr;zSscr;zsscr;zssetmn;zssmile;zsstarf;zStar;zstar;zstarf;zstraightepsilon;z straightphi;zstrns;zSub;zsub;zsubdot;zsubE;zsube;zsubedot;zsubmult;zsubnE;zsubne;zsubplus;zsubrarr;zSubset;zsubset;z subseteq;z
subseteqq;z SubsetEqual;z
subsetneq;z subsetneqq;zsubsim;zsubsub;zsubsup;zsucc;z succapprox;z succcurlyeq;z Succeeds;zSucceedsEqual;zSucceedsSlantEqual;zSucceedsTilde;zsucceq;z succnapprox;z succneqq;z succnsim;zsuccsim;z SuchThat;zSum;zsum;zsung;rH zsup1;rI zsup2;rJ zsup3;zSup;zsup;zsupdot;zsupdsub;zsupE;zsupe;zsupedot;z Superset;zSupersetEqual;zsuphsol;zsuphsub;zsuplarr;zsupmult;zsupnE;zsupne;zsupplus;zSupset;zsupset;z supseteq;z
supseteqq;z
supsetneq;z supsetneqq;zsupsim;zsupsub;zsupsup;zswarhk;zswArr;zswarr;zswarrow;zswnwar;rL zszlig;zTab;ztarget;zTau;ztau;ztbrk;zTcaron;ztcaron;zTcedil;ztcedil;zTcy;ztcy;ztdot;ztelrec;zTfr;ztfr;zthere4;z
Therefore;z
therefore;zTheta;ztheta;z thetasym;zthetav;z thickapprox;z thicksim;z ThickSpace;zthinsp;z
ThinSpace;zthkap;zthksim;r� rR zTHORN;zthorn;zTilde;ztilde;z TildeEqual;zTildeFullEqual;z TildeTilde;rT ztimes;ztimesb;z timesbar;ztimesd;ztint;ztoea;ztop;ztopbot;ztopcir;zTopf;ztopf;ztopfork;ztosa;ztprime;zTRADE;ztrade;z triangle;z
triangledown;z
triangleleft;ztrianglelefteq;z
triangleq;ztriangleright;ztrianglerighteq;ztridot;ztrie;z triminus;z
TripleDot;ztriplus;ztrisb;ztritime;z trpezium;zTscr;ztscr;zTScy;ztscy;zTSHcy;ztshcy;zTstrok;ztstrok;ztwixt;ztwoheadleftarrow;ztwoheadrightarrow;r� rW zUacute;zuacute;zUarr;zuArr;zuarr;z Uarrocir;zUbrcy;zubrcy;zUbreve;zubreve;r� rY zUcirc;zucirc;zUcy;zucy;zudarr;zUdblac;zudblac;zudhar;zufisht;zUfr;zufr;r� rZ zUgrave;zugrave;zuHar;zuharl;zuharr;zuhblk;zulcorn;z ulcorner;zulcrop;zultri;zUmacr;zumacr;r[ zuml;z UnderBar;z UnderBrace;z
UnderBracket;zUnderParenthesis;zUnion;z
UnionPlus;zUogon;zuogon;zUopf;zuopf;zUpArrow;zUparrow;zuparrow;z UpArrowBar;zUpArrowDownArrow;z UpDownArrow;z Updownarrow;z updownarrow;zUpEquilibrium;zupharpoonleft;zupharpoonright;zuplus;zUpperLeftArrow;zUpperRightArrow;zUpsi;zupsi;zupsih;zUpsilon;zupsilon;zUpTee;z UpTeeArrow;z upuparrows;zurcorn;z urcorner;zurcrop;zUring;zuring;zurtri;zUscr;zuscr;zutdot;zUtilde;zutilde;zutri;zutrif;zuuarr;r� r^ zUuml;zuuml;zuwangle;zvangrt;z varepsilon;z varkappa;z varnothing;zvarphi;zvarpi;z
varpropto;zvArr;zvarr;zvarrho;z varsigma;z
varsubsetneq;zvarsubsetneqq;z
varsupsetneq;zvarsupsetneqq;z vartheta;zvartriangleleft;zvartriangleright;zVbar;zvBar;zvBarv;zVcy;zvcy;zVDash;zVdash;zvDash;zvdash;zVdashl;zVee;zvee;zveebar;zveeeq;zvellip;zVerbar;zverbar;zVert;zvert;z VerticalBar;z
VerticalLine;zVerticalSeparator;zVerticalTilde;zVeryThinSpace;zVfr;zvfr;zvltri;zvnsub;zvnsup;zVopf;zvopf;zvprop;zvrtri;zVscr;zvscr;zvsubnE;zvsubne;zvsupnE;zvsupne;zVvdash;zvzigzag;zWcirc;zwcirc;zwedbar;zWedge;zwedge;zwedgeq;zweierp;zWfr;zwfr;zWopf;zwopf;zwp;zwr;zwreath;zWscr;zwscr;zxcap;zxcirc;zxcup;zxdtri;zXfr;zxfr;zxhArr;zxharr;zXi;zxi;zxlArr;zxlarr;zxmap;zxnis;zxodot;zXopf;zxopf;zxoplus;zxotime;zxrArr;zxrarr;zXscr;zxscr;zxsqcup;zxuplus;zxutri;zxvee;zxwedge;r� ra zYacute;zyacute;zYAcy;zyacy;zYcirc;zycirc;zYcy;zycy;rb zyen;zYfr;zyfr;zYIcy;zyicy;zYopf;zyopf;zYscr;zyscr;zYUcy;zyucy;rc zYuml;zyuml;zZacute;zzacute;zZcaron;zzcaron;zZcy;zzcy;zZdot;zzdot;zzeetrf;zZeroWidthSpace;zZeta;zzeta;zZfr;zzfr;zZHcy;zzhcy;zzigrarr;zZopf;zzopf;zZscr;zzscr;zzwj;zzwnj;N)�__doc__�
__future__r r r r Zfuture.builtins�name2codepoint�html5�codepoint2name�
entitydefs�items�name� codepoint�chr� r� r� �H/usr/local/lib/python3.9/site-packages/future/backports/html/entities.py�<module> s� � � � � � � � � � � � � � � � � � � � �
LPK �Cu\Q *5 *5 7 future/backports/html/__pycache__/parser.cpython-39.pycnu �[��� a
��?h:M � @ s d Z ddlmZmZmZmZ ddlT ddlmZ ddl Z ddl
Z
e � d�Z e � d�Z
e � d�Ze � d �Ze � d
�Ze � d �Ze � d �Ze � d
�Ze � d�Ze � d�Ze � d�Ze � de j�Ze � de j�Ze � d �Ze � d�ZG dd� de �Z G dd� dej �Z dS )zLA parser for HTML and XHTML.
Backported for python-future from Python 3.3.
� )�absolute_import�division�print_function�unicode_literals)�*)� _markupbaseNz[&<]z
&[a-zA-Z#]z%&([a-zA-Z][-.a-zA-Z0-9]*)[^a-zA-Z0-9]z)&#(?:[0-9]+|[xX][0-9a-fA-F]+)[^0-9a-fA-F]z <[a-zA-Z]�>z--\s*>z(([a-zA-Z][-.a-zA-Z0-9:_]*)(?:\s|/(?!>))*z[a-zA-Z][^
/> ]*zJ\s*([a-zA-Z_][-.:a-zA-Z_0-9]*)(\s*=\s*(\'[^\']*\'|"[^"]*"|[^\s"\'=<>`]*))?z]((?<=[\'"\s/])[^\s/>][^\s/=>]*)(\s*=+\s*(\'[^\']*\'|"[^"]*"|(?![\'"])[^>\s]*))?(?:\s|/(?!>))*a�
<[a-zA-Z][-.a-zA-Z0-9:_]* # tag name
(?:\s+ # whitespace before attribute name
(?:[a-zA-Z_][-.:a-zA-Z0-9_]* # attribute name
(?:\s*=\s* # value indicator
(?:'[^']*' # LITA-enclosed value
|\"[^\"]*\" # LIT-enclosed value
|[^'\">\s]+ # bare value
)
)?
)
)*
\s* # trailing whitespace
aF
<[a-zA-Z][-.a-zA-Z0-9:_]* # tag name
(?:[\s/]* # optional whitespace before attribute name
(?:(?<=['"\s/])[^\s/>][^\s/=>]* # attribute name
(?:\s*=+\s* # value indicator
(?:'[^']*' # LITA-enclosed value
|"[^"]*" # LIT-enclosed value
|(?!['"])[^>\s]* # bare value
)
(?:\s*,)* # possibly followed by a comma
)?(?:\s|/(?!>))*
)*
)?
\s* # trailing whitespace
z#</\s*([a-zA-Z][-.a-zA-Z0-9:_]*)\s*>c @ s" e Zd ZdZddd�Zdd� ZdS ) �HTMLParseErrorz&Exception raised for all parse errors.�NNc C s& |sJ �|| _ |d | _|d | _d S )Nr � ��msg�lineno�offset)�selfr
�position� r �F/usr/local/lib/python3.9/site-packages/future/backports/html/parser.py�__init__U s
zHTMLParseError.__init__c C s> | j }| jd ur |d| j }| jd ur:|d| jd }|S )Nz , at line %dz , column %dr r )r �resultr r r �__str__[ s
zHTMLParseError.__str__N)r
)�__name__�
__module__� __qualname__�__doc__r r r r r r r R s
r c @ s� e Zd ZdZdZd:dd�Zdd� Zdd � Zd
d � Zd d
� Z dZ
dd� Z dd� Z dd� Z
dd� Zdd� Zd;dd�Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z dS )<�
HTMLParsera� Find tags and other markup and call handler functions.
Usage:
p = HTMLParser()
p.feed(data)
...
p.close()
Start tags are handled by calling self.handle_starttag() or
self.handle_startendtag(); end tags by self.handle_endtag(). The
data between tags is passed from the parser to the derived class
by calling self.handle_data() with the data as argument (the data
may be split up in arbitrary chunks). Entity references are
passed by calling self.handle_entityref() with the entity
reference as the argument. Numeric character references are
passed to self.handle_charref() with the string containing the
reference as the argument.
)�script�styleFc C s& |rt jdtdd� || _| �� dS )z�Initialize and reset this instance.
If strict is set to False (the default) the parser will parse invalid
markup, otherwise it will raise an error. Note that the strict mode
is deprecated.
z The strict mode is deprecated.� )�
stacklevelN)�warnings�warn�DeprecationWarning�strict�reset)r r# r r r r z s �zHTMLParser.__init__c C s( d| _ d| _t| _d| _tj�| � dS )z1Reset this instance. Loses all unprocessed data.� z???N)�rawdata�lasttag�interesting_normal� interesting�
cdata_elemr �
ParserBaser$ �r r r r r$ � s
zHTMLParser.resetc C s | j | | _ | �d� dS )z�Feed data to the parser.
Call this as often as you want, with as little or as much text
as you want (may include '\n').
r N)r& �goahead�r �datar r r �feed� s zHTMLParser.feedc C s | � d� dS )zHandle any buffered data.r N)r- r, r r r �close� s zHTMLParser.closec C s t || �� ��d S �N)r �getpos)r �messager r r �error� s zHTMLParser.errorNc C s | j S )z)Return full source of start tag: '<...>'.)�_HTMLParser__starttag_textr, r r r �get_starttag_text� s z HTMLParser.get_starttag_textc C s$ |� � | _t�d| j tj�| _d S )Nz </\s*%s\s*>)�lowerr* �re�compile�Ir) )r �elemr r r �set_cdata_mode� s
zHTMLParser.set_cdata_modec C s t | _d | _d S r2 )r( r) r* r, r r r �clear_cdata_mode� s zHTMLParser.clear_cdata_modec
C s� | j }d}t|�}||k �rd| j�||�}|r8|�� }n| jrB�qd|}||k r`| �|||� � | �||�}||krx�qd|j}|d|��r�t �
||�r�| � |�}n�|d|�r�| � |�}n~|d|�r�| �
|�}nh|d|�r�| �|�}nR|d|��r| j�r| �|�}n
| �|�}n&|d |k �rd| �d� |d }n�qd|dk �r�|�sJ�qd| j�r\| �d� |�d |d �}|dk �r�|�d|d �}|dk �r�|d }n|d7 }| �|||� � | �||�}q|d
|��r`t�
||�}|�r*|�� d d � } | �| � |�� }|d
|d ��s|d }| �||�}qn4d
||d � v �rd| �|dd � � | �|d �}�qdq|d|��rVt�
||�}|�r�|�d�} | �| � |�� }|d
|d ��s�|d }| �||�}qt�
||�}|�r&|�rd|�� ||d � k�rd| j�r| �d� n ||k�r|}| �||d �}�qdn.|d |k �rd| �d� | �||d �}n�qdqdsJ d��q|�r�||k �r�| j�s�| �|||� � | �||�}||d � | _ d S )Nr �<�</�<!--�<?�<!r zEOF in middle of constructr �&#r ����;�&z#EOF in middle of entity or char refzinteresting.search() lied)r& �lenr) �search�startr* � handle_data� updatepos�
startswith� starttagopen�match�parse_starttag� parse_endtag�
parse_comment�parse_pir# �parse_declaration�parse_html_declarationr5 �find�charref�group�handle_charref�end� entityref�handle_entityref�
incomplete)
r rZ r& �i�nrO �jrM �k�namer r r r- � s�
zHTMLParser.goaheadc C s� | j }|||d � dks"J d��|||d � dkr@| �|�S |||d � dkr^| �|�S |||d � �� d kr�|�d
|d �}|d kr�d S | �||d |� � |d S | �|�S d S )
Nr rC z+unexpected call to parse_html_declaration()� rA � z<![� z <!doctyper rE r )r& rR �parse_marked_sectionr8 rV � handle_decl�parse_bogus_comment)r r^ r& �gtposr r r rU s
z!HTMLParser.parse_html_declarationr c C s` | j }|||d � dv s"J d��|�d|d �}|dkr>dS |rX| �||d |� � |d S )Nr )rC r@ z"unexpected call to parse_comment()r rE r )r& rV �handle_comment)r r^ �reportr& �posr r r rh - s z HTMLParser.parse_bogus_commentc C sd | j }|||d � dks"J d��t�||d �}|s:dS |�� }| �||d |� � |�� }|S )Nr rB z unexpected call to parse_pi()rE )r& �picloserI rJ � handle_pirZ )r r^ r& rO r` r r r rS 9 s zHTMLParser.parse_pic C s. d | _ | �|�}|dk r |S | j}|||� | _ g }t�||d �}|sPJ d��|�� }|�d��� | _}||k �rH| j r�t
�||�}n t �||�}|s��qH|�ddd�\} }
} |
s�d } n`| d d� d kr�| dd � k�sn | d d� d k�r | dd � k�r n n | dd� } | �r,| � | �} |�
| �� | f� |�� }ql|||� �� } | d v�r�| �� \}
}d
| j v �r�|
| j �d
� }
t| j �| j �d
� }n|t| j � }| j �r�| �d |||� d d � f � | �|||� � |S | �d
��r| �||� n"| �||� || jv �r*| �|� |S )Nr r z#unexpected call to parse_starttag()r rd �'rE �")r �/>�
z junk characters in start tag: %r� rq )r6 �check_for_whole_start_tagr& �tagfindrO rZ rX r8 r' r# �attrfind�attrfind_tolerant�unescape�append�stripr3 �countrH �rfindr5 rK �endswith�handle_startendtag�handle_starttag�CDATA_CONTENT_ELEMENTSr= )r r^ �endposr& �attrsrO ra �tag�m�attrname�rest� attrvaluerZ r r r r r rP E sf
( �
�
��
zHTMLParser.parse_starttagc C s | j }| jrt�||�}n t�||�}|r�|�� }|||d � }|dkrR|d S |dkr�|�d|�rn|d S |�d|�r~dS | jr�| �||d � | �d� ||kr�|S |d S |dkr�dS |d v r�dS | jr�| �||� | �d
� ||kr�|S |d S t d ��d S ) Nr r �/rq r rE zmalformed empty start tagr% z6abcdefghijklmnopqrstuvwxyz=/ABCDEFGHIJKLMNOPQRSTUVWXYZzmalformed start tagzwe should not get here!)
r& r# �locatestarttagendrO �locatestarttagend_tolerantrZ rM rL r5 �AssertionError)r r^ r& r� r` �nextr r r rt ~ s>
z$HTMLParser.check_for_whole_start_tagc C sN | j }|||d � dks"J d��t�||d �}|s:dS |�� }t�||�}|s�| jd urr| �|||� � |S | jr�| � d|||� f � t
�||d �}|s�|||d � dkr�|d S | � |�S |� � �
� }|�d |�� �}| �|� |d S |� d��
� }| jd u�r4|| jk�r4| �|||� � |S | �|�
� � | �� |S )
Nr r@ z unexpected call to parse_endtagr rE zbad end tag: %rrd z</>r )r& � endendtagrI rZ �
endtagfindrO r* rK r# r5 �tagfind_tolerantrh rX r8 rV �
handle_endtagr> )r r^ r& rO ri � namematch�tagnamer< r r r rQ � s<
zHTMLParser.parse_endtagc C s | � ||� | �|� d S r2 )r r� �r r� r� r r r r~ � s z HTMLParser.handle_startendtagc C s d S r2 r r� r r r r � s zHTMLParser.handle_starttagc C s d S r2 r )r r� r r r r� � s zHTMLParser.handle_endtagc C s d S r2 r �r rb r r r rY � s zHTMLParser.handle_charrefc C s d S r2 r r� r r r r\ � s zHTMLParser.handle_entityrefc C s d S r2 r r. r r r rK � s zHTMLParser.handle_datac C s d S r2 r r. r r r rj � s zHTMLParser.handle_commentc C s d S r2 r )r �declr r r rg � s zHTMLParser.handle_declc C s d S r2 r r. r r r rn � s zHTMLParser.handle_pic C s | j r| �d|f � d S )Nzunknown declaration: %r)r# r5 r. r r r � unknown_decl� s zHTMLParser.unknown_declc C s" d|vr |S dd� }t �d||�S )NrG c S s | � � d } zZ| d dkrd| dd � } | d dv rLt| dd � �d�d�}nt| �d��}t|�W S W n ty� d| Y S 0 ddlm} | |v r�|| S | �d�r�d | S td
t | ��D ]4}| d |� |v r�|| d |� | |d � S q�d | S d S ) Nr �#r )�x�XrF � rD )�html5rG r )
�groups�int�rstrip�chr�
ValueErrorZ future.backports.html.entitiesr� r} �rangerH )�s�cr� r� r r r �replaceEntities� s&
"z,HTMLParser.unescape.<locals>.replaceEntitiesz&&(#?[xX]?(?:[0-9a-fA-F]+;|\w{1,32};?)))r9 �sub)r r� r� r r r rx � s �zHTMLParser.unescape)F)r ) r r r r r� r r$ r0 r1 r5 r6 r7 r= r> r- rU rh rS rP rt rQ r~ r r� rY r\ rK rj rg rn r� rx r r r r r d s:
h
9+*r ) r �
__future__r r r r Zfuture.builtinsZfuture.backportsr r9 r r: r( r] r[ rW rN rm � commentcloseru r� rv rw �VERBOSEr� r� r� r� � Exceptionr r+ r r r r r �<module> s<
��
��
PK �Cu\�FS�:M :M future/backports/html/parser.pynu �[��� """A parser for HTML and XHTML.
Backported for python-future from Python 3.3.
"""
# This file is based on sgmllib.py, but the API is slightly different.
# XXX There should be a way to distinguish between PCDATA (parsed
# character data -- the normal case), RCDATA (replaceable character
# data -- only char and entity references and end tags are special)
# and CDATA (character data -- only end tags are special).
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from future.builtins import *
from future.backports import _markupbase
import re
import warnings
# Regular expressions used for parsing
interesting_normal = re.compile('[&<]')
incomplete = re.compile('&[a-zA-Z#]')
entityref = re.compile('&([a-zA-Z][-.a-zA-Z0-9]*)[^a-zA-Z0-9]')
charref = re.compile('&#(?:[0-9]+|[xX][0-9a-fA-F]+)[^0-9a-fA-F]')
starttagopen = re.compile('<[a-zA-Z]')
piclose = re.compile('>')
commentclose = re.compile(r'--\s*>')
tagfind = re.compile('([a-zA-Z][-.a-zA-Z0-9:_]*)(?:\s|/(?!>))*')
# see http://www.w3.org/TR/html5/tokenization.html#tag-open-state
# and http://www.w3.org/TR/html5/tokenization.html#tag-name-state
tagfind_tolerant = re.compile('[a-zA-Z][^\t\n\r\f />\x00]*')
# Note:
# 1) the strict attrfind isn't really strict, but we can't make it
# correctly strict without breaking backward compatibility;
# 2) if you change attrfind remember to update locatestarttagend too;
# 3) if you change attrfind and/or locatestarttagend the parser will
# explode, so don't do it.
attrfind = re.compile(
r'\s*([a-zA-Z_][-.:a-zA-Z_0-9]*)(\s*=\s*'
r'(\'[^\']*\'|"[^"]*"|[^\s"\'=<>`]*))?')
attrfind_tolerant = re.compile(
r'((?<=[\'"\s/])[^\s/>][^\s/=>]*)(\s*=+\s*'
r'(\'[^\']*\'|"[^"]*"|(?![\'"])[^>\s]*))?(?:\s|/(?!>))*')
locatestarttagend = re.compile(r"""
<[a-zA-Z][-.a-zA-Z0-9:_]* # tag name
(?:\s+ # whitespace before attribute name
(?:[a-zA-Z_][-.:a-zA-Z0-9_]* # attribute name
(?:\s*=\s* # value indicator
(?:'[^']*' # LITA-enclosed value
|\"[^\"]*\" # LIT-enclosed value
|[^'\">\s]+ # bare value
)
)?
)
)*
\s* # trailing whitespace
""", re.VERBOSE)
locatestarttagend_tolerant = re.compile(r"""
<[a-zA-Z][-.a-zA-Z0-9:_]* # tag name
(?:[\s/]* # optional whitespace before attribute name
(?:(?<=['"\s/])[^\s/>][^\s/=>]* # attribute name
(?:\s*=+\s* # value indicator
(?:'[^']*' # LITA-enclosed value
|"[^"]*" # LIT-enclosed value
|(?!['"])[^>\s]* # bare value
)
(?:\s*,)* # possibly followed by a comma
)?(?:\s|/(?!>))*
)*
)?
\s* # trailing whitespace
""", re.VERBOSE)
endendtag = re.compile('>')
# the HTML 5 spec, section 8.1.2.2, doesn't allow spaces between
# </ and the tag name, so maybe this should be fixed
endtagfind = re.compile('</\s*([a-zA-Z][-.a-zA-Z0-9:_]*)\s*>')
class HTMLParseError(Exception):
"""Exception raised for all parse errors."""
def __init__(self, msg, position=(None, None)):
assert msg
self.msg = msg
self.lineno = position[0]
self.offset = position[1]
def __str__(self):
result = self.msg
if self.lineno is not None:
result = result + ", at line %d" % self.lineno
if self.offset is not None:
result = result + ", column %d" % (self.offset + 1)
return result
class HTMLParser(_markupbase.ParserBase):
"""Find tags and other markup and call handler functions.
Usage:
p = HTMLParser()
p.feed(data)
...
p.close()
Start tags are handled by calling self.handle_starttag() or
self.handle_startendtag(); end tags by self.handle_endtag(). The
data between tags is passed from the parser to the derived class
by calling self.handle_data() with the data as argument (the data
may be split up in arbitrary chunks). Entity references are
passed by calling self.handle_entityref() with the entity
reference as the argument. Numeric character references are
passed to self.handle_charref() with the string containing the
reference as the argument.
"""
CDATA_CONTENT_ELEMENTS = ("script", "style")
def __init__(self, strict=False):
"""Initialize and reset this instance.
If strict is set to False (the default) the parser will parse invalid
markup, otherwise it will raise an error. Note that the strict mode
is deprecated.
"""
if strict:
warnings.warn("The strict mode is deprecated.",
DeprecationWarning, stacklevel=2)
self.strict = strict
self.reset()
def reset(self):
"""Reset this instance. Loses all unprocessed data."""
self.rawdata = ''
self.lasttag = '???'
self.interesting = interesting_normal
self.cdata_elem = None
_markupbase.ParserBase.reset(self)
def feed(self, data):
r"""Feed data to the parser.
Call this as often as you want, with as little or as much text
as you want (may include '\n').
"""
self.rawdata = self.rawdata + data
self.goahead(0)
def close(self):
"""Handle any buffered data."""
self.goahead(1)
def error(self, message):
raise HTMLParseError(message, self.getpos())
__starttag_text = None
def get_starttag_text(self):
"""Return full source of start tag: '<...>'."""
return self.__starttag_text
def set_cdata_mode(self, elem):
self.cdata_elem = elem.lower()
self.interesting = re.compile(r'</\s*%s\s*>' % self.cdata_elem, re.I)
def clear_cdata_mode(self):
self.interesting = interesting_normal
self.cdata_elem = None
# Internal -- handle data as far as reasonable. May leave state
# and data to be processed by a subsequent call. If 'end' is
# true, force handling all data as if followed by EOF marker.
def goahead(self, end):
rawdata = self.rawdata
i = 0
n = len(rawdata)
while i < n:
match = self.interesting.search(rawdata, i) # < or &
if match:
j = match.start()
else:
if self.cdata_elem:
break
j = n
if i < j: self.handle_data(rawdata[i:j])
i = self.updatepos(i, j)
if i == n: break
startswith = rawdata.startswith
if startswith('<', i):
if starttagopen.match(rawdata, i): # < + letter
k = self.parse_starttag(i)
elif startswith("</", i):
k = self.parse_endtag(i)
elif startswith("<!--", i):
k = self.parse_comment(i)
elif startswith("<?", i):
k = self.parse_pi(i)
elif startswith("<!", i):
if self.strict:
k = self.parse_declaration(i)
else:
k = self.parse_html_declaration(i)
elif (i + 1) < n:
self.handle_data("<")
k = i + 1
else:
break
if k < 0:
if not end:
break
if self.strict:
self.error("EOF in middle of construct")
k = rawdata.find('>', i + 1)
if k < 0:
k = rawdata.find('<', i + 1)
if k < 0:
k = i + 1
else:
k += 1
self.handle_data(rawdata[i:k])
i = self.updatepos(i, k)
elif startswith("&#", i):
match = charref.match(rawdata, i)
if match:
name = match.group()[2:-1]
self.handle_charref(name)
k = match.end()
if not startswith(';', k-1):
k = k - 1
i = self.updatepos(i, k)
continue
else:
if ";" in rawdata[i:]: #bail by consuming &#
self.handle_data(rawdata[0:2])
i = self.updatepos(i, 2)
break
elif startswith('&', i):
match = entityref.match(rawdata, i)
if match:
name = match.group(1)
self.handle_entityref(name)
k = match.end()
if not startswith(';', k-1):
k = k - 1
i = self.updatepos(i, k)
continue
match = incomplete.match(rawdata, i)
if match:
# match.group() will contain at least 2 chars
if end and match.group() == rawdata[i:]:
if self.strict:
self.error("EOF in middle of entity or char ref")
else:
if k <= i:
k = n
i = self.updatepos(i, i + 1)
# incomplete
break
elif (i + 1) < n:
# not the end of the buffer, and can't be confused
# with some other construct
self.handle_data("&")
i = self.updatepos(i, i + 1)
else:
break
else:
assert 0, "interesting.search() lied"
# end while
if end and i < n and not self.cdata_elem:
self.handle_data(rawdata[i:n])
i = self.updatepos(i, n)
self.rawdata = rawdata[i:]
# Internal -- parse html declarations, return length or -1 if not terminated
# See w3.org/TR/html5/tokenization.html#markup-declaration-open-state
# See also parse_declaration in _markupbase
def parse_html_declaration(self, i):
rawdata = self.rawdata
assert rawdata[i:i+2] == '<!', ('unexpected call to '
'parse_html_declaration()')
if rawdata[i:i+4] == '<!--':
# this case is actually already handled in goahead()
return self.parse_comment(i)
elif rawdata[i:i+3] == '<![':
return self.parse_marked_section(i)
elif rawdata[i:i+9].lower() == '<!doctype':
# find the closing >
gtpos = rawdata.find('>', i+9)
if gtpos == -1:
return -1
self.handle_decl(rawdata[i+2:gtpos])
return gtpos+1
else:
return self.parse_bogus_comment(i)
# Internal -- parse bogus comment, return length or -1 if not terminated
# see http://www.w3.org/TR/html5/tokenization.html#bogus-comment-state
def parse_bogus_comment(self, i, report=1):
rawdata = self.rawdata
assert rawdata[i:i+2] in ('<!', '</'), ('unexpected call to '
'parse_comment()')
pos = rawdata.find('>', i+2)
if pos == -1:
return -1
if report:
self.handle_comment(rawdata[i+2:pos])
return pos + 1
# Internal -- parse processing instr, return end or -1 if not terminated
def parse_pi(self, i):
rawdata = self.rawdata
assert rawdata[i:i+2] == '<?', 'unexpected call to parse_pi()'
match = piclose.search(rawdata, i+2) # >
if not match:
return -1
j = match.start()
self.handle_pi(rawdata[i+2: j])
j = match.end()
return j
# Internal -- handle starttag, return end or -1 if not terminated
def parse_starttag(self, i):
self.__starttag_text = None
endpos = self.check_for_whole_start_tag(i)
if endpos < 0:
return endpos
rawdata = self.rawdata
self.__starttag_text = rawdata[i:endpos]
# Now parse the data between i+1 and j into a tag and attrs
attrs = []
match = tagfind.match(rawdata, i+1)
assert match, 'unexpected call to parse_starttag()'
k = match.end()
self.lasttag = tag = match.group(1).lower()
while k < endpos:
if self.strict:
m = attrfind.match(rawdata, k)
else:
m = attrfind_tolerant.match(rawdata, k)
if not m:
break
attrname, rest, attrvalue = m.group(1, 2, 3)
if not rest:
attrvalue = None
elif attrvalue[:1] == '\'' == attrvalue[-1:] or \
attrvalue[:1] == '"' == attrvalue[-1:]:
attrvalue = attrvalue[1:-1]
if attrvalue:
attrvalue = self.unescape(attrvalue)
attrs.append((attrname.lower(), attrvalue))
k = m.end()
end = rawdata[k:endpos].strip()
if end not in (">", "/>"):
lineno, offset = self.getpos()
if "\n" in self.__starttag_text:
lineno = lineno + self.__starttag_text.count("\n")
offset = len(self.__starttag_text) \
- self.__starttag_text.rfind("\n")
else:
offset = offset + len(self.__starttag_text)
if self.strict:
self.error("junk characters in start tag: %r"
% (rawdata[k:endpos][:20],))
self.handle_data(rawdata[i:endpos])
return endpos
if end.endswith('/>'):
# XHTML-style empty tag: <span attr="value" />
self.handle_startendtag(tag, attrs)
else:
self.handle_starttag(tag, attrs)
if tag in self.CDATA_CONTENT_ELEMENTS:
self.set_cdata_mode(tag)
return endpos
# Internal -- check to see if we have a complete starttag; return end
# or -1 if incomplete.
def check_for_whole_start_tag(self, i):
rawdata = self.rawdata
if self.strict:
m = locatestarttagend.match(rawdata, i)
else:
m = locatestarttagend_tolerant.match(rawdata, i)
if m:
j = m.end()
next = rawdata[j:j+1]
if next == ">":
return j + 1
if next == "/":
if rawdata.startswith("/>", j):
return j + 2
if rawdata.startswith("/", j):
# buffer boundary
return -1
# else bogus input
if self.strict:
self.updatepos(i, j + 1)
self.error("malformed empty start tag")
if j > i:
return j
else:
return i + 1
if next == "":
# end of input
return -1
if next in ("abcdefghijklmnopqrstuvwxyz=/"
"ABCDEFGHIJKLMNOPQRSTUVWXYZ"):
# end of input in or before attribute value, or we have the
# '/' from a '/>' ending
return -1
if self.strict:
self.updatepos(i, j)
self.error("malformed start tag")
if j > i:
return j
else:
return i + 1
raise AssertionError("we should not get here!")
# Internal -- parse endtag, return end or -1 if incomplete
def parse_endtag(self, i):
rawdata = self.rawdata
assert rawdata[i:i+2] == "</", "unexpected call to parse_endtag"
match = endendtag.search(rawdata, i+1) # >
if not match:
return -1
gtpos = match.end()
match = endtagfind.match(rawdata, i) # </ + tag + >
if not match:
if self.cdata_elem is not None:
self.handle_data(rawdata[i:gtpos])
return gtpos
if self.strict:
self.error("bad end tag: %r" % (rawdata[i:gtpos],))
# find the name: w3.org/TR/html5/tokenization.html#tag-name-state
namematch = tagfind_tolerant.match(rawdata, i+2)
if not namematch:
# w3.org/TR/html5/tokenization.html#end-tag-open-state
if rawdata[i:i+3] == '</>':
return i+3
else:
return self.parse_bogus_comment(i)
tagname = namematch.group().lower()
# consume and ignore other stuff between the name and the >
# Note: this is not 100% correct, since we might have things like
# </tag attr=">">, but looking for > after tha name should cover
# most of the cases and is much simpler
gtpos = rawdata.find('>', namematch.end())
self.handle_endtag(tagname)
return gtpos+1
elem = match.group(1).lower() # script or style
if self.cdata_elem is not None:
if elem != self.cdata_elem:
self.handle_data(rawdata[i:gtpos])
return gtpos
self.handle_endtag(elem.lower())
self.clear_cdata_mode()
return gtpos
# Overridable -- finish processing of start+end tag: <tag.../>
def handle_startendtag(self, tag, attrs):
self.handle_starttag(tag, attrs)
self.handle_endtag(tag)
# Overridable -- handle start tag
def handle_starttag(self, tag, attrs):
pass
# Overridable -- handle end tag
def handle_endtag(self, tag):
pass
# Overridable -- handle character reference
def handle_charref(self, name):
pass
# Overridable -- handle entity reference
def handle_entityref(self, name):
pass
# Overridable -- handle data
def handle_data(self, data):
pass
# Overridable -- handle comment
def handle_comment(self, data):
pass
# Overridable -- handle declaration
def handle_decl(self, decl):
pass
# Overridable -- handle processing instruction
def handle_pi(self, data):
pass
def unknown_decl(self, data):
if self.strict:
self.error("unknown declaration: %r" % (data,))
# Internal -- helper to remove special character quoting
def unescape(self, s):
if '&' not in s:
return s
def replaceEntities(s):
s = s.groups()[0]
try:
if s[0] == "#":
s = s[1:]
if s[0] in ['x','X']:
c = int(s[1:].rstrip(';'), 16)
else:
c = int(s.rstrip(';'))
return chr(c)
except ValueError:
return '&#' + s
else:
from future.backports.html.entities import html5
if s in html5:
return html5[s]
elif s.endswith(';'):
return '&' + s
for x in range(2, len(s)):
if s[:x] in html5:
return html5[s[:x]] + s[x:]
else:
return '&' + s
return re.sub(r"&(#?[xX]?(?:[0-9a-fA-F]+;|\w{1,32};?))",
replaceEntities, s)
PK �Cu\�H�g future/backports/__init__.pynu �[��� """
future.backports package
"""
from __future__ import absolute_import
import sys
__future_module__ = True
from future.standard_library import import_top_level_modules
if sys.version_info[0] >= 3:
import_top_level_modules()
from .misc import (ceil,
OrderedDict,
Counter,
ChainMap,
check_output,
count,
recursive_repr,
_count_elements,
cmp_to_key
)
PK �Cu\X�h~/= /= future/backports/socket.pynu �[��� # Wrapper module for _socket, providing some additional facilities
# implemented in Python.
"""\
This module provides socket operations and some related functions.
On Unix, it supports IP (Internet Protocol) and Unix domain sockets.
On other systems, it only supports IP. Functions specific for a
socket are available as methods of the socket object.
Functions:
socket() -- create a new socket object
socketpair() -- create a pair of new socket objects [*]
fromfd() -- create a socket object from an open file descriptor [*]
fromshare() -- create a socket object from data received from socket.share() [*]
gethostname() -- return the current hostname
gethostbyname() -- map a hostname to its IP number
gethostbyaddr() -- map an IP number or hostname to DNS info
getservbyname() -- map a service name and a protocol name to a port number
getprotobyname() -- map a protocol name (e.g. 'tcp') to a number
ntohs(), ntohl() -- convert 16, 32 bit int from network to host byte order
htons(), htonl() -- convert 16, 32 bit int from host to network byte order
inet_aton() -- convert IP addr string (123.45.67.89) to 32-bit packed format
inet_ntoa() -- convert 32-bit packed format IP to string (123.45.67.89)
socket.getdefaulttimeout() -- get the default timeout value
socket.setdefaulttimeout() -- set the default timeout value
create_connection() -- connects to an address, with an optional timeout and
optional source address.
[*] not available on all platforms!
Special objects:
SocketType -- type object for socket objects
error -- exception raised for I/O errors
has_ipv6 -- boolean value indicating if IPv6 is supported
Integer constants:
AF_INET, AF_UNIX -- socket domains (first argument to socket() call)
SOCK_STREAM, SOCK_DGRAM, SOCK_RAW -- socket types (second argument)
Many other constants may be defined; these may be used in calls to
the setsockopt() and getsockopt() methods.
"""
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
import _socket
from _socket import *
import os, sys, io
try:
import errno
except ImportError:
errno = None
EBADF = getattr(errno, 'EBADF', 9)
EAGAIN = getattr(errno, 'EAGAIN', 11)
EWOULDBLOCK = getattr(errno, 'EWOULDBLOCK', 11)
__all__ = ["getfqdn", "create_connection"]
__all__.extend(os._get_exports_list(_socket))
_realsocket = socket
# WSA error codes
if sys.platform.lower().startswith("win"):
errorTab = {}
errorTab[10004] = "The operation was interrupted."
errorTab[10009] = "A bad file handle was passed."
errorTab[10013] = "Permission denied."
errorTab[10014] = "A fault occurred on the network??" # WSAEFAULT
errorTab[10022] = "An invalid operation was attempted."
errorTab[10035] = "The socket operation would block"
errorTab[10036] = "A blocking operation is already in progress."
errorTab[10048] = "The network address is in use."
errorTab[10054] = "The connection has been reset."
errorTab[10058] = "The network has been shut down."
errorTab[10060] = "The operation timed out."
errorTab[10061] = "Connection refused."
errorTab[10063] = "The name is too long."
errorTab[10064] = "The host is down."
errorTab[10065] = "The host is unreachable."
__all__.append("errorTab")
class socket(_socket.socket):
"""A subclass of _socket.socket adding the makefile() method."""
__slots__ = ["__weakref__", "_io_refs", "_closed"]
def __init__(self, family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None):
if fileno is None:
_socket.socket.__init__(self, family, type, proto)
else:
_socket.socket.__init__(self, family, type, proto, fileno)
self._io_refs = 0
self._closed = False
def __enter__(self):
return self
def __exit__(self, *args):
if not self._closed:
self.close()
def __repr__(self):
"""Wrap __repr__() to reveal the real class name."""
s = _socket.socket.__repr__(self)
if s.startswith("<socket object"):
s = "<%s.%s%s%s" % (self.__class__.__module__,
self.__class__.__name__,
getattr(self, '_closed', False) and " [closed] " or "",
s[7:])
return s
def __getstate__(self):
raise TypeError("Cannot serialize socket object")
def dup(self):
"""dup() -> socket object
Return a new socket object connected to the same system resource.
"""
fd = dup(self.fileno())
sock = self.__class__(self.family, self.type, self.proto, fileno=fd)
sock.settimeout(self.gettimeout())
return sock
def accept(self):
"""accept() -> (socket object, address info)
Wait for an incoming connection. Return a new socket
representing the connection, and the address of the client.
For IP sockets, the address info is a pair (hostaddr, port).
"""
fd, addr = self._accept()
sock = socket(self.family, self.type, self.proto, fileno=fd)
# Issue #7995: if no default timeout is set and the listening
# socket had a (non-zero) timeout, force the new socket in blocking
# mode to override platform-specific socket flags inheritance.
if getdefaulttimeout() is None and self.gettimeout():
sock.setblocking(True)
return sock, addr
def makefile(self, mode="r", buffering=None, **_3to2kwargs):
"""makefile(...) -> an I/O stream connected to the socket
The arguments are as for io.open() after the filename,
except the only mode characters supported are 'r', 'w' and 'b'.
The semantics are similar too. (XXX refactor to share code?)
"""
if 'newline' in _3to2kwargs: newline = _3to2kwargs['newline']; del _3to2kwargs['newline']
else: newline = None
if 'errors' in _3to2kwargs: errors = _3to2kwargs['errors']; del _3to2kwargs['errors']
else: errors = None
if 'encoding' in _3to2kwargs: encoding = _3to2kwargs['encoding']; del _3to2kwargs['encoding']
else: encoding = None
for c in mode:
if c not in ("r", "w", "b"):
raise ValueError("invalid mode %r (only r, w, b allowed)")
writing = "w" in mode
reading = "r" in mode or not writing
assert reading or writing
binary = "b" in mode
rawmode = ""
if reading:
rawmode += "r"
if writing:
rawmode += "w"
raw = SocketIO(self, rawmode)
self._io_refs += 1
if buffering is None:
buffering = -1
if buffering < 0:
buffering = io.DEFAULT_BUFFER_SIZE
if buffering == 0:
if not binary:
raise ValueError("unbuffered streams must be binary")
return raw
if reading and writing:
buffer = io.BufferedRWPair(raw, raw, buffering)
elif reading:
buffer = io.BufferedReader(raw, buffering)
else:
assert writing
buffer = io.BufferedWriter(raw, buffering)
if binary:
return buffer
text = io.TextIOWrapper(buffer, encoding, errors, newline)
text.mode = mode
return text
def _decref_socketios(self):
if self._io_refs > 0:
self._io_refs -= 1
if self._closed:
self.close()
def _real_close(self, _ss=_socket.socket):
# This function should not reference any globals. See issue #808164.
_ss.close(self)
def close(self):
# This function should not reference any globals. See issue #808164.
self._closed = True
if self._io_refs <= 0:
self._real_close()
def detach(self):
"""detach() -> file descriptor
Close the socket object without closing the underlying file descriptor.
The object cannot be used after this call, but the file descriptor
can be reused for other purposes. The file descriptor is returned.
"""
self._closed = True
return super().detach()
def fromfd(fd, family, type, proto=0):
""" fromfd(fd, family, type[, proto]) -> socket object
Create a socket object from a duplicate of the given file
descriptor. The remaining arguments are the same as for socket().
"""
nfd = dup(fd)
return socket(family, type, proto, nfd)
if hasattr(_socket.socket, "share"):
def fromshare(info):
""" fromshare(info) -> socket object
Create a socket object from a the bytes object returned by
socket.share(pid).
"""
return socket(0, 0, 0, info)
if hasattr(_socket, "socketpair"):
def socketpair(family=None, type=SOCK_STREAM, proto=0):
"""socketpair([family[, type[, proto]]]) -> (socket object, socket object)
Create a pair of socket objects from the sockets returned by the platform
socketpair() function.
The arguments are the same as for socket() except the default family is
AF_UNIX if defined on the platform; otherwise, the default is AF_INET.
"""
if family is None:
try:
family = AF_UNIX
except NameError:
family = AF_INET
a, b = _socket.socketpair(family, type, proto)
a = socket(family, type, proto, a.detach())
b = socket(family, type, proto, b.detach())
return a, b
_blocking_errnos = set([EAGAIN, EWOULDBLOCK])
class SocketIO(io.RawIOBase):
"""Raw I/O implementation for stream sockets.
This class supports the makefile() method on sockets. It provides
the raw I/O interface on top of a socket object.
"""
# One might wonder why not let FileIO do the job instead. There are two
# main reasons why FileIO is not adapted:
# - it wouldn't work under Windows (where you can't used read() and
# write() on a socket handle)
# - it wouldn't work with socket timeouts (FileIO would ignore the
# timeout and consider the socket non-blocking)
# XXX More docs
def __init__(self, sock, mode):
if mode not in ("r", "w", "rw", "rb", "wb", "rwb"):
raise ValueError("invalid mode: %r" % mode)
io.RawIOBase.__init__(self)
self._sock = sock
if "b" not in mode:
mode += "b"
self._mode = mode
self._reading = "r" in mode
self._writing = "w" in mode
self._timeout_occurred = False
def readinto(self, b):
"""Read up to len(b) bytes into the writable buffer *b* and return
the number of bytes read. If the socket is non-blocking and no bytes
are available, None is returned.
If *b* is non-empty, a 0 return value indicates that the connection
was shutdown at the other end.
"""
self._checkClosed()
self._checkReadable()
if self._timeout_occurred:
raise IOError("cannot read from timed out object")
while True:
try:
return self._sock.recv_into(b)
except timeout:
self._timeout_occurred = True
raise
# except InterruptedError:
# continue
except error as e:
if e.args[0] in _blocking_errnos:
return None
raise
def write(self, b):
"""Write the given bytes or bytearray object *b* to the socket
and return the number of bytes written. This can be less than
len(b) if not all data could be written. If the socket is
non-blocking and no bytes could be written None is returned.
"""
self._checkClosed()
self._checkWritable()
try:
return self._sock.send(b)
except error as e:
# XXX what about EINTR?
if e.args[0] in _blocking_errnos:
return None
raise
def readable(self):
"""True if the SocketIO is open for reading.
"""
if self.closed:
raise ValueError("I/O operation on closed socket.")
return self._reading
def writable(self):
"""True if the SocketIO is open for writing.
"""
if self.closed:
raise ValueError("I/O operation on closed socket.")
return self._writing
def seekable(self):
"""True if the SocketIO is open for seeking.
"""
if self.closed:
raise ValueError("I/O operation on closed socket.")
return super().seekable()
def fileno(self):
"""Return the file descriptor of the underlying socket.
"""
self._checkClosed()
return self._sock.fileno()
@property
def name(self):
if not self.closed:
return self.fileno()
else:
return -1
@property
def mode(self):
return self._mode
def close(self):
"""Close the SocketIO object. This doesn't close the underlying
socket, except if all references to it have disappeared.
"""
if self.closed:
return
io.RawIOBase.close(self)
self._sock._decref_socketios()
self._sock = None
def getfqdn(name=''):
"""Get fully qualified domain name from name.
An empty argument is interpreted as meaning the local host.
First the hostname returned by gethostbyaddr() is checked, then
possibly existing aliases. In case no FQDN is available, hostname
from gethostname() is returned.
"""
name = name.strip()
if not name or name == '0.0.0.0':
name = gethostname()
try:
hostname, aliases, ipaddrs = gethostbyaddr(name)
except error:
pass
else:
aliases.insert(0, hostname)
for name in aliases:
if '.' in name:
break
else:
name = hostname
return name
# Re-use the same sentinel as in the Python stdlib socket module:
from socket import _GLOBAL_DEFAULT_TIMEOUT
# Was: _GLOBAL_DEFAULT_TIMEOUT = object()
def create_connection(address, timeout=_GLOBAL_DEFAULT_TIMEOUT,
source_address=None):
"""Connect to *address* and return the socket object.
Convenience function. Connect to *address* (a 2-tuple ``(host,
port)``) and return the socket object. Passing the optional
*timeout* parameter will set the timeout on the socket instance
before attempting to connect. If no *timeout* is supplied, the
global default timeout setting returned by :func:`getdefaulttimeout`
is used. If *source_address* is set it must be a tuple of (host, port)
for the socket to bind as a source address before making the connection.
An host of '' or port 0 tells the OS to use the default.
"""
host, port = address
err = None
for res in getaddrinfo(host, port, 0, SOCK_STREAM):
af, socktype, proto, canonname, sa = res
sock = None
try:
sock = socket(af, socktype, proto)
if timeout is not _GLOBAL_DEFAULT_TIMEOUT:
sock.settimeout(timeout)
if source_address:
sock.bind(source_address)
sock.connect(sa)
return sock
except error as _:
err = _
if sock is not None:
sock.close()
if err is not None:
raise err
else:
raise error("getaddrinfo returns an empty list")
PK �Cu\'( g g 4 future/backports/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ sl d Z ddlmZ ddlZdZddlmZ ejd dkr<e� ddlm Z m
Z
m Z m Z m
Z
mZmZmZmZ dS ) z
future.backports package
� )�absolute_importNT)�import_top_level_modules� � ) �ceil� OrderedDict�Counter�ChainMap� check_output�count�recursive_repr�_count_elements�
cmp_to_key)�__doc__�
__future__r �sysZ__future_module__Zfuture.standard_libraryr � version_info�miscr r r r r
r r r
r � r r �C/usr/local/lib/python3.9/site-packages/future/backports/__init__.py�<module> s PK �Cu\lu1� �� 4 future/backports/__pycache__/datetime.cpython-39.pycnu �[��� a
��?h!' � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm
Z
dd
lm Z dd lm Z dd l
mZmZ dd
lZdd
lZdd� ZdZdZdZg d�Zd
gZdZedd
� D ]Ze� e� ee7 Zq�[[dd� Z dd� Z dd� Z dd� Z d d � Z!e d �Z"e d �Z#e d �Z$e$d!k�s8J �e"d"e# d k�sNJ �e#d#e$ d k�sdJ �d$d%� Z%g d&�Z&g d'�Z'd(d)� Z(d*d+� Z)d,d-� Z*d.d/� Z+d0d1� Z,d2d3� Z-d4d5� Z.d6d7� Z/d8d9� Z0d:d;� Z1G d<d=� d=e �Z2e2d>�e2_3e2d?d@dAdAdBdC�e2_4e2ddD�e2_5G dEdF� dFe �Z6e6Z7e6ddd�e6_3e6ddGdH�e6_4e2ddI�e6_5G dJdK� dKe �Z8e8Z9G dLdM� dMe �ZeZ:eddd�e_3ed@dAdAdB�e_4e2ddD�e_5G dNdO� dOe6�Z;e;ddd�e;_3e;ddGdHd@dAdAdB�e;_4e2ddD�e;_5dPdQ� Z<G dRdS� dSe8�Z=e=�>e2d��e=_?e=�>e=j@�e=_3e=�>e=jA�e=_4e;dTdde=j?dU�ZBz ddVlCT W n eD�yJ Y nL0 ['[[[#["[$[[&[([+[.[/[0[,[-[[1[7[ [ [ [)[ [<[[%[[:[9[*[!ddWlCm Z d
S )Xz�Concrete date/time and related types.
See http://www.iana.org/time-zones/repository/tz-link.html for
time zone and DST data sources.
� )�division)�unicode_literals)�print_function)�absolute_import)�str)�bytes)�map)�round)�int)�object)�
native_str�PY2Nc C s | |kr dS | |krdS dS )Nr � ���� ��x�yr r �C/usr/local/lib/python3.9/site-packages/future/backports/datetime.py�_cmp s r r i' i۹7 )
N� � r � r r r r r r r r c C s$ | d dko"| d dkp"| d dkS )z year -> 1 if leap year, else 0.� r �d � r )�yearr r r �_is_leap. s r c C s( | d }|d |d |d |d S )z2year -> number of days before January 1st of year.r �m r r r r )r r r r r �_days_before_year2 s r c C s: d| krdks n J |��|dkr2t | �r2dS t| S )z9year, month -> number of days in that month in that year.r � � � )r �_DAYS_IN_MONTH�r �monthr r r �_days_in_month7 s r& c C s6 d| krdks n J d��t | |dko2t| � S )zCyear, month -> number of days in year preceding first day of month.r r �month must be in 1..12r! )�_DAYS_BEFORE_MONTHr r$ r r r �_days_before_month> s r) c C s` d| krdks n J d��t | |�}d| kr<|ksJn J d| ��t| �t| |� | S )z>year, month, day -> ordinal, considering 01-Jan-0001 as day 1.r r r' �day must be in 1..%d)r& r r) �r r% �day�dimr r r �_ymd2ordC s
"��r. i� �e � i� r � c C s8 | d8 } t | t�\}} |d d }t | t�\}} t | t�\}} t | d�\}} ||d |d | 7 }|dkst|dkr�| dks�J �|d ddfS |d ko�|d
kp�|d k}|t|�ks�J �| d d ? }t| |d
ko�| }|| kr�|d8 }|t| |d
ko�| 8 }| |8 } d| k�r$t||�k �s*n J �||| d fS )z@ordinal -> (year, month, day), considering 01-Jan-0001 as day 1.r r r r r r r r � � �2 r0 r! )�divmod�_DI400Y�_DI100Y�_DI4Yr r( r# r& ) �nZn400r Zn100Zn4Zn1Zleapyearr% Z precedingr r r �_ord2ymd\ s( $r: )
N�Jan�Feb�Mar�Apr�May�Jun�Jul�Aug�Sep�Oct�Nov�Dec)N�Mon�Tue�Wed�Thu�Fri�Sat�Sunc C s> t | ||�d d }t| |�| }t�| ||||||||f �S )N� � )r. r) �_time� struct_time) r �m�d�hh�mm�ssZdstflagZwdayZdnumr r r �_build_struct_time� s rW c C s" d| ||f }|r |d| 7 }|S )Nz%02d:%02d:%02d�.%06dr )rT rU rV �us�resultr r r � _format_time� s r[ c C s� d }d }d }g }|j }dt|� }} || k �r�|| }
|d7 }|
dk�r�|| k �r�|| }
|d7 }|
dkr�|d u r�dt| dd� }|� |� �q�|
dk�r@|d u �r&d}t| d ��r&| �� } | d u�r&d
} | jdk r�| } d } t| tdd ��\}
}|tdd
� �r
J d��|tdd
� }d| |
|f }d|v�s4J �|� |� n^|
dk�r�|d u �r�d}t| d��r�| �� }|d u�r�|� dd�}|� |� n|d� ||
� n|d� q$||
� q$d�
|�}t � ||�S )Nr r �%�fz%06d� microsecond�z� � utcoffset�+�-��hours��minutes� whole minutez
%c%02d%02d�Z�tznamez%%)
�append�len�getattr�hasattrra �daysr5 � timedeltarj �replace�joinrP �strftime)r �format� timetupleZfreplaceZzreplaceZZreplaceZ newformat�push�ir9 �ch�offset�sign�hrR �sr r r �_wrap_strftime� sb
�
r} c C s | d u r d S t | |�|�S �N)rm )�tzinfoZmethnameZ tzinfoargr r r �_call_tzinfo_method� s r� c C s& | d ur"t | t�s"tdt| � ��d S )Nz4tzinfo.tzname() must return None or string, not '%s')�
isinstancer � TypeError�type)�namer r r �
_check_tzname� s �r� c C s� | dv s J �|d u rd S t |t�s6td| t|�f ��|tdd� sJ|jrZtd| |f ��td� | k rxtd�k s�n td| |f ��d S )N)ra �dstz3tzinfo.%s() must return None or timedelta, not '%s'r rf z9tzinfo.%s() must return a whole number of minutes, got %szV%s()=%s, must be must be strictly between -timedelta(hours=24) and timedelta(hours=24))r� rp r� r� � microseconds�
ValueError)r� ry r r r �_check_utc_offset� s
�� �r� c C s� t | t�std��t| kr&tks:n tdttf | ��d| krNdksZn td|��t| |�}d| krx|ks�n td| |��d S )N� int expectedzyear must be in %d..%dr r r' r* )r� r
r� �MINYEAR�MAXYEARr� r& r+ r r r �_check_date_fields s
r� c C s� t | t�std��d| kr&dks2n td| ��d| krFdksRn td|��d| krfdksrn td|��d| kr�dks�n td |��d S )
Nr� r � zhour must be in 0..23�; zminute must be in 0..59zsecond must be in 0..59�?B z microsecond must be in 0..999999)r� r
r� r� )�hour�minute�secondr^ r r r �_check_time_fields s
r� c C s | d urt | t�std��d S )Nz4tzinfo argument must be None or of a tzinfo subclass)r� r r� )�tzr r r �_check_tzinfo_arg s r� c C s t dt| �jt|�jf ��d S )Nzcan't compare '%s' to '%s')r� r� �__name__r r r r � _cmperror! s �r� c @ s e Zd ZdZdZdAdd�Zdd� Zdd � Zd
d � Ze d d
� �Z
e dd� �Z e dd� �Z dd� Z
e
Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � ZeZd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Z d.d/� Z d0d1� Z d2d3� Z d4d5� Z d6d7� Z!d8d9� Z"d:d;� Z#d<d=� Z$d>d?� Z%d@S )Brp a� Represent the difference between two datetime objects.
Supported operators:
- add, subtract timedelta
- unary plus, minus, abs
- compare to timedelta
- multiply, divide by int
In addition, datetime supports subtraction of two datetime objects
returning a timedelta, and addition or subtraction of a datetime
and a timedelta giving a datetime.
Representation: (days, seconds, microseconds). Why? Because I
felt like it.
��_days�_seconds�
_microsecondsr c C s d } } }
||d 7 }||d |d 7 }||d 7 }t |t�r�t�|�\} }t�| d �\} }
|
t|
�ksrJ �t|
�} |t|�ks�J �t|�}nd} |}t | t�s�J �t| �dks�J �t |t�s�J �t| �d ks�J �t |t��r(t�|�\}}|t|�k�sJ �t|�}|| 7 }t|�d
k�s,J �n| }t |t��s<J �t|�d
k�sNJ �t |t��s^J �t|d �\}}||7 }| t|�7 } t | t��s�J �t| �d k�s�J �|d }t|�d
k �s�J �t |t��rz||7 }t|d�}t|d �\}}|t|�k�s�J �|t|�k�s J �t|d�\}}|t|�k�s,J �|t|�k�s>J �|t|�7 }| t|�7 } t | t��sfJ �t| �dk�s�J �nlt|d�\}}t|d �\}}||7 }| t|�7 } t | t��s�J �t| �dk�s�J �t|�}||7 }t|d�}t| �dk�s�J �t|�dk �s
J �t |t��sJ �t|�|k�s,J �t|�}
t|
d�\}}
| |7 } t | t��sZJ �t| d �\}} ||7 }t |t��s�J �t | t��r�d| k�r�d k �s�n J �t |
t��r�d|
k�r�dk �s�n J �t� | �}||_
| |_ |
|_ t|�dk�r
t
d| ��|S )Nr rO �< � i� g �@g � �?�Q g @i � � ��.Ag �@Ai�� �@B g ��GA�ɚ;z$timedelta # of days is too large: %d)r� �float�_math�modfr
�absr5 r r �__new__r� r� r� �
OverflowError)�clsro �secondsr� Z millisecondsrg re �weeksrS r| rY ZdayfracZdaysecondsfracZdaysecondswholeZ secondsfracZusdouble�selfr r r r� 8 s�
**
ztimedelta.__new__c C sZ | j r$dd| jj | j| j| j f S | jrDdd| jj | j| jf S dd| jj | jf S )N�%s(%d, %d, %d)� datetime.z
%s(%d, %d)z%s(%d))r� � __class__r� r� r� �r� r r r �__repr__� s � �ztimedelta.__repr__c C sd t | jd�\}}t |d�\}}d|||f }| jrLdd� }d|| j� | }| jr`|d| j }|S )Nr� z %d:%02d:%02dc S s | t | �dkrdpdfS )Nr r| r` )r� )r9 r r r �plural� s z!timedelta.__str__.<locals>.pluralz
%d day%s, rX )r5 r� r� r� )r� rU rV rT r| r� r r r �__str__� s ztimedelta.__str__c C s | j d | j d | j d S )z Total seconds in the duration.r� r� )ro r� r� r� r r r �
total_seconds� s
��ztimedelta.total_secondsc C s | j S �ro �r� r� r r r ro � s ztimedelta.daysc C s | j S �r� )r� r� r r r r� � s ztimedelta.secondsc C s | j S �r� )r� r� r r r r� � s ztimedelta.microsecondsc C s2 t |t�r.t| j|j | j|j | j|j �S tS r~ �r� rp r� r� r� �NotImplemented�r� �otherr r r �__add__� s
�ztimedelta.__add__c C s2 t |t�r.t| j|j | j|j | j|j �S tS r~ r� r� r r r �__sub__� s
�ztimedelta.__sub__c C s t |t�r| | S tS r~ )r� rp r� r� r r r �__rsub__� s
ztimedelta.__rsub__c C s t | j | j | j �S r~ )rp r� r� r� r� r r r �__neg__� s �ztimedelta.__neg__c C s | S r~ r r� r r r �__pos__� s ztimedelta.__pos__c C s | j dk r| S | S d S �Nr r� r� r r r �__abs__� s
ztimedelta.__abs__c C sN t |t�r(t| j| | j| | j| �S t |t�rJ|�� \}}| | | S tS r~ ) r� r
rp r� r� r� r� �as_integer_ratior� )r� r� �a�br r r �__mul__� s
�
ztimedelta.__mul__c C s | j d | j d | j S )Nr� r� r� r� r r r �_to_microseconds
s �ztimedelta._to_microsecondsc C sN t |ttf�stS | �� }t |t�r0||�� S t |t�rJtdd|| �S d S r� )r� r
rp r� r� )r� r� �usecr r r � __floordiv__ s
ztimedelta.__floordiv__c C sz t |tttf�stS | �� }t |t�r2||�� S t |t�rLtdd|| �S t |t�rv|�� \}}tdd|| | �S d S r� )r� r
r� rp r� r� r� )r� r� r� r� r� r r r � __truediv__ s
ztimedelta.__truediv__c C s* t |t�r&| �� |�� }tdd|�S tS r� )r� rp r� r� )r� r� �rr r r �__mod__& s
ztimedelta.__mod__c C s4 t |t�r0t| �� |�� �\}}|tdd|�fS tS r� )r� rp r5 r� r� )r� r� �qr� r r r �
__divmod__, s
�ztimedelta.__divmod__c C s t |t�r| �|�dkS dS d S )Nr F�r� rp r r� r r r �__eq__5 s
ztimedelta.__eq__c C s t |t�r| �|�dkS dS d S )Nr Tr� r� r r r �__ne__; s
ztimedelta.__ne__c C s& t |t�r| �|�dkS t| |� d S r� �r� rp r r� r� r r r �__le__A s
ztimedelta.__le__c C s& t |t�r| �|�dk S t| |� d S r� r� r� r r r �__lt__G s
ztimedelta.__lt__c C s& t |t�r| �|�dkS t| |� d S r� r� r� r r r �__ge__M s
ztimedelta.__ge__c C s& t |t�r| �|�dkS t| |� d S r� r� r� r r r �__gt__S s
ztimedelta.__gt__c C s t |t�sJ �t| �� |�� �S r~ )r� rp r � _getstater� r r r r Y s ztimedelta._cmpc C s t | �� �S r~ ��hashr� r� r r r �__hash__] s ztimedelta.__hash__c C s | j dkp | jdkp | jdkS r� r� r� r r r �__bool__` s
��ztimedelta.__bool__c C s | j | j| jfS r~ r� r� r r r r� g s ztimedelta._getstatec C s | j | �� fS r~ �r� r� r� r r r �
__reduce__j s ztimedelta.__reduce__N)r r r r r r r )&r� �
__module__� __qualname__�__doc__� __slots__r� r� r� r� �propertyro r� r� r� �__radd__r� r� r� r� r� r� �__rmul__r� r� r� r� r� r� r� r� r� r� r� r r� r� r� r� r r r r rp % sN �
q
rp i6e�r� r� r� r� )ro re rg r� r� r� c @ s0 e Zd ZdZdZdBdd�Zedd� �Zedd � �Zed
d � �Z d d
� Z
dd� Z dd� Z dd� Z
dd� ZeZedd� �Zedd� �Zedd� �Zd d � Zd d � ZdCd d!�Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Z d.d/� Z d0d1� Z d2d3� Z e Z d4d5� Z!d6d7� Z"d8d9� Z#d:d;� Z$d<d=� Z%d>d?� Z&d@dA� Z'dS )D�datea� Concrete date type.
Constructors:
__new__()
fromtimestamp()
today()
fromordinal()
Operators:
__repr__, __str__
__cmp__, __hash__
__add__, __radd__, __sub__ (add/radd only with timedelta arg)
Methods:
timetuple()
toordinal()
weekday()
isoweekday(), isocalendar(), isoformat()
ctime()
strftime()
Properties (readonly):
year, month, day
��_year�_month�_dayNc C s~ t |t�rRt|�dkrRd|d kr.dkrRn n |du rRt�| �}|�|� |S t|||� t�| �}||_||_||_ |S )zVConstructor.
Arguments:
year, month, day (required, base 1)
r r r! r N)
r� r rl r r� �_date__setstater� r� r� r� )r� r r% r, r� r r r r� � s ��
�
z date.__new__c C s( t �|�\ }}}}}}}} }
| |||�S )z;Construct a date from a POSIX timestamp (like time.time()).)rP � localtime) r� �tr rR rS rT rU rV �weekday�jdayr� r r r �
fromtimestamp� s zdate.fromtimestampc C s t �� }| �|�S )z"Construct a date from time.time().�rP �timer� �r� r� r r r �today� s z
date.todayc C s t |�\}}}| |||�S )z�Construct a date from a proleptic Gregorian ordinal.
January 1 of year 1 is day 1. Only the year, month and day are
non-zero in the result.
)r: )r� r9 r rR rS r r r � fromordinal� s zdate.fromordinalc C s dd| j j | j| j| jf S )a5 Convert to formal string, for repr().
>>> dt = datetime(2010, 1, 1)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0)'
>>> dt = datetime(2010, 1, 1, tzinfo=timezone.utc)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)'
r� r� )r� r� r� r� r� r� r r r r� � s
�z
date.__repr__c C s. | � � d pd}dt| t| j | j| jf S )� Return ctime() style string.rO z%s %s %2d 00:00:00 %04d)� toordinal� _DAYNAMES� _MONTHNAMESr� r� r� �r� r� r r r �ctime� s �z
date.ctimec C s t | || �� �S )zFormat using strftime().)r} ru �r� �fmtr r r rs � s z
date.strftimec C s t |�dkr| �|�S t| �S r� �rl rs r r� r r r �
__format__� s
zdate.__format__c C s d| j | j| jf S )z�Return the date formatted according to ISO.
This is 'YYYY-MM-DD'.
References:
- http://www.w3.org/TR/NOTE-datetime
- http://www.cl.cam.ac.uk/~mgk25/iso-time.html
z%04d-%02d-%02dr� r� r r r � isoformat� s zdate.isoformatc C s | j S )z
year (1-9999))r� r� r r r r � s z date.yearc C s | j S )z month (1-12))r� r� r r r r% � s z
date.monthc C s | j S )z
day (1-31))r� r� r r r r, � s zdate.dayc C s t | j| j| jdddd�S )�9Return local time tuple compatible with time.localtime().r r )rW r� r� r� r� r r r ru s �zdate.timetuplec C s t | j| j| j�S )z�Return proleptic Gregorian ordinal for the year, month and day.
January 1 of year 1 is day 1. Only the year, month and day values
contribute to the result.
)r. r� r� r� r� r r r r� s zdate.toordinalc C sB |du r| j }|du r | j}|du r*| j}t|||� t|||�S )z;Return a new date with new values for the specified fields.N)r� r� r� r� r� )r� r r% r, r r r rq s z date.replacec C s t |t�r| �|�dkS tS r� �r� r� r r� r� r r r r� s
z date.__eq__c C s t |t�r| �|�dkS tS r� r r� r r r r� " s
z date.__ne__c C s t |t�r| �|�dkS tS r� r r� r r r r� ' s
z date.__le__c C s t |t�r| �|�dk S tS r� r r� r r r r� , s
z date.__lt__c C s t |t�r| �|�dkS tS r� r r� r r r r� 1 s
z date.__ge__c C s t |t�r| �|�dkS tS r� r r� r r r r� 6 s
z date.__gt__c C sP t |t�sJ �| j| j| j }}}|j|j|j }}}t|||f|||f�S r~ )r� r� r� r� r� r )r� r� r rR rS �y2�m2Zd2r r r r ; s z date._cmpc C s t | �� �S )�Hash.r� r� r r r r� A s z
date.__hash__c C sF t |t�rB| �� |j }d| k r,tkr:n n
t�|�S td��tS )zAdd a date to a timedelta.r �result out of range) r� rp r� ro � _MAXORDINALr� r� r� r� )r� r� �or r r r� G s
z date.__add__c C sD t |t�r| t|j � S t |t�r@| �� }|�� }t|| �S tS )z.Subtract two dates, or a date and a timedelta.)r� rp ro r� r� r� )r� r� �days1�days2r r r r� R s
z date.__sub__c C s | � � d d S )z:Return day of the week, where Monday == 0 ... Sunday == 6.rN rO �r� r� r r r r� \ s z date.weekdayc C s | � � d pdS )z:Return day of the week, where Monday == 1 ... Sunday == 7.rO r r� r r r �
isoweekdayb s zdate.isoweekdayc C s� | j }t|�}t| j | j| j�}t|| d�\}}|dk r^|d8 }t|�}t|| d�\}}n$|dkr�|t|d �kr�|d7 }d}||d |d fS )a� Return a 3-tuple containing ISO year, week number, and weekday.
The first ISO week of the year is the (Mon-Sun) week
containing the year's first Thursday; everything else derives
from that.
The first week is 1; Monday is 1 ... Sunday is 7.
ISO calendar algorithm taken from
http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
rO r r �4 )r� �_isoweek1mondayr. r� r� r5 )r� r � week1mondayr� �weekr, r r r � isocalendarg s zdate.isocalendarc C s& t | jd�\}}t||| j| jg�fS �N� )r5 r� r r� r� )r� �yhi�ylor r r r� � s zdate._getstatec C sP t |�dks&d|d kr$dks.n td��|\}}| _| _|d | | _d S )Nr r r! r znot enough argumentsr )rl r� r� r� r� )r� �stringr r r r r �
__setstate� s &zdate.__setstatec C s | j | �� fS r~ r� r� r r r r� � s zdate.__reduce__)NN)NNN)(r� r� r� r� r� r� � classmethodr� r� r� r� r� rs r r r� r� r r% r, ru r� rq r� r� r� r� r� r� r r� r� r� r� r� r
r r� r� r� r r r r r� r sR
r� r r r� c @ s< e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
S )r z}Abstract base class for time zone info classes.
Subclasses must override the name(), utcoffset() and dst() methods.
r c C s t d��dS )z%datetime -> string name of time zone.z&tzinfo subclass must override tzname()N��NotImplementedError�r� �dtr r r rj � s z
tzinfo.tznamec C s t d��dS )z:datetime -> minutes east of UTC (negative for west of UTC)z)tzinfo subclass must override utcoffset()Nr r r r r ra � s ztzinfo.utcoffsetc C s t d��dS )z�datetime -> DST offset in minutes east of UTC.
Return 0 if DST not in effect. utcoffset() must include the DST
offset.
z#tzinfo subclass must override dst()Nr r r r r r� � s z
tzinfo.dstc C s� t |t�std��|j| ur$td��|�� }|du r<td��|�� }|du rTtd��|| }|r�||7 }|�� }|du r�td��|| S )z*datetime in UTC -> datetime in local time.z&fromutc() requires a datetime argumentzdt.tzinfo is not selfNz0fromutc() requires a non-None utcoffset() resultz*fromutc() requires a non-None dst() resultz;fromutc(): dt.dst gave inconsistent results; cannot convert)r� �datetimer� r r� ra r� )r� r ZdtoffZdtdst�deltar r r �fromutc� s"
ztzinfo.fromutcc C sf t | dd �}|r|� }nd}t | dd �}|r4|� }nt | dd �pBd }|d u rV| j|fS | j||fS d S )N�__getinitargs__r � __getstate__�__dict__)rm r� )r� Z getinitargs�args�getstate�stater r r r� � s
ztzinfo.__reduce__N)
r� r� r� r� r� rj ra r� r r� r r r r r � s r c @ s e Zd ZdZd=dd�Zedd� �Zedd � �Zed
d � �Zed d
� �Z edd� �Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd>d d �Zd d � Zd?d"d#�Zd$d%� Zd&d'� ZeZd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd@d3d4�Z d5d6� Z d7d8� Z d9d:� Z d;d<� Z dS )Ar� a Time with time zone.
Constructors:
__new__()
Operators:
__repr__, __str__
__cmp__, __hash__
Methods:
strftime()
isoformat()
utcoffset()
tzname()
dst()
Properties (readonly):
hour, minute, second, microsecond, tzinfo
r Nc C sl t �| �}t|t�r4t|�dkr4|�||p,d� |S t|� t||||� ||_||_ ||_
||_ ||_ |S )z�Constructor.
Arguments:
hour, minute (required)
second, microsecond (default to zero)
tzinfo (default to None)
rN N)
r r� r� r rl �_time__setstater� r� �_hour�_minute�_second� _microsecond�_tzinfo)r� r� r� r� r^ r r� r r r r� � s
z time.__new__c C s | j S �z hour (0-23)�r( r� r r r r� s z time.hourc C s | j S �z
minute (0-59)�r) r� r r r r� s z time.minutec C s | j S �z
second (0-59)�r* r� r r r r� s z time.secondc C s | j S �zmicrosecond (0-999999)�r+ r� r r r r^ s ztime.microsecondc C s | j S �ztimezone info object�r, r� r r r r s z time.tzinfoc C s$ t |t�r | j|dd�dkS dS d S �NT�� allow_mixedr F�r� r� r r� r r r r� ) s
z time.__eq__c C s$ t |t�r | j|dd�dkS dS d S �NTr8 r r: r� r r r r� / s
z time.__ne__c C s& t |t�r| �|�dkS t| |� d S r� �r� r� r r� r� r r r r� 5 s
z time.__le__c C s& t |t�r| �|�dk S t| |� d S r� r< r� r r r r� ; s
z time.__lt__c C s& t |t�r| �|�dkS t| |� d S r� r< r� r r r r� A s
z time.__ge__c C s& t |t�r| �|�dkS t| |� d S r� r< r� r r r r� G s
z time.__gt__Fc
C s� t |t�sJ �| j}|j}d }}||u r0d}n| �� }|�� }||k}|rvt| j| j| j| jf|j|j|j|jf�S |d u s�|d u r�|r�dS t d��| jd | j |t
dd� }|jd |j |t
dd� } t|| j| jf| |j|jf�S )NTr! z$cannot compare naive and aware timesr� r rf ) r� r� r, ra r r( r) r* r+ r� rp )
r� r� r9 �mytz�ottz�myoff�otoff� base_compareZmyhhmmZothhmmr r r r M s4 � �� �z time._cmpc C s� | � � }|s t| �� d �S tt| j| jd�| tdd��\}}|tdd� rVJ d��|tdd� }d| krxdk r�n ntt||| j| j ��S t||| j| j f�S )r r �re rg r rd rf rh r3 )
ra r� r� r5 rp r� r� r� r� r^ )r� �tzoffr{ rR r r r r� i s �z
time.__hash__�:c C s� | � � }|dur�|jdk r&d}| }nd}t|tdd��\}}|tdd� rTJ d��|tdd� }d| krvd k s|n J �d
||||f }|S ) z2Return formatted timezone offset (+xx:xx) or None.Nr rc rb r rd rf rh r3 z %s%02d%s%02d)ra ro r5 rp )r� �sep�offrz rT rU r r r �_tzstrx s
z time._tzstrc C s� | j dkr d| j| j f }n| jdkr2d| j }nd}dd| jj | j| j|f }| jdur�|dd� d kspJ �|dd� d
| j d }|S ) �%Convert to formal string, for repr().r z, %d, %dz, %dr` z %s(%d, %d%s)r� Nr �)� , tzinfo=%r)r+ r* r� r� r( r) r, )r� r| r r r r� � s
�
z
time.__repr__c C s. t | j| j| j| j�}| �� }|r*||7 }|S )z�Return the time formatted according to ISO.
This is 'HH:MM:SS.mmmmmm+zz:zz', or 'HH:MM:SS+zz:zz' if
self.microsecond == 0.
)r[ r( r) r* r+ rG )r� r| r� r r r r � s �ztime.isoformatc C s( ddd| j | j| jdddf }t| ||�S )z{Format using strftime(). The date part of the timestamp passed
to underlying strftime should not be used.
il r r r )r( r) r* r} )r� r� ru r r r rs � s
�z
time.strftimec C s t |�dkr| �|�S t| �S r� r� r� r r r r � s
ztime.__format__c C s( | j du rdS | j �d�}td|� |S �zQReturn the timezone offset in minutes east of UTC (negative west of
UTC).Nra �r, ra r� �r� ry r r r ra � s
ztime.utcoffsetc C s& | j du rdS | j �d�}t|� |S )� Return the timezone name.
Note that the name is 100% informational -- there's no requirement that
it mean anything in particular. For example, "GMT", "UTC", "-500",
"-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
N)r, rj r� �r� r� r r r rj � s
z time.tznamec C s( | j du rdS | j �d�}td|� |S �af Return 0 if DST is not in effect, or the DST offset (in minutes
eastward) if DST is in effect.
This is purely informational; the DST offset has already been added to
the UTC offset returned by utcoffset() if applicable, so there's no
need to consult dst() unless you're interested in displaying the DST
info.
Nr� �r, r� r� rM r r r r� � s
ztime.dstTc C sl |du r| j }|du r | j}|du r*| j}|du r8| j}|du rF| j}t||||� t|� t|||||�S )z;Return a new time with new values for the specified fields.NT)r� r� r� r^ r r� r� r� )r� r� r� r� r^ r r r r rq � s z time.replacec C s4 | j s | jrdS | �� p td�}t| j| jd�|kS )NTr rB )r� r^ ra rp r� r� rM r r r r� � s z
time.__bool__c C sV t | jd�\}}t |d�\}}t| j| j| j|||g�}| jd u rH|fS || jfS d S r )r5 r+ r r( r) r* r, )r� �us2�us3�us1� basestater r r r� � s �
ztime._getstatec C sv t |�dks|d dkr td��|\| _| _| _}}}|d> |B d> |B | _|d u s^t|t�rf|| _n td| ��d S )NrN r r3 zan integer is required� �bad tzinfo state arg %r) rl r� r( r) r* r+ r� �
_tzinfo_classr, )r� r r rT rR rS r r r r s �ztime.__setstatec C s t | �� fS r~ )r� r� r� r r r r� s ztime.__reduce__)r r r r N)F)rD )NNNNT)!r� r� r� r� r� r� r� r� r� r^ r r� r� r� r� r� r� r r� rG r� r r� rs r ra rj r� rq r� r� r' r� r r r r r� � sH
�
r� c @ s� e Zd ZdZejd ZdXdd�Zedd� �Zed d
� �Z ed d � �Z
ed
d� �Z edd� �Z e
dYdd��Ze
dd� �Ze
dZdd��Ze
dd� �Ze
dd� �Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd[d(d)�Zd\d*d+�Zd,d-� Zd]d/d0�Zd1d2� Z d3d4� Z e
d5d6� �Z d7d8� Z d9d:� Z d;d<� Z!d=d>� Z"d?d@� Z#dAdB� Z$dCdD� Z%dEdF� Z&dGdH� Z'd^dJdK�Z(dLdM� Z)e)Z*dNdO� Z+dPdQ� Z,dRdS� Z-dTdU� Z.dVdW� Z/dS )_r z�datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])
The year, month and day arguments are required. tzinfo may be None, or an
instance of a tzinfo subclass. The remaining arguments may be ints.
)r( r) r* r+ r, Nr c
C s� t |t�r:t|�dkr:t�| |d d� �} | �||� | S t|� t||||� t�| |||�} || _|| _ || _
|| _ || _ | S )N�
r )
r� r rl r� r� �_datetime__setstater� r� r( r) r* r+ r, )
r� r r% r, r� r� r� r^ r r� r r r r� s zdatetime.__new__c C s | j S r- r. r� r r r r� 0 s z
datetime.hourc C s | j S r/ r0 r� r r r r� 5 s zdatetime.minutec C s | j S r1 r2 r� r r r r� : s zdatetime.secondc C s | j S r3 r4 r� r r r r^ ? s zdatetime.microsecondc C s | j S r5 r6 r� r r r r D s zdatetime.tzinfoc C s� t |� |du rtjntj}t|d�\}}t|d �}|dkrJ|d7 }d}||�\ }}}} }
} } }
}t| d�} | |||| |
| ||�}|dur�|�|�}|S )z�Construct a datetime from a POSIX timestamp (like time.time()).
A timezone info object may be passed in as well.
Nr� r� r� r r r� )r� rP r� �gmtimer5 r
�minr )r� r� r� � converter�fracrY r rR rS rT rU rV r� r� r� rZ r r r r� I s
zdatetime.fromtimestampc
C sh t |d�\}}t|d �}|dkr.|d7 }d}t�|�\ }}}}}} }
} } t| d�} | |||||| |�S )zCConstruct a UTC datetime from a POSIX timestamp (like time.time()).r� r� r� r r r� )r5 r
rP r[ r\ )
r� r� r^ rY r rR rS rT rU rV r� r� r� r r r �utcfromtimestampe s
zdatetime.utcfromtimestampc C s t �� }| �||�S )zBConstruct a datetime from time.time() and optional time zone info.r� )r� r� r� r r r �now{ s z datetime.nowc C s t �� }| �|�S )z*Construct a UTC datetime from time.time().)rP r� r_ r� r r r �utcnow� s zdatetime.utcnowc C sJ t |t�std��t |t�s$td��| |j|j|j|j|j|j |j
|j �S )z8Construct a datetime from a given date and a given time.z%date argument must be a date instancez%time argument must be a time instance) r� � _date_classr� � _time_classr r% r, r� r� r� r^ r )r� r� r� r r r �combine� s
�zdatetime.combinec C sD | � � }|du rd}n|r d}nd}t| j| j| j| j| j| j|�S )r Nr r r )r� rW r r% r, r� r� r� )r� r� r r r ru � s �zdatetime.timetuplec C sL | j du r<t�| j| j| j| j| j| jdddf �| j d S | t
� � S dS )z Return POSIX timestamp as floatNr r� ) r, rP �mktimer r% r, r� r� r� r^ �_EPOCHr� r� r r r � timestamp� s
��zdatetime.timestampc C sT | � � }|r| |8 } | j| j| j }}}| j| j| j }}}t||||||d�S )z4Return UTC time tuple compatible with time.gmtime().r )ra r r% r, r� r� r� rW )r� ry r rR rS rT rU rV r r r � utctimetuple� s zdatetime.utctimetuplec C s t | j| j| j�S )zReturn the date part.)r� r� r� r� r� r r r r� � s z
datetime.datec C s t | j| j| j| j�S )z'Return the time part, with tzinfo None.)r� r� r� r� r^ r� r r r r� � s z
datetime.timec C s t | j| j| j| j| j�S )z'Return the time part, with same tzinfo.)r� r� r� r� r^ r, r� r r r �timetz� s �zdatetime.timetzTc C s� |du r| j }|du r | j}|du r*| j}|du r8| j}|du rF| j}|du rT| j}|du rb| j}|du rp| j}t|||� t ||||� t
|� t ||||||||�S )z?Return a new datetime with new values for the specified fields.NT) r r% r, r� r� r� r^ r r� r� r� r ) r� r r% r, r� r� r� r^ r r r r rq � s, �zdatetime.replacec C sL |d u r�| j d u rtd��| t tdd� }t�|�}t|d d� � }z|j}|j}W nv t y� |tt�
|�d d� � }tj o�|j dk}|r�tj
ntj }|t|d�kr�t|tj| �}nt|�}Y q�0 tt|d�|�}nt|t �s�td��| j } | d u �r
td��|| u �r| S | �� }
|
d u �r2td��| |
j|d�} |�| �S )Nz'astimezone() requires an aware datetimer r� rN r z)tz argument must be an instance of tzinfo�r )r r� rf rp rP r� r � tm_gmtoff�tm_zone�AttributeErrorr[ �daylight�tm_isdst�altzone�timezonerj r� r� ra rq r ) r� r� �ts�localtm�local�gmtoff�zoner r� r= Zmyoffset�utcr r r �
astimezone� s:
zdatetime.astimezonec C s: | � � d pd}dt| t| j | j| j| j| j| jf S )r� rO z %s %s %2d %02d:%02d:%02d %04d) r� r� r� r� r� r( r) r* r� r� r r r r� s �zdatetime.ctime�Tc C s� d| j | j| j|f t| j| j| j| j� }| �� }|dur�|j dk rRd}| }nd}t
|t dd��\}}|t dd� r�J d ��|t dd� }|d
|||f 7 }|S ) a� Return the time formatted according to ISO.
This is 'YYYY-MM-DD HH:MM:SS.mmmmmm', or 'YYYY-MM-DD HH:MM:SS' if
self.microsecond == 0.
If self.tzinfo is not None, the UTC offset is also attached, giving
'YYYY-MM-DD HH:MM:SS.mmmmmm+HH:MM' or 'YYYY-MM-DD HH:MM:SS+HH:MM'.
Optional argument sep specifies the separator between date and
time, default 'T'.
z%04d-%02d-%02d%cNr rc rb r rd rf rh z %s%02d:%02d) r� r� r� r[ r( r) r* r+ ra ro r5 rp )r� rE r| rF rz rT rU r r r r s$ ���
zdatetime.isoformatc C s� | j | j| j| j| j| j| jg}|d dkr2|d= |d dkrD|d= d�tt |��}dd| j
j |f }| j dur�|dd� dks�J �|dd� d| j d }|S ) rH r r z, z%s(%s)r� NrI rJ )
r� r� r� r( r) r* r+ rr r r r� r� r, )r� �Lr| r r r r� , s �
zdatetime.__repr__c C s | j dd�S )z Convert to string, for str().� )rE )r r� r r r r� ; s zdatetime.__str__c C s ddl }|�| ||�S )zKstring, format -> new datetime parsed from a string (like time.strptime()).r N)� _strptimeZ_strptime_datetime)r� Z date_stringrt r| r r r �strptime? s zdatetime.strptimec C s( | j du rdS | j �| �}td|� |S rK rL rM r r r ra E s
zdatetime.utcoffsetc C s t | jd| �}t|� |S )rN rj )r� r, r� rO r r r rj N s zdatetime.tznamec C s( | j du rdS | j �| �}td|� |S rP rQ rM r r r r� Y s
z datetime.dstc C s2 t |t�r | j|dd�dkS t |t�s*tS dS d S r7 �r� r r r� r� r� r r r r� j s
zdatetime.__eq__c C s2 t |t�r | j|dd�dkS t |t�s*tS dS d S r; r~ r� r r r r� r s
zdatetime.__ne__c C s4 t |t�r| �|�dkS t |t�s&tS t| |� d S r� �r� r r r� r� r� r� r r r r� z s
zdatetime.__le__c C s4 t |t�r| �|�dk S t |t�s&tS t| |� d S r� r r� r r r r� � s
zdatetime.__lt__c C s4 t |t�r| �|�dkS t |t�s&tS t| |� d S r� r r� r r r r� � s
zdatetime.__ge__c C s4 t |t�r| �|�dkS t |t�s&tS t| |� d S r� r r� r r r r� � s
zdatetime.__gt__Fc C s� t |t�sJ �| j}|j}d }}||u r0d}n| �� }|�� }||k}|r�t| j| j| j| j| j | j
| j f|j|j|j|j|j |j
|j f�S |d u s�|d u r�|r�dS t d��| | }|j
dk r�dS |r�dp�dS )NTr! z(cannot compare naive and aware datetimesr r r )r� r r, ra r r� r� r� r( r) r* r+ r� ro ) r� r� r9 r= r> r? r@ rA �diffr r r r � s6 � ��
z
datetime._cmpc
C s� t |t�stS t| �� | j| j| j| jd�}||7 }t|j d�\}}t|d�\}}d|j
k rht kr�n n&t �
t�|j
�t||||j| jd��S td��dS )z Add a datetime and a timedelta.)re rg r� r� r� r� r rj r N)r� rp r� r� r( r) r* r+ r5 r� ro r r rd r� r� r� r� r, r� )r� r� r r� �remr� r� r r r r� � s&
���zdatetime.__add__c C s� t |t�s"t |t�r | | S tS | �� }|�� }| j| jd | jd }|j|jd |jd }t|| || | j|j �}| j |j u r�|S | �
� }|�
� }||kr�|S |du s�|du r�t d��|| | S )z6Subtract two datetimes, or a datetime and a timedelta.r� r� Nz(cannot mix naive and timezone-aware time) r� r rp r� r� r* r) r( r+ r, ra r� ) r� r� r
r Zsecs1Zsecs2�baser? r@ r r r r� � s*
� zdatetime.__sub__c C sb | � � }|d u r t| �� d �S t| j| j| j�}| jd | jd | j }tt
||| j �| �S )Nr r� r� ) ra r� r� r. r r% r, r� r� r� rp r^ )r� rC ro r� r r r r� � s zdatetime.__hash__c C sr t | jd�\}}t | jd�\}}t |d�\}}t||| j| j| j| j| j|||g
�}| j d u rd|fS || j fS d S r )
r5 r� r+ r r� r� r( r) r* r, )r� r r rR rS rT rU r r r r� � s �
zdatetime._getstatec
C sp |\
}}| _ | _| _| _| _}}}|d | | _|d> |B d> |B | _|d u sXt|t�r`|| _ n t
d| ��d S )Nr rV rW ) r� r� r( r) r* r� r+ r� rX r, r� )r� r r r r rT rR rS r r r r � s �zdatetime.__setstatec C s | j | �� fS r~ r� r� r r r r� s zdatetime.__reduce__)NNr r r r N)N)N)NNNNNNNT)N)ry )F)0r� r� r� r� r� r� r� r� r� r� r� r^ r r r� r_ r` ra rd ru rg rh r� ri rq rx r� r r� r� r} ra rj r� r� r� r� r� r� r� r r� r� r� r� r� rZ r� r r r r r st
�
�
.
r c C s8 d}t | dd�}|d d }|| }||kr4|d7 }|S )Nr2 r rN rO )r. )r �THURSDAYZfirstday� firstweekdayr r r r r s r c @ s� e Zd ZdZe� Zefdd�Zed dd��Zdd� Z d d
� Z
d d � Z d
d� Z dd� Z
dd� Zdd� Zdd� Zdd� Zeddd�Ze Zed d � �ZdS ) rq )�_offset�_namec C s� t |t�std��|| ju r,|s&| jS d }n*t |t�sVtrNt |t�rN|�� }ntd��| j | krn| j
ksxn t d��|j dks�|j
d dkr�t d��| �||�S )Nzoffset must be a timedeltazname must be a stringzYoffset must be a timedelta strictly between -timedelta(hours=24) and timedelta(hours=24).r r� zAoffset must be a timedelta representing a whole number of minutes)r� rp r� �_Omittedrw r r
r �decode�
_minoffset�
_maxoffsetr� r� r� �_create)r� ry r� r r r r� s"
�ztimezone.__new__Nc C s t �| �}||_||_|S r~ )r r� r� r� )r� ry r� r� r r r r� 8 s
ztimezone._createc C s | j du r| jfS | j| j fS )zpickle supportN)r� r� r� r r r r! ? s
ztimezone.__getinitargs__c C s t |�tkrdS | j|jkS )NF)r� rq r� r� r r r r� E s ztimezone.__eq__c C s
t | j�S r~ )r� r� r� r r r r� J s ztimezone.__hash__c C sH | | j u rdS | jdu r.dd| jj | jf S dd| jj | j| jf S )a Convert to formal string, for repr().
>>> tz = timezone.utc
>>> repr(tz)
'datetime.timezone.utc'
>>> tz = timezone(timedelta(hours=-5), 'EST')
>>> repr(tz)
"datetime.timezone(datetime.timedelta(-1, 68400), 'EST')"
zdatetime.timezone.utcNz%s(%r)r� z
%s(%r, %r))rw r� r� r� r� r� r r r r� M s
� �ztimezone.__repr__c C s
| � d �S r~ )rj r� r r r r� _ s ztimezone.__str__c C s$ t |t�s|d u r| jS td��d S )Nz8utcoffset() argument must be a datetime instance or None)r� r r� r� r r r r ra b s ztimezone.utcoffsetc C s: t |t�s|d u r.| jd u r(| �| j�S | jS td��d S )Nz5tzname() argument must be a datetime instance or None)r� r r� �_name_from_offsetr� r� r r r r rj h s
ztimezone.tznamec C s" t |t�s|d u rd S td��d S )Nz2dst() argument must be a datetime instance or None)r� r r� r r r r r� p s z timezone.dstc C s2 t |t�r&|j| ur td��|| j S td��d S )Nz fromutc: dt.tzinfo is not selfz6fromutc() argument must be a datetime instance or None)r� r r r� r� r� r r r r r v s
ztimezone.fromutcr� r� rB c C sL | t d�k rd}| } nd}t| t dd��\}}|t dd� }d�|||�S )Nr rc rb r rd rf zUTC{}{:02d}:{:02d})rp r5 rt )r rz re �restrg r r r r� � s ztimezone._name_from_offset)N)r� r� r� r� r r� r� r r� r! r� r� r� r� ra rj r� r rp r� r� � staticmethodr� r r r r rq s$ rq i� rj )�*)r� )Er� �
__future__r r r r Zfuture.builtinsr r r r r
r Z future.utilsr r
r� rP �mathr� r r� r� r r# r( �dbmr- rk r r r& r) r. r6 r7 r8 r: r� r� rW r[ r} r� r� r� r� r� r� r� rp r\ �max�
resolutionr� rb r rX rc r r rq r� rw r� r� rf � _datetime� ImportErrorr r r r �<module> s�
?9 J
� ! C 4 y s G
PK �Cu\�{�7 �7 2 future/backports/__pycache__/socket.cpython-39.pycnu �[��� a
��?h/= � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlZddlT ddl Z ddl
Z
ddl Z z ddl Z W n e
y� dZ Y n0 ee d d
�Zee d d �Zee d
d �ZddgZe�e �e�� eZe
j�� �d��rdi Zded< ded< ded< ded< ded< ded < d ed < d ed < d!ed"< d#ed$< d%ed&< d'ed(< d)ed*< d+ed,< d-ed.< e�d/� G d0d1� d1ej�Zd?d2d3�Z e ejd4��r�d5d6� Z e ed7��r�de dfd8d7�Z e!eeg�Z"G d9d:� d:e j#�Z$d@d<d�Z%dd=lm&Z& e&dfd>d�Z'dS )Aa This module provides socket operations and some related functions.
On Unix, it supports IP (Internet Protocol) and Unix domain sockets.
On other systems, it only supports IP. Functions specific for a
socket are available as methods of the socket object.
Functions:
socket() -- create a new socket object
socketpair() -- create a pair of new socket objects [*]
fromfd() -- create a socket object from an open file descriptor [*]
fromshare() -- create a socket object from data received from socket.share() [*]
gethostname() -- return the current hostname
gethostbyname() -- map a hostname to its IP number
gethostbyaddr() -- map an IP number or hostname to DNS info
getservbyname() -- map a service name and a protocol name to a port number
getprotobyname() -- map a protocol name (e.g. 'tcp') to a number
ntohs(), ntohl() -- convert 16, 32 bit int from network to host byte order
htons(), htonl() -- convert 16, 32 bit int from host to network byte order
inet_aton() -- convert IP addr string (123.45.67.89) to 32-bit packed format
inet_ntoa() -- convert 32-bit packed format IP to string (123.45.67.89)
socket.getdefaulttimeout() -- get the default timeout value
socket.setdefaulttimeout() -- set the default timeout value
create_connection() -- connects to an address, with an optional timeout and
optional source address.
[*] not available on all platforms!
Special objects:
SocketType -- type object for socket objects
error -- exception raised for I/O errors
has_ipv6 -- boolean value indicating if IPv6 is supported
Integer constants:
AF_INET, AF_UNIX -- socket domains (first argument to socket() call)
SOCK_STREAM, SOCK_DGRAM, SOCK_RAW -- socket types (second argument)
Many other constants may be defined; these may be used in calls to
the setsockopt() and getsockopt() methods.
� )�unicode_literals)�print_function)�division)�absolute_import)�superN)�*�EBADF� �EAGAIN� � EWOULDBLOCK�getfqdn�create_connection�winz The operation was interrupted.i' z A bad file handle was passed.i' zPermission denied.i ' z!A fault occurred on the network??i ' z#An invalid operation was attempted.i&' z The socket operation would blocki3' z,A blocking operation is already in progress.i4' z The network address is in use.i@' z The connection has been reset.iF' z The network has been shut down.iJ' zThe operation timed out.iL' zConnection refused.iM' zThe name is too long.iO' zThe host is down.iP' zThe host is unreachable.iQ' �errorTabc s� e Zd ZdZg d�Zeeddfdd�Zdd� Zd d
� Z d d � Z
d
d� Z dd� Z dd� Z
d dd�Zdd� Zejfdd�Zdd� Z� fd d �Z� ZS ) �socketz:A subclass of _socket.socket adding the makefile() method.)� __weakref__�_io_refs�_closedr Nc C s@ |d u r t j�| |||� nt j�| ||||� d| _d| _d S )Nr F)�_socketr �__init__r r )�self�family�type�proto�fileno� r �A/usr/local/lib/python3.9/site-packages/future/backports/socket.pyr c s
zsocket.__init__c C s | S �Nr �r r r r � __enter__k s zsocket.__enter__c G s | j s| �� d S r )r �close)r �argsr r r �__exit__n s zsocket.__exit__c C sJ t j�| �}|�d�rFd| jj| jjt| dd�r4dp6d|dd� f }|S ) z.Wrap __repr__() to reveal the real class name.z<socket objectz
<%s.%s%s%sr Fz
[closed] � � N)r r �__repr__�
startswith� __class__�
__module__�__name__�getattr)r �sr r r r& r s
�zsocket.__repr__c C s t d��d S )Nz Cannot serialize socket object)� TypeErrorr r r r � __getstate__| s zsocket.__getstate__c C s6 t | �� �}| j| j| j| j|d�}|�| �� � |S )zjdup() -> socket object
Return a new socket object connected to the same system resource.
�r )�dupr r( r r r �
settimeout�
gettimeout)r �fd�sockr r r r0 s z
socket.dupc C sF | � � \}}t| j| j| j|d�}t� du r>| �� r>|�d� ||fS )z�accept() -> (socket object, address info)
Wait for an incoming connection. Return a new socket
representing the connection, and the address of the client.
For IP sockets, the address info is a pair (hostaddr, port).
r/ NT)�_acceptr r r r �getdefaulttimeoutr2 � setblocking)r r3 �addrr4 r r r �accept� s
z
socket.accept�rc K sh d|v r|d }|d= nd}d|v r4|d }|d= nd}d|v rP|d }|d= nd}|D ]}|dvrXt d��qXd|v }d|v p�| } | s�|s�J �d |v }
d
} | r�| d7 } |r�| d7 } t| | �} | jd 7 _|du r�d }|d
k r�tj}|d
kr�|
s�t d��| S | �r|�rt�| | |�}
n*| �r.t�| |�}
n|�s8J �t�| |�}
|
�rN|
S t�|
|||�}||_ |S )a
makefile(...) -> an I/O stream connected to the socket
The arguments are as for io.open() after the filename,
except the only mode characters supported are 'r', 'w' and 'b'.
The semantics are similar too. (XXX refactor to share code?)
�newlineN�errors�encoding)r: �w�bz&invalid mode %r (only r, w, b allowed)r> r: r? r$ � ���r z!unbuffered streams must be binary)
�
ValueError�SocketIOr �io�DEFAULT_BUFFER_SIZE�BufferedRWPair�BufferedReader�BufferedWriter�
TextIOWrapper�mode)r rJ � bufferingZ _3to2kwargsr; r< r= �c�writing�reading�binary�rawmode�raw�buffer�textr r r �makefile� sN
zsocket.makefilec C s* | j dkr| j d8 _ | jr&| �� d S )Nr r@ )r r r! r r r r �_decref_socketios� s
zsocket._decref_socketiosc C s |� | � d S r )r! )r �_ssr r r � _real_close� s zsocket._real_closec C s d| _ | jdkr| �� d S )NTr )r r rW r r r r r! � s
z socket.closec s d| _ t� �� S )a detach() -> file descriptor
Close the socket object without closing the underlying file descriptor.
The object cannot be used after this call, but the file descriptor
can be reused for other purposes. The file descriptor is returned.
T)r r �detachr �r( r r rX � s z
socket.detach)r: N)r* r) � __qualname__�__doc__� __slots__�AF_INET� SOCK_STREAMr r r# r& r. r0 r9 rT rU r r rW r! rX �
__classcell__r r rY r r ] s
0r c C s t | �}t||||�S )z� fromfd(fd, family, type[, proto]) -> socket object
Create a socket object from a duplicate of the given file
descriptor. The remaining arguments are the same as for socket().
)r0 r )r3 r r r �nfdr r r �fromfd� s ra �sharec C s t ddd| �S )z� fromshare(info) -> socket object
Create a socket object from a the bytes object returned by
socket.share(pid).
r )r )�infor r r � fromshare� s rd �
socketpairc C sf | du r(zt } W n ty& t} Y n0 t�| ||�\}}t| |||�� �}t| |||�� �}||fS )aa socketpair([family[, type[, proto]]]) -> (socket object, socket object)
Create a pair of socket objects from the sockets returned by the platform
socketpair() function.
The arguments are the same as for socket() except the default family is
AF_UNIX if defined on the platform; otherwise, the default is AF_INET.
N)�AF_UNIX� NameErrorr] r re r rX )r r r �ar? r r r re � s
c sp e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Z� fd d
�Z dd� Z
e dd� �Z e dd� �Z
dd� Z� ZS )rC z�Raw I/O implementation for stream sockets.
This class supports the makefile() method on sockets. It provides
the raw I/O interface on top of a socket object.
c C sZ |dvrt d| ��tj�| � || _d|vr6|d7 }|| _d|v | _d|v | _d| _d S )N)r: r> �rw�rb�wb�rwbzinvalid mode: %rr? r: r> F) rB rD � RawIOBaser �_sock�_mode�_reading�_writing�_timeout_occurred)r r4 rJ r r r r s
zSocketIO.__init__c
C s� | � � | �� | jr td��z| j�|�W S tyF d| _� Y q ty� } z*|jd t v rpW Y d}~dS � W Y d}~q d}~0 0 q dS )a3 Read up to len(b) bytes into the writable buffer *b* and return
the number of bytes read. If the socket is non-blocking and no bytes
are available, None is returned.
If *b* is non-empty, a 0 return value indicates that the connection
was shutdown at the other end.
z!cannot read from timed out objectTr N)
� _checkClosed�_checkReadablerr �IOErrorrn � recv_into�timeout�errorr" �_blocking_errnos�r r? �er r r �readinto) s zSocketIO.readintoc
C sf | � � | �� z| j�|�W S ty` } z*|jd tv rJW Y d}~dS � W Y d}~n
d}~0 0 dS )a Write the given bytes or bytearray object *b* to the socket
and return the number of bytes written. This can be less than
len(b) if not all data could be written. If the socket is
non-blocking and no bytes could be written None is returned.
r N)rs �_checkWritablern �sendrx r" ry rz r r r �writeB s zSocketIO.writec C s | j rtd��| jS )z2True if the SocketIO is open for reading.
� I/O operation on closed socket.)�closedrB rp r r r r �readableR s zSocketIO.readablec C s | j rtd��| jS )z2True if the SocketIO is open for writing.
r� )r� rB rq r r r r �writableY s zSocketIO.writablec s | j rtd��t� �� S )z2True if the SocketIO is open for seeking.
r� )r� rB r �seekabler rY r r r� ` s zSocketIO.seekablec C s | � � | j�� S )z=Return the file descriptor of the underlying socket.
)rs rn r r r r r r g s zSocketIO.filenoc C s | j s| �� S dS d S )NrA )r� r r r r r �namem s z
SocketIO.namec C s | j S r )ro r r r r rJ t s z
SocketIO.modec C s* | j r
dS tj�| � | j�� d| _dS )z�Close the SocketIO object. This doesn't close the underlying
socket, except if all references to it have disappeared.
N)r� rD rm r! rn rU r r r r r! x s
zSocketIO.close)r* r) rZ r[ r r| r r� r� r� r �propertyr� rJ r! r_ r r rY r rC s
rC r$ c C sj | � � } | r| dkrt� } zt| �\}}}W n ty> Y n(0 |�d|� |D ]} d| v rP qfqP|} | S )a Get fully qualified domain name from name.
An empty argument is interpreted as meaning the local host.
First the hostname returned by gethostbyaddr() is checked, then
possibly existing aliases. In case no FQDN is available, hostname
from gethostname() is returned.
z0.0.0.0r �.)�strip� gethostname�
gethostbyaddrrx �insert)r� �hostname�aliases�ipaddrsr r r r
� s )�_GLOBAL_DEFAULT_TIMEOUTc C s� | \}}d}t ||dt�D ]�}|\}}} }
} d} z@t||| �} |turP| �|� |r^| �|� | �| � | W S ty� }
z |
}| dur�| �� W Y d}
~
qd}
~
0 0 q|dur�|�ntd��dS )ad Connect to *address* and return the socket object.
Convenience function. Connect to *address* (a 2-tuple ``(host,
port)``) and return the socket object. Passing the optional
*timeout* parameter will set the timeout on the socket instance
before attempting to connect. If no *timeout* is supplied, the
global default timeout setting returned by :func:`getdefaulttimeout`
is used. If *source_address* is set it must be a tuple of (host, port)
for the socket to bind as a source address before making the connection.
An host of '' or port 0 tells the OS to use the default.
Nr z!getaddrinfo returns an empty list) � getaddrinfor^ r r� r1 �bind�connectrx r! )�addressrw �source_address�host�port�err�res�af�socktyper � canonname�sar4 �_r r r r � s(
)r )r$ )(r[ �
__future__r r r r Zfuture.builtinsr r �os�sysrD �errno� ImportErrorr+ r r
r �__all__�extend�_get_exports_listr Z _realsocket�platform�lowerr' r �appendra �hasattrrd r^ re �setry rm rC r
r� r r r r r �<module> sd +
w
�PK �Cu\�]��p �p 0 future/backports/__pycache__/misc.cpython-39.pycnu �[��� a
��?h'� � @ s� d Z ddlmZ ddlZddlmZ ddlmZ m
Z ddl Z ddl
ZddlmZ ddlmZmZmZ ddlmZmZm Z mZ dd l m Z m Z m Z m!Z!m"Z" e r�dd
l#m$Z$m%Z% ndd
l&m$Z$m%Z% d d � Zdd
lm'Z' e!r�d4dd�Z(n ddlm(Z( e"�r(zddl)m*Z* W n e+�y$ ddl,m*Z* Y n0 n2zddl-m*Z* W n e+�yX ddl.m*Z* Y n0 d5dd�Z/G dd� de0�Z1G dd� de2�Z3z ddlmZ ddl
m4Z4 W n e+�y� Y n0 d d � Z5G d d � d e2�Z6d d!� Z7d6d"d�Z(G d#d$� d$e%�Z8dd%lm9Z9 e9dfd&d'�Z:d(d)� Z;e3Z<e6Z=e7Z>e(Z?eZ@e5ZAe/ZBe8ZCe:ZDe;ZEe jFd*k�r�dd+l#m3Z3m6Z6 ddlm(Z( dd,lGm;Z; zdd-lm7Z7 W n e+�y� Y n0 dd.lm:Z: e jFd/k�r�ddlmZ dd0l#m5Z5 e jFd1k�r�dd2lHm/Z/ dd3l#m8Z8 dS )7a�
Miscellaneous function (re)definitions from the Py3.4+ standard library
for Python 2.6/2.7.
- math.ceil (for Python 2.7)
- collections.OrderedDict (for Python 2.6)
- collections.Counter (for Python 2.6)
- collections.ChainMap (for all versions prior to Python 3.3)
- itertools.count (for Python 2.6, with step parameter)
- subprocess.check_output (for Python 2.6)
- reprlib.recursive_repr (for Python 2.6+)
- functools.cmp_to_key (for Python 2.6)
� )�absolute_importN)�ceil)�
itemgetter�eq)�proxy)�repeat�chain�starmap)� getaddrinfo� SOCK_STREAM�error�socket)� iteritems�
itervalues�PY2�PY26�PY3)�Mapping�MutableMappingc C s t t| ��S )zZ
Return the ceiling of x as an int.
This is the smallest integral value >= x.
)�int�oldceil)�x� r �?/usr/local/lib/python3.9/site-packages/future/backports/misc.pyr # s r )�islice� c c s | V | |7 } q d S �Nr ��start�stepr r r �count3 s r )r )� get_ident�...c s � fdd�}|S )zGDecorator to make a repr function return fillvalue for a recursive callc sL t � � �� �fdd�}t�d�|_t�d�|_t�d�|_t�di �|_|S )Nc sL t | �t� f}|�v r� S ��|� z�| �}W ��|� n ��|� 0 |S r )�idr! �add�discard)�self�key�result)� fillvalue� repr_running�
user_functionr r �wrapperM s
z<recursive_repr.<locals>.decorating_function.<locals>.wrapper�
__module__�__doc__�__name__�__annotations__)�set�getattrr- r. r/ r0 )r+ r, �r) )r* r+ r �decorating_functionJ s z+recursive_repr.<locals>.decorating_functionr )r) r4 r r3 r �recursive_reprG s r5 c @ s e Zd ZdZdS )�_Link)�prev�nextr' � __weakref__N)r/ r- � __qualname__� __slots__r r r r r6 j s r6 c @ s� e Zd ZdZdd� Zejeefdd�Zej fdd�Z dd � Z
d
d � Z d d
� Z d$dd�Z
d%dd�Zdd� Zej ZZejZejZejZejZe� Zefdd�Zd&dd�Ze� dd� �Z d d � Z d d � Z e d'd d!��Z d"d#� Z!dS )(� OrderedDictz)Dictionary that remembers insertion orderc O s� | s t d��| d }| dd� } t| �dkr<t dt| � ��z
|j W n< ty� t� |_t|j� |_}| |_|_i |_ Y n0 |j
| i |�� dS )z�Initialize an ordered dictionary. The signature is the same as
regular dictionaries, but keyword arguments are not recommended because
their insertion order is arbitrary.
z?descriptor '__init__' of 'OrderedDict' object needs an argumentr r N�$expected at most 1 arguments, got %d) � TypeError�len�_OrderedDict__root�AttributeErrorr6 �_OrderedDict__hardroot�_proxyr7 r8 �_OrderedDict__map�_OrderedDict__update)�args�kwdsr& �rootr r r �__init__| s
zOrderedDict.__init__c C sZ || vrJ|� | j |< }| j}|j}||| |_|_|_||_||�|_|| ||� dS )z!od.__setitem__(i, y) <==> od[i]=yN)rD r@ r7 r8 r' ) r& r' �valueZ dict_setitemr �Link�linkrH �lastr r r � __setitem__� s
zOrderedDict.__setitem__c C s2 || |� | j �|�}|j}|j}||_||_dS )z od.__delitem__(y) <==> del od[y]N)rD �popr7 r8 )r& r' Z dict_delitemrL � link_prev� link_nextr r r � __delitem__� s
zOrderedDict.__delitem__c c s( | j }|j}||ur$|jV |j}q dS )zod.__iter__() <==> iter(od)N)r@ r8 r' �r& rH �currr r r �__iter__� s
zOrderedDict.__iter__c c s( | j }|j}||ur$|jV |j}q dS )z#od.__reversed__() <==> reversed(od)N)r@ r7 r' rS r r r � __reversed__� s
zOrderedDict.__reversed__c C s* | j }| |_|_| j�� t�| � dS )z.od.clear() -> None. Remove all items from od.N)r@ r7 r8 rD �clear�dict)r& rH r r r rW � s
zOrderedDict.clearTc C sj | s t d��| j}|r0|j}|j}||_||_n|j}|j}||_||_|j}| j|= t�| |�}||fS )z�od.popitem() -> (k, v), return and remove a (key, value) pair.
Pairs are returned in LIFO order if last is true or FIFO order if false.
zdictionary is empty)�KeyErrorr@ r7 r8 r' rD rX rO )r& rM rH rL rP rQ r' rJ r r r �popitem� s zOrderedDict.popitemc C sn | j | }|j}|j}||_||_| j}|rL|j}||_||_| |_|_n |j}||_||_| |_|_dS )z�Move an existing element to the end (or beginning if last==False).
Raises KeyError if the element does not exist.
When last=True, acts like a fast version of self[key]=self.pop(key).
N)rD r7 r8 r@ )r& r' rM rL rP rQ rH �firstr r r � move_to_end� s
zOrderedDict.move_to_endc C sV t j}t| �d }|| j�}||| j�d 7 }||| j�| 7 }||| j�| 7 }|S )Nr � )�sys� getsizeofr? �__dict__rD rB r@ )r& �sizeof�n�sizer r r �
__sizeof__� s
zOrderedDict.__sizeof__c C s0 || v r| | }| |= |S || j u r,t|��|S )z�od.pop(k[,d]) -> v, remove specified key and return the corresponding
value. If key is not found, d is returned if given, otherwise KeyError
is raised.
)�_OrderedDict__markerrY )r& r' �defaultr( r r r rO s
zOrderedDict.popNc C s || v r| | S || |< |S )zDod.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in odr �r& r' rf r r r �
setdefault s zOrderedDict.setdefaultc C s* | sd| j jf S d| j jt| �� �f S )zod.__repr__() <==> repr(od)�%s()z%s(%r))� __class__r/ �list�items�r& r r r �__repr__ s zOrderedDict.__repr__c C sD t | ��� }t t� �D ]}|�|d� q| jd|p4ddt| �� �fS )z%Return state information for picklingNr )�vars�copyr< rO rj �iterrl )r& � inst_dict�kr r r �
__reduce__ s zOrderedDict.__reduce__c C s
| � | �S )z!od.copy() -> a shallow copy of od�rj rm r r r rp ' s zOrderedDict.copyc C s | � }|D ] }|||< q
|S )zOD.fromkeys(S[, v]) -> New ordered dictionary with keys from S.
If not specified, the value defaults to None.
r )�cls�iterablerJ r& r' r r r �fromkeys+ s
zOrderedDict.fromkeysc C s2 t |t�r&t�| |�o$ttt| |��S t�| |�S )z�od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive
while comparison to a regular mapping is order-insensitive.
)�
isinstancer< rX �__eq__�all�map�_eq�r& �otherr r r rz 6 s
zOrderedDict.__eq__)T)T)N)N)"r/ r- r: r. rI rX rN rC r6 rR rU rV rW rZ r\ rd r �updaterE �keys�valuesrl �__ne__�objectre rO rh r5 rn rt rp � classmethodrx rz r r r r r< m s4 �
r< )r )�nlargestc C s& | j }|D ]}||d�d | |< q
dS )z!Tally elements from the iterable.r r N)�get)�mappingrw Z mapping_get�elemr r r �_count_elementsL s r� c s� e Zd ZdZ� fdd�Zdd� Zd/dd�Zd d
� Zed0d d ��Z � fd
d�Z
dd� Z dd� Z dd� Z
� fdd�Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Z� ZS )1�Countera� Dict subclass for counting hashable items. Sometimes called a bag
or multiset. Elements are stored as dictionary keys and their counts
are stored as dictionary values.
>>> c = Counter('abcdeabcdabcaba') # count elements from a string
>>> c.most_common(3) # three most common elements
[('a', 5), ('b', 4), ('c', 3)]
>>> sorted(c) # list all unique elements
['a', 'b', 'c', 'd', 'e']
>>> ''.join(sorted(c.elements())) # list elements with repetitions
'aaaaabbbbcccdde'
>>> sum(c.values()) # total of all counts
15
>>> c['a'] # count of letter 'a'
5
>>> for elem in 'shazam': # update counts from an iterable
... c[elem] += 1 # by adding 1 to each element's count
>>> c['a'] # now there are seven 'a'
7
>>> del c['b'] # remove all 'b'
>>> c['b'] # now there are zero 'b'
0
>>> d = Counter('simsalabim') # make another counter
>>> c.update(d) # add in the second counter
>>> c['a'] # now there are nine 'a'
9
>>> c.clear() # empty the counter
>>> c
Counter()
Note: If a count is set to zero or reduced to zero, it will remain
in the counter until the entry is deleted or the counter is cleared:
>>> c = Counter('aaabbc')
>>> c['b'] -= 2 # reduce the count of 'b' by two
>>> c.most_common() # 'b' is still in, but its count is zero
[('a', 3), ('c', 1), ('b', 0)]
c s^ | s t d��| d }| dd� } t| �dkr<t dt| � ��tt|��� |j| i |�� dS )a Create a new, empty Counter object. And if given, count elements
from an input iterable. Or, initialize the count from another mapping
of elements to their counts.
>>> c = Counter() # a new, empty counter
>>> c = Counter('gallahad') # a new counter from an iterable
>>> c = Counter({'a': 4, 'b': 2}) # a new counter from a mapping
>>> c = Counter(a=4, b=2) # a new counter from keyword args
z;descriptor '__init__' of 'Counter' object needs an argumentr r Nr= )r> r? �superr� rI r� )rF rG r& ru r r rI � s zCounter.__init__c C s dS )z1The count of elements not in the Counter is zero.r r �r& r' r r r � __missing__� s zCounter.__missing__Nc C s6 |du r t | �� td�dd�S tj|| �� td�d�S )z�List the n most common elements and their counts from the most
common to the least. If n is None, then list all element counts.
>>> Counter('abcdeabcdabcaba').most_common(3)
[('a', 5), ('b', 4), ('c', 3)]
Nr T)r' �reverse�r' )�sortedrl � _itemgetter�_heapqr� )r& rb r r r � most_common� s zCounter.most_commonc C s t �tt| �� ��S )a� Iterator over elements repeating each as many times as its count.
>>> c = Counter('ABCABC')
>>> sorted(c.elements())
['A', 'A', 'B', 'B', 'C', 'C']
# Knuth's example for prime factors of 1836: 2**2 * 3**3 * 17**1
>>> prime_factors = Counter({2: 2, 3: 3, 17: 1})
>>> product = 1
>>> for factor in prime_factors.elements(): # loop over factors
... product *= factor # and multiply them
>>> product
1836
Note, if an element's count has been set to zero or is a negative
number, elements() will ignore it.
)�_chain�
from_iterable�_starmap�_repeatrl rm r r r �elements� s zCounter.elementsc C s t d��d S )Nz@Counter.fromkeys() is undefined. Use Counter(iterable) instead.)�NotImplementedError)rv rw �vr r r rx � s �zCounter.fromkeysc s� | s t d��| d }| dd� } t| �dkr<t dt| � ��| rH| d nd}|dur�t|t�r�|r�|j}|�� D ]\}}|||d� ||< qpq�tt|��|� n
t ||� |r�|�|� dS )a� Like dict.update() but add counts instead of replacing them.
Source can be an iterable, a dictionary, or another Counter instance.
>>> c = Counter('which')
>>> c.update('witch') # add elements from another iterable
>>> d = Counter('watch')
>>> c.update(d) # add elements from another counter
>>> c['h'] # four 'h' in which, witch, and watch
4
z9descriptor 'update' of 'Counter' object needs an argumentr r Nr= )
r> r? ry r r� rl r� r� r� r� �rF rG r& rw �self_getr� r ru r r r� � s"
zCounter.updatec O s� | s t d��| d }| dd� } t| �dkr<t dt| � ��| rH| d nd}|dur�|j}t|t�r�|�� D ]\}}||d�| ||< qln |D ]}||d�d ||< q�|r�|�|� dS )a� Like dict.update() but subtracts counts instead of replacing them.
Counts can be reduced below zero. Both the inputs and outputs are
allowed to contain zero and negative counts.
Source can be an iterable, a dictionary, or another Counter instance.
>>> c = Counter('which')
>>> c.subtract('witch') # subtract elements from another iterable
>>> c.subtract(Counter('watch')) # subtract elements from another counter
>>> c['h'] # 2 in which, minus 1 in witch, minus 1 in watch
0
>>> c['w'] # 1 in which, minus 1 in witch, minus 1 in watch
-1
z;descriptor 'subtract' of 'Counter' object needs an argumentr r Nr= )r> r? r� ry r rl �subtractr� r r r r� � s
zCounter.subtractc C s
| � | �S )zReturn a shallow copy.ru rm r r r rp s z Counter.copyc C s | j t| �ffS r )rj rX rm r r r rt s zCounter.__reduce__c s || v rt t| ��|� dS )zGLike dict.__delitem__() but does not raise KeyError for missing values.N)r� r� rR )r& r� ru r r rR s zCounter.__delitem__c C sd | sd| j j S z(d�tdj| �� ��}d| j j|f W S ty^ d�| j jt| �� Y S 0 d S )Nri �, z%r: %rz%s({%s})z
{0}({1!r})) rj r/ �joinr| �__mod__r� r> �formatrX )r& rl r r r rn # s zCounter.__repr__c C sp t |t�stS t� }| �� D ]$\}}||| }|dkr |||< q |�� D ] \}}|| vrJ|dkrJ|||< qJ|S )zAdd counts from two counters.
>>> Counter('abbb') + Counter('bcc')
Counter({'b': 4, 'c': 2, 'a': 1})
r �ry r� �NotImplementedrl �r& r r( r� r �newcountr r r �__add__6 s
zCounter.__add__c C st t |t�stS t� }| �� D ]$\}}||| }|dkr |||< q |�� D ]$\}}|| vrJ|dk rJd| ||< qJ|S )z� Subtract count, but keep only results with positive counts.
>>> Counter('abbbc') - Counter('bccd')
Counter({'b': 2, 'a': 1})
r r� r� r r r �__sub__I s
zCounter.__sub__c C s| t |t�stS t� }| �� D ]0\}}|| }||k r8|n|}|dkr |||< q |�� D ] \}}|| vrV|dkrV|||< qV|S )z�Union is the maximum of value in either of the input counters.
>>> Counter('abbb') | Counter('bcc')
Counter({'b': 3, 'c': 2, 'a': 1})
r r� �r& r r( r� r � other_countr� r r r �__or__\ s
zCounter.__or__c C sR t |t�stS t� }| �� D ]0\}}|| }||k r8|n|}|dkr |||< q |S )z� Intersection is the minimum of corresponding counts.
>>> Counter('abbb') & Counter('bcc')
Counter({'b': 1})
r r� r� r r r �__and__p s
zCounter.__and__c C s
| t � S )zEAdds an empty counter, effectively stripping negative and zero counts�r� rm r r r �__pos__� s zCounter.__pos__c C s
t � | S )z{Subtracts from an empty counter. Strips positive and zero counts,
and flips the sign on negative counts.
r� rm r r r �__neg__� s zCounter.__neg__c C s& dd� | � � D �}|D ]
}| |= q| S )z?Internal method to strip elements with a negative or zero countc S s g | ]\}}|d ks|�qS )r r )�.0r� r r r r �
<listcomp>� � z*Counter._keep_positive.<locals>.<listcomp>)rl )r& � nonpositiver� r r r �_keep_positive� s zCounter._keep_positivec C s* |� � D ]\}}| | |7 < q| �� S )z�Inplace add from another counter, keeping only positive counts.
>>> c = Counter('abbb')
>>> c += Counter('bcc')
>>> c
Counter({'b': 4, 'c': 2, 'a': 1})
�rl r� �r& r r� r r r r �__iadd__� s zCounter.__iadd__c C s* |� � D ]\}}| | |8 < q| �� S )z�Inplace subtract counter, but keep only results with positive counts.
>>> c = Counter('abbbc')
>>> c -= Counter('bccd')
>>> c
Counter({'b': 2, 'a': 1})
r� r� r r r �__isub__� s zCounter.__isub__c C s2 |� � D ] \}}| | }||kr|| |< q| �� S )z�Inplace union is the maximum of value from either counter.
>>> c = Counter('abbb')
>>> c |= Counter('bcc')
>>> c
Counter({'b': 3, 'c': 2, 'a': 1})
r� )r& r r� r� r r r r �__ior__� s
zCounter.__ior__c C s2 | � � D ] \}}|| }||k r|| |< q| �� S )z�Inplace intersection is the minimum of corresponding counts.
>>> c = Counter('abbb')
>>> c &= Counter('bcc')
>>> c
Counter({'b': 1})
r� )r& r r� r r� r r r �__iand__� s
zCounter.__iand__)N)N) r/ r- r: r. rI r� r� r� r� rx r� r� rp rt rR rn r� r� r� r� r� r� r� r� r� r� r� �
__classcell__r r ru r r� R s0 2
)#
r� c O sh d|v rt d��tj| dtji|��}|�� \}}|�� }|rd|�d�}|du rX| d }t�||��|S )z[
For Python 2.6 compatibility: see
http://stackoverflow.com/questions/4814970/
�stdoutz3stdout argument not allowed, it will be overridden.rF Nr )�
ValueError�
subprocess�Popen�PIPE� communicate�pollr� �CalledProcessError)� popenargs�kwargs�process�outputZ
unused_err�retcode�cmdr r r � check_output� s
r� c c s | V | |7 } q dS )z�
``itertools.count`` in Py 2.6 doesn't accept a step
parameter. This is an enhanced version of ``itertools.count``
for Py2.6 equivalent to ``itertools.count`` in Python 2.7+.
Nr r r r r r � s c @ s� e Zd ZdZdd� Zdd� Zdd� Zd'd d
�Zd d � Zd
d� Z dd� Z
dd� Z e Z e
� dd� �Zedd� �Zdd� ZeZd(dd�Zedd � �Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� ZdS ))�ChainMapa� A ChainMap groups multiple dicts (or other mappings) together
to create a single, updateable view.
The underlying mappings are stored in a list. That list is public and can
accessed or updated using the *maps* attribute. There is no other state.
Lookups search the underlying mappings successively until a key is found.
In contrast, writes, updates, and deletions only operate on the first
mapping.
c G s t |�p i g| _dS )z�Initialize a ChainMap by setting *maps* to the given mappings.
If no mappings are provided, a single empty dictionary is used.
N)rk �maps)r& r� r r r rI � s zChainMap.__init__c C s t |��d S r )rY r� r r r r� s zChainMap.__missing__c C s8 | j D ]&}z|| W S ty* Y q0 q| �|�S r )r� rY r� )r& r' r� r r r � __getitem__ s
zChainMap.__getitem__Nc C s || v r| | S |S r r rg r r r r� s z ChainMap.getc C s t t� j| j� �S r )r? r1 �unionr� rm r r r �__len__ s zChainMap.__len__c C s t t� j| j� �S r )rq r1 r� r� rm r r r rU s zChainMap.__iter__c s t � fdd�| jD ��S )Nc 3 s | ]}� |v V qd S r r )r� �mr� r r � <genexpr> r� z(ChainMap.__contains__.<locals>.<genexpr>��anyr� r� r r� r � __contains__ s zChainMap.__contains__c C s
t | j�S r r� rm r r r �__bool__ s zChainMap.__bool__c C s d� | d�tt| j���S )Nz{0.__class__.__name__}({1})r� )r� r� r| �reprr� rm r r r rn ! s �zChainMap.__repr__c G s | t j|g|�R � �S )z?Create a ChainMap with a single dict created from the iterable.)rX rx )rv rw rF r r r rx & s zChainMap.fromkeysc C s& | j | jd �� g| jdd� �R � S )zHNew ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]r r N)rj r� rp rm r r r rp + s z
ChainMap.copyc C s |du r i }| j |g| j�R � S )z�
New ChainMap with a new map followed by all previous maps. If no
map is provided, an empty dict is used.
N�rj r� )r& r� r r r � new_child1 s zChainMap.new_childc C s | j | jdd� � S )zNew ChainMap from maps[1:].r Nr� rm r r r �parents: s zChainMap.parentsc C s || j d |< d S �Nr )r� )r& r' rJ r r r rN ? s zChainMap.__setitem__c C s6 z| j d |= W n ty0 td�|���Y n0 d S )Nr �)Key not found in the first mapping: {0!r})r� rY r� r� r r r rR B s zChainMap.__delitem__c C s0 z| j d �� W S ty* td��Y n0 dS )zPRemove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.r z#No keys found in the first mapping.N)r� rZ rY rm r r r rZ H s zChainMap.popitemc G s@ z| j d j|g|�R � W S ty: td�|���Y n0 dS )zWRemove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].r r� N)r� rO rY r� )r& r' rF r r r rO O s z ChainMap.popc C s | j d �� dS )z'Clear maps[0], leaving maps[1:] intact.r N)r� rW rm r r r rW V s zChainMap.clear)N)N)r/ r- r: r. rI r� r� r� r� rU r� r� � __nonzero__r5 rn r� rx rp �__copy__r� �propertyr� rN rR rZ rO rW r r r r r� � s0
r� )�_GLOBAL_DEFAULT_TIMEOUTc C s� | \}}d}t ||dt�D ]�}|\}}} }
} d} z@t||| �} |turP| �|� |r^| �|� | �| � | W S ty� }
z |
}| dur�| �� W Y d}
~
qd}
~
0 0 q|dur�|�ntd��dS )a� Backport of 3-argument create_connection() for Py2.6.
Connect to *address* and return the socket object.
Convenience function. Connect to *address* (a 2-tuple ``(host,
port)``) and return the socket object. Passing the optional
*timeout* parameter will set the timeout on the socket instance
before attempting to connect. If no *timeout* is supplied, the
global default timeout setting returned by :func:`getdefaulttimeout`
is used. If *source_address* is set it must be a tuple of (host, port)
for the socket to bind as a source address before making the connection.
An host of '' or port 0 tells the OS to use the default.
Nr z!getaddrinfo returns an empty list) r
r r
r� �
settimeout�bind�connectr �close)�address�timeout�source_address�host�port�err�res�af�socktype�proto� canonname�sa�sock�_r r r �create_connection` s(
r� c s G � fdd�dt �}|S )z,Convert a cmp= function into a key= functionc sj e Zd ZdgZdd� Z� fdd�Z� fdd�Z� fdd �Z� fd
d �Z� fd d
�Z � fdd�Z
dd� Z dS )zcmp_to_key.<locals>.K�objc W s
|| _ d S r �r� )r& r� rF r r r rI � s z cmp_to_key.<locals>.K.__init__c s � | j |j �dk S r� r� r~ ��mycmpr r �__lt__� s z cmp_to_key.<locals>.K.__lt__c s � | j |j �dkS r� r� r~ r� r r �__gt__� s z cmp_to_key.<locals>.K.__gt__c s � | j |j �dkS r� r� r~ r� r r rz � s z cmp_to_key.<locals>.K.__eq__c s � | j |j �dkS r� r� r~ r� r r �__le__� s z cmp_to_key.<locals>.K.__le__c s � | j |j �dkS r� r� r~ r� r r �__ge__� s z cmp_to_key.<locals>.K.__ge__c s � | j |j �dkS r� r� r~ r� r r r� � s z cmp_to_key.<locals>.K.__ne__c S s t d��d S )Nzhash not implemented)r> rm r r r �__hash__� s z cmp_to_key.<locals>.K.__hash__N) r/ r- r: r; rI r� r� rz r� r� r� r� r r� r r �K� s r� )r� )r� r� r r� r �
cmp_to_key� s r� )r] � )r< r� )r� )r� )r� )� r )r� )r� r� )r5 )r� )r r )r" )r r )Ir. �
__future__r r� �mathr r �operatorr r� r r} r^ �heapqr� �_weakrefr rC � itertoolsr r� r r� r r� r
r
r r Z future.utilsr r r r r � collectionsr r �collections.abcr r �_threadr! � ImportError�
_dummy_thread�thread� dummy_threadr5 r� r6 rX r< r� r� r� r� r� r� r� r� � _OrderedDictZ_CounterZ
_check_output�_count�_ceilZ__count_elements�_recursive_repr� _ChainMap�_create_connectionZ _cmp_to_key� version_info� functools�reprlibr r r r �<module> s�
# V |
l �
) PK �Cu\��lr�V �V 8 future/backports/__pycache__/socketserver.cpython-39.pycnu �[��� a
��?h�^ � @ s� d Z ddlmZmZ dZddlZddlZddlZddlZddl Z z ddl
Z
W n e yf ddl Z
Y n0 g d�Z
eed�r�e
�g d�� dd � ZG d
d � d e�ZG d d
� d
e�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� dee�ZG dd� dee�ZG dd� dee�ZG dd� dee�Zeed��rxG d d � d e�ZG d d � d e�Z G d d!� d!ee�Z G d"d#� d#ee �Z G d$d%� d%e�Z G d&d'� d'e �Z G d(d)� d)e �Z!dS )*a� Generic socket server classes.
This module tries to capture the various aspects of defining a server:
For socket-based servers:
- address family:
- AF_INET{,6}: IP (Internet Protocol) sockets (default)
- AF_UNIX: Unix domain sockets
- others, e.g. AF_DECNET are conceivable (see <socket.h>
- socket type:
- SOCK_STREAM (reliable stream, e.g. TCP)
- SOCK_DGRAM (datagrams, e.g. UDP)
For request-based servers (including socket-based):
- client address verification before further looking at the request
(This is actually a hook for any processing that needs to look
at the request before anything else, e.g. logging)
- how to handle multiple requests:
- synchronous (one request is handled at a time)
- forking (each request is handled by a new process)
- threading (each request is handled by a new thread)
The classes in this module favor the server type that is simplest to
write: a synchronous TCP/IP server. This is bad class design, but
save some typing. (There's also the issue that a deep class hierarchy
slows down method lookups.)
There are five classes in an inheritance diagram, four of which represent
synchronous servers of four types:
+------------+
| BaseServer |
+------------+
|
v
+-----------+ +------------------+
| TCPServer |------->| UnixStreamServer |
+-----------+ +------------------+
|
v
+-----------+ +--------------------+
| UDPServer |------->| UnixDatagramServer |
+-----------+ +--------------------+
Note that UnixDatagramServer derives from UDPServer, not from
UnixStreamServer -- the only difference between an IP and a Unix
stream server is the address family, which is simply repeated in both
unix server classes.
Forking and threading versions of each type of server can be created
using the ForkingMixIn and ThreadingMixIn mix-in classes. For
instance, a threading UDP server class is created as follows:
class ThreadingUDPServer(ThreadingMixIn, UDPServer): pass
The Mix-in class must come first, since it overrides a method defined
in UDPServer! Setting the various member variables also changes
the behavior of the underlying server mechanism.
To implement a service, you must derive a class from
BaseRequestHandler and redefine its handle() method. You can then run
various versions of the service by combining one of the server classes
with your request handler class.
The request handler class must be different for datagram or stream
services. This can be hidden by using the request handler
subclasses StreamRequestHandler or DatagramRequestHandler.
Of course, you still have to use your head!
For instance, it makes no sense to use a forking server if the service
contains state in memory that can be modified by requests (since the
modifications in the child process would never reach the initial state
kept in the parent process and passed to each child). In this case,
you can use a threading server, but you will probably have to use
locks to avoid two requests that come in nearly simultaneous to apply
conflicting changes to the server state.
On the other hand, if you are building e.g. an HTTP server, where all
data is stored externally (e.g. in the file system), a synchronous
class will essentially render the service "deaf" while one request is
being handled -- which may be for a very long time if a client is slow
to read all the data it has requested. Here a threading or forking
server is appropriate.
In some cases, it may be appropriate to process part of a request
synchronously, but to finish processing in a forked child depending on
the request data. This can be implemented by using a synchronous
server and doing an explicit fork in the request handler class
handle() method.
Another approach to handling multiple simultaneous requests in an
environment that supports neither threads nor fork (or where these are
too expensive or inappropriate for the service) is to maintain an
explicit table of partially finished requests and to use select() to
decide which request to work on next (or whether to handle a new
incoming request). This is particularly important for stream services
where each client can potentially be connected for a long time (if
threads or subprocesses cannot be used).
Future work:
- Standard classes for Sun RPC (which uses either UDP or TCP)
- Standard mix-in classes to implement various authentication
and encryption schemes
- Standard framework for select-based multiplexing
XXX Open problems:
- What to do with out-of-band data?
BaseServer:
- split generic "request" functionality out into BaseServer class.
Copyright (C) 2000 Luke Kenneth Casson Leighton <lkcl@samba.org>
example: read entries from a SQL database (requires overriding
get_request() to return a table entry from the database).
entry is processed by a RequestHandlerClass.
� )�absolute_import�print_functionz0.4N) � TCPServer� UDPServer�ForkingUDPServer�ForkingTCPServer�ThreadingUDPServer�ThreadingTCPServer�BaseRequestHandler�StreamRequestHandler�DatagramRequestHandler�ThreadingMixIn� ForkingMixIn�AF_UNIX)�UnixStreamServer�UnixDatagramServer�ThreadingUnixStreamServer�ThreadingUnixDatagramServerc
G sD z
| |� W S t y< } z|jtjkr(� W Y d}~q d}~0 0 q dS )z*restart a system call interrupted by EINTRN)�OSError�errnoZEINTR)�func�args�e� r �G/usr/local/lib/python3.9/site-packages/future/backports/socketserver.py� _eintr_retry� s
r c @ s� e Zd ZdZdZdd� Zdd� Zd"dd �Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd d!� ZdS )#�
BaseServera� Base class for server classes.
Methods for the caller:
- __init__(server_address, RequestHandlerClass)
- serve_forever(poll_interval=0.5)
- shutdown()
- handle_request() # if you do not use serve_forever()
- fileno() -> int # for select()
Methods that may be overridden:
- server_bind()
- server_activate()
- get_request() -> request, client_address
- handle_timeout()
- verify_request(request, client_address)
- server_close()
- process_request(request, client_address)
- shutdown_request(request)
- close_request(request)
- service_actions()
- handle_error()
Methods for derived classes:
- finish_request(request, client_address)
Class variables that may be overridden by derived classes or
instances:
- timeout
- address_family
- socket_type
- allow_reuse_address
Instance variables:
- RequestHandlerClass
- socket
Nc C s || _ || _t�� | _d| _dS )�/Constructor. May be extended, do not override.FN)�server_address�RequestHandlerClass� threading�Event�_BaseServer__is_shut_down� _BaseServer__shutdown_request)�selfr r r r r �__init__� s
zBaseServer.__init__c C s dS �zSCalled by constructor to activate the server.
May be overridden.
Nr �r$ r r r �server_activate� s zBaseServer.server_activate� �?c C sp | j �� zN| jsFttj| gg g |�\}}}| |v r<| �� | �� q W d| _| j �� nd| _| j �� 0 dS )z�Handle one request at a time until shutdown.
Polls for shutdown every poll_interval seconds. Ignores
self.timeout. If you need to do periodic tasks, do them in
another thread.
FN)r" �clearr# r �select�_handle_request_noblock�service_actions�set)r$ �
poll_interval�r�wr r r r �
serve_forever� s
�
�zBaseServer.serve_foreverc C s d| _ | j�� dS )z�Stops the serve_forever loop.
Blocks until the loop has finished. This must be called while
serve_forever() is running in another thread, or it will
deadlock.
TN)r# r" �waitr' r r r �shutdown� s zBaseServer.shutdownc C s dS )z�Called by the serve_forever() loop.
May be overridden by a subclass / Mixin to implement any code that
needs to be run during the loop.
Nr r' r r r r- s zBaseServer.service_actionsc C sd | j �� }|du r| j}n| jdur0t|| j�}ttj| gg g |�}|d sX| �� dS | �� dS )zOHandle one request, possibly blocking.
Respects self.timeout.
Nr )�socket�
gettimeout�timeout�minr r+ �handle_timeoutr, )r$ r7 Zfd_setsr r r �handle_request s
zBaseServer.handle_requestc C sl z| � � \}}W n tjy& Y dS 0 | �||�rhz| �||� W n" | �||� | �|� Y n0 dS )z�Handle one request, without blocking.
I assume that select.select has returned that the socket is
readable before this function was called, so there should be
no risk of blocking in get_request().
N)� get_requestr5 �error�verify_request�process_request� handle_error�shutdown_request�r$ �request�client_addressr r r r, ' s z"BaseServer._handle_request_noblockc C s dS )zcCalled if no new request arrives within self.timeout.
Overridden by ForkingMixIn.
Nr r' r r r r9 9 s zBaseServer.handle_timeoutc C s dS )znVerify the request. May be overridden.
Return True if we should proceed with this request.
Tr rA r r r r= @ s zBaseServer.verify_requestc C s | � ||� | �|� dS )zVCall finish_request.
Overridden by ForkingMixIn and ThreadingMixIn.
N)�finish_requestr@ rA r r r r> H s zBaseServer.process_requestc C s dS �zDCalled to clean-up the server.
May be overridden.
Nr r' r r r � server_closeQ s zBaseServer.server_closec C s | � ||| � dS )z8Finish one request by instantiating RequestHandlerClass.N)r rA r r r rD Y s zBaseServer.finish_requestc C s | � |� dS �z3Called to shutdown and close an individual request.N��
close_request�r$ rB r r r r@ ] s zBaseServer.shutdown_requestc C s dS �z)Called to clean up an individual request.Nr rJ r r r rI a s zBaseServer.close_requestc C s8 t d� t ddd� t |� ddl}|�� t d� dS )ztHandle an error gracefully. May be overridden.
The default is to print a traceback and continue.
z(----------------------------------------z4Exception happened during processing of request from� )�endr N)�print� traceback� print_exc)r$ rB rC rO r r r r? e s zBaseServer.handle_error)r) )�__name__�
__module__� __qualname__�__doc__r7 r% r( r2 r4 r- r: r, r9 r= r> rF rD r@ rI r? r r r r r � s" +
r c @ sf e Zd ZdZejZejZdZ dZ
ddd�Z dd� Z d d
� Z
d d � Zd
d� Zdd� Zdd� Zdd� ZdS )r a3 Base class for various socket-based server classes.
Defaults to synchronous IP stream (i.e., TCP).
Methods for the caller:
- __init__(server_address, RequestHandlerClass, bind_and_activate=True)
- serve_forever(poll_interval=0.5)
- shutdown()
- handle_request() # if you don't use serve_forever()
- fileno() -> int # for select()
Methods that may be overridden:
- server_bind()
- server_activate()
- get_request() -> request, client_address
- handle_timeout()
- verify_request(request, client_address)
- process_request(request, client_address)
- shutdown_request(request)
- close_request(request)
- handle_error()
Methods for derived classes:
- finish_request(request, client_address)
Class variables that may be overridden by derived classes or
instances:
- timeout
- address_family
- socket_type
- request_queue_size (only for stream sockets)
- allow_reuse_address
Instance variables:
- server_address
- RequestHandlerClass
- socket
� FTc C s8 t �| ||� t�| j| j�| _|r4| �� | �� dS )r N)r r% r5 �address_family� socket_type� server_bindr( )r$ r r �bind_and_activater r r r% � s �zTCPServer.__init__c C s8 | j r| j�tjtjd� | j�| j� | j�� | _dS )zOCalled by constructor to bind the socket.
May be overridden.
� N)�allow_reuse_addressr5 �
setsockopt�
SOL_SOCKET� SO_REUSEADDR�bindr � getsocknamer' r r r rX � s zTCPServer.server_bindc C s | j �| j� dS r& )r5 �listen�request_queue_sizer' r r r r( � s zTCPServer.server_activatec C s | j �� dS rE )r5 �closer' r r r rF � s zTCPServer.server_closec C s
| j �� S )zMReturn socket file number.
Interface required by select().
)r5 �filenor' r r r rd � s zTCPServer.filenoc C s
| j �� S )zYGet the request and client address from the socket.
May be overridden.
)r5 �acceptr' r r r r; � s zTCPServer.get_requestc C s4 z|� tj� W n tjy$ Y n0 | �|� dS rG )r4 r5 �SHUT_WRr< rI rJ r r r r@ � s
zTCPServer.shutdown_requestc C s |� � dS rK )rc rJ r r r rI � s zTCPServer.close_requestN)T)rQ rR rS rT r5 �AF_INETrV � SOCK_STREAMrW rb r[ r% rX r( rF rd r; r@ rI r r r r r s s -
r c @ s> e Zd ZdZdZejZdZdd� Z dd� Z
dd � Z d
d � Z d S )
r zUDP server class.Fi c C s | j �| j�\}}|| j f|fS �N)r5 �recvfrom�max_packet_size)r$ �data� client_addrr r r r; � s zUDPServer.get_requestc C s d S ri r r' r r r r( � s zUDPServer.server_activatec C s | � |� d S ri rH rJ r r r r@ � s zUDPServer.shutdown_requestc C s d S ri r rJ r r r rI s zUDPServer.close_requestN)
rQ rR rS rT r[ r5 �
SOCK_DGRAMrW rk r; r( r@ rI r r r r r � s r c @ s< e Zd ZdZdZdZdZdd� Zdd� Zd d
� Z d d � Z
dS )
r z5Mix-in class to handle each request in a new process.i, N�( c C s� | j du rdS t| j �| jkrfzt�dd�\}}W n tjyJ d}Y n0 || j vrXq| j �|� q| j D ]�}zt�|tj�\}}W n tjy� d}Y n0 |s�qlz| j �|� W ql ty� } z"td|j || j f ��W Y d}~qld}~0 0 qldS )z7Internal routine to wait for children that have exited.Nr z%s. x=%d and list=%r)
�active_children�len� max_children�os�waitpidr< �remove�WNOHANG�
ValueError�message)r$ �pid�status�childr r r r �collect_children s(
�z ForkingMixIn.collect_childrenc C s | � � dS )znWait for zombies after self.timeout seconds of inactivity.
May be extended, do not override.
N�r| r' r r r r9 / s zForkingMixIn.handle_timeoutc C s | � � dS )z�Collect the zombie child processes regularly in the ForkingMixIn.
service_actions is called in the BaseServer's serve_forver loop.
Nr} r' r r r r- 6 s z ForkingMixIn.service_actionsc C s� t �� }|r6| jdu r g | _| j�|� | �|� dS z$| �||� | �|� t �d� W n> z$| �||� | �|� W t �d� n t �d� 0 Y n0 dS )z-Fork a new subprocess to process the request.Nr rZ ) rs �forkrp �appendrI rD r@ �_exitr? )r$ rB rC ry r r r r> = s
z ForkingMixIn.process_request) rQ rR rS rT r7 rp rr r| r9 r- r> r r r r r s r c @ s$ e Zd ZdZdZdd� Zdd� ZdS )r
z4Mix-in class to handle each request in a new thread.Fc C sB z| � ||� | �|� W n" | �||� | �|� Y n0 dS )zgSame as in BaseServer but as a thread.
In addition, exception handling is done here.
N)rD r@ r? rA r r r �process_request_thread] s z%ThreadingMixIn.process_request_threadc C s( t j| j||fd�}| j|_|�� dS )z*Start a new thread to process the request.)�targetr N)r �Threadr� �daemon_threads�daemon�start)r$ rB rC �tr r r r> j s
�z ThreadingMixIn.process_requestN)rQ rR rS rT r� r� r> r r r r r
V s
r
c @ s e Zd ZdS )r N�rQ rR rS r r r r r r � r c @ s e Zd ZdS )r Nr� r r r r r s r� r c @ s e Zd ZdS )r Nr� r r r r r u r� r c @ s e Zd ZdS )r Nr� r r r r r v r� r c @ s e Zd ZejZdS )r N�rQ rR rS r5 r rV r r r r r z s r c @ s e Zd ZejZdS )r Nr� r r r r r } s r c @ s e Zd ZdS )r Nr� r r r r r � r� r c @ s e Zd ZdS )r Nr� r r r r r � r� r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r
a� Base class for request handler classes.
This class is instantiated for each request to be handled. The
constructor sets the instance variables request, client_address
and server, and then calls the handle() method. To implement a
specific service, all you need to do is to derive a class which
defines a handle() method.
The handle() method can find the request as self.request, the
client address as self.client_address, and the server (in case it
needs access to per-server information) as self.server. Since a
separate instance is created for each request, the handle() method
can define arbitrary other instance variariables.
c C s> || _ || _|| _| �� z| �� W | �� n
| �� 0 d S ri )rB rC �server�setup�handle�finish)r$ rB rC r� r r r r% � s
zBaseRequestHandler.__init__c C s d S ri r r' r r r r� � s zBaseRequestHandler.setupc C s d S ri r r' r r r r� � s zBaseRequestHandler.handlec C s d S ri r r' r r r r� � s zBaseRequestHandler.finishN)rQ rR rS rT r% r� r� r� r r r r r
� s
r
c @ s0 e Zd ZdZdZdZdZdZdd� Zdd � Z dS )
r z4Define self.rfile and self.wfile for stream sockets.���r NFc C sb | j | _| jd ur | j�| j� | jr:| j�tjtjd� | j� d| j
�| _ | j� d| j �| _
d S )NT�rb�wb)rB �
connectionr7 �
settimeout�disable_nagle_algorithmr\ r5 � IPPROTO_TCP� TCP_NODELAY�makefile�rbufsize�rfile�wbufsize�wfiler' r r r r� � s
�zStreamRequestHandler.setupc C sD | j js,z| j �� W n tjy* Y n0 | j �� | j�� d S ri )r� �closed�flushr5 r< rc r� r' r r r r� � s
zStreamRequestHandler.finish)
rQ rR rS rT r� r� r7 r� r� r� r r r r r � s
r c @ s e Zd ZdZdd� Zdd� ZdS )r z6Define self.rfile and self.wfile for datagram sockets.c C s2 ddl m} | j\| _| _|| j�| _|� | _d S )Nr )�BytesIO)�ior� rB �packetr5 r� r� )r$ r� r r r r� � s z DatagramRequestHandler.setupc C s | j �| j�� | j� d S ri )r5 �sendtor� �getvaluerC r' r r r r� � s z DatagramRequestHandler.finishN)rQ rR rS rT r� r� r r r r r � s r )"rT �
__future__r r � __version__r5 r+ �sysrs r r � ImportErrorZdummy_threading�__all__�hasattr�extendr �objectr r r r r
r r r r r r r r r
r r r r r r �<module> sD
RzO .+PK �Cu\B��u�$ �$ 7 future/backports/__pycache__/_markupbase.cpython-39.pycnu �[��� a
��?hW? � @ sX d Z ddlZe�d�jZe�d�jZe�d�Ze�d�Ze�d�Z[G dd � d e �Z
dS )
a Shared support for scanning document type declarations in HTML and XHTML.
Backported for python-future from Python 3.3. Reason: ParserBase is an
old-style class in the Python 2.7 source of markupbase.py, which I suspect
might be the cause of sporadic unit-test failures on travis-ci.org with
test_htmlparser.py. The test failures look like this:
======================================================================
ERROR: test_attr_entity_replacement (future.tests.test_htmlparser.AttributesStrictTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 661, in test_attr_entity_replacement
[("starttag", "a", [("b", "&><"'")])])
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 93, in _run_check
collector = self.get_collector()
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 617, in get_collector
return EventCollector(strict=True)
File "/home/travis/build/edschofield/python-future/future/tests/test_htmlparser.py", line 27, in __init__
html.parser.HTMLParser.__init__(self, *args, **kw)
File "/home/travis/build/edschofield/python-future/future/backports/html/parser.py", line 135, in __init__
self.reset()
File "/home/travis/build/edschofield/python-future/future/backports/html/parser.py", line 143, in reset
_markupbase.ParserBase.reset(self)
TypeError: unbound method reset() must be called with ParserBase instance as first argument (got EventCollector instance instead)
This module is used as a foundation for the html.parser module. It has no
documented public API and should not be used directly.
� Nz[a-zA-Z][-_.a-zA-Z0-9]*\s*z(\'[^\']*\'|"[^"]*")\s*z--\s*>z ]\s*]\s*>z]\s*>c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd Z d
d� Z
d#dd�Z d$dd�Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"S )%�
ParserBaseziParser base class which provides some common support methods used
by the SGML/HTML and XHTML parsers.c C s | j tu rtd��d S )Nz)_markupbase.ParserBase must be subclassed)� __class__r � RuntimeError��self� r �F/usr/local/lib/python3.9/site-packages/future/backports/_markupbase.py�__init__6 s
�zParserBase.__init__c C s t d��d S )Nz.subclasses of ParserBase must override error())�NotImplementedError)r �messager r r �error; s �zParserBase.errorc C s d| _ d| _d S )N� r ��lineno�offsetr r r r �reset? s zParserBase.resetc C s | j | jfS )z&Return current line number and offset.r r r r r �getposC s zParserBase.getposc C sb ||kr |S | j }|�d||�}|rN| j| | _|�d||�}||d | _n| j| | | _|S )N�
r
)�rawdata�countr �rindexr )r �i�jr �nlines�posr r r � updateposK s zParserBase.updatepos� c
C s� | j }|d }|||� dks&J d��|||d � dkrB|d S |||d � dv rZdS t|�}|||d � dkr�| �|�S || d kr�| �|�S | �||�\}}|d
k r�|S |d kr�d | _||k �r�|| }|dk�r||d |� }|d k�r| �|� n
| �|� |d S |d
v �r<t||�}|�s2dS |� � }n�|dv �rX| �||�\} }n||| jv �rn|d }nf|d k�r�|d k�r�| �
|d |�}n,|t g d��v �r�| � d| � n
| � d� n| � d|| � |d
k r�|S q�dS )N� �<!z$unexpected call to parse_declarationr
�>)�-r ���z--�[r �doctyper z"'�4abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ)�attlist�linktype�link�elementz&unsupported '[' char in %s declarationz"unexpected '[' char in declarationz!unexpected %r char in declaration)
r �len�
parse_comment�parse_marked_section�
_scan_name�_decl_otherchars� handle_decl� unknown_decl�_declstringlit_match�end�_parse_doctype_subset�setr )
r r r r �n�decltype�c�data�m�namer r r �parse_declaration[ s\
�z ParserBase.parse_declarationr
c C s� | j }|||d � dks"J d��| �|d |�\}}|dk rB|S |tg d��v rdt�||d �}n<|tg d��v r�t�||d �}n| �d||d |� � |s�dS |r�|�d�}| �||d |� � |� d�S ) N� z<![z)unexpected call to parse_marked_section()r )�temp�cdata�ignore�include�rcdata)�if�else�endifz+unknown status keyword %r in marked sectionr! )
r r, r3 �_markedsectionclose�search�_msmarkedsectioncloser �startr/ r1 )r r �reportr �sectNamer �matchr r r r+ � s
z ParserBase.parse_marked_sectionc C sj | j }|||d � dkr$| �d� t�||d �}|s<dS |r`|�d�}| �||d |� � |�d�S )N� �<!--z"unexpected call to parse_comment()r! r )r r �
_commentcloserE rG �handle_commentr1 )r r rH r rJ r r r r r* � s
zParserBase.parse_commentc
C s2 | j }t|�}|}||k �r.|| }|dk�r8|||d � }|dkrJdS |dkrp| �||d � | �d| � |d |kr�dS |d |kr�dS |||d � dkr�| j|d d
�}|d k r|S q| �|d |�\}}|dkr�dS |tg d ��v�r| �||d � | �d | � t| d
| �} | ||�}|d k �r,|S q|dk�r�|d |k�rTdS | �|d |�\}}|d k �rv|S || dk�r,|d }q|dk�r�|d }||k �r�|| �� �r�|d }�q�||k �r�|| dk�r�|S | �||� | �d� ndS q|�� �r|d }q| �||� | �d| � qdS )N�<r r! r r
z*unexpected char in internal subset (in %r)rK rL r )rH )r% r( �entity�notationz)unknown declaration %r in internal subset�_parse_doctype_�%�;�]r z%unexpected char after internal subsetz%unexpected char %r in internal subset) r r) r r r* r, r3 �getattr�isspace)
r r � declstartposr r4 r r6 �sr9 �methr r r r2 � sp
�
z ParserBase._parse_doctype_subsetc C sF | � ||�\}}|dkr dS | j}d||d � v rB|�d|�d S dS )Nr! r r
)r, r �find)r r rX r9 r r r r r �_parse_doctype_element s z!ParserBase._parse_doctype_elementc C s� | j }| �||�\}}|||d � }|dkr2dS |dkrB|d S | �||�\}}|dk r^|S |||d � }|dkrzdS |dkr�d||d � v r�|�d|�d }ndS |||d � �� r�|d }q�||d � s�dS n| �||�\}}|||d � }|�sdS |dv �rDt||�}|�r&|�� }ndS |||d � }|�sDdS |d k�r�||d � d k�rddS | �|d |�\}}|dk �r�|S |||d � }|�s�dS |dkrB|d S qBd S )
Nr
r r! r r �(�)�'"�#)r r, r[ rW r0 r1 )r r rX r r9 r r6 r8 r r r �_parse_doctype_attlist sX
z!ParserBase._parse_doctype_attlistc C s� | � ||�\}}|dk r |S | j}|||d � }|s:dS |dkrJ|d S |dv rnt||�}|sddS |�� }q"| � ||�\}}|dk r"|S q"d S )Nr r
r! r r_ )r, r r0 r1 )r r rX r9 r r r6 r8 r r r �_parse_doctype_notationX s"
z"ParserBase._parse_doctype_notationc C s� | j }|||d � dkrR|d }|||d � }|s:dS |�� rP|d }q"qVq"n|}| �||�\}}|dk rr|S | j ||d � }|s�dS |dv r�t||�}|r�|�� }q�dS qr|dkr�|d S | �||�\}}|dk rr|S qrd S )Nr
rS r! r r_ r )r rW r, r0 r1 )r r rX r r r6 r9 r8 r r r �_parse_doctype_entityo s4
z ParserBase._parse_doctype_entityc C s� | j }t|�}||krdS t||�}|r\|�� }|�� }|t|� |krLdS |�� |�� fS | �||� | �d|||d � � d S )N)Nr! zexpected name token at %r� ) r r) �_declname_match�group�strip�lowerr1 r r )r r rX r r4 r8 rY r9 r r r r, � s
�zParserBase._scan_namec C s d S )Nr )r r7 r r r r/ � s zParserBase.unknown_declN)r
)r
)�__name__�
__module__� __qualname__�__doc__r r r r r r- r: r+ r* r2 r\ ra rb rc r, r/ r r r r r 2 s"
R
C 9$r ) rl �re�compilerJ re r0 rM rD rF �objectr r r r r �<module> s "
PK �Cu\��-L� � : future/backports/__pycache__/total_ordering.cpython-39.pycnu �[��� a
��?h� � @ s0 d Z ddlZejdkr$ddlmZ ndd� ZdS )z�
For Python < 2.7.2. total_ordering in versions prior to 2.7.2 is buggy.
See http://bugs.python.org/issue10042 for details. For these versions use
code borrowed from Python 2.7.3.
From django.utils.
� N)� � r )�total_orderingc C s� ddd� fddd� fddd� fgddd� fd d
d� fdd d� fgd d d� fdd
d� fddd� fgddd� fddd� fd dd� fgd�}t t| ��t |�@ }|s�td��t|�}|| D ]0\}}||vr�||_tt|�j|_t| ||� q�| S )z6Class decorator that fills in missing ordering methods�__gt__c S s | |k p| |k S �N� ��self�otherr r �I/usr/local/lib/python3.9/site-packages/future/backports/total_ordering.py�<lambda> � z total_ordering.<locals>.<lambda>�__le__c S s | |k p| |kS r r r r r r r r
�__ge__c S s
| |k S r r r r r r r r
c S s | |k p| |kS r r r r r r r r
�__lt__c S s | |ko| |k S r r r r r r r r
c S s
| |k S r r r r r r r r
c S s | |kp| |k S r r r r r r r r
c S s | |kp| |kS r r r r r r r r
c S s
| |k S r r r r r r r r
c S s | |k p| |kS r r r r r r r r
c S s | |ko| |k S r r r r r r r r
c S s
| |k S r r r r r r r r
)r r r r z6must define at least one ordering operation: < > <= >=) �set�dir�
ValueError�max�__name__�getattr�int�__doc__�setattr)�cls�convert�roots�root�opname�opfuncr r r r
s6
�
�
�
��r )r �sys� version_info� functoolsr r r r r �<module> s
PK �Cu\+&<<� � " future/backports/total_ordering.pynu �[��� """
For Python < 2.7.2. total_ordering in versions prior to 2.7.2 is buggy.
See http://bugs.python.org/issue10042 for details. For these versions use
code borrowed from Python 2.7.3.
From django.utils.
"""
import sys
if sys.version_info >= (2, 7, 2):
from functools import total_ordering
else:
def total_ordering(cls):
"""Class decorator that fills in missing ordering methods"""
convert = {
'__lt__': [('__gt__', lambda self, other: not (self < other or self == other)),
('__le__', lambda self, other: self < other or self == other),
('__ge__', lambda self, other: not self < other)],
'__le__': [('__ge__', lambda self, other: not self <= other or self == other),
('__lt__', lambda self, other: self <= other and not self == other),
('__gt__', lambda self, other: not self <= other)],
'__gt__': [('__lt__', lambda self, other: not (self > other or self == other)),
('__ge__', lambda self, other: self > other or self == other),
('__le__', lambda self, other: not self > other)],
'__ge__': [('__le__', lambda self, other: (not self >= other) or self == other),
('__gt__', lambda self, other: self >= other and not self == other),
('__lt__', lambda self, other: not self >= other)]
}
roots = set(dir(cls)) & set(convert)
if not roots:
raise ValueError('must define at least one ordering operation: < > <= >=')
root = max(roots) # prefer __lt__ to __le__ to __gt__ to __ge__
for opname, opfunc in convert[root]:
if opname not in roots:
opfunc.__name__ = opname
opfunc.__doc__ = getattr(int, opname).__doc__
setattr(cls, opname, opfunc)
return cls
PK �Cu\���J/� /� ! future/backports/xmlrpc/client.pynu �[��� #
# XML-RPC CLIENT LIBRARY
# $Id$
#
# an XML-RPC client interface for Python.
#
# the marshalling and response parser code can also be used to
# implement XML-RPC servers.
#
# Notes:
# this version is designed to work with Python 2.1 or newer.
#
# History:
# 1999-01-14 fl Created
# 1999-01-15 fl Changed dateTime to use localtime
# 1999-01-16 fl Added Binary/base64 element, default to RPC2 service
# 1999-01-19 fl Fixed array data element (from Skip Montanaro)
# 1999-01-21 fl Fixed dateTime constructor, etc.
# 1999-02-02 fl Added fault handling, handle empty sequences, etc.
# 1999-02-10 fl Fixed problem with empty responses (from Skip Montanaro)
# 1999-06-20 fl Speed improvements, pluggable parsers/transports (0.9.8)
# 2000-11-28 fl Changed boolean to check the truth value of its argument
# 2001-02-24 fl Added encoding/Unicode/SafeTransport patches
# 2001-02-26 fl Added compare support to wrappers (0.9.9/1.0b1)
# 2001-03-28 fl Make sure response tuple is a singleton
# 2001-03-29 fl Don't require empty params element (from Nicholas Riley)
# 2001-06-10 fl Folded in _xmlrpclib accelerator support (1.0b2)
# 2001-08-20 fl Base xmlrpclib.Error on built-in Exception (from Paul Prescod)
# 2001-09-03 fl Allow Transport subclass to override getparser
# 2001-09-10 fl Lazy import of urllib, cgi, xmllib (20x import speedup)
# 2001-10-01 fl Remove containers from memo cache when done with them
# 2001-10-01 fl Use faster escape method (80% dumps speedup)
# 2001-10-02 fl More dumps microtuning
# 2001-10-04 fl Make sure import expat gets a parser (from Guido van Rossum)
# 2001-10-10 sm Allow long ints to be passed as ints if they don't overflow
# 2001-10-17 sm Test for int and long overflow (allows use on 64-bit systems)
# 2001-11-12 fl Use repr() to marshal doubles (from Paul Felix)
# 2002-03-17 fl Avoid buffered read when possible (from James Rucker)
# 2002-04-07 fl Added pythondoc comments
# 2002-04-16 fl Added __str__ methods to datetime/binary wrappers
# 2002-05-15 fl Added error constants (from Andrew Kuchling)
# 2002-06-27 fl Merged with Python CVS version
# 2002-10-22 fl Added basic authentication (based on code from Phillip Eby)
# 2003-01-22 sm Add support for the bool type
# 2003-02-27 gvr Remove apply calls
# 2003-04-24 sm Use cStringIO if available
# 2003-04-25 ak Add support for nil
# 2003-06-15 gn Add support for time.struct_time
# 2003-07-12 gp Correct marshalling of Faults
# 2003-10-31 mvl Add multicall support
# 2004-08-20 mvl Bump minimum supported Python version to 2.1
#
# Copyright (c) 1999-2002 by Secret Labs AB.
# Copyright (c) 1999-2002 by Fredrik Lundh.
#
# info@pythonware.com
# http://www.pythonware.com
#
# --------------------------------------------------------------------
# The XML-RPC client interface is
#
# Copyright (c) 1999-2002 by Secret Labs AB
# Copyright (c) 1999-2002 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
"""
Ported using Python-Future from the Python 3.3 standard library.
An XML-RPC client interface for Python.
The marshalling and response parser code can also be used to
implement XML-RPC servers.
Exported exceptions:
Error Base class for client errors
ProtocolError Indicates an HTTP protocol error
ResponseError Indicates a broken response package
Fault Indicates an XML-RPC fault package
Exported classes:
ServerProxy Represents a logical connection to an XML-RPC server
MultiCall Executor of boxcared xmlrpc requests
DateTime dateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate a "dateTime.iso8601"
XML-RPC value
Binary binary data wrapper
Marshaller Generate an XML-RPC params chunk from a Python data structure
Unmarshaller Unmarshal an XML-RPC response from incoming XML event message
Transport Handles an HTTP transaction to an XML-RPC server
SafeTransport Handles an HTTPS transaction to an XML-RPC server
Exported constants:
(none)
Exported functions:
getparser Create instance of the fastest available parser & attach
to an unmarshalling object
dumps Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
loads Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
"""
from __future__ import (absolute_import, division, print_function,
unicode_literals)
from future.builtins import bytes, dict, int, range, str
import base64
import sys
if sys.version_info < (3, 9):
# Py2.7 compatibility hack
base64.encodebytes = base64.encodestring
base64.decodebytes = base64.decodestring
import time
from datetime import datetime
from future.backports.http import client as http_client
from future.backports.urllib import parse as urllib_parse
from future.utils import ensure_new_type
from xml.parsers import expat
import socket
import errno
from io import BytesIO
try:
import gzip
except ImportError:
gzip = None #python can be built without zlib/gzip support
# --------------------------------------------------------------------
# Internal stuff
def escape(s):
s = s.replace("&", "&")
s = s.replace("<", "<")
return s.replace(">", ">",)
# used in User-Agent header sent
__version__ = sys.version[:3]
# xmlrpc integer limits
MAXINT = 2**31-1
MININT = -2**31
# --------------------------------------------------------------------
# Error constants (from Dan Libby's specification at
# http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php)
# Ranges of errors
PARSE_ERROR = -32700
SERVER_ERROR = -32600
APPLICATION_ERROR = -32500
SYSTEM_ERROR = -32400
TRANSPORT_ERROR = -32300
# Specific errors
NOT_WELLFORMED_ERROR = -32700
UNSUPPORTED_ENCODING = -32701
INVALID_ENCODING_CHAR = -32702
INVALID_XMLRPC = -32600
METHOD_NOT_FOUND = -32601
INVALID_METHOD_PARAMS = -32602
INTERNAL_ERROR = -32603
# --------------------------------------------------------------------
# Exceptions
##
# Base class for all kinds of client-side errors.
class Error(Exception):
"""Base class for client errors."""
def __str__(self):
return repr(self)
##
# Indicates an HTTP-level protocol error. This is raised by the HTTP
# transport layer, if the server returns an error code other than 200
# (OK).
#
# @param url The target URL.
# @param errcode The HTTP error code.
# @param errmsg The HTTP error message.
# @param headers The HTTP header dictionary.
class ProtocolError(Error):
"""Indicates an HTTP protocol error."""
def __init__(self, url, errcode, errmsg, headers):
Error.__init__(self)
self.url = url
self.errcode = errcode
self.errmsg = errmsg
self.headers = headers
def __repr__(self):
return (
"<ProtocolError for %s: %s %s>" %
(self.url, self.errcode, self.errmsg)
)
##
# Indicates a broken XML-RPC response package. This exception is
# raised by the unmarshalling layer, if the XML-RPC response is
# malformed.
class ResponseError(Error):
"""Indicates a broken response package."""
pass
##
# Indicates an XML-RPC fault response package. This exception is
# raised by the unmarshalling layer, if the XML-RPC response contains
# a fault string. This exception can also be used as a class, to
# generate a fault XML-RPC message.
#
# @param faultCode The XML-RPC fault code.
# @param faultString The XML-RPC fault string.
class Fault(Error):
"""Indicates an XML-RPC fault package."""
def __init__(self, faultCode, faultString, **extra):
Error.__init__(self)
self.faultCode = faultCode
self.faultString = faultString
def __repr__(self):
return "<Fault %s: %r>" % (ensure_new_type(self.faultCode),
ensure_new_type(self.faultString))
# --------------------------------------------------------------------
# Special values
##
# Backwards compatibility
boolean = Boolean = bool
##
# Wrapper for XML-RPC DateTime values. This converts a time value to
# the format used by XML-RPC.
# <p>
# The value can be given as a datetime object, as a string in the
# format "yyyymmddThh:mm:ss", as a 9-item time tuple (as returned by
# time.localtime()), or an integer value (as returned by time.time()).
# The wrapper uses time.localtime() to convert an integer to a time
# tuple.
#
# @param value The time, given as a datetime object, an ISO 8601 string,
# a time tuple, or an integer time value.
### For Python-Future:
def _iso8601_format(value):
return "%04d%02d%02dT%02d:%02d:%02d" % (
value.year, value.month, value.day,
value.hour, value.minute, value.second)
###
# Issue #13305: different format codes across platforms
# _day0 = datetime(1, 1, 1)
# if _day0.strftime('%Y') == '0001': # Mac OS X
# def _iso8601_format(value):
# return value.strftime("%Y%m%dT%H:%M:%S")
# elif _day0.strftime('%4Y') == '0001': # Linux
# def _iso8601_format(value):
# return value.strftime("%4Y%m%dT%H:%M:%S")
# else:
# def _iso8601_format(value):
# return value.strftime("%Y%m%dT%H:%M:%S").zfill(17)
# del _day0
def _strftime(value):
if isinstance(value, datetime):
return _iso8601_format(value)
if not isinstance(value, (tuple, time.struct_time)):
if value == 0:
value = time.time()
value = time.localtime(value)
return "%04d%02d%02dT%02d:%02d:%02d" % value[:6]
class DateTime(object):
"""DateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate 'dateTime.iso8601' XML-RPC
value.
"""
def __init__(self, value=0):
if isinstance(value, str):
self.value = value
else:
self.value = _strftime(value)
def make_comparable(self, other):
if isinstance(other, DateTime):
s = self.value
o = other.value
elif isinstance(other, datetime):
s = self.value
o = _iso8601_format(other)
elif isinstance(other, str):
s = self.value
o = other
elif hasattr(other, "timetuple"):
s = self.timetuple()
o = other.timetuple()
else:
otype = (hasattr(other, "__class__")
and other.__class__.__name__
or type(other))
raise TypeError("Can't compare %s and %s" %
(self.__class__.__name__, otype))
return s, o
def __lt__(self, other):
s, o = self.make_comparable(other)
return s < o
def __le__(self, other):
s, o = self.make_comparable(other)
return s <= o
def __gt__(self, other):
s, o = self.make_comparable(other)
return s > o
def __ge__(self, other):
s, o = self.make_comparable(other)
return s >= o
def __eq__(self, other):
s, o = self.make_comparable(other)
return s == o
def __ne__(self, other):
s, o = self.make_comparable(other)
return s != o
def timetuple(self):
return time.strptime(self.value, "%Y%m%dT%H:%M:%S")
##
# Get date/time value.
#
# @return Date/time value, as an ISO 8601 string.
def __str__(self):
return self.value
def __repr__(self):
return "<DateTime %r at %x>" % (ensure_new_type(self.value), id(self))
def decode(self, data):
self.value = str(data).strip()
def encode(self, out):
out.write("<value><dateTime.iso8601>")
out.write(self.value)
out.write("</dateTime.iso8601></value>\n")
def _datetime(data):
# decode xml element contents into a DateTime structure.
value = DateTime()
value.decode(data)
return value
def _datetime_type(data):
return datetime.strptime(data, "%Y%m%dT%H:%M:%S")
##
# Wrapper for binary data. This can be used to transport any kind
# of binary data over XML-RPC, using BASE64 encoding.
#
# @param data An 8-bit string containing arbitrary data.
class Binary(object):
"""Wrapper for binary data."""
def __init__(self, data=None):
if data is None:
data = b""
else:
if not isinstance(data, (bytes, bytearray)):
raise TypeError("expected bytes or bytearray, not %s" %
data.__class__.__name__)
data = bytes(data) # Make a copy of the bytes!
self.data = data
##
# Get buffer contents.
#
# @return Buffer contents, as an 8-bit string.
def __str__(self):
return str(self.data, "latin-1") # XXX encoding?!
def __eq__(self, other):
if isinstance(other, Binary):
other = other.data
return self.data == other
def __ne__(self, other):
if isinstance(other, Binary):
other = other.data
return self.data != other
def decode(self, data):
self.data = base64.decodebytes(data)
def encode(self, out):
out.write("<value><base64>\n")
encoded = base64.encodebytes(self.data)
out.write(encoded.decode('ascii'))
out.write("</base64></value>\n")
def _binary(data):
# decode xml element contents into a Binary structure
value = Binary()
value.decode(data)
return value
WRAPPERS = (DateTime, Binary)
# --------------------------------------------------------------------
# XML parsers
class ExpatParser(object):
# fast expat parser for Python 2.0 and later.
def __init__(self, target):
self._parser = parser = expat.ParserCreate(None, None)
self._target = target
parser.StartElementHandler = target.start
parser.EndElementHandler = target.end
parser.CharacterDataHandler = target.data
encoding = None
target.xml(encoding, None)
def feed(self, data):
self._parser.Parse(data, 0)
def close(self):
self._parser.Parse("", 1) # end of data
del self._target, self._parser # get rid of circular references
# --------------------------------------------------------------------
# XML-RPC marshalling and unmarshalling code
##
# XML-RPC marshaller.
#
# @param encoding Default encoding for 8-bit strings. The default
# value is None (interpreted as UTF-8).
# @see dumps
class Marshaller(object):
"""Generate an XML-RPC params chunk from a Python data structure.
Create a Marshaller instance for each set of parameters, and use
the "dumps" method to convert your data (represented as a tuple)
to an XML-RPC params chunk. To write a fault response, pass a
Fault instance instead. You may prefer to use the "dumps" module
function for this purpose.
"""
# by the way, if you don't understand what's going on in here,
# that's perfectly ok.
def __init__(self, encoding=None, allow_none=False):
self.memo = {}
self.data = None
self.encoding = encoding
self.allow_none = allow_none
dispatch = {}
def dumps(self, values):
out = []
write = out.append
dump = self.__dump
if isinstance(values, Fault):
# fault instance
write("<fault>\n")
dump({'faultCode': values.faultCode,
'faultString': values.faultString},
write)
write("</fault>\n")
else:
# parameter block
# FIXME: the xml-rpc specification allows us to leave out
# the entire <params> block if there are no parameters.
# however, changing this may break older code (including
# old versions of xmlrpclib.py), so this is better left as
# is for now. See @XMLRPC3 for more information. /F
write("<params>\n")
for v in values:
write("<param>\n")
dump(v, write)
write("</param>\n")
write("</params>\n")
result = "".join(out)
return str(result)
def __dump(self, value, write):
try:
f = self.dispatch[type(ensure_new_type(value))]
except KeyError:
# check if this object can be marshalled as a structure
if not hasattr(value, '__dict__'):
raise TypeError("cannot marshal %s objects" % type(value))
# check if this class is a sub-class of a basic type,
# because we don't know how to marshal these types
# (e.g. a string sub-class)
for type_ in type(value).__mro__:
if type_ in self.dispatch.keys():
raise TypeError("cannot marshal %s objects" % type(value))
# XXX(twouters): using "_arbitrary_instance" as key as a quick-fix
# for the p3yk merge, this should probably be fixed more neatly.
f = self.dispatch["_arbitrary_instance"]
f(self, value, write)
def dump_nil (self, value, write):
if not self.allow_none:
raise TypeError("cannot marshal None unless allow_none is enabled")
write("<value><nil/></value>")
dispatch[type(None)] = dump_nil
def dump_bool(self, value, write):
write("<value><boolean>")
write(value and "1" or "0")
write("</boolean></value>\n")
dispatch[bool] = dump_bool
def dump_long(self, value, write):
if value > MAXINT or value < MININT:
raise OverflowError("long int exceeds XML-RPC limits")
write("<value><int>")
write(str(int(value)))
write("</int></value>\n")
dispatch[int] = dump_long
# backward compatible
dump_int = dump_long
def dump_double(self, value, write):
write("<value><double>")
write(repr(ensure_new_type(value)))
write("</double></value>\n")
dispatch[float] = dump_double
def dump_unicode(self, value, write, escape=escape):
write("<value><string>")
write(escape(value))
write("</string></value>\n")
dispatch[str] = dump_unicode
def dump_bytes(self, value, write):
write("<value><base64>\n")
encoded = base64.encodebytes(value)
write(encoded.decode('ascii'))
write("</base64></value>\n")
dispatch[bytes] = dump_bytes
dispatch[bytearray] = dump_bytes
def dump_array(self, value, write):
i = id(value)
if i in self.memo:
raise TypeError("cannot marshal recursive sequences")
self.memo[i] = None
dump = self.__dump
write("<value><array><data>\n")
for v in value:
dump(v, write)
write("</data></array></value>\n")
del self.memo[i]
dispatch[tuple] = dump_array
dispatch[list] = dump_array
def dump_struct(self, value, write, escape=escape):
i = id(value)
if i in self.memo:
raise TypeError("cannot marshal recursive dictionaries")
self.memo[i] = None
dump = self.__dump
write("<value><struct>\n")
for k, v in value.items():
write("<member>\n")
if not isinstance(k, str):
raise TypeError("dictionary key must be string")
write("<name>%s</name>\n" % escape(k))
dump(v, write)
write("</member>\n")
write("</struct></value>\n")
del self.memo[i]
dispatch[dict] = dump_struct
def dump_datetime(self, value, write):
write("<value><dateTime.iso8601>")
write(_strftime(value))
write("</dateTime.iso8601></value>\n")
dispatch[datetime] = dump_datetime
def dump_instance(self, value, write):
# check for special wrappers
if value.__class__ in WRAPPERS:
self.write = write
value.encode(self)
del self.write
else:
# store instance attributes as a struct (really?)
self.dump_struct(value.__dict__, write)
dispatch[DateTime] = dump_instance
dispatch[Binary] = dump_instance
# XXX(twouters): using "_arbitrary_instance" as key as a quick-fix
# for the p3yk merge, this should probably be fixed more neatly.
dispatch["_arbitrary_instance"] = dump_instance
##
# XML-RPC unmarshaller.
#
# @see loads
class Unmarshaller(object):
"""Unmarshal an XML-RPC response, based on incoming XML event
messages (start, data, end). Call close() to get the resulting
data structure.
Note that this reader is fairly tolerant, and gladly accepts bogus
XML-RPC data without complaining (but not bogus XML).
"""
# and again, if you don't understand what's going on in here,
# that's perfectly ok.
def __init__(self, use_datetime=False, use_builtin_types=False):
self._type = None
self._stack = []
self._marks = []
self._data = []
self._methodname = None
self._encoding = "utf-8"
self.append = self._stack.append
self._use_datetime = use_builtin_types or use_datetime
self._use_bytes = use_builtin_types
def close(self):
# return response tuple and target method
if self._type is None or self._marks:
raise ResponseError()
if self._type == "fault":
raise Fault(**self._stack[0])
return tuple(self._stack)
def getmethodname(self):
return self._methodname
#
# event handlers
def xml(self, encoding, standalone):
self._encoding = encoding
# FIXME: assert standalone == 1 ???
def start(self, tag, attrs):
# prepare to handle this element
if tag == "array" or tag == "struct":
self._marks.append(len(self._stack))
self._data = []
self._value = (tag == "value")
def data(self, text):
self._data.append(text)
def end(self, tag):
# call the appropriate end tag handler
try:
f = self.dispatch[tag]
except KeyError:
pass # unknown tag ?
else:
return f(self, "".join(self._data))
#
# accelerator support
def end_dispatch(self, tag, data):
# dispatch data
try:
f = self.dispatch[tag]
except KeyError:
pass # unknown tag ?
else:
return f(self, data)
#
# element decoders
dispatch = {}
def end_nil (self, data):
self.append(None)
self._value = 0
dispatch["nil"] = end_nil
def end_boolean(self, data):
if data == "0":
self.append(False)
elif data == "1":
self.append(True)
else:
raise TypeError("bad boolean value")
self._value = 0
dispatch["boolean"] = end_boolean
def end_int(self, data):
self.append(int(data))
self._value = 0
dispatch["i4"] = end_int
dispatch["i8"] = end_int
dispatch["int"] = end_int
def end_double(self, data):
self.append(float(data))
self._value = 0
dispatch["double"] = end_double
def end_string(self, data):
if self._encoding:
data = data.decode(self._encoding)
self.append(data)
self._value = 0
dispatch["string"] = end_string
dispatch["name"] = end_string # struct keys are always strings
def end_array(self, data):
mark = self._marks.pop()
# map arrays to Python lists
self._stack[mark:] = [self._stack[mark:]]
self._value = 0
dispatch["array"] = end_array
def end_struct(self, data):
mark = self._marks.pop()
# map structs to Python dictionaries
dict = {}
items = self._stack[mark:]
for i in range(0, len(items), 2):
dict[items[i]] = items[i+1]
self._stack[mark:] = [dict]
self._value = 0
dispatch["struct"] = end_struct
def end_base64(self, data):
value = Binary()
value.decode(data.encode("ascii"))
if self._use_bytes:
value = value.data
self.append(value)
self._value = 0
dispatch["base64"] = end_base64
def end_dateTime(self, data):
value = DateTime()
value.decode(data)
if self._use_datetime:
value = _datetime_type(data)
self.append(value)
dispatch["dateTime.iso8601"] = end_dateTime
def end_value(self, data):
# if we stumble upon a value element with no internal
# elements, treat it as a string element
if self._value:
self.end_string(data)
dispatch["value"] = end_value
def end_params(self, data):
self._type = "params"
dispatch["params"] = end_params
def end_fault(self, data):
self._type = "fault"
dispatch["fault"] = end_fault
def end_methodName(self, data):
if self._encoding:
data = data.decode(self._encoding)
self._methodname = data
self._type = "methodName" # no params
dispatch["methodName"] = end_methodName
## Multicall support
#
class _MultiCallMethod(object):
# some lesser magic to store calls made to a MultiCall object
# for batch execution
def __init__(self, call_list, name):
self.__call_list = call_list
self.__name = name
def __getattr__(self, name):
return _MultiCallMethod(self.__call_list, "%s.%s" % (self.__name, name))
def __call__(self, *args):
self.__call_list.append((self.__name, args))
class MultiCallIterator(object):
"""Iterates over the results of a multicall. Exceptions are
raised in response to xmlrpc faults."""
def __init__(self, results):
self.results = results
def __getitem__(self, i):
item = self.results[i]
if isinstance(type(item), dict):
raise Fault(item['faultCode'], item['faultString'])
elif type(item) == type([]):
return item[0]
else:
raise ValueError("unexpected type in multicall result")
class MultiCall(object):
"""server -> a object used to boxcar method calls
server should be a ServerProxy object.
Methods can be added to the MultiCall using normal
method call syntax e.g.:
multicall = MultiCall(server_proxy)
multicall.add(2,3)
multicall.get_address("Guido")
To execute the multicall, call the MultiCall object e.g.:
add_result, address = multicall()
"""
def __init__(self, server):
self.__server = server
self.__call_list = []
def __repr__(self):
return "<MultiCall at %x>" % id(self)
__str__ = __repr__
def __getattr__(self, name):
return _MultiCallMethod(self.__call_list, name)
def __call__(self):
marshalled_list = []
for name, args in self.__call_list:
marshalled_list.append({'methodName' : name, 'params' : args})
return MultiCallIterator(self.__server.system.multicall(marshalled_list))
# --------------------------------------------------------------------
# convenience functions
FastMarshaller = FastParser = FastUnmarshaller = None
##
# Create a parser object, and connect it to an unmarshalling instance.
# This function picks the fastest available XML parser.
#
# return A (parser, unmarshaller) tuple.
def getparser(use_datetime=False, use_builtin_types=False):
"""getparser() -> parser, unmarshaller
Create an instance of the fastest available parser, and attach it
to an unmarshalling object. Return both objects.
"""
if FastParser and FastUnmarshaller:
if use_builtin_types:
mkdatetime = _datetime_type
mkbytes = base64.decodebytes
elif use_datetime:
mkdatetime = _datetime_type
mkbytes = _binary
else:
mkdatetime = _datetime
mkbytes = _binary
target = FastUnmarshaller(True, False, mkbytes, mkdatetime, Fault)
parser = FastParser(target)
else:
target = Unmarshaller(use_datetime=use_datetime, use_builtin_types=use_builtin_types)
if FastParser:
parser = FastParser(target)
else:
parser = ExpatParser(target)
return parser, target
##
# Convert a Python tuple or a Fault instance to an XML-RPC packet.
#
# @def dumps(params, **options)
# @param params A tuple or Fault instance.
# @keyparam methodname If given, create a methodCall request for
# this method name.
# @keyparam methodresponse If given, create a methodResponse packet.
# If used with a tuple, the tuple must be a singleton (that is,
# it must contain exactly one element).
# @keyparam encoding The packet encoding.
# @return A string containing marshalled data.
def dumps(params, methodname=None, methodresponse=None, encoding=None,
allow_none=False):
"""data [,options] -> marshalled data
Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
In addition to the data object, the following options can be given
as keyword arguments:
methodname: the method name for a methodCall packet
methodresponse: true to create a methodResponse packet.
If this option is used with a tuple, the tuple must be
a singleton (i.e. it can contain only one element).
encoding: the packet encoding (default is UTF-8)
All byte strings in the data structure are assumed to use the
packet encoding. Unicode strings are automatically converted,
where necessary.
"""
assert isinstance(params, (tuple, Fault)), "argument must be tuple or Fault instance"
if isinstance(params, Fault):
methodresponse = 1
elif methodresponse and isinstance(params, tuple):
assert len(params) == 1, "response tuple must be a singleton"
if not encoding:
encoding = "utf-8"
if FastMarshaller:
m = FastMarshaller(encoding)
else:
m = Marshaller(encoding, allow_none)
data = m.dumps(params)
if encoding != "utf-8":
xmlheader = "<?xml version='1.0' encoding='%s'?>\n" % str(encoding)
else:
xmlheader = "<?xml version='1.0'?>\n" # utf-8 is default
# standard XML-RPC wrappings
if methodname:
# a method call
if not isinstance(methodname, str):
methodname = methodname.encode(encoding)
data = (
xmlheader,
"<methodCall>\n"
"<methodName>", methodname, "</methodName>\n",
data,
"</methodCall>\n"
)
elif methodresponse:
# a method response, or a fault structure
data = (
xmlheader,
"<methodResponse>\n",
data,
"</methodResponse>\n"
)
else:
return data # return as is
return str("").join(data)
##
# Convert an XML-RPC packet to a Python object. If the XML-RPC packet
# represents a fault condition, this function raises a Fault exception.
#
# @param data An XML-RPC packet, given as an 8-bit string.
# @return A tuple containing the unpacked data, and the method name
# (None if not present).
# @see Fault
def loads(data, use_datetime=False, use_builtin_types=False):
"""data -> unmarshalled data, method name
Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
If the XML-RPC packet represents a fault condition, this function
raises a Fault exception.
"""
p, u = getparser(use_datetime=use_datetime, use_builtin_types=use_builtin_types)
p.feed(data)
p.close()
return u.close(), u.getmethodname()
##
# Encode a string using the gzip content encoding such as specified by the
# Content-Encoding: gzip
# in the HTTP header, as described in RFC 1952
#
# @param data the unencoded data
# @return the encoded data
def gzip_encode(data):
"""data -> gzip encoded data
Encode data using the gzip content encoding as described in RFC 1952
"""
if not gzip:
raise NotImplementedError
f = BytesIO()
gzf = gzip.GzipFile(mode="wb", fileobj=f, compresslevel=1)
gzf.write(data)
gzf.close()
encoded = f.getvalue()
f.close()
return encoded
##
# Decode a string using the gzip content encoding such as specified by the
# Content-Encoding: gzip
# in the HTTP header, as described in RFC 1952
#
# @param data The encoded data
# @return the unencoded data
# @raises ValueError if data is not correctly coded.
def gzip_decode(data):
"""gzip encoded data -> unencoded data
Decode data using the gzip content encoding as described in RFC 1952
"""
if not gzip:
raise NotImplementedError
f = BytesIO(data)
gzf = gzip.GzipFile(mode="rb", fileobj=f)
try:
decoded = gzf.read()
except IOError:
raise ValueError("invalid data")
f.close()
gzf.close()
return decoded
##
# Return a decoded file-like object for the gzip encoding
# as described in RFC 1952.
#
# @param response A stream supporting a read() method
# @return a file-like object that the decoded data can be read() from
class GzipDecodedResponse(gzip.GzipFile if gzip else object):
"""a file-like object to decode a response encoded with the gzip
method, as described in RFC 1952.
"""
def __init__(self, response):
#response doesn't support tell() and read(), required by
#GzipFile
if not gzip:
raise NotImplementedError
self.io = BytesIO(response.read())
gzip.GzipFile.__init__(self, mode="rb", fileobj=self.io)
def close(self):
gzip.GzipFile.close(self)
self.io.close()
# --------------------------------------------------------------------
# request dispatcher
class _Method(object):
# some magic to bind an XML-RPC method to an RPC server.
# supports "nested" methods (e.g. examples.getStateName)
def __init__(self, send, name):
self.__send = send
self.__name = name
def __getattr__(self, name):
return _Method(self.__send, "%s.%s" % (self.__name, name))
def __call__(self, *args):
return self.__send(self.__name, args)
##
# Standard transport class for XML-RPC over HTTP.
# <p>
# You can create custom transports by subclassing this method, and
# overriding selected methods.
class Transport(object):
"""Handles an HTTP transaction to an XML-RPC server."""
# client identifier (may be overridden)
user_agent = "Python-xmlrpc/%s" % __version__
#if true, we'll request gzip encoding
accept_gzip_encoding = True
# if positive, encode request using gzip if it exceeds this threshold
# note that many server will get confused, so only use it if you know
# that they can decode such a request
encode_threshold = None #None = don't encode
def __init__(self, use_datetime=False, use_builtin_types=False):
self._use_datetime = use_datetime
self._use_builtin_types = use_builtin_types
self._connection = (None, None)
self._extra_headers = []
##
# Send a complete request, and parse the response.
# Retry request if a cached connection has disconnected.
#
# @param host Target host.
# @param handler Target PRC handler.
# @param request_body XML-RPC request body.
# @param verbose Debugging flag.
# @return Parsed response.
def request(self, host, handler, request_body, verbose=False):
#retry request once if cached connection has gone cold
for i in (0, 1):
try:
return self.single_request(host, handler, request_body, verbose)
except socket.error as e:
if i or e.errno not in (errno.ECONNRESET, errno.ECONNABORTED, errno.EPIPE):
raise
except http_client.BadStatusLine: #close after we sent request
if i:
raise
def single_request(self, host, handler, request_body, verbose=False):
# issue XML-RPC request
try:
http_conn = self.send_request(host, handler, request_body, verbose)
resp = http_conn.getresponse()
if resp.status == 200:
self.verbose = verbose
return self.parse_response(resp)
except Fault:
raise
except Exception:
#All unexpected errors leave connection in
# a strange state, so we clear it.
self.close()
raise
#We got an error response.
#Discard any response data and raise exception
if resp.getheader("content-length", ""):
resp.read()
raise ProtocolError(
host + handler,
resp.status, resp.reason,
dict(resp.getheaders())
)
##
# Create parser.
#
# @return A 2-tuple containing a parser and a unmarshaller.
def getparser(self):
# get parser and unmarshaller
return getparser(use_datetime=self._use_datetime,
use_builtin_types=self._use_builtin_types)
##
# Get authorization info from host parameter
# Host may be a string, or a (host, x509-dict) tuple; if a string,
# it is checked for a "user:pw@host" format, and a "Basic
# Authentication" header is added if appropriate.
#
# @param host Host descriptor (URL or (URL, x509 info) tuple).
# @return A 3-tuple containing (actual host, extra headers,
# x509 info). The header and x509 fields may be None.
def get_host_info(self, host):
x509 = {}
if isinstance(host, tuple):
host, x509 = host
auth, host = urllib_parse.splituser(host)
if auth:
auth = urllib_parse.unquote_to_bytes(auth)
auth = base64.encodebytes(auth).decode("utf-8")
auth = "".join(auth.split()) # get rid of whitespace
extra_headers = [
("Authorization", "Basic " + auth)
]
else:
extra_headers = []
return host, extra_headers, x509
##
# Connect to server.
#
# @param host Target host.
# @return An HTTPConnection object
def make_connection(self, host):
#return an existing connection if possible. This allows
#HTTP/1.1 keep-alive.
if self._connection and host == self._connection[0]:
return self._connection[1]
# create a HTTP connection object from a host descriptor
chost, self._extra_headers, x509 = self.get_host_info(host)
self._connection = host, http_client.HTTPConnection(chost)
return self._connection[1]
##
# Clear any cached connection object.
# Used in the event of socket errors.
#
def close(self):
if self._connection[1]:
self._connection[1].close()
self._connection = (None, None)
##
# Send HTTP request.
#
# @param host Host descriptor (URL or (URL, x509 info) tuple).
# @param handler Target RPC handler (a path relative to host)
# @param request_body The XML-RPC request body
# @param debug Enable debugging if debug is true.
# @return An HTTPConnection.
def send_request(self, host, handler, request_body, debug):
connection = self.make_connection(host)
headers = self._extra_headers[:]
if debug:
connection.set_debuglevel(1)
if self.accept_gzip_encoding and gzip:
connection.putrequest("POST", handler, skip_accept_encoding=True)
headers.append(("Accept-Encoding", "gzip"))
else:
connection.putrequest("POST", handler)
headers.append(("Content-Type", "text/xml"))
headers.append(("User-Agent", self.user_agent))
self.send_headers(connection, headers)
self.send_content(connection, request_body)
return connection
##
# Send request headers.
# This function provides a useful hook for subclassing
#
# @param connection httpConnection.
# @param headers list of key,value pairs for HTTP headers
def send_headers(self, connection, headers):
for key, val in headers:
connection.putheader(key, val)
##
# Send request body.
# This function provides a useful hook for subclassing
#
# @param connection httpConnection.
# @param request_body XML-RPC request body.
def send_content(self, connection, request_body):
#optionally encode the request
if (self.encode_threshold is not None and
self.encode_threshold < len(request_body) and
gzip):
connection.putheader("Content-Encoding", "gzip")
request_body = gzip_encode(request_body)
connection.putheader("Content-Length", str(len(request_body)))
connection.endheaders(request_body)
##
# Parse response.
#
# @param file Stream.
# @return Response tuple and target method.
def parse_response(self, response):
# read response data from httpresponse, and parse it
# Check for new http response object, otherwise it is a file object.
if hasattr(response, 'getheader'):
if response.getheader("Content-Encoding", "") == "gzip":
stream = GzipDecodedResponse(response)
else:
stream = response
else:
stream = response
p, u = self.getparser()
while 1:
data = stream.read(1024)
if not data:
break
if self.verbose:
print("body:", repr(data))
p.feed(data)
if stream is not response:
stream.close()
p.close()
return u.close()
##
# Standard transport class for XML-RPC over HTTPS.
class SafeTransport(Transport):
"""Handles an HTTPS transaction to an XML-RPC server."""
# FIXME: mostly untested
def make_connection(self, host):
if self._connection and host == self._connection[0]:
return self._connection[1]
if not hasattr(http_client, "HTTPSConnection"):
raise NotImplementedError(
"your version of http.client doesn't support HTTPS")
# create a HTTPS connection object from a host descriptor
# host may be a string, or a (host, x509-dict) tuple
chost, self._extra_headers, x509 = self.get_host_info(host)
self._connection = host, http_client.HTTPSConnection(chost,
None, **(x509 or {}))
return self._connection[1]
##
# Standard server proxy. This class establishes a virtual connection
# to an XML-RPC server.
# <p>
# This class is available as ServerProxy and Server. New code should
# use ServerProxy, to avoid confusion.
#
# @def ServerProxy(uri, **options)
# @param uri The connection point on the server.
# @keyparam transport A transport factory, compatible with the
# standard transport class.
# @keyparam encoding The default encoding used for 8-bit strings
# (default is UTF-8).
# @keyparam verbose Use a true value to enable debugging output.
# (printed to standard output).
# @see Transport
class ServerProxy(object):
"""uri [,options] -> a logical connection to an XML-RPC server
uri is the connection point on the server, given as
scheme://host/target.
The standard implementation always supports the "http" scheme. If
SSL socket support is available (Python 2.0), it also supports
"https".
If the target part and the slash preceding it are both omitted,
"/RPC2" is assumed.
The following options can be given as keyword arguments:
transport: a transport factory
encoding: the request encoding (default is UTF-8)
All 8-bit strings passed to the server proxy are assumed to use
the given encoding.
"""
def __init__(self, uri, transport=None, encoding=None, verbose=False,
allow_none=False, use_datetime=False, use_builtin_types=False):
# establish a "logical" server connection
# get the url
type, uri = urllib_parse.splittype(uri)
if type not in ("http", "https"):
raise IOError("unsupported XML-RPC protocol")
self.__host, self.__handler = urllib_parse.splithost(uri)
if not self.__handler:
self.__handler = "/RPC2"
if transport is None:
if type == "https":
handler = SafeTransport
else:
handler = Transport
transport = handler(use_datetime=use_datetime,
use_builtin_types=use_builtin_types)
self.__transport = transport
self.__encoding = encoding or 'utf-8'
self.__verbose = verbose
self.__allow_none = allow_none
def __close(self):
self.__transport.close()
def __request(self, methodname, params):
# call a method on the remote server
request = dumps(params, methodname, encoding=self.__encoding,
allow_none=self.__allow_none).encode(self.__encoding)
response = self.__transport.request(
self.__host,
self.__handler,
request,
verbose=self.__verbose
)
if len(response) == 1:
response = response[0]
return response
def __repr__(self):
return (
"<ServerProxy for %s%s>" %
(self.__host, self.__handler)
)
__str__ = __repr__
def __getattr__(self, name):
# magic method dispatcher
return _Method(self.__request, name)
# note: to call a remote object with an non-standard name, use
# result getattr(server, "strange-python-name")(args)
def __call__(self, attr):
"""A workaround to get special attributes on the ServerProxy
without interfering with the magic __getattr__
"""
if attr == "close":
return self.__close
elif attr == "transport":
return self.__transport
raise AttributeError("Attribute %r not found" % (attr,))
# compatibility
Server = ServerProxy
# --------------------------------------------------------------------
# test code
if __name__ == "__main__":
# simple test program (from the XML-RPC specification)
# local server, available from Lib/xmlrpc/server.py
server = ServerProxy("http://localhost:8000")
try:
print(server.currentTime.getCurrentTime())
except Error as v:
print("ERROR", v)
multi = MultiCall(server)
multi.getData()
multi.pow(2,9)
multi.add(1,2)
try:
for response in multi():
print(response)
except Error as v:
print("ERROR", v)
PK �Cu\���I& & # future/backports/xmlrpc/__init__.pynu �[��� # This directory is a Python package.
PK �Cu\���C� � ; future/backports/xmlrpc/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h& � @ s d S )N� r r r �J/usr/local/lib/python3.9/site-packages/future/backports/xmlrpc/__init__.py�<module> � PK �Cu\>�D�� � 9 future/backports/xmlrpc/__pycache__/client.cpython-39.pycnu �[��� a
��?h/� �
@ s� d Z ddlmZmZmZmZ ddlmZmZm Z m
Z
m Z ddl Z ddl
Z
e
jdk rbe je _e je _ddlZddlmZ ddlmZ ddlmZ dd lm Z dd
l m Z ddl Z ddl Z dd l!m"Z" z ddl#Z#W n e$y� dZ#Y n0 d d
� Z%e
j&dd� Z'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0dZ1dZ2dZ3dZ4dZ5G dd � d e6�Z7G d d � d e7�Z8G d d � d e7�Z9G d!d"� d"e7�Z:e; Z<Z=d#d$� Z>d%d&� Z?G d'd(� d(e@�ZAd)d*� ZBd+d,� ZCG d-d.� d.e@�ZDd/d0� ZEeAeDfZFG d1d2� d2e@�ZGG d3d4� d4e@�ZHG d5d6� d6e@�ZIG d7d8� d8e@�ZJG d9d:� d:e@�ZKG d;d<� d<e@�ZLd ZM ZNZOdXd>d?�ZPdYd@dA�ZQdZdBdC�ZRdDdE� ZSdFdG� ZTG dHdI� dIe#�r|e#jUne@�ZVG dJdK� dKe@�ZWG dLdM� dMe@�ZXG dNdO� dOeX�ZYG dPdQ� dQe@�ZZeZZ[e\dRk�r�eZdS�Z]ze^e]j_�`� � W n0 e7�y Za ze^dTea� W Y dZa[an
dZa[a0 0 eLe]�Zbeb�c� eb�ddUdV� eb�edWdU� zeb� D ]Zfe^ef� �qLW n0 e7�y� Za ze^dTea� W Y dZa[an
dZa[a0 0 dS )[a�
Ported using Python-Future from the Python 3.3 standard library.
An XML-RPC client interface for Python.
The marshalling and response parser code can also be used to
implement XML-RPC servers.
Exported exceptions:
Error Base class for client errors
ProtocolError Indicates an HTTP protocol error
ResponseError Indicates a broken response package
Fault Indicates an XML-RPC fault package
Exported classes:
ServerProxy Represents a logical connection to an XML-RPC server
MultiCall Executor of boxcared xmlrpc requests
DateTime dateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate a "dateTime.iso8601"
XML-RPC value
Binary binary data wrapper
Marshaller Generate an XML-RPC params chunk from a Python data structure
Unmarshaller Unmarshal an XML-RPC response from incoming XML event message
Transport Handles an HTTP transaction to an XML-RPC server
SafeTransport Handles an HTTPS transaction to an XML-RPC server
Exported constants:
(none)
Exported functions:
getparser Create instance of the fastest available parser & attach
to an unmarshalling object
dumps Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
loads Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
� )�absolute_import�division�print_function�unicode_literals)�bytes�dict�int�range�strN)� � )�datetime)�client)�parse)�ensure_new_type)�expat)�BytesIOc C s$ | � dd�} | � dd�} | � dd�S )N�&z&�<z<�>z>)�replace)�s� r �H/usr/local/lib/python3.9/site-packages/future/backports/xmlrpc/client.py�escape� s r r i���i �iD���i����i ���ip���iԁ��iC���iB���i����i����i����c @ s e Zd ZdZdd� ZdS )�Errorz Base class for client errors.c C s t | �S �N)�repr��selfr r r �__str__� s z
Error.__str__N)�__name__�
__module__� __qualname__�__doc__r r r r r r � s r c @ s e Zd ZdZdd� Zdd� ZdS )�
ProtocolErrorz!Indicates an HTTP protocol error.c C s& t �| � || _|| _|| _|| _d S r )r �__init__�url�errcode�errmsg�headers)r r' r( r) r* r r r r& � s
zProtocolError.__init__c C s d| j | j| jf S )Nz <ProtocolError for %s: %s %s>)r' r( r) r r r r �__repr__� s ��zProtocolError.__repr__N�r! r" r# r$ r& r+ r r r r r% � s r% c @ s e Zd ZdZdS )�
ResponseErrorz$Indicates a broken response package.N)r! r" r# r$ r r r r r- � s r- c @ s e Zd ZdZdd� Zdd� ZdS )�Faultz#Indicates an XML-RPC fault package.c K s t �| � || _|| _d S r )r r& � faultCode� faultString)r r/ r0 �extrar r r r& � s
zFault.__init__c C s dt | j�t | j�f S )Nz<Fault %s: %r>)r r/ r0 r r r r r+ � s
�zFault.__repr__Nr, r r r r r. � s r. c C s d| j | j| j| j| j| jf S )N�%04d%02d%02dT%02d:%02d:%02d)�year�month�day�hour�minute�second��valuer r r �_iso8601_format s �r; c C sL t | t�rt| �S t | ttjf�s<| dkr2t�� } t�| �} d| d d� S )Nr r2 � )�
isinstancer
r; �tuple�time� struct_time� localtimer9 r r r � _strftime( s
rB c @ sz e Zd ZdZd dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd S ) �DateTimez�DateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate 'dateTime.iso8601' XML-RPC
value.
r c C s t |t�r|| _n
t|�| _d S r )r= r
r: rB )r r: r r r r& 9 s
zDateTime.__init__c C s� t |t�r| j}|j}nzt |t�r2| j}t|�}n`t |t�rH| j}|}nJt|d�rd| �� }|�� }n.t|d�rv|jj p|t
|�}t d| jj |f ��||fS )N� timetuple� __class__zCan't compare %s and %s) r= rC r: r
r; r
�hasattrrD rE r! �type� TypeError)r �otherr �oZotyper r r �make_comparable? s*
��
�zDateTime.make_comparablec C s | � |�\}}||k S r �rK �r rI r rJ r r r �__lt__T s zDateTime.__lt__c C s | � |�\}}||kS r rL rM r r r �__le__X s zDateTime.__le__c C s | � |�\}}||kS r rL rM r r r �__gt__\ s zDateTime.__gt__c C s | � |�\}}||kS r rL rM r r r �__ge__` s zDateTime.__ge__c C s | � |�\}}||kS r rL rM r r r �__eq__d s zDateTime.__eq__c C s | � |�\}}||kS r rL rM r r r �__ne__h s zDateTime.__ne__c C s t �| jd�S �Nz%Y%m%dT%H:%M:%S)r? �strptimer: r r r r rD l s zDateTime.timetuplec C s | j S r r9 r r r r r t s zDateTime.__str__c C s dt | j�t| �f S )Nz<DateTime %r at %x>)r r: �idr r r r r+ w s zDateTime.__repr__c C s t |��� | _d S r )r
�stripr: �r �datar r r �decodez s zDateTime.decodec C s$ |� d� |� | j� |� d� d S �Nz<value><dateTime.iso8601>z </dateTime.iso8601></value>
)�writer: )r �outr r r �encode} s
zDateTime.encodeN)r )r! r" r# r$ r& rK rN rO rP rQ rR rS rD r r+ rZ r^ r r r r rC 3 s
rC c C s t � }|�| � |S r )rC rZ �rY r: r r r � _datetime� s
r` c C s t �| d�S rT )r
rU )rY r r r �_datetime_type� s ra c @ sB e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dS )�BinaryzWrapper for binary data.Nc C s> |d u rd}n&t |ttf�s,td|jj ��t|�}|| _d S )N� z#expected bytes or bytearray, not %s)r= r � bytearrayrH rE r! rY rX r r r r& � s �zBinary.__init__c C s t | jd�S )Nzlatin-1)r
rY r r r r r � s zBinary.__str__c C s t |t�r|j}| j|kS r �r= rb rY �r rI r r r rR � s
z
Binary.__eq__c C s t |t�r|j}| j|kS r re rf r r r rS � s
z
Binary.__ne__c C s t �|�| _d S r )�base64� decodebytesrY rX r r r rZ � s z
Binary.decodec C s4 |� d� t�| j�}|� |�d�� |� d� d S �Nz<value><base64>
�asciiz</base64></value>
)r\ rg � encodebytesrY rZ )r r] �encodedr r r r^ � s
z
Binary.encode)N)
r! r" r# r$ r& r rR rS rZ r^ r r r r rb � s
rb c C s t � }|�| � |S r )rb rZ r_ r r r �_binary� s
rm c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ExpatParserc C sD t �d d � | _}|| _|j|_|j|_|j|_ d }|�
|d � d S r ) r � ParserCreate�_parser�_target�start�StartElementHandler�end�EndElementHandlerrY �CharacterDataHandler�xml)r �target�parser�encodingr r r r& � s zExpatParser.__init__c C s | j �|d� d S �Nr )rp �ParserX r r r �feed� s zExpatParser.feedc C s | j �dd� | `| ` d S )N� � )rp r| rq r r r r �close� s zExpatParser.closeN)r! r" r# r& r} r� r r r r rn � s rn c @ s� e Zd ZdZd dd�Zi Zdd� Zdd � Zd
d � Zeee d�< d d
� Z
e
ee < dd� Z e ee
< e Zdd� Zeee< efdd�Zeee< dd� Zeee< eee< dd� Zeee< eee< efdd�Zeee< dd� Z e ee < d d � Z e ee < e ee < e ed < dS ) �
Marshallerav Generate an XML-RPC params chunk from a Python data structure.
Create a Marshaller instance for each set of parameters, and use
the "dumps" method to convert your data (represented as a tuple)
to an XML-RPC params chunk. To write a fault response, pass a
Fault instance instead. You may prefer to use the "dumps" module
function for this purpose.
NFc C s i | _ d | _|| _|| _d S r )�memorY rz �
allow_none)r rz r� r r r r& � s zMarshaller.__init__c C s� g }|j }| j}t|t�r@|d� ||j|jd�|� |d� n4|d� |D ] }|d� |||� |d� qL|d� d�|�}t|�S ) Nz<fault>
)r/ r0 z </fault>
z <params>
z<param>
z </param>
z
</params>
r~ )�append�_Marshaller__dumpr= r. r/ r0 �joinr
)r �valuesr] r\ �dump�v�resultr r r �dumps� s&
��
zMarshaller.dumpsc C s� z| j tt|�� }W nd tyz t|d�s>tdt|� ��t|�jD ]"}|| j �� v rHtdt|� ��qH| j d }Y n0 || ||� d S )N�__dict__zcannot marshal %s objects�_arbitrary_instance)�dispatchrG r �KeyErrorrF rH �__mro__�keys)r r: r\ �f�type_r r r �__dump s
zMarshaller.__dumpc C s | j std��|d� d S )Nz0cannot marshal None unless allow_none is enabledz<value><nil/></value>)r� rH �r r: r\ r r r �dump_nil" s zMarshaller.dump_nilc C s$ |d� ||rdpd� |d� d S )Nz<value><boolean>�1�0z</boolean></value>
r r� r r r � dump_bool( s zMarshaller.dump_boolc C s< |t ks|tk rtd��|d� |tt|��� |d� d S )Nz long int exceeds XML-RPC limitsz <value><int>z</int></value>
)�MAXINT�MININT�
OverflowErrorr
r r� r r r � dump_long. s
zMarshaller.dump_longc C s$ |d� |t t|��� |d� d S )Nz<value><double>z</double></value>
)r r r� r r r � dump_double9 s zMarshaller.dump_doublec C s |d� |||�� |d� d S )Nz<value><string>z</string></value>
r )r r: r\ r r r r � dump_unicode? s zMarshaller.dump_unicodec C s, |d� t �|�}||�d�� |d� d S ri )rg rk rZ )r r: r\ rl r r r �
dump_bytesE s
zMarshaller.dump_bytesc C sZ t |�}|| jv rtd��d | j|< | j}|d� |D ]}|||� q6|d� | j|= d S )Nz"cannot marshal recursive sequencesz<value><array><data>
z</data></array></value>
)rV r� rH r� )r r: r\ �ir� r� r r r �
dump_arrayM s
zMarshaller.dump_arrayc C s� t |�}|| jv rtd��d | j|< | j}|d� |�� D ]D\}}|d� t|t�s\td��|d||� � |||� |d� q:|d� | j|= d S )Nz%cannot marshal recursive dictionariesz<value><struct>
z <member>
z dictionary key must be stringz<name>%s</name>
z
</member>
z</struct></value>
)rV r� rH r� �itemsr= r
)r r: r\ r r� r� �kr� r r r � dump_struct[ s
zMarshaller.dump_structc C s |d� |t |�� |d� d S r[ )rB r� r r r �
dump_datetimem s zMarshaller.dump_datetimec C s2 |j tv r || _|�| � | `n| �|j|� d S r )rE �WRAPPERSr\ r^ r� r� r� r r r �
dump_instances s
zMarshaller.dump_instancer� )NF)!r! r" r# r$ r& r� r� r� r� rG r� �boolr� r �dump_intr� �floatr r� r
r� r rd r� r> �listr� r r� r
r� rC rb r r r r r� � s<
r� c @ s> e Zd ZdZd>dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z i Z dd� Z
e
e d< dd� Zee d< dd� Zee d< ee d < ee d < d d � Zee d < d!d"� Zee d#< ee d$< d%d&� Zee d'< d(d)� Zee d*< d+d,� Zee d-< d.d/� Zee d0< d1d2� Zee d3< d4d5� Zee d6< d7d8� Zee d9< d:d;� Zee d<< d=S )?� Unmarshallera Unmarshal an XML-RPC response, based on incoming XML event
messages (start, data, end). Call close() to get the resulting
data structure.
Note that this reader is fairly tolerant, and gladly accepts bogus
XML-RPC data without complaining (but not bogus XML).
Fc C sB d | _ g | _g | _g | _d | _d| _| jj| _|p4|| _|| _d S )N�utf-8) �_type�_stack�_marks�_data� _methodname� _encodingr� �
_use_datetime�
_use_bytes�r � use_datetime�use_builtin_typesr r r r& � s
zUnmarshaller.__init__c C s> | j d u s| jrt� �| j dkr4tf i | jd ���t| j�S )N�faultr )r� r� r- r. r� r> r r r r r� � s
zUnmarshaller.closec C s | j S r )r� r r r r �
getmethodname� s zUnmarshaller.getmethodnamec C s
|| _ d S r )r� )r rz �
standaloner r r rw � s zUnmarshaller.xmlc C s6 |dks|dkr"| j �t| j�� g | _|dk| _d S )N�array�structr: )r� r� �lenr� r� �_value)r �tag�attrsr r r rr � s zUnmarshaller.startc C s | j �|� d S r )r� r� )r �textr r r rY � s zUnmarshaller.datac C s8 z| j | }W n ty Y n0 || d�| j��S d S )Nr~ )r� r� r� r� )r r� r� r r r rt � s
zUnmarshaller.endc C s0 z| j | }W n ty Y n 0 || |�S d S r )r� r� )r r� rY r� r r r � end_dispatch� s
zUnmarshaller.end_dispatchc C s | � d � d| _d S r{ )r� r� rX r r r �end_nil� s
zUnmarshaller.end_nil�nilc C s: |dkr| � d� n |dkr(| � d� ntd��d| _d S )Nr� Fr� Tzbad boolean valuer )r� rH r� rX r r r � end_boolean� s zUnmarshaller.end_boolean�booleanc C s | � t|�� d| _d S r{ )r� r r� rX r r r �end_int� s zUnmarshaller.end_int�i4�i8r c C s | � t|�� d| _d S r{ )r� r� r� rX r r r �
end_double� s zUnmarshaller.end_double�doublec C s& | j r|�| j �}| �|� d| _d S r{ )r� rZ r� r� rX r r r �
end_string� s
zUnmarshaller.end_string�string�namec C s. | j �� }| j|d � g| j|d �< d| _d S r{ )r� �popr� r� )r rY �markr r r � end_array� s
zUnmarshaller.end_arrayr� c C s` | j �� }i }| j|d � }tdt|�d�D ]}||d ||| < q,|g| j|d �< d| _d S )Nr � r )r� r� r� r r� r� )r rY r� r r� r� r r r �
end_struct� s
zUnmarshaller.end_structr� c C s6 t � }|�|�d�� | jr"|j}| �|� d| _d S )Nrj r )rb rZ r^ r� rY r� r� �r rY r: r r r �
end_base64 s
zUnmarshaller.end_base64rg c C s, t � }|�|� | jr t|�}| �|� d S r )rC rZ r� ra r� r� r r r � end_dateTime s
zUnmarshaller.end_dateTimezdateTime.iso8601c C s | j r| �|� d S r )r� r� rX r r r � end_value s zUnmarshaller.end_valuer: c C s
d| _ d S )N�params�r� rX r r r �
end_params! s zUnmarshaller.end_paramsr� c C s
d| _ d S )Nr� r� rX r r r � end_fault% s zUnmarshaller.end_faultr� c C s" | j r|�| j �}|| _d| _d S )N�
methodName)r� rZ r� r� rX r r r �end_methodName) s zUnmarshaller.end_methodNamer� N)FF)r! r" r# r$ r& r� r� rw rr rY rt r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r� � sN
r� c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�_MultiCallMethodc C s || _ || _d S r )�_MultiCallMethod__call_list�_MultiCallMethod__name)r � call_listr� r r r r& 6 s z_MultiCallMethod.__init__c C s t | jd| j|f �S �Nz%s.%s)r� r� r� �r r� r r r � __getattr__9 s z _MultiCallMethod.__getattr__c G s | j �| j|f� d S r )r� r� r� �r �argsr r r �__call__; s z_MultiCallMethod.__call__N�r! r" r# r& r� r� r r r r r� 3 s r� c @ s e Zd ZdZdd� Zdd� ZdS )�MultiCallIteratorzaIterates over the results of a multicall. Exceptions are
raised in response to xmlrpc faults.c C s
|| _ d S r )�results)r r� r r r r& B s zMultiCallIterator.__init__c C sP | j | }tt|�t�r,t|d |d ��n t|�tg �krD|d S td��d S )Nr/ r0 r z#unexpected type in multicall result)r� r= rG r r. �
ValueError)r r� �itemr r r � __getitem__E s
z MultiCallIterator.__getitem__N)r! r" r# r$ r& r� r r r r r� > s r� c @ s4 e Zd ZdZdd� Zdd� ZeZdd� Zdd � Zd
S ) � MultiCalla} server -> a object used to boxcar method calls
server should be a ServerProxy object.
Methods can be added to the MultiCall using normal
method call syntax e.g.:
multicall = MultiCall(server_proxy)
multicall.add(2,3)
multicall.get_address("Guido")
To execute the multicall, call the MultiCall object e.g.:
add_result, address = multicall()
c C s || _ g | _d S r )�_MultiCall__server�_MultiCall__call_list)r �serverr r r r& _ s zMultiCall.__init__c C s dt | � S )Nz<MultiCall at %x>)rV r r r r r+ c s zMultiCall.__repr__c C s t | j|�S r )r� r� r� r r r r� h s zMultiCall.__getattr__c C s6 g }| j D ]\}}|�||d�� q
t| jj�|��S )N)r� r� )r� r� r� r� �system� multicall)r �marshalled_listr� r� r r r r� k s zMultiCall.__call__N) r! r" r# r$ r& r+ r r� r� r r r r r� N s r� Fc C sr t rHtrH|rt}tj}n| r&t}t}nt}t}tdd||t�}t |�}n"t| |d�}t rbt |�}nt |�}||fS )z�getparser() -> parser, unmarshaller
Create an instance of the fastest available parser, and attach it
to an unmarshalling object. Return both objects.
TF�r� r� )
�
FastParser�FastUnmarshallerra rg rh rm r` r. r� rn )r� r� �
mkdatetime�mkbytesrx ry r r r � getparser} s
r� c C s� t | ttf�sJ d��t | t�r&d}n"|rHt | t�rHt| �dksHJ d��|sPd}tr^t|�}n
t||�}|�| �}|dkr�dt|� }nd}|r�t |t�s�|�|�}|d|d|d f}n|r�|d
|d f}n|S td �� |�S )
a� data [,options] -> marshalled data
Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
In addition to the data object, the following options can be given
as keyword arguments:
methodname: the method name for a methodCall packet
methodresponse: true to create a methodResponse packet.
If this option is used with a tuple, the tuple must be
a singleton (i.e. it can contain only one element).
encoding: the packet encoding (default is UTF-8)
All byte strings in the data structure are assumed to use the
packet encoding. Unicode strings are automatically converted,
where necessary.
z(argument must be tuple or Fault instancer z"response tuple must be a singletonr� z$<?xml version='1.0' encoding='%s'?>
z<?xml version='1.0'?>
z<methodCall>
<methodName>z</methodName>
z</methodCall>
z<methodResponse>
z</methodResponse>
r~ )
r= r> r. r� �FastMarshallerr� r� r
r^ r� )r� �
methodname�methodresponserz r� �mrY � xmlheaderr r r r� � s>
��r� c C s2 t ||d�\}}|�| � |�� |�� |�� fS )z�data -> unmarshalled data, method name
Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
If the XML-RPC packet represents a fault condition, this function
raises a Fault exception.
r� )r� r} r� r� )rY r� r� �p�ur r r �loads� s
r c C sD t st�t� }t jd|dd�}|�| � |�� |�� }|�� |S )zhdata -> gzip encoded data
Encode data using the gzip content encoding as described in RFC 1952
�wbr )�mode�fileobj�
compresslevel)�gzip�NotImplementedErrorr �GzipFiler\ r� �getvalue)rY r� �gzfrl r r r � gzip_encode s
r c C sZ t st�t| �}t jd|d�}z |�� }W n tyD td��Y n0 |�� |�� |S )zrgzip encoded data -> unencoded data
Decode data using the gzip content encoding as described in RFC 1952
�rb�r r z invalid data)r r
r r �read�IOErrorr� r� )rY r� r
�decodedr r r � gzip_decode s r c @ s e Zd ZdZdd� Zdd� ZdS )�GzipDecodedResponsezha file-like object to decode a response encoded with the gzip
method, as described in RFC 1952.
c C s. t st�t|�� �| _t jj| d| jd� d S )Nr r )r r
r r �ior r& )r �responser r r r& ; s z GzipDecodedResponse.__init__c C s t j�| � | j�� d S r )r r r� r r r r r r� C s zGzipDecodedResponse.closeN)r! r" r# r$ r& r� r r r r r 7 s r c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�_Methodc C s || _ || _d S r ��
_Method__send�
_Method__name)r �sendr� r r r r& N s z_Method.__init__c C s t | jd| j|f �S r� )r r r r� r r r r� Q s z_Method.__getattr__c G s | � | j|�S r r r� r r r r� S s z_Method.__call__Nr� r r r r r K s r c @ s~ e Zd ZdZde ZdZdZd dd�Zd dd �Z d d
d �Z
d d
� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zdd� ZdS ) � Transportz1Handles an HTTP transaction to an XML-RPC server.zPython-xmlrpc/%sTNFc C s || _ || _d| _g | _d S )N�NN)r� �_use_builtin_types� _connection�_extra_headersr� r r r r& j s zTransport.__init__c C s� dD ]v}z| � ||||�W S tjy` } z(|sJ|jtjtjtjfvrL� W Y d }~qd }~0 tjyx |rt� Y q0 qd S )N)r r ) �single_request�socket�error�errno�
ECONNRESET� ECONNABORTED�EPIPE� http_client�
BadStatusLine)r �host�handler� request_body�verboser� �er r r �requestz s zTransport.requestc C s� z8| � ||||�}|�� }|jdkr6|| _| �|�W S W n. tyL � Y n tyf | �� � Y n0 |�dd�r||� � t
|| |j|j t |�
� ���d S )N�� zcontent-lengthr~ )� send_request� getresponse�statusr. �parse_responser. � Exceptionr� � getheaderr r% �reasonr �
getheaders)r r+ r, r- r. � http_conn�respr r r r" � s$
�zTransport.single_requestc C s t | j| jd�S )Nr� )r� r� r r r r r r� � s �zTransport.getparserc C sn i }t |t�r|\}}t�|�\}}|r`t�|�}t�|��d�}d�|� � �}dd| fg}ng }|||fS )Nr� r~ �
AuthorizationzBasic )
r= r> � urllib_parse� splituser�unquote_to_bytesrg rk rZ r� �split)r r+ �x509�auth�
extra_headersr r r �
get_host_info� s
�zTransport.get_host_infoc C sJ | j r || j d kr | j d S | �|�\}| _}|t�|�f| _ | j d S )Nr r )r rD r! r) �HTTPConnection�r r+ �chostrA r r r �make_connection� s
zTransport.make_connectionc C s" | j d r | j d �� d| _ d S )Nr r )r r� r r r r r� � s
zTransport.closec C s� | � |�}| jd d � }|r&|�d� | jrLtrL|jd|dd� |�d� n |�d|� |�d� |�d| jf� | �||� | � ||� |S )Nr �POSTT)�skip_accept_encoding)zAccept-Encodingr )z Content-Typeztext/xmlz
User-Agent)
rH r! �set_debuglevel�accept_gzip_encodingr �
putrequestr� �
user_agent� send_headers� send_content)r r+ r, r- �debug�
connectionr* r r r r2 � s
zTransport.send_requestc C s |D ]\}}|� ||� qd S r )� putheader)r rR r* �key�valr r r rO s zTransport.send_headersc C sR | j d ur0| j t|�k r0tr0|�dd� t|�}|�dtt|��� |�|� d S )N�Content-Encodingr zContent-Length)�encode_thresholdr� r rS r r
�
endheaders)r rR r- r r r rP s
�� zTransport.send_contentc C s� t |d�r*|�dd�dkr$t|�}q.|}n|}| �� \}}|�d�}|sJqj| jr^tdt|�� |�|� q:||urz|� � |� � |� � S )Nr7 rV r~ r i zbody:)
rF r7 r r� r r. �printr r} r� )r r �streamr r rY r r r r5 s
zTransport.parse_response)FF)F)F)r! r" r# r$ � __version__rN rL rW r& r0 r" r� rD rH r� r2 rO rP r5 r r r r r \ s
! r c @ s e Zd ZdZdd� ZdS )�
SafeTransportz2Handles an HTTPS transaction to an XML-RPC server.c C sj | j r || j d kr | j d S ttd�s0td��| �|�\}| _}|tj|d fi |pVi ��f| _ | j d S )Nr r �HTTPSConnectionz1your version of http.client doesn't support HTTPS)r rF r) r
rD r! r] rF r r r rH B s
���
z SafeTransport.make_connectionN)r! r" r# r$ rH r r r r r\ = s r\ c @ sF e Zd ZdZddd�Zdd� Zdd � Zd
d � ZeZd d
� Z dd� Z
dS )� ServerProxya� uri [,options] -> a logical connection to an XML-RPC server
uri is the connection point on the server, given as
scheme://host/target.
The standard implementation always supports the "http" scheme. If
SSL socket support is available (Python 2.0), it also supports
"https".
If the target part and the slash preceding it are both omitted,
"/RPC2" is assumed.
The following options can be given as keyword arguments:
transport: a transport factory
encoding: the request encoding (default is UTF-8)
All 8-bit strings passed to the server proxy are assumed to use
the given encoding.
NFc
C s� t �|�\}}|dvr td��t �|�\| _| _| js<d| _|d u rb|dkrRt} nt} | ||d�}|| _|pnd| _ || _
|| _ d S )N)�http�httpsz unsupported XML-RPC protocolz/RPC2r` r� r� ) r= � splittyper � splithost�_ServerProxy__host�_ServerProxy__handlerr\ r �_ServerProxy__transport�_ServerProxy__encoding�_ServerProxy__verbose�_ServerProxy__allow_none)
r �uri� transportrz r. r� r� r� rG r, r r r r& w s" �
zServerProxy.__init__c C s | j �� d S r )re r� r r r r �__close� s zServerProxy.__closec C sN t ||| j| jd��| j�}| jj| j| j|| jd�}t |�dkrJ|d }|S )N)rz r� )r. r r )
r� rf rh r^ re r0 rc rd rg r� )r r� r� r0 r r r r � __request� s
��� zServerProxy.__requestc C s d| j | jf S )Nz<ServerProxy for %s%s>)rc rd r r r r r+ � s
��zServerProxy.__repr__c C s t | j|�S r )r �_ServerProxy__requestr� r r r r� � s zServerProxy.__getattr__c C s. |dkr| j S |dkr | jS td|f ��dS )z|A workaround to get special attributes on the ServerProxy
without interfering with the magic __getattr__
r� rj zAttribute %r not foundN)�_ServerProxy__closere �AttributeError)r �attrr r r r� � s
zServerProxy.__call__)NNFFFF) r! r" r# r$ r& rn rm r+ r r� r� r r r r r^ a s �
r^ �__main__zhttp://localhost:8000�ERRORr� r r )FF)NNNF)FF)gr$ �
__future__r r r r Zfuture.builtinsr r r r r
rg �sys� version_info� encodestringrk � decodestringrh r? r
Zfuture.backports.httpr r) Zfuture.backports.urllibr r= Z future.utilsr Z xml.parsersr r# r% r r r � ImportErrorr �versionr[ r� r� � PARSE_ERROR� SERVER_ERROR�APPLICATION_ERROR� SYSTEM_ERROR�TRANSPORT_ERROR�NOT_WELLFORMED_ERROR�UNSUPPORTED_ENCODING�INVALID_ENCODING_CHAR�INVALID_XMLRPC�METHOD_NOT_FOUND�INVALID_METHOD_PARAMS�INTERNAL_ERRORr6 r r% r- r. r� r� �Booleanr; rB �objectrC r` ra rb rm r� rn r� r� r� r� r� r� r� r� r� r� r r r r r r r r\ r^ �Serverr! r� rY � currentTimeZgetCurrentTimer� ZmultiZgetData�pow�addr r r r r �<module>X s� ,
O ( ( - '
' �
M
b$_
PK �Cu\���t �t 9 future/backports/xmlrpc/__pycache__/server.cpython-39.pycnu �[��� a
��?h�� � @ s2 d Z ddlmZmZmZmZ ddlmZmZ ddl m
Z
m Z m Z m
Z
mZ ddlmZ ddlm m mZ ddlmZ ddlZddlZddlZddlZddlZddl Z z ddl Z W n e y� dZ Y n0 d,d d
�Z d d � Z G d
d� de!�Z"G dd� de�Z#G dd� dej$e"�Z%G dd� de%�Z&G dd� de"�Z'G dd� dej(�Z)G dd� de!�Z*G dd � d e#�Z+G d d � d e%e*�Z,G d d � d e'e*�Z-e.d!k�r.ddl/Z/G d"d#� d#�Z0e%d$�Ze�1e2� e�1d%d&� d'� ej3e0� dd(� e�4� e5d)� e5d*� z e�6� W n. e7�y, e5d+� e�8� e�9d� Y n0 dS )-aK
Ported using Python-Future from the Python 3.3 standard library.
XML-RPC Servers.
This module can be used to create simple XML-RPC servers
by creating a server and either installing functions, a
class instance, or by extending the SimpleXMLRPCServer
class.
It can also be used to handle XML-RPC requests in a CGI
environment using CGIXMLRPCRequestHandler.
The Doc* classes can be used to create XML-RPC servers that
serve pydoc-style documentation in response to HTTP
GET requests. This documentation is dynamically generated
based on the functions and methods registered with the
server.
A list of possible usage patterns follows:
1. Install functions:
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_function(pow)
server.register_function(lambda x,y: x+y, 'add')
server.serve_forever()
2. Install an instance:
class MyFuncs:
def __init__(self):
# make all of the sys functions available through sys.func_name
import sys
self.sys = sys
def _listMethods(self):
# implement this method so that system.listMethods
# knows to advertise the sys methods
return list_public_methods(self) + \
['sys.' + method for method in list_public_methods(self.sys)]
def pow(self, x, y): return pow(x, y)
def add(self, x, y) : return x + y
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_introspection_functions()
server.register_instance(MyFuncs())
server.serve_forever()
3. Install an instance with custom dispatch method:
class Math:
def _listMethods(self):
# this method must be present for system.listMethods
# to work
return ['add', 'pow']
def _methodHelp(self, method):
# this method must be present for system.methodHelp
# to work
if method == 'add':
return "add(2,3) => 5"
elif method == 'pow':
return "pow(x, y[, z]) => number"
else:
# By convention, return empty
# string if no help is available
return ""
def _dispatch(self, method, params):
if method == 'pow':
return pow(*params)
elif method == 'add':
return params[0] + params[1]
else:
raise ValueError('bad method')
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_introspection_functions()
server.register_instance(Math())
server.serve_forever()
4. Subclass SimpleXMLRPCServer:
class MathServer(SimpleXMLRPCServer):
def _dispatch(self, method, params):
try:
# We are forcing the 'export_' prefix on methods that are
# callable through XML-RPC to prevent potential security
# problems
func = getattr(self, 'export_' + method)
except AttributeError:
raise Exception('method "%s" is not supported' % method)
else:
return func(*params)
def export_add(self, x, y):
return x + y
server = MathServer(("localhost", 8000))
server.serve_forever()
5. CGI script:
server = CGIXMLRPCRequestHandler()
server.register_function(pow)
server.handle_request()
� )�absolute_import�division�print_function�unicode_literals)�int�str)�Fault�dumps�loads� gzip_encode� gzip_decode)�BaseHTTPRequestHandlerN)� socketserverTc C sF |r|� d�}n|g}|D ]&}|�d�r6td| ��qt| |�} q| S )aG resolve_dotted_attribute(a, 'b.c.d') => a.b.c.d
Resolves a dotted attribute name to an object. Raises
an AttributeError if any attribute in the chain starts with a '_'.
If the optional allow_dotted_names argument is false, dots are not
supported and this function operates similar to getattr(obj, attr).
�.�_z(attempt to access private attribute "%s")�split�
startswith�AttributeError�getattr)�obj�attr�allow_dotted_names�attrs�i� r �H/usr/local/lib/python3.9/site-packages/future/backports/xmlrpc/server.py�resolve_dotted_attribute� s
� r c s � fdd�t � �D �S )zkReturns a list of attribute strings, found in the specified
object, which represent callable attributesc s( g | ] }|� d �stt� |��r|�qS )r )r �callabler )�.0�member�r r r �
<listcomp>� s
�z'list_public_methods.<locals>.<listcomp>)�dirr r r r �list_public_methods� s r# c @ sp e Zd ZdZddd�Zddd�Zd dd �Zd
d � Zd d
� Zd dd�Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS ) �SimpleXMLRPCDispatchera& Mix-in class that dispatches XML-RPC requests.
This class is used to register XML-RPC method handlers
and then to dispatch them. This class doesn't need to be
instanced directly when used by SimpleXMLRPCServer but it
can be instanced when used by the MultiPathXMLRPCServer
FNc C s& i | _ d | _|| _|pd| _|| _d S �N�utf-8)�funcs�instance�
allow_none�encoding�use_builtin_types��selfr) r* r+ r r r �__init__� s
z SimpleXMLRPCDispatcher.__init__c C s || _ || _dS )a Registers an instance to respond to XML-RPC requests.
Only one instance can be installed at a time.
If the registered instance has a _dispatch method then that
method will be called with the name of the XML-RPC method and
its parameters as a tuple
e.g. instance._dispatch('add',(2,3))
If the registered instance does not have a _dispatch method
then the instance will be searched to find a matching method
and, if found, will be called. Methods beginning with an '_'
are considered private and will not be called by
SimpleXMLRPCServer.
If a registered function matches a XML-RPC request, then it
will be called instead of the registered instance.
If the optional allow_dotted_names argument is true and the
instance does not have a _dispatch method, method names
containing dots are supported and resolved, as long as none of
the name segments start with an '_'.
*** SECURITY WARNING: ***
Enabling the allow_dotted_names options allows intruders
to access your module's global variables and may allow
intruders to execute arbitrary code on your machine. Only
use this option on a secure, closed network.
N)r( r )r- r( r r r r �register_instance� s !z(SimpleXMLRPCDispatcher.register_instancec C s |du r|j }|| j|< dS )z�Registers a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
N)�__name__r' )r- �function�namer r r �register_function� s z(SimpleXMLRPCDispatcher.register_functionc C s | j �| j| j| jd�� dS )z�Registers the XML-RPC introspection methods in the system
namespace.
see http://xmlrpc.usefulinc.com/doc/reserved.html
)zsystem.listMethodszsystem.methodSignaturezsystem.methodHelpN)r' �update�system_listMethods�system_methodSignature�system_methodHelp�r- r r r � register_introspection_functions� s
�z7SimpleXMLRPCDispatcher.register_introspection_functionsc C s | j �d| ji� dS )z�Registers the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208zsystem.multicallN)r' r4 �system_multicallr8 r r r � register_multicall_functions� s z3SimpleXMLRPCDispatcher.register_multicall_functionsc
C s� zPt || jd�\}}|dur(|||�}n | �||�}|f}t|d| j| jd�}W nn ty� } z t|| j| jd�}W Y d}~nBd}~0 t�� \}} }
ttdd|| f �| j| jd�}Y n0 |� | j�S )a� Dispatches an XML-RPC method from marshalled (XML) data.
XML-RPC methods are dispatched from the marshalled (XML) data
using the _dispatch method and the result is returned as
marshalled data. For backwards compatibility, a dispatch
function can be provided as an argument (see comment in
SimpleXMLRPCRequestHandler.do_POST) but overriding the
existing method through subclassing is the preferred means
of changing method dispatch behavior.
)r+ N� )�methodresponser) r* )r) r* �%s:%s�r* r) )
r
r+ � _dispatchr r) r* r �sys�exc_info�encode) r- �data�dispatch_method�path�params�method�response�fault�exc_type� exc_value�exc_tbr r r �_marshaled_dispatch� s( �
�� z*SimpleXMLRPCDispatcher._marshaled_dispatchc C s^ t | j�� �}| jdurVt| jd�r8|t | j�� �O }n t| jd�sV|t t| j��O }t|�S )zwsystem.listMethods() => ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server.N� _listMethodsr@ )�setr' �keysr( �hasattrrO r# �sorted)r- �methodsr r r r5 s
z)SimpleXMLRPCDispatcher.system_listMethodsc C s dS )a# system.methodSignature('add') => [double, int, int]
Returns a list describing the signature of the method. In the
above example, the add method takes two integers as arguments
and returns a double result.
This server does NOT support system.methodSignature.zsignatures not supportedr )r- � method_namer r r r6 * s z-SimpleXMLRPCDispatcher.system_methodSignaturec C s� d}|| j v r| j | }nV| jdurpt| jd�r<| j�|�S t| jd�spzt| j|| j�}W n tyn Y n0 |du r|dS t�|�S dS )z�system.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method.N� _methodHelpr@ � ) r' r( rR rV r r r �pydoc�getdoc)r- rU rH r r r r7 7 s$
� z(SimpleXMLRPCDispatcher.system_methodHelpc
C s� g }|D ]�}|d }|d }z|� | �||�g� W q tyl } z |� |j|jd�� W Y d}~qd}~0 t�� \}}} |� dd||f d�� Y q0 q|S )z�system.multicall([{'methodName': 'add', 'params': [2, 2]}, ...]) => [[4], ...]
Allows the caller to package multiple XML-RPC calls into a single
request.
See http://www.xmlrpc.com/discuss/msgReader$1208
�
methodNamerG )� faultCode� faultStringNr< r> )�appendr@ r r[ r\ rA rB )
r- � call_list�results�callrU rG rJ rK rL rM r r r r: V s(
��
�� z'SimpleXMLRPCDispatcher.system_multicallc C s� d}z| j | }W nb tyt | jdurpt| jd�rH| j�||� Y S zt| j|| j�}W n tyn Y n0 Y n0 |dur�||� S td| ��dS )a� Dispatches the XML-RPC method.
XML-RPC calls are forwarded to a registered function that
matches the called XML-RPC method name. If no such function
exists then the call is forwarded to the registered instance,
if available.
If the registered instance has a _dispatch method then that
method will be called with the name of the XML-RPC method and
its parameters as a tuple
e.g. instance._dispatch('add',(2,3))
If the registered instance does not have a _dispatch method
then the instance will be searched to find a matching method
and, if found, will be called.
Methods beginning with an '_' are considered private and will
not be called.
Nr@ z method "%s" is not supported) r' �KeyErrorr( rR r@ r r r � Exception)r- rH rG �funcr r r r@ v s$
� z SimpleXMLRPCDispatcher._dispatch)FNF)F)N)NN)r0 �
__module__� __qualname__�__doc__r. r/ r3 r9 r; rN r5 r6 r7 r: r@ r r r r r$ � s �
$
%
r$ c @ sf e Zd ZdZdZdZdZdZe� dej
ej B �Z dd� Z
d d
� Zd d � Zd
d� Zdd� Zddd�ZdS )�SimpleXMLRPCRequestHandlerz�Simple XML-RPC request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
)�/z/RPC2ix ���Tz�
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
c C s^ i }| j �dd�}|�d�D ]<}| j�|�}|r |�d�}|rFt|�nd}|||�d�< q |S )NzAccept-EncodingrW �,� g �?r< )�headers�getr � aepattern�match�group�float)r- �rZae�ero �vr r r �accept_encodings� s
z+SimpleXMLRPCRequestHandler.accept_encodingsc C s | j r| j| j v S dS d S )NT)� rpc_pathsrF r8 r r r �is_rpc_path_valid� s z,SimpleXMLRPCRequestHandler.is_rpc_path_validc
C s� | � � s| �� dS z�d}t| jd �}g }|rht||�}| j�|�}|sLqh|�|� |t|d �8 }q,d� |�}| �
|�}|du r�W dS | j � |t
| dd�| j�}W n� t�y8 } zx| �d� t| j d��r| j j�r| �d t|�� t�� } t| �d
d �d
�} | �d | � | �d
d� | �� W Y d}~n�d}~0 0 | �d� | �dd� | jdu�r�t|�| jk�r�| �� �dd�}
|
�r�zt |�}| �dd� W n t �y� Y n0 | �d
tt|��� | �� | j � |� dS )z�Handles the HTTP POST request.
Attempts to interpret all HTTP POST requests as XML-RPC calls,
which are forwarded to the server's _dispatch method for handling.
Ni � zcontent-lengthri � r@ i� �_send_traceback_headerz X-exception�ASCII�backslashreplacez X-traceback�Content-length�0�� � Content-typeztext/xml�gzipr zContent-Encoding) rw �
report_404r rl �min�rfile�readr] �len�join�decode_request_content�serverrN r rF rb �
send_responserR ry � send_headerr � traceback�
format_excrC � end_headers�encode_thresholdru rm r �NotImplementedError�wfile�write) r- Zmax_chunk_sizeZsize_remaining�L�
chunk_size�chunkrD rI rs �trace�qr r r �do_POST� s\
�
�
z"SimpleXMLRPCRequestHandler.do_POSTc C s� | j �dd��� }|dkr |S |dkrrz
t|�W S tyR | �dd| � Y q� tyn | �dd� Y q�0 n| �dd| � | �dd � | �� d S )
Nzcontent-encoding�identityr� i� zencoding %r not supported� zerror decoding gzip contentr| r} ) rl rm �lowerr r� r� �
ValueErrorr� r� )r- rD r* r r r r� s
z1SimpleXMLRPCRequestHandler.decode_request_contentc C sF | � d� d}| �dd� | �dtt|��� | �� | j�|� d S )Ni� s No such pager z
text/plainr| )r� r� r r� r� r� r� �r- rI r r r r� ' s
z%SimpleXMLRPCRequestHandler.report_404�-c C s | j jrt�| ||� dS )z$Selectively log an accepted request.N)r� � logRequestsr
� log_request)r- �code�sizer r r r� 0 s z&SimpleXMLRPCRequestHandler.log_requestN)r� r� )r0 rd re rf rv r� �wbufsize�disable_nagle_algorithm�re�compile�VERBOSE�
IGNORECASErn ru rw r� r� r� r� r r r r rg � s
� G rg c @ s. e Zd ZdZdZdZedddddfdd�ZdS )�SimpleXMLRPCServerag Simple XML-RPC server.
Simple XML-RPC server that allows functions and a single instance
to be installed to handle requests. The default implementation
attempts to dispatch XML-RPC calls to the functions or instance
installed in the server. Override the _dispatch method inherited
from SimpleXMLRPCDispatcher to change this behavior.
TFNc C sn || _ t�| |||� tj�| |||� td urjttd�rjt�| �� tj�}|tj O }t�| �� tj
|� d S )N�
FD_CLOEXEC) r� r$ r. r � TCPServer�fcntlrR �filenoZF_GETFDr� ZF_SETFD) r- �addr�requestHandlerr� r) r* �bind_and_activater+ �flagsr r r r. I s
zSimpleXMLRPCServer.__init__)r0 rd re rf �allow_reuse_addressry rg r. r r r r r� 6 s �r� c @ s@ e Zd ZdZedddddfdd�Zdd� Zd d
� Zd
d d �ZdS )�MultiPathXMLRPCServera\ Multipath XML-RPC Server
This specialization of SimpleXMLRPCServer allows the user to create
multiple Dispatcher instances and assign them to different
HTTP request paths. This makes it possible to run two or more
'virtual XML-RPC servers' at the same port.
Make sure that the requestHandler accepts the paths in question.
TFNc
C s2 t �| |||||||� i | _|| _|p*d| _d S r% )r� r. � dispatchersr) r* �r- r� r� r� r) r* r� r+ r r r r. a s �z MultiPathXMLRPCServer.__init__c C s || j |< |S �N�r� )r- rF �
dispatcherr r r �add_dispatcherk s
z$MultiPathXMLRPCServer.add_dispatcherc C s
| j | S r� r� )r- rF r r r �get_dispatchero s z$MultiPathXMLRPCServer.get_dispatcherc C sj z| j | �|||�}W nL t�� d d� \}}ttdd||f �| j| jd�}|�| j�}Y n0 |S )N� r< r> r? ) r� rN rA rB r r r* r) rC )r- rD rE rF rI rK rL r r r rN r s
��z)MultiPathXMLRPCServer._marshaled_dispatch)NN) r0 rd re rf rg r. r� r� rN r r r r r� Y s �
r� c @ s4 e Zd ZdZd dd�Zdd� Zdd � Zd
d
d �ZdS )�CGIXMLRPCRequestHandlerz3Simple handler for XML-RPC data passed through CGI.FNc C s t �| |||� d S r� )r$ r. r, r r r r. � s z CGIXMLRPCRequestHandler.__init__c C sP | � |�}td� tdt|� � t� tj�� tjj�|� tjj�� dS )z Handle a single XML-RPC requestzContent-Type: text/xml�Content-Length: %dN)rN �printr� rA �stdout�flush�bufferr� )r- � request_textrI r r r �
handle_xmlrpc� s
z%CGIXMLRPCRequestHandler.handle_xmlrpcc C s� d}t j| \}}tj|||d� }|�d�}td||f � tdtj � tdt|� � t� tj �
� tj j � |� tj j �
� dS )z�Handle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
r� )r� �message�explainr& z
Status: %d %szContent-Type: %sr� N)
r
� responses� http_serverZDEFAULT_ERROR_MESSAGErC r� ZDEFAULT_ERROR_CONTENT_TYPEr� rA r� r� r� r� )r- r� r� r� rI r r r �
handle_get� s ��
z"CGIXMLRPCRequestHandler.handle_getc C sx |du r$t j�dd�dkr$| �� nPztt j�dd��}W n ttfyT d}Y n0 |du rjtj� |�}| �
|� dS )z�Handle a single XML-RPC request passed through a CGI post method.
If no XML data is given then it is read from stdin. The resulting
XML-RPC response is printed to stdout along with the correct HTTP
headers.
N�REQUEST_METHOD�GET�CONTENT_LENGTHri ) �os�environrm r� r r� � TypeErrorrA �stdinr� r� )r- r� �lengthr r r �handle_request� s �
z&CGIXMLRPCRequestHandler.handle_request)FNF)N)r0 rd re rf r. r� r� r� r r r r r� � s
r� c @ s> e Zd ZdZdi i i fdd�Zdi i i dfdd�Zdd� ZdS ) �
ServerHTMLDocz7Class used to generate pydoc HTML document for a serverNc C sZ |p| j }g }d}t�d�}|�||�} | s0�q:| �� \}
} |�||||
� �� | �� \} }
}}}}|
r�|| ��dd�}|�d||f � n�|r�dt|� }|�d||| �f � n~|r�dt|� }|�d||| �f � nV|| | d � d k�r |�| � ||||�� n(|�r"|�d
| � n|�| � ||�� | }q |�|||d � �� d �
|�S )
z�Mark up some plain text, given a context of symbols to look for.
Each context dictionary maps object names to anchor names.r zM\b((http|ftp)://\S+[\w/]|RFC[- ]?(\d+)|PEP[- ]?(\d+)|(self\.)?((?:\w|\.)+))\b�"z"z<a href="%s">%s</a>z'http://www.rfc-editor.org/rfc/rfc%d.txtz(http://www.python.org/dev/peps/pep-%04d/r< �(zself.<strong>%s</strong>NrW ) �escaper� r� �search�spanr] �groups�replacer Znamelinkr� )r- �textr� r' �classesrT r_ �here�patternro �start�end�all�schemeZrfcZpepZselfdotr2 �urlr r r �markup� s4
zServerHTMLDoc.markupc C s$ |r
|j p dd | }d} d| �|�| �|�f }
t�|�rrt�|�} tj| jdd� | j| j| j | j
| j d�} n<t� |�r�t�|�} tj| j| j| j| j | j
| j d�} nd} t
|t�r�|d p�| } |d p�d}
n
t�|�}
|
| | o�| �d | � }| �|
| j|||�}|�od
| }d ||f S ) z;Produce HTML documentation for a function or method object.rW r� z$<a name="%s"><strong>%s</strong></a>r< N)� annotations� formatvaluez(...)r z'<font face="helvetica, arial">%s</font>z<dd><tt>%s</tt></dd>z<dl><dt>%s</dt>%s</dl>
)r0 r� �inspect�ismethod�getfullargspec�
formatargspec�args�varargs�varkw�defaultsr� r� �
isfunction�
isinstance�tuplerX rY Zgreyr� � preformat)r- �objectr2 �modr' r� rT Zcl�anchorZnote�titler� Zargspec� docstring�decl�docr r r �
docroutine� sF �
�
�
� �zServerHTMLDoc.docroutinec C s� i }|� � D ] \}}d| ||< || ||< q | �|�}d| }| �|dd�}| �|| j|�} | ohd| } |d| }g }
t|� � �} | D ] \}}|
�| j|||d�� q�|| �ddd d
� |
�� }|S ) z1Produce HTML documentation for an XML-RPC server.z#-z)<big><big><strong>%s</strong></big></big>z#ffffffz#7799eez <tt>%s</tt>z
<p>%s</p>
)r' ZMethodsz#eeaa77rW )
�itemsr� �headingr� r� rS r] r� Z
bigsectionr� ) r- � server_nameZpackage_documentationrT Zfdict�key�value�head�resultr� �contentsZ method_itemsr r r � docserver s$
�zServerHTMLDoc.docserver)r0 rd re rf r� r� r r r r r r� � s )�
-r� c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�XMLRPCDocGeneratorz�Generates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
c C s d| _ d| _d| _d S )Nz XML-RPC Server DocumentationzGThis server exports the following methods through the XML-RPC protocol.)r� �server_documentation� server_titler8 r r r r. ? s �zXMLRPCDocGenerator.__init__c C s
|| _ dS )z8Set the HTML title of the generated server documentationN)r )r- r r r r �set_server_titleG s z#XMLRPCDocGenerator.set_server_titlec C s
|| _ dS )z7Set the name of the generated HTML server documentationN)r� )r- r� r r r �set_server_nameL s z"XMLRPCDocGenerator.set_server_namec C s
|| _ dS )z3Set the documentation string for the entire server.N)r )r- r r r r �set_server_documentationQ s z+XMLRPCDocGenerator.set_server_documentationc C s� i }| � � D ]�}|| jv r&| j| }n�| jdur�ddg}t| jd�rT| j�|�|d< t| jd�rp| j�|�|d< t|�}|dkr�|}q�t| jd�s�zt| j|�}W q� ty� |}Y q�0 q�|}n ds�J d��|||< q t � }|�
| j | j |�}|�
| j|�S ) a generate_html_documentation() => html documentation for the server
Generates HTML documentation for the server using introspection for
installed functions and instances that do not implement the
_dispatch method. Alternatively, instances can choose to implement
the _get_method_argstring(method_name) method to provide the
argument string used in the documentation and the
_methodHelp(method_name) method to provide the help text used
in the documentation.N�_get_method_argstringr rV r< )NNr@ zACould not find method in self.functions and no instance installed)r5 r' r( rR r rV r� r r r� r r� r �pager )r- rT rU rH Z method_infoZ
documenterZ
documentationr r r �generate_html_documentationV s>
�
�z.XMLRPCDocGenerator.generate_html_documentationN) r0 rd re rf r. r r r r
r r r r r 8 s r c @ s e Zd ZdZdd� ZdS )�DocXMLRPCRequestHandlerz�XML-RPC and documentation request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
Handles all HTTP GET requests and interprets them as requests
for documentation.
c C sf | � � s| �� dS | j�� �d�}| �d� | �dd� | �dtt|��� | � � | j
� |� dS )�}Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
Nr& r~ r z text/htmlr| ) rw r� r� r
rC r� r� r r� r� r� r� r� r r r �do_GET� s
z DocXMLRPCRequestHandler.do_GETN)r0 rd re rf r
r r r r r � s r c @ s& e Zd ZdZedddddfdd�ZdS )�DocXMLRPCServerz�XML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
TFNc
C s& t �| |||||||� t�| � d S r� )r� r. r r� r r r r. � s
�zDocXMLRPCServer.__init__)r0 rd re rf r r. r r r r r � s
�r c @ s e Zd ZdZdd� Zdd� ZdS )�DocCGIXMLRPCRequestHandlerzJHandler for XML-RPC data and documentation requests passed through
CGIc C sT | � � �d�}td� tdt|� � t� tj�� tjj�|� tjj�� dS )r r& zContent-Type: text/htmlr� N) r
rC r� r� rA r� r� r� r� r� r r r r� � s
z%DocCGIXMLRPCRequestHandler.handle_getc C s t �| � t�| � d S r� )r� r. r r8 r r r r. � s
z#DocCGIXMLRPCRequestHandler.__init__N)r0 rd re rf r� r. r r r r r � s r �__main__c @ s" e Zd Zdd� ZG dd� d�ZdS )�ExampleServicec C s dS )NZ42r r8 r r r �getData� s zExampleService.getDatac @ s e Zd Zedd� �ZdS )zExampleService.currentTimec C s
t j �� S r� )�datetime�nowr r r r �getCurrentTime� s z)ExampleService.currentTime.getCurrentTimeN)r0 rd re � staticmethodr r r r r � currentTime� s r N)r0 rd re r r r r r r r � s r )� localhosti@ c C s | | S r� r )�x�yr r r �<lambda>� rx r �add)r z&Serving XML-RPC on localhost port 8000zKIt is advisable to run this example server within a secure, closed network.z&
Keyboard interrupt received, exiting.)T):rf �
__future__r r r r Zfuture.builtinsr r Z future.backports.xmlrpc.clientr r r
r r Z future.backports.http.serverr
Z backports�httpr� r� Zfuture.backportsr rA r� r� rX r� r� r� � ImportErrorr r# r� r$ rg r� r� r� r� ZHTMLDocr� r r r r r0 r r r3 �powr/ r; r� �
serve_forever�KeyboardInterrupt� server_close�exitr r r r �<module> sj j
�#(ErQ � �
PK �Cu\ �_��� �� ! future/backports/xmlrpc/server.pynu �[��� r"""
Ported using Python-Future from the Python 3.3 standard library.
XML-RPC Servers.
This module can be used to create simple XML-RPC servers
by creating a server and either installing functions, a
class instance, or by extending the SimpleXMLRPCServer
class.
It can also be used to handle XML-RPC requests in a CGI
environment using CGIXMLRPCRequestHandler.
The Doc* classes can be used to create XML-RPC servers that
serve pydoc-style documentation in response to HTTP
GET requests. This documentation is dynamically generated
based on the functions and methods registered with the
server.
A list of possible usage patterns follows:
1. Install functions:
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_function(pow)
server.register_function(lambda x,y: x+y, 'add')
server.serve_forever()
2. Install an instance:
class MyFuncs:
def __init__(self):
# make all of the sys functions available through sys.func_name
import sys
self.sys = sys
def _listMethods(self):
# implement this method so that system.listMethods
# knows to advertise the sys methods
return list_public_methods(self) + \
['sys.' + method for method in list_public_methods(self.sys)]
def pow(self, x, y): return pow(x, y)
def add(self, x, y) : return x + y
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_introspection_functions()
server.register_instance(MyFuncs())
server.serve_forever()
3. Install an instance with custom dispatch method:
class Math:
def _listMethods(self):
# this method must be present for system.listMethods
# to work
return ['add', 'pow']
def _methodHelp(self, method):
# this method must be present for system.methodHelp
# to work
if method == 'add':
return "add(2,3) => 5"
elif method == 'pow':
return "pow(x, y[, z]) => number"
else:
# By convention, return empty
# string if no help is available
return ""
def _dispatch(self, method, params):
if method == 'pow':
return pow(*params)
elif method == 'add':
return params[0] + params[1]
else:
raise ValueError('bad method')
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_introspection_functions()
server.register_instance(Math())
server.serve_forever()
4. Subclass SimpleXMLRPCServer:
class MathServer(SimpleXMLRPCServer):
def _dispatch(self, method, params):
try:
# We are forcing the 'export_' prefix on methods that are
# callable through XML-RPC to prevent potential security
# problems
func = getattr(self, 'export_' + method)
except AttributeError:
raise Exception('method "%s" is not supported' % method)
else:
return func(*params)
def export_add(self, x, y):
return x + y
server = MathServer(("localhost", 8000))
server.serve_forever()
5. CGI script:
server = CGIXMLRPCRequestHandler()
server.register_function(pow)
server.handle_request()
"""
from __future__ import absolute_import, division, print_function, unicode_literals
from future.builtins import int, str
# Written by Brian Quinlan (brian@sweetapp.com).
# Based on code written by Fredrik Lundh.
from future.backports.xmlrpc.client import Fault, dumps, loads, gzip_encode, gzip_decode
from future.backports.http.server import BaseHTTPRequestHandler
import future.backports.http.server as http_server
from future.backports import socketserver
import sys
import os
import re
import pydoc
import inspect
import traceback
try:
import fcntl
except ImportError:
fcntl = None
def resolve_dotted_attribute(obj, attr, allow_dotted_names=True):
"""resolve_dotted_attribute(a, 'b.c.d') => a.b.c.d
Resolves a dotted attribute name to an object. Raises
an AttributeError if any attribute in the chain starts with a '_'.
If the optional allow_dotted_names argument is false, dots are not
supported and this function operates similar to getattr(obj, attr).
"""
if allow_dotted_names:
attrs = attr.split('.')
else:
attrs = [attr]
for i in attrs:
if i.startswith('_'):
raise AttributeError(
'attempt to access private attribute "%s"' % i
)
else:
obj = getattr(obj,i)
return obj
def list_public_methods(obj):
"""Returns a list of attribute strings, found in the specified
object, which represent callable attributes"""
return [member for member in dir(obj)
if not member.startswith('_') and
callable(getattr(obj, member))]
class SimpleXMLRPCDispatcher(object):
"""Mix-in class that dispatches XML-RPC requests.
This class is used to register XML-RPC method handlers
and then to dispatch them. This class doesn't need to be
instanced directly when used by SimpleXMLRPCServer but it
can be instanced when used by the MultiPathXMLRPCServer
"""
def __init__(self, allow_none=False, encoding=None,
use_builtin_types=False):
self.funcs = {}
self.instance = None
self.allow_none = allow_none
self.encoding = encoding or 'utf-8'
self.use_builtin_types = use_builtin_types
def register_instance(self, instance, allow_dotted_names=False):
"""Registers an instance to respond to XML-RPC requests.
Only one instance can be installed at a time.
If the registered instance has a _dispatch method then that
method will be called with the name of the XML-RPC method and
its parameters as a tuple
e.g. instance._dispatch('add',(2,3))
If the registered instance does not have a _dispatch method
then the instance will be searched to find a matching method
and, if found, will be called. Methods beginning with an '_'
are considered private and will not be called by
SimpleXMLRPCServer.
If a registered function matches a XML-RPC request, then it
will be called instead of the registered instance.
If the optional allow_dotted_names argument is true and the
instance does not have a _dispatch method, method names
containing dots are supported and resolved, as long as none of
the name segments start with an '_'.
*** SECURITY WARNING: ***
Enabling the allow_dotted_names options allows intruders
to access your module's global variables and may allow
intruders to execute arbitrary code on your machine. Only
use this option on a secure, closed network.
"""
self.instance = instance
self.allow_dotted_names = allow_dotted_names
def register_function(self, function, name=None):
"""Registers a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
"""
if name is None:
name = function.__name__
self.funcs[name] = function
def register_introspection_functions(self):
"""Registers the XML-RPC introspection methods in the system
namespace.
see http://xmlrpc.usefulinc.com/doc/reserved.html
"""
self.funcs.update({'system.listMethods' : self.system_listMethods,
'system.methodSignature' : self.system_methodSignature,
'system.methodHelp' : self.system_methodHelp})
def register_multicall_functions(self):
"""Registers the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208"""
self.funcs.update({'system.multicall' : self.system_multicall})
def _marshaled_dispatch(self, data, dispatch_method = None, path = None):
"""Dispatches an XML-RPC method from marshalled (XML) data.
XML-RPC methods are dispatched from the marshalled (XML) data
using the _dispatch method and the result is returned as
marshalled data. For backwards compatibility, a dispatch
function can be provided as an argument (see comment in
SimpleXMLRPCRequestHandler.do_POST) but overriding the
existing method through subclassing is the preferred means
of changing method dispatch behavior.
"""
try:
params, method = loads(data, use_builtin_types=self.use_builtin_types)
# generate response
if dispatch_method is not None:
response = dispatch_method(method, params)
else:
response = self._dispatch(method, params)
# wrap response in a singleton tuple
response = (response,)
response = dumps(response, methodresponse=1,
allow_none=self.allow_none, encoding=self.encoding)
except Fault as fault:
response = dumps(fault, allow_none=self.allow_none,
encoding=self.encoding)
except:
# report exception back to server
exc_type, exc_value, exc_tb = sys.exc_info()
response = dumps(
Fault(1, "%s:%s" % (exc_type, exc_value)),
encoding=self.encoding, allow_none=self.allow_none,
)
return response.encode(self.encoding)
def system_listMethods(self):
"""system.listMethods() => ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server."""
methods = set(self.funcs.keys())
if self.instance is not None:
# Instance can implement _listMethod to return a list of
# methods
if hasattr(self.instance, '_listMethods'):
methods |= set(self.instance._listMethods())
# if the instance has a _dispatch method then we
# don't have enough information to provide a list
# of methods
elif not hasattr(self.instance, '_dispatch'):
methods |= set(list_public_methods(self.instance))
return sorted(methods)
def system_methodSignature(self, method_name):
"""system.methodSignature('add') => [double, int, int]
Returns a list describing the signature of the method. In the
above example, the add method takes two integers as arguments
and returns a double result.
This server does NOT support system.methodSignature."""
# See http://xmlrpc.usefulinc.com/doc/sysmethodsig.html
return 'signatures not supported'
def system_methodHelp(self, method_name):
"""system.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method."""
method = None
if method_name in self.funcs:
method = self.funcs[method_name]
elif self.instance is not None:
# Instance can implement _methodHelp to return help for a method
if hasattr(self.instance, '_methodHelp'):
return self.instance._methodHelp(method_name)
# if the instance has a _dispatch method then we
# don't have enough information to provide help
elif not hasattr(self.instance, '_dispatch'):
try:
method = resolve_dotted_attribute(
self.instance,
method_name,
self.allow_dotted_names
)
except AttributeError:
pass
# Note that we aren't checking that the method actually
# be a callable object of some kind
if method is None:
return ""
else:
return pydoc.getdoc(method)
def system_multicall(self, call_list):
"""system.multicall([{'methodName': 'add', 'params': [2, 2]}, ...]) => \
[[4], ...]
Allows the caller to package multiple XML-RPC calls into a single
request.
See http://www.xmlrpc.com/discuss/msgReader$1208
"""
results = []
for call in call_list:
method_name = call['methodName']
params = call['params']
try:
# XXX A marshalling error in any response will fail the entire
# multicall. If someone cares they should fix this.
results.append([self._dispatch(method_name, params)])
except Fault as fault:
results.append(
{'faultCode' : fault.faultCode,
'faultString' : fault.faultString}
)
except:
exc_type, exc_value, exc_tb = sys.exc_info()
results.append(
{'faultCode' : 1,
'faultString' : "%s:%s" % (exc_type, exc_value)}
)
return results
def _dispatch(self, method, params):
"""Dispatches the XML-RPC method.
XML-RPC calls are forwarded to a registered function that
matches the called XML-RPC method name. If no such function
exists then the call is forwarded to the registered instance,
if available.
If the registered instance has a _dispatch method then that
method will be called with the name of the XML-RPC method and
its parameters as a tuple
e.g. instance._dispatch('add',(2,3))
If the registered instance does not have a _dispatch method
then the instance will be searched to find a matching method
and, if found, will be called.
Methods beginning with an '_' are considered private and will
not be called.
"""
func = None
try:
# check to see if a matching function has been registered
func = self.funcs[method]
except KeyError:
if self.instance is not None:
# check for a _dispatch method
if hasattr(self.instance, '_dispatch'):
return self.instance._dispatch(method, params)
else:
# call instance method directly
try:
func = resolve_dotted_attribute(
self.instance,
method,
self.allow_dotted_names
)
except AttributeError:
pass
if func is not None:
return func(*params)
else:
raise Exception('method "%s" is not supported' % method)
class SimpleXMLRPCRequestHandler(BaseHTTPRequestHandler):
"""Simple XML-RPC request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
"""
# Class attribute listing the accessible path components;
# paths not on this list will result in a 404 error.
rpc_paths = ('/', '/RPC2')
#if not None, encode responses larger than this, if possible
encode_threshold = 1400 #a common MTU
#Override form StreamRequestHandler: full buffering of output
#and no Nagle.
wbufsize = -1
disable_nagle_algorithm = True
# a re to match a gzip Accept-Encoding
aepattern = re.compile(r"""
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
""", re.VERBOSE | re.IGNORECASE)
def accept_encodings(self):
r = {}
ae = self.headers.get("Accept-Encoding", "")
for e in ae.split(","):
match = self.aepattern.match(e)
if match:
v = match.group(3)
v = float(v) if v else 1.0
r[match.group(1)] = v
return r
def is_rpc_path_valid(self):
if self.rpc_paths:
return self.path in self.rpc_paths
else:
# If .rpc_paths is empty, just assume all paths are legal
return True
def do_POST(self):
"""Handles the HTTP POST request.
Attempts to interpret all HTTP POST requests as XML-RPC calls,
which are forwarded to the server's _dispatch method for handling.
"""
# Check that the path is legal
if not self.is_rpc_path_valid():
self.report_404()
return
try:
# Get arguments by reading body of request.
# We read this in chunks to avoid straining
# socket.read(); around the 10 or 15Mb mark, some platforms
# begin to have problems (bug #792570).
max_chunk_size = 10*1024*1024
size_remaining = int(self.headers["content-length"])
L = []
while size_remaining:
chunk_size = min(size_remaining, max_chunk_size)
chunk = self.rfile.read(chunk_size)
if not chunk:
break
L.append(chunk)
size_remaining -= len(L[-1])
data = b''.join(L)
data = self.decode_request_content(data)
if data is None:
return #response has been sent
# In previous versions of SimpleXMLRPCServer, _dispatch
# could be overridden in this class, instead of in
# SimpleXMLRPCDispatcher. To maintain backwards compatibility,
# check to see if a subclass implements _dispatch and dispatch
# using that method if present.
response = self.server._marshaled_dispatch(
data, getattr(self, '_dispatch', None), self.path
)
except Exception as e: # This should only happen if the module is buggy
# internal error, report as HTTP server error
self.send_response(500)
# Send information about the exception if requested
if hasattr(self.server, '_send_traceback_header') and \
self.server._send_traceback_header:
self.send_header("X-exception", str(e))
trace = traceback.format_exc()
trace = str(trace.encode('ASCII', 'backslashreplace'), 'ASCII')
self.send_header("X-traceback", trace)
self.send_header("Content-length", "0")
self.end_headers()
else:
self.send_response(200)
self.send_header("Content-type", "text/xml")
if self.encode_threshold is not None:
if len(response) > self.encode_threshold:
q = self.accept_encodings().get("gzip", 0)
if q:
try:
response = gzip_encode(response)
self.send_header("Content-Encoding", "gzip")
except NotImplementedError:
pass
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
def decode_request_content(self, data):
#support gzip encoding of request
encoding = self.headers.get("content-encoding", "identity").lower()
if encoding == "identity":
return data
if encoding == "gzip":
try:
return gzip_decode(data)
except NotImplementedError:
self.send_response(501, "encoding %r not supported" % encoding)
except ValueError:
self.send_response(400, "error decoding gzip content")
else:
self.send_response(501, "encoding %r not supported" % encoding)
self.send_header("Content-length", "0")
self.end_headers()
def report_404 (self):
# Report a 404 error
self.send_response(404)
response = b'No such page'
self.send_header("Content-type", "text/plain")
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
def log_request(self, code='-', size='-'):
"""Selectively log an accepted request."""
if self.server.logRequests:
BaseHTTPRequestHandler.log_request(self, code, size)
class SimpleXMLRPCServer(socketserver.TCPServer,
SimpleXMLRPCDispatcher):
"""Simple XML-RPC server.
Simple XML-RPC server that allows functions and a single instance
to be installed to handle requests. The default implementation
attempts to dispatch XML-RPC calls to the functions or instance
installed in the server. Override the _dispatch method inherited
from SimpleXMLRPCDispatcher to change this behavior.
"""
allow_reuse_address = True
# Warning: this is for debugging purposes only! Never set this to True in
# production code, as will be sending out sensitive information (exception
# and stack trace details) when exceptions are raised inside
# SimpleXMLRPCRequestHandler.do_POST
_send_traceback_header = False
def __init__(self, addr, requestHandler=SimpleXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
self.logRequests = logRequests
SimpleXMLRPCDispatcher.__init__(self, allow_none, encoding, use_builtin_types)
socketserver.TCPServer.__init__(self, addr, requestHandler, bind_and_activate)
# [Bug #1222790] If possible, set close-on-exec flag; if a
# method spawns a subprocess, the subprocess shouldn't have
# the listening socket open.
if fcntl is not None and hasattr(fcntl, 'FD_CLOEXEC'):
flags = fcntl.fcntl(self.fileno(), fcntl.F_GETFD)
flags |= fcntl.FD_CLOEXEC
fcntl.fcntl(self.fileno(), fcntl.F_SETFD, flags)
class MultiPathXMLRPCServer(SimpleXMLRPCServer):
"""Multipath XML-RPC Server
This specialization of SimpleXMLRPCServer allows the user to create
multiple Dispatcher instances and assign them to different
HTTP request paths. This makes it possible to run two or more
'virtual XML-RPC servers' at the same port.
Make sure that the requestHandler accepts the paths in question.
"""
def __init__(self, addr, requestHandler=SimpleXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
SimpleXMLRPCServer.__init__(self, addr, requestHandler, logRequests, allow_none,
encoding, bind_and_activate, use_builtin_types)
self.dispatchers = {}
self.allow_none = allow_none
self.encoding = encoding or 'utf-8'
def add_dispatcher(self, path, dispatcher):
self.dispatchers[path] = dispatcher
return dispatcher
def get_dispatcher(self, path):
return self.dispatchers[path]
def _marshaled_dispatch(self, data, dispatch_method = None, path = None):
try:
response = self.dispatchers[path]._marshaled_dispatch(
data, dispatch_method, path)
except:
# report low level exception back to server
# (each dispatcher should have handled their own
# exceptions)
exc_type, exc_value = sys.exc_info()[:2]
response = dumps(
Fault(1, "%s:%s" % (exc_type, exc_value)),
encoding=self.encoding, allow_none=self.allow_none)
response = response.encode(self.encoding)
return response
class CGIXMLRPCRequestHandler(SimpleXMLRPCDispatcher):
"""Simple handler for XML-RPC data passed through CGI."""
def __init__(self, allow_none=False, encoding=None, use_builtin_types=False):
SimpleXMLRPCDispatcher.__init__(self, allow_none, encoding, use_builtin_types)
def handle_xmlrpc(self, request_text):
"""Handle a single XML-RPC request"""
response = self._marshaled_dispatch(request_text)
print('Content-Type: text/xml')
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def handle_get(self):
"""Handle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
"""
code = 400
message, explain = BaseHTTPRequestHandler.responses[code]
response = http_server.DEFAULT_ERROR_MESSAGE % \
{
'code' : code,
'message' : message,
'explain' : explain
}
response = response.encode('utf-8')
print('Status: %d %s' % (code, message))
print('Content-Type: %s' % http_server.DEFAULT_ERROR_CONTENT_TYPE)
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def handle_request(self, request_text=None):
"""Handle a single XML-RPC request passed through a CGI post method.
If no XML data is given then it is read from stdin. The resulting
XML-RPC response is printed to stdout along with the correct HTTP
headers.
"""
if request_text is None and \
os.environ.get('REQUEST_METHOD', None) == 'GET':
self.handle_get()
else:
# POST data is normally available through stdin
try:
length = int(os.environ.get('CONTENT_LENGTH', None))
except (ValueError, TypeError):
length = -1
if request_text is None:
request_text = sys.stdin.read(length)
self.handle_xmlrpc(request_text)
# -----------------------------------------------------------------------------
# Self documenting XML-RPC Server.
class ServerHTMLDoc(pydoc.HTMLDoc):
"""Class used to generate pydoc HTML document for a server"""
def markup(self, text, escape=None, funcs={}, classes={}, methods={}):
"""Mark up some plain text, given a context of symbols to look for.
Each context dictionary maps object names to anchor names."""
escape = escape or self.escape
results = []
here = 0
# XXX Note that this regular expression does not allow for the
# hyperlinking of arbitrary strings being used as method
# names. Only methods with names consisting of word characters
# and '.'s are hyperlinked.
pattern = re.compile(r'\b((http|ftp)://\S+[\w/]|'
r'RFC[- ]?(\d+)|'
r'PEP[- ]?(\d+)|'
r'(self\.)?((?:\w|\.)+))\b')
while 1:
match = pattern.search(text, here)
if not match: break
start, end = match.span()
results.append(escape(text[here:start]))
all, scheme, rfc, pep, selfdot, name = match.groups()
if scheme:
url = escape(all).replace('"', '"')
results.append('<a href="%s">%s</a>' % (url, url))
elif rfc:
url = 'http://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
results.append('<a href="%s">%s</a>' % (url, escape(all)))
elif pep:
url = 'http://www.python.org/dev/peps/pep-%04d/' % int(pep)
results.append('<a href="%s">%s</a>' % (url, escape(all)))
elif text[end:end+1] == '(':
results.append(self.namelink(name, methods, funcs, classes))
elif selfdot:
results.append('self.<strong>%s</strong>' % name)
else:
results.append(self.namelink(name, classes))
here = end
results.append(escape(text[here:]))
return ''.join(results)
def docroutine(self, object, name, mod=None,
funcs={}, classes={}, methods={}, cl=None):
"""Produce HTML documentation for a function or method object."""
anchor = (cl and cl.__name__ or '') + '-' + name
note = ''
title = '<a name="%s"><strong>%s</strong></a>' % (
self.escape(anchor), self.escape(name))
if inspect.ismethod(object):
args = inspect.getfullargspec(object)
# exclude the argument bound to the instance, it will be
# confusing to the non-Python user
argspec = inspect.formatargspec (
args.args[1:],
args.varargs,
args.varkw,
args.defaults,
annotations=args.annotations,
formatvalue=self.formatvalue
)
elif inspect.isfunction(object):
args = inspect.getfullargspec(object)
argspec = inspect.formatargspec(
args.args, args.varargs, args.varkw, args.defaults,
annotations=args.annotations,
formatvalue=self.formatvalue)
else:
argspec = '(...)'
if isinstance(object, tuple):
argspec = object[0] or argspec
docstring = object[1] or ""
else:
docstring = pydoc.getdoc(object)
decl = title + argspec + (note and self.grey(
'<font face="helvetica, arial">%s</font>' % note))
doc = self.markup(
docstring, self.preformat, funcs, classes, methods)
doc = doc and '<dd><tt>%s</tt></dd>' % doc
return '<dl><dt>%s</dt>%s</dl>\n' % (decl, doc)
def docserver(self, server_name, package_documentation, methods):
"""Produce HTML documentation for an XML-RPC server."""
fdict = {}
for key, value in methods.items():
fdict[key] = '#-' + key
fdict[value] = fdict[key]
server_name = self.escape(server_name)
head = '<big><big><strong>%s</strong></big></big>' % server_name
result = self.heading(head, '#ffffff', '#7799ee')
doc = self.markup(package_documentation, self.preformat, fdict)
doc = doc and '<tt>%s</tt>' % doc
result = result + '<p>%s</p>\n' % doc
contents = []
method_items = sorted(methods.items())
for key, value in method_items:
contents.append(self.docroutine(value, key, funcs=fdict))
result = result + self.bigsection(
'Methods', '#ffffff', '#eeaa77', ''.join(contents))
return result
class XMLRPCDocGenerator(object):
"""Generates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
"""
def __init__(self):
# setup variables used for HTML documentation
self.server_name = 'XML-RPC Server Documentation'
self.server_documentation = \
"This server exports the following methods through the XML-RPC "\
"protocol."
self.server_title = 'XML-RPC Server Documentation'
def set_server_title(self, server_title):
"""Set the HTML title of the generated server documentation"""
self.server_title = server_title
def set_server_name(self, server_name):
"""Set the name of the generated HTML server documentation"""
self.server_name = server_name
def set_server_documentation(self, server_documentation):
"""Set the documentation string for the entire server."""
self.server_documentation = server_documentation
def generate_html_documentation(self):
"""generate_html_documentation() => html documentation for the server
Generates HTML documentation for the server using introspection for
installed functions and instances that do not implement the
_dispatch method. Alternatively, instances can choose to implement
the _get_method_argstring(method_name) method to provide the
argument string used in the documentation and the
_methodHelp(method_name) method to provide the help text used
in the documentation."""
methods = {}
for method_name in self.system_listMethods():
if method_name in self.funcs:
method = self.funcs[method_name]
elif self.instance is not None:
method_info = [None, None] # argspec, documentation
if hasattr(self.instance, '_get_method_argstring'):
method_info[0] = self.instance._get_method_argstring(method_name)
if hasattr(self.instance, '_methodHelp'):
method_info[1] = self.instance._methodHelp(method_name)
method_info = tuple(method_info)
if method_info != (None, None):
method = method_info
elif not hasattr(self.instance, '_dispatch'):
try:
method = resolve_dotted_attribute(
self.instance,
method_name
)
except AttributeError:
method = method_info
else:
method = method_info
else:
assert 0, "Could not find method in self.functions and no "\
"instance installed"
methods[method_name] = method
documenter = ServerHTMLDoc()
documentation = documenter.docserver(
self.server_name,
self.server_documentation,
methods
)
return documenter.page(self.server_title, documentation)
class DocXMLRPCRequestHandler(SimpleXMLRPCRequestHandler):
"""XML-RPC and documentation request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
Handles all HTTP GET requests and interprets them as requests
for documentation.
"""
def do_GET(self):
"""Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
"""
# Check that the path is legal
if not self.is_rpc_path_valid():
self.report_404()
return
response = self.server.generate_html_documentation().encode('utf-8')
self.send_response(200)
self.send_header("Content-type", "text/html")
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
class DocXMLRPCServer( SimpleXMLRPCServer,
XMLRPCDocGenerator):
"""XML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
"""
def __init__(self, addr, requestHandler=DocXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
SimpleXMLRPCServer.__init__(self, addr, requestHandler, logRequests,
allow_none, encoding, bind_and_activate,
use_builtin_types)
XMLRPCDocGenerator.__init__(self)
class DocCGIXMLRPCRequestHandler( CGIXMLRPCRequestHandler,
XMLRPCDocGenerator):
"""Handler for XML-RPC data and documentation requests passed through
CGI"""
def handle_get(self):
"""Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
"""
response = self.generate_html_documentation().encode('utf-8')
print('Content-Type: text/html')
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def __init__(self):
CGIXMLRPCRequestHandler.__init__(self)
XMLRPCDocGenerator.__init__(self)
if __name__ == '__main__':
import datetime
class ExampleService:
def getData(self):
return '42'
class currentTime:
@staticmethod
def getCurrentTime():
return datetime.datetime.now()
server = SimpleXMLRPCServer(("localhost", 8000))
server.register_function(pow)
server.register_function(lambda x,y: x+y, 'add')
server.register_instance(ExampleService(), allow_dotted_names=True)
server.register_multicall_functions()
print('Serving XML-RPC on localhost port 8000')
print('It is advisable to run this example server within a secure, closed network.')
try:
server.serve_forever()
except KeyboardInterrupt:
print("\nKeyboard interrupt received, exiting.")
server.server_close()
sys.exit(0)
PK �Cu\����l l # future/backports/urllib/response.pynu �[��� """Response classes used by urllib.
The base class, addbase, defines a minimal file-like interface,
including read() and readline(). The typical response object is an
addinfourl instance, which defines an info() method that returns
headers and a geturl() method that returns the url.
"""
from __future__ import absolute_import, division, unicode_literals
from future.builtins import object
class addbase(object):
"""Base class for addinfo and addclosehook."""
# XXX Add a method to expose the timeout on the underlying socket?
def __init__(self, fp):
# TODO(jhylton): Is there a better way to delegate using io?
self.fp = fp
self.read = self.fp.read
self.readline = self.fp.readline
# TODO(jhylton): Make sure an object with readlines() is also iterable
if hasattr(self.fp, "readlines"):
self.readlines = self.fp.readlines
if hasattr(self.fp, "fileno"):
self.fileno = self.fp.fileno
else:
self.fileno = lambda: None
def __iter__(self):
# Assigning `__iter__` to the instance doesn't work as intended
# because the iter builtin does something like `cls.__iter__(obj)`
# and thus fails to find the _bound_ method `obj.__iter__`.
# Returning just `self.fp` works for built-in file objects but
# might not work for general file-like objects.
return iter(self.fp)
def __repr__(self):
return '<%s at %r whose fp = %r>' % (self.__class__.__name__,
id(self), self.fp)
def close(self):
if self.fp:
self.fp.close()
self.fp = None
self.read = None
self.readline = None
self.readlines = None
self.fileno = None
self.__iter__ = None
self.__next__ = None
def __enter__(self):
if self.fp is None:
raise ValueError("I/O operation on closed file")
return self
def __exit__(self, type, value, traceback):
self.close()
class addclosehook(addbase):
"""Class to add a close hook to an open file."""
def __init__(self, fp, closehook, *hookargs):
addbase.__init__(self, fp)
self.closehook = closehook
self.hookargs = hookargs
def close(self):
if self.closehook:
self.closehook(*self.hookargs)
self.closehook = None
self.hookargs = None
addbase.close(self)
class addinfo(addbase):
"""class to add an info() method to an open file."""
def __init__(self, fp, headers):
addbase.__init__(self, fp)
self.headers = headers
def info(self):
return self.headers
class addinfourl(addbase):
"""class to add info() and geturl() methods to an open file."""
def __init__(self, fp, headers, url, code=None):
addbase.__init__(self, fp)
self.headers = headers
self.url = url
self.code = code
def info(self):
return self.headers
def getcode(self):
return self.code
def geturl(self):
return self.url
del absolute_import, division, unicode_literals, object
PK �Cu\ # future/backports/urllib/__init__.pynu �[��� PK Du\���c c : future/backports/urllib/__pycache__/request.cpython-39.pycnu �[��� a
��?hx � @ s d Z ddlmZmZmZmZ ddlmZmZm Z m
Z
m Z m Z m
Z
mZ ddlmZmZmZ ddlZddlZddlZddlZddlmZ ddlmZ dd l m Z m Z m Z dd
l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1 dd l2m3Z3m4Z4 ddl5Z5ddl6Z6ddl7Z7ddl8Z8ddl9Z9ddl:Z:ddl;Z;ddl<Z<ddl=Z=ddl>Z>dd lmZ e�rpdd
l?m@Z@ n dd
lAm@Z@ zddlBZBddlBmCZC W n eD�y� dZEY n0 dZEg d�ZFe:jGdd� ZHdaIde9jJfdd�ZKdd� ZLg ZMd�dd�ZNdd� ZOe�re8�Pde8jQ�ZRn
e8�Pd�ZRd d � ZSG d d � d eT�ZUG d d!� d!eT�ZVd"d#� ZWG d$d%� d%eT�ZXG d&d'� d'eX�ZYG d(d)� d)eX�ZZG d*d+� d+eX�Z[d,d-� Z\G d.d/� d/eX�Z]G d0d1� d1eT�Z^G d2d3� d3e^�Z_G d4d5� d5eT�Z`G d6d7� d7e`eX�ZaG d8d9� d9e`eX�Zbe6jcZdG d:d;� d;eT�ZeG d<d=� d=eXee�ZfG d>d?� d?eXee�ZgG d@dA� dAeX�ZhG dBdC� dCeh�ZiejedD��rvG dEdF� dFeh�ZkeF�ldF� G dGdH� dHeX�ZmG dIdJ� dJeX�ZndKdL� ZodMdN� ZpG dOdP� dPeX�ZqdQdR� ZrG dSdT� dTeX�ZsG dUdV� dVes�ZtdWZue6jvdXk�r ddYlwmxZxmyZy ndZd[� Zxd\d]� Zyi ZzG d^d_� d_eT�Z{G d`da� dae{�Z|da}dbdc� Z~daddde� Z�da�dfdg� Z�da�dhdi� Z�G djdk� dkeT�Z�dldm� Z�dndo� Z�dpdq� Z�e:j�drk�r�ddsl�m�Z�m�Z� dtdu� Z�dvdw� Z�dxdy� Z�dzd{� Z�n6e6jvdXk�r�d|d}� Z�d~d{� Z�dd�� Z�d�dy� Z�ne�Z�e�Z�dS )�a�
Ported using Python-Future from the Python 3.3 standard library.
An extensible library for opening URLs using a variety of protocols
The simplest way to use this module is to call the urlopen function,
which accepts a string containing a URL or a Request object (described
below). It opens the URL and returns the results as file-like
object; the returned object has some extra methods described below.
The OpenerDirector manages a collection of Handler objects that do
all the actual work. Each Handler implements a particular protocol or
option. The OpenerDirector is a composite object that invokes the
Handlers needed to open the requested URL. For example, the
HTTPHandler performs HTTP GET and POST requests and deals with
non-error returns. The HTTPRedirectHandler automatically deals with
HTTP 301, 302, 303 and 307 redirect errors, and the HTTPDigestAuthHandler
deals with digest authentication.
urlopen(url, data=None) -- Basic usage is the same as original
urllib. pass the url and optionally data to post to an HTTP URL, and
get a file-like object back. One difference is that you can also pass
a Request instance instead of URL. Raises a URLError (subclass of
IOError); for HTTP errors, raises an HTTPError, which can also be
treated as a valid response.
build_opener -- Function that creates a new OpenerDirector instance.
Will install the default handlers. Accepts one or more Handlers as
arguments, either instances or Handler classes that it will
instantiate. If one of the argument is a subclass of the default
handler, the argument will be installed instead of the default.
install_opener -- Installs a new opener as the default opener.
objects of interest:
OpenerDirector -- Sets up the User Agent as the Python-urllib client and manages
the Handler classes, while dealing with requests and responses.
Request -- An object that encapsulates the state of a request. The
state can be as simple as the URL. It can also include extra HTTP
headers, e.g. a User-Agent.
BaseHandler --
internals:
BaseHandler and parent
_call_chain conventions
Example usage:
import urllib.request
# set up authentication info
authinfo = urllib.request.HTTPBasicAuthHandler()
authinfo.add_password(realm='PDQ Application',
uri='https://mahler:8092/site-updates.py',
user='klem',
passwd='geheim$parole')
proxy_support = urllib.request.ProxyHandler({"http" : "http://ahad-haam:3128"})
# build a new opener that adds authentication and caching FTP handlers
opener = urllib.request.build_opener(proxy_support, authinfo,
urllib.request.CacheFTPHandler)
# install it
urllib.request.install_opener(opener)
f = urllib.request.urlopen('http://www.python.org/')
� )�absolute_import�division�print_function�unicode_literals)�bytes�dict�filter�input�int�map�open�str)�PY2�PY3�raise_with_tracebackN)�email)�client� )�URLError� HTTPError�ContentTooShortError)�urlparse�urlsplit�urljoin�unwrap�quote�unquote� splittype� splithost� splitport� splituser� splitpasswd� splitattr�
splitquery�
splitvalue�splittag�to_bytes�
urlunparse)�
addinfourl� addclosehook)r )�Iterable)�
SSLContextFT) �Request�OpenerDirector� BaseHandler�HTTPDefaultErrorHandler�HTTPRedirectHandler�HTTPCookieProcessor� ProxyHandler�HTTPPasswordMgr� HTTPPasswordMgrWithDefaultRealm�AbstractBasicAuthHandler�HTTPBasicAuthHandler�ProxyBasicAuthHandler�AbstractDigestAuthHandler�HTTPDigestAuthHandler�ProxyDigestAuthHandler� HTTPHandler� FileHandler�
FTPHandler�CacheFTPHandler�UnknownHandler�HTTPErrorProcessor�urlopen�install_opener� build_opener� pathname2url� url2pathname�
getproxies� urlretrieve�
urlcleanup� URLopener�FancyURLopener� c
K s� d|v r|d }|d= nd}d|v r4|d }|d= nd }d|v rP|d }|d= nd }|s`|s`|r�t sltd��t�tj�}| jtjO _tj|_|s�|r�|� ||� n|�
� t |dd�}t |�} nt
d u r�t � a
} nt
} | �| ||�S )N� cadefaultF�capath�cafilezSSL support not availableT��context�check_hostname)� _have_ssl�
ValueError�sslr+ �PROTOCOL_SSLv23�options� OP_NO_SSLv2�
CERT_REQUIRED� verify_mode�load_verify_locations�set_default_verify_paths� HTTPSHandlerrC �_openerr )
�url�data�timeoutZ _3to2kwargsrL rM rN rP �
https_handler�opener� rc �I/usr/local/lib/python3.9/site-packages/future/backports/urllib/request.pyrA � s*
rA c C s | a d S �N)r] )rb rc rc rd rB � s rB c C sl t | �\}}t�t| |����}|�� }|dkrR|sRtj�|�|fW d � S |rbt|d�}n t j
dd�}|j }t �
|� |�� ||f} d}
d} d} d}
d |v r�t|d
�} |r�||
|
| � |�|
�}|sҐq| t|�7 } |�|� |
d 7 }
|r�||
|
| � q�W d � n1 �s0 Y W d � n1 �s80 Y | dk�rh| | k �rhtd | | f | ��| S )
aW
Retrieve a URL into a temporary location on disk.
Requires a URL argument. If a filename is passed, it is used as
the temporary file location. The reporthook argument should be
a callable that accepts a block number, a read size, and the
total file size of the URL target. The data argument should be
valid URL encoded data.
If a filename is passed and the URL points to a local resource,
the result is a copy from local file to new file.
Returns a tuple containing the path to the newly created
data file as well as the resulting HTTPMessage object.
�fileN�wbF)�delete� ���r �content-length�Content-Lengthr �1retrieval incomplete: got only %i out of %i bytes)r �
contextlib�closingrA �info�os�path�normpathr �tempfile�NamedTemporaryFile�name�_url_tempfiles�appendr
�read�len�writer )r^ �filename�
reporthookr_ �url_typerr �fp�headers�tfp�result�bs�sizery �blocknum�blockrc rc rd rG � sH
N��rG c C sB t D ]&} zt�| � W q ty( Y q0 qt d d �= tr>d ad S re )rw rq �unlink�EnvironmentErrorr] )� temp_filerc rc rd rH � s
rH z:\d+$c C s< | j }t|�d }|dkr&| �dd�}t�d|d�}|�� S )z�Return request-host, as defined by RFC 2965.
Variation from RFC: returned value is lowercased, for convenient
comparison.
r � �Host)�full_urlr �
get_header� _cut_port_re�sub�lower)�requestr^ �hostrc rc rd � request_host s r� c @ s� e Zd Zdi dddfdd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd)d%d&�Zd'd(� ZdS )*r, NFc C s� t |�| _t| j�\| _| _|| _i | _d | _|�� D ]\}}| �||� q6i | _ |d u rbt
| �}|| _ || _ || _
| �� d S re )r r� r% �fragmentr_ r� � _tunnel_host�items�
add_header�unredirected_hdrsr� �origin_req_host� unverifiable�method�_parse) �selfr^ r_ r� r� r� r� �key�valuerc rc rd �__init__ s
zRequest.__init__c C sN t | j�\| _}| jd u r(td| j ��t|�\| _| _| jrJt| j�| _d S )Nzunknown url type: %r)r r� �typerS r r� �selectorr )r� �restrc rc rd r� . s
zRequest._parsec C s& | j dur| j S | jdur dS dS dS )z3Return a string indicating the HTTP request method.N�POST�GET)r� r_ �r� rc rc rd �
get_method6 s
zRequest.get_methodc C s | j rd| j| j f S | jS d S )Nz%s#%s)r� r� r� rc rc rd � get_full_url? s zRequest.get_full_urlc C s d}t j|tdd� || _d S )Nz&Request.add_data method is deprecated.r ��
stacklevel��warnings�warn�DeprecationWarningr_ )r� r_ �msgrc rc rd �add_dataG s zRequest.add_datac C s d}t j|tdd� | jd uS )Nz&Request.has_data method is deprecated.r r� r� �r� r� rc rc rd �has_dataL s zRequest.has_datac C s d}t j|tdd� | jS )Nz&Request.get_data method is deprecated.r r� r� r� rc rc rd �get_dataQ s zRequest.get_datac C s d}t j|tdd� | jS )Nz&Request.get_type method is deprecated.r r� )r� r� r� r� r� rc rc rd �get_typeV s zRequest.get_typec C s d}t j|tdd� | jS )Nz&Request.get_host method is deprecated.r r� )r� r� r� r� r� rc rc rd �get_host[ s zRequest.get_hostc C s d}t j|tdd� | jS )Nz*Request.get_selector method is deprecated.r r� )r� r� r� r� r� rc rc rd � get_selector` s zRequest.get_selectorc C s d}t j|tdd� | jS )Nz-Request.is_unverifiable method is deprecated.r r� )r� r� r� r� r� rc rc rd �is_unverifiablee s zRequest.is_unverifiablec C s d}t j|tdd� | jS )Nz1Request.get_origin_req_host method is deprecated.r r� )r� r� r� r� r� rc rc rd �get_origin_req_hostj s zRequest.get_origin_req_hostc C s2 | j dkr| js| j| _n|| _ | j| _|| _d S )N�https)r� r� r� r� r� )r� r� r� rc rc rd � set_proxyq s
zRequest.set_proxyc C s | j | jkS re )r� r� r� rc rc rd � has_proxyy s zRequest.has_proxyc C s || j |�� < d S re )r� �
capitalize�r� r� �valrc rc rd r� | s zRequest.add_headerc C s || j |�� < d S re )r� r� r� rc rc rd �add_unredirected_header� s z Request.add_unredirected_headerc C s || j v p|| jv S re )r� r� )r� � header_namerc rc rd �
has_header� s
�zRequest.has_headerc C s | j �|| j�||��S re )r� �getr� )r� r� �defaultrc rc rd r� � s �zRequest.get_headerc C s" | j �� }|�| j� t|�� �S re )r� �copy�updater� �listr� )r� �hdrsrc rc rd � header_items� s
zRequest.header_items)N)�__name__�
__module__� __qualname__r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� rc rc rc rd r, s, �
r, c @ sN e Zd Zdd� Zdd� Zdd� Zdd� Zd ejfd
d �Z dd d
�Z
dd� Z d S )r- c C s6 dt }d|fg| _g | _i | _i | _i | _i | _d S )N�Python-urllib/%sz
User-agent)� __version__�
addheaders�handlers� handle_open� handle_error�process_response�process_request)r� �client_versionrc rc rd r� � s zOpenerDirector.__init__c C sR t |d�stdt|� ��d}t|�D �]}|dv r6q&|�d�}|d |� }||d d � }|�d�r�|�d�| d }||d d � }z t|�}W n ty� Y n0 | j� |i �} | | j|< n>|dkr�|}| j
} n*|d kr�|}| j } n|d
kr&|}| j } nq&| �
|g �}
|
�r t�|
|� n
|
�|� d }q&|�rNt�| j|� |�| � d S ) N�
add_parentz%expected BaseHandler instance, got %rF)�redirect_request�do_open�
proxy_open�_r �errorr �responser� T)�hasattr� TypeErrorr� �dir�find�
startswithr
rS r� r� r� r� r� �
setdefault�bisect�insortrx r� r� ) r� �handler�added�meth�i�protocol� condition�j�kind�lookupr� rc rc rd � add_handler� sL
�
zOpenerDirector.add_handlerc C s d S re rc r� rc rc rd �close� s zOpenerDirector.closec G s< |� |d�}|D ]&}t||�}||� }|d ur| S qd S )Nrc )r� �getattr) r� �chainr� � meth_name�argsr� r� �funcr� rc rc rd � _call_chain� s
zOpenerDirector._call_chainNc
C s� t |t�r|�� }t |t�r(t||�}n|}|dur:||_||_|j}|d }| j� |g �D ]}t
||�}||�}q\| � ||�} |d }| j � |g �D ]}t
||�}||| �} q�| S )z�
Accept a URL or a Request object
Python-Future: if the URL is passed as a byte-string, decode it first.
N�_request� _response)
�
isinstancer �decoder
r, r_ r` r� r� r� r� �_openr� )
r� �fullurlr_ r` �reqr� r� � processorr� r� rc rc rd r � s&
zOpenerDirector.openc C sP | � | jdd|�}|r|S |j}| � | j||d |�}|r>|S | � | jdd|�S )Nr� � default_openr� �unknown� unknown_open)r� r� r� )r� r� r_ r� r� rc rc rd r� � s
� ��
�zOpenerDirector._openc G s~ |dv r,| j d }|d }d| }d}|}n| j }|d }d}|||f| }| j|� }|r^|S |rz|dd f| }| j|� S d S )
N��httpr� r � z
http_error_%sr �_errorr r� �http_error_default)r� r� )r� �protor� r r� �http_err� orig_argsr� rc rc rd r�
s
zOpenerDirector.error)N) r� r� r� r� r� r� r� �socket�_GLOBAL_DEFAULT_TIMEOUTr r� r� rc rc rc rd r- � s / "
r- c G s� dd� }t � }ttttttttg}t t
d�r6|� t � t
� }|D ]@}| D ]6}||�rjt||�r~|�|� qHt||�rH|�|� qHq@|D ]}|�|� q�|D ]}|�|� � q�| D ] }||�r�|� }|�|� q�|S )a* Create an opener object from a list of handlers.
The opener will use several default handlers, including support
for HTTP, FTP and when applicable HTTPS.
If any of the handlers passed as arguments are subclasses of the
default handlers, the default handlers will not be used.
c S s t | t�pt| d�S )N� __bases__)r� r� r� )�objrc rc rd �isclass/ s z build_opener.<locals>.isclass�HTTPSConnection)r- r2 r? r; r/ r0 r= r< r@ r� � http_clientrx r\ �set�
issubclass�addr� �remover� )r� r rb �default_classes�skip�klass�check�hrc rc rd rC & s2 �
rC c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r. �� c C s
|| _ d S re )�parent)r� r rc rc rd r� O s zBaseHandler.add_parentc C s d S re rc r� rc rc rd r� R s zBaseHandler.closec C s t |d�sdS | j|jk S )N�
handler_orderT)r� r )r� �otherrc rc rd �__lt__V s
zBaseHandler.__lt__N)r� r� r� r r� r� r rc rc rc rd r. L s r. c @ s e Zd ZdZdZdd� ZeZdS )r@ z Process HTTP error responses.i� c C sH |j |j|�� }}}d| kr,dk sDn | j�d|||||�}|S )N�� �, r )�coder� rp r r� )r� r� r� r r� r� rc rc rd �
http_responsec s �z HTTPErrorProcessor.http_responseN)r� r� r� �__doc__r r �https_responserc rc rc rd r@ _ s r@ c @ s e Zd Zdd� ZdS )r/ c C s t |j||||��d S re )r r� )r� r� r r r� r� rc rc rd r q s z*HTTPDefaultErrorHandler.http_error_defaultN)r� r� r� r rc rc rc rd r/ p s r/ c @ s4 e Zd ZdZdZdd� Zdd� Ze Z ZZ dZ
dS ) r0 � �
c sx |� � }|dv r|dv s:|dv r(|dks:t|j||||��|�dd�}d� t� fdd �|j�� D ��}t|||jd
d �S ) a� Return a Request or None in response to a redirect.
This is called by the http_error_30x methods when a
redirection response is received. If a redirection should
take place, return a new Request to allow http_error_30x to
perform the redirect. Otherwise, raise HTTPError if no-one
else should try to handle this url. Return None if you can't
but another Handler might.
)�- �. �/ i3 )r� �HEAD)r% r& r' r� � z%20)rk z content-typec 3 s& | ] \}}|� � � vr||fV qd S re )r� ��.0�k�v��CONTENT_HEADERSrc rd � <genexpr>� s
�z7HTTPRedirectHandler.redirect_request.<locals>.<genexpr>T)r� r� r� ) r� r r� �replacer r� r� r, r� ) r� r� r r r� r� �newurl�m�
newheadersrc r. rd r� | s
�� �z$HTTPRedirectHandler.redirect_requestc
C s2 d|v r|d }nd|v r$|d }nd S t |�}|jdvrRt||d||f ||��|jsht|�}d|d< t|�}t|j|�}| �||||||�}|d u r�d S t |d�r�|j
} |_
| � |d�| j ks�t
| �| jkr�t|j|| j| ||��ni } |_
|_
| � |d�d | |< |�� |�� | jj||jd
�S ) N�location�uri�r r� �ftpr� z+%s - Redirection to url '%s' is not allowed�/r �
redirect_dictr r �r` )r �schemer rr r� r' r r� r� r� r: r� � max_repeatsrz �max_redirections�inf_msgry r� r r r` )
r� r� r r r� r� r2 �urlparts�new�visitedrc rc rd �http_error_302� sB
�
� �z"HTTPRedirectHandler.http_error_302zoThe HTTP server returned a redirect error that would lead to an infinite loop.
The last 30x error message was:
N) r� r� r� r= r> r� rC �http_error_301�http_error_303�http_error_307r? rc rc rc rd r0 t s "7 r0 c C s� t | �\}}|�d�s d}| }n:|�d�s6td| ��|�dd�}|dkrNd}|d|� }t|�\}}|dur|t|�\}}nd }}||||fS )a3 Return (scheme, user, password, host/port) given a URL or an authority.
If a URL is supplied, it must have an authority (host:port) component.
According to RFC 3986, having an authority component means the URL must
have two slashes after the scheme:
>>> _parse_proxy('file:/ftp.example.com/')
Traceback (most recent call last):
ValueError: proxy URL with no authority: 'file:/ftp.example.com/'
The first three items of the returned tuple may be None.
Examples of authority parsing:
>>> _parse_proxy('proxy.example.com')
(None, None, None, 'proxy.example.com')
>>> _parse_proxy('proxy.example.com:3128')
(None, None, None, 'proxy.example.com:3128')
The authority component may optionally include userinfo (assumed to be
username:password):
>>> _parse_proxy('joe:password@proxy.example.com')
(None, 'joe', 'password', 'proxy.example.com')
>>> _parse_proxy('joe:password@proxy.example.com:3128')
(None, 'joe', 'password', 'proxy.example.com:3128')
Same examples, but with URLs instead:
>>> _parse_proxy('http://proxy.example.com/')
('http', None, None, 'proxy.example.com')
>>> _parse_proxy('http://proxy.example.com:3128/')
('http', None, None, 'proxy.example.com:3128')
>>> _parse_proxy('http://joe:password@proxy.example.com/')
('http', 'joe', 'password', 'proxy.example.com')
>>> _parse_proxy('http://joe:password@proxy.example.com:3128')
('http', 'joe', 'password', 'proxy.example.com:3128')
Everything after the authority is ignored:
>>> _parse_proxy('ftp://joe:password@proxy.example.com/rubbish:3128')
('ftp', 'joe', 'password', 'proxy.example.com')
Test for no trailing '/' case:
>>> _parse_proxy('http://joe:password@proxy.example.com')
('http', 'joe', 'password', 'proxy.example.com')
r9 N�//z proxy URL with no authority: %rr rj )r r� rS r� r r! ) �proxyr< �r_scheme� authority�end�userinfo�hostport�user�passwordrc rc rd � _parse_proxy� s 2
rP c @ s" e Zd ZdZddd�Zdd� ZdS )r2 �d Nc C sZ |d u rt � }t|d�s J d��|| _|�� D ]&\}}t| d| ||| jfdd�� q.d S )N�keys�proxies must be a mappingz%s_openc S s || ||�S re rc )�rrH r� r� rc rc rd �<lambda>/ s z'ProxyHandler.__init__.<locals>.<lambda>)rF r� �proxiesr� �setattrr� )r� rV r� r^ rc rc rd r� ( s
�zProxyHandler.__init__c C s� |j }t|�\}}}}|d u r"|}|jr6t|j�r6d S |rv|rvdt|�t|�f } t�| �� ��d�}
|� dd|
� t|�}|�
||� ||ks�|dkr�d S | j j ||j
d�S d S )N�%s:%s�ascii�Proxy-authorization�Basic r� r; )r� rP r� � proxy_bypassr �base64� b64encode�encoder� r� r� r r r` ) r� r� rH r� � orig_type�
proxy_typerN rO rM � user_pass�credsrc rc rd r� 2 s" � zProxyHandler.proxy_open)N)r� r� r� r r� r� rc rc rc rd r2 $ s
r2 c @ s6 e Zd Zdd� Zdd� Zdd� Zd
dd �Zd
d � Zd S )r3 c C s
i | _ d S re )�passwdr� rc rc rd r� P s zHTTPPasswordMgr.__init__c s\ t |t�r|g}|�jvr$i �j|< dD ].� t� �fdd�|D ��}||f�j| |< q(d S )N�TFc s g | ]}�� |� ��qS rc )�
reduce_uri)r+ �u�� default_portr� rc rd �
<listcomp>[ � z0HTTPPasswordMgr.add_password.<locals>.<listcomp>)r� r
rd �tuple)r� �realmr6 rN rd � reduced_urirc rh rd � add_passwordS s
�z HTTPPasswordMgr.add_passwordc C s` | j �|i �}dD ]H}| �||�}|�� D ].\}}|D ] }| �||�r6| S q6q*qdS )Nre �NN)rd r� rf r� � is_suburi) r� rm �authuri�domainsri �reduced_authuri�uris�authinfor6 rc rc rd �find_user_password^ s z"HTTPPasswordMgr.find_user_passwordTc
C s� t |�}|d r.|d }|d }|d p*d}n d}|}d}t|�\}}|r~|du r~|dur~ddd��|�} | dur~d || f }||fS )
z@Accept authority or URI and extract only the authority and path.r r r r9 N�P i� r z%s:%d)r r r� )
r� r6 ri �partsr< rJ rr r� �port�dportrc rc rd rf h s$ �� zHTTPPasswordMgr.reduce_uric C sR ||kr dS |d |d kr dS t �|d |d f�}t|�t|d �krNdS dS )zcCheck if test is below base in a URI tree
Both args must be URIs in reduced form.
Tr Fr )� posixpath� commonprefixrz )r� �base�test�commonrc rc rd rq s zHTTPPasswordMgr.is_suburiN)T)r� r� r� r� ro rw rf rq rc rc rc rd r3 N s
r3 c @ s e Zd Zdd� ZdS )r4 c C s0 t �| ||�\}}|d ur"||fS t �| d |�S re )r3 rw )r� rm rr rN rO rc rc rd rw � s �z2HTTPPasswordMgrWithDefaultRealm.find_user_passwordN)r� r� r� rw rc rc rc rd r4 � s r4 c @ s< e Zd Ze�dej�Zd dd�Zdd� Zdd� Z d d
� Z
dS ) r5 z1(?:.*,)*[ ]*([^ ]+)[ ]+realm=(["']?)([^"']*)\2Nc C s( |d u rt � }|| _| jj| _d| _d S �Nr )r3 rd ro �retried)r� � password_mgrrc rc rd r� � s
z!AbstractBasicAuthHandler.__init__c C s
d| _ d S r� �r� r� rc rc rd �reset_retry_count� s z*AbstractBasicAuthHandler.reset_retry_countc
C s� |� |d �}| jdkr,t|�� dd|d ��n| jd7 _|r�|�� d }|�� dkrdtd| ��nftj� |�}|r�|�
� \}}}|dvr�t � d t
d
� |�� dkr�| �|||�} | r�| jdkr�d| _| S d S ) N� � zbasic auth failedr r �basiczDAbstractBasicAuthHandler does not support the following scheme: '%s')�"�'z Basic Auth Realm was unquotedr )r� r� r r� �splitr� rS r5 �rx�search�groupsr� r� � UserWarning�retry_http_basic_authr )
r� �authreqr� r� r� r< �mor rm r� rc rc rd �http_error_auth_reqed� s0
� � � z.AbstractBasicAuthHandler.http_error_auth_reqedc C s~ | j �||�\}}|d urvd||f }dt�|�� ��d� }|j�| jd �|krVd S |� | j|� | j
j ||j d�S d S d S )NrX r[ rY r; )
rd rw r] r^ r_ r� r� r� � auth_headerr� r r r` )r� r� r� rm rN �pw�raw�authrc rc rd r� � s z.AbstractBasicAuthHandler.retry_http_basic_auth)N) r� r� r� �re�compile�Ir� r� r� r� r� rc rc rc rd r5 � s �
r5 c @ s e Zd ZdZdd� ZdS )r6 �
Authorizationc C s" |j }| �d|||�}| �� |S )N�www-authenticate)r� r� r� )r� r� r r r� r� r^ r� rc rc rd �http_error_401� s �z#HTTPBasicAuthHandler.http_error_401N)r� r� r� r� r� rc rc rc rd r6 � s r6 c @ s e Zd ZdZdd� ZdS )r7 rZ c C s" |j }| �d|||�}| �� |S �N�proxy-authenticate�r� r� r� )r� r� r r r� r� rJ r� rc rc rd �http_error_407� s �z$ProxyBasicAuthHandler.http_error_407N)r� r� r� r� r� rc rc rc rd r7 � s r7 c @ sN e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dS )r8 Nc C s4 |d u rt � }|| _| jj| _d| _d| _d | _d S r� )r3 rd ro r� � nonce_count�
last_nonce)r� rd rc rc rd r� s
z"AbstractDigestAuthHandler.__init__c C s
d| _ d S r� r� r� rc rc rd r� s z+AbstractDigestAuthHandler.reset_retry_countc C s| |� |d �}| jdkr*t|jdd|d ��n| jd7 _|rx|�� d }|�� dkr`| �||�S |�� dkrxtd| ��d S ) Nr� r� zdigest auth failedr r �digestr� zEAbstractDigestAuthHandler does not support the following scheme: '%s')r� r� r r� r� r� �retry_http_digest_authrS )r� r� r� r� r� r� r< rc rc rd r� s
� �z/AbstractDigestAuthHandler.http_error_auth_reqedc C sz |� dd�\}}ttd t|���}| �||�}|rvd| }|j�| jd �|krRd S |�| j|� | j j
||j d�}|S d S )Nr) r z Digest %sr; ) r� �parse_keqv_listr �parse_http_list�get_authorizationr� r� r� r� r r r` )r� r� r� �token� challenge�chal�auth_val�resprc rc rd r� ( s z0AbstractDigestAuthHandler.retry_http_digest_authc C s@ d| j |t�� f }|�d�td� }t�|��� }|d d� S )Nz %s:%s:%s:rY � � )r� �time�ctimer_ � _randombytes�hashlib�sha1� hexdigest)r� �nonce�s�b�digrc rc rd �
get_cnonce4 s z$AbstractDigestAuthHandler.get_cnoncec C s� z6|d }|d }|� d�}|� dd�}|� dd �}W n tyJ Y d S 0 | �|�\}} |d u rfd S | j�||j�\}
} |
d u r�d S |jd ur�| �|j|�} nd } d|
|| f }
d|�� |j f }|d k�r.|| j
kr�| j d
7 _ n d
| _ || _
d | j }| � |�}d ||||||�f }| ||
�|�}n2|d u �rT| ||
�d|||�f �}n t
d
| ��d|
|||j |f }|�r�|d| 7 }| �r�|d| 7 }|d| 7 }|�r�|d||f 7 }|S )Nrm r� �qop� algorithm�MD5�opaquez%s:%s:%srX r� r z%08xz%s:%s:%s:%s:%szqop '%s' is not supported.z>username="%s", realm="%s", nonce="%s", uri="%s", response="%s"z
, opaque="%s"z
, digest="%s"z, algorithm="%s"z , qop=auth, nc=%s, cnonce="%s")r� �KeyError�get_algorithm_implsrd rw r� r_ �get_entity_digestr� r� r� r� r� r )r� r� r� rm r� r� r� r� �H�KDrN r� �entdig�A1�A2�ncvalue�cnonce�noncebit�respdigr~ rc rc rd r� ? s\
�
�� z+AbstractDigestAuthHandler.get_authorizationc s6 |dkrdd� � n|dkr"dd� � � fdd�}� |fS )Nr� c S s t �| �d���� S �NrY )r� �md5r_ r� ��xrc rc rd rU ~ rk z?AbstractDigestAuthHandler.get_algorithm_impls.<locals>.<lambda>�SHAc S s t �| �d���� S r� )r� r� r_ r� r� rc rc rd rU � rk c s � d| |f �S )NrX rc )r� �d�r� rc rd rU � rk rc )r� r� r� rc r� rd r� { s
z-AbstractDigestAuthHandler.get_algorithm_implsc C s d S re rc )r� r_ r� rc rc rd r� � s z+AbstractDigestAuthHandler.get_entity_digest)N) r� r� r� r� r� r� r� r� r� r� r� rc rc rc rd r8 � s
<
r8 c @ s e Zd ZdZdZdZdd� ZdS )r9 z�An authentication protocol defined by RFC 2069
Digest authentication improves on basic authentication because it
does not transmit passwords in the clear.
r� �� c C s* t |j�d }| �d|||�}| �� |S )Nr r� )r r� r� r� �r� r� r r r� r� r� �retryrc rc rd r� � s �z$HTTPDigestAuthHandler.http_error_401N)r� r� r� r! r� r r� rc rc rc rd r9 � s r9 c @ s e Zd ZdZdZdd� ZdS )r: �Proxy-Authorizationr� c C s" |j }| �d|||�}| �� |S r� r� r� rc rc rd r� � s �z%ProxyDigestAuthHandler.http_error_407N)r� r� r� r� r r� rc rc rc rd r: � s r: c @ s. e Zd Zd dd�Zdd� Zdd� Zdd � Zd
S ) �AbstractHTTPHandlerr c C s
|| _ d S re �� _debuglevel)r� �
debuglevelrc rc rd r� � s z AbstractHTTPHandler.__init__c C s
|| _ d S re r� )r� �levelrc rc rd �set_http_debuglevel� s z'AbstractHTTPHandler.set_http_debuglevelc
C sN |j }|std��|jd ur�|j}t|t�r8d}t|��|�d�sN|�dd� |�d�s�d }z:tr~t|t j �r~t
|�|j }nt |�}t
|�|j }W n0 ty� t|t
�r�tdt|�|f ��Y n0 |�dd| � |}|�� r�t|j�\}} t| �\}}
|�d��s|�d|� | jjD ]*\} } | �� } |�| ��s |�| | � �q |S ) N�
no host givenzLPOST data should be bytes or an iterable of bytes. It cannot be of type str.z Content-type�!application/x-www-form-urlencodedzContent-lengthzBContent-Length should be specified for iterable data of type %r %rz%dr� )r� r r_ r� r
r� r� r� r �arrayrz �itemsize�
memoryviewr* rS r� r� r r� r r r� r� )
r� r� r� r_ r� r� �mv�sel_hostr< �sel�sel_pathrv r� rc rc rd � do_request_� sR
�
�� � z AbstractHTTPHandler.do_request_c
s4 |j }|std��||fd|ji|��}t|j�� � �t� fdd�|j�� D ��� d� d< tdd� � �� D ��� |jr�i }d}|� v r�� | ||< � |= |j |j|d � z |�
|� � |j |j
� � W n6 tjy� } z |�� t|��W Y d
}~n*d
}~0 0 |�� } |j�r |j�� d
|_|�� | _| j| _| S ) z�Return an HTTPResponse object for the request, using http_class.
http_class must implement the HTTPConnection API from http.client.
r� r` c 3 s" | ]\}}|� vr||fV qd S re rc r* �r� rc rd r0 � s
�z.AbstractHTTPHandler.do_open.<locals>.<genexpr>r� �
Connectionc s s | ]\}}|� � |fV qd S re )�title)r+ rv r� rc rc rd r0 � rk r� r� N)r� r r` r r� r� r� r� r� �
set_tunnelr� r� r� r_ r r� r� � getresponse�sockr� r^ �reasonr� )
r� �
http_classr� �http_conn_argsr� r �tunnel_headers�proxy_auth_hdr�errrT rc r� rd r� � s6
"
zAbstractHTTPHandler.do_openN)r )r� r� r� r� r� r� r� rc rc rc rd r� � s
3r� c @ s e Zd Zdd� ZejZdS )r; c C s | � tj|�S re )r� r �HTTPConnection�r� r� rc rc rd � http_open$ s zHTTPHandler.http_openN)r� r� r� r� r� r� � http_requestrc rc rc rd r; " s r; r
c @ s$ e Zd Zddd�Zdd� ZejZdS )r\ r Nc C s t �| |� || _|| _d S re )r� r� �_context�_check_hostname)r� r� rP rQ rc rc rd r� - s zHTTPSHandler.__init__c C s | j tj|| j| jd�S )NrO )r� r r
r� r� r� rc rc rd �
https_open2 s
�zHTTPSHandler.https_open)r NN)r� r� r� r� r� r� r� �
https_requestrc rc rc rd r\ + s
r\ c @ s. e Zd Zddd�Zdd� Zdd� ZeZeZdS ) r1 Nc C s2 dd l m m m} |d u r(|�� }|| _d S r� )Z future.backports.http.cookiejar� backportsr � cookiejar� CookieJar)r� r� �http_cookiejarrc rc rd r� ; s z HTTPCookieProcessor.__init__c C s | j �|� |S re )r� �add_cookie_header)r� r� rc rc rd r� A s z HTTPCookieProcessor.http_requestc C s | j �||� |S re )r� �extract_cookies)r� r� r� rc rc rd r E s z!HTTPCookieProcessor.http_response)N)r� r� r� r� r� r r� r" rc rc rc rd r1 : s
r1 c @ s e Zd Zdd� ZdS )r? c C s |j }td| ��d S )Nzunknown url type: %s)r� r )r� r� r� rc rc rd r� M s zUnknownHandler.unknown_openN)r� r� r� r� rc rc rc rd r? L s r? c C sN i }| D ]@}|� dd�\}}|d dkr@|d dkr@|dd� }|||< q|S )z>Parse list of key=value strings where keys are not duplicated.�=r r r� rj )r� )�l�parsed�eltr, r- rc rc rd r� Q s
r� c C s� g }d}d }}| D ]l}|r*||7 }d}q|rT|dkr>d}qn |dkrJd}||7 }q|dkrl|� |� d}q|dkrxd}||7 }q|r�|� |� dd� |D �S ) ap Parse lists as described by RFC 2068 Section 2.
In particular, parse comma-separated lists where the elements of
the list may include quoted-strings. A quoted-string could
contain a comma. A non-quoted string could have quotes in the
middle. Neither commas nor quotes count if they are escaped.
Only double-quotes count, not single-quotes.
r� F�\Tr� �,c S s g | ] }|� � �qS rc ��strip)r+ �partrc rc rd rj � rk z#parse_http_list.<locals>.<listcomp>)rx )r� �resr �escaper �currc rc rd r� [ s4
r� c @ s( e Zd Zdd� ZdZdd� Zdd� ZdS )r< c C s\ |j }|d d� dkrN|dd� dkrN|jrN|jdkrN|j| �� urXtd��n
| �|�S d S )Nr rG rK r9 � localhost�-file:// scheme is supported only on localhost)r� r� � get_namesr �open_local_file)r� r� r^ rc rc rd � file_open� s &�
zFileHandler.file_openNc C s^ t jd u rXz*tt�d�d t�t�� �d �t _W n" tjyV t�d�ft _Y n0 t jS )Nr r )r< �namesrl r �gethostbyname_ex� gethostname�gaierror�
gethostbynamer� rc rc rd r � s
��
zFileHandler.get_namesc
C s dd l m m m} dd l}|j}|j}t|�}z�t� |�}|j
}|j |j dd�} |�
|�d }
t�d|
ppd|| f �} |r�t|�\}} |r�| s�t|�| �� v r�|r�d| | }
nd| }
tt|d�| |
�W S W n. t�y } zt|��W Y d }~n
d }~0 0 td��d S ) Nr T��usegmtz6Content-type: %s
Content-length: %d
Last-modified: %s
�
text/plain�file://�rbzfile not on local host)� future.backports.email.utilsr� r �utils� mimetypesr� r� rE rq �stat�st_size�
formatdate�st_mtime�
guess_type�message_from_stringr �_safe_gethostbynamer r( r �OSErrorr )r� r� � email_utilsr r� r| � localfile�statsr� �modified�mtyper� rz �origurl�exprc rc rd r � s:
�� �� zFileHandler.open_local_file)r� r� r� r r r r rc rc rc rd r< � s
r< c C s( z t �| �W S t jy" Y d S 0 d S re )r r r �r� rc rc rd r$ � s r$ c @ s e Zd Zdd� Zdd� ZdS )r= c
C s& dd l }dd l}|j}|s"td��t|�\}}|d u r>|j}nt|�}t|�\}}|rdt|�\}}nd }t |�}|pvd}|p~d}zt
� |�}W n. t
j y� } zt|��W Y d }~n
d }~0 0 t
|j�\} }
| �d�} ttt | ��} | d d� | d } } | �r| d �s| dd � } z�| �||||| |j�}
| �r:d�p<d}|
D ]2}t|�\}}|�� d k�rB|d
v �rB|�� }�qB|
�| |�\}}d}|�|j�d }|�r�|d | 7 }|d u�r�|dk�r�|d | 7 }t�|�}t |||j�W S |j �y } z td
| �}t |� W Y d }~n
d }~0 0 d S )Nr �ftp error: no host givenr� r9 rj r r� �Dr� ��a�Ar� r� r� r/ zContent-type: %s
zContent-length: %d
�
ftp error: %r) �ftplibr r� r r �FTP_PORTr
r r! r r r r� r" r� r� r� r � connect_ftpr` r$ r� �upper�retrfiler" r� r r# r( �
all_errorsr )r� r� r4 r r� rz rN rd r� rr �attrs�dirsrf �fwr� �attrr� r �retrlenr� r* r, �excrc rc rd �ftp_open� s^
�
zFTPHandler.ftp_openc C s t ||||||dd�S )NF)�
persistent)�
ftpwrapper)r� rN rd r� rz r; r` rc rc rd r6 � s �zFTPHandler.connect_ftpN)r� r� r� r@ r6 rc rc rc rd r= � s 5r= c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
S )r> c C s" i | _ i | _d| _d| _d| _d S )Nr �< r� )�cacher` �soonest�delay� max_connsr� rc rc rd r� � s
zCacheFTPHandler.__init__c C s
|| _ d S re )rF )r� �trc rc rd �
setTimeout s zCacheFTPHandler.setTimeoutc C s
|| _ d S re )rG )r� r3 rc rc rd � setMaxConns s zCacheFTPHandler.setMaxConnsc C sr |||d� |�|f}|| jv r4t�� | j | j|< n,t||||||�| j|< t�� | j | j|< | �� | j| S )Nr9 )�joinrD r� rF r` rB � check_cache)r� rN rd r� rz r; r` r� rc rc rd r6
s
�
zCacheFTPHandler.connect_ftpc C s� t � � }| j|krPt| j�� �D ].\}}||k r | j| �� | j|= | j|= q tt| j�� ��| _t | j�| j
kr�t| j�� �D ]&\}}|| jkr�| j|= | j|= q�q�tt| j�� ��| _d S re ) r� rE r� r` r� rD r� �min�valuesrz rG )r� rH r, r- rc rc rd rL s
zCacheFTPHandler.check_cachec C s0 | j �� D ] }|�� q
| j �� | j�� d S re )rD rN r� �clearr` )r� �connrc rc rd � clear_cache) s
zCacheFTPHandler.clear_cacheN) r� r� r� r� rI rJ r6 rL rQ rc rc rc rd r> � s r> r$ �nt)rE rD c C s t | �S )zOS-specific conversion from a relative URL of the 'file' scheme
to a file system path; not recommended for general use.)r ��pathnamerc rc rd rE 8 s rE c C s t | �S )zOS-specific conversion from a file system path to a relative URL
of the 'file' scheme; not recommended for general use.)r rS rc rc rd rD = s rD c @ s� e Zd ZdZdZde Zd*dd�Zdd� Zdd � Z d
d � Z
d d
� Z d+dd�Z d,dd�Z
d-dd�Zd.dd�Zdd� Zd/dd�Zd0dd�Zd d � Zer�d d � Zd1d d!�Zd"d#� Zd$d%� Zd&d'� Zd2d(d)�ZdS )3rI a, Class to open URLs.
This is a class rather than just a subroutine because we may need
more than one set of global protocol-specific options.
Note -- this is a base class for those who don't want the
automatic handling of errors type 302 (relocated) and 401
(authorization needed).Nr� c K s� dd| j ji }tj|tdd� |d u r.t� }t|d�s@J d��|| _|�d�| _ |�d�| _
d | j fg| _ g | _
tj| _d | _t| _d S )
NzW%(class)s style of invoking requests is deprecated. Use newer urlopen functions/methods�classrK r� rR rS �key_file� cert_filez
User-Agent)� __class__r� r� r� r� rF r� rV r� rV rW �versionr� �_URLopener__tempfilesrq r� �_URLopener__unlink� tempcache�ftpcache)r� rV �x509r� rc rc rd r� W s
� zURLopener.__init__c C s | � � d S re )r� r� rc rc rd �__del__q s zURLopener.__del__c C s | � � d S re )�cleanupr� rc rc rd r� t s zURLopener.closec C sT | j r@| j D ]&}z| �|� W q ty0 Y q 0 q | j d d �= | jrP| j�� d S re )rZ r[ r% r\ rO )r� rf rc rc rd r` w s
zURLopener.cleanupc G s | j �|� dS )zdAdd a header to be used by the HTTP interface only
e.g. u.addheader('Accept', 'sound/basic')N)r� rx )r� r� rc rc rd � addheader� s zURLopener.addheaderc
C sZ t t|��}t|dd�}| jrL|| jv rL| j| \}}t|d�}t|||�S t|�\}}|s`d}|| jv r�| j| }t|�\}} t| �\}
} |
|f}nd}d| } || _ | �
dd�} t | | �s�|r�| � |||�S | �
||�S z.|du r�t| | �|�W S t| | �||�W S W nJ t�y � Y n6 tj�yT }
zttd |
�� W Y d}
~
n
d}
~
0 0 dS )
z6Use URLopener().open(file) instead of open(file, 'r').z%/:=&?~#+!$,;'@()*[]|��safer rf N�open_�-r� z socket error)r r& r r\ r r( r rV r r� r1 r� �open_unknown_proxy� open_unknownr� r r r� r �IOError)r� r� r_ r| r� r �urltyper^ rH � proxyhostr� r� rv r� rc rc rd r � s<
zURLopener.openc C s t |�\}}tdd|��dS )�/Overridable interface to open unknown URL type.� url errorzunknown url typeN�r rh )r� r� r_ r� r^ rc rc rd rg � s zURLopener.open_unknownc C s t |�\}}tdd| |��dS )rk rl zinvalid proxy for %sNrm )r� rH r� r_ r� r^ rc rc rd rf � s z URLopener.open_unknown_proxyc
C s6 t t|��}| jr&|| jv r&| j| S t|�\}}|du r�|rF|dkr�z0| �|�}|�� }|�� tt|�d �|fW S t y� } z W Y d} ~ n
d} ~ 0 0 | �
||�}�zV|�� }
|r�t
|d�} n|ddl } t|�\}
}t|p�d�\}
}t |p�d�\}}
t
|�pd�\}}
tj�|�d }| �|�\}}| j�|� t�|d�} z�||
f}| jdu�r`|| j|< d}d}d}d}d |
v �r�t|
d
�}|�r�||||� |�|�}|�s��q�|t|�7 }| �|� |d7 }|�r�||||� �q�W | �� n
| �� 0 W |�� n
|�� 0 |dk�r2||k �r2td ||f |��|S ) ztretrieve(url) returns (filename, headers) for a local object
or (tempfilename, headers) for a remote object.Nrf r rg r r� ri rj rk rl rm )r r& r\ r r rp r� rE r rh r rt r# r" rq rr �splitext�mkstemprZ rx �fdopenr
ry rz r{ r )r� r^ r| r} r_ r� �url1r r� r� r� r� rt �garbagerr �suffix�fdr� r� r� ry r� r� rc rc rd �retrieve� sp
��zURLopener.retrievec C s d}d}t |t�r<t|�\}}|r6t|�\}}t|�}|}nt|\}}t|�\}}t|�\} }
|
}d}| �� dkrvd}n:t|
�\}}
|r�t|�\}}|r�d| ||
f }t|�r�|}|s�tdd��|r�t|�}t �
|� � �� d�} nd} |�rt|�}t �
|� � �� d�} nd} ||�}
i }| �r*d| |d< | �r<d| |d < |�rJ||d
< d |d < | j
D ]\}}|||< �qX|du�r�d
|d< |
�d|||� n|
jd||d� z |
�� }W n tj�y� td��Y n0 d|j k�r�dk �r n nt||jd| |j�S | �||j|j|j|j|�S dS )a� Make an HTTP connection using connection_class.
This is an internal method that should be called from
open_http() or open_https().
Arguments:
- connection_factory should take a host name and return an
HTTPConnection instance.
- url is the url to retrieval or a host, relative-path pair.
- data is payload for a POST request or None.
Nr z %s://%s%sz
http errorr� rY zBasic %sr� r� r� r� r� r� z Content-Typer� r� r� z$http protocol error: bad status liner r �http:)r� r
r r r r r� r\ rh r] r^ r_ r� r� r� r� r �
BadStatusLiner �statusr( r� �
http_errorr r� )r� �connection_factoryr^ r_ � user_passwd� proxy_passwdr� r� �realhostri r� �
proxy_authr� � http_connr� �headerr� r� rc rc rd �_open_generic_http� st
��z URLopener._open_generic_httpc C s | � tj||�S )zUse HTTP protocol.)r� r r� �r� r^ r_ rc rc rd � open_httpX s zURLopener.open_httpc
C sb d| }t | |�rPt| |�}|du r6||||||�} n|||||||�} | rP| S | �|||||�S )z�Handle http errors.
Derived class can override this, or provide specific handlers
named http_error_DDD where DDD is the 3-digit error code.z
http_error_%dN)r� r� r )
r� r^ r �errcode�errmsgr� r_ rv r� r� rc rc rd ry \ s
zURLopener.http_errorc C s |� � t||||d��dS )z>Default error handler: close the connection and raise IOError.N)r� r �r� r^ r r� r� r� rc rc rd r l s z URLopener.http_error_defaultc C s t j|| j| jd�S )N)rV rW )r r
rV rW )r� r� rc rc rd �_https_connectionr s �zURLopener._https_connectionc C s | � | j||�S )zUse HTTPS protocol.)r� r� r� rc rc rd �
open_httpsw s zURLopener.open_httpsc C s^ t |t�std��|dd� dkrP|dd� dkrP|dd� �� dkrPtd ��n
| �|�S dS )
z/Use local file or FTP depending on form of URL.zEfile error: proxy support for file protocol currently not implementedNr rG rK r9 � z
localhost/r
)r� r
r r� rS r )r� r^ rc rc rd � open_file{ s
4
zURLopener.open_filec
C sl ddl m m m} ddl}t|�\}}t|�}zt�|�}W n2 t yt } zt
|j |j ��W Y d}~n
d}~0 0 |j
} |j|jdd�}
|�|�d } t�d| p�d| |
f �} |s�|}
|dd� dkr�d | }
tt|d
�| |
�S t|�\}}|�s`t�|�t� ft� v �r`|}
|dd� dk�r0d | }
n |dd � d k�rNtd
| ��tt|d
�| |
�S t
d��dS )zUse local file.r NTr z6Content-Type: %s
Content-Length: %d
Last-modified: %s
r r r9 r r r z./zAlocal file url may start with / or file:. Unknown url of type: %sz#local file error: not on local host)r r� r r r r rE rq r r% r �strerrorr| r r r! r" r# r( r r r r r �thishostrS )r� r^ r& r r� rf � localnamer( �er� r) r* r� �urlfilerz rc rc rd r � s@ $ �� �
zURLopener.open_local_filec
C s� t |t�std��ddl}t|�\}}|s2td��t|�\}}t|�\}}|r\t|�\}}nd}t|�}t|ppd�}t|p|d�}t �
|�}|s�ddl }|j }nt
|�}t|�\}} t|�}|�d�}
|
dd� |
d }
} |
r�|
d s�|
dd� }
|
�r
|
d �s
d|
d< |||d�|
�f} t| j�tk�rb| j�� D ]*}
|
| k�r6| j|
}| j|
= |�� �q6z�| | jv�r�t|||||
�| j| < | �s�d }nd
}| D ]2}t|�\}}|�� d k�r�|d v �r�|�� }�q�| j| �| |�\}}|�d
| �d }d}|�r |d| 7 }|du�r,|dk�r,|d| 7 }t � |�}t ||d
| �W S t � �y~ } z t td| �� W Y d}~n
d}~0 0 dS )zUse FTP protocol.zCftp error: proxy support for ftp protocol currently not implementedr Nr. r� r9 rj r r/ r� r� r0 zftp:zContent-Type: %s
zContent-Length: %d
z ftp error %r)!r� r
r r r r r r! r r r r4 r5 r
r" r� rK rz r] � MAXFTPCACHErR r� rB r$ r� r7 r8 r" r r# r( � ftperrorsr )r� r^ r r� rr rz rN rd r4 r: r; rf r� r, r- r� r= r� r r> r* r� r, rc rc rd �open_ftp� sj
� �
zURLopener.open_ftpc
C s: t |t�std��z|�dd�\}}W n tyB tdd��Y n0 |sLd}|�d�}|dkr�d ||d
� vr�||d d
� }|d
|� }nd }g }|�d t� d
t�
t�� �� � |�d| � |dkr�t � |�
d���d�}nt|�}|�dt|� � |�d � |�|� d�|�}t�|�}t�|�}t|||�S )zUse "data" URL.zEdata error: proxy support for data protocol currently not implementedr r z
data errorz bad data URLztext/plain;charset=US-ASCII�;r r Nr� zDate: %sz%a, %d %b %Y %H:%M:%S GMTzContent-type: %sr] rY zlatin-1zContent-Length: %d�
)r� r
r r� rS rh �rfindrx r� �strftime�gmtimer] � decodebytesr_ r� r rz rK r r# �io�StringIOr( ) r� r^ r_ r� �semi�encodingr� r� �frc rc rd � open_data� s8
�
zURLopener.open_data)N)N)N)N)NNN)N)N)N)N)r� r� r� r! rZ r� rY r� r_ r� r` ra r rg rf ru r� r� ry r rR r� r� r� r r� r� rc rc rc rd rI J s.
$
B\
:rI c @ s� e Zd ZdZdd� Zdd� Zd#dd�Zd d
� Zd$d d �Zd%d
d�Z d&dd�Z
d'dd�Z d(dd�Z d)dd�Z
d*dd�Zd+dd�Zd,d d �Zd-d d �Zd!d"� ZdS ).rJ z?Derived class with handlers for errors we can handle (perhaps).c O s. t j| g|�R i |�� i | _d| _d| _d S )Nr r$ )rI r� �
auth_cache�tries�maxtries)r� r� �kwargsrc rc rd r� s zFancyURLopener.__init__c C s t ||d| |�S )z3Default error handling -- don't raise an exception.rv )r( r� rc rc rd r s z!FancyURLopener.http_error_defaultNc C sl | j d7 _ | jrN| j | jkrNt| d�r2| j}n| j}d| _ |||dd|�S | �||||||�}d| _ |S )z%Error 302 -- relocated (temporarily).r �http_error_500r r z)Internal Server Error: Redirect Recursion)r� r� r� r� r �redirect_internal) r� r^ r r� r� r� r_ r� r� rc rc rd rC s
��z FancyURLopener.http_error_302c C sx d|v r|d }nd|v r$|d }nd S |� � t| jd | |�}t|�}|jdvrnt|||d| ||��| �|�S )Nr5 r6 �:r7 z( Redirection to url '%s' is not allowed.)r� r r� r r< r r ) r� r^ r r� r� r� r_ r2 r@ rc rc rd r� % s
��z FancyURLopener.redirect_internalc C s | � ||||||�S )z*Error 301 -- also relocated (permanently).�rC �r� r^ r r� r� r� r_ rc rc rd rD A s z FancyURLopener.http_error_301c C s | � ||||||�S )z;Error 303 -- also relocated (essentially identical to 302).r� r� rc rc rd rE E s z FancyURLopener.http_error_303c C s2 |du r | � ||||||�S | �|||||�S dS )z1Error 307 -- relocated, but turn POST into error.N)rC r r� rc rc rd rF I s z FancyURLopener.http_error_307Fc
C s� d|vr t �| |||||� |d }t�d|�} | sHt �| |||||� | �� \}
} |
�� dkrtt �| |||||� |s�t �| |||||� d| j d } |du r�t| | �|| �S t| | �|| |�S dS )z_Error 401 -- authentication required.
This function supports Basic authentication only.r� �![ ]*([^ ]+)[ ]+realm="([^"]*)"r� �retry_� _basic_authN�rI r r� �matchr� r� r� r� �
r� r^ r r� r� r� r_ r� �stuffr� r< rm rv rc rc rd r� P s.
�
�
��z FancyURLopener.http_error_401c
C s� d|vr t �| |||||� |d }t�d|�} | sHt �| |||||� | �� \}
} |
�� dkrtt �| |||||� |s�t �| |||||� d| j d } |du r�t| | �|| �S t| | �|| |�S dS )zeError 407 -- proxy authentication required.
This function supports Basic authentication only.r� r� r� � retry_proxy_r� Nr� r� rc rc rd r� i s.
�
�
��z FancyURLopener.http_error_407c C s� t |�\}}d| | }| jd }t|�\}} t | �\} }
| �d�d } | | d � } | �| || �\} }
| sr|
srd S dt| dd�t|
dd�| f } d| |
| jd< |d u r�| �|�S | �||�S d S )N�http://r �@r �%s:%s@%sr� rb �r rV r r� �get_user_passwdr r �r� r^ rm r_ r� r� r2 rH ri rj �
proxyselectorr� rN rd rc rc rd �retry_proxy_http_basic_auth� s
�
z*FancyURLopener.retry_proxy_http_basic_authc C s� t |�\}}d| | }| jd }t|�\}} t | �\} }
| �d�d } | | d � } | �| || �\} }
| sr|
srd S dt| dd�t|
dd�| f } d| |
| jd< |d u r�| �|�S | �||�S d S )N�https://r� r� r r� r� rb r� r� rc rc rd � retry_proxy_https_basic_auth� s
�
z+FancyURLopener.retry_proxy_https_basic_authc
C s� t |�\}}|�d�d }||d � }| �|||�\}}|sD|sDd S dt|dd�t|dd�|f }d| | } |d u r�| �| �S | �| |�S d S )Nr� r r� r� rb r� �r r� r� r r �
r� r^ rm r_ r� r� r� rN rd r2 rc rc rd r� � s �
z$FancyURLopener.retry_http_basic_authc
C s� t |�\}}|�d�d }||d � }| �|||�\}}|sD|sDd S dt|dd�t|dd�|f }d| | } |d u r�| �| �S | �| |�S d S )Nr� r r� r� rb r� r� r� rc rc rd �retry_https_basic_auth� s �
z%FancyURLopener.retry_https_basic_authr c C s` |d |� � }|| jv r2|r(| j|= n
| j| S | �||�\}}|sJ|rX||f| j|< ||fS )Nr� )r� r� �prompt_user_passwd)r� r� rm rQ r� rN rd rc rc rd r� � s
z FancyURLopener.get_user_passwdc C sV ddl }z.td||f �}|� d|||f �}||fW S tyP t� Y dS 0 dS )z#Override this in a GUI environment!r Nz Enter username for %s at %s: z#Enter password for %s in %s at %s: rp )�getpassr �KeyboardInterrupt�print)r� r� rm r� rN rd rc rc rd r� � s �
z!FancyURLopener.prompt_user_passwd)N)N)N)N)NF)NF)N)N)N)N)r )r� r� r� r! r� r rC r� rD rE rF r� r� r� r� r� r� r� r� rc rc rc rd rJ s(
�
�
rJ c C s t du rt�d�a t S )z8Return the IP address of the magic hostname 'localhost'.Nr )�
_localhostr r rc rc rc rd r � s
r c C sN t du rJztt�t�� �d �a W n& tjyH tt�d�d �a Y n0 t S )z,Return the IP addresses of the current host.Nr r )� _thishostrl r r r r rc rc rc rd r� � s r� c C s t du rddl} | ja t S )z1Return the set of errors raised by the FTP class.Nr )�
_ftperrorsr4 r9 )r4 rc rc rd r� � s r� c C s t du rt�d�a t S )z%Return an empty email Message object.Nr� )�
_noheadersr r# rc rc rc rd � noheaders� s
r� c @ sJ e Zd ZdZddd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dS )rB z;Class used by open_ftp() for cache of open FTP connections.NTc C s< || _ || _|| _|| _|| _|| _d| _|| _| �� d S r� ) rN rd r� rz r; r` �refcount� keepalive�init)r� rN rd r� rz r; r` rA rc rc rd r� s zftpwrapper.__init__c C s\ dd l }d| _|�� | _| j�| j| j| j� | j�| j | j
� d� | j �}| j�
|� d S )Nr r9 )r4 �busy�FTPr8 �connectr� rz r` �loginrN rd rK r; �cwd)r� r4 �_targetrc rc rd r� s
zftpwrapper.initc
C s� dd l }| �� |dv r"d}d}n d| }d}z| j�|� W n( |jyf | �� | j�|� Y n0 d }|r�|s�z d| }| j�|�\}}W nJ |jy� } z0t|�d d� dkr�t t
d | �� W Y d }~n
d }~0 0 |�s�| j�d� |�rx| j� � } z`z| j� |� W n> |j�yN } z"t
d | �}
||
_
|
�W Y d }~n
d }~0 0 W | j� | � n| j� | � 0 d
| }nd }| j�|�\}}d| _t|�d �| j�} | jd7 _|�� | |fS )
Nr )r� r/ zTYPE Ar zTYPE zRETR rK �550r3 zLIST �LISTr )r4 � endtransferr8 �voidcmdr9 r� � ntransfercmd�
error_permr
r r �pwdr� � __cause__r� r) �makefile�
file_closer� r� ) r� rf r� r4 �cmd�isdirrP r> r� r� r? �ftpobjrc rc rd r8 sJ &
zftpwrapper.retrfilec C s
d| _ d S r� )r� r� rc rc rd r� K s zftpwrapper.endtransferc C s d| _ | jdkr| �� d S )NFr )r� r� �
real_closer� rc rc rd r� N s
zftpwrapper.closec C s2 | � � | jd8 _| jdkr.| js.| �� d S )Nr r )r� r� r� r� r� rc rc rd r� S s zftpwrapper.file_closec C s0 | � � z| j�� W n t� y* Y n0 d S re )r� r8 r� r� r� rc rc rd r� Y s
zftpwrapper.real_close)NT) r� r� r� r! r� r� r8 r� r� r� r� rc rc rc rd rB s �
0rB c C sH i } t j�� D ]4\}}|�� }|r|dd� dkr|| |dd� < q| S )a Return a dictionary of scheme -> proxy server URL mappings.
Scan the environment for variables named <scheme>_proxy;
this seems to be the standard convention. If you need a
different way, you can pass a proxies dictionary to the
[Fancy]URLopener constructor.
i����N�_proxy)rq �environr� r� )rV rv r� rc rc rd �getproxies_environmenta s r� c C st t j�dd�pt j�dd�}|dkr(dS t| �\}}dd� |�d�D �}|D ]"}|rL|�|�sh| �|�rL dS qLd S )
z�Test if proxies should not be used for a particular host.
Checks the environment for a variable named no_proxy, which should
be a list of DNS suffixes separated by commas, or '*' for all hosts.
�no_proxyr� ZNO_PROXY�*r c S s g | ] }|� � �qS rc r )r+ rH rc rc rd rj ~ rk z,proxy_bypass_environment.<locals>.<listcomp>r r )rq r� r� r r� �endswith)r� r� �hostonlyrz Z
no_proxy_listrv rc rc rd �proxy_bypass_environmentq s r� c C s ddl m } t| �\}}dd� }d| vr4|d r4dS d}|�d d
�D ]�}|sNqDt�d |�}|du�r|du r�zt�|�}||�}W n tjy� Y qDY n0 ||�d ��} |�d
�}
|
du r�d|�d �� d�d }
nt
|
d d� �}
d|
}
||
? | |
? k�r dS qD|| |�rD dS qDdS )aj
Return True iff this host shouldn't be accessed using a proxy
This function uses the MacOSX framework SystemConfiguration
to fetch the proxy information.
proxy_settings come from _scproxy._get_proxy_settings or get mocked ie:
{ 'exclude_simple': bool,
'exceptions': ['foo.bar', '*.bar.com', '127.0.0.1', '10.1', '10.0/16']
}
r )�fnmatchc S sd | � d�}ttt|��}t|�dkr8|g d� d d� }|d d> |d d> B |d d > B |d
B S ) N�.r# )r r r r r � r r� r r� rK )r� r� r r
rz )�ipAddrry rc rc rd �ip2num� s
z,_proxy_bypass_macosx_sysconf.<locals>.ip2numr� �exclude_simpleTN�
exceptionsrc z(\d+(?:\.\d+)*)(/\d+)?r r r� � F) r� r r� r� r� r r r� �group�countr
) r� �proxy_settingsr� r� rz r� �hostIPr� r3 r~ �maskrc rc rd � _proxy_bypass_macosx_sysconf� s8
r� �darwin)�_get_proxy_settings� _get_proxiesc C s t � }t| |�S re )r� r� )r� r� rc rc rd �proxy_bypass_macosx_sysconf� s r� c C s t � S )z�Return a dictionary of scheme -> proxy server URL mappings.
This function uses the MacOSX framework SystemConfiguration
to fetch the proxy information.
)r� rc rc rc rd �getproxies_macosx_sysconf� s r� c C s t � rt| �S t| �S d S re )r� r� r� r- rc rc rd r\ � s r\ c C s t � p
t� S re )r� r� rc rc rc rd rF � s rF c
C s i } z ddl }W n ty& | Y S 0 z�|�|jd�}|�|d�d }|r�t|�|d�d �}d|v r�|�d�D ]4}|�dd�\}}t�d |�s�d
||f }|| |< qrn>|dd � d kr�|| d
< n$d| | d
< d| | d< d| | d< |� � W n t
t t f�y Y n0 | S )zxReturn a dictionary of scheme -> proxy server URL mappings.
Win32 uses the registry to store proxies.
r N�;Software\Microsoft\Windows\CurrentVersion\Internet Settings� ProxyEnableZ ProxyServerr r� r z ^([^/:]+)://z%s://%sr� rv r z http://%sz
https://%sr� zftp://%sr8 )
�winreg� ImportError�OpenKey�HKEY_CURRENT_USER� QueryValueExr
r� r� r� �Close� WindowsErrorrS r� )rV r� �internetSettings� proxyEnableZ proxyServer�pr� �addressrc rc rd �getproxies_registry� sF
�����
r c C s t � p
t� S )��Return a dictionary of scheme -> proxy server URL mappings.
Returns settings gathered from the environment, if specified,
or the registry.
)r� r rc rc rc rd rF
s c C sv z dd l }W n ty Y dS 0 z6|�|jd�}|�|d�d }t|�|d�d �}W n tyl Y dS 0 |rv|szdS t| �\}}|g} z t� |�}||kr�| �
|� W n tj y� Y n0 z t� |�}||kr�| �
|� W n tj y� Y n0 |�
d�}|D ]j} | dk�r$d|v�r$ dS | �dd �} | �d
d �} | �d d�} | D ] }
t�| |
tj��rL dS �qL�qdS )
Nr r� r� Z
ProxyOverrider� z<local>r� r z\.r� z.*�?)r� r� r� r� r� r
r r r r rx r� �getfqdnr� r1 r� r� r� ) r� r� r r Z
proxyOverrideZrawHostrz �addrZfqdnr r� rc rc rd �proxy_bypass_registry
s` �����
r
c C s t � rt| �S t| �S dS )r N)r� r� r
r- rc rc rd r\ H
s )NNN)�r! �
__future__r r r r Zfuture.builtinsr r r r r
r r r
Z future.utilsr r r r] r� r� r� Zfuture.backportsr Zfuture.backports.httpr r r� r r r �parser r r r r r r r r r r! r" r# r$ r% r& r' r� r( r) r� rq r| r� r �sysr� rt rn r� � collectionsr* �collections.abcrT r+ r� rR �__all__rY r� r] r rA rB rw rG rH r� �ASCIIr� r� �objectr, r- rC r. r@ r/ r0 rP r2 r3 r4 r5 r6 r7 �urandomr� r8 r9 r: r� r; r� r\ rx r1 r? r� r� r< r$ r= r> r� rv Z
nturl2pathrE rD r] rI rJ r� r r� r� r� r� r� r� rB r� r� r� �platformZ_scproxyr� r� r� r� r\ rF r r
rc rc rc rd �<module> s� V( L
?
y &hH*@
E z
+4:8 A U
^<
- 2
PK Du\_S}�e
e
8 future/backports/urllib/__pycache__/error.cpython-39.pycnu �[��� a
��?h�
� @ sp d Z ddlmZmZmZ ddlmZ ddlmZ g d�Z
G dd� de �Z G dd � d e e j
�ZG d
d � d e �Zd S )
a� Exception classes raised by urllib.
The base exception class is URLError, which inherits from IOError. It
doesn't define any behavior of its own, but is the base class for all
exceptions defined in this package.
HTTPError is an exception class that is also a valid HTTP response
instance. It behaves this way because HTTP protocol errors are valid
responses, with a status code, headers, and a body. In some contexts,
an application may want to handle an exception like a regular
response.
� )�absolute_import�division�unicode_literals)�standard_library)�response)�URLError� HTTPError�ContentTooShortErrorc @ s e Zd Zddd�Zdd� ZdS )r Nc C s |f| _ || _|d ur || _d S �N)�args�reason�filename)�selfr r
� r �G/usr/local/lib/python3.9/site-packages/future/backports/urllib/error.py�__init__ s zURLError.__init__c C s
d| j S )Nz<urlopen error %s>)r �r r r r �__str__& s zURLError.__str__)N)�__name__�
__module__� __qualname__r r r r r r r s
r c @ s< e Zd ZdZejjZdd� Zdd� Ze dd� �Z
dd � Z d
S ) r zBRaised when HTTP error occurs, but also acts like non-error returnc C s: || _ || _|| _|| _|| _|d ur6| �||||� d S r
)�code�msg�hdrs�fpr
�_HTTPError__super_init)r �urlr r r r r r r r - s zHTTPError.__init__c C s d| j | jf S )NzHTTP Error %s: %s)r r r r r r r : s zHTTPError.__str__c C s | j S r
)r r r r r r ? s zHTTPError.reasonc C s | j S r
)r r r r r �infoC s zHTTPError.infoN) r r r �__doc__�urllib_response�
addinfourlr r r �propertyr r r r r r r ) s
r c @ s e Zd Zdd� ZdS )r c C s t �| |� || _d S r
)r r �content)r �messager" r r r r I s z ContentTooShortError.__init__N)r r r r r r r r r H s r N)r �
__future__r r r �futurer Zfuture.backports.urllibr r �__all__�IOErrorr r r r r r r r �<module> s PK Du\^��� � > future/backports/urllib/__pycache__/robotparser.cpython-39.pycnu �[��� a
��?h� � @ s� d dl mZmZmZ d dlmZ d dlmZ d dlm Z
m Z e
e_ e e_ dgZ
G dd� de�ZG dd� de�ZG d d
� d
e�Zd S ) � )�absolute_import�division�unicode_literals��str)�urllib)�parse�request�RobotFileParserc @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )r
zs This class provides a set of methods to read, parse and answer
questions about a single robots.txt file.
� c C s, g | _ d | _d| _d| _| �|� d| _d S )NFr )�entries�
default_entry� disallow_all� allow_all�set_url� last_checked��self�url� r �M/usr/local/lib/python3.9/site-packages/future/backports/urllib/robotparser.py�__init__ s
zRobotFileParser.__init__c C s | j S )z�Returns the time the robots.txt file was last fetched.
This is useful for long-running web spiders that need to
check for new robots.txt files periodically.
)r �r r r r �mtime& s zRobotFileParser.mtimec C s ddl }|� � | _dS )zYSets the time the robots.txt file was last fetched to the
current time.
r N)�timer )r r r r r �modified/ s zRobotFileParser.modifiedc C s& || _ tj�|�dd� \| _| _dS )z,Sets the URL referring to a robots.txt file.� � N)r r r �urlparse�host�pathr r r r r 7 s zRobotFileParser.set_urlc
C s~ zt j�| j�}W nJ t jjy\ } z.|jdv r8d| _n|jdkrHd| _W Y d}~n&d}~0 0 |� � }| �
|� d�� � � dS )z4Reads the robots.txt URL and feeds it to the parser.)i� i� Ti� Nzutf-8)
r r �urlopenr �error� HTTPError�coder r �readr �decode�
splitlines)r �f�err�rawr r r r% < s
zRobotFileParser.readc C s, d|j v r | jd u r(|| _n | j�|� d S �N�*)�
useragentsr
r �append)r �entryr r r �
_add_entryI s
zRobotFileParser._add_entryc C sn d}t � }|D �]D}|sH|dkr,t � }d}n |dkrH| �|� t � }d}|�d�}|dkrf|d|� }|�� }|stq|�dd�}t|�dkr|d �� �� |d< tj� |d �� �|d< |d dkr�|dkr�| �|� t � }|j
� |d � d}q|d dk�r&|dk�rT|j � t
|d d �� d}q|d d
kr|dkr|j � t
|d d �� d}q|dk�rj| �|� dS ) z�Parse the input lines from a robots.txt file.
We allow that a user-agent: line is not preceded by
one or more blank lines.
r r � �#N�:z
user-agentZdisallowFZallowT)�Entryr0 �find�strip�split�len�lowerr r �unquoter- r. � rulelines�RuleLine)r �lines�stater/ �line�ir r r r R sJ
zRobotFileParser.parsec C s� | j r
dS | jrdS tj�tj�|��}tj�dd|j|j|j |j
f�}tj� |�}|s\d}| j D ] }|�
|�rb|�|� S qb| jr�| j�|�S dS )z=using the parsed robots.txt decide if useragent can fetch urlFTr �/)r r r r r r: �
urlunparser �params�query�fragment�quoter �
applies_to� allowancer
)r � useragentr �
parsed_urlr/ r r r � can_fetch� s" �
zRobotFileParser.can_fetchc C s d� dd� | jD ��S )Nr c S s g | ]}t |�d �qS )�
r )�.0r/ r r r �
<listcomp>� � z+RobotFileParser.__str__.<locals>.<listcomp>)�joinr r r r r �__str__� s zRobotFileParser.__str__N)r )
�__name__�
__module__� __qualname__�__doc__r r r r r% r0 r rK rQ r r r r r
s
3c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r< zoA rule line is a single "Allow:" (allowance==True) or "Disallow:"
(allowance==False) followed by a path.c C s( |dkr|sd}t j�|�| _|| _d S )Nr T)r r rF r rH )r r rH r r r r � s zRuleLine.__init__c C s | j dkp|�| j �S r+ )r �
startswith)r �filenamer r r rG � s zRuleLine.applies_toc C s | j r
dp dd | j S )NZAllowZDisallowz: )rH r r r r r rQ � s zRuleLine.__str__N)rR rS rT rU r rG rQ r r r r r< � s r< c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r4 z?An entry has one or more user-agents and zero or more rulelinesc C s g | _ g | _d S )N)r- r; r r r r r � s zEntry.__init__c C sH g }| j D ]}|�d|dg� q
| jD ]}|�t|�dg� q&d�|�S )Nz User-agent: rL r )r- �extendr; r rP )r �ret�agentr? r r r rQ � s
z
Entry.__str__c C sF |� d�d �� }| jD ](}|dkr* dS |�� }||v r dS qdS )z2check if this entry applies to the specified agentrA r r, TF)r7 r9 r- )r rI rZ r r r rG � s
zEntry.applies_toc C s$ | j D ]}|�|�r|j S qdS )zZPreconditions:
- our agent applies to this entry
- filename is URL decodedT)r; rG rH )r rW r? r r r rH � s
zEntry.allowanceN)rR rS rT rU r rQ rG rH r r r r r4 � s
r4 N)�
__future__r r r Zfuture.builtinsr Zfuture.backportsr Zfuture.backports.urllibr �_parser �_request�__all__�objectr
r< r4 r r r r �<module> s PK Du\���ڥ � ; future/backports/urllib/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �J/usr/local/lib/python3.9/site-packages/future/backports/urllib/__init__.py�<module> � PK
Du\���!�p �p 8 future/backports/urllib/__pycache__/parse.cpython-39.pycnu �[��� a
��?hЋ � @ sN d Z ddlmZmZmZ ddlmZmZmZm Z m
Z
m Z ddl m
Z
ddlZddlZddlZg d�Zg d�Zg d�Zg d �Zg d
�Zg d �Zg d �Zd
ZdZi Zdd� ZdZ dZ dd� Z e e fdd�Z e e fdd�Z dd� Z!G dd � d e"�Z#G d d � d e"�Z$G d d � d e"�Z%G d!d"� d"e%e#�Z&G d#d$� d$e%e$�Z'dd%lm(Z( e(d&d'�Z)e(d(d)�Z*e(d*d+�Z+e&Z,G d,d&� d&e)e#�Z-G d-d(� d(e*e&�Z.G d.d*� d*e+e&�Z/G d/d0� d0e)e$�Z0G d1d2� d2e*e'�Z1G d3d4� d4e+e'�Z2d5d6� Z3e3� [3dd9d:�Z4d;d<� Z5d�d=d>�Z6d�d?d@�Z7dAdB� Z8dCdD� Z9d�dEdF�Z:dGdH� Z;dIZ<edJdK� e<D ��Z=dLdM� Z>e�?dN�Z@d�dQdR�ZAd�dTdU�ZBd�dVdW�ZCd�dXdY�ZDeEedZ��ZFeeF�ZGi ZHG d[d\� d\ejI�ZJd�d^d_�ZKd�d`da�ZLd�dbdc�ZMd�ddde�ZNdfdg� ZOdhdi� ZPdaQdjdk� ZRdaSdldm� ZTdaUdndo� ZVdaWdpdq� ZXdaYdrds� ZZda[d�dudv�Z\da]dwdx� Z^da_dydz� Z`d{d|� Zadabd}d~� ZcdS )�a�
Ported using Python-Future from the Python 3.3 standard library.
Parse (absolute and relative) URLs.
urlparse module is based upon the following RFC specifications.
RFC 3986 (STD66): "Uniform Resource Identifiers" by T. Berners-Lee, R. Fielding
and L. Masinter, January 2005.
RFC 2732 : "Format for Literal IPv6 Addresses in URL's by R.Hinden, B.Carpenter
and L.Masinter, December 1999.
RFC 2396: "Uniform Resource Identifiers (URI)": Generic Syntax by T.
Berners-Lee, R. Fielding, and L. Masinter, August 1998.
RFC 2368: "The mailto URL scheme", by P.Hoffman , L Masinter, J. Zawinski, July 1998.
RFC 1808: "Relative Uniform Resource Locators", by R. Fielding, UC Irvine, June
1995.
RFC 1738: "Uniform Resource Locators (URL)" by T. Berners-Lee, L. Masinter, M.
McCahill, December 1994
RFC 3986 is considered the current standard and any future changes to
urlparse module should conform with it. The urlparse module is
currently not entirely compliant with this RFC due to defacto
scenarios for parsing, and for backward compatibility purposes, some
parsing quirks from older RFCs are retained. The testcases in
test_urlparse.py provides a good indicator of parsing behavior.
� )�absolute_import�division�unicode_literals)�bytes�chr�dict�int�range�str)�raise_with_tracebackN)�urlparse�
urlunparse�urljoin� urldefrag�urlsplit�
urlunsplit� urlencode�parse_qs� parse_qsl�quote�
quote_plus�quote_from_bytes�unquote� unquote_plus�unquote_to_bytes)�ftp�http�gopher�nntp�imap�wais�file�https�shttp�mms�prospero�rtsp�rtspu� �sftp�svn�svn+ssh)r r r r �telnetr r r! r$ r" r# �snewsr% r& r' �rsyncr( r* r+ r) �nfs�gitzgit+ssh)r �hdlr% r r r" r# r& r' �sip�sipsr$ r( r) �tel)
r r1 �mailto�newsr, r r r- r2 r3 ) r r r r" r# r$ r r& r' r2 r3 r( )
r r1 r r r6 r r r" r# r- r! r% r( zAabcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+-.� c C s t �� t�� dS )z,Clear the parse cache and the quoters cache.N)� _parse_cache�clear�
_safe_quoters� r; r; �G/usr/local/lib/python3.9/site-packages/future/backports/urllib/parse.py� clear_cacheN s r= �ascii�strictc C s | S �Nr; )�objr; r; r< �_noop] s rB c C s | � ||�S r@ ��encode)rA �encoding�errorsr; r; r< �_encode_result` s rG c s t � �fdd�| D ��S )Nc 3 s" | ]}|r|� � ��nd V qdS )r( N��decode��.0�x�rE rF r; r< � <genexpr>f � z _decode_args.<locals>.<genexpr>)�tuple)�argsrE rF r; rM r< � _decode_argsd s rR c G sV t | d t�}| dd � D ] }|rt |t�|krtd��q|rH| tf S t| �tf S )Nr � z$Cannot mix str and non-str arguments)�
isinstancer
� TypeErrorrB rR rG )rQ � str_input�argr; r; r< � _coerce_argsh s
rX c @ s e Zd ZdZdZddd�ZdS ) �_ResultMixinStrz>Standard approach to encoding parsed results from str to bytesr; r> r? c s | j � �fdd�| D �� S )Nc 3 s | ]}|� � ��V qd S r@ rC rJ rM r; r< rN ~ rO z)_ResultMixinStr.encode.<locals>.<genexpr>)�_encoded_counterpart��selfrE rF r; rM r< rD } s z_ResultMixinStr.encodeN)r> r? )�__name__�
__module__� __qualname__�__doc__� __slots__rD r; r; r; r< rY y s rY c @ s e Zd ZdZdZddd�ZdS ) �_ResultMixinBytesz>Standard approach to decoding parsed results from bytes to strr; r> r? c s | j � �fdd�| D �� S )Nc 3 s | ]}|� � ��V qd S r@ rH rJ rM r; r< rN � rO z+_ResultMixinBytes.decode.<locals>.<genexpr>)�_decoded_counterpartr[ r; rM r< rI � s z_ResultMixinBytes.decodeN)r> r? )r] r^ r_ r` ra rI r; r; r; r< rb � s rb c @ sD e Zd ZdZdZedd� �Zedd� �Zedd� �Zed d
� �Z d S ) �_NetlocResultMixinBasezHShared methods for the parsed result objects containing a netloc elementr; c C s
| j d S �Nr �� _userinfo�r\ r; r; r< �username� s z _NetlocResultMixinBase.usernamec C s
| j d S )NrS rf rh r; r; r< �password� s z _NetlocResultMixinBase.passwordc C s( | j d }|sd }n|d ur$|�� }|S re )� _hostinfo�lower)r\ �hostnamer; r; r< rm � s
z _NetlocResultMixinBase.hostnamec C s: | j d }|d ur6t|d�}d| kr0dks6n d S |S )NrS �
r i�� )rk r )r\ �portr; r; r< ro � s
z_NetlocResultMixinBase.portN)
r] r^ r_ r` ra �propertyri rj rm ro r; r; r; r< rd � s
rd c @ s( e Zd ZdZedd� �Zedd� �ZdS )�_NetlocResultMixinStrr; c C sD | j }|�d�\}}}|r4|�d�\}}}|s<d }nd }}||fS )N�@�:��netloc�
rpartition� partition�r\ ru �userinfo� have_info�hostinfori �
have_passwordrj r; r; r< rg � s z _NetlocResultMixinStr._userinfoc C sl | j }|�d�\}}}|�d�\}}}|rL|�d�\}}}|�d�\}}}n|�d�\}}}|sdd }||fS )Nrr �[�]rs rt � r\ ru �_r{ � have_open_br� bracketedrm ro Z have_portr; r; r< rk � s z _NetlocResultMixinStr._hostinfoN�r] r^ r_ ra rp rg rk r; r; r; r< rq � s
rq c @ s( e Zd ZdZedd� �Zedd� �ZdS )�_NetlocResultMixinBytesr; c C sD | j }|�d�\}}}|r4|�d�\}}}|s<d }nd }}||fS )N� @� :rt rx r; r; r< rg � s z!_NetlocResultMixinBytes._userinfoc C sl | j }|�d�\}}}|�d�\}}}|rL|�d�\}}}|�d�\}}}n|�d�\}}}|sdd }||fS )Nr� � [� ]r� rt r r; r; r< rk � s z!_NetlocResultMixinBytes._hostinfoNr� r; r; r; r< r� � s
r� )�
namedtuple� DefragResultz url fragment� SplitResultz!scheme netloc path query fragment� ParseResultz(scheme netloc path params query fragmentc @ s e Zd ZdZdd� ZdS )r� r; c C s | j r| jd | j S | jS d S )N�#��fragment�urlrh r; r; r< �geturl� s zDefragResult.geturlN�r] r^ r_ ra r� r; r; r; r< r� � s c @ s e Zd ZdZdd� ZdS )r� r; c C s t | �S r@ �r rh r; r; r< r� � s zSplitResult.geturlNr� r; r; r; r< r� � s c @ s e Zd ZdZdd� ZdS )r� r; c C s t | �S r@ �r
rh r; r; r< r� s zParseResult.geturlNr� r; r; r; r< r� � s c @ s e Zd ZdZdd� ZdS )�DefragResultBytesr; c C s | j r| jd | j S | jS d S )N� #r� rh r; r; r< r� s zDefragResultBytes.geturlNr� r; r; r; r< r� s r� c @ s e Zd ZdZdd� ZdS )�SplitResultBytesr; c C s t | �S r@ r� rh r; r; r< r� s zSplitResultBytes.geturlNr� r; r; r; r< r� s r� c @ s e Zd ZdZdd� ZdS )�ParseResultBytesr; c C s t | �S r@ r� rh r; r; r< r� s zParseResultBytes.geturlNr� r; r; r; r< r� s r� c C s4 t tfttfttff} | D ]\}}||_||_qd S r@ )r� r� r� r� r� r� rZ rc )Z
_result_pairsZ_decodedZ_encodedr; r; r< �_fix_result_transcoding s � r� r( Tc
C sf t | |�\} }}t| ||�}|\}}} }}|tv rHd| v rHt| �\} }nd}t||| |||�} || �S )a# Parse a URL into 6 components:
<scheme>://<netloc>/<path>;<params>?<query>#<fragment>
Return a 6-tuple: (scheme, netloc, path, params, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes.�;r( )rX r � uses_params� _splitparamsr� )
r� �scheme�allow_fragments�_coerce_result� splitresultru �queryr� �params�resultr; r; r< r $ s r c C sR d| v r,| � d| �d��}|dk r6| dfS n
| � d�}| d |� | |d d � fS )N�/r� r r( rS )�find�rfind)r� �ir; r; r< r� 4 s
r� c C sH t | �}dD ]"}| �||�}|dkr t||�}q | ||� | |d � fS )Nz/?#r )�lenr� �min)r� �start�delim�c�wdelimr; r; r< � _splitnetloc= s r� c
C sX t | |�\} }}t|�}| ||t| �t|�f}t�|d�}|rF||�S tt�tkrXt� d } }}| �d�} | dk�r�| d| � dk�rJ| d| � � � }| | d d� } | dd� dkr�t
| d�\}} d |v r�d
|vs�d
|v r�d |vr�t d ��|�rd | v �r| � d d�\} }d
| v �r*| � d
d�\} }t
||| ||�}
|
t|< ||
�S | d| � D ]} | tv�rV �q��qV| | d d� } | �r�tdd� | D ���r�| d| � � � | }} | dd� dk�r�t
| d�\}} d |v �r�d
|v�s�d
|v �r�d |v�r�t d ��|�r d | v �r | � d d�\} }d
| v �r8| � d
d�\} }t
||| ||�}
|
t|< ||
�S )a Parse a URL into 5 components:
<scheme>://<netloc>/<path>?<query>#<fragment>
Return a 5-tuple: (scheme, netloc, path, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes.Nr( rs r r rS � �//r} r~ zInvalid IPv6 URLr� �?c s s | ]}|d vV qdS )�
0123456789Nr; �rK r� r; r; r< rN l rO zurlsplit.<locals>.<genexpr>)rX �bool�typer8 �getr� �MAX_CACHE_SIZEr= r� rl r� �
ValueError�splitr� � scheme_chars�any)
r� r� r� r� �key�cachedru r� r� r� �vr� �restr; r; r< r E sd
��
��
r c C s< t | � \}}}}}}}|r&d||f }|t|||||f��S )z�Put a parsed URL back together again. This may result in a
slightly different, but equivalent URL, if the URL that was parsed
originally had redundant delimiters, e.g. a ? with an empty query
(the draft states that these are equivalent).z%s;%s)rX r )�
componentsr� ru r� r� r� r� r� r; r; r< r
} s
� r
c C s� t | � \}}}}}}|s4|r`|tv r`|dd� dkr`|rP|dd� dkrPd| }d|pXd | }|rp|d | }|r�|d | }|r�|d | }||�S )
ak Combine the elements of a tuple as returned by urlsplit() into a
complete URL as a string. The data argument can be any five-item iterable.
This may result in a slightly different, but equivalent URL, if the URL that
was parsed originally had unnecessary delimiters (for example, a ? with an
empty query; the RFC states that these are equivalent).Nr� r� rS r� r( rs r� r� )rX � uses_netloc)r� r� ru r� r� r� r� r; r; r< r � s � r c C s� | s|S |s| S t | |�\} }}t| d|�\}}}}}} t|||�\}
} } }
}}|
|ks`|
tvrh||�S |
tv r�| r�|t|
| | |
||f��S |} | dd� dkr�|t|
| | |
||f��S | s�|
s�|} |}
|s�|}|t|
| | |
||f��S |�d�dd� | �d� }|d dk�rd|d< d|v �r2|�d� �qd}t|�d }||k �r�|| dk�r�||d dv�r�||d |d �= �q2|d }�qB�q��q2|ddgk�r�d|d< n*t|�d k�r�|d dk�r�dg|d
d�< |t|
| d�|�|
||f��S ) zaJoin a base URL and a possibly relative URL to form an absolute
interpretation of the latter.r( NrS r� ����.�..)r( r� r� ���) rX r �
uses_relativer� r
r� �remover� �join)�baser� r� r� �bscheme�bnetloc�bpath�bparams�bquery� bfragmentr� ru �pathr� r� r� �segmentsr� �nr; r; r< r � sf
�
�
�
�
�
�
�r c C sT t | �\} }d| v r>t| �\}}}}}}t|||||df�}nd}| }|t||��S )z�Removes any existing fragment from URL.
Returns a tuple of the defragmented URL and the fragment. If
the URL contained no fragments, the second element is the
empty string.
r� r( )rX r r
r� ) r� r� �sr� �p�a�q�frag�defragr; r; r< r � s r �0123456789ABCDEFabcdefc c s8 | ]0}t D ]&}|| �� tt|| d �g�fV q
qdS )� N)�_hexdigrD r r )rK r� �br; r; r< rN � s
�rN c C s� | s| j td�S t| t�r&| �d�} t| �} | � d�}t|�dkrH| S |d g}|j}|dd� D ]P}z(|t|dd� � ||dd� � W qd ty� |d� ||� Y qd0 qdtd�� |�S )z,unquote_to_bytes('abc%20def') -> b'abc def'.rO �utf-8� %rS r Nr� )
r� r rT r
rD r� �append�
_hextobyte�KeyErrorr� )�string�bits�resr� �itemr; r; r< r � s&
r z([ -]+)r� �replacec C s� d| vr| j | S |du r d}|du r*d}t� | �}|d g}|j}tdt|�d�D ],}|t|| ��||�� |||d � qTd�|�S ) a� Replace %xx escapes by their single-character equivalent. The optional
encoding and errors parameters specify how to decode percent-encoded
sequences into Unicode characters, as accepted by the bytes.decode()
method.
By default, percent-encoded sequences are decoded with UTF-8, and invalid
sequences are replaced by a placeholder character.
unquote('abc%20def') -> 'abc def'.
�%Nr� r� r rS r� r( )r� �_asciirer� r r� r rI r� )r� rE rF r� r� r� r� r; r; r< r s
r Fc C sJ i }t | ||||d�}|D ]*\}}||v r:|| �|� q|g||< q|S )aO Parse a query given as a string argument.
Arguments:
qs: percent-encoded query string to be parsed
keep_blank_values: flag indicating whether blank values in
percent-encoded queries should be treated as blank strings.
A true value indicates that blanks should be retained as
blank strings. The default false value indicates that
blank values are to be ignored and treated as if they were
not included.
strict_parsing: flag indicating what to do with parsing errors.
If false (the default), errors are silently ignored.
If true, errors raise a ValueError exception.
encoding and errors: specify how to decode percent-encoded sequences
into Unicode characters, as accepted by the bytes.decode() method.
rM )r r� ) �qs�keep_blank_values�strict_parsingrE rF �
parsed_result�pairs�name�valuer; r; r< r s � r c C s� t | �\} }dd� | �d�D �}g }|D ]�}|s6|s6q(|�dd�} t| �dkrr|r`td|f ��|r(| �d� nq(t| d �s�|r(| d �d
d �}
t|
||d �}
||
�}
| d �d
d �} t| ||d �} || �} |�|
| f� q(|S )
a; Parse a query given as a string argument.
Arguments:
qs: percent-encoded query string to be parsed
keep_blank_values: flag indicating whether blank values in
percent-encoded queries should be treated as blank strings. A
true value indicates that blanks should be retained as blank
strings. The default false value indicates that blank values
are to be ignored and treated as if they were not included.
strict_parsing: flag indicating what to do with parsing errors. If
false (the default), errors are silently ignored. If true,
errors raise a ValueError exception.
encoding and errors: specify how to decode percent-encoded sequences
into Unicode characters, as accepted by the bytes.decode() method.
Returns a list, as G-d intended.
c S s g | ]}|� d �D ]}|�qqS )r� �r� )rK �s1�s2r; r; r< �
<listcomp>T rO z parse_qsl.<locals>.<listcomp>�&�=rS r� zbad query field: %rr( r �+� rM )rX r� r� r� r� r� r ) r� r� r� rE rF r� r� �r�
name_value�nvr� r� r; r; r< r < s, r c C s | � dd�} t| ||�S )z�Like unquote(), but also replace plus signs by spaces, as required for
unquoting HTML form values.
unquote_plus('%7e/abc+def') -> '~/abc def'
r� r� )r� r )r� rE rF r; r; r< r l s r sA ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_.-c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �Quoterz�A mapping from bytes (in range(0,256)) to strings.
String values are percent-encoded byte values, unless the key < 128, and
in the "safe" set (either the specified safe set, or default set).
c C s t �t|��| _dS )zsafe: bytes object.N)� _ALWAYS_SAFE�unionr �safe)r\ r� r; r; r< �__init__� s zQuoter.__init__c C s dt | � S )Nz <Quoter %r>)r rh r; r; r< �__repr__� s zQuoter.__repr__c C s( || j v rt|�nd�|�}|| |< |S )Nz%{0:02X})r� r �format)r\ r� r� r; r; r< � __missing__� s zQuoter.__missing__N)r] r^ r_ r` r� r r r; r; r; r< r� | s r� r� c C sb t | t�r8| s| S |du r d}|du r*d}| �||�} n |durHtd��|durXtd��t| |�S )a� quote('abc def') -> 'abc%20def'
Each part of a URL, e.g. the path info, the query, etc., has a
different set of reserved characters that must be quoted.
RFC 2396 Uniform Resource Identifiers (URI): Generic Syntax lists
the following reserved characters.
reserved = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+" |
"$" | ","
Each of these characters is reserved in some component of a URL,
but not necessarily in all of them.
By default, the quote function is intended for quoting the path
section of a URL. Thus, it will not encode '/'. This character
is reserved, but in typical usage the quote function is being
called on a path where the existing slash characters are used as
reserved characters.
string and safe may be either str or bytes objects. encoding must
not be specified if string is a str.
The optional encoding and errors parameters specify how to deal with
non-ASCII characters, as accepted by the str.encode method.
By default, encoding='utf-8' (characters are encoded with UTF-8), and
errors='strict' (unsupported characters raise a UnicodeEncodeError).
Nr� r? z,quote() doesn't support 'encoding' for bytesz*quote() doesn't support 'errors' for bytes)rT r
rD rU r )r� r� rE rF r; r; r< r � s
r c C sl t | t�rd| vs$t | t�r2d| vr2t| |||�S t |t�rFtd�}ntd�}t| || ||�} | �dd�S )z�Like quote(), but also replace ' ' with '+', as required for quoting
HTML form values. Plus signs in the original string are escaped unless
they are included in safe. It also does not have safe default to '/'.
r� � r� )rT r
r r r� )r� r� rE rF �spacer; r; r< r � s ��
r c s� t | ttf�std��| s"td�S t| �} t |t�rFt|��dd�}nt|�}tdd� |D ��}| �t| �sv| �� S z t | � W n$ t
y� t |�j t |< � Y n0 td��
� fdd�| D ��S )z�Like quote(), but accepts a bytes object rather than a str, and does
not perform string-to-bytes encoding. It always returns an ASCII string.
quote_from_bytes(b'abc def?') -> 'abc%20def%3f'
z!quote_from_bytes() expected bytesr( r> �ignorec S s g | ]}|d k r|�qS )� r; r� r; r; r< r� � rO z$quote_from_bytes.<locals>.<listcomp>c s g | ] }� |��qS r; r; )rK �char��quoterr; r< r� � rO )rT r � bytearrayrU r
rD �rstrip�_ALWAYS_SAFE_BYTESrI r: r� r� � __getitem__r� )�bsr� r; r r< r � s
r c
C s t | d�r| �� } nNz t| �r0t| d t�s0t�W n. ty` t�� \}}}ttd�|� Y n0 g }|s�| D ]j\} }
t| t �r�t
| |�} nt
t | �|||�} t|
t �r�t
|
|�}
nt
t |
�|||�}
|� | d |
� qn�n | D �]\} }
t| t ��rt
| |�} nt
t | �|||�} t|
t ��r@t
|
|�}
|� | d |
� q�t|
t ��rnt
|
|||�}
|� | d |
� q�z t|
�} W n8 t�y� t
t |
�|||�}
|� | d |
� Y q�0 |
D ]B} t| t ��r�t
| |�} nt
t | �|||�} |� | d | � �q�q�t d��
|�S )a# Encode a sequence of two-element tuples or dictionary into a URL query string.
If any values in the query arg are sequences and doseq is true, each
sequence element is converted to a separate parameter.
If the query arg is a sequence of two-element tuples, the order of the
parameters in the output will match the order of parameters in the
input.
The query arg may be either a string or a bytes type. When query arg is a
string, the safe, encoding and error parameters are sent the quote_plus for
encoding.
�itemsr z1not a valid non-string sequence or mapping objectr� r� )�hasattrr r� rT rP rU �sys�exc_infor r r r
r� r� )
r� �doseqr� rE rF �ty�va�tb�l�kr� rL �eltr; r; r< r � sR
�
r c C sH t | t�rDz| �d��� } W n& tyB tdt| � d ��Y n0 | S )zto_bytes(u"URL") --> 'URL'.�ASCIIzURL z contains non-ASCII characters)rT r
rD rI � UnicodeError�repr�r� r; r; r< �to_bytesH s
� r c C s` t | ��� } | dd� dkr<| dd� dkr<| dd� �� } | dd� dkr\| dd� �� } | S )z8unwrap('<URL:type://host/path>') --> 'type://host/path'.NrS �<r� �>� zURL:)r
�stripr r; r; r< �unwrapU s
r# c C sV t du rddl}|�d�a t �| �}|rN|�d�}|�� | t|�d d� fS d| fS )z:splittype('type:opaquestring') --> 'type', 'opaquestring'.Nr z
^([^/:]+):rS )� _typeprog�re�compile�match�grouprl r� )r� r% r' r� r; r; r< � splittype^ s
r) c C sb t du rddl}|�d�a t �| �}|rZ|�d�}|�d�}|rR|�d�sRd| }||fS d| fS )z;splithost('//host[:port]/path') --> 'host[:port]', '/path'.Nr z^//([^/?]*)(.*)$rS r� r� )� _hostprogr% r& r' r( �
startswith)r� r% r' � host_portr� r; r; r< � splithostl s
r- c C s< t du rddl}|�d�a t �| �}|r4|�dd�S d| fS )zJsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.Nr z ^(.*)@(.*)$rS r� )� _userprogr% r& r' r( ��hostr% r' r; r; r< � splituser} s
r1 c C s@ t du r ddl}|�d|j�a t �| �}|r8|�dd�S | dfS )z/splitpasswd('user:passwd') -> 'user', 'passwd'.Nr z^([^:]*):(.*)$rS r� )� _passwdprogr% r& �Sr' r( )�userr% r' r; r; r< � splitpasswd� s
r5 c C s< t du rddl}|�d�a t �| �}|r4|�dd�S | dfS )z*splitport('host:port') --> 'host', 'port'.Nr z^(.*):([0-9]+)$rS r� )� _portprogr% r& r' r( r/ r; r; r< � splitport� s
r7 r� c C sx t du rddl}|�d�a t �| �}|rp|�dd�\} }z|sFtd��t|�}W n tyf d}Y n0 | |fS | |fS )z�Split host and port, returning numeric port.
Return given default port if no ':' found; defaults to -1.
Return numerical port if a valid number are found after ':'.
Return None if ':' but not a valid number.Nr z ^(.*):(.*)$rS r� z no digits)�
_nportprogr% r& r' r( r� r )r0 �defportr% r' ro �nportr; r; r< �
splitnport� s
r; c C s< t du rddl}|�d�a t �| �}|r4|�dd�S | dfS )z/splitquery('/path?query') --> '/path', 'query'.Nr z^(.*)\?([^?]*)$rS r� )�
_queryprogr% r& r' r( �r� r% r' r; r; r< �
splitquery� s
r> c C s< t du rddl}|�d�a t �| �}|r4|�dd�S | dfS )z)splittag('/path#tag') --> '/path', 'tag'.Nr z^(.*)#([^#]*)$rS r� )�_tagprogr% r& r' r( r= r; r; r< �splittag� s
r@ c C s | � d�}|d |dd� fS )zksplitattr('/path;attr1=value1;attr2=value2;...') ->
'/path', ['attr1=value1', 'attr2=value2', ...].r� r rS Nr� )r� �wordsr; r; r< � splitattr� s
rB c C s< t du rddl}|�d�a t �| �}|r4|�dd�S | dfS )z-splitvalue('attr=value') --> 'attr', 'value'.Nr z^([^=]*)=(.*)$rS r� )�
_valueprogr% r& r' r( )�attrr% r' r; r; r< �
splitvalue� s
rE )r( T)r )r( T)T)r� r� )FFr� r� )FFr� r� )r� r� )r� NN)r( NN)r� )Fr( NN)r� )dr` �
__future__r r r Zfuture.builtinsr r r r r r
Z future.utilsr r% r � collections�__all__r� r� r� �non_hierarchical�
uses_query�
uses_fragmentr� r� r8 r= �_implicit_encoding�_implicit_errorsrB rG rR rX �objectrY rb rd rq r� r� �_DefragResultBase�_SplitResultBase�_ParseResultBase�
ResultBaser� r� r� r� r� r� r� r r� r� r r
r r r r� r� r r& r� r r r r � frozensetr� r r: � defaultdictr� r r r r r r# r$ r) r* r- r. r1 r2 r5 r6 r7 r8 r; r< r> r? r@ rB rC rE r; r; r; r< �<module> s� �
�
8
5�
�
�
0
,
]
PK
Du\�U�@ @ ; future/backports/urllib/__pycache__/response.cpython-39.pycnu �[��� a
��?hl � @ sp d Z ddlmZmZmZ ddlmZ G dd� de�ZG dd� de�ZG dd � d e�Z G d
d � d e�Z
[[[[d S )
a Response classes used by urllib.
The base class, addbase, defines a minimal file-like interface,
including read() and readline(). The typical response object is an
addinfourl instance, which defines an info() method that returns
headers and a geturl() method that returns the url.
� )�absolute_import�division�unicode_literals)�objectc @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�addbasez(Base class for addinfo and addclosehook.c C sV || _ | j j| _| j j| _t| j d�r0| j j| _t| j d�rH| j j| _n
dd� | _d S )N� readlines�filenoc S s d S �N� r
r
r
�J/usr/local/lib/python3.9/site-packages/future/backports/urllib/response.py�<lambda> � z"addbase.__init__.<locals>.<lambda>)�fp�read�readline�hasattrr r )�selfr r
r
r �__init__ s
zaddbase.__init__c C s
t | j�S r )�iterr �r r
r
r �__iter__ s zaddbase.__iter__c C s d| j jt| �| jf S )Nz<%s at %r whose fp = %r>)� __class__�__name__�idr r r
r
r �__repr__% s
�zaddbase.__repr__c C s> | j r| j �� d | _ d | _d | _d | _d | _d | _d | _d S r )r �closer r r r r �__next__r r
r
r r ) s
z
addbase.closec C s | j d u rtd��| S )Nz I/O operation on closed file)r �
ValueErrorr r
r
r � __enter__4 s
zaddbase.__enter__c C s | � � d S r )r )r �type�value� tracebackr
r
r �__exit__9 s zaddbase.__exit__N)
r �
__module__� __qualname__�__doc__r r r r r r" r
r
r
r r s
r c @ s e Zd ZdZdd� Zdd� ZdS )� addclosehookz*Class to add a close hook to an open file.c G s t �| |� || _|| _d S r )r r � closehook�hookargs)r r r' r( r
r
r r ? s zaddclosehook.__init__c C s, | j r | j | j� d | _ d | _t�| � d S r )r' r( r r r r
r
r r D s
zaddclosehook.closeN)r r# r$ r% r r r
r
r
r r& < s r& c @ s e Zd ZdZdd� Zdd� ZdS )�addinfoz.class to add an info() method to an open file.c C s t �| |� || _d S r )r r �headers)r r r* r
r
r r N s zaddinfo.__init__c C s | j S r �r* r r
r
r �infoR s z addinfo.infoN)r r# r$ r% r r, r
r
r
r r) K s r) c @ s2 e Zd ZdZd dd�Zdd� Zdd� Zd d
� ZdS ) �
addinfourlz9class to add info() and geturl() methods to an open file.Nc C s" t �| |� || _|| _|| _d S r )r r r* �url�code)r r r* r. r/ r
r
r r X s zaddinfourl.__init__c C s | j S r r+ r r
r
r r, ^ s zaddinfourl.infoc C s | j S r )r/ r r
r
r �getcodea s zaddinfourl.getcodec C s | j S r )r. r r
r
r �geturld s zaddinfourl.geturl)N)r r# r$ r% r r, r0 r1 r
r
r
r r- U s
r- N) r% �
__future__r r r Zfuture.builtinsr r r& r) r- r
r
r
r �<module> s 1
PK Du\+ ܓ�
�
future/backports/urllib/error.pynu �[��� """Exception classes raised by urllib.
The base exception class is URLError, which inherits from IOError. It
doesn't define any behavior of its own, but is the base class for all
exceptions defined in this package.
HTTPError is an exception class that is also a valid HTTP response
instance. It behaves this way because HTTP protocol errors are valid
responses, with a status code, headers, and a body. In some contexts,
an application may want to handle an exception like a regular
response.
"""
from __future__ import absolute_import, division, unicode_literals
from future import standard_library
from future.backports.urllib import response as urllib_response
__all__ = ['URLError', 'HTTPError', 'ContentTooShortError']
# do these error classes make sense?
# make sure all of the IOError stuff is overridden. we just want to be
# subtypes.
class URLError(IOError):
# URLError is a sub-type of IOError, but it doesn't share any of
# the implementation. need to override __init__ and __str__.
# It sets self.args for compatibility with other EnvironmentError
# subclasses, but args doesn't have the typical format with errno in
# slot 0 and strerror in slot 1. This may be better than nothing.
def __init__(self, reason, filename=None):
self.args = reason,
self.reason = reason
if filename is not None:
self.filename = filename
def __str__(self):
return '<urlopen error %s>' % self.reason
class HTTPError(URLError, urllib_response.addinfourl):
"""Raised when HTTP error occurs, but also acts like non-error return"""
__super_init = urllib_response.addinfourl.__init__
def __init__(self, url, code, msg, hdrs, fp):
self.code = code
self.msg = msg
self.hdrs = hdrs
self.fp = fp
self.filename = url
# The addinfourl classes depend on fp being a valid file
# object. In some cases, the HTTPError may not have a valid
# file object. If this happens, the simplest workaround is to
# not initialize the base classes.
if fp is not None:
self.__super_init(fp, hdrs, url, code)
def __str__(self):
return 'HTTP Error %s: %s' % (self.code, self.msg)
# since URLError specifies a .reason attribute, HTTPError should also
# provide this attribute. See issue13211 for discussion.
@property
def reason(self):
return self.msg
def info(self):
return self.hdrs
# exception raised when downloaded size does not match content-length
class ContentTooShortError(URLError):
def __init__(self, message, content):
URLError.__init__(self, message)
self.content = content
PK Du\~LD�Ћ Ћ future/backports/urllib/parse.pynu �[��� """
Ported using Python-Future from the Python 3.3 standard library.
Parse (absolute and relative) URLs.
urlparse module is based upon the following RFC specifications.
RFC 3986 (STD66): "Uniform Resource Identifiers" by T. Berners-Lee, R. Fielding
and L. Masinter, January 2005.
RFC 2732 : "Format for Literal IPv6 Addresses in URL's by R.Hinden, B.Carpenter
and L.Masinter, December 1999.
RFC 2396: "Uniform Resource Identifiers (URI)": Generic Syntax by T.
Berners-Lee, R. Fielding, and L. Masinter, August 1998.
RFC 2368: "The mailto URL scheme", by P.Hoffman , L Masinter, J. Zawinski, July 1998.
RFC 1808: "Relative Uniform Resource Locators", by R. Fielding, UC Irvine, June
1995.
RFC 1738: "Uniform Resource Locators (URL)" by T. Berners-Lee, L. Masinter, M.
McCahill, December 1994
RFC 3986 is considered the current standard and any future changes to
urlparse module should conform with it. The urlparse module is
currently not entirely compliant with this RFC due to defacto
scenarios for parsing, and for backward compatibility purposes, some
parsing quirks from older RFCs are retained. The testcases in
test_urlparse.py provides a good indicator of parsing behavior.
"""
from __future__ import absolute_import, division, unicode_literals
from future.builtins import bytes, chr, dict, int, range, str
from future.utils import raise_with_traceback
import re
import sys
import collections
__all__ = ["urlparse", "urlunparse", "urljoin", "urldefrag",
"urlsplit", "urlunsplit", "urlencode", "parse_qs",
"parse_qsl", "quote", "quote_plus", "quote_from_bytes",
"unquote", "unquote_plus", "unquote_to_bytes"]
# A classification of schemes ('' means apply by default)
uses_relative = ['ftp', 'http', 'gopher', 'nntp', 'imap',
'wais', 'file', 'https', 'shttp', 'mms',
'prospero', 'rtsp', 'rtspu', '', 'sftp',
'svn', 'svn+ssh']
uses_netloc = ['ftp', 'http', 'gopher', 'nntp', 'telnet',
'imap', 'wais', 'file', 'mms', 'https', 'shttp',
'snews', 'prospero', 'rtsp', 'rtspu', 'rsync', '',
'svn', 'svn+ssh', 'sftp', 'nfs', 'git', 'git+ssh']
uses_params = ['ftp', 'hdl', 'prospero', 'http', 'imap',
'https', 'shttp', 'rtsp', 'rtspu', 'sip', 'sips',
'mms', '', 'sftp', 'tel']
# These are not actually used anymore, but should stay for backwards
# compatibility. (They are undocumented, but have a public-looking name.)
non_hierarchical = ['gopher', 'hdl', 'mailto', 'news',
'telnet', 'wais', 'imap', 'snews', 'sip', 'sips']
uses_query = ['http', 'wais', 'imap', 'https', 'shttp', 'mms',
'gopher', 'rtsp', 'rtspu', 'sip', 'sips', '']
uses_fragment = ['ftp', 'hdl', 'http', 'gopher', 'news',
'nntp', 'wais', 'https', 'shttp', 'snews',
'file', 'prospero', '']
# Characters valid in scheme names
scheme_chars = ('abcdefghijklmnopqrstuvwxyz'
'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
'0123456789'
'+-.')
# XXX: Consider replacing with functools.lru_cache
MAX_CACHE_SIZE = 20
_parse_cache = {}
def clear_cache():
"""Clear the parse cache and the quoters cache."""
_parse_cache.clear()
_safe_quoters.clear()
# Helpers for bytes handling
# For 3.2, we deliberately require applications that
# handle improperly quoted URLs to do their own
# decoding and encoding. If valid use cases are
# presented, we may relax this by using latin-1
# decoding internally for 3.3
_implicit_encoding = 'ascii'
_implicit_errors = 'strict'
def _noop(obj):
return obj
def _encode_result(obj, encoding=_implicit_encoding,
errors=_implicit_errors):
return obj.encode(encoding, errors)
def _decode_args(args, encoding=_implicit_encoding,
errors=_implicit_errors):
return tuple(x.decode(encoding, errors) if x else '' for x in args)
def _coerce_args(*args):
# Invokes decode if necessary to create str args
# and returns the coerced inputs along with
# an appropriate result coercion function
# - noop for str inputs
# - encoding function otherwise
str_input = isinstance(args[0], str)
for arg in args[1:]:
# We special-case the empty string to support the
# "scheme=''" default argument to some functions
if arg and isinstance(arg, str) != str_input:
raise TypeError("Cannot mix str and non-str arguments")
if str_input:
return args + (_noop,)
return _decode_args(args) + (_encode_result,)
# Result objects are more helpful than simple tuples
class _ResultMixinStr(object):
"""Standard approach to encoding parsed results from str to bytes"""
__slots__ = ()
def encode(self, encoding='ascii', errors='strict'):
return self._encoded_counterpart(*(x.encode(encoding, errors) for x in self))
class _ResultMixinBytes(object):
"""Standard approach to decoding parsed results from bytes to str"""
__slots__ = ()
def decode(self, encoding='ascii', errors='strict'):
return self._decoded_counterpart(*(x.decode(encoding, errors) for x in self))
class _NetlocResultMixinBase(object):
"""Shared methods for the parsed result objects containing a netloc element"""
__slots__ = ()
@property
def username(self):
return self._userinfo[0]
@property
def password(self):
return self._userinfo[1]
@property
def hostname(self):
hostname = self._hostinfo[0]
if not hostname:
hostname = None
elif hostname is not None:
hostname = hostname.lower()
return hostname
@property
def port(self):
port = self._hostinfo[1]
if port is not None:
port = int(port, 10)
# Return None on an illegal port
if not ( 0 <= port <= 65535):
return None
return port
class _NetlocResultMixinStr(_NetlocResultMixinBase, _ResultMixinStr):
__slots__ = ()
@property
def _userinfo(self):
netloc = self.netloc
userinfo, have_info, hostinfo = netloc.rpartition('@')
if have_info:
username, have_password, password = userinfo.partition(':')
if not have_password:
password = None
else:
username = password = None
return username, password
@property
def _hostinfo(self):
netloc = self.netloc
_, _, hostinfo = netloc.rpartition('@')
_, have_open_br, bracketed = hostinfo.partition('[')
if have_open_br:
hostname, _, port = bracketed.partition(']')
_, have_port, port = port.partition(':')
else:
hostname, have_port, port = hostinfo.partition(':')
if not have_port:
port = None
return hostname, port
class _NetlocResultMixinBytes(_NetlocResultMixinBase, _ResultMixinBytes):
__slots__ = ()
@property
def _userinfo(self):
netloc = self.netloc
userinfo, have_info, hostinfo = netloc.rpartition(b'@')
if have_info:
username, have_password, password = userinfo.partition(b':')
if not have_password:
password = None
else:
username = password = None
return username, password
@property
def _hostinfo(self):
netloc = self.netloc
_, _, hostinfo = netloc.rpartition(b'@')
_, have_open_br, bracketed = hostinfo.partition(b'[')
if have_open_br:
hostname, _, port = bracketed.partition(b']')
_, have_port, port = port.partition(b':')
else:
hostname, have_port, port = hostinfo.partition(b':')
if not have_port:
port = None
return hostname, port
from collections import namedtuple
_DefragResultBase = namedtuple('DefragResult', 'url fragment')
_SplitResultBase = namedtuple('SplitResult', 'scheme netloc path query fragment')
_ParseResultBase = namedtuple('ParseResult', 'scheme netloc path params query fragment')
# For backwards compatibility, alias _NetlocResultMixinStr
# ResultBase is no longer part of the documented API, but it is
# retained since deprecating it isn't worth the hassle
ResultBase = _NetlocResultMixinStr
# Structured result objects for string data
class DefragResult(_DefragResultBase, _ResultMixinStr):
__slots__ = ()
def geturl(self):
if self.fragment:
return self.url + '#' + self.fragment
else:
return self.url
class SplitResult(_SplitResultBase, _NetlocResultMixinStr):
__slots__ = ()
def geturl(self):
return urlunsplit(self)
class ParseResult(_ParseResultBase, _NetlocResultMixinStr):
__slots__ = ()
def geturl(self):
return urlunparse(self)
# Structured result objects for bytes data
class DefragResultBytes(_DefragResultBase, _ResultMixinBytes):
__slots__ = ()
def geturl(self):
if self.fragment:
return self.url + b'#' + self.fragment
else:
return self.url
class SplitResultBytes(_SplitResultBase, _NetlocResultMixinBytes):
__slots__ = ()
def geturl(self):
return urlunsplit(self)
class ParseResultBytes(_ParseResultBase, _NetlocResultMixinBytes):
__slots__ = ()
def geturl(self):
return urlunparse(self)
# Set up the encode/decode result pairs
def _fix_result_transcoding():
_result_pairs = (
(DefragResult, DefragResultBytes),
(SplitResult, SplitResultBytes),
(ParseResult, ParseResultBytes),
)
for _decoded, _encoded in _result_pairs:
_decoded._encoded_counterpart = _encoded
_encoded._decoded_counterpart = _decoded
_fix_result_transcoding()
del _fix_result_transcoding
def urlparse(url, scheme='', allow_fragments=True):
"""Parse a URL into 6 components:
<scheme>://<netloc>/<path>;<params>?<query>#<fragment>
Return a 6-tuple: (scheme, netloc, path, params, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes."""
url, scheme, _coerce_result = _coerce_args(url, scheme)
splitresult = urlsplit(url, scheme, allow_fragments)
scheme, netloc, url, query, fragment = splitresult
if scheme in uses_params and ';' in url:
url, params = _splitparams(url)
else:
params = ''
result = ParseResult(scheme, netloc, url, params, query, fragment)
return _coerce_result(result)
def _splitparams(url):
if '/' in url:
i = url.find(';', url.rfind('/'))
if i < 0:
return url, ''
else:
i = url.find(';')
return url[:i], url[i+1:]
def _splitnetloc(url, start=0):
delim = len(url) # position of end of domain part of url, default is end
for c in '/?#': # look for delimiters; the order is NOT important
wdelim = url.find(c, start) # find first of this delim
if wdelim >= 0: # if found
delim = min(delim, wdelim) # use earliest delim position
return url[start:delim], url[delim:] # return (domain, rest)
def urlsplit(url, scheme='', allow_fragments=True):
"""Parse a URL into 5 components:
<scheme>://<netloc>/<path>?<query>#<fragment>
Return a 5-tuple: (scheme, netloc, path, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes."""
url, scheme, _coerce_result = _coerce_args(url, scheme)
allow_fragments = bool(allow_fragments)
key = url, scheme, allow_fragments, type(url), type(scheme)
cached = _parse_cache.get(key, None)
if cached:
return _coerce_result(cached)
if len(_parse_cache) >= MAX_CACHE_SIZE: # avoid runaway growth
clear_cache()
netloc = query = fragment = ''
i = url.find(':')
if i > 0:
if url[:i] == 'http': # optimize the common case
scheme = url[:i].lower()
url = url[i+1:]
if url[:2] == '//':
netloc, url = _splitnetloc(url, 2)
if (('[' in netloc and ']' not in netloc) or
(']' in netloc and '[' not in netloc)):
raise ValueError("Invalid IPv6 URL")
if allow_fragments and '#' in url:
url, fragment = url.split('#', 1)
if '?' in url:
url, query = url.split('?', 1)
v = SplitResult(scheme, netloc, url, query, fragment)
_parse_cache[key] = v
return _coerce_result(v)
for c in url[:i]:
if c not in scheme_chars:
break
else:
# make sure "url" is not actually a port number (in which case
# "scheme" is really part of the path)
rest = url[i+1:]
if not rest or any(c not in '0123456789' for c in rest):
# not a port number
scheme, url = url[:i].lower(), rest
if url[:2] == '//':
netloc, url = _splitnetloc(url, 2)
if (('[' in netloc and ']' not in netloc) or
(']' in netloc and '[' not in netloc)):
raise ValueError("Invalid IPv6 URL")
if allow_fragments and '#' in url:
url, fragment = url.split('#', 1)
if '?' in url:
url, query = url.split('?', 1)
v = SplitResult(scheme, netloc, url, query, fragment)
_parse_cache[key] = v
return _coerce_result(v)
def urlunparse(components):
"""Put a parsed URL back together again. This may result in a
slightly different, but equivalent URL, if the URL that was parsed
originally had redundant delimiters, e.g. a ? with an empty query
(the draft states that these are equivalent)."""
scheme, netloc, url, params, query, fragment, _coerce_result = (
_coerce_args(*components))
if params:
url = "%s;%s" % (url, params)
return _coerce_result(urlunsplit((scheme, netloc, url, query, fragment)))
def urlunsplit(components):
"""Combine the elements of a tuple as returned by urlsplit() into a
complete URL as a string. The data argument can be any five-item iterable.
This may result in a slightly different, but equivalent URL, if the URL that
was parsed originally had unnecessary delimiters (for example, a ? with an
empty query; the RFC states that these are equivalent)."""
scheme, netloc, url, query, fragment, _coerce_result = (
_coerce_args(*components))
if netloc or (scheme and scheme in uses_netloc and url[:2] != '//'):
if url and url[:1] != '/': url = '/' + url
url = '//' + (netloc or '') + url
if scheme:
url = scheme + ':' + url
if query:
url = url + '?' + query
if fragment:
url = url + '#' + fragment
return _coerce_result(url)
def urljoin(base, url, allow_fragments=True):
"""Join a base URL and a possibly relative URL to form an absolute
interpretation of the latter."""
if not base:
return url
if not url:
return base
base, url, _coerce_result = _coerce_args(base, url)
bscheme, bnetloc, bpath, bparams, bquery, bfragment = \
urlparse(base, '', allow_fragments)
scheme, netloc, path, params, query, fragment = \
urlparse(url, bscheme, allow_fragments)
if scheme != bscheme or scheme not in uses_relative:
return _coerce_result(url)
if scheme in uses_netloc:
if netloc:
return _coerce_result(urlunparse((scheme, netloc, path,
params, query, fragment)))
netloc = bnetloc
if path[:1] == '/':
return _coerce_result(urlunparse((scheme, netloc, path,
params, query, fragment)))
if not path and not params:
path = bpath
params = bparams
if not query:
query = bquery
return _coerce_result(urlunparse((scheme, netloc, path,
params, query, fragment)))
segments = bpath.split('/')[:-1] + path.split('/')
# XXX The stuff below is bogus in various ways...
if segments[-1] == '.':
segments[-1] = ''
while '.' in segments:
segments.remove('.')
while 1:
i = 1
n = len(segments) - 1
while i < n:
if (segments[i] == '..'
and segments[i-1] not in ('', '..')):
del segments[i-1:i+1]
break
i = i+1
else:
break
if segments == ['', '..']:
segments[-1] = ''
elif len(segments) >= 2 and segments[-1] == '..':
segments[-2:] = ['']
return _coerce_result(urlunparse((scheme, netloc, '/'.join(segments),
params, query, fragment)))
def urldefrag(url):
"""Removes any existing fragment from URL.
Returns a tuple of the defragmented URL and the fragment. If
the URL contained no fragments, the second element is the
empty string.
"""
url, _coerce_result = _coerce_args(url)
if '#' in url:
s, n, p, a, q, frag = urlparse(url)
defrag = urlunparse((s, n, p, a, q, ''))
else:
frag = ''
defrag = url
return _coerce_result(DefragResult(defrag, frag))
_hexdig = '0123456789ABCDEFabcdef'
_hextobyte = dict(((a + b).encode(), bytes([int(a + b, 16)]))
for a in _hexdig for b in _hexdig)
def unquote_to_bytes(string):
"""unquote_to_bytes('abc%20def') -> b'abc def'."""
# Note: strings are encoded as UTF-8. This is only an issue if it contains
# unescaped non-ASCII characters, which URIs should not.
if not string:
# Is it a string-like object?
string.split
return bytes(b'')
if isinstance(string, str):
string = string.encode('utf-8')
### For Python-Future:
# It is already a byte-string object, but force it to be newbytes here on
# Py2:
string = bytes(string)
###
bits = string.split(b'%')
if len(bits) == 1:
return string
res = [bits[0]]
append = res.append
for item in bits[1:]:
try:
append(_hextobyte[item[:2]])
append(item[2:])
except KeyError:
append(b'%')
append(item)
return bytes(b'').join(res)
_asciire = re.compile('([\x00-\x7f]+)')
def unquote(string, encoding='utf-8', errors='replace'):
"""Replace %xx escapes by their single-character equivalent. The optional
encoding and errors parameters specify how to decode percent-encoded
sequences into Unicode characters, as accepted by the bytes.decode()
method.
By default, percent-encoded sequences are decoded with UTF-8, and invalid
sequences are replaced by a placeholder character.
unquote('abc%20def') -> 'abc def'.
"""
if '%' not in string:
string.split
return string
if encoding is None:
encoding = 'utf-8'
if errors is None:
errors = 'replace'
bits = _asciire.split(string)
res = [bits[0]]
append = res.append
for i in range(1, len(bits), 2):
append(unquote_to_bytes(bits[i]).decode(encoding, errors))
append(bits[i + 1])
return ''.join(res)
def parse_qs(qs, keep_blank_values=False, strict_parsing=False,
encoding='utf-8', errors='replace'):
"""Parse a query given as a string argument.
Arguments:
qs: percent-encoded query string to be parsed
keep_blank_values: flag indicating whether blank values in
percent-encoded queries should be treated as blank strings.
A true value indicates that blanks should be retained as
blank strings. The default false value indicates that
blank values are to be ignored and treated as if they were
not included.
strict_parsing: flag indicating what to do with parsing errors.
If false (the default), errors are silently ignored.
If true, errors raise a ValueError exception.
encoding and errors: specify how to decode percent-encoded sequences
into Unicode characters, as accepted by the bytes.decode() method.
"""
parsed_result = {}
pairs = parse_qsl(qs, keep_blank_values, strict_parsing,
encoding=encoding, errors=errors)
for name, value in pairs:
if name in parsed_result:
parsed_result[name].append(value)
else:
parsed_result[name] = [value]
return parsed_result
def parse_qsl(qs, keep_blank_values=False, strict_parsing=False,
encoding='utf-8', errors='replace'):
"""Parse a query given as a string argument.
Arguments:
qs: percent-encoded query string to be parsed
keep_blank_values: flag indicating whether blank values in
percent-encoded queries should be treated as blank strings. A
true value indicates that blanks should be retained as blank
strings. The default false value indicates that blank values
are to be ignored and treated as if they were not included.
strict_parsing: flag indicating what to do with parsing errors. If
false (the default), errors are silently ignored. If true,
errors raise a ValueError exception.
encoding and errors: specify how to decode percent-encoded sequences
into Unicode characters, as accepted by the bytes.decode() method.
Returns a list, as G-d intended.
"""
qs, _coerce_result = _coerce_args(qs)
pairs = [s2 for s1 in qs.split('&') for s2 in s1.split(';')]
r = []
for name_value in pairs:
if not name_value and not strict_parsing:
continue
nv = name_value.split('=', 1)
if len(nv) != 2:
if strict_parsing:
raise ValueError("bad query field: %r" % (name_value,))
# Handle case of a control-name with no equal sign
if keep_blank_values:
nv.append('')
else:
continue
if len(nv[1]) or keep_blank_values:
name = nv[0].replace('+', ' ')
name = unquote(name, encoding=encoding, errors=errors)
name = _coerce_result(name)
value = nv[1].replace('+', ' ')
value = unquote(value, encoding=encoding, errors=errors)
value = _coerce_result(value)
r.append((name, value))
return r
def unquote_plus(string, encoding='utf-8', errors='replace'):
"""Like unquote(), but also replace plus signs by spaces, as required for
unquoting HTML form values.
unquote_plus('%7e/abc+def') -> '~/abc def'
"""
string = string.replace('+', ' ')
return unquote(string, encoding, errors)
_ALWAYS_SAFE = frozenset(bytes(b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
b'abcdefghijklmnopqrstuvwxyz'
b'0123456789'
b'_.-'))
_ALWAYS_SAFE_BYTES = bytes(_ALWAYS_SAFE)
_safe_quoters = {}
class Quoter(collections.defaultdict):
"""A mapping from bytes (in range(0,256)) to strings.
String values are percent-encoded byte values, unless the key < 128, and
in the "safe" set (either the specified safe set, or default set).
"""
# Keeps a cache internally, using defaultdict, for efficiency (lookups
# of cached keys don't call Python code at all).
def __init__(self, safe):
"""safe: bytes object."""
self.safe = _ALWAYS_SAFE.union(bytes(safe))
def __repr__(self):
# Without this, will just display as a defaultdict
return "<Quoter %r>" % dict(self)
def __missing__(self, b):
# Handle a cache miss. Store quoted string in cache and return.
res = chr(b) if b in self.safe else '%{0:02X}'.format(b)
self[b] = res
return res
def quote(string, safe='/', encoding=None, errors=None):
"""quote('abc def') -> 'abc%20def'
Each part of a URL, e.g. the path info, the query, etc., has a
different set of reserved characters that must be quoted.
RFC 2396 Uniform Resource Identifiers (URI): Generic Syntax lists
the following reserved characters.
reserved = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+" |
"$" | ","
Each of these characters is reserved in some component of a URL,
but not necessarily in all of them.
By default, the quote function is intended for quoting the path
section of a URL. Thus, it will not encode '/'. This character
is reserved, but in typical usage the quote function is being
called on a path where the existing slash characters are used as
reserved characters.
string and safe may be either str or bytes objects. encoding must
not be specified if string is a str.
The optional encoding and errors parameters specify how to deal with
non-ASCII characters, as accepted by the str.encode method.
By default, encoding='utf-8' (characters are encoded with UTF-8), and
errors='strict' (unsupported characters raise a UnicodeEncodeError).
"""
if isinstance(string, str):
if not string:
return string
if encoding is None:
encoding = 'utf-8'
if errors is None:
errors = 'strict'
string = string.encode(encoding, errors)
else:
if encoding is not None:
raise TypeError("quote() doesn't support 'encoding' for bytes")
if errors is not None:
raise TypeError("quote() doesn't support 'errors' for bytes")
return quote_from_bytes(string, safe)
def quote_plus(string, safe='', encoding=None, errors=None):
"""Like quote(), but also replace ' ' with '+', as required for quoting
HTML form values. Plus signs in the original string are escaped unless
they are included in safe. It also does not have safe default to '/'.
"""
# Check if ' ' in string, where string may either be a str or bytes. If
# there are no spaces, the regular quote will produce the right answer.
if ((isinstance(string, str) and ' ' not in string) or
(isinstance(string, bytes) and b' ' not in string)):
return quote(string, safe, encoding, errors)
if isinstance(safe, str):
space = str(' ')
else:
space = bytes(b' ')
string = quote(string, safe + space, encoding, errors)
return string.replace(' ', '+')
def quote_from_bytes(bs, safe='/'):
"""Like quote(), but accepts a bytes object rather than a str, and does
not perform string-to-bytes encoding. It always returns an ASCII string.
quote_from_bytes(b'abc def\x3f') -> 'abc%20def%3f'
"""
if not isinstance(bs, (bytes, bytearray)):
raise TypeError("quote_from_bytes() expected bytes")
if not bs:
return str('')
### For Python-Future:
bs = bytes(bs)
###
if isinstance(safe, str):
# Normalize 'safe' by converting to bytes and removing non-ASCII chars
safe = str(safe).encode('ascii', 'ignore')
else:
### For Python-Future:
safe = bytes(safe)
###
safe = bytes([c for c in safe if c < 128])
if not bs.rstrip(_ALWAYS_SAFE_BYTES + safe):
return bs.decode()
try:
quoter = _safe_quoters[safe]
except KeyError:
_safe_quoters[safe] = quoter = Quoter(safe).__getitem__
return str('').join([quoter(char) for char in bs])
def urlencode(query, doseq=False, safe='', encoding=None, errors=None):
"""Encode a sequence of two-element tuples or dictionary into a URL query string.
If any values in the query arg are sequences and doseq is true, each
sequence element is converted to a separate parameter.
If the query arg is a sequence of two-element tuples, the order of the
parameters in the output will match the order of parameters in the
input.
The query arg may be either a string or a bytes type. When query arg is a
string, the safe, encoding and error parameters are sent the quote_plus for
encoding.
"""
if hasattr(query, "items"):
query = query.items()
else:
# It's a bother at times that strings and string-like objects are
# sequences.
try:
# non-sequence items should not work with len()
# non-empty strings will fail this
if len(query) and not isinstance(query[0], tuple):
raise TypeError
# Zero-length sequences of all types will get here and succeed,
# but that's a minor nit. Since the original implementation
# allowed empty dicts that type of behavior probably should be
# preserved for consistency
except TypeError:
ty, va, tb = sys.exc_info()
raise_with_traceback(TypeError("not a valid non-string sequence "
"or mapping object"), tb)
l = []
if not doseq:
for k, v in query:
if isinstance(k, bytes):
k = quote_plus(k, safe)
else:
k = quote_plus(str(k), safe, encoding, errors)
if isinstance(v, bytes):
v = quote_plus(v, safe)
else:
v = quote_plus(str(v), safe, encoding, errors)
l.append(k + '=' + v)
else:
for k, v in query:
if isinstance(k, bytes):
k = quote_plus(k, safe)
else:
k = quote_plus(str(k), safe, encoding, errors)
if isinstance(v, bytes):
v = quote_plus(v, safe)
l.append(k + '=' + v)
elif isinstance(v, str):
v = quote_plus(v, safe, encoding, errors)
l.append(k + '=' + v)
else:
try:
# Is this a sufficient test for sequence-ness?
x = len(v)
except TypeError:
# not a sequence
v = quote_plus(str(v), safe, encoding, errors)
l.append(k + '=' + v)
else:
# loop over the sequence
for elt in v:
if isinstance(elt, bytes):
elt = quote_plus(elt, safe)
else:
elt = quote_plus(str(elt), safe, encoding, errors)
l.append(k + '=' + elt)
return str('&').join(l)
# Utilities to parse URLs (most of these return None for missing parts):
# unwrap('<URL:type://host/path>') --> 'type://host/path'
# splittype('type:opaquestring') --> 'type', 'opaquestring'
# splithost('//host[:port]/path') --> 'host[:port]', '/path'
# splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'
# splitpasswd('user:passwd') -> 'user', 'passwd'
# splitport('host:port') --> 'host', 'port'
# splitquery('/path?query') --> '/path', 'query'
# splittag('/path#tag') --> '/path', 'tag'
# splitattr('/path;attr1=value1;attr2=value2;...') ->
# '/path', ['attr1=value1', 'attr2=value2', ...]
# splitvalue('attr=value') --> 'attr', 'value'
# urllib.parse.unquote('abc%20def') -> 'abc def'
# quote('abc def') -> 'abc%20def')
def to_bytes(url):
"""to_bytes(u"URL") --> 'URL'."""
# Most URL schemes require ASCII. If that changes, the conversion
# can be relaxed.
# XXX get rid of to_bytes()
if isinstance(url, str):
try:
url = url.encode("ASCII").decode()
except UnicodeError:
raise UnicodeError("URL " + repr(url) +
" contains non-ASCII characters")
return url
def unwrap(url):
"""unwrap('<URL:type://host/path>') --> 'type://host/path'."""
url = str(url).strip()
if url[:1] == '<' and url[-1:] == '>':
url = url[1:-1].strip()
if url[:4] == 'URL:': url = url[4:].strip()
return url
_typeprog = None
def splittype(url):
"""splittype('type:opaquestring') --> 'type', 'opaquestring'."""
global _typeprog
if _typeprog is None:
import re
_typeprog = re.compile('^([^/:]+):')
match = _typeprog.match(url)
if match:
scheme = match.group(1)
return scheme.lower(), url[len(scheme) + 1:]
return None, url
_hostprog = None
def splithost(url):
"""splithost('//host[:port]/path') --> 'host[:port]', '/path'."""
global _hostprog
if _hostprog is None:
import re
_hostprog = re.compile('^//([^/?]*)(.*)$')
match = _hostprog.match(url)
if match:
host_port = match.group(1)
path = match.group(2)
if path and not path.startswith('/'):
path = '/' + path
return host_port, path
return None, url
_userprog = None
def splituser(host):
"""splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'."""
global _userprog
if _userprog is None:
import re
_userprog = re.compile('^(.*)@(.*)$')
match = _userprog.match(host)
if match: return match.group(1, 2)
return None, host
_passwdprog = None
def splitpasswd(user):
"""splitpasswd('user:passwd') -> 'user', 'passwd'."""
global _passwdprog
if _passwdprog is None:
import re
_passwdprog = re.compile('^([^:]*):(.*)$',re.S)
match = _passwdprog.match(user)
if match: return match.group(1, 2)
return user, None
# splittag('/path#tag') --> '/path', 'tag'
_portprog = None
def splitport(host):
"""splitport('host:port') --> 'host', 'port'."""
global _portprog
if _portprog is None:
import re
_portprog = re.compile('^(.*):([0-9]+)$')
match = _portprog.match(host)
if match: return match.group(1, 2)
return host, None
_nportprog = None
def splitnport(host, defport=-1):
"""Split host and port, returning numeric port.
Return given default port if no ':' found; defaults to -1.
Return numerical port if a valid number are found after ':'.
Return None if ':' but not a valid number."""
global _nportprog
if _nportprog is None:
import re
_nportprog = re.compile('^(.*):(.*)$')
match = _nportprog.match(host)
if match:
host, port = match.group(1, 2)
try:
if not port: raise ValueError("no digits")
nport = int(port)
except ValueError:
nport = None
return host, nport
return host, defport
_queryprog = None
def splitquery(url):
"""splitquery('/path?query') --> '/path', 'query'."""
global _queryprog
if _queryprog is None:
import re
_queryprog = re.compile('^(.*)\?([^?]*)$')
match = _queryprog.match(url)
if match: return match.group(1, 2)
return url, None
_tagprog = None
def splittag(url):
"""splittag('/path#tag') --> '/path', 'tag'."""
global _tagprog
if _tagprog is None:
import re
_tagprog = re.compile('^(.*)#([^#]*)$')
match = _tagprog.match(url)
if match: return match.group(1, 2)
return url, None
def splitattr(url):
"""splitattr('/path;attr1=value1;attr2=value2;...') ->
'/path', ['attr1=value1', 'attr2=value2', ...]."""
words = url.split(';')
return words[0], words[1:]
_valueprog = None
def splitvalue(attr):
"""splitvalue('attr=value') --> 'attr', 'value'."""
global _valueprog
if _valueprog is None:
import re
_valueprog = re.compile('^([^=]*)=(.*)$')
match = _valueprog.match(attr)
if match: return match.group(1, 2)
return attr, None
PK Du\�Px x " future/backports/urllib/request.pynu �[��� """
Ported using Python-Future from the Python 3.3 standard library.
An extensible library for opening URLs using a variety of protocols
The simplest way to use this module is to call the urlopen function,
which accepts a string containing a URL or a Request object (described
below). It opens the URL and returns the results as file-like
object; the returned object has some extra methods described below.
The OpenerDirector manages a collection of Handler objects that do
all the actual work. Each Handler implements a particular protocol or
option. The OpenerDirector is a composite object that invokes the
Handlers needed to open the requested URL. For example, the
HTTPHandler performs HTTP GET and POST requests and deals with
non-error returns. The HTTPRedirectHandler automatically deals with
HTTP 301, 302, 303 and 307 redirect errors, and the HTTPDigestAuthHandler
deals with digest authentication.
urlopen(url, data=None) -- Basic usage is the same as original
urllib. pass the url and optionally data to post to an HTTP URL, and
get a file-like object back. One difference is that you can also pass
a Request instance instead of URL. Raises a URLError (subclass of
IOError); for HTTP errors, raises an HTTPError, which can also be
treated as a valid response.
build_opener -- Function that creates a new OpenerDirector instance.
Will install the default handlers. Accepts one or more Handlers as
arguments, either instances or Handler classes that it will
instantiate. If one of the argument is a subclass of the default
handler, the argument will be installed instead of the default.
install_opener -- Installs a new opener as the default opener.
objects of interest:
OpenerDirector -- Sets up the User Agent as the Python-urllib client and manages
the Handler classes, while dealing with requests and responses.
Request -- An object that encapsulates the state of a request. The
state can be as simple as the URL. It can also include extra HTTP
headers, e.g. a User-Agent.
BaseHandler --
internals:
BaseHandler and parent
_call_chain conventions
Example usage:
import urllib.request
# set up authentication info
authinfo = urllib.request.HTTPBasicAuthHandler()
authinfo.add_password(realm='PDQ Application',
uri='https://mahler:8092/site-updates.py',
user='klem',
passwd='geheim$parole')
proxy_support = urllib.request.ProxyHandler({"http" : "http://ahad-haam:3128"})
# build a new opener that adds authentication and caching FTP handlers
opener = urllib.request.build_opener(proxy_support, authinfo,
urllib.request.CacheFTPHandler)
# install it
urllib.request.install_opener(opener)
f = urllib.request.urlopen('http://www.python.org/')
"""
# XXX issues:
# If an authentication error handler that tries to perform
# authentication for some reason but fails, how should the error be
# signalled? The client needs to know the HTTP error code. But if
# the handler knows that the problem was, e.g., that it didn't know
# that hash algo that requested in the challenge, it would be good to
# pass that information along to the client, too.
# ftp errors aren't handled cleanly
# check digest against correct (i.e. non-apache) implementation
# Possible extensions:
# complex proxies XXX not sure what exactly was meant by this
# abstract factory for opener
from __future__ import absolute_import, division, print_function, unicode_literals
from future.builtins import bytes, dict, filter, input, int, map, open, str
from future.utils import PY2, PY3, raise_with_traceback
import base64
import bisect
import hashlib
import array
from future.backports import email
from future.backports.http import client as http_client
from .error import URLError, HTTPError, ContentTooShortError
from .parse import (
urlparse, urlsplit, urljoin, unwrap, quote, unquote,
splittype, splithost, splitport, splituser, splitpasswd,
splitattr, splitquery, splitvalue, splittag, to_bytes, urlunparse)
from .response import addinfourl, addclosehook
import io
import os
import posixpath
import re
import socket
import sys
import time
import tempfile
import contextlib
import warnings
from future.utils import PY2
if PY2:
from collections import Iterable
else:
from collections.abc import Iterable
# check for SSL
try:
import ssl
# Not available in the SSL module in Py2:
from ssl import SSLContext
except ImportError:
_have_ssl = False
else:
_have_ssl = True
__all__ = [
# Classes
'Request', 'OpenerDirector', 'BaseHandler', 'HTTPDefaultErrorHandler',
'HTTPRedirectHandler', 'HTTPCookieProcessor', 'ProxyHandler',
'HTTPPasswordMgr', 'HTTPPasswordMgrWithDefaultRealm',
'AbstractBasicAuthHandler', 'HTTPBasicAuthHandler', 'ProxyBasicAuthHandler',
'AbstractDigestAuthHandler', 'HTTPDigestAuthHandler', 'ProxyDigestAuthHandler',
'HTTPHandler', 'FileHandler', 'FTPHandler', 'CacheFTPHandler',
'UnknownHandler', 'HTTPErrorProcessor',
# Functions
'urlopen', 'install_opener', 'build_opener',
'pathname2url', 'url2pathname', 'getproxies',
# Legacy interface
'urlretrieve', 'urlcleanup', 'URLopener', 'FancyURLopener',
]
# used in User-Agent header sent
__version__ = sys.version[:3]
_opener = None
def urlopen(url, data=None, timeout=socket._GLOBAL_DEFAULT_TIMEOUT, **_3to2kwargs):
if 'cadefault' in _3to2kwargs: cadefault = _3to2kwargs['cadefault']; del _3to2kwargs['cadefault']
else: cadefault = False
if 'capath' in _3to2kwargs: capath = _3to2kwargs['capath']; del _3to2kwargs['capath']
else: capath = None
if 'cafile' in _3to2kwargs: cafile = _3to2kwargs['cafile']; del _3to2kwargs['cafile']
else: cafile = None
global _opener
if cafile or capath or cadefault:
if not _have_ssl:
raise ValueError('SSL support not available')
context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
context.options |= ssl.OP_NO_SSLv2
context.verify_mode = ssl.CERT_REQUIRED
if cafile or capath:
context.load_verify_locations(cafile, capath)
else:
context.set_default_verify_paths()
https_handler = HTTPSHandler(context=context, check_hostname=True)
opener = build_opener(https_handler)
elif _opener is None:
_opener = opener = build_opener()
else:
opener = _opener
return opener.open(url, data, timeout)
def install_opener(opener):
global _opener
_opener = opener
_url_tempfiles = []
def urlretrieve(url, filename=None, reporthook=None, data=None):
"""
Retrieve a URL into a temporary location on disk.
Requires a URL argument. If a filename is passed, it is used as
the temporary file location. The reporthook argument should be
a callable that accepts a block number, a read size, and the
total file size of the URL target. The data argument should be
valid URL encoded data.
If a filename is passed and the URL points to a local resource,
the result is a copy from local file to new file.
Returns a tuple containing the path to the newly created
data file as well as the resulting HTTPMessage object.
"""
url_type, path = splittype(url)
with contextlib.closing(urlopen(url, data)) as fp:
headers = fp.info()
# Just return the local path and the "headers" for file://
# URLs. No sense in performing a copy unless requested.
if url_type == "file" and not filename:
return os.path.normpath(path), headers
# Handle temporary file setup.
if filename:
tfp = open(filename, 'wb')
else:
tfp = tempfile.NamedTemporaryFile(delete=False)
filename = tfp.name
_url_tempfiles.append(filename)
with tfp:
result = filename, headers
bs = 1024*8
size = -1
read = 0
blocknum = 0
if "content-length" in headers:
size = int(headers["Content-Length"])
if reporthook:
reporthook(blocknum, bs, size)
while True:
block = fp.read(bs)
if not block:
break
read += len(block)
tfp.write(block)
blocknum += 1
if reporthook:
reporthook(blocknum, bs, size)
if size >= 0 and read < size:
raise ContentTooShortError(
"retrieval incomplete: got only %i out of %i bytes"
% (read, size), result)
return result
def urlcleanup():
for temp_file in _url_tempfiles:
try:
os.unlink(temp_file)
except EnvironmentError:
pass
del _url_tempfiles[:]
global _opener
if _opener:
_opener = None
if PY3:
_cut_port_re = re.compile(r":\d+$", re.ASCII)
else:
_cut_port_re = re.compile(r":\d+$")
def request_host(request):
"""Return request-host, as defined by RFC 2965.
Variation from RFC: returned value is lowercased, for convenient
comparison.
"""
url = request.full_url
host = urlparse(url)[1]
if host == "":
host = request.get_header("Host", "")
# remove port, if present
host = _cut_port_re.sub("", host, 1)
return host.lower()
class Request(object):
def __init__(self, url, data=None, headers={},
origin_req_host=None, unverifiable=False,
method=None):
# unwrap('<URL:type://host/path>') --> 'type://host/path'
self.full_url = unwrap(url)
self.full_url, self.fragment = splittag(self.full_url)
self.data = data
self.headers = {}
self._tunnel_host = None
for key, value in headers.items():
self.add_header(key, value)
self.unredirected_hdrs = {}
if origin_req_host is None:
origin_req_host = request_host(self)
self.origin_req_host = origin_req_host
self.unverifiable = unverifiable
self.method = method
self._parse()
def _parse(self):
self.type, rest = splittype(self.full_url)
if self.type is None:
raise ValueError("unknown url type: %r" % self.full_url)
self.host, self.selector = splithost(rest)
if self.host:
self.host = unquote(self.host)
def get_method(self):
"""Return a string indicating the HTTP request method."""
if self.method is not None:
return self.method
elif self.data is not None:
return "POST"
else:
return "GET"
def get_full_url(self):
if self.fragment:
return '%s#%s' % (self.full_url, self.fragment)
else:
return self.full_url
# Begin deprecated methods
def add_data(self, data):
msg = "Request.add_data method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
self.data = data
def has_data(self):
msg = "Request.has_data method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.data is not None
def get_data(self):
msg = "Request.get_data method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.data
def get_type(self):
msg = "Request.get_type method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.type
def get_host(self):
msg = "Request.get_host method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.host
def get_selector(self):
msg = "Request.get_selector method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.selector
def is_unverifiable(self):
msg = "Request.is_unverifiable method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.unverifiable
def get_origin_req_host(self):
msg = "Request.get_origin_req_host method is deprecated."
warnings.warn(msg, DeprecationWarning, stacklevel=1)
return self.origin_req_host
# End deprecated methods
def set_proxy(self, host, type):
if self.type == 'https' and not self._tunnel_host:
self._tunnel_host = self.host
else:
self.type= type
self.selector = self.full_url
self.host = host
def has_proxy(self):
return self.selector == self.full_url
def add_header(self, key, val):
# useful for something like authentication
self.headers[key.capitalize()] = val
def add_unredirected_header(self, key, val):
# will not be added to a redirected request
self.unredirected_hdrs[key.capitalize()] = val
def has_header(self, header_name):
return (header_name in self.headers or
header_name in self.unredirected_hdrs)
def get_header(self, header_name, default=None):
return self.headers.get(
header_name,
self.unredirected_hdrs.get(header_name, default))
def header_items(self):
hdrs = self.unredirected_hdrs.copy()
hdrs.update(self.headers)
return list(hdrs.items())
class OpenerDirector(object):
def __init__(self):
client_version = "Python-urllib/%s" % __version__
self.addheaders = [('User-agent', client_version)]
# self.handlers is retained only for backward compatibility
self.handlers = []
# manage the individual handlers
self.handle_open = {}
self.handle_error = {}
self.process_response = {}
self.process_request = {}
def add_handler(self, handler):
if not hasattr(handler, "add_parent"):
raise TypeError("expected BaseHandler instance, got %r" %
type(handler))
added = False
for meth in dir(handler):
if meth in ["redirect_request", "do_open", "proxy_open"]:
# oops, coincidental match
continue
i = meth.find("_")
protocol = meth[:i]
condition = meth[i+1:]
if condition.startswith("error"):
j = condition.find("_") + i + 1
kind = meth[j+1:]
try:
kind = int(kind)
except ValueError:
pass
lookup = self.handle_error.get(protocol, {})
self.handle_error[protocol] = lookup
elif condition == "open":
kind = protocol
lookup = self.handle_open
elif condition == "response":
kind = protocol
lookup = self.process_response
elif condition == "request":
kind = protocol
lookup = self.process_request
else:
continue
handlers = lookup.setdefault(kind, [])
if handlers:
bisect.insort(handlers, handler)
else:
handlers.append(handler)
added = True
if added:
bisect.insort(self.handlers, handler)
handler.add_parent(self)
def close(self):
# Only exists for backwards compatibility.
pass
def _call_chain(self, chain, kind, meth_name, *args):
# Handlers raise an exception if no one else should try to handle
# the request, or return None if they can't but another handler
# could. Otherwise, they return the response.
handlers = chain.get(kind, ())
for handler in handlers:
func = getattr(handler, meth_name)
result = func(*args)
if result is not None:
return result
def open(self, fullurl, data=None, timeout=socket._GLOBAL_DEFAULT_TIMEOUT):
"""
Accept a URL or a Request object
Python-Future: if the URL is passed as a byte-string, decode it first.
"""
if isinstance(fullurl, bytes):
fullurl = fullurl.decode()
if isinstance(fullurl, str):
req = Request(fullurl, data)
else:
req = fullurl
if data is not None:
req.data = data
req.timeout = timeout
protocol = req.type
# pre-process request
meth_name = protocol+"_request"
for processor in self.process_request.get(protocol, []):
meth = getattr(processor, meth_name)
req = meth(req)
response = self._open(req, data)
# post-process response
meth_name = protocol+"_response"
for processor in self.process_response.get(protocol, []):
meth = getattr(processor, meth_name)
response = meth(req, response)
return response
def _open(self, req, data=None):
result = self._call_chain(self.handle_open, 'default',
'default_open', req)
if result:
return result
protocol = req.type
result = self._call_chain(self.handle_open, protocol, protocol +
'_open', req)
if result:
return result
return self._call_chain(self.handle_open, 'unknown',
'unknown_open', req)
def error(self, proto, *args):
if proto in ('http', 'https'):
# XXX http[s] protocols are special-cased
dict = self.handle_error['http'] # https is not different than http
proto = args[2] # YUCK!
meth_name = 'http_error_%s' % proto
http_err = 1
orig_args = args
else:
dict = self.handle_error
meth_name = proto + '_error'
http_err = 0
args = (dict, proto, meth_name) + args
result = self._call_chain(*args)
if result:
return result
if http_err:
args = (dict, 'default', 'http_error_default') + orig_args
return self._call_chain(*args)
# XXX probably also want an abstract factory that knows when it makes
# sense to skip a superclass in favor of a subclass and when it might
# make sense to include both
def build_opener(*handlers):
"""Create an opener object from a list of handlers.
The opener will use several default handlers, including support
for HTTP, FTP and when applicable HTTPS.
If any of the handlers passed as arguments are subclasses of the
default handlers, the default handlers will not be used.
"""
def isclass(obj):
return isinstance(obj, type) or hasattr(obj, "__bases__")
opener = OpenerDirector()
default_classes = [ProxyHandler, UnknownHandler, HTTPHandler,
HTTPDefaultErrorHandler, HTTPRedirectHandler,
FTPHandler, FileHandler, HTTPErrorProcessor]
if hasattr(http_client, "HTTPSConnection"):
default_classes.append(HTTPSHandler)
skip = set()
for klass in default_classes:
for check in handlers:
if isclass(check):
if issubclass(check, klass):
skip.add(klass)
elif isinstance(check, klass):
skip.add(klass)
for klass in skip:
default_classes.remove(klass)
for klass in default_classes:
opener.add_handler(klass())
for h in handlers:
if isclass(h):
h = h()
opener.add_handler(h)
return opener
class BaseHandler(object):
handler_order = 500
def add_parent(self, parent):
self.parent = parent
def close(self):
# Only exists for backwards compatibility
pass
def __lt__(self, other):
if not hasattr(other, "handler_order"):
# Try to preserve the old behavior of having custom classes
# inserted after default ones (works only for custom user
# classes which are not aware of handler_order).
return True
return self.handler_order < other.handler_order
class HTTPErrorProcessor(BaseHandler):
"""Process HTTP error responses."""
handler_order = 1000 # after all other processing
def http_response(self, request, response):
code, msg, hdrs = response.code, response.msg, response.info()
# According to RFC 2616, "2xx" code indicates that the client's
# request was successfully received, understood, and accepted.
if not (200 <= code < 300):
response = self.parent.error(
'http', request, response, code, msg, hdrs)
return response
https_response = http_response
class HTTPDefaultErrorHandler(BaseHandler):
def http_error_default(self, req, fp, code, msg, hdrs):
raise HTTPError(req.full_url, code, msg, hdrs, fp)
class HTTPRedirectHandler(BaseHandler):
# maximum number of redirections to any single URL
# this is needed because of the state that cookies introduce
max_repeats = 4
# maximum total number of redirections (regardless of URL) before
# assuming we're in a loop
max_redirections = 10
def redirect_request(self, req, fp, code, msg, headers, newurl):
"""Return a Request or None in response to a redirect.
This is called by the http_error_30x methods when a
redirection response is received. If a redirection should
take place, return a new Request to allow http_error_30x to
perform the redirect. Otherwise, raise HTTPError if no-one
else should try to handle this url. Return None if you can't
but another Handler might.
"""
m = req.get_method()
if (not (code in (301, 302, 303, 307) and m in ("GET", "HEAD")
or code in (301, 302, 303) and m == "POST")):
raise HTTPError(req.full_url, code, msg, headers, fp)
# Strictly (according to RFC 2616), 301 or 302 in response to
# a POST MUST NOT cause a redirection without confirmation
# from the user (of urllib.request, in this case). In practice,
# essentially all clients do redirect in this case, so we do
# the same.
# be conciliant with URIs containing a space
newurl = newurl.replace(' ', '%20')
CONTENT_HEADERS = ("content-length", "content-type")
newheaders = dict((k, v) for k, v in req.headers.items()
if k.lower() not in CONTENT_HEADERS)
return Request(newurl,
headers=newheaders,
origin_req_host=req.origin_req_host,
unverifiable=True)
# Implementation note: To avoid the server sending us into an
# infinite loop, the request object needs to track what URLs we
# have already seen. Do this by adding a handler-specific
# attribute to the Request object.
def http_error_302(self, req, fp, code, msg, headers):
# Some servers (incorrectly) return multiple Location headers
# (so probably same goes for URI). Use first header.
if "location" in headers:
newurl = headers["location"]
elif "uri" in headers:
newurl = headers["uri"]
else:
return
# fix a possible malformed URL
urlparts = urlparse(newurl)
# For security reasons we don't allow redirection to anything other
# than http, https or ftp.
if urlparts.scheme not in ('http', 'https', 'ftp', ''):
raise HTTPError(
newurl, code,
"%s - Redirection to url '%s' is not allowed" % (msg, newurl),
headers, fp)
if not urlparts.path:
urlparts = list(urlparts)
urlparts[2] = "/"
newurl = urlunparse(urlparts)
newurl = urljoin(req.full_url, newurl)
# XXX Probably want to forget about the state of the current
# request, although that might interact poorly with other
# handlers that also use handler-specific request attributes
new = self.redirect_request(req, fp, code, msg, headers, newurl)
if new is None:
return
# loop detection
# .redirect_dict has a key url if url was previously visited.
if hasattr(req, 'redirect_dict'):
visited = new.redirect_dict = req.redirect_dict
if (visited.get(newurl, 0) >= self.max_repeats or
len(visited) >= self.max_redirections):
raise HTTPError(req.full_url, code,
self.inf_msg + msg, headers, fp)
else:
visited = new.redirect_dict = req.redirect_dict = {}
visited[newurl] = visited.get(newurl, 0) + 1
# Don't close the fp until we are sure that we won't use it
# with HTTPError.
fp.read()
fp.close()
return self.parent.open(new, timeout=req.timeout)
http_error_301 = http_error_303 = http_error_307 = http_error_302
inf_msg = "The HTTP server returned a redirect error that would " \
"lead to an infinite loop.\n" \
"The last 30x error message was:\n"
def _parse_proxy(proxy):
"""Return (scheme, user, password, host/port) given a URL or an authority.
If a URL is supplied, it must have an authority (host:port) component.
According to RFC 3986, having an authority component means the URL must
have two slashes after the scheme:
>>> _parse_proxy('file:/ftp.example.com/')
Traceback (most recent call last):
ValueError: proxy URL with no authority: 'file:/ftp.example.com/'
The first three items of the returned tuple may be None.
Examples of authority parsing:
>>> _parse_proxy('proxy.example.com')
(None, None, None, 'proxy.example.com')
>>> _parse_proxy('proxy.example.com:3128')
(None, None, None, 'proxy.example.com:3128')
The authority component may optionally include userinfo (assumed to be
username:password):
>>> _parse_proxy('joe:password@proxy.example.com')
(None, 'joe', 'password', 'proxy.example.com')
>>> _parse_proxy('joe:password@proxy.example.com:3128')
(None, 'joe', 'password', 'proxy.example.com:3128')
Same examples, but with URLs instead:
>>> _parse_proxy('http://proxy.example.com/')
('http', None, None, 'proxy.example.com')
>>> _parse_proxy('http://proxy.example.com:3128/')
('http', None, None, 'proxy.example.com:3128')
>>> _parse_proxy('http://joe:password@proxy.example.com/')
('http', 'joe', 'password', 'proxy.example.com')
>>> _parse_proxy('http://joe:password@proxy.example.com:3128')
('http', 'joe', 'password', 'proxy.example.com:3128')
Everything after the authority is ignored:
>>> _parse_proxy('ftp://joe:password@proxy.example.com/rubbish:3128')
('ftp', 'joe', 'password', 'proxy.example.com')
Test for no trailing '/' case:
>>> _parse_proxy('http://joe:password@proxy.example.com')
('http', 'joe', 'password', 'proxy.example.com')
"""
scheme, r_scheme = splittype(proxy)
if not r_scheme.startswith("/"):
# authority
scheme = None
authority = proxy
else:
# URL
if not r_scheme.startswith("//"):
raise ValueError("proxy URL with no authority: %r" % proxy)
# We have an authority, so for RFC 3986-compliant URLs (by ss 3.
# and 3.3.), path is empty or starts with '/'
end = r_scheme.find("/", 2)
if end == -1:
end = None
authority = r_scheme[2:end]
userinfo, hostport = splituser(authority)
if userinfo is not None:
user, password = splitpasswd(userinfo)
else:
user = password = None
return scheme, user, password, hostport
class ProxyHandler(BaseHandler):
# Proxies must be in front
handler_order = 100
def __init__(self, proxies=None):
if proxies is None:
proxies = getproxies()
assert hasattr(proxies, 'keys'), "proxies must be a mapping"
self.proxies = proxies
for type, url in proxies.items():
setattr(self, '%s_open' % type,
lambda r, proxy=url, type=type, meth=self.proxy_open:
meth(r, proxy, type))
def proxy_open(self, req, proxy, type):
orig_type = req.type
proxy_type, user, password, hostport = _parse_proxy(proxy)
if proxy_type is None:
proxy_type = orig_type
if req.host and proxy_bypass(req.host):
return None
if user and password:
user_pass = '%s:%s' % (unquote(user),
unquote(password))
creds = base64.b64encode(user_pass.encode()).decode("ascii")
req.add_header('Proxy-authorization', 'Basic ' + creds)
hostport = unquote(hostport)
req.set_proxy(hostport, proxy_type)
if orig_type == proxy_type or orig_type == 'https':
# let other handlers take care of it
return None
else:
# need to start over, because the other handlers don't
# grok the proxy's URL type
# e.g. if we have a constructor arg proxies like so:
# {'http': 'ftp://proxy.example.com'}, we may end up turning
# a request for http://acme.example.com/a into one for
# ftp://proxy.example.com/a
return self.parent.open(req, timeout=req.timeout)
class HTTPPasswordMgr(object):
def __init__(self):
self.passwd = {}
def add_password(self, realm, uri, user, passwd):
# uri could be a single URI or a sequence
if isinstance(uri, str):
uri = [uri]
if realm not in self.passwd:
self.passwd[realm] = {}
for default_port in True, False:
reduced_uri = tuple(
[self.reduce_uri(u, default_port) for u in uri])
self.passwd[realm][reduced_uri] = (user, passwd)
def find_user_password(self, realm, authuri):
domains = self.passwd.get(realm, {})
for default_port in True, False:
reduced_authuri = self.reduce_uri(authuri, default_port)
for uris, authinfo in domains.items():
for uri in uris:
if self.is_suburi(uri, reduced_authuri):
return authinfo
return None, None
def reduce_uri(self, uri, default_port=True):
"""Accept authority or URI and extract only the authority and path."""
# note HTTP URLs do not have a userinfo component
parts = urlsplit(uri)
if parts[1]:
# URI
scheme = parts[0]
authority = parts[1]
path = parts[2] or '/'
else:
# host or host:port
scheme = None
authority = uri
path = '/'
host, port = splitport(authority)
if default_port and port is None and scheme is not None:
dport = {"http": 80,
"https": 443,
}.get(scheme)
if dport is not None:
authority = "%s:%d" % (host, dport)
return authority, path
def is_suburi(self, base, test):
"""Check if test is below base in a URI tree
Both args must be URIs in reduced form.
"""
if base == test:
return True
if base[0] != test[0]:
return False
common = posixpath.commonprefix((base[1], test[1]))
if len(common) == len(base[1]):
return True
return False
class HTTPPasswordMgrWithDefaultRealm(HTTPPasswordMgr):
def find_user_password(self, realm, authuri):
user, password = HTTPPasswordMgr.find_user_password(self, realm,
authuri)
if user is not None:
return user, password
return HTTPPasswordMgr.find_user_password(self, None, authuri)
class AbstractBasicAuthHandler(object):
# XXX this allows for multiple auth-schemes, but will stupidly pick
# the last one with a realm specified.
# allow for double- and single-quoted realm values
# (single quotes are a violation of the RFC, but appear in the wild)
rx = re.compile('(?:.*,)*[ \t]*([^ \t]+)[ \t]+'
'realm=(["\']?)([^"\']*)\\2', re.I)
# XXX could pre-emptively send auth info already accepted (RFC 2617,
# end of section 2, and section 1.2 immediately after "credentials"
# production).
def __init__(self, password_mgr=None):
if password_mgr is None:
password_mgr = HTTPPasswordMgr()
self.passwd = password_mgr
self.add_password = self.passwd.add_password
self.retried = 0
def reset_retry_count(self):
self.retried = 0
def http_error_auth_reqed(self, authreq, host, req, headers):
# host may be an authority (without userinfo) or a URL with an
# authority
# XXX could be multiple headers
authreq = headers.get(authreq, None)
if self.retried > 5:
# retry sending the username:password 5 times before failing.
raise HTTPError(req.get_full_url(), 401, "basic auth failed",
headers, None)
else:
self.retried += 1
if authreq:
scheme = authreq.split()[0]
if scheme.lower() != 'basic':
raise ValueError("AbstractBasicAuthHandler does not"
" support the following scheme: '%s'" %
scheme)
else:
mo = AbstractBasicAuthHandler.rx.search(authreq)
if mo:
scheme, quote, realm = mo.groups()
if quote not in ['"',"'"]:
warnings.warn("Basic Auth Realm was unquoted",
UserWarning, 2)
if scheme.lower() == 'basic':
response = self.retry_http_basic_auth(host, req, realm)
if response and response.code != 401:
self.retried = 0
return response
def retry_http_basic_auth(self, host, req, realm):
user, pw = self.passwd.find_user_password(realm, host)
if pw is not None:
raw = "%s:%s" % (user, pw)
auth = "Basic " + base64.b64encode(raw.encode()).decode("ascii")
if req.headers.get(self.auth_header, None) == auth:
return None
req.add_unredirected_header(self.auth_header, auth)
return self.parent.open(req, timeout=req.timeout)
else:
return None
class HTTPBasicAuthHandler(AbstractBasicAuthHandler, BaseHandler):
auth_header = 'Authorization'
def http_error_401(self, req, fp, code, msg, headers):
url = req.full_url
response = self.http_error_auth_reqed('www-authenticate',
url, req, headers)
self.reset_retry_count()
return response
class ProxyBasicAuthHandler(AbstractBasicAuthHandler, BaseHandler):
auth_header = 'Proxy-authorization'
def http_error_407(self, req, fp, code, msg, headers):
# http_error_auth_reqed requires that there is no userinfo component in
# authority. Assume there isn't one, since urllib.request does not (and
# should not, RFC 3986 s. 3.2.1) support requests for URLs containing
# userinfo.
authority = req.host
response = self.http_error_auth_reqed('proxy-authenticate',
authority, req, headers)
self.reset_retry_count()
return response
# Return n random bytes.
_randombytes = os.urandom
class AbstractDigestAuthHandler(object):
# Digest authentication is specified in RFC 2617.
# XXX The client does not inspect the Authentication-Info header
# in a successful response.
# XXX It should be possible to test this implementation against
# a mock server that just generates a static set of challenges.
# XXX qop="auth-int" supports is shaky
def __init__(self, passwd=None):
if passwd is None:
passwd = HTTPPasswordMgr()
self.passwd = passwd
self.add_password = self.passwd.add_password
self.retried = 0
self.nonce_count = 0
self.last_nonce = None
def reset_retry_count(self):
self.retried = 0
def http_error_auth_reqed(self, auth_header, host, req, headers):
authreq = headers.get(auth_header, None)
if self.retried > 5:
# Don't fail endlessly - if we failed once, we'll probably
# fail a second time. Hm. Unless the Password Manager is
# prompting for the information. Crap. This isn't great
# but it's better than the current 'repeat until recursion
# depth exceeded' approach <wink>
raise HTTPError(req.full_url, 401, "digest auth failed",
headers, None)
else:
self.retried += 1
if authreq:
scheme = authreq.split()[0]
if scheme.lower() == 'digest':
return self.retry_http_digest_auth(req, authreq)
elif scheme.lower() != 'basic':
raise ValueError("AbstractDigestAuthHandler does not support"
" the following scheme: '%s'" % scheme)
def retry_http_digest_auth(self, req, auth):
token, challenge = auth.split(' ', 1)
chal = parse_keqv_list(filter(None, parse_http_list(challenge)))
auth = self.get_authorization(req, chal)
if auth:
auth_val = 'Digest %s' % auth
if req.headers.get(self.auth_header, None) == auth_val:
return None
req.add_unredirected_header(self.auth_header, auth_val)
resp = self.parent.open(req, timeout=req.timeout)
return resp
def get_cnonce(self, nonce):
# The cnonce-value is an opaque
# quoted string value provided by the client and used by both client
# and server to avoid chosen plaintext attacks, to provide mutual
# authentication, and to provide some message integrity protection.
# This isn't a fabulous effort, but it's probably Good Enough.
s = "%s:%s:%s:" % (self.nonce_count, nonce, time.ctime())
b = s.encode("ascii") + _randombytes(8)
dig = hashlib.sha1(b).hexdigest()
return dig[:16]
def get_authorization(self, req, chal):
try:
realm = chal['realm']
nonce = chal['nonce']
qop = chal.get('qop')
algorithm = chal.get('algorithm', 'MD5')
# mod_digest doesn't send an opaque, even though it isn't
# supposed to be optional
opaque = chal.get('opaque', None)
except KeyError:
return None
H, KD = self.get_algorithm_impls(algorithm)
if H is None:
return None
user, pw = self.passwd.find_user_password(realm, req.full_url)
if user is None:
return None
# XXX not implemented yet
if req.data is not None:
entdig = self.get_entity_digest(req.data, chal)
else:
entdig = None
A1 = "%s:%s:%s" % (user, realm, pw)
A2 = "%s:%s" % (req.get_method(),
# XXX selector: what about proxies and full urls
req.selector)
if qop == 'auth':
if nonce == self.last_nonce:
self.nonce_count += 1
else:
self.nonce_count = 1
self.last_nonce = nonce
ncvalue = '%08x' % self.nonce_count
cnonce = self.get_cnonce(nonce)
noncebit = "%s:%s:%s:%s:%s" % (nonce, ncvalue, cnonce, qop, H(A2))
respdig = KD(H(A1), noncebit)
elif qop is None:
respdig = KD(H(A1), "%s:%s" % (nonce, H(A2)))
else:
# XXX handle auth-int.
raise URLError("qop '%s' is not supported." % qop)
# XXX should the partial digests be encoded too?
base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
'response="%s"' % (user, realm, nonce, req.selector,
respdig)
if opaque:
base += ', opaque="%s"' % opaque
if entdig:
base += ', digest="%s"' % entdig
base += ', algorithm="%s"' % algorithm
if qop:
base += ', qop=auth, nc=%s, cnonce="%s"' % (ncvalue, cnonce)
return base
def get_algorithm_impls(self, algorithm):
# lambdas assume digest modules are imported at the top level
if algorithm == 'MD5':
H = lambda x: hashlib.md5(x.encode("ascii")).hexdigest()
elif algorithm == 'SHA':
H = lambda x: hashlib.sha1(x.encode("ascii")).hexdigest()
# XXX MD5-sess
KD = lambda s, d: H("%s:%s" % (s, d))
return H, KD
def get_entity_digest(self, data, chal):
# XXX not implemented yet
return None
class HTTPDigestAuthHandler(BaseHandler, AbstractDigestAuthHandler):
"""An authentication protocol defined by RFC 2069
Digest authentication improves on basic authentication because it
does not transmit passwords in the clear.
"""
auth_header = 'Authorization'
handler_order = 490 # before Basic auth
def http_error_401(self, req, fp, code, msg, headers):
host = urlparse(req.full_url)[1]
retry = self.http_error_auth_reqed('www-authenticate',
host, req, headers)
self.reset_retry_count()
return retry
class ProxyDigestAuthHandler(BaseHandler, AbstractDigestAuthHandler):
auth_header = 'Proxy-Authorization'
handler_order = 490 # before Basic auth
def http_error_407(self, req, fp, code, msg, headers):
host = req.host
retry = self.http_error_auth_reqed('proxy-authenticate',
host, req, headers)
self.reset_retry_count()
return retry
class AbstractHTTPHandler(BaseHandler):
def __init__(self, debuglevel=0):
self._debuglevel = debuglevel
def set_http_debuglevel(self, level):
self._debuglevel = level
def do_request_(self, request):
host = request.host
if not host:
raise URLError('no host given')
if request.data is not None: # POST
data = request.data
if isinstance(data, str):
msg = "POST data should be bytes or an iterable of bytes. " \
"It cannot be of type str."
raise TypeError(msg)
if not request.has_header('Content-type'):
request.add_unredirected_header(
'Content-type',
'application/x-www-form-urlencoded')
if not request.has_header('Content-length'):
size = None
try:
### For Python-Future:
if PY2 and isinstance(data, array.array):
# memoryviews of arrays aren't supported
# in Py2.7. (e.g. memoryview(array.array('I',
# [1, 2, 3, 4])) raises a TypeError.)
# So we calculate the size manually instead:
size = len(data) * data.itemsize
###
else:
mv = memoryview(data)
size = len(mv) * mv.itemsize
except TypeError:
if isinstance(data, Iterable):
raise ValueError("Content-Length should be specified "
"for iterable data of type %r %r" % (type(data),
data))
else:
request.add_unredirected_header(
'Content-length', '%d' % size)
sel_host = host
if request.has_proxy():
scheme, sel = splittype(request.selector)
sel_host, sel_path = splithost(sel)
if not request.has_header('Host'):
request.add_unredirected_header('Host', sel_host)
for name, value in self.parent.addheaders:
name = name.capitalize()
if not request.has_header(name):
request.add_unredirected_header(name, value)
return request
def do_open(self, http_class, req, **http_conn_args):
"""Return an HTTPResponse object for the request, using http_class.
http_class must implement the HTTPConnection API from http.client.
"""
host = req.host
if not host:
raise URLError('no host given')
# will parse host:port
h = http_class(host, timeout=req.timeout, **http_conn_args)
headers = dict(req.unredirected_hdrs)
headers.update(dict((k, v) for k, v in req.headers.items()
if k not in headers))
# TODO(jhylton): Should this be redesigned to handle
# persistent connections?
# We want to make an HTTP/1.1 request, but the addinfourl
# class isn't prepared to deal with a persistent connection.
# It will try to read all remaining data from the socket,
# which will block while the server waits for the next request.
# So make sure the connection gets closed after the (only)
# request.
headers["Connection"] = "close"
headers = dict((name.title(), val) for name, val in headers.items())
if req._tunnel_host:
tunnel_headers = {}
proxy_auth_hdr = "Proxy-Authorization"
if proxy_auth_hdr in headers:
tunnel_headers[proxy_auth_hdr] = headers[proxy_auth_hdr]
# Proxy-Authorization should not be sent to origin
# server.
del headers[proxy_auth_hdr]
h.set_tunnel(req._tunnel_host, headers=tunnel_headers)
try:
h.request(req.get_method(), req.selector, req.data, headers)
except socket.error as err: # timeout error
h.close()
raise URLError(err)
else:
r = h.getresponse()
# If the server does not send us a 'Connection: close' header,
# HTTPConnection assumes the socket should be left open. Manually
# mark the socket to be closed when this response object goes away.
if h.sock:
h.sock.close()
h.sock = None
r.url = req.get_full_url()
# This line replaces the .msg attribute of the HTTPResponse
# with .headers, because urllib clients expect the response to
# have the reason in .msg. It would be good to mark this
# attribute is deprecated and get then to use info() or
# .headers.
r.msg = r.reason
return r
class HTTPHandler(AbstractHTTPHandler):
def http_open(self, req):
return self.do_open(http_client.HTTPConnection, req)
http_request = AbstractHTTPHandler.do_request_
if hasattr(http_client, 'HTTPSConnection'):
class HTTPSHandler(AbstractHTTPHandler):
def __init__(self, debuglevel=0, context=None, check_hostname=None):
AbstractHTTPHandler.__init__(self, debuglevel)
self._context = context
self._check_hostname = check_hostname
def https_open(self, req):
return self.do_open(http_client.HTTPSConnection, req,
context=self._context, check_hostname=self._check_hostname)
https_request = AbstractHTTPHandler.do_request_
__all__.append('HTTPSHandler')
class HTTPCookieProcessor(BaseHandler):
def __init__(self, cookiejar=None):
import future.backports.http.cookiejar as http_cookiejar
if cookiejar is None:
cookiejar = http_cookiejar.CookieJar()
self.cookiejar = cookiejar
def http_request(self, request):
self.cookiejar.add_cookie_header(request)
return request
def http_response(self, request, response):
self.cookiejar.extract_cookies(response, request)
return response
https_request = http_request
https_response = http_response
class UnknownHandler(BaseHandler):
def unknown_open(self, req):
type = req.type
raise URLError('unknown url type: %s' % type)
def parse_keqv_list(l):
"""Parse list of key=value strings where keys are not duplicated."""
parsed = {}
for elt in l:
k, v = elt.split('=', 1)
if v[0] == '"' and v[-1] == '"':
v = v[1:-1]
parsed[k] = v
return parsed
def parse_http_list(s):
"""Parse lists as described by RFC 2068 Section 2.
In particular, parse comma-separated lists where the elements of
the list may include quoted-strings. A quoted-string could
contain a comma. A non-quoted string could have quotes in the
middle. Neither commas nor quotes count if they are escaped.
Only double-quotes count, not single-quotes.
"""
res = []
part = ''
escape = quote = False
for cur in s:
if escape:
part += cur
escape = False
continue
if quote:
if cur == '\\':
escape = True
continue
elif cur == '"':
quote = False
part += cur
continue
if cur == ',':
res.append(part)
part = ''
continue
if cur == '"':
quote = True
part += cur
# append last part
if part:
res.append(part)
return [part.strip() for part in res]
class FileHandler(BaseHandler):
# Use local file or FTP depending on form of URL
def file_open(self, req):
url = req.selector
if url[:2] == '//' and url[2:3] != '/' and (req.host and
req.host != 'localhost'):
if not req.host is self.get_names():
raise URLError("file:// scheme is supported only on localhost")
else:
return self.open_local_file(req)
# names for the localhost
names = None
def get_names(self):
if FileHandler.names is None:
try:
FileHandler.names = tuple(
socket.gethostbyname_ex('localhost')[2] +
socket.gethostbyname_ex(socket.gethostname())[2])
except socket.gaierror:
FileHandler.names = (socket.gethostbyname('localhost'),)
return FileHandler.names
# not entirely sure what the rules are here
def open_local_file(self, req):
import future.backports.email.utils as email_utils
import mimetypes
host = req.host
filename = req.selector
localfile = url2pathname(filename)
try:
stats = os.stat(localfile)
size = stats.st_size
modified = email_utils.formatdate(stats.st_mtime, usegmt=True)
mtype = mimetypes.guess_type(filename)[0]
headers = email.message_from_string(
'Content-type: %s\nContent-length: %d\nLast-modified: %s\n' %
(mtype or 'text/plain', size, modified))
if host:
host, port = splitport(host)
if not host or \
(not port and _safe_gethostbyname(host) in self.get_names()):
if host:
origurl = 'file://' + host + filename
else:
origurl = 'file://' + filename
return addinfourl(open(localfile, 'rb'), headers, origurl)
except OSError as exp:
# users shouldn't expect OSErrors coming from urlopen()
raise URLError(exp)
raise URLError('file not on local host')
def _safe_gethostbyname(host):
try:
return socket.gethostbyname(host)
except socket.gaierror:
return None
class FTPHandler(BaseHandler):
def ftp_open(self, req):
import ftplib
import mimetypes
host = req.host
if not host:
raise URLError('ftp error: no host given')
host, port = splitport(host)
if port is None:
port = ftplib.FTP_PORT
else:
port = int(port)
# username/password handling
user, host = splituser(host)
if user:
user, passwd = splitpasswd(user)
else:
passwd = None
host = unquote(host)
user = user or ''
passwd = passwd or ''
try:
host = socket.gethostbyname(host)
except socket.error as msg:
raise URLError(msg)
path, attrs = splitattr(req.selector)
dirs = path.split('/')
dirs = list(map(unquote, dirs))
dirs, file = dirs[:-1], dirs[-1]
if dirs and not dirs[0]:
dirs = dirs[1:]
try:
fw = self.connect_ftp(user, passwd, host, port, dirs, req.timeout)
type = file and 'I' or 'D'
for attr in attrs:
attr, value = splitvalue(attr)
if attr.lower() == 'type' and \
value in ('a', 'A', 'i', 'I', 'd', 'D'):
type = value.upper()
fp, retrlen = fw.retrfile(file, type)
headers = ""
mtype = mimetypes.guess_type(req.full_url)[0]
if mtype:
headers += "Content-type: %s\n" % mtype
if retrlen is not None and retrlen >= 0:
headers += "Content-length: %d\n" % retrlen
headers = email.message_from_string(headers)
return addinfourl(fp, headers, req.full_url)
except ftplib.all_errors as exp:
exc = URLError('ftp error: %r' % exp)
raise_with_traceback(exc)
def connect_ftp(self, user, passwd, host, port, dirs, timeout):
return ftpwrapper(user, passwd, host, port, dirs, timeout,
persistent=False)
class CacheFTPHandler(FTPHandler):
# XXX would be nice to have pluggable cache strategies
# XXX this stuff is definitely not thread safe
def __init__(self):
self.cache = {}
self.timeout = {}
self.soonest = 0
self.delay = 60
self.max_conns = 16
def setTimeout(self, t):
self.delay = t
def setMaxConns(self, m):
self.max_conns = m
def connect_ftp(self, user, passwd, host, port, dirs, timeout):
key = user, host, port, '/'.join(dirs), timeout
if key in self.cache:
self.timeout[key] = time.time() + self.delay
else:
self.cache[key] = ftpwrapper(user, passwd, host, port,
dirs, timeout)
self.timeout[key] = time.time() + self.delay
self.check_cache()
return self.cache[key]
def check_cache(self):
# first check for old ones
t = time.time()
if self.soonest <= t:
for k, v in list(self.timeout.items()):
if v < t:
self.cache[k].close()
del self.cache[k]
del self.timeout[k]
self.soonest = min(list(self.timeout.values()))
# then check the size
if len(self.cache) == self.max_conns:
for k, v in list(self.timeout.items()):
if v == self.soonest:
del self.cache[k]
del self.timeout[k]
break
self.soonest = min(list(self.timeout.values()))
def clear_cache(self):
for conn in self.cache.values():
conn.close()
self.cache.clear()
self.timeout.clear()
# Code move from the old urllib module
MAXFTPCACHE = 10 # Trim the ftp cache beyond this size
# Helper for non-unix systems
if os.name == 'nt':
from nturl2path import url2pathname, pathname2url
else:
def url2pathname(pathname):
"""OS-specific conversion from a relative URL of the 'file' scheme
to a file system path; not recommended for general use."""
return unquote(pathname)
def pathname2url(pathname):
"""OS-specific conversion from a file system path to a relative URL
of the 'file' scheme; not recommended for general use."""
return quote(pathname)
# This really consists of two pieces:
# (1) a class which handles opening of all sorts of URLs
# (plus assorted utilities etc.)
# (2) a set of functions for parsing URLs
# XXX Should these be separated out into different modules?
ftpcache = {}
class URLopener(object):
"""Class to open URLs.
This is a class rather than just a subroutine because we may need
more than one set of global protocol-specific options.
Note -- this is a base class for those who don't want the
automatic handling of errors type 302 (relocated) and 401
(authorization needed)."""
__tempfiles = None
version = "Python-urllib/%s" % __version__
# Constructor
def __init__(self, proxies=None, **x509):
msg = "%(class)s style of invoking requests is deprecated. " \
"Use newer urlopen functions/methods" % {'class': self.__class__.__name__}
warnings.warn(msg, DeprecationWarning, stacklevel=3)
if proxies is None:
proxies = getproxies()
assert hasattr(proxies, 'keys'), "proxies must be a mapping"
self.proxies = proxies
self.key_file = x509.get('key_file')
self.cert_file = x509.get('cert_file')
self.addheaders = [('User-Agent', self.version)]
self.__tempfiles = []
self.__unlink = os.unlink # See cleanup()
self.tempcache = None
# Undocumented feature: if you assign {} to tempcache,
# it is used to cache files retrieved with
# self.retrieve(). This is not enabled by default
# since it does not work for changing documents (and I
# haven't got the logic to check expiration headers
# yet).
self.ftpcache = ftpcache
# Undocumented feature: you can use a different
# ftp cache by assigning to the .ftpcache member;
# in case you want logically independent URL openers
# XXX This is not threadsafe. Bah.
def __del__(self):
self.close()
def close(self):
self.cleanup()
def cleanup(self):
# This code sometimes runs when the rest of this module
# has already been deleted, so it can't use any globals
# or import anything.
if self.__tempfiles:
for file in self.__tempfiles:
try:
self.__unlink(file)
except OSError:
pass
del self.__tempfiles[:]
if self.tempcache:
self.tempcache.clear()
def addheader(self, *args):
"""Add a header to be used by the HTTP interface only
e.g. u.addheader('Accept', 'sound/basic')"""
self.addheaders.append(args)
# External interface
def open(self, fullurl, data=None):
"""Use URLopener().open(file) instead of open(file, 'r')."""
fullurl = unwrap(to_bytes(fullurl))
fullurl = quote(fullurl, safe="%/:=&?~#+!$,;'@()*[]|")
if self.tempcache and fullurl in self.tempcache:
filename, headers = self.tempcache[fullurl]
fp = open(filename, 'rb')
return addinfourl(fp, headers, fullurl)
urltype, url = splittype(fullurl)
if not urltype:
urltype = 'file'
if urltype in self.proxies:
proxy = self.proxies[urltype]
urltype, proxyhost = splittype(proxy)
host, selector = splithost(proxyhost)
url = (host, fullurl) # Signal special case to open_*()
else:
proxy = None
name = 'open_' + urltype
self.type = urltype
name = name.replace('-', '_')
if not hasattr(self, name):
if proxy:
return self.open_unknown_proxy(proxy, fullurl, data)
else:
return self.open_unknown(fullurl, data)
try:
if data is None:
return getattr(self, name)(url)
else:
return getattr(self, name)(url, data)
except HTTPError:
raise
except socket.error as msg:
raise_with_traceback(IOError('socket error', msg))
def open_unknown(self, fullurl, data=None):
"""Overridable interface to open unknown URL type."""
type, url = splittype(fullurl)
raise IOError('url error', 'unknown url type', type)
def open_unknown_proxy(self, proxy, fullurl, data=None):
"""Overridable interface to open unknown URL type."""
type, url = splittype(fullurl)
raise IOError('url error', 'invalid proxy for %s' % type, proxy)
# External interface
def retrieve(self, url, filename=None, reporthook=None, data=None):
"""retrieve(url) returns (filename, headers) for a local object
or (tempfilename, headers) for a remote object."""
url = unwrap(to_bytes(url))
if self.tempcache and url in self.tempcache:
return self.tempcache[url]
type, url1 = splittype(url)
if filename is None and (not type or type == 'file'):
try:
fp = self.open_local_file(url1)
hdrs = fp.info()
fp.close()
return url2pathname(splithost(url1)[1]), hdrs
except IOError as msg:
pass
fp = self.open(url, data)
try:
headers = fp.info()
if filename:
tfp = open(filename, 'wb')
else:
import tempfile
garbage, path = splittype(url)
garbage, path = splithost(path or "")
path, garbage = splitquery(path or "")
path, garbage = splitattr(path or "")
suffix = os.path.splitext(path)[1]
(fd, filename) = tempfile.mkstemp(suffix)
self.__tempfiles.append(filename)
tfp = os.fdopen(fd, 'wb')
try:
result = filename, headers
if self.tempcache is not None:
self.tempcache[url] = result
bs = 1024*8
size = -1
read = 0
blocknum = 0
if "content-length" in headers:
size = int(headers["Content-Length"])
if reporthook:
reporthook(blocknum, bs, size)
while 1:
block = fp.read(bs)
if not block:
break
read += len(block)
tfp.write(block)
blocknum += 1
if reporthook:
reporthook(blocknum, bs, size)
finally:
tfp.close()
finally:
fp.close()
# raise exception if actual size does not match content-length header
if size >= 0 and read < size:
raise ContentTooShortError(
"retrieval incomplete: got only %i out of %i bytes"
% (read, size), result)
return result
# Each method named open_<type> knows how to open that type of URL
def _open_generic_http(self, connection_factory, url, data):
"""Make an HTTP connection using connection_class.
This is an internal method that should be called from
open_http() or open_https().
Arguments:
- connection_factory should take a host name and return an
HTTPConnection instance.
- url is the url to retrieval or a host, relative-path pair.
- data is payload for a POST request or None.
"""
user_passwd = None
proxy_passwd= None
if isinstance(url, str):
host, selector = splithost(url)
if host:
user_passwd, host = splituser(host)
host = unquote(host)
realhost = host
else:
host, selector = url
# check whether the proxy contains authorization information
proxy_passwd, host = splituser(host)
# now we proceed with the url we want to obtain
urltype, rest = splittype(selector)
url = rest
user_passwd = None
if urltype.lower() != 'http':
realhost = None
else:
realhost, rest = splithost(rest)
if realhost:
user_passwd, realhost = splituser(realhost)
if user_passwd:
selector = "%s://%s%s" % (urltype, realhost, rest)
if proxy_bypass(realhost):
host = realhost
if not host: raise IOError('http error', 'no host given')
if proxy_passwd:
proxy_passwd = unquote(proxy_passwd)
proxy_auth = base64.b64encode(proxy_passwd.encode()).decode('ascii')
else:
proxy_auth = None
if user_passwd:
user_passwd = unquote(user_passwd)
auth = base64.b64encode(user_passwd.encode()).decode('ascii')
else:
auth = None
http_conn = connection_factory(host)
headers = {}
if proxy_auth:
headers["Proxy-Authorization"] = "Basic %s" % proxy_auth
if auth:
headers["Authorization"] = "Basic %s" % auth
if realhost:
headers["Host"] = realhost
# Add Connection:close as we don't support persistent connections yet.
# This helps in closing the socket and avoiding ResourceWarning
headers["Connection"] = "close"
for header, value in self.addheaders:
headers[header] = value
if data is not None:
headers["Content-Type"] = "application/x-www-form-urlencoded"
http_conn.request("POST", selector, data, headers)
else:
http_conn.request("GET", selector, headers=headers)
try:
response = http_conn.getresponse()
except http_client.BadStatusLine:
# something went wrong with the HTTP status line
raise URLError("http protocol error: bad status line")
# According to RFC 2616, "2xx" code indicates that the client's
# request was successfully received, understood, and accepted.
if 200 <= response.status < 300:
return addinfourl(response, response.msg, "http:" + url,
response.status)
else:
return self.http_error(
url, response.fp,
response.status, response.reason, response.msg, data)
def open_http(self, url, data=None):
"""Use HTTP protocol."""
return self._open_generic_http(http_client.HTTPConnection, url, data)
def http_error(self, url, fp, errcode, errmsg, headers, data=None):
"""Handle http errors.
Derived class can override this, or provide specific handlers
named http_error_DDD where DDD is the 3-digit error code."""
# First check if there's a specific handler for this error
name = 'http_error_%d' % errcode
if hasattr(self, name):
method = getattr(self, name)
if data is None:
result = method(url, fp, errcode, errmsg, headers)
else:
result = method(url, fp, errcode, errmsg, headers, data)
if result: return result
return self.http_error_default(url, fp, errcode, errmsg, headers)
def http_error_default(self, url, fp, errcode, errmsg, headers):
"""Default error handler: close the connection and raise IOError."""
fp.close()
raise HTTPError(url, errcode, errmsg, headers, None)
if _have_ssl:
def _https_connection(self, host):
return http_client.HTTPSConnection(host,
key_file=self.key_file,
cert_file=self.cert_file)
def open_https(self, url, data=None):
"""Use HTTPS protocol."""
return self._open_generic_http(self._https_connection, url, data)
def open_file(self, url):
"""Use local file or FTP depending on form of URL."""
if not isinstance(url, str):
raise URLError('file error: proxy support for file protocol currently not implemented')
if url[:2] == '//' and url[2:3] != '/' and url[2:12].lower() != 'localhost/':
raise ValueError("file:// scheme is supported only on localhost")
else:
return self.open_local_file(url)
def open_local_file(self, url):
"""Use local file."""
import future.backports.email.utils as email_utils
import mimetypes
host, file = splithost(url)
localname = url2pathname(file)
try:
stats = os.stat(localname)
except OSError as e:
raise URLError(e.strerror, e.filename)
size = stats.st_size
modified = email_utils.formatdate(stats.st_mtime, usegmt=True)
mtype = mimetypes.guess_type(url)[0]
headers = email.message_from_string(
'Content-Type: %s\nContent-Length: %d\nLast-modified: %s\n' %
(mtype or 'text/plain', size, modified))
if not host:
urlfile = file
if file[:1] == '/':
urlfile = 'file://' + file
return addinfourl(open(localname, 'rb'), headers, urlfile)
host, port = splitport(host)
if (not port
and socket.gethostbyname(host) in ((localhost(),) + thishost())):
urlfile = file
if file[:1] == '/':
urlfile = 'file://' + file
elif file[:2] == './':
raise ValueError("local file url may start with / or file:. Unknown url of type: %s" % url)
return addinfourl(open(localname, 'rb'), headers, urlfile)
raise URLError('local file error: not on local host')
def open_ftp(self, url):
"""Use FTP protocol."""
if not isinstance(url, str):
raise URLError('ftp error: proxy support for ftp protocol currently not implemented')
import mimetypes
host, path = splithost(url)
if not host: raise URLError('ftp error: no host given')
host, port = splitport(host)
user, host = splituser(host)
if user: user, passwd = splitpasswd(user)
else: passwd = None
host = unquote(host)
user = unquote(user or '')
passwd = unquote(passwd or '')
host = socket.gethostbyname(host)
if not port:
import ftplib
port = ftplib.FTP_PORT
else:
port = int(port)
path, attrs = splitattr(path)
path = unquote(path)
dirs = path.split('/')
dirs, file = dirs[:-1], dirs[-1]
if dirs and not dirs[0]: dirs = dirs[1:]
if dirs and not dirs[0]: dirs[0] = '/'
key = user, host, port, '/'.join(dirs)
# XXX thread unsafe!
if len(self.ftpcache) > MAXFTPCACHE:
# Prune the cache, rather arbitrarily
for k in self.ftpcache.keys():
if k != key:
v = self.ftpcache[k]
del self.ftpcache[k]
v.close()
try:
if key not in self.ftpcache:
self.ftpcache[key] = \
ftpwrapper(user, passwd, host, port, dirs)
if not file: type = 'D'
else: type = 'I'
for attr in attrs:
attr, value = splitvalue(attr)
if attr.lower() == 'type' and \
value in ('a', 'A', 'i', 'I', 'd', 'D'):
type = value.upper()
(fp, retrlen) = self.ftpcache[key].retrfile(file, type)
mtype = mimetypes.guess_type("ftp:" + url)[0]
headers = ""
if mtype:
headers += "Content-Type: %s\n" % mtype
if retrlen is not None and retrlen >= 0:
headers += "Content-Length: %d\n" % retrlen
headers = email.message_from_string(headers)
return addinfourl(fp, headers, "ftp:" + url)
except ftperrors() as exp:
raise_with_traceback(URLError('ftp error %r' % exp))
def open_data(self, url, data=None):
"""Use "data" URL."""
if not isinstance(url, str):
raise URLError('data error: proxy support for data protocol currently not implemented')
# ignore POSTed data
#
# syntax of data URLs:
# dataurl := "data:" [ mediatype ] [ ";base64" ] "," data
# mediatype := [ type "/" subtype ] *( ";" parameter )
# data := *urlchar
# parameter := attribute "=" value
try:
[type, data] = url.split(',', 1)
except ValueError:
raise IOError('data error', 'bad data URL')
if not type:
type = 'text/plain;charset=US-ASCII'
semi = type.rfind(';')
if semi >= 0 and '=' not in type[semi:]:
encoding = type[semi+1:]
type = type[:semi]
else:
encoding = ''
msg = []
msg.append('Date: %s'%time.strftime('%a, %d %b %Y %H:%M:%S GMT',
time.gmtime(time.time())))
msg.append('Content-type: %s' % type)
if encoding == 'base64':
# XXX is this encoding/decoding ok?
data = base64.decodebytes(data.encode('ascii')).decode('latin-1')
else:
data = unquote(data)
msg.append('Content-Length: %d' % len(data))
msg.append('')
msg.append(data)
msg = '\n'.join(msg)
headers = email.message_from_string(msg)
f = io.StringIO(msg)
#f.fileno = None # needed for addinfourl
return addinfourl(f, headers, url)
class FancyURLopener(URLopener):
"""Derived class with handlers for errors we can handle (perhaps)."""
def __init__(self, *args, **kwargs):
URLopener.__init__(self, *args, **kwargs)
self.auth_cache = {}
self.tries = 0
self.maxtries = 10
def http_error_default(self, url, fp, errcode, errmsg, headers):
"""Default error handling -- don't raise an exception."""
return addinfourl(fp, headers, "http:" + url, errcode)
def http_error_302(self, url, fp, errcode, errmsg, headers, data=None):
"""Error 302 -- relocated (temporarily)."""
self.tries += 1
if self.maxtries and self.tries >= self.maxtries:
if hasattr(self, "http_error_500"):
meth = self.http_error_500
else:
meth = self.http_error_default
self.tries = 0
return meth(url, fp, 500,
"Internal Server Error: Redirect Recursion", headers)
result = self.redirect_internal(url, fp, errcode, errmsg, headers,
data)
self.tries = 0
return result
def redirect_internal(self, url, fp, errcode, errmsg, headers, data):
if 'location' in headers:
newurl = headers['location']
elif 'uri' in headers:
newurl = headers['uri']
else:
return
fp.close()
# In case the server sent a relative URL, join with original:
newurl = urljoin(self.type + ":" + url, newurl)
urlparts = urlparse(newurl)
# For security reasons, we don't allow redirection to anything other
# than http, https and ftp.
# We are using newer HTTPError with older redirect_internal method
# This older method will get deprecated in 3.3
if urlparts.scheme not in ('http', 'https', 'ftp', ''):
raise HTTPError(newurl, errcode,
errmsg +
" Redirection to url '%s' is not allowed." % newurl,
headers, fp)
return self.open(newurl)
def http_error_301(self, url, fp, errcode, errmsg, headers, data=None):
"""Error 301 -- also relocated (permanently)."""
return self.http_error_302(url, fp, errcode, errmsg, headers, data)
def http_error_303(self, url, fp, errcode, errmsg, headers, data=None):
"""Error 303 -- also relocated (essentially identical to 302)."""
return self.http_error_302(url, fp, errcode, errmsg, headers, data)
def http_error_307(self, url, fp, errcode, errmsg, headers, data=None):
"""Error 307 -- relocated, but turn POST into error."""
if data is None:
return self.http_error_302(url, fp, errcode, errmsg, headers, data)
else:
return self.http_error_default(url, fp, errcode, errmsg, headers)
def http_error_401(self, url, fp, errcode, errmsg, headers, data=None,
retry=False):
"""Error 401 -- authentication required.
This function supports Basic authentication only."""
if 'www-authenticate' not in headers:
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
stuff = headers['www-authenticate']
match = re.match('[ \t]*([^ \t]+)[ \t]+realm="([^"]*)"', stuff)
if not match:
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
scheme, realm = match.groups()
if scheme.lower() != 'basic':
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
if not retry:
URLopener.http_error_default(self, url, fp, errcode, errmsg,
headers)
name = 'retry_' + self.type + '_basic_auth'
if data is None:
return getattr(self,name)(url, realm)
else:
return getattr(self,name)(url, realm, data)
def http_error_407(self, url, fp, errcode, errmsg, headers, data=None,
retry=False):
"""Error 407 -- proxy authentication required.
This function supports Basic authentication only."""
if 'proxy-authenticate' not in headers:
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
stuff = headers['proxy-authenticate']
match = re.match('[ \t]*([^ \t]+)[ \t]+realm="([^"]*)"', stuff)
if not match:
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
scheme, realm = match.groups()
if scheme.lower() != 'basic':
URLopener.http_error_default(self, url, fp,
errcode, errmsg, headers)
if not retry:
URLopener.http_error_default(self, url, fp, errcode, errmsg,
headers)
name = 'retry_proxy_' + self.type + '_basic_auth'
if data is None:
return getattr(self,name)(url, realm)
else:
return getattr(self,name)(url, realm, data)
def retry_proxy_http_basic_auth(self, url, realm, data=None):
host, selector = splithost(url)
newurl = 'http://' + host + selector
proxy = self.proxies['http']
urltype, proxyhost = splittype(proxy)
proxyhost, proxyselector = splithost(proxyhost)
i = proxyhost.find('@') + 1
proxyhost = proxyhost[i:]
user, passwd = self.get_user_passwd(proxyhost, realm, i)
if not (user or passwd): return None
proxyhost = "%s:%s@%s" % (quote(user, safe=''),
quote(passwd, safe=''), proxyhost)
self.proxies['http'] = 'http://' + proxyhost + proxyselector
if data is None:
return self.open(newurl)
else:
return self.open(newurl, data)
def retry_proxy_https_basic_auth(self, url, realm, data=None):
host, selector = splithost(url)
newurl = 'https://' + host + selector
proxy = self.proxies['https']
urltype, proxyhost = splittype(proxy)
proxyhost, proxyselector = splithost(proxyhost)
i = proxyhost.find('@') + 1
proxyhost = proxyhost[i:]
user, passwd = self.get_user_passwd(proxyhost, realm, i)
if not (user or passwd): return None
proxyhost = "%s:%s@%s" % (quote(user, safe=''),
quote(passwd, safe=''), proxyhost)
self.proxies['https'] = 'https://' + proxyhost + proxyselector
if data is None:
return self.open(newurl)
else:
return self.open(newurl, data)
def retry_http_basic_auth(self, url, realm, data=None):
host, selector = splithost(url)
i = host.find('@') + 1
host = host[i:]
user, passwd = self.get_user_passwd(host, realm, i)
if not (user or passwd): return None
host = "%s:%s@%s" % (quote(user, safe=''),
quote(passwd, safe=''), host)
newurl = 'http://' + host + selector
if data is None:
return self.open(newurl)
else:
return self.open(newurl, data)
def retry_https_basic_auth(self, url, realm, data=None):
host, selector = splithost(url)
i = host.find('@') + 1
host = host[i:]
user, passwd = self.get_user_passwd(host, realm, i)
if not (user or passwd): return None
host = "%s:%s@%s" % (quote(user, safe=''),
quote(passwd, safe=''), host)
newurl = 'https://' + host + selector
if data is None:
return self.open(newurl)
else:
return self.open(newurl, data)
def get_user_passwd(self, host, realm, clear_cache=0):
key = realm + '@' + host.lower()
if key in self.auth_cache:
if clear_cache:
del self.auth_cache[key]
else:
return self.auth_cache[key]
user, passwd = self.prompt_user_passwd(host, realm)
if user or passwd: self.auth_cache[key] = (user, passwd)
return user, passwd
def prompt_user_passwd(self, host, realm):
"""Override this in a GUI environment!"""
import getpass
try:
user = input("Enter username for %s at %s: " % (realm, host))
passwd = getpass.getpass("Enter password for %s in %s at %s: " %
(user, realm, host))
return user, passwd
except KeyboardInterrupt:
print()
return None, None
# Utility functions
_localhost = None
def localhost():
"""Return the IP address of the magic hostname 'localhost'."""
global _localhost
if _localhost is None:
_localhost = socket.gethostbyname('localhost')
return _localhost
_thishost = None
def thishost():
"""Return the IP addresses of the current host."""
global _thishost
if _thishost is None:
try:
_thishost = tuple(socket.gethostbyname_ex(socket.gethostname())[2])
except socket.gaierror:
_thishost = tuple(socket.gethostbyname_ex('localhost')[2])
return _thishost
_ftperrors = None
def ftperrors():
"""Return the set of errors raised by the FTP class."""
global _ftperrors
if _ftperrors is None:
import ftplib
_ftperrors = ftplib.all_errors
return _ftperrors
_noheaders = None
def noheaders():
"""Return an empty email Message object."""
global _noheaders
if _noheaders is None:
_noheaders = email.message_from_string("")
return _noheaders
# Utility classes
class ftpwrapper(object):
"""Class used by open_ftp() for cache of open FTP connections."""
def __init__(self, user, passwd, host, port, dirs, timeout=None,
persistent=True):
self.user = user
self.passwd = passwd
self.host = host
self.port = port
self.dirs = dirs
self.timeout = timeout
self.refcount = 0
self.keepalive = persistent
self.init()
def init(self):
import ftplib
self.busy = 0
self.ftp = ftplib.FTP()
self.ftp.connect(self.host, self.port, self.timeout)
self.ftp.login(self.user, self.passwd)
_target = '/'.join(self.dirs)
self.ftp.cwd(_target)
def retrfile(self, file, type):
import ftplib
self.endtransfer()
if type in ('d', 'D'): cmd = 'TYPE A'; isdir = 1
else: cmd = 'TYPE ' + type; isdir = 0
try:
self.ftp.voidcmd(cmd)
except ftplib.all_errors:
self.init()
self.ftp.voidcmd(cmd)
conn = None
if file and not isdir:
# Try to retrieve as a file
try:
cmd = 'RETR ' + file
conn, retrlen = self.ftp.ntransfercmd(cmd)
except ftplib.error_perm as reason:
if str(reason)[:3] != '550':
raise_with_traceback(URLError('ftp error: %r' % reason))
if not conn:
# Set transfer mode to ASCII!
self.ftp.voidcmd('TYPE A')
# Try a directory listing. Verify that directory exists.
if file:
pwd = self.ftp.pwd()
try:
try:
self.ftp.cwd(file)
except ftplib.error_perm as reason:
### Was:
# raise URLError('ftp error: %r' % reason) from reason
exc = URLError('ftp error: %r' % reason)
exc.__cause__ = reason
raise exc
finally:
self.ftp.cwd(pwd)
cmd = 'LIST ' + file
else:
cmd = 'LIST'
conn, retrlen = self.ftp.ntransfercmd(cmd)
self.busy = 1
ftpobj = addclosehook(conn.makefile('rb'), self.file_close)
self.refcount += 1
conn.close()
# Pass back both a suitably decorated object and a retrieval length
return (ftpobj, retrlen)
def endtransfer(self):
self.busy = 0
def close(self):
self.keepalive = False
if self.refcount <= 0:
self.real_close()
def file_close(self):
self.endtransfer()
self.refcount -= 1
if self.refcount <= 0 and not self.keepalive:
self.real_close()
def real_close(self):
self.endtransfer()
try:
self.ftp.close()
except ftperrors():
pass
# Proxy handling
def getproxies_environment():
"""Return a dictionary of scheme -> proxy server URL mappings.
Scan the environment for variables named <scheme>_proxy;
this seems to be the standard convention. If you need a
different way, you can pass a proxies dictionary to the
[Fancy]URLopener constructor.
"""
proxies = {}
for name, value in os.environ.items():
name = name.lower()
if value and name[-6:] == '_proxy':
proxies[name[:-6]] = value
return proxies
def proxy_bypass_environment(host):
"""Test if proxies should not be used for a particular host.
Checks the environment for a variable named no_proxy, which should
be a list of DNS suffixes separated by commas, or '*' for all hosts.
"""
no_proxy = os.environ.get('no_proxy', '') or os.environ.get('NO_PROXY', '')
# '*' is special case for always bypass
if no_proxy == '*':
return 1
# strip port off host
hostonly, port = splitport(host)
# check if the host ends with any of the DNS suffixes
no_proxy_list = [proxy.strip() for proxy in no_proxy.split(',')]
for name in no_proxy_list:
if name and (hostonly.endswith(name) or host.endswith(name)):
return 1
# otherwise, don't bypass
return 0
# This code tests an OSX specific data structure but is testable on all
# platforms
def _proxy_bypass_macosx_sysconf(host, proxy_settings):
"""
Return True iff this host shouldn't be accessed using a proxy
This function uses the MacOSX framework SystemConfiguration
to fetch the proxy information.
proxy_settings come from _scproxy._get_proxy_settings or get mocked ie:
{ 'exclude_simple': bool,
'exceptions': ['foo.bar', '*.bar.com', '127.0.0.1', '10.1', '10.0/16']
}
"""
from fnmatch import fnmatch
hostonly, port = splitport(host)
def ip2num(ipAddr):
parts = ipAddr.split('.')
parts = list(map(int, parts))
if len(parts) != 4:
parts = (parts + [0, 0, 0, 0])[:4]
return (parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]
# Check for simple host names:
if '.' not in host:
if proxy_settings['exclude_simple']:
return True
hostIP = None
for value in proxy_settings.get('exceptions', ()):
# Items in the list are strings like these: *.local, 169.254/16
if not value: continue
m = re.match(r"(\d+(?:\.\d+)*)(/\d+)?", value)
if m is not None:
if hostIP is None:
try:
hostIP = socket.gethostbyname(hostonly)
hostIP = ip2num(hostIP)
except socket.error:
continue
base = ip2num(m.group(1))
mask = m.group(2)
if mask is None:
mask = 8 * (m.group(1).count('.') + 1)
else:
mask = int(mask[1:])
mask = 32 - mask
if (hostIP >> mask) == (base >> mask):
return True
elif fnmatch(host, value):
return True
return False
if sys.platform == 'darwin':
from _scproxy import _get_proxy_settings, _get_proxies
def proxy_bypass_macosx_sysconf(host):
proxy_settings = _get_proxy_settings()
return _proxy_bypass_macosx_sysconf(host, proxy_settings)
def getproxies_macosx_sysconf():
"""Return a dictionary of scheme -> proxy server URL mappings.
This function uses the MacOSX framework SystemConfiguration
to fetch the proxy information.
"""
return _get_proxies()
def proxy_bypass(host):
if getproxies_environment():
return proxy_bypass_environment(host)
else:
return proxy_bypass_macosx_sysconf(host)
def getproxies():
return getproxies_environment() or getproxies_macosx_sysconf()
elif os.name == 'nt':
def getproxies_registry():
"""Return a dictionary of scheme -> proxy server URL mappings.
Win32 uses the registry to store proxies.
"""
proxies = {}
try:
import winreg
except ImportError:
# Std module, so should be around - but you never know!
return proxies
try:
internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
proxyEnable = winreg.QueryValueEx(internetSettings,
'ProxyEnable')[0]
if proxyEnable:
# Returned as Unicode but problems if not converted to ASCII
proxyServer = str(winreg.QueryValueEx(internetSettings,
'ProxyServer')[0])
if '=' in proxyServer:
# Per-protocol settings
for p in proxyServer.split(';'):
protocol, address = p.split('=', 1)
# See if address has a type:// prefix
if not re.match('^([^/:]+)://', address):
address = '%s://%s' % (protocol, address)
proxies[protocol] = address
else:
# Use one setting for all protocols
if proxyServer[:5] == 'http:':
proxies['http'] = proxyServer
else:
proxies['http'] = 'http://%s' % proxyServer
proxies['https'] = 'https://%s' % proxyServer
proxies['ftp'] = 'ftp://%s' % proxyServer
internetSettings.Close()
except (WindowsError, ValueError, TypeError):
# Either registry key not found etc, or the value in an
# unexpected format.
# proxies already set up to be empty so nothing to do
pass
return proxies
def getproxies():
"""Return a dictionary of scheme -> proxy server URL mappings.
Returns settings gathered from the environment, if specified,
or the registry.
"""
return getproxies_environment() or getproxies_registry()
def proxy_bypass_registry(host):
try:
import winreg
except ImportError:
# Std modules, so should be around - but you never know!
return 0
try:
internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
proxyEnable = winreg.QueryValueEx(internetSettings,
'ProxyEnable')[0]
proxyOverride = str(winreg.QueryValueEx(internetSettings,
'ProxyOverride')[0])
# ^^^^ Returned as Unicode but problems if not converted to ASCII
except WindowsError:
return 0
if not proxyEnable or not proxyOverride:
return 0
# try to make a host list from name and IP address.
rawHost, port = splitport(host)
host = [rawHost]
try:
addr = socket.gethostbyname(rawHost)
if addr != rawHost:
host.append(addr)
except socket.error:
pass
try:
fqdn = socket.getfqdn(rawHost)
if fqdn != rawHost:
host.append(fqdn)
except socket.error:
pass
# make a check value list from the registry entry: replace the
# '<local>' string by the localhost entry and the corresponding
# canonical entry.
proxyOverride = proxyOverride.split(';')
# now check if we match one of the registry values.
for test in proxyOverride:
if test == '<local>':
if '.' not in rawHost:
return 1
test = test.replace(".", r"\.") # mask dots
test = test.replace("*", r".*") # change glob sequence
test = test.replace("?", r".") # change glob char
for val in host:
if re.match(test, val, re.I):
return 1
return 0
def proxy_bypass(host):
"""Return a dictionary of scheme -> proxy server URL mappings.
Returns settings gathered from the environment, if specified,
or the registry.
"""
if getproxies_environment():
return proxy_bypass_environment(host)
else:
return proxy_bypass_registry(host)
else:
# By default use environment variables
getproxies = getproxies_environment
proxy_bypass = proxy_bypass_environment
PK Du\� �� � & future/backports/urllib/robotparser.pynu �[��� from __future__ import absolute_import, division, unicode_literals
from future.builtins import str
""" robotparser.py
Copyright (C) 2000 Bastian Kleineidam
You can choose between two licenses when using this package:
1) GNU GPLv2
2) PSF license for Python 2.2
The robots.txt Exclusion Protocol is implemented as specified in
http://info.webcrawler.com/mak/projects/robots/norobots-rfc.html
"""
# Was: import urllib.parse, urllib.request
from future.backports import urllib
from future.backports.urllib import parse as _parse, request as _request
urllib.parse = _parse
urllib.request = _request
__all__ = ["RobotFileParser"]
class RobotFileParser(object):
""" This class provides a set of methods to read, parse and answer
questions about a single robots.txt file.
"""
def __init__(self, url=''):
self.entries = []
self.default_entry = None
self.disallow_all = False
self.allow_all = False
self.set_url(url)
self.last_checked = 0
def mtime(self):
"""Returns the time the robots.txt file was last fetched.
This is useful for long-running web spiders that need to
check for new robots.txt files periodically.
"""
return self.last_checked
def modified(self):
"""Sets the time the robots.txt file was last fetched to the
current time.
"""
import time
self.last_checked = time.time()
def set_url(self, url):
"""Sets the URL referring to a robots.txt file."""
self.url = url
self.host, self.path = urllib.parse.urlparse(url)[1:3]
def read(self):
"""Reads the robots.txt URL and feeds it to the parser."""
try:
f = urllib.request.urlopen(self.url)
except urllib.error.HTTPError as err:
if err.code in (401, 403):
self.disallow_all = True
elif err.code >= 400:
self.allow_all = True
else:
raw = f.read()
self.parse(raw.decode("utf-8").splitlines())
def _add_entry(self, entry):
if "*" in entry.useragents:
# the default entry is considered last
if self.default_entry is None:
# the first default entry wins
self.default_entry = entry
else:
self.entries.append(entry)
def parse(self, lines):
"""Parse the input lines from a robots.txt file.
We allow that a user-agent: line is not preceded by
one or more blank lines.
"""
# states:
# 0: start state
# 1: saw user-agent line
# 2: saw an allow or disallow line
state = 0
entry = Entry()
for line in lines:
if not line:
if state == 1:
entry = Entry()
state = 0
elif state == 2:
self._add_entry(entry)
entry = Entry()
state = 0
# remove optional comment and strip line
i = line.find('#')
if i >= 0:
line = line[:i]
line = line.strip()
if not line:
continue
line = line.split(':', 1)
if len(line) == 2:
line[0] = line[0].strip().lower()
line[1] = urllib.parse.unquote(line[1].strip())
if line[0] == "user-agent":
if state == 2:
self._add_entry(entry)
entry = Entry()
entry.useragents.append(line[1])
state = 1
elif line[0] == "disallow":
if state != 0:
entry.rulelines.append(RuleLine(line[1], False))
state = 2
elif line[0] == "allow":
if state != 0:
entry.rulelines.append(RuleLine(line[1], True))
state = 2
if state == 2:
self._add_entry(entry)
def can_fetch(self, useragent, url):
"""using the parsed robots.txt decide if useragent can fetch url"""
if self.disallow_all:
return False
if self.allow_all:
return True
# search for given user agent matches
# the first match counts
parsed_url = urllib.parse.urlparse(urllib.parse.unquote(url))
url = urllib.parse.urlunparse(('','',parsed_url.path,
parsed_url.params,parsed_url.query, parsed_url.fragment))
url = urllib.parse.quote(url)
if not url:
url = "/"
for entry in self.entries:
if entry.applies_to(useragent):
return entry.allowance(url)
# try the default entry last
if self.default_entry:
return self.default_entry.allowance(url)
# agent not found ==> access granted
return True
def __str__(self):
return ''.join([str(entry) + "\n" for entry in self.entries])
class RuleLine(object):
"""A rule line is a single "Allow:" (allowance==True) or "Disallow:"
(allowance==False) followed by a path."""
def __init__(self, path, allowance):
if path == '' and not allowance:
# an empty value means allow all
allowance = True
self.path = urllib.parse.quote(path)
self.allowance = allowance
def applies_to(self, filename):
return self.path == "*" or filename.startswith(self.path)
def __str__(self):
return (self.allowance and "Allow" or "Disallow") + ": " + self.path
class Entry(object):
"""An entry has one or more user-agents and zero or more rulelines"""
def __init__(self):
self.useragents = []
self.rulelines = []
def __str__(self):
ret = []
for agent in self.useragents:
ret.extend(["User-agent: ", agent, "\n"])
for line in self.rulelines:
ret.extend([str(line), "\n"])
return ''.join(ret)
def applies_to(self, useragent):
"""check if this entry applies to the specified agent"""
# split the name token and make it lower case
useragent = useragent.split("/")[0].lower()
for agent in self.useragents:
if agent == '*':
# we have the catch-all agent
return True
agent = agent.lower()
if agent in useragent:
return True
return False
def allowance(self, filename):
"""Preconditions:
- our agent applies to this entry
- filename is URL decoded"""
for line in self.rulelines:
if line.applies_to(filename):
return line.allowance
return True
PK Du\P� �!' !' future/backports/datetime.pynu �[��� """Concrete date/time and related types.
See http://www.iana.org/time-zones/repository/tz-link.html for
time zone and DST data sources.
"""
from __future__ import division
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import absolute_import
from future.builtins import str
from future.builtins import bytes
from future.builtins import map
from future.builtins import round
from future.builtins import int
from future.builtins import object
from future.utils import native_str, PY2
import time as _time
import math as _math
def _cmp(x, y):
return 0 if x == y else 1 if x > y else -1
MINYEAR = 1
MAXYEAR = 9999
_MAXORDINAL = 3652059 # date.max.toordinal()
# Utility functions, adapted from Python's Demo/classes/Dates.py, which
# also assumes the current Gregorian calendar indefinitely extended in
# both directions. Difference: Dates.py calls January 1 of year 0 day
# number 1. The code here calls January 1 of year 1 day number 1. This is
# to match the definition of the "proleptic Gregorian" calendar in Dershowitz
# and Reingold's "Calendrical Calculations", where it's the base calendar
# for all computations. See the book for algorithms for converting between
# proleptic Gregorian ordinals and many other calendar systems.
_DAYS_IN_MONTH = [None, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
_DAYS_BEFORE_MONTH = [None]
dbm = 0
for dim in _DAYS_IN_MONTH[1:]:
_DAYS_BEFORE_MONTH.append(dbm)
dbm += dim
del dbm, dim
def _is_leap(year):
"year -> 1 if leap year, else 0."
return year % 4 == 0 and (year % 100 != 0 or year % 400 == 0)
def _days_before_year(year):
"year -> number of days before January 1st of year."
y = year - 1
return y*365 + y//4 - y//100 + y//400
def _days_in_month(year, month):
"year, month -> number of days in that month in that year."
assert 1 <= month <= 12, month
if month == 2 and _is_leap(year):
return 29
return _DAYS_IN_MONTH[month]
def _days_before_month(year, month):
"year, month -> number of days in year preceding first day of month."
assert 1 <= month <= 12, 'month must be in 1..12'
return _DAYS_BEFORE_MONTH[month] + (month > 2 and _is_leap(year))
def _ymd2ord(year, month, day):
"year, month, day -> ordinal, considering 01-Jan-0001 as day 1."
assert 1 <= month <= 12, 'month must be in 1..12'
dim = _days_in_month(year, month)
assert 1 <= day <= dim, ('day must be in 1..%d' % dim)
return (_days_before_year(year) +
_days_before_month(year, month) +
day)
_DI400Y = _days_before_year(401) # number of days in 400 years
_DI100Y = _days_before_year(101) # " " " " 100 "
_DI4Y = _days_before_year(5) # " " " " 4 "
# A 4-year cycle has an extra leap day over what we'd get from pasting
# together 4 single years.
assert _DI4Y == 4 * 365 + 1
# Similarly, a 400-year cycle has an extra leap day over what we'd get from
# pasting together 4 100-year cycles.
assert _DI400Y == 4 * _DI100Y + 1
# OTOH, a 100-year cycle has one fewer leap day than we'd get from
# pasting together 25 4-year cycles.
assert _DI100Y == 25 * _DI4Y - 1
def _ord2ymd(n):
"ordinal -> (year, month, day), considering 01-Jan-0001 as day 1."
# n is a 1-based index, starting at 1-Jan-1. The pattern of leap years
# repeats exactly every 400 years. The basic strategy is to find the
# closest 400-year boundary at or before n, then work with the offset
# from that boundary to n. Life is much clearer if we subtract 1 from
# n first -- then the values of n at 400-year boundaries are exactly
# those divisible by _DI400Y:
#
# D M Y n n-1
# -- --- ---- ---------- ----------------
# 31 Dec -400 -_DI400Y -_DI400Y -1
# 1 Jan -399 -_DI400Y +1 -_DI400Y 400-year boundary
# ...
# 30 Dec 000 -1 -2
# 31 Dec 000 0 -1
# 1 Jan 001 1 0 400-year boundary
# 2 Jan 001 2 1
# 3 Jan 001 3 2
# ...
# 31 Dec 400 _DI400Y _DI400Y -1
# 1 Jan 401 _DI400Y +1 _DI400Y 400-year boundary
n -= 1
n400, n = divmod(n, _DI400Y)
year = n400 * 400 + 1 # ..., -399, 1, 401, ...
# Now n is the (non-negative) offset, in days, from January 1 of year, to
# the desired date. Now compute how many 100-year cycles precede n.
# Note that it's possible for n100 to equal 4! In that case 4 full
# 100-year cycles precede the desired day, which implies the desired
# day is December 31 at the end of a 400-year cycle.
n100, n = divmod(n, _DI100Y)
# Now compute how many 4-year cycles precede it.
n4, n = divmod(n, _DI4Y)
# And now how many single years. Again n1 can be 4, and again meaning
# that the desired day is December 31 at the end of the 4-year cycle.
n1, n = divmod(n, 365)
year += n100 * 100 + n4 * 4 + n1
if n1 == 4 or n100 == 4:
assert n == 0
return year-1, 12, 31
# Now the year is correct, and n is the offset from January 1. We find
# the month via an estimate that's either exact or one too large.
leapyear = n1 == 3 and (n4 != 24 or n100 == 3)
assert leapyear == _is_leap(year)
month = (n + 50) >> 5
preceding = _DAYS_BEFORE_MONTH[month] + (month > 2 and leapyear)
if preceding > n: # estimate is too large
month -= 1
preceding -= _DAYS_IN_MONTH[month] + (month == 2 and leapyear)
n -= preceding
assert 0 <= n < _days_in_month(year, month)
# Now the year and month are correct, and n is the offset from the
# start of that month: we're done!
return year, month, n+1
# Month and day names. For localized versions, see the calendar module.
_MONTHNAMES = [None, "Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
_DAYNAMES = [None, "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
def _build_struct_time(y, m, d, hh, mm, ss, dstflag):
wday = (_ymd2ord(y, m, d) + 6) % 7
dnum = _days_before_month(y, m) + d
return _time.struct_time((y, m, d, hh, mm, ss, wday, dnum, dstflag))
def _format_time(hh, mm, ss, us):
# Skip trailing microseconds when us==0.
result = "%02d:%02d:%02d" % (hh, mm, ss)
if us:
result += ".%06d" % us
return result
# Correctly substitute for %z and %Z escapes in strftime formats.
def _wrap_strftime(object, format, timetuple):
# Don't call utcoffset() or tzname() unless actually needed.
freplace = None # the string to use for %f
zreplace = None # the string to use for %z
Zreplace = None # the string to use for %Z
# Scan format for %z and %Z escapes, replacing as needed.
newformat = []
push = newformat.append
i, n = 0, len(format)
while i < n:
ch = format[i]
i += 1
if ch == '%':
if i < n:
ch = format[i]
i += 1
if ch == 'f':
if freplace is None:
freplace = '%06d' % getattr(object,
'microsecond', 0)
newformat.append(freplace)
elif ch == 'z':
if zreplace is None:
zreplace = ""
if hasattr(object, "utcoffset"):
offset = object.utcoffset()
if offset is not None:
sign = '+'
if offset.days < 0:
offset = -offset
sign = '-'
h, m = divmod(offset, timedelta(hours=1))
assert not m % timedelta(minutes=1), "whole minute"
m //= timedelta(minutes=1)
zreplace = '%c%02d%02d' % (sign, h, m)
assert '%' not in zreplace
newformat.append(zreplace)
elif ch == 'Z':
if Zreplace is None:
Zreplace = ""
if hasattr(object, "tzname"):
s = object.tzname()
if s is not None:
# strftime is going to have at this: escape %
Zreplace = s.replace('%', '%%')
newformat.append(Zreplace)
else:
push('%')
push(ch)
else:
push('%')
else:
push(ch)
newformat = "".join(newformat)
return _time.strftime(newformat, timetuple)
def _call_tzinfo_method(tzinfo, methname, tzinfoarg):
if tzinfo is None:
return None
return getattr(tzinfo, methname)(tzinfoarg)
# Just raise TypeError if the arg isn't None or a string.
def _check_tzname(name):
if name is not None and not isinstance(name, str):
raise TypeError("tzinfo.tzname() must return None or string, "
"not '%s'" % type(name))
# name is the offset-producing method, "utcoffset" or "dst".
# offset is what it returned.
# If offset isn't None or timedelta, raises TypeError.
# If offset is None, returns None.
# Else offset is checked for being in range, and a whole # of minutes.
# If it is, its integer value is returned. Else ValueError is raised.
def _check_utc_offset(name, offset):
assert name in ("utcoffset", "dst")
if offset is None:
return
if not isinstance(offset, timedelta):
raise TypeError("tzinfo.%s() must return None "
"or timedelta, not '%s'" % (name, type(offset)))
if offset % timedelta(minutes=1) or offset.microseconds:
raise ValueError("tzinfo.%s() must return a whole number "
"of minutes, got %s" % (name, offset))
if not -timedelta(1) < offset < timedelta(1):
raise ValueError("%s()=%s, must be must be strictly between"
" -timedelta(hours=24) and timedelta(hours=24)"
% (name, offset))
def _check_date_fields(year, month, day):
if not isinstance(year, int):
raise TypeError('int expected')
if not MINYEAR <= year <= MAXYEAR:
raise ValueError('year must be in %d..%d' % (MINYEAR, MAXYEAR), year)
if not 1 <= month <= 12:
raise ValueError('month must be in 1..12', month)
dim = _days_in_month(year, month)
if not 1 <= day <= dim:
raise ValueError('day must be in 1..%d' % dim, day)
def _check_time_fields(hour, minute, second, microsecond):
if not isinstance(hour, int):
raise TypeError('int expected')
if not 0 <= hour <= 23:
raise ValueError('hour must be in 0..23', hour)
if not 0 <= minute <= 59:
raise ValueError('minute must be in 0..59', minute)
if not 0 <= second <= 59:
raise ValueError('second must be in 0..59', second)
if not 0 <= microsecond <= 999999:
raise ValueError('microsecond must be in 0..999999', microsecond)
def _check_tzinfo_arg(tz):
if tz is not None and not isinstance(tz, tzinfo):
raise TypeError("tzinfo argument must be None or of a tzinfo subclass")
def _cmperror(x, y):
raise TypeError("can't compare '%s' to '%s'" % (
type(x).__name__, type(y).__name__))
class timedelta(object):
"""Represent the difference between two datetime objects.
Supported operators:
- add, subtract timedelta
- unary plus, minus, abs
- compare to timedelta
- multiply, divide by int
In addition, datetime supports subtraction of two datetime objects
returning a timedelta, and addition or subtraction of a datetime
and a timedelta giving a datetime.
Representation: (days, seconds, microseconds). Why? Because I
felt like it.
"""
__slots__ = '_days', '_seconds', '_microseconds'
def __new__(cls, days=0, seconds=0, microseconds=0,
milliseconds=0, minutes=0, hours=0, weeks=0):
# Doing this efficiently and accurately in C is going to be difficult
# and error-prone, due to ubiquitous overflow possibilities, and that
# C double doesn't have enough bits of precision to represent
# microseconds over 10K years faithfully. The code here tries to make
# explicit where go-fast assumptions can be relied on, in order to
# guide the C implementation; it's way more convoluted than speed-
# ignoring auto-overflow-to-long idiomatic Python could be.
# XXX Check that all inputs are ints or floats.
# Final values, all integer.
# s and us fit in 32-bit signed ints; d isn't bounded.
d = s = us = 0
# Normalize everything to days, seconds, microseconds.
days += weeks*7
seconds += minutes*60 + hours*3600
microseconds += milliseconds*1000
# Get rid of all fractions, and normalize s and us.
# Take a deep breath <wink>.
if isinstance(days, float):
dayfrac, days = _math.modf(days)
daysecondsfrac, daysecondswhole = _math.modf(dayfrac * (24.*3600.))
assert daysecondswhole == int(daysecondswhole) # can't overflow
s = int(daysecondswhole)
assert days == int(days)
d = int(days)
else:
daysecondsfrac = 0.0
d = days
assert isinstance(daysecondsfrac, float)
assert abs(daysecondsfrac) <= 1.0
assert isinstance(d, int)
assert abs(s) <= 24 * 3600
# days isn't referenced again before redefinition
if isinstance(seconds, float):
secondsfrac, seconds = _math.modf(seconds)
assert seconds == int(seconds)
seconds = int(seconds)
secondsfrac += daysecondsfrac
assert abs(secondsfrac) <= 2.0
else:
secondsfrac = daysecondsfrac
# daysecondsfrac isn't referenced again
assert isinstance(secondsfrac, float)
assert abs(secondsfrac) <= 2.0
assert isinstance(seconds, int)
days, seconds = divmod(seconds, 24*3600)
d += days
s += int(seconds) # can't overflow
assert isinstance(s, int)
assert abs(s) <= 2 * 24 * 3600
# seconds isn't referenced again before redefinition
usdouble = secondsfrac * 1e6
assert abs(usdouble) < 2.1e6 # exact value not critical
# secondsfrac isn't referenced again
if isinstance(microseconds, float):
microseconds += usdouble
microseconds = round(microseconds, 0)
seconds, microseconds = divmod(microseconds, 1e6)
assert microseconds == int(microseconds)
assert seconds == int(seconds)
days, seconds = divmod(seconds, 24.*3600.)
assert days == int(days)
assert seconds == int(seconds)
d += int(days)
s += int(seconds) # can't overflow
assert isinstance(s, int)
assert abs(s) <= 3 * 24 * 3600
else:
seconds, microseconds = divmod(microseconds, 1000000)
days, seconds = divmod(seconds, 24*3600)
d += days
s += int(seconds) # can't overflow
assert isinstance(s, int)
assert abs(s) <= 3 * 24 * 3600
microseconds = float(microseconds)
microseconds += usdouble
microseconds = round(microseconds, 0)
assert abs(s) <= 3 * 24 * 3600
assert abs(microseconds) < 3.1e6
# Just a little bit of carrying possible for microseconds and seconds.
assert isinstance(microseconds, float)
assert int(microseconds) == microseconds
us = int(microseconds)
seconds, us = divmod(us, 1000000)
s += seconds # cant't overflow
assert isinstance(s, int)
days, s = divmod(s, 24*3600)
d += days
assert isinstance(d, int)
assert isinstance(s, int) and 0 <= s < 24*3600
assert isinstance(us, int) and 0 <= us < 1000000
self = object.__new__(cls)
self._days = d
self._seconds = s
self._microseconds = us
if abs(d) > 999999999:
raise OverflowError("timedelta # of days is too large: %d" % d)
return self
def __repr__(self):
if self._microseconds:
return "%s(%d, %d, %d)" % ('datetime.' + self.__class__.__name__,
self._days,
self._seconds,
self._microseconds)
if self._seconds:
return "%s(%d, %d)" % ('datetime.' + self.__class__.__name__,
self._days,
self._seconds)
return "%s(%d)" % ('datetime.' + self.__class__.__name__, self._days)
def __str__(self):
mm, ss = divmod(self._seconds, 60)
hh, mm = divmod(mm, 60)
s = "%d:%02d:%02d" % (hh, mm, ss)
if self._days:
def plural(n):
return n, abs(n) != 1 and "s" or ""
s = ("%d day%s, " % plural(self._days)) + s
if self._microseconds:
s = s + ".%06d" % self._microseconds
return s
def total_seconds(self):
"""Total seconds in the duration."""
return ((self.days * 86400 + self.seconds)*10**6 +
self.microseconds) / 10**6
# Read-only field accessors
@property
def days(self):
"""days"""
return self._days
@property
def seconds(self):
"""seconds"""
return self._seconds
@property
def microseconds(self):
"""microseconds"""
return self._microseconds
def __add__(self, other):
if isinstance(other, timedelta):
# for CPython compatibility, we cannot use
# our __class__ here, but need a real timedelta
return timedelta(self._days + other._days,
self._seconds + other._seconds,
self._microseconds + other._microseconds)
return NotImplemented
__radd__ = __add__
def __sub__(self, other):
if isinstance(other, timedelta):
# for CPython compatibility, we cannot use
# our __class__ here, but need a real timedelta
return timedelta(self._days - other._days,
self._seconds - other._seconds,
self._microseconds - other._microseconds)
return NotImplemented
def __rsub__(self, other):
if isinstance(other, timedelta):
return -self + other
return NotImplemented
def __neg__(self):
# for CPython compatibility, we cannot use
# our __class__ here, but need a real timedelta
return timedelta(-self._days,
-self._seconds,
-self._microseconds)
def __pos__(self):
return self
def __abs__(self):
if self._days < 0:
return -self
else:
return self
def __mul__(self, other):
if isinstance(other, int):
# for CPython compatibility, we cannot use
# our __class__ here, but need a real timedelta
return timedelta(self._days * other,
self._seconds * other,
self._microseconds * other)
if isinstance(other, float):
a, b = other.as_integer_ratio()
return self * a / b
return NotImplemented
__rmul__ = __mul__
def _to_microseconds(self):
return ((self._days * (24*3600) + self._seconds) * 1000000 +
self._microseconds)
def __floordiv__(self, other):
if not isinstance(other, (int, timedelta)):
return NotImplemented
usec = self._to_microseconds()
if isinstance(other, timedelta):
return usec // other._to_microseconds()
if isinstance(other, int):
return timedelta(0, 0, usec // other)
def __truediv__(self, other):
if not isinstance(other, (int, float, timedelta)):
return NotImplemented
usec = self._to_microseconds()
if isinstance(other, timedelta):
return usec / other._to_microseconds()
if isinstance(other, int):
return timedelta(0, 0, usec / other)
if isinstance(other, float):
a, b = other.as_integer_ratio()
return timedelta(0, 0, b * usec / a)
def __mod__(self, other):
if isinstance(other, timedelta):
r = self._to_microseconds() % other._to_microseconds()
return timedelta(0, 0, r)
return NotImplemented
def __divmod__(self, other):
if isinstance(other, timedelta):
q, r = divmod(self._to_microseconds(),
other._to_microseconds())
return q, timedelta(0, 0, r)
return NotImplemented
# Comparisons of timedelta objects with other.
def __eq__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) == 0
else:
return False
def __ne__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) != 0
else:
return True
def __le__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) <= 0
else:
_cmperror(self, other)
def __lt__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) < 0
else:
_cmperror(self, other)
def __ge__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) >= 0
else:
_cmperror(self, other)
def __gt__(self, other):
if isinstance(other, timedelta):
return self._cmp(other) > 0
else:
_cmperror(self, other)
def _cmp(self, other):
assert isinstance(other, timedelta)
return _cmp(self._getstate(), other._getstate())
def __hash__(self):
return hash(self._getstate())
def __bool__(self):
return (self._days != 0 or
self._seconds != 0 or
self._microseconds != 0)
# Pickle support.
def _getstate(self):
return (self._days, self._seconds, self._microseconds)
def __reduce__(self):
return (self.__class__, self._getstate())
timedelta.min = timedelta(-999999999)
timedelta.max = timedelta(days=999999999, hours=23, minutes=59, seconds=59,
microseconds=999999)
timedelta.resolution = timedelta(microseconds=1)
class date(object):
"""Concrete date type.
Constructors:
__new__()
fromtimestamp()
today()
fromordinal()
Operators:
__repr__, __str__
__cmp__, __hash__
__add__, __radd__, __sub__ (add/radd only with timedelta arg)
Methods:
timetuple()
toordinal()
weekday()
isoweekday(), isocalendar(), isoformat()
ctime()
strftime()
Properties (readonly):
year, month, day
"""
__slots__ = '_year', '_month', '_day'
def __new__(cls, year, month=None, day=None):
"""Constructor.
Arguments:
year, month, day (required, base 1)
"""
if (isinstance(year, bytes) and len(year) == 4 and
1 <= year[2] <= 12 and month is None): # Month is sane
# Pickle support
self = object.__new__(cls)
self.__setstate(year)
return self
_check_date_fields(year, month, day)
self = object.__new__(cls)
self._year = year
self._month = month
self._day = day
return self
# Additional constructors
@classmethod
def fromtimestamp(cls, t):
"Construct a date from a POSIX timestamp (like time.time())."
y, m, d, hh, mm, ss, weekday, jday, dst = _time.localtime(t)
return cls(y, m, d)
@classmethod
def today(cls):
"Construct a date from time.time()."
t = _time.time()
return cls.fromtimestamp(t)
@classmethod
def fromordinal(cls, n):
"""Construct a date from a proleptic Gregorian ordinal.
January 1 of year 1 is day 1. Only the year, month and day are
non-zero in the result.
"""
y, m, d = _ord2ymd(n)
return cls(y, m, d)
# Conversions to string
def __repr__(self):
"""Convert to formal string, for repr().
>>> dt = datetime(2010, 1, 1)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0)'
>>> dt = datetime(2010, 1, 1, tzinfo=timezone.utc)
>>> repr(dt)
'datetime.datetime(2010, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)'
"""
return "%s(%d, %d, %d)" % ('datetime.' + self.__class__.__name__,
self._year,
self._month,
self._day)
# XXX These shouldn't depend on time.localtime(), because that
# clips the usable dates to [1970 .. 2038). At least ctime() is
# easily done without using strftime() -- that's better too because
# strftime("%c", ...) is locale specific.
def ctime(self):
"Return ctime() style string."
weekday = self.toordinal() % 7 or 7
return "%s %s %2d 00:00:00 %04d" % (
_DAYNAMES[weekday],
_MONTHNAMES[self._month],
self._day, self._year)
def strftime(self, fmt):
"Format using strftime()."
return _wrap_strftime(self, fmt, self.timetuple())
def __format__(self, fmt):
if len(fmt) != 0:
return self.strftime(fmt)
return str(self)
def isoformat(self):
"""Return the date formatted according to ISO.
This is 'YYYY-MM-DD'.
References:
- http://www.w3.org/TR/NOTE-datetime
- http://www.cl.cam.ac.uk/~mgk25/iso-time.html
"""
return "%04d-%02d-%02d" % (self._year, self._month, self._day)
__str__ = isoformat
# Read-only field accessors
@property
def year(self):
"""year (1-9999)"""
return self._year
@property
def month(self):
"""month (1-12)"""
return self._month
@property
def day(self):
"""day (1-31)"""
return self._day
# Standard conversions, __cmp__, __hash__ (and helpers)
def timetuple(self):
"Return local time tuple compatible with time.localtime()."
return _build_struct_time(self._year, self._month, self._day,
0, 0, 0, -1)
def toordinal(self):
"""Return proleptic Gregorian ordinal for the year, month and day.
January 1 of year 1 is day 1. Only the year, month and day values
contribute to the result.
"""
return _ymd2ord(self._year, self._month, self._day)
def replace(self, year=None, month=None, day=None):
"""Return a new date with new values for the specified fields."""
if year is None:
year = self._year
if month is None:
month = self._month
if day is None:
day = self._day
_check_date_fields(year, month, day)
return date(year, month, day)
# Comparisons of date objects with other.
def __eq__(self, other):
if isinstance(other, date):
return self._cmp(other) == 0
return NotImplemented
def __ne__(self, other):
if isinstance(other, date):
return self._cmp(other) != 0
return NotImplemented
def __le__(self, other):
if isinstance(other, date):
return self._cmp(other) <= 0
return NotImplemented
def __lt__(self, other):
if isinstance(other, date):
return self._cmp(other) < 0
return NotImplemented
def __ge__(self, other):
if isinstance(other, date):
return self._cmp(other) >= 0
return NotImplemented
def __gt__(self, other):
if isinstance(other, date):
return self._cmp(other) > 0
return NotImplemented
def _cmp(self, other):
assert isinstance(other, date)
y, m, d = self._year, self._month, self._day
y2, m2, d2 = other._year, other._month, other._day
return _cmp((y, m, d), (y2, m2, d2))
def __hash__(self):
"Hash."
return hash(self._getstate())
# Computations
def __add__(self, other):
"Add a date to a timedelta."
if isinstance(other, timedelta):
o = self.toordinal() + other.days
if 0 < o <= _MAXORDINAL:
return date.fromordinal(o)
raise OverflowError("result out of range")
return NotImplemented
__radd__ = __add__
def __sub__(self, other):
"""Subtract two dates, or a date and a timedelta."""
if isinstance(other, timedelta):
return self + timedelta(-other.days)
if isinstance(other, date):
days1 = self.toordinal()
days2 = other.toordinal()
return timedelta(days1 - days2)
return NotImplemented
def weekday(self):
"Return day of the week, where Monday == 0 ... Sunday == 6."
return (self.toordinal() + 6) % 7
# Day-of-the-week and week-of-the-year, according to ISO
def isoweekday(self):
"Return day of the week, where Monday == 1 ... Sunday == 7."
# 1-Jan-0001 is a Monday
return self.toordinal() % 7 or 7
def isocalendar(self):
"""Return a 3-tuple containing ISO year, week number, and weekday.
The first ISO week of the year is the (Mon-Sun) week
containing the year's first Thursday; everything else derives
from that.
The first week is 1; Monday is 1 ... Sunday is 7.
ISO calendar algorithm taken from
http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
"""
year = self._year
week1monday = _isoweek1monday(year)
today = _ymd2ord(self._year, self._month, self._day)
# Internally, week and day have origin 0
week, day = divmod(today - week1monday, 7)
if week < 0:
year -= 1
week1monday = _isoweek1monday(year)
week, day = divmod(today - week1monday, 7)
elif week >= 52:
if today >= _isoweek1monday(year+1):
year += 1
week = 0
return year, week+1, day+1
# Pickle support.
def _getstate(self):
yhi, ylo = divmod(self._year, 256)
return bytes([yhi, ylo, self._month, self._day]),
def __setstate(self, string):
if len(string) != 4 or not (1 <= string[2] <= 12):
raise TypeError("not enough arguments")
yhi, ylo, self._month, self._day = string
self._year = yhi * 256 + ylo
def __reduce__(self):
return (self.__class__, self._getstate())
_date_class = date # so functions w/ args named "date" can get at the class
date.min = date(1, 1, 1)
date.max = date(9999, 12, 31)
date.resolution = timedelta(days=1)
class tzinfo(object):
"""Abstract base class for time zone info classes.
Subclasses must override the name(), utcoffset() and dst() methods.
"""
__slots__ = ()
def tzname(self, dt):
"datetime -> string name of time zone."
raise NotImplementedError("tzinfo subclass must override tzname()")
def utcoffset(self, dt):
"datetime -> minutes east of UTC (negative for west of UTC)"
raise NotImplementedError("tzinfo subclass must override utcoffset()")
def dst(self, dt):
"""datetime -> DST offset in minutes east of UTC.
Return 0 if DST not in effect. utcoffset() must include the DST
offset.
"""
raise NotImplementedError("tzinfo subclass must override dst()")
def fromutc(self, dt):
"datetime in UTC -> datetime in local time."
if not isinstance(dt, datetime):
raise TypeError("fromutc() requires a datetime argument")
if dt.tzinfo is not self:
raise ValueError("dt.tzinfo is not self")
dtoff = dt.utcoffset()
if dtoff is None:
raise ValueError("fromutc() requires a non-None utcoffset() "
"result")
# See the long comment block at the end of this file for an
# explanation of this algorithm.
dtdst = dt.dst()
if dtdst is None:
raise ValueError("fromutc() requires a non-None dst() result")
delta = dtoff - dtdst
if delta:
dt += delta
dtdst = dt.dst()
if dtdst is None:
raise ValueError("fromutc(): dt.dst gave inconsistent "
"results; cannot convert")
return dt + dtdst
# Pickle support.
def __reduce__(self):
getinitargs = getattr(self, "__getinitargs__", None)
if getinitargs:
args = getinitargs()
else:
args = ()
getstate = getattr(self, "__getstate__", None)
if getstate:
state = getstate()
else:
state = getattr(self, "__dict__", None) or None
if state is None:
return (self.__class__, args)
else:
return (self.__class__, args, state)
_tzinfo_class = tzinfo
class time(object):
"""Time with time zone.
Constructors:
__new__()
Operators:
__repr__, __str__
__cmp__, __hash__
Methods:
strftime()
isoformat()
utcoffset()
tzname()
dst()
Properties (readonly):
hour, minute, second, microsecond, tzinfo
"""
def __new__(cls, hour=0, minute=0, second=0, microsecond=0, tzinfo=None):
"""Constructor.
Arguments:
hour, minute (required)
second, microsecond (default to zero)
tzinfo (default to None)
"""
self = object.__new__(cls)
if isinstance(hour, bytes) and len(hour) == 6:
# Pickle support
self.__setstate(hour, minute or None)
return self
_check_tzinfo_arg(tzinfo)
_check_time_fields(hour, minute, second, microsecond)
self._hour = hour
self._minute = minute
self._second = second
self._microsecond = microsecond
self._tzinfo = tzinfo
return self
# Read-only field accessors
@property
def hour(self):
"""hour (0-23)"""
return self._hour
@property
def minute(self):
"""minute (0-59)"""
return self._minute
@property
def second(self):
"""second (0-59)"""
return self._second
@property
def microsecond(self):
"""microsecond (0-999999)"""
return self._microsecond
@property
def tzinfo(self):
"""timezone info object"""
return self._tzinfo
# Standard conversions, __hash__ (and helpers)
# Comparisons of time objects with other.
def __eq__(self, other):
if isinstance(other, time):
return self._cmp(other, allow_mixed=True) == 0
else:
return False
def __ne__(self, other):
if isinstance(other, time):
return self._cmp(other, allow_mixed=True) != 0
else:
return True
def __le__(self, other):
if isinstance(other, time):
return self._cmp(other) <= 0
else:
_cmperror(self, other)
def __lt__(self, other):
if isinstance(other, time):
return self._cmp(other) < 0
else:
_cmperror(self, other)
def __ge__(self, other):
if isinstance(other, time):
return self._cmp(other) >= 0
else:
_cmperror(self, other)
def __gt__(self, other):
if isinstance(other, time):
return self._cmp(other) > 0
else:
_cmperror(self, other)
def _cmp(self, other, allow_mixed=False):
assert isinstance(other, time)
mytz = self._tzinfo
ottz = other._tzinfo
myoff = otoff = None
if mytz is ottz:
base_compare = True
else:
myoff = self.utcoffset()
otoff = other.utcoffset()
base_compare = myoff == otoff
if base_compare:
return _cmp((self._hour, self._minute, self._second,
self._microsecond),
(other._hour, other._minute, other._second,
other._microsecond))
if myoff is None or otoff is None:
if allow_mixed:
return 2 # arbitrary non-zero value
else:
raise TypeError("cannot compare naive and aware times")
myhhmm = self._hour * 60 + self._minute - myoff//timedelta(minutes=1)
othhmm = other._hour * 60 + other._minute - otoff//timedelta(minutes=1)
return _cmp((myhhmm, self._second, self._microsecond),
(othhmm, other._second, other._microsecond))
def __hash__(self):
"""Hash."""
tzoff = self.utcoffset()
if not tzoff: # zero or None
return hash(self._getstate()[0])
h, m = divmod(timedelta(hours=self.hour, minutes=self.minute) - tzoff,
timedelta(hours=1))
assert not m % timedelta(minutes=1), "whole minute"
m //= timedelta(minutes=1)
if 0 <= h < 24:
return hash(time(h, m, self.second, self.microsecond))
return hash((h, m, self.second, self.microsecond))
# Conversion to string
def _tzstr(self, sep=":"):
"""Return formatted timezone offset (+xx:xx) or None."""
off = self.utcoffset()
if off is not None:
if off.days < 0:
sign = "-"
off = -off
else:
sign = "+"
hh, mm = divmod(off, timedelta(hours=1))
assert not mm % timedelta(minutes=1), "whole minute"
mm //= timedelta(minutes=1)
assert 0 <= hh < 24
off = "%s%02d%s%02d" % (sign, hh, sep, mm)
return off
def __repr__(self):
"""Convert to formal string, for repr()."""
if self._microsecond != 0:
s = ", %d, %d" % (self._second, self._microsecond)
elif self._second != 0:
s = ", %d" % self._second
else:
s = ""
s= "%s(%d, %d%s)" % ('datetime.' + self.__class__.__name__,
self._hour, self._minute, s)
if self._tzinfo is not None:
assert s[-1:] == ")"
s = s[:-1] + ", tzinfo=%r" % self._tzinfo + ")"
return s
def isoformat(self):
"""Return the time formatted according to ISO.
This is 'HH:MM:SS.mmmmmm+zz:zz', or 'HH:MM:SS+zz:zz' if
self.microsecond == 0.
"""
s = _format_time(self._hour, self._minute, self._second,
self._microsecond)
tz = self._tzstr()
if tz:
s += tz
return s
__str__ = isoformat
def strftime(self, fmt):
"""Format using strftime(). The date part of the timestamp passed
to underlying strftime should not be used.
"""
# The year must be >= 1000 else Python's strftime implementation
# can raise a bogus exception.
timetuple = (1900, 1, 1,
self._hour, self._minute, self._second,
0, 1, -1)
return _wrap_strftime(self, fmt, timetuple)
def __format__(self, fmt):
if len(fmt) != 0:
return self.strftime(fmt)
return str(self)
# Timezone functions
def utcoffset(self):
"""Return the timezone offset in minutes east of UTC (negative west of
UTC)."""
if self._tzinfo is None:
return None
offset = self._tzinfo.utcoffset(None)
_check_utc_offset("utcoffset", offset)
return offset
def tzname(self):
"""Return the timezone name.
Note that the name is 100% informational -- there's no requirement that
it mean anything in particular. For example, "GMT", "UTC", "-500",
"-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
"""
if self._tzinfo is None:
return None
name = self._tzinfo.tzname(None)
_check_tzname(name)
return name
def dst(self):
"""Return 0 if DST is not in effect, or the DST offset (in minutes
eastward) if DST is in effect.
This is purely informational; the DST offset has already been added to
the UTC offset returned by utcoffset() if applicable, so there's no
need to consult dst() unless you're interested in displaying the DST
info.
"""
if self._tzinfo is None:
return None
offset = self._tzinfo.dst(None)
_check_utc_offset("dst", offset)
return offset
def replace(self, hour=None, minute=None, second=None, microsecond=None,
tzinfo=True):
"""Return a new time with new values for the specified fields."""
if hour is None:
hour = self.hour
if minute is None:
minute = self.minute
if second is None:
second = self.second
if microsecond is None:
microsecond = self.microsecond
if tzinfo is True:
tzinfo = self.tzinfo
_check_time_fields(hour, minute, second, microsecond)
_check_tzinfo_arg(tzinfo)
return time(hour, minute, second, microsecond, tzinfo)
def __bool__(self):
if self.second or self.microsecond:
return True
offset = self.utcoffset() or timedelta(0)
return timedelta(hours=self.hour, minutes=self.minute) != offset
# Pickle support.
def _getstate(self):
us2, us3 = divmod(self._microsecond, 256)
us1, us2 = divmod(us2, 256)
basestate = bytes([self._hour, self._minute, self._second,
us1, us2, us3])
if self._tzinfo is None:
return (basestate,)
else:
return (basestate, self._tzinfo)
def __setstate(self, string, tzinfo):
if len(string) != 6 or string[0] >= 24:
raise TypeError("an integer is required")
(self._hour, self._minute, self._second,
us1, us2, us3) = string
self._microsecond = (((us1 << 8) | us2) << 8) | us3
if tzinfo is None or isinstance(tzinfo, _tzinfo_class):
self._tzinfo = tzinfo
else:
raise TypeError("bad tzinfo state arg %r" % tzinfo)
def __reduce__(self):
return (time, self._getstate())
_time_class = time # so functions w/ args named "time" can get at the class
time.min = time(0, 0, 0)
time.max = time(23, 59, 59, 999999)
time.resolution = timedelta(microseconds=1)
class datetime(date):
"""datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])
The year, month and day arguments are required. tzinfo may be None, or an
instance of a tzinfo subclass. The remaining arguments may be ints.
"""
__slots__ = date.__slots__ + (
'_hour', '_minute', '_second',
'_microsecond', '_tzinfo')
def __new__(cls, year, month=None, day=None, hour=0, minute=0, second=0,
microsecond=0, tzinfo=None):
if isinstance(year, bytes) and len(year) == 10:
# Pickle support
self = date.__new__(cls, year[:4])
self.__setstate(year, month)
return self
_check_tzinfo_arg(tzinfo)
_check_time_fields(hour, minute, second, microsecond)
self = date.__new__(cls, year, month, day)
self._hour = hour
self._minute = minute
self._second = second
self._microsecond = microsecond
self._tzinfo = tzinfo
return self
# Read-only field accessors
@property
def hour(self):
"""hour (0-23)"""
return self._hour
@property
def minute(self):
"""minute (0-59)"""
return self._minute
@property
def second(self):
"""second (0-59)"""
return self._second
@property
def microsecond(self):
"""microsecond (0-999999)"""
return self._microsecond
@property
def tzinfo(self):
"""timezone info object"""
return self._tzinfo
@classmethod
def fromtimestamp(cls, t, tz=None):
"""Construct a datetime from a POSIX timestamp (like time.time()).
A timezone info object may be passed in as well.
"""
_check_tzinfo_arg(tz)
converter = _time.localtime if tz is None else _time.gmtime
t, frac = divmod(t, 1.0)
us = int(frac * 1e6)
# If timestamp is less than one microsecond smaller than a
# full second, us can be rounded up to 1000000. In this case,
# roll over to seconds, otherwise, ValueError is raised
# by the constructor.
if us == 1000000:
t += 1
us = 0
y, m, d, hh, mm, ss, weekday, jday, dst = converter(t)
ss = min(ss, 59) # clamp out leap seconds if the platform has them
result = cls(y, m, d, hh, mm, ss, us, tz)
if tz is not None:
result = tz.fromutc(result)
return result
@classmethod
def utcfromtimestamp(cls, t):
"Construct a UTC datetime from a POSIX timestamp (like time.time())."
t, frac = divmod(t, 1.0)
us = int(frac * 1e6)
# If timestamp is less than one microsecond smaller than a
# full second, us can be rounded up to 1000000. In this case,
# roll over to seconds, otherwise, ValueError is raised
# by the constructor.
if us == 1000000:
t += 1
us = 0
y, m, d, hh, mm, ss, weekday, jday, dst = _time.gmtime(t)
ss = min(ss, 59) # clamp out leap seconds if the platform has them
return cls(y, m, d, hh, mm, ss, us)
# XXX This is supposed to do better than we *can* do by using time.time(),
# XXX if the platform supports a more accurate way. The C implementation
# XXX uses gettimeofday on platforms that have it, but that isn't
# XXX available from Python. So now() may return different results
# XXX across the implementations.
@classmethod
def now(cls, tz=None):
"Construct a datetime from time.time() and optional time zone info."
t = _time.time()
return cls.fromtimestamp(t, tz)
@classmethod
def utcnow(cls):
"Construct a UTC datetime from time.time()."
t = _time.time()
return cls.utcfromtimestamp(t)
@classmethod
def combine(cls, date, time):
"Construct a datetime from a given date and a given time."
if not isinstance(date, _date_class):
raise TypeError("date argument must be a date instance")
if not isinstance(time, _time_class):
raise TypeError("time argument must be a time instance")
return cls(date.year, date.month, date.day,
time.hour, time.minute, time.second, time.microsecond,
time.tzinfo)
def timetuple(self):
"Return local time tuple compatible with time.localtime()."
dst = self.dst()
if dst is None:
dst = -1
elif dst:
dst = 1
else:
dst = 0
return _build_struct_time(self.year, self.month, self.day,
self.hour, self.minute, self.second,
dst)
def timestamp(self):
"Return POSIX timestamp as float"
if self._tzinfo is None:
return _time.mktime((self.year, self.month, self.day,
self.hour, self.minute, self.second,
-1, -1, -1)) + self.microsecond / 1e6
else:
return (self - _EPOCH).total_seconds()
def utctimetuple(self):
"Return UTC time tuple compatible with time.gmtime()."
offset = self.utcoffset()
if offset:
self -= offset
y, m, d = self.year, self.month, self.day
hh, mm, ss = self.hour, self.minute, self.second
return _build_struct_time(y, m, d, hh, mm, ss, 0)
def date(self):
"Return the date part."
return date(self._year, self._month, self._day)
def time(self):
"Return the time part, with tzinfo None."
return time(self.hour, self.minute, self.second, self.microsecond)
def timetz(self):
"Return the time part, with same tzinfo."
return time(self.hour, self.minute, self.second, self.microsecond,
self._tzinfo)
def replace(self, year=None, month=None, day=None, hour=None,
minute=None, second=None, microsecond=None, tzinfo=True):
"""Return a new datetime with new values for the specified fields."""
if year is None:
year = self.year
if month is None:
month = self.month
if day is None:
day = self.day
if hour is None:
hour = self.hour
if minute is None:
minute = self.minute
if second is None:
second = self.second
if microsecond is None:
microsecond = self.microsecond
if tzinfo is True:
tzinfo = self.tzinfo
_check_date_fields(year, month, day)
_check_time_fields(hour, minute, second, microsecond)
_check_tzinfo_arg(tzinfo)
return datetime(year, month, day, hour, minute, second,
microsecond, tzinfo)
def astimezone(self, tz=None):
if tz is None:
if self.tzinfo is None:
raise ValueError("astimezone() requires an aware datetime")
ts = (self - _EPOCH) // timedelta(seconds=1)
localtm = _time.localtime(ts)
local = datetime(*localtm[:6])
try:
# Extract TZ data if available
gmtoff = localtm.tm_gmtoff
zone = localtm.tm_zone
except AttributeError:
# Compute UTC offset and compare with the value implied
# by tm_isdst. If the values match, use the zone name
# implied by tm_isdst.
delta = local - datetime(*_time.gmtime(ts)[:6])
dst = _time.daylight and localtm.tm_isdst > 0
gmtoff = -(_time.altzone if dst else _time.timezone)
if delta == timedelta(seconds=gmtoff):
tz = timezone(delta, _time.tzname[dst])
else:
tz = timezone(delta)
else:
tz = timezone(timedelta(seconds=gmtoff), zone)
elif not isinstance(tz, tzinfo):
raise TypeError("tz argument must be an instance of tzinfo")
mytz = self.tzinfo
if mytz is None:
raise ValueError("astimezone() requires an aware datetime")
if tz is mytz:
return self
# Convert self to UTC, and attach the new time zone object.
myoffset = self.utcoffset()
if myoffset is None:
raise ValueError("astimezone() requires an aware datetime")
utc = (self - myoffset).replace(tzinfo=tz)
# Convert from UTC to tz's local time.
return tz.fromutc(utc)
# Ways to produce a string.
def ctime(self):
"Return ctime() style string."
weekday = self.toordinal() % 7 or 7
return "%s %s %2d %02d:%02d:%02d %04d" % (
_DAYNAMES[weekday],
_MONTHNAMES[self._month],
self._day,
self._hour, self._minute, self._second,
self._year)
def isoformat(self, sep='T'):
"""Return the time formatted according to ISO.
This is 'YYYY-MM-DD HH:MM:SS.mmmmmm', or 'YYYY-MM-DD HH:MM:SS' if
self.microsecond == 0.
If self.tzinfo is not None, the UTC offset is also attached, giving
'YYYY-MM-DD HH:MM:SS.mmmmmm+HH:MM' or 'YYYY-MM-DD HH:MM:SS+HH:MM'.
Optional argument sep specifies the separator between date and
time, default 'T'.
"""
s = ("%04d-%02d-%02d%c" % (self._year, self._month, self._day,
sep) +
_format_time(self._hour, self._minute, self._second,
self._microsecond))
off = self.utcoffset()
if off is not None:
if off.days < 0:
sign = "-"
off = -off
else:
sign = "+"
hh, mm = divmod(off, timedelta(hours=1))
assert not mm % timedelta(minutes=1), "whole minute"
mm //= timedelta(minutes=1)
s += "%s%02d:%02d" % (sign, hh, mm)
return s
def __repr__(self):
"""Convert to formal string, for repr()."""
L = [self._year, self._month, self._day, # These are never zero
self._hour, self._minute, self._second, self._microsecond]
if L[-1] == 0:
del L[-1]
if L[-1] == 0:
del L[-1]
s = ", ".join(map(str, L))
s = "%s(%s)" % ('datetime.' + self.__class__.__name__, s)
if self._tzinfo is not None:
assert s[-1:] == ")"
s = s[:-1] + ", tzinfo=%r" % self._tzinfo + ")"
return s
def __str__(self):
"Convert to string, for str()."
return self.isoformat(sep=' ')
@classmethod
def strptime(cls, date_string, format):
'string, format -> new datetime parsed from a string (like time.strptime()).'
import _strptime
return _strptime._strptime_datetime(cls, date_string, format)
def utcoffset(self):
"""Return the timezone offset in minutes east of UTC (negative west of
UTC)."""
if self._tzinfo is None:
return None
offset = self._tzinfo.utcoffset(self)
_check_utc_offset("utcoffset", offset)
return offset
def tzname(self):
"""Return the timezone name.
Note that the name is 100% informational -- there's no requirement that
it mean anything in particular. For example, "GMT", "UTC", "-500",
"-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
"""
name = _call_tzinfo_method(self._tzinfo, "tzname", self)
_check_tzname(name)
return name
def dst(self):
"""Return 0 if DST is not in effect, or the DST offset (in minutes
eastward) if DST is in effect.
This is purely informational; the DST offset has already been added to
the UTC offset returned by utcoffset() if applicable, so there's no
need to consult dst() unless you're interested in displaying the DST
info.
"""
if self._tzinfo is None:
return None
offset = self._tzinfo.dst(self)
_check_utc_offset("dst", offset)
return offset
# Comparisons of datetime objects with other.
def __eq__(self, other):
if isinstance(other, datetime):
return self._cmp(other, allow_mixed=True) == 0
elif not isinstance(other, date):
return NotImplemented
else:
return False
def __ne__(self, other):
if isinstance(other, datetime):
return self._cmp(other, allow_mixed=True) != 0
elif not isinstance(other, date):
return NotImplemented
else:
return True
def __le__(self, other):
if isinstance(other, datetime):
return self._cmp(other) <= 0
elif not isinstance(other, date):
return NotImplemented
else:
_cmperror(self, other)
def __lt__(self, other):
if isinstance(other, datetime):
return self._cmp(other) < 0
elif not isinstance(other, date):
return NotImplemented
else:
_cmperror(self, other)
def __ge__(self, other):
if isinstance(other, datetime):
return self._cmp(other) >= 0
elif not isinstance(other, date):
return NotImplemented
else:
_cmperror(self, other)
def __gt__(self, other):
if isinstance(other, datetime):
return self._cmp(other) > 0
elif not isinstance(other, date):
return NotImplemented
else:
_cmperror(self, other)
def _cmp(self, other, allow_mixed=False):
assert isinstance(other, datetime)
mytz = self._tzinfo
ottz = other._tzinfo
myoff = otoff = None
if mytz is ottz:
base_compare = True
else:
myoff = self.utcoffset()
otoff = other.utcoffset()
base_compare = myoff == otoff
if base_compare:
return _cmp((self._year, self._month, self._day,
self._hour, self._minute, self._second,
self._microsecond),
(other._year, other._month, other._day,
other._hour, other._minute, other._second,
other._microsecond))
if myoff is None or otoff is None:
if allow_mixed:
return 2 # arbitrary non-zero value
else:
raise TypeError("cannot compare naive and aware datetimes")
# XXX What follows could be done more efficiently...
diff = self - other # this will take offsets into account
if diff.days < 0:
return -1
return diff and 1 or 0
def __add__(self, other):
"Add a datetime and a timedelta."
if not isinstance(other, timedelta):
return NotImplemented
delta = timedelta(self.toordinal(),
hours=self._hour,
minutes=self._minute,
seconds=self._second,
microseconds=self._microsecond)
delta += other
hour, rem = divmod(delta.seconds, 3600)
minute, second = divmod(rem, 60)
if 0 < delta.days <= _MAXORDINAL:
return datetime.combine(date.fromordinal(delta.days),
time(hour, minute, second,
delta.microseconds,
tzinfo=self._tzinfo))
raise OverflowError("result out of range")
__radd__ = __add__
def __sub__(self, other):
"Subtract two datetimes, or a datetime and a timedelta."
if not isinstance(other, datetime):
if isinstance(other, timedelta):
return self + -other
return NotImplemented
days1 = self.toordinal()
days2 = other.toordinal()
secs1 = self._second + self._minute * 60 + self._hour * 3600
secs2 = other._second + other._minute * 60 + other._hour * 3600
base = timedelta(days1 - days2,
secs1 - secs2,
self._microsecond - other._microsecond)
if self._tzinfo is other._tzinfo:
return base
myoff = self.utcoffset()
otoff = other.utcoffset()
if myoff == otoff:
return base
if myoff is None or otoff is None:
raise TypeError("cannot mix naive and timezone-aware time")
return base + otoff - myoff
def __hash__(self):
tzoff = self.utcoffset()
if tzoff is None:
return hash(self._getstate()[0])
days = _ymd2ord(self.year, self.month, self.day)
seconds = self.hour * 3600 + self.minute * 60 + self.second
return hash(timedelta(days, seconds, self.microsecond) - tzoff)
# Pickle support.
def _getstate(self):
yhi, ylo = divmod(self._year, 256)
us2, us3 = divmod(self._microsecond, 256)
us1, us2 = divmod(us2, 256)
basestate = bytes([yhi, ylo, self._month, self._day,
self._hour, self._minute, self._second,
us1, us2, us3])
if self._tzinfo is None:
return (basestate,)
else:
return (basestate, self._tzinfo)
def __setstate(self, string, tzinfo):
(yhi, ylo, self._month, self._day, self._hour,
self._minute, self._second, us1, us2, us3) = string
self._year = yhi * 256 + ylo
self._microsecond = (((us1 << 8) | us2) << 8) | us3
if tzinfo is None or isinstance(tzinfo, _tzinfo_class):
self._tzinfo = tzinfo
else:
raise TypeError("bad tzinfo state arg %r" % tzinfo)
def __reduce__(self):
return (self.__class__, self._getstate())
datetime.min = datetime(1, 1, 1)
datetime.max = datetime(9999, 12, 31, 23, 59, 59, 999999)
datetime.resolution = timedelta(microseconds=1)
def _isoweek1monday(year):
# Helper to calculate the day number of the Monday starting week 1
# XXX This could be done more efficiently
THURSDAY = 3
firstday = _ymd2ord(year, 1, 1)
firstweekday = (firstday + 6) % 7 # See weekday() above
week1monday = firstday - firstweekday
if firstweekday > THURSDAY:
week1monday += 7
return week1monday
class timezone(tzinfo):
__slots__ = '_offset', '_name'
# Sentinel value to disallow None
_Omitted = object()
def __new__(cls, offset, name=_Omitted):
if not isinstance(offset, timedelta):
raise TypeError("offset must be a timedelta")
if name is cls._Omitted:
if not offset:
return cls.utc
name = None
elif not isinstance(name, str):
###
# For Python-Future:
if PY2 and isinstance(name, native_str):
name = name.decode()
else:
raise TypeError("name must be a string")
###
if not cls._minoffset <= offset <= cls._maxoffset:
raise ValueError("offset must be a timedelta"
" strictly between -timedelta(hours=24) and"
" timedelta(hours=24).")
if (offset.microseconds != 0 or
offset.seconds % 60 != 0):
raise ValueError("offset must be a timedelta"
" representing a whole number of minutes")
return cls._create(offset, name)
@classmethod
def _create(cls, offset, name=None):
self = tzinfo.__new__(cls)
self._offset = offset
self._name = name
return self
def __getinitargs__(self):
"""pickle support"""
if self._name is None:
return (self._offset,)
return (self._offset, self._name)
def __eq__(self, other):
if type(other) != timezone:
return False
return self._offset == other._offset
def __hash__(self):
return hash(self._offset)
def __repr__(self):
"""Convert to formal string, for repr().
>>> tz = timezone.utc
>>> repr(tz)
'datetime.timezone.utc'
>>> tz = timezone(timedelta(hours=-5), 'EST')
>>> repr(tz)
"datetime.timezone(datetime.timedelta(-1, 68400), 'EST')"
"""
if self is self.utc:
return 'datetime.timezone.utc'
if self._name is None:
return "%s(%r)" % ('datetime.' + self.__class__.__name__,
self._offset)
return "%s(%r, %r)" % ('datetime.' + self.__class__.__name__,
self._offset, self._name)
def __str__(self):
return self.tzname(None)
def utcoffset(self, dt):
if isinstance(dt, datetime) or dt is None:
return self._offset
raise TypeError("utcoffset() argument must be a datetime instance"
" or None")
def tzname(self, dt):
if isinstance(dt, datetime) or dt is None:
if self._name is None:
return self._name_from_offset(self._offset)
return self._name
raise TypeError("tzname() argument must be a datetime instance"
" or None")
def dst(self, dt):
if isinstance(dt, datetime) or dt is None:
return None
raise TypeError("dst() argument must be a datetime instance"
" or None")
def fromutc(self, dt):
if isinstance(dt, datetime):
if dt.tzinfo is not self:
raise ValueError("fromutc: dt.tzinfo "
"is not self")
return dt + self._offset
raise TypeError("fromutc() argument must be a datetime instance"
" or None")
_maxoffset = timedelta(hours=23, minutes=59)
_minoffset = -_maxoffset
@staticmethod
def _name_from_offset(delta):
if delta < timedelta(0):
sign = '-'
delta = -delta
else:
sign = '+'
hours, rest = divmod(delta, timedelta(hours=1))
minutes = rest // timedelta(minutes=1)
return 'UTC{}{:02d}:{:02d}'.format(sign, hours, minutes)
timezone.utc = timezone._create(timedelta(0))
timezone.min = timezone._create(timezone._minoffset)
timezone.max = timezone._create(timezone._maxoffset)
_EPOCH = datetime(1970, 1, 1, tzinfo=timezone.utc)
"""
Some time zone algebra. For a datetime x, let
x.n = x stripped of its timezone -- its naive time.
x.o = x.utcoffset(), and assuming that doesn't raise an exception or
return None
x.d = x.dst(), and assuming that doesn't raise an exception or
return None
x.s = x's standard offset, x.o - x.d
Now some derived rules, where k is a duration (timedelta).
1. x.o = x.s + x.d
This follows from the definition of x.s.
2. If x and y have the same tzinfo member, x.s = y.s.
This is actually a requirement, an assumption we need to make about
sane tzinfo classes.
3. The naive UTC time corresponding to x is x.n - x.o.
This is again a requirement for a sane tzinfo class.
4. (x+k).s = x.s
This follows from #2, and that datimetimetz+timedelta preserves tzinfo.
5. (x+k).n = x.n + k
Again follows from how arithmetic is defined.
Now we can explain tz.fromutc(x). Let's assume it's an interesting case
(meaning that the various tzinfo methods exist, and don't blow up or return
None when called).
The function wants to return a datetime y with timezone tz, equivalent to x.
x is already in UTC.
By #3, we want
y.n - y.o = x.n [1]
The algorithm starts by attaching tz to x.n, and calling that y. So
x.n = y.n at the start. Then it wants to add a duration k to y, so that [1]
becomes true; in effect, we want to solve [2] for k:
(y+k).n - (y+k).o = x.n [2]
By #1, this is the same as
(y+k).n - ((y+k).s + (y+k).d) = x.n [3]
By #5, (y+k).n = y.n + k, which equals x.n + k because x.n=y.n at the start.
Substituting that into [3],
x.n + k - (y+k).s - (y+k).d = x.n; the x.n terms cancel, leaving
k - (y+k).s - (y+k).d = 0; rearranging,
k = (y+k).s - (y+k).d; by #4, (y+k).s == y.s, so
k = y.s - (y+k).d
On the RHS, (y+k).d can't be computed directly, but y.s can be, and we
approximate k by ignoring the (y+k).d term at first. Note that k can't be
very large, since all offset-returning methods return a duration of magnitude
less than 24 hours. For that reason, if y is firmly in std time, (y+k).d must
be 0, so ignoring it has no consequence then.
In any case, the new value is
z = y + y.s [4]
It's helpful to step back at look at [4] from a higher level: it's simply
mapping from UTC to tz's standard time.
At this point, if
z.n - z.o = x.n [5]
we have an equivalent time, and are almost done. The insecurity here is
at the start of daylight time. Picture US Eastern for concreteness. The wall
time jumps from 1:59 to 3:00, and wall hours of the form 2:MM don't make good
sense then. The docs ask that an Eastern tzinfo class consider such a time to
be EDT (because it's "after 2"), which is a redundant spelling of 1:MM EST
on the day DST starts. We want to return the 1:MM EST spelling because that's
the only spelling that makes sense on the local wall clock.
In fact, if [5] holds at this point, we do have the standard-time spelling,
but that takes a bit of proof. We first prove a stronger result. What's the
difference between the LHS and RHS of [5]? Let
diff = x.n - (z.n - z.o) [6]
Now
z.n = by [4]
(y + y.s).n = by #5
y.n + y.s = since y.n = x.n
x.n + y.s = since z and y are have the same tzinfo member,
y.s = z.s by #2
x.n + z.s
Plugging that back into [6] gives
diff =
x.n - ((x.n + z.s) - z.o) = expanding
x.n - x.n - z.s + z.o = cancelling
- z.s + z.o = by #2
z.d
So diff = z.d.
If [5] is true now, diff = 0, so z.d = 0 too, and we have the standard-time
spelling we wanted in the endcase described above. We're done. Contrarily,
if z.d = 0, then we have a UTC equivalent, and are also done.
If [5] is not true now, diff = z.d != 0, and z.d is the offset we need to
add to z (in effect, z is in tz's standard time, and we need to shift the
local clock into tz's daylight time).
Let
z' = z + z.d = z + diff [7]
and we can again ask whether
z'.n - z'.o = x.n [8]
If so, we're done. If not, the tzinfo class is insane, according to the
assumptions we've made. This also requires a bit of proof. As before, let's
compute the difference between the LHS and RHS of [8] (and skipping some of
the justifications for the kinds of substitutions we've done several times
already):
diff' = x.n - (z'.n - z'.o) = replacing z'.n via [7]
x.n - (z.n + diff - z'.o) = replacing diff via [6]
x.n - (z.n + x.n - (z.n - z.o) - z'.o) =
x.n - z.n - x.n + z.n - z.o + z'.o = cancel x.n
- z.n + z.n - z.o + z'.o = cancel z.n
- z.o + z'.o = #1 twice
-z.s - z.d + z'.s + z'.d = z and z' have same tzinfo
z'.d - z.d
So z' is UTC-equivalent to x iff z'.d = z.d at this point. If they are equal,
we've found the UTC-equivalent so are done. In fact, we stop with [7] and
return z', not bothering to compute z'.d.
How could z.d and z'd differ? z' = z + z.d [7], so merely moving z' by
a dst() offset, and starting *from* a time already in DST (we know z.d != 0),
would have to change the result dst() returns: we start in DST, and moving
a little further into it takes us out of DST.
There isn't a sane case where this can happen. The closest it gets is at
the end of DST, where there's an hour in UTC with no spelling in a hybrid
tzinfo class. In US Eastern, that's 5:MM UTC = 0:MM EST = 1:MM EDT. During
that hour, on an Eastern clock 1:MM is taken as being in standard time (6:MM
UTC) because the docs insist on that, but 0:MM is taken as being in daylight
time (4:MM UTC). There is no local time mapping to 5:MM UTC. The local
clock jumps from 1:59 back to 1:00 again, and repeats the 1:MM hour in
standard time. Since that's what the local clock *does*, we want to map both
UTC hours 5:MM and 6:MM to 1:MM Eastern. The result is ambiguous
in local time, but so it goes -- it's the way the local clock works.
When x = 5:MM UTC is the input to this algorithm, x.o=0, y.o=-5 and y.d=0,
so z=0:MM. z.d=60 (minutes) then, so [5] doesn't hold and we keep going.
z' = z + z.d = 1:MM then, and z'.d=0, and z'.d - z.d = -60 != 0 so [8]
(correctly) concludes that z' is not UTC-equivalent to x.
Because we know z.d said z was in daylight time (else [5] would have held and
we would have stopped then), and we know z.d != z'.d (else [8] would have held
and we have stopped then), and there are only 2 possible values dst() can
return in Eastern, it follows that z'.d must be 0 (which it is in the example,
but the reasoning doesn't depend on the example -- it depends on there being
two possible dst() outcomes, one zero and the other non-zero). Therefore
z' must be in standard time, and is the spelling we want in this case.
Note again that z' is not UTC-equivalent as far as the hybrid tzinfo class is
concerned (because it takes z' as being in standard time rather than the
daylight time we intend here), but returning it gives the real-life "local
clock repeats an hour" behavior when mapping the "unspellable" UTC hour into
tz.
When the input is 6:MM, z=1:MM and z.d=0, and we stop at once, again with
the 1:MM standard time spelling we want.
So how can this break? One of the assumptions must be violated. Two
possibilities:
1) [2] effectively says that y.s is invariant across all y belong to a given
time zone. This isn't true if, for political reasons or continental drift,
a region decides to change its base offset from UTC.
2) There may be versions of "double daylight" time where the tail end of
the analysis gives up a step too early. I haven't thought about that
enough to say.
In any case, it's clear that the default fromutc() is strong enough to handle
"almost all" time zones: so long as the standard offset is invariant, it
doesn't matter if daylight time transition points change from year to year, or
if daylight time is skipped in some years; it doesn't matter how large or
small dst() may get within its bounds; and it doesn't even matter if some
perverse time zone returns a negative dst()). So a breaking case must be
pretty bizarre, and a tzinfo subclass can override fromutc() if it is.
"""
try:
from _datetime import *
except ImportError:
pass
else:
# Clean up unused names
del (_DAYNAMES, _DAYS_BEFORE_MONTH, _DAYS_IN_MONTH,
_DI100Y, _DI400Y, _DI4Y, _MAXORDINAL, _MONTHNAMES,
_build_struct_time, _call_tzinfo_method, _check_date_fields,
_check_time_fields, _check_tzinfo_arg, _check_tzname,
_check_utc_offset, _cmp, _cmperror, _date_class, _days_before_month,
_days_before_year, _days_in_month, _format_time, _is_leap,
_isoweek1monday, _math, _ord2ymd, _time, _time_class, _tzinfo_class,
_wrap_strftime, _ymd2ord)
# XXX Since import * above excludes names that start with _,
# docstring does not get overwritten. In the future, it may be
# appropriate to maintain a single module level docstring and
# remove the following line.
from _datetime import __doc__
PK #Du\��� " future/backports/test/keycert2.pemnu �[��� -----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBAJnsJZVrppL+W5I9
zGQrrawWwE5QJpBK9nWw17mXrZ03R1cD9BamLGivVISbPlRlAVnZBEyh1ATpsB7d
CUQ+WHEvALquvx4+Yw5l+fXeiYRjrLRBYZuVy8yNtXzU3iWcGObcYRkUdiXdOyP7
sLF2YZHRvQZpzgDBKkrraeQ81w21AgMBAAECgYBEm7n07FMHWlE+0kT0sXNsLYfy
YE+QKZnJw9WkaDN+zFEEPELkhZVt5BjsMraJr6v2fIEqF0gGGJPkbenffVq2B5dC
lWUOxvJHufMK4sM3Cp6s/gOp3LP+QkzVnvJSfAyZU6l+4PGX5pLdUsXYjPxgzjzL
S36tF7/2Uv1WePyLUQJBAMsPhYzUXOPRgmbhcJiqi9A9c3GO8kvSDYTCKt3VMnqz
HBn6MQ4VQasCD1F+7jWTI0FU/3vdw8non/Fj8hhYqZcCQQDCDRdvmZqDiZnpMqDq
L6ZSrLTVtMvZXZbgwForaAD9uHj51TME7+eYT7EG2YCgJTXJ4YvRJEnPNyskwdKt
vTSTAkEAtaaN/vyemEJ82BIGStwONNw0ILsSr5cZ9tBHzqiA/tipY+e36HRFiXhP
QcU9zXlxyWkDH8iz9DSAmE2jbfoqwwJANlMJ65E543cjIlitGcKLMnvtCCLcKpb7
xSG0XJB6Lo11OKPJ66jp0gcFTSCY1Lx2CXVd+gfJrfwI1Pp562+bhwJBAJ9IfDPU
R8OpO9v1SGd8x33Owm7uXOpB9d63/T70AD1QOXjKUC4eXYbt0WWfWuny/RNPRuyh
w7DXSfUF+kPKolU=
-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICXTCCAcagAwIBAgIJAIO3upAG445fMA0GCSqGSIb3DQEBBQUAMGIxCzAJBgNV
BAYTAlhZMRcwFQYDVQQHEw5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9u
IFNvZnR3YXJlIEZvdW5kYXRpb24xFTATBgNVBAMTDGZha2Vob3N0bmFtZTAeFw0x
MDEwMDkxNTAxMDBaFw0yMDEwMDYxNTAxMDBaMGIxCzAJBgNVBAYTAlhZMRcwFQYD
VQQHEw5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9uIFNvZnR3YXJlIEZv
dW5kYXRpb24xFTATBgNVBAMTDGZha2Vob3N0bmFtZTCBnzANBgkqhkiG9w0BAQEF
AAOBjQAwgYkCgYEAmewllWumkv5bkj3MZCutrBbATlAmkEr2dbDXuZetnTdHVwP0
FqYsaK9UhJs+VGUBWdkETKHUBOmwHt0JRD5YcS8Auq6/Hj5jDmX59d6JhGOstEFh
m5XLzI21fNTeJZwY5txhGRR2Jd07I/uwsXZhkdG9BmnOAMEqSutp5DzXDbUCAwEA
AaMbMBkwFwYDVR0RBBAwDoIMZmFrZWhvc3RuYW1lMA0GCSqGSIb3DQEBBQUAA4GB
AH+iMClLLGSaKWgwXsmdVo4FhTZZHo8Uprrtg3N9FxEeE50btpDVQysgRt5ias3K
m+bME9zbKwvbVWD5zZdjus4pDgzwF/iHyccL8JyYhxOvS/9zmvAtFXj/APIIbZFp
IT75d9f88ScIGEtknZQejnrdhB64tYki/EqluiuKBqKD
-----END CERTIFICATE-----
PK &Du\��g� � future/backports/test/dh512.pemnu �[��� -----BEGIN DH PARAMETERS-----
MEYCQQD1Kv884bEpQBgRjXyEpwpy1obEAxnIByl6ypUM2Zafq9AKUJsCRtMIPWak
XUGfnHy9iUsiGSa6q6Jew1XpKgVfAgEC
-----END DH PARAMETERS-----
These are the 512 bit DH parameters from "Assigned Number for SKIP Protocols"
(http://www.skip-vpn.org/spec/numbers.html).
See there for how they were generated.
Note that g is not a generator, but this is not a problem since p is a safe prime.
PK (Du\���� ! future/backports/test/__init__.pynu �[��� """
test package backported for python-future.
Its primary purpose is to allow use of "import test.support" for running
the Python standard library unit tests using the new Python 3 stdlib
import location.
Python 3 renamed test.test_support to test.support.
"""
PK +Du\��2�c c " future/backports/test/ssl_cert.pemnu �[��� -----BEGIN CERTIFICATE-----
MIICVDCCAb2gAwIBAgIJANfHOBkZr8JOMA0GCSqGSIb3DQEBBQUAMF8xCzAJBgNV
BAYTAlhZMRcwFQYDVQQHEw5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9u
IFNvZnR3YXJlIEZvdW5kYXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDAeFw0xMDEw
MDgyMzAxNTZaFw0yMDEwMDUyMzAxNTZaMF8xCzAJBgNVBAYTAlhZMRcwFQYDVQQH
Ew5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9uIFNvZnR3YXJlIEZvdW5k
YXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
gYkCgYEA21vT5isq7F68amYuuNpSFlKDPrMUCa4YWYqZRt2OZ+/3NKaZ2xAiSwr7
6MrQF70t5nLbSPpqE5+5VrS58SY+g/sXLiFd6AplH1wJZwh78DofbFYXUggktFMt
pTyiX8jtP66bkcPkDADA089RI1TQR6Ca+n7HFa7c1fabVV6i3zkCAwEAAaMYMBYw
FAYDVR0RBA0wC4IJbG9jYWxob3N0MA0GCSqGSIb3DQEBBQUAA4GBAHPctQBEQ4wd
BJ6+JcpIraopLn8BGhbjNWj40mmRqWB/NAWF6M5ne7KpGAu7tLeG4hb1zLaldK8G
lxy2GPSRF6LFS48dpEj2HbMv2nvv6xxalDMJ9+DicWgAKTQ6bcX2j3GUkCR0g/T1
CRlNBAAlvhKzO7Clpf9l0YKBEfraJByX
-----END CERTIFICATE-----
PK .Du\̺v
3 future/backports/test/https_svn_python_org_root.pemnu �[��� -----BEGIN CERTIFICATE-----
MIIHPTCCBSWgAwIBAgIBADANBgkqhkiG9w0BAQQFADB5MRAwDgYDVQQKEwdSb290
IENBMR4wHAYDVQQLExVodHRwOi8vd3d3LmNhY2VydC5vcmcxIjAgBgNVBAMTGUNB
IENlcnQgU2lnbmluZyBBdXRob3JpdHkxITAfBgkqhkiG9w0BCQEWEnN1cHBvcnRA
Y2FjZXJ0Lm9yZzAeFw0wMzAzMzAxMjI5NDlaFw0zMzAzMjkxMjI5NDlaMHkxEDAO
BgNVBAoTB1Jvb3QgQ0ExHjAcBgNVBAsTFWh0dHA6Ly93d3cuY2FjZXJ0Lm9yZzEi
MCAGA1UEAxMZQ0EgQ2VydCBTaWduaW5nIEF1dGhvcml0eTEhMB8GCSqGSIb3DQEJ
ARYSc3VwcG9ydEBjYWNlcnQub3JnMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEAziLA4kZ97DYoB1CW8qAzQIxL8TtmPzHlawI229Z89vGIj053NgVBlfkJ
8BLPRoZzYLdufujAWGSuzbCtRRcMY/pnCujW0r8+55jE8Ez64AO7NV1sId6eINm6
zWYyN3L69wj1x81YyY7nDl7qPv4coRQKFWyGhFtkZip6qUtTefWIonvuLwphK42y
fk1WpRPs6tqSnqxEQR5YYGUFZvjARL3LlPdCfgv3ZWiYUQXw8wWRBB0bF4LsyFe7
w2t6iPGwcswlWyCR7BYCEo8y6RcYSNDHBS4CMEK4JZwFaz+qOqfrU0j36NK2B5jc
G8Y0f3/JHIJ6BVgrCFvzOKKrF11myZjXnhCLotLddJr3cQxyYN/Nb5gznZY0dj4k
epKwDpUeb+agRThHqtdB7Uq3EvbXG4OKDy7YCbZZ16oE/9KTfWgu3YtLq1i6L43q
laegw1SJpfvbi1EinbLDvhG+LJGGi5Z4rSDTii8aP8bQUWWHIbEZAWV/RRyH9XzQ
QUxPKZgh/TMfdQwEUfoZd9vUFBzugcMd9Zi3aQaRIt0AUMyBMawSB3s42mhb5ivU
fslfrejrckzzAeVLIL+aplfKkQABi6F1ITe1Yw1nPkZPcCBnzsXWWdsC4PDSy826
YreQQejdIOQpvGQpQsgi3Hia/0PsmBsJUUtaWsJx8cTLc6nloQsCAwEAAaOCAc4w
ggHKMB0GA1UdDgQWBBQWtTIb1Mfz4OaO873SsDrusjkY0TCBowYDVR0jBIGbMIGY
gBQWtTIb1Mfz4OaO873SsDrusjkY0aF9pHsweTEQMA4GA1UEChMHUm9vdCBDQTEe
MBwGA1UECxMVaHR0cDovL3d3dy5jYWNlcnQub3JnMSIwIAYDVQQDExlDQSBDZXJ0
IFNpZ25pbmcgQXV0aG9yaXR5MSEwHwYJKoZIhvcNAQkBFhJzdXBwb3J0QGNhY2Vy
dC5vcmeCAQAwDwYDVR0TAQH/BAUwAwEB/zAyBgNVHR8EKzApMCegJaAjhiFodHRw
czovL3d3dy5jYWNlcnQub3JnL3Jldm9rZS5jcmwwMAYJYIZIAYb4QgEEBCMWIWh0
dHBzOi8vd3d3LmNhY2VydC5vcmcvcmV2b2tlLmNybDA0BglghkgBhvhCAQgEJxYl
aHR0cDovL3d3dy5jYWNlcnQub3JnL2luZGV4LnBocD9pZD0xMDBWBglghkgBhvhC
AQ0ESRZHVG8gZ2V0IHlvdXIgb3duIGNlcnRpZmljYXRlIGZvciBGUkVFIGhlYWQg
b3ZlciB0byBodHRwOi8vd3d3LmNhY2VydC5vcmcwDQYJKoZIhvcNAQEEBQADggIB
ACjH7pyCArpcgBLKNQodgW+JapnM8mgPf6fhjViVPr3yBsOQWqy1YPaZQwGjiHCc
nWKdpIevZ1gNMDY75q1I08t0AoZxPuIrA2jxNGJARjtT6ij0rPtmlVOKTV39O9lg
18p5aTuxZZKmxoGCXJzN600BiqXfEVWqFcofN8CCmHBh22p8lqOOLlQ+TyGpkO/c
gr/c6EWtTZBzCDyUZbAEmXZ/4rzCahWqlwQ3JNgelE5tDlG+1sSPypZt90Pf6DBl
Jzt7u0NDY8RD97LsaMzhGY4i+5jhe1o+ATc7iwiwovOVThrLm82asduycPAtStvY
sONvRUgzEv/+PDIqVPfE94rwiCPCR/5kenHA0R6mY7AHfqQv0wGP3J8rtsYIqQ+T
SCX8Ev2fQtzzxD72V7DX3WnRBnc0CkvSyqD/HMaMyRa+xMwyN2hzXwj7UfdJUzYF
CpUCTPJ5GhD22Dp1nPMd8aINcGeGG7MW9S/lpOt5hvk9C8JzC6WZrG/8Z7jlLwum
GCSNe9FINSkYQKyTYOGWhlC0elnYjyELn8+CkcY7v2vcB5G5l1YjqrZslMZIBjzk
zk6q5PYvCdxTby78dOs6Y5nCpqyJvKeyRKANihDjbPIky/qbn3BHLt4Ui9SyIAmW
omTxJBzcoTWcFbLUvFUufQb1nA5V9FrWk9p2rSVzTMVD
-----END CERTIFICATE-----
PK 0Du\���;� � ! future/backports/test/ssl_key.pemnu �[��� -----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBANtb0+YrKuxevGpm
LrjaUhZSgz6zFAmuGFmKmUbdjmfv9zSmmdsQIksK++jK0Be9LeZy20j6ahOfuVa0
ufEmPoP7Fy4hXegKZR9cCWcIe/A6H2xWF1IIJLRTLaU8ol/I7T+um5HD5AwAwNPP
USNU0Eegmvp+xxWu3NX2m1Veot85AgMBAAECgYA3ZdZ673X0oexFlq7AAmrutkHt
CL7LvwrpOiaBjhyTxTeSNWzvtQBkIU8DOI0bIazA4UreAFffwtvEuPmonDb3F+Iq
SMAu42XcGyVZEl+gHlTPU9XRX7nTOXVt+MlRRRxL6t9GkGfUAXI3XxJDXW3c0vBK
UL9xqD8cORXOfE06rQJBAP8mEX1ERkR64Ptsoe4281vjTlNfIbs7NMPkUnrn9N/Y
BLhjNIfQ3HFZG8BTMLfX7kCS9D593DW5tV4Z9BP/c6cCQQDcFzCcVArNh2JSywOQ
ZfTfRbJg/Z5Lt9Fkngv1meeGNPgIMLN8Sg679pAOOWmzdMO3V706rNPzSVMME7E5
oPIfAkEA8pDddarP5tCvTTgUpmTFbakm0KoTZm2+FzHcnA4jRh+XNTjTOv98Y6Ik
eO5d1ZnKXseWvkZncQgxfdnMqqpj5wJAcNq/RVne1DbYlwWchT2Si65MYmmJ8t+F
0mcsULqjOnEMwf5e+ptq5LzwbyrHZYq5FNk7ocufPv/ZQrcSSC+cFwJBAKvOJByS
x56qyGeZLOQlWS2JS3KJo59XuLFGqcbgN9Om9xFa41Yb4N9NvplFivsvZdw3m1Q/
SPIXQuT8RMPDVNQ=
-----END PRIVATE KEY-----
PK 3Du\�C � � future/backports/test/support.pynu �[��� # -*- coding: utf-8 -*-
"""Supporting definitions for the Python regression tests.
Backported for python-future from Python 3.3 test/support.py.
"""
from __future__ import (absolute_import, division,
print_function, unicode_literals)
from future import utils
from future.builtins import str, range, open, int, map, list
import contextlib
import errno
import functools
import gc
import socket
import sys
import os
import platform
import shutil
import warnings
import unittest
# For Python 2.6 compatibility:
if not hasattr(unittest, 'skip'):
import unittest2 as unittest
import importlib
# import collections.abc # not present on Py2.7
import re
import subprocess
import time
try:
import sysconfig
except ImportError:
# sysconfig is not available on Python 2.6. Try using distutils.sysconfig instead:
from distutils import sysconfig
import fnmatch
import logging.handlers
import struct
import tempfile
try:
if utils.PY3:
import _thread, threading
else:
import thread as _thread, threading
except ImportError:
_thread = None
threading = None
try:
import multiprocessing.process
except ImportError:
multiprocessing = None
try:
import zlib
except ImportError:
zlib = None
try:
import gzip
except ImportError:
gzip = None
try:
import bz2
except ImportError:
bz2 = None
try:
import lzma
except ImportError:
lzma = None
__all__ = [
"Error", "TestFailed", "ResourceDenied", "import_module", "verbose",
"use_resources", "max_memuse", "record_original_stdout",
"get_original_stdout", "unload", "unlink", "rmtree", "forget",
"is_resource_enabled", "requires", "requires_freebsd_version",
"requires_linux_version", "requires_mac_ver", "find_unused_port",
"bind_port", "IPV6_ENABLED", "is_jython", "TESTFN", "HOST", "SAVEDCWD",
"temp_cwd", "findfile", "create_empty_file", "sortdict",
"check_syntax_error", "open_urlresource", "check_warnings", "CleanImport",
"EnvironmentVarGuard", "TransientResource", "captured_stdout",
"captured_stdin", "captured_stderr", "time_out", "socket_peer_reset",
"ioerror_peer_reset", "run_with_locale", 'temp_umask',
"transient_internet", "set_memlimit", "bigmemtest", "bigaddrspacetest",
"BasicTestRunner", "run_unittest", "run_doctest", "threading_setup",
"threading_cleanup", "reap_children", "cpython_only", "check_impl_detail",
"get_attribute", "swap_item", "swap_attr", "requires_IEEE_754",
"TestHandler", "Matcher", "can_symlink", "skip_unless_symlink",
"skip_unless_xattr", "import_fresh_module", "requires_zlib",
"PIPE_MAX_SIZE", "failfast", "anticipate_failure", "run_with_tz",
"requires_gzip", "requires_bz2", "requires_lzma", "suppress_crash_popup",
]
class Error(Exception):
"""Base class for regression test exceptions."""
class TestFailed(Error):
"""Test failed."""
class ResourceDenied(unittest.SkipTest):
"""Test skipped because it requested a disallowed resource.
This is raised when a test calls requires() for a resource that
has not be enabled. It is used to distinguish between expected
and unexpected skips.
"""
@contextlib.contextmanager
def _ignore_deprecated_imports(ignore=True):
"""Context manager to suppress package and module deprecation
warnings when importing them.
If ignore is False, this context manager has no effect."""
if ignore:
with warnings.catch_warnings():
warnings.filterwarnings("ignore", ".+ (module|package)",
DeprecationWarning)
yield
else:
yield
def import_module(name, deprecated=False):
"""Import and return the module to be tested, raising SkipTest if
it is not available.
If deprecated is True, any module or package deprecation messages
will be suppressed."""
with _ignore_deprecated_imports(deprecated):
try:
return importlib.import_module(name)
except ImportError as msg:
raise unittest.SkipTest(str(msg))
def _save_and_remove_module(name, orig_modules):
"""Helper function to save and remove a module from sys.modules
Raise ImportError if the module can't be imported.
"""
# try to import the module and raise an error if it can't be imported
if name not in sys.modules:
__import__(name)
del sys.modules[name]
for modname in list(sys.modules):
if modname == name or modname.startswith(name + '.'):
orig_modules[modname] = sys.modules[modname]
del sys.modules[modname]
def _save_and_block_module(name, orig_modules):
"""Helper function to save and block a module in sys.modules
Return True if the module was in sys.modules, False otherwise.
"""
saved = True
try:
orig_modules[name] = sys.modules[name]
except KeyError:
saved = False
sys.modules[name] = None
return saved
def anticipate_failure(condition):
"""Decorator to mark a test that is known to be broken in some cases
Any use of this decorator should have a comment identifying the
associated tracker issue.
"""
if condition:
return unittest.expectedFailure
return lambda f: f
def import_fresh_module(name, fresh=(), blocked=(), deprecated=False):
"""Import and return a module, deliberately bypassing sys.modules.
This function imports and returns a fresh copy of the named Python module
by removing the named module from sys.modules before doing the import.
Note that unlike reload, the original module is not affected by
this operation.
*fresh* is an iterable of additional module names that are also removed
from the sys.modules cache before doing the import.
*blocked* is an iterable of module names that are replaced with None
in the module cache during the import to ensure that attempts to import
them raise ImportError.
The named module and any modules named in the *fresh* and *blocked*
parameters are saved before starting the import and then reinserted into
sys.modules when the fresh import is complete.
Module and package deprecation messages are suppressed during this import
if *deprecated* is True.
This function will raise ImportError if the named module cannot be
imported.
If deprecated is True, any module or package deprecation messages
will be suppressed.
"""
# NOTE: test_heapq, test_json and test_warnings include extra sanity checks
# to make sure that this utility function is working as expected
with _ignore_deprecated_imports(deprecated):
# Keep track of modules saved for later restoration as well
# as those which just need a blocking entry removed
orig_modules = {}
names_to_remove = []
_save_and_remove_module(name, orig_modules)
try:
for fresh_name in fresh:
_save_and_remove_module(fresh_name, orig_modules)
for blocked_name in blocked:
if not _save_and_block_module(blocked_name, orig_modules):
names_to_remove.append(blocked_name)
fresh_module = importlib.import_module(name)
except ImportError:
fresh_module = None
finally:
for orig_name, module in orig_modules.items():
sys.modules[orig_name] = module
for name_to_remove in names_to_remove:
del sys.modules[name_to_remove]
return fresh_module
def get_attribute(obj, name):
"""Get an attribute, raising SkipTest if AttributeError is raised."""
try:
attribute = getattr(obj, name)
except AttributeError:
raise unittest.SkipTest("object %r has no attribute %r" % (obj, name))
else:
return attribute
verbose = 1 # Flag set to 0 by regrtest.py
use_resources = None # Flag set to [] by regrtest.py
max_memuse = 0 # Disable bigmem tests (they will still be run with
# small sizes, to make sure they work.)
real_max_memuse = 0
failfast = False
match_tests = None
# _original_stdout is meant to hold stdout at the time regrtest began.
# This may be "the real" stdout, or IDLE's emulation of stdout, or whatever.
# The point is to have some flavor of stdout the user can actually see.
_original_stdout = None
def record_original_stdout(stdout):
global _original_stdout
_original_stdout = stdout
def get_original_stdout():
return _original_stdout or sys.stdout
def unload(name):
try:
del sys.modules[name]
except KeyError:
pass
if sys.platform.startswith("win"):
def _waitfor(func, pathname, waitall=False):
# Perform the operation
func(pathname)
# Now setup the wait loop
if waitall:
dirname = pathname
else:
dirname, name = os.path.split(pathname)
dirname = dirname or '.'
# Check for `pathname` to be removed from the filesystem.
# The exponential backoff of the timeout amounts to a total
# of ~1 second after which the deletion is probably an error
# anyway.
# Testing on a i7@4.3GHz shows that usually only 1 iteration is
# required when contention occurs.
timeout = 0.001
while timeout < 1.0:
# Note we are only testing for the existence of the file(s) in
# the contents of the directory regardless of any security or
# access rights. If we have made it this far, we have sufficient
# permissions to do that much using Python's equivalent of the
# Windows API FindFirstFile.
# Other Windows APIs can fail or give incorrect results when
# dealing with files that are pending deletion.
L = os.listdir(dirname)
if not (L if waitall else name in L):
return
# Increase the timeout and try again
time.sleep(timeout)
timeout *= 2
warnings.warn('tests may fail, delete still pending for ' + pathname,
RuntimeWarning, stacklevel=4)
def _unlink(filename):
_waitfor(os.unlink, filename)
def _rmdir(dirname):
_waitfor(os.rmdir, dirname)
def _rmtree(path):
def _rmtree_inner(path):
for name in os.listdir(path):
fullname = os.path.join(path, name)
if os.path.isdir(fullname):
_waitfor(_rmtree_inner, fullname, waitall=True)
os.rmdir(fullname)
else:
os.unlink(fullname)
_waitfor(_rmtree_inner, path, waitall=True)
_waitfor(os.rmdir, path)
else:
_unlink = os.unlink
_rmdir = os.rmdir
_rmtree = shutil.rmtree
def unlink(filename):
try:
_unlink(filename)
except OSError as error:
# The filename need not exist.
if error.errno not in (errno.ENOENT, errno.ENOTDIR):
raise
def rmdir(dirname):
try:
_rmdir(dirname)
except OSError as error:
# The directory need not exist.
if error.errno != errno.ENOENT:
raise
def rmtree(path):
try:
_rmtree(path)
except OSError as error:
if error.errno != errno.ENOENT:
raise
# On some platforms, should not run gui test even if it is allowed
# in `use_resources'.
if sys.platform.startswith('win'):
import ctypes
import ctypes.wintypes
def _is_gui_available():
UOI_FLAGS = 1
WSF_VISIBLE = 0x0001
class USEROBJECTFLAGS(ctypes.Structure):
_fields_ = [("fInherit", ctypes.wintypes.BOOL),
("fReserved", ctypes.wintypes.BOOL),
("dwFlags", ctypes.wintypes.DWORD)]
dll = ctypes.windll.user32
h = dll.GetProcessWindowStation()
if not h:
raise ctypes.WinError()
uof = USEROBJECTFLAGS()
needed = ctypes.wintypes.DWORD()
res = dll.GetUserObjectInformationW(h,
UOI_FLAGS,
ctypes.byref(uof),
ctypes.sizeof(uof),
ctypes.byref(needed))
if not res:
raise ctypes.WinError()
return bool(uof.dwFlags & WSF_VISIBLE)
else:
def _is_gui_available():
return True
def is_resource_enabled(resource):
"""Test whether a resource is enabled. Known resources are set by
regrtest.py."""
return use_resources is not None and resource in use_resources
def requires(resource, msg=None):
"""Raise ResourceDenied if the specified resource is not available.
If the caller's module is __main__ then automatically return True. The
possibility of False being returned occurs when regrtest.py is
executing.
"""
if resource == 'gui' and not _is_gui_available():
raise unittest.SkipTest("Cannot use the 'gui' resource")
# see if the caller's module is __main__ - if so, treat as if
# the resource was set
if sys._getframe(1).f_globals.get("__name__") == "__main__":
return
if not is_resource_enabled(resource):
if msg is None:
msg = "Use of the %r resource not enabled" % resource
raise ResourceDenied(msg)
def _requires_unix_version(sysname, min_version):
"""Decorator raising SkipTest if the OS is `sysname` and the version is less
than `min_version`.
For example, @_requires_unix_version('FreeBSD', (7, 2)) raises SkipTest if
the FreeBSD version is less than 7.2.
"""
def decorator(func):
@functools.wraps(func)
def wrapper(*args, **kw):
if platform.system() == sysname:
version_txt = platform.release().split('-', 1)[0]
try:
version = tuple(map(int, version_txt.split('.')))
except ValueError:
pass
else:
if version < min_version:
min_version_txt = '.'.join(map(str, min_version))
raise unittest.SkipTest(
"%s version %s or higher required, not %s"
% (sysname, min_version_txt, version_txt))
return func(*args, **kw)
wrapper.min_version = min_version
return wrapper
return decorator
def requires_freebsd_version(*min_version):
"""Decorator raising SkipTest if the OS is FreeBSD and the FreeBSD version is
less than `min_version`.
For example, @requires_freebsd_version(7, 2) raises SkipTest if the FreeBSD
version is less than 7.2.
"""
return _requires_unix_version('FreeBSD', min_version)
def requires_linux_version(*min_version):
"""Decorator raising SkipTest if the OS is Linux and the Linux version is
less than `min_version`.
For example, @requires_linux_version(2, 6, 32) raises SkipTest if the Linux
version is less than 2.6.32.
"""
return _requires_unix_version('Linux', min_version)
def requires_mac_ver(*min_version):
"""Decorator raising SkipTest if the OS is Mac OS X and the OS X
version if less than min_version.
For example, @requires_mac_ver(10, 5) raises SkipTest if the OS X version
is lesser than 10.5.
"""
def decorator(func):
@functools.wraps(func)
def wrapper(*args, **kw):
if sys.platform == 'darwin':
version_txt = platform.mac_ver()[0]
try:
version = tuple(map(int, version_txt.split('.')))
except ValueError:
pass
else:
if version < min_version:
min_version_txt = '.'.join(map(str, min_version))
raise unittest.SkipTest(
"Mac OS X %s or higher required, not %s"
% (min_version_txt, version_txt))
return func(*args, **kw)
wrapper.min_version = min_version
return wrapper
return decorator
# Don't use "localhost", since resolving it uses the DNS under recent
# Windows versions (see issue #18792).
HOST = "127.0.0.1"
HOSTv6 = "::1"
def find_unused_port(family=socket.AF_INET, socktype=socket.SOCK_STREAM):
"""Returns an unused port that should be suitable for binding. This is
achieved by creating a temporary socket with the same family and type as
the 'sock' parameter (default is AF_INET, SOCK_STREAM), and binding it to
the specified host address (defaults to 0.0.0.0) with the port set to 0,
eliciting an unused ephemeral port from the OS. The temporary socket is
then closed and deleted, and the ephemeral port is returned.
Either this method or bind_port() should be used for any tests where a
server socket needs to be bound to a particular port for the duration of
the test. Which one to use depends on whether the calling code is creating
a python socket, or if an unused port needs to be provided in a constructor
or passed to an external program (i.e. the -accept argument to openssl's
s_server mode). Always prefer bind_port() over find_unused_port() where
possible. Hard coded ports should *NEVER* be used. As soon as a server
socket is bound to a hard coded port, the ability to run multiple instances
of the test simultaneously on the same host is compromised, which makes the
test a ticking time bomb in a buildbot environment. On Unix buildbots, this
may simply manifest as a failed test, which can be recovered from without
intervention in most cases, but on Windows, the entire python process can
completely and utterly wedge, requiring someone to log in to the buildbot
and manually kill the affected process.
(This is easy to reproduce on Windows, unfortunately, and can be traced to
the SO_REUSEADDR socket option having different semantics on Windows versus
Unix/Linux. On Unix, you can't have two AF_INET SOCK_STREAM sockets bind,
listen and then accept connections on identical host/ports. An EADDRINUSE
socket.error will be raised at some point (depending on the platform and
the order bind and listen were called on each socket).
However, on Windows, if SO_REUSEADDR is set on the sockets, no EADDRINUSE
will ever be raised when attempting to bind two identical host/ports. When
accept() is called on each socket, the second caller's process will steal
the port from the first caller, leaving them both in an awkwardly wedged
state where they'll no longer respond to any signals or graceful kills, and
must be forcibly killed via OpenProcess()/TerminateProcess().
The solution on Windows is to use the SO_EXCLUSIVEADDRUSE socket option
instead of SO_REUSEADDR, which effectively affords the same semantics as
SO_REUSEADDR on Unix. Given the propensity of Unix developers in the Open
Source world compared to Windows ones, this is a common mistake. A quick
look over OpenSSL's 0.9.8g source shows that they use SO_REUSEADDR when
openssl.exe is called with the 's_server' option, for example. See
http://bugs.python.org/issue2550 for more info. The following site also
has a very thorough description about the implications of both REUSEADDR
and EXCLUSIVEADDRUSE on Windows:
http://msdn2.microsoft.com/en-us/library/ms740621(VS.85).aspx)
XXX: although this approach is a vast improvement on previous attempts to
elicit unused ports, it rests heavily on the assumption that the ephemeral
port returned to us by the OS won't immediately be dished back out to some
other process when we close and delete our temporary socket but before our
calling code has a chance to bind the returned port. We can deal with this
issue if/when we come across it.
"""
tempsock = socket.socket(family, socktype)
port = bind_port(tempsock)
tempsock.close()
del tempsock
return port
def bind_port(sock, host=HOST):
"""Bind the socket to a free port and return the port number. Relies on
ephemeral ports in order to ensure we are using an unbound port. This is
important as many tests may be running simultaneously, especially in a
buildbot environment. This method raises an exception if the sock.family
is AF_INET and sock.type is SOCK_STREAM, *and* the socket has SO_REUSEADDR
or SO_REUSEPORT set on it. Tests should *never* set these socket options
for TCP/IP sockets. The only case for setting these options is testing
multicasting via multiple UDP sockets.
Additionally, if the SO_EXCLUSIVEADDRUSE socket option is available (i.e.
on Windows), it will be set on the socket. This will prevent anyone else
from bind()'ing to our host/port for the duration of the test.
"""
if sock.family == socket.AF_INET and sock.type == socket.SOCK_STREAM:
if hasattr(socket, 'SO_REUSEADDR'):
if sock.getsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR) == 1:
raise TestFailed("tests should never set the SO_REUSEADDR " \
"socket option on TCP/IP sockets!")
if hasattr(socket, 'SO_REUSEPORT'):
try:
if sock.getsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT) == 1:
raise TestFailed("tests should never set the SO_REUSEPORT " \
"socket option on TCP/IP sockets!")
except socket.error:
# Python's socket module was compiled using modern headers
# thus defining SO_REUSEPORT but this process is running
# under an older kernel that does not support SO_REUSEPORT.
pass
if hasattr(socket, 'SO_EXCLUSIVEADDRUSE'):
sock.setsockopt(socket.SOL_SOCKET, socket.SO_EXCLUSIVEADDRUSE, 1)
sock.bind((host, 0))
port = sock.getsockname()[1]
return port
def _is_ipv6_enabled():
"""Check whether IPv6 is enabled on this host."""
if socket.has_ipv6:
sock = None
try:
sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
sock.bind(('::1', 0))
return True
except (socket.error, socket.gaierror):
pass
finally:
if sock:
sock.close()
return False
IPV6_ENABLED = _is_ipv6_enabled()
# A constant likely larger than the underlying OS pipe buffer size, to
# make writes blocking.
# Windows limit seems to be around 512 B, and many Unix kernels have a
# 64 KiB pipe buffer size or 16 * PAGE_SIZE: take a few megs to be sure.
# (see issue #17835 for a discussion of this number).
PIPE_MAX_SIZE = 4 * 1024 * 1024 + 1
# A constant likely larger than the underlying OS socket buffer size, to make
# writes blocking.
# The socket buffer sizes can usually be tuned system-wide (e.g. through sysctl
# on Linux), or on a per-socket basis (SO_SNDBUF/SO_RCVBUF). See issue #18643
# for a discussion of this number).
SOCK_MAX_SIZE = 16 * 1024 * 1024 + 1
# # decorator for skipping tests on non-IEEE 754 platforms
# requires_IEEE_754 = unittest.skipUnless(
# float.__getformat__("double").startswith("IEEE"),
# "test requires IEEE 754 doubles")
requires_zlib = unittest.skipUnless(zlib, 'requires zlib')
requires_bz2 = unittest.skipUnless(bz2, 'requires bz2')
requires_lzma = unittest.skipUnless(lzma, 'requires lzma')
is_jython = sys.platform.startswith('java')
# Filename used for testing
if os.name == 'java':
# Jython disallows @ in module names
TESTFN = '$test'
else:
TESTFN = '@test'
# Disambiguate TESTFN for parallel testing, while letting it remain a valid
# module name.
TESTFN = "{0}_{1}_tmp".format(TESTFN, os.getpid())
# # FS_NONASCII: non-ASCII character encodable by os.fsencode(),
# # or None if there is no such character.
# FS_NONASCII = None
# for character in (
# # First try printable and common characters to have a readable filename.
# # For each character, the encoding list are just example of encodings able
# # to encode the character (the list is not exhaustive).
#
# # U+00E6 (Latin Small Letter Ae): cp1252, iso-8859-1
# '\u00E6',
# # U+0130 (Latin Capital Letter I With Dot Above): cp1254, iso8859_3
# '\u0130',
# # U+0141 (Latin Capital Letter L With Stroke): cp1250, cp1257
# '\u0141',
# # U+03C6 (Greek Small Letter Phi): cp1253
# '\u03C6',
# # U+041A (Cyrillic Capital Letter Ka): cp1251
# '\u041A',
# # U+05D0 (Hebrew Letter Alef): Encodable to cp424
# '\u05D0',
# # U+060C (Arabic Comma): cp864, cp1006, iso8859_6, mac_arabic
# '\u060C',
# # U+062A (Arabic Letter Teh): cp720
# '\u062A',
# # U+0E01 (Thai Character Ko Kai): cp874
# '\u0E01',
#
# # Then try more "special" characters. "special" because they may be
# # interpreted or displayed differently depending on the exact locale
# # encoding and the font.
#
# # U+00A0 (No-Break Space)
# '\u00A0',
# # U+20AC (Euro Sign)
# '\u20AC',
# ):
# try:
# os.fsdecode(os.fsencode(character))
# except UnicodeError:
# pass
# else:
# FS_NONASCII = character
# break
#
# # TESTFN_UNICODE is a non-ascii filename
# TESTFN_UNICODE = TESTFN + "-\xe0\xf2\u0258\u0141\u011f"
# if sys.platform == 'darwin':
# # In Mac OS X's VFS API file names are, by definition, canonically
# # decomposed Unicode, encoded using UTF-8. See QA1173:
# # http://developer.apple.com/mac/library/qa/qa2001/qa1173.html
# import unicodedata
# TESTFN_UNICODE = unicodedata.normalize('NFD', TESTFN_UNICODE)
# TESTFN_ENCODING = sys.getfilesystemencoding()
#
# # TESTFN_UNENCODABLE is a filename (str type) that should *not* be able to be
# # encoded by the filesystem encoding (in strict mode). It can be None if we
# # cannot generate such filename.
# TESTFN_UNENCODABLE = None
# if os.name in ('nt', 'ce'):
# # skip win32s (0) or Windows 9x/ME (1)
# if sys.getwindowsversion().platform >= 2:
# # Different kinds of characters from various languages to minimize the
# # probability that the whole name is encodable to MBCS (issue #9819)
# TESTFN_UNENCODABLE = TESTFN + "-\u5171\u0141\u2661\u0363\uDC80"
# try:
# TESTFN_UNENCODABLE.encode(TESTFN_ENCODING)
# except UnicodeEncodeError:
# pass
# else:
# print('WARNING: The filename %r CAN be encoded by the filesystem encoding (%s). '
# 'Unicode filename tests may not be effective'
# % (TESTFN_UNENCODABLE, TESTFN_ENCODING))
# TESTFN_UNENCODABLE = None
# # Mac OS X denies unencodable filenames (invalid utf-8)
# elif sys.platform != 'darwin':
# try:
# # ascii and utf-8 cannot encode the byte 0xff
# b'\xff'.decode(TESTFN_ENCODING)
# except UnicodeDecodeError:
# # 0xff will be encoded using the surrogate character u+DCFF
# TESTFN_UNENCODABLE = TESTFN \
# + b'-\xff'.decode(TESTFN_ENCODING, 'surrogateescape')
# else:
# # File system encoding (eg. ISO-8859-* encodings) can encode
# # the byte 0xff. Skip some unicode filename tests.
# pass
#
# # TESTFN_UNDECODABLE is a filename (bytes type) that should *not* be able to be
# # decoded from the filesystem encoding (in strict mode). It can be None if we
# # cannot generate such filename (ex: the latin1 encoding can decode any byte
# # sequence). On UNIX, TESTFN_UNDECODABLE can be decoded by os.fsdecode() thanks
# # to the surrogateescape error handler (PEP 383), but not from the filesystem
# # encoding in strict mode.
# TESTFN_UNDECODABLE = None
# for name in (
# # b'\xff' is not decodable by os.fsdecode() with code page 932. Windows
# # accepts it to create a file or a directory, or don't accept to enter to
# # such directory (when the bytes name is used). So test b'\xe7' first: it is
# # not decodable from cp932.
# b'\xe7w\xf0',
# # undecodable from ASCII, UTF-8
# b'\xff',
# # undecodable from iso8859-3, iso8859-6, iso8859-7, cp424, iso8859-8, cp856
# # and cp857
# b'\xae\xd5'
# # undecodable from UTF-8 (UNIX and Mac OS X)
# b'\xed\xb2\x80', b'\xed\xb4\x80',
# # undecodable from shift_jis, cp869, cp874, cp932, cp1250, cp1251, cp1252,
# # cp1253, cp1254, cp1255, cp1257, cp1258
# b'\x81\x98',
# ):
# try:
# name.decode(TESTFN_ENCODING)
# except UnicodeDecodeError:
# TESTFN_UNDECODABLE = os.fsencode(TESTFN) + name
# break
#
# if FS_NONASCII:
# TESTFN_NONASCII = TESTFN + '-' + FS_NONASCII
# else:
# TESTFN_NONASCII = None
# Save the initial cwd
SAVEDCWD = os.getcwd()
@contextlib.contextmanager
def temp_cwd(name='tempcwd', quiet=False, path=None):
"""
Context manager that temporarily changes the CWD.
An existing path may be provided as *path*, in which case this
function makes no changes to the file system.
Otherwise, the new CWD is created in the current directory and it's
named *name*. If *quiet* is False (default) and it's not possible to
create or change the CWD, an error is raised. If it's True, only a
warning is raised and the original CWD is used.
"""
saved_dir = os.getcwd()
is_temporary = False
if path is None:
path = name
try:
os.mkdir(name)
is_temporary = True
except OSError:
if not quiet:
raise
warnings.warn('tests may fail, unable to create temp CWD ' + name,
RuntimeWarning, stacklevel=3)
try:
os.chdir(path)
except OSError:
if not quiet:
raise
warnings.warn('tests may fail, unable to change the CWD to ' + path,
RuntimeWarning, stacklevel=3)
try:
yield os.getcwd()
finally:
os.chdir(saved_dir)
if is_temporary:
rmtree(name)
if hasattr(os, "umask"):
@contextlib.contextmanager
def temp_umask(umask):
"""Context manager that temporarily sets the process umask."""
oldmask = os.umask(umask)
try:
yield
finally:
os.umask(oldmask)
def findfile(file, here=__file__, subdir=None):
"""Try to find a file on sys.path and the working directory. If it is not
found the argument passed to the function is returned (this does not
necessarily signal failure; could still be the legitimate path)."""
if os.path.isabs(file):
return file
if subdir is not None:
file = os.path.join(subdir, file)
path = sys.path
path = [os.path.dirname(here)] + path
for dn in path:
fn = os.path.join(dn, file)
if os.path.exists(fn): return fn
return file
def create_empty_file(filename):
"""Create an empty file. If the file already exists, truncate it."""
fd = os.open(filename, os.O_WRONLY | os.O_CREAT | os.O_TRUNC)
os.close(fd)
def sortdict(dict):
"Like repr(dict), but in sorted order."
items = sorted(dict.items())
reprpairs = ["%r: %r" % pair for pair in items]
withcommas = ", ".join(reprpairs)
return "{%s}" % withcommas
def make_bad_fd():
"""
Create an invalid file descriptor by opening and closing a file and return
its fd.
"""
file = open(TESTFN, "wb")
try:
return file.fileno()
finally:
file.close()
unlink(TESTFN)
def check_syntax_error(testcase, statement):
testcase.assertRaises(SyntaxError, compile, statement,
'<test string>', 'exec')
def open_urlresource(url, *args, **kw):
from future.backports.urllib import (request as urllib_request,
parse as urllib_parse)
check = kw.pop('check', None)
filename = urllib_parse.urlparse(url)[2].split('/')[-1] # '/': it's URL!
fn = os.path.join(os.path.dirname(__file__), "data", filename)
def check_valid_file(fn):
f = open(fn, *args, **kw)
if check is None:
return f
elif check(f):
f.seek(0)
return f
f.close()
if os.path.exists(fn):
f = check_valid_file(fn)
if f is not None:
return f
unlink(fn)
# Verify the requirement before downloading the file
requires('urlfetch')
print('\tfetching %s ...' % url, file=get_original_stdout())
f = urllib_request.urlopen(url, timeout=15)
try:
with open(fn, "wb") as out:
s = f.read()
while s:
out.write(s)
s = f.read()
finally:
f.close()
f = check_valid_file(fn)
if f is not None:
return f
raise TestFailed('invalid resource %r' % fn)
class WarningsRecorder(object):
"""Convenience wrapper for the warnings list returned on
entry to the warnings.catch_warnings() context manager.
"""
def __init__(self, warnings_list):
self._warnings = warnings_list
self._last = 0
def __getattr__(self, attr):
if len(self._warnings) > self._last:
return getattr(self._warnings[-1], attr)
elif attr in warnings.WarningMessage._WARNING_DETAILS:
return None
raise AttributeError("%r has no attribute %r" % (self, attr))
@property
def warnings(self):
return self._warnings[self._last:]
def reset(self):
self._last = len(self._warnings)
def _filterwarnings(filters, quiet=False):
"""Catch the warnings, then check if all the expected
warnings have been raised and re-raise unexpected warnings.
If 'quiet' is True, only re-raise the unexpected warnings.
"""
# Clear the warning registry of the calling module
# in order to re-raise the warnings.
frame = sys._getframe(2)
registry = frame.f_globals.get('__warningregistry__')
if registry:
if utils.PY3:
registry.clear()
else:
# Py2-compatible:
for i in range(len(registry)):
registry.pop()
with warnings.catch_warnings(record=True) as w:
# Set filter "always" to record all warnings. Because
# test_warnings swap the module, we need to look up in
# the sys.modules dictionary.
sys.modules['warnings'].simplefilter("always")
yield WarningsRecorder(w)
# Filter the recorded warnings
reraise = list(w)
missing = []
for msg, cat in filters:
seen = False
for w in reraise[:]:
warning = w.message
# Filter out the matching messages
if (re.match(msg, str(warning), re.I) and
issubclass(warning.__class__, cat)):
seen = True
reraise.remove(w)
if not seen and not quiet:
# This filter caught nothing
missing.append((msg, cat.__name__))
if reraise:
raise AssertionError("unhandled warning %s" % reraise[0])
if missing:
raise AssertionError("filter (%r, %s) did not catch any warning" %
missing[0])
@contextlib.contextmanager
def check_warnings(*filters, **kwargs):
"""Context manager to silence warnings.
Accept 2-tuples as positional arguments:
("message regexp", WarningCategory)
Optional argument:
- if 'quiet' is True, it does not fail if a filter catches nothing
(default True without argument,
default False if some filters are defined)
Without argument, it defaults to:
check_warnings(("", Warning), quiet=True)
"""
quiet = kwargs.get('quiet')
if not filters:
filters = (("", Warning),)
# Preserve backward compatibility
if quiet is None:
quiet = True
return _filterwarnings(filters, quiet)
class CleanImport(object):
"""Context manager to force import to return a new module reference.
This is useful for testing module-level behaviours, such as
the emission of a DeprecationWarning on import.
Use like this:
with CleanImport("foo"):
importlib.import_module("foo") # new reference
"""
def __init__(self, *module_names):
self.original_modules = sys.modules.copy()
for module_name in module_names:
if module_name in sys.modules:
module = sys.modules[module_name]
# It is possible that module_name is just an alias for
# another module (e.g. stub for modules renamed in 3.x).
# In that case, we also need delete the real module to clear
# the import cache.
if module.__name__ != module_name:
del sys.modules[module.__name__]
del sys.modules[module_name]
def __enter__(self):
return self
def __exit__(self, *ignore_exc):
sys.modules.update(self.original_modules)
### Added for python-future:
if utils.PY3:
import collections.abc
mybase = collections.abc.MutableMapping
else:
import UserDict
mybase = UserDict.DictMixin
###
class EnvironmentVarGuard(mybase):
"""Class to help protect the environment variable properly. Can be used as
a context manager."""
def __init__(self):
self._environ = os.environ
self._changed = {}
def __getitem__(self, envvar):
return self._environ[envvar]
def __setitem__(self, envvar, value):
# Remember the initial value on the first access
if envvar not in self._changed:
self._changed[envvar] = self._environ.get(envvar)
self._environ[envvar] = value
def __delitem__(self, envvar):
# Remember the initial value on the first access
if envvar not in self._changed:
self._changed[envvar] = self._environ.get(envvar)
if envvar in self._environ:
del self._environ[envvar]
def keys(self):
return self._environ.keys()
def __iter__(self):
return iter(self._environ)
def __len__(self):
return len(self._environ)
def set(self, envvar, value):
self[envvar] = value
def unset(self, envvar):
del self[envvar]
def __enter__(self):
return self
def __exit__(self, *ignore_exc):
for (k, v) in self._changed.items():
if v is None:
if k in self._environ:
del self._environ[k]
else:
self._environ[k] = v
os.environ = self._environ
class DirsOnSysPath(object):
"""Context manager to temporarily add directories to sys.path.
This makes a copy of sys.path, appends any directories given
as positional arguments, then reverts sys.path to the copied
settings when the context ends.
Note that *all* sys.path modifications in the body of the
context manager, including replacement of the object,
will be reverted at the end of the block.
"""
def __init__(self, *paths):
self.original_value = sys.path[:]
self.original_object = sys.path
sys.path.extend(paths)
def __enter__(self):
return self
def __exit__(self, *ignore_exc):
sys.path = self.original_object
sys.path[:] = self.original_value
class TransientResource(object):
"""Raise ResourceDenied if an exception is raised while the context manager
is in effect that matches the specified exception and attributes."""
def __init__(self, exc, **kwargs):
self.exc = exc
self.attrs = kwargs
def __enter__(self):
return self
def __exit__(self, type_=None, value=None, traceback=None):
"""If type_ is a subclass of self.exc and value has attributes matching
self.attrs, raise ResourceDenied. Otherwise let the exception
propagate (if any)."""
if type_ is not None and issubclass(self.exc, type_):
for attr, attr_value in self.attrs.items():
if not hasattr(value, attr):
break
if getattr(value, attr) != attr_value:
break
else:
raise ResourceDenied("an optional resource is not available")
# Context managers that raise ResourceDenied when various issues
# with the Internet connection manifest themselves as exceptions.
# XXX deprecate these and use transient_internet() instead
time_out = TransientResource(IOError, errno=errno.ETIMEDOUT)
socket_peer_reset = TransientResource(socket.error, errno=errno.ECONNRESET)
ioerror_peer_reset = TransientResource(IOError, errno=errno.ECONNRESET)
@contextlib.contextmanager
def transient_internet(resource_name, timeout=30.0, errnos=()):
"""Return a context manager that raises ResourceDenied when various issues
with the Internet connection manifest themselves as exceptions."""
default_errnos = [
('ECONNREFUSED', 111),
('ECONNRESET', 104),
('EHOSTUNREACH', 113),
('ENETUNREACH', 101),
('ETIMEDOUT', 110),
]
default_gai_errnos = [
('EAI_AGAIN', -3),
('EAI_FAIL', -4),
('EAI_NONAME', -2),
('EAI_NODATA', -5),
# Encountered when trying to resolve IPv6-only hostnames
('WSANO_DATA', 11004),
]
denied = ResourceDenied("Resource %r is not available" % resource_name)
captured_errnos = errnos
gai_errnos = []
if not captured_errnos:
captured_errnos = [getattr(errno, name, num)
for (name, num) in default_errnos]
gai_errnos = [getattr(socket, name, num)
for (name, num) in default_gai_errnos]
def filter_error(err):
n = getattr(err, 'errno', None)
if (isinstance(err, socket.timeout) or
(isinstance(err, socket.gaierror) and n in gai_errnos) or
n in captured_errnos):
if not verbose:
sys.stderr.write(denied.args[0] + "\n")
# Was: raise denied from err
# For Python-Future:
exc = denied
exc.__cause__ = err
raise exc
old_timeout = socket.getdefaulttimeout()
try:
if timeout is not None:
socket.setdefaulttimeout(timeout)
yield
except IOError as err:
# urllib can wrap original socket errors multiple times (!), we must
# unwrap to get at the original error.
while True:
a = err.args
if len(a) >= 1 and isinstance(a[0], IOError):
err = a[0]
# The error can also be wrapped as args[1]:
# except socket.error as msg:
# raise IOError('socket error', msg).with_traceback(sys.exc_info()[2])
elif len(a) >= 2 and isinstance(a[1], IOError):
err = a[1]
else:
break
filter_error(err)
raise
# XXX should we catch generic exceptions and look for their
# __cause__ or __context__?
finally:
socket.setdefaulttimeout(old_timeout)
@contextlib.contextmanager
def captured_output(stream_name):
"""Return a context manager used by captured_stdout/stdin/stderr
that temporarily replaces the sys stream *stream_name* with a StringIO."""
import io
orig_stdout = getattr(sys, stream_name)
setattr(sys, stream_name, io.StringIO())
try:
yield getattr(sys, stream_name)
finally:
setattr(sys, stream_name, orig_stdout)
def captured_stdout():
"""Capture the output of sys.stdout:
with captured_stdout() as s:
print("hello")
self.assertEqual(s.getvalue(), "hello")
"""
return captured_output("stdout")
def captured_stderr():
return captured_output("stderr")
def captured_stdin():
return captured_output("stdin")
def gc_collect():
"""Force as many objects as possible to be collected.
In non-CPython implementations of Python, this is needed because timely
deallocation is not guaranteed by the garbage collector. (Even in CPython
this can be the case in case of reference cycles.) This means that __del__
methods may be called later than expected and weakrefs may remain alive for
longer than expected. This function tries its best to force all garbage
objects to disappear.
"""
gc.collect()
if is_jython:
time.sleep(0.1)
gc.collect()
gc.collect()
@contextlib.contextmanager
def disable_gc():
have_gc = gc.isenabled()
gc.disable()
try:
yield
finally:
if have_gc:
gc.enable()
def python_is_optimized():
"""Find if Python was built with optimizations."""
# We don't have sysconfig on Py2.6:
import sysconfig
cflags = sysconfig.get_config_var('PY_CFLAGS') or ''
final_opt = ""
for opt in cflags.split():
if opt.startswith('-O'):
final_opt = opt
return final_opt != '' and final_opt != '-O0'
_header = 'nP'
_align = '0n'
if hasattr(sys, "gettotalrefcount"):
_header = '2P' + _header
_align = '0P'
_vheader = _header + 'n'
def calcobjsize(fmt):
return struct.calcsize(_header + fmt + _align)
def calcvobjsize(fmt):
return struct.calcsize(_vheader + fmt + _align)
_TPFLAGS_HAVE_GC = 1<<14
_TPFLAGS_HEAPTYPE = 1<<9
def check_sizeof(test, o, size):
result = sys.getsizeof(o)
# add GC header size
if ((type(o) == type) and (o.__flags__ & _TPFLAGS_HEAPTYPE) or\
((type(o) != type) and (type(o).__flags__ & _TPFLAGS_HAVE_GC))):
size += _testcapi.SIZEOF_PYGC_HEAD
msg = 'wrong size for %s: got %d, expected %d' \
% (type(o), result, size)
test.assertEqual(result, size, msg)
#=======================================================================
# Decorator for running a function in a different locale, correctly resetting
# it afterwards.
def run_with_locale(catstr, *locales):
def decorator(func):
def inner(*args, **kwds):
try:
import locale
category = getattr(locale, catstr)
orig_locale = locale.setlocale(category)
except AttributeError:
# if the test author gives us an invalid category string
raise
except:
# cannot retrieve original locale, so do nothing
locale = orig_locale = None
else:
for loc in locales:
try:
locale.setlocale(category, loc)
break
except:
pass
# now run the function, resetting the locale on exceptions
try:
return func(*args, **kwds)
finally:
if locale and orig_locale:
locale.setlocale(category, orig_locale)
inner.__name__ = func.__name__
inner.__doc__ = func.__doc__
return inner
return decorator
#=======================================================================
# Decorator for running a function in a specific timezone, correctly
# resetting it afterwards.
def run_with_tz(tz):
def decorator(func):
def inner(*args, **kwds):
try:
tzset = time.tzset
except AttributeError:
raise unittest.SkipTest("tzset required")
if 'TZ' in os.environ:
orig_tz = os.environ['TZ']
else:
orig_tz = None
os.environ['TZ'] = tz
tzset()
# now run the function, resetting the tz on exceptions
try:
return func(*args, **kwds)
finally:
if orig_tz is None:
del os.environ['TZ']
else:
os.environ['TZ'] = orig_tz
time.tzset()
inner.__name__ = func.__name__
inner.__doc__ = func.__doc__
return inner
return decorator
#=======================================================================
# Big-memory-test support. Separate from 'resources' because memory use
# should be configurable.
# Some handy shorthands. Note that these are used for byte-limits as well
# as size-limits, in the various bigmem tests
_1M = 1024*1024
_1G = 1024 * _1M
_2G = 2 * _1G
_4G = 4 * _1G
MAX_Py_ssize_t = sys.maxsize
def set_memlimit(limit):
global max_memuse
global real_max_memuse
sizes = {
'k': 1024,
'm': _1M,
'g': _1G,
't': 1024*_1G,
}
m = re.match(r'(\d+(\.\d+)?) (K|M|G|T)b?$', limit,
re.IGNORECASE | re.VERBOSE)
if m is None:
raise ValueError('Invalid memory limit %r' % (limit,))
memlimit = int(float(m.group(1)) * sizes[m.group(3).lower()])
real_max_memuse = memlimit
if memlimit > MAX_Py_ssize_t:
memlimit = MAX_Py_ssize_t
if memlimit < _2G - 1:
raise ValueError('Memory limit %r too low to be useful' % (limit,))
max_memuse = memlimit
class _MemoryWatchdog(object):
"""An object which periodically watches the process' memory consumption
and prints it out.
"""
def __init__(self):
self.procfile = '/proc/{pid}/statm'.format(pid=os.getpid())
self.started = False
def start(self):
try:
f = open(self.procfile, 'r')
except OSError as e:
warnings.warn('/proc not available for stats: {0}'.format(e),
RuntimeWarning)
sys.stderr.flush()
return
watchdog_script = findfile("memory_watchdog.py")
self.mem_watchdog = subprocess.Popen([sys.executable, watchdog_script],
stdin=f, stderr=subprocess.DEVNULL)
f.close()
self.started = True
def stop(self):
if self.started:
self.mem_watchdog.terminate()
self.mem_watchdog.wait()
def bigmemtest(size, memuse, dry_run=True):
"""Decorator for bigmem tests.
'minsize' is the minimum useful size for the test (in arbitrary,
test-interpreted units.) 'memuse' is the number of 'bytes per size' for
the test, or a good estimate of it.
if 'dry_run' is False, it means the test doesn't support dummy runs
when -M is not specified.
"""
def decorator(f):
def wrapper(self):
size = wrapper.size
memuse = wrapper.memuse
if not real_max_memuse:
maxsize = 5147
else:
maxsize = size
if ((real_max_memuse or not dry_run)
and real_max_memuse < maxsize * memuse):
raise unittest.SkipTest(
"not enough memory: %.1fG minimum needed"
% (size * memuse / (1024 ** 3)))
if real_max_memuse and verbose:
print()
print(" ... expected peak memory use: {peak:.1f}G"
.format(peak=size * memuse / (1024 ** 3)))
watchdog = _MemoryWatchdog()
watchdog.start()
else:
watchdog = None
try:
return f(self, maxsize)
finally:
if watchdog:
watchdog.stop()
wrapper.size = size
wrapper.memuse = memuse
return wrapper
return decorator
def bigaddrspacetest(f):
"""Decorator for tests that fill the address space."""
def wrapper(self):
if max_memuse < MAX_Py_ssize_t:
if MAX_Py_ssize_t >= 2**63 - 1 and max_memuse >= 2**31:
raise unittest.SkipTest(
"not enough memory: try a 32-bit build instead")
else:
raise unittest.SkipTest(
"not enough memory: %.1fG minimum needed"
% (MAX_Py_ssize_t / (1024 ** 3)))
else:
return f(self)
return wrapper
#=======================================================================
# unittest integration.
class BasicTestRunner(object):
def run(self, test):
result = unittest.TestResult()
test(result)
return result
def _id(obj):
return obj
def requires_resource(resource):
if resource == 'gui' and not _is_gui_available():
return unittest.skip("resource 'gui' is not available")
if is_resource_enabled(resource):
return _id
else:
return unittest.skip("resource {0!r} is not enabled".format(resource))
def cpython_only(test):
"""
Decorator for tests only applicable on CPython.
"""
return impl_detail(cpython=True)(test)
def impl_detail(msg=None, **guards):
if check_impl_detail(**guards):
return _id
if msg is None:
guardnames, default = _parse_guards(guards)
if default:
msg = "implementation detail not available on {0}"
else:
msg = "implementation detail specific to {0}"
guardnames = sorted(guardnames.keys())
msg = msg.format(' or '.join(guardnames))
return unittest.skip(msg)
def _parse_guards(guards):
# Returns a tuple ({platform_name: run_me}, default_value)
if not guards:
return ({'cpython': True}, False)
is_true = list(guards.values())[0]
assert list(guards.values()) == [is_true] * len(guards) # all True or all False
return (guards, not is_true)
# Use the following check to guard CPython's implementation-specific tests --
# or to run them only on the implementation(s) guarded by the arguments.
def check_impl_detail(**guards):
"""This function returns True or False depending on the host platform.
Examples:
if check_impl_detail(): # only on CPython (default)
if check_impl_detail(jython=True): # only on Jython
if check_impl_detail(cpython=False): # everywhere except on CPython
"""
guards, default = _parse_guards(guards)
return guards.get(platform.python_implementation().lower(), default)
def no_tracing(func):
"""Decorator to temporarily turn off tracing for the duration of a test."""
if not hasattr(sys, 'gettrace'):
return func
else:
@functools.wraps(func)
def wrapper(*args, **kwargs):
original_trace = sys.gettrace()
try:
sys.settrace(None)
return func(*args, **kwargs)
finally:
sys.settrace(original_trace)
return wrapper
def refcount_test(test):
"""Decorator for tests which involve reference counting.
To start, the decorator does not run the test if is not run by CPython.
After that, any trace function is unset during the test to prevent
unexpected refcounts caused by the trace function.
"""
return no_tracing(cpython_only(test))
def _filter_suite(suite, pred):
"""Recursively filter test cases in a suite based on a predicate."""
newtests = []
for test in suite._tests:
if isinstance(test, unittest.TestSuite):
_filter_suite(test, pred)
newtests.append(test)
else:
if pred(test):
newtests.append(test)
suite._tests = newtests
def _run_suite(suite):
"""Run tests from a unittest.TestSuite-derived class."""
if verbose:
runner = unittest.TextTestRunner(sys.stdout, verbosity=2,
failfast=failfast)
else:
runner = BasicTestRunner()
result = runner.run(suite)
if not result.wasSuccessful():
if len(result.errors) == 1 and not result.failures:
err = result.errors[0][1]
elif len(result.failures) == 1 and not result.errors:
err = result.failures[0][1]
else:
err = "multiple errors occurred"
if not verbose: err += "; run in verbose mode for details"
raise TestFailed(err)
def run_unittest(*classes):
"""Run tests from unittest.TestCase-derived classes."""
valid_types = (unittest.TestSuite, unittest.TestCase)
suite = unittest.TestSuite()
for cls in classes:
if isinstance(cls, str):
if cls in sys.modules:
suite.addTest(unittest.findTestCases(sys.modules[cls]))
else:
raise ValueError("str arguments must be keys in sys.modules")
elif isinstance(cls, valid_types):
suite.addTest(cls)
else:
suite.addTest(unittest.makeSuite(cls))
def case_pred(test):
if match_tests is None:
return True
for name in test.id().split("."):
if fnmatch.fnmatchcase(name, match_tests):
return True
return False
_filter_suite(suite, case_pred)
_run_suite(suite)
# We don't have sysconfig on Py2.6:
# #=======================================================================
# # Check for the presence of docstrings.
#
# HAVE_DOCSTRINGS = (check_impl_detail(cpython=False) or
# sys.platform == 'win32' or
# sysconfig.get_config_var('WITH_DOC_STRINGS'))
#
# requires_docstrings = unittest.skipUnless(HAVE_DOCSTRINGS,
# "test requires docstrings")
#
#
# #=======================================================================
# doctest driver.
def run_doctest(module, verbosity=None, optionflags=0):
"""Run doctest on the given module. Return (#failures, #tests).
If optional argument verbosity is not specified (or is None), pass
support's belief about verbosity on to doctest. Else doctest's
usual behavior is used (it searches sys.argv for -v).
"""
import doctest
if verbosity is None:
verbosity = verbose
else:
verbosity = None
f, t = doctest.testmod(module, verbose=verbosity, optionflags=optionflags)
if f:
raise TestFailed("%d of %d doctests failed" % (f, t))
if verbose:
print('doctest (%s) ... %d tests with zero failures' %
(module.__name__, t))
return f, t
#=======================================================================
# Support for saving and restoring the imported modules.
def modules_setup():
return sys.modules.copy(),
def modules_cleanup(oldmodules):
# Encoders/decoders are registered permanently within the internal
# codec cache. If we destroy the corresponding modules their
# globals will be set to None which will trip up the cached functions.
encodings = [(k, v) for k, v in sys.modules.items()
if k.startswith('encodings.')]
# Was:
# sys.modules.clear()
# Py2-compatible:
for i in range(len(sys.modules)):
sys.modules.pop()
sys.modules.update(encodings)
# XXX: This kind of problem can affect more than just encodings. In particular
# extension modules (such as _ssl) don't cope with reloading properly.
# Really, test modules should be cleaning out the test specific modules they
# know they added (ala test_runpy) rather than relying on this function (as
# test_importhooks and test_pkg do currently).
# Implicitly imported *real* modules should be left alone (see issue 10556).
sys.modules.update(oldmodules)
#=======================================================================
# Backported versions of threading_setup() and threading_cleanup() which don't refer
# to threading._dangling (not available on Py2.7).
# Threading support to prevent reporting refleaks when running regrtest.py -R
# NOTE: we use thread._count() rather than threading.enumerate() (or the
# moral equivalent thereof) because a threading.Thread object is still alive
# until its __bootstrap() method has returned, even after it has been
# unregistered from the threading module.
# thread._count(), on the other hand, only gets decremented *after* the
# __bootstrap() method has returned, which gives us reliable reference counts
# at the end of a test run.
def threading_setup():
if _thread:
return _thread._count(),
else:
return 1,
def threading_cleanup(nb_threads):
if not _thread:
return
_MAX_COUNT = 10
for count in range(_MAX_COUNT):
n = _thread._count()
if n == nb_threads:
break
time.sleep(0.1)
# XXX print a warning in case of failure?
def reap_threads(func):
"""Use this function when threads are being used. This will
ensure that the threads are cleaned up even when the test fails.
If threading is unavailable this function does nothing.
"""
if not _thread:
return func
@functools.wraps(func)
def decorator(*args):
key = threading_setup()
try:
return func(*args)
finally:
threading_cleanup(*key)
return decorator
def reap_children():
"""Use this function at the end of test_main() whenever sub-processes
are started. This will help ensure that no extra children (zombies)
stick around to hog resources and create problems when looking
for refleaks.
"""
# Reap all our dead child processes so we don't leave zombies around.
# These hog resources and might be causing some of the buildbots to die.
if hasattr(os, 'waitpid'):
any_process = -1
while True:
try:
# This will raise an exception on Windows. That's ok.
pid, status = os.waitpid(any_process, os.WNOHANG)
if pid == 0:
break
except:
break
@contextlib.contextmanager
def swap_attr(obj, attr, new_val):
"""Temporary swap out an attribute with a new object.
Usage:
with swap_attr(obj, "attr", 5):
...
This will set obj.attr to 5 for the duration of the with: block,
restoring the old value at the end of the block. If `attr` doesn't
exist on `obj`, it will be created and then deleted at the end of the
block.
"""
if hasattr(obj, attr):
real_val = getattr(obj, attr)
setattr(obj, attr, new_val)
try:
yield
finally:
setattr(obj, attr, real_val)
else:
setattr(obj, attr, new_val)
try:
yield
finally:
delattr(obj, attr)
@contextlib.contextmanager
def swap_item(obj, item, new_val):
"""Temporary swap out an item with a new object.
Usage:
with swap_item(obj, "item", 5):
...
This will set obj["item"] to 5 for the duration of the with: block,
restoring the old value at the end of the block. If `item` doesn't
exist on `obj`, it will be created and then deleted at the end of the
block.
"""
if item in obj:
real_val = obj[item]
obj[item] = new_val
try:
yield
finally:
obj[item] = real_val
else:
obj[item] = new_val
try:
yield
finally:
del obj[item]
def strip_python_stderr(stderr):
"""Strip the stderr of a Python process from potential debug output
emitted by the interpreter.
This will typically be run on the result of the communicate() method
of a subprocess.Popen object.
"""
stderr = re.sub(br"\[\d+ refs\]\r?\n?", b"", stderr).strip()
return stderr
def args_from_interpreter_flags():
"""Return a list of command-line arguments reproducing the current
settings in sys.flags and sys.warnoptions."""
return subprocess._args_from_interpreter_flags()
#============================================================
# Support for assertions about logging.
#============================================================
class TestHandler(logging.handlers.BufferingHandler):
def __init__(self, matcher):
# BufferingHandler takes a "capacity" argument
# so as to know when to flush. As we're overriding
# shouldFlush anyway, we can set a capacity of zero.
# You can call flush() manually to clear out the
# buffer.
logging.handlers.BufferingHandler.__init__(self, 0)
self.matcher = matcher
def shouldFlush(self):
return False
def emit(self, record):
self.format(record)
self.buffer.append(record.__dict__)
def matches(self, **kwargs):
"""
Look for a saved dict whose keys/values match the supplied arguments.
"""
result = False
for d in self.buffer:
if self.matcher.matches(d, **kwargs):
result = True
break
return result
class Matcher(object):
_partial_matches = ('msg', 'message')
def matches(self, d, **kwargs):
"""
Try to match a single dict with the supplied arguments.
Keys whose values are strings and which are in self._partial_matches
will be checked for partial (i.e. substring) matches. You can extend
this scheme to (for example) do regular expression matching, etc.
"""
result = True
for k in kwargs:
v = kwargs[k]
dv = d.get(k)
if not self.match_value(k, dv, v):
result = False
break
return result
def match_value(self, k, dv, v):
"""
Try to match a single stored value (dv) with a supplied value (v).
"""
if type(v) != type(dv):
result = False
elif type(dv) is not str or k not in self._partial_matches:
result = (v == dv)
else:
result = dv.find(v) >= 0
return result
_can_symlink = None
def can_symlink():
global _can_symlink
if _can_symlink is not None:
return _can_symlink
symlink_path = TESTFN + "can_symlink"
try:
os.symlink(TESTFN, symlink_path)
can = True
except (OSError, NotImplementedError, AttributeError):
can = False
else:
os.remove(symlink_path)
_can_symlink = can
return can
def skip_unless_symlink(test):
"""Skip decorator for tests that require functional symlink"""
ok = can_symlink()
msg = "Requires functional symlink implementation"
return test if ok else unittest.skip(msg)(test)
_can_xattr = None
def can_xattr():
global _can_xattr
if _can_xattr is not None:
return _can_xattr
if not hasattr(os, "setxattr"):
can = False
else:
tmp_fp, tmp_name = tempfile.mkstemp()
try:
with open(TESTFN, "wb") as fp:
try:
# TESTFN & tempfile may use different file systems with
# different capabilities
os.setxattr(tmp_fp, b"user.test", b"")
os.setxattr(fp.fileno(), b"user.test", b"")
# Kernels < 2.6.39 don't respect setxattr flags.
kernel_version = platform.release()
m = re.match("2.6.(\d{1,2})", kernel_version)
can = m is None or int(m.group(1)) >= 39
except OSError:
can = False
finally:
unlink(TESTFN)
unlink(tmp_name)
_can_xattr = can
return can
def skip_unless_xattr(test):
"""Skip decorator for tests that require functional extended attributes"""
ok = can_xattr()
msg = "no non-broken extended attribute support"
return test if ok else unittest.skip(msg)(test)
if sys.platform.startswith('win'):
@contextlib.contextmanager
def suppress_crash_popup():
"""Disable Windows Error Reporting dialogs using SetErrorMode."""
# see http://msdn.microsoft.com/en-us/library/windows/desktop/ms680621%28v=vs.85%29.aspx
# GetErrorMode is not available on Windows XP and Windows Server 2003,
# but SetErrorMode returns the previous value, so we can use that
import ctypes
k32 = ctypes.windll.kernel32
SEM_NOGPFAULTERRORBOX = 0x02
old_error_mode = k32.SetErrorMode(SEM_NOGPFAULTERRORBOX)
k32.SetErrorMode(old_error_mode | SEM_NOGPFAULTERRORBOX)
try:
yield
finally:
k32.SetErrorMode(old_error_mode)
else:
# this is a no-op for other platforms
@contextlib.contextmanager
def suppress_crash_popup():
yield
def patch(test_instance, object_to_patch, attr_name, new_value):
"""Override 'object_to_patch'.'attr_name' with 'new_value'.
Also, add a cleanup procedure to 'test_instance' to restore
'object_to_patch' value for 'attr_name'.
The 'attr_name' should be a valid attribute for 'object_to_patch'.
"""
# check that 'attr_name' is a real attribute for 'object_to_patch'
# will raise AttributeError if it does not exist
getattr(object_to_patch, attr_name)
# keep a copy of the old value
attr_is_local = False
try:
old_value = object_to_patch.__dict__[attr_name]
except (AttributeError, KeyError):
old_value = getattr(object_to_patch, attr_name, None)
else:
attr_is_local = True
# restore the value when the test is done
def cleanup():
if attr_is_local:
setattr(object_to_patch, attr_name, old_value)
else:
delattr(object_to_patch, attr_name)
test_instance.addCleanup(cleanup)
# actually override the attribute
setattr(object_to_patch, attr_name, new_value)
PK 5Du\��� future/backports/test/pystone.pynu �[��� #!/usr/bin/env python3
"""
"PYSTONE" Benchmark Program
Version: Python/1.1 (corresponds to C/1.1 plus 2 Pystone fixes)
Author: Reinhold P. Weicker, CACM Vol 27, No 10, 10/84 pg. 1013.
Translated from ADA to C by Rick Richardson.
Every method to preserve ADA-likeness has been used,
at the expense of C-ness.
Translated from C to Python by Guido van Rossum.
Version History:
Version 1.1 corrects two bugs in version 1.0:
First, it leaked memory: in Proc1(), NextRecord ends
up having a pointer to itself. I have corrected this
by zapping NextRecord.PtrComp at the end of Proc1().
Second, Proc3() used the operator != to compare a
record to None. This is rather inefficient and not
true to the intention of the original benchmark (where
a pointer comparison to None is intended; the !=
operator attempts to find a method __cmp__ to do value
comparison of the record). Version 1.1 runs 5-10
percent faster than version 1.0, so benchmark figures
of different versions can't be compared directly.
"""
from __future__ import print_function
from time import clock
LOOPS = 50000
__version__ = "1.1"
[Ident1, Ident2, Ident3, Ident4, Ident5] = range(1, 6)
class Record(object):
def __init__(self, PtrComp = None, Discr = 0, EnumComp = 0,
IntComp = 0, StringComp = 0):
self.PtrComp = PtrComp
self.Discr = Discr
self.EnumComp = EnumComp
self.IntComp = IntComp
self.StringComp = StringComp
def copy(self):
return Record(self.PtrComp, self.Discr, self.EnumComp,
self.IntComp, self.StringComp)
TRUE = 1
FALSE = 0
def main(loops=LOOPS):
benchtime, stones = pystones(loops)
print("Pystone(%s) time for %d passes = %g" % \
(__version__, loops, benchtime))
print("This machine benchmarks at %g pystones/second" % stones)
def pystones(loops=LOOPS):
return Proc0(loops)
IntGlob = 0
BoolGlob = FALSE
Char1Glob = '\0'
Char2Glob = '\0'
Array1Glob = [0]*51
Array2Glob = [x[:] for x in [Array1Glob]*51]
PtrGlb = None
PtrGlbNext = None
def Proc0(loops=LOOPS):
global IntGlob
global BoolGlob
global Char1Glob
global Char2Glob
global Array1Glob
global Array2Glob
global PtrGlb
global PtrGlbNext
starttime = clock()
for i in range(loops):
pass
nulltime = clock() - starttime
PtrGlbNext = Record()
PtrGlb = Record()
PtrGlb.PtrComp = PtrGlbNext
PtrGlb.Discr = Ident1
PtrGlb.EnumComp = Ident3
PtrGlb.IntComp = 40
PtrGlb.StringComp = "DHRYSTONE PROGRAM, SOME STRING"
String1Loc = "DHRYSTONE PROGRAM, 1'ST STRING"
Array2Glob[8][7] = 10
starttime = clock()
for i in range(loops):
Proc5()
Proc4()
IntLoc1 = 2
IntLoc2 = 3
String2Loc = "DHRYSTONE PROGRAM, 2'ND STRING"
EnumLoc = Ident2
BoolGlob = not Func2(String1Loc, String2Loc)
while IntLoc1 < IntLoc2:
IntLoc3 = 5 * IntLoc1 - IntLoc2
IntLoc3 = Proc7(IntLoc1, IntLoc2)
IntLoc1 = IntLoc1 + 1
Proc8(Array1Glob, Array2Glob, IntLoc1, IntLoc3)
PtrGlb = Proc1(PtrGlb)
CharIndex = 'A'
while CharIndex <= Char2Glob:
if EnumLoc == Func1(CharIndex, 'C'):
EnumLoc = Proc6(Ident1)
CharIndex = chr(ord(CharIndex)+1)
IntLoc3 = IntLoc2 * IntLoc1
IntLoc2 = IntLoc3 / IntLoc1
IntLoc2 = 7 * (IntLoc3 - IntLoc2) - IntLoc1
IntLoc1 = Proc2(IntLoc1)
benchtime = clock() - starttime - nulltime
if benchtime == 0.0:
loopsPerBenchtime = 0.0
else:
loopsPerBenchtime = (loops / benchtime)
return benchtime, loopsPerBenchtime
def Proc1(PtrParIn):
PtrParIn.PtrComp = NextRecord = PtrGlb.copy()
PtrParIn.IntComp = 5
NextRecord.IntComp = PtrParIn.IntComp
NextRecord.PtrComp = PtrParIn.PtrComp
NextRecord.PtrComp = Proc3(NextRecord.PtrComp)
if NextRecord.Discr == Ident1:
NextRecord.IntComp = 6
NextRecord.EnumComp = Proc6(PtrParIn.EnumComp)
NextRecord.PtrComp = PtrGlb.PtrComp
NextRecord.IntComp = Proc7(NextRecord.IntComp, 10)
else:
PtrParIn = NextRecord.copy()
NextRecord.PtrComp = None
return PtrParIn
def Proc2(IntParIO):
IntLoc = IntParIO + 10
while 1:
if Char1Glob == 'A':
IntLoc = IntLoc - 1
IntParIO = IntLoc - IntGlob
EnumLoc = Ident1
if EnumLoc == Ident1:
break
return IntParIO
def Proc3(PtrParOut):
global IntGlob
if PtrGlb is not None:
PtrParOut = PtrGlb.PtrComp
else:
IntGlob = 100
PtrGlb.IntComp = Proc7(10, IntGlob)
return PtrParOut
def Proc4():
global Char2Glob
BoolLoc = Char1Glob == 'A'
BoolLoc = BoolLoc or BoolGlob
Char2Glob = 'B'
def Proc5():
global Char1Glob
global BoolGlob
Char1Glob = 'A'
BoolGlob = FALSE
def Proc6(EnumParIn):
EnumParOut = EnumParIn
if not Func3(EnumParIn):
EnumParOut = Ident4
if EnumParIn == Ident1:
EnumParOut = Ident1
elif EnumParIn == Ident2:
if IntGlob > 100:
EnumParOut = Ident1
else:
EnumParOut = Ident4
elif EnumParIn == Ident3:
EnumParOut = Ident2
elif EnumParIn == Ident4:
pass
elif EnumParIn == Ident5:
EnumParOut = Ident3
return EnumParOut
def Proc7(IntParI1, IntParI2):
IntLoc = IntParI1 + 2
IntParOut = IntParI2 + IntLoc
return IntParOut
def Proc8(Array1Par, Array2Par, IntParI1, IntParI2):
global IntGlob
IntLoc = IntParI1 + 5
Array1Par[IntLoc] = IntParI2
Array1Par[IntLoc+1] = Array1Par[IntLoc]
Array1Par[IntLoc+30] = IntLoc
for IntIndex in range(IntLoc, IntLoc+2):
Array2Par[IntLoc][IntIndex] = IntLoc
Array2Par[IntLoc][IntLoc-1] = Array2Par[IntLoc][IntLoc-1] + 1
Array2Par[IntLoc+20][IntLoc] = Array1Par[IntLoc]
IntGlob = 5
def Func1(CharPar1, CharPar2):
CharLoc1 = CharPar1
CharLoc2 = CharLoc1
if CharLoc2 != CharPar2:
return Ident1
else:
return Ident2
def Func2(StrParI1, StrParI2):
IntLoc = 1
while IntLoc <= 1:
if Func1(StrParI1[IntLoc], StrParI2[IntLoc+1]) == Ident1:
CharLoc = 'A'
IntLoc = IntLoc + 1
if CharLoc >= 'W' and CharLoc <= 'Z':
IntLoc = 7
if CharLoc == 'X':
return TRUE
else:
if StrParI1 > StrParI2:
IntLoc = IntLoc + 7
return TRUE
else:
return FALSE
def Func3(EnumParIn):
EnumLoc = EnumParIn
if EnumLoc == Ident3: return TRUE
return FALSE
if __name__ == '__main__':
import sys
def error(msg):
print(msg, end=' ', file=sys.stderr)
print("usage: %s [number_of_loops]" % sys.argv[0], file=sys.stderr)
sys.exit(100)
nargs = len(sys.argv) - 1
if nargs > 1:
error("%d arguments are too many;" % nargs)
elif nargs == 1:
try: loops = int(sys.argv[1])
except ValueError:
error("Invalid argument %r;" % sys.argv[1])
else:
loops = LOOPS
main(loops)
PK :Du\d�|� � 9 future/backports/test/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d Z dS )a
test package backported for python-future.
Its primary purpose is to allow use of "import test.support" for running
the Python standard library unit tests using the new Python 3 stdlib
import location.
Python 3 renamed test.test_support to test.support.
N)�__doc__� r r �H/usr/local/lib/python3.9/site-packages/future/backports/test/__init__.py�<module> � PK =Du\#( �S S 8 future/backports/test/__pycache__/pystone.cpython-39.pycnu �[��� a
��?h � @ s� d Z ddlmZ ddlmZ dZdZedd�\ZZ Z
Z Z G dd � d e
�ZdZdZefd
d �Zefd d
�Zdaeadadadgd add� tgd D �adadaefdd�Zdd� Z dd� Z dd� Z dd � Z d d � Z d d � Z!d!d"� Z"d#d$� Z#d%d&� Z$d'd(� Z%d)d*� Z&e'd+k�r�ddl(Z(d,d-� Z)e*e(j+�d Z,e,dk�rBe)d.e, � nJe,dk�r�ze-e(j+d �Z.W n& e/�y� e)d/e(j+d � Y n0 neZ.ee.� dS )0a�
"PYSTONE" Benchmark Program
Version: Python/1.1 (corresponds to C/1.1 plus 2 Pystone fixes)
Author: Reinhold P. Weicker, CACM Vol 27, No 10, 10/84 pg. 1013.
Translated from ADA to C by Rick Richardson.
Every method to preserve ADA-likeness has been used,
at the expense of C-ness.
Translated from C to Python by Guido van Rossum.
Version History:
Version 1.1 corrects two bugs in version 1.0:
First, it leaked memory: in Proc1(), NextRecord ends
up having a pointer to itself. I have corrected this
by zapping NextRecord.PtrComp at the end of Proc1().
Second, Proc3() used the operator != to compare a
record to None. This is rather inefficient and not
true to the intention of the original benchmark (where
a pointer comparison to None is intended; the !=
operator attempts to find a method __cmp__ to do value
comparison of the record). Version 1.1 runs 5-10
percent faster than version 1.0, so benchmark figures
of different versions can't be compared directly.
� )�print_function)�clockiP� z1.1� � c @ s e Zd Zddd�Zdd� ZdS )�RecordNr c C s" || _ || _|| _|| _|| _d S �N)�PtrComp�Discr�EnumComp�IntComp�
StringComp)�selfr r r
r r � r �G/usr/local/lib/python3.9/site-packages/future/backports/test/pystone.py�__init__/ s
zRecord.__init__c C s t | j| j| j| j| j�S r )r r r r
r r )r
r r r �copy7 s �z Record.copy)Nr r r r )�__name__�
__module__� __qualname__r r r r r r r - s �
r c C s. t | �\}}tdt| |f � td| � d S )Nz#Pystone(%s) time for %d passes = %gz-This machine benchmarks at %g pystones/second)�pystones�print� __version__)�loops� benchtimeZstonesr r r �main> s
�r c C s t | �S r )�Proc0)r r r r r E s r � �3 c C s g | ]}|d d � �qS r r )�.0�xr r r �
<listcomp>M � r Nc
C s^ t � }t| �D ]}qt � | }t� at� att_tt_tt_ dt_
dt_ d}dt d d< t � }t| �D ]�}t
� t� d}d}d }t}t||� a||k r�d
| | } t||�} |d }q�ttt || � tt�ad }
|
tk�r|t|
d
�kr�tt�}tt|
�d �}
q�|| } | | }d| | | }t|�}qft � | | } | dk�rNd} n| | } | | fS )N�( z DHRYSTONE PROGRAM, SOME STRINGz DHRYSTONE PROGRAM, 1'ST STRING�
� � � � z DHRYSTONE PROGRAM, 2'ND STRING� r �A�Cg ) r �ranger �
PtrGlbNext�PtrGlbr �Ident1r �Ident3r
r r �
Array2Glob�Proc5�Proc4�Ident2�Func2�BoolGlob�Proc7�Proc8�
Array1Glob�Proc1� Char2Glob�Func1�Proc6�chr�ord�Proc2)
r Z starttime�iZnulltimeZ
String1LocZIntLoc1ZIntLoc2Z
String2Loc�EnumLocZIntLoc3Z CharIndexr ZloopsPerBenchtimer r r r Q sT
r c C sv t �� | _}d| _| j|_| j|_t|j�|_|jtkrdd|_t| j�|_t j|_t |jd�|_n|�� } d |_| S )Nr( r r# )
r- r r r �Proc3r r. r< r
r6 )ZPtrParInZ
NextRecordr r r r9 � s
r9 c C s4 | d }t dkr$|d }|t } t}|tkrq0q| S )Nr# r) r )� Char1Glob�IntGlobr. )ZIntParIO�IntLocrA r r r r? � s r? c C s$ t d urt j} ndatdt�t _| S )N�d r# )r- r rD r6 r )Z PtrParOutr r r rB � s
rB c C s t dk} | pt} dad S )Nr) �B)rC r5 r: )ZBoolLocr r r r2 � s r2 c C s da tad S )Nr) )rC �FALSEr5 r r r r r1 � s r1 c C sb | }t | �st}| tkr t}n@| tkr:tdkr4t}q^t}n$| tkrHt}n| tkrRn | tkr^t}|S )NrF )�Func3�Ident4r. r3 rD r/ �Ident5)� EnumParInZ
EnumParOutr r r r< � s r< c C s | d }|| }|S )Nr& r )�IntParI1�IntParI2rE Z IntParOutr r r r6 � s r6 c C s� |d }|| |< | | | |d < || |d < t ||d �D ]}||| |< q:|| |d d || |d < | | ||d |< dad S )Nr( r � r& � )r+ rD )Z Array1ParZ Array2ParrM rN rE ZIntIndexr r r r7 � s r7 c C s | }|}||krt S tS d S r )r. r3 )ZCharPar1ZCharPar2ZCharLoc1ZCharLoc2r r r r; � s
r; c C sp d}|dkr4t | | ||d �tkrd}|d }q|dkrH|dkrHd}|dkrTtS | |krh|d }tS tS d S )Nr r) �W�Zr% �X)r; r. �TRUErH )ZStrParI1ZStrParI2rE ZCharLocr r r r4 � s
r4 c C s | }|t krtS tS r )r/ rT rH )rL rA r r r rI � s rI �__main__c C s6 t | dtjd� t dtjd tjd� t�d� d S )N� )�end�filezusage: %s [number_of_loops]r )rX rF )r �sys�stderr�argv�exit)�msgr r r �error s r^ z%d arguments are too many;zInvalid argument %r;)0�__doc__�
__future__r �timer ZLOOPSr r+ r. r3 r/ rJ rK �objectr rT rH r r rD r5 rC r: r8 r0 r- r, r r9 r? rB r2 r1 r< r6 r7 r; r4 rI r rY r^ �lenr[ �nargs�intr �
ValueErrorr r r r �<module> sT
:
PK ADu\����� �� 8 future/backports/test/__pycache__/support.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZmZmZmZ ddlmZ ddlm Z m
Z
m Z m Z m
Z
mZ ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZeed�s�ddlZddl Z ddl Z ddl Z ddl Z z ddl Z W n e!y� ddl"m Z Y n0 ddl#Z#ddl$Z%ddl&Z&ddl'Z'z.ej(�r:ddl)Z)ddl*Z*nddl+Z)ddl*Z*W n e!�yh dZ)dZ*Y n0 z ddl,Z-W n e!�y� dZ-Y n0 z ddl.Z.W n e!�y� dZ.Y n0 z ddl/Z/W n e!�y� dZ/Y n0 z ddl0Z0W n e!�y dZ0Y n0 z ddl1Z1W n e!�y& dZ1Y n0 g d�Z2G d d
� d
e3�Z4G d d � d e4�Z5G d
d� dej6�Z7ej8d�dd��Z9d�dd�Z:dd� Z;dd� Z<dd� Z=d�d d �Z>d d � Z?d Z@dZAdaBdaCdZDdZEdaFd!d"� ZGd#d$� ZHd%d&� ZIej�Jd'��r d�d(d)�ZKd*d+� ZLd,d-� ZMd.d/� ZNnejOZLejPZMejQZNd0d1� ZOd2d3� ZPd4d5� ZQej�Jd'��r^ddlRZRddlSZRd6d7� ZTnd8d7� ZTd9d:� ZUd�d;d<�ZVd=d>� ZWd?d@� ZXdAdB� ZYdCdD� ZZdEZ[dFZ\ej]ej^fdGdH�Z_e[fdIdJ�Z`dKdL� Zaea� ZbdMZcdNZde�ee.dO�Zfe�ee0dP�Zge�ee1dQ�Zhej�JdR�ZiejjdRk�rdSZkndTZkdU�leke�m� �Zke�n� Zoej8d�dWdX��ZpeedY��r\ej8dZd[� �Zqerdfd\d]�Zsd^d_� Ztd`da� Zudbdc� Zvddde� Zwdfdg� ZxG dhdi� diey�Zzd�djdk�Z{ej8dldm� �Z|G dndo� doey�Z}ej(�r�ddl~Zej�j�Z�nddl�Z�e�j�Z�G dpdq� dqe��Z�G drds� dsey�Z�G dtdu� duey�Z�e�e�ej�dv�Z�e�ej�ej�dv�Z�e�e�ej�dv�Z�ej8d�dxdy��Z�ej8dzd{� �Z�d|d}� Z�d~d� Z�d�d�� Z�d�d�� Z�ej8d�d�� �Z�d�d�� Z�d�Z�d�Z�eed���r�d�e� Z�d�Z�e�d� Z�d�d�� Z�d�d�� Z�d�Z�d�Z�d�d�� Z�d�d�� Z�d�d�� Z�d�Z�d�e� Z�d�e� Z�d�e� Z�ej�Z�d�d�� Z�G d�d�� d�ey�Z�d�d�d��Z�d�d�� Z�G d�d�� d�ey�Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�d�d�� Z�d�dÄ Z�d�dń Z�d�dDŽ Z�d�dɄ Z�d�d˄ Z�ej8d�d̈́ �Z�ej8d�dτ �Z�d�dф Z�d�dӄ Z�G d�dՄ d�e%j�jÃZ�G d�dׄ d�ey�Z�da�d�dل Z�d�dۄ Z�da�d�d݄ Z�d�d߄ Z�ej�Jd'��r�ej8d�d� �Z�nej8d�d� �Z�d�d� Z�dS )�zwSupporting definitions for the Python regression tests.
Backported for python-future from Python 3.3 test/support.py.
� )�absolute_import�division�print_function�unicode_literals)�utils)�str�range�open�int�map�listN�skip)� sysconfig)J�Error�
TestFailed�ResourceDenied�
import_module�verbose�
use_resources�
max_memuse�record_original_stdout�get_original_stdout�unload�unlink�rmtreeZforget�is_resource_enabled�requires�requires_freebsd_version�requires_linux_version�requires_mac_ver�find_unused_port� bind_port� IPV6_ENABLED� is_jython�TESTFN�HOST�SAVEDCWD�temp_cwd�findfile�create_empty_file�sortdict�check_syntax_error�open_urlresource�check_warnings� CleanImport�EnvironmentVarGuard�TransientResource�captured_stdout�captured_stdin�captured_stderr�time_out�socket_peer_reset�ioerror_peer_reset�run_with_locale�
temp_umask�transient_internet� set_memlimit�
bigmemtest�bigaddrspacetest�BasicTestRunner� run_unittest� run_doctest�threading_setup�threading_cleanup�
reap_children� cpython_only�check_impl_detail�
get_attribute� swap_item� swap_attrZrequires_IEEE_754� TestHandler�Matcher� can_symlink�skip_unless_symlink�skip_unless_xattr�import_fresh_module�
requires_zlib�
PIPE_MAX_SIZE�failfast�anticipate_failure� run_with_tzZ
requires_gzip� requires_bz2�
requires_lzma�suppress_crash_popupc @ s e Zd ZdZdS )r z*Base class for regression test exceptions.N��__name__�
__module__� __qualname__�__doc__� r[ r[ �G/usr/local/lib/python3.9/site-packages/future/backports/test/support.pyr a s r c @ s e Zd ZdZdS )r z Test failed.NrV r[ r[ r[ r\ r d s r c @ s e Zd ZdZdS )r z�Test skipped because it requested a disallowed resource.
This is raised when a test calls requires() for a resource that
has not be enabled. It is used to distinguish between expected
and unexpected skips.
NrV r[ r[ r[ r\ r g s r Tc c sL | rBt �� �$ t �ddt� dV W d � qH1 s60 Y ndV dS )z�Context manager to suppress package and module deprecation
warnings when importing them.
If ignore is False, this context manager has no effect.�ignorez.+ (module|package)N)�warnings�catch_warnings�filterwarnings�DeprecationWarning)r] r[ r[ r\ �_ignore_deprecated_importso s
�&rb Fc C sz t |��^ zt�| �W W d � S tyV } zt�t|���W Y d}~n
d}~0 0 W d � n1 sl0 Y dS )z�Import and return the module to be tested, raising SkipTest if
it is not available.
If deprecated is True, any module or package deprecation messages
will be suppressed.N)rb � importlibr � ImportError�unittest�SkipTestr )�name�
deprecated�msgr[ r[ r\ r ~ s
r c C sZ | t jvrt| � t j| = tt j�D ]0}|| ks>|�| d �r$t j| ||< t j|= q$dS )zyHelper function to save and remove a module from sys.modules
Raise ImportError if the module can't be imported.
�.N)�sys�modules�
__import__r �
startswith)rg � orig_modules�modnamer[ r[ r\ �_save_and_remove_module� s
rq c C s< d}zt j| || < W n ty, d}Y n0 dt j| < |S )z�Helper function to save and block a module in sys.modules
Return True if the module was in sys.modules, False otherwise.
TFN�rk rl �KeyError)rg ro Zsavedr[ r[ r\ �_save_and_block_module� s
rt c C s | r
t jS dd� S )z�Decorator to mark a test that is known to be broken in some cases
Any use of this decorator should have a comment identifying the
associated tracker issue.
c S s | S �Nr[ ��fr[ r[ r\ �<lambda>� � z$anticipate_failure.<locals>.<lambda>)re ZexpectedFailure)� conditionr[ r[ r\ rQ � s rQ r[ c C s� t |��� i }g }t| |� z�z@|D ]}t||� q$|D ]}t||�s8|�|� q8t�| �}W n tyt d}Y n0 W |�� D ]\} }
|
tj | < q�|D ] } tj | = q�n0|�� D ]\} }
|
tj | < q�|D ] } tj | = q�0 |W d � S 1 s�0 Y dS )aV Import and return a module, deliberately bypassing sys.modules.
This function imports and returns a fresh copy of the named Python module
by removing the named module from sys.modules before doing the import.
Note that unlike reload, the original module is not affected by
this operation.
*fresh* is an iterable of additional module names that are also removed
from the sys.modules cache before doing the import.
*blocked* is an iterable of module names that are replaced with None
in the module cache during the import to ensure that attempts to import
them raise ImportError.
The named module and any modules named in the *fresh* and *blocked*
parameters are saved before starting the import and then reinserted into
sys.modules when the fresh import is complete.
Module and package deprecation messages are suppressed during this import
if *deprecated* is True.
This function will raise ImportError if the named module cannot be
imported.
If deprecated is True, any module or package deprecation messages
will be suppressed.
N)
rb rq rt �appendrc r rd �itemsrk rl ) rg ZfreshZblockedrh ro Znames_to_removeZ
fresh_nameZ blocked_nameZ fresh_moduleZ orig_name�moduleZname_to_remover[ r[ r\ rM � s,
� rM c C s< zt | |�}W n$ ty2 t�d| |f ��Y n0 |S dS )z?Get an attribute, raising SkipTest if AttributeError is raised.z object %r has no attribute %rN)�getattr�AttributeErrorre rf )�objrg � attributer[ r[ r\ rE � s
rE � c C s | a d S ru )�_original_stdout)�stdoutr[ r[ r\ r � s r c C s
t ptjS ru )r� rk r� r[ r[ r[ r\ r � s r c C s$ z t j| = W n ty Y n0 d S ru rr )rg r[ r[ r\ r s r �winc C s� | |� |r|}nt j�|�\}}|p(d}d}|dk rjt �|�}|rJ|sVn||v sVd S t�|� |d9 }q.tjd| tdd� d S )Nrj g����MbP?g �?� z)tests may fail, delete still pending for � ��
stacklevel) �os�path�split�listdir�time�sleepr^ �warn�RuntimeWarning)�func�pathname�waitall�dirnamerg �timeout�Lr[ r[ r\ �_waitfor s
�r� c C s t tj| � d S ru )r� r� r )�filenamer[ r[ r\ �_unlink* s r� c C s t tj| � d S ru �r� r� �rmdir)r� r[ r[ r\ �_rmdir- s r� c s* � fdd�� t � | dd� t tj| � d S )Nc sR t �| �D ]B}t j�| |�}t j�|�rBt� |dd� t �|� q
t �|� q
d S )NT�r� )r� r� r� �join�isdirr� r� r )r� rg �fullname��
_rmtree_innerr[ r\ r� 1 s z _rmtree.<locals>._rmtree_innerTr� r� )r� r[ r� r\ �_rmtree0 s r� c
C sJ z t | � W n8 tyD } z |jtjtjfvr0� W Y d }~n
d }~0 0 d S ru )r� �OSError�errno�ENOENT�ENOTDIR)r� �errorr[ r[ r\ r @ s
r c
C sD z t | � W n2 ty> } z|jtjkr*� W Y d }~n
d }~0 0 d S ru )r� r� r� r� )r� r� r[ r[ r\ r� H s
r� c
C sD z t | � W n2 ty> } z|jtjkr*� W Y d }~n
d }~0 0 d S ru )r� r� r� r� )r� r� r[ r[ r\ r P s
r c C s� d} d}G dd� dt j�}t jj}|�� }|s6t �� �|� }t j�� }|�|| t � |�t �
|�t � |��}|svt �� �t |j |@ �S )Nr� c @ s. e Zd ZdejjfdejjfdejjfgZdS )z*_is_gui_available.<locals>.USEROBJECTFLAGSZfInheritZ fReserved�dwFlagsN)rW rX rY �ctypes�wintypesZBOOL�DWORD�_fields_r[ r[ r[ r\ �USEROBJECTFLAGS` s
�r� )
r� � Structure�windllZuser32ZGetProcessWindowStationZWinErrorr� r� ZGetUserObjectInformationW�byref�sizeof�boolr� )Z UOI_FLAGSZ WSF_VISIBLEr� �dll�hZuof�needed�resr[ r[ r\ �_is_gui_available] s$
�r� c C s dS )NTr[ r[ r[ r[ r\ r� s s c C s t duo| t v S )zPTest whether a resource is enabled. Known resources are set by
regrtest.py.N)r ��resourcer[ r[ r\ r v s r c C sV | dkrt � st�d��t�d�j�d�dkr2dS t| �sR|du rJd| }t|��dS )z�Raise ResourceDenied if the specified resource is not available.
If the caller's module is __main__ then automatically return True. The
possibility of False being returned occurs when regrtest.py is
executing.
�guiz Cannot use the 'gui' resourcer� rW �__main__Nz"Use of the %r resource not enabled) r� re rf rk � _getframe� f_globals�getr r )r� ri r[ r[ r\ r { s
r c s � �fdd�}|S )z�Decorator raising SkipTest if the OS is `sysname` and the version is less
than `min_version`.
For example, @_requires_unix_version('FreeBSD', (7, 2)) raises SkipTest if
the FreeBSD version is less than 7.2.
c s$ t �� �� ��fdd��}�|_|S )Nc s� t �� �krxt �� �dd�d }zttt|�d���}W n tyJ Y n.0 |�k rxd�tt ���}t
� d�||f ��� | i |��S )N�-r� r rj z(%s version %s or higher required, not %s) �platform�system�releaser� �tupler r
�
ValueErrorr� r re rf ��args�kwZ version_txt�versionZmin_version_txt)r� � min_version�sysnamer[ r\ �wrapper� s ��z:_requires_unix_version.<locals>.decorator.<locals>.wrapper�� functools�wrapsr� �r� r� �r� r� �r� r\ � decorator� s z)_requires_unix_version.<locals>.decoratorr[ )r� r� r� r[ r� r\ �_requires_unix_version� s r� c G s
t d| �S )z�Decorator raising SkipTest if the OS is FreeBSD and the FreeBSD version is
less than `min_version`.
For example, @requires_freebsd_version(7, 2) raises SkipTest if the FreeBSD
version is less than 7.2.
ZFreeBSD�r� �r� r[ r[ r\ r � s r c G s
t d| �S )z�Decorator raising SkipTest if the OS is Linux and the Linux version is
less than `min_version`.
For example, @requires_linux_version(2, 6, 32) raises SkipTest if the Linux
version is less than 2.6.32.
�Linuxr� r� r[ r[ r\ r � s r c s � fdd�}|S )z�Decorator raising SkipTest if the OS is Mac OS X and the OS X
version if less than min_version.
For example, @requires_mac_ver(10, 5) raises SkipTest if the OS X version
is lesser than 10.5.
c s" t �� �� �fdd��}�|_|S )Nc sz t jdkrlt�� d }zttt|�d���}W n ty@ Y n,0 |�k rld�tt ���}t
� d||f ��� | i |��S )N�darwinr rj z&Mac OS X %s or higher required, not %s) rk r� �mac_verr� r r
r� r� r� r re rf r� )r� r� r[ r\ r� � s
��z4requires_mac_ver.<locals>.decorator.<locals>.wrapperr� r� r� r� r\ r� � s z#requires_mac_ver.<locals>.decoratorr[ )r� r� r[ r� r\ r � s r z 127.0.0.1�::1c C s" t � | |�}t|�}|�� ~|S )a�
Returns an unused port that should be suitable for binding. This is
achieved by creating a temporary socket with the same family and type as
the 'sock' parameter (default is AF_INET, SOCK_STREAM), and binding it to
the specified host address (defaults to 0.0.0.0) with the port set to 0,
eliciting an unused ephemeral port from the OS. The temporary socket is
then closed and deleted, and the ephemeral port is returned.
Either this method or bind_port() should be used for any tests where a
server socket needs to be bound to a particular port for the duration of
the test. Which one to use depends on whether the calling code is creating
a python socket, or if an unused port needs to be provided in a constructor
or passed to an external program (i.e. the -accept argument to openssl's
s_server mode). Always prefer bind_port() over find_unused_port() where
possible. Hard coded ports should *NEVER* be used. As soon as a server
socket is bound to a hard coded port, the ability to run multiple instances
of the test simultaneously on the same host is compromised, which makes the
test a ticking time bomb in a buildbot environment. On Unix buildbots, this
may simply manifest as a failed test, which can be recovered from without
intervention in most cases, but on Windows, the entire python process can
completely and utterly wedge, requiring someone to log in to the buildbot
and manually kill the affected process.
(This is easy to reproduce on Windows, unfortunately, and can be traced to
the SO_REUSEADDR socket option having different semantics on Windows versus
Unix/Linux. On Unix, you can't have two AF_INET SOCK_STREAM sockets bind,
listen and then accept connections on identical host/ports. An EADDRINUSE
socket.error will be raised at some point (depending on the platform and
the order bind and listen were called on each socket).
However, on Windows, if SO_REUSEADDR is set on the sockets, no EADDRINUSE
will ever be raised when attempting to bind two identical host/ports. When
accept() is called on each socket, the second caller's process will steal
the port from the first caller, leaving them both in an awkwardly wedged
state where they'll no longer respond to any signals or graceful kills, and
must be forcibly killed via OpenProcess()/TerminateProcess().
The solution on Windows is to use the SO_EXCLUSIVEADDRUSE socket option
instead of SO_REUSEADDR, which effectively affords the same semantics as
SO_REUSEADDR on Unix. Given the propensity of Unix developers in the Open
Source world compared to Windows ones, this is a common mistake. A quick
look over OpenSSL's 0.9.8g source shows that they use SO_REUSEADDR when
openssl.exe is called with the 's_server' option, for example. See
http://bugs.python.org/issue2550 for more info. The following site also
has a very thorough description about the implications of both REUSEADDR
and EXCLUSIVEADDRUSE on Windows:
http://msdn2.microsoft.com/en-us/library/ms740621(VS.85).aspx)
XXX: although this approach is a vast improvement on previous attempts to
elicit unused ports, it rests heavily on the assumption that the ephemeral
port returned to us by the OS won't immediately be dished back out to some
other process when we close and delete our temporary socket but before our
calling code has a chance to bind the returned port. We can deal with this
issue if/when we come across it.
)�socketr! �close)�family�socktypeZtempsock�portr[ r[ r\ r � s
8 r c C s� | j tjkr�| jtjkr�ttd�r>| �tjtj�dkr>t d��ttd�r~z | �tjtj
�dkrft d��W n tj y| Y n0 ttd�r�| � tjtj
d� | �|df� | �� d }|S )a% Bind the socket to a free port and return the port number. Relies on
ephemeral ports in order to ensure we are using an unbound port. This is
important as many tests may be running simultaneously, especially in a
buildbot environment. This method raises an exception if the sock.family
is AF_INET and sock.type is SOCK_STREAM, *and* the socket has SO_REUSEADDR
or SO_REUSEPORT set on it. Tests should *never* set these socket options
for TCP/IP sockets. The only case for setting these options is testing
multicasting via multiple UDP sockets.
Additionally, if the SO_EXCLUSIVEADDRUSE socket option is available (i.e.
on Windows), it will be set on the socket. This will prevent anyone else
from bind()'ing to our host/port for the duration of the test.
� SO_REUSEADDRr� zHtests should never set the SO_REUSEADDR socket option on TCP/IP sockets!� SO_REUSEPORTzHtests should never set the SO_REUSEPORT socket option on TCP/IP sockets!�SO_EXCLUSIVEADDRUSEr )r� r� �AF_INET�type� SOCK_STREAM�hasattr�
getsockopt�
SOL_SOCKETr� r r� r� �
setsockoptr� �bind� getsockname)�sock�hostr� r[ r[ r\ r! s
r! c C sx t jrtd} zZz.t � t jt j�} | �d� W W | r8| �� dS t jt jfyT Y n0 W | rt| �� n| rr| �� 0 dS )z+Check whether IPv6 is enabled on this host.N)r� r TF)r� �has_ipv6�AF_INET6r� r� r� r� �gaierror)r� r[ r[ r\ �_is_ipv6_enabled> s
�
�
r� i @ i z
requires zlibz requires bz2z
requires lzma�javaz$testz@testz {0}_{1}_tmp�tempcwdc c s� t �� }d}|du rX| }zt �| � d}W n, tyV |s>� tjd| tdd� Y n0 zt �|� W n, ty� |sz� tjd| tdd� Y n0 z$t �� V W t �|� |r�t| � nt �|� |r�t| � 0 dS )a�
Context manager that temporarily changes the CWD.
An existing path may be provided as *path*, in which case this
function makes no changes to the file system.
Otherwise, the new CWD is created in the current directory and it's
named *name*. If *quiet* is False (default) and it's not possible to
create or change the CWD, an error is raised. If it's True, only a
warning is raised and the original CWD is used.
FNTz*tests may fail, unable to create temp CWD � r� z,tests may fail, unable to change the CWD to ) r� �getcwd�mkdirr� r^ r� r� �chdirr )rg �quietr� Z saved_dirZ is_temporaryr[ r[ r\ r' � s:
�
�
�
r' �umaskc c s0 t �| �}zdV W t �|� n t �|� 0 dS )z8Context manager that temporarily sets the process umask.N)r� r� )r� Zoldmaskr[ r[ r\ r8 s
r8 c C sn t j�| �r| S |dur&t j�|| �} tj}t j�|�g| }|D ]&}t j�|| �}t j�|�rB| S qB| S )z�Try to find a file on sys.path and the working directory. If it is not
found the argument passed to the function is returned (this does not
necessarily signal failure; could still be the legitimate path).N)r� r� �isabsr� rk r� �exists)�file�here�subdirr� �dn�fnr[ r[ r\ r( & s r( c C s( t �| t jt jB t jB �}t �|� dS )z>Create an empty file. If the file already exists, truncate it.N)r� r �O_WRONLY�O_CREAT�O_TRUNCr� )r� �fdr[ r[ r\ r) 5 s r) c C s, t | �� �}dd� |D �}d�|�}d| S )z%Like repr(dict), but in sorted order.c S s g | ] }d | �qS )z%r: %rr[ )�.0�pairr[ r[ r\ �
<listcomp>= ry z sortdict.<locals>.<listcomp>z, z{%s})�sortedr| r� )�dictr| Z reprpairsZ
withcommasr[ r[ r\ r* : s
r* c C s< t td�} z| �� W | �� tt� S | �� tt� 0 dS )z`
Create an invalid file descriptor by opening and closing a file and return
its fd.
�wbN)r r$ �filenor� r �r� r[ r[ r\ � make_bad_fdA s
� �r c C s | � tt|dd� d S )Nz
<test string>�exec)� assertRaises� SyntaxError�compile)ZtestcaseZ statementr[ r[ r\ r+ M s
�r+ c s4 ddl m}m} ��dd ��|�| �d �d�d }tj�tj� t
�d|�}� ��fdd �}tj� |�r�||�}|d ur||S t |� t
d
� td | t� d � |j| d
d�}zVt|d��0} |�� }
|
r�| �|
� |�� }
q�W d � n1 s�0 Y W |�� n
|�� 0 ||�}|d u�r$|S td| ��d S )Nr )�request�parse�checkr� �/����datac sD t | g� �R i ���}�d u r"|S �|�r8|�d� |S |�� d S �Nr )r �seekr� )r rw �r� r r� r[ r\ �check_valid_file[ s
z*open_urlresource.<locals>.check_valid_fileZurlfetchz fetching %s ...r
� )r� r zinvalid resource %r)Zfuture.backports.urllibr r �pop�urlparser� r� r� r� r� �__file__r� r r �printr �urlopenr �read�writer� r ) �urlr� r� Zurllib_request� urllib_parser� r r rw �out�sr[ r r\ r, Q s0
*
r, c @ s4 e Zd ZdZdd� Zdd� Zedd� �Zdd � Zd
S ) �WarningsRecorderzyConvenience wrapper for the warnings list returned on
entry to the warnings.catch_warnings() context manager.
c C s || _ d| _d S r �� _warnings�_last)�selfZ
warnings_listr[ r[ r\ �__init__� s zWarningsRecorder.__init__c C sD t | j�| jkr t| jd |�S |tjjv r0d S td| |f ��d S )Nr z%r has no attribute %r)�lenr+ r, r~ r^ �WarningMessage�_WARNING_DETAILSr )r- �attrr[ r[ r\ � __getattr__� s
z WarningsRecorder.__getattr__c C s | j | jd � S ru r* �r- r[ r[ r\ r^ � s zWarningsRecorder.warningsc C s t | j�| _d S ru )r/ r+ r, r4 r[ r[ r\ �reset� s zWarningsRecorder.resetN) rW rX rY rZ r. r3 �propertyr^ r5 r[ r[ r[ r\ r) ~ s
r) c c s6 t �d�}|j�d�}|rDtjr*|�� ntt|��D ] }|� � q6t
j dd��*}t j d �
d� t|�V W d � n1 s�0 Y t|�}g }| D ]j\}} d}
|dd� D ]8}|j} t�|t| �tj�r�t| j| �r�d}
|�|� q�|
s�|s�|�|| jf� q�|�r td |d
��|�r2td |d
��dS ) z�Catch the warnings, then check if all the expected
warnings have been raised and re-raise unexpected warnings.
If 'quiet' is True, only re-raise the unexpected warnings.
r� Z__warningregistry__T)�recordr^ �alwaysNFzunhandled warning %sr z)filter (%r, %s) did not catch any warning)rk r� r� r� r �PY3�clearr r/ r r^ r_ rl � simplefilterr) r �message�re�matchr �I�
issubclass� __class__�remover{ rW �AssertionError) �filtersr� �frame�registry�i�w�reraise�missingri �cat�seen�warningr[ r[ r\ �_filterwarnings� s:
(
� �rN c O s. |� d�}| s$dtff} |du r$d}t| |�S )a� Context manager to silence warnings.
Accept 2-tuples as positional arguments:
("message regexp", WarningCategory)
Optional argument:
- if 'quiet' is True, it does not fail if a filter catches nothing
(default True without argument,
default False if some filters are defined)
Without argument, it defaults to:
check_warnings(("", Warning), quiet=True)
r� � NT)r� �WarningrN )rD �kwargsr� r[ r[ r\ r- � s
r- c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r. a, Context manager to force import to return a new module reference.
This is useful for testing module-level behaviours, such as
the emission of a DeprecationWarning on import.
Use like this:
with CleanImport("foo"):
importlib.import_module("foo") # new reference
c G sJ t j�� | _|D ]4}|t jv rt j| }|j|kr<t j|j= t j|= qd S ru )rk rl �copy�original_modulesrW )r- Z module_names� module_namer} r[ r[ r\ r. � s
zCleanImport.__init__c C s | S ru r[ r4 r[ r[ r\ � __enter__� s zCleanImport.__enter__c G s t j�| j� d S ru )rk rl �updaterS �r- �
ignore_excr[ r[ r\ �__exit__� s zCleanImport.__exit__N�rW rX rY rZ r. rU rY r[ r[ r[ r\ r. � s
r. c @ sh e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS )r/ z_Class to help protect the environment variable properly. Can be used as
a context manager.c C s t j| _i | _d S ru )r� �environ�_environ�_changedr4 r[ r[ r\ r. s z EnvironmentVarGuard.__init__c C s
| j | S ru )r\ �r- �envvarr[ r[ r\ � __getitem__
s z EnvironmentVarGuard.__getitem__c C s* || j vr | j�|�| j |< || j|< d S ru �r] r\ r� �r- r_ �valuer[ r[ r\ � __setitem__
s
z EnvironmentVarGuard.__setitem__c C s2 || j vr | j�|�| j |< || jv r.| j|= d S ru ra r^ r[ r[ r\ � __delitem__ s
z EnvironmentVarGuard.__delitem__c C s
| j �� S ru )r\ �keysr4 r[ r[ r\ rf s zEnvironmentVarGuard.keysc C s
t | j�S ru )�iterr\ r4 r[ r[ r\ �__iter__ s z EnvironmentVarGuard.__iter__c C s
t | j�S ru )r/ r\ r4 r[ r[ r\ �__len__ s zEnvironmentVarGuard.__len__c C s || |< d S ru r[ rb r[ r[ r\ �set# s zEnvironmentVarGuard.setc C s
| |= d S ru r[ r^ r[ r[ r\ �unset& s zEnvironmentVarGuard.unsetc C s | S ru r[ r4 r[ r[ r\ rU ) s z EnvironmentVarGuard.__enter__c G sF | j �� D ].\}}|d u r.|| jv r8| j|= q
|| j|< q
| jt_d S ru )r] r| r\ r� r[ )r- rX �k�vr[ r[ r\ rY , s
z EnvironmentVarGuard.__exit__N)rW rX rY rZ r. r` rd re rf rh ri rj rk rU rY r[ r[ r[ r\ r/ s r/ c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �
DirsOnSysPatha� Context manager to temporarily add directories to sys.path.
This makes a copy of sys.path, appends any directories given
as positional arguments, then reverts sys.path to the copied
settings when the context ends.
Note that *all* sys.path modifications in the body of the
context manager, including replacement of the object,
will be reverted at the end of the block.
c G s( t jd d � | _t j| _t j�|� d S ru )rk r� �original_value�original_object�extend)r- �pathsr[ r[ r\ r. B s zDirsOnSysPath.__init__c C s | S ru r[ r4 r[ r[ r\ rU G s zDirsOnSysPath.__enter__c G s | j t_| jtjd d �< d S ru )rp rk r� ro rW r[ r[ r\ rY J s zDirsOnSysPath.__exit__NrZ r[ r[ r[ r\ rn 6 s rn c @ s* e Zd ZdZdd� Zdd� Zd dd�ZdS )
r0 z�Raise ResourceDenied if an exception is raised while the context manager
is in effect that matches the specified exception and attributes.c K s || _ || _d S ru )�exc�attrs)r- rs rQ r[ r[ r\ r. T s zTransientResource.__init__c C s | S ru r[ r4 r[ r[ r\ rU X s zTransientResource.__enter__Nc C sT |durPt | j|�rP| j�� D ](\}}t||�s4 qPt||�|kr qPq td��dS )z�If type_ is a subclass of self.exc and value has attributes matching
self.attrs, raise ResourceDenied. Otherwise let the exception
propagate (if any).Nz%an optional resource is not available)r@ rs rt r| r� r~ r )r- �type_rc � tracebackr2 �
attr_valuer[ r[ r\ rY [ s
zTransientResource.__exit__)NNNrZ r[ r[ r[ r\ r0 O s r0 )r� � >@c
# s g d�}g d�}t d| ��|� g �� sDdd� |D �� dd� |D ��� ��fdd�}t�� }z�z |d urrt�|� d V W n� ty� } zh|j}t|�d
kr�t|d t�r�|d }q�t|�d kr�t|d
t�r�|d
}q�q�q�||� � W Y d }~n
d }~0 0 W t�|� n t�|� 0 d S )
z�Return a context manager that raises ResourceDenied when various issues
with the Internet connection manifest themselves as exceptions.))Z ECONNREFUSED�o )�
ECONNRESET�h )Z EHOSTUNREACH�q )Z ENETUNREACH�e )� ETIMEDOUT�n ))� EAI_AGAIN���)�EAI_FAIL���)�
EAI_NONAME���)�
EAI_NODATA���)Z
WSANO_DATAi�* z Resource %r is not availablec S s g | ]\}}t t||��qS r[ )r~ r� �r rg �numr[ r[ r\ r � s �z&transient_internet.<locals>.<listcomp>c S s g | ]\}}t t||��qS r[ )r~ r� r� r[ r[ r\ r � s �c s` t | dd �}t| tj�s4t| tj�r,|�v s4|� v r\tsNtj��j d d � �}| |_
|�d S )Nr� r �
) r~ �
isinstancer� r� r� r rk �stderrr$ r� � __cause__)�err�nrs �Zcaptured_errnosZdeniedZ
gai_errnosr[ r\ � filter_error� s
���z(transient_internet.<locals>.filter_errorNr� r r� )r r� �getdefaulttimeout�setdefaulttimeout�IOErrorr� r/ r� ) �
resource_namer� ZerrnosZdefault_errnosZdefault_gai_errnosr� Z old_timeoutr� �ar[ r� r\ r9 p s8 ��
r9 c
c sR ddl }tt| �}tt| |�� � z tt| �V W tt| |� ntt| |� 0 dS )z�Return a context manager used by captured_stdout/stdin/stderr
that temporarily replaces the sys stream *stream_name* with a StringIO.r N)�ior~ rk �setattr�StringIO)� stream_namer� � orig_stdoutr[ r[ r\ �captured_output� s
r� c C s t d�S )z�Capture the output of sys.stdout:
with captured_stdout() as s:
print("hello")
self.assertEqual(s.getvalue(), "hello")
r� �r� r[ r[ r[ r\ r1 � s r1 c C s t d�S )Nr� r� r[ r[ r[ r\ r3 � s r3 c C s t d�S )N�stdinr� r[ r[ r[ r\ r2 � s r2 c C s* t �� trt�d� t �� t �� dS )a� Force as many objects as possible to be collected.
In non-CPython implementations of Python, this is needed because timely
deallocation is not guaranteed by the garbage collector. (Even in CPython
this can be the case in case of reference cycles.) This means that __del__
methods may be called later than expected and weakrefs may remain alive for
longer than expected. This function tries its best to force all garbage
objects to disappear.
皙�����?N)�gcZcollectr# r� r� r[ r[ r[ r\ �
gc_collect� s
r� c c s: t �� } t �� zd V W | r6t �� n| r4t �� 0 d S ru )r� � isenabled�disable�enable)Zhave_gcr[ r[ r\ �
disable_gc� s
�r� c C sF ddl } | �d�pd}d}|�� D ]}|�d�r"|}q"|dkoD|dkS )z,Find if Python was built with optimizations.r N� PY_CFLAGSrO z-Oz-O0)r �get_config_varr� rn )r �cflagsZ final_opt�optr[ r[ r\ �python_is_optimized� s
r� ZnPZ0n�gettotalrefcountZ2PZ0Pr� c C s t �t| t �S ru )�struct�calcsize�_header�_align��fmtr[ r[ r\ � calcobjsize� s r� c C s t �t| t �S ru )r� r� �_vheaderr� r� r[ r[ r\ � calcvobjsize s r� i @ i c C sh t �|�}t|�tkr |jt@ s:t|�tkrDt|�jt@ rD|tj7 }dt|�||f }| �|||� d S )Nz&wrong size for %s: got %d, expected %d) rk � getsizeofr� � __flags__�_TPFLAGS_HEAPTYPE�_TPFLAGS_HAVE_GCZ _testcapiZSIZEOF_PYGC_HEAD� assertEqual)�test�o�size�resultri r[ r[ r\ � check_sizeof s
� �
�r� c s � �fdd�}|S )Nc s$ �� �fdd�}� j |_ � j|_|S )Nc
s� z dd l }t|� �}|�|�}W n& ty4 � Y nB d }}Y n00 �D ](}z|�||� W qvW qL Y qL0 qLz&�| i |��W |r�|r�|�||� S n|r�|r�|�||� 0 d S r )�localer~ � setlocaler )r� �kwdsr� �categoryZ orig_locale�loc)�catstrr� �localesr[ r\ �inner s.
� �z1run_with_locale.<locals>.decorator.<locals>.inner�rW rZ �r� r� �r� r� r� r\ r� s z"run_with_locale.<locals>.decoratorr[ )r� r� r� r[ r� r\ r7 s r7 c s � fdd�}|S )Nc s" � �fdd�}� j |_ � j|_|S )Nc s� z
t j}W n ty& t�d��Y n0 dtjv r>tjd }nd }�tjd< |� zH� | i |��W |d u rttjd= n
|tjd< t �� S |tjd< t �� n&|d u r�tjd= n
|tjd< t �� 0 d S )Nztzset requiredZTZ)r� �tzsetr re rf r� r[ )r� r� r� Zorig_tz)r� �tzr[ r\ r� = s0
�
�
z-run_with_tz.<locals>.decorator.<locals>.innerr� r� �r� r� r\ r� < s z run_with_tz.<locals>.decoratorr[ )r� r� r[ r� r\ rR ; s rR i � r� r� c C s� dt tdt d�}t�d| tjtjB �}|d u r>td| f ��tt|� d��||� d��
� �}|a |t krrt }|t
d k r�td| f ��|ad S )Nr� )rl �m�g�tz(\d+(\.\d+)?) (K|M|G|T)b?$zInvalid memory limit %rr� r� z$Memory limit %r too low to be useful)�_1M�_1Gr= r> �
IGNORECASE�VERBOSEr� r
�float�group�lower�real_max_memuse�MAX_Py_ssize_t�_2Gr )�limit�sizesr� �memlimitr[ r[ r\ r: e s" �
�$ r: c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �_MemoryWatchdogz`An object which periodically watches the process' memory consumption
and prints it out.
c C s dj t�� d�| _d| _d S )Nz/proc/{pid}/statm)�pidF)�formatr� �getpid�procfile�startedr4 r[ r[ r\ r. s z_MemoryWatchdog.__init__c
C s� zt | jd�}W nB tyR } z*t�d�|�t� tj� � W Y d }~d S d }~0 0 t
d�}t j tj
|g|t jd�| _|�� d| _d S )N�rz"/proc not available for stats: {0}zmemory_watchdog.py)r� r� T)r r� r� r^ r� r� r� rk r� �flushr( �
subprocess�Popen�
executable�DEVNULL� mem_watchdogr� r� )r- rw �eZwatchdog_scriptr[ r[ r\ �start� s �
�z_MemoryWatchdog.startc C s | j r| j�� | j�� d S ru )r� r� � terminate�waitr4 r[ r[ r\ �stop� s
z_MemoryWatchdog.stopN)rW rX rY rZ r. r� r� r[ r[ r[ r\ r� z s r� c s � ��fdd�}|S )aA Decorator for bigmem tests.
'minsize' is the minimum useful size for the test (in arbitrary,
test-interpreted units.) 'memuse' is the number of 'bytes per size' for
the test, or a good estimate of it.
if 'dry_run' is False, it means the test doesn't support dummy runs
when -M is not specified.
c s �� �fdd����_ ��_�S )Nc s� �j }�j}tsd}n|}ts"� sDt|| k rDt�d|| d ��trztrzt� tdj|| d d�� t� }|� � nd }z�| |�W |r�|�
� S n|r�|�
� 0 d S )Ni �'not enough memory: %.1fG minimum needed� @z* ... expected peak memory use: {peak:.1f}G)Zpeak) r� �memuser� re rf r r! r� r� r� r� )r- r� r� �maxsizeZwatchdog)�dry_runrw r� r[ r\ r� � s<
�
��
�
� �z.bigmemtest.<locals>.decorator.<locals>.wrapper)r� r� rv �r� r� r� �rw r� r\ r� � s z bigmemtest.<locals>.decoratorr[ )r� r� r� r� r[ r� r\ r; � s
!r; c s � fdd�}|S )z0Decorator for tests that fill the address space.c sD t tk r8tdkr$t dkr$t�d��q@t�dtd ��n� | �S d S )Nl ���� l z-not enough memory: try a 32-bit build insteadr� r� )r r� re rf r4 rv r[ r\ r� � s ���z!bigaddrspacetest.<locals>.wrapperr[ r� r[ rv r\ r< � s r< c @ s e Zd Zdd� ZdS )r= c C s t �� }||� |S ru )re Z
TestResult)r- r� r� r[ r[ r\ �run� s zBasicTestRunner.runN)rW rX rY r� r[ r[ r[ r\ r= � s r= c C s | S ru r[ )r� r[ r[ r\ �_id� s r� c C s8 | dkrt � st�d�S t| �r$tS t�d�| ��S d S )Nr� z resource 'gui' is not availablez resource {0!r} is not enabled)r� re r
r r� r� r� r[ r[ r\ �requires_resource� s
r� c C s t dd�| �S )z9
Decorator for tests only applicable on CPython.
T)�cpython)� impl_detail�r� r[ r[ r\ rC � s rC c K sZ t f i |��rtS | d u rPt|�\}}|r0d} nd} t|�� �}| �d�|��} t�| �S )Nz*implementation detail not available on {0}z%implementation detail specific to {0}z or ) rD r� �
_parse_guardsr rf r� r� re r
)ri �guardsZ
guardnames�defaultr[ r[ r\ r� � s r� c C sH | sddidfS t | �� �d }t | �� �|gt| � ks>J �| | fS )Nr� TFr )r �valuesr/ )r� Zis_truer[ r[ r\ r� � s
r� c K s t | �\} }| �t�� �� |�S )a5 This function returns True or False depending on the host platform.
Examples:
if check_impl_detail(): # only on CPython (default)
if check_impl_detail(jython=True): # only on Jython
if check_impl_detail(cpython=False): # everywhere except on CPython
)r� r� r� �python_implementationr� )r� r� r[ r[ r\ rD s rD c s, t td�s� S t�� �� fdd��}|S dS )zEDecorator to temporarily turn off tracing for the duration of a test.�gettracec s> t �� }z$t �d � � | i |��W t �|� S t �|� 0 d S ru )rk r �settrace)r� rQ Zoriginal_tracer� r[ r\ r� s
�zno_tracing.<locals>.wrapperN)r� rk r� r� r� r[ r� r\ �
no_tracing s
r c C s t t| ��S )a Decorator for tests which involve reference counting.
To start, the decorator does not run the test if is not run by CPython.
After that, any trace function is unset during the test to prevent
unexpected refcounts caused by the trace function.
)r rC r� r[ r[ r\ �
refcount_test s r c C sN g }| j D ]8}t|tj�r0t||� |�|� q
||�r
|�|� q
|| _ dS )z>Recursively filter test cases in a suite based on a predicate.N)Z_testsr� re � TestSuite�
_filter_suiter{ )�suite�predZnewtestsr� r[ r[ r\ r + s
r c C s� t rtjtjdtd�}nt� }|�| �}|�� s�t |j
�dkrT|j sT|j
d d }n4t |j �dkrx|j
sx|j d d }nd}t s�|d7 }t |��dS )z2Run tests from a unittest.TestSuite-derived class.r� )� verbosityrP r� r zmultiple errors occurredz!; run in verbose mode for detailsN)
r re ZTextTestRunnerrk r� rP r= r� Z
wasSuccessfulr/ �errorsZfailuresr )r �runnerr� r� r[ r[ r\ �
_run_suite7 s
�
r
c G s� t jt jf}t �� }| D ]`}t|t�rR|tjv rH|�t �tj| �� qxt d��qt||�rh|�|� q|�t �
|�� qdd� }t ||� t |� dS )z1Run tests from unittest.TestCase-derived classes.z)str arguments must be keys in sys.modulesc S s6 t d u r dS | �� �d�D ]}t�|t �r dS qdS )NTrj F)� match_tests�idr� �fnmatch� fnmatchcase)r� rg r[ r[ r\ � case_predY s z run_unittest.<locals>.case_predN)
re r ZTestCaser� r rk rl ZaddTestZ
findTestCasesr� Z makeSuiter r
)�classesZ valid_typesr �clsr r[ r[ r\ r> K s
r> c C s` ddl }|du rt}nd}|j| ||d�\}}|rBtd||f ��trXtd| j|f � ||fS )a Run doctest on the given module. Return (#failures, #tests).
If optional argument verbosity is not specified (or is None), pass
support's belief about verbosity on to doctest. Else doctest's
usual behavior is used (it searches sys.argv for -v).
r N)r � optionflagsz%d of %d doctests failedz,doctest (%s) ... %d tests with zero failures)�doctestr �testmodr r! rW )r} r
r r rw r� r[ r[ r\ r? r s �r? c C s t j�� fS ru )rk rl rR r[ r[ r[ r\ �
modules_setup� s r c C sN dd� t j�� D �}ttt j��D ]}t j�� q"t j�|� t j�| � d S )Nc S s" g | ]\}}|� d �r||f�qS )z
encodings.)rn )r rl rm r[ r[ r\ r � s
�z#modules_cleanup.<locals>.<listcomp>)rk rl r| r r/ r rV )Z
oldmodules� encodingsrG r[ r[ r\ �modules_cleanup� s
r c C s t rt �� fS dS d S )N)r� )�_thread�_countr[ r[ r[ r\ r@ � s
r@ c C s< t sd S d}t|�D ]"}t �� }|| kr, q8t�d� qd S )N�
r� )r r r r� r� )Z
nb_threadsZ
_MAX_COUNT�countr� r[ r[ r\ rA � s rA c s" t s� S t�� �� fdd��}|S )z�Use this function when threads are being used. This will
ensure that the threads are cleaned up even when the test fails.
If threading is unavailable this function does nothing.
c s( t � }z� | � W t|� S t|� 0 d S ru )r@ rA )r� �keyr� r[ r\ r� � s �z reap_threads.<locals>.decorator)r r� r� )r� r� r[ r� r\ � reap_threads� s
r c C sH t td�rDd} z"t�| tj�\}}|dkr.W qDW q Y qDY q0 qdS )z�Use this function at the end of test_main() whenever sub-processes
are started. This will help ensure that no extra children (zombies)
stick around to hog resources and create problems when looking
for refleaks.
�waitpidr r N)r� r� r! �WNOHANG)Z any_processr� �statusr[ r[ r\ rB � s
rB c
c sz t | |�rHt| |�}t| ||� zdV W t| ||� qvt| ||� 0 n.t| ||� zdV W t| |� n t| |� 0 dS )am Temporary swap out an attribute with a new object.
Usage:
with swap_attr(obj, "attr", 5):
...
This will set obj.attr to 5 for the duration of the with: block,
restoring the old value at the end of the block. If `attr` doesn't
exist on `obj`, it will be created and then deleted at the end of the
block.
N)r� r~ r� �delattr)r� r2 �new_val�real_valr[ r[ r\ rG � s
rG c c s^ || v r8| | }|| |< zdV W || |< qZ|| |< 0 n"|| |< zdV W | |= n| |= 0 dS )ak Temporary swap out an item with a new object.
Usage:
with swap_item(obj, "item", 5):
...
This will set obj["item"] to 5 for the duration of the with: block,
restoring the old value at the end of the block. If `item` doesn't
exist on `obj`, it will be created and then deleted at the end of the
block.
Nr[ )r� �itemr% r& r[ r[ r\ rF s
rF c C s t �dd| ��� } | S )z�Strip the stderr of a Python process from potential debug output
emitted by the interpreter.
This will typically be run on the result of the communicate() method
of a subprocess.Popen object.
s \[\d+ refs\]\r?\n?ry )r= �sub�strip)r� r[ r[ r\ �strip_python_stderr s r* c C s t �� S )znReturn a list of command-line arguments reproducing the current
settings in sys.flags and sys.warnoptions.)r� � _args_from_interpreter_flagsr[ r[ r[ r\ �args_from_interpreter_flags* s r, c @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S )
rH c C s t jj�| d� || _d S r )�logging�handlers�BufferingHandlerr. �matcher)r- r0 r[ r[ r\ r. 4 s zTestHandler.__init__c C s dS )NFr[ r4 r[ r[ r\ � shouldFlush= s zTestHandler.shouldFlushc C s | � |� | j�|j� d S ru )r� �bufferr{ �__dict__)r- r7 r[ r[ r\ �emit@ s
zTestHandler.emitc K s0 d}| j D ] }| jj|fi |��r
d} q,q
|S )zW
Look for a saved dict whose keys/values match the supplied arguments.
FT)r2 r0 �matches)r- rQ r� �dr[ r[ r\ r5 D s
zTestHandler.matchesN)rW rX rY r. r1 r4 r5 r[ r[ r[ r\ rH 3 s rH c @ s e Zd ZdZdd� Zdd� ZdS )rI )ri r< c K s: d}|D ],}|| }|� |�}| �|||�sd} q6q|S )a.
Try to match a single dict with the supplied arguments.
Keys whose values are strings and which are in self._partial_matches
will be checked for partial (i.e. substring) matches. You can extend
this scheme to (for example) do regular expression matching, etc.
TF)r� � match_value)r- r6 rQ r� rl rm �dvr[ r[ r\ r5 S s
zMatcher.matchesc C sH t |�t |�krd}n.t |�tus,|| jvr6||k}n|�|�dk}|S )zT
Try to match a single stored value (dv) with a supplied value (v).
Fr )r� r �_partial_matches�find)r- rl r8 rm r� r[ r[ r\ r7 d s
zMatcher.match_valueN)rW rX rY r9 r5 r7 r[ r[ r[ r\ rI O s rI c
C sX t d ur t S td } zt�t| � d}W n tttfyD d}Y n 0 t�| � |a |S )NrJ TF)� _can_symlinkr$ r� �symlinkr� �NotImplementedErrorr rB )Z symlink_path�canr[ r[ r\ rJ r s
rJ c C s t � }d}|r| S t�|�| �S )z8Skip decorator for tests that require functional symlinkz*Requires functional symlink implementation)rJ re r
�r� �okri r[ r[ r\ rK � s rK c C s� t d ur t S ttd�s d} n�t�� \}}z�ttd��z}zRt�|dd� t�|�� dd� t �
� }t � d|�}|d u p�t
|�d��dk} W n ty� d} Y n0 W d � n1 s�0 Y W tt� t|� ntt� t|� 0 | a | S ) N�setxattrFr s user.testry z
2.6.(\d{1,2})r� �' )�
_can_xattrr� r� �tempfile�mkstempr r$ rA r r� r� r= r> r
r� r� r )r> Ztmp_fp�tmp_name�fpZkernel_versionr� r[ r[ r\ � can_xattr� s*
*
�
rH c C s t � }d}|r| S t�|�| �S )zDSkip decorator for tests that require functional extended attributesz(no non-broken extended attribute support)rH re r
r? r[ r[ r\ rL � s rL c c sR ddl } | jj}d}|�|�}|�||B � zdV W |�|� n |�|� 0 dS )z;Disable Windows Error Reporting dialogs using SetErrorMode.r Nr� )r� r� Zkernel32Z SetErrorMode)r� Zk32ZSEM_NOGPFAULTERRORBOXZold_error_moder[ r[ r\ rU � s
rU c c s
d V d S ru r[ r[ r[ r[ r\ rU � s c sp t ��� d� z�j� �W n" ttfy> t ��d��Y n0 d� � ���fdd�}| �|� t��|� dS )z�Override 'object_to_patch'.'attr_name' with 'new_value'.
Also, add a cleanup procedure to 'test_instance' to restore
'object_to_patch' value for 'attr_name'.
The 'attr_name' should be a valid attribute for 'object_to_patch'.
FNTc s � rt ���� n
t��� d S ru )r� r$ r[ �Z
attr_is_local� attr_name�object_to_patch� old_valuer[ r\ �cleanup� s zpatch.<locals>.cleanup)r~ r3 r rs Z
addCleanupr� )Z
test_instancerK rJ � new_valuerM r[ rI r\ �patch� s
rO )T)F)r[ r[ F)F)N)r� FN)F)rx r[ )T)N)Nr )�rZ �
__future__r r r r �futurer Zfuture.builtinsr r r r
r r �
contextlibr� r� r� r� rk r� r� �shutilr^ re r� Z unittest2rc r= r� r� r rd � distutilsr �logging.handlersr- r� rD r9 r � threading�threadZmultiprocessing.process�multiprocessing�zlib�gzip�bz2�lzma�__all__� Exceptionr r rf r �contextmanagerrb r rq rt rQ rM rE r r r r� rP r r� r r r rn r� r� r� r� r r� r r� Zctypes.wintypesr� r r r� r r r r% ZHOSTv6r� r� r r! r� r" rO Z
SOCK_MAX_SIZEZ
skipUnlessrN rS rT r# rg r$ r� r� r� r& r' r8 r r( r) r* r r+ r, �objectr) rN r- r. �collections.abc� collections�abc�MutableMappingZmybase�UserDictZ DictMixinr/ rn r0 r� r~ r4 r� rz r5 r6 r9 r� r1 r3 r2 r� r� r� r� r� r� r� r� r� r� r� r7 rR r� r� r� Z_4Gr� r� r: r� r; r< r= r� r� rC r� r� rD r r r r
r> r? r r r@ rA r rB rG rF r* r, r. r/ rH rI r; rJ rK rC rH rL rU rO r[ r[ r[ r\ �<module> s�
4
!
> % } '
-
,
5 D
$#
-
'
#
"
PK DDu\��E�� � < future/backports/test/__pycache__/ssl_servers.cpython-39.pycnu �[��� a
��?h) � @ s> d dl mZmZmZmZ d dlmZmZ d dlm Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZd dlmZ d dlmZmZmZ d dlmZ e�d�Ze
j� e �Z ej Z e
j� e d �Z!G d
d � d e�Z"G d d
� d
e�Z#G dd� de�Z$G dd� dej%�Z&e!e dfdd�Z'e(dk�r:d dl)Z)e)j*dd�Z+e+j,dde-ddd� e+j,d d d d d d!d"� e+j,d#d$d%d&d'd(d"� e+j,d)d*ed+d,d-� e+j,d.d/ed+d0d-� e+�.� Z/e/j0e_0e/j1�r�e$Z2n"e#Z2e j3�r�e
�4� e2_5n
e
�6� e2_5e �7e j8�Z9e9�:e!� e/j;�r�e9�<e/j;� e/j=�re9�>e/j=� e"d1e/j?fe2e9�Z@e/j0�r0eAd2�Be/�� e@�Cd3� dS )4� )�absolute_import�division�print_function�unicode_literals)�filter�str)�utilsN)�parse)�
HTTPServer�SimpleHTTPRequestHandler�BaseHTTPRequestHandler)�support� threadingz keycert.pemc @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� HTTPSServerc C s t �| ||� || _d S �N)� _HTTPServer�__init__�context)�self�server_address�
handler_classr � r �K/usr/local/lib/python3.9/site-packages/future/backports/test/ssl_servers.pyr s zHTTPSServer.__init__c C s d| j j| j| jf S )Nz
<%s %s:%s>)� __class__�__name__Z server_name� server_port�r r r r �__str__ s ��zHTTPSServer.__str__c
C sj z"| j �� \}}| jj|dd�}W n> t jy` } z$tjrJtj� d| � � W Y d }~n
d }~0 0 ||fS )NT)� server_sidezGot an error:
%s
)
�socket�acceptr � wrap_socket�errorr
�verbose�sys�stderr�write)r �sock�addrZsslconn�er r r � get_request" s zHTTPSServer.get_requestN)r �
__module__� __qualname__r r r* r r r r r s r c @ s( e Zd ZdZeZdZdd� Zdd� ZdS )�RootedHTTPRequestHandlerz
TestHTTPS/1.0� c C sz t j�|�d }tj�t j�|��}|�d�}td|�}| j }|D ]2}tj�
|�\}}tj�|�\}}tj� ||�}qB|S )z�Translate a /-separated PATH to the local filename syntax.
Components that mean special things to the local file system
(e.g. drive or directory names) are ignored. (XXX They should
probably be diagnosed.)
� �/N) �urllibr �urlparse�os�path�normpath�unquote�splitr �root�
splitdrive�join)r r4 �words�word�drive�headr r r �translate_path8 s
z'RootedHTTPRequestHandler.translate_pathc G s: t jr6tj�d| jj| jj| j� � | �
� || f � d S )Nz server (%s:%d %s):
[%s] %s
) r
r# r$ �stdoutr& �serverr r �request�cipherZlog_date_time_string�r �format�argsr r r � log_messageL s ��z$RootedHTTPRequestHandler.log_messageN) r r+ r, �server_version�herer8 �timeoutr? rG r r r r r- . s
r- c @ s. e Zd ZdZdZd dd�Zdd� Zdd � Zd
S ) �StatsRequestHandlerzSExample HTTP request handler which returns SSL statistics on GET
requests.
zStatsHTTPS/1.0Tc C s� | j jj}|j}|�� |�� |�� d�}t�|�}|� d�}| �
d� | � dd� | � dt t
|��� | �� |r~| j�|� dS )zServe a GET request.)Z
session_cacherC � compressionzutf-8�� z Content-typeztext/plain; charset=utf-8zContent-LengthN)�rfile�raw�_sockr �
session_statsrC rL �pprint�pformat�encodeZ
send_responseZ send_headerr �lenZ end_headers�wfiler& )r � send_bodyr' r �stats�bodyr r r �do_GET^ s
�
zStatsRequestHandler.do_GETc C s | j dd� dS )zServe a HEAD request.F)rW N)rZ r r r r �do_HEADp s zStatsRequestHandler.do_HEADc G s t jrtj| |g|�R � d S r )r
r# r � log_requestrD r r r r\ t s z StatsRequestHandler.log_requestN)T)r r+ r, �__doc__rH rZ r[ r\ r r r r rK W s
rK c @ s< e Zd Zedfdd�Zdd� Zd dd�Zdd � Zd
d � ZdS )
�HTTPSServerThreadNc C s< d | _ t|df|pt|�| _| jj| _tj�| � d| _ d S )Nr T)
�flagr r- rA r �portr �Threadr �daemon)r r �hostr r r r r { s �
zHTTPSServerThread.__init__c C s d| j j| jf S )Nz<%s %s>)r r rA r r r r r � s zHTTPSServerThread.__str__c C s || _ tj�| � d S r )r_ r ra �start)r r_ r r r rd � s zHTTPSServerThread.startc C s< | j r| j �� z| j�d� W | j�� n | j�� 0 d S )Ng�������?)r_ �setrA �
serve_forever� server_closer r r r �run� s
zHTTPSServerThread.runc C s | j �� d S r )rA �shutdownr r r r �stop� s zHTTPSServerThread.stop)N) r r+ r, �HOSTr r rd rh rj r r r r r^ y s
r^ c sV t �t j�}|�|� t|||�� t�� }� �|� |�� � fdd�}| � |� � S )Nc s8 t jrtj�d� � �� t jr,tj�d� � �� d S )Nzstopping HTTPS server
zjoining HTTPS thread
)r
r# r$ r@ r& rj r: r �rA r r �cleanup� s z"make_https_server.<locals>.cleanup)
�ssl�
SSLContext�PROTOCOL_SSLv23�load_cert_chainr^ r �Eventrd �waitZ
addCleanup)Zcase�certfilerc r r r_ rm r rl r �make_https_server� s
ru �__main__zERun a test HTTPS server. By default, the current directory is served.)� descriptionz-pz--portiQ z(port to listen on (default: %(default)s))�type�default�helpz-qz--quietr# T� store_falsezbe less verbose)�destry �actionrz z-sz--stats�use_stats_handlerF�
store_truezalways return stats pagez --curve-name�
curve_name�storez&curve name for EC-based Diffie-Hellman)r| rx r} rz z--dh�dh_filez!PEM file containing DH parameters� z'Listening on https://localhost:{0.port}g�������?)D�
__future__r r r r Zfuture.builtinsr r �futurer r3 r$ rn rR r Zfuture.backports.urllibr � urllib_parseZ future.backports.http.serverr
r r r Zfuture.backports.testr
�
import_moduler r4 �dirname�__file__rI rk r: ZCERTFILEr r- rK ra r^ ru r �argparse�ArgumentParser�parser� add_argument�int�
parse_argsrF r# r~ r �PY2Zgetcwdur8 �getcwdro �PROTOCOL_TLSv1r rq r� �set_ecdh_curver� �load_dh_paramsr` rA �printrE rf r r r r �<module> st
)"
� � � �
� �
PK IDu\��|() ) $ future/backports/test/ssl_servers.pynu �[��� from __future__ import absolute_import, division, print_function, unicode_literals
from future.builtins import filter, str
from future import utils
import os
import sys
import ssl
import pprint
import socket
from future.backports.urllib import parse as urllib_parse
from future.backports.http.server import (HTTPServer as _HTTPServer,
SimpleHTTPRequestHandler, BaseHTTPRequestHandler)
from future.backports.test import support
threading = support.import_module("threading")
here = os.path.dirname(__file__)
HOST = support.HOST
CERTFILE = os.path.join(here, 'keycert.pem')
# This one's based on HTTPServer, which is based on SocketServer
class HTTPSServer(_HTTPServer):
def __init__(self, server_address, handler_class, context):
_HTTPServer.__init__(self, server_address, handler_class)
self.context = context
def __str__(self):
return ('<%s %s:%s>' %
(self.__class__.__name__,
self.server_name,
self.server_port))
def get_request(self):
# override this to wrap socket with SSL
try:
sock, addr = self.socket.accept()
sslconn = self.context.wrap_socket(sock, server_side=True)
except socket.error as e:
# socket errors are silenced by the caller, print them here
if support.verbose:
sys.stderr.write("Got an error:\n%s\n" % e)
raise
return sslconn, addr
class RootedHTTPRequestHandler(SimpleHTTPRequestHandler):
# need to override translate_path to get a known root,
# instead of using os.curdir, since the test could be
# run from anywhere
server_version = "TestHTTPS/1.0"
root = here
# Avoid hanging when a request gets interrupted by the client
timeout = 5
def translate_path(self, path):
"""Translate a /-separated PATH to the local filename syntax.
Components that mean special things to the local file system
(e.g. drive or directory names) are ignored. (XXX They should
probably be diagnosed.)
"""
# abandon query parameters
path = urllib.parse.urlparse(path)[2]
path = os.path.normpath(urllib.parse.unquote(path))
words = path.split('/')
words = filter(None, words)
path = self.root
for word in words:
drive, word = os.path.splitdrive(word)
head, word = os.path.split(word)
path = os.path.join(path, word)
return path
def log_message(self, format, *args):
# we override this to suppress logging unless "verbose"
if support.verbose:
sys.stdout.write(" server (%s:%d %s):\n [%s] %s\n" %
(self.server.server_address,
self.server.server_port,
self.request.cipher(),
self.log_date_time_string(),
format%args))
class StatsRequestHandler(BaseHTTPRequestHandler):
"""Example HTTP request handler which returns SSL statistics on GET
requests.
"""
server_version = "StatsHTTPS/1.0"
def do_GET(self, send_body=True):
"""Serve a GET request."""
sock = self.rfile.raw._sock
context = sock.context
stats = {
'session_cache': context.session_stats(),
'cipher': sock.cipher(),
'compression': sock.compression(),
}
body = pprint.pformat(stats)
body = body.encode('utf-8')
self.send_response(200)
self.send_header("Content-type", "text/plain; charset=utf-8")
self.send_header("Content-Length", str(len(body)))
self.end_headers()
if send_body:
self.wfile.write(body)
def do_HEAD(self):
"""Serve a HEAD request."""
self.do_GET(send_body=False)
def log_request(self, format, *args):
if support.verbose:
BaseHTTPRequestHandler.log_request(self, format, *args)
class HTTPSServerThread(threading.Thread):
def __init__(self, context, host=HOST, handler_class=None):
self.flag = None
self.server = HTTPSServer((host, 0),
handler_class or RootedHTTPRequestHandler,
context)
self.port = self.server.server_port
threading.Thread.__init__(self)
self.daemon = True
def __str__(self):
return "<%s %s>" % (self.__class__.__name__, self.server)
def start(self, flag=None):
self.flag = flag
threading.Thread.start(self)
def run(self):
if self.flag:
self.flag.set()
try:
self.server.serve_forever(0.05)
finally:
self.server.server_close()
def stop(self):
self.server.shutdown()
def make_https_server(case, certfile=CERTFILE, host=HOST, handler_class=None):
# we assume the certfile contains both private key and certificate
context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
context.load_cert_chain(certfile)
server = HTTPSServerThread(context, host, handler_class)
flag = threading.Event()
server.start(flag)
flag.wait()
def cleanup():
if support.verbose:
sys.stdout.write('stopping HTTPS server\n')
server.stop()
if support.verbose:
sys.stdout.write('joining HTTPS thread\n')
server.join()
case.addCleanup(cleanup)
return server
if __name__ == "__main__":
import argparse
parser = argparse.ArgumentParser(
description='Run a test HTTPS server. '
'By default, the current directory is served.')
parser.add_argument('-p', '--port', type=int, default=4433,
help='port to listen on (default: %(default)s)')
parser.add_argument('-q', '--quiet', dest='verbose', default=True,
action='store_false', help='be less verbose')
parser.add_argument('-s', '--stats', dest='use_stats_handler', default=False,
action='store_true', help='always return stats page')
parser.add_argument('--curve-name', dest='curve_name', type=str,
action='store',
help='curve name for EC-based Diffie-Hellman')
parser.add_argument('--dh', dest='dh_file', type=str, action='store',
help='PEM file containing DH parameters')
args = parser.parse_args()
support.verbose = args.verbose
if args.use_stats_handler:
handler_class = StatsRequestHandler
else:
handler_class = RootedHTTPRequestHandler
if utils.PY2:
handler_class.root = os.getcwdu()
else:
handler_class.root = os.getcwd()
context = ssl.SSLContext(ssl.PROTOCOL_TLSv1)
context.load_cert_chain(CERTFILE)
if args.curve_name:
context.set_ecdh_curve(args.curve_name)
if args.dh_file:
context.load_dh_params(args.dh_file)
server = HTTPSServer(("", args.port), handler_class, context)
if args.verbose:
print("Listening on https://localhost:{0.port}".format(args))
server.serve_forever(0.1)
PK LDu\'�q � � future/backports/test/sha256.pemnu �[��� # Certificate chain for https://sha256.tbs-internet.com
0 s:/C=FR/postalCode=14000/ST=Calvados/L=CAEN/street=22 rue de Bretagne/O=TBS INTERNET/OU=0002 440443810/OU=sha-256 production/CN=sha256.tbs-internet.com
i:/C=FR/ST=Calvados/L=Caen/O=TBS INTERNET/OU=Terms and Conditions: http://www.tbs-internet.com/CA/repository/OU=TBS INTERNET CA/CN=TBS X509 CA SGC
-----BEGIN CERTIFICATE-----
MIIGXDCCBUSgAwIBAgIRAKpVmHgg9nfCodAVwcP4siwwDQYJKoZIhvcNAQELBQAw
gcQxCzAJBgNVBAYTAkZSMREwDwYDVQQIEwhDYWx2YWRvczENMAsGA1UEBxMEQ2Fl
bjEVMBMGA1UEChMMVEJTIElOVEVSTkVUMUgwRgYDVQQLEz9UZXJtcyBhbmQgQ29u
ZGl0aW9uczogaHR0cDovL3d3dy50YnMtaW50ZXJuZXQuY29tL0NBL3JlcG9zaXRv
cnkxGDAWBgNVBAsTD1RCUyBJTlRFUk5FVCBDQTEYMBYGA1UEAxMPVEJTIFg1MDkg
Q0EgU0dDMB4XDTEyMDEwNDAwMDAwMFoXDTE0MDIxNzIzNTk1OVowgcsxCzAJBgNV
BAYTAkZSMQ4wDAYDVQQREwUxNDAwMDERMA8GA1UECBMIQ2FsdmFkb3MxDTALBgNV
BAcTBENBRU4xGzAZBgNVBAkTEjIyIHJ1ZSBkZSBCcmV0YWduZTEVMBMGA1UEChMM
VEJTIElOVEVSTkVUMRcwFQYDVQQLEw4wMDAyIDQ0MDQ0MzgxMDEbMBkGA1UECxMS
c2hhLTI1NiBwcm9kdWN0aW9uMSAwHgYDVQQDExdzaGEyNTYudGJzLWludGVybmV0
LmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKQIX/zdJcyxty0m
PM1XQSoSSifueS3AVcgqMsaIKS/u+rYzsv4hQ/qA6vLn5m5/ewUcZDj7zdi6rBVf
PaVNXJ6YinLX0tkaW8TEjeVuZG5yksGZlhCt1CJ1Ho9XLiLaP4uJ7MCoNUntpJ+E
LfrOdgsIj91kPmwjDJeztVcQCvKzhjVJA/KxdInc0JvOATn7rpaSmQI5bvIjufgo
qVsTPwVFzuUYULXBk7KxRT7MiEqnd5HvviNh0285QC478zl3v0I0Fb5El4yD3p49
IthcRnxzMKc0UhU5ogi0SbONyBfm/mzONVfSxpM+MlyvZmJqrbuuLoEDzJD+t8PU
xSuzgbcCAwEAAaOCAj4wggI6MB8GA1UdIwQYMBaAFAdEdoWTKLx/bXjSCuv6TEvf
2YIfMB0GA1UdDgQWBBT/qTGYdaj+f61c2IRFL/B1eEsM8DAOBgNVHQ8BAf8EBAMC
BaAwDAYDVR0TAQH/BAIwADA0BgNVHSUELTArBggrBgEFBQcDAQYIKwYBBQUHAwIG
CisGAQQBgjcKAwMGCWCGSAGG+EIEATBLBgNVHSAERDBCMEAGCisGAQQB5TcCBAEw
MjAwBggrBgEFBQcCARYkaHR0cHM6Ly93d3cudGJzLWludGVybmV0LmNvbS9DQS9D
UFM0MG0GA1UdHwRmMGQwMqAwoC6GLGh0dHA6Ly9jcmwudGJzLWludGVybmV0LmNv
bS9UQlNYNTA5Q0FTR0MuY3JsMC6gLKAqhihodHRwOi8vY3JsLnRicy14NTA5LmNv
bS9UQlNYNTA5Q0FTR0MuY3JsMIGmBggrBgEFBQcBAQSBmTCBljA4BggrBgEFBQcw
AoYsaHR0cDovL2NydC50YnMtaW50ZXJuZXQuY29tL1RCU1g1MDlDQVNHQy5jcnQw
NAYIKwYBBQUHMAKGKGh0dHA6Ly9jcnQudGJzLXg1MDkuY29tL1RCU1g1MDlDQVNH
Qy5jcnQwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLnRicy14NTA5LmNvbTA/BgNV
HREEODA2ghdzaGEyNTYudGJzLWludGVybmV0LmNvbYIbd3d3LnNoYTI1Ni50YnMt
aW50ZXJuZXQuY29tMA0GCSqGSIb3DQEBCwUAA4IBAQA0pOuL8QvAa5yksTbGShzX
ABApagunUGoEydv4YJT1MXy9tTp7DrWaozZSlsqBxrYAXP1d9r2fuKbEniYHxaQ0
UYaf1VSIlDo1yuC8wE7wxbHDIpQ/E5KAyxiaJ8obtDhFstWAPAH+UoGXq0kj2teN
21sFQ5dXgA95nldvVFsFhrRUNB6xXAcaj0VZFhttI0ZfQZmQwEI/P+N9Jr40OGun
aa+Dn0TMeUH4U20YntfLbu2nDcJcYfyurm+8/0Tr4HznLnedXu9pCPYj0TaddrgT
XO0oFiyy7qGaY6+qKh71yD64Y3ycCJ/HR9Wm39mjZYc9ezYwT4noP6r7Lk8YO7/q
-----END CERTIFICATE-----
1 s:/C=FR/ST=Calvados/L=Caen/O=TBS INTERNET/OU=Terms and Conditions: http://www.tbs-internet.com/CA/repository/OU=TBS INTERNET CA/CN=TBS X509 CA SGC
i:/C=SE/O=AddTrust AB/OU=AddTrust External TTP Network/CN=AddTrust External CA Root
-----BEGIN CERTIFICATE-----
MIIFVjCCBD6gAwIBAgIQXpDZ0ETJMV02WTx3GTnhhTANBgkqhkiG9w0BAQUFADBv
MQswCQYDVQQGEwJTRTEUMBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFk
ZFRydXN0IEV4dGVybmFsIFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBF
eHRlcm5hbCBDQSBSb290MB4XDTA1MTIwMTAwMDAwMFoXDTE5MDYyNDE5MDYzMFow
gcQxCzAJBgNVBAYTAkZSMREwDwYDVQQIEwhDYWx2YWRvczENMAsGA1UEBxMEQ2Fl
bjEVMBMGA1UEChMMVEJTIElOVEVSTkVUMUgwRgYDVQQLEz9UZXJtcyBhbmQgQ29u
ZGl0aW9uczogaHR0cDovL3d3dy50YnMtaW50ZXJuZXQuY29tL0NBL3JlcG9zaXRv
cnkxGDAWBgNVBAsTD1RCUyBJTlRFUk5FVCBDQTEYMBYGA1UEAxMPVEJTIFg1MDkg
Q0EgU0dDMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsgOkO3f7wzN6
rOjg45tR5vjBfzK7qmV9IBxb/QW9EEXxG+E7FNhZqQLtwGBKoSsHTnQqV75wWMk0
9tinWvftBkSpj5sTi/8cbzJfUvTSVYh3Qxv6AVVjMMH/ruLjE6y+4PoaPs8WoYAQ
ts5R4Z1g8c/WnTepLst2x0/Wv7GmuoQi+gXvHU6YrBiu7XkeYhzc95QdviWSJRDk
owhb5K43qhcvjRmBfO/paGlCliDGZp8mHwrI21mwobWpVjTxZRwYO3bd4+TGcI4G
Ie5wmHwE8F7SK1tgSqbBacKjDa93j7txKkfz/Yd2n7TGqOXiHPsJpG655vrKtnXk
9vs1zoDeJQIDAQABo4IBljCCAZIwHQYDVR0OBBYEFAdEdoWTKLx/bXjSCuv6TEvf
2YIfMA4GA1UdDwEB/wQEAwIBBjASBgNVHRMBAf8ECDAGAQH/AgEAMCAGA1UdJQQZ
MBcGCisGAQQBgjcKAwMGCWCGSAGG+EIEATAYBgNVHSAEETAPMA0GCysGAQQBgOU3
AgQBMHsGA1UdHwR0MHIwOKA2oDSGMmh0dHA6Ly9jcmwuY29tb2RvY2EuY29tL0Fk
ZFRydXN0RXh0ZXJuYWxDQVJvb3QuY3JsMDagNKAyhjBodHRwOi8vY3JsLmNvbW9k
by5uZXQvQWRkVHJ1c3RFeHRlcm5hbENBUm9vdC5jcmwwgYAGCCsGAQUFBwEBBHQw
cjA4BggrBgEFBQcwAoYsaHR0cDovL2NydC5jb21vZG9jYS5jb20vQWRkVHJ1c3RV
VE5TR0NDQS5jcnQwNgYIKwYBBQUHMAKGKmh0dHA6Ly9jcnQuY29tb2RvLm5ldC9B
ZGRUcnVzdFVUTlNHQ0NBLmNydDARBglghkgBhvhCAQEEBAMCAgQwDQYJKoZIhvcN
AQEFBQADggEBAK2zEzs+jcIrVK9oDkdDZNvhuBYTdCfpxfFs+OAujW0bIfJAy232
euVsnJm6u/+OrqKudD2tad2BbejLLXhMZViaCmK7D9nrXHx4te5EP8rL19SUVqLY
1pTnv5dhNgEgvA7n5lIzDSYs7yRLsr7HJsYPr6SeYSuZizyX1SNz7ooJ32/F3X98
RB0Mlc/E0OyOrkQ9/y5IrnpnaSora8CnUrV5XNOg+kyCz9edCyx4D5wXYcwZPVWz
8aDqquESrezPyjtfi4WRO4s/VD3HLZvOxzMrWAVYCDG9FxaOhF0QGuuG1F7F3GKV
v6prNyCl016kRl2j1UT+a7gLd8fA25A4C9E=
-----END CERTIFICATE-----
2 s:/C=SE/O=AddTrust AB/OU=AddTrust External TTP Network/CN=AddTrust External CA Root
i:/C=US/ST=UT/L=Salt Lake City/O=The USERTRUST Network/OU=http://www.usertrust.com/CN=UTN - DATACorp SGC
-----BEGIN CERTIFICATE-----
MIIEZjCCA06gAwIBAgIQUSYKkxzif5zDpV954HKugjANBgkqhkiG9w0BAQUFADCB
kzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
dHRwOi8vd3d3LnVzZXJ0cnVzdC5jb20xGzAZBgNVBAMTElVUTiAtIERBVEFDb3Jw
IFNHQzAeFw0wNTA2MDcwODA5MTBaFw0xOTA2MjQxOTA2MzBaMG8xCzAJBgNVBAYT
AlNFMRQwEgYDVQQKEwtBZGRUcnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0
ZXJuYWwgVFRQIE5ldHdvcmsxIjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENB
IFJvb3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC39xoz5vIABC05
4E5b7R+8bA/Ntfojts7emxEzl6QpTH2Tn71KvJPtAxrjj8/lbVBa1pcplFqAsEl6
2y6V/bjKvzc4LR4+kUGtcFbH8E8/6DKedMrIkFTpxl8PeJ2aQDwOrGGqXhSPnoeh
alDc15pOrwWzpnGUnHGzUGAKxxOdOAeGAqjpqGkmGJCrTLBPI6s6T4TY386f4Wlv
u9dC12tE5Met7m1BX3JacQg3s3llpFmglDf3AC8NwpJy2tA4ctsUqEXEXSp9t7TW
xO6szRNEt8kr3UMAJfphuWlqWCMRt6czj1Z1WfXNKddGtworZbbTQm8Vsrh7++/p
XVPVNFonAgMBAAGjgdgwgdUwHwYDVR0jBBgwFoAUUzLRs89/+uDxoF2FTpLSnkUd
tE8wHQYDVR0OBBYEFK29mHo0tCb3+sQmVO8DveAky1QaMA4GA1UdDwEB/wQEAwIB
BjAPBgNVHRMBAf8EBTADAQH/MBEGCWCGSAGG+EIBAQQEAwIBAjAgBgNVHSUEGTAX
BgorBgEEAYI3CgMDBglghkgBhvhCBAEwPQYDVR0fBDYwNDAyoDCgLoYsaHR0cDov
L2NybC51c2VydHJ1c3QuY29tL1VUTi1EQVRBQ29ycFNHQy5jcmwwDQYJKoZIhvcN
AQEFBQADggEBAMbuUxdoFLJRIh6QWA2U/b3xcOWGLcM2MY9USEbnLQg3vGwKYOEO
rVE04BKT6b64q7gmtOmWPSiPrmQH/uAB7MXjkesYoPF1ftsK5p+R26+udd8jkWjd
FwBaS/9kbHDrARrQkNnHptZt9hPk/7XJ0h4qy7ElQyZ42TCbTg0evmnv3+r+LbPM
+bDdtRTKkdSytaX7ARmjR3mfnYyVhzT4HziS2jamEfpr62vp3EV4FTkG101B5CHI
3C+H0be/SGB1pWLLJN47YaApIKa+xWycxOkKaSLvkTr6Jq/RW0GnOuL4OAdCq8Fb
+M5tug8EPzI0rNwEKNdwMBQmBsTkm5jVz3g=
-----END CERTIFICATE-----
3 s:/C=US/ST=UT/L=Salt Lake City/O=The USERTRUST Network/OU=http://www.usertrust.com/CN=UTN - DATACorp SGC
i:/C=US/ST=UT/L=Salt Lake City/O=The USERTRUST Network/OU=http://www.usertrust.com/CN=UTN - DATACorp SGC
-----BEGIN CERTIFICATE-----
MIIEXjCCA0agAwIBAgIQRL4Mi1AAIbQR0ypoBqmtaTANBgkqhkiG9w0BAQUFADCB
kzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
dHRwOi8vd3d3LnVzZXJ0cnVzdC5jb20xGzAZBgNVBAMTElVUTiAtIERBVEFDb3Jw
IFNHQzAeFw05OTA2MjQxODU3MjFaFw0xOTA2MjQxOTA2MzBaMIGTMQswCQYDVQQG
EwJVUzELMAkGA1UECBMCVVQxFzAVBgNVBAcTDlNhbHQgTGFrZSBDaXR5MR4wHAYD
VQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxITAfBgNVBAsTGGh0dHA6Ly93d3cu
dXNlcnRydXN0LmNvbTEbMBkGA1UEAxMSVVROIC0gREFUQUNvcnAgU0dDMIIBIjAN
BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3+5YEKIrblXEjr8uRgnn4AgPLit6
E5Qbvfa2gI5lBZMAHryv4g+OGQ0SR+ysraP6LnD43m77VkIVni5c7yPeIbkFdicZ
D0/Ww5y0vpQZY/KmEQrrU0icvvIpOxboGqBMpsn0GFlowHDyUwDAXlCCpVZvNvlK
4ESGoE1O1kduSUrLZ9emxAW5jh70/P/N5zbgnAVssjMiFdC04MwXwLLA9P4yPykq
lXvY8qdOD1R8oQ2AswkDwf9c3V6aPryuvEeKaq5xyh+xKrhfQgUL7EYw0XILyulW
bfXv33i+Ybqypa4ETLyorGkVl73v67SMvzX41MPRKA5cOp9wGDMgd8SirwIDAQAB
o4GrMIGoMAsGA1UdDwQEAwIBxjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRT
MtGzz3/64PGgXYVOktKeRR20TzA9BgNVHR8ENjA0MDKgMKAuhixodHRwOi8vY3Js
LnVzZXJ0cnVzdC5jb20vVVROLURBVEFDb3JwU0dDLmNybDAqBgNVHSUEIzAhBggr
BgEFBQcDAQYKKwYBBAGCNwoDAwYJYIZIAYb4QgQBMA0GCSqGSIb3DQEBBQUAA4IB
AQAnNZcAiosovcYzMB4p/OL31ZjUQLtgyr+rFywJNn9Q+kHcrpY6CiM+iVnJowft
Gzet/Hy+UUla3joKVAgWRcKZsYfNjGjgaQPpxE6YsjuMFrMOoAyYUJuTqXAJyCyj
j98C5OBxOvG0I3KgqgHf35g+FFCgMSa9KOlaMCZ1+XtgHI3zzVAmbQQnmt/VDUVH
KWss5nbZqSl9Mt3JNjy9rjXxEZ4du5A/EkdOjtd+D2JzHVImOBwYSf0wdJrE5SIv
2MCN7ZF6TACPcn9d2t0bi0Vr591pl6jFVkwPDPafepE39peC4N1xaf92P2BNPM/3
mfnGV/TJVTl4uix5yaaIK/QI
-----END CERTIFICATE-----
PK NDu\���; ; & future/backports/test/nullbytecert.pemnu �[��� Certificate:
Data:
Version: 3 (0x2)
Serial Number: 0 (0x0)
Signature Algorithm: sha1WithRSAEncryption
Issuer: C=US, ST=Oregon, L=Beaverton, O=Python Software Foundation, OU=Python Core Development, CN=null.python.org\x00example.org/emailAddress=python-dev@python.org
Validity
Not Before: Aug 7 13:11:52 2013 GMT
Not After : Aug 7 13:12:52 2013 GMT
Subject: C=US, ST=Oregon, L=Beaverton, O=Python Software Foundation, OU=Python Core Development, CN=null.python.org\x00example.org/emailAddress=python-dev@python.org
Subject Public Key Info:
Public Key Algorithm: rsaEncryption
Public-Key: (2048 bit)
Modulus:
00:b5:ea:ed:c9:fb:46:7d:6f:3b:76:80:dd:3a:f3:
03:94:0b:a7:a6:db:ec:1d:df:ff:23:74:08:9d:97:
16:3f:a3:a4:7b:3e:1b:0e:96:59:25:03:a7:26:e2:
88:a9:cf:79:cd:f7:04:56:b0:ab:79:32:6e:59:c1:
32:30:54:eb:58:a8:cb:91:f0:42:a5:64:27:cb:d4:
56:31:88:52:ad:cf:bd:7f:f0:06:64:1f:cc:27:b8:
a3:8b:8c:f3:d8:29:1f:25:0b:f5:46:06:1b:ca:02:
45:ad:7b:76:0a:9c:bf:bb:b9:ae:0d:16:ab:60:75:
ae:06:3e:9c:7c:31:dc:92:2f:29:1a:e0:4b:0c:91:
90:6c:e9:37:c5:90:d7:2a:d7:97:15:a3:80:8f:5d:
7b:49:8f:54:30:d4:97:2c:1c:5b:37:b5:ab:69:30:
68:43:d3:33:78:4b:02:60:f5:3c:44:80:a1:8f:e7:
f0:0f:d1:5e:87:9e:46:cf:62:fc:f9:bf:0c:65:12:
f1:93:c8:35:79:3f:c8:ec:ec:47:f5:ef:be:44:d5:
ae:82:1e:2d:9a:9f:98:5a:67:65:e1:74:70:7c:cb:
d3:c2:ce:0e:45:49:27:dc:e3:2d:d4:fb:48:0e:2f:
9e:77:b8:14:46:c0:c4:36:ca:02:ae:6a:91:8c:da:
2f:85
Exponent: 65537 (0x10001)
X509v3 extensions:
X509v3 Basic Constraints: critical
CA:FALSE
X509v3 Subject Key Identifier:
88:5A:55:C0:52:FF:61:CD:52:A3:35:0F:EA:5A:9C:24:38:22:F7:5C
X509v3 Key Usage:
Digital Signature, Non Repudiation, Key Encipherment
X509v3 Subject Alternative Name:
*************************************************************
WARNING: The values for DNS, email and URI are WRONG. OpenSSL
doesn't print the text after a NULL byte.
*************************************************************
DNS:altnull.python.org, email:null@python.org, URI:http://null.python.org, IP Address:192.0.2.1, IP Address:2001:DB8:0:0:0:0:0:1
Signature Algorithm: sha1WithRSAEncryption
ac:4f:45:ef:7d:49:a8:21:70:8e:88:59:3e:d4:36:42:70:f5:
a3:bd:8b:d7:a8:d0:58:f6:31:4a:b1:a4:a6:dd:6f:d9:e8:44:
3c:b6:0a:71:d6:7f:b1:08:61:9d:60:ce:75:cf:77:0c:d2:37:
86:02:8d:5e:5d:f9:0f:71:b4:16:a8:c1:3d:23:1c:f1:11:b3:
56:6e:ca:d0:8d:34:94:e6:87:2a:99:f2:ae:ae:cc:c2:e8:86:
de:08:a8:7f:c5:05:fa:6f:81:a7:82:e6:d0:53:9d:34:f4:ac:
3e:40:fe:89:57:7a:29:a4:91:7e:0b:c6:51:31:e5:10:2f:a4:
60:76:cd:95:51:1a:be:8b:a1:b0:fd:ad:52:bd:d7:1b:87:60:
d2:31:c7:17:c4:18:4f:2d:08:25:a3:a7:4f:b7:92:ca:e2:f5:
25:f1:54:75:81:9d:b3:3d:61:a2:f7:da:ed:e1:c6:6f:2c:60:
1f:d8:6f:c5:92:05:ab:c9:09:62:49:a9:14:ad:55:11:cc:d6:
4a:19:94:99:97:37:1d:81:5f:8b:cf:a3:a8:96:44:51:08:3d:
0b:05:65:12:eb:b6:70:80:88:48:72:4f:c6:c2:da:cf:cd:8e:
5b:ba:97:2f:60:b4:96:56:49:5e:3a:43:76:63:04:be:2a:f6:
c1:ca:a9:94
-----BEGIN CERTIFICATE-----
MIIE2DCCA8CgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBxTELMAkGA1UEBhMCVVMx
DzANBgNVBAgMBk9yZWdvbjESMBAGA1UEBwwJQmVhdmVydG9uMSMwIQYDVQQKDBpQ
eXRob24gU29mdHdhcmUgRm91bmRhdGlvbjEgMB4GA1UECwwXUHl0aG9uIENvcmUg
RGV2ZWxvcG1lbnQxJDAiBgNVBAMMG251bGwucHl0aG9uLm9yZwBleGFtcGxlLm9y
ZzEkMCIGCSqGSIb3DQEJARYVcHl0aG9uLWRldkBweXRob24ub3JnMB4XDTEzMDgw
NzEzMTE1MloXDTEzMDgwNzEzMTI1MlowgcUxCzAJBgNVBAYTAlVTMQ8wDQYDVQQI
DAZPcmVnb24xEjAQBgNVBAcMCUJlYXZlcnRvbjEjMCEGA1UECgwaUHl0aG9uIFNv
ZnR3YXJlIEZvdW5kYXRpb24xIDAeBgNVBAsMF1B5dGhvbiBDb3JlIERldmVsb3Bt
ZW50MSQwIgYDVQQDDBtudWxsLnB5dGhvbi5vcmcAZXhhbXBsZS5vcmcxJDAiBgkq
hkiG9w0BCQEWFXB5dGhvbi1kZXZAcHl0aG9uLm9yZzCCASIwDQYJKoZIhvcNAQEB
BQADggEPADCCAQoCggEBALXq7cn7Rn1vO3aA3TrzA5QLp6bb7B3f/yN0CJ2XFj+j
pHs+Gw6WWSUDpybiiKnPec33BFawq3kyblnBMjBU61ioy5HwQqVkJ8vUVjGIUq3P
vX/wBmQfzCe4o4uM89gpHyUL9UYGG8oCRa17dgqcv7u5rg0Wq2B1rgY+nHwx3JIv
KRrgSwyRkGzpN8WQ1yrXlxWjgI9de0mPVDDUlywcWze1q2kwaEPTM3hLAmD1PESA
oY/n8A/RXoeeRs9i/Pm/DGUS8ZPINXk/yOzsR/XvvkTVroIeLZqfmFpnZeF0cHzL
08LODkVJJ9zjLdT7SA4vnne4FEbAxDbKAq5qkYzaL4UCAwEAAaOB0DCBzTAMBgNV
HRMBAf8EAjAAMB0GA1UdDgQWBBSIWlXAUv9hzVKjNQ/qWpwkOCL3XDALBgNVHQ8E
BAMCBeAwgZAGA1UdEQSBiDCBhYIeYWx0bnVsbC5weXRob24ub3JnAGV4YW1wbGUu
Y29tgSBudWxsQHB5dGhvbi5vcmcAdXNlckBleGFtcGxlLm9yZ4YpaHR0cDovL251
bGwucHl0aG9uLm9yZwBodHRwOi8vZXhhbXBsZS5vcmeHBMAAAgGHECABDbgAAAAA
AAAAAAAAAAEwDQYJKoZIhvcNAQEFBQADggEBAKxPRe99SaghcI6IWT7UNkJw9aO9
i9eo0Fj2MUqxpKbdb9noRDy2CnHWf7EIYZ1gznXPdwzSN4YCjV5d+Q9xtBaowT0j
HPERs1ZuytCNNJTmhyqZ8q6uzMLoht4IqH/FBfpvgaeC5tBTnTT0rD5A/olXeimk
kX4LxlEx5RAvpGB2zZVRGr6LobD9rVK91xuHYNIxxxfEGE8tCCWjp0+3ksri9SXx
VHWBnbM9YaL32u3hxm8sYB/Yb8WSBavJCWJJqRStVRHM1koZlJmXNx2BX4vPo6iW
RFEIPQsFZRLrtnCAiEhyT8bC2s/Njlu6ly9gtJZWSV46Q3ZjBL4q9sHKqZQ=
-----END CERTIFICATE-----
PK QDu\��|G� � future/backports/test/nokia.pemnu �[��� # Certificate for projects.developer.nokia.com:443 (see issue 13034)
-----BEGIN CERTIFICATE-----
MIIFLDCCBBSgAwIBAgIQLubqdkCgdc7lAF9NfHlUmjANBgkqhkiG9w0BAQUFADCB
vDELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQL
ExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTswOQYDVQQLEzJUZXJtcyBvZiB1c2Ug
YXQgaHR0cHM6Ly93d3cudmVyaXNpZ24uY29tL3JwYSAoYykxMDE2MDQGA1UEAxMt
VmVyaVNpZ24gQ2xhc3MgMyBJbnRlcm5hdGlvbmFsIFNlcnZlciBDQSAtIEczMB4X
DTExMDkyMTAwMDAwMFoXDTEyMDkyMDIzNTk1OVowcTELMAkGA1UEBhMCRkkxDjAM
BgNVBAgTBUVzcG9vMQ4wDAYDVQQHFAVFc3BvbzEOMAwGA1UEChQFTm9raWExCzAJ
BgNVBAsUAkJJMSUwIwYDVQQDFBxwcm9qZWN0cy5kZXZlbG9wZXIubm9raWEuY29t
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCr92w1bpHYSYxUEx8N/8Iddda2
lYi+aXNtQfV/l2Fw9Ykv3Ipw4nLeGTj18FFlAZgMdPRlgrzF/NNXGw/9l3/qKdow
CypkQf8lLaxb9Ze1E/KKmkRJa48QTOqvo6GqKuTI6HCeGlG1RxDb8YSKcQWLiytn
yj3Wp4MgRQO266xmMQIDAQABo4IB9jCCAfIwQQYDVR0RBDowOIIccHJvamVjdHMu
ZGV2ZWxvcGVyLm5va2lhLmNvbYIYcHJvamVjdHMuZm9ydW0ubm9raWEuY29tMAkG
A1UdEwQCMAAwCwYDVR0PBAQDAgWgMEEGA1UdHwQ6MDgwNqA0oDKGMGh0dHA6Ly9T
VlJJbnRsLUczLWNybC52ZXJpc2lnbi5jb20vU1ZSSW50bEczLmNybDBEBgNVHSAE
PTA7MDkGC2CGSAGG+EUBBxcDMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LnZl
cmlzaWduLmNvbS9ycGEwKAYDVR0lBCEwHwYJYIZIAYb4QgQBBggrBgEFBQcDAQYI
KwYBBQUHAwIwcgYIKwYBBQUHAQEEZjBkMCQGCCsGAQUFBzABhhhodHRwOi8vb2Nz
cC52ZXJpc2lnbi5jb20wPAYIKwYBBQUHMAKGMGh0dHA6Ly9TVlJJbnRsLUczLWFp
YS52ZXJpc2lnbi5jb20vU1ZSSW50bEczLmNlcjBuBggrBgEFBQcBDARiMGChXqBc
MFowWDBWFglpbWFnZS9naWYwITAfMAcGBSsOAwIaBBRLa7kolgYMu9BSOJsprEsH
iyEFGDAmFiRodHRwOi8vbG9nby52ZXJpc2lnbi5jb20vdnNsb2dvMS5naWYwDQYJ
KoZIhvcNAQEFBQADggEBACQuPyIJqXwUyFRWw9x5yDXgMW4zYFopQYOw/ItRY522
O5BsySTh56BWS6mQB07XVfxmYUGAvRQDA5QHpmY8jIlNwSmN3s8RKo+fAtiNRlcL
x/mWSfuMs3D/S6ev3D6+dpEMZtjrhOdctsarMKp8n/hPbwhAbg5hVjpkW5n8vz2y
0KxvvkA1AxpLwpVv7OlK17ttzIHw8bp9HTlHBU5s8bKz4a565V/a5HI0CSEv/+0y
ko4/ghTnZc1CkmUngKKeFMSah/mT/xAh8XnE2l1AazFa8UKuYki1e+ArHaGZc4ix
UYOtiRphwfuYQhRZ7qX9q2MMkCMI65XNK/SaFrAbbG0=
-----END CERTIFICATE-----
PK SDu\�,\� � ! future/backports/test/keycert.pemnu �[��� -----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBANtb0+YrKuxevGpm
LrjaUhZSgz6zFAmuGFmKmUbdjmfv9zSmmdsQIksK++jK0Be9LeZy20j6ahOfuVa0
ufEmPoP7Fy4hXegKZR9cCWcIe/A6H2xWF1IIJLRTLaU8ol/I7T+um5HD5AwAwNPP
USNU0Eegmvp+xxWu3NX2m1Veot85AgMBAAECgYA3ZdZ673X0oexFlq7AAmrutkHt
CL7LvwrpOiaBjhyTxTeSNWzvtQBkIU8DOI0bIazA4UreAFffwtvEuPmonDb3F+Iq
SMAu42XcGyVZEl+gHlTPU9XRX7nTOXVt+MlRRRxL6t9GkGfUAXI3XxJDXW3c0vBK
UL9xqD8cORXOfE06rQJBAP8mEX1ERkR64Ptsoe4281vjTlNfIbs7NMPkUnrn9N/Y
BLhjNIfQ3HFZG8BTMLfX7kCS9D593DW5tV4Z9BP/c6cCQQDcFzCcVArNh2JSywOQ
ZfTfRbJg/Z5Lt9Fkngv1meeGNPgIMLN8Sg679pAOOWmzdMO3V706rNPzSVMME7E5
oPIfAkEA8pDddarP5tCvTTgUpmTFbakm0KoTZm2+FzHcnA4jRh+XNTjTOv98Y6Ik
eO5d1ZnKXseWvkZncQgxfdnMqqpj5wJAcNq/RVne1DbYlwWchT2Si65MYmmJ8t+F
0mcsULqjOnEMwf5e+ptq5LzwbyrHZYq5FNk7ocufPv/ZQrcSSC+cFwJBAKvOJByS
x56qyGeZLOQlWS2JS3KJo59XuLFGqcbgN9Om9xFa41Yb4N9NvplFivsvZdw3m1Q/
SPIXQuT8RMPDVNQ=
-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICVDCCAb2gAwIBAgIJANfHOBkZr8JOMA0GCSqGSIb3DQEBBQUAMF8xCzAJBgNV
BAYTAlhZMRcwFQYDVQQHEw5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9u
IFNvZnR3YXJlIEZvdW5kYXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDAeFw0xMDEw
MDgyMzAxNTZaFw0yMDEwMDUyMzAxNTZaMF8xCzAJBgNVBAYTAlhZMRcwFQYDVQQH
Ew5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9uIFNvZnR3YXJlIEZvdW5k
YXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
gYkCgYEA21vT5isq7F68amYuuNpSFlKDPrMUCa4YWYqZRt2OZ+/3NKaZ2xAiSwr7
6MrQF70t5nLbSPpqE5+5VrS58SY+g/sXLiFd6AplH1wJZwh78DofbFYXUggktFMt
pTyiX8jtP66bkcPkDADA089RI1TQR6Ca+n7HFa7c1fabVV6i3zkCAwEAAaMYMBYw
FAYDVR0RBA0wC4IJbG9jYWxob3N0MA0GCSqGSIb3DQEBBQUAA4GBAHPctQBEQ4wd
BJ6+JcpIraopLn8BGhbjNWj40mmRqWB/NAWF6M5ne7KpGAu7tLeG4hb1zLaldK8G
lxy2GPSRF6LFS48dpEj2HbMv2nvv6xxalDMJ9+DicWgAKTQ6bcX2j3GUkCR0g/T1
CRlNBAAlvhKzO7Clpf9l0YKBEfraJByX
-----END CERTIFICATE-----
PK VDu\ " future/backports/test/nullcert.pemnu �[��� PK VDu\<�& & ( future/backports/test/keycert.passwd.pemnu �[��� -----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,1A8D9D2A02EC698A
kJYbfZ8L0sfe9Oty3gw0aloNnY5E8fegRfQLZlNoxTl6jNt0nIwI8kDJ36CZgR9c
u3FDJm/KqrfUoz8vW+qEnWhSG7QPX2wWGPHd4K94Yz/FgrRzZ0DoK7XxXq9gOtVA
AVGQhnz32p+6WhfGsCr9ArXEwRZrTk/FvzEPaU5fHcoSkrNVAGX8IpSVkSDwEDQr
Gv17+cfk99UV1OCza6yKHoFkTtrC+PZU71LomBabivS2Oc4B9hYuSR2hF01wTHP+
YlWNagZOOVtNz4oKK9x9eNQpmfQXQvPPTfusexKIbKfZrMvJoxcm1gfcZ0H/wK6P
6wmXSG35qMOOztCZNtperjs1wzEBXznyK8QmLcAJBjkfarABJX9vBEzZV0OUKhy+
noORFwHTllphbmydLhu6ehLUZMHPhzAS5UN7srtpSN81eerDMy0RMUAwA7/PofX1
94Me85Q8jP0PC9ETdsJcPqLzAPETEYu0ELewKRcrdyWi+tlLFrpE5KT/s5ecbl9l
7B61U4Kfd1PIXc/siINhU3A3bYK+845YyUArUOnKf1kEox7p1RpD7yFqVT04lRTo
cibNKATBusXSuBrp2G6GNuhWEOSafWCKJQAzgCYIp6ZTV2khhMUGppc/2H3CF6cO
zX0KtlPVZC7hLkB6HT8SxYUwF1zqWY7+/XPPdc37MeEZ87Q3UuZwqORLY+Z0hpgt
L5JXBCoklZhCAaN2GqwFLXtGiRSRFGY7xXIhbDTlE65Wv1WGGgDLMKGE1gOz3yAo
2jjG1+yAHJUdE69XTFHSqSkvaloA1W03LdMXZ9VuQJ/ySXCie6ABAQ==
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICVDCCAb2gAwIBAgIJANfHOBkZr8JOMA0GCSqGSIb3DQEBBQUAMF8xCzAJBgNV
BAYTAlhZMRcwFQYDVQQHEw5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9u
IFNvZnR3YXJlIEZvdW5kYXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDAeFw0xMDEw
MDgyMzAxNTZaFw0yMDEwMDUyMzAxNTZaMF8xCzAJBgNVBAYTAlhZMRcwFQYDVQQH
Ew5DYXN0bGUgQW50aHJheDEjMCEGA1UEChMaUHl0aG9uIFNvZnR3YXJlIEZvdW5k
YXRpb24xEjAQBgNVBAMTCWxvY2FsaG9zdDCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
gYkCgYEA21vT5isq7F68amYuuNpSFlKDPrMUCa4YWYqZRt2OZ+/3NKaZ2xAiSwr7
6MrQF70t5nLbSPpqE5+5VrS58SY+g/sXLiFd6AplH1wJZwh78DofbFYXUggktFMt
pTyiX8jtP66bkcPkDADA089RI1TQR6Ca+n7HFa7c1fabVV6i3zkCAwEAAaMYMBYw
FAYDVR0RBA0wC4IJbG9jYWxob3N0MA0GCSqGSIb3DQEBBQUAA4GBAHPctQBEQ4wd
BJ6+JcpIraopLn8BGhbjNWj40mmRqWB/NAWF6M5ne7KpGAu7tLeG4hb1zLaldK8G
lxy2GPSRF6LFS48dpEj2HbMv2nvv6xxalDMJ9+DicWgAKTQ6bcX2j3GUkCR0g/T1
CRlNBAAlvhKzO7Clpf9l0YKBEfraJByX
-----END CERTIFICATE-----
PK YDu\�<��� � ( future/backports/test/ssl_key.passwd.pemnu �[��� -----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,1A8D9D2A02EC698A
kJYbfZ8L0sfe9Oty3gw0aloNnY5E8fegRfQLZlNoxTl6jNt0nIwI8kDJ36CZgR9c
u3FDJm/KqrfUoz8vW+qEnWhSG7QPX2wWGPHd4K94Yz/FgrRzZ0DoK7XxXq9gOtVA
AVGQhnz32p+6WhfGsCr9ArXEwRZrTk/FvzEPaU5fHcoSkrNVAGX8IpSVkSDwEDQr
Gv17+cfk99UV1OCza6yKHoFkTtrC+PZU71LomBabivS2Oc4B9hYuSR2hF01wTHP+
YlWNagZOOVtNz4oKK9x9eNQpmfQXQvPPTfusexKIbKfZrMvJoxcm1gfcZ0H/wK6P
6wmXSG35qMOOztCZNtperjs1wzEBXznyK8QmLcAJBjkfarABJX9vBEzZV0OUKhy+
noORFwHTllphbmydLhu6ehLUZMHPhzAS5UN7srtpSN81eerDMy0RMUAwA7/PofX1
94Me85Q8jP0PC9ETdsJcPqLzAPETEYu0ELewKRcrdyWi+tlLFrpE5KT/s5ecbl9l
7B61U4Kfd1PIXc/siINhU3A3bYK+845YyUArUOnKf1kEox7p1RpD7yFqVT04lRTo
cibNKATBusXSuBrp2G6GNuhWEOSafWCKJQAzgCYIp6ZTV2khhMUGppc/2H3CF6cO
zX0KtlPVZC7hLkB6HT8SxYUwF1zqWY7+/XPPdc37MeEZ87Q3UuZwqORLY+Z0hpgt
L5JXBCoklZhCAaN2GqwFLXtGiRSRFGY7xXIhbDTlE65Wv1WGGgDLMKGE1gOz3yAo
2jjG1+yAHJUdE69XTFHSqSkvaloA1W03LdMXZ9VuQJ/ySXCie6ABAQ==
-----END RSA PRIVATE KEY-----
PK [Du\0,5� � ! future/backports/test/badcert.pemnu �[��� -----BEGIN RSA PRIVATE KEY-----
MIICXwIBAAKBgQC8ddrhm+LutBvjYcQlnH21PPIseJ1JVG2HMmN2CmZk2YukO+9L
opdJhTvbGfEj0DQs1IE8M+kTUyOmuKfVrFMKwtVeCJphrAnhoz7TYOuLBSqt7lVH
fhi/VwovESJlaBOp+WMnfhcduPEYHYx/6cnVapIkZnLt30zu2um+DzA9jQIDAQAB
AoGBAK0FZpaKj6WnJZN0RqhhK+ggtBWwBnc0U/ozgKz2j1s3fsShYeiGtW6CK5nU
D1dZ5wzhbGThI7LiOXDvRucc9n7vUgi0alqPQ/PFodPxAN/eEYkmXQ7W2k7zwsDA
IUK0KUhktQbLu8qF/m8qM86ba9y9/9YkXuQbZ3COl5ahTZrhAkEA301P08RKv3KM
oXnGU2UHTuJ1MAD2hOrPxjD4/wxA/39EWG9bZczbJyggB4RHu0I3NOSFjAm3HQm0
ANOu5QK9owJBANgOeLfNNcF4pp+UikRFqxk5hULqRAWzVxVrWe85FlPm0VVmHbb/
loif7mqjU8o1jTd/LM7RD9f2usZyE2psaw8CQQCNLhkpX3KO5kKJmS9N7JMZSc4j
oog58yeYO8BBqKKzpug0LXuQultYv2K4veaIO04iL9VLe5z9S/Q1jaCHBBuXAkEA
z8gjGoi1AOp6PBBLZNsncCvcV/0aC+1se4HxTNo2+duKSDnbq+ljqOM+E7odU+Nq
ewvIWOG//e8fssd0mq3HywJBAJ8l/c8GVmrpFTx8r/nZ2Pyyjt3dH1widooDXYSV
q6Gbf41Llo5sYAtmxdndTLASuHKecacTgZVhy0FryZpLKrU=
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
Just bad cert data
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
MIICXwIBAAKBgQC8ddrhm+LutBvjYcQlnH21PPIseJ1JVG2HMmN2CmZk2YukO+9L
opdJhTvbGfEj0DQs1IE8M+kTUyOmuKfVrFMKwtVeCJphrAnhoz7TYOuLBSqt7lVH
fhi/VwovESJlaBOp+WMnfhcduPEYHYx/6cnVapIkZnLt30zu2um+DzA9jQIDAQAB
AoGBAK0FZpaKj6WnJZN0RqhhK+ggtBWwBnc0U/ozgKz2j1s3fsShYeiGtW6CK5nU
D1dZ5wzhbGThI7LiOXDvRucc9n7vUgi0alqPQ/PFodPxAN/eEYkmXQ7W2k7zwsDA
IUK0KUhktQbLu8qF/m8qM86ba9y9/9YkXuQbZ3COl5ahTZrhAkEA301P08RKv3KM
oXnGU2UHTuJ1MAD2hOrPxjD4/wxA/39EWG9bZczbJyggB4RHu0I3NOSFjAm3HQm0
ANOu5QK9owJBANgOeLfNNcF4pp+UikRFqxk5hULqRAWzVxVrWe85FlPm0VVmHbb/
loif7mqjU8o1jTd/LM7RD9f2usZyE2psaw8CQQCNLhkpX3KO5kKJmS9N7JMZSc4j
oog58yeYO8BBqKKzpug0LXuQultYv2K4veaIO04iL9VLe5z9S/Q1jaCHBBuXAkEA
z8gjGoi1AOp6PBBLZNsncCvcV/0aC+1se4HxTNo2+duKSDnbq+ljqOM+E7odU+Nq
ewvIWOG//e8fssd0mq3HywJBAJ8l/c8GVmrpFTx8r/nZ2Pyyjt3dH1widooDXYSV
q6Gbf41Llo5sYAtmxdndTLASuHKecacTgZVhy0FryZpLKrU=
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
Just bad cert data
-----END CERTIFICATE-----
PK `Du\�
��r r future/backports/test/badkey.pemnu �[��� -----BEGIN RSA PRIVATE KEY-----
Bad Key, though the cert should be OK
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICpzCCAhCgAwIBAgIJAP+qStv1cIGNMA0GCSqGSIb3DQEBBQUAMIGJMQswCQYD
VQQGEwJVUzERMA8GA1UECBMIRGVsYXdhcmUxEzARBgNVBAcTCldpbG1pbmd0b24x
IzAhBgNVBAoTGlB5dGhvbiBTb2Z0d2FyZSBGb3VuZGF0aW9uMQwwCgYDVQQLEwNT
U0wxHzAdBgNVBAMTFnNvbWVtYWNoaW5lLnB5dGhvbi5vcmcwHhcNMDcwODI3MTY1
NDUwWhcNMTMwMjE2MTY1NDUwWjCBiTELMAkGA1UEBhMCVVMxETAPBgNVBAgTCERl
bGF3YXJlMRMwEQYDVQQHEwpXaWxtaW5ndG9uMSMwIQYDVQQKExpQeXRob24gU29m
dHdhcmUgRm91bmRhdGlvbjEMMAoGA1UECxMDU1NMMR8wHQYDVQQDExZzb21lbWFj
aGluZS5weXRob24ub3JnMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC8ddrh
m+LutBvjYcQlnH21PPIseJ1JVG2HMmN2CmZk2YukO+9LopdJhTvbGfEj0DQs1IE8
M+kTUyOmuKfVrFMKwtVeCJphrAnhoz7TYOuLBSqt7lVHfhi/VwovESJlaBOp+WMn
fhcduPEYHYx/6cnVapIkZnLt30zu2um+DzA9jQIDAQABoxUwEzARBglghkgBhvhC
AQEEBAMCBkAwDQYJKoZIhvcNAQEFBQADgYEAF4Q5BVqmCOLv1n8je/Jw9K669VXb
08hyGzQhkemEBYQd6fzQ9A/1ZzHkJKb1P6yreOLSEh4KcxYPyrLRC1ll8nr5OlCx
CMhKkTnR6qBsdNV0XtdU2+N25hqW+Ma4ZeqsN/iiJVCGNOZGnvQuvCAGWF8+J/f/
iHkC6gGdBJhogs4=
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
Bad Key, though the cert should be OK
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICpzCCAhCgAwIBAgIJAP+qStv1cIGNMA0GCSqGSIb3DQEBBQUAMIGJMQswCQYD
VQQGEwJVUzERMA8GA1UECBMIRGVsYXdhcmUxEzARBgNVBAcTCldpbG1pbmd0b24x
IzAhBgNVBAoTGlB5dGhvbiBTb2Z0d2FyZSBGb3VuZGF0aW9uMQwwCgYDVQQLEwNT
U0wxHzAdBgNVBAMTFnNvbWVtYWNoaW5lLnB5dGhvbi5vcmcwHhcNMDcwODI3MTY1
NDUwWhcNMTMwMjE2MTY1NDUwWjCBiTELMAkGA1UEBhMCVVMxETAPBgNVBAgTCERl
bGF3YXJlMRMwEQYDVQQHEwpXaWxtaW5ndG9uMSMwIQYDVQQKExpQeXRob24gU29m
dHdhcmUgRm91bmRhdGlvbjEMMAoGA1UECxMDU1NMMR8wHQYDVQQDExZzb21lbWFj
aGluZS5weXRob24ub3JnMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC8ddrh
m+LutBvjYcQlnH21PPIseJ1JVG2HMmN2CmZk2YukO+9LopdJhTvbGfEj0DQs1IE8
M+kTUyOmuKfVrFMKwtVeCJphrAnhoz7TYOuLBSqt7lVHfhi/VwovESJlaBOp+WMn
fhcduPEYHYx/6cnVapIkZnLt30zu2um+DzA9jQIDAQABoxUwEzARBglghkgBhvhC
AQEEBAMCBkAwDQYJKoZIhvcNAQEFBQADgYEAF4Q5BVqmCOLv1n8je/Jw9K669VXb
08hyGzQhkemEBYQd6fzQ9A/1ZzHkJKb1P6yreOLSEh4KcxYPyrLRC1ll8nr5OlCx
CMhKkTnR6qBsdNV0XtdU2+N25hqW+Ma4ZeqsN/iiJVCGNOZGnvQuvCAGWF8+J/f/
iHkC6gGdBJhogs4=
-----END CERTIFICATE-----
PK bDu\��t�^ �^ future/backports/socketserver.pynu �[��� """Generic socket server classes.
This module tries to capture the various aspects of defining a server:
For socket-based servers:
- address family:
- AF_INET{,6}: IP (Internet Protocol) sockets (default)
- AF_UNIX: Unix domain sockets
- others, e.g. AF_DECNET are conceivable (see <socket.h>
- socket type:
- SOCK_STREAM (reliable stream, e.g. TCP)
- SOCK_DGRAM (datagrams, e.g. UDP)
For request-based servers (including socket-based):
- client address verification before further looking at the request
(This is actually a hook for any processing that needs to look
at the request before anything else, e.g. logging)
- how to handle multiple requests:
- synchronous (one request is handled at a time)
- forking (each request is handled by a new process)
- threading (each request is handled by a new thread)
The classes in this module favor the server type that is simplest to
write: a synchronous TCP/IP server. This is bad class design, but
save some typing. (There's also the issue that a deep class hierarchy
slows down method lookups.)
There are five classes in an inheritance diagram, four of which represent
synchronous servers of four types:
+------------+
| BaseServer |
+------------+
|
v
+-----------+ +------------------+
| TCPServer |------->| UnixStreamServer |
+-----------+ +------------------+
|
v
+-----------+ +--------------------+
| UDPServer |------->| UnixDatagramServer |
+-----------+ +--------------------+
Note that UnixDatagramServer derives from UDPServer, not from
UnixStreamServer -- the only difference between an IP and a Unix
stream server is the address family, which is simply repeated in both
unix server classes.
Forking and threading versions of each type of server can be created
using the ForkingMixIn and ThreadingMixIn mix-in classes. For
instance, a threading UDP server class is created as follows:
class ThreadingUDPServer(ThreadingMixIn, UDPServer): pass
The Mix-in class must come first, since it overrides a method defined
in UDPServer! Setting the various member variables also changes
the behavior of the underlying server mechanism.
To implement a service, you must derive a class from
BaseRequestHandler and redefine its handle() method. You can then run
various versions of the service by combining one of the server classes
with your request handler class.
The request handler class must be different for datagram or stream
services. This can be hidden by using the request handler
subclasses StreamRequestHandler or DatagramRequestHandler.
Of course, you still have to use your head!
For instance, it makes no sense to use a forking server if the service
contains state in memory that can be modified by requests (since the
modifications in the child process would never reach the initial state
kept in the parent process and passed to each child). In this case,
you can use a threading server, but you will probably have to use
locks to avoid two requests that come in nearly simultaneous to apply
conflicting changes to the server state.
On the other hand, if you are building e.g. an HTTP server, where all
data is stored externally (e.g. in the file system), a synchronous
class will essentially render the service "deaf" while one request is
being handled -- which may be for a very long time if a client is slow
to read all the data it has requested. Here a threading or forking
server is appropriate.
In some cases, it may be appropriate to process part of a request
synchronously, but to finish processing in a forked child depending on
the request data. This can be implemented by using a synchronous
server and doing an explicit fork in the request handler class
handle() method.
Another approach to handling multiple simultaneous requests in an
environment that supports neither threads nor fork (or where these are
too expensive or inappropriate for the service) is to maintain an
explicit table of partially finished requests and to use select() to
decide which request to work on next (or whether to handle a new
incoming request). This is particularly important for stream services
where each client can potentially be connected for a long time (if
threads or subprocesses cannot be used).
Future work:
- Standard classes for Sun RPC (which uses either UDP or TCP)
- Standard mix-in classes to implement various authentication
and encryption schemes
- Standard framework for select-based multiplexing
XXX Open problems:
- What to do with out-of-band data?
BaseServer:
- split generic "request" functionality out into BaseServer class.
Copyright (C) 2000 Luke Kenneth Casson Leighton <lkcl@samba.org>
example: read entries from a SQL database (requires overriding
get_request() to return a table entry from the database).
entry is processed by a RequestHandlerClass.
"""
# Author of the BaseServer patch: Luke Kenneth Casson Leighton
# XXX Warning!
# There is a test suite for this module, but it cannot be run by the
# standard regression test.
# To run it manually, run Lib/test/test_socketserver.py.
from __future__ import (absolute_import, print_function)
__version__ = "0.4"
import socket
import select
import sys
import os
import errno
try:
import threading
except ImportError:
import dummy_threading as threading
__all__ = ["TCPServer","UDPServer","ForkingUDPServer","ForkingTCPServer",
"ThreadingUDPServer","ThreadingTCPServer","BaseRequestHandler",
"StreamRequestHandler","DatagramRequestHandler",
"ThreadingMixIn", "ForkingMixIn"]
if hasattr(socket, "AF_UNIX"):
__all__.extend(["UnixStreamServer","UnixDatagramServer",
"ThreadingUnixStreamServer",
"ThreadingUnixDatagramServer"])
def _eintr_retry(func, *args):
"""restart a system call interrupted by EINTR"""
while True:
try:
return func(*args)
except OSError as e:
if e.errno != errno.EINTR:
raise
class BaseServer(object):
"""Base class for server classes.
Methods for the caller:
- __init__(server_address, RequestHandlerClass)
- serve_forever(poll_interval=0.5)
- shutdown()
- handle_request() # if you do not use serve_forever()
- fileno() -> int # for select()
Methods that may be overridden:
- server_bind()
- server_activate()
- get_request() -> request, client_address
- handle_timeout()
- verify_request(request, client_address)
- server_close()
- process_request(request, client_address)
- shutdown_request(request)
- close_request(request)
- service_actions()
- handle_error()
Methods for derived classes:
- finish_request(request, client_address)
Class variables that may be overridden by derived classes or
instances:
- timeout
- address_family
- socket_type
- allow_reuse_address
Instance variables:
- RequestHandlerClass
- socket
"""
timeout = None
def __init__(self, server_address, RequestHandlerClass):
"""Constructor. May be extended, do not override."""
self.server_address = server_address
self.RequestHandlerClass = RequestHandlerClass
self.__is_shut_down = threading.Event()
self.__shutdown_request = False
def server_activate(self):
"""Called by constructor to activate the server.
May be overridden.
"""
pass
def serve_forever(self, poll_interval=0.5):
"""Handle one request at a time until shutdown.
Polls for shutdown every poll_interval seconds. Ignores
self.timeout. If you need to do periodic tasks, do them in
another thread.
"""
self.__is_shut_down.clear()
try:
while not self.__shutdown_request:
# XXX: Consider using another file descriptor or
# connecting to the socket to wake this up instead of
# polling. Polling reduces our responsiveness to a
# shutdown request and wastes cpu at all other times.
r, w, e = _eintr_retry(select.select, [self], [], [],
poll_interval)
if self in r:
self._handle_request_noblock()
self.service_actions()
finally:
self.__shutdown_request = False
self.__is_shut_down.set()
def shutdown(self):
"""Stops the serve_forever loop.
Blocks until the loop has finished. This must be called while
serve_forever() is running in another thread, or it will
deadlock.
"""
self.__shutdown_request = True
self.__is_shut_down.wait()
def service_actions(self):
"""Called by the serve_forever() loop.
May be overridden by a subclass / Mixin to implement any code that
needs to be run during the loop.
"""
pass
# The distinction between handling, getting, processing and
# finishing a request is fairly arbitrary. Remember:
#
# - handle_request() is the top-level call. It calls
# select, get_request(), verify_request() and process_request()
# - get_request() is different for stream or datagram sockets
# - process_request() is the place that may fork a new process
# or create a new thread to finish the request
# - finish_request() instantiates the request handler class;
# this constructor will handle the request all by itself
def handle_request(self):
"""Handle one request, possibly blocking.
Respects self.timeout.
"""
# Support people who used socket.settimeout() to escape
# handle_request before self.timeout was available.
timeout = self.socket.gettimeout()
if timeout is None:
timeout = self.timeout
elif self.timeout is not None:
timeout = min(timeout, self.timeout)
fd_sets = _eintr_retry(select.select, [self], [], [], timeout)
if not fd_sets[0]:
self.handle_timeout()
return
self._handle_request_noblock()
def _handle_request_noblock(self):
"""Handle one request, without blocking.
I assume that select.select has returned that the socket is
readable before this function was called, so there should be
no risk of blocking in get_request().
"""
try:
request, client_address = self.get_request()
except socket.error:
return
if self.verify_request(request, client_address):
try:
self.process_request(request, client_address)
except:
self.handle_error(request, client_address)
self.shutdown_request(request)
def handle_timeout(self):
"""Called if no new request arrives within self.timeout.
Overridden by ForkingMixIn.
"""
pass
def verify_request(self, request, client_address):
"""Verify the request. May be overridden.
Return True if we should proceed with this request.
"""
return True
def process_request(self, request, client_address):
"""Call finish_request.
Overridden by ForkingMixIn and ThreadingMixIn.
"""
self.finish_request(request, client_address)
self.shutdown_request(request)
def server_close(self):
"""Called to clean-up the server.
May be overridden.
"""
pass
def finish_request(self, request, client_address):
"""Finish one request by instantiating RequestHandlerClass."""
self.RequestHandlerClass(request, client_address, self)
def shutdown_request(self, request):
"""Called to shutdown and close an individual request."""
self.close_request(request)
def close_request(self, request):
"""Called to clean up an individual request."""
pass
def handle_error(self, request, client_address):
"""Handle an error gracefully. May be overridden.
The default is to print a traceback and continue.
"""
print('-'*40)
print('Exception happened during processing of request from', end=' ')
print(client_address)
import traceback
traceback.print_exc() # XXX But this goes to stderr!
print('-'*40)
class TCPServer(BaseServer):
"""Base class for various socket-based server classes.
Defaults to synchronous IP stream (i.e., TCP).
Methods for the caller:
- __init__(server_address, RequestHandlerClass, bind_and_activate=True)
- serve_forever(poll_interval=0.5)
- shutdown()
- handle_request() # if you don't use serve_forever()
- fileno() -> int # for select()
Methods that may be overridden:
- server_bind()
- server_activate()
- get_request() -> request, client_address
- handle_timeout()
- verify_request(request, client_address)
- process_request(request, client_address)
- shutdown_request(request)
- close_request(request)
- handle_error()
Methods for derived classes:
- finish_request(request, client_address)
Class variables that may be overridden by derived classes or
instances:
- timeout
- address_family
- socket_type
- request_queue_size (only for stream sockets)
- allow_reuse_address
Instance variables:
- server_address
- RequestHandlerClass
- socket
"""
address_family = socket.AF_INET
socket_type = socket.SOCK_STREAM
request_queue_size = 5
allow_reuse_address = False
def __init__(self, server_address, RequestHandlerClass, bind_and_activate=True):
"""Constructor. May be extended, do not override."""
BaseServer.__init__(self, server_address, RequestHandlerClass)
self.socket = socket.socket(self.address_family,
self.socket_type)
if bind_and_activate:
self.server_bind()
self.server_activate()
def server_bind(self):
"""Called by constructor to bind the socket.
May be overridden.
"""
if self.allow_reuse_address:
self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
self.socket.bind(self.server_address)
self.server_address = self.socket.getsockname()
def server_activate(self):
"""Called by constructor to activate the server.
May be overridden.
"""
self.socket.listen(self.request_queue_size)
def server_close(self):
"""Called to clean-up the server.
May be overridden.
"""
self.socket.close()
def fileno(self):
"""Return socket file number.
Interface required by select().
"""
return self.socket.fileno()
def get_request(self):
"""Get the request and client address from the socket.
May be overridden.
"""
return self.socket.accept()
def shutdown_request(self, request):
"""Called to shutdown and close an individual request."""
try:
#explicitly shutdown. socket.close() merely releases
#the socket and waits for GC to perform the actual close.
request.shutdown(socket.SHUT_WR)
except socket.error:
pass #some platforms may raise ENOTCONN here
self.close_request(request)
def close_request(self, request):
"""Called to clean up an individual request."""
request.close()
class UDPServer(TCPServer):
"""UDP server class."""
allow_reuse_address = False
socket_type = socket.SOCK_DGRAM
max_packet_size = 8192
def get_request(self):
data, client_addr = self.socket.recvfrom(self.max_packet_size)
return (data, self.socket), client_addr
def server_activate(self):
# No need to call listen() for UDP.
pass
def shutdown_request(self, request):
# No need to shutdown anything.
self.close_request(request)
def close_request(self, request):
# No need to close anything.
pass
class ForkingMixIn(object):
"""Mix-in class to handle each request in a new process."""
timeout = 300
active_children = None
max_children = 40
def collect_children(self):
"""Internal routine to wait for children that have exited."""
if self.active_children is None: return
while len(self.active_children) >= self.max_children:
# XXX: This will wait for any child process, not just ones
# spawned by this library. This could confuse other
# libraries that expect to be able to wait for their own
# children.
try:
pid, status = os.waitpid(0, 0)
except os.error:
pid = None
if pid not in self.active_children: continue
self.active_children.remove(pid)
# XXX: This loop runs more system calls than it ought
# to. There should be a way to put the active_children into a
# process group and then use os.waitpid(-pgid) to wait for any
# of that set, but I couldn't find a way to allocate pgids
# that couldn't collide.
for child in self.active_children:
try:
pid, status = os.waitpid(child, os.WNOHANG)
except os.error:
pid = None
if not pid: continue
try:
self.active_children.remove(pid)
except ValueError as e:
raise ValueError('%s. x=%d and list=%r' % (e.message, pid,
self.active_children))
def handle_timeout(self):
"""Wait for zombies after self.timeout seconds of inactivity.
May be extended, do not override.
"""
self.collect_children()
def service_actions(self):
"""Collect the zombie child processes regularly in the ForkingMixIn.
service_actions is called in the BaseServer's serve_forver loop.
"""
self.collect_children()
def process_request(self, request, client_address):
"""Fork a new subprocess to process the request."""
pid = os.fork()
if pid:
# Parent process
if self.active_children is None:
self.active_children = []
self.active_children.append(pid)
self.close_request(request)
return
else:
# Child process.
# This must never return, hence os._exit()!
try:
self.finish_request(request, client_address)
self.shutdown_request(request)
os._exit(0)
except:
try:
self.handle_error(request, client_address)
self.shutdown_request(request)
finally:
os._exit(1)
class ThreadingMixIn(object):
"""Mix-in class to handle each request in a new thread."""
# Decides how threads will act upon termination of the
# main process
daemon_threads = False
def process_request_thread(self, request, client_address):
"""Same as in BaseServer but as a thread.
In addition, exception handling is done here.
"""
try:
self.finish_request(request, client_address)
self.shutdown_request(request)
except:
self.handle_error(request, client_address)
self.shutdown_request(request)
def process_request(self, request, client_address):
"""Start a new thread to process the request."""
t = threading.Thread(target = self.process_request_thread,
args = (request, client_address))
t.daemon = self.daemon_threads
t.start()
class ForkingUDPServer(ForkingMixIn, UDPServer): pass
class ForkingTCPServer(ForkingMixIn, TCPServer): pass
class ThreadingUDPServer(ThreadingMixIn, UDPServer): pass
class ThreadingTCPServer(ThreadingMixIn, TCPServer): pass
if hasattr(socket, 'AF_UNIX'):
class UnixStreamServer(TCPServer):
address_family = socket.AF_UNIX
class UnixDatagramServer(UDPServer):
address_family = socket.AF_UNIX
class ThreadingUnixStreamServer(ThreadingMixIn, UnixStreamServer): pass
class ThreadingUnixDatagramServer(ThreadingMixIn, UnixDatagramServer): pass
class BaseRequestHandler(object):
"""Base class for request handler classes.
This class is instantiated for each request to be handled. The
constructor sets the instance variables request, client_address
and server, and then calls the handle() method. To implement a
specific service, all you need to do is to derive a class which
defines a handle() method.
The handle() method can find the request as self.request, the
client address as self.client_address, and the server (in case it
needs access to per-server information) as self.server. Since a
separate instance is created for each request, the handle() method
can define arbitrary other instance variariables.
"""
def __init__(self, request, client_address, server):
self.request = request
self.client_address = client_address
self.server = server
self.setup()
try:
self.handle()
finally:
self.finish()
def setup(self):
pass
def handle(self):
pass
def finish(self):
pass
# The following two classes make it possible to use the same service
# class for stream or datagram servers.
# Each class sets up these instance variables:
# - rfile: a file object from which receives the request is read
# - wfile: a file object to which the reply is written
# When the handle() method returns, wfile is flushed properly
class StreamRequestHandler(BaseRequestHandler):
"""Define self.rfile and self.wfile for stream sockets."""
# Default buffer sizes for rfile, wfile.
# We default rfile to buffered because otherwise it could be
# really slow for large data (a getc() call per byte); we make
# wfile unbuffered because (a) often after a write() we want to
# read and we need to flush the line; (b) big writes to unbuffered
# files are typically optimized by stdio even when big reads
# aren't.
rbufsize = -1
wbufsize = 0
# A timeout to apply to the request socket, if not None.
timeout = None
# Disable nagle algorithm for this socket, if True.
# Use only when wbufsize != 0, to avoid small packets.
disable_nagle_algorithm = False
def setup(self):
self.connection = self.request
if self.timeout is not None:
self.connection.settimeout(self.timeout)
if self.disable_nagle_algorithm:
self.connection.setsockopt(socket.IPPROTO_TCP,
socket.TCP_NODELAY, True)
self.rfile = self.connection.makefile('rb', self.rbufsize)
self.wfile = self.connection.makefile('wb', self.wbufsize)
def finish(self):
if not self.wfile.closed:
try:
self.wfile.flush()
except socket.error:
# An final socket error may have occurred here, such as
# the local error ECONNABORTED.
pass
self.wfile.close()
self.rfile.close()
class DatagramRequestHandler(BaseRequestHandler):
# XXX Regrettably, I cannot get this working on Linux;
# s.recvfrom() doesn't return a meaningful client address.
"""Define self.rfile and self.wfile for datagram sockets."""
def setup(self):
from io import BytesIO
self.packet, self.socket = self.request
self.rfile = BytesIO(self.packet)
self.wfile = BytesIO()
def finish(self):
self.socket.sendto(self.wfile.getvalue(), self.client_address)
PK gDu\dd��� � . future/backports/email/_header_value_parser.pynu �[��� """Header value parser implementing various email-related RFC parsing rules.
The parsing methods defined in this module implement various email related
parsing rules. Principal among them is RFC 5322, which is the followon
to RFC 2822 and primarily a clarification of the former. It also implements
RFC 2047 encoded word decoding.
RFC 5322 goes to considerable trouble to maintain backward compatibility with
RFC 822 in the parse phase, while cleaning up the structure on the generation
phase. This parser supports correct RFC 5322 generation by tagging white space
as folding white space only when folding is allowed in the non-obsolete rule
sets. Actually, the parser is even more generous when accepting input than RFC
5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages.
Where possible deviations from the standard are annotated on the 'defects'
attribute of tokens that deviate.
The general structure of the parser follows RFC 5322, and uses its terminology
where there is a direct correspondence. Where the implementation requires a
somewhat different structure than that used by the formal grammar, new terms
that mimic the closest existing terms are used. Thus, it really helps to have
a copy of RFC 5322 handy when studying this code.
Input to the parser is a string that has already been unfolded according to
RFC 5322 rules. According to the RFC this unfolding is the very first step, and
this parser leaves the unfolding step to a higher level message parser, which
will have already detected the line breaks that need unfolding while
determining the beginning and end of each header.
The output of the parser is a TokenList object, which is a list subclass. A
TokenList is a recursive data structure. The terminal nodes of the structure
are Terminal objects, which are subclasses of str. These do not correspond
directly to terminal objects in the formal grammar, but are instead more
practical higher level combinations of true terminals.
All TokenList and Terminal objects have a 'value' attribute, which produces the
semantically meaningful value of that part of the parse subtree. The value of
all whitespace tokens (no matter how many sub-tokens they may contain) is a
single space, as per the RFC rules. This includes 'CFWS', which is herein
included in the general class of whitespace tokens. There is one exception to
the rule that whitespace tokens are collapsed into single spaces in values: in
the value of a 'bare-quoted-string' (a quoted-string with no leading or
trailing whitespace), any whitespace that appeared between the quotation marks
is preserved in the returned value. Note that in all Terminal strings quoted
pairs are turned into their unquoted values.
All TokenList and Terminal objects also have a string value, which attempts to
be a "canonical" representation of the RFC-compliant form of the substring that
produced the parsed subtree, including minimal use of quoted pair quoting.
Whitespace runs are not collapsed.
Comment tokens also have a 'content' attribute providing the string found
between the parens (including any nested comments) with whitespace preserved.
All TokenList and Terminal objects have a 'defects' attribute which is a
possibly empty list all of the defects found while creating the token. Defects
may appear on any token in the tree, and a composite list of all defects in the
subtree is available through the 'all_defects' attribute of any node. (For
Terminal notes x.defects == x.all_defects.)
Each object in a parse tree is called a 'token', and each has a 'token_type'
attribute that gives the name from the RFC 5322 grammar that it represents.
Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that
may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters.
It is returned in place of lists of (ctext/quoted-pair) and
(qtext/quoted-pair).
XXX: provide complete list of token types.
"""
from __future__ import print_function
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import int, range, str, super, list
import re
from collections import namedtuple, OrderedDict
from future.backports.urllib.parse import (unquote, unquote_to_bytes)
from future.backports.email import _encoded_words as _ew
from future.backports.email import errors
from future.backports.email import utils
#
# Useful constants and functions
#
WSP = set(' \t')
CFWS_LEADER = WSP | set('(')
SPECIALS = set(r'()<>@,:;.\"[]')
ATOM_ENDS = SPECIALS | WSP
DOT_ATOM_ENDS = ATOM_ENDS - set('.')
# '.', '"', and '(' do not end phrases in order to support obs-phrase
PHRASE_ENDS = SPECIALS - set('."(')
TSPECIALS = (SPECIALS | set('/?=')) - set('.')
TOKEN_ENDS = TSPECIALS | WSP
ASPECIALS = TSPECIALS | set("*'%")
ATTRIBUTE_ENDS = ASPECIALS | WSP
EXTENDED_ATTRIBUTE_ENDS = ATTRIBUTE_ENDS - set('%')
def quote_string(value):
return '"'+str(value).replace('\\', '\\\\').replace('"', r'\"')+'"'
#
# Accumulator for header folding
#
class _Folded(object):
def __init__(self, maxlen, policy):
self.maxlen = maxlen
self.policy = policy
self.lastlen = 0
self.stickyspace = None
self.firstline = True
self.done = []
self.current = list() # uses l.clear()
def newline(self):
self.done.extend(self.current)
self.done.append(self.policy.linesep)
self.current.clear()
self.lastlen = 0
def finalize(self):
if self.current:
self.newline()
def __str__(self):
return ''.join(self.done)
def append(self, stoken):
self.current.append(stoken)
def append_if_fits(self, token, stoken=None):
if stoken is None:
stoken = str(token)
l = len(stoken)
if self.stickyspace is not None:
stickyspace_len = len(self.stickyspace)
if self.lastlen + stickyspace_len + l <= self.maxlen:
self.current.append(self.stickyspace)
self.lastlen += stickyspace_len
self.current.append(stoken)
self.lastlen += l
self.stickyspace = None
self.firstline = False
return True
if token.has_fws:
ws = token.pop_leading_fws()
if ws is not None:
self.stickyspace += str(ws)
stickyspace_len += len(ws)
token._fold(self)
return True
if stickyspace_len and l + 1 <= self.maxlen:
margin = self.maxlen - l
if 0 < margin < stickyspace_len:
trim = stickyspace_len - margin
self.current.append(self.stickyspace[:trim])
self.stickyspace = self.stickyspace[trim:]
stickyspace_len = trim
self.newline()
self.current.append(self.stickyspace)
self.current.append(stoken)
self.lastlen = l + stickyspace_len
self.stickyspace = None
self.firstline = False
return True
if not self.firstline:
self.newline()
self.current.append(self.stickyspace)
self.current.append(stoken)
self.stickyspace = None
self.firstline = False
return True
if self.lastlen + l <= self.maxlen:
self.current.append(stoken)
self.lastlen += l
return True
if l < self.maxlen:
self.newline()
self.current.append(stoken)
self.lastlen = l
return True
return False
#
# TokenList and its subclasses
#
class TokenList(list):
token_type = None
def __init__(self, *args, **kw):
super(TokenList, self).__init__(*args, **kw)
self.defects = []
def __str__(self):
return ''.join(str(x) for x in self)
def __repr__(self):
return '{}({})'.format(self.__class__.__name__,
super(TokenList, self).__repr__())
@property
def value(self):
return ''.join(x.value for x in self if x.value)
@property
def all_defects(self):
return sum((x.all_defects for x in self), self.defects)
#
# Folding API
#
# parts():
#
# return a list of objects that constitute the "higher level syntactic
# objects" specified by the RFC as the best places to fold a header line.
# The returned objects must include leading folding white space, even if
# this means mutating the underlying parse tree of the object. Each object
# is only responsible for returning *its* parts, and should not drill down
# to any lower level except as required to meet the leading folding white
# space constraint.
#
# _fold(folded):
#
# folded: the result accumulator. This is an instance of _Folded.
# (XXX: I haven't finished factoring this out yet, the folding code
# pretty much uses this as a state object.) When the folded.current
# contains as much text as will fit, the _fold method should call
# folded.newline.
# folded.lastlen: the current length of the test stored in folded.current.
# folded.maxlen: The maximum number of characters that may appear on a
# folded line. Differs from the policy setting in that "no limit" is
# represented by +inf, which means it can be used in the trivially
# logical fashion in comparisons.
#
# Currently no subclasses implement parts, and I think this will remain
# true. A subclass only needs to implement _fold when the generic version
# isn't sufficient. _fold will need to be implemented primarily when it is
# possible for encoded words to appear in the specialized token-list, since
# there is no generic algorithm that can know where exactly the encoded
# words are allowed. A _fold implementation is responsible for filling
# lines in the same general way that the top level _fold does. It may, and
# should, call the _fold method of sub-objects in a similar fashion to that
# of the top level _fold.
#
# XXX: I'm hoping it will be possible to factor the existing code further
# to reduce redundancy and make the logic clearer.
@property
def parts(self):
klass = self.__class__
this = list()
for token in self:
if token.startswith_fws():
if this:
yield this[0] if len(this)==1 else klass(this)
this.clear()
end_ws = token.pop_trailing_ws()
this.append(token)
if end_ws:
yield klass(this)
this = [end_ws]
if this:
yield this[0] if len(this)==1 else klass(this)
def startswith_fws(self):
return self[0].startswith_fws()
def pop_leading_fws(self):
if self[0].token_type == 'fws':
return self.pop(0)
return self[0].pop_leading_fws()
def pop_trailing_ws(self):
if self[-1].token_type == 'cfws':
return self.pop(-1)
return self[-1].pop_trailing_ws()
@property
def has_fws(self):
for part in self:
if part.has_fws:
return True
return False
def has_leading_comment(self):
return self[0].has_leading_comment()
@property
def comments(self):
comments = []
for token in self:
comments.extend(token.comments)
return comments
def fold(self, **_3to2kwargs):
# max_line_length 0/None means no limit, ie: infinitely long.
policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
maxlen = policy.max_line_length or float("+inf")
folded = _Folded(maxlen, policy)
self._fold(folded)
folded.finalize()
return str(folded)
def as_encoded_word(self, charset):
# This works only for things returned by 'parts', which include
# the leading fws, if any, that should be used.
res = []
ws = self.pop_leading_fws()
if ws:
res.append(ws)
trailer = self.pop(-1) if self[-1].token_type=='fws' else ''
res.append(_ew.encode(str(self), charset))
res.append(trailer)
return ''.join(res)
def cte_encode(self, charset, policy):
res = []
for part in self:
res.append(part.cte_encode(charset, policy))
return ''.join(res)
def _fold(self, folded):
for part in self.parts:
tstr = str(part)
tlen = len(tstr)
try:
str(part).encode('us-ascii')
except UnicodeEncodeError:
if any(isinstance(x, errors.UndecodableBytesDefect)
for x in part.all_defects):
charset = 'unknown-8bit'
else:
# XXX: this should be a policy setting
charset = 'utf-8'
tstr = part.cte_encode(charset, folded.policy)
tlen = len(tstr)
if folded.append_if_fits(part, tstr):
continue
# Peel off the leading whitespace if any and make it sticky, to
# avoid infinite recursion.
ws = part.pop_leading_fws()
if ws is not None:
# Peel off the leading whitespace and make it sticky, to
# avoid infinite recursion.
folded.stickyspace = str(part.pop(0))
if folded.append_if_fits(part):
continue
if part.has_fws:
part._fold(folded)
continue
# There are no fold points in this one; it is too long for a single
# line and can't be split...we just have to put it on its own line.
folded.append(tstr)
folded.newline()
def pprint(self, indent=''):
print('\n'.join(self._pp(indent='')))
def ppstr(self, indent=''):
return '\n'.join(self._pp(indent=''))
def _pp(self, indent=''):
yield '{}{}/{}('.format(
indent,
self.__class__.__name__,
self.token_type)
for token in self:
if not hasattr(token, '_pp'):
yield (indent + ' !! invalid element in token '
'list: {!r}'.format(token))
else:
for line in token._pp(indent+' '):
yield line
if self.defects:
extra = ' Defects: {}'.format(self.defects)
else:
extra = ''
yield '{}){}'.format(indent, extra)
class WhiteSpaceTokenList(TokenList):
@property
def value(self):
return ' '
@property
def comments(self):
return [x.content for x in self if x.token_type=='comment']
class UnstructuredTokenList(TokenList):
token_type = 'unstructured'
def _fold(self, folded):
if any(x.token_type=='encoded-word' for x in self):
return self._fold_encoded(folded)
# Here we can have either a pure ASCII string that may or may not
# have surrogateescape encoded bytes, or a unicode string.
last_ew = None
for part in self.parts:
tstr = str(part)
is_ew = False
try:
str(part).encode('us-ascii')
except UnicodeEncodeError:
if any(isinstance(x, errors.UndecodableBytesDefect)
for x in part.all_defects):
charset = 'unknown-8bit'
else:
charset = 'utf-8'
if last_ew is not None:
# We've already done an EW, combine this one with it
# if there's room.
chunk = get_unstructured(
''.join(folded.current[last_ew:]+[tstr])).as_encoded_word(charset)
oldlastlen = sum(len(x) for x in folded.current[:last_ew])
schunk = str(chunk)
lchunk = len(schunk)
if oldlastlen + lchunk <= folded.maxlen:
del folded.current[last_ew:]
folded.append(schunk)
folded.lastlen = oldlastlen + lchunk
continue
tstr = part.as_encoded_word(charset)
is_ew = True
if folded.append_if_fits(part, tstr):
if is_ew:
last_ew = len(folded.current) - 1
continue
if is_ew or last_ew:
# It's too big to fit on the line, but since we've
# got encoded words we can use encoded word folding.
part._fold_as_ew(folded)
continue
# Peel off the leading whitespace if any and make it sticky, to
# avoid infinite recursion.
ws = part.pop_leading_fws()
if ws is not None:
folded.stickyspace = str(ws)
if folded.append_if_fits(part):
continue
if part.has_fws:
part.fold(folded)
continue
# It can't be split...we just have to put it on its own line.
folded.append(tstr)
folded.newline()
last_ew = None
def cte_encode(self, charset, policy):
res = []
last_ew = None
for part in self:
spart = str(part)
try:
spart.encode('us-ascii')
res.append(spart)
except UnicodeEncodeError:
if last_ew is None:
res.append(part.cte_encode(charset, policy))
last_ew = len(res)
else:
tl = get_unstructured(''.join(res[last_ew:] + [spart]))
res.append(tl.as_encoded_word())
return ''.join(res)
class Phrase(TokenList):
token_type = 'phrase'
def _fold(self, folded):
# As with Unstructured, we can have pure ASCII with or without
# surrogateescape encoded bytes, or we could have unicode. But this
# case is more complicated, since we have to deal with the various
# sub-token types and how they can be composed in the face of
# unicode-that-needs-CTE-encoding, and the fact that if a token a
# comment that becomes a barrier across which we can't compose encoded
# words.
last_ew = None
for part in self.parts:
tstr = str(part)
tlen = len(tstr)
has_ew = False
try:
str(part).encode('us-ascii')
except UnicodeEncodeError:
if any(isinstance(x, errors.UndecodableBytesDefect)
for x in part.all_defects):
charset = 'unknown-8bit'
else:
charset = 'utf-8'
if last_ew is not None and not part.has_leading_comment():
# We've already done an EW, let's see if we can combine
# this one with it. The last_ew logic ensures that all we
# have at this point is atoms, no comments or quoted
# strings. So we can treat the text between the last
# encoded word and the content of this token as
# unstructured text, and things will work correctly. But
# we have to strip off any trailing comment on this token
# first, and if it is a quoted string we have to pull out
# the content (we're encoding it, so it no longer needs to
# be quoted).
if part[-1].token_type == 'cfws' and part.comments:
remainder = part.pop(-1)
else:
remainder = ''
for i, token in enumerate(part):
if token.token_type == 'bare-quoted-string':
part[i] = UnstructuredTokenList(token[:])
chunk = get_unstructured(
''.join(folded.current[last_ew:]+[tstr])).as_encoded_word(charset)
schunk = str(chunk)
lchunk = len(schunk)
if last_ew + lchunk <= folded.maxlen:
del folded.current[last_ew:]
folded.append(schunk)
folded.lastlen = sum(len(x) for x in folded.current)
continue
tstr = part.as_encoded_word(charset)
tlen = len(tstr)
has_ew = True
if folded.append_if_fits(part, tstr):
if has_ew and not part.comments:
last_ew = len(folded.current) - 1
elif part.comments or part.token_type == 'quoted-string':
# If a comment is involved we can't combine EWs. And if a
# quoted string is involved, it's not worth the effort to
# try to combine them.
last_ew = None
continue
part._fold(folded)
def cte_encode(self, charset, policy):
res = []
last_ew = None
is_ew = False
for part in self:
spart = str(part)
try:
spart.encode('us-ascii')
res.append(spart)
except UnicodeEncodeError:
is_ew = True
if last_ew is None:
if not part.comments:
last_ew = len(res)
res.append(part.cte_encode(charset, policy))
elif not part.has_leading_comment():
if part[-1].token_type == 'cfws' and part.comments:
remainder = part.pop(-1)
else:
remainder = ''
for i, token in enumerate(part):
if token.token_type == 'bare-quoted-string':
part[i] = UnstructuredTokenList(token[:])
tl = get_unstructured(''.join(res[last_ew:] + [spart]))
res[last_ew:] = [tl.as_encoded_word(charset)]
if part.comments or (not is_ew and part.token_type == 'quoted-string'):
last_ew = None
return ''.join(res)
class Word(TokenList):
token_type = 'word'
class CFWSList(WhiteSpaceTokenList):
token_type = 'cfws'
def has_leading_comment(self):
return bool(self.comments)
class Atom(TokenList):
token_type = 'atom'
class Token(TokenList):
token_type = 'token'
class EncodedWord(TokenList):
token_type = 'encoded-word'
cte = None
charset = None
lang = None
@property
def encoded(self):
if self.cte is not None:
return self.cte
_ew.encode(str(self), self.charset)
class QuotedString(TokenList):
token_type = 'quoted-string'
@property
def content(self):
for x in self:
if x.token_type == 'bare-quoted-string':
return x.value
@property
def quoted_value(self):
res = []
for x in self:
if x.token_type == 'bare-quoted-string':
res.append(str(x))
else:
res.append(x.value)
return ''.join(res)
@property
def stripped_value(self):
for token in self:
if token.token_type == 'bare-quoted-string':
return token.value
class BareQuotedString(QuotedString):
token_type = 'bare-quoted-string'
def __str__(self):
return quote_string(''.join(str(x) for x in self))
@property
def value(self):
return ''.join(str(x) for x in self)
class Comment(WhiteSpaceTokenList):
token_type = 'comment'
def __str__(self):
return ''.join(sum([
["("],
[self.quote(x) for x in self],
[")"],
], []))
def quote(self, value):
if value.token_type == 'comment':
return str(value)
return str(value).replace('\\', '\\\\').replace(
'(', '\(').replace(
')', '\)')
@property
def content(self):
return ''.join(str(x) for x in self)
@property
def comments(self):
return [self.content]
class AddressList(TokenList):
token_type = 'address-list'
@property
def addresses(self):
return [x for x in self if x.token_type=='address']
@property
def mailboxes(self):
return sum((x.mailboxes
for x in self if x.token_type=='address'), [])
@property
def all_mailboxes(self):
return sum((x.all_mailboxes
for x in self if x.token_type=='address'), [])
class Address(TokenList):
token_type = 'address'
@property
def display_name(self):
if self[0].token_type == 'group':
return self[0].display_name
@property
def mailboxes(self):
if self[0].token_type == 'mailbox':
return [self[0]]
elif self[0].token_type == 'invalid-mailbox':
return []
return self[0].mailboxes
@property
def all_mailboxes(self):
if self[0].token_type == 'mailbox':
return [self[0]]
elif self[0].token_type == 'invalid-mailbox':
return [self[0]]
return self[0].all_mailboxes
class MailboxList(TokenList):
token_type = 'mailbox-list'
@property
def mailboxes(self):
return [x for x in self if x.token_type=='mailbox']
@property
def all_mailboxes(self):
return [x for x in self
if x.token_type in ('mailbox', 'invalid-mailbox')]
class GroupList(TokenList):
token_type = 'group-list'
@property
def mailboxes(self):
if not self or self[0].token_type != 'mailbox-list':
return []
return self[0].mailboxes
@property
def all_mailboxes(self):
if not self or self[0].token_type != 'mailbox-list':
return []
return self[0].all_mailboxes
class Group(TokenList):
token_type = "group"
@property
def mailboxes(self):
if self[2].token_type != 'group-list':
return []
return self[2].mailboxes
@property
def all_mailboxes(self):
if self[2].token_type != 'group-list':
return []
return self[2].all_mailboxes
@property
def display_name(self):
return self[0].display_name
class NameAddr(TokenList):
token_type = 'name-addr'
@property
def display_name(self):
if len(self) == 1:
return None
return self[0].display_name
@property
def local_part(self):
return self[-1].local_part
@property
def domain(self):
return self[-1].domain
@property
def route(self):
return self[-1].route
@property
def addr_spec(self):
return self[-1].addr_spec
class AngleAddr(TokenList):
token_type = 'angle-addr'
@property
def local_part(self):
for x in self:
if x.token_type == 'addr-spec':
return x.local_part
@property
def domain(self):
for x in self:
if x.token_type == 'addr-spec':
return x.domain
@property
def route(self):
for x in self:
if x.token_type == 'obs-route':
return x.domains
@property
def addr_spec(self):
for x in self:
if x.token_type == 'addr-spec':
return x.addr_spec
else:
return '<>'
class ObsRoute(TokenList):
token_type = 'obs-route'
@property
def domains(self):
return [x.domain for x in self if x.token_type == 'domain']
class Mailbox(TokenList):
token_type = 'mailbox'
@property
def display_name(self):
if self[0].token_type == 'name-addr':
return self[0].display_name
@property
def local_part(self):
return self[0].local_part
@property
def domain(self):
return self[0].domain
@property
def route(self):
if self[0].token_type == 'name-addr':
return self[0].route
@property
def addr_spec(self):
return self[0].addr_spec
class InvalidMailbox(TokenList):
token_type = 'invalid-mailbox'
@property
def display_name(self):
return None
local_part = domain = route = addr_spec = display_name
class Domain(TokenList):
token_type = 'domain'
@property
def domain(self):
return ''.join(super(Domain, self).value.split())
class DotAtom(TokenList):
token_type = 'dot-atom'
class DotAtomText(TokenList):
token_type = 'dot-atom-text'
class AddrSpec(TokenList):
token_type = 'addr-spec'
@property
def local_part(self):
return self[0].local_part
@property
def domain(self):
if len(self) < 3:
return None
return self[-1].domain
@property
def value(self):
if len(self) < 3:
return self[0].value
return self[0].value.rstrip()+self[1].value+self[2].value.lstrip()
@property
def addr_spec(self):
nameset = set(self.local_part)
if len(nameset) > len(nameset-DOT_ATOM_ENDS):
lp = quote_string(self.local_part)
else:
lp = self.local_part
if self.domain is not None:
return lp + '@' + self.domain
return lp
class ObsLocalPart(TokenList):
token_type = 'obs-local-part'
class DisplayName(Phrase):
token_type = 'display-name'
@property
def display_name(self):
res = TokenList(self)
if res[0].token_type == 'cfws':
res.pop(0)
else:
if res[0][0].token_type == 'cfws':
res[0] = TokenList(res[0][1:])
if res[-1].token_type == 'cfws':
res.pop()
else:
if res[-1][-1].token_type == 'cfws':
res[-1] = TokenList(res[-1][:-1])
return res.value
@property
def value(self):
quote = False
if self.defects:
quote = True
else:
for x in self:
if x.token_type == 'quoted-string':
quote = True
if quote:
pre = post = ''
if self[0].token_type=='cfws' or self[0][0].token_type=='cfws':
pre = ' '
if self[-1].token_type=='cfws' or self[-1][-1].token_type=='cfws':
post = ' '
return pre+quote_string(self.display_name)+post
else:
return super(DisplayName, self).value
class LocalPart(TokenList):
token_type = 'local-part'
@property
def value(self):
if self[0].token_type == "quoted-string":
return self[0].quoted_value
else:
return self[0].value
@property
def local_part(self):
# Strip whitespace from front, back, and around dots.
res = [DOT]
last = DOT
last_is_tl = False
for tok in self[0] + [DOT]:
if tok.token_type == 'cfws':
continue
if (last_is_tl and tok.token_type == 'dot' and
last[-1].token_type == 'cfws'):
res[-1] = TokenList(last[:-1])
is_tl = isinstance(tok, TokenList)
if (is_tl and last.token_type == 'dot' and
tok[0].token_type == 'cfws'):
res.append(TokenList(tok[1:]))
else:
res.append(tok)
last = res[-1]
last_is_tl = is_tl
res = TokenList(res[1:-1])
return res.value
class DomainLiteral(TokenList):
token_type = 'domain-literal'
@property
def domain(self):
return ''.join(super(DomainLiteral, self).value.split())
@property
def ip(self):
for x in self:
if x.token_type == 'ptext':
return x.value
class MIMEVersion(TokenList):
token_type = 'mime-version'
major = None
minor = None
class Parameter(TokenList):
token_type = 'parameter'
sectioned = False
extended = False
charset = 'us-ascii'
@property
def section_number(self):
# Because the first token, the attribute (name) eats CFWS, the second
# token is always the section if there is one.
return self[1].number if self.sectioned else 0
@property
def param_value(self):
# This is part of the "handle quoted extended parameters" hack.
for token in self:
if token.token_type == 'value':
return token.stripped_value
if token.token_type == 'quoted-string':
for token in token:
if token.token_type == 'bare-quoted-string':
for token in token:
if token.token_type == 'value':
return token.stripped_value
return ''
class InvalidParameter(Parameter):
token_type = 'invalid-parameter'
class Attribute(TokenList):
token_type = 'attribute'
@property
def stripped_value(self):
for token in self:
if token.token_type.endswith('attrtext'):
return token.value
class Section(TokenList):
token_type = 'section'
number = None
class Value(TokenList):
token_type = 'value'
@property
def stripped_value(self):
token = self[0]
if token.token_type == 'cfws':
token = self[1]
if token.token_type.endswith(
('quoted-string', 'attribute', 'extended-attribute')):
return token.stripped_value
return self.value
class MimeParameters(TokenList):
token_type = 'mime-parameters'
@property
def params(self):
# The RFC specifically states that the ordering of parameters is not
# guaranteed and may be reordered by the transport layer. So we have
# to assume the RFC 2231 pieces can come in any order. However, we
# output them in the order that we first see a given name, which gives
# us a stable __str__.
params = OrderedDict()
for token in self:
if not token.token_type.endswith('parameter'):
continue
if token[0].token_type != 'attribute':
continue
name = token[0].value.strip()
if name not in params:
params[name] = []
params[name].append((token.section_number, token))
for name, parts in params.items():
parts = sorted(parts)
# XXX: there might be more recovery we could do here if, for
# example, this is really a case of a duplicate attribute name.
value_parts = []
charset = parts[0][1].charset
for i, (section_number, param) in enumerate(parts):
if section_number != i:
param.defects.append(errors.InvalidHeaderDefect(
"inconsistent multipart parameter numbering"))
value = param.param_value
if param.extended:
try:
value = unquote_to_bytes(value)
except UnicodeEncodeError:
# source had surrogate escaped bytes. What we do now
# is a bit of an open question. I'm not sure this is
# the best choice, but it is what the old algorithm did
value = unquote(value, encoding='latin-1')
else:
try:
value = value.decode(charset, 'surrogateescape')
except LookupError:
# XXX: there should really be a custom defect for
# unknown character set to make it easy to find,
# because otherwise unknown charset is a silent
# failure.
value = value.decode('us-ascii', 'surrogateescape')
if utils._has_surrogates(value):
param.defects.append(errors.UndecodableBytesDefect())
value_parts.append(value)
value = ''.join(value_parts)
yield name, value
def __str__(self):
params = []
for name, value in self.params:
if value:
params.append('{}={}'.format(name, quote_string(value)))
else:
params.append(name)
params = '; '.join(params)
return ' ' + params if params else ''
class ParameterizedHeaderValue(TokenList):
@property
def params(self):
for token in reversed(self):
if token.token_type == 'mime-parameters':
return token.params
return {}
@property
def parts(self):
if self and self[-1].token_type == 'mime-parameters':
# We don't want to start a new line if all of the params don't fit
# after the value, so unwrap the parameter list.
return TokenList(self[:-1] + self[-1])
return TokenList(self).parts
class ContentType(ParameterizedHeaderValue):
token_type = 'content-type'
maintype = 'text'
subtype = 'plain'
class ContentDisposition(ParameterizedHeaderValue):
token_type = 'content-disposition'
content_disposition = None
class ContentTransferEncoding(TokenList):
token_type = 'content-transfer-encoding'
cte = '7bit'
class HeaderLabel(TokenList):
token_type = 'header-label'
class Header(TokenList):
token_type = 'header'
def _fold(self, folded):
folded.append(str(self.pop(0)))
folded.lastlen = len(folded.current[0])
# The first line of the header is different from all others: we don't
# want to start a new object on a new line if it has any fold points in
# it that would allow part of it to be on the first header line.
# Further, if the first fold point would fit on the new line, we want
# to do that, but if it doesn't we want to put it on the first line.
# Folded supports this via the stickyspace attribute. If this
# attribute is not None, it does the special handling.
folded.stickyspace = str(self.pop(0)) if self[0].token_type == 'cfws' else ''
rest = self.pop(0)
if self:
raise ValueError("Malformed Header token list")
rest._fold(folded)
#
# Terminal classes and instances
#
class Terminal(str):
def __new__(cls, value, token_type):
self = super(Terminal, cls).__new__(cls, value)
self.token_type = token_type
self.defects = []
return self
def __repr__(self):
return "{}({})".format(self.__class__.__name__, super(Terminal, self).__repr__())
@property
def all_defects(self):
return list(self.defects)
def _pp(self, indent=''):
return ["{}{}/{}({}){}".format(
indent,
self.__class__.__name__,
self.token_type,
super(Terminal, self).__repr__(),
'' if not self.defects else ' {}'.format(self.defects),
)]
def cte_encode(self, charset, policy):
value = str(self)
try:
value.encode('us-ascii')
return value
except UnicodeEncodeError:
return _ew.encode(value, charset)
def pop_trailing_ws(self):
# This terminates the recursion.
return None
def pop_leading_fws(self):
# This terminates the recursion.
return None
@property
def comments(self):
return []
def has_leading_comment(self):
return False
def __getnewargs__(self):
return(str(self), self.token_type)
class WhiteSpaceTerminal(Terminal):
@property
def value(self):
return ' '
def startswith_fws(self):
return True
has_fws = True
class ValueTerminal(Terminal):
@property
def value(self):
return self
def startswith_fws(self):
return False
has_fws = False
def as_encoded_word(self, charset):
return _ew.encode(str(self), charset)
class EWWhiteSpaceTerminal(WhiteSpaceTerminal):
@property
def value(self):
return ''
@property
def encoded(self):
return self[:]
def __str__(self):
return ''
has_fws = True
# XXX these need to become classes and used as instances so
# that a program can't change them in a parse tree and screw
# up other parse trees. Maybe should have tests for that, too.
DOT = ValueTerminal('.', 'dot')
ListSeparator = ValueTerminal(',', 'list-separator')
RouteComponentMarker = ValueTerminal('@', 'route-component-marker')
#
# Parser
#
"""Parse strings according to RFC822/2047/2822/5322 rules.
This is a stateless parser. Each get_XXX function accepts a string and
returns either a Terminal or a TokenList representing the RFC object named
by the method and a string containing the remaining unparsed characters
from the input. Thus a parser method consumes the next syntactic construct
of a given type and returns a token representing the construct plus the
unparsed remainder of the input string.
For example, if the first element of a structured header is a 'phrase',
then:
phrase, value = get_phrase(value)
returns the complete phrase from the start of the string value, plus any
characters left in the string after the phrase is removed.
"""
_wsp_splitter = re.compile(r'([{}]+)'.format(''.join(WSP))).split
_non_atom_end_matcher = re.compile(r"[^{}]+".format(
''.join(ATOM_ENDS).replace('\\','\\\\').replace(']','\]'))).match
_non_printable_finder = re.compile(r"[\x00-\x20\x7F]").findall
_non_token_end_matcher = re.compile(r"[^{}]+".format(
''.join(TOKEN_ENDS).replace('\\','\\\\').replace(']','\]'))).match
_non_attribute_end_matcher = re.compile(r"[^{}]+".format(
''.join(ATTRIBUTE_ENDS).replace('\\','\\\\').replace(']','\]'))).match
_non_extended_attribute_end_matcher = re.compile(r"[^{}]+".format(
''.join(EXTENDED_ATTRIBUTE_ENDS).replace(
'\\','\\\\').replace(']','\]'))).match
def _validate_xtext(xtext):
"""If input token contains ASCII non-printables, register a defect."""
non_printables = _non_printable_finder(xtext)
if non_printables:
xtext.defects.append(errors.NonPrintableDefect(non_printables))
if utils._has_surrogates(xtext):
xtext.defects.append(errors.UndecodableBytesDefect(
"Non-ASCII characters found in header token"))
def _get_ptext_to_endchars(value, endchars):
"""Scan printables/quoted-pairs until endchars and return unquoted ptext.
This function turns a run of qcontent, ccontent-without-comments, or
dtext-with-quoted-printables into a single string by unquoting any
quoted printables. It returns the string, the remaining value, and
a flag that is True iff there were any quoted printables decoded.
"""
_3to2list = list(_wsp_splitter(value, 1))
fragment, remainder, = _3to2list[:1] + [_3to2list[1:]]
vchars = []
escape = False
had_qp = False
for pos in range(len(fragment)):
if fragment[pos] == '\\':
if escape:
escape = False
had_qp = True
else:
escape = True
continue
if escape:
escape = False
elif fragment[pos] in endchars:
break
vchars.append(fragment[pos])
else:
pos = pos + 1
return ''.join(vchars), ''.join([fragment[pos:]] + remainder), had_qp
def _decode_ew_run(value):
""" Decode a run of RFC2047 encoded words.
_decode_ew_run(value) -> (text, value, defects)
Scans the supplied value for a run of tokens that look like they are RFC
2047 encoded words, decodes those words into text according to RFC 2047
rules (whitespace between encoded words is discarded), and returns the text
and the remaining value (including any leading whitespace on the remaining
value), as well as a list of any defects encountered while decoding. The
input value may not have any leading whitespace.
"""
res = []
defects = []
last_ws = ''
while value:
try:
tok, ws, value = _wsp_splitter(value, 1)
except ValueError:
tok, ws, value = value, '', ''
if not (tok.startswith('=?') and tok.endswith('?=')):
return ''.join(res), last_ws + tok + ws + value, defects
text, charset, lang, new_defects = _ew.decode(tok)
res.append(text)
defects.extend(new_defects)
last_ws = ws
return ''.join(res), last_ws, defects
def get_fws(value):
"""FWS = 1*WSP
This isn't the RFC definition. We're using fws to represent tokens where
folding can be done, but when we are parsing the *un*folding has already
been done so we don't need to watch out for CRLF.
"""
newvalue = value.lstrip()
fws = WhiteSpaceTerminal(value[:len(value)-len(newvalue)], 'fws')
return fws, newvalue
def get_encoded_word(value):
""" encoded-word = "=?" charset "?" encoding "?" encoded-text "?="
"""
ew = EncodedWord()
if not value.startswith('=?'):
raise errors.HeaderParseError(
"expected encoded word but found {}".format(value))
_3to2list1 = list(value[2:].split('?=', 1))
tok, remainder, = _3to2list1[:1] + [_3to2list1[1:]]
if tok == value[2:]:
raise errors.HeaderParseError(
"expected encoded word but found {}".format(value))
remstr = ''.join(remainder)
if remstr[:2].isdigit():
_3to2list3 = list(remstr.split('?=', 1))
rest, remainder, = _3to2list3[:1] + [_3to2list3[1:]]
tok = tok + '?=' + rest
if len(tok.split()) > 1:
ew.defects.append(errors.InvalidHeaderDefect(
"whitespace inside encoded word"))
ew.cte = value
value = ''.join(remainder)
try:
text, charset, lang, defects = _ew.decode('=?' + tok + '?=')
except ValueError:
raise errors.HeaderParseError(
"encoded word format invalid: '{}'".format(ew.cte))
ew.charset = charset
ew.lang = lang
ew.defects.extend(defects)
while text:
if text[0] in WSP:
token, text = get_fws(text)
ew.append(token)
continue
_3to2list5 = list(_wsp_splitter(text, 1))
chars, remainder, = _3to2list5[:1] + [_3to2list5[1:]]
vtext = ValueTerminal(chars, 'vtext')
_validate_xtext(vtext)
ew.append(vtext)
text = ''.join(remainder)
return ew, value
def get_unstructured(value):
"""unstructured = (*([FWS] vchar) *WSP) / obs-unstruct
obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS)
obs-utext = %d0 / obs-NO-WS-CTL / LF / CR
obs-NO-WS-CTL is control characters except WSP/CR/LF.
So, basically, we have printable runs, plus control characters or nulls in
the obsolete syntax, separated by whitespace. Since RFC 2047 uses the
obsolete syntax in its specification, but requires whitespace on either
side of the encoded words, I can see no reason to need to separate the
non-printable-non-whitespace from the printable runs if they occur, so we
parse this into xtext tokens separated by WSP tokens.
Because an 'unstructured' value must by definition constitute the entire
value, this 'get' routine does not return a remaining value, only the
parsed TokenList.
"""
# XXX: but what about bare CR and LF? They might signal the start or
# end of an encoded word. YAGNI for now, since out current parsers
# will never send us strings with bard CR or LF.
unstructured = UnstructuredTokenList()
while value:
if value[0] in WSP:
token, value = get_fws(value)
unstructured.append(token)
continue
if value.startswith('=?'):
try:
token, value = get_encoded_word(value)
except errors.HeaderParseError:
pass
else:
have_ws = True
if len(unstructured) > 0:
if unstructured[-1].token_type != 'fws':
unstructured.defects.append(errors.InvalidHeaderDefect(
"missing whitespace before encoded word"))
have_ws = False
if have_ws and len(unstructured) > 1:
if unstructured[-2].token_type == 'encoded-word':
unstructured[-1] = EWWhiteSpaceTerminal(
unstructured[-1], 'fws')
unstructured.append(token)
continue
_3to2list7 = list(_wsp_splitter(value, 1))
tok, remainder, = _3to2list7[:1] + [_3to2list7[1:]]
vtext = ValueTerminal(tok, 'vtext')
_validate_xtext(vtext)
unstructured.append(vtext)
value = ''.join(remainder)
return unstructured
def get_qp_ctext(value):
"""ctext = <printable ascii except \ ( )>
This is not the RFC ctext, since we are handling nested comments in comment
and unquoting quoted-pairs here. We allow anything except the '()'
characters, but if we find any ASCII other than the RFC defined printable
ASCII an NonPrintableDefect is added to the token's defects list. Since
quoted pairs are converted to their unquoted values, what is returned is
a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value
is ' '.
"""
ptext, value, _ = _get_ptext_to_endchars(value, '()')
ptext = WhiteSpaceTerminal(ptext, 'ptext')
_validate_xtext(ptext)
return ptext, value
def get_qcontent(value):
"""qcontent = qtext / quoted-pair
We allow anything except the DQUOTE character, but if we find any ASCII
other than the RFC defined printable ASCII an NonPrintableDefect is
added to the token's defects list. Any quoted pairs are converted to their
unquoted values, so what is returned is a 'ptext' token. In this case it
is a ValueTerminal.
"""
ptext, value, _ = _get_ptext_to_endchars(value, '"')
ptext = ValueTerminal(ptext, 'ptext')
_validate_xtext(ptext)
return ptext, value
def get_atext(value):
"""atext = <matches _atext_matcher>
We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to
the token's defects list if we find non-atext characters.
"""
m = _non_atom_end_matcher(value)
if not m:
raise errors.HeaderParseError(
"expected atext but found '{}'".format(value))
atext = m.group()
value = value[len(atext):]
atext = ValueTerminal(atext, 'atext')
_validate_xtext(atext)
return atext, value
def get_bare_quoted_string(value):
"""bare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE
A quoted-string without the leading or trailing white space. Its
value is the text between the quote marks, with whitespace
preserved and quoted pairs decoded.
"""
if value[0] != '"':
raise errors.HeaderParseError(
"expected '\"' but found '{}'".format(value))
bare_quoted_string = BareQuotedString()
value = value[1:]
while value and value[0] != '"':
if value[0] in WSP:
token, value = get_fws(value)
else:
token, value = get_qcontent(value)
bare_quoted_string.append(token)
if not value:
bare_quoted_string.defects.append(errors.InvalidHeaderDefect(
"end of header inside quoted string"))
return bare_quoted_string, value
return bare_quoted_string, value[1:]
def get_comment(value):
"""comment = "(" *([FWS] ccontent) [FWS] ")"
ccontent = ctext / quoted-pair / comment
We handle nested comments here, and quoted-pair in our qp-ctext routine.
"""
if value and value[0] != '(':
raise errors.HeaderParseError(
"expected '(' but found '{}'".format(value))
comment = Comment()
value = value[1:]
while value and value[0] != ")":
if value[0] in WSP:
token, value = get_fws(value)
elif value[0] == '(':
token, value = get_comment(value)
else:
token, value = get_qp_ctext(value)
comment.append(token)
if not value:
comment.defects.append(errors.InvalidHeaderDefect(
"end of header inside comment"))
return comment, value
return comment, value[1:]
def get_cfws(value):
"""CFWS = (1*([FWS] comment) [FWS]) / FWS
"""
cfws = CFWSList()
while value and value[0] in CFWS_LEADER:
if value[0] in WSP:
token, value = get_fws(value)
else:
token, value = get_comment(value)
cfws.append(token)
return cfws, value
def get_quoted_string(value):
"""quoted-string = [CFWS] <bare-quoted-string> [CFWS]
'bare-quoted-string' is an intermediate class defined by this
parser and not by the RFC grammar. It is the quoted string
without any attached CFWS.
"""
quoted_string = QuotedString()
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
quoted_string.append(token)
token, value = get_bare_quoted_string(value)
quoted_string.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
quoted_string.append(token)
return quoted_string, value
def get_atom(value):
"""atom = [CFWS] 1*atext [CFWS]
"""
atom = Atom()
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
atom.append(token)
if value and value[0] in ATOM_ENDS:
raise errors.HeaderParseError(
"expected atom but found '{}'".format(value))
token, value = get_atext(value)
atom.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
atom.append(token)
return atom, value
def get_dot_atom_text(value):
""" dot-text = 1*atext *("." 1*atext)
"""
dot_atom_text = DotAtomText()
if not value or value[0] in ATOM_ENDS:
raise errors.HeaderParseError("expected atom at a start of "
"dot-atom-text but found '{}'".format(value))
while value and value[0] not in ATOM_ENDS:
token, value = get_atext(value)
dot_atom_text.append(token)
if value and value[0] == '.':
dot_atom_text.append(DOT)
value = value[1:]
if dot_atom_text[-1] is DOT:
raise errors.HeaderParseError("expected atom at end of dot-atom-text "
"but found '{}'".format('.'+value))
return dot_atom_text, value
def get_dot_atom(value):
""" dot-atom = [CFWS] dot-atom-text [CFWS]
"""
dot_atom = DotAtom()
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
dot_atom.append(token)
token, value = get_dot_atom_text(value)
dot_atom.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
dot_atom.append(token)
return dot_atom, value
def get_word(value):
"""word = atom / quoted-string
Either atom or quoted-string may start with CFWS. We have to peel off this
CFWS first to determine which type of word to parse. Afterward we splice
the leading CFWS, if any, into the parsed sub-token.
If neither an atom or a quoted-string is found before the next special, a
HeaderParseError is raised.
The token returned is either an Atom or a QuotedString, as appropriate.
This means the 'word' level of the formal grammar is not represented in the
parse tree; this is because having that extra layer when manipulating the
parse tree is more confusing than it is helpful.
"""
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
else:
leader = None
if value[0]=='"':
token, value = get_quoted_string(value)
elif value[0] in SPECIALS:
raise errors.HeaderParseError("Expected 'atom' or 'quoted-string' "
"but found '{}'".format(value))
else:
token, value = get_atom(value)
if leader is not None:
token[:0] = [leader]
return token, value
def get_phrase(value):
""" phrase = 1*word / obs-phrase
obs-phrase = word *(word / "." / CFWS)
This means a phrase can be a sequence of words, periods, and CFWS in any
order as long as it starts with at least one word. If anything other than
words is detected, an ObsoleteHeaderDefect is added to the token's defect
list. We also accept a phrase that starts with CFWS followed by a dot;
this is registered as an InvalidHeaderDefect, since it is not supported by
even the obsolete grammar.
"""
phrase = Phrase()
try:
token, value = get_word(value)
phrase.append(token)
except errors.HeaderParseError:
phrase.defects.append(errors.InvalidHeaderDefect(
"phrase does not start with word"))
while value and value[0] not in PHRASE_ENDS:
if value[0]=='.':
phrase.append(DOT)
phrase.defects.append(errors.ObsoleteHeaderDefect(
"period in 'phrase'"))
value = value[1:]
else:
try:
token, value = get_word(value)
except errors.HeaderParseError:
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
phrase.defects.append(errors.ObsoleteHeaderDefect(
"comment found without atom"))
else:
raise
phrase.append(token)
return phrase, value
def get_local_part(value):
""" local-part = dot-atom / quoted-string / obs-local-part
"""
local_part = LocalPart()
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
raise errors.HeaderParseError(
"expected local-part but found '{}'".format(value))
try:
token, value = get_dot_atom(value)
except errors.HeaderParseError:
try:
token, value = get_word(value)
except errors.HeaderParseError:
if value[0] != '\\' and value[0] in PHRASE_ENDS:
raise
token = TokenList()
if leader is not None:
token[:0] = [leader]
local_part.append(token)
if value and (value[0]=='\\' or value[0] not in PHRASE_ENDS):
obs_local_part, value = get_obs_local_part(str(local_part) + value)
if obs_local_part.token_type == 'invalid-obs-local-part':
local_part.defects.append(errors.InvalidHeaderDefect(
"local-part is not dot-atom, quoted-string, or obs-local-part"))
else:
local_part.defects.append(errors.ObsoleteHeaderDefect(
"local-part is not a dot-atom (contains CFWS)"))
local_part[0] = obs_local_part
try:
local_part.value.encode('ascii')
except UnicodeEncodeError:
local_part.defects.append(errors.NonASCIILocalPartDefect(
"local-part contains non-ASCII characters)"))
return local_part, value
def get_obs_local_part(value):
""" obs-local-part = word *("." word)
"""
obs_local_part = ObsLocalPart()
last_non_ws_was_dot = False
while value and (value[0]=='\\' or value[0] not in PHRASE_ENDS):
if value[0] == '.':
if last_non_ws_was_dot:
obs_local_part.defects.append(errors.InvalidHeaderDefect(
"invalid repeated '.'"))
obs_local_part.append(DOT)
last_non_ws_was_dot = True
value = value[1:]
continue
elif value[0]=='\\':
obs_local_part.append(ValueTerminal(value[0],
'misplaced-special'))
value = value[1:]
obs_local_part.defects.append(errors.InvalidHeaderDefect(
"'\\' character outside of quoted-string/ccontent"))
last_non_ws_was_dot = False
continue
if obs_local_part and obs_local_part[-1].token_type != 'dot':
obs_local_part.defects.append(errors.InvalidHeaderDefect(
"missing '.' between words"))
try:
token, value = get_word(value)
last_non_ws_was_dot = False
except errors.HeaderParseError:
if value[0] not in CFWS_LEADER:
raise
token, value = get_cfws(value)
obs_local_part.append(token)
if (obs_local_part[0].token_type == 'dot' or
obs_local_part[0].token_type=='cfws' and
obs_local_part[1].token_type=='dot'):
obs_local_part.defects.append(errors.InvalidHeaderDefect(
"Invalid leading '.' in local part"))
if (obs_local_part[-1].token_type == 'dot' or
obs_local_part[-1].token_type=='cfws' and
obs_local_part[-2].token_type=='dot'):
obs_local_part.defects.append(errors.InvalidHeaderDefect(
"Invalid trailing '.' in local part"))
if obs_local_part.defects:
obs_local_part.token_type = 'invalid-obs-local-part'
return obs_local_part, value
def get_dtext(value):
""" dtext = <printable ascii except \ [ ]> / obs-dtext
obs-dtext = obs-NO-WS-CTL / quoted-pair
We allow anything except the excluded characters, but if we find any
ASCII other than the RFC defined printable ASCII an NonPrintableDefect is
added to the token's defects list. Quoted pairs are converted to their
unquoted values, so what is returned is a ptext token, in this case a
ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is
added to the returned token's defect list.
"""
ptext, value, had_qp = _get_ptext_to_endchars(value, '[]')
ptext = ValueTerminal(ptext, 'ptext')
if had_qp:
ptext.defects.append(errors.ObsoleteHeaderDefect(
"quoted printable found in domain-literal"))
_validate_xtext(ptext)
return ptext, value
def _check_for_early_dl_end(value, domain_literal):
if value:
return False
domain_literal.append(errors.InvalidHeaderDefect(
"end of input inside domain-literal"))
domain_literal.append(ValueTerminal(']', 'domain-literal-end'))
return True
def get_domain_literal(value):
""" domain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS]
"""
domain_literal = DomainLiteral()
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
domain_literal.append(token)
if not value:
raise errors.HeaderParseError("expected domain-literal")
if value[0] != '[':
raise errors.HeaderParseError("expected '[' at start of domain-literal "
"but found '{}'".format(value))
value = value[1:]
if _check_for_early_dl_end(value, domain_literal):
return domain_literal, value
domain_literal.append(ValueTerminal('[', 'domain-literal-start'))
if value[0] in WSP:
token, value = get_fws(value)
domain_literal.append(token)
token, value = get_dtext(value)
domain_literal.append(token)
if _check_for_early_dl_end(value, domain_literal):
return domain_literal, value
if value[0] in WSP:
token, value = get_fws(value)
domain_literal.append(token)
if _check_for_early_dl_end(value, domain_literal):
return domain_literal, value
if value[0] != ']':
raise errors.HeaderParseError("expected ']' at end of domain-literal "
"but found '{}'".format(value))
domain_literal.append(ValueTerminal(']', 'domain-literal-end'))
value = value[1:]
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
domain_literal.append(token)
return domain_literal, value
def get_domain(value):
""" domain = dot-atom / domain-literal / obs-domain
obs-domain = atom *("." atom))
"""
domain = Domain()
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
raise errors.HeaderParseError(
"expected domain but found '{}'".format(value))
if value[0] == '[':
token, value = get_domain_literal(value)
if leader is not None:
token[:0] = [leader]
domain.append(token)
return domain, value
try:
token, value = get_dot_atom(value)
except errors.HeaderParseError:
token, value = get_atom(value)
if leader is not None:
token[:0] = [leader]
domain.append(token)
if value and value[0] == '.':
domain.defects.append(errors.ObsoleteHeaderDefect(
"domain is not a dot-atom (contains CFWS)"))
if domain[0].token_type == 'dot-atom':
domain[:] = domain[0]
while value and value[0] == '.':
domain.append(DOT)
token, value = get_atom(value[1:])
domain.append(token)
return domain, value
def get_addr_spec(value):
""" addr-spec = local-part "@" domain
"""
addr_spec = AddrSpec()
token, value = get_local_part(value)
addr_spec.append(token)
if not value or value[0] != '@':
addr_spec.defects.append(errors.InvalidHeaderDefect(
"add-spec local part with no domain"))
return addr_spec, value
addr_spec.append(ValueTerminal('@', 'address-at-symbol'))
token, value = get_domain(value[1:])
addr_spec.append(token)
return addr_spec, value
def get_obs_route(value):
""" obs-route = obs-domain-list ":"
obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain])
Returns an obs-route token with the appropriate sub-tokens (that is,
there is no obs-domain-list in the parse tree).
"""
obs_route = ObsRoute()
while value and (value[0]==',' or value[0] in CFWS_LEADER):
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
obs_route.append(token)
elif value[0] == ',':
obs_route.append(ListSeparator)
value = value[1:]
if not value or value[0] != '@':
raise errors.HeaderParseError(
"expected obs-route domain but found '{}'".format(value))
obs_route.append(RouteComponentMarker)
token, value = get_domain(value[1:])
obs_route.append(token)
while value and value[0]==',':
obs_route.append(ListSeparator)
value = value[1:]
if not value:
break
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
obs_route.append(token)
if value[0] == '@':
obs_route.append(RouteComponentMarker)
token, value = get_domain(value[1:])
obs_route.append(token)
if not value:
raise errors.HeaderParseError("end of header while parsing obs-route")
if value[0] != ':':
raise errors.HeaderParseError( "expected ':' marking end of "
"obs-route but found '{}'".format(value))
obs_route.append(ValueTerminal(':', 'end-of-obs-route-marker'))
return obs_route, value[1:]
def get_angle_addr(value):
""" angle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr
obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS]
"""
angle_addr = AngleAddr()
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
angle_addr.append(token)
if not value or value[0] != '<':
raise errors.HeaderParseError(
"expected angle-addr but found '{}'".format(value))
angle_addr.append(ValueTerminal('<', 'angle-addr-start'))
value = value[1:]
# Although it is not legal per RFC5322, SMTP uses '<>' in certain
# circumstances.
if value[0] == '>':
angle_addr.append(ValueTerminal('>', 'angle-addr-end'))
angle_addr.defects.append(errors.InvalidHeaderDefect(
"null addr-spec in angle-addr"))
value = value[1:]
return angle_addr, value
try:
token, value = get_addr_spec(value)
except errors.HeaderParseError:
try:
token, value = get_obs_route(value)
angle_addr.defects.append(errors.ObsoleteHeaderDefect(
"obsolete route specification in angle-addr"))
except errors.HeaderParseError:
raise errors.HeaderParseError(
"expected addr-spec or obs-route but found '{}'".format(value))
angle_addr.append(token)
token, value = get_addr_spec(value)
angle_addr.append(token)
if value and value[0] == '>':
value = value[1:]
else:
angle_addr.defects.append(errors.InvalidHeaderDefect(
"missing trailing '>' on angle-addr"))
angle_addr.append(ValueTerminal('>', 'angle-addr-end'))
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
angle_addr.append(token)
return angle_addr, value
def get_display_name(value):
""" display-name = phrase
Because this is simply a name-rule, we don't return a display-name
token containing a phrase, but rather a display-name token with
the content of the phrase.
"""
display_name = DisplayName()
token, value = get_phrase(value)
display_name.extend(token[:])
display_name.defects = token.defects[:]
return display_name, value
def get_name_addr(value):
""" name-addr = [display-name] angle-addr
"""
name_addr = NameAddr()
# Both the optional display name and the angle-addr can start with cfws.
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
raise errors.HeaderParseError(
"expected name-addr but found '{}'".format(leader))
if value[0] != '<':
if value[0] in PHRASE_ENDS:
raise errors.HeaderParseError(
"expected name-addr but found '{}'".format(value))
token, value = get_display_name(value)
if not value:
raise errors.HeaderParseError(
"expected name-addr but found '{}'".format(token))
if leader is not None:
token[0][:0] = [leader]
leader = None
name_addr.append(token)
token, value = get_angle_addr(value)
if leader is not None:
token[:0] = [leader]
name_addr.append(token)
return name_addr, value
def get_mailbox(value):
""" mailbox = name-addr / addr-spec
"""
# The only way to figure out if we are dealing with a name-addr or an
# addr-spec is to try parsing each one.
mailbox = Mailbox()
try:
token, value = get_name_addr(value)
except errors.HeaderParseError:
try:
token, value = get_addr_spec(value)
except errors.HeaderParseError:
raise errors.HeaderParseError(
"expected mailbox but found '{}'".format(value))
if any(isinstance(x, errors.InvalidHeaderDefect)
for x in token.all_defects):
mailbox.token_type = 'invalid-mailbox'
mailbox.append(token)
return mailbox, value
def get_invalid_mailbox(value, endchars):
""" Read everything up to one of the chars in endchars.
This is outside the formal grammar. The InvalidMailbox TokenList that is
returned acts like a Mailbox, but the data attributes are None.
"""
invalid_mailbox = InvalidMailbox()
while value and value[0] not in endchars:
if value[0] in PHRASE_ENDS:
invalid_mailbox.append(ValueTerminal(value[0],
'misplaced-special'))
value = value[1:]
else:
token, value = get_phrase(value)
invalid_mailbox.append(token)
return invalid_mailbox, value
def get_mailbox_list(value):
""" mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list
obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS])
For this routine we go outside the formal grammar in order to improve error
handling. We recognize the end of the mailbox list only at the end of the
value or at a ';' (the group terminator). This is so that we can turn
invalid mailboxes into InvalidMailbox tokens and continue parsing any
remaining valid mailboxes. We also allow all mailbox entries to be null,
and this condition is handled appropriately at a higher level.
"""
mailbox_list = MailboxList()
while value and value[0] != ';':
try:
token, value = get_mailbox(value)
mailbox_list.append(token)
except errors.HeaderParseError:
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value or value[0] in ',;':
mailbox_list.append(leader)
mailbox_list.defects.append(errors.ObsoleteHeaderDefect(
"empty element in mailbox-list"))
else:
token, value = get_invalid_mailbox(value, ',;')
if leader is not None:
token[:0] = [leader]
mailbox_list.append(token)
mailbox_list.defects.append(errors.InvalidHeaderDefect(
"invalid mailbox in mailbox-list"))
elif value[0] == ',':
mailbox_list.defects.append(errors.ObsoleteHeaderDefect(
"empty element in mailbox-list"))
else:
token, value = get_invalid_mailbox(value, ',;')
if leader is not None:
token[:0] = [leader]
mailbox_list.append(token)
mailbox_list.defects.append(errors.InvalidHeaderDefect(
"invalid mailbox in mailbox-list"))
if value and value[0] not in ',;':
# Crap after mailbox; treat it as an invalid mailbox.
# The mailbox info will still be available.
mailbox = mailbox_list[-1]
mailbox.token_type = 'invalid-mailbox'
token, value = get_invalid_mailbox(value, ',;')
mailbox.extend(token)
mailbox_list.defects.append(errors.InvalidHeaderDefect(
"invalid mailbox in mailbox-list"))
if value and value[0] == ',':
mailbox_list.append(ListSeparator)
value = value[1:]
return mailbox_list, value
def get_group_list(value):
""" group-list = mailbox-list / CFWS / obs-group-list
obs-group-list = 1*([CFWS] ",") [CFWS]
"""
group_list = GroupList()
if not value:
group_list.defects.append(errors.InvalidHeaderDefect(
"end of header before group-list"))
return group_list, value
leader = None
if value and value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
# This should never happen in email parsing, since CFWS-only is a
# legal alternative to group-list in a group, which is the only
# place group-list appears.
group_list.defects.append(errors.InvalidHeaderDefect(
"end of header in group-list"))
group_list.append(leader)
return group_list, value
if value[0] == ';':
group_list.append(leader)
return group_list, value
token, value = get_mailbox_list(value)
if len(token.all_mailboxes)==0:
if leader is not None:
group_list.append(leader)
group_list.extend(token)
group_list.defects.append(errors.ObsoleteHeaderDefect(
"group-list with empty entries"))
return group_list, value
if leader is not None:
token[:0] = [leader]
group_list.append(token)
return group_list, value
def get_group(value):
""" group = display-name ":" [group-list] ";" [CFWS]
"""
group = Group()
token, value = get_display_name(value)
if not value or value[0] != ':':
raise errors.HeaderParseError("expected ':' at end of group "
"display name but found '{}'".format(value))
group.append(token)
group.append(ValueTerminal(':', 'group-display-name-terminator'))
value = value[1:]
if value and value[0] == ';':
group.append(ValueTerminal(';', 'group-terminator'))
return group, value[1:]
token, value = get_group_list(value)
group.append(token)
if not value:
group.defects.append(errors.InvalidHeaderDefect(
"end of header in group"))
if value[0] != ';':
raise errors.HeaderParseError(
"expected ';' at end of group but found {}".format(value))
group.append(ValueTerminal(';', 'group-terminator'))
value = value[1:]
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
group.append(token)
return group, value
def get_address(value):
""" address = mailbox / group
Note that counter-intuitively, an address can be either a single address or
a list of addresses (a group). This is why the returned Address object has
a 'mailboxes' attribute which treats a single address as a list of length
one. When you need to differentiate between to two cases, extract the single
element, which is either a mailbox or a group token.
"""
# The formal grammar isn't very helpful when parsing an address. mailbox
# and group, especially when allowing for obsolete forms, start off very
# similarly. It is only when you reach one of @, <, or : that you know
# what you've got. So, we try each one in turn, starting with the more
# likely of the two. We could perhaps make this more efficient by looking
# for a phrase and then branching based on the next character, but that
# would be a premature optimization.
address = Address()
try:
token, value = get_group(value)
except errors.HeaderParseError:
try:
token, value = get_mailbox(value)
except errors.HeaderParseError:
raise errors.HeaderParseError(
"expected address but found '{}'".format(value))
address.append(token)
return address, value
def get_address_list(value):
""" address_list = (address *("," address)) / obs-addr-list
obs-addr-list = *([CFWS] ",") address *("," [address / CFWS])
We depart from the formal grammar here by continuing to parse until the end
of the input, assuming the input to be entirely composed of an
address-list. This is always true in email parsing, and allows us
to skip invalid addresses to parse additional valid ones.
"""
address_list = AddressList()
while value:
try:
token, value = get_address(value)
address_list.append(token)
except errors.HeaderParseError as err:
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value or value[0] == ',':
address_list.append(leader)
address_list.defects.append(errors.ObsoleteHeaderDefect(
"address-list entry with no content"))
else:
token, value = get_invalid_mailbox(value, ',')
if leader is not None:
token[:0] = [leader]
address_list.append(Address([token]))
address_list.defects.append(errors.InvalidHeaderDefect(
"invalid address in address-list"))
elif value[0] == ',':
address_list.defects.append(errors.ObsoleteHeaderDefect(
"empty element in address-list"))
else:
token, value = get_invalid_mailbox(value, ',')
if leader is not None:
token[:0] = [leader]
address_list.append(Address([token]))
address_list.defects.append(errors.InvalidHeaderDefect(
"invalid address in address-list"))
if value and value[0] != ',':
# Crap after address; treat it as an invalid mailbox.
# The mailbox info will still be available.
mailbox = address_list[-1][0]
mailbox.token_type = 'invalid-mailbox'
token, value = get_invalid_mailbox(value, ',')
mailbox.extend(token)
address_list.defects.append(errors.InvalidHeaderDefect(
"invalid address in address-list"))
if value: # Must be a , at this point.
address_list.append(ValueTerminal(',', 'list-separator'))
value = value[1:]
return address_list, value
#
# XXX: As I begin to add additional header parsers, I'm realizing we probably
# have two level of parser routines: the get_XXX methods that get a token in
# the grammar, and parse_XXX methods that parse an entire field value. So
# get_address_list above should really be a parse_ method, as probably should
# be get_unstructured.
#
def parse_mime_version(value):
""" mime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS]
"""
# The [CFWS] is implicit in the RFC 2045 BNF.
# XXX: This routine is a bit verbose, should factor out a get_int method.
mime_version = MIMEVersion()
if not value:
mime_version.defects.append(errors.HeaderMissingRequiredValue(
"Missing MIME version number (eg: 1.0)"))
return mime_version
if value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mime_version.append(token)
if not value:
mime_version.defects.append(errors.HeaderMissingRequiredValue(
"Expected MIME version number but found only CFWS"))
digits = ''
while value and value[0] != '.' and value[0] not in CFWS_LEADER:
digits += value[0]
value = value[1:]
if not digits.isdigit():
mime_version.defects.append(errors.InvalidHeaderDefect(
"Expected MIME major version number but found {!r}".format(digits)))
mime_version.append(ValueTerminal(digits, 'xtext'))
else:
mime_version.major = int(digits)
mime_version.append(ValueTerminal(digits, 'digits'))
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mime_version.append(token)
if not value or value[0] != '.':
if mime_version.major is not None:
mime_version.defects.append(errors.InvalidHeaderDefect(
"Incomplete MIME version; found only major number"))
if value:
mime_version.append(ValueTerminal(value, 'xtext'))
return mime_version
mime_version.append(ValueTerminal('.', 'version-separator'))
value = value[1:]
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mime_version.append(token)
if not value:
if mime_version.major is not None:
mime_version.defects.append(errors.InvalidHeaderDefect(
"Incomplete MIME version; found only major number"))
return mime_version
digits = ''
while value and value[0] not in CFWS_LEADER:
digits += value[0]
value = value[1:]
if not digits.isdigit():
mime_version.defects.append(errors.InvalidHeaderDefect(
"Expected MIME minor version number but found {!r}".format(digits)))
mime_version.append(ValueTerminal(digits, 'xtext'))
else:
mime_version.minor = int(digits)
mime_version.append(ValueTerminal(digits, 'digits'))
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mime_version.append(token)
if value:
mime_version.defects.append(errors.InvalidHeaderDefect(
"Excess non-CFWS text after MIME version"))
mime_version.append(ValueTerminal(value, 'xtext'))
return mime_version
def get_invalid_parameter(value):
""" Read everything up to the next ';'.
This is outside the formal grammar. The InvalidParameter TokenList that is
returned acts like a Parameter, but the data attributes are None.
"""
invalid_parameter = InvalidParameter()
while value and value[0] != ';':
if value[0] in PHRASE_ENDS:
invalid_parameter.append(ValueTerminal(value[0],
'misplaced-special'))
value = value[1:]
else:
token, value = get_phrase(value)
invalid_parameter.append(token)
return invalid_parameter, value
def get_ttext(value):
"""ttext = <matches _ttext_matcher>
We allow any non-TOKEN_ENDS in ttext, but add defects to the token's
defects list if we find non-ttext characters. We also register defects for
*any* non-printables even though the RFC doesn't exclude all of them,
because we follow the spirit of RFC 5322.
"""
m = _non_token_end_matcher(value)
if not m:
raise errors.HeaderParseError(
"expected ttext but found '{}'".format(value))
ttext = m.group()
value = value[len(ttext):]
ttext = ValueTerminal(ttext, 'ttext')
_validate_xtext(ttext)
return ttext, value
def get_token(value):
"""token = [CFWS] 1*ttext [CFWS]
The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or
tspecials. We also exclude tabs even though the RFC doesn't.
The RFC implies the CFWS but is not explicit about it in the BNF.
"""
mtoken = Token()
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mtoken.append(token)
if value and value[0] in TOKEN_ENDS:
raise errors.HeaderParseError(
"expected token but found '{}'".format(value))
token, value = get_ttext(value)
mtoken.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
mtoken.append(token)
return mtoken, value
def get_attrtext(value):
"""attrtext = 1*(any non-ATTRIBUTE_ENDS character)
We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the
token's defects list if we find non-attrtext characters. We also register
defects for *any* non-printables even though the RFC doesn't exclude all of
them, because we follow the spirit of RFC 5322.
"""
m = _non_attribute_end_matcher(value)
if not m:
raise errors.HeaderParseError(
"expected attrtext but found {!r}".format(value))
attrtext = m.group()
value = value[len(attrtext):]
attrtext = ValueTerminal(attrtext, 'attrtext')
_validate_xtext(attrtext)
return attrtext, value
def get_attribute(value):
""" [CFWS] 1*attrtext [CFWS]
This version of the BNF makes the CFWS explicit, and as usual we use a
value terminal for the actual run of characters. The RFC equivalent of
attrtext is the token characters, with the subtraction of '*', "'", and '%'.
We include tab in the excluded set just as we do for token.
"""
attribute = Attribute()
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
attribute.append(token)
if value and value[0] in ATTRIBUTE_ENDS:
raise errors.HeaderParseError(
"expected token but found '{}'".format(value))
token, value = get_attrtext(value)
attribute.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
attribute.append(token)
return attribute, value
def get_extended_attrtext(value):
"""attrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%')
This is a special parsing routine so that we get a value that
includes % escapes as a single string (which we decode as a single
string later).
"""
m = _non_extended_attribute_end_matcher(value)
if not m:
raise errors.HeaderParseError(
"expected extended attrtext but found {!r}".format(value))
attrtext = m.group()
value = value[len(attrtext):]
attrtext = ValueTerminal(attrtext, 'extended-attrtext')
_validate_xtext(attrtext)
return attrtext, value
def get_extended_attribute(value):
""" [CFWS] 1*extended_attrtext [CFWS]
This is like the non-extended version except we allow % characters, so that
we can pick up an encoded value as a single string.
"""
# XXX: should we have an ExtendedAttribute TokenList?
attribute = Attribute()
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
attribute.append(token)
if value and value[0] in EXTENDED_ATTRIBUTE_ENDS:
raise errors.HeaderParseError(
"expected token but found '{}'".format(value))
token, value = get_extended_attrtext(value)
attribute.append(token)
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
attribute.append(token)
return attribute, value
def get_section(value):
""" '*' digits
The formal BNF is more complicated because leading 0s are not allowed. We
check for that and add a defect. We also assume no CFWS is allowed between
the '*' and the digits, though the RFC is not crystal clear on that.
The caller should already have dealt with leading CFWS.
"""
section = Section()
if not value or value[0] != '*':
raise errors.HeaderParseError("Expected section but found {}".format(
value))
section.append(ValueTerminal('*', 'section-marker'))
value = value[1:]
if not value or not value[0].isdigit():
raise errors.HeaderParseError("Expected section number but "
"found {}".format(value))
digits = ''
while value and value[0].isdigit():
digits += value[0]
value = value[1:]
if digits[0] == '0' and digits != '0':
section.defects.append(errors.InvalidHeaderError("section number"
"has an invalid leading 0"))
section.number = int(digits)
section.append(ValueTerminal(digits, 'digits'))
return section, value
def get_value(value):
""" quoted-string / attribute
"""
v = Value()
if not value:
raise errors.HeaderParseError("Expected value but found end of string")
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
raise errors.HeaderParseError("Expected value but found "
"only {}".format(leader))
if value[0] == '"':
token, value = get_quoted_string(value)
else:
token, value = get_extended_attribute(value)
if leader is not None:
token[:0] = [leader]
v.append(token)
return v, value
def get_parameter(value):
""" attribute [section] ["*"] [CFWS] "=" value
The CFWS is implied by the RFC but not made explicit in the BNF. This
simplified form of the BNF from the RFC is made to conform with the RFC BNF
through some extra checks. We do it this way because it makes both error
recovery and working with the resulting parse tree easier.
"""
# It is possible CFWS would also be implicitly allowed between the section
# and the 'extended-attribute' marker (the '*') , but we've never seen that
# in the wild and we will therefore ignore the possibility.
param = Parameter()
token, value = get_attribute(value)
param.append(token)
if not value or value[0] == ';':
param.defects.append(errors.InvalidHeaderDefect("Parameter contains "
"name ({}) but no value".format(token)))
return param, value
if value[0] == '*':
try:
token, value = get_section(value)
param.sectioned = True
param.append(token)
except errors.HeaderParseError:
pass
if not value:
raise errors.HeaderParseError("Incomplete parameter")
if value[0] == '*':
param.append(ValueTerminal('*', 'extended-parameter-marker'))
value = value[1:]
param.extended = True
if value[0] != '=':
raise errors.HeaderParseError("Parameter not followed by '='")
param.append(ValueTerminal('=', 'parameter-separator'))
value = value[1:]
leader = None
if value and value[0] in CFWS_LEADER:
token, value = get_cfws(value)
param.append(token)
remainder = None
appendto = param
if param.extended and value and value[0] == '"':
# Now for some serious hackery to handle the common invalid case of
# double quotes around an extended value. We also accept (with defect)
# a value marked as encoded that isn't really.
qstring, remainder = get_quoted_string(value)
inner_value = qstring.stripped_value
semi_valid = False
if param.section_number == 0:
if inner_value and inner_value[0] == "'":
semi_valid = True
else:
token, rest = get_attrtext(inner_value)
if rest and rest[0] == "'":
semi_valid = True
else:
try:
token, rest = get_extended_attrtext(inner_value)
except:
pass
else:
if not rest:
semi_valid = True
if semi_valid:
param.defects.append(errors.InvalidHeaderDefect(
"Quoted string value for extended parameter is invalid"))
param.append(qstring)
for t in qstring:
if t.token_type == 'bare-quoted-string':
t[:] = []
appendto = t
break
value = inner_value
else:
remainder = None
param.defects.append(errors.InvalidHeaderDefect(
"Parameter marked as extended but appears to have a "
"quoted string value that is non-encoded"))
if value and value[0] == "'":
token = None
else:
token, value = get_value(value)
if not param.extended or param.section_number > 0:
if not value or value[0] != "'":
appendto.append(token)
if remainder is not None:
assert not value, value
value = remainder
return param, value
param.defects.append(errors.InvalidHeaderDefect(
"Apparent initial-extended-value but attribute "
"was not marked as extended or was not initial section"))
if not value:
# Assume the charset/lang is missing and the token is the value.
param.defects.append(errors.InvalidHeaderDefect(
"Missing required charset/lang delimiters"))
appendto.append(token)
if remainder is None:
return param, value
else:
if token is not None:
for t in token:
if t.token_type == 'extended-attrtext':
break
t.token_type == 'attrtext'
appendto.append(t)
param.charset = t.value
if value[0] != "'":
raise errors.HeaderParseError("Expected RFC2231 char/lang encoding "
"delimiter, but found {!r}".format(value))
appendto.append(ValueTerminal("'", 'RFC2231 delimiter'))
value = value[1:]
if value and value[0] != "'":
token, value = get_attrtext(value)
appendto.append(token)
param.lang = token.value
if not value or value[0] != "'":
raise errors.HeaderParseError("Expected RFC2231 char/lang encoding "
"delimiter, but found {}".format(value))
appendto.append(ValueTerminal("'", 'RFC2231 delimiter'))
value = value[1:]
if remainder is not None:
# Treat the rest of value as bare quoted string content.
v = Value()
while value:
if value[0] in WSP:
token, value = get_fws(value)
else:
token, value = get_qcontent(value)
v.append(token)
token = v
else:
token, value = get_value(value)
appendto.append(token)
if remainder is not None:
assert not value, value
value = remainder
return param, value
def parse_mime_parameters(value):
""" parameter *( ";" parameter )
That BNF is meant to indicate this routine should only be called after
finding and handling the leading ';'. There is no corresponding rule in
the formal RFC grammar, but it is more convenient for us for the set of
parameters to be treated as its own TokenList.
This is 'parse' routine because it consumes the reminaing value, but it
would never be called to parse a full header. Instead it is called to
parse everything after the non-parameter value of a specific MIME header.
"""
mime_parameters = MimeParameters()
while value:
try:
token, value = get_parameter(value)
mime_parameters.append(token)
except errors.HeaderParseError as err:
leader = None
if value[0] in CFWS_LEADER:
leader, value = get_cfws(value)
if not value:
mime_parameters.append(leader)
return mime_parameters
if value[0] == ';':
if leader is not None:
mime_parameters.append(leader)
mime_parameters.defects.append(errors.InvalidHeaderDefect(
"parameter entry with no content"))
else:
token, value = get_invalid_parameter(value)
if leader:
token[:0] = [leader]
mime_parameters.append(token)
mime_parameters.defects.append(errors.InvalidHeaderDefect(
"invalid parameter {!r}".format(token)))
if value and value[0] != ';':
# Junk after the otherwise valid parameter. Mark it as
# invalid, but it will have a value.
param = mime_parameters[-1]
param.token_type = 'invalid-parameter'
token, value = get_invalid_parameter(value)
param.extend(token)
mime_parameters.defects.append(errors.InvalidHeaderDefect(
"parameter with invalid trailing text {!r}".format(token)))
if value:
# Must be a ';' at this point.
mime_parameters.append(ValueTerminal(';', 'parameter-separator'))
value = value[1:]
return mime_parameters
def _find_mime_parameters(tokenlist, value):
"""Do our best to find the parameters in an invalid MIME header
"""
while value and value[0] != ';':
if value[0] in PHRASE_ENDS:
tokenlist.append(ValueTerminal(value[0], 'misplaced-special'))
value = value[1:]
else:
token, value = get_phrase(value)
tokenlist.append(token)
if not value:
return
tokenlist.append(ValueTerminal(';', 'parameter-separator'))
tokenlist.append(parse_mime_parameters(value[1:]))
def parse_content_type_header(value):
""" maintype "/" subtype *( ";" parameter )
The maintype and substype are tokens. Theoretically they could
be checked against the official IANA list + x-token, but we
don't do that.
"""
ctype = ContentType()
recover = False
if not value:
ctype.defects.append(errors.HeaderMissingRequiredValue(
"Missing content type specification"))
return ctype
try:
token, value = get_token(value)
except errors.HeaderParseError:
ctype.defects.append(errors.InvalidHeaderDefect(
"Expected content maintype but found {!r}".format(value)))
_find_mime_parameters(ctype, value)
return ctype
ctype.append(token)
# XXX: If we really want to follow the formal grammar we should make
# mantype and subtype specialized TokenLists here. Probably not worth it.
if not value or value[0] != '/':
ctype.defects.append(errors.InvalidHeaderDefect(
"Invalid content type"))
if value:
_find_mime_parameters(ctype, value)
return ctype
ctype.maintype = token.value.strip().lower()
ctype.append(ValueTerminal('/', 'content-type-separator'))
value = value[1:]
try:
token, value = get_token(value)
except errors.HeaderParseError:
ctype.defects.append(errors.InvalidHeaderDefect(
"Expected content subtype but found {!r}".format(value)))
_find_mime_parameters(ctype, value)
return ctype
ctype.append(token)
ctype.subtype = token.value.strip().lower()
if not value:
return ctype
if value[0] != ';':
ctype.defects.append(errors.InvalidHeaderDefect(
"Only parameters are valid after content type, but "
"found {!r}".format(value)))
# The RFC requires that a syntactically invalid content-type be treated
# as text/plain. Perhaps we should postel this, but we should probably
# only do that if we were checking the subtype value against IANA.
del ctype.maintype, ctype.subtype
_find_mime_parameters(ctype, value)
return ctype
ctype.append(ValueTerminal(';', 'parameter-separator'))
ctype.append(parse_mime_parameters(value[1:]))
return ctype
def parse_content_disposition_header(value):
""" disposition-type *( ";" parameter )
"""
disp_header = ContentDisposition()
if not value:
disp_header.defects.append(errors.HeaderMissingRequiredValue(
"Missing content disposition"))
return disp_header
try:
token, value = get_token(value)
except errors.HeaderParseError:
ctype.defects.append(errors.InvalidHeaderDefect(
"Expected content disposition but found {!r}".format(value)))
_find_mime_parameters(disp_header, value)
return disp_header
disp_header.append(token)
disp_header.content_disposition = token.value.strip().lower()
if not value:
return disp_header
if value[0] != ';':
disp_header.defects.append(errors.InvalidHeaderDefect(
"Only parameters are valid after content disposition, but "
"found {!r}".format(value)))
_find_mime_parameters(disp_header, value)
return disp_header
disp_header.append(ValueTerminal(';', 'parameter-separator'))
disp_header.append(parse_mime_parameters(value[1:]))
return disp_header
def parse_content_transfer_encoding_header(value):
""" mechanism
"""
# We should probably validate the values, since the list is fixed.
cte_header = ContentTransferEncoding()
if not value:
cte_header.defects.append(errors.HeaderMissingRequiredValue(
"Missing content transfer encoding"))
return cte_header
try:
token, value = get_token(value)
except errors.HeaderParseError:
ctype.defects.append(errors.InvalidHeaderDefect(
"Expected content trnasfer encoding but found {!r}".format(value)))
else:
cte_header.append(token)
cte_header.cte = token.value.strip().lower()
if not value:
return cte_header
while value:
cte_header.defects.append(errors.InvalidHeaderDefect(
"Extra text after content transfer encoding"))
if value[0] in PHRASE_ENDS:
cte_header.append(ValueTerminal(value[0], 'misplaced-special'))
value = value[1:]
else:
token, value = get_phrase(value)
cte_header.append(token)
return cte_header
PK jDu\7L�� D D ! future/backports/email/charset.pynu �[��� from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import str
from future.builtins import next
# Copyright (C) 2001-2007 Python Software Foundation
# Author: Ben Gertzfield, Barry Warsaw
# Contact: email-sig@python.org
__all__ = [
'Charset',
'add_alias',
'add_charset',
'add_codec',
]
from functools import partial
from future.backports import email
from future.backports.email import errors
from future.backports.email.encoders import encode_7or8bit
# Flags for types of header encodings
QP = 1 # Quoted-Printable
BASE64 = 2 # Base64
SHORTEST = 3 # the shorter of QP and base64, but only for headers
# In "=?charset?q?hello_world?=", the =?, ?q?, and ?= add up to 7
RFC2047_CHROME_LEN = 7
DEFAULT_CHARSET = 'us-ascii'
UNKNOWN8BIT = 'unknown-8bit'
EMPTYSTRING = ''
# Defaults
CHARSETS = {
# input header enc body enc output conv
'iso-8859-1': (QP, QP, None),
'iso-8859-2': (QP, QP, None),
'iso-8859-3': (QP, QP, None),
'iso-8859-4': (QP, QP, None),
# iso-8859-5 is Cyrillic, and not especially used
# iso-8859-6 is Arabic, also not particularly used
# iso-8859-7 is Greek, QP will not make it readable
# iso-8859-8 is Hebrew, QP will not make it readable
'iso-8859-9': (QP, QP, None),
'iso-8859-10': (QP, QP, None),
# iso-8859-11 is Thai, QP will not make it readable
'iso-8859-13': (QP, QP, None),
'iso-8859-14': (QP, QP, None),
'iso-8859-15': (QP, QP, None),
'iso-8859-16': (QP, QP, None),
'windows-1252':(QP, QP, None),
'viscii': (QP, QP, None),
'us-ascii': (None, None, None),
'big5': (BASE64, BASE64, None),
'gb2312': (BASE64, BASE64, None),
'euc-jp': (BASE64, None, 'iso-2022-jp'),
'shift_jis': (BASE64, None, 'iso-2022-jp'),
'iso-2022-jp': (BASE64, None, None),
'koi8-r': (BASE64, BASE64, None),
'utf-8': (SHORTEST, BASE64, 'utf-8'),
}
# Aliases for other commonly-used names for character sets. Map
# them to the real ones used in email.
ALIASES = {
'latin_1': 'iso-8859-1',
'latin-1': 'iso-8859-1',
'latin_2': 'iso-8859-2',
'latin-2': 'iso-8859-2',
'latin_3': 'iso-8859-3',
'latin-3': 'iso-8859-3',
'latin_4': 'iso-8859-4',
'latin-4': 'iso-8859-4',
'latin_5': 'iso-8859-9',
'latin-5': 'iso-8859-9',
'latin_6': 'iso-8859-10',
'latin-6': 'iso-8859-10',
'latin_7': 'iso-8859-13',
'latin-7': 'iso-8859-13',
'latin_8': 'iso-8859-14',
'latin-8': 'iso-8859-14',
'latin_9': 'iso-8859-15',
'latin-9': 'iso-8859-15',
'latin_10':'iso-8859-16',
'latin-10':'iso-8859-16',
'cp949': 'ks_c_5601-1987',
'euc_jp': 'euc-jp',
'euc_kr': 'euc-kr',
'ascii': 'us-ascii',
}
# Map charsets to their Unicode codec strings.
CODEC_MAP = {
'gb2312': 'eucgb2312_cn',
'big5': 'big5_tw',
# Hack: We don't want *any* conversion for stuff marked us-ascii, as all
# sorts of garbage might be sent to us in the guise of 7-bit us-ascii.
# Let that stuff pass through without conversion to/from Unicode.
'us-ascii': None,
}
# Convenience functions for extending the above mappings
def add_charset(charset, header_enc=None, body_enc=None, output_charset=None):
"""Add character set properties to the global registry.
charset is the input character set, and must be the canonical name of a
character set.
Optional header_enc and body_enc is either Charset.QP for
quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for
the shortest of qp or base64 encoding, or None for no encoding. SHORTEST
is only valid for header_enc. It describes how message headers and
message bodies in the input charset are to be encoded. Default is no
encoding.
Optional output_charset is the character set that the output should be
in. Conversions will proceed from input charset, to Unicode, to the
output charset when the method Charset.convert() is called. The default
is to output in the same character set as the input.
Both input_charset and output_charset must have Unicode codec entries in
the module's charset-to-codec mapping; use add_codec(charset, codecname)
to add codecs the module does not know about. See the codecs module's
documentation for more information.
"""
if body_enc == SHORTEST:
raise ValueError('SHORTEST not allowed for body_enc')
CHARSETS[charset] = (header_enc, body_enc, output_charset)
def add_alias(alias, canonical):
"""Add a character set alias.
alias is the alias name, e.g. latin-1
canonical is the character set's canonical name, e.g. iso-8859-1
"""
ALIASES[alias] = canonical
def add_codec(charset, codecname):
"""Add a codec that map characters in the given charset to/from Unicode.
charset is the canonical name of a character set. codecname is the name
of a Python codec, as appropriate for the second argument to the unicode()
built-in, or to the encode() method of a Unicode string.
"""
CODEC_MAP[charset] = codecname
# Convenience function for encoding strings, taking into account
# that they might be unknown-8bit (ie: have surrogate-escaped bytes)
def _encode(string, codec):
string = str(string)
if codec == UNKNOWN8BIT:
return string.encode('ascii', 'surrogateescape')
else:
return string.encode(codec)
class Charset(object):
"""Map character sets to their email properties.
This class provides information about the requirements imposed on email
for a specific character set. It also provides convenience routines for
converting between character sets, given the availability of the
applicable codecs. Given a character set, it will do its best to provide
information on how to use that character set in an email in an
RFC-compliant way.
Certain character sets must be encoded with quoted-printable or base64
when used in email headers or bodies. Certain character sets must be
converted outright, and are not allowed in email. Instances of this
module expose the following information about a character set:
input_charset: The initial character set specified. Common aliases
are converted to their `official' email names (e.g. latin_1
is converted to iso-8859-1). Defaults to 7-bit us-ascii.
header_encoding: If the character set must be encoded before it can be
used in an email header, this attribute will be set to
Charset.QP (for quoted-printable), Charset.BASE64 (for
base64 encoding), or Charset.SHORTEST for the shortest of
QP or BASE64 encoding. Otherwise, it will be None.
body_encoding: Same as header_encoding, but describes the encoding for the
mail message's body, which indeed may be different than the
header encoding. Charset.SHORTEST is not allowed for
body_encoding.
output_charset: Some character sets must be converted before they can be
used in email headers or bodies. If the input_charset is
one of them, this attribute will contain the name of the
charset output will be converted to. Otherwise, it will
be None.
input_codec: The name of the Python codec used to convert the
input_charset to Unicode. If no conversion codec is
necessary, this attribute will be None.
output_codec: The name of the Python codec used to convert Unicode
to the output_charset. If no conversion codec is necessary,
this attribute will have the same value as the input_codec.
"""
def __init__(self, input_charset=DEFAULT_CHARSET):
# RFC 2046, $4.1.2 says charsets are not case sensitive. We coerce to
# unicode because its .lower() is locale insensitive. If the argument
# is already a unicode, we leave it at that, but ensure that the
# charset is ASCII, as the standard (RFC XXX) requires.
try:
if isinstance(input_charset, str):
input_charset.encode('ascii')
else:
input_charset = str(input_charset, 'ascii')
except UnicodeError:
raise errors.CharsetError(input_charset)
input_charset = input_charset.lower()
# Set the input charset after filtering through the aliases
self.input_charset = ALIASES.get(input_charset, input_charset)
# We can try to guess which encoding and conversion to use by the
# charset_map dictionary. Try that first, but let the user override
# it.
henc, benc, conv = CHARSETS.get(self.input_charset,
(SHORTEST, BASE64, None))
if not conv:
conv = self.input_charset
# Set the attributes, allowing the arguments to override the default.
self.header_encoding = henc
self.body_encoding = benc
self.output_charset = ALIASES.get(conv, conv)
# Now set the codecs. If one isn't defined for input_charset,
# guess and try a Unicode codec with the same name as input_codec.
self.input_codec = CODEC_MAP.get(self.input_charset,
self.input_charset)
self.output_codec = CODEC_MAP.get(self.output_charset,
self.output_charset)
def __str__(self):
return self.input_charset.lower()
__repr__ = __str__
def __eq__(self, other):
return str(self) == str(other).lower()
def __ne__(self, other):
return not self.__eq__(other)
def get_body_encoding(self):
"""Return the content-transfer-encoding used for body encoding.
This is either the string `quoted-printable' or `base64' depending on
the encoding used, or it is a function in which case you should call
the function with a single argument, the Message object being
encoded. The function should then set the Content-Transfer-Encoding
header itself to whatever is appropriate.
Returns "quoted-printable" if self.body_encoding is QP.
Returns "base64" if self.body_encoding is BASE64.
Returns conversion function otherwise.
"""
assert self.body_encoding != SHORTEST
if self.body_encoding == QP:
return 'quoted-printable'
elif self.body_encoding == BASE64:
return 'base64'
else:
return encode_7or8bit
def get_output_charset(self):
"""Return the output character set.
This is self.output_charset if that is not None, otherwise it is
self.input_charset.
"""
return self.output_charset or self.input_charset
def header_encode(self, string):
"""Header-encode a string by converting it first to bytes.
The type of encoding (base64 or quoted-printable) will be based on
this charset's `header_encoding`.
:param string: A unicode string for the header. It must be possible
to encode this string to bytes using the character set's
output codec.
:return: The encoded string, with RFC 2047 chrome.
"""
codec = self.output_codec or 'us-ascii'
header_bytes = _encode(string, codec)
# 7bit/8bit encodings return the string unchanged (modulo conversions)
encoder_module = self._get_encoder(header_bytes)
if encoder_module is None:
return string
return encoder_module.header_encode(header_bytes, codec)
def header_encode_lines(self, string, maxlengths):
"""Header-encode a string by converting it first to bytes.
This is similar to `header_encode()` except that the string is fit
into maximum line lengths as given by the argument.
:param string: A unicode string for the header. It must be possible
to encode this string to bytes using the character set's
output codec.
:param maxlengths: Maximum line length iterator. Each element
returned from this iterator will provide the next maximum line
length. This parameter is used as an argument to built-in next()
and should never be exhausted. The maximum line lengths should
not count the RFC 2047 chrome. These line lengths are only a
hint; the splitter does the best it can.
:return: Lines of encoded strings, each with RFC 2047 chrome.
"""
# See which encoding we should use.
codec = self.output_codec or 'us-ascii'
header_bytes = _encode(string, codec)
encoder_module = self._get_encoder(header_bytes)
encoder = partial(encoder_module.header_encode, charset=codec)
# Calculate the number of characters that the RFC 2047 chrome will
# contribute to each line.
charset = self.get_output_charset()
extra = len(charset) + RFC2047_CHROME_LEN
# Now comes the hard part. We must encode bytes but we can't split on
# bytes because some character sets are variable length and each
# encoded word must stand on its own. So the problem is you have to
# encode to bytes to figure out this word's length, but you must split
# on characters. This causes two problems: first, we don't know how
# many octets a specific substring of unicode characters will get
# encoded to, and second, we don't know how many ASCII characters
# those octets will get encoded to. Unless we try it. Which seems
# inefficient. In the interest of being correct rather than fast (and
# in the hope that there will be few encoded headers in any such
# message), brute force it. :(
lines = []
current_line = []
maxlen = next(maxlengths) - extra
for character in string:
current_line.append(character)
this_line = EMPTYSTRING.join(current_line)
length = encoder_module.header_length(_encode(this_line, charset))
if length > maxlen:
# This last character doesn't fit so pop it off.
current_line.pop()
# Does nothing fit on the first line?
if not lines and not current_line:
lines.append(None)
else:
separator = (' ' if lines else '')
joined_line = EMPTYSTRING.join(current_line)
header_bytes = _encode(joined_line, codec)
lines.append(encoder(header_bytes))
current_line = [character]
maxlen = next(maxlengths) - extra
joined_line = EMPTYSTRING.join(current_line)
header_bytes = _encode(joined_line, codec)
lines.append(encoder(header_bytes))
return lines
def _get_encoder(self, header_bytes):
if self.header_encoding == BASE64:
return email.base64mime
elif self.header_encoding == QP:
return email.quoprimime
elif self.header_encoding == SHORTEST:
len64 = email.base64mime.header_length(header_bytes)
lenqp = email.quoprimime.header_length(header_bytes)
if len64 < lenqp:
return email.base64mime
else:
return email.quoprimime
else:
return None
def body_encode(self, string):
"""Body-encode a string by converting it first to bytes.
The type of encoding (base64 or quoted-printable) will be based on
self.body_encoding. If body_encoding is None, we assume the
output charset is a 7bit encoding, so re-encoding the decoded
string using the ascii codec produces the correct string version
of the content.
"""
if not string:
return string
if self.body_encoding is BASE64:
if isinstance(string, str):
string = string.encode(self.output_charset)
return email.base64mime.body_encode(string)
elif self.body_encoding is QP:
# quopromime.body_encode takes a string, but operates on it as if
# it were a list of byte codes. For a (minimal) history on why
# this is so, see changeset 0cf700464177. To correctly encode a
# character set, then, we must turn it into pseudo bytes via the
# latin1 charset, which will encode any byte as a single code point
# between 0 and 255, which is what body_encode is expecting.
if isinstance(string, str):
string = string.encode(self.output_charset)
string = string.decode('latin1')
return email.quoprimime.body_encode(string)
else:
if isinstance(string, str):
string = string.encode(self.output_charset).decode('ascii')
return string
PK lDu\髠��X �X $ future/backports/email/feedparser.pynu �[��� # Copyright (C) 2004-2006 Python Software Foundation
# Authors: Baxter, Wouters and Warsaw
# Contact: email-sig@python.org
"""FeedParser - An email feed parser.
The feed parser implements an interface for incrementally parsing an email
message, line by line. This has advantages for certain applications, such as
those reading email messages off a socket.
FeedParser.feed() is the primary interface for pushing new data into the
parser. It returns when there's nothing more it can do with the available
data. When you have no more data to push into the parser, call .close().
This completes the parsing and returns the root message object.
The other advantage of this parser is that it will never raise a parsing
exception. Instead, when it finds something unexpected, it adds a 'defect' to
the current message. Defects are just instances that live on the message
object's .defects attribute.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import object, range, super
from future.utils import implements_iterator, PY3
__all__ = ['FeedParser', 'BytesFeedParser']
import re
from future.backports.email import errors
from future.backports.email import message
from future.backports.email._policybase import compat32
NLCRE = re.compile('\r\n|\r|\n')
NLCRE_bol = re.compile('(\r\n|\r|\n)')
NLCRE_eol = re.compile('(\r\n|\r|\n)\Z')
NLCRE_crack = re.compile('(\r\n|\r|\n)')
# RFC 2822 $3.6.8 Optional fields. ftext is %d33-57 / %d59-126, Any character
# except controls, SP, and ":".
headerRE = re.compile(r'^(From |[\041-\071\073-\176]{1,}:|[\t ])')
EMPTYSTRING = ''
NL = '\n'
NeedMoreData = object()
# @implements_iterator
class BufferedSubFile(object):
"""A file-ish object that can have new data loaded into it.
You can also push and pop line-matching predicates onto a stack. When the
current predicate matches the current line, a false EOF response
(i.e. empty string) is returned instead. This lets the parser adhere to a
simple abstraction -- it parses until EOF closes the current message.
"""
def __init__(self):
# The last partial line pushed into this object.
self._partial = ''
# The list of full, pushed lines, in reverse order
self._lines = []
# The stack of false-EOF checking predicates.
self._eofstack = []
# A flag indicating whether the file has been closed or not.
self._closed = False
def push_eof_matcher(self, pred):
self._eofstack.append(pred)
def pop_eof_matcher(self):
return self._eofstack.pop()
def close(self):
# Don't forget any trailing partial line.
self._lines.append(self._partial)
self._partial = ''
self._closed = True
def readline(self):
if not self._lines:
if self._closed:
return ''
return NeedMoreData
# Pop the line off the stack and see if it matches the current
# false-EOF predicate.
line = self._lines.pop()
# RFC 2046, section 5.1.2 requires us to recognize outer level
# boundaries at any level of inner nesting. Do this, but be sure it's
# in the order of most to least nested.
for ateof in self._eofstack[::-1]:
if ateof(line):
# We're at the false EOF. But push the last line back first.
self._lines.append(line)
return ''
return line
def unreadline(self, line):
# Let the consumer push a line back into the buffer.
assert line is not NeedMoreData
self._lines.append(line)
def push(self, data):
"""Push some new data into this object."""
# Handle any previous leftovers
data, self._partial = self._partial + data, ''
# Crack into lines, but preserve the newlines on the end of each
parts = NLCRE_crack.split(data)
# The *ahem* interesting behaviour of re.split when supplied grouping
# parentheses is that the last element of the resulting list is the
# data after the final RE. In the case of a NL/CR terminated string,
# this is the empty string.
self._partial = parts.pop()
#GAN 29Mar09 bugs 1555570, 1721862 Confusion at 8K boundary ending with \r:
# is there a \n to follow later?
if not self._partial and parts and parts[-1].endswith('\r'):
self._partial = parts.pop(-2)+parts.pop()
# parts is a list of strings, alternating between the line contents
# and the eol character(s). Gather up a list of lines after
# re-attaching the newlines.
lines = []
for i in range(len(parts) // 2):
lines.append(parts[i*2] + parts[i*2+1])
self.pushlines(lines)
def pushlines(self, lines):
# Reverse and insert at the front of the lines.
self._lines[:0] = lines[::-1]
def __iter__(self):
return self
def __next__(self):
line = self.readline()
if line == '':
raise StopIteration
return line
class FeedParser(object):
"""A feed-style parser of email."""
def __init__(self, _factory=message.Message, **_3to2kwargs):
if 'policy' in _3to2kwargs: policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
else: policy = compat32
"""_factory is called with no arguments to create a new message obj
The policy keyword specifies a policy object that controls a number of
aspects of the parser's operation. The default policy maintains
backward compatibility.
"""
self._factory = _factory
self.policy = policy
try:
_factory(policy=self.policy)
self._factory_kwds = lambda: {'policy': self.policy}
except TypeError:
# Assume this is an old-style factory
self._factory_kwds = lambda: {}
self._input = BufferedSubFile()
self._msgstack = []
if PY3:
self._parse = self._parsegen().__next__
else:
self._parse = self._parsegen().next
self._cur = None
self._last = None
self._headersonly = False
# Non-public interface for supporting Parser's headersonly flag
def _set_headersonly(self):
self._headersonly = True
def feed(self, data):
"""Push more data into the parser."""
self._input.push(data)
self._call_parse()
def _call_parse(self):
try:
self._parse()
except StopIteration:
pass
def close(self):
"""Parse all remaining data and return the root message object."""
self._input.close()
self._call_parse()
root = self._pop_message()
assert not self._msgstack
# Look for final set of defects
if root.get_content_maintype() == 'multipart' \
and not root.is_multipart():
defect = errors.MultipartInvariantViolationDefect()
self.policy.handle_defect(root, defect)
return root
def _new_message(self):
msg = self._factory(**self._factory_kwds())
if self._cur and self._cur.get_content_type() == 'multipart/digest':
msg.set_default_type('message/rfc822')
if self._msgstack:
self._msgstack[-1].attach(msg)
self._msgstack.append(msg)
self._cur = msg
self._last = msg
def _pop_message(self):
retval = self._msgstack.pop()
if self._msgstack:
self._cur = self._msgstack[-1]
else:
self._cur = None
return retval
def _parsegen(self):
# Create a new message and start by parsing headers.
self._new_message()
headers = []
# Collect the headers, searching for a line that doesn't match the RFC
# 2822 header or continuation pattern (including an empty line).
for line in self._input:
if line is NeedMoreData:
yield NeedMoreData
continue
if not headerRE.match(line):
# If we saw the RFC defined header/body separator
# (i.e. newline), just throw it away. Otherwise the line is
# part of the body so push it back.
if not NLCRE.match(line):
defect = errors.MissingHeaderBodySeparatorDefect()
self.policy.handle_defect(self._cur, defect)
self._input.unreadline(line)
break
headers.append(line)
# Done with the headers, so parse them and figure out what we're
# supposed to see in the body of the message.
self._parse_headers(headers)
# Headers-only parsing is a backwards compatibility hack, which was
# necessary in the older parser, which could raise errors. All
# remaining lines in the input are thrown into the message body.
if self._headersonly:
lines = []
while True:
line = self._input.readline()
if line is NeedMoreData:
yield NeedMoreData
continue
if line == '':
break
lines.append(line)
self._cur.set_payload(EMPTYSTRING.join(lines))
return
if self._cur.get_content_type() == 'message/delivery-status':
# message/delivery-status contains blocks of headers separated by
# a blank line. We'll represent each header block as a separate
# nested message object, but the processing is a bit different
# than standard message/* types because there is no body for the
# nested messages. A blank line separates the subparts.
while True:
self._input.push_eof_matcher(NLCRE.match)
for retval in self._parsegen():
if retval is NeedMoreData:
yield NeedMoreData
continue
break
msg = self._pop_message()
# We need to pop the EOF matcher in order to tell if we're at
# the end of the current file, not the end of the last block
# of message headers.
self._input.pop_eof_matcher()
# The input stream must be sitting at the newline or at the
# EOF. We want to see if we're at the end of this subpart, so
# first consume the blank line, then test the next line to see
# if we're at this subpart's EOF.
while True:
line = self._input.readline()
if line is NeedMoreData:
yield NeedMoreData
continue
break
while True:
line = self._input.readline()
if line is NeedMoreData:
yield NeedMoreData
continue
break
if line == '':
break
# Not at EOF so this is a line we're going to need.
self._input.unreadline(line)
return
if self._cur.get_content_maintype() == 'message':
# The message claims to be a message/* type, then what follows is
# another RFC 2822 message.
for retval in self._parsegen():
if retval is NeedMoreData:
yield NeedMoreData
continue
break
self._pop_message()
return
if self._cur.get_content_maintype() == 'multipart':
boundary = self._cur.get_boundary()
if boundary is None:
# The message /claims/ to be a multipart but it has not
# defined a boundary. That's a problem which we'll handle by
# reading everything until the EOF and marking the message as
# defective.
defect = errors.NoBoundaryInMultipartDefect()
self.policy.handle_defect(self._cur, defect)
lines = []
for line in self._input:
if line is NeedMoreData:
yield NeedMoreData
continue
lines.append(line)
self._cur.set_payload(EMPTYSTRING.join(lines))
return
# Make sure a valid content type was specified per RFC 2045:6.4.
if (self._cur.get('content-transfer-encoding', '8bit').lower()
not in ('7bit', '8bit', 'binary')):
defect = errors.InvalidMultipartContentTransferEncodingDefect()
self.policy.handle_defect(self._cur, defect)
# Create a line match predicate which matches the inter-part
# boundary as well as the end-of-multipart boundary. Don't push
# this onto the input stream until we've scanned past the
# preamble.
separator = '--' + boundary
boundaryre = re.compile(
'(?P<sep>' + re.escape(separator) +
r')(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$')
capturing_preamble = True
preamble = []
linesep = False
close_boundary_seen = False
while True:
line = self._input.readline()
if line is NeedMoreData:
yield NeedMoreData
continue
if line == '':
break
mo = boundaryre.match(line)
if mo:
# If we're looking at the end boundary, we're done with
# this multipart. If there was a newline at the end of
# the closing boundary, then we need to initialize the
# epilogue with the empty string (see below).
if mo.group('end'):
close_boundary_seen = True
linesep = mo.group('linesep')
break
# We saw an inter-part boundary. Were we in the preamble?
if capturing_preamble:
if preamble:
# According to RFC 2046, the last newline belongs
# to the boundary.
lastline = preamble[-1]
eolmo = NLCRE_eol.search(lastline)
if eolmo:
preamble[-1] = lastline[:-len(eolmo.group(0))]
self._cur.preamble = EMPTYSTRING.join(preamble)
capturing_preamble = False
self._input.unreadline(line)
continue
# We saw a boundary separating two parts. Consume any
# multiple boundary lines that may be following. Our
# interpretation of RFC 2046 BNF grammar does not produce
# body parts within such double boundaries.
while True:
line = self._input.readline()
if line is NeedMoreData:
yield NeedMoreData
continue
mo = boundaryre.match(line)
if not mo:
self._input.unreadline(line)
break
# Recurse to parse this subpart; the input stream points
# at the subpart's first line.
self._input.push_eof_matcher(boundaryre.match)
for retval in self._parsegen():
if retval is NeedMoreData:
yield NeedMoreData
continue
break
# Because of RFC 2046, the newline preceding the boundary
# separator actually belongs to the boundary, not the
# previous subpart's payload (or epilogue if the previous
# part is a multipart).
if self._last.get_content_maintype() == 'multipart':
epilogue = self._last.epilogue
if epilogue == '':
self._last.epilogue = None
elif epilogue is not None:
mo = NLCRE_eol.search(epilogue)
if mo:
end = len(mo.group(0))
self._last.epilogue = epilogue[:-end]
else:
payload = self._last._payload
if isinstance(payload, str):
mo = NLCRE_eol.search(payload)
if mo:
payload = payload[:-len(mo.group(0))]
self._last._payload = payload
self._input.pop_eof_matcher()
self._pop_message()
# Set the multipart up for newline cleansing, which will
# happen if we're in a nested multipart.
self._last = self._cur
else:
# I think we must be in the preamble
assert capturing_preamble
preamble.append(line)
# We've seen either the EOF or the end boundary. If we're still
# capturing the preamble, we never saw the start boundary. Note
# that as a defect and store the captured text as the payload.
if capturing_preamble:
defect = errors.StartBoundaryNotFoundDefect()
self.policy.handle_defect(self._cur, defect)
self._cur.set_payload(EMPTYSTRING.join(preamble))
epilogue = []
for line in self._input:
if line is NeedMoreData:
yield NeedMoreData
continue
self._cur.epilogue = EMPTYSTRING.join(epilogue)
return
# If we're not processing the preamble, then we might have seen
# EOF without seeing that end boundary...that is also a defect.
if not close_boundary_seen:
defect = errors.CloseBoundaryNotFoundDefect()
self.policy.handle_defect(self._cur, defect)
return
# Everything from here to the EOF is epilogue. If the end boundary
# ended in a newline, we'll need to make sure the epilogue isn't
# None
if linesep:
epilogue = ['']
else:
epilogue = []
for line in self._input:
if line is NeedMoreData:
yield NeedMoreData
continue
epilogue.append(line)
# Any CRLF at the front of the epilogue is not technically part of
# the epilogue. Also, watch out for an empty string epilogue,
# which means a single newline.
if epilogue:
firstline = epilogue[0]
bolmo = NLCRE_bol.match(firstline)
if bolmo:
epilogue[0] = firstline[len(bolmo.group(0)):]
self._cur.epilogue = EMPTYSTRING.join(epilogue)
return
# Otherwise, it's some non-multipart type, so the entire rest of the
# file contents becomes the payload.
lines = []
for line in self._input:
if line is NeedMoreData:
yield NeedMoreData
continue
lines.append(line)
self._cur.set_payload(EMPTYSTRING.join(lines))
def _parse_headers(self, lines):
# Passed a list of lines that make up the headers for the current msg
lastheader = ''
lastvalue = []
for lineno, line in enumerate(lines):
# Check for continuation
if line[0] in ' \t':
if not lastheader:
# The first line of the headers was a continuation. This
# is illegal, so let's note the defect, store the illegal
# line, and ignore it for purposes of headers.
defect = errors.FirstHeaderLineIsContinuationDefect(line)
self.policy.handle_defect(self._cur, defect)
continue
lastvalue.append(line)
continue
if lastheader:
self._cur.set_raw(*self.policy.header_source_parse(lastvalue))
lastheader, lastvalue = '', []
# Check for envelope header, i.e. unix-from
if line.startswith('From '):
if lineno == 0:
# Strip off the trailing newline
mo = NLCRE_eol.search(line)
if mo:
line = line[:-len(mo.group(0))]
self._cur.set_unixfrom(line)
continue
elif lineno == len(lines) - 1:
# Something looking like a unix-from at the end - it's
# probably the first line of the body, so push back the
# line and stop.
self._input.unreadline(line)
return
else:
# Weirdly placed unix-from line. Note this as a defect
# and ignore it.
defect = errors.MisplacedEnvelopeHeaderDefect(line)
self._cur.defects.append(defect)
continue
# Split the line on the colon separating field name from value.
# There will always be a colon, because if there wasn't the part of
# the parser that calls us would have started parsing the body.
i = line.find(':')
assert i>0, "_parse_headers fed line with no : and no leading WS"
lastheader = line[:i]
lastvalue = [line]
# Done with all the lines, so handle the last header.
if lastheader:
self._cur.set_raw(*self.policy.header_source_parse(lastvalue))
class BytesFeedParser(FeedParser):
"""Like FeedParser, but feed accepts bytes."""
def feed(self, data):
super().feed(data.decode('ascii', 'surrogateescape'))
PK oDu\��@L @L # future/backports/email/generator.pynu �[��� # Copyright (C) 2001-2010 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Classes to generate plain text from a message object tree."""
from __future__ import print_function
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
from future.builtins import str
__all__ = ['Generator', 'DecodedGenerator', 'BytesGenerator']
import re
import sys
import time
import random
import warnings
from io import StringIO, BytesIO
from future.backports.email._policybase import compat32
from future.backports.email.header import Header
from future.backports.email.utils import _has_surrogates
import future.backports.email.charset as _charset
UNDERSCORE = '_'
NL = '\n' # XXX: no longer used by the code below.
fcre = re.compile(r'^From ', re.MULTILINE)
class Generator(object):
"""Generates output from a Message object tree.
This basic generator writes the message to the given file object as plain
text.
"""
#
# Public interface
#
def __init__(self, outfp, mangle_from_=True, maxheaderlen=None, **_3to2kwargs):
if 'policy' in _3to2kwargs: policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
else: policy = None
"""Create the generator for message flattening.
outfp is the output file-like object for writing the message to. It
must have a write() method.
Optional mangle_from_ is a flag that, when True (the default), escapes
From_ lines in the body of the message by putting a `>' in front of
them.
Optional maxheaderlen specifies the longest length for a non-continued
header. When a header line is longer (in characters, with tabs
expanded to 8 spaces) than maxheaderlen, the header will split as
defined in the Header class. Set maxheaderlen to zero to disable
header wrapping. The default is 78, as recommended (but not required)
by RFC 2822.
The policy keyword specifies a policy object that controls a number of
aspects of the generator's operation. The default policy maintains
backward compatibility.
"""
self._fp = outfp
self._mangle_from_ = mangle_from_
self.maxheaderlen = maxheaderlen
self.policy = policy
def write(self, s):
# Just delegate to the file object
self._fp.write(s)
def flatten(self, msg, unixfrom=False, linesep=None):
r"""Print the message object tree rooted at msg to the output file
specified when the Generator instance was created.
unixfrom is a flag that forces the printing of a Unix From_ delimiter
before the first object in the message tree. If the original message
has no From_ delimiter, a `standard' one is crafted. By default, this
is False to inhibit the printing of any From_ delimiter.
Note that for subobjects, no From_ line is printed.
linesep specifies the characters used to indicate a new line in
the output. The default value is determined by the policy.
"""
# We use the _XXX constants for operating on data that comes directly
# from the msg, and _encoded_XXX constants for operating on data that
# has already been converted (to bytes in the BytesGenerator) and
# inserted into a temporary buffer.
policy = msg.policy if self.policy is None else self.policy
if linesep is not None:
policy = policy.clone(linesep=linesep)
if self.maxheaderlen is not None:
policy = policy.clone(max_line_length=self.maxheaderlen)
self._NL = policy.linesep
self._encoded_NL = self._encode(self._NL)
self._EMPTY = ''
self._encoded_EMTPY = self._encode('')
# Because we use clone (below) when we recursively process message
# subparts, and because clone uses the computed policy (not None),
# submessages will automatically get set to the computed policy when
# they are processed by this code.
old_gen_policy = self.policy
old_msg_policy = msg.policy
try:
self.policy = policy
msg.policy = policy
if unixfrom:
ufrom = msg.get_unixfrom()
if not ufrom:
ufrom = 'From nobody ' + time.ctime(time.time())
self.write(ufrom + self._NL)
self._write(msg)
finally:
self.policy = old_gen_policy
msg.policy = old_msg_policy
def clone(self, fp):
"""Clone this generator with the exact same options."""
return self.__class__(fp,
self._mangle_from_,
None, # Use policy setting, which we've adjusted
policy=self.policy)
#
# Protected interface - undocumented ;/
#
# Note that we use 'self.write' when what we are writing is coming from
# the source, and self._fp.write when what we are writing is coming from a
# buffer (because the Bytes subclass has already had a chance to transform
# the data in its write method in that case). This is an entirely
# pragmatic split determined by experiment; we could be more general by
# always using write and having the Bytes subclass write method detect when
# it has already transformed the input; but, since this whole thing is a
# hack anyway this seems good enough.
# Similarly, we have _XXX and _encoded_XXX attributes that are used on
# source and buffer data, respectively.
_encoded_EMPTY = ''
def _new_buffer(self):
# BytesGenerator overrides this to return BytesIO.
return StringIO()
def _encode(self, s):
# BytesGenerator overrides this to encode strings to bytes.
return s
def _write_lines(self, lines):
# We have to transform the line endings.
if not lines:
return
lines = lines.splitlines(True)
for line in lines[:-1]:
self.write(line.rstrip('\r\n'))
self.write(self._NL)
laststripped = lines[-1].rstrip('\r\n')
self.write(laststripped)
if len(lines[-1]) != len(laststripped):
self.write(self._NL)
def _write(self, msg):
# We can't write the headers yet because of the following scenario:
# say a multipart message includes the boundary string somewhere in
# its body. We'd have to calculate the new boundary /before/ we write
# the headers so that we can write the correct Content-Type:
# parameter.
#
# The way we do this, so as to make the _handle_*() methods simpler,
# is to cache any subpart writes into a buffer. The we write the
# headers and the buffer contents. That way, subpart handlers can
# Do The Right Thing, and can still modify the Content-Type: header if
# necessary.
oldfp = self._fp
try:
self._fp = sfp = self._new_buffer()
self._dispatch(msg)
finally:
self._fp = oldfp
# Write the headers. First we see if the message object wants to
# handle that itself. If not, we'll do it generically.
meth = getattr(msg, '_write_headers', None)
if meth is None:
self._write_headers(msg)
else:
meth(self)
self._fp.write(sfp.getvalue())
def _dispatch(self, msg):
# Get the Content-Type: for the message, then try to dispatch to
# self._handle_<maintype>_<subtype>(). If there's no handler for the
# full MIME type, then dispatch to self._handle_<maintype>(). If
# that's missing too, then dispatch to self._writeBody().
main = msg.get_content_maintype()
sub = msg.get_content_subtype()
specific = UNDERSCORE.join((main, sub)).replace('-', '_')
meth = getattr(self, '_handle_' + specific, None)
if meth is None:
generic = main.replace('-', '_')
meth = getattr(self, '_handle_' + generic, None)
if meth is None:
meth = self._writeBody
meth(msg)
#
# Default handlers
#
def _write_headers(self, msg):
for h, v in msg.raw_items():
self.write(self.policy.fold(h, v))
# A blank line always separates headers from body
self.write(self._NL)
#
# Handlers for writing types and subtypes
#
def _handle_text(self, msg):
payload = msg.get_payload()
if payload is None:
return
if not isinstance(payload, str):
raise TypeError('string payload expected: %s' % type(payload))
if _has_surrogates(msg._payload):
charset = msg.get_param('charset')
if charset is not None:
del msg['content-transfer-encoding']
msg.set_payload(payload, charset)
payload = msg.get_payload()
if self._mangle_from_:
payload = fcre.sub('>From ', payload)
self._write_lines(payload)
# Default body handler
_writeBody = _handle_text
def _handle_multipart(self, msg):
# The trick here is to write out each part separately, merge them all
# together, and then make sure that the boundary we've chosen isn't
# present in the payload.
msgtexts = []
subparts = msg.get_payload()
if subparts is None:
subparts = []
elif isinstance(subparts, str):
# e.g. a non-strict parse of a message with no starting boundary.
self.write(subparts)
return
elif not isinstance(subparts, list):
# Scalar payload
subparts = [subparts]
for part in subparts:
s = self._new_buffer()
g = self.clone(s)
g.flatten(part, unixfrom=False, linesep=self._NL)
msgtexts.append(s.getvalue())
# BAW: What about boundaries that are wrapped in double-quotes?
boundary = msg.get_boundary()
if not boundary:
# Create a boundary that doesn't appear in any of the
# message texts.
alltext = self._encoded_NL.join(msgtexts)
boundary = self._make_boundary(alltext)
msg.set_boundary(boundary)
# If there's a preamble, write it out, with a trailing CRLF
if msg.preamble is not None:
if self._mangle_from_:
preamble = fcre.sub('>From ', msg.preamble)
else:
preamble = msg.preamble
self._write_lines(preamble)
self.write(self._NL)
# dash-boundary transport-padding CRLF
self.write('--' + boundary + self._NL)
# body-part
if msgtexts:
self._fp.write(msgtexts.pop(0))
# *encapsulation
# --> delimiter transport-padding
# --> CRLF body-part
for body_part in msgtexts:
# delimiter transport-padding CRLF
self.write(self._NL + '--' + boundary + self._NL)
# body-part
self._fp.write(body_part)
# close-delimiter transport-padding
self.write(self._NL + '--' + boundary + '--')
if msg.epilogue is not None:
self.write(self._NL)
if self._mangle_from_:
epilogue = fcre.sub('>From ', msg.epilogue)
else:
epilogue = msg.epilogue
self._write_lines(epilogue)
def _handle_multipart_signed(self, msg):
# The contents of signed parts has to stay unmodified in order to keep
# the signature intact per RFC1847 2.1, so we disable header wrapping.
# RDM: This isn't enough to completely preserve the part, but it helps.
p = self.policy
self.policy = p.clone(max_line_length=0)
try:
self._handle_multipart(msg)
finally:
self.policy = p
def _handle_message_delivery_status(self, msg):
# We can't just write the headers directly to self's file object
# because this will leave an extra newline between the last header
# block and the boundary. Sigh.
blocks = []
for part in msg.get_payload():
s = self._new_buffer()
g = self.clone(s)
g.flatten(part, unixfrom=False, linesep=self._NL)
text = s.getvalue()
lines = text.split(self._encoded_NL)
# Strip off the unnecessary trailing empty line
if lines and lines[-1] == self._encoded_EMPTY:
blocks.append(self._encoded_NL.join(lines[:-1]))
else:
blocks.append(text)
# Now join all the blocks with an empty line. This has the lovely
# effect of separating each block with an empty line, but not adding
# an extra one after the last one.
self._fp.write(self._encoded_NL.join(blocks))
def _handle_message(self, msg):
s = self._new_buffer()
g = self.clone(s)
# The payload of a message/rfc822 part should be a multipart sequence
# of length 1. The zeroth element of the list should be the Message
# object for the subpart. Extract that object, stringify it, and
# write it out.
# Except, it turns out, when it's a string instead, which happens when
# and only when HeaderParser is used on a message of mime type
# message/rfc822. Such messages are generated by, for example,
# Groupwise when forwarding unadorned messages. (Issue 7970.) So
# in that case we just emit the string body.
payload = msg._payload
if isinstance(payload, list):
g.flatten(msg.get_payload(0), unixfrom=False, linesep=self._NL)
payload = s.getvalue()
else:
payload = self._encode(payload)
self._fp.write(payload)
# This used to be a module level function; we use a classmethod for this
# and _compile_re so we can continue to provide the module level function
# for backward compatibility by doing
# _make_boudary = Generator._make_boundary
# at the end of the module. It *is* internal, so we could drop that...
@classmethod
def _make_boundary(cls, text=None):
# Craft a random boundary. If text is given, ensure that the chosen
# boundary doesn't appear in the text.
token = random.randrange(sys.maxsize)
boundary = ('=' * 15) + (_fmt % token) + '=='
if text is None:
return boundary
b = boundary
counter = 0
while True:
cre = cls._compile_re('^--' + re.escape(b) + '(--)?$', re.MULTILINE)
if not cre.search(text):
break
b = boundary + '.' + str(counter)
counter += 1
return b
@classmethod
def _compile_re(cls, s, flags):
return re.compile(s, flags)
class BytesGenerator(Generator):
"""Generates a bytes version of a Message object tree.
Functionally identical to the base Generator except that the output is
bytes and not string. When surrogates were used in the input to encode
bytes, these are decoded back to bytes for output. If the policy has
cte_type set to 7bit, then the message is transformed such that the
non-ASCII bytes are properly content transfer encoded, using the charset
unknown-8bit.
The outfp object must accept bytes in its write method.
"""
# Bytes versions of this constant for use in manipulating data from
# the BytesIO buffer.
_encoded_EMPTY = b''
def write(self, s):
self._fp.write(str(s).encode('ascii', 'surrogateescape'))
def _new_buffer(self):
return BytesIO()
def _encode(self, s):
return s.encode('ascii')
def _write_headers(self, msg):
# This is almost the same as the string version, except for handling
# strings with 8bit bytes.
for h, v in msg.raw_items():
self._fp.write(self.policy.fold_binary(h, v))
# A blank line always separates headers from body
self.write(self._NL)
def _handle_text(self, msg):
# If the string has surrogates the original source was bytes, so
# just write it back out.
if msg._payload is None:
return
if _has_surrogates(msg._payload) and not self.policy.cte_type=='7bit':
if self._mangle_from_:
msg._payload = fcre.sub(">From ", msg._payload)
self._write_lines(msg._payload)
else:
super(BytesGenerator,self)._handle_text(msg)
# Default body handler
_writeBody = _handle_text
@classmethod
def _compile_re(cls, s, flags):
return re.compile(s.encode('ascii'), flags)
_FMT = '[Non-text (%(type)s) part of message omitted, filename %(filename)s]'
class DecodedGenerator(Generator):
"""Generates a text representation of a message.
Like the Generator base class, except that non-text parts are substituted
with a format string representing the part.
"""
def __init__(self, outfp, mangle_from_=True, maxheaderlen=78, fmt=None):
"""Like Generator.__init__() except that an additional optional
argument is allowed.
Walks through all subparts of a message. If the subpart is of main
type `text', then it prints the decoded payload of the subpart.
Otherwise, fmt is a format string that is used instead of the message
payload. fmt is expanded with the following keywords (in
%(keyword)s format):
type : Full MIME type of the non-text part
maintype : Main MIME type of the non-text part
subtype : Sub-MIME type of the non-text part
filename : Filename of the non-text part
description: Description associated with the non-text part
encoding : Content transfer encoding of the non-text part
The default value for fmt is None, meaning
[Non-text (%(type)s) part of message omitted, filename %(filename)s]
"""
Generator.__init__(self, outfp, mangle_from_, maxheaderlen)
if fmt is None:
self._fmt = _FMT
else:
self._fmt = fmt
def _dispatch(self, msg):
for part in msg.walk():
maintype = part.get_content_maintype()
if maintype == 'text':
print(part.get_payload(decode=False), file=self)
elif maintype == 'multipart':
# Just skip this
pass
else:
print(self._fmt % {
'type' : part.get_content_type(),
'maintype' : part.get_content_maintype(),
'subtype' : part.get_content_subtype(),
'filename' : part.get_filename('[no filename]'),
'description': part.get('Content-Description',
'[no description]'),
'encoding' : part.get('Content-Transfer-Encoding',
'[no encoding]'),
}, file=self)
# Helper used by Generator._make_boundary
_width = len(repr(sys.maxsize-1))
_fmt = '%%0%dd' % _width
# Backward compatibility
_make_boundary = Generator._make_boundary
PK rDu\����� � " future/backports/email/__init__.pynu �[��� # Copyright (C) 2001-2007 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""
Backport of the Python 3.3 email package for Python-Future.
A package for parsing, handling, and generating email messages.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
# Install the surrogate escape handler here because this is used by many
# modules in the email package.
from future.utils import surrogateescape
surrogateescape.register_surrogateescape()
# (Should this be done globally by ``future``?)
__version__ = '5.1.0'
__all__ = [
'base64mime',
'charset',
'encoders',
'errors',
'feedparser',
'generator',
'header',
'iterators',
'message',
'message_from_file',
'message_from_binary_file',
'message_from_string',
'message_from_bytes',
'mime',
'parser',
'quoprimime',
'utils',
]
# Some convenience routines. Don't import Parser and Message as side-effects
# of importing email since those cascadingly import most of the rest of the
# email package.
def message_from_string(s, *args, **kws):
"""Parse a string into a Message object model.
Optional _class and strict are passed to the Parser constructor.
"""
from future.backports.email.parser import Parser
return Parser(*args, **kws).parsestr(s)
def message_from_bytes(s, *args, **kws):
"""Parse a bytes string into a Message object model.
Optional _class and strict are passed to the Parser constructor.
"""
from future.backports.email.parser import BytesParser
return BytesParser(*args, **kws).parsebytes(s)
def message_from_file(fp, *args, **kws):
"""Read a file and parse its contents into a Message object model.
Optional _class and strict are passed to the Parser constructor.
"""
from future.backports.email.parser import Parser
return Parser(*args, **kws).parse(fp)
def message_from_binary_file(fp, *args, **kws):
"""Read a binary file and parse its contents into a Message object model.
Optional _class and strict are passed to the Parser constructor.
"""
from future.backports.email.parser import BytesParser
return BytesParser(*args, **kws).parse(fp)
PK tDu\�'�79 79 % future/backports/email/_policybase.pynu �[��� """Policy framework for the email package.
Allows fine grained feature control of how the package parses and emits data.
"""
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
from future.builtins import str
from future.utils import with_metaclass
import abc
from future.backports.email import header
from future.backports.email import charset as _charset
from future.backports.email.utils import _has_surrogates
__all__ = [
'Policy',
'Compat32',
'compat32',
]
class _PolicyBase(object):
"""Policy Object basic framework.
This class is useless unless subclassed. A subclass should define
class attributes with defaults for any values that are to be
managed by the Policy object. The constructor will then allow
non-default values to be set for these attributes at instance
creation time. The instance will be callable, taking these same
attributes keyword arguments, and returning a new instance
identical to the called instance except for those values changed
by the keyword arguments. Instances may be added, yielding new
instances with any non-default values from the right hand
operand overriding those in the left hand operand. That is,
A + B == A(<non-default values of B>)
The repr of an instance can be used to reconstruct the object
if and only if the repr of the values can be used to reconstruct
those values.
"""
def __init__(self, **kw):
"""Create new Policy, possibly overriding some defaults.
See class docstring for a list of overridable attributes.
"""
for name, value in kw.items():
if hasattr(self, name):
super(_PolicyBase,self).__setattr__(name, value)
else:
raise TypeError(
"{!r} is an invalid keyword argument for {}".format(
name, self.__class__.__name__))
def __repr__(self):
args = [ "{}={!r}".format(name, value)
for name, value in self.__dict__.items() ]
return "{}({})".format(self.__class__.__name__, ', '.join(args))
def clone(self, **kw):
"""Return a new instance with specified attributes changed.
The new instance has the same attribute values as the current object,
except for the changes passed in as keyword arguments.
"""
newpolicy = self.__class__.__new__(self.__class__)
for attr, value in self.__dict__.items():
object.__setattr__(newpolicy, attr, value)
for attr, value in kw.items():
if not hasattr(self, attr):
raise TypeError(
"{!r} is an invalid keyword argument for {}".format(
attr, self.__class__.__name__))
object.__setattr__(newpolicy, attr, value)
return newpolicy
def __setattr__(self, name, value):
if hasattr(self, name):
msg = "{!r} object attribute {!r} is read-only"
else:
msg = "{!r} object has no attribute {!r}"
raise AttributeError(msg.format(self.__class__.__name__, name))
def __add__(self, other):
"""Non-default values from right operand override those from left.
The object returned is a new instance of the subclass.
"""
return self.clone(**other.__dict__)
def _append_doc(doc, added_doc):
doc = doc.rsplit('\n', 1)[0]
added_doc = added_doc.split('\n', 1)[1]
return doc + '\n' + added_doc
def _extend_docstrings(cls):
if cls.__doc__ and cls.__doc__.startswith('+'):
cls.__doc__ = _append_doc(cls.__bases__[0].__doc__, cls.__doc__)
for name, attr in cls.__dict__.items():
if attr.__doc__ and attr.__doc__.startswith('+'):
for c in (c for base in cls.__bases__ for c in base.mro()):
doc = getattr(getattr(c, name), '__doc__')
if doc:
attr.__doc__ = _append_doc(doc, attr.__doc__)
break
return cls
class Policy(with_metaclass(abc.ABCMeta, _PolicyBase)):
r"""Controls for how messages are interpreted and formatted.
Most of the classes and many of the methods in the email package accept
Policy objects as parameters. A Policy object contains a set of values and
functions that control how input is interpreted and how output is rendered.
For example, the parameter 'raise_on_defect' controls whether or not an RFC
violation results in an error being raised or not, while 'max_line_length'
controls the maximum length of output lines when a Message is serialized.
Any valid attribute may be overridden when a Policy is created by passing
it as a keyword argument to the constructor. Policy objects are immutable,
but a new Policy object can be created with only certain values changed by
calling the Policy instance with keyword arguments. Policy objects can
also be added, producing a new Policy object in which the non-default
attributes set in the right hand operand overwrite those specified in the
left operand.
Settable attributes:
raise_on_defect -- If true, then defects should be raised as errors.
Default: False.
linesep -- string containing the value to use as separation
between output lines. Default '\n'.
cte_type -- Type of allowed content transfer encodings
7bit -- ASCII only
8bit -- Content-Transfer-Encoding: 8bit is allowed
Default: 8bit. Also controls the disposition of
(RFC invalid) binary data in headers; see the
documentation of the binary_fold method.
max_line_length -- maximum length of lines, excluding 'linesep',
during serialization. None or 0 means no line
wrapping is done. Default is 78.
"""
raise_on_defect = False
linesep = '\n'
cte_type = '8bit'
max_line_length = 78
def handle_defect(self, obj, defect):
"""Based on policy, either raise defect or call register_defect.
handle_defect(obj, defect)
defect should be a Defect subclass, but in any case must be an
Exception subclass. obj is the object on which the defect should be
registered if it is not raised. If the raise_on_defect is True, the
defect is raised as an error, otherwise the object and the defect are
passed to register_defect.
This method is intended to be called by parsers that discover defects.
The email package parsers always call it with Defect instances.
"""
if self.raise_on_defect:
raise defect
self.register_defect(obj, defect)
def register_defect(self, obj, defect):
"""Record 'defect' on 'obj'.
Called by handle_defect if raise_on_defect is False. This method is
part of the Policy API so that Policy subclasses can implement custom
defect handling. The default implementation calls the append method of
the defects attribute of obj. The objects used by the email package by
default that get passed to this method will always have a defects
attribute with an append method.
"""
obj.defects.append(defect)
def header_max_count(self, name):
"""Return the maximum allowed number of headers named 'name'.
Called when a header is added to a Message object. If the returned
value is not 0 or None, and there are already a number of headers with
the name 'name' equal to the value returned, a ValueError is raised.
Because the default behavior of Message's __setitem__ is to append the
value to the list of headers, it is easy to create duplicate headers
without realizing it. This method allows certain headers to be limited
in the number of instances of that header that may be added to a
Message programmatically. (The limit is not observed by the parser,
which will faithfully produce as many headers as exist in the message
being parsed.)
The default implementation returns None for all header names.
"""
return None
@abc.abstractmethod
def header_source_parse(self, sourcelines):
"""Given a list of linesep terminated strings constituting the lines of
a single header, return the (name, value) tuple that should be stored
in the model. The input lines should retain their terminating linesep
characters. The lines passed in by the email package may contain
surrogateescaped binary data.
"""
raise NotImplementedError
@abc.abstractmethod
def header_store_parse(self, name, value):
"""Given the header name and the value provided by the application
program, return the (name, value) that should be stored in the model.
"""
raise NotImplementedError
@abc.abstractmethod
def header_fetch_parse(self, name, value):
"""Given the header name and the value from the model, return the value
to be returned to the application program that is requesting that
header. The value passed in by the email package may contain
surrogateescaped binary data if the lines were parsed by a BytesParser.
The returned value should not contain any surrogateescaped data.
"""
raise NotImplementedError
@abc.abstractmethod
def fold(self, name, value):
"""Given the header name and the value from the model, return a string
containing linesep characters that implement the folding of the header
according to the policy controls. The value passed in by the email
package may contain surrogateescaped binary data if the lines were
parsed by a BytesParser. The returned value should not contain any
surrogateescaped data.
"""
raise NotImplementedError
@abc.abstractmethod
def fold_binary(self, name, value):
"""Given the header name and the value from the model, return binary
data containing linesep characters that implement the folding of the
header according to the policy controls. The value passed in by the
email package may contain surrogateescaped binary data.
"""
raise NotImplementedError
@_extend_docstrings
class Compat32(Policy):
"""+
This particular policy is the backward compatibility Policy. It
replicates the behavior of the email package version 5.1.
"""
def _sanitize_header(self, name, value):
# If the header value contains surrogates, return a Header using
# the unknown-8bit charset to encode the bytes as encoded words.
if not isinstance(value, str):
# Assume it is already a header object
return value
if _has_surrogates(value):
return header.Header(value, charset=_charset.UNKNOWN8BIT,
header_name=name)
else:
return value
def header_source_parse(self, sourcelines):
"""+
The name is parsed as everything up to the ':' and returned unmodified.
The value is determined by stripping leading whitespace off the
remainder of the first line, joining all subsequent lines together, and
stripping any trailing carriage return or linefeed characters.
"""
name, value = sourcelines[0].split(':', 1)
value = value.lstrip(' \t') + ''.join(sourcelines[1:])
return (name, value.rstrip('\r\n'))
def header_store_parse(self, name, value):
"""+
The name and value are returned unmodified.
"""
return (name, value)
def header_fetch_parse(self, name, value):
"""+
If the value contains binary data, it is converted into a Header object
using the unknown-8bit charset. Otherwise it is returned unmodified.
"""
return self._sanitize_header(name, value)
def fold(self, name, value):
"""+
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. Non-ASCII binary data are CTE encoded using the
unknown-8bit charset.
"""
return self._fold(name, value, sanitize=True)
def fold_binary(self, name, value):
"""+
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. If cte_type is 7bit, non-ascii binary data is CTE
encoded using the unknown-8bit charset. Otherwise the original source
header is used, with its existing line breaks and/or binary data.
"""
folded = self._fold(name, value, sanitize=self.cte_type=='7bit')
return folded.encode('ascii', 'surrogateescape')
def _fold(self, name, value, sanitize):
parts = []
parts.append('%s: ' % name)
if isinstance(value, str):
if _has_surrogates(value):
if sanitize:
h = header.Header(value,
charset=_charset.UNKNOWN8BIT,
header_name=name)
else:
# If we have raw 8bit data in a byte string, we have no idea
# what the encoding is. There is no safe way to split this
# string. If it's ascii-subset, then we could do a normal
# ascii split, but if it's multibyte then we could break the
# string. There's no way to know so the least harm seems to
# be to not split the string and risk it being too long.
parts.append(value)
h = None
else:
h = header.Header(value, header_name=name)
else:
# Assume it is a Header-like object.
h = value
if h is not None:
parts.append(h.encode(linesep=self.linesep,
maxlinelen=self.max_line_length))
parts.append(self.linesep)
return ''.join(parts)
compat32 = Compat32()
PK wDu\��0�, , # future/backports/email/iterators.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Various types of useful iterators and generators."""
from __future__ import print_function
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = [
'body_line_iterator',
'typed_subpart_iterator',
'walk',
# Do not include _structure() since it's part of the debugging API.
]
import sys
from io import StringIO
# This function will become a method of the Message class
def walk(self):
"""Walk over the message tree, yielding each subpart.
The walk is performed in depth-first order. This method is a
generator.
"""
yield self
if self.is_multipart():
for subpart in self.get_payload():
for subsubpart in subpart.walk():
yield subsubpart
# These two functions are imported into the Iterators.py interface module.
def body_line_iterator(msg, decode=False):
"""Iterate over the parts, returning string payloads line-by-line.
Optional decode (default False) is passed through to .get_payload().
"""
for subpart in msg.walk():
payload = subpart.get_payload(decode=decode)
if isinstance(payload, str):
for line in StringIO(payload):
yield line
def typed_subpart_iterator(msg, maintype='text', subtype=None):
"""Iterate over the subparts with a given MIME type.
Use `maintype' as the main MIME type to match against; this defaults to
"text". Optional `subtype' is the MIME subtype to match against; if
omitted, only the main type is matched.
"""
for subpart in msg.walk():
if subpart.get_content_maintype() == maintype:
if subtype is None or subpart.get_content_subtype() == subtype:
yield subpart
def _structure(msg, fp=None, level=0, include_default=False):
"""A handy debugging aid"""
if fp is None:
fp = sys.stdout
tab = ' ' * (level * 4)
print(tab + msg.get_content_type(), end='', file=fp)
if include_default:
print(' [%s]' % msg.get_default_type(), file=fp)
else:
print(file=fp)
if msg.is_multipart():
for subpart in msg.get_payload():
_structure(subpart, fp, level+1, include_default)
PK yDu\)��� � ( future/backports/email/_encoded_words.pynu �[��� """ Routines for manipulating RFC2047 encoded words.
This is currently a package-private API, but will be considered for promotion
to a public API if there is demand.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import bytes
from future.builtins import chr
from future.builtins import int
from future.builtins import str
# An ecoded word looks like this:
#
# =?charset[*lang]?cte?encoded_string?=
#
# for more information about charset see the charset module. Here it is one
# of the preferred MIME charset names (hopefully; you never know when parsing).
# cte (Content Transfer Encoding) is either 'q' or 'b' (ignoring case). In
# theory other letters could be used for other encodings, but in practice this
# (almost?) never happens. There could be a public API for adding entries
# to the CTE tables, but YAGNI for now. 'q' is Quoted Printable, 'b' is
# Base64. The meaning of encoded_string should be obvious. 'lang' is optional
# as indicated by the brackets (they are not part of the syntax) but is almost
# never encountered in practice.
#
# The general interface for a CTE decoder is that it takes the encoded_string
# as its argument, and returns a tuple (cte_decoded_string, defects). The
# cte_decoded_string is the original binary that was encoded using the
# specified cte. 'defects' is a list of MessageDefect instances indicating any
# problems encountered during conversion. 'charset' and 'lang' are the
# corresponding strings extracted from the EW, case preserved.
#
# The general interface for a CTE encoder is that it takes a binary sequence
# as input and returns the cte_encoded_string, which is an ascii-only string.
#
# Each decoder must also supply a length function that takes the binary
# sequence as its argument and returns the length of the resulting encoded
# string.
#
# The main API functions for the module are decode, which calls the decoder
# referenced by the cte specifier, and encode, which adds the appropriate
# RFC 2047 "chrome" to the encoded string, and can optionally automatically
# select the shortest possible encoding. See their docstrings below for
# details.
import re
import base64
import binascii
import functools
from string import ascii_letters, digits
from future.backports.email import errors
__all__ = ['decode_q',
'encode_q',
'decode_b',
'encode_b',
'len_q',
'len_b',
'decode',
'encode',
]
#
# Quoted Printable
#
# regex based decoder.
_q_byte_subber = functools.partial(re.compile(br'=([a-fA-F0-9]{2})').sub,
lambda m: bytes([int(m.group(1), 16)]))
def decode_q(encoded):
encoded = bytes(encoded.replace(b'_', b' '))
return _q_byte_subber(encoded), []
# dict mapping bytes to their encoded form
class _QByteMap(dict):
safe = bytes(b'-!*+/' + ascii_letters.encode('ascii') + digits.encode('ascii'))
def __missing__(self, key):
if key in self.safe:
self[key] = chr(key)
else:
self[key] = "={:02X}".format(key)
return self[key]
_q_byte_map = _QByteMap()
# In headers spaces are mapped to '_'.
_q_byte_map[ord(' ')] = '_'
def encode_q(bstring):
return str(''.join(_q_byte_map[x] for x in bytes(bstring)))
def len_q(bstring):
return sum(len(_q_byte_map[x]) for x in bytes(bstring))
#
# Base64
#
def decode_b(encoded):
defects = []
pad_err = len(encoded) % 4
if pad_err:
defects.append(errors.InvalidBase64PaddingDefect())
padded_encoded = encoded + b'==='[:4-pad_err]
else:
padded_encoded = encoded
try:
# The validate kwarg to b64decode is not supported in Py2.x
if not re.match(b'^[A-Za-z0-9+/]*={0,2}$', padded_encoded):
raise binascii.Error('Non-base64 digit found')
return base64.b64decode(padded_encoded), defects
except binascii.Error:
# Since we had correct padding, this must an invalid char error.
defects = [errors.InvalidBase64CharactersDefect()]
# The non-alphabet characters are ignored as far as padding
# goes, but we don't know how many there are. So we'll just
# try various padding lengths until something works.
for i in 0, 1, 2, 3:
try:
return base64.b64decode(encoded+b'='*i), defects
except (binascii.Error, TypeError): # Py2 raises a TypeError
if i==0:
defects.append(errors.InvalidBase64PaddingDefect())
else:
# This should never happen.
raise AssertionError("unexpected binascii.Error")
def encode_b(bstring):
return base64.b64encode(bstring).decode('ascii')
def len_b(bstring):
groups_of_3, leftover = divmod(len(bstring), 3)
# 4 bytes out for each 3 bytes (or nonzero fraction thereof) in.
return groups_of_3 * 4 + (4 if leftover else 0)
_cte_decoders = {
'q': decode_q,
'b': decode_b,
}
def decode(ew):
"""Decode encoded word and return (string, charset, lang, defects) tuple.
An RFC 2047/2243 encoded word has the form:
=?charset*lang?cte?encoded_string?=
where '*lang' may be omitted but the other parts may not be.
This function expects exactly such a string (that is, it does not check the
syntax and may raise errors if the string is not well formed), and returns
the encoded_string decoded first from its Content Transfer Encoding and
then from the resulting bytes into unicode using the specified charset. If
the cte-decoded string does not successfully decode using the specified
character set, a defect is added to the defects list and the unknown octets
are replaced by the unicode 'unknown' character \uFDFF.
The specified charset and language are returned. The default for language,
which is rarely if ever encountered, is the empty string.
"""
_, charset, cte, cte_string, _ = str(ew).split('?')
charset, _, lang = charset.partition('*')
cte = cte.lower()
# Recover the original bytes and do CTE decoding.
bstring = cte_string.encode('ascii', 'surrogateescape')
bstring, defects = _cte_decoders[cte](bstring)
# Turn the CTE decoded bytes into unicode.
try:
string = bstring.decode(charset)
except UnicodeError:
defects.append(errors.UndecodableBytesDefect("Encoded word "
"contains bytes not decodable using {} charset".format(charset)))
string = bstring.decode(charset, 'surrogateescape')
except LookupError:
string = bstring.decode('ascii', 'surrogateescape')
if charset.lower() != 'unknown-8bit':
defects.append(errors.CharsetError("Unknown charset {} "
"in encoded word; decoded as unknown bytes".format(charset)))
return string, charset, lang, defects
_cte_encoders = {
'q': encode_q,
'b': encode_b,
}
_cte_encode_length = {
'q': len_q,
'b': len_b,
}
def encode(string, charset='utf-8', encoding=None, lang=''):
"""Encode string using the CTE encoding that produces the shorter result.
Produces an RFC 2047/2243 encoded word of the form:
=?charset*lang?cte?encoded_string?=
where '*lang' is omitted unless the 'lang' parameter is given a value.
Optional argument charset (defaults to utf-8) specifies the charset to use
to encode the string to binary before CTE encoding it. Optional argument
'encoding' is the cte specifier for the encoding that should be used ('q'
or 'b'); if it is None (the default) the encoding which produces the
shortest encoded sequence is used, except that 'q' is preferred if it is up
to five characters longer. Optional argument 'lang' (default '') gives the
RFC 2243 language string to specify in the encoded word.
"""
string = str(string)
if charset == 'unknown-8bit':
bstring = string.encode('ascii', 'surrogateescape')
else:
bstring = string.encode(charset)
if encoding is None:
qlen = _cte_encode_length['q'](bstring)
blen = _cte_encode_length['b'](bstring)
# Bias toward q. 5 is arbitrary.
encoding = 'q' if qlen - blen < 5 else 'b'
encoded = _cte_encoders[encoding](bstring)
if lang:
lang = '*' + lang
return "=?{0}{1}?{2}?{3}?=".format(charset, lang, encoding, encoded)
PK |Du\���C �C $ future/backports/email/_parseaddr.pynu �[��� # Copyright (C) 2002-2007 Python Software Foundation
# Contact: email-sig@python.org
"""Email address parsing code.
Lifted directly from rfc822.py. This should eventually be rewritten.
"""
from __future__ import unicode_literals
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
from future.builtins import int
__all__ = [
'mktime_tz',
'parsedate',
'parsedate_tz',
'quote',
]
import time, calendar
SPACE = ' '
EMPTYSTRING = ''
COMMASPACE = ', '
# Parse a date field
_monthnames = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul',
'aug', 'sep', 'oct', 'nov', 'dec',
'january', 'february', 'march', 'april', 'may', 'june', 'july',
'august', 'september', 'october', 'november', 'december']
_daynames = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
# The timezone table does not include the military time zones defined
# in RFC822, other than Z. According to RFC1123, the description in
# RFC822 gets the signs wrong, so we can't rely on any such time
# zones. RFC1123 recommends that numeric timezone indicators be used
# instead of timezone names.
_timezones = {'UT':0, 'UTC':0, 'GMT':0, 'Z':0,
'AST': -400, 'ADT': -300, # Atlantic (used in Canada)
'EST': -500, 'EDT': -400, # Eastern
'CST': -600, 'CDT': -500, # Central
'MST': -700, 'MDT': -600, # Mountain
'PST': -800, 'PDT': -700 # Pacific
}
def parsedate_tz(data):
"""Convert a date string to a time tuple.
Accounts for military timezones.
"""
res = _parsedate_tz(data)
if not res:
return
if res[9] is None:
res[9] = 0
return tuple(res)
def _parsedate_tz(data):
"""Convert date to extended time tuple.
The last (additional) element is the time zone offset in seconds, except if
the timezone was specified as -0000. In that case the last element is
None. This indicates a UTC timestamp that explicitly declaims knowledge of
the source timezone, as opposed to a +0000 timestamp that indicates the
source timezone really was UTC.
"""
if not data:
return
data = data.split()
# The FWS after the comma after the day-of-week is optional, so search and
# adjust for this.
if data[0].endswith(',') or data[0].lower() in _daynames:
# There's a dayname here. Skip it
del data[0]
else:
i = data[0].rfind(',')
if i >= 0:
data[0] = data[0][i+1:]
if len(data) == 3: # RFC 850 date, deprecated
stuff = data[0].split('-')
if len(stuff) == 3:
data = stuff + data[1:]
if len(data) == 4:
s = data[3]
i = s.find('+')
if i == -1:
i = s.find('-')
if i > 0:
data[3:] = [s[:i], s[i:]]
else:
data.append('') # Dummy tz
if len(data) < 5:
return None
data = data[:5]
[dd, mm, yy, tm, tz] = data
mm = mm.lower()
if mm not in _monthnames:
dd, mm = mm, dd.lower()
if mm not in _monthnames:
return None
mm = _monthnames.index(mm) + 1
if mm > 12:
mm -= 12
if dd[-1] == ',':
dd = dd[:-1]
i = yy.find(':')
if i > 0:
yy, tm = tm, yy
if yy[-1] == ',':
yy = yy[:-1]
if not yy[0].isdigit():
yy, tz = tz, yy
if tm[-1] == ',':
tm = tm[:-1]
tm = tm.split(':')
if len(tm) == 2:
[thh, tmm] = tm
tss = '0'
elif len(tm) == 3:
[thh, tmm, tss] = tm
elif len(tm) == 1 and '.' in tm[0]:
# Some non-compliant MUAs use '.' to separate time elements.
tm = tm[0].split('.')
if len(tm) == 2:
[thh, tmm] = tm
tss = 0
elif len(tm) == 3:
[thh, tmm, tss] = tm
else:
return None
try:
yy = int(yy)
dd = int(dd)
thh = int(thh)
tmm = int(tmm)
tss = int(tss)
except ValueError:
return None
# Check for a yy specified in two-digit format, then convert it to the
# appropriate four-digit format, according to the POSIX standard. RFC 822
# calls for a two-digit yy, but RFC 2822 (which obsoletes RFC 822)
# mandates a 4-digit yy. For more information, see the documentation for
# the time module.
if yy < 100:
# The year is between 1969 and 1999 (inclusive).
if yy > 68:
yy += 1900
# The year is between 2000 and 2068 (inclusive).
else:
yy += 2000
tzoffset = None
tz = tz.upper()
if tz in _timezones:
tzoffset = _timezones[tz]
else:
try:
tzoffset = int(tz)
except ValueError:
pass
if tzoffset==0 and tz.startswith('-'):
tzoffset = None
# Convert a timezone offset into seconds ; -0500 -> -18000
if tzoffset:
if tzoffset < 0:
tzsign = -1
tzoffset = -tzoffset
else:
tzsign = 1
tzoffset = tzsign * ( (tzoffset//100)*3600 + (tzoffset % 100)*60)
# Daylight Saving Time flag is set to -1, since DST is unknown.
return [yy, mm, dd, thh, tmm, tss, 0, 1, -1, tzoffset]
def parsedate(data):
"""Convert a time string to a time tuple."""
t = parsedate_tz(data)
if isinstance(t, tuple):
return t[:9]
else:
return t
def mktime_tz(data):
"""Turn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp."""
if data[9] is None:
# No zone info, so localtime is better assumption than GMT
return time.mktime(data[:8] + (-1,))
else:
t = calendar.timegm(data)
return t - data[9]
def quote(str):
"""Prepare string to be used in a quoted string.
Turns backslash and double quote characters into quoted pairs. These
are the only characters that need to be quoted inside a quoted string.
Does not add the surrounding double quotes.
"""
return str.replace('\\', '\\\\').replace('"', '\\"')
class AddrlistClass(object):
"""Address parser class by Ben Escoto.
To understand what this class does, it helps to have a copy of RFC 2822 in
front of you.
Note: this class interface is deprecated and may be removed in the future.
Use email.utils.AddressList instead.
"""
def __init__(self, field):
"""Initialize a new instance.
`field' is an unparsed address header field, containing
one or more addresses.
"""
self.specials = '()<>@,:;.\"[]'
self.pos = 0
self.LWS = ' \t'
self.CR = '\r\n'
self.FWS = self.LWS + self.CR
self.atomends = self.specials + self.LWS + self.CR
# Note that RFC 2822 now specifies `.' as obs-phrase, meaning that it
# is obsolete syntax. RFC 2822 requires that we recognize obsolete
# syntax, so allow dots in phrases.
self.phraseends = self.atomends.replace('.', '')
self.field = field
self.commentlist = []
def gotonext(self):
"""Skip white space and extract comments."""
wslist = []
while self.pos < len(self.field):
if self.field[self.pos] in self.LWS + '\n\r':
if self.field[self.pos] not in '\n\r':
wslist.append(self.field[self.pos])
self.pos += 1
elif self.field[self.pos] == '(':
self.commentlist.append(self.getcomment())
else:
break
return EMPTYSTRING.join(wslist)
def getaddrlist(self):
"""Parse all addresses.
Returns a list containing all of the addresses.
"""
result = []
while self.pos < len(self.field):
ad = self.getaddress()
if ad:
result += ad
else:
result.append(('', ''))
return result
def getaddress(self):
"""Parse the next address."""
self.commentlist = []
self.gotonext()
oldpos = self.pos
oldcl = self.commentlist
plist = self.getphraselist()
self.gotonext()
returnlist = []
if self.pos >= len(self.field):
# Bad email address technically, no domain.
if plist:
returnlist = [(SPACE.join(self.commentlist), plist[0])]
elif self.field[self.pos] in '.@':
# email address is just an addrspec
# this isn't very efficient since we start over
self.pos = oldpos
self.commentlist = oldcl
addrspec = self.getaddrspec()
returnlist = [(SPACE.join(self.commentlist), addrspec)]
elif self.field[self.pos] == ':':
# address is a group
returnlist = []
fieldlen = len(self.field)
self.pos += 1
while self.pos < len(self.field):
self.gotonext()
if self.pos < fieldlen and self.field[self.pos] == ';':
self.pos += 1
break
returnlist = returnlist + self.getaddress()
elif self.field[self.pos] == '<':
# Address is a phrase then a route addr
routeaddr = self.getrouteaddr()
if self.commentlist:
returnlist = [(SPACE.join(plist) + ' (' +
' '.join(self.commentlist) + ')', routeaddr)]
else:
returnlist = [(SPACE.join(plist), routeaddr)]
else:
if plist:
returnlist = [(SPACE.join(self.commentlist), plist[0])]
elif self.field[self.pos] in self.specials:
self.pos += 1
self.gotonext()
if self.pos < len(self.field) and self.field[self.pos] == ',':
self.pos += 1
return returnlist
def getrouteaddr(self):
"""Parse a route address (Return-path value).
This method just skips all the route stuff and returns the addrspec.
"""
if self.field[self.pos] != '<':
return
expectroute = False
self.pos += 1
self.gotonext()
adlist = ''
while self.pos < len(self.field):
if expectroute:
self.getdomain()
expectroute = False
elif self.field[self.pos] == '>':
self.pos += 1
break
elif self.field[self.pos] == '@':
self.pos += 1
expectroute = True
elif self.field[self.pos] == ':':
self.pos += 1
else:
adlist = self.getaddrspec()
self.pos += 1
break
self.gotonext()
return adlist
def getaddrspec(self):
"""Parse an RFC 2822 addr-spec."""
aslist = []
self.gotonext()
while self.pos < len(self.field):
preserve_ws = True
if self.field[self.pos] == '.':
if aslist and not aslist[-1].strip():
aslist.pop()
aslist.append('.')
self.pos += 1
preserve_ws = False
elif self.field[self.pos] == '"':
aslist.append('"%s"' % quote(self.getquote()))
elif self.field[self.pos] in self.atomends:
if aslist and not aslist[-1].strip():
aslist.pop()
break
else:
aslist.append(self.getatom())
ws = self.gotonext()
if preserve_ws and ws:
aslist.append(ws)
if self.pos >= len(self.field) or self.field[self.pos] != '@':
return EMPTYSTRING.join(aslist)
aslist.append('@')
self.pos += 1
self.gotonext()
return EMPTYSTRING.join(aslist) + self.getdomain()
def getdomain(self):
"""Get the complete domain name from an address."""
sdlist = []
while self.pos < len(self.field):
if self.field[self.pos] in self.LWS:
self.pos += 1
elif self.field[self.pos] == '(':
self.commentlist.append(self.getcomment())
elif self.field[self.pos] == '[':
sdlist.append(self.getdomainliteral())
elif self.field[self.pos] == '.':
self.pos += 1
sdlist.append('.')
elif self.field[self.pos] in self.atomends:
break
else:
sdlist.append(self.getatom())
return EMPTYSTRING.join(sdlist)
def getdelimited(self, beginchar, endchars, allowcomments=True):
"""Parse a header fragment delimited by special characters.
`beginchar' is the start character for the fragment.
If self is not looking at an instance of `beginchar' then
getdelimited returns the empty string.
`endchars' is a sequence of allowable end-delimiting characters.
Parsing stops when one of these is encountered.
If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed
within the parsed fragment.
"""
if self.field[self.pos] != beginchar:
return ''
slist = ['']
quote = False
self.pos += 1
while self.pos < len(self.field):
if quote:
slist.append(self.field[self.pos])
quote = False
elif self.field[self.pos] in endchars:
self.pos += 1
break
elif allowcomments and self.field[self.pos] == '(':
slist.append(self.getcomment())
continue # have already advanced pos from getcomment
elif self.field[self.pos] == '\\':
quote = True
else:
slist.append(self.field[self.pos])
self.pos += 1
return EMPTYSTRING.join(slist)
def getquote(self):
"""Get a quote-delimited fragment from self's field."""
return self.getdelimited('"', '"\r', False)
def getcomment(self):
"""Get a parenthesis-delimited fragment from self's field."""
return self.getdelimited('(', ')\r', True)
def getdomainliteral(self):
"""Parse an RFC 2822 domain-literal."""
return '[%s]' % self.getdelimited('[', ']\r', False)
def getatom(self, atomends=None):
"""Parse an RFC 2822 atom.
Optional atomends specifies a different set of end token delimiters
(the default is to use self.atomends). This is used e.g. in
getphraselist() since phrase endings must not include the `.' (which
is legal in phrases)."""
atomlist = ['']
if atomends is None:
atomends = self.atomends
while self.pos < len(self.field):
if self.field[self.pos] in atomends:
break
else:
atomlist.append(self.field[self.pos])
self.pos += 1
return EMPTYSTRING.join(atomlist)
def getphraselist(self):
"""Parse a sequence of RFC 2822 phrases.
A phrase is a sequence of words, which are in turn either RFC 2822
atoms or quoted-strings. Phrases are canonicalized by squeezing all
runs of continuous whitespace into one space.
"""
plist = []
while self.pos < len(self.field):
if self.field[self.pos] in self.FWS:
self.pos += 1
elif self.field[self.pos] == '"':
plist.append(self.getquote())
elif self.field[self.pos] == '(':
self.commentlist.append(self.getcomment())
elif self.field[self.pos] in self.phraseends:
break
else:
plist.append(self.getatom(self.phraseends))
return plist
class AddressList(AddrlistClass):
"""An AddressList encapsulates a list of parsed RFC 2822 addresses."""
def __init__(self, field):
AddrlistClass.__init__(self, field)
if field:
self.addresslist = self.getaddrlist()
else:
self.addresslist = []
def __len__(self):
return len(self.addresslist)
def __add__(self, other):
# Set union
newaddr = AddressList(None)
newaddr.addresslist = self.addresslist[:]
for x in other.addresslist:
if not x in self.addresslist:
newaddr.addresslist.append(x)
return newaddr
def __iadd__(self, other):
# Set union, in-place
for x in other.addresslist:
if not x in self.addresslist:
self.addresslist.append(x)
return self
def __sub__(self, other):
# Set difference
newaddr = AddressList(None)
for x in self.addresslist:
if not x in other.addresslist:
newaddr.addresslist.append(x)
return newaddr
def __isub__(self, other):
# Set difference, in-place
for x in other.addresslist:
if x in self.addresslist:
self.addresslist.remove(x)
return self
def __getitem__(self, index):
# Make indexing, slices, and 'in' work
return self.addresslist[index]
PK �Du\P�U�
�
" future/backports/email/encoders.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Encodings and related functions."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import str
__all__ = [
'encode_7or8bit',
'encode_base64',
'encode_noop',
'encode_quopri',
]
try:
from base64 import encodebytes as _bencode
except ImportError:
# Py2 compatibility. TODO: test this!
from base64 import encodestring as _bencode
from quopri import encodestring as _encodestring
def _qencode(s):
enc = _encodestring(s, quotetabs=True)
# Must encode spaces, which quopri.encodestring() doesn't do
return enc.replace(' ', '=20')
def encode_base64(msg):
"""Encode the message's payload in Base64.
Also, add an appropriate Content-Transfer-Encoding header.
"""
orig = msg.get_payload()
encdata = str(_bencode(orig), 'ascii')
msg.set_payload(encdata)
msg['Content-Transfer-Encoding'] = 'base64'
def encode_quopri(msg):
"""Encode the message's payload in quoted-printable.
Also, add an appropriate Content-Transfer-Encoding header.
"""
orig = msg.get_payload()
encdata = _qencode(orig)
msg.set_payload(encdata)
msg['Content-Transfer-Encoding'] = 'quoted-printable'
def encode_7or8bit(msg):
"""Set the Content-Transfer-Encoding header to 7bit or 8bit."""
orig = msg.get_payload()
if orig is None:
# There's no payload. For backwards compatibility we use 7bit
msg['Content-Transfer-Encoding'] = '7bit'
return
# We play a trick to make this go fast. If encoding/decode to ASCII
# succeeds, we know the data must be 7bit, otherwise treat it as 8bit.
try:
if isinstance(orig, str):
orig.encode('ascii')
else:
orig.decode('ascii')
except UnicodeError:
charset = msg.get_charset()
output_cset = charset and charset.output_charset
# iso-2022-* is non-ASCII but encodes to a 7-bit representation
if output_cset and output_cset.lower().startswith('iso-2022-'):
msg['Content-Transfer-Encoding'] = '7bit'
else:
msg['Content-Transfer-Encoding'] = '8bit'
else:
msg['Content-Transfer-Encoding'] = '7bit'
if not isinstance(orig, str):
msg.set_payload(orig.decode('ascii', 'surrogateescape'))
def encode_noop(msg):
"""Do nothing."""
# Well, not quite *nothing*: in Python3 we have to turn bytes into a string
# in our internal surrogateescaped form in order to keep the model
# consistent.
orig = msg.get_payload()
if not isinstance(orig, str):
msg.set_payload(orig.decode('ascii', 'surrogateescape'))
PK �Du\���fB fB 8 future/backports/email/__pycache__/header.cpython-39.pycnu �[��� a
��?h�_ � @ sN d Z ddlmZ ddlmZ ddlmZ ddlmZmZmZm Z m
Z
g d�Z ddl Z ddl
Z
ddlmZ dd lmZ dd
lmZ ddlm m mZ dd lmZmZ ejZd Z d
Z dZ dZ dZ dZ!dZ"ed�Z#ed�Z$e �%de j&e j'B e j(B �Z)e �%d�Z*e �%d�Z+dd� Z,d"dd�Z-G d d � d e.�Z/G d d � d e.�Z0G d d!� d!e1�Z2dS )#z+Header encoding and decoding functionality.� )�unicode_literals)�division)�absolute_import)�bytes�range�str�super�zip)�Header�
decode_header� make_headerN)�email)�
base64mime)�HeaderParseError)� _max_append�
header_decode�
� � z � �N z �us-asciizutf-8ai
=\? # literal =?
(?P<charset>[^?]*?) # non-greedy up to the next ? is the charset
\? # literal ?
(?P<encoding>[qb]) # either a "q" or a "b", case insensitive
\? # literal ?
(?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string
\?= # literal ?=
z[\041-\176]+:$z
\n[^ \t]+:c C s� t | d�rdd� | jD �S t�| �s.| dfgS g }| �� D ]�}t�|�}d}|r:|�d�}|rj|�� }d}|r~|�|ddf� |rL|�d�� � }|�d�� � }|�d�}|�|||f� qLq:ddl
} g }
t |�D ]J\} } | dkr�| d r�|| d d r�|| d d � � r�|
�| d � q�t
|
�D ] }
||
= �q$g }|D ]�\}}}|du �r^|�||f� n�|d
k�r�t|�}|�||f� nz|d k�r�t|�d }|�r�|d
dd | � 7 }zt�|�}W n tj�y� td��Y n0 |�||f� n td| ���q:g }d }}|D ]v\}}t|t��r,t|d�}|du �r@|}|}nB||k�rb|�||f� |}|}n |du �rz|t| 7 }n||7 }�q|�||f� |S )a; Decode a message header value without converting charset.
Returns a list of (string, charset) pairs containing each of the decoded
parts of the header. Charset is None for non-encoded parts of the header,
otherwise a lower-case string containing the name of the character set
specified in the encoded string.
header may be a string that may or may not contain RFC2047 encoded words,
or it may be a Header object.
An email.errors.HeaderParseError may be raised when certain decoding error
occurs (e.g. a base64 decoding exception).
�_chunksc S s( g | ] \}}t �|t|��t|�f�qS � )�_charset�_encoder )�.0�string�charsetr r �G/usr/local/lib/python3.9/site-packages/future/backports/email/header.py�
<listcomp>N s �z!decode_header.<locals>.<listcomp>NTr F� � �q�b� z===zBase64 decoding errorzUnexpected encoding: zraw-unicode-escape)�hasattrr �ecre�search�
splitlines�split�pop�lstrip�append�lower�sys� enumerate�isspace�reversedr �lenr �decode�binascii�Errorr �AssertionError�
isinstancer r �BSPACE)�header�words�line�parts�first� unencodedr �encoding�encodedr/ �droplist�n�w�d�
decoded_words�encoded_string�word�paderr� collapsed� last_word� last_charsetr r r r > s~
�
4
r c C sF t |||d�}| D ].\}}|dur4t|t�s4t|�}|�||� q|S )a� Create a Header from a sequence of pairs as returned by decode_header()
decode_header() takes a header value string and returns a sequence of
pairs of the format (decoded_string, charset) where charset is the string
name of the character set.
This function takes one of those sequence of pairs and returns a Header
instance. Optional maxlinelen, header_name, and continuation_ws are as in
the Header constructor.
)�
maxlinelen� header_name�continuation_wsN)r
r8 �Charsetr- )� decoded_seqrM rN rO �h�sr r r r r � s � r c @ sR e Zd Zddd�Zdd� Zdd � Zd
d � Zdd d
�Zdd� Zddd�Z dd� Z
dS )r
Nr �strictc C s| |du rt }nt|t�s t|�}|| _|| _g | _|durH| �|||� |du rTt}|| _|du rjd| _ nt
|�d | _ dS )aD Create a MIME-compliant header that can contain many character sets.
Optional s is the initial header value. If None, the initial header
value is not set. You can later append to the header with .append()
method calls. s may be a byte string or a Unicode string, but see the
.append() documentation for semantics.
Optional charset serves two purposes: it has the same meaning as the
charset argument to the .append() method. It also sets the default
character set for all subsequent .append() calls that omit the charset
argument. If charset is not provided in the constructor, the us-ascii
charset is used both as s's initial charset and as the default for
subsequent .append() calls.
The maximum line length can be specified explicitly via maxlinelen. For
splitting the first line to a shorter value (to account for the field
header which isn't included in s, e.g. `Subject') pass in the name of
the field in header_name. The default maxlinelen is 78 as recommended
by RFC 2822.
continuation_ws must be RFC 2822 compliant folding whitespace (usually
either a space or a hard tab) which will be prepended to continuation
lines.
errors is passed through to the .append() call.
Nr r" ) �USASCIIr8 rP r �_continuation_wsr r- �
MAXLINELEN� _maxlinelen�
_headerlenr3 )�selfrS r rM rN rO �errorsr r r �__init__� s
zHeader.__init__c C s� | � � g }d}d}| jD ]�\}}|}|tjkrH|�dd�}|�dd�}|r�|o\| �|d �}|dvr�|dv r�|s�|�t� d}n|dvr�|s�|�t� |o�| �|d �}|}|�|� qt �
|�S )z&Return the string value of the header.N�ascii�surrogateescape�replacer �Nr ���) �
_normalizer r � UNKNOWN8BIT�encoder4 � _nonctextr- �SPACE� EMPTYSTRING�join) rZ �uchunks�lastcs� lastspacer r �nextcs�original_bytes�hasspacer r r �__str__� s*
zHeader.__str__c C s |t | �kS �N)r �rZ �otherr r r �__eq__ s z
Header.__eq__c C s
| |k S rp r rq r r r �__ne__ s z
Header.__ne__c C s� |du r| j }nt|t�s"t|�}t|t�sZ|jp4d}|t jkrN|�dd�}n |�||�}|jpbd}|t jkr�z|�||� W n t y� |dkr�� t
}Y n0 | j � ||f� dS )a. Append a string to the MIME header.
Optional charset, if given, should be a Charset instance or the name
of a character set (which will be converted to a Charset instance). A
value of None (the default) means that the charset given in the
constructor is used.
s may be a byte string or a Unicode string. If it is a byte string
(i.e. isinstance(s, str) is false), then charset is the encoding of
that byte string, and a UnicodeError will be raised if the string
cannot be decoded with that charset. If s is a Unicode string, then
charset is a hint specifying the character set of the characters in
the string. In either case, when producing an RFC 2822 compliant
header using RFC 2047 rules, the string will be encoded using the
output codec of the charset. If the string cannot be encoded to the
output codec, a UnicodeError will be raised.
Optional `errors' is passed as the errors argument to the decode
call if s is a byte string.
Nr r^ )
r r8 rP r � input_codecrc r4 � output_codecrd �UnicodeEncodeError�UTF8r r- )rZ rS r r[ �
input_charset�output_charsetr r r r- s$
z
Header.appendc C s |� � p|dv S )z=True if string s is not a ctext character of RFC822.
)�(�)�\)r1 )rZ rS r r r re 7 s zHeader._nonctext�;, r c C s� | � � |du r| j}|dkr"d}t| j|| j|�}d}d }}| jD �]&\}} |dur�|oh| �|d �}ddl}
|dvr�|r�| dvr�|�� n| dvr�|s�|�� |o�| �|d �}| }d}|� � } | r�|�
d| d | � n|�
dd| � | dd� D ]`} |� � | j du�r*|�
| jd | �
� | � q�| �
� }
| dt| �t|
� � }|�
||
| � q�t| �dkrF|� � qF| j�r�|�� |�|�}t�|��r�td
�|���|S ) a� Encode a message header into an RFC-compliant format.
There are many issues involved in converting a given string for use in
an email header. Only certain character sets are readable in most
email clients, and as header strings can only contain a subset of
7-bit ASCII, care must be taken to properly convert and encode (with
Base64 or quoted-printable) header strings. In addition, there is a
75-character length limit on any given encoded header field, so
line-wrapping must be performed, even with double-byte character sets.
Optional maxlinelen specifies the maximum length of each generated
line, exclusive of the linesep string. Individual lines may be longer
than maxlinelen if a folding point cannot be found. The first line
will be shorter by the length of the header name plus ": " if a header
name was specified at Header construction time. The default value for
maxlinelen is determined at header construction time.
Optional splitchars is a string containing characters which should be
given extra weight by the splitting algorithm during normal header
wrapping. This is in very rough support of RFC 2822's `higher level
syntactic breaks': split points preceded by a splitchar are preferred
during line splitting, with the characters preferred in the order in
which they appear in the string. Space and tab may be included in the
string to indicate whether preference should be given to one over the
other as a split point when other split chars do not appear in the line
being split. Splitchars does not affect RFC 2047 encoded lines.
Optional linesep is a string to be used to separate the lines of
the value. The default value is the most useful for typical
Python applications, but it can be set to \r\n to produce RFC-compliant
line separators when needed.
Nr i@B r` ra Fr r! r z8header value appears to contain an embedded header: {!r})rb rX �_ValueFormatterrY rV r re r/ �add_transitionr) �feed�newline�header_encodingr, r3 �_str�_embeded_headerr( r �format)rZ �
splitcharsrM �linesep� formatterrj rn rk r r r/ �linesr< �sline�fws�valuer r r rd < sZ !�
�
�z
Header.encodec C sx g }d }g }| j D ]B\}}||kr.|�|� q|d urJ|�t�|�|f� |g}|}q|rn|�t�|�|f� || _ d S rp )r r- rf rh )rZ �chunksrL �
last_chunkr r r r r rb � s zHeader._normalize)NNNNr rT )NrT )r~ Nr ) �__name__�
__module__� __qualname__r\ ro rs rt r- re rd rb r r r r r
� s �
/
+
Qr
c @ sT e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dS )r c C s0 || _ || _t|�| _|| _g | _t|�| _d S rp )�_maxlenrV r3 �_continuation_ws_len� _splitchars�_lines� _Accumulator�
_current_line)rZ � headerlen�maxlenrO r� r r r r\ � s
z_ValueFormatter.__init__c C s | � � |�| j�S rp )r� rh r� )rZ r� r r r r� � s z_ValueFormatter._strc C s
| � t�S rp )r� �NL�rZ r r r ro � s z_ValueFormatter.__str__c C sp | j �� }|dkr | j j|� t| j �dkrb| j �� rP| jd t| j �7 < n| j�t| j �� | j �� d S )N)r r r ra ) r� r+ �pushr3 � is_onlywsr� r r- �reset)rZ � end_of_liner r r r� � s
z_ValueFormatter.newlinec C s | j �dd� d S )Nr r )r� r� r� r r r r� � s z _ValueFormatter.add_transitionc C s� |j d u r | �||| j� d S |�|| �� �}z|�d�}W n tyP Y d S 0 |d urf| �||� z |�� }W n ty� Y d S 0 | �� | j �
| j |� |D ]}| j �
| j | � q�d S �Nr )r� � _ascii_splitr� �header_encode_lines� _maxlengthsr+ �
IndexError�
_append_chunkr� r� r� rV r� r- )rZ r� r r �
encoded_lines�
first_line� last_liner< r r r r� � s$
z_ValueFormatter.feedc c s& | j t| j� V | j | j V qd S rp )r� r3 r� r� r� r r r r� � s z_ValueFormatter._maxlengthsc C sf t �dt d || �}|d r0dg|d d�< n
|�d� tt|�gd � D ]\}}| �||� qLd S )Nz([z]+)r r r" )�rer* �FWSr+ r �iterr� )rZ r� r r� r= �partr r r r� � s
z _ValueFormatter._ascii_splitc C s | j �||� t| j �| jk�r| jD ]v}t| j �� d dd�D ]T}|�� rn| j | d }|rn|d |krn q�| j |d d }|r@|d |kr@ q�q@q& q�q&| j �� \}}| j j dkr�| �
� |s�d}| j �||� d S | j � |�}| j �
t| j �� | j �|� d S )Nr! r ra r )r� r� r3 r� r� r �
part_countr1 r+ �
_initial_sizer� �pop_fromr� r- r r� )rZ r� r �ch�i�prevpartr� � remainderr r r r� � s.
z _ValueFormatter._append_chunkN) r� r� r� r\ r� ro r� r� r� r� r� r� r r r r r � s %r c sj e Zd Zd� fdd� Zdd� Zddd�Z� fdd �Zd
d � Zd d
� Zddd�Z dd� Z
� fdd�Z � Z S )r� r c s || _ t� �� d S rp )r� r r\ )rZ � initial_size�� __class__r r r\ " s z_Accumulator.__init__c C s | � ||f� d S rp )r- )rZ r� r r r r r� & s z_Accumulator.pushc C s | |d � }g | |d �< |S rp r )rZ r� �poppedr r r r� ) s z_Accumulator.pop_fromc s | � � dkrdS t� �� S )Nr )r r )r� r r+ r� r� r r r+ . s z_Accumulator.popc C s t dd� | D �| j�S )Nc s s" | ]\}}t |�t |� V qd S rp )r3 �r r� r� r r r � <genexpr>4 � z'_Accumulator.__len__.<locals>.<genexpr>)�sumr� r� r r r �__len__3 s �z_Accumulator.__len__c C s t �dd� | D ��S )Nc s s | ]\}}t �||f�V qd S rp �rg rh r� r r r r� 8 s �z'_Accumulator.__str__.<locals>.<genexpr>r� r� r r r ro 7 s
�z_Accumulator.__str__Nc C s" |d u r g }|| d d �< d| _ d S r� )r� )rZ �startvalr r r r� ; s z_Accumulator.resetc C s | j dko| pt| ��� S r� )r� r r1 r� r r r r� A s z_Accumulator.is_onlywsc s
t � �� S rp )r r� r� r� r r r� D s z_Accumulator.part_count)r )r )N)
r� r� r� r\ r� r� r+ r� ro r� r� r� �
__classcell__r r r� r r� s
r� )NNr )3�__doc__�
__future__r r r Zfuture.builtinsr r r r r �__all__r� r5 Zfuture.backportsr
Zfuture.backports.emailr Z future.backports.email.errorsr Z future.backports.email.charsetZ backportsr r Z!future.backports.email.quoprimimer r rP r� rf r9 �SPACE8rg rW r� rU rx �compile�VERBOSE�
IGNORECASE� MULTILINEr' �fcrer� r r �objectr
r �listr� r r r r �<module> sH �
_ �
n PK �Du\��� � � : future/backports/email/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ sl d Z ddlmZ ddlmZ ddlmZ ddlmZ e�� dZg d�Z dd � Z
d
d � Z d d
� Z dd� Z
dS )z~
Backport of the Python 3.3 email package for Python-Future.
A package for parsing, handling, and generating email messages.
� )�unicode_literals)�division)�absolute_import)�surrogateescapez5.1.0)�
base64mime�charset�encoders�errors�
feedparser� generator�header� iterators�message�message_from_file�message_from_binary_file�message_from_string�message_from_bytes�mime�parser�
quoprimime�utilsc O s ddl m} ||i |���| �S )zvParse a string into a Message object model.
Optional _class and strict are passed to the Parser constructor.
r ��Parser)� future.backports.email.parserr �parsestr)�s�args�kwsr � r �I/usr/local/lib/python3.9/site-packages/future/backports/email/__init__.pyr 0 s r c O s ddl m} ||i |���| �S )z|Parse a bytes string into a Message object model.
Optional _class and strict are passed to the Parser constructor.
r �� BytesParser)r r! �
parsebytes)r r r r! r r r r 8 s r c O s ddl m} ||i |���| �S )z�Read a file and parse its contents into a Message object model.
Optional _class and strict are passed to the Parser constructor.
r r )r r �parse)�fpr r r r r r r @ s r c O s ddl m} ||i |���| �S )z�Read a binary file and parse its contents into a Message object model.
Optional _class and strict are passed to the Parser constructor.
r r )r r! r# )r$ r r r! r r r r H s r N)�__doc__�
__future__r r r Z future.utilsr Zregister_surrogateescape� __version__�__all__r r r r r r r r �<module> s PK �Du\+��m m ; future/backports/email/__pycache__/iterators.cpython-39.pycnu �[��� a
��?h, � @ sz d Z ddlmZ ddlmZ ddlmZ ddlmZ g d�ZddlZddlm Z d d
� Z
dd d
�Z ddd�Z ddd�Z
dS )z1Various types of useful iterators and generators.� )�print_function)�unicode_literals)�division)�absolute_import)�body_line_iterator�typed_subpart_iterator�walkN)�StringIOc c s4 | V | � � r0| �� D ]}|�� D ]
}|V q"qdS )z�Walk over the message tree, yielding each subpart.
The walk is performed in depth-first order. This method is a
generator.
N)� is_multipart� get_payloadr )�self�subpartZ
subsubpart� r �J/usr/local/lib/python3.9/site-packages/future/backports/email/iterators.pyr s
r Fc c s< | � � D ].}|j|d�}t|t�rt|�D ]
}|V q*qdS )z�Iterate over the parts, returning string payloads line-by-line.
Optional decode (default False) is passed through to .get_payload().
)�decodeN)r r �
isinstance�strr )�msgr r
�payload�liner r r r % s
r �textc c s8 | � � D ]*}|�� |kr|du s,|�� |kr|V qdS )z�Iterate over the subparts with a given MIME type.
Use `maintype' as the main MIME type to match against; this defaults to
"text". Optional `subtype' is the MIME subtype to match against; if
omitted, only the main type is matched.
N)r �get_content_maintype�get_content_subtype)r �maintype�subtyper
r r r r 1 s r c C s� |du rt j}d|d }t|| �� d|d� |rJtd| �� |d� n
t|d� | �� r|| �� D ]}t|||d |� qddS ) zA handy debugging aidN� � � )�end�filez [%s])r � )�sys�stdout�print�get_content_type�get_default_typer
r �
_structure)r �fp�level�include_default�tabr
r r r r& > s
r& )F)r N)Nr F)�__doc__�
__future__r r r r �__all__r! �ior r r r r& r r r r �<module> s
PK �Du\y�
��R �R @ future/backports/email/__pycache__/headerregistry.cpython-39.pycnu �[��� a
��?h�P � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z dd l
m Z dd
l
m
Z G d d � d e�ZG d
d� de�ZG dd� de�Zdd� ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG d!d"� d"e�ZG d#d$� d$e�Z G d%d&� d&e�Z G d'd(� d(e �Z G d)d*� d*e �Z G d+d,� d,e�Z eeeeeeeeeeeeeeee e e e d-�Z!G d.d/� d/e�Z"d0S )1a; Representing and manipulating email headers via custom objects.
This module provides an implementation of the HeaderRegistry API.
The implementation is designed to flexibly follow RFC5322 rules.
Eventually HeaderRegistry will be a public API, but it isn't yet,
and will probably change some before that happens.
� )�unicode_literals)�division)�absolute_import)�super��str)�text_to_native_str)�utils)�errors)�_header_value_parserc @ s^ e Zd Zddd�Zedd� �Zedd� �Zed d
� �Zed d � �Zd
d� Z dd� Z
dd� Z dS )�Address� Nc C sl |durV|s|rt d��t�|�\}}|r:td�||���|jrJ|jd �|j}|j}|| _|| _ || _
dS )a� Create an object represeting a full email address.
An address can have a 'display_name', a 'username', and a 'domain'. In
addition to specifying the username and domain separately, they may be
specified together by using the addr_spec keyword *instead of* the
username and domain keywords. If an addr_spec string is specified it
must be properly quoted according to RFC 5322 rules; an error will be
raised if it is not.
An Address object has display_name, username, domain, and addr_spec
attributes, all of which are read-only. The addr_spec and the string
value of the object are both quoted according to RFC5322 rules, but
without any Content Transfer Encoding.
Nz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r ) � TypeError�parserZ
get_addr_spec�
ValueError�format� all_defects�
local_part�domain�
_display_name� _username�_domain)�self� display_name�usernamer � addr_specZa_s�rest� r �O/usr/local/lib/python3.9/site-packages/future/backports/email/headerregistry.py�__init__ s �
zAddress.__init__c C s | j S �N�r �r r r r r < s zAddress.display_namec C s | j S r )r r" r r r r @ s zAddress.usernamec C s | j S r )r r" r r r r D s zAddress.domainc C sT t | j�}t|�t|tj �kr.t�| j�}n| j}| jrH|d | j S |sPdS |S )z�The addr_spec (username@domain) portion of the address, quoted
according to RFC 5322 rules, but with no Content Transfer Encoding.
�@�<>)�setr �lenr Z
DOT_ATOM_ENDS� quote_stringr )r �namesetZlpr r r r H s
zAddress.addr_specc C s d� | j| j| j�S )Nz6Address(display_name={!r}, username={!r}, domain={!r}))r r r r r" r r r �__repr__X s �zAddress.__repr__c C s^ t | j�}t|�t|tj �kr.t�| j�}n| j}|rX| jdkrFdn| j}d�||�S | jS )Nr$ r
z{} <{}>)r% r r& r �SPECIALSr' r r )r r( �dispr r r r �__str__\ s
zAddress.__str__c C s8 t |�t | �krdS | j|jko6| j|jko6| j|jkS �NF)�typer r r �r �otherr r r �__eq__g s
�
�zAddress.__eq__)r
r
r
N) �__name__�
__module__� __qualname__r �propertyr r r r r) r, r1 r r r r r s
%
r c @ sF e Zd Zddd�Zedd� �Zedd� �Zdd � Zd
d � Zd d
� Z dS )�GroupNc C s || _ |rt|�nt� | _dS )a Create an object representing an address group.
An address group consists of a display_name followed by colon and an
list of addresses (see Address) terminated by a semi-colon. The Group
is created by specifying a display_name and a possibly empty list of
Address objects. A Group can also be used to represent a single
address that is not in a group, which is convenient when manipulating
lists that are a combination of Groups and individual Addresses. In
this case the display_name should be set to None. In particular, the
string representation of a Group whose display_name is None is the same
as the Address object, if there is one and only one Address object in
the addresses list.
N)r �tuple�
_addresses)r r � addressesr r r r q s zGroup.__init__c C s | j S r r! r" r r r r � s zGroup.display_namec C s | j S r )r8 r" r r r r9 � s zGroup.addressesc C s d� | j| j�S )Nz'Group(display_name={!r}, addresses={!r})r r r9 r" r r r r) � s �zGroup.__repr__c C s� | j d u r&t| j�dkr&t| jd �S | j }|d ur\t|�}t|�t|tj �kr\t�|�}d�dd� | jD ��}|r~d| n|}d� ||�S )N� r �, c s s | ]}t |�V qd S r r )�.0�xr r r � <genexpr>� � z Group.__str__.<locals>.<genexpr>� z{}:{};)
r r& r9 r r% r r* r' �joinr )r r+ r( Zadrstrr r r r, � s
z
Group.__str__c C s, t |�t | �krdS | j|jko*| j|jkS r- )r. r r9 r/ r r r r1 � s
�z Group.__eq__)NN)
r2 r3 r4 r r5 r r9 r) r, r1 r r r r r6 o s
r6 c @ sT e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd
d � Z e
d d
� �Z dd� Z dS )�
BaseHeadera| Base class for message headers.
Implements generic behavior and provides tools for subclasses.
A subclass must define a classmethod named 'parse' that takes an unfolded
value string and a dictionary as its arguments. The dictionary will
contain one key, 'defects', initialized to an empty list. After the call
the dictionary must contain two additional keys: parse_tree, set to the
parse tree obtained from parsing the header, and 'decoded', set to the
string value of the idealized representation of the data from the value.
(That is, encoded words are decoded, and values that have canonical
representations are so represented.)
The defects key is intended to collect parsing defects, which the message
parser will subsequently dispose of as appropriate. The parser should not,
insofar as practical, raise any errors. Defects should be added to the
list instead. The standard header parsers register defects for RFC
compliance issues, for obsolete RFC syntax, and for unrecoverable parsing
errors.
The parse method may add additional keys to the dictionary. In this case
the subclass must define an 'init' method, which will be passed the
dictionary as its keyword arguments. The method should use (usually by
setting them as the value of similarly named attributes) and remove all the
extra keys added by its parse method, and then use super to call its parent
class with the remaining arguments and keywords.
The subclass should also make sure that a 'max_count' attribute is defined
that is either None or 1. XXX: need to better define this API.
c C sZ dg i}| � ||� t�|d �r4t�|d �|d< t�| |d �}|j|fi |�� |S )N�defects�decoded)�parser �_has_surrogates� _sanitizer �__new__�init)�cls�name�value�kwdsr r r r rH � s zBaseHeader.__new__c K s2 |d }|d= |d }|d= || _ || _|| _d S )NrC �
parse_tree)�_name� _parse_tree�_defects)r rK � _3to2kwargsrC rN r r r rI � s
zBaseHeader.initc C s | j S r )rO r" r r r rK � s zBaseHeader.namec C s
t | j�S r )r7 rQ r" r r r rC � s zBaseHeader.defectsc C s t | jj| jjt| �f| jfS r )�_reconstruct_header� __class__r2 � __bases__r �__dict__r" r r r �
__reduce__� s ��zBaseHeader.__reduce__c C s t �| |�S r )r rH )rJ rL r r r � _reconstruct� s zBaseHeader._reconstructc K sX |d }|d= t �t �t �| jd�t �dd�g�t �t �dd�g�| jg�}|j|d�S )N�policyz header-name�:z
header-sepr@ �fws)rY ) r �HeaderZ HeaderLabelZ
ValueTerminalrK ZCFWSListZWhiteSpaceTerminalrP �fold)r rR rY �headerr r r r] � s
��zBaseHeader.foldN)
r2 r3 r4 �__doc__rH rI r5 rK rC rW � classmethodrX r] r r r r rB � s
rB c C s t t| �|i ��|�S r )r. r rX )�cls_name�basesrL r r r rS s rS c @ s& e Zd ZdZeej�Zedd� �Z dS )�UnstructuredHeaderNc C s" | � |�|d< t|d �|d< d S )NrN rD )� value_parserr �rJ rL rM r r r rE s zUnstructuredHeader.parse)
r2 r3 r4 � max_count� staticmethodr �get_unstructuredrd r` rE r r r r rc s
rc c @ s e Zd ZdZdS )�UniqueUnstructuredHeaderr: N�r2 r3 r4 rf r r r r ri s ri c sF e Zd ZdZdZeej�Ze dd� �Z
� fdd�Z e dd� �Z
� ZS ) �
DateHeadera� Header whose value consists of a single timestamp.
Provides an additional attribute, datetime, which is either an aware
datetime using a timezone, or a naive datetime if the timezone
in the input string is -0000. Also accepts a datetime as input.
The 'value' attribute is the normalized form of the timestamp,
which means it is the output of format_datetime on the datetime.
Nc C sz |s6|d � t�� � d |d< d|d< t�� |d< d S t|t�rJt�|�}||d< t� |d �|d< | �
|d �|d< d S )NrC �datetimer
rD rN ) �appendr
�HeaderMissingRequiredValuer Z TokenList�
isinstancer r �parsedate_to_datetime�format_datetimerd re r r r rE , s
zDateHeader.parsec s" |� d�| _t� j|i |�� d S )Nrl )�pop� _datetimer rI �r �args�kw�rT r r rI : s zDateHeader.initc C s | j S r )rs r" r r r rl > s zDateHeader.datetime)r2 r3 r4 r_ rf rg r rh rd r` rE rI r5 rl �
__classcell__r r rw r rk s
rk c @ s e Zd ZdZdS )�UniqueDateHeaderr: Nrj r r r r ry C s ry c sP e Zd ZdZedd� �Zedd� �Z� fdd�Ze dd � �Z
e d
d � �Z � Z S ) �
AddressHeaderNc C s t �| �\}} | rJ d��|S )Nzthis should not happen)r Zget_address_list)rL � address_listr r r rd L s zAddressHeader.value_parserc C s� t |t�rV| �|� |d< }g }|jD ]"}|�t|jdd� |jD ��� q&t|j �}n"t
|d�sf|g}dd� |D �}g }||d< ||d< d� d d� |D ��|d
< d|vr�| �|d
�|d< d S ) NrN c S s* g | ]"}t |jpd |jpd |jp"d ��qS )r
)r r r r )r< �mbr r r �
<listcomp>[ s
�
�z'AddressHeader.parse.<locals>.<listcomp>�__iter__c S s& g | ] }t |d �s td|g�n|�qS )r9 N)�hasattrr6 �r< �itemr r r r} d s ��groupsrC r; c S s g | ] }t |��qS r r r� r r r r} j r? rD ) ro r rd r9 rm r6 r Z
all_mailboxes�listr r rA )rJ rL rM r{ r� �addrrC r r r rE R s*
��
�zAddressHeader.parsec s, t |�d��| _d | _t� j|i |�� d S )Nr� )r7 rr �_groupsr8 r rI rt rw r r rI n s zAddressHeader.initc C s | j S r )r� r" r r r r� s s zAddressHeader.groupsc C s& | j d u r tdd� | jD ��| _ | j S )Nc S s g | ]}|j D ]}|�qqS r )r9 )r< �group�addressr r r r} z s
�z+AddressHeader.addresses.<locals>.<listcomp>)r8 r7 r� r" r r r r9 w s
zAddressHeader.addresses)
r2 r3 r4 rf rg rd r` rE rI r5 r� r9 rx r r rw r rz H s
rz c @ s e Zd ZdZdS )�UniqueAddressHeaderr: Nrj r r r r r� s r� c @ s e Zd Zedd� �ZdS )�SingleAddressHeaderc C s( t | j�dkr td�| j���| jd S )Nr: z9value of single address header {} is not a single addressr )r& r9 r r rK r" r r r r� � s
�zSingleAddressHeader.addressN)r2 r3 r4 r5 r� r r r r r� � s r� c @ s e Zd ZdZdS )�UniqueSingleAddressHeaderr: Nrj r r r r r� � s r� c sZ e Zd ZdZeej�Zedd� �Z � fdd�Z
e dd� �Z e dd � �Z
e d
d � �Z� ZS ) �MIMEVersionHeaderr: c C s� | � |� |d< }t|�|d< |d �|j� |jd u r<d n|j|d< |j|d< |jd urtd�|d |d �|d< nd |d< d S )NrN rD rC �major�minorz{}.{}�version)rd r �extendr r� r� r �rJ rL rM rN r r r rE � s
zMIMEVersionHeader.parsec s: |� d�| _|� d�| _|� d�| _t� j|i |�� d S )Nr� r� r� )rr �_version�_major�_minorr rI rt rw r r rI � s zMIMEVersionHeader.initc C s | j S r )r� r" r r r r� � s zMIMEVersionHeader.majorc C s | j S r )r� r" r r r r� � s zMIMEVersionHeader.minorc C s | j S r )r� r" r r r r� � s zMIMEVersionHeader.version)r2 r3 r4 rf rg r Zparse_mime_versionrd r` rE rI r5 r� r� r� rx r r rw r r� � s
r� c s8 e Zd ZdZedd� �Z� fdd�Zedd� �Z� Z S )�ParameterizedMIMEHeaderr: c C s^ | � |� |d< }t|�|d< |d �|j� |jd u rBi |d< ntdd� |jD ��|d< d S )NrN rD rC �paramsc s s* | ]"\}}t �|��� t �|�fV qd S r )r rG �lower)r< rK rL r r r r> � s � �z0ParameterizedMIMEHeader.parse.<locals>.<genexpr>)rd r r� r r� �dictr� r r r rE � s
�z ParameterizedMIMEHeader.parsec s" |� d�| _t� j|i |�� d S )Nr� )rr �_paramsr rI rt rw r r rI � s z ParameterizedMIMEHeader.initc C s
| j �� S r )r� �copyr" r r r r� � s z ParameterizedMIMEHeader.params)
r2 r3 r4 rf r` rE rI r5 r� rx r r rw r r� � s
r� c sJ e Zd Zeej�Z� fdd�Zedd� �Z edd� �Z
edd� �Z � Z S ) �ContentTypeHeaderc s6 t � j|i |�� t�| jj�| _t�| jj�| _d S r ) r rI r rG rP �maintype� _maintype�subtype�_subtypert rw r r rI � s zContentTypeHeader.initc C s | j S r )r� r" r r r r� � s zContentTypeHeader.maintypec C s | j S r )r� r" r r r r� � s zContentTypeHeader.subtypec C s | j d | j S )N�/)r� r� r" r r r � content_type� s z ContentTypeHeader.content_type)
r2 r3 r4 rg r Zparse_content_type_headerrd rI r5 r� r� r� rx r r rw r r� � s
r� c s2 e Zd Zeej�Z� fdd�Zedd� �Z � Z
S )�ContentDispositionHeaderc s6 t � j|i |�� | jj}|d u r&|nt�|�| _d S r )r rI rP �content_dispositionr rG �_content_disposition)r ru rv Zcdrw r r rI � s z ContentDispositionHeader.initc C s | j S r )r� r" r r r r� � s z,ContentDispositionHeader.content_disposition) r2 r3 r4 rg r Z parse_content_disposition_headerrd rI r5 r� rx r r rw r r� � s
r� c sB e Zd ZdZeej�Zedd� �Z � fdd�Z
e dd� �Z � Z
S )� ContentTransferEncodingHeaderr: c C s2 | � |� |d< }t|�|d< |d �|j� d S )NrN rD rC )rd r r� r r� r r r rE � s z#ContentTransferEncodingHeader.parsec s& t � j|i |�� t�| jj�| _d S r )r rI r rG rP �cte�_ctert rw r r rI s z"ContentTransferEncodingHeader.initc C s | j S r )r� r" r r r r� s z!ContentTransferEncodingHeader.cte)r2 r3 r4 rf rg r Z&parse_content_transfer_encoding_headerrd r` rE rI r5 r� rx r r rw r r� � s
r� )�subject�datez resent-datez orig-dateZsenderz
resent-sender�toz resent-to�ccz resent-ccZbccz
resent-bcc�fromz resent-fromzreply-toz mime-versionz content-typezcontent-dispositionzcontent-transfer-encodingc @ s8 e Zd ZdZeedfdd�Zdd� Zdd� Zd d
� Z d S ) �HeaderRegistryz%A header_factory and header registry.Tc C s& i | _ || _|| _|r"| j �t� dS )a� Create a header_factory that works with the Policy API.
base_class is the class that will be the last class in the created
header class's __bases__ list. default_class is the class that will be
used if "name" (see __call__) does not appear in the registry.
use_default_map controls whether or not the default mapping of names to
specialized classes is copied in to the registry when the factory is
created. The default is True.
N)�registry�
base_class�
default_class�update�_default_header_map)r r� r� Zuse_default_mapr r r r * s
zHeaderRegistry.__init__c C s || j |�� < dS )zLRegister cls as the specialized class for handling "name" headers.
N)r� r� �r rK rJ r r r � map_to_type< s zHeaderRegistry.map_to_typec C s0 | j �|�� | j�}ttd|j �|| jfi �S )N�_)r� �getr� r� r. r r2 r� r� r r r � __getitem__B s zHeaderRegistry.__getitem__c C s | | ||�S )a� Create a header instance for header 'name' from 'value'.
Creates a header instance by creating a specialized class for parsing
and representing the specified header by combining the factory
base_class with a specialized class from the registry or the
default_class, and passing the name and value to the constructed
class's constructor.
r )r rK rL r r r �__call__F s
zHeaderRegistry.__call__N)
r2 r3 r4 r_ rB rc r r� r� r� r r r r r� & s �
r� N)#r_ �
__future__r r r Zfuture.builtinsr r Z future.utilsr Zfuture.backports.emailr r
r r �objectr r6 rB rS rc ri rk ry rz r� r� r� r� r� r� r� r� r� r� r r r r �<module> s^ Z5d '7
% �PK �Du\�yI� � @ future/backports/email/__pycache__/_encoded_words.cpython-39.pycnu �[��� a
��?h� � @ s: d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd l
Z
dd l Z dd l Z dd l
Z
dd
lmZmZ dd lmZ g d �Ze
�e
�d
�jdd� �Zdd� ZG dd� de�Ze� Zdee d�< dd� Z dd� Z dd� Z d d � Z d d � Z!ee d �Z"d!d"� Z#e e d �Z$e e!d �Z%d'd%d&�Z&d S )(z� Routines for manipulating RFC2047 encoded words.
This is currently a package-private API, but will be considered for promotion
to a public API if there is demand.
� )�unicode_literals)�division)�absolute_import)�bytes)�chr)�int)�strN)�
ascii_letters�digits)�errors)�decode_q�encode_q�decode_b�encode_b�len_q�len_b�decode�encodes =([a-fA-F0-9]{2})c C s t t| �d�d�g�S )N� � )r r �group)�m� r �O/usr/local/lib/python3.9/site-packages/future/backports/email/_encoded_words.py�<lambda>H � r c C s t | �dd��} t| �g fS )N� _� )r �replace�_q_byte_subber)�encodedr r r r J s r c @ s0 e Zd Zede�d� e�d� �Zdd� ZdS )� _QByteMaps -!*+/�asciic C s. || j v rt|�| |< nd�|�| |< | | S )Nz={:02X})�safer �format)�self�keyr r r � __missing__T s
z_QByteMap.__missing__N) �__name__�
__module__� __qualname__r r r r
r# r' r r r r r! P s r! �_� c C s t d�dd� t| �D ���S )N� c s s | ]}t | V qd S �N)� _q_byte_map��.0�xr r r � <genexpr>a r zencode_q.<locals>.<genexpr>)r �joinr ��bstringr r r r
` s r
c C s t dd� t| �D ��S )Nc s s | ]}t t| �V qd S r. )�lenr/ r0 r r r r3 d r zlen_q.<locals>.<genexpr>)�sumr r5 r r r r c s r c
C s� g }t | �d }|r8|�t�� � | dd d| � }n| }z&t�d|�sTt�d��t� |�|fW S tjy� t�
� g}dD ]T}z t� | d| �|fW Y S tjt fy� |dkr�|�t�� � Y q�0 q�t d��Y n0 d S ) N� s ===s ^[A-Za-z0-9+/]*={0,2}$zNon-base64 digit found)r r � � � =r zunexpected binascii.Error)
r7 �appendr �InvalidBase64PaddingDefect�re�match�binascii�Error�base64� b64decode� InvalidBase64CharactersDefect� TypeError�AssertionError)r �defects�pad_errZpadded_encoded�ir r r r k s&
r c C s t �| ��d�S )Nr" )rC � b64encoder r5 r r r r � s r c C s& t t| �d�\}}|d |r dnd S )Nr; r9 r )�divmodr7 )r6 � groups_of_3�leftoverr r r r � s r )�q�bc
C s� t | ��d�\}}}}}|�d�\}}}|�� }|�dd�}t| |�\}}z|�|�}W nr ty� |�t �
d� |��� |�|d�}Y n@ t y� |�dd�}|�� dkr�|�t �
d� |��� Y n0 ||||fS )u� Decode encoded word and return (string, charset, lang, defects) tuple.
An RFC 2047/2243 encoded word has the form:
=?charset*lang?cte?encoded_string?=
where '*lang' may be omitted but the other parts may not be.
This function expects exactly such a string (that is, it does not check the
syntax and may raise errors if the string is not well formed), and returns
the encoded_string decoded first from its Content Transfer Encoding and
then from the resulting bytes into unicode using the specified charset. If
the cte-decoded string does not successfully decode using the specified
character set, a defect is added to the defects list and the unknown octets
are replaced by the unicode 'unknown' character ﷿.
The specified charset and language are returned. The default for language,
which is rarely if ever encountered, is the empty string.
�?�*r" �surrogateescapez:Encoded word contains bytes not decodable using {} charset� unknown-8bitz<Unknown charset {} in encoded word; decoded as unknown bytes)r �split� partition�lowerr �
_cte_decodersr � UnicodeErrorr= r �UndecodableBytesDefectr$ � LookupError� CharsetError) �ewr+ �charset�cte�
cte_string�langr6 rH �stringr r r r � s& � �r �utf-8r- c C s� t | �} |dkr | �dd�}n
| �|�}|du r\td |�}td |�}|| dk rXdnd}t| |�}|rtd| }d �||||�S )
a Encode string using the CTE encoding that produces the shorter result.
Produces an RFC 2047/2243 encoded word of the form:
=?charset*lang?cte?encoded_string?=
where '*lang' is omitted unless the 'lang' parameter is given a value.
Optional argument charset (defaults to utf-8) specifies the charset to use
to encode the string to binary before CTE encoding it. Optional argument
'encoding' is the cte specifier for the encoding that should be used ('q'
or 'b'); if it is None (the default) the encoding which produces the
shortest encoded sequence is used, except that 'q' is preferred if it is up
to five characters longer. Optional argument 'lang' (default '') gives the
RFC 2243 language string to specify in the encoded word.
rT r" rS NrO rP � rR z=?{0}{1}?{2}?{3}?=)r r �_cte_encode_length�
_cte_encodersr$ )rb r^ �encodingra r6 �qlen�blenr r r r r � s
r )rc Nr- )'�__doc__�
__future__r r r Zfuture.builtinsr r r r r? rC rA � functoolsrb r r
Zfuture.backports.emailr �__all__�partial�compile�subr r �dictr! r/ �ordr
r r r r rX r rf re r r r r r �<module> sJ $ � �+��PK �Du\=ި� 9 9 = future/backports/email/__pycache__/_policybase.cpython-39.pycnu �[��� a
��?h79 � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
dd l Z dd
l m
Z
dd l mZ dd lmZ g d
�ZG dd� de�Zdd� Zdd� ZG dd� de
e je��ZeG dd� de��Ze� Zd S )zwPolicy framework for the email package.
Allows fine grained feature control of how the package parses and emits data.
� )�unicode_literals)�print_function)�division)�absolute_import)�super)�str)�with_metaclassN)�header)�charset)�_has_surrogates)�Policy�Compat32�compat32c s@ e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd
d � Z� Z S ) � _PolicyBasea� Policy Object basic framework.
This class is useless unless subclassed. A subclass should define
class attributes with defaults for any values that are to be
managed by the Policy object. The constructor will then allow
non-default values to be set for these attributes at instance
creation time. The instance will be callable, taking these same
attributes keyword arguments, and returning a new instance
identical to the called instance except for those values changed
by the keyword arguments. Instances may be added, yielding new
instances with any non-default values from the right hand
operand overriding those in the left hand operand. That is,
A + B == A(<non-default values of B>)
The repr of an instance can be used to reconstruct the object
if and only if the repr of the values can be used to reconstruct
those values.
c sH |� � D ]:\}}t| |�r.tt| ��||� qtd�|| jj���qdS )z�Create new Policy, possibly overriding some defaults.
See class docstring for a list of overridable attributes.
�*{!r} is an invalid keyword argument for {}N) �items�hasattrr r � __setattr__� TypeError�format� __class__�__name__)�self�kw�name�value�r � �L/usr/local/lib/python3.9/site-packages/future/backports/email/_policybase.py�__init__0 s
��z_PolicyBase.__init__c C s* dd� | j �� D �}d�| jjd�|��S )Nc S s g | ]\}}d � ||��qS )z{}={!r})r )�.0r r r r r �
<listcomp>? s �z(_PolicyBase.__repr__.<locals>.<listcomp>z{}({})z, )�__dict__r r r r �join)r �argsr r r �__repr__> s �z_PolicyBase.__repr__c K sr | j �| j �}| j�� D ]\}}t�|||� q|�� D ]4\}}t| |�s^td�|| j j ���t�|||� q8|S )z�Return a new instance with specified attributes changed.
The new instance has the same attribute values as the current object,
except for the changes passed in as keyword arguments.
r )
r �__new__r" r �objectr r r r r )r r � newpolicy�attrr r r r �cloneC s
��z_PolicyBase.clonec C s, t | |�rd}nd}t|�| jj|���d S )Nz'{!r} object attribute {!r} is read-onlyz!{!r} object has no attribute {!r})r �AttributeErrorr r r )r r r �msgr r r r U s
z_PolicyBase.__setattr__c C s | j f i |j��S )z�Non-default values from right operand override those from left.
The object returned is a new instance of the subclass.
)r* r" )r �otherr r r �__add__\ s z_PolicyBase.__add__)
r �
__module__� __qualname__�__doc__r r% r* r r. �
__classcell__r r r r r s r c C s, | � dd�d } |�dd�d }| d | S )N�
� r )�rsplit�split)�doc� added_docr r r � _append_doce s r9 c C s� | j r(| j �d�r(t| jd j | j �| _ | j�� D ]V\}}|j r2|j �d�r2dd� | jD �D ]*}tt||�d�}|r\t||j �|_ q2q\q2| S )N�+r c s s | ]}|� � D ]
}|V qqd S )N)�mro)r �base�cr r r � <genexpr>o � z%_extend_docstrings.<locals>.<genexpr>r1 )r1 �
startswithr9 � __bases__r" r �getattr)�clsr r) r= r7 r r r �_extend_docstringsj s rD c @ s~ e Zd ZdZdZdZdZdZdd� Zdd � Z d
d � Z
e j d d
� �Z
e j dd� �Ze j dd� �Ze j dd� �Ze j dd� �ZdS )r a� Controls for how messages are interpreted and formatted.
Most of the classes and many of the methods in the email package accept
Policy objects as parameters. A Policy object contains a set of values and
functions that control how input is interpreted and how output is rendered.
For example, the parameter 'raise_on_defect' controls whether or not an RFC
violation results in an error being raised or not, while 'max_line_length'
controls the maximum length of output lines when a Message is serialized.
Any valid attribute may be overridden when a Policy is created by passing
it as a keyword argument to the constructor. Policy objects are immutable,
but a new Policy object can be created with only certain values changed by
calling the Policy instance with keyword arguments. Policy objects can
also be added, producing a new Policy object in which the non-default
attributes set in the right hand operand overwrite those specified in the
left operand.
Settable attributes:
raise_on_defect -- If true, then defects should be raised as errors.
Default: False.
linesep -- string containing the value to use as separation
between output lines. Default '\n'.
cte_type -- Type of allowed content transfer encodings
7bit -- ASCII only
8bit -- Content-Transfer-Encoding: 8bit is allowed
Default: 8bit. Also controls the disposition of
(RFC invalid) binary data in headers; see the
documentation of the binary_fold method.
max_line_length -- maximum length of lines, excluding 'linesep',
during serialization. None or 0 means no line
wrapping is done. Default is 78.
Fr3 �8bit�N c C s | j r
|�| �||� dS )aZ Based on policy, either raise defect or call register_defect.
handle_defect(obj, defect)
defect should be a Defect subclass, but in any case must be an
Exception subclass. obj is the object on which the defect should be
registered if it is not raised. If the raise_on_defect is True, the
defect is raised as an error, otherwise the object and the defect are
passed to register_defect.
This method is intended to be called by parsers that discover defects.
The email package parsers always call it with Defect instances.
N)�raise_on_defect�register_defect�r �obj�defectr r r �
handle_defect� s zPolicy.handle_defectc C s |j �|� dS )a� Record 'defect' on 'obj'.
Called by handle_defect if raise_on_defect is False. This method is
part of the Policy API so that Policy subclasses can implement custom
defect handling. The default implementation calls the append method of
the defects attribute of obj. The objects used by the email package by
default that get passed to this method will always have a defects
attribute with an append method.
N)�defects�appendrI r r r rH � s zPolicy.register_defectc C s dS )a[ Return the maximum allowed number of headers named 'name'.
Called when a header is added to a Message object. If the returned
value is not 0 or None, and there are already a number of headers with
the name 'name' equal to the value returned, a ValueError is raised.
Because the default behavior of Message's __setitem__ is to append the
value to the list of headers, it is easy to create duplicate headers
without realizing it. This method allows certain headers to be limited
in the number of instances of that header that may be added to a
Message programmatically. (The limit is not observed by the parser,
which will faithfully produce as many headers as exist in the message
being parsed.)
The default implementation returns None for all header names.
Nr )r r r r r �header_max_count� s zPolicy.header_max_countc C s t �dS )aZ Given a list of linesep terminated strings constituting the lines of
a single header, return the (name, value) tuple that should be stored
in the model. The input lines should retain their terminating linesep
characters. The lines passed in by the email package may contain
surrogateescaped binary data.
N��NotImplementedError)r � sourcelinesr r r �header_source_parse� s zPolicy.header_source_parsec C s t �dS )z�Given the header name and the value provided by the application
program, return the (name, value) that should be stored in the model.
NrP �r r r r r r �header_store_parse� s zPolicy.header_store_parsec C s t �dS )aw Given the header name and the value from the model, return the value
to be returned to the application program that is requesting that
header. The value passed in by the email package may contain
surrogateescaped binary data if the lines were parsed by a BytesParser.
The returned value should not contain any surrogateescaped data.
NrP rT r r r �header_fetch_parse� s zPolicy.header_fetch_parsec C s t �dS )a� Given the header name and the value from the model, return a string
containing linesep characters that implement the folding of the header
according to the policy controls. The value passed in by the email
package may contain surrogateescaped binary data if the lines were
parsed by a BytesParser. The returned value should not contain any
surrogateescaped data.
NrP rT r r r �fold� s
z Policy.foldc C s t �dS )a% Given the header name and the value from the model, return binary
data containing linesep characters that implement the folding of the
header according to the policy controls. The value passed in by the
email package may contain surrogateescaped binary data.
NrP rT r r r � fold_binary s zPolicy.fold_binaryN)r r/ r0 r1 rG �linesep�cte_type�max_line_lengthrL rH rO �abc�abstractmethodrS rU rV rW rX r r r r r w s$ (
r c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dS )r
z�+
This particular policy is the backward compatibility Policy. It
replicates the behavior of the email package version 5.1.
c C s0 t |t�s|S t|�r(tj|tj|d�S |S d S )N�r
� header_name)�
isinstancer r r �Header�_charset� UNKNOWN8BITrT r r r �_sanitize_header s
�zCompat32._sanitize_headerc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )a: +
The name is parsed as everything up to the ':' and returned unmodified.
The value is determined by stripping leading whitespace off the
remainder of the first line, joining all subsequent lines together, and
stripping any trailing carriage return or linefeed characters.
r �:r4 z � Nz
)r6 �lstripr# �rstrip)r rR r r r r r rS s z Compat32.header_source_parsec C s ||fS )z>+
The name and value are returned unmodified.
r rT r r r rU , s zCompat32.header_store_parsec C s | � ||�S )z�+
If the value contains binary data, it is converted into a Header object
using the unknown-8bit charset. Otherwise it is returned unmodified.
)rd rT r r r rV 2 s zCompat32.header_fetch_parsec C s | j ||dd�S )a +
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. Non-ASCII binary data are CTE encoded using the
unknown-8bit charset.
T��sanitize)�_foldrT r r r rW 9 s z
Compat32.foldc C s" | j ||| jdkd�}|�dd�S )a� +
Headers are folded using the Header folding algorithm, which preserves
existing line breaks in the value, and wraps each resulting line to the
max_line_length. If cte_type is 7bit, non-ascii binary data is CTE
encoded using the unknown-8bit charset. Otherwise the original source
header is used, with its existing line breaks and/or binary data.
�7bitri �ascii�surrogateescape)rk rZ �encode)r r r �foldedr r r rX C s zCompat32.fold_binaryc C s� g }|� d| � t|t�r\t|�rL|r<tj|tj|d�}qZ|� |� d }q`tj||d�}n|}|d ur�|� |j| j | j
d�� |� | j � d� |�S )Nz%s: r^ )r_ )rY �
maxlinelenrf ) rN r` r r r ra rb rc ro rY r[ r# )r r r rj �parts�hr r r rk O s&
�
� zCompat32._foldN) r r/ r0 r1 rd rS rU rV rW rX rk r r r r r
s
r
)r1 �
__future__r r r r Zfuture.builtinsr r Z future.utilsr r\ Zfuture.backports.emailr r
rb Z future.backports.email.utilsr �__all__r' r r9 rD �ABCMetar r
r r r r r �<module> s( L
`PK �Du\�L�
� � 8 future/backports/email/__pycache__/policy.cpython-39.pycnu �[��� a
��?hw" � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZm Z m
Z
m Z ddl m
Z
ddlmZ g d �Ze G d
d � d e��Ze� Ze`ejd d
�Zejdd�Zejddd�ZdS )zcThis will be the home for the policy that hooks in the new
code that adds all the email6 features.
� )�unicode_literals)�division)�absolute_import)�super)�Policy�Compat32�compat32�_extend_docstrings)�_has_surrogates)�HeaderRegistry)r r r � EmailPolicy�default�strict�SMTP�HTTPc sd e Zd ZdZdZe� Z� fdd�Zdd� Zdd� Z d d
� Z
d d � Z d
d� Z dd� Z
ddd�Z� ZS )r a +
PROVISIONAL
The API extensions enabled by this policy are currently provisional.
Refer to the documentation for details.
This policy adds new header parsing and folding algorithms. Instead of
simple strings, headers are custom objects with custom attributes
depending on the type of the field. The folding algorithm fully
implements RFCs 2047 and 5322.
In addition to the settable attributes listed above that apply to
all Policies, this policy adds the following additional attributes:
refold_source -- if the value for a header in the Message object
came from the parsing of some source, this attribute
indicates whether or not a generator should refold
that value when transforming the message back into
stream form. The possible values are:
none -- all source values use original folding
long -- source values that have any line that is
longer than max_line_length will be
refolded
all -- all values are refolded.
The default is 'long'.
header_factory -- a callable that takes two arguments, 'name' and
'value', where 'name' is a header field name and
'value' is an unfolded header field value, and
returns a string-like object that represents that
header. A default header_factory is provided that
understands some of the RFC5322 header field types.
(Currently address fields and date fields have
special treatment, while all other fields are
treated as unstructured. This list will be
completed before the extension is marked stable.)
�longc s. d|vrt �| dt� � t� jf i |�� d S )N�header_factory)�object� __setattr__r r �__init__)�self�kw�� __class__� �G/usr/local/lib/python3.9/site-packages/future/backports/email/policy.pyr G s zEmailPolicy.__init__c C s | j | jS )z�+
The implementation for this class returns the max_count attribute from
the specialized header class that would be used to construct a header
of type 'name'.
)r � max_count)r �namer r r �header_max_countN s z EmailPolicy.header_max_countc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )ac +
The name is parsed as everything up to the ':' and returned unmodified.
The value is determined by stripping leading whitespace off the
remainder of the first line, joining all subsequent lines together, and
stripping any trailing carriage return or linefeed characters. (This
is the same as Compat32).
r �:� z � N�
)�split�lstrip�join�rstrip)r � sourcelinesr �valuer r r �header_source_parse` s z EmailPolicy.header_source_parsec C sV t |d�r$|j�� |�� kr$||fS t|t�rFt|�� �dkrFtd��|| �||�fS )a� +
The name is returned unchanged. If the input value has a 'name'
attribute and it matches the name ignoring case, the value is returned
unchanged. Otherwise the name and value are passed to header_factory
method, and the resulting custom header object is returned as the
value. In this case a ValueError is raised if the input value contains
CR or LF characters.
r r zDHeader values may not contain linefeed or carriage return characters) �hasattrr �lower�
isinstance�str�len�
splitlines�
ValueErrorr �r r r( r r r �header_store_parsem s
z EmailPolicy.header_store_parsec C s$ t |d�r|S | �|d�|�� ��S )ai +
If the value has a 'name' attribute, it is returned to unmodified.
Otherwise the name and the value with any linesep characters removed
are passed to the header_factory method, and the resulting custom
header object is returned. Any surrogateescaped bytes get turned
into the unicode unknown-character glyph.
r r! )r* r r% r/ r1 r r r �header_fetch_parse~ s
z EmailPolicy.header_fetch_parsec C s | j ||dd�S )a +
Header folding is controlled by the refold_source policy setting. A
value is considered to be a 'source value' if and only if it does not
have a 'name' attribute (having a 'name' attribute means it is a header
object of some sort). If a source value needs to be refolded according
to the policy, it is converted into a custom header object by passing
the name and the value with any linesep characters removed to the
header_factory method. Folding of a custom header object is done by
calling its fold method with the current policy.
Source values are split into lines using splitlines. If the value is
not to be refolded, the lines are rejoined using the linesep from the
policy and returned. The exception is lines containing non-ascii
binary data. In that case the value is refolded regardless of the
refold_source setting, which causes the binary data to be CTE encoded
using the unknown-8bit charset.
T��
refold_binary)�_foldr1 r r r �fold� s zEmailPolicy.foldc C s" | j ||| jdkd�}|�dd�S )a� +
The same as fold if cte_type is 7bit, except that the returned value is
bytes.
If cte_type is 8bit, non-ASCII binary data is converted back into
bytes. Headers with binary data are not refolded, regardless of the
refold_header setting, since there is no way to know whether the binary
data consists of single byte characters or multibyte characters.
�7bitr4 �ascii�surrogateescape)r6 �cte_type�encode)r r r( �foldedr r r � fold_binary� s zEmailPolicy.fold_binaryFc s� t |d�r|j| d�S | jr"| jntd�� |�� }| jdkp�| jdko�|rft|d �t|� d � kp�t� fdd �|d
d � D ��}|s�|r�t|�r�| � |d �
|��j| d�S |d | j �
|� | j S )
Nr )�policy�inf�allr r � c 3 s | ]}t |�� kV qd S )N)r. )�.0�x��maxlenr r � <genexpr>� � z$EmailPolicy._fold.<locals>.<genexpr>r r! z: ) r* r7 �max_line_length�floatr/ �
refold_sourcer. �anyr
r r% �linesep)r r r( r5 �linesZrefoldr rE r r6 � s
�zEmailPolicy._fold)F)�__name__�
__module__� __qualname__�__doc__rK r r r r r) r2 r3 r7 r> r6 �
__classcell__r r r r r s (
r T)�raise_on_defectr" )rM N)rM rI )rR �
__future__r r r Zfuture.builtinsr Z)future.standard_library.email._policybaser r r r Z#future.standard_library.email.utilsr
Z,future.standard_library.email.headerregistryr �__all__r r
r �cloner r r r r r r �<module> s # PK �Du\UKj^�) �) < future/backports/email/__pycache__/feedparser.cpython-39.pycnu �[��� a
��?h�X � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZmZmZ ddl m
Z
m Z ddgZ dd l
Z
dd
lmZ dd lmZ dd lmZ e
�d
�Ze
�d�Ze
�d�Ze
�d�Ze
�d�ZdZdZe� ZG dd� de�Z G dd� de�Z G dd� de �Z d S )a FeedParser - An email feed parser.
The feed parser implements an interface for incrementally parsing an email
message, line by line. This has advantages for certain applications, such as
those reading email messages off a socket.
FeedParser.feed() is the primary interface for pushing new data into the
parser. It returns when there's nothing more it can do with the available
data. When you have no more data to push into the parser, call .close().
This completes the parsing and returns the root message object.
The other advantage of this parser is that it will never raise a parsing
exception. Instead, when it finds something unexpected, it adds a 'defect' to
the current message. Defects are just instances that live on the message
object's .defects attribute.
� )�unicode_literals)�division)�absolute_import)�object�range�super)�implements_iterator�PY3�
FeedParser�BytesFeedParserN)�errors)�message)�compat32z
|
|
z(
|
|
)z
(
|
|
)\Zz(^(From |[\041-\071\073-\176]{1,}:|[\t ])� �
c @ s` e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dS )�BufferedSubFileak A file-ish object that can have new data loaded into it.
You can also push and pop line-matching predicates onto a stack. When the
current predicate matches the current line, a false EOF response
(i.e. empty string) is returned instead. This lets the parser adhere to a
simple abstraction -- it parses until EOF closes the current message.
c C s d| _ g | _g | _d| _d S )Nr F)�_partial�_lines� _eofstack�_closed��self� r �K/usr/local/lib/python3.9/site-packages/future/backports/email/feedparser.py�__init__9 s zBufferedSubFile.__init__c C s | j �|� d S �N)r �append)r �predr r r �push_eof_matcherC s z BufferedSubFile.push_eof_matcherc C s
| j �� S r )r �popr r r r �pop_eof_matcherF s z BufferedSubFile.pop_eof_matcherc C s | j �| j� d| _d| _d S )Nr T)r r r r r r r r �closeI s zBufferedSubFile.closec C sR | j s| jrdS tS | j �� }| jd d d� D ] }||�r.| j �|� dS q.|S )Nr ���)r r � NeedMoreDatar r r )r �line�ateofr r r �readlineO s
zBufferedSubFile.readlinec C s |t us J �| j�|� d S r )r# r r �r r$ r r r �
unreadlinea s zBufferedSubFile.unreadlinec C s� | j | d }| _ t�|�}|�� | _ | j sR|rR|d �d�rR|�d�|�� | _ g }tt|�d �D ]&}|�||d ||d d � qf| �|� dS )z$Push some new data into this object.r r" �
���� � N) r � NLCRE_crack�splitr �endswithr �lenr � pushlines)r �data�parts�lines�ir r r �pushf s
$zBufferedSubFile.pushc C s |d d d� | j d d�< d S )Nr" r )r )r r4 r r r r1 } s zBufferedSubFile.pushlinesc C s | S r r r r r r �__iter__� s zBufferedSubFile.__iter__c C s | � � }|dkrt�|S )Nr )r& �
StopIterationr' r r r �__next__� s zBufferedSubFile.__next__N)�__name__�
__module__� __qualname__�__doc__r r r r! r& r( r6 r1 r7 r9 r r r r r 1 s
r c @ s^ e Zd ZdZejfdd�Zdd� Zdd� Zdd � Z d
d � Z
d d
� Z dd� Z dd� Z
dd� ZdS )r
z A feed-style parser of email.c s� d|v r|d }|d= nt }|� _|� _z |� jd� � fdd�� _W n tyb dd� � _Y n0 t� � _g � _tr�� � � j
� _ n � � � j � _ d � _
d � _d� _d S )N�policy�r> c s
d� j iS )Nr> r? r r r r �<lambda>� � z%FeedParser.__init__.<locals>.<lambda>c S s i S r r r r r r r@ � rA F)r �_factoryr> �
_factory_kwds� TypeErrorr �_input� _msgstackr � _parsegenr9 �_parse�next�_cur�_last� _headersonly)r rB Z _3to2kwargsr> r r r r � s" zFeedParser.__init__c C s
d| _ d S )NT)rL r r r r �_set_headersonly� s zFeedParser._set_headersonlyc C s | j �|� | �� dS )z Push more data into the parser.N)rE r6 � _call_parse�r r2 r r r �feed� s zFeedParser.feedc C s$ z | � � W n ty Y n0 d S r )rH r8 r r r r rN � s zFeedParser._call_parsec C sR | j �� | �� | �� }| jr$J �|�� dkrN|�� sNt�� }| j �
||� |S )z<Parse all remaining data and return the root message object.� multipart) rE r! rN � _pop_messagerF �get_content_maintype� is_multipartr �!MultipartInvariantViolationDefectr> �
handle_defect)r �root�defectr r r r! � s
�zFeedParser.closec C sd | j f i | �� ��}| jr2| j�� dkr2|�d� | jrH| jd �|� | j�|� || _|| _d S )Nzmultipart/digestzmessage/rfc822r" ) rB rC rJ �get_content_type�set_default_typerF �attachr rK )r �msgr r r � _new_message� s
zFeedParser._new_messagec C s( | j �� }| j r | j d | _nd | _|S )Nr" )rF r rJ )r �retvalr r r rR � s
zFeedParser._pop_messagec c s | � � g }| jD ]Z}|tu r&tV qt�|�sbt�|�s^t�� }| j� | j
|� | j� |� qn|� |� q| �
|� | jr�g }| j�� }|tu r�tV q�|dkr�q�|� |� q�| j
�t�|�� d S | j
�� dk�r�| j�tj� | �� D ] }|tu �rtV q� �q q�| �� }| j�� | j�� }|tu �rDtV �q �qD�q | j�� }|tu �rjtV �qD�qj�qD|dk�rx�q�| j� |� q�d S | j
�� dk�r�| �� D ] }|tu �r�tV �q� �qĐq�| �� d S | j
�� dk�r�| j
�� }|d u �rRt�� }| j� | j
|� g }| jD ]$}|tu �r.tV �q|� |� �q| j
�t�|�� d S | j
�dd�� � dv�r�t� � }| j� | j
|� d| }t � d t � |� d
�} d }
g } d } d }
| j�� }|tu �r�tV �q�|dk�rސq�| �|�}|�r�|�!d
��r d }
|�!d�} �q�|
�rn| �rZ| d }t"�#|�}|�rL|d t$|�!d�� � | d< t�| �| j
_%d }
| j� |� �q�| j�� }|tu �r�tV �qn| �|�}|�sn| j� |� �q��qn| j�| j� | �� D ] }|tu �r�tV �q� �q�q�| j&�� dk�rP| j&j'}|dk�rd | j&_'n:|d u�r�t"�#|�}|�r�t$|�!d��}|d | � | j&_'nD| j&j(}t)|t*��r�t"�#|�}|�r�|d t$|�!d�� � }|| j&_(| j�� | �� | j
| _&n|
�s�J �| � |� �q�|
�r0t�+� }| j� | j
|� | j
�t�| �� g }| jD ]}|tu �rtV �q�qt�|�| j
_'d S |
�sRt�,� }| j� | j
|� d S | �r`dg}ng }| jD ]$}|tu �r�tV �qj|� |� �qj|�r�|d }t-�|�}|�r�|t$|�!d��d � |d< t�|�| j
_'d S g }| jD ]$}|tu �r�tV �q�|� |� �q�| j
�t�|�� d S )Nr zmessage/delivery-statusr
rQ zcontent-transfer-encoding�8bit)�7bitr_ �binaryz--z(?P<sep>z4)(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$TF�end�linesepr" r ).r] rE r# �headerRE�match�NLCREr � MissingHeaderBodySeparatorDefectr> rV rJ r( r �_parse_headersrL r& � set_payload� EMPTYSTRING�joinrY r rG rR r rS � get_boundary�NoBoundaryInMultipartDefect�get�lower�-InvalidMultipartContentTransferEncodingDefect�re�compile�escape�group� NLCRE_eol�searchr0 �preamblerK �epilogue�_payload�
isinstance�str�StartBoundaryNotFoundDefect�CloseBoundaryNotFoundDefect� NLCRE_bol)r �headersr$ rX r4 r^ r\ �boundary� separator�
boundaryre�capturing_preamblerw rc �close_boundary_seen�mo�lastline�eolmorx rb �payload� firstline�bolmor r r rG � sb
� ��
zFeedParser._parsegenc C sF d}g }t |�D �]\}}|d dv rR|sFt�|�}| j�| j|� q|�|� q|rt| jj| j�|�� dg }}|� d�r�|dkr�t
� |�}|r�|d t |�
d�� � }| j�|� qn<|t |�d kr�| j�|� d S t�|�}| jj�|� q|�d�}|dk�sJ d��|d |� }|g}q|�rB| jj| j�|�� d S )Nr r z zFrom r, �:z3_parse_headers fed line with no : and no leading WS)� enumerater �#FirstHeaderLineIsContinuationDefectr> rV rJ r �set_raw�header_source_parse�
startswithru rv r0 rt � set_unixfromrE r( � MisplacedEnvelopeHeaderDefect�defects�find) r r4 �
lastheader� lastvalue�linenor$ rX r� r5 r r r rh � s@
zFeedParser._parse_headersN)r: r; r< r= r
�Messager rM rP rN r! r] rR rG rh r r r r r
� s
~c s e Zd ZdZ� fdd�Z� ZS )r z(Like FeedParser, but feed accepts bytes.c s t � �|�dd�� d S )N�ascii�surrogateescape)r rP �decoderO �� __class__r r rP s zBytesFeedParser.feed)r: r; r< r= rP �
__classcell__r r r� r r s ) r= �
__future__r r r Zfuture.builtinsr r r Z future.utilsr r �__all__rq Zfuture.backports.emailr r
Z"future.backports.email._policybaser rr rf r~ ru r- rd rj �NLr# r r
r r r r r �<module> s0
Z PK �Du\�{�/�
�
< future/backports/email/__pycache__/base64mime.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ g d�Z dd l
m Z dd
l m
Z
mZ d Zd Zd
ZdZdd� Zddd�Zdefdd�Zdd� ZeZeZdS )a� Base64 content transfer encoding per RFCs 2045-2047.
This module handles the content transfer encoding method defined in RFC 2045
to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit
characters encoding known as Base64.
It is used in the MIME standards for email to attach images, audio, and text
using some 8-bit character sets to messages.
This module provides an interface to encode and decode both headers and bodies
with Base64 encoding.
RFC 2045 defines a method for including character set information in an
`encoded-word' in a header. This method is commonly used for 8-bit real names
in To:, From:, Cc:, etc. fields, as well as Subject: lines.
This module does not do the line wrapping or end-of-line character conversion
necessary for proper internationalized headers; it only does dumb encoding and
decoding. To deal with the various line wrapping issues, use the email.header
module.
� )�unicode_literals)�division)�absolute_import)�range)�bytes)�str)� body_decode� body_encode�decode� decodestring�
header_encode�
header_length)� b64encode)�
b2a_base64�
a2b_base64z
�
� � c C s* t t| �d�\}}|d }|r&|d7 }|S )z6Return the length of s when it is encoded with base64.� � )�divmod�len)� bytearray� groups_of_3�leftover�n� r �K/usr/local/lib/python3.9/site-packages/future/backports/email/base64mime.pyr
7 s
r
�
iso-8859-1c C s6 | sdS t | t�r | �|�} t| ��d�}d||f S )z�Encode a single header line with Base64 encoding in a given charset.
charset names the character set to use to encode the header. It defaults
to iso-8859-1. Base64 encoding is defined in RFC 2045.
r �asciiz =?%s?b?%s?=)�
isinstancer �encoder r
)� header_bytes�charset�encodedr r r r A s
r �L c C s~ | s| S g }|d d }t dt| �|�D ]J}t| ||| � ��d�}|�t�rh|tkrh|dd� | }|�|� q(t�|�S )a1 Encode a string with base64.
Each line will be wrapped at, at most, maxlinelen characters (defaults to
76 characters).
Each line of encoded text will end with eol, which defaults to "\n". Set
this to "\r\n" if you will be using the result of this function directly
in an email.
r r r r N���) r r r r
�endswith�NL�append� EMPTYSTRING�join)�s�
maxlinelen�eol�encvec�
max_unencoded�i�encr r r r O s
r c C s. | s
t � S t| t�r"t| �d��S t| �S dS )z�Decode a raw base64 string, returning a bytes object.
This function does not parse a full MIME header value encoded with
base64 (like =?iso-8895-1?b?bmloISBuaWgh?=) -- please use the high
level email.header class for that functionality.
zraw-unicode-escapeN)r r r r r! )�stringr r r r
h s
r
N)r )�__doc__�
__future__r r r Zfuture.builtinsr r r �__all__�base64r �binasciir r �CRLFr( r* �MISC_LENr
r r r
r r r r r r �<module> s&
PK �Du\4t_N$ N$ < future/backports/email/__pycache__/quoprimime.cpython-39.pycnu �[��� a
��?h�* � @ s~ d Z ddlmZ ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z g d�Z ddl
Z
ddlZddlmZmZmZ d Zd
Zd Zed d
� e
d�D ��Ze�� Zede�d� e�d� �D ]Zee�ee< q�deed�< ed�D ]Zee�ee< q�dd� Z dd� Z dd� Z dd� Z d0d d �Z d d � Z!d d!� Z"d1d#d$�Z#G d%d&� d&ej$�Z%d'efd(d)�Z&efd*d+�Z'e'Z(e'Z)d,d-� Z*d.d/� Z+dS )2aF Quoted-printable content transfer encoding per RFCs 2045-2047.
This module handles the content transfer encoding method defined in RFC 2045
to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to
safely encode text that is in a character set similar to the 7-bit US ASCII
character set, but that includes some 8-bit characters that are normally not
allowed in email bodies or headers.
Quoted-printable is very space-inefficient for encoding binary files; use the
email.base64mime module for that instead.
This module provides an interface to encode and decode both headers and bodies
with quoted-printable encoding.
RFC 2045 defines a method for including character set information in an
`encoded-word' in a header. This method is commonly used for 8-bit real names
in To:/From:/Cc: etc. fields, as well as Subject: lines.
This module does not do the line wrapping or end-of-line character
conversion necessary for proper internationalized headers; it only
does dumb encoding and decoding. To deal with the various line
wrapping issues, use the email.header module.
� )�unicode_literals)�division)�absolute_import)�bytes�chr�dict�int�range�super)
� body_decode� body_encode� body_length�decode� decodestring�
header_decode�
header_encode�
header_length�quote�unquoteN)�
ascii_letters�digits� hexdigits�
�
� c c s | ]}|d | fV qdS )�=%02XN� )�.0�cr r �K/usr/local/lib/python3.9/site-packages/future/backports/email/quoprimime.py� <genexpr>< � r � s -!*+/�ascii�_� s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ c C s t | �t| kS )z>Return True if the octet should be escaped with header quopri.)r �_QUOPRI_HEADER_MAP��octetr r r � header_checkN s r) c C s t | �t| kS )z<Return True if the octet should be escaped with body quopri.)r �_QUOPRI_BODY_MAPr' r r r �
body_checkS s r+ c C s t dd� | D ��S )a: Return a header quoted-printable encoding length.
Note that this does not include any RFC 2047 chrome added by
`header_encode()`.
:param bytearray: An array of bytes (a.k.a. octets).
:return: The length in bytes of the byte array when it is encoded with
quoted-printable for headers.
c s s | ]}t t| �V qd S �N)�lenr& �r r( r r r r b r! z header_length.<locals>.<genexpr>��sum�� bytearrayr r r r X s
r c C s t dd� | D ��S )z�Return a body quoted-printable encoding length.
:param bytearray: An array of bytes (a.k.a. octets).
:return: The length in bytes of the byte array when it is encoded with
quoted-printable for bodies.
c s s | ]}t t| �V qd S r, )r- r* r. r r r r l r! z body_length.<locals>.<genexpr>r/ r1 r r r r
e s r
c C sf t |t�st|�}| s&| �|�� � n<t| d �t|� |krT| d || 7 < n| �|�� � d S )N���)�
isinstance�strr �append�lstripr- )�L�s�maxlen�extrar r r � _max_appendo s
r< c C s t t| dd� d��S )zDTurn a string in the form =AB to the ASCII character with value 0xab� � � )r r �r9 r r r r z s r c C s dt | � S )Nr )�ord)r r r r r s r �
iso-8859-1c C s6 | sdS g }| D ]}|� t| � qd|t�|�f S )a� Encode a single header line with quoted-printable (like) encoding.
Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but
used specifically for email header fields to allow charsets with mostly 7
bit characters (and some 8 bit) to remain more or less readable in non-RFC
2045 aware mail clients.
charset names the character set to use in the RFC 2046 header. It
defaults to iso-8859-1.
r z =?%s?q?%s?=)r6 r& � EMPTYSTRING�join)� header_bytes�charset�encodedr( r r r r � s r c sF e Zd Z� fdd�Zdd� Zdd� Zdd� Zdd
d �Zd d
� Z� Z S )�_body_accumulatorc s( t � j|i |�� || _| | _| _d S r, )r
�__init__�eol�
maxlinelen�room)�selfrK rJ �args�kw�� __class__r r rI � s z_body_accumulator.__init__c C s | � |� | jt|�8 _dS )z%Add string s to the accumulated body.N)�writerL r- )rM r9 r r r � write_str� s
z_body_accumulator.write_strc C s | � | j� | j| _dS )z Write eol, then start new line.N)rS rJ rK rL �rM r r r �newline� s z_body_accumulator.newlinec C s | � d� | �� dS )z*Write a soft break, then start a new line.�=N)rS rU rT r r r �write_soft_break� s
z"_body_accumulator.write_soft_breakr c C s( | j t|�| k r| �� | �|� dS )z.Add a soft line break if needed, then write s.N)rL r- rW rS )rM r9 �
extra_roomr r r �
write_wrapped� s z _body_accumulator.write_wrappedc C sz |s| j |dd� nb|dvr(| � |� nN| jdkrB| �t|�� n4| jdkr`| �|� | �� n| �� | �t|�� d S )Nr= )rX z r> � )rY rL rR r rW )rM r Z is_last_charr r r �
write_char� s
z _body_accumulator.write_char)r )
�__name__�
__module__� __qualname__rI rS rU rW rY r[ �
__classcell__r r rP r rH � s
rH �L c C s� |dk rt d��| s| S | d dv }t||�}| �� }t|�d }t|�D ]^\}}t|�d } t|�D ],\}
} tt| ��r�t| �} |�| |
| k� qf||k s�|rJ|� � qJ|�
� S )a� Encode with quoted-printable, wrapping at maxlinelen characters.
Each line of encoded text will end with eol, which defaults to "\n". Set
this to "\r\n" if you will be using the result of this function directly
in an email.
Each line will be wrapped at, at most, maxlinelen characters before the
eol string (maxlinelen defaults to 76 characters, the maximum value
permitted by RFC 2045). Long lines will have the 'soft line break'
quoted-printable character "=" appended to them, so the decoded text will
be identical to the original text.
The minimum maxlinelen is 4 to have room for a quoted character ("=XX")
followed by a soft line break. Smaller values will generate a
ValueError.
� z maxlinelen must be at least 4r3 r r= ) �
ValueErrorrH �
splitlinesr- � enumerater+ rA r r[ rU �getvalue) �bodyrK rJ Z last_has_eol� encoded_body�linesZ last_line_noZline_no�lineZlast_char_index�ir r r r r � s"
r c C s | s| S d}| � � D ]�}|�� }|s.||7 }qd}t|�}||k r|| }|dkrd||7 }|d7 }nv|d |kr||d7 }q:n^|d |k r�||d tv r�||d tv r�|t|||d � �7 }|d7 }n||7 }|d7 }||kr:||7 }q:q| d dv�r|�|��r|d d� }|S )
z_Decode a quoted-printable string.
Lines are separated with eol, which defaults to \n.
r r rV r= rZ r> r3 r N)rc �rstripr- r r �endswith)rG rJ �decodedri rj �nr r r r r s8
,
r c C s | � d�}t|�S )zCTurn a match in the form =AB to the ASCII character with value 0xabr )�groupr )�matchr9 r r r �_unquote_match7 s
rq c C s | � dd�} t�dt| tj�S )a Decode a string encoded with RFC 2045 MIME header `Q' encoding.
This function does not parse a full MIME header value encoded with
quoted-printable (like =?iso-8895-1?q?Hello_World?=) -- please use
the high level email.header class for that functionality.
r$ r% z=[a-fA-F0-9]{2})�replace�re�subrq �ASCIIr@ r r r r > s r )r )rB ),�__doc__�
__future__r r r Zfuture.builtinsr r r r r r
�__all__rs �io�stringr r r �CRLF�NLrC r& �copyr* �encoder rA r) r+ r r
r< r r r �StringIOrH r r r r rq r r r r r �<module> sB
61 0PK �Du\����- �- ; future/backports/email/__pycache__/generator.cpython-39.pycnu �[��� a
��?h@L � @ s6 d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ g d�Z dd l
Z
dd l Z dd l Z dd l
Z
dd lZdd
lmZmZ dd lmZ dd lmZ dd
lmZ dd lm m mZ dZ dZ e
� de
j �Z!G dd� de"�Z#G dd� de#�Z$dZ%G dd� de#�Z&e'e(e j)d ��Z*de* Z+e#j,Z,d S )z:Classes to generate plain text from a message object tree.� )�print_function)�unicode_literals)�division)�absolute_import)�super)�str)� Generator�DecodedGenerator�BytesGeneratorN)�StringIO�BytesIO)�compat32)�Header)�_has_surrogates�_�
z^From c @ s� e Zd ZdZd(dd�Zdd� Zd)d d
�Zd d � Zd
Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� ZeZd d � Zd d � Zd d!� Zd"d#� Zed*d$d%��Zed&d'� �ZdS )+r z�Generates output from a Message object tree.
This basic generator writes the message to the given file object as plain
text.
TNc K s8 d|v r|d }|d= nd }|| _ || _|| _|| _d S )N�policy)�_fp�
_mangle_from_� maxheaderlenr )�self�outfp� mangle_from_r Z _3to2kwargsr � r �J/usr/local/lib/python3.9/site-packages/future/backports/email/generator.py�__init__+ s zGenerator.__init__c C s | j �|� d S �N)r �write�r �sr r r r H s zGenerator.writeFc C s� | j du r|j n| j }|dur*|j|d�}| jdurB|j| jd�}|j| _| �| j�| _d| _| �d�| _| j }|j }zX|| _ ||_ |r�|� � }|s�dt
� t
�
� � }| � || j � | �
|� W || _ ||_ n|| _ ||_ 0 dS )az Print the message object tree rooted at msg to the output file
specified when the Generator instance was created.
unixfrom is a flag that forces the printing of a Unix From_ delimiter
before the first object in the message tree. If the original message
has no From_ delimiter, a `standard' one is crafted. By default, this
is False to inhibit the printing of any From_ delimiter.
Note that for subobjects, no From_ line is printed.
linesep specifies the characters used to indicate a new line in
the output. The default value is determined by the policy.
N)�linesep��max_line_length� z From nobody )r �cloner r �_NL�_encode� _encoded_NLZ_EMPTYZ_encoded_EMTPY� get_unixfrom�time�ctimer �_write)r �msg�unixfromr r Zold_gen_policyZold_msg_policyZufromr r r �flattenL s0
�zGenerator.flattenc C s | j || jd| jd�S )z1Clone this generator with the exact same options.N)r )� __class__r r )r �fpr r r r$ { s
�zGenerator.cloner# c C s t � S r )r �r r r r � _new_buffer� s zGenerator._new_bufferc C s |S r r r r r r r& � s zGenerator._encodec C s| |sd S |� d�}|d d� D ] }| �|�d�� | �| j� q |d �d�}| �|� t|d �t|�krx| �| j� d S )NT���z
)�
splitlinesr �rstripr% �len)r �lines�lineZ laststrippedr r r � _write_lines� s
zGenerator._write_linesc C sn | j }z"| �� | _ }| �|� W || _ n|| _ 0 t|dd �}|d u rR| �|� n|| � | j �|�� � d S )N�_write_headers)r r2 � _dispatch�getattrr: r �getvalue)r r, ZoldfpZsfp�methr r r r+ � s zGenerator._writec C st |� � }|�� }t�||f��dd�}t| d| d �}|d u rh|�dd�}t| d| d �}|d u rh| j}||� d S )N�-r Z_handle_)�get_content_maintype�get_content_subtype�
UNDERSCORE�join�replacer< �
_writeBody)r r, �main�subZspecificr> Zgenericr r r r; � s zGenerator._dispatchc C s6 |� � D ] \}}| �| j�||�� q| �| j� d S r )� raw_itemsr r �foldr% �r r, �h�vr r r r: � s zGenerator._write_headersc C s� |� � }|d u rd S t|t�s.tdt|� ��t|j�rd|�d�}|d urd|d= |�||� |� � }| j rvt
� d|�}| � |� d S )Nzstring payload expected: %s�charsetzcontent-transfer-encoding�>From )
� get_payload�
isinstancer � TypeError�typer �_payload� get_param� set_payloadr �fcrerG r9 )r r, �payloadrM r r r � _handle_text� s
zGenerator._handle_textc C s� g }|� � }|d u rg }n(t|t�r2| �|� d S t|t�sB|g}|D ]6}| �� }| �|�}|j|d| jd� |� |�
� � qF|� � }|s�| j �
|�}| �|�}|�|� |jd ur�| jr�t�d|j�} n|j} | �| � | �| j� | �d| | j � |�r| j�|�d�� |D ],}
| �| jd | | j � | j�|
� �q| �| jd | d � |jd u�r�| �| j� | j�r�t�d|j�} n|j} | �| � d S )NF�r- r rN z--r )rO rP r r �listr2 r$ r. r% �appendr= � get_boundaryr' rC �_make_boundary� set_boundary�preambler rV rG r9 r �pop�epilogue) r r, Zmsgtexts�subparts�partr �g�boundaryZalltextr_ Z body_partra r r r �_handle_multipart� sL
zGenerator._handle_multipartc C s6 | j }|jdd�| _ z| �|� W || _ n|| _ 0 d S )Nr r! )r r$ rf )r r, �pr r r �_handle_multipart_signed/ s
z"Generator._handle_multipart_signedc C s� g }|� � D ]t}| �� }| �|�}|j|d| jd� |�� }|�| j�}|rv|d | jkrv|� | j�
|d d� �� q |� |� q | j � | j�
|�� d S )NFrY r3 )
rO r2 r$ r. r% r= �splitr' �_encoded_EMPTYr[ rC r r )r r, �blocksrc r rd �textr7 r r r � _handle_message_delivery_status: s
z)Generator._handle_message_delivery_statusc C s^ | � � }| �|�}|j}t|t�rD|j|�d�d| jd� |�� }n
| � |�}| j
� |� d S )Nr FrY ) r2 r$ rS rP rZ r. rO r% r= r& r r )r r, r rd rW r r r �_handle_messageO s
zGenerator._handle_messagec C sv t �tj�}dt| d }|d u r(|S |}d}| �dt�|� d tj�}|� |�sXqr|d t
|� }|d7 }q0|S )Nz===============z==r z^--z(--)?$�.� ) �random� randrange�sys�maxsize�_fmt� _compile_re�re�escape� MULTILINE�searchr )�clsrl �tokenre �b�counterZcrer r r r] h s
zGenerator._make_boundaryc C s t �||�S r )rw �compile�r{ r �flagsr r r rv z s zGenerator._compile_re)TN)FN)N)�__name__�
__module__� __qualname__�__doc__r r r. r$ rj r2 r& r9 r+ r; r: rX rE rf rh rm rn � classmethodr] rv r r r r r ! s,
/
; r c sT e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Z� fd d �Z e Z
e d
d� �Z � Z
S )r
a� Generates a bytes version of a Message object tree.
Functionally identical to the base Generator except that the output is
bytes and not string. When surrogates were used in the input to encode
bytes, these are decoded back to bytes for output. If the policy has
cte_type set to 7bit, then the message is transformed such that the
non-ASCII bytes are properly content transfer encoded, using the charset
unknown-8bit.
The outfp object must accept bytes in its write method.
� c C s | j �t|��dd�� d S )N�ascii�surrogateescape)r r r �encoder r r r r � s zBytesGenerator.writec C s t � S r )r r1 r r r r2 � s zBytesGenerator._new_bufferc C s
|� d�S �Nr� )r� r r r r r& � s zBytesGenerator._encodec C s8 |� � D ] \}}| j�| j�||�� q| �| j� d S r )rH r r r � fold_binaryr% rJ r r r r: � s z BytesGenerator._write_headersc s\ |j d u rd S t|j �rH| jjdksH| jr:t�d|j �|_ | �|j � ntt | ��
|� d S )N�7bitrN ) rS r r �cte_typer rV rG r9 r r
rX )r r, �r/ r r rX � s
zBytesGenerator._handle_textc C s t �|�d�|�S r� )rw r r� r� r r r rv � s zBytesGenerator._compile_re)r� r� r� r� rj r r2 r& r: rX rE r� rv �
__classcell__r r r� r r
~ s
r
zD[Non-text (%(type)s) part of message omitted, filename %(filename)s]c @ s" e Zd ZdZd dd�Zdd� ZdS )
r z�Generates a text representation of a message.
Like the Generator base class, except that non-text parts are substituted
with a format string representing the part.
T�N Nc C s* t �| |||� |du r t| _n|| _dS )a� Like Generator.__init__() except that an additional optional
argument is allowed.
Walks through all subparts of a message. If the subpart is of main
type `text', then it prints the decoded payload of the subpart.
Otherwise, fmt is a format string that is used instead of the message
payload. fmt is expanded with the following keywords (in
%(keyword)s format):
type : Full MIME type of the non-text part
maintype : Main MIME type of the non-text part
subtype : Sub-MIME type of the non-text part
filename : Filename of the non-text part
description: Description associated with the non-text part
encoding : Content transfer encoding of the non-text part
The default value for fmt is None, meaning
[Non-text (%(type)s) part of message omitted, filename %(filename)s]
N)r r �_FMTru )r r r r �fmtr r r r � s zDecodedGenerator.__init__c C s� |� � D ]v}|�� }|dkr2t|jdd�| d� q|dkr<qt| j|�� |�� |�� |�d�|�dd�|�d d
�d � | d� qd S ) Nrl F)�decode)�file� multipartz
[no filename]zContent-Descriptionz[no description]zContent-Transfer-Encodingz
[no encoding])rR �maintype�subtype�filename� description�encoding) �walkr@ �printrO ru �get_content_typerA � get_filename�get)r r, rc r� r r r r; � s( ��� �zDecodedGenerator._dispatch)Tr� N)r� r� r� r� r r; r r r r r � s
r rp z%%0%dd)-r� �
__future__r r r r Zfuture.builtinsr r �__all__rw rs r) rq �warnings�ior r Z"future.backports.email._policybaser
Z future.backports.email.headerr Z future.backports.email.utilsr Z future.backports.email.charsetZ backports�emailrM �_charsetrB �NLr ry rV �objectr r
r� r r6 �reprrt �_widthru r] r r r r �<module> s: _68PK �Du\��g��o �o 9 future/backports/email/__pycache__/message.cpython-39.pycnu �[��� a
��?h�� � @ s� d Z ddlmZmZmZ ddlmZmZmZm Z dgZ
ddl Z ddl Z ddl
Z
ddlZddlmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lm Z ej Z d
Z e � d�Z dd� Z!ddd�Z"dd� Z#dd� Z$G dd� de%�Z&dS )z8Basic message object for the email package object model.� )�absolute_import�division�unicode_literals)�list�range�str�zip�MessageN)�BytesIO�StringIO)�
as_native_str)�utils)�errors)�compat32��charset)�decode_bz; z[ \(\)<>@,;:\\"/\[\]\?=]c C s4 t | ��d�\}}}|s$|�� d fS |�� |�� fS )N�;)r � partition�strip)�param�a�sep�b� r �H/usr/local/lib/python3.9/site-packages/future/backports/email/message.py� _splitparam" s r Tc C s� |dur�t |�dkr�t|t�rL| d7 } t�|d |d |d �}d| |f S z|�d� W n4 ty� | d7 } t�|dd �}d| |f Y S 0 |s�t�|�r�d
| t� |�f S d| |f S n| S dS ) a~ Convenience function to format and return a key=value pair.
This will quote the value if needed or if quote is true. If value is a
three tuple (charset, language, value), it will be encoded according
to RFC2231 rules. If it contains non-ascii characters it will likewise
be encoded according to RFC2231 rules, using the utf-8 charset and
a null language.
Nr �*� � �%s=%s�ascii�utf-8� z%s="%s")
�len�
isinstance�tupler
�encode_rfc2231�encode�UnicodeEncodeError� tspecials�search�quote)r �valuer, r r r � _formatparam, s
r. c C s� dt | � } g }| d d� dkr�| dd � } | �d�}|dkrp| �dd|�| �dd|� d rp| �d|d �}q6|dk r�t| �}| d |� }d|v r�|�d�}|d |� �� �� d ||d d � �� }|�|�� � | |d � } q|S )Nr r r �"z\"r �=)r �find�countr$ �indexr �lower�append)�s�plist�end�f�ir r r � _parseparamN s
(
,r; c C s4 t | t�r&| d | d t�| d �fS t�| �S d S )Nr r r )r% r& r
�unquote)r- r r r �
_unquotevalueb s
r= c @ s� e Zd ZdZefdd�Zedd�dd� �Zd`d
d �Zd d
� Z dd� Z
dd� Z dd� Z dadd�Z
dbdd�Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zdcd/d0�Zd1d2� Zd3d4� Z ddd5d6�Z d7d8� Z d9d:� Z d;d<� Z d=d>� Z!d?d@� Z"dAdB� Z#dCdD� Z$dEdF� Z%dedIdJ�Z&dfdKdL�Z'dgdOdP�Z(dhdQdR�Z)didSdT�Z*djdUdV�Z+dkdWdX�Z,dYdZ� Z-dld[d\�Z.dmd]d^�Z/d d_l0m1Z1 dS )nr a� Basic message object.
A message object is defined as something that has a bunch of RFC 2822
headers and a payload. It may optionally have an envelope header
(a.k.a. Unix-From or From_ header). If the message is a container (i.e. a
multipart or a message/rfc822), then the payload is a list of Message
objects, otherwise it is a string.
Message objects implement part of the `mapping' interface, which assumes
there is exactly one occurrence of the header per message. Some headers
do in fact appear multiple times (e.g. Received) and for those headers,
you must use the explicit API to set or get all the headers. Not all of
the mapping methods are implemented.
c C s< || _ t� | _d | _d | _d | _d | _| _g | _d| _ d S )N�
text/plain)
�policyr �_headers� _unixfrom�_payload�_charset�preamble�epilogue�defects�
_default_type)�selfr? r r r �__init__| s zMessage.__init__r" )�encodingc C s | � � S )zwReturn the entire formatted message as a string.
This includes the headers, body, and envelope header.
)� as_string�rH r r r �__str__� s zMessage.__str__Fr c C s6 ddl m} t� }||d|d�}|j| |d� |�� S )aW Return the entire formatted message as a (unicode) string.
Optional `unixfrom' when True, means include the Unix From_ envelope
header.
This is a convenience method and may not generate the message exactly
as you intend. For more flexibility, use the flatten() method of a
Generator instance.
r )� GeneratorF)� mangle_from_� maxheaderlen)�unixfrom)Z future.backports.email.generatorrN r �flatten�getvalue)rH rQ rP rN �fp�gr r r rK � s
zMessage.as_stringc C s t | jt�S )z6Return True if the message consists of multiple parts.)r% rB r rL r r r � is_multipart� s zMessage.is_multipartc C s
|| _ d S �N�rA )rH rQ r r r � set_unixfrom� s zMessage.set_unixfromc C s | j S rW rX rL r r r � get_unixfrom� s zMessage.get_unixfromc C s$ | j du r|g| _ n | j �|� dS )z�Add the given payload to the current payload.
The current payload will always be a list of objects after this method
is called. If you want to set the payload to a scalar object, use
set_payload() instead.
N)rB r5 )rH �payloadr r r �attach� s
zMessage.attachNc C s� | � � r(|rdS |du r | jS | j| S |durNt| jt�sNtdt| j� ��| j}t| �dd���� }t|t��rt|�}t �
|�r�|� dd�}|s�z|� | �
dd�d�}W n ty� |� dd�}Y n0 n4|�rz|� d�}W n t�y |� d �}Y n0 |�s|S |d
k�r"t �|�S |d k�r`td �|�� ��\}}|D ]}| j�| |� �qF|S |d
v �r�t|�} t� }
ztj | |
dd� |
�� W S tj�y� | Y S 0 t|t��r�|S |S )aZ Return a reference to the payload.
The payload will either be a list object or a string. If you mutate
the list object, you modify the message's payload in place. Optional
i returns that index into the payload.
Optional decode is a flag indicating whether the payload should be
decoded or not, according to the Content-Transfer-Encoding header
(default is False).
When True and the message is not a multipart, the payload will be
decoded if this header's value is `quoted-printable' or `base64'. If
some other encoding is used, or the header is missing, or if the
payload has bogus data (i.e. bogus base64 or uuencoded data), the
payload is returned as-is.
If the message is a multipart and the decode flag is True, then None
is returned.
NzExpected list, got %szcontent-transfer-encodingr# r! �surrogateescaper �replace�raw-unicode-escapezquoted-printable�base64� )z
x-uuencode�uuencode�uuezx-uueT)�quiet)rV rB r% r � TypeError�typer �getr4 r
�_has_surrogatesr( �decode� get_param� LookupError� UnicodeErrorZ_qdecoder �join�
splitlinesr? �
handle_defectr
�uurS �Error) rH r: ri r[ �cte�bpayloadr- rF �defect�in_file�out_filer r r � get_payload� sX "
zMessage.get_payloadc C s || _ |dur| �|� dS )z�Set the payload to the given value.
Optional charset sets the message's default character set. See
set_charset() for details.
N)rB � set_charset)rH r[ r r r r � set_payload s zMessage.set_payloadc C s� |du r | � d� d| _dS t|t�s.t|�}|| _d| vrH| �dd� d| vrf| jdd|�� d� n| �d|�� � ||�� kr�|�| j�| _d| vr�|� � }z || � W n, t
y� |�| j�| _| �d|� Y n0 dS ) a� Set the charset of the payload to a given character set.
charset can be a Charset instance, a string naming a character set, or
None. If it is a string it will be converted to a Charset instance.
If charset is None, the charset parameter will be removed from the
Content-Type field. Anything else will generate a TypeError.
The message will be assumed to be of type text/* encoded with
charset.input_charset. It will be converted to charset.output_charset
and encoded properly, if needed, when generating the plain text
representation of the message. MIME headers (MIME-Version,
Content-Type, Content-Transfer-Encoding) will be added as needed.
Nr � MIME-Version�1.0� Content-Typer> r zContent-Transfer-Encoding) � del_paramrC r% �Charset�
add_header�get_output_charset� set_param� body_encoderB �get_body_encodingre )rH r rr r r r rx s.
� zMessage.set_charsetc C s | j S )zKReturn the Charset instance associated with the message's payload.
)rC rL r r r � get_charsetE s zMessage.get_charsetc C s
t | j�S )z9Return the total number of headers, including duplicates.)r$ r@ rL r r r �__len__M s zMessage.__len__c C s
| � |�S )a- Get a header value.
Return None if the header is missing instead of raising an exception.
Note that if the header appeared multiple times, exactly which
occurrence gets returned is undefined. Use get_all() to get all
the values matching a header field name.
)rg �rH �namer r r � __getitem__Q s zMessage.__getitem__c C sr | j �|�}|rX|�� }d}| jD ]4\}}|�� |kr"|d7 }||kr"td�||���q"| j�| j �||�� dS )z�Set the value of a header.
Note: this does not overwrite an existing header with the same field
name. Use __delitem__() first to delete any existing headers.
r r z/There may be at most {} {} headers in a messageN)r? �header_max_countr4 r@ �
ValueError�formatr5 �header_store_parse)rH r� �val� max_count�lname�found�k�vr r r � __setitem__\ s �zMessage.__setitem__c C sB |� � }t� }| jD ]"\}}|� � |kr|�||f� q|| _dS )zwDelete all occurrences of a header, if present.
Does not raise an exception if the header is missing.
N)r4 r r@ r5 )rH r� �
newheadersr� r� r r r � __delitem__n s zMessage.__delitem__c C s |� � dd� | jD �v S )Nc S s g | ]\}}|� � �qS r )r4 ��.0r� r� r r r �
<listcomp>{ ra z(Message.__contains__.<locals>.<listcomp>)r4 r@ r� r r r � __contains__z s zMessage.__contains__c c s | j D ]\}}|V qd S rW �r@ )rH �fieldr- r r r �__iter__} s zMessage.__iter__c C s dd� | j D �S )a. Return a list of all the message's header field names.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
c S s g | ] \}}|�qS r r r� r r r r� � ra z Message.keys.<locals>.<listcomp>r� rL r r r �keys� s z Message.keysc s � fdd�� j D �S )a) Return a list of all the message's header values.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
c s g | ]\}}� j �||��qS r �r? �header_fetch_parser� rL r r r� � s �z"Message.values.<locals>.<listcomp>r� rL r rL r �values� s
�zMessage.valuesc s � fdd�� j D �S )a' Get all the message's header fields and values.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
c s" g | ]\}}|� j �||�f�qS r r� r� rL r r r� � s �z!Message.items.<locals>.<listcomp>r� rL r rL r �items� s
�z
Message.itemsc C s: |� � }| jD ]&\}}|� � |kr| j�||� S q|S )z~Get a header value.
Like __getitem__() but return failobj instead of None when the field
is missing.
)r4 r@ r? r� )rH r� �failobjr� r� r r r rg � s
z Message.getc C s | j �||f� dS )z�Store name and value in the model without modification.
This is an "internal" API, intended only for use by a parser.
N)r@ r5 )rH r� r- r r r �set_raw� s zMessage.set_rawc C s t | j�� �S )z�Return the (name, value) header pairs without modification.
This is an "internal" API, intended only for use by a generator.
)�iterr@ �copyrL r r r � raw_items� s zMessage.raw_itemsc C sH g }|� � }| jD ](\}}|� � |kr|�| j�||�� q|sD|S |S )aQ Return a list of all the values for the named field.
These will be sorted in the order they appeared in the original
message, and may contain duplicates. Any fields deleted and
re-inserted are always appended to the header list.
If no such fields exist, failobj is returned (defaults to None).
)r4 r@ r5 r? r� )rH r� r� r� r� r� r r r �get_all� s zMessage.get_allc K sp g }|� � D ]<\}}|du r0|�|�dd�� q |�t|�dd�|�� q |dur^|�d|� t�|�| |< dS )u� Extended header setting.
name is the header field to add. keyword arguments can be used to set
additional parameters for the header field, with underscores converted
to dashes. Normally the parameter will be added as key="value" unless
value is None, in which case only the key will be added. If a
parameter value contains non-ASCII characters it can be specified as a
three-tuple of (charset, language, value), in which case it will be
encoded according to RFC2231 rules. Otherwise it will be encoded using
the utf-8 charset and a language of ''.
Examples:
msg.add_header('content-disposition', 'attachment', filename='bud.gif')
msg.add_header('content-disposition', 'attachment',
filename=('utf-8', '', 'Fußballer.ppt'))
msg.add_header('content-disposition', 'attachment',
filename='Fußballer.ppt'))
N�_�-r )r� r5 r^ r. �insert� SEMISPACErm )rH �_name�_value�_params�partsr� r� r r r r � s zMessage.add_headerc C s\ |� � }ttt| j��| j�D ]0\}\}}|� � |kr | j�||�| j|< qXq t|��dS )z�Replace a header.
Replace the first matching header found in the message, retaining
header order and case. If no matching header was found, a KeyError is
raised.
N)r4 r r r$ r@ r? r� �KeyError)rH r� r� r: r� r� r r r �replace_header� s " zMessage.replace_headerc C sH t � }| �d|�}||u r"| �� S t|�d �� }|�d�dkrDdS |S )a0 Return the message's content type.
The returned string is coerced to lower case of the form
`maintype/subtype'. If there was no Content-Type header in the
message, the default type as given by get_default_type() will be
returned. Since according to RFC 2045, messages always have a default
type this will always return a value.
RFC 2045 defines a message's default type to be text/plain unless it
appears inside a multipart/digest container, in which case it would be
message/rfc822.
� content-typer �/r r> )�objectrg �get_default_typer r4 r2 )rH �missingr- �ctyper r r �get_content_type s
zMessage.get_content_typec C s | � � }|�d�d S )z�Return the message's main content type.
This is the `maintype' part of the string returned by
get_content_type().
r� r �r� �split�rH r� r r r �get_content_maintype s z Message.get_content_maintypec C s | � � }|�d�d S )z�Returns the message's sub-content type.
This is the `subtype' part of the string returned by
get_content_type().
r� r r� r� r r r �get_content_subtype( s zMessage.get_content_subtypec C s | j S )a Return the `default' content type.
Most messages have a default content type of text/plain, except for
messages that are subparts of multipart/digest containers. Such
subparts have a default content type of message/rfc822.
�rG rL r r r r� 1 s zMessage.get_default_typec C s
|| _ dS )z�Set the `default' content type.
ctype should be either "text/plain" or "message/rfc822", although this
is not enforced. The default content type is not stored in the
Content-Type header.
Nr� r� r r r �set_default_type: s zMessage.set_default_typec C s� t � }| �||�}||u r |S g }t|�D ]V}z$|�dd�\}}|�� }|�� }W n typ |�� }d}Y n0 |�||f� q*t�|�}|S )Nr0 r r# ) r� rg r; r� r r� r5 r
�
decode_params) rH r� �headerr� r- �params�pr� r� r r r �_get_params_preserveC s
z Message._get_params_preserver� Tc C s8 t � }| �||�}||u r |S |r0dd� |D �S |S dS )am Return the message's Content-Type parameters, as a list.
The elements of the returned list are 2-tuples of key/value pairs, as
split on the `=' sign. The left hand side of the `=' is the key,
while the right hand side is the value. If there is no `=' sign in
the parameter the value is the empty string. The value is as
described in the get_param() method.
Optional failobj is the object to return if there is no Content-Type
header. Optional header is the header to search instead of
Content-Type. If unquote is True, the value is unquoted.
c S s g | ]\}}|t |�f�qS r )r= r� r r r r� j ra z&Message.get_params.<locals>.<listcomp>N)r� r� )rH r� r� r< r� r� r r r �
get_paramsX s
zMessage.get_paramsc C sN || vr |S | � ||�D ]0\}}|�� |�� kr|r@t|� S | S q|S )a Return the parameter value if found in the Content-Type header.
Optional failobj is the object to return if there is no Content-Type
header, or the Content-Type header has no such parameter. Optional
header is the header to search instead of Content-Type.
Parameter keys are always compared case insensitively. The return
value can either be a string, or a 3-tuple if the parameter was RFC
2231 encoded. When it's a 3-tuple, the elements of the value are of
the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and
LANGUAGE can be None, in which case you should consider VALUE to be
encoded in the us-ascii charset. You can usually ignore LANGUAGE.
The parameter value (either the returned string, or the VALUE item in
the 3-tuple) is always unquoted, unless unquote is set to False.
If your application doesn't care whether the parameter was RFC 2231
encoded, it can turn the return value into a string as follows:
param = msg.get_param('foo')
param = email.utils.collapse_rfc2231_value(rawparam)
)r� r4 r= )rH r r� r� r< r� r� r r r rj n s
zMessage.get_paramr| r# c C s� t |t�s|r|||f}|| vr2|�� dkr2d}n
| �|�}| j||d�st|s\t|||�}q�t�|t|||�g�}nbd}| j||d�D ]N\}} d}
|�� |�� kr�t|||�}
n t|| |�}
|s�|
}q�t�||
g�}q�|| �|�kr�| |= || |< dS )a� Set a parameter in the Content-Type header.
If the parameter already exists in the header, its value will be
replaced with the new value.
If header is Content-Type and has not yet been defined for this
message, it will be set to "text/plain" and the new parameter and
value will be appended as per RFC 2045.
An alternate header can specified in the header argument, and all
parameters will be quoted as necessary unless requote is False.
If charset is specified, the parameter will be encoded according to RFC
2231. Optional language specifies the RFC 2231 language, defaulting
to the empty string. Both charset and language should be strings.
r� r> )r� r# �r� r< N) r% r& r4 rg rj r. r� rm r� ) rH r r- r� �requoter �languager� � old_param� old_value� append_paramr r r r� � s2
�� zMessage.set_paramc C s� || vr dS d}| j ||d�D ]@\}}|�� |�� kr |sHt|||�}q t�|t|||�g�}q || �|�kr|| |= || |< dS )a> Remove the given parameter completely from the Content-Type header.
The header will be re-written in place without the parameter or its
value. All values will be quoted as necessary unless requote is
False. Optional header specifies an alternative to the Content-Type
header.
Nr# r� )r� r4 r. r� rm rg )rH r r� r� � new_ctyper� r� r r r r} � s
�zMessage.del_paramc C s� |� d�dkst�|�� dkr,| d= d| d< || vr@|| |< dS | j||d�}| |= || |< |dd� D ]\}}| �||||� qhdS ) aK Set the main type and subtype for the Content-Type header.
type must be a string in the form "maintype/subtype", otherwise a
ValueError is raised.
This method replaces the Content-Type header, keeping all the
parameters in place. If requote is False, this leaves the existing
header's quoting as is. Otherwise, the parameters will be quoted (the
default).
An alternative header can be specified in the header argument. When
the Content-Type header is set, we'll always also add a MIME-Version
header.
r� r r� z mime-versionr{ rz Nr� )r2 r� r4 r� r� )rH rf r� r� r� r� r� r r r �set_type� s zMessage.set_typec C sD t � }| �d|d�}||u r*| �d|d�}||u r6|S t�|��� S )a@ Return the filename associated with the payload if present.
The filename is extracted from the Content-Disposition header's
`filename' parameter, and it is unquoted. If that header is missing
the `filename' parameter, this method falls back to looking for the
`name' parameter.
�filenamezcontent-dispositionr� r� )r� rj r
�collapse_rfc2231_valuer )rH r� r� r� r r r � get_filename� s zMessage.get_filenamec C s, t � }| �d|�}||u r |S t�|��� S )z�Return the boundary associated with the payload if present.
The boundary is extracted from the Content-Type header's `boundary'
parameter, and it is unquoted.
�boundary)r� rj r
r� �rstrip)rH r� r� r� r r r � get_boundary s
zMessage.get_boundaryc C s t � }| �|d�}||u r$t�d��t� }d}|D ]:\}}|�� dkr^|�dd| f� d}q2|�||f� q2|s�|�dd| f� t� }| jD ]|\} }
| �� dkr�t� } |D ].\} }
|
dkr�| �| � q�| �d| |
f � q�t� | �}
|�| j
� | |
�� q�|�| |
f� q�|| _d S )
a� Set the boundary parameter in Content-Type to 'boundary'.
This is subtly different than deleting the Content-Type header and
adding a new one with a new boundary parameter via add_header(). The
main difference is that using the set_boundary() method preserves the
order of the Content-Type header in the original message.
HeaderParseError is raised if the message has no Content-Type header.
r� z No Content-Type header foundFr� z"%s"Tr# r N) r� r� r �HeaderParseErrorr r4 r5 r@ r� rm r? r� )rH r� r� r� � newparams�foundp�pk�pvr� �hr� r� r� r� r r r � set_boundary s2
zMessage.set_boundaryc C s� t � }| �d|�}||u r |S t|t�rp|d p2d}z |d �d�}t||�}W n ttfyn |d }Y n0 z|�d� W n ty� | Y S 0 |�� S )z�Return the charset parameter of the Content-Type header.
The returned string is always coerced to lower case. If there is no
Content-Type header, or if that header has no charset parameter,
failobj is returned.
r r zus-asciir r_ ) r� rj r% r& r( r rk rl r4 )rH r� r� r �pcharset�as_bytesr r r �get_content_charsetA s
zMessage.get_content_charsetc s � fdd�| � � D �S )a� Return a list containing the charset(s) used in this message.
The returned list of items describes the Content-Type headers'
charset parameter for this message and all the subparts in its
payload.
Each item will either be a string (the value of the charset parameter
in the Content-Type header of that part) or the value of the
'failobj' parameter (defaults to None), if the part does not have a
main MIME type of "text", or the charset is not defined.
The list will contain one string for each part of the message, plus
one for the container message (i.e. self), so that a non-multipart
message will still return a list of length 1.
c s g | ]}|� � ��qS r )r� )r� �part�r� r r r� o ra z(Message.get_charsets.<locals>.<listcomp>��walk)rH r� r r� r � get_charsets_ s zMessage.get_charsetsr� )Fr )NF)N)N)N)Nr� T)Nr� T)r| TNr# )r� T)r| T)N)N)N)N)2�__name__�
__module__� __qualname__�__doc__r rI r rM rK rV rY rZ r\ rw ry rx r� r� r� r� r� r� r� r� r� r� rg r� r� r� r r� r� r� r� r� r� r� r� rj r� r} r� r� r� r� r� r� Z future.backports.email.iteratorsr� r r r r r m sb
[
&
�
" �
0
.
)NT)'r� �
__future__r r r Zfuture.builtinsr r r r �__all__�rerp r` �binascii�ior
r Z future.utilsr Zfuture.backports.emailr
r Z"future.backports.email._policybaser r rC Z%future.backports.email._encoded_wordsr r~ r� �compiler* r r. r; r= r� r r r r r �<module> s,
" PK �Du\�� �X. X. 9 future/backports/email/__pycache__/charset.cpython-39.pycnu �[��� a
��?h D � @ s� d dl mZ d dl mZ d dl mZ d dlmZ d dlmZ g d�Zd dlm Z d dl
m Z d d l m
Z
d d
lmZ d Zd Zd
ZdZdZdZdZeedfeedfeedfeedfeedfeedfeedfeedfeedfeedfeedfeedfdeedfeedfeddfeddfeddfeedfeedfd�Zddddddddddd d d d d d d d d d d!d"d#dd$�Zd%d&dd'�Zd2d(d)�Zd*d+� Zd,d-� Z d.d/� Z G d0d1� d1e �Z dS )3� )�unicode_literals)�division)�absolute_import)�str)�next)�Charset� add_alias� add_charset� add_codec)�partial)�email)�errors)�encode_7or8bit� � � � �us-asciiz unknown-8bit� N)NNN� iso-2022-jp�utf-8)�
iso-8859-1�
iso-8859-2�
iso-8859-3�
iso-8859-4�
iso-8859-9� iso-8859-10� iso-8859-13� iso-8859-14� iso-8859-15� iso-8859-16z windows-1252�visciir �big5�gb2312�euc-jp� shift_jisr zkoi8-rr r r r r r r r r r r zks_c_5601-1987r$ zeuc-kr)�latin_1zlatin-1�latin_2zlatin-2�latin_3zlatin-3�latin_4zlatin-4�latin_5zlatin-5�latin_6zlatin-6�latin_7zlatin-7�latin_8zlatin-8�latin_9zlatin-9�latin_10zlatin-10�cp949�euc_jp�euc_kr�ascii� eucgb2312_cn�big5_tw)r# r" r c C s" |t krtd��|||ft| < dS )a> Add character set properties to the global registry.
charset is the input character set, and must be the canonical name of a
character set.
Optional header_enc and body_enc is either Charset.QP for
quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for
the shortest of qp or base64 encoding, or None for no encoding. SHORTEST
is only valid for header_enc. It describes how message headers and
message bodies in the input charset are to be encoded. Default is no
encoding.
Optional output_charset is the character set that the output should be
in. Conversions will proceed from input charset, to Unicode, to the
output charset when the method Charset.convert() is called. The default
is to output in the same character set as the input.
Both input_charset and output_charset must have Unicode codec entries in
the module's charset-to-codec mapping; use add_codec(charset, codecname)
to add codecs the module does not know about. See the codecs module's
documentation for more information.
z!SHORTEST not allowed for body_encN)�SHORTEST�
ValueError�CHARSETS)�charset�
header_enc�body_enc�output_charset� r= �H/usr/local/lib/python3.9/site-packages/future/backports/email/charset.pyr n s r c C s |t | < dS )z�Add a character set alias.
alias is the alias name, e.g. latin-1
canonical is the character set's canonical name, e.g. iso-8859-1
N)�ALIASES)�alias� canonicalr= r= r> r � s r c C s |t | < dS )a$ Add a codec that map characters in the given charset to/from Unicode.
charset is the canonical name of a character set. codecname is the name
of a Python codec, as appropriate for the second argument to the unicode()
built-in, or to the encode() method of a Unicode string.
N)� CODEC_MAP)r9 � codecnamer= r= r> r
� s r
c C s* t | �} |tkr | �dd�S | �|�S d S )Nr3 �surrogateescape)r � UNKNOWN8BIT�encode)�string�codecr= r= r> �_encode� s rI c @ sh e Zd ZdZefdd�Zdd� ZeZdd� Zdd � Z d
d � Z
d d
� Z dd� Z dd� Z
dd� Zdd� ZdS )r a@ Map character sets to their email properties.
This class provides information about the requirements imposed on email
for a specific character set. It also provides convenience routines for
converting between character sets, given the availability of the
applicable codecs. Given a character set, it will do its best to provide
information on how to use that character set in an email in an
RFC-compliant way.
Certain character sets must be encoded with quoted-printable or base64
when used in email headers or bodies. Certain character sets must be
converted outright, and are not allowed in email. Instances of this
module expose the following information about a character set:
input_charset: The initial character set specified. Common aliases
are converted to their `official' email names (e.g. latin_1
is converted to iso-8859-1). Defaults to 7-bit us-ascii.
header_encoding: If the character set must be encoded before it can be
used in an email header, this attribute will be set to
Charset.QP (for quoted-printable), Charset.BASE64 (for
base64 encoding), or Charset.SHORTEST for the shortest of
QP or BASE64 encoding. Otherwise, it will be None.
body_encoding: Same as header_encoding, but describes the encoding for the
mail message's body, which indeed may be different than the
header encoding. Charset.SHORTEST is not allowed for
body_encoding.
output_charset: Some character sets must be converted before they can be
used in email headers or bodies. If the input_charset is
one of them, this attribute will contain the name of the
charset output will be converted to. Otherwise, it will
be None.
input_codec: The name of the Python codec used to convert the
input_charset to Unicode. If no conversion codec is
necessary, this attribute will be None.
output_codec: The name of the Python codec used to convert Unicode
to the output_charset. If no conversion codec is necessary,
this attribute will have the same value as the input_codec.
c C s� z$t |t�r|�d� n
t|d�}W n ty@ t�|��Y n0 |�� }t�||�| _ t
�| j t t d f�\}}}|s|| j }|| _
|| _t�||�| _t�| j | j �| _t�| j| j�| _d S )Nr3 )�
isinstancer rF � UnicodeErrorr
� CharsetError�lowerr? �get�
input_charsetr8 r6 �BASE64�header_encoding�
body_encodingr< rB � input_codec� output_codec)�selfrO �henc�benc�convr= r= r> �__init__� s,
�
��zCharset.__init__c C s
| j �� S �N)rO rM �rU r= r= r> �__str__� s zCharset.__str__c C s t | �t |��� kS rZ )r rM �rU �otherr= r= r> �__eq__� s zCharset.__eq__c C s | � |� S rZ )r_ r] r= r= r> �__ne__� s zCharset.__ne__c C s2 | j tksJ �| j tkr dS | j tkr*dS tS dS )aP Return the content-transfer-encoding used for body encoding.
This is either the string `quoted-printable' or `base64' depending on
the encoding used, or it is a function in which case you should call
the function with a single argument, the Message object being
encoded. The function should then set the Content-Transfer-Encoding
header itself to whatever is appropriate.
Returns "quoted-printable" if self.body_encoding is QP.
Returns "base64" if self.body_encoding is BASE64.
Returns conversion function otherwise.
zquoted-printable�base64N)rR r6 �QPrP r r[ r= r= r> �get_body_encoding� s
zCharset.get_body_encodingc C s | j p
| jS )z�Return the output character set.
This is self.output_charset if that is not None, otherwise it is
self.input_charset.
)r< rO r[ r= r= r> �get_output_charset s zCharset.get_output_charsetc C s6 | j pd}t||�}| �|�}|du r*|S |�||�S )a� Header-encode a string by converting it first to bytes.
The type of encoding (base64 or quoted-printable) will be based on
this charset's `header_encoding`.
:param string: A unicode string for the header. It must be possible
to encode this string to bytes using the character set's
output codec.
:return: The encoded string, with RFC 2047 chrome.
r N)rT rI � _get_encoder�
header_encode)rU rG rH � header_bytes�encoder_moduler= r= r> rf s
zCharset.header_encodec C s | j pd}t||�}| �|�}t|j|d�}| �� }t|�t }g } g }
t|�| } |D ]�} |
� | � t
� |
�}
|� t|
|��}|| krX|
�
� | s�|
s�| � d� n.| r�dnd}t
� |
�}t||�}| � ||�� | g}
t|�| } qXt
� |
�}t||�}| � ||�� | S )af Header-encode a string by converting it first to bytes.
This is similar to `header_encode()` except that the string is fit
into maximum line lengths as given by the argument.
:param string: A unicode string for the header. It must be possible
to encode this string to bytes using the character set's
output codec.
:param maxlengths: Maximum line length iterator. Each element
returned from this iterator will provide the next maximum line
length. This parameter is used as an argument to built-in next()
and should never be exhausted. The maximum line lengths should
not count the RFC 2047 chrome. These line lengths are only a
hint; the splitter does the best it can.
:return: Lines of encoded strings, each with RFC 2047 chrome.
r )r9 N� r )rT rI re r rf rd �len�RFC2047_CHROME_LENr �append� EMPTYSTRING�join�
header_length�pop)rU rG �
maxlengthsrH rg rh �encoderr9 �extra�lines� current_line�maxlen� character� this_line�length� separator� joined_liner= r= r> �header_encode_lines/ s6
zCharset.header_encode_linesc C s` | j tkrtjS | j tkr tjS | j tkrXtj�|�}tj�|�}||k rPtjS tjS nd S d S rZ )rQ rP r �
base64mimerb �
quoprimimer6 ro )rU rg �len64�lenqpr= r= r> re m s
zCharset._get_encoderc C s� |s|S | j tu r4t|t�r(|�| j�}tj�|�S | j t u rjt|t�rT|�| j�}|�
d�}tj �|�S t|t�r�|�| j��
d�}|S dS )av Body-encode a string by converting it first to bytes.
The type of encoding (base64 or quoted-printable) will be based on
self.body_encoding. If body_encoding is None, we assume the
output charset is a 7bit encoding, so re-encoding the decoded
string using the ascii codec produces the correct string version
of the content.
�latin1r3 N) rR rP rJ r rF r< r r} � body_encoderb �decoder~ )rU rG r= r= r> r� | s
zCharset.body_encodeN)�__name__�
__module__� __qualname__�__doc__�DEFAULT_CHARSETrY r\ �__repr__r_ r` rc rd rf r| re r� r= r= r= r> r � s + !>r )NNN) �
__future__r r r Zfuture.builtinsr r �__all__� functoolsr Zfuture.backportsr Zfuture.backports.emailr
Z future.backports.email.encodersr rb rP r6 rk r� rE rm r8 r? rB r r r
rI �objectr r= r= r= r> �<module> s� � � �
PK �Du\�H�rj j : future/backports/email/__pycache__/encoders.cpython-39.pycnu �[��� a
��?h�
� @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ g d�Zzddlm Z
W n e yj ddlm Z
Y n0 ddl
m Z d d
� Zd d � Zd
d� Zdd� Zdd� ZdS )z Encodings and related functions.� )�unicode_literals)�division)�absolute_import)�str)�encode_7or8bit�
encode_base64� encode_noop�
encode_quopri)� encodebytes)� encodestringc C s t | dd�}|�dd�S )NT)� quotetabs� z=20)�
_encodestring�replace)�s�enc� r �I/usr/local/lib/python3.9/site-packages/future/backports/email/encoders.py�_qencode s r c C s, | � � }tt|�d�}| �|� d| d< dS )zlEncode the message's payload in Base64.
Also, add an appropriate Content-Transfer-Encoding header.
�ascii�base64�Content-Transfer-EncodingN)� get_payloadr �_bencode� set_payload��msg�orig�encdatar r r r ! s
r c C s& | � � }t|�}| �|� d| d< dS )zvEncode the message's payload in quoted-printable.
Also, add an appropriate Content-Transfer-Encoding header.
zquoted-printabler N)r r r r r r r r , s
r c C s� | � � }|du r d| d< dS z$t|t�r4|�d� n
|�d� W nH ty� | �� }|o^|j}|r||�� � d�r|d| d< nd| d< Y n
0 d| d< t|t�s�| �
|�dd�� dS )z9Set the Content-Transfer-Encoding header to 7bit or 8bit.N�7bitr r z iso-2022-�8bit�surrogateescape) r �
isinstancer �encode�decode� UnicodeError� get_charset�output_charset�lower�
startswithr )r r �charsetZ output_csetr r r r 7 s"
r c C s( | � � }t|t�s$| �|�dd�� dS )z Do nothing.r r! N)r r" r r r$ )r r r r r r S s
r N)�__doc__�
__future__r r r Zfuture.builtinsr �__all__r r
r � ImportErrorr �quoprir r r r r r r r r r �<module> s PK �Du\��N�x( x( 7 future/backports/email/__pycache__/utils.cpython-39.pycnu �[��� a
��?h�7 � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZm Z m
Z
g d�Z ddl Z ddl
Z
ejrlde
_ddlZddlZddlZddlZdd lmZ dd
lmZmZ ddlZdd l m Z dd l mZ dd
l m Z ddl m!Z! ddl m"Z"m#Z#m$Z$ ddl%m&Z' ddl(m)Z)m*Z* ddl+m,Z, dZ-dZ.dZ/dZ0dZ1e
�2d�Z3e
�2d�Z4e
�2d�j5Z6dd� Z7d?d d �Z8d d � Z9e
�2d!e
j:e
j;B �Z<d"d#� Z=d@d%d&�Z>dAd'd(�Z?dBd)d*�Z@d+d,� ZAd-d.� ZBd/d0� Zd1d2� ZCdCd3d4�ZDe
�2d5e
j�ZEd6d7� ZFdDd:d;�ZGdEd=d>�ZHdS )FzMiscellaneous utilities.� )�unicode_literals)�division)�absolute_import)�utils)�bytes�int�str)�collapse_rfc2231_value�
decode_params�decode_rfc2231�encode_rfc2231�
formataddr�
formatdate�format_datetime� getaddresses�
make_msgid� mktime_tz� parseaddr� parsedate� parsedate_tz�parsedate_to_datetime�unquoteN)�datetime)�quoter )�StringIO)r )� AddressList)r )r r �
_parsedate_tz)� decodestring)�_bencode�_qencode)�Charsetz, � z
�'z[][\\()<>@,:;".]z[\\"]u' ([^�-�]|\A)[�-�]([^�-�]|\Z)c C s | � dd�}|�dd�S )N�ascii�surrogateescape�replace)�encode�decode)�string�original_bytes� r* �F/usr/local/lib/python3.9/site-packages/future/backports/email/utils.py� _sanitizeH s r, �utf-8c C s� | \}}|� d� |r�z|� d� W n: ty^ t|t�rDt|�}|�|�}d||f Y S 0 d}t�|�rrd}t� d|�}d||||f S |S )a� The inverse of parseaddr(), this takes a 2-tuple of the form
(realname, email_address) and returns the string value suitable
for an RFC 2822 From, To or Cc header.
If the first element of pair is false, then the second element is
returned unmodified.
Optional charset if given is the character set that is used to encode
realname in case realname is not ASCII safe. Can be an instance of str or
a Charset-like object which has a header_encode method. Default is
'utf-8'.
r# z%s <%s>r! �"z\\\g<0>z %s%s%s <%s>)
r& �UnicodeEncodeError�
isinstancer r �
header_encode�
specialsre�search� escapesre�sub)�pair�charset�name�address� encoded_name�quotesr* r* r+ r
P s
r
c C s t �| �}t|�}|jS )z7Return a list of (REALNAME, EMAIL) for each fieldvalue.)�
COMMASPACE�join� _AddressList� addresslist)� fieldvalues�all�ar* r* r+ r r s
r a_
=\? # literal =?
(?P<charset>[^?]*?) # non-greedy up to the next ? is the charset
\? # literal ?
(?P<encoding>[qb]) # either a "q" or a "b", case insensitive
\? # literal ?
(?P<atom>.*?) # non-greedy up to the next ?= is the atom
\?= # literal ?=
c C sH dg d�| d | d g d�| d d | d | d | d | d
|f S ) Nz"%s, %02d %s %04d %02d:%02d:%02d %s)�Mon�Tue�Wed�Thu�Fri�Sat�Sun� � ) �Jan�Feb�Mar�Apr�May�Jun�Jul�Aug�Sep�Oct�Nov�Dec� r � � � r* )� timetuple�zoner* r* r+ �_format_timetuple_and_zone� s
��r^ Fc C s� | du rt � � } |rrt �| �}t jr4|d r4t j}nt j}tt|�d�\}}|dkrZd}nd}d|||d f }nt �| �}|r�d }nd
}t||�S ) a� Returns a date string as specified by RFC 2822, e.g.:
Fri, 09 Nov 2001 01:08:47 -0000
Optional timeval if given is a floating point time value as accepted by
gmtime() and localtime(), otherwise the current time is used.
Optional localtime is a flag that when True, interprets timeval, and
returns a date relative to the local timezone instead of UTC, properly
taking daylight savings time into account.
Optional argument usegmt means that the timezone is written out as
an ascii string, not numeric one (so "GMT" instead of "+0000"). This
is needed for HTTP, and is only used when localtime==False.
N���i r �-�+z
%s%02d%02d�< �GMT�-0000) �time� localtime�daylight�altzone�timezone�divmod�abs�gmtimer^ ) �timevalrf �usegmt�now�offset�hours�minutes�signr] r* r* r+ r � s"
r c C sV | � � }|r2| jdu s$| jtjjkr,td��d}n| jdu rBd}n
| �d�}t||�S )a$ Turn a datetime into a date string as specified in RFC 2822.
If usegmt is True, dt must be an aware datetime with an offset of zero. In
this case 'GMT' will be rendered instead of the normal +0000 required by
RFC2822. This is to support HTTP headers involving date stamps.
Nz%usegmt option requires a UTC datetimerc rd z%z)r\ �tzinfor ri �utc�
ValueError�strftimer^ )�dtrn ro r] r* r* r+ r � s
r c C sh t � � }t �dt �|��}t�� }t�d�}| du r:d} nd| } |du rRt�� }d|||| |f }|S )an Returns a string suitable for RFC 2822 compliant Message-ID, e.g:
<20020201195627.33539.96671@nightshade.la.mastaler.com>
Optional idstring if given is a string used to strengthen the
uniqueness of the message id. Optional domain if given provides the
portion of the message id after the '@'. It defaults to the locally
defined hostname.
z %Y%m%d%H%M%Si�� Nr! �.z<%s.%s.%s%s@%s>) re rw rl �os�getpid�random� randrange�socket�getfqdn)�idstring�domainrm Zutcdate�pid�randint�msgidr* r* r+ r � s
r c C sj t t| ��}|d d� g|dd � \}}|d u rDtj|d d� � S tj|d d� dt�tj|d��i�S )Nr_ rJ rt ��seconds)�listr r ri � timedelta)�dataZ _3to2list�dtuple�tzr* r* r+ r � s �r c C s t | �j}|sdS |d S )N)r! r! r )r> r? )�addr�addrsr* r* r+ r � s
r c C s` t | �dkr\| �d�r<| �d�r<| dd� �dd��dd�S | �d�r\| �d�r\| dd� S | S ) z Remove quotes from a string.rX r. r_ z\\�\z\"�<�>)�len�
startswith�endswithr% )r r* r* r+ r � s r c C s& | � td�}t|�dkr"dd| fS |S )z#Decode string according to RFC 2231rK N)�split�TICKr� )�s�partsr* r* r+ r s
r c C s@ t | d|p dd�} |du r&|du r&| S |du r2d}d||| f S )z�Encode string according to RFC 2231.
If neither charset nor language is given, then s is returned as-is. If
charset is given but not language, the string is encoded using the empty
string for language.
r! r# )�safe�encodingNz%s'%s'%s)� url_quote)r� r7 �languager* r* r+ r s r z&^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c
C sh | dd� } g }i }| � d�\}}|�||f� | r�| � d�\}}|�d�rRd}nd}t|�}t�|�}|r�|�dd�\}}|dur�t|�}|�|g ��|||f� q0|�|dt |� f� q0|�rd|�
� D ]�\}}g }d} |� � |D ]*\}}
}|�rt |
d d
�}
d} |�|
� q�t t
�|��}| �rPt|�\} } }|�|| | d| ff� q�|�|d| f� q�|S ) zDecode parameters list according to RFC 2231.
params is a sequence of 2-tuples containing (param name, string value).
Nr �*TFr8 �numz"%s"zlatin-1)r� )�pop�appendr� r �rfc2231_continuation�match�groupr �
setdefaultr �items�sort� url_unquote� EMPTYSTRINGr= r )
�params�
new_params�rfc2231_paramsr8 �value�encoded�mor� �
continuations�extendedr� r7 r� r* r* r+ r
sD
r
r% �us-asciic C s` t | t�rt| �dkr t| �S | \}}}t|d�}zt|||�W S tyZ t|� Y S 0 d S )NrY zraw-unicode-escape)r0 �tupler� r r r � LookupError)r� �errors�fallback_charsetr7 r� �text�rawbytesr* r* r+ r U s
r r_ c C s | du r t j �t jj��� S | jdur.| �� S | �� dd� |f }t�|�}t� |�}z t j
|j d�}t �||j �}W n~ t
y� | t j t�|�dd� � }tjo�|jdk}|r�tjntj }|t j
|d�kr�t �|tj| �}n
t �|�}Y n0 | j|d�S )a� Return local time as an aware datetime object.
If called without arguments, return current time. Otherwise *dt*
argument should be a datetime instance, and it is converted to the
local time zone according to the system time zone database. If *dt* is
naive (that is, dt.tzinfo is None), it is assumed to be in local time.
In this case, a positive or zero value for *isdst* causes localtime to
presume initially that summer time (for example, Daylight Saving Time)
is or is not (respectively) in effect for the specified time. A
negative value for *isdst* causes the localtime() function to attempt
to divine whether summer time is in effect for the specified time.
Nr_ r� rJ r )rt )r ro ri ru �
astimezonert r\ re �mktimerf r� � tm_gmtoff�tm_zone�AttributeErrorrl rg �tm_isdstrh �tznamer% ) rx �isdst�tmr� �localtm�deltar� �dst�gmtoffr* r* r+ rf k s$
rf )r- )NFF)F)NN)NN)r% r� )Nr_ )I�__doc__�
__future__r r r �futurer Zfuture.builtinsr r r �__all__rz �re�PY2�ASCIIre �base64r| r~ Zfuture.backportsr Z future.backports.urllib.parser r� r r� �warnings�ior Z!future.backports.email._parseaddrr r> r r r r �quoprir Z_qdecodeZ future.backports.email.encodersr r Z future.backports.email.charsetr r< r� � UEMPTYSTRING�CRLFr� �compiler2 r4 r3 �_has_surrogatesr, r
r �VERBOSE�
IGNORECASE�ecrer^ r r r r r r r r� r
r rf r* r* r* r+ �<module> st
�
"
�
-
�8 �
PK �Du\�ɐ� � 8 future/backports/email/__pycache__/parser.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZ ddlmZ ddlmZ g d�ZddlZddlmZm Z ddl
m Z m Z dd l
mZ dd
lmZ G d d � d e�ZG d
d� de�ZG dd� de�ZG dd� de�ZdS )z-A parser of RFC 2822 and MIME email messages.� )�unicode_literals)�division)�absolute_import)�Parser� HeaderParser� BytesParser�BytesHeaderParserN)�StringIO�
TextIOWrapper)�
FeedParser�BytesFeedParser)�Message)�compat32c @ s, e Zd Zefdd�Zd dd�Zd
dd�ZdS ) r c K s, d|v r|d }|d= nt }|| _|| _dS )a� Parser of RFC 2822 and MIME email messages.
Creates an in-memory object tree representing the email message, which
can then be manipulated and turned over to a Generator to return the
textual representation of the message.
The string must be formatted as a block of RFC 2822 headers and header
continuation lines, optionally preceded by a `Unix-from' header. The
header block is terminated either by the end of the string or by a
blank line.
_class is the class to instantiate for new message objects when they
must be created. This class must have a constructor that can take
zero arguments. Default is Message.Message.
The policy keyword specifies a policy object that controls a number of
aspects of the parser's operation. The default policy maintains
backward compatibility.
�policyN)r �_classr )�selfr Z _3to2kwargsr � r �G/usr/local/lib/python3.9/site-packages/future/backports/email/parser.py�__init__ s zParser.__init__Fc C s@ t | j| jd�}|r |�� |�d�}|s,q8|�|� q |�� S )a\ Create a message structure from the data in a file.
Reads all the data from the file and returns the root of the message
structure. Optional headersonly is a flag specifying whether to stop
parsing after reading the headers or not. The default is False,
meaning it parses the entire contents of the file.
)r i )r r r �_set_headersonly�read�feed�close)r �fp� headersonly�
feedparser�datar r r �parse/ s
z Parser.parsec C s | j t|�|d�S )a- Create a message structure from a string.
Returns the root of the message structure. Optional headersonly is a
flag specifying whether to stop parsing after reading the headers or
not. The default is False, meaning it parses the entire contents of
the file.
�r )r r �r �textr r r r �parsestrA s zParser.parsestrN)F)F)�__name__�
__module__� __qualname__r
r r r! r r r r r s
r c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t �| |d�S �NT)r r �r r r r r r r N s zHeaderParser.parsec C s t �| |d�S r% )r r! r r r r r! Q s zHeaderParser.parsestrN)T)T)r" r# r$ r r! r r r r r M s
r c @ s( e Zd Zdd� Zd dd�Zd
dd�ZdS ) r c O s t |i |��| _dS )a� Parser of binary RFC 2822 and MIME email messages.
Creates an in-memory object tree representing the email message, which
can then be manipulated and turned over to a Generator to return the
textual representation of the message.
The input must be formatted as a block of RFC 2822 headers and header
continuation lines, optionally preceded by a `Unix-from' header. The
header block is terminated either by the end of the input or by a
blank line.
_class is the class to instantiate for new message objects when they
must be created. This class must have a constructor that can take
zero arguments. Default is Message.Message.
N)r �parser)r �args�kwr r r r W s zBytesParser.__init__Fc C sD t |ddd�}|� | j�||�W d � S 1 s60 Y dS )ac Create a message structure from the data in a binary file.
Reads all the data from the file and returns the root of the message
structure. Optional headersonly is a flag specifying whether to stop
parsing after reading the headers or not. The default is False,
meaning it parses the entire contents of the file.
�ascii�surrogateescape)�encoding�errorsN)r
r' r r& r r r r i s zBytesParser.parsec C s |j ddd�}| j�||�S )a2 Create a message structure from a byte string.
Returns the root of the message structure. Optional headersonly is a
flag specifying whether to stop parsing after reading the headers or
not. The default is False, meaning it parses the entire contents of
the file.
�ASCIIr+ )r- )�decoder' r! r r r r �
parsebytesv s zBytesParser.parsebytesN)F)F)r" r# r$ r r r0 r r r r r U s
r c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t j| |dd�S �NTr )r r r& r r r r � s zBytesHeaderParser.parsec C s t j| |dd�S r1 )r r0 r r r r r0 � s z BytesHeaderParser.parsebytesN)T)T)r" r# r$ r r0 r r r r r � s
r )�__doc__�
__future__r r r �__all__�warnings�ior r
Z!future.backports.email.feedparserr r Z future.backports.email.messager
Z"future.backports.email._policybaser �objectr r r r r r r r �<module> s 9-PK �Du\�m}^1 1 < future/backports/email/__pycache__/_parseaddr.cpython-39.pycnu �[��� a
��?h�C � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ g d�Zddl Z ddl
Z
d Z d
Z d Z
g d �Zg d
�Zddddddddddddddd�Zdd� Zdd� Zdd� Zdd � Zd d � ZG d d � d e�ZG d!d"� d"e�ZdS )#zcEmail address parsing code.
Lifted directly from rfc822.py. This should eventually be rewritten.
� )�unicode_literals)�print_function)�division)�absolute_import)�int)� mktime_tz� parsedate� parsedate_tz�quoteN� � z, )�jan�feb�mar�apr�may�jun�jul�aug�sep�oct�nov�dec�january�february�march�aprilr �june�july�august� september�october�november�december)�mon�tue�wed�thu�fri�sat�sunip���i���i ���i����iD���i��)�UT�UTC�GMT�Z�AST�ADT�EST�EDT�CST�CDT�MST�MDT�PST�PDTc C s, t | �}|sdS |d du r$d|d< t|�S )zQConvert a date string to a time tuple.
Accounts for military timezones.
N� r )�
_parsedate_tz�tuple)�data�res� r> �K/usr/local/lib/python3.9/site-packages/future/backports/email/_parseaddr.pyr 3 s r c
C s� | sdS | � � } | d �d�s.| d �� tv r6| d= n.| d �d�}|dkrd| d |d d� | d< t| �dkr�| d � d�}t|�dkr�|| dd� } t| �dkr�| d }|�d�}|d kr�|�d�}|dkr�|d|� ||d� g| dd�< n
| �d
� t| �d k �rdS | dd � } | \}}}}}|�� }|tv�rX||�� }}|tv�rXdS t� |�d }|d k�rx|d 8 }|d dk�r�|dd � }|�d
�}|dk�r�|| }}|d dk�r�|dd � }|d �
� �s�|| }}|d dk�r�|dd � }|� d
�}t|�dk�r"|\} }
d} n~t|�dk�r<|\} }
} ndt|�dk�r�d|d v �r�|d � d�}t|�dk�r�|\} }
d} nt|�dk�r�|\} }
} ndS z,t |�}t |�}t | �} t |
�}
t | �} W n t �y� Y dS 0 |dk �r
|dk�r|d7 }n|d7 }d} |�
� }|tv �r*t| } n<z t |�} W n t �yJ Y n0 | dk�rf|�d��rfd} | �r�| dk �r�d }
| } nd}
|
| d d | d d } |||| |
| ddd | g
S )a� Convert date to extended time tuple.
The last (additional) element is the time zone offset in seconds, except if
the timezone was specified as -0000. In that case the last element is
None. This indicates a UTC timestamp that explicitly declaims knowledge of
the source timezone, as opposed to a +0000 timestamp that indicates the
source timezone really was UTC.
Nr �,� � �-� �+���r � � �:� �0�.�d �D il i� i �< )�split�endswith�lower� _daynames�rfind�len�find�append� _monthnames�index�isdigitr �
ValueError�upper�
_timezones�
startswith)r< �i�stuff�s�dd�mm�yy�tm�tz�thh�tmm�tss�tzoffset�tzsignr> r> r? r: ? s�
"
r: c C s& t | �}t|t�r |dd� S |S dS )z&Convert a time string to a time tuple.Nr9 )r �
isinstancer; �r< �tr> r> r? r � s
r c C s< | d du r"t �| dd� d �S t�| �}|| d S dS )zETurn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.r9 N� )rF )�time�mktime�calendar�timegmrm r> r> r? r � s
r c C s | � dd�� dd�S )z�Prepare string to be used in a quoted string.
Turns backslash and double quote characters into quoted pairs. These
are the only characters that need to be quoted inside a quoted string.
Does not add the surrounding double quotes.
�\z\\�"z\")�replace)�strr> r> r? r
� s r
c @ s| e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
d dd�Z dd� Z dd� Z
dd� Zd dd�Zd d � ZdS ) �
AddrlistClassa Address parser class by Ben Escoto.
To understand what this class does, it helps to have a copy of RFC 2822 in
front of you.
Note: this class interface is deprecated and may be removed in the future.
Use email.utils.AddressList instead.
c C sZ d| _ d| _d| _d| _| j| j | _| j | j | j | _| j�dd�| _|| _g | _ dS )z�Initialize a new instance.
`field' is an unparsed address header field, containing
one or more addresses.
z ()<>@,:;."[]r z z
rL r N)
�specials�pos�LWS�CR�FWS�atomendsrv �
phraseends�field� commentlist��selfr� r> r> r? �__init__� s zAddrlistClass.__init__c C s� g }| j t| j�k r�| j| j | jd v r\| j| j dvrL|�| j| j � | j d7 _ q| j| j dkr�| j�| �� � qq�qt�|�S )z&Skip white space and extract comments.z
rA �() rz rU r� r{ rW r� �
getcomment� EMPTYSTRING�join)r� �wslistr> r> r? �gotonext� s zAddrlistClass.gotonextc C s: g }| j t| j�k r6| �� }|r*||7 }q|�d� q|S )zVParse all addresses.
Returns a list containing all of the addresses.
)r r )rz rU r� �
getaddressrW )r� �result�adr> r> r? � getaddrlist� s
zAddrlistClass.getaddrlistc C s� g | _ | �� | j}| j }| �� }| �� g }| jt| j�kr\|rXt�| j �|d fg}�n\| j| j dv r�|| _|| _ | �� }t�| j �|fg}�n"| j| j dk�r g }t| j�}| jd7 _| jt| j�k �r�| �� | j|k �r| j| j dk�r| jd7 _�q�|| � � }q�n�| j| j dk�rx| �
� }| j �rft�|�d d�| j � d |fg}nt�|�|fg}n@|�r�t�| j �|d fg}n"| j| j | j v �r�| jd7 _| �� | jt| j�k �r�| j| j d
k�r�| jd7 _|S ) zParse the next address.r z.@rI rA �;�<z (r �)r@ ) r� r� rz �
getphraselistrU r� �SPACEr� � getaddrspecr� � getrouteaddrry )r� �oldpos�oldcl�plist�
returnlist�addrspec�fieldlen� routeaddrr> r> r? r�
sX
���$zAddrlistClass.getaddressc C s� | j | j dkrdS d}| jd7 _| �� d}| jt| j �k r�|rT| �� d}n~| j | j dkrv| jd7 _q�n\| j | j dkr�| jd7 _d}n8| j | j d kr�| jd7 _n| �� }| jd7 _q�| �� q2|S )
z�Parse a route address (Return-path value).
This method just skips all the route stuff and returns the addrspec.
r� NFrA r �>�@TrI )r� rz r� rU � getdomainr� )r� � expectroute�adlistr> r> r? r� E s.
zAddrlistClass.getrouteaddrc C sF g }| � � | jt| j�k r�d}| j| j dkrf|rH|d �� sH|�� |�d� | jd7 _d}nd| j| j dkr�|�dt| �� � � n<| j| j | j v r�|r�|d �� s�|�� q�n|�| �
� � | � � }|r |r |�|� q | jt| j�k�s
| j| j dk�rt � |�S |�d� | jd7 _| � � t � |�| �
� S ) z Parse an RFC 2822 addr-spec.TrL rF rA Fru z"%s"r� )r� rz rU r� �strip�poprW r
�getquoter~ �getatomr� r� r� )r� �aslist� preserve_ws�wsr> r> r? r� e s4
$
zAddrlistClass.getaddrspecc C s� g }| j t| j�k r�| j| j | jv r6| j d7 _ q| j| j dkrX| j�| �� � q| j| j dkrx|�| �� � q| j| j dkr�| j d7 _ |�d� q| j| j | jv r�q�q|�| � � � qt
� |�S )z-Get the complete domain name from an address.rA r� �[rL ) rz rU r� r{ r� rW r� �getdomainliteralr~ r� r� r� )r� �sdlistr> r> r? r� � s zAddrlistClass.getdomainTc C s� | j | j |krdS dg}d}| jd7 _| jt| j �k r�|rX|�| j | j � d}np| j | j |v rz| jd7 _q�nN|r�| j | j dkr�|�| �� � q,n(| j | j dkr�d}n|�| j | j � | jd7 _q,t�|�S )a� Parse a header fragment delimited by special characters.
`beginchar' is the start character for the fragment.
If self is not looking at an instance of `beginchar' then
getdelimited returns the empty string.
`endchars' is a sequence of allowable end-delimiting characters.
Parsing stops when one of these is encountered.
If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed
within the parsed fragment.
r FrA r� rt T)r� rz rU rW r� r� r� )r� � beginchar�endchars�
allowcomments�slistr
r> r> r? � getdelimited� s(
zAddrlistClass.getdelimitedc C s | � ddd�S )z1Get a quote-delimited fragment from self's field.ru z"
F�r� �r� r> r> r? r� � s zAddrlistClass.getquotec C s | � ddd�S )z7Get a parenthesis-delimited fragment from self's field.r� z)
Tr� r� r> r> r? r� � s zAddrlistClass.getcommentc C s d| � ddd� S )z!Parse an RFC 2822 domain-literal.z[%s]r� z]
Fr� r� r> r> r? r� � s z AddrlistClass.getdomainliteralNc C sd dg}|du r| j }| jt| j�k rZ| j| j |v r8qZn|�| j| j � | jd7 _qt�|�S )a Parse an RFC 2822 atom.
Optional atomends specifies a different set of end token delimiters
(the default is to use self.atomends). This is used e.g. in
getphraselist() since phrase endings must not include the `.' (which
is legal in phrases).r NrA )r~ rz rU r� rW r� r� )r� r~ �atomlistr> r> r? r� � s zAddrlistClass.getatomc C s� g }| j t| j�k r�| j| j | jv r6| j d7 _ q| j| j dkrV|�| �� � q| j| j dkrx| j�| �� � q| j| j | jv r�q�q|�| � | j�� q|S )z�Parse a sequence of RFC 2822 phrases.
A phrase is a sequence of words, which are in turn either RFC 2822
atoms or quoted-strings. Phrases are canonicalized by squeezing all
runs of continuous whitespace into one space.
rA ru r� )
rz rU r� r} rW r� r� r� r r� )r� r� r> r> r? r� � s zAddrlistClass.getphraselist)T)N)�__name__�
__module__� __qualname__�__doc__r� r� r� r� r� r� r� r� r� r� r� r� r� r> r> r> r? rx � s ; !
%
rx c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dS )� AddressListz@An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s& t �| |� |r | �� | _ng | _d S �N)rx r� r� � addresslistr� r> r> r? r� � s zAddressList.__init__c C s
t | j�S r� )rU r� r� r> r> r? �__len__� s zAddressList.__len__c C s> t d �}| jd d � |_|jD ]}|| jvr |j�|� q |S r� �r� r� rW �r� �other�newaddr�xr> r> r? �__add__ s
zAddressList.__add__c C s& |j D ]}|| j vr| j �|� q| S r� )r� rW �r� r� r� r> r> r? �__iadd__
s
zAddressList.__iadd__c C s. t d �}| jD ]}||jvr|j�|� q|S r� r� r� r> r> r? �__sub__ s
zAddressList.__sub__c C s& |j D ]}|| j v r| j �|� q| S r� )r� �remover� r> r> r? �__isub__ s
zAddressList.__isub__c C s
| j | S r� )r� )r� rY r> r> r? � __getitem__ s zAddressList.__getitem__N) r� r� r� r� r� r� r� r� r� r� r� r> r> r> r? r� � s r� )r� �
__future__r r r r Zfuture.builtinsr �__all__rp rr r� r� �
COMMASPACErX rS r] r r: r r r
�objectrx r� r> r> r> r? �<module> s8 � u
&PK �Du\�n^r 8 future/backports/email/__pycache__/errors.cpython-39.pycnu �[��� a
��?h` � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ G dd� de�ZG dd � d e�Z G d
d � d e �Z
G d d
� d
e �Z G dd� dee �Z
G dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG d d � d e�ZG d d � d e�ZeZG d d!� d!e�ZG d"d#� d#e�ZG d$d%� d%e�ZG d&d'� d'e�ZG d(d)� d)e�Z G d*d+� d+e�Z G d,d-� d-e �Z G d.d/� d/e �Z G d0d1� d1e �Z G d2d3� d3e �Z!G d4d5� d5e �Z"d6S )7z email package exception classes.� )�unicode_literals)�division)�absolute_import)�superc @ s e Zd ZdZdS )� MessageErrorz+Base class for errors in the email package.N��__name__�
__module__� __qualname__�__doc__� r r �G/usr/local/lib/python3.9/site-packages/future/backports/email/errors.pyr s r c @ s e Zd ZdZdS )�MessageParseErrorz&Base class for message parsing errors.Nr r r r r
r s r c @ s e Zd ZdZdS )�HeaderParseErrorz Error while parsing headers.Nr r r r r
r s r c @ s e Zd ZdZdS )�
BoundaryErrorz#Couldn't find terminating boundary.Nr r r r r
r s r c @ s e Zd ZdZdS )�MultipartConversionErrorz(Conversion to a multipart is prohibited.Nr r r r r
r s r c @ s e Zd ZdZdS )� CharsetErrorz An illegal charset was given.Nr r r r r
r s r c s" e Zd ZdZd� fdd� Z� ZS )�
MessageDefectz Base class for a message defect.Nc s |d urt � �|� || _d S �N)r �__init__�line)�selfr �� __class__r r
r ( s zMessageDefect.__init__)N�r r r
r r �
__classcell__r r r r
r % s r c @ s e Zd ZdZdS )�NoBoundaryInMultipartDefectzBA message claimed to be a multipart but had no boundary parameter.Nr r r r r
r - s r c @ s e Zd ZdZdS )�StartBoundaryNotFoundDefectz+The claimed start boundary was never found.Nr r r r r
r 0 s r c @ s e Zd ZdZdS )�CloseBoundaryNotFoundDefectzEA start boundary was found, but not the corresponding close boundary.Nr r r r r
r 3 s r c @ s e Zd ZdZdS )�#FirstHeaderLineIsContinuationDefectz;A message had a continuation line as its first header line.Nr r r r r
r 6 s r c @ s e Zd ZdZdS )� MisplacedEnvelopeHeaderDefectz?A 'Unix-from' header was found in the middle of a header block.Nr r r r r
r 9 s r c @ s e Zd ZdZdS )� MissingHeaderBodySeparatorDefectzEFound line with no leading whitespace and no colon before blank line.Nr r r r r
r! < s r! c @ s e Zd ZdZdS )�!MultipartInvariantViolationDefectz?A message claimed to be a multipart but no subparts were found.Nr r r r r
r" A s r" c @ s e Zd ZdZdS )�-InvalidMultipartContentTransferEncodingDefectzEAn invalid content transfer encoding was set on the multipart itself.Nr r r r r
r# D s r# c @ s e Zd ZdZdS )�UndecodableBytesDefectz0Header contained bytes that could not be decodedNr r r r r
r$ G s r$ c @ s e Zd ZdZdS )�InvalidBase64PaddingDefectz/base64 encoded sequence had an incorrect lengthNr r r r r
r% J s r% c @ s e Zd ZdZdS )� InvalidBase64CharactersDefectz=base64 encoded sequence had characters not in base64 alphabetNr r r r r
r& M s r& c s e Zd ZdZ� fdd�Z� ZS )� HeaderDefectz Base class for a header defect.c s t � j|i |�� d S r )r r )r �args�kwr r r
r U s zHeaderDefect.__init__r r r r r
r' R s r' c @ s e Zd ZdZdS )�InvalidHeaderDefectz+Header is not valid, message gives details.Nr r r r r
r* X s r* c @ s e Zd ZdZdS )�HeaderMissingRequiredValuez(A header that must have a value had noneNr r r r r
r+ [ s r+ c s( e Zd ZdZ� fdd�Zdd� Z� ZS )�NonPrintableDefectz8ASCII characters outside the ascii-printable range foundc s t � �|� || _d S r )r r �non_printables)r r- r r r
r a s zNonPrintableDefect.__init__c C s d� | j�S )Nz6the following ASCII non-printables found in header: {})�formatr- )r r r r
�__str__e s �zNonPrintableDefect.__str__)r r r
r r r/ r r r r r
r, ^ s r, c @ s e Zd ZdZdS )�ObsoleteHeaderDefectz0Header uses syntax declared obsolete by RFC 5322Nr r r r r
r0 i s r0 c @ s e Zd ZdZdS )�NonASCIILocalPartDefectz(local_part contains non-ASCII charactersNr r r r r
r1 l s r1 N)#r �
__future__r r r Zfuture.builtinsr � Exceptionr r r r � TypeErrorr r �
ValueErrorr r r r r r r! �MalformedHeaderDefectr" r# r$ r% r& r' r* r+ r, r0 r1 r r r r
�<module> s: PK �Du\ �}�8 �8 F future/backports/email/__pycache__/_header_value_parser.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZm Z m
Z
m Z ddl Z ddl
mZmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ ed
�Zeed�B Zed�ZeeB Z e ed� Z eed� Z eed�B ed� Z e eB Z e ed�B Z!e!eB Z"e"ed� Z#dd� Z$G dd� de%�Z&G dd� de �Z'G dd � d e'�Z(G d d � d e'�Z)G d d � d e'�Z*G d!d"� d"e'�Z+G d#d$� d$e(�Z,G d%d&� d&e'�Z-G d'd(� d(e'�Z.G d)d*� d*e'�Z/G d+d,� d,e'�Z0G d-d.� d.e0�Z1G d/d0� d0e(�Z2G d1d2� d2e'�Z3G d3d4� d4e'�Z4G d5d6� d6e'�Z5G d7d8� d8e'�Z6G d9d:� d:e'�Z7G d;d<� d<e'�Z8G d=d>� d>e'�Z9G d?d@� d@e'�Z:G dAdB� dBe'�Z;G dCdD� dDe'�Z<G dEdF� dFe'�Z=G dGdH� dHe'�Z>G dIdJ� dJe'�Z?G dKdL� dLe'�Z@G dMdN� dNe'�ZAG dOdP� dPe*�ZBG dQdR� dRe'�ZCG dSdT� dTe'�ZDG dUdV� dVe'�ZEG dWdX� dXe'�ZFG dYdZ� dZeF�ZGG d[d\� d\e'�ZHG d]d^� d^e'�ZIG d_d`� d`e'�ZJG dadb� dbe'�ZKG dcdd� dde'�ZLG dedf� dfeL�ZMG dgdh� dheL�ZNG didj� dje'�ZOG dkdl� dle'�ZPG dmdn� dne'�ZQG dodp� dpe �ZRG dqdr� dreR�ZSG dsdt� dteR�ZTG dudv� dveS�ZUeTddw�ZVeTdxdy�ZWeTdzd{�ZXe �Yd|�Zd}�[e���j\Z]e �Yd~�Zd}�[e ��^dd���^d�d����j_Z`e �Yd��jaZbe �Yd~�Zd}�[e ��^dd���^d�d����j_Zce �Yd~�Zd}�[e"��^dd���^d�d����j_Zde �Yd~�Zd}�[e#��^dd���^d�d����j_Zed�d�� Zfd�d�� Zgd�d�� Zhd�d�� Zid�d�� Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsd�d�� Ztd�d�� Zud�d�� Zvd�d�� Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�� Z{d�d�� Z|d�d�� Z}d�d�� Z~d�d�� Zd�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�dÄ Z�d�dń Z�d�dDŽ Z�d�dɄ Z�d�d˄ Z�d�d̈́ Z�d�dτ Z�d�dф Z�d�dӄ Z�d�dՄ Z�d�dׄ Z�d�dل Z�d�dۄ Z�d�d݄ Z�d�d߄ Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�dS )�al Header value parser implementing various email-related RFC parsing rules.
The parsing methods defined in this module implement various email related
parsing rules. Principal among them is RFC 5322, which is the followon
to RFC 2822 and primarily a clarification of the former. It also implements
RFC 2047 encoded word decoding.
RFC 5322 goes to considerable trouble to maintain backward compatibility with
RFC 822 in the parse phase, while cleaning up the structure on the generation
phase. This parser supports correct RFC 5322 generation by tagging white space
as folding white space only when folding is allowed in the non-obsolete rule
sets. Actually, the parser is even more generous when accepting input than RFC
5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages.
Where possible deviations from the standard are annotated on the 'defects'
attribute of tokens that deviate.
The general structure of the parser follows RFC 5322, and uses its terminology
where there is a direct correspondence. Where the implementation requires a
somewhat different structure than that used by the formal grammar, new terms
that mimic the closest existing terms are used. Thus, it really helps to have
a copy of RFC 5322 handy when studying this code.
Input to the parser is a string that has already been unfolded according to
RFC 5322 rules. According to the RFC this unfolding is the very first step, and
this parser leaves the unfolding step to a higher level message parser, which
will have already detected the line breaks that need unfolding while
determining the beginning and end of each header.
The output of the parser is a TokenList object, which is a list subclass. A
TokenList is a recursive data structure. The terminal nodes of the structure
are Terminal objects, which are subclasses of str. These do not correspond
directly to terminal objects in the formal grammar, but are instead more
practical higher level combinations of true terminals.
All TokenList and Terminal objects have a 'value' attribute, which produces the
semantically meaningful value of that part of the parse subtree. The value of
all whitespace tokens (no matter how many sub-tokens they may contain) is a
single space, as per the RFC rules. This includes 'CFWS', which is herein
included in the general class of whitespace tokens. There is one exception to
the rule that whitespace tokens are collapsed into single spaces in values: in
the value of a 'bare-quoted-string' (a quoted-string with no leading or
trailing whitespace), any whitespace that appeared between the quotation marks
is preserved in the returned value. Note that in all Terminal strings quoted
pairs are turned into their unquoted values.
All TokenList and Terminal objects also have a string value, which attempts to
be a "canonical" representation of the RFC-compliant form of the substring that
produced the parsed subtree, including minimal use of quoted pair quoting.
Whitespace runs are not collapsed.
Comment tokens also have a 'content' attribute providing the string found
between the parens (including any nested comments) with whitespace preserved.
All TokenList and Terminal objects have a 'defects' attribute which is a
possibly empty list all of the defects found while creating the token. Defects
may appear on any token in the tree, and a composite list of all defects in the
subtree is available through the 'all_defects' attribute of any node. (For
Terminal notes x.defects == x.all_defects.)
Each object in a parse tree is called a 'token', and each has a 'token_type'
attribute that gives the name from the RFC 5322 grammar that it represents.
Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that
may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters.
It is returned in place of lists of (ctext/quoted-pair) and
(qtext/quoted-pair).
XXX: provide complete list of token types.
� )�print_function)�unicode_literals)�division)�absolute_import)�int�range�str�super�listN)�
namedtuple� OrderedDict)�unquote�unquote_to_bytes)�_encoded_words)�errors)�utilsz �(z
()<>@,:;.\"[]�.z."(z/?=z*'%�%c C s dt | ��dd��dd� d S )N�"�\�\\z\")r �replace��value� r �U/usr/local/lib/python3.9/site-packages/future/backports/email/_header_value_parser.py� quote_stringd s r c @ s> e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zdd d
�Zd S )�_Foldedc C s0 || _ || _d| _d | _d| _g | _t� | _d S )Nr T)�maxlen�policy�lastlen� stickyspace� firstline�doner
�current)�selfr r r r r �__init__m s z_Folded.__init__c C s2 | j �| j� | j �| jj� | j�� d| _d S �Nr )r$ �extendr% �appendr �linesep�clearr! �r& r r r �newlinev s
z_Folded.newlinec C s | j r| �� d S �N)r% r. r- r r r �finalize| s z_Folded.finalizec C s d� | j�S �N� )�joinr$ r- r r r �__str__� s z_Folded.__str__c C s | j �|� d S r/ )r% r* )r& �stokenr r r r* � s z_Folded.appendNc C s |d u rt |�}t|�}| jd u�r�t| j�}| j| | | jkr�| j�| j� | j|7 _| j�|� | j|7 _d | _d| _dS |jr�|� � }|d ur�| jt |�7 _|t|�7 }|�
| � dS |�rt|d | jk�rt| j| }d| k �r|k �r8n n2|| }| j�| jd |� � | j|d � | _|}| � � | j�| j� | j�|� || | _d | _d| _dS | j�s�| � � | j�| j� | j�|� d | _d| _dS | j| | jk�r�| j�|� | j|7 _dS || jk �r| � � | j�|� || _dS dS )NFT� r ) r �lenr" r! r r% r* r# �has_fws�pop_leading_fws�_foldr. )r& �tokenr5 �lZstickyspace_len�ws�marginZtrimr r r �append_if_fits� sf
z_Folded.append_if_fits)N) �__name__�
__module__� __qualname__r' r. r0 r4 r* r? r r r r r k s r c s� e Zd ZdZ� fdd�Zdd� Z� fdd�Zedd � �Zed
d � �Z ed d
� �Z
dd� Z dd� Z dd� Z
edd� �Zdd� Zedd� �Zdd� Zd d � Zd d � Zd d!� Zd)d#d$�Zd*d%d&�Zd+d'd(�Z� ZS ),� TokenListNc s t t| �j|i |�� g | _d S r/ )r rC r' �defects)r& �args�kw�� __class__r r r' � s zTokenList.__init__c C s d� dd� | D ��S )Nr2 c s s | ]}t |�V qd S r/ �r ��.0�xr r r � <genexpr>� � z$TokenList.__str__.<locals>.<genexpr>�r3 r- r r r r4 � s zTokenList.__str__c s d� | jjtt| ��� �S �Nz{}({}))�formatrH r@ r rC �__repr__r- rG r r rR � s
�zTokenList.__repr__c C s d� dd� | D ��S )Nr2 c s s | ]}|j r|j V qd S r/ r rJ r r r rM � rN z"TokenList.value.<locals>.<genexpr>rO r- r r r r � s zTokenList.valuec C s t dd� | D �| j�S )Nc s s | ] }|j V qd S r/ )� all_defectsrJ r r r rM � rN z(TokenList.all_defects.<locals>.<genexpr>)�sumrD r- r r r rS � s zTokenList.all_defectsc c s� | j }t� }| D ]\}|�� rF|rFt|�dkr4|d n||�V |�� |�� }|�|� |r||�V |g}q|r�t|�dkr�|d n||�V d S �Nr6 r )rH r
�startswith_fwsr7 r, �pop_trailing_wsr* )r& �klass�thisr; Zend_wsr r r �parts� s
zTokenList.partsc C s | d � � S r( )rV r- r r r rV s zTokenList.startswith_fwsc C s$ | d j dkr| �d�S | d �� S )Nr �fws)�
token_type�popr9 r- r r r r9 s
zTokenList.pop_leading_fwsc C s$ | d j dkr| �d�S | d �� S )N����cfws)r\ r] rW r- r r r rW s
zTokenList.pop_trailing_wsc C s | D ]}|j r dS qdS )NTF)r8 )r& �partr r r r8 s zTokenList.has_fwsc C s | d � � S r( )�has_leading_commentr- r r r ra " s z TokenList.has_leading_commentc C s g }| D ]}|� |j� q|S r/ )r) �comments)r& rb r; r r r rb % s zTokenList.commentsc K s@ |d }|d= |j ptd�}t||�}| �|� |�� t|�S )Nr z+inf)�max_line_length�floatr r: r0 r )r& Z _3to2kwargsr r �foldedr r r �fold, s
zTokenList.foldc C s` g }| � � }|r|�|� | d jdkr2| �d�nd}|�t�t| �|�� |�|� d�|�S )Nr^ r[ r2 )r9 r* r\ r] �_ew�encoder r3 )r& �charset�resr= �trailerr r r �as_encoded_word5 s
zTokenList.as_encoded_wordc C s* g }| D ]}|� |�||�� qd�|�S r1 )r* �
cte_encoder3 )r& ri r rj r` r r r rm A s zTokenList.cte_encodec C s� | j D ]�}t|�}t|�}zt|��d� W nF tyr tdd� |jD ��rTd}nd}|�||j�}t|�}Y n0 |� ||�r�q|�
� }|d ur�t|� d��|_ |� |�r�q|j
r�|�|� q|�|� |�� qd S )N�us-asciic s s | ]}t |tj�V qd S r/ ��
isinstancer �UndecodableBytesDefectrJ r r r rM N s �z"TokenList._fold.<locals>.<genexpr>� unknown-8bit�utf-8r )rZ r r7 rh �UnicodeEncodeError�anyrS rm r r? r9 r] r" r8 r: r* r. )r& re r` �tstr�tlenri r= r r r r: G s2
�
zTokenList._foldr2 c C s t d�| jdd��� d S �N�
r2 )�indent)�printr3 �_pp�r& rz r r r �pprinti s zTokenList.pprintc C s d� | jdd��S rx )r3 r| r} r r r �ppstrl s zTokenList.ppstrc c s� d� || jj| j�V | D ]:}t|d�s:|d� |� V q|�|d �D ]
}|V qHq| jrjd� | j�}nd}d� ||�V d S )Nz{}{}/{}(r| z* !! invalid element in token list: {!r}z z Defects: {}r2 z{}){})rQ rH r@ r\ �hasattrr| rD )r& rz r; �line�extrar r r r| o s �
�
z
TokenList._pp)r2 )r2 )r2 )r@ rA rB r\ r' r4 rR �propertyr rS rZ rV r9 rW r8 ra rb rf rl rm r: r~ r r| �
__classcell__r r rG r rC � s2
*
"
rC c @ s$ e Zd Zedd� �Zedd� �ZdS )�WhiteSpaceTokenListc C s dS �N� r r- r r r r � s zWhiteSpaceTokenList.valuec C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS )�comment)r\ �contentrJ r r r �
<listcomp>� rN z0WhiteSpaceTokenList.comments.<locals>.<listcomp>r r- r r r rb � s z WhiteSpaceTokenList.commentsN)r@ rA rB r� r rb r r r r r� � s
r� c @ s e Zd ZdZdd� Zdd� ZdS )�UnstructuredTokenList� unstructuredc
C s� t dd� | D ��r | �|�S d }| jD �]�}t|�}d}zt|��d� W n� t�y t dd� |jD ��rtd}nd}|d u�rtd�|j |d � |g ���
|�}t d d� |j d |� D ��}t|�} t | �}
||
|j
k�r|j |d �= |�| � ||
|_Y q&|�
|�}d
}Y n0 |�||��r<|r&t |j �d }q&|�sH|�rT|�|� q&|�� } | d u�r~t| �|_|�|��r~q&|j�r�|�|� q&|�|� |�� d }q&d S ) Nc s s | ]}|j d kV qdS )� encoded-wordN�r\ rJ r r r rM � rN z.UnstructuredTokenList._fold.<locals>.<genexpr>Frn c s s | ]}t |tj�V qd S r/ ro rJ r r r rM � s �rr rs r2 c s s | ]}t |�V qd S r/ �r7 rJ r r r rM � rN Tr6 )ru Z
_fold_encodedrZ r rh rt rS �get_unstructuredr3 r% rl rT r7 r r* r! r? Z _fold_as_ewr9 r" r8 rf r. ) r& re �last_ewr` rv �is_ewri �chunkZ
oldlastlen�schunk�lchunkr= r r r r: � s`
�
��
zUnstructuredTokenList._foldc
C s� g }d }| D ]�}t |�}z|�d� |�|� W q ty� |d u rb|�|�||�� t|�}n*td�||d � |g ��}|�|�� � Y q 0 q d�|�S )Nrn r2 ) r rh r* rt rm r7 r� r3 rl )r& ri r rj r� r` �spart�tlr r r rm � s
z UnstructuredTokenList.cte_encodeN�r@ rA rB r\ r: rm r r r r r� � s 8r� c @ s e Zd ZdZdd� Zdd� ZdS )�Phrase�phrasec
C s� d }| j D �]�}t|�}t|�}d}zt|��d� W �n$ t�y\ tdd� |jD ��rbd}nd}|d u�rB|�� �sB|d jdkr�|j r�|�
d�}nd }t |�D ]&\} }
|
jd
kr�t |
d d � �|| < q�t
d �|j|d � |g ���|�} t| �} t| �}
||
|jk�rB|j|d �= |�| � td d� |jD ��|_Y q
|�|�}t|�}d }Y n0 |�||��r�|�r�|j �s�t|j�d
}q
|j �s�|jdkr
d }q
|�|� q
d S )NFrn c s s | ]}t |tj�V qd S r/ ro rJ r r r rM � s �z Phrase._fold.<locals>.<genexpr>rr rs r^ r_ r2 �bare-quoted-stringc s s | ]}t |�V qd S r/ r� rJ r r r rM
rN Tr6 �
quoted-string)rZ r r7 rh rt ru rS ra r\ rb r] � enumerater� r� r3 r% rl r r* rT r! r? r: )r& re r� r` rv rw Zhas_ewri � remainder�ir; r� r� r� r r r r: � sT �
��
z Phrase._foldc
C s. g }d }d}| D �]}t |�}z|�d� |�|� W n� t�y d}|d u rt|js`t|�}|�|�||�� n�|�� �s|d jdkr�|jr�|� d�}nd}t
|�D ]&\} }
|
jdkr�t |
d d � �|| < q�t d�
||d � |g ��} | �|�g||d �< Y n0 |j�s |s|jdkrd }qd�
|�S ) NFrn Tr^ r_ r2 r� r� )r rh r* rt rb r7 rm ra r\ r] r� r� r� r3 rl ) r& ri r rj r� r� r` r� r� r� r; r� r r r rm s4
zPhrase.cte_encodeNr� r r r r r� � s >r� c @ s e Zd ZdZdS )�Word�wordN�r@ rA rB r\ r r r r r� : s r� c @ s e Zd ZdZdd� ZdS )�CFWSListr_ c C s
t | j�S r/ )�boolrb r- r r r ra C s z CFWSList.has_leading_commentN)r@ rA rB r\ ra r r r r r� ? s r� c @ s e Zd ZdZdS )�Atom�atomNr� r r r r r� G s r� c @ s e Zd ZdZdS )�Tokenr; Nr� r r r r r� L s r� c @ s( e Zd ZdZdZdZdZedd� �ZdS )� EncodedWordr� Nc C s& | j d ur| j S t�t| �| j� d S r/ )�cterg rh r ri r- r r r �encodedX s
zEncodedWord.encoded) r@ rA rB r\ r� ri �langr� r� r r r r r� Q s r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � QuotedStringr� c C s" | D ]}|j dkr|j S qd S �Nr� �r\ r �r& rL r r r r� d s
zQuotedString.contentc C s> g }| D ]*}|j dkr&|�t|�� q|�|j� qd�|�S )Nr� r2 )r\ r* r r r3 )r& rj rL r r r � quoted_valuej s
zQuotedString.quoted_valuec C s" | D ]}|j dkr|j S qd S r� r� �r& r; r r r �stripped_valuet s
zQuotedString.stripped_valueN)r@ rA rB r\ r� r� r� r� r r r r r� ` s
r� c @ s$ e Zd ZdZdd� Zedd� �ZdS )�BareQuotedStringr� c C s t d�dd� | D ���S )Nr2 c s s | ]}t |�V qd S r/ rI rJ r r r rM � rN z+BareQuotedString.__str__.<locals>.<genexpr>)r r3 r- r r r r4 s zBareQuotedString.__str__c C s d� dd� | D ��S )Nr2 c s s | ]}t |�V qd S r/ rI rJ r r r rM � rN z)BareQuotedString.value.<locals>.<genexpr>rO r- r r r r � s zBareQuotedString.valueN)r@ rA rB r\ r4 r� r r r r r r� { s r� c @ s8 e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd
S ) �Commentr� c s( d� tdg� fdd�� D �dggg ��S )Nr2 r c s g | ]}� � |��qS r )�quoterJ r- r r r� � rN z#Comment.__str__.<locals>.<listcomp>�))r3 rT r- r r- r r4 � s ��zComment.__str__c C s2 |j dkrt|�S t|��dd��dd��dd�S )Nr� r r r z\(r� z\))r\ r r )r& r r r r r� � s
��z
Comment.quotec C s d� dd� | D ��S )Nr2 c s s | ]}t |�V qd S r/ rI rJ r r r rM � rN z"Comment.content.<locals>.<genexpr>rO r- r r r r� � s zComment.contentc C s | j gS r/ )r� r- r r r rb � s zComment.commentsN) r@ rA rB r\ r4 r� r� r� rb r r r r r� � s
r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � AddressListz address-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )�addressr� rJ r r r r� � rN z)AddressList.addresses.<locals>.<listcomp>r r- r r r � addresses� s zAddressList.addressesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS �r� N�r\ � mailboxesrJ r r r rM � s �z(AddressList.mailboxes.<locals>.<genexpr>�rT r- r r r r� � s
��zAddressList.mailboxesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS r� �r\ �
all_mailboxesrJ r r r rM � s �z,AddressList.all_mailboxes.<locals>.<genexpr>r� r- r r r r� � s
��zAddressList.all_mailboxesN)r@ rA rB r\ r� r� r� r� r r r r r� � s
r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Addressr� c C s | d j dkr| d jS d S )Nr �group�r\ � display_namer- r r r r� � s zAddress.display_namec C s4 | d j dkr| d gS | d j dkr*g S | d jS �Nr �mailbox�invalid-mailboxr� r- r r r r� � s
zAddress.mailboxesc C s: | d j dkr| d gS | d j dkr0| d gS | d jS r� r� r- r r r r� � s
zAddress.all_mailboxesN)r@ rA rB r\ r� r� r� r� r r r r r� � s
r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� MailboxList� mailbox-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )r� r� rJ r r r r� � rN z)MailboxList.mailboxes.<locals>.<listcomp>r r- r r r r� � s zMailboxList.mailboxesc C s dd� | D �S )Nc S s g | ]}|j d v r|�qS ))r� r� r� rJ r r r r� � s
�z-MailboxList.all_mailboxes.<locals>.<listcomp>r r- r r r r� � s zMailboxList.all_mailboxesN�r@ rA rB r\ r� r� r� r r r r r� � s
r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� GroupList�
group-listc C s | r| d j dkrg S | d jS �Nr r� r� r- r r r r� � s zGroupList.mailboxesc C s | r| d j dkrg S | d jS r� r� r- r r r r� � s zGroupList.all_mailboxesNr� r r r r r� � s
r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Groupr� c C s | d j dkrg S | d jS �N� r� r� r- r r r r� � s zGroup.mailboxesc C s | d j dkrg S | d jS r� r� r- r r r r� � s zGroup.all_mailboxesc C s
| d j S r( )r� r- r r r r� � s zGroup.display_nameN)r@ rA rB r\ r� r� r� r� r r r r r� � s
r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed
d � �Z d S )
�NameAddr� name-addrc C s t | �dkrd S | d jS rU )r7 r� r- r r r r� s zNameAddr.display_namec C s
| d j S �Nr^ ��
local_partr- r r r r� s zNameAddr.local_partc C s
| d j S r� ��domainr- r r r r� s zNameAddr.domainc C s
| d j S r� )�router- r r r r� s zNameAddr.routec C s
| d j S r� �� addr_specr- r r r r� s zNameAddr.addr_specN�
r@ rA rB r\ r� r� r� r� r� r� r r r r r� s
r� c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd
S ) � AngleAddrz
angle-addrc C s" | D ]}|j dkr|j S qd S �N� addr-spec)r\ r� r� r r r r� s
zAngleAddr.local_partc C s" | D ]}|j dkr|j S qd S r� �r\ r� r� r r r r� & s
zAngleAddr.domainc C s" | D ]}|j dkr|j S qd S )N� obs-route)r\ �domainsr� r r r r� , s
zAngleAddr.routec C s" | D ]}|j dkr|j S qdS )Nr� z<>)r\ r� r� r r r r� 2 s
zAngleAddr.addr_specN) r@ rA rB r\ r� r� r� r� r� r r r r r� s
r� c @ s e Zd ZdZedd� �ZdS )�ObsRouter� c C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS r� r� rJ r r r r� A rN z$ObsRoute.domains.<locals>.<listcomp>r r- r r r r� ? s zObsRoute.domainsN)r@ rA rB r\ r� r� r r r r r� ; s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed
d � �Z d S )
�Mailboxr� c C s | d j dkr| d jS d S �Nr r� r� r- r r r r� H s zMailbox.display_namec C s
| d j S r( r� r- r r r r� M s zMailbox.local_partc C s
| d j S r( r� r- r r r r� Q s zMailbox.domainc C s | d j dkr| d jS d S r� )r\ r� r- r r r r� U s z
Mailbox.routec C s
| d j S r( r� r- r r r r� Z s zMailbox.addr_specNr� r r r r r� D s
r� c @ s, e Zd ZdZedd� �Ze Z Z ZZ dS )�InvalidMailboxr� c C s d S r/ r r- r r r r� c s zInvalidMailbox.display_nameNr� r r r r r� _ s
r� c s$ e Zd ZdZe� fdd��Z� ZS )�Domainr� c s d� tt| �j�� �S r1 )r3 r r� r �splitr- rG r r r� n s z
Domain.domain)r@ rA rB r\ r� r� r� r r rG r r� j s r� c @ s e Zd ZdZdS )�DotAtom�dot-atomNr� r r r r r� s s r� c @ s e Zd ZdZdS )� DotAtomTextz
dot-atom-textNr� r r r r r� x s r� c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd
S ) �AddrSpecr� c C s
| d j S r( r� r- r r r r� � s zAddrSpec.local_partc C s t | �dk rd S | d jS )N� r^ )r7 r� r- r r r r� � s zAddrSpec.domainc C s< t | �dk r| d jS | d j�� | d j | d j�� S )Nr� r r6 r� )r7 r �rstrip�lstripr- r r r r � s
zAddrSpec.valuec C sL t | j�}t|�t|t �kr*t| j�}n| j}| jd urH|d | j S |S )N�@)�setr� r7 �
DOT_ATOM_ENDSr r� )r& ZnamesetZlpr r r r� � s
zAddrSpec.addr_specN) r@ rA rB r\ r� r� r� r r� r r r r r� } s
r� c @ s e Zd ZdZdS )� ObsLocalPartzobs-local-partNr� r r r r r� � s r� c s0 e Zd ZdZedd� �Ze� fdd��Z� ZS )� DisplayNamez display-namec C s� t | �}|d jdkr"|�d� n*|d d jdkrLt |d dd � �|d< |d jdkrd|�� n*|d d jdkr�t |d d d� �|d< |jS )Nr r_ r6 r^ )rC r\ r] r )r& rj r r r r� � s
zDisplayName.display_namec s� d}| j rd}n| D ]}|jdkrd}q|r�d }}| d jdksT| d d jdkrXd}| d jdksx| d d jdkr|d}|t| j� | S tt| �jS d S ) NFTr� r2 r r_ r� r^ )rD r\ r r� r r� r )r& r� rL �pre�postrG r r r � s
zDisplayName.value)r@ rA rB r\ r� r� r r� r r rG r r� � s
r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� LocalPartz
local-partc C s& | d j dkr| d jS | d jS d S )Nr r� )r\ r� r r- r r r r � s
zLocalPart.valuec C s� t g}t }d}| d t g D ]�}|jdkr,q |r\|jdkr\|d jdkr\t|d d� �|d< t|t�}|r�|jdkr�|d jdkr�|�t|dd � �� n
|�|� |d }|}q t|dd� �}|jS )NFr r_ �dotr^ r6 )�DOTr\ rC rp r* r )r& rj �lastZ
last_is_tl�tokZis_tlr r r r� � s(
�
�
zLocalPart.local_partN)r@ rA rB r\ r� r r� r r r r r� � s
r� c s0 e Zd ZdZe� fdd��Zedd� �Z� ZS )�
DomainLiteralzdomain-literalc s d� tt| �j�� �S r1 )r3 r r� r r� r- rG r r r� � s zDomainLiteral.domainc C s" | D ]}|j dkr|j S qd S )N�ptextr� r� r r r �ip� s
zDomainLiteral.ip)r@ rA rB r\ r� r� r� r� r r rG r r� � s
r� c @ s e Zd ZdZdZdZdS )� MIMEVersionz mime-versionN)r@ rA rB r\ �major�minorr r r r r� � s r� c @ s4 e Zd ZdZdZdZdZedd� �Zedd� �Z dS ) � Parameter� parameterFrn c C s | j r| d jS dS rU )� sectioned�numberr- r r r �section_number s zParameter.section_numberc C sf | D ]\}|j dkr |j S |j dkr|D ]4}|j dkr*|D ] }|j dkr<|j S q<q*qdS )Nr r� r� r2 )r\ r� r� r r r � param_value s
zParameter.param_valueN)
r@ rA rB r\ r �extendedri r� r r r r r r r s
r c @ s e Zd ZdZdS )�InvalidParameter�invalid-parameterNr� r r r r r s r c @ s e Zd ZdZedd� �ZdS )� Attribute� attributec C s$ | D ]}|j �d�r|j S qd S )N�attrtext)r\ �endswithr r� r r r r� ' s zAttribute.stripped_valueN�r@ rA rB r\ r� r� r r r r r # s r c @ s e Zd ZdZdZdS )�Section�sectionN)r@ rA rB r\ r r r r r r - s r c @ s e Zd ZdZedd� �ZdS )�Valuer c C s2 | d }|j dkr| d }|j �d�r,|jS | jS )Nr r_ r6 )r� r
zextended-attribute)r\ r r� r r� r r r r� 7 s
�zValue.stripped_valueNr
r r r r r 3 s r c @ s$ e Zd ZdZedd� �Zdd� ZdS )�MimeParameters�mime-parametersc
c sf t � }| D ]T}|j�d�s q
|d jdkr,q
|d j�� }||vrJg ||< || �|j|f� q
|�� D ]�\}}t|�}g }|d d j }t
|�D ]�\}\}} ||kr�| j �t �
d�� | j}
| j�r@z t|
�}
W n ty� t|
dd�}
Y nP0 z|
�|d�}
W n t�y" |
�d d�}
Y n0 t�|
��r@| j �t �� � |�|
� q�d
�|�}
||
fV qhd S ) Nr r r
r6 z*inconsistent multipart parameter numberingzlatin-1)�encoding�surrogateescapern r2 )r r\ r r �stripr* r �items�sortedri r� rD r �InvalidHeaderDefectr r r rt r
�decode� LookupErrorr �_has_surrogatesrq r3 ) r& �paramsr; �namerZ Z value_partsri r� r �paramr r r r r F sD
�
zMimeParameters.paramsc C sT g }| j D ].\}}|r.|�d�|t|��� q
|�|� q
d�|�}|rPd| S dS )Nz{}={}z; r� r2 )r r* rQ r r3 )r& r r r r r r r4 y s
zMimeParameters.__str__N)r@ rA rB r\ r� r r4 r r r r r B s
2r c @ s$ e Zd Zedd� �Zedd� �ZdS )�ParameterizedHeaderValuec C s& t | �D ]}|jdkr|j S qi S )Nr )�reversedr\ r r� r r r r � s
z ParameterizedHeaderValue.paramsc C s4 | r*| d j dkr*t| d d� | d �S t| �jS )Nr^ r )r\ rC rZ r- r r r rZ � s z ParameterizedHeaderValue.partsN)r@ rA rB r� r rZ r r r r r � s
r c @ s e Zd ZdZdZdZdS )� ContentTypez content-type�text�plainN)r@ rA rB r\ �maintype�subtyper r r r r! � s r! c @ s e Zd ZdZdZdS )�ContentDispositionzcontent-dispositionN)r@ rA rB r\ �content_dispositionr r r r r& � s r& c @ s e Zd ZdZdZdS )�ContentTransferEncodingzcontent-transfer-encoding�7bitN)r@ rA rB r\ r� r r r r r( � s r( c @ s e Zd ZdZdS )� HeaderLabelz header-labelNr� r r r r r* � s r* c @ s e Zd ZdZdd� ZdS )�Header�headerc C sj |� t| �d��� t|jd �|_| d jdkr@t| �d��nd|_| �d�}| r\td��|� |� d S )Nr r_ r2 zMalformed Header token list)
r* r r] r7 r% r! r\ r" �
ValueErrorr: )r& re �restr r r r: � s "
z Header._foldN)r@ rA rB r\ r: r r r r r+ � s r+ c sv e Zd Z� fdd�Z� fdd�Zedd� �Zd� fdd � Zd
d � Zd d
� Z dd� Z
edd� �Z dd� Z dd� Z
� ZS )�Terminalc s" t t| ��| |�}||_g |_|S r/ )r r/ �__new__r\ rD )�clsr r\ r& rG r r r0 � s zTerminal.__new__c s d� | jjtt| ��� �S rP )rQ rH r@ r r/ rR r- rG r r rR � s zTerminal.__repr__c C s
t | j�S r/ )r
rD r- r r r rS � s zTerminal.all_defectsr2 c s6 d� || jj| jtt| ��� | js&dn
d� | j��gS )Nz
{}{}/{}({}){}r2 z {})rQ rH r@ r\ r r/ rR rD r} rG r r r| � s �z Terminal._ppc C s< t | �}z|�d� |W S ty6 t�||� Y S 0 d S )Nrn )r rh rt rg )r& ri r r r r r rm � s
zTerminal.cte_encodec C s d S r/ r r- r r r rW � s zTerminal.pop_trailing_wsc C s d S r/ r r- r r r r9 � s zTerminal.pop_leading_fwsc C s g S r/ r r- r r r rb � s zTerminal.commentsc C s dS �NFr r- r r r ra � s z Terminal.has_leading_commentc C s t | �| jfS r/ )r r\ r- r r r �__getnewargs__� s zTerminal.__getnewargs__)r2 )r@ rA rB r0 rR r� rS r| rm rW r9 rb ra r3 r� r r rG r r/ � s
r/ c @ s$ e Zd Zedd� �Zdd� ZdZdS )�WhiteSpaceTerminalc C s dS r� r r- r r r r � s zWhiteSpaceTerminal.valuec C s dS )NTr r- r r r rV s z!WhiteSpaceTerminal.startswith_fwsTN)r@ rA rB r� r rV r8 r r r r r4 � s
r4 c @ s, e Zd Zedd� �Zdd� ZdZdd� ZdS ) �
ValueTerminalc C s | S r/ r r- r r r r s zValueTerminal.valuec C s dS r2 r r- r r r rV s z ValueTerminal.startswith_fwsFc C s t �t| �|�S r/ )rg rh r )r& ri r r r rl s z ValueTerminal.as_encoded_wordN)r@ rA rB r� r rV r8 rl r r r r r5 s
r5 c @ s0 e Zd Zedd� �Zedd� �Zdd� ZdZdS ) �EWWhiteSpaceTerminalc C s dS r1 r r- r r r r s zEWWhiteSpaceTerminal.valuec C s | d d � S r/ r r- r r r r� s z EWWhiteSpaceTerminal.encodedc C s dS r1 r r- r r r r4 s z EWWhiteSpaceTerminal.__str__TN)r@ rA rB r� r r� r4 r8 r r r r r6 s
r6 r� �,�list-separatorr� zroute-component-markerz([{}]+)r2 z[^{}]+r r �]z\]z[\x00-\x20\x7F]c C s> t | �}|r | j�t�|�� t�| �r:| j�t�d�� dS )z@If input token contains ASCII non-printables, register a defect.z*Non-ASCII characters found in header tokenN)�_non_printable_finderrD r* r �NonPrintableDefectr r rq )�xtext�non_printablesr r r �_validate_xtextO s
�r> c C s� t t| d��}|dd� |dd� g \}}g }d}d}tt|��D ]L}|| dkrh|rbd}d}nd}qD|rrd}n|| |v r� q�|�|| � qD|d }d�|�d�||d� g| �|fS )ak Scan printables/quoted-pairs until endchars and return unquoted ptext.
This function turns a run of qcontent, ccontent-without-comments, or
dtext-with-quoted-printables into a single string by unquoting any
quoted printables. It returns the string, the remaining value, and
a flag that is True iff there were any quoted printables decoded.
r6 NFr Tr2 )r
�
_wsp_splitterr r7 r* r3 ) r �endcharsZ _3to2list�fragmentr� Zvchars�escape�had_qp�posr r r �_get_ptext_to_endcharsY s& rE c
C s� g }g }d}| r�zt | d�\}}} W n" tyF | dd }}} Y n0 |�d�r\|�d�sxd�|�|| | | |fS t�|�\}}}} |�|� |�| � |}q d�|�||fS )a" Decode a run of RFC2047 encoded words.
_decode_ew_run(value) -> (text, value, defects)
Scans the supplied value for a run of tokens that look like they are RFC
2047 encoded words, decodes those words into text according to RFC 2047
rules (whitespace between encoded words is discarded), and returns the text
and the remaining value (including any leading whitespace on the remaining
value), as well as a list of any defects encountered while decoding. The
input value may not have any leading whitespace.
r2 r6 �=?�?=) r? r- �
startswithr r3 rg r r* r) )
r rj rD Zlast_wsr� r= r" ri r� Z new_defectsr r r �_decode_ew_runx s
rI c C s. | � � }t| dt| �t|� � d�}||fS )z�FWS = 1*WSP
This isn't the RFC definition. We're using fws to represent tokens where
folding can be done, but when we are parsing the *un*folding has already
been done so we don't need to watch out for CRLF.
Nr[ )r� r4 r7 )r Znewvaluer[ r r r �get_fws� s rJ c C s� t � }| �d�s t�d�| ���t| dd� �dd��}|dd� |dd� g \}}|| dd� krvt�d�| ���d�|�}|dd� �� r�t|�dd��}|dd� |dd� g \}}|d | }t |�� �dkr�|j
� t� d�� | |_
d�|�} z t�d| d �\}} }
} W n& t�y@ t�d �|j
���Y n0 | |_|
|_|j
�| � |�r�|d
tv �r�t|�\} }|� | � �qZtt|d��}
|
dd� |
dd� g \}}t|d �}t|� |� |� d�|�}�qZ|| fS ) zE encoded-word = "=?" charset "?" encoding "?" encoded-text "?="
rF z"expected encoded word but found {}r� NrG r6 r2 z whitespace inside encoded wordz!encoded word format invalid: '{}'r �vtext)r� rH r �HeaderParseErrorrQ r
r� r3 �isdigitr7 rD r* r r� rg r r- ri r� r) �WSPrJ r? r5 r> )r �ewZ
_3to2list1r� r� ZremstrZ
_3to2list3r. r" ri r� rD r; Z
_3to2list5�charsrK r r r �get_encoded_word� sV
� �
�
�
rQ c C s( t � }| �r$| d tv r0t| �\}} |�|� q| �d�r�zt| �\}} W n tjy^ Y nr0 d}t|�dkr�|d j dkr�|j
�t� d�� d}|r�t|�dkr�|d j d
kr�t |d d�|d< |�|� qt
t| d��}|d d� |dd � g \}}t|d �}t|� |�|� d
�|�} q|S )aO unstructured = (*([FWS] vchar) *WSP) / obs-unstruct
obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS)
obs-utext = %d0 / obs-NO-WS-CTL / LF / CR
obs-NO-WS-CTL is control characters except WSP/CR/LF.
So, basically, we have printable runs, plus control characters or nulls in
the obsolete syntax, separated by whitespace. Since RFC 2047 uses the
obsolete syntax in its specification, but requires whitespace on either
side of the encoded words, I can see no reason to need to separate the
non-printable-non-whitespace from the printable runs if they occur, so we
parse this into xtext tokens separated by WSP tokens.
Because an 'unstructured' value must by definition constitute the entire
value, this 'get' routine does not return a remaining value, only the
parsed TokenList.
r rF Tr^ r[ z&missing whitespace before encoded wordFr6 ���r� NrK r2 )r� rN rJ r* rH rQ r rL r7 r\ rD r r6 r
r? r5 r> r3 )r r� r; Zhave_wsZ
_3to2list7r� r� rK r r r r� � s@
��
r� c C s* t | d�\}} }t|d�}t|� || fS )a ctext = <printable ascii except \ ( )>
This is not the RFC ctext, since we are handling nested comments in comment
and unquoting quoted-pairs here. We allow anything except the '()'
characters, but if we find any ASCII other than the RFC defined printable
ASCII an NonPrintableDefect is added to the token's defects list. Since
quoted pairs are converted to their unquoted values, what is returned is
a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value
is ' '.
z()r� )rE r4 r> �r r� �_r r r � get_qp_ctext s
rU c C s* t | d�\}} }t|d�}t|� || fS )ao qcontent = qtext / quoted-pair
We allow anything except the DQUOTE character, but if we find any ASCII
other than the RFC defined printable ASCII an NonPrintableDefect is
added to the token's defects list. Any quoted pairs are converted to their
unquoted values, so what is returned is a 'ptext' token. In this case it
is a ValueTerminal.
r r� )rE r5 r> rS r r r � get_qcontent s
rV c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�atext = <matches _atext_matcher>
We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to
the token's defects list if we find non-atext characters.
z expected atext but found '{}'N�atext)�_non_atom_end_matcherr rL rQ r� r7 r5 r> )r �mrW r r r � get_atext$ s �
rZ c C s� | d dkr t �d�| ���t� }| dd� } | rp| d dkrp| d tv rXt| �\}} n t| �\}} |�|� q.| s�|j�t � d�� || fS || dd� fS )z�bare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE
A quoted-string without the leading or trailing white space. Its
value is the text between the quote marks, with whitespace
preserved and quoted pairs decoded.
r r zexpected '"' but found '{}'r6 Nz"end of header inside quoted string)
r rL rQ r� rN rJ rV r* rD r )r Zbare_quoted_stringr; r r r �get_bare_quoted_string4 s" �
�r[ c C s� | r | d dkr t �d�| ���t� }| dd� } | r�| d dkr�| d tv r\t| �\}} n&| d dkrvt| �\}} n t| �\}} |�|� q2| s�|j �t �
d�� || fS || dd� fS )z�comment = "(" *([FWS] ccontent) [FWS] ")"
ccontent = ctext / quoted-pair / comment
We handle nested comments here, and quoted-pair in our qp-ctext routine.
r r zexpected '(' but found '{}'r6 Nr� z end of header inside comment) r rL rQ r� rN rJ � get_commentrU r* rD r )r r� r; r r r r\ L s& �
�r\ c C sP t � }| rH| d tv rH| d tv r0t| �\}} n t| �\}} |�|� q|| fS )z,CFWS = (1*([FWS] comment) [FWS]) / FWS
r )r� � CFWS_LEADERrN rJ r\ r* )r r_ r; r r r �get_cfwse s r^ c C sp t � }| r,| d tv r,t| �\}} |�|� t| �\}} |�|� | rh| d tv rht| �\}} |�|� || fS )z�quoted-string = [CFWS] <bare-quoted-string> [CFWS]
'bare-quoted-string' is an intermediate class defined by this
parser and not by the RFC grammar. It is the quoted string
without any attached CFWS.
r )r� r] r^ r* r[ )r Z
quoted_stringr; r r r �get_quoted_stringr s
r_ c C s� t � }| r,| d tv r,t| �\}} |�|� | rL| d tv rLt�d�| ���t| �\}} |�|� | r�| d tv r�t| �\}} |�|� || fS )z"atom = [CFWS] 1*atext [CFWS]
r z expected atom but found '{}') r� r] r^ r* � ATOM_ENDSr rL rQ rZ )r r� r; r r r �get_atom� s
�
ra c C s� t � }| r| d tv r&t�d�| ���| rt| d tvrtt| �\}} |�|� | r&| d dkr&|�t� | dd� } q&|d tu r�t�d�d| ���|| fS )z( dot-text = 1*atext *("." 1*atext)
r z8expected atom at a start of dot-atom-text but found '{}'r r6 Nr^ z4expected atom at end of dot-atom-text but found '{}')r� r` r rL rQ rZ r* r� )r Z
dot_atom_textr; r r r �get_dot_atom_text� s �
�rb c C sl t � }| d tv r(t| �\}} |�|� t| �\}} |�|� | rd| d tv rdt| �\}} |�|� || fS )z- dot-atom = [CFWS] dot-atom-text [CFWS]
r )r� r] r^ r* rb )r Zdot_atomr; r r r � get_dot_atom� s
rc c C s� | d t v rt| �\}} nd}| d dkr8t| �\}} n*| d tv rVt�d�| ���n t| �\}} |durx|g|dd�< || fS )a� word = atom / quoted-string
Either atom or quoted-string may start with CFWS. We have to peel off this
CFWS first to determine which type of word to parse. Afterward we splice
the leading CFWS, if any, into the parsed sub-token.
If neither an atom or a quoted-string is found before the next special, a
HeaderParseError is raised.
The token returned is either an Atom or a QuotedString, as appropriate.
This means the 'word' level of the formal grammar is not represented in the
parse tree; this is because having that extra layer when manipulating the
parse tree is more confusing than it is helpful.
r Nr z1Expected 'atom' or 'quoted-string' but found '{}')r] r^ r_ �SPECIALSr rL rQ ra )r �leaderr; r r r �get_word� s � rf c C s� t � }zt| �\}} |�|� W n& tjyF |j�t�d�� Y n0 | r�| d tvr�| d dkr�|�t� |j�t� d�� | dd� } qHzt| �\}} W nB tjy� | d t
v r�t | �\}} |j�t� d�� n� Y n0 |�|� qH|| fS )a� phrase = 1*word / obs-phrase
obs-phrase = word *(word / "." / CFWS)
This means a phrase can be a sequence of words, periods, and CFWS in any
order as long as it starts with at least one word. If anything other than
words is detected, an ObsoleteHeaderDefect is added to the token's defect
list. We also accept a phrase that starts with CFWS followed by a dot;
this is registered as an InvalidHeaderDefect, since it is not supported by
even the obsolete grammar.
z phrase does not start with wordr r zperiod in 'phrase'r6 Nzcomment found without atom) r� rf r* r rL rD r � PHRASE_ENDSr� �ObsoleteHeaderDefectr] r^ )r r� r; r r r �
get_phrase� s4
�
�
� ri c C sp t � }d}| d tv r"t| �\}} | s6t�d�| ���zt| �\}} W nZ tjy� zt| �\}} W n4 tjy� | d dkr�| d tv r�� t � }Y n0 Y n0 |dur�|g|dd�< |�
|� | �r0| d dks�| d tv�r0t t |�| �\}} |j
dk�r|j�
t�d�� n|j�
t�d�� ||d< z|j�d� W n& t�yf |j�
t�d �� Y n0 || fS )
z= local-part = dot-atom / quoted-string / obs-local-part
Nr z"expected local-part but found '{}'r �invalid-obs-local-partz<local-part is not dot-atom, quoted-string, or obs-local-partz,local-part is not a dot-atom (contains CFWS)�asciiz)local-part contains non-ASCII characters))r� r] r^ r rL rQ rc rf rg rC r* �get_obs_local_partr r\ rD r rh r rh rt �NonASCIILocalPartDefect)r r� re r; �obs_local_partr r r �get_local_part� sJ �
�
�
� ro c C s� t � }d}| �r&| d dks*| d tv�r&| d dkrj|rL|j�t�d�� |�t� d}| dd� } q
nD| d dkr�|�t| d d �� | dd� } |j�t�d
�� d}q
|r�|d jd kr�|j�t�d
�� zt | �\}} d}W n2 tj
�y | d t v�r� t | �\}} Y n0 |�|� q
|d jd k�sV|d jdk�rh|d jd k�rh|j�t�d�� |d jd k�s�|d jdk�r�|d jd k�r�|j�t�d�� |j�r�d|_|| fS )z' obs-local-part = word *("." word)
Fr r r zinvalid repeated '.'Tr6 N�misplaced-specialz/'\' character outside of quoted-string/ccontentr^ r� zmissing '.' between wordsr_ z!Invalid leading '.' in local partrR z"Invalid trailing '.' in local partrj )
r� rg rD r* r r r� r5 r\ rf rL r] r^ )r rn Zlast_non_ws_was_dotr; r r r rl $ sj
�
�
�
� � �
� � �
�rl c C s@ t | d�\}} }t|d�}|r0|j�t�d�� t|� || fS )a dtext = <printable ascii except \ [ ]> / obs-dtext
obs-dtext = obs-NO-WS-CTL / quoted-pair
We allow anything except the excluded characters, but if we find any
ASCII other than the RFC defined printable ASCII an NonPrintableDefect is
added to the token's defects list. Quoted pairs are converted to their
unquoted values, so what is returned is a ptext token, in this case a
ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is
added to the returned token's defect list.
z[]r� z(quoted printable found in domain-literal)rE r5 rD r* r rh r> )r r� rC r r r � get_dtextS s
�rq c C s, | rdS |� t�d�� |� tdd�� dS )NFz"end of input inside domain-literalr9 �domain-literal-endT)r* r r r5 )r �domain_literalr r r �_check_for_early_dl_endg s �rt c C sj t � }| d tv r(t| �\}} |�|� | s6t�d��| d dkrRt�d�| ���| dd� } t| |�rp|| fS |�tdd�� | d t v r�t
| �\}} |�|� t | �\}} |�|� t| |�r�|| fS | d t v r�t
| �\}} |�|� t| |�r�|| fS | d dk�r t�d �| ���|�tdd
�� | dd� } | �rb| d tv �rbt| �\}} |�|� || fS ) zB domain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS]
r zexpected domain-literal�[z6expected '[' at start of domain-literal but found '{}'r6 Nzdomain-literal-startr9 z4expected ']' at end of domain-literal but found '{}'rr ) r� r] r^ r* r rL rQ rt r5 rN rJ rq )r rs r; r r r �get_domain_literalo sH
�
�
rv c C sV t � }d}| d tv r"t| �\}} | s6t�d�| ���| d dkrvt| �\}} |durd|g|dd�< |�|� || fS zt| �\}} W n tjy� t | �\}} Y n0 |dur�|g|dd�< |�|� | �rN| d dk�rN|j
�t� d�� |d j dk�r|d |dd�< | �rN| d dk�rN|�t
� t | dd� �\}} |�|� �q|| fS ) z] domain = dot-atom / domain-literal / obs-domain
obs-domain = atom *("." atom))
Nr z expected domain but found '{}'ru r z(domain is not a dot-atom (contains CFWS)r� r6 )r� r] r^ r rL rQ rv r* rc ra rD rh r\ r� )r r� re r; r r r �
get_domain� s@ �
�
rw c C s| t � }t| �\}} |�|� | r,| d dkrF|j�t�d�� || fS |�tdd�� t| dd� �\}} |�|� || fS )z( addr-spec = local-part "@" domain
r r� z"add-spec local part with no domainzaddress-at-symbolr6 N)r� ro r* rD r r r5 rw )r r� r; r r r �
get_addr_spec� s
�
rx c C s� t � }| rj| d dks"| d tv rj| d tv rFt| �\}} |�|� q| d dkr|�t� | dd� } q| rz| d dkr�t�d�| ���|�t� t | dd� �\}} |�|� | �r>| d dk�r>|�t� | dd� } | s�q>| d tv �rt| �\}} |�|� | d dkr�|�t� t | dd� �\}} |�|� q�| �sNt�d��| d dk�rlt�d �| ���|�t
dd
�� || dd� fS ) z� obs-route = obs-domain-list ":"
obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain])
Returns an obs-route token with the appropriate sub-tokens (that is,
there is no obs-domain-list in the parse tree).
r r7 r6 Nr� z(expected obs-route domain but found '{}'z%end of header while parsing obs-route�:z4expected ':' marking end of obs-route but found '{}'zend-of-obs-route-marker) r� r] r^ r* �
ListSeparatorr rL rQ �RouteComponentMarkerrw r5 )r Z obs_router; r r r �
get_obs_route� sF
�
�r| c C s� t � }| d tv r(t| �\}} |�|� | r8| d dkrHt�d�| ���|�tdd�� | dd� } | d dkr�|�tdd�� |j�t� d �� | dd� } || fS zt
| �\}} W nv tj�y, z"t | �\}} |j�t� d
�� W n& tj�y t�d �| ���Y n0 |�|� t
| �\}} Y n0 |�|� | �rZ| d dk�rZ| dd� } n|j�t� d �� |�tdd�� | �r�| d tv �r�t| �\}} |�|� || fS )
z� angle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr
obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS]
r �<z"expected angle-addr but found '{}'zangle-addr-startr6 N�>zangle-addr-endz null addr-spec in angle-addrz*obsolete route specification in angle-addrz.expected addr-spec or obs-route but found '{}'z"missing trailing '>' on angle-addr)
r� r] r^ r* r rL rQ r5 rD r rx r| rh )r Z
angle_addrr; r r r �get_angle_addr� sT
�
�
�
�
�
r c C s< t � }t| �\}} |�|dd� � |jdd� |_|| fS )z� display-name = phrase
Because this is simply a name-rule, we don't return a display-name
token containing a phrase, but rather a display-name token with
the content of the phrase.
N)r� ri r) rD )r r� r; r r r �get_display_name! s
r� c C s� t � }d}| d tv r6t| �\}} | s6t�d�|���| d dkr�| d tv r^t�d�| ���t| �\}} | s~t�d�|���|dur�|g|d dd�< d}|�|� t | �\}} |dur�|g|dd�< |�|� || fS )z, name-addr = [display-name] angle-addr
Nr z!expected name-addr but found '{}'r} )
r� r] r^ r rL rQ rg r� r* r )r Z name_addrre r; r r r �
get_name_addr0 s6 � � �
r� c C s� t � }zt| �\}} W nJ tjy` zt| �\}} W n$ tjyZ t�d�| ���Y n0 Y n0 tdd� |jD ��r|d|_|� |� || fS )z& mailbox = name-addr / addr-spec
z expected mailbox but found '{}'c s s | ]}t |tj�V qd S r/ )rp r r rJ r r r rM ] s �z get_mailbox.<locals>.<genexpr>r� )
r� r� r rL rx rQ ru rS r\ r* )r r� r; r r r � get_mailboxN s ��
r� c C sd t � }| r\| d |vr\| d tv rD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to one of the chars in endchars.
This is outside the formal grammar. The InvalidMailbox TokenList that is
returned acts like a Mailbox, but the data attributes are None.
r rp r6 N)r� rg r* r5 ri )r r@ Zinvalid_mailboxr; r r r �get_invalid_mailboxc s � r� c C s� t � }| �r�| d dk�r�z t| �\}} |�|� W �n tj�y: d}| d tv r�t| �\}} | rt| d dv r�|�|� |j�t�d�� n@t | d�\}} |dur�|g|dd�< |�|� |j�t�
d�� nb| d dkr�|j�t�d�� nBt | d�\}} |du�r|g|dd�< |�|� |j�t�
d�� Y n0 | �r�| d dv�r�|d }d |_ t | d�\}} |� |� |j�t�
d�� | r| d dkr|�t
� | d
d� } q|| fS ) aJ mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list
obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS])
For this routine we go outside the formal grammar in order to improve error
handling. We recognize the end of the mailbox list only at the end of the
value or at a ';' (the group terminator). This is so that we can turn
invalid mailboxes into InvalidMailbox tokens and continue parsing any
remaining valid mailboxes. We also allow all mailbox entries to be null,
and this condition is handled appropriately at a higher level.
r �;Nz,;z empty element in mailbox-listz invalid mailbox in mailbox-listr7 r^ r� r6 )r� r� r* r rL r] r^ rD rh r� r r\ r) rz )r Z mailbox_listr; re r� r r r �get_mailbox_listu sX
�
�
�
�
�
r� c C s t � }| s$|j�t�d�� || fS d}| r�| d tv r�t| �\}} | sl|j�t�d�� |�|� || fS | d dkr�|�|� || fS t| �\}} t|j �dkr�|dur�|�|� |�
|� |j�t� d�� || fS |dur�|g|dd�< |�|� || fS )zg group-list = mailbox-list / CFWS / obs-group-list
obs-group-list = 1*([CFWS] ",") [CFWS]
z end of header before group-listNr zend of header in group-listr� z group-list with empty entries) r� rD r* r r r] r^ r� r7 r� r) rh )r Z
group_listre r; r r r �get_group_list� s>
�
�
�
r� c C s t � }t| �\}} | r"| d dkr2t�d�| ���|�|� |�tdd�� | dd� } | r�| d dkr�|�tdd�� || dd� fS t| �\}} |�|� | s�|j�t� d �� | d dkr�t�d
�| ���|�tdd�� | dd� } | �r| d t
v �rt | �\}} |�|� || fS ) z7 group = display-name ":" [group-list] ";" [CFWS]
r ry z8expected ':' at end of group display name but found '{}'z group-display-name-terminatorr6 Nr� zgroup-terminatorzend of header in groupz)expected ';' at end of group but found {}) r� r� r rL rQ r* r5 r� rD r r] r^ )r r� r; r r r � get_group� s8 �
� �
r� c C st t � }zt| �\}} W nJ tjy` zt| �\}} W n$ tjyZ t�d�| ���Y n0 Y n0 |�|� || fS )a� address = mailbox / group
Note that counter-intuitively, an address can be either a single address or
a list of addresses (a group). This is why the returned Address object has
a 'mailboxes' attribute which treats a single address as a list of length
one. When you need to differentiate between to two cases, extract the single
element, which is either a mailbox or a group token.
z expected address but found '{}')r� r� r rL r� rQ r* )r r� r; r r r � get_address� s �
r� c
C s� t � }| �r�z t| �\}} |�|� W �n$ tj�yL } �zd}| d tv r�t| �\}} | rj| d dkr�|�|� |j�t�d�� nFt | d�\}} |dur�|g|dd�< |�t
|g�� |j�t� d�� nh| d dkr�|j�t�d�� nHt | d�\}} |du�r|g|dd�< |�t
|g�� |j�t� d�� W Y d}~n
d}~0 0 | �r�| d dk�r�|d d }d|_ t | d�\}} |�
|� |j�t� d�� | r|�tdd �� | d
d� } q|| fS ) a� address_list = (address *("," address)) / obs-addr-list
obs-addr-list = *([CFWS] ",") address *("," [address / CFWS])
We depart from the formal grammar here by continuing to parse until the end
of the input, assuming the input to be entirely composed of an
address-list. This is always true in email parsing, and allows us
to skip invalid addresses to parse additional valid ones.
Nr r7 z"address-list entry with no contentz invalid address in address-listz empty element in address-listr^ r� r8 r6 )r� r� r* r rL r] r^ rD rh r� r� r r\ r) r5 )r Z address_listr; �errre r� r r r �get_address_list sX
�
�
�
�
�r� c C s� t � }| s |j�t�d�� |S | d tv rXt| �\}} |�|� | sX|j�t�d�� d}| r�| d dkr�| d tvr�|| d 7 }| dd� } q\|�� s�|j�t�d� |��� |�t
|d �� nt |�|_ |�t
|d
�� | �r| d tv �rt| �\}} |�|� | �r | d dk�rT|j du�r:|j�t�d �� | �rP|�t
| d �� |S |�t
dd �� | dd� } | �r�| d tv �r�t| �\}} |�|� | �s�|j du�r�|j�t�d �� |S d}| �r�| d tv�r�|| d 7 }| dd� } �q�|�� �s*|j�t�d
� |��� |�t
|d �� nt |�|_
|�t
|d
�� | �rn| d tv �rnt| �\}} |�|� | �r�|j�t�d�� |�t
| d �� |S )zE mime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS]
z%Missing MIME version number (eg: 1.0)r z0Expected MIME version number but found only CFWSr2 r r6 Nz1Expected MIME major version number but found {!r}r< �digitsz0Incomplete MIME version; found only major numberzversion-separatorz1Expected MIME minor version number but found {!r}z'Excess non-CFWS text after MIME version)r� rD r* r �HeaderMissingRequiredValuer] r^ rM r rQ r5 r r� r� )r Z mime_versionr; r� r r r �parse_mime_versionL s�
�
�
�
�
�
�
�r� c C sd t � }| r\| d dkr\| d tv rD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to the next ';'.
This is outside the formal grammar. The InvalidParameter TokenList that is
returned acts like a Parameter, but the data attributes are None.
r r� rp r6 N)r rg r* r5 ri )r Zinvalid_parameterr; r r r �get_invalid_parameter� s � r� c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )a8 ttext = <matches _ttext_matcher>
We allow any non-TOKEN_ENDS in ttext, but add defects to the token's
defects list if we find non-ttext characters. We also register defects for
*any* non-printables even though the RFC doesn't exclude all of them,
because we follow the spirit of RFC 5322.
z expected ttext but found '{}'N�ttext)�_non_token_end_matcherr rL rQ r� r7 r5 r> )r rY r� r r r � get_ttext� s �
r� c C s� t � }| r,| d tv r,t| �\}} |�|� | rL| d tv rLt�d�| ���t| �\}} |�|� | r�| d tv r�t| �\}} |�|� || fS )z�token = [CFWS] 1*ttext [CFWS]
The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or
tspecials. We also exclude tabs even though the RFC doesn't.
The RFC implies the CFWS but is not explicit about it in the BNF.
r � expected token but found '{}') r� r] r^ r* �
TOKEN_ENDSr rL rQ r� )r Zmtokenr; r r r � get_token� s
�
r� c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )aQ attrtext = 1*(any non-ATTRIBUTE_ENDS character)
We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the
token's defects list if we find non-attrtext characters. We also register
defects for *any* non-printables even though the RFC doesn't exclude all of
them, because we follow the spirit of RFC 5322.
z expected attrtext but found {!r}Nr )�_non_attribute_end_matcherr rL rQ r� r7 r5 r> �r rY r r r r � get_attrtext� s �
r� c C s� t � }| r,| d tv r,t| �\}} |�|� | rL| d tv rLt�d�| ���t| �\}} |�|� | r�| d tv r�t| �\}} |�|� || fS )aH [CFWS] 1*attrtext [CFWS]
This version of the BNF makes the CFWS explicit, and as usual we use a
value terminal for the actual run of characters. The RFC equivalent of
attrtext is the token characters, with the subtraction of '*', "'", and '%'.
We include tab in the excluded set just as we do for token.
r r� ) r r] r^ r* �ATTRIBUTE_ENDSr rL rQ r� �r r
r; r r r �
get_attribute� s
�
r� c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�attrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%')
This is a special parsing routine so that we get a value that
includes % escapes as a single string (which we decode as a single
string later).
z)expected extended attrtext but found {!r}N�extended-attrtext)�#_non_extended_attribute_end_matcherr rL rQ r� r7 r5 r> r� r r r �get_extended_attrtext� s �
r� c C s� t � }| r,| d tv r,t| �\}} |�|� | rL| d tv rLt�d�| ���t| �\}} |�|� | r�| d tv r�t| �\}} |�|� || fS )z� [CFWS] 1*extended_attrtext [CFWS]
This is like the non-extended version except we allow % characters, so that
we can pick up an encoded value as a single string.
r r� ) r r] r^ r* �EXTENDED_ATTRIBUTE_ENDSr rL rQ r� r� r r r �get_extended_attribute
s
�
r� c C s� t � }| r| d dkr&t�d�| ���|�tdd�� | dd� } | rR| d �� sbt�d�| ���d}| r�| d �� r�|| d 7 }| dd� } qf|d d kr�|d kr�|j�t�d
�� t |�|_
|�t|d �� || fS ) a6 '*' digits
The formal BNF is more complicated because leading 0s are not allowed. We
check for that and add a defect. We also assume no CFWS is allowed between
the '*' and the digits, though the RFC is not crystal clear on that.
The caller should already have dealt with leading CFWS.
r �*z Expected section but found {}zsection-markerr6 Nz$Expected section number but found {}r2 �0z§ion numberhas an invalid leading 0r� ) r r rL rQ r* r5 rM rD �InvalidHeaderErrorr r )r r r� r r r � get_section
s( � �
r� c C s� t � }| st�d��d}| d tv r0t| �\}} | sDt�d�|���| d dkr^t| �\}} n t| �\}} |dur�|g|dd�< |�|� || fS )z quoted-string / attribute
z&Expected value but found end of stringNr z Expected value but found only {}r ) r r rL r] r^ rQ r_ r� r* )r �vre r; r r r � get_value<
s"
�
r� c C s� t � }t| �\}} |�|� | r,| d dkrL|j�t�d�|��� || fS | d dkr�z t| �\}} d|_|�|� W n tj y� Y n0 | s�t� d��| d dkr�|�t
dd�� | dd � } d|_ | d d
kr�t� d ��|�t
d
d �� | dd � } d }| �r*| d t v �r*t
| �\}} |�|� d }|}|j �rD| �rD| d d
k�rDt| �\}}|j}d}|jdk�r�|�r�|d dk�r�d}n$t|�\}} | �r�| d dk�r�d}n(zt|�\}} W n Y n 0 | �s�d}|�r.|j�t�d�� |�|� |D ](}
|
jdk�r�g |
d d �< |
} �q(�q�|} nd }|j�t�d�� | �r^| d dk�r^d }n t| �\}} |j �r~|jdk�r�| �r�| d dk�r�|�|� |d u�r�| �r�J | ��|} || fS |j�t�d�� | �s|j�t�d�� |�|� |d u �r�|| fS n�|d u�rL|D ]}
|
jdk�r �q0�q|
jdk |�|
� |
j|_| d dk�rjt� d�| ���|�t
dd�� | dd � } | �r�| d dk�r�t| �\}} |�|� |j|_| �r�| d dk�r�t� d�| ���|�t
dd�� | dd � } |d u�rJt� } | �rD| d tv �r*t| �\}} n t| �\}} | �|� �q| }n t| �\}} |�|� |d u�r|| �rxJ | ��|} || fS )aY attribute [section] ["*"] [CFWS] "=" value
The CFWS is implied by the RFC but not made explicit in the BNF. This
simplified form of the BNF from the RFC is made to conform with the RFC BNF
through some extra checks. We do it this way because it makes both error
recovery and working with the resulting parse tree easier.
r r� z)Parameter contains name ({}) but no valuer� TzIncomplete parameterzextended-parameter-markerr6 N�=z Parameter not followed by '='�parameter-separatorr F�'z5Quoted string value for extended parameter is invalidr� zZParameter marked as extended but appears to have a quoted string value that is non-encodedzcApparent initial-extended-value but attribute was not marked as extended or was not initial sectionz(Missing required charset/lang delimitersr� r z=Expected RFC2231 char/lang encoding delimiter, but found {!r}zRFC2231 delimiterz;Expected RFC2231 char/lang encoding delimiter, but found {}) r r� r* rD r r rQ r� r rL r5 r r] r^ r_ r� r r� r� r\ r� r ri r� r rN rJ rV ) r r r; re r� ZappendtoZqstringZ inner_valueZ
semi_validr. �tr� r r r �
get_parameterR
s�
�
�
�
�
�
�
�
r� c
C sp t � }| �rlzt| �\}} |�|� W n� tjy� } z�d}| d tv rTt| �\}} | sr|�|� |W Y d}~S | d dkr�|dur�|�|� |j�t�d�� n@t | �\}} |r�|g|dd�< |�|� |j�t�d�
|��� W Y d}~n
d}~0 0 | �rJ| d dk�rJ|d }d|_ t | �\}} |� |� |j�t�d�
|��� | r|�t
dd �� | d
d� } q|S ) a! parameter *( ";" parameter )
That BNF is meant to indicate this routine should only be called after
finding and handling the leading ';'. There is no corresponding rule in
the formal RFC grammar, but it is more convenient for us for the set of
parameters to be treated as its own TokenList.
This is 'parse' routine because it consumes the reminaing value, but it
would never be called to parse a full header. Instead it is called to
parse everything after the non-parameter value of a specific MIME header.
Nr r� z parameter entry with no contentzinvalid parameter {!r}r^ r z)parameter with invalid trailing text {!r}r� r6 )r r� r* r rL r] r^ rD r r� rQ r\ r) r5 )r Zmime_parametersr; r� re r r r r �parse_mime_parameters�
sJ
�
�
�r� c C s� |rV|d dkrV|d t v r>| �t|d d�� |dd� }q t|�\}}| �|� q |s^dS | �tdd�� | �t|dd� �� dS )zBDo our best to find the parameters in an invalid MIME header
r r� rp r6 Nr� )rg r* r5 ri r� )� tokenlistr r; r r r �_find_mime_parameters s r� c
C s� t � }d}| s$|j�t�d�� |S zt| �\}} W n: tjyn |j�t�d�| ��� t || � | Y S 0 |�|� | r�| d dkr�|j�t�d�� | r�t || � |S |j
� � � � |_
|�tdd�� | dd � } zt| �\}} W n< tj�y& |j�t�d
�| ��� t || � | Y S 0 |�|� |j
� � � � |_| �sL|S | d d k�r�|j�t�d �| ��� |`
|`t || � |S |�td d
�� |�t| dd � �� |S )z� maintype "/" subtype *( ";" parameter )
The maintype and substype are tokens. Theoretically they could
be checked against the official IANA list + x-token, but we
don't do that.
Fz"Missing content type specificationz(Expected content maintype but found {!r}r �/zInvalid content typezcontent-type-separatorr6 Nz'Expected content subtype but found {!r}r� z<Only parameters are valid after content type, but found {!r}r� )r! rD r* r r� r� rL r rQ r� r r �lowerr$ r5 r% r� )r �ctypeZrecoverr; r r r �parse_content_type_header! sd
�
�
�
�
��
r� c
C s� t � }| s |j�t�d�� |S zt| �\}} W n: tjyj tj�t�d� | ��� t
|| � | Y S 0 |�|� |j � � �
� |_| s�|S | d dkr�|j�t�d� | ��� t
|| � |S |�tdd�� |�t| dd� �� |S ) z* disposition-type *( ";" parameter )
zMissing content dispositionz+Expected content disposition but found {!r}r r� zCOnly parameters are valid after content disposition, but found {!r}r� r6 N)r& rD r* r r� r� rL r� r rQ r� r r r� r' r5 r� )r Z disp_headerr; r r r � parse_content_disposition_headerZ s:
�
�
��
r� c
C s� t � }| s |j�t�d�� |S zt| �\}} W n, tjy\ tj�t�d� | ��� Y n 0 |�|� |j
� � � � |_
| s�|S | r�|j�t�d�� | d tv r�|�t| d d�� | dd� } q�t| �\}} |�|� q�|S )z mechanism
z!Missing content transfer encodingz1Expected content trnasfer encoding but found {!r}z*Extra text after content transfer encodingr rp r6 N)r( rD r* r r� r� rL r� r rQ r r r� r� rg r5 ri )r Z
cte_headerr; r r r �&parse_content_transfer_encoding_headerx s4
�
�
� r� )��__doc__�
__future__r r r r Zfuture.builtinsr r r r r
�re� collectionsr r Z future.backports.urllib.parser
r Zfuture.backports.emailr rg r r r� rN r] rd r` r� rg Z TSPECIALSr� Z ASPECIALSr� r� r �objectr rC r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r! r& r( r* r+ r/ r4 r5 r6 r� rz r{ �compilerQ r3 r� r? r �matchrX �findallr: r� r� r� r> rE rI rJ rQ r� rU rV rZ r[ r\ r^ r_ ra rb rc rf ri ro rl rq rt rv rw rx r| r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r �<module> s$ D T D N_ '#
B3
� ��
���
,7
&'/'$). 9% >D 49 PK �Du\)��!�* �* $ future/backports/email/quoprimime.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Ben Gertzfield
# Contact: email-sig@python.org
"""Quoted-printable content transfer encoding per RFCs 2045-2047.
This module handles the content transfer encoding method defined in RFC 2045
to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to
safely encode text that is in a character set similar to the 7-bit US ASCII
character set, but that includes some 8-bit characters that are normally not
allowed in email bodies or headers.
Quoted-printable is very space-inefficient for encoding binary files; use the
email.base64mime module for that instead.
This module provides an interface to encode and decode both headers and bodies
with quoted-printable encoding.
RFC 2045 defines a method for including character set information in an
`encoded-word' in a header. This method is commonly used for 8-bit real names
in To:/From:/Cc: etc. fields, as well as Subject: lines.
This module does not do the line wrapping or end-of-line character
conversion necessary for proper internationalized headers; it only
does dumb encoding and decoding. To deal with the various line
wrapping issues, use the email.header module.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import bytes, chr, dict, int, range, super
__all__ = [
'body_decode',
'body_encode',
'body_length',
'decode',
'decodestring',
'header_decode',
'header_encode',
'header_length',
'quote',
'unquote',
]
import re
import io
from string import ascii_letters, digits, hexdigits
CRLF = '\r\n'
NL = '\n'
EMPTYSTRING = ''
# Build a mapping of octets to the expansion of that octet. Since we're only
# going to have 256 of these things, this isn't terribly inefficient
# space-wise. Remember that headers and bodies have different sets of safe
# characters. Initialize both maps with the full expansion, and then override
# the safe bytes with the more compact form.
_QUOPRI_HEADER_MAP = dict((c, '=%02X' % c) for c in range(256))
_QUOPRI_BODY_MAP = _QUOPRI_HEADER_MAP.copy()
# Safe header bytes which need no encoding.
for c in bytes(b'-!*+/' + ascii_letters.encode('ascii') + digits.encode('ascii')):
_QUOPRI_HEADER_MAP[c] = chr(c)
# Headers have one other special encoding; spaces become underscores.
_QUOPRI_HEADER_MAP[ord(' ')] = '_'
# Safe body bytes which need no encoding.
for c in bytes(b' !"#$%&\'()*+,-./0123456789:;<>'
b'?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`'
b'abcdefghijklmnopqrstuvwxyz{|}~\t'):
_QUOPRI_BODY_MAP[c] = chr(c)
# Helpers
def header_check(octet):
"""Return True if the octet should be escaped with header quopri."""
return chr(octet) != _QUOPRI_HEADER_MAP[octet]
def body_check(octet):
"""Return True if the octet should be escaped with body quopri."""
return chr(octet) != _QUOPRI_BODY_MAP[octet]
def header_length(bytearray):
"""Return a header quoted-printable encoding length.
Note that this does not include any RFC 2047 chrome added by
`header_encode()`.
:param bytearray: An array of bytes (a.k.a. octets).
:return: The length in bytes of the byte array when it is encoded with
quoted-printable for headers.
"""
return sum(len(_QUOPRI_HEADER_MAP[octet]) for octet in bytearray)
def body_length(bytearray):
"""Return a body quoted-printable encoding length.
:param bytearray: An array of bytes (a.k.a. octets).
:return: The length in bytes of the byte array when it is encoded with
quoted-printable for bodies.
"""
return sum(len(_QUOPRI_BODY_MAP[octet]) for octet in bytearray)
def _max_append(L, s, maxlen, extra=''):
if not isinstance(s, str):
s = chr(s)
if not L:
L.append(s.lstrip())
elif len(L[-1]) + len(s) <= maxlen:
L[-1] += extra + s
else:
L.append(s.lstrip())
def unquote(s):
"""Turn a string in the form =AB to the ASCII character with value 0xab"""
return chr(int(s[1:3], 16))
def quote(c):
return '=%02X' % ord(c)
def header_encode(header_bytes, charset='iso-8859-1'):
"""Encode a single header line with quoted-printable (like) encoding.
Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but
used specifically for email header fields to allow charsets with mostly 7
bit characters (and some 8 bit) to remain more or less readable in non-RFC
2045 aware mail clients.
charset names the character set to use in the RFC 2046 header. It
defaults to iso-8859-1.
"""
# Return empty headers as an empty string.
if not header_bytes:
return ''
# Iterate over every byte, encoding if necessary.
encoded = []
for octet in header_bytes:
encoded.append(_QUOPRI_HEADER_MAP[octet])
# Now add the RFC chrome to each encoded chunk and glue the chunks
# together.
return '=?%s?q?%s?=' % (charset, EMPTYSTRING.join(encoded))
class _body_accumulator(io.StringIO):
def __init__(self, maxlinelen, eol, *args, **kw):
super().__init__(*args, **kw)
self.eol = eol
self.maxlinelen = self.room = maxlinelen
def write_str(self, s):
"""Add string s to the accumulated body."""
self.write(s)
self.room -= len(s)
def newline(self):
"""Write eol, then start new line."""
self.write_str(self.eol)
self.room = self.maxlinelen
def write_soft_break(self):
"""Write a soft break, then start a new line."""
self.write_str('=')
self.newline()
def write_wrapped(self, s, extra_room=0):
"""Add a soft line break if needed, then write s."""
if self.room < len(s) + extra_room:
self.write_soft_break()
self.write_str(s)
def write_char(self, c, is_last_char):
if not is_last_char:
# Another character follows on this line, so we must leave
# extra room, either for it or a soft break, and whitespace
# need not be quoted.
self.write_wrapped(c, extra_room=1)
elif c not in ' \t':
# For this and remaining cases, no more characters follow,
# so there is no need to reserve extra room (since a hard
# break will immediately follow).
self.write_wrapped(c)
elif self.room >= 3:
# It's a whitespace character at end-of-line, and we have room
# for the three-character quoted encoding.
self.write(quote(c))
elif self.room == 2:
# There's room for the whitespace character and a soft break.
self.write(c)
self.write_soft_break()
else:
# There's room only for a soft break. The quoted whitespace
# will be the only content on the subsequent line.
self.write_soft_break()
self.write(quote(c))
def body_encode(body, maxlinelen=76, eol=NL):
"""Encode with quoted-printable, wrapping at maxlinelen characters.
Each line of encoded text will end with eol, which defaults to "\\n". Set
this to "\\r\\n" if you will be using the result of this function directly
in an email.
Each line will be wrapped at, at most, maxlinelen characters before the
eol string (maxlinelen defaults to 76 characters, the maximum value
permitted by RFC 2045). Long lines will have the 'soft line break'
quoted-printable character "=" appended to them, so the decoded text will
be identical to the original text.
The minimum maxlinelen is 4 to have room for a quoted character ("=XX")
followed by a soft line break. Smaller values will generate a
ValueError.
"""
if maxlinelen < 4:
raise ValueError("maxlinelen must be at least 4")
if not body:
return body
# The last line may or may not end in eol, but all other lines do.
last_has_eol = (body[-1] in '\r\n')
# This accumulator will make it easier to build the encoded body.
encoded_body = _body_accumulator(maxlinelen, eol)
lines = body.splitlines()
last_line_no = len(lines) - 1
for line_no, line in enumerate(lines):
last_char_index = len(line) - 1
for i, c in enumerate(line):
if body_check(ord(c)):
c = quote(c)
encoded_body.write_char(c, i==last_char_index)
# Add an eol if input line had eol. All input lines have eol except
# possibly the last one.
if line_no < last_line_no or last_has_eol:
encoded_body.newline()
return encoded_body.getvalue()
# BAW: I'm not sure if the intent was for the signature of this function to be
# the same as base64MIME.decode() or not...
def decode(encoded, eol=NL):
"""Decode a quoted-printable string.
Lines are separated with eol, which defaults to \\n.
"""
if not encoded:
return encoded
# BAW: see comment in encode() above. Again, we're building up the
# decoded string with string concatenation, which could be done much more
# efficiently.
decoded = ''
for line in encoded.splitlines():
line = line.rstrip()
if not line:
decoded += eol
continue
i = 0
n = len(line)
while i < n:
c = line[i]
if c != '=':
decoded += c
i += 1
# Otherwise, c == "=". Are we at the end of the line? If so, add
# a soft line break.
elif i+1 == n:
i += 1
continue
# Decode if in form =AB
elif i+2 < n and line[i+1] in hexdigits and line[i+2] in hexdigits:
decoded += unquote(line[i:i+3])
i += 3
# Otherwise, not in form =AB, pass literally
else:
decoded += c
i += 1
if i == n:
decoded += eol
# Special case if original string did not end with eol
if encoded[-1] not in '\r\n' and decoded.endswith(eol):
decoded = decoded[:-1]
return decoded
# For convenience and backwards compatibility w/ standard base64 module
body_decode = decode
decodestring = decode
def _unquote_match(match):
"""Turn a match in the form =AB to the ASCII character with value 0xab"""
s = match.group(0)
return unquote(s)
# Header decoding is done a bit differently
def header_decode(s):
"""Decode a string encoded with RFC 2045 MIME header `Q' encoding.
This function does not parse a full MIME header value encoded with
quoted-printable (like =?iso-8895-1?q?Hello_World?=) -- please use
the high level email.header class for that functionality.
"""
s = s.replace('_', ' ')
return re.sub(r'=[a-fA-F0-9]{2}', _unquote_match, s, re.ASCII)
PK �Du\Wxl� � future/backports/email/parser.pynu �[��� # Copyright (C) 2001-2007 Python Software Foundation
# Author: Barry Warsaw, Thomas Wouters, Anthony Baxter
# Contact: email-sig@python.org
"""A parser of RFC 2822 and MIME email messages."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['Parser', 'HeaderParser', 'BytesParser', 'BytesHeaderParser']
import warnings
from io import StringIO, TextIOWrapper
from future.backports.email.feedparser import FeedParser, BytesFeedParser
from future.backports.email.message import Message
from future.backports.email._policybase import compat32
class Parser(object):
def __init__(self, _class=Message, **_3to2kwargs):
"""Parser of RFC 2822 and MIME email messages.
Creates an in-memory object tree representing the email message, which
can then be manipulated and turned over to a Generator to return the
textual representation of the message.
The string must be formatted as a block of RFC 2822 headers and header
continuation lines, optionally preceded by a `Unix-from' header. The
header block is terminated either by the end of the string or by a
blank line.
_class is the class to instantiate for new message objects when they
must be created. This class must have a constructor that can take
zero arguments. Default is Message.Message.
The policy keyword specifies a policy object that controls a number of
aspects of the parser's operation. The default policy maintains
backward compatibility.
"""
if 'policy' in _3to2kwargs: policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
else: policy = compat32
self._class = _class
self.policy = policy
def parse(self, fp, headersonly=False):
"""Create a message structure from the data in a file.
Reads all the data from the file and returns the root of the message
structure. Optional headersonly is a flag specifying whether to stop
parsing after reading the headers or not. The default is False,
meaning it parses the entire contents of the file.
"""
feedparser = FeedParser(self._class, policy=self.policy)
if headersonly:
feedparser._set_headersonly()
while True:
data = fp.read(8192)
if not data:
break
feedparser.feed(data)
return feedparser.close()
def parsestr(self, text, headersonly=False):
"""Create a message structure from a string.
Returns the root of the message structure. Optional headersonly is a
flag specifying whether to stop parsing after reading the headers or
not. The default is False, meaning it parses the entire contents of
the file.
"""
return self.parse(StringIO(text), headersonly=headersonly)
class HeaderParser(Parser):
def parse(self, fp, headersonly=True):
return Parser.parse(self, fp, True)
def parsestr(self, text, headersonly=True):
return Parser.parsestr(self, text, True)
class BytesParser(object):
def __init__(self, *args, **kw):
"""Parser of binary RFC 2822 and MIME email messages.
Creates an in-memory object tree representing the email message, which
can then be manipulated and turned over to a Generator to return the
textual representation of the message.
The input must be formatted as a block of RFC 2822 headers and header
continuation lines, optionally preceded by a `Unix-from' header. The
header block is terminated either by the end of the input or by a
blank line.
_class is the class to instantiate for new message objects when they
must be created. This class must have a constructor that can take
zero arguments. Default is Message.Message.
"""
self.parser = Parser(*args, **kw)
def parse(self, fp, headersonly=False):
"""Create a message structure from the data in a binary file.
Reads all the data from the file and returns the root of the message
structure. Optional headersonly is a flag specifying whether to stop
parsing after reading the headers or not. The default is False,
meaning it parses the entire contents of the file.
"""
fp = TextIOWrapper(fp, encoding='ascii', errors='surrogateescape')
with fp:
return self.parser.parse(fp, headersonly)
def parsebytes(self, text, headersonly=False):
"""Create a message structure from a byte string.
Returns the root of the message structure. Optional headersonly is a
flag specifying whether to stop parsing after reading the headers or
not. The default is False, meaning it parses the entire contents of
the file.
"""
text = text.decode('ASCII', errors='surrogateescape')
return self.parser.parsestr(text, headersonly)
class BytesHeaderParser(BytesParser):
def parse(self, fp, headersonly=True):
return BytesParser.parse(self, fp, headersonly=True)
def parsebytes(self, text, headersonly=True):
return BytesParser.parsebytes(self, text, headersonly=True)
PK �Du\�';�P �P ( future/backports/email/headerregistry.pynu �[��� """Representing and manipulating email headers via custom objects.
This module provides an implementation of the HeaderRegistry API.
The implementation is designed to flexibly follow RFC5322 rules.
Eventually HeaderRegistry will be a public API, but it isn't yet,
and will probably change some before that happens.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
from future.builtins import str
from future.utils import text_to_native_str
from future.backports.email import utils
from future.backports.email import errors
from future.backports.email import _header_value_parser as parser
class Address(object):
def __init__(self, display_name='', username='', domain='', addr_spec=None):
"""Create an object represeting a full email address.
An address can have a 'display_name', a 'username', and a 'domain'. In
addition to specifying the username and domain separately, they may be
specified together by using the addr_spec keyword *instead of* the
username and domain keywords. If an addr_spec string is specified it
must be properly quoted according to RFC 5322 rules; an error will be
raised if it is not.
An Address object has display_name, username, domain, and addr_spec
attributes, all of which are read-only. The addr_spec and the string
value of the object are both quoted according to RFC5322 rules, but
without any Content Transfer Encoding.
"""
# This clause with its potential 'raise' may only happen when an
# application program creates an Address object using an addr_spec
# keyword. The email library code itself must always supply username
# and domain.
if addr_spec is not None:
if username or domain:
raise TypeError("addrspec specified when username and/or "
"domain also specified")
a_s, rest = parser.get_addr_spec(addr_spec)
if rest:
raise ValueError("Invalid addr_spec; only '{}' "
"could be parsed from '{}'".format(
a_s, addr_spec))
if a_s.all_defects:
raise a_s.all_defects[0]
username = a_s.local_part
domain = a_s.domain
self._display_name = display_name
self._username = username
self._domain = domain
@property
def display_name(self):
return self._display_name
@property
def username(self):
return self._username
@property
def domain(self):
return self._domain
@property
def addr_spec(self):
"""The addr_spec (username@domain) portion of the address, quoted
according to RFC 5322 rules, but with no Content Transfer Encoding.
"""
nameset = set(self.username)
if len(nameset) > len(nameset-parser.DOT_ATOM_ENDS):
lp = parser.quote_string(self.username)
else:
lp = self.username
if self.domain:
return lp + '@' + self.domain
if not lp:
return '<>'
return lp
def __repr__(self):
return "Address(display_name={!r}, username={!r}, domain={!r})".format(
self.display_name, self.username, self.domain)
def __str__(self):
nameset = set(self.display_name)
if len(nameset) > len(nameset-parser.SPECIALS):
disp = parser.quote_string(self.display_name)
else:
disp = self.display_name
if disp:
addr_spec = '' if self.addr_spec=='<>' else self.addr_spec
return "{} <{}>".format(disp, addr_spec)
return self.addr_spec
def __eq__(self, other):
if type(other) != type(self):
return False
return (self.display_name == other.display_name and
self.username == other.username and
self.domain == other.domain)
class Group(object):
def __init__(self, display_name=None, addresses=None):
"""Create an object representing an address group.
An address group consists of a display_name followed by colon and an
list of addresses (see Address) terminated by a semi-colon. The Group
is created by specifying a display_name and a possibly empty list of
Address objects. A Group can also be used to represent a single
address that is not in a group, which is convenient when manipulating
lists that are a combination of Groups and individual Addresses. In
this case the display_name should be set to None. In particular, the
string representation of a Group whose display_name is None is the same
as the Address object, if there is one and only one Address object in
the addresses list.
"""
self._display_name = display_name
self._addresses = tuple(addresses) if addresses else tuple()
@property
def display_name(self):
return self._display_name
@property
def addresses(self):
return self._addresses
def __repr__(self):
return "Group(display_name={!r}, addresses={!r}".format(
self.display_name, self.addresses)
def __str__(self):
if self.display_name is None and len(self.addresses)==1:
return str(self.addresses[0])
disp = self.display_name
if disp is not None:
nameset = set(disp)
if len(nameset) > len(nameset-parser.SPECIALS):
disp = parser.quote_string(disp)
adrstr = ", ".join(str(x) for x in self.addresses)
adrstr = ' ' + adrstr if adrstr else adrstr
return "{}:{};".format(disp, adrstr)
def __eq__(self, other):
if type(other) != type(self):
return False
return (self.display_name == other.display_name and
self.addresses == other.addresses)
# Header Classes #
class BaseHeader(str):
"""Base class for message headers.
Implements generic behavior and provides tools for subclasses.
A subclass must define a classmethod named 'parse' that takes an unfolded
value string and a dictionary as its arguments. The dictionary will
contain one key, 'defects', initialized to an empty list. After the call
the dictionary must contain two additional keys: parse_tree, set to the
parse tree obtained from parsing the header, and 'decoded', set to the
string value of the idealized representation of the data from the value.
(That is, encoded words are decoded, and values that have canonical
representations are so represented.)
The defects key is intended to collect parsing defects, which the message
parser will subsequently dispose of as appropriate. The parser should not,
insofar as practical, raise any errors. Defects should be added to the
list instead. The standard header parsers register defects for RFC
compliance issues, for obsolete RFC syntax, and for unrecoverable parsing
errors.
The parse method may add additional keys to the dictionary. In this case
the subclass must define an 'init' method, which will be passed the
dictionary as its keyword arguments. The method should use (usually by
setting them as the value of similarly named attributes) and remove all the
extra keys added by its parse method, and then use super to call its parent
class with the remaining arguments and keywords.
The subclass should also make sure that a 'max_count' attribute is defined
that is either None or 1. XXX: need to better define this API.
"""
def __new__(cls, name, value):
kwds = {'defects': []}
cls.parse(value, kwds)
if utils._has_surrogates(kwds['decoded']):
kwds['decoded'] = utils._sanitize(kwds['decoded'])
self = str.__new__(cls, kwds['decoded'])
# del kwds['decoded']
self.init(name, **kwds)
return self
def init(self, name, **_3to2kwargs):
defects = _3to2kwargs['defects']; del _3to2kwargs['defects']
parse_tree = _3to2kwargs['parse_tree']; del _3to2kwargs['parse_tree']
self._name = name
self._parse_tree = parse_tree
self._defects = defects
@property
def name(self):
return self._name
@property
def defects(self):
return tuple(self._defects)
def __reduce__(self):
return (
_reconstruct_header,
(
self.__class__.__name__,
self.__class__.__bases__,
str(self),
),
self.__dict__)
@classmethod
def _reconstruct(cls, value):
return str.__new__(cls, value)
def fold(self, **_3to2kwargs):
policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
"""Fold header according to policy.
The parsed representation of the header is folded according to
RFC5322 rules, as modified by the policy. If the parse tree
contains surrogateescaped bytes, the bytes are CTE encoded using
the charset 'unknown-8bit".
Any non-ASCII characters in the parse tree are CTE encoded using
charset utf-8. XXX: make this a policy setting.
The returned value is an ASCII-only string possibly containing linesep
characters, and ending with a linesep character. The string includes
the header name and the ': ' separator.
"""
# At some point we need to only put fws here if it was in the source.
header = parser.Header([
parser.HeaderLabel([
parser.ValueTerminal(self.name, 'header-name'),
parser.ValueTerminal(':', 'header-sep')]),
parser.CFWSList([parser.WhiteSpaceTerminal(' ', 'fws')]),
self._parse_tree])
return header.fold(policy=policy)
def _reconstruct_header(cls_name, bases, value):
return type(text_to_native_str(cls_name), bases, {})._reconstruct(value)
class UnstructuredHeader(object):
max_count = None
value_parser = staticmethod(parser.get_unstructured)
@classmethod
def parse(cls, value, kwds):
kwds['parse_tree'] = cls.value_parser(value)
kwds['decoded'] = str(kwds['parse_tree'])
class UniqueUnstructuredHeader(UnstructuredHeader):
max_count = 1
class DateHeader(object):
"""Header whose value consists of a single timestamp.
Provides an additional attribute, datetime, which is either an aware
datetime using a timezone, or a naive datetime if the timezone
in the input string is -0000. Also accepts a datetime as input.
The 'value' attribute is the normalized form of the timestamp,
which means it is the output of format_datetime on the datetime.
"""
max_count = None
# This is used only for folding, not for creating 'decoded'.
value_parser = staticmethod(parser.get_unstructured)
@classmethod
def parse(cls, value, kwds):
if not value:
kwds['defects'].append(errors.HeaderMissingRequiredValue())
kwds['datetime'] = None
kwds['decoded'] = ''
kwds['parse_tree'] = parser.TokenList()
return
if isinstance(value, str):
value = utils.parsedate_to_datetime(value)
kwds['datetime'] = value
kwds['decoded'] = utils.format_datetime(kwds['datetime'])
kwds['parse_tree'] = cls.value_parser(kwds['decoded'])
def init(self, *args, **kw):
self._datetime = kw.pop('datetime')
super().init(*args, **kw)
@property
def datetime(self):
return self._datetime
class UniqueDateHeader(DateHeader):
max_count = 1
class AddressHeader(object):
max_count = None
@staticmethod
def value_parser(value):
address_list, value = parser.get_address_list(value)
assert not value, 'this should not happen'
return address_list
@classmethod
def parse(cls, value, kwds):
if isinstance(value, str):
# We are translating here from the RFC language (address/mailbox)
# to our API language (group/address).
kwds['parse_tree'] = address_list = cls.value_parser(value)
groups = []
for addr in address_list.addresses:
groups.append(Group(addr.display_name,
[Address(mb.display_name or '',
mb.local_part or '',
mb.domain or '')
for mb in addr.all_mailboxes]))
defects = list(address_list.all_defects)
else:
# Assume it is Address/Group stuff
if not hasattr(value, '__iter__'):
value = [value]
groups = [Group(None, [item]) if not hasattr(item, 'addresses')
else item
for item in value]
defects = []
kwds['groups'] = groups
kwds['defects'] = defects
kwds['decoded'] = ', '.join([str(item) for item in groups])
if 'parse_tree' not in kwds:
kwds['parse_tree'] = cls.value_parser(kwds['decoded'])
def init(self, *args, **kw):
self._groups = tuple(kw.pop('groups'))
self._addresses = None
super().init(*args, **kw)
@property
def groups(self):
return self._groups
@property
def addresses(self):
if self._addresses is None:
self._addresses = tuple([address for group in self._groups
for address in group.addresses])
return self._addresses
class UniqueAddressHeader(AddressHeader):
max_count = 1
class SingleAddressHeader(AddressHeader):
@property
def address(self):
if len(self.addresses)!=1:
raise ValueError(("value of single address header {} is not "
"a single address").format(self.name))
return self.addresses[0]
class UniqueSingleAddressHeader(SingleAddressHeader):
max_count = 1
class MIMEVersionHeader(object):
max_count = 1
value_parser = staticmethod(parser.parse_mime_version)
@classmethod
def parse(cls, value, kwds):
kwds['parse_tree'] = parse_tree = cls.value_parser(value)
kwds['decoded'] = str(parse_tree)
kwds['defects'].extend(parse_tree.all_defects)
kwds['major'] = None if parse_tree.minor is None else parse_tree.major
kwds['minor'] = parse_tree.minor
if parse_tree.minor is not None:
kwds['version'] = '{}.{}'.format(kwds['major'], kwds['minor'])
else:
kwds['version'] = None
def init(self, *args, **kw):
self._version = kw.pop('version')
self._major = kw.pop('major')
self._minor = kw.pop('minor')
super().init(*args, **kw)
@property
def major(self):
return self._major
@property
def minor(self):
return self._minor
@property
def version(self):
return self._version
class ParameterizedMIMEHeader(object):
# Mixin that handles the params dict. Must be subclassed and
# a property value_parser for the specific header provided.
max_count = 1
@classmethod
def parse(cls, value, kwds):
kwds['parse_tree'] = parse_tree = cls.value_parser(value)
kwds['decoded'] = str(parse_tree)
kwds['defects'].extend(parse_tree.all_defects)
if parse_tree.params is None:
kwds['params'] = {}
else:
# The MIME RFCs specify that parameter ordering is arbitrary.
kwds['params'] = dict((utils._sanitize(name).lower(),
utils._sanitize(value))
for name, value in parse_tree.params)
def init(self, *args, **kw):
self._params = kw.pop('params')
super().init(*args, **kw)
@property
def params(self):
return self._params.copy()
class ContentTypeHeader(ParameterizedMIMEHeader):
value_parser = staticmethod(parser.parse_content_type_header)
def init(self, *args, **kw):
super().init(*args, **kw)
self._maintype = utils._sanitize(self._parse_tree.maintype)
self._subtype = utils._sanitize(self._parse_tree.subtype)
@property
def maintype(self):
return self._maintype
@property
def subtype(self):
return self._subtype
@property
def content_type(self):
return self.maintype + '/' + self.subtype
class ContentDispositionHeader(ParameterizedMIMEHeader):
value_parser = staticmethod(parser.parse_content_disposition_header)
def init(self, *args, **kw):
super().init(*args, **kw)
cd = self._parse_tree.content_disposition
self._content_disposition = cd if cd is None else utils._sanitize(cd)
@property
def content_disposition(self):
return self._content_disposition
class ContentTransferEncodingHeader(object):
max_count = 1
value_parser = staticmethod(parser.parse_content_transfer_encoding_header)
@classmethod
def parse(cls, value, kwds):
kwds['parse_tree'] = parse_tree = cls.value_parser(value)
kwds['decoded'] = str(parse_tree)
kwds['defects'].extend(parse_tree.all_defects)
def init(self, *args, **kw):
super().init(*args, **kw)
self._cte = utils._sanitize(self._parse_tree.cte)
@property
def cte(self):
return self._cte
# The header factory #
_default_header_map = {
'subject': UniqueUnstructuredHeader,
'date': UniqueDateHeader,
'resent-date': DateHeader,
'orig-date': UniqueDateHeader,
'sender': UniqueSingleAddressHeader,
'resent-sender': SingleAddressHeader,
'to': UniqueAddressHeader,
'resent-to': AddressHeader,
'cc': UniqueAddressHeader,
'resent-cc': AddressHeader,
'bcc': UniqueAddressHeader,
'resent-bcc': AddressHeader,
'from': UniqueAddressHeader,
'resent-from': AddressHeader,
'reply-to': UniqueAddressHeader,
'mime-version': MIMEVersionHeader,
'content-type': ContentTypeHeader,
'content-disposition': ContentDispositionHeader,
'content-transfer-encoding': ContentTransferEncodingHeader,
}
class HeaderRegistry(object):
"""A header_factory and header registry."""
def __init__(self, base_class=BaseHeader, default_class=UnstructuredHeader,
use_default_map=True):
"""Create a header_factory that works with the Policy API.
base_class is the class that will be the last class in the created
header class's __bases__ list. default_class is the class that will be
used if "name" (see __call__) does not appear in the registry.
use_default_map controls whether or not the default mapping of names to
specialized classes is copied in to the registry when the factory is
created. The default is True.
"""
self.registry = {}
self.base_class = base_class
self.default_class = default_class
if use_default_map:
self.registry.update(_default_header_map)
def map_to_type(self, name, cls):
"""Register cls as the specialized class for handling "name" headers.
"""
self.registry[name.lower()] = cls
def __getitem__(self, name):
cls = self.registry.get(name.lower(), self.default_class)
return type(text_to_native_str('_'+cls.__name__), (cls, self.base_class), {})
def __call__(self, name, value):
"""Create a header instance for header 'name' from 'value'.
Creates a header instance by creating a specialized class for parsing
and representing the specified header by combining the factory
base_class with a specialized class from the registry or the
default_class, and passing the name and value to the constructed
class's constructor.
"""
return self[name](name, value)
PK �Du\ӌ��_ �_ future/backports/email/header.pynu �[��� # Copyright (C) 2002-2007 Python Software Foundation
# Author: Ben Gertzfield, Barry Warsaw
# Contact: email-sig@python.org
"""Header encoding and decoding functionality."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import bytes, range, str, super, zip
__all__ = [
'Header',
'decode_header',
'make_header',
]
import re
import binascii
from future.backports import email
from future.backports.email import base64mime
from future.backports.email.errors import HeaderParseError
import future.backports.email.charset as _charset
# Helpers
from future.backports.email.quoprimime import _max_append, header_decode
Charset = _charset.Charset
NL = '\n'
SPACE = ' '
BSPACE = b' '
SPACE8 = ' ' * 8
EMPTYSTRING = ''
MAXLINELEN = 78
FWS = ' \t'
USASCII = Charset('us-ascii')
UTF8 = Charset('utf-8')
# Match encoded-word strings in the form =?charset?q?Hello_World?=
ecre = re.compile(r'''
=\? # literal =?
(?P<charset>[^?]*?) # non-greedy up to the next ? is the charset
\? # literal ?
(?P<encoding>[qb]) # either a "q" or a "b", case insensitive
\? # literal ?
(?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string
\?= # literal ?=
''', re.VERBOSE | re.IGNORECASE | re.MULTILINE)
# Field name regexp, including trailing colon, but not separating whitespace,
# according to RFC 2822. Character range is from tilde to exclamation mark.
# For use with .match()
fcre = re.compile(r'[\041-\176]+:$')
# Find a header embedded in a putative header value. Used to check for
# header injection attack.
_embeded_header = re.compile(r'\n[^ \t]+:')
def decode_header(header):
"""Decode a message header value without converting charset.
Returns a list of (string, charset) pairs containing each of the decoded
parts of the header. Charset is None for non-encoded parts of the header,
otherwise a lower-case string containing the name of the character set
specified in the encoded string.
header may be a string that may or may not contain RFC2047 encoded words,
or it may be a Header object.
An email.errors.HeaderParseError may be raised when certain decoding error
occurs (e.g. a base64 decoding exception).
"""
# If it is a Header object, we can just return the encoded chunks.
if hasattr(header, '_chunks'):
return [(_charset._encode(string, str(charset)), str(charset))
for string, charset in header._chunks]
# If no encoding, just return the header with no charset.
if not ecre.search(header):
return [(header, None)]
# First step is to parse all the encoded parts into triplets of the form
# (encoded_string, encoding, charset). For unencoded strings, the last
# two parts will be None.
words = []
for line in header.splitlines():
parts = ecre.split(line)
first = True
while parts:
unencoded = parts.pop(0)
if first:
unencoded = unencoded.lstrip()
first = False
if unencoded:
words.append((unencoded, None, None))
if parts:
charset = parts.pop(0).lower()
encoding = parts.pop(0).lower()
encoded = parts.pop(0)
words.append((encoded, encoding, charset))
# Now loop over words and remove words that consist of whitespace
# between two encoded strings.
import sys
droplist = []
for n, w in enumerate(words):
if n>1 and w[1] and words[n-2][1] and words[n-1][0].isspace():
droplist.append(n-1)
for d in reversed(droplist):
del words[d]
# The next step is to decode each encoded word by applying the reverse
# base64 or quopri transformation. decoded_words is now a list of the
# form (decoded_word, charset).
decoded_words = []
for encoded_string, encoding, charset in words:
if encoding is None:
# This is an unencoded word.
decoded_words.append((encoded_string, charset))
elif encoding == 'q':
word = header_decode(encoded_string)
decoded_words.append((word, charset))
elif encoding == 'b':
paderr = len(encoded_string) % 4 # Postel's law: add missing padding
if paderr:
encoded_string += '==='[:4 - paderr]
try:
word = base64mime.decode(encoded_string)
except binascii.Error:
raise HeaderParseError('Base64 decoding error')
else:
decoded_words.append((word, charset))
else:
raise AssertionError('Unexpected encoding: ' + encoding)
# Now convert all words to bytes and collapse consecutive runs of
# similarly encoded words.
collapsed = []
last_word = last_charset = None
for word, charset in decoded_words:
if isinstance(word, str):
word = bytes(word, 'raw-unicode-escape')
if last_word is None:
last_word = word
last_charset = charset
elif charset != last_charset:
collapsed.append((last_word, last_charset))
last_word = word
last_charset = charset
elif last_charset is None:
last_word += BSPACE + word
else:
last_word += word
collapsed.append((last_word, last_charset))
return collapsed
def make_header(decoded_seq, maxlinelen=None, header_name=None,
continuation_ws=' '):
"""Create a Header from a sequence of pairs as returned by decode_header()
decode_header() takes a header value string and returns a sequence of
pairs of the format (decoded_string, charset) where charset is the string
name of the character set.
This function takes one of those sequence of pairs and returns a Header
instance. Optional maxlinelen, header_name, and continuation_ws are as in
the Header constructor.
"""
h = Header(maxlinelen=maxlinelen, header_name=header_name,
continuation_ws=continuation_ws)
for s, charset in decoded_seq:
# None means us-ascii but we can simply pass it on to h.append()
if charset is not None and not isinstance(charset, Charset):
charset = Charset(charset)
h.append(s, charset)
return h
class Header(object):
def __init__(self, s=None, charset=None,
maxlinelen=None, header_name=None,
continuation_ws=' ', errors='strict'):
"""Create a MIME-compliant header that can contain many character sets.
Optional s is the initial header value. If None, the initial header
value is not set. You can later append to the header with .append()
method calls. s may be a byte string or a Unicode string, but see the
.append() documentation for semantics.
Optional charset serves two purposes: it has the same meaning as the
charset argument to the .append() method. It also sets the default
character set for all subsequent .append() calls that omit the charset
argument. If charset is not provided in the constructor, the us-ascii
charset is used both as s's initial charset and as the default for
subsequent .append() calls.
The maximum line length can be specified explicitly via maxlinelen. For
splitting the first line to a shorter value (to account for the field
header which isn't included in s, e.g. `Subject') pass in the name of
the field in header_name. The default maxlinelen is 78 as recommended
by RFC 2822.
continuation_ws must be RFC 2822 compliant folding whitespace (usually
either a space or a hard tab) which will be prepended to continuation
lines.
errors is passed through to the .append() call.
"""
if charset is None:
charset = USASCII
elif not isinstance(charset, Charset):
charset = Charset(charset)
self._charset = charset
self._continuation_ws = continuation_ws
self._chunks = []
if s is not None:
self.append(s, charset, errors)
if maxlinelen is None:
maxlinelen = MAXLINELEN
self._maxlinelen = maxlinelen
if header_name is None:
self._headerlen = 0
else:
# Take the separating colon and space into account.
self._headerlen = len(header_name) + 2
def __str__(self):
"""Return the string value of the header."""
self._normalize()
uchunks = []
lastcs = None
lastspace = None
for string, charset in self._chunks:
# We must preserve spaces between encoded and non-encoded word
# boundaries, which means for us we need to add a space when we go
# from a charset to None/us-ascii, or from None/us-ascii to a
# charset. Only do this for the second and subsequent chunks.
# Don't add a space if the None/us-ascii string already has
# a space (trailing or leading depending on transition)
nextcs = charset
if nextcs == _charset.UNKNOWN8BIT:
original_bytes = string.encode('ascii', 'surrogateescape')
string = original_bytes.decode('ascii', 'replace')
if uchunks:
hasspace = string and self._nonctext(string[0])
if lastcs not in (None, 'us-ascii'):
if nextcs in (None, 'us-ascii') and not hasspace:
uchunks.append(SPACE)
nextcs = None
elif nextcs not in (None, 'us-ascii') and not lastspace:
uchunks.append(SPACE)
lastspace = string and self._nonctext(string[-1])
lastcs = nextcs
uchunks.append(string)
return EMPTYSTRING.join(uchunks)
# Rich comparison operators for equality only. BAW: does it make sense to
# have or explicitly disable <, <=, >, >= operators?
def __eq__(self, other):
# other may be a Header or a string. Both are fine so coerce
# ourselves to a unicode (of the unencoded header value), swap the
# args and do another comparison.
return other == str(self)
def __ne__(self, other):
return not self == other
def append(self, s, charset=None, errors='strict'):
"""Append a string to the MIME header.
Optional charset, if given, should be a Charset instance or the name
of a character set (which will be converted to a Charset instance). A
value of None (the default) means that the charset given in the
constructor is used.
s may be a byte string or a Unicode string. If it is a byte string
(i.e. isinstance(s, str) is false), then charset is the encoding of
that byte string, and a UnicodeError will be raised if the string
cannot be decoded with that charset. If s is a Unicode string, then
charset is a hint specifying the character set of the characters in
the string. In either case, when producing an RFC 2822 compliant
header using RFC 2047 rules, the string will be encoded using the
output codec of the charset. If the string cannot be encoded to the
output codec, a UnicodeError will be raised.
Optional `errors' is passed as the errors argument to the decode
call if s is a byte string.
"""
if charset is None:
charset = self._charset
elif not isinstance(charset, Charset):
charset = Charset(charset)
if not isinstance(s, str):
input_charset = charset.input_codec or 'us-ascii'
if input_charset == _charset.UNKNOWN8BIT:
s = s.decode('us-ascii', 'surrogateescape')
else:
s = s.decode(input_charset, errors)
# Ensure that the bytes we're storing can be decoded to the output
# character set, otherwise an early error is raised.
output_charset = charset.output_codec or 'us-ascii'
if output_charset != _charset.UNKNOWN8BIT:
try:
s.encode(output_charset, errors)
except UnicodeEncodeError:
if output_charset!='us-ascii':
raise
charset = UTF8
self._chunks.append((s, charset))
def _nonctext(self, s):
"""True if string s is not a ctext character of RFC822.
"""
return s.isspace() or s in ('(', ')', '\\')
def encode(self, splitchars=';, \t', maxlinelen=None, linesep='\n'):
r"""Encode a message header into an RFC-compliant format.
There are many issues involved in converting a given string for use in
an email header. Only certain character sets are readable in most
email clients, and as header strings can only contain a subset of
7-bit ASCII, care must be taken to properly convert and encode (with
Base64 or quoted-printable) header strings. In addition, there is a
75-character length limit on any given encoded header field, so
line-wrapping must be performed, even with double-byte character sets.
Optional maxlinelen specifies the maximum length of each generated
line, exclusive of the linesep string. Individual lines may be longer
than maxlinelen if a folding point cannot be found. The first line
will be shorter by the length of the header name plus ": " if a header
name was specified at Header construction time. The default value for
maxlinelen is determined at header construction time.
Optional splitchars is a string containing characters which should be
given extra weight by the splitting algorithm during normal header
wrapping. This is in very rough support of RFC 2822's `higher level
syntactic breaks': split points preceded by a splitchar are preferred
during line splitting, with the characters preferred in the order in
which they appear in the string. Space and tab may be included in the
string to indicate whether preference should be given to one over the
other as a split point when other split chars do not appear in the line
being split. Splitchars does not affect RFC 2047 encoded lines.
Optional linesep is a string to be used to separate the lines of
the value. The default value is the most useful for typical
Python applications, but it can be set to \r\n to produce RFC-compliant
line separators when needed.
"""
self._normalize()
if maxlinelen is None:
maxlinelen = self._maxlinelen
# A maxlinelen of 0 means don't wrap. For all practical purposes,
# choosing a huge number here accomplishes that and makes the
# _ValueFormatter algorithm much simpler.
if maxlinelen == 0:
maxlinelen = 1000000
formatter = _ValueFormatter(self._headerlen, maxlinelen,
self._continuation_ws, splitchars)
lastcs = None
hasspace = lastspace = None
for string, charset in self._chunks:
if hasspace is not None:
hasspace = string and self._nonctext(string[0])
import sys
if lastcs not in (None, 'us-ascii'):
if not hasspace or charset not in (None, 'us-ascii'):
formatter.add_transition()
elif charset not in (None, 'us-ascii') and not lastspace:
formatter.add_transition()
lastspace = string and self._nonctext(string[-1])
lastcs = charset
hasspace = False
lines = string.splitlines()
if lines:
formatter.feed('', lines[0], charset)
else:
formatter.feed('', '', charset)
for line in lines[1:]:
formatter.newline()
if charset.header_encoding is not None:
formatter.feed(self._continuation_ws, ' ' + line.lstrip(),
charset)
else:
sline = line.lstrip()
fws = line[:len(line)-len(sline)]
formatter.feed(fws, sline, charset)
if len(lines) > 1:
formatter.newline()
if self._chunks:
formatter.add_transition()
value = formatter._str(linesep)
if _embeded_header.search(value):
raise HeaderParseError("header value appears to contain "
"an embedded header: {!r}".format(value))
return value
def _normalize(self):
# Step 1: Normalize the chunks so that all runs of identical charsets
# get collapsed into a single unicode string.
chunks = []
last_charset = None
last_chunk = []
for string, charset in self._chunks:
if charset == last_charset:
last_chunk.append(string)
else:
if last_charset is not None:
chunks.append((SPACE.join(last_chunk), last_charset))
last_chunk = [string]
last_charset = charset
if last_chunk:
chunks.append((SPACE.join(last_chunk), last_charset))
self._chunks = chunks
class _ValueFormatter(object):
def __init__(self, headerlen, maxlen, continuation_ws, splitchars):
self._maxlen = maxlen
self._continuation_ws = continuation_ws
self._continuation_ws_len = len(continuation_ws)
self._splitchars = splitchars
self._lines = []
self._current_line = _Accumulator(headerlen)
def _str(self, linesep):
self.newline()
return linesep.join(self._lines)
def __str__(self):
return self._str(NL)
def newline(self):
end_of_line = self._current_line.pop()
if end_of_line != (' ', ''):
self._current_line.push(*end_of_line)
if len(self._current_line) > 0:
if self._current_line.is_onlyws():
self._lines[-1] += str(self._current_line)
else:
self._lines.append(str(self._current_line))
self._current_line.reset()
def add_transition(self):
self._current_line.push(' ', '')
def feed(self, fws, string, charset):
# If the charset has no header encoding (i.e. it is an ASCII encoding)
# then we must split the header at the "highest level syntactic break"
# possible. Note that we don't have a lot of smarts about field
# syntax; we just try to break on semi-colons, then commas, then
# whitespace. Eventually, this should be pluggable.
if charset.header_encoding is None:
self._ascii_split(fws, string, self._splitchars)
return
# Otherwise, we're doing either a Base64 or a quoted-printable
# encoding which means we don't need to split the line on syntactic
# breaks. We can basically just find enough characters to fit on the
# current line, minus the RFC 2047 chrome. What makes this trickier
# though is that we have to split at octet boundaries, not character
# boundaries but it's only safe to split at character boundaries so at
# best we can only get close.
encoded_lines = charset.header_encode_lines(string, self._maxlengths())
# The first element extends the current line, but if it's None then
# nothing more fit on the current line so start a new line.
try:
first_line = encoded_lines.pop(0)
except IndexError:
# There are no encoded lines, so we're done.
return
if first_line is not None:
self._append_chunk(fws, first_line)
try:
last_line = encoded_lines.pop()
except IndexError:
# There was only one line.
return
self.newline()
self._current_line.push(self._continuation_ws, last_line)
# Everything else are full lines in themselves.
for line in encoded_lines:
self._lines.append(self._continuation_ws + line)
def _maxlengths(self):
# The first line's length.
yield self._maxlen - len(self._current_line)
while True:
yield self._maxlen - self._continuation_ws_len
def _ascii_split(self, fws, string, splitchars):
# The RFC 2822 header folding algorithm is simple in principle but
# complex in practice. Lines may be folded any place where "folding
# white space" appears by inserting a linesep character in front of the
# FWS. The complication is that not all spaces or tabs qualify as FWS,
# and we are also supposed to prefer to break at "higher level
# syntactic breaks". We can't do either of these without intimate
# knowledge of the structure of structured headers, which we don't have
# here. So the best we can do here is prefer to break at the specified
# splitchars, and hope that we don't choose any spaces or tabs that
# aren't legal FWS. (This is at least better than the old algorithm,
# where we would sometimes *introduce* FWS after a splitchar, or the
# algorithm before that, where we would turn all white space runs into
# single spaces or tabs.)
parts = re.split("(["+FWS+"]+)", fws+string)
if parts[0]:
parts[:0] = ['']
else:
parts.pop(0)
for fws, part in zip(*[iter(parts)]*2):
self._append_chunk(fws, part)
def _append_chunk(self, fws, string):
self._current_line.push(fws, string)
if len(self._current_line) > self._maxlen:
# Find the best split point, working backward from the end.
# There might be none, on a long first line.
for ch in self._splitchars:
for i in range(self._current_line.part_count()-1, 0, -1):
if ch.isspace():
fws = self._current_line[i][0]
if fws and fws[0]==ch:
break
prevpart = self._current_line[i-1][1]
if prevpart and prevpart[-1]==ch:
break
else:
continue
break
else:
fws, part = self._current_line.pop()
if self._current_line._initial_size > 0:
# There will be a header, so leave it on a line by itself.
self.newline()
if not fws:
# We don't use continuation_ws here because the whitespace
# after a header should always be a space.
fws = ' '
self._current_line.push(fws, part)
return
remainder = self._current_line.pop_from(i)
self._lines.append(str(self._current_line))
self._current_line.reset(remainder)
class _Accumulator(list):
def __init__(self, initial_size=0):
self._initial_size = initial_size
super().__init__()
def push(self, fws, string):
self.append((fws, string))
def pop_from(self, i=0):
popped = self[i:]
self[i:] = []
return popped
def pop(self):
if self.part_count()==0:
return ('', '')
return super().pop()
def __len__(self):
return sum((len(fws)+len(part) for fws, part in self),
self._initial_size)
def __str__(self):
return EMPTYSTRING.join((EMPTYSTRING.join((fws, part))
for fws, part in self))
def reset(self, startval=None):
if startval is None:
startval = []
self[:] = startval
self._initial_size = 0
def is_onlyws(self):
return self._initial_size==0 and (not self or str(self).isspace())
def part_count(self):
return super().__len__()
PK �Du\��Ա � $ future/backports/email/base64mime.pynu �[��� # Copyright (C) 2002-2007 Python Software Foundation
# Author: Ben Gertzfield
# Contact: email-sig@python.org
"""Base64 content transfer encoding per RFCs 2045-2047.
This module handles the content transfer encoding method defined in RFC 2045
to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit
characters encoding known as Base64.
It is used in the MIME standards for email to attach images, audio, and text
using some 8-bit character sets to messages.
This module provides an interface to encode and decode both headers and bodies
with Base64 encoding.
RFC 2045 defines a method for including character set information in an
`encoded-word' in a header. This method is commonly used for 8-bit real names
in To:, From:, Cc:, etc. fields, as well as Subject: lines.
This module does not do the line wrapping or end-of-line character conversion
necessary for proper internationalized headers; it only does dumb encoding and
decoding. To deal with the various line wrapping issues, use the email.header
module.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import range
from future.builtins import bytes
from future.builtins import str
__all__ = [
'body_decode',
'body_encode',
'decode',
'decodestring',
'header_encode',
'header_length',
]
from base64 import b64encode
from binascii import b2a_base64, a2b_base64
CRLF = '\r\n'
NL = '\n'
EMPTYSTRING = ''
# See also Charset.py
MISC_LEN = 7
# Helpers
def header_length(bytearray):
"""Return the length of s when it is encoded with base64."""
groups_of_3, leftover = divmod(len(bytearray), 3)
# 4 bytes out for each 3 bytes (or nonzero fraction thereof) in.
n = groups_of_3 * 4
if leftover:
n += 4
return n
def header_encode(header_bytes, charset='iso-8859-1'):
"""Encode a single header line with Base64 encoding in a given charset.
charset names the character set to use to encode the header. It defaults
to iso-8859-1. Base64 encoding is defined in RFC 2045.
"""
if not header_bytes:
return ""
if isinstance(header_bytes, str):
header_bytes = header_bytes.encode(charset)
encoded = b64encode(header_bytes).decode("ascii")
return '=?%s?b?%s?=' % (charset, encoded)
def body_encode(s, maxlinelen=76, eol=NL):
r"""Encode a string with base64.
Each line will be wrapped at, at most, maxlinelen characters (defaults to
76 characters).
Each line of encoded text will end with eol, which defaults to "\n". Set
this to "\r\n" if you will be using the result of this function directly
in an email.
"""
if not s:
return s
encvec = []
max_unencoded = maxlinelen * 3 // 4
for i in range(0, len(s), max_unencoded):
# BAW: should encode() inherit b2a_base64()'s dubious behavior in
# adding a newline to the encoded string?
enc = b2a_base64(s[i:i + max_unencoded]).decode("ascii")
if enc.endswith(NL) and eol != NL:
enc = enc[:-1] + eol
encvec.append(enc)
return EMPTYSTRING.join(encvec)
def decode(string):
"""Decode a raw base64 string, returning a bytes object.
This function does not parse a full MIME header value encoded with
base64 (like =?iso-8895-1?b?bmloISBuaWgh?=) -- please use the high
level email.header class for that functionality.
"""
if not string:
return bytes()
elif isinstance(string, str):
return a2b_base64(string.encode('raw-unicode-escape'))
else:
return a2b_base64(string)
# For convenience and backwards compatibility w/ standard base64 module
body_decode = decode
decodestring = decode
PK �Du\6ޜ�@ @ + future/backports/email/mime/nonmultipart.pynu �[��� # Copyright (C) 2002-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Base class for MIME type messages that are not multipart."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMENonMultipart']
from future.backports.email import errors
from future.backports.email.mime.base import MIMEBase
class MIMENonMultipart(MIMEBase):
"""Base class for MIME multipart/* type messages."""
def attach(self, payload):
# The public API prohibits attaching multiple subparts to MIMEBase
# derived subtypes since none of them are, by definition, of content
# type multipart/*
raise errors.MultipartConversionError(
'Cannot attach additional subparts to non-multipart/*')
PK �Du\ ' future/backports/email/mime/__init__.pynu �[��� PK �Du\ԁy y * future/backports/email/mime/application.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Keith Dart
# Contact: email-sig@python.org
"""Class representing application/* type MIME documents."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.backports.email import encoders
from future.backports.email.mime.nonmultipart import MIMENonMultipart
__all__ = ["MIMEApplication"]
class MIMEApplication(MIMENonMultipart):
"""Class for generating application/* MIME documents."""
def __init__(self, _data, _subtype='octet-stream',
_encoder=encoders.encode_base64, **_params):
"""Create an application/* type MIME document.
_data is a string containing the raw application data.
_subtype is the MIME content type subtype, defaulting to
'octet-stream'.
_encoder is a function which will perform the actual encoding for
transport of the application data, defaulting to base64 encoding.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
"""
if _subtype is None:
raise TypeError('Invalid application MIME subtype')
MIMENonMultipart.__init__(self, 'application', _subtype, **_params)
self.set_payload(_data)
_encoder(self)
PK �Du\� �?�
�
< future/backports/email/mime/__pycache__/audio.cpython-39.pycnu �[��� a
��?h�
� @ s� d Z ddlmZ ddlmZ ddlmZ dgZddlZddlmZ ddl m
Z
dd l m Z d
d d d d
�Z
dd� ZG dd� de �ZdS )z/Class representing audio/* type MIME documents.� )�unicode_literals)�division)�absolute_import� MIMEAudioN)�BytesIO)�encoders)�MIMENonMultipart�basiczx-wavzx-aiff)�auZwavZaiffZaifcc C sH | dd� }t |�}tjD ](}|||�}|durt�|d � S qdS )a Try to identify a sound file type.
sndhdr.what() has a pretty cruddy interface, unfortunately. This is why
we re-do it here. It would be easier to reverse engineer the Unix 'file'
command and use the standard 'magic' file, as shipped with a modern Unix.
Ni r )r �sndhdr�tests�_sndhdr_MIMEmap�get)�data�hdrZfakefileZtestfn�res� r �K/usr/local/lib/python3.9/site-packages/future/backports/email/mime/audio.py�_whatsnd s
r c @ s e Zd ZdZdejfdd�ZdS )r z,Class for generating audio/* MIME documents.Nc K sL |du rt |�}|du r td��tj| d|fi |�� | �|� || � dS )a Create an audio/* type MIME document.
_audiodata is a string containing the raw audio data. If this data
can be decoded by the standard Python `sndhdr' module, then the
subtype will be automatically included in the Content-Type header.
Otherwise, you can specify the specific audio subtype via the
_subtype parameter. If _subtype is not given, and no subtype can be
guessed, a TypeError is raised.
_encoder is a function which will perform the actual encoding for
transport of the image data. It takes one argument, which is this
Image instance. It should use get_payload() and set_payload() to
change the payload to the encoded form. It should also add any
Content-Transfer-Encoding or other headers to the message as
necessary. The default encoding is Base64.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
Nz!Could not find audio MIME subtype�audio)r � TypeErrorr �__init__� set_payload)�selfZ
_audiodata�_subtype�_encoder�_paramsr r r r . s
zMIMEAudio.__init__)�__name__�
__module__� __qualname__�__doc__r �
encode_base64r r r r r r + s �)r �
__future__r r r �__all__r �ior Zfuture.backports.emailr Z(future.backports.email.mime.nonmultipartr r
r r r r r r �<module> s �PK �Du\��a;� � ? future/backports/email/mime/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �N/usr/local/lib/python3.9/site-packages/future/backports/email/mime/__init__.py�<module> � PK �Du\��~j j @ future/backports/email/mime/__pycache__/multipart.cpython-39.pycnu �[��� a
��?h� � @ sN d Z ddlmZ ddlmZ ddlmZ dgZddlmZ G dd� de�ZdS ) �.Base class for MIME multipart/* type messages.� )�unicode_literals)�division)�absolute_import�
MIMEMultipart)�MIMEBasec @ s e Zd ZdZddd�ZdS )r r �mixedNc K sF t j| d|fi |�� g | _|r4|D ]}| �|� q$|rB| �|� dS )a� Creates a multipart/* type message.
By default, creates a multipart/mixed message, with proper
Content-Type and MIME-Version headers.
_subtype is the subtype of the multipart content type, defaulting to
`mixed'.
boundary is the multipart boundary string. By default it is
calculated as needed.
_subparts is a sequence of initial subparts for the payload. It
must be an iterable object, such as a list. You can always
attach new subparts to the message by using the attach() method.
Additional parameters for the Content-Type header are taken from the
keyword arguments (or passed into the _params argument).
� multipartN)r �__init__�_payload�attach� set_boundary)�self�_subtype�boundaryZ _subparts�_params�p� r �O/usr/local/lib/python3.9/site-packages/future/backports/email/mime/multipart.pyr
s zMIMEMultipart.__init__)r NN)�__name__�
__module__� __qualname__�__doc__r
r r r r r s N) r �
__future__r r r �__all__Z future.backports.email.mime.baser r r r r r �<module> s PK �Du\�d�L L B future/backports/email/mime/__pycache__/application.cpython-39.pycnu �[��� a
��?hy � @ sZ d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dgZ G dd� de�Z
d S )
z5Class representing application/* type MIME documents.� )�unicode_literals)�division)�absolute_import)�encoders)�MIMENonMultipart�MIMEApplicationc @ s e Zd ZdZdejfdd�ZdS )r z2Class for generating application/* MIME documents.z octet-streamc K s< |du rt d��tj| d|fi |�� | �|� || � dS )a Create an application/* type MIME document.
_data is a string containing the raw application data.
_subtype is the MIME content type subtype, defaulting to
'octet-stream'.
_encoder is a function which will perform the actual encoding for
transport of the application data, defaulting to base64 encoding.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
Nz Invalid application MIME subtypeZ application)� TypeErrorr �__init__� set_payload)�self�_data�_subtype�_encoder�_params� r �Q/usr/local/lib/python3.9/site-packages/future/backports/email/mime/application.pyr s
zMIMEApplication.__init__N)�__name__�
__module__� __qualname__�__doc__r �
encode_base64r r r r r r s �N) r �
__future__r r r Zfuture.backports.emailr Z(future.backports.email.mime.nonmultipartr �__all__r r r r r �<module> s PK �Du\�X�M M ; future/backports/email/mime/__pycache__/base.cpython-39.pycnu �[��� a
��?hk � @ s@ d Z ddlmZmZmZ ddlmZ dgZG dd� dej�Z dS )�$Base class for MIME specializations.� )�absolute_import�division�unicode_literals)�message�MIMEBasec @ s e Zd ZdZdd� ZdS )r r c K s8 t j�| � d||f }| jd|fi |�� d| d< dS )z�This constructor adds a Content-Type: and a MIME-Version: header.
The Content-Type: header is taken from the _maintype and _subtype
arguments. Additional parameters for this header are taken from the
keyword arguments.
z%s/%sz Content-Typez1.0z MIME-VersionN)r �Message�__init__�
add_header)�selfZ _maintype�_subtype�_params�ctype� r �J/usr/local/lib/python3.9/site-packages/future/backports/email/mime/base.pyr s zMIMEBase.__init__N)�__name__�
__module__� __qualname__�__doc__r r r r r r s N)
r �
__future__r r r Zfuture.backports.emailr �__all__r r r r r r �<module> s PK �Du\^th� � C future/backports/email/mime/__pycache__/nonmultipart.cpython-39.pycnu �[��� a
��?h@ � @ sZ d Z ddlmZ ddlmZ ddlmZ dgZddlmZ ddlm Z G dd� de �Z
d S )
z9Base class for MIME type messages that are not multipart.� )�unicode_literals)�division)�absolute_import�MIMENonMultipart)�errors)�MIMEBasec @ s e Zd ZdZdd� ZdS )r z.Base class for MIME multipart/* type messages.c C s t �d��d S )Nz4Cannot attach additional subparts to non-multipart/*)r �MultipartConversionError)�self�payload� r �R/usr/local/lib/python3.9/site-packages/future/backports/email/mime/nonmultipart.py�attach s �zMIMENonMultipart.attachN)�__name__�
__module__� __qualname__�__doc__r
r r r r r s N) r �
__future__r r r �__all__Zfuture.backports.emailr Z future.backports.email.mime.baser r r r r r �<module> s PK �Du\��q � � > future/backports/email/mime/__pycache__/message.cpython-39.pycnu �[��� a
��?h� � @ sZ d Z ddlmZ ddlmZ ddlmZ dgZddlmZ ddlm Z G dd� de �Z
d S )
�,Class representing message/* MIME documents.� )�unicode_literals)�division)�absolute_import� MIMEMessage)�message)�MIMENonMultipartc @ s e Zd ZdZddd�ZdS )r r �rfc822c C s> t �| d|� t|tj�s"td��tj�| |� | �d� dS )a� Create a message/* type MIME document.
_msg is a message object and must be an instance of Message, or a
derived class of Message, otherwise a TypeError is raised.
Optional _subtype defines the subtype of the contained message. The
default is "rfc822" (this is defined by the MIME standard, even though
the term "rfc822" is technically outdated by RFC 2822).
r z&Argument is not an instance of Messagezmessage/rfc822N)r �__init__�
isinstancer �Message� TypeError�attach�set_default_type)�self�_msg�_subtype� r �M/usr/local/lib/python3.9/site-packages/future/backports/email/mime/message.pyr
s
zMIMEMessage.__init__N)r )�__name__�
__module__� __qualname__�__doc__r
r r r r r s N) r �
__future__r r r �__all__Zfuture.backports.emailr Z(future.backports.email.mime.nonmultipartr r r r r r �<module> s PK �Du\,��� < future/backports/email/mime/__pycache__/image.cpython-39.pycnu �[��� a
��?hs � @ sb d Z ddlmZ ddlmZ ddlmZ dgZddlZddlmZ ddl m
Z
G d d� de
�Z dS )
z/Class representing image/* type MIME documents.� )�unicode_literals)�division)�absolute_import� MIMEImageN)�encoders)�MIMENonMultipartc @ s e Zd ZdZdejfdd�ZdS )r z1Class for generating image/* type MIME documents.Nc K sP |du rt �d|�}|du r$td��tj| d|fi |�� | �|� || � dS )a� Create an image/* type MIME document.
_imagedata is a string containing the raw image data. If this data
can be decoded by the standard Python `imghdr' module, then the
subtype will be automatically included in the Content-Type header.
Otherwise, you can specify the specific image subtype via the _subtype
parameter.
_encoder is a function which will perform the actual encoding for
transport of the image data. It takes one argument, which is this
Image instance. It should use get_payload() and set_payload() to
change the payload to the encoded form. It should also add any
Content-Transfer-Encoding or other headers to the message as
necessary. The default encoding is Base64.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
Nz"Could not guess image MIME subtype�image)�imghdr�what� TypeErrorr �__init__� set_payload)�selfZ
_imagedata�_subtype�_encoder�_params� r �K/usr/local/lib/python3.9/site-packages/future/backports/email/mime/image.pyr s
zMIMEImage.__init__)�__name__�
__module__� __qualname__�__doc__r �
encode_base64r r r r r r s �) r �
__future__r r r �__all__r Zfuture.backports.emailr Z(future.backports.email.mime.nonmultipartr r r r r r �<module> s PK �Du\�[��� � ; future/backports/email/mime/__pycache__/text.cpython-39.pycnu �[��� a
��?h � @ sZ d Z ddlmZ ddlmZ ddlmZ dgZddlmZ ddlm Z G dd� de �Z
d S )
z.Class representing text/* type MIME documents.� )�unicode_literals)�division)�absolute_import�MIMEText)�encode_7or8bit)�MIMENonMultipartc @ s e Zd ZdZddd�ZdS )r z0Class for generating text/* type MIME documents.�plainNc C s\ |du r2z|� d� d}W n ty0 d}Y n0 tj| d|fi d|i�� | �||� dS )a~ Create a text/* type MIME document.
_text is the string for this message object.
_subtype is the MIME sub content type, defaulting to "plain".
_charset is the character set parameter added to the Content-Type
header. This defaults to "us-ascii". Note that as a side-effect, the
Content-Transfer-Encoding header will also be set.
Nzus-asciizutf-8�text�charset)�encode�UnicodeEncodeErrorr �__init__� set_payload)�selfZ_text�_subtype�_charset� r �J/usr/local/lib/python3.9/site-packages/future/backports/email/mime/text.pyr
s
�zMIMEText.__init__)r N)�__name__�
__module__� __qualname__�__doc__r
r r r r r s N) r �
__future__r r r �__all__Z future.backports.email.encodersr Z(future.backports.email.mime.nonmultipartr r r r r r �<module> s PK �Du\v�� # future/backports/email/mime/text.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Class representing text/* type MIME documents."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMEText']
from future.backports.email.encoders import encode_7or8bit
from future.backports.email.mime.nonmultipart import MIMENonMultipart
class MIMEText(MIMENonMultipart):
"""Class for generating text/* type MIME documents."""
def __init__(self, _text, _subtype='plain', _charset=None):
"""Create a text/* type MIME document.
_text is the string for this message object.
_subtype is the MIME sub content type, defaulting to "plain".
_charset is the character set parameter added to the Content-Type
header. This defaults to "us-ascii". Note that as a side-effect, the
Content-Transfer-Encoding header will also be set.
"""
# If no _charset was specified, check to see if there are non-ascii
# characters present. If not, use 'us-ascii', otherwise use utf-8.
# XXX: This can be removed once #7304 is fixed.
if _charset is None:
try:
_text.encode('us-ascii')
_charset = 'us-ascii'
except UnicodeEncodeError:
_charset = 'utf-8'
MIMENonMultipart.__init__(self, 'text', _subtype,
**{'charset': _charset})
self.set_payload(_text, _charset)
PK �Du\R�t� � ( future/backports/email/mime/multipart.pynu �[��� # Copyright (C) 2002-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Base class for MIME multipart/* type messages."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMEMultipart']
from future.backports.email.mime.base import MIMEBase
class MIMEMultipart(MIMEBase):
"""Base class for MIME multipart/* type messages."""
def __init__(self, _subtype='mixed', boundary=None, _subparts=None,
**_params):
"""Creates a multipart/* type message.
By default, creates a multipart/mixed message, with proper
Content-Type and MIME-Version headers.
_subtype is the subtype of the multipart content type, defaulting to
`mixed'.
boundary is the multipart boundary string. By default it is
calculated as needed.
_subparts is a sequence of initial subparts for the payload. It
must be an iterable object, such as a list. You can always
attach new subparts to the message by using the attach() method.
Additional parameters for the Content-Type header are taken from the
keyword arguments (or passed into the _params argument).
"""
MIMEBase.__init__(self, 'multipart', _subtype, **_params)
# Initialise _payload to an empty list as the Message superclass's
# implementation of is_multipart assumes that _payload is a list for
# multipart messages.
self._payload = []
if _subparts:
for p in _subparts:
self.attach(p)
if boundary:
self.set_boundary(boundary)
PK �Du\�� ֕ � & future/backports/email/mime/message.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Class representing message/* MIME documents."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMEMessage']
from future.backports.email import message
from future.backports.email.mime.nonmultipart import MIMENonMultipart
class MIMEMessage(MIMENonMultipart):
"""Class representing message/* MIME documents."""
def __init__(self, _msg, _subtype='rfc822'):
"""Create a message/* type MIME document.
_msg is a message object and must be an instance of Message, or a
derived class of Message, otherwise a TypeError is raised.
Optional _subtype defines the subtype of the contained message. The
default is "rfc822" (this is defined by the MIME standard, even though
the term "rfc822" is technically outdated by RFC 2822).
"""
MIMENonMultipart.__init__(self, 'message', _subtype)
if not isinstance(_msg, message.Message):
raise TypeError('Argument is not an instance of Message')
# It's convenient to use this base class method. We need to do it
# this way or we'll get an exception
message.Message.attach(self, _msg)
# And be sure our default type is set correctly
self.set_default_type('message/rfc822')
PK �Du\�s ��
�
$ future/backports/email/mime/audio.pynu �[��� # Copyright (C) 2001-2007 Python Software Foundation
# Author: Anthony Baxter
# Contact: email-sig@python.org
"""Class representing audio/* type MIME documents."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMEAudio']
import sndhdr
from io import BytesIO
from future.backports.email import encoders
from future.backports.email.mime.nonmultipart import MIMENonMultipart
_sndhdr_MIMEmap = {'au' : 'basic',
'wav' :'x-wav',
'aiff':'x-aiff',
'aifc':'x-aiff',
}
# There are others in sndhdr that don't have MIME types. :(
# Additional ones to be added to sndhdr? midi, mp3, realaudio, wma??
def _whatsnd(data):
"""Try to identify a sound file type.
sndhdr.what() has a pretty cruddy interface, unfortunately. This is why
we re-do it here. It would be easier to reverse engineer the Unix 'file'
command and use the standard 'magic' file, as shipped with a modern Unix.
"""
hdr = data[:512]
fakefile = BytesIO(hdr)
for testfn in sndhdr.tests:
res = testfn(hdr, fakefile)
if res is not None:
return _sndhdr_MIMEmap.get(res[0])
return None
class MIMEAudio(MIMENonMultipart):
"""Class for generating audio/* MIME documents."""
def __init__(self, _audiodata, _subtype=None,
_encoder=encoders.encode_base64, **_params):
"""Create an audio/* type MIME document.
_audiodata is a string containing the raw audio data. If this data
can be decoded by the standard Python `sndhdr' module, then the
subtype will be automatically included in the Content-Type header.
Otherwise, you can specify the specific audio subtype via the
_subtype parameter. If _subtype is not given, and no subtype can be
guessed, a TypeError is raised.
_encoder is a function which will perform the actual encoding for
transport of the image data. It takes one argument, which is this
Image instance. It should use get_payload() and set_payload() to
change the payload to the encoded form. It should also add any
Content-Transfer-Encoding or other headers to the message as
necessary. The default encoding is Base64.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
"""
if _subtype is None:
_subtype = _whatsnd(_audiodata)
if _subtype is None:
raise TypeError('Could not find audio MIME subtype')
MIMENonMultipart.__init__(self, 'audio', _subtype, **_params)
self.set_payload(_audiodata)
_encoder(self)
PK �Du\�G�k k # future/backports/email/mime/base.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Base class for MIME specializations."""
from __future__ import absolute_import, division, unicode_literals
from future.backports.email import message
__all__ = ['MIMEBase']
class MIMEBase(message.Message):
"""Base class for MIME specializations."""
def __init__(self, _maintype, _subtype, **_params):
"""This constructor adds a Content-Type: and a MIME-Version: header.
The Content-Type: header is taken from the _maintype and _subtype
arguments. Additional parameters for this header are taken from the
keyword arguments.
"""
message.Message.__init__(self)
ctype = '%s/%s' % (_maintype, _subtype)
self.add_header('Content-Type', ctype, **_params)
self['MIME-Version'] = '1.0'
PK �Du\�6�s s $ future/backports/email/mime/image.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Class representing image/* type MIME documents."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
__all__ = ['MIMEImage']
import imghdr
from future.backports.email import encoders
from future.backports.email.mime.nonmultipart import MIMENonMultipart
class MIMEImage(MIMENonMultipart):
"""Class for generating image/* type MIME documents."""
def __init__(self, _imagedata, _subtype=None,
_encoder=encoders.encode_base64, **_params):
"""Create an image/* type MIME document.
_imagedata is a string containing the raw image data. If this data
can be decoded by the standard Python `imghdr' module, then the
subtype will be automatically included in the Content-Type header.
Otherwise, you can specify the specific image subtype via the _subtype
parameter.
_encoder is a function which will perform the actual encoding for
transport of the image data. It takes one argument, which is this
Image instance. It should use get_payload() and set_payload() to
change the payload to the encoded form. It should also add any
Content-Transfer-Encoding or other headers to the message as
necessary. The default encoding is Base64.
Any additional keyword arguments are passed to the base class
constructor, which turns them into parameters on the Content-Type
header.
"""
if _subtype is None:
_subtype = imghdr.what(None, _imagedata)
if _subtype is None:
raise TypeError('Could not guess image MIME subtype')
MIMENonMultipart.__init__(self, 'image', _subtype, **_params)
self.set_payload(_imagedata)
_encoder(self)
PK �Du\��d��� �� ! future/backports/email/message.pynu �[��� # -*- coding: utf-8 -*-
# Copyright (C) 2001-2007 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Basic message object for the email package object model."""
from __future__ import absolute_import, division, unicode_literals
from future.builtins import list, range, str, zip
__all__ = ['Message']
import re
import uu
import base64
import binascii
from io import BytesIO, StringIO
# Intrapackage imports
from future.utils import as_native_str
from future.backports.email import utils
from future.backports.email import errors
from future.backports.email._policybase import compat32
from future.backports.email import charset as _charset
from future.backports.email._encoded_words import decode_b
Charset = _charset.Charset
SEMISPACE = '; '
# Regular expression that matches `special' characters in parameters, the
# existence of which force quoting of the parameter value.
tspecials = re.compile(r'[ \(\)<>@,;:\\"/\[\]\?=]')
def _splitparam(param):
# Split header parameters. BAW: this may be too simple. It isn't
# strictly RFC 2045 (section 5.1) compliant, but it catches most headers
# found in the wild. We may eventually need a full fledged parser.
# RDM: we might have a Header here; for now just stringify it.
a, sep, b = str(param).partition(';')
if not sep:
return a.strip(), None
return a.strip(), b.strip()
def _formatparam(param, value=None, quote=True):
"""Convenience function to format and return a key=value pair.
This will quote the value if needed or if quote is true. If value is a
three tuple (charset, language, value), it will be encoded according
to RFC2231 rules. If it contains non-ascii characters it will likewise
be encoded according to RFC2231 rules, using the utf-8 charset and
a null language.
"""
if value is not None and len(value) > 0:
# A tuple is used for RFC 2231 encoded parameter values where items
# are (charset, language, value). charset is a string, not a Charset
# instance. RFC 2231 encoded values are never quoted, per RFC.
if isinstance(value, tuple):
# Encode as per RFC 2231
param += '*'
value = utils.encode_rfc2231(value[2], value[0], value[1])
return '%s=%s' % (param, value)
else:
try:
value.encode('ascii')
except UnicodeEncodeError:
param += '*'
value = utils.encode_rfc2231(value, 'utf-8', '')
return '%s=%s' % (param, value)
# BAW: Please check this. I think that if quote is set it should
# force quoting even if not necessary.
if quote or tspecials.search(value):
return '%s="%s"' % (param, utils.quote(value))
else:
return '%s=%s' % (param, value)
else:
return param
def _parseparam(s):
# RDM This might be a Header, so for now stringify it.
s = ';' + str(s)
plist = []
while s[:1] == ';':
s = s[1:]
end = s.find(';')
while end > 0 and (s.count('"', 0, end) - s.count('\\"', 0, end)) % 2:
end = s.find(';', end + 1)
if end < 0:
end = len(s)
f = s[:end]
if '=' in f:
i = f.index('=')
f = f[:i].strip().lower() + '=' + f[i+1:].strip()
plist.append(f.strip())
s = s[end:]
return plist
def _unquotevalue(value):
# This is different than utils.collapse_rfc2231_value() because it doesn't
# try to convert the value to a unicode. Message.get_param() and
# Message.get_params() are both currently defined to return the tuple in
# the face of RFC 2231 parameters.
if isinstance(value, tuple):
return value[0], value[1], utils.unquote(value[2])
else:
return utils.unquote(value)
class Message(object):
"""Basic message object.
A message object is defined as something that has a bunch of RFC 2822
headers and a payload. It may optionally have an envelope header
(a.k.a. Unix-From or From_ header). If the message is a container (i.e. a
multipart or a message/rfc822), then the payload is a list of Message
objects, otherwise it is a string.
Message objects implement part of the `mapping' interface, which assumes
there is exactly one occurrence of the header per message. Some headers
do in fact appear multiple times (e.g. Received) and for those headers,
you must use the explicit API to set or get all the headers. Not all of
the mapping methods are implemented.
"""
def __init__(self, policy=compat32):
self.policy = policy
self._headers = list()
self._unixfrom = None
self._payload = None
self._charset = None
# Defaults for multipart messages
self.preamble = self.epilogue = None
self.defects = []
# Default content type
self._default_type = 'text/plain'
@as_native_str(encoding='utf-8')
def __str__(self):
"""Return the entire formatted message as a string.
This includes the headers, body, and envelope header.
"""
return self.as_string()
def as_string(self, unixfrom=False, maxheaderlen=0):
"""Return the entire formatted message as a (unicode) string.
Optional `unixfrom' when True, means include the Unix From_ envelope
header.
This is a convenience method and may not generate the message exactly
as you intend. For more flexibility, use the flatten() method of a
Generator instance.
"""
from future.backports.email.generator import Generator
fp = StringIO()
g = Generator(fp, mangle_from_=False, maxheaderlen=maxheaderlen)
g.flatten(self, unixfrom=unixfrom)
return fp.getvalue()
def is_multipart(self):
"""Return True if the message consists of multiple parts."""
return isinstance(self._payload, list)
#
# Unix From_ line
#
def set_unixfrom(self, unixfrom):
self._unixfrom = unixfrom
def get_unixfrom(self):
return self._unixfrom
#
# Payload manipulation.
#
def attach(self, payload):
"""Add the given payload to the current payload.
The current payload will always be a list of objects after this method
is called. If you want to set the payload to a scalar object, use
set_payload() instead.
"""
if self._payload is None:
self._payload = [payload]
else:
self._payload.append(payload)
def get_payload(self, i=None, decode=False):
"""Return a reference to the payload.
The payload will either be a list object or a string. If you mutate
the list object, you modify the message's payload in place. Optional
i returns that index into the payload.
Optional decode is a flag indicating whether the payload should be
decoded or not, according to the Content-Transfer-Encoding header
(default is False).
When True and the message is not a multipart, the payload will be
decoded if this header's value is `quoted-printable' or `base64'. If
some other encoding is used, or the header is missing, or if the
payload has bogus data (i.e. bogus base64 or uuencoded data), the
payload is returned as-is.
If the message is a multipart and the decode flag is True, then None
is returned.
"""
# Here is the logic table for this code, based on the email5.0.0 code:
# i decode is_multipart result
# ------ ------ ------------ ------------------------------
# None True True None
# i True True None
# None False True _payload (a list)
# i False True _payload element i (a Message)
# i False False error (not a list)
# i True False error (not a list)
# None False False _payload
# None True False _payload decoded (bytes)
# Note that Barry planned to factor out the 'decode' case, but that
# isn't so easy now that we handle the 8 bit data, which needs to be
# converted in both the decode and non-decode path.
if self.is_multipart():
if decode:
return None
if i is None:
return self._payload
else:
return self._payload[i]
# For backward compatibility, Use isinstance and this error message
# instead of the more logical is_multipart test.
if i is not None and not isinstance(self._payload, list):
raise TypeError('Expected list, got %s' % type(self._payload))
payload = self._payload
# cte might be a Header, so for now stringify it.
cte = str(self.get('content-transfer-encoding', '')).lower()
# payload may be bytes here.
if isinstance(payload, str):
payload = str(payload) # for Python-Future, so surrogateescape works
if utils._has_surrogates(payload):
bpayload = payload.encode('ascii', 'surrogateescape')
if not decode:
try:
payload = bpayload.decode(self.get_param('charset', 'ascii'), 'replace')
except LookupError:
payload = bpayload.decode('ascii', 'replace')
elif decode:
try:
bpayload = payload.encode('ascii')
except UnicodeError:
# This won't happen for RFC compliant messages (messages
# containing only ASCII codepoints in the unicode input).
# If it does happen, turn the string into bytes in a way
# guaranteed not to fail.
bpayload = payload.encode('raw-unicode-escape')
if not decode:
return payload
if cte == 'quoted-printable':
return utils._qdecode(bpayload)
elif cte == 'base64':
# XXX: this is a bit of a hack; decode_b should probably be factored
# out somewhere, but I haven't figured out where yet.
value, defects = decode_b(b''.join(bpayload.splitlines()))
for defect in defects:
self.policy.handle_defect(self, defect)
return value
elif cte in ('x-uuencode', 'uuencode', 'uue', 'x-uue'):
in_file = BytesIO(bpayload)
out_file = BytesIO()
try:
uu.decode(in_file, out_file, quiet=True)
return out_file.getvalue()
except uu.Error:
# Some decoding problem
return bpayload
if isinstance(payload, str):
return bpayload
return payload
def set_payload(self, payload, charset=None):
"""Set the payload to the given value.
Optional charset sets the message's default character set. See
set_charset() for details.
"""
self._payload = payload
if charset is not None:
self.set_charset(charset)
def set_charset(self, charset):
"""Set the charset of the payload to a given character set.
charset can be a Charset instance, a string naming a character set, or
None. If it is a string it will be converted to a Charset instance.
If charset is None, the charset parameter will be removed from the
Content-Type field. Anything else will generate a TypeError.
The message will be assumed to be of type text/* encoded with
charset.input_charset. It will be converted to charset.output_charset
and encoded properly, if needed, when generating the plain text
representation of the message. MIME headers (MIME-Version,
Content-Type, Content-Transfer-Encoding) will be added as needed.
"""
if charset is None:
self.del_param('charset')
self._charset = None
return
if not isinstance(charset, Charset):
charset = Charset(charset)
self._charset = charset
if 'MIME-Version' not in self:
self.add_header('MIME-Version', '1.0')
if 'Content-Type' not in self:
self.add_header('Content-Type', 'text/plain',
charset=charset.get_output_charset())
else:
self.set_param('charset', charset.get_output_charset())
if charset != charset.get_output_charset():
self._payload = charset.body_encode(self._payload)
if 'Content-Transfer-Encoding' not in self:
cte = charset.get_body_encoding()
try:
cte(self)
except TypeError:
self._payload = charset.body_encode(self._payload)
self.add_header('Content-Transfer-Encoding', cte)
def get_charset(self):
"""Return the Charset instance associated with the message's payload.
"""
return self._charset
#
# MAPPING INTERFACE (partial)
#
def __len__(self):
"""Return the total number of headers, including duplicates."""
return len(self._headers)
def __getitem__(self, name):
"""Get a header value.
Return None if the header is missing instead of raising an exception.
Note that if the header appeared multiple times, exactly which
occurrence gets returned is undefined. Use get_all() to get all
the values matching a header field name.
"""
return self.get(name)
def __setitem__(self, name, val):
"""Set the value of a header.
Note: this does not overwrite an existing header with the same field
name. Use __delitem__() first to delete any existing headers.
"""
max_count = self.policy.header_max_count(name)
if max_count:
lname = name.lower()
found = 0
for k, v in self._headers:
if k.lower() == lname:
found += 1
if found >= max_count:
raise ValueError("There may be at most {} {} headers "
"in a message".format(max_count, name))
self._headers.append(self.policy.header_store_parse(name, val))
def __delitem__(self, name):
"""Delete all occurrences of a header, if present.
Does not raise an exception if the header is missing.
"""
name = name.lower()
newheaders = list()
for k, v in self._headers:
if k.lower() != name:
newheaders.append((k, v))
self._headers = newheaders
def __contains__(self, name):
return name.lower() in [k.lower() for k, v in self._headers]
def __iter__(self):
for field, value in self._headers:
yield field
def keys(self):
"""Return a list of all the message's header field names.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
"""
return [k for k, v in self._headers]
def values(self):
"""Return a list of all the message's header values.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
"""
return [self.policy.header_fetch_parse(k, v)
for k, v in self._headers]
def items(self):
"""Get all the message's header fields and values.
These will be sorted in the order they appeared in the original
message, or were added to the message, and may contain duplicates.
Any fields deleted and re-inserted are always appended to the header
list.
"""
return [(k, self.policy.header_fetch_parse(k, v))
for k, v in self._headers]
def get(self, name, failobj=None):
"""Get a header value.
Like __getitem__() but return failobj instead of None when the field
is missing.
"""
name = name.lower()
for k, v in self._headers:
if k.lower() == name:
return self.policy.header_fetch_parse(k, v)
return failobj
#
# "Internal" methods (public API, but only intended for use by a parser
# or generator, not normal application code.
#
def set_raw(self, name, value):
"""Store name and value in the model without modification.
This is an "internal" API, intended only for use by a parser.
"""
self._headers.append((name, value))
def raw_items(self):
"""Return the (name, value) header pairs without modification.
This is an "internal" API, intended only for use by a generator.
"""
return iter(self._headers.copy())
#
# Additional useful stuff
#
def get_all(self, name, failobj=None):
"""Return a list of all the values for the named field.
These will be sorted in the order they appeared in the original
message, and may contain duplicates. Any fields deleted and
re-inserted are always appended to the header list.
If no such fields exist, failobj is returned (defaults to None).
"""
values = []
name = name.lower()
for k, v in self._headers:
if k.lower() == name:
values.append(self.policy.header_fetch_parse(k, v))
if not values:
return failobj
return values
def add_header(self, _name, _value, **_params):
"""Extended header setting.
name is the header field to add. keyword arguments can be used to set
additional parameters for the header field, with underscores converted
to dashes. Normally the parameter will be added as key="value" unless
value is None, in which case only the key will be added. If a
parameter value contains non-ASCII characters it can be specified as a
three-tuple of (charset, language, value), in which case it will be
encoded according to RFC2231 rules. Otherwise it will be encoded using
the utf-8 charset and a language of ''.
Examples:
msg.add_header('content-disposition', 'attachment', filename='bud.gif')
msg.add_header('content-disposition', 'attachment',
filename=('utf-8', '', 'Fußballer.ppt'))
msg.add_header('content-disposition', 'attachment',
filename='Fußballer.ppt'))
"""
parts = []
for k, v in _params.items():
if v is None:
parts.append(k.replace('_', '-'))
else:
parts.append(_formatparam(k.replace('_', '-'), v))
if _value is not None:
parts.insert(0, _value)
self[_name] = SEMISPACE.join(parts)
def replace_header(self, _name, _value):
"""Replace a header.
Replace the first matching header found in the message, retaining
header order and case. If no matching header was found, a KeyError is
raised.
"""
_name = _name.lower()
for i, (k, v) in zip(range(len(self._headers)), self._headers):
if k.lower() == _name:
self._headers[i] = self.policy.header_store_parse(k, _value)
break
else:
raise KeyError(_name)
#
# Use these three methods instead of the three above.
#
def get_content_type(self):
"""Return the message's content type.
The returned string is coerced to lower case of the form
`maintype/subtype'. If there was no Content-Type header in the
message, the default type as given by get_default_type() will be
returned. Since according to RFC 2045, messages always have a default
type this will always return a value.
RFC 2045 defines a message's default type to be text/plain unless it
appears inside a multipart/digest container, in which case it would be
message/rfc822.
"""
missing = object()
value = self.get('content-type', missing)
if value is missing:
# This should have no parameters
return self.get_default_type()
ctype = _splitparam(value)[0].lower()
# RFC 2045, section 5.2 says if its invalid, use text/plain
if ctype.count('/') != 1:
return 'text/plain'
return ctype
def get_content_maintype(self):
"""Return the message's main content type.
This is the `maintype' part of the string returned by
get_content_type().
"""
ctype = self.get_content_type()
return ctype.split('/')[0]
def get_content_subtype(self):
"""Returns the message's sub-content type.
This is the `subtype' part of the string returned by
get_content_type().
"""
ctype = self.get_content_type()
return ctype.split('/')[1]
def get_default_type(self):
"""Return the `default' content type.
Most messages have a default content type of text/plain, except for
messages that are subparts of multipart/digest containers. Such
subparts have a default content type of message/rfc822.
"""
return self._default_type
def set_default_type(self, ctype):
"""Set the `default' content type.
ctype should be either "text/plain" or "message/rfc822", although this
is not enforced. The default content type is not stored in the
Content-Type header.
"""
self._default_type = ctype
def _get_params_preserve(self, failobj, header):
# Like get_params() but preserves the quoting of values. BAW:
# should this be part of the public interface?
missing = object()
value = self.get(header, missing)
if value is missing:
return failobj
params = []
for p in _parseparam(value):
try:
name, val = p.split('=', 1)
name = name.strip()
val = val.strip()
except ValueError:
# Must have been a bare attribute
name = p.strip()
val = ''
params.append((name, val))
params = utils.decode_params(params)
return params
def get_params(self, failobj=None, header='content-type', unquote=True):
"""Return the message's Content-Type parameters, as a list.
The elements of the returned list are 2-tuples of key/value pairs, as
split on the `=' sign. The left hand side of the `=' is the key,
while the right hand side is the value. If there is no `=' sign in
the parameter the value is the empty string. The value is as
described in the get_param() method.
Optional failobj is the object to return if there is no Content-Type
header. Optional header is the header to search instead of
Content-Type. If unquote is True, the value is unquoted.
"""
missing = object()
params = self._get_params_preserve(missing, header)
if params is missing:
return failobj
if unquote:
return [(k, _unquotevalue(v)) for k, v in params]
else:
return params
def get_param(self, param, failobj=None, header='content-type',
unquote=True):
"""Return the parameter value if found in the Content-Type header.
Optional failobj is the object to return if there is no Content-Type
header, or the Content-Type header has no such parameter. Optional
header is the header to search instead of Content-Type.
Parameter keys are always compared case insensitively. The return
value can either be a string, or a 3-tuple if the parameter was RFC
2231 encoded. When it's a 3-tuple, the elements of the value are of
the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and
LANGUAGE can be None, in which case you should consider VALUE to be
encoded in the us-ascii charset. You can usually ignore LANGUAGE.
The parameter value (either the returned string, or the VALUE item in
the 3-tuple) is always unquoted, unless unquote is set to False.
If your application doesn't care whether the parameter was RFC 2231
encoded, it can turn the return value into a string as follows:
param = msg.get_param('foo')
param = email.utils.collapse_rfc2231_value(rawparam)
"""
if header not in self:
return failobj
for k, v in self._get_params_preserve(failobj, header):
if k.lower() == param.lower():
if unquote:
return _unquotevalue(v)
else:
return v
return failobj
def set_param(self, param, value, header='Content-Type', requote=True,
charset=None, language=''):
"""Set a parameter in the Content-Type header.
If the parameter already exists in the header, its value will be
replaced with the new value.
If header is Content-Type and has not yet been defined for this
message, it will be set to "text/plain" and the new parameter and
value will be appended as per RFC 2045.
An alternate header can specified in the header argument, and all
parameters will be quoted as necessary unless requote is False.
If charset is specified, the parameter will be encoded according to RFC
2231. Optional language specifies the RFC 2231 language, defaulting
to the empty string. Both charset and language should be strings.
"""
if not isinstance(value, tuple) and charset:
value = (charset, language, value)
if header not in self and header.lower() == 'content-type':
ctype = 'text/plain'
else:
ctype = self.get(header)
if not self.get_param(param, header=header):
if not ctype:
ctype = _formatparam(param, value, requote)
else:
ctype = SEMISPACE.join(
[ctype, _formatparam(param, value, requote)])
else:
ctype = ''
for old_param, old_value in self.get_params(header=header,
unquote=requote):
append_param = ''
if old_param.lower() == param.lower():
append_param = _formatparam(param, value, requote)
else:
append_param = _formatparam(old_param, old_value, requote)
if not ctype:
ctype = append_param
else:
ctype = SEMISPACE.join([ctype, append_param])
if ctype != self.get(header):
del self[header]
self[header] = ctype
def del_param(self, param, header='content-type', requote=True):
"""Remove the given parameter completely from the Content-Type header.
The header will be re-written in place without the parameter or its
value. All values will be quoted as necessary unless requote is
False. Optional header specifies an alternative to the Content-Type
header.
"""
if header not in self:
return
new_ctype = ''
for p, v in self.get_params(header=header, unquote=requote):
if p.lower() != param.lower():
if not new_ctype:
new_ctype = _formatparam(p, v, requote)
else:
new_ctype = SEMISPACE.join([new_ctype,
_formatparam(p, v, requote)])
if new_ctype != self.get(header):
del self[header]
self[header] = new_ctype
def set_type(self, type, header='Content-Type', requote=True):
"""Set the main type and subtype for the Content-Type header.
type must be a string in the form "maintype/subtype", otherwise a
ValueError is raised.
This method replaces the Content-Type header, keeping all the
parameters in place. If requote is False, this leaves the existing
header's quoting as is. Otherwise, the parameters will be quoted (the
default).
An alternative header can be specified in the header argument. When
the Content-Type header is set, we'll always also add a MIME-Version
header.
"""
# BAW: should we be strict?
if not type.count('/') == 1:
raise ValueError
# Set the Content-Type, you get a MIME-Version
if header.lower() == 'content-type':
del self['mime-version']
self['MIME-Version'] = '1.0'
if header not in self:
self[header] = type
return
params = self.get_params(header=header, unquote=requote)
del self[header]
self[header] = type
# Skip the first param; it's the old type.
for p, v in params[1:]:
self.set_param(p, v, header, requote)
def get_filename(self, failobj=None):
"""Return the filename associated with the payload if present.
The filename is extracted from the Content-Disposition header's
`filename' parameter, and it is unquoted. If that header is missing
the `filename' parameter, this method falls back to looking for the
`name' parameter.
"""
missing = object()
filename = self.get_param('filename', missing, 'content-disposition')
if filename is missing:
filename = self.get_param('name', missing, 'content-type')
if filename is missing:
return failobj
return utils.collapse_rfc2231_value(filename).strip()
def get_boundary(self, failobj=None):
"""Return the boundary associated with the payload if present.
The boundary is extracted from the Content-Type header's `boundary'
parameter, and it is unquoted.
"""
missing = object()
boundary = self.get_param('boundary', missing)
if boundary is missing:
return failobj
# RFC 2046 says that boundaries may begin but not end in w/s
return utils.collapse_rfc2231_value(boundary).rstrip()
def set_boundary(self, boundary):
"""Set the boundary parameter in Content-Type to 'boundary'.
This is subtly different than deleting the Content-Type header and
adding a new one with a new boundary parameter via add_header(). The
main difference is that using the set_boundary() method preserves the
order of the Content-Type header in the original message.
HeaderParseError is raised if the message has no Content-Type header.
"""
missing = object()
params = self._get_params_preserve(missing, 'content-type')
if params is missing:
# There was no Content-Type header, and we don't know what type
# to set it to, so raise an exception.
raise errors.HeaderParseError('No Content-Type header found')
newparams = list()
foundp = False
for pk, pv in params:
if pk.lower() == 'boundary':
newparams.append(('boundary', '"%s"' % boundary))
foundp = True
else:
newparams.append((pk, pv))
if not foundp:
# The original Content-Type header had no boundary attribute.
# Tack one on the end. BAW: should we raise an exception
# instead???
newparams.append(('boundary', '"%s"' % boundary))
# Replace the existing Content-Type header with the new value
newheaders = list()
for h, v in self._headers:
if h.lower() == 'content-type':
parts = list()
for k, v in newparams:
if v == '':
parts.append(k)
else:
parts.append('%s=%s' % (k, v))
val = SEMISPACE.join(parts)
newheaders.append(self.policy.header_store_parse(h, val))
else:
newheaders.append((h, v))
self._headers = newheaders
def get_content_charset(self, failobj=None):
"""Return the charset parameter of the Content-Type header.
The returned string is always coerced to lower case. If there is no
Content-Type header, or if that header has no charset parameter,
failobj is returned.
"""
missing = object()
charset = self.get_param('charset', missing)
if charset is missing:
return failobj
if isinstance(charset, tuple):
# RFC 2231 encoded, so decode it, and it better end up as ascii.
pcharset = charset[0] or 'us-ascii'
try:
# LookupError will be raised if the charset isn't known to
# Python. UnicodeError will be raised if the encoded text
# contains a character not in the charset.
as_bytes = charset[2].encode('raw-unicode-escape')
charset = str(as_bytes, pcharset)
except (LookupError, UnicodeError):
charset = charset[2]
# charset characters must be in us-ascii range
try:
charset.encode('us-ascii')
except UnicodeError:
return failobj
# RFC 2046, $4.1.2 says charsets are not case sensitive
return charset.lower()
def get_charsets(self, failobj=None):
"""Return a list containing the charset(s) used in this message.
The returned list of items describes the Content-Type headers'
charset parameter for this message and all the subparts in its
payload.
Each item will either be a string (the value of the charset parameter
in the Content-Type header of that part) or the value of the
'failobj' parameter (defaults to None), if the part does not have a
main MIME type of "text", or the charset is not defined.
The list will contain one string for each part of the message, plus
one for the container message (i.e. self), so that a non-multipart
message will still return a list of length 1.
"""
return [part.get_content_charset(failobj) for part in self.walk()]
# I.e. def walk(self): ...
from future.backports.email.iterators import walk
PK �Du\-��/�7 �7 future/backports/email/utils.pynu �[��� # Copyright (C) 2001-2010 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""Miscellaneous utilities."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future import utils
from future.builtins import bytes, int, str
__all__ = [
'collapse_rfc2231_value',
'decode_params',
'decode_rfc2231',
'encode_rfc2231',
'formataddr',
'formatdate',
'format_datetime',
'getaddresses',
'make_msgid',
'mktime_tz',
'parseaddr',
'parsedate',
'parsedate_tz',
'parsedate_to_datetime',
'unquote',
]
import os
import re
if utils.PY2:
re.ASCII = 0
import time
import base64
import random
import socket
from future.backports import datetime
from future.backports.urllib.parse import quote as url_quote, unquote as url_unquote
import warnings
from io import StringIO
from future.backports.email._parseaddr import quote
from future.backports.email._parseaddr import AddressList as _AddressList
from future.backports.email._parseaddr import mktime_tz
from future.backports.email._parseaddr import parsedate, parsedate_tz, _parsedate_tz
from quopri import decodestring as _qdecode
# Intrapackage imports
from future.backports.email.encoders import _bencode, _qencode
from future.backports.email.charset import Charset
COMMASPACE = ', '
EMPTYSTRING = ''
UEMPTYSTRING = ''
CRLF = '\r\n'
TICK = "'"
specialsre = re.compile(r'[][\\()<>@,:;".]')
escapesre = re.compile(r'[\\"]')
# How to figure out if we are processing strings that come from a byte
# source with undecodable characters.
_has_surrogates = re.compile(
'([^\ud800-\udbff]|\A)[\udc00-\udfff]([^\udc00-\udfff]|\Z)').search
# How to deal with a string containing bytes before handing it to the
# application through the 'normal' interface.
def _sanitize(string):
# Turn any escaped bytes into unicode 'unknown' char.
original_bytes = string.encode('ascii', 'surrogateescape')
return original_bytes.decode('ascii', 'replace')
# Helpers
def formataddr(pair, charset='utf-8'):
"""The inverse of parseaddr(), this takes a 2-tuple of the form
(realname, email_address) and returns the string value suitable
for an RFC 2822 From, To or Cc header.
If the first element of pair is false, then the second element is
returned unmodified.
Optional charset if given is the character set that is used to encode
realname in case realname is not ASCII safe. Can be an instance of str or
a Charset-like object which has a header_encode method. Default is
'utf-8'.
"""
name, address = pair
# The address MUST (per RFC) be ascii, so raise an UnicodeError if it isn't.
address.encode('ascii')
if name:
try:
name.encode('ascii')
except UnicodeEncodeError:
if isinstance(charset, str):
charset = Charset(charset)
encoded_name = charset.header_encode(name)
return "%s <%s>" % (encoded_name, address)
else:
quotes = ''
if specialsre.search(name):
quotes = '"'
name = escapesre.sub(r'\\\g<0>', name)
return '%s%s%s <%s>' % (quotes, name, quotes, address)
return address
def getaddresses(fieldvalues):
"""Return a list of (REALNAME, EMAIL) for each fieldvalue."""
all = COMMASPACE.join(fieldvalues)
a = _AddressList(all)
return a.addresslist
ecre = re.compile(r'''
=\? # literal =?
(?P<charset>[^?]*?) # non-greedy up to the next ? is the charset
\? # literal ?
(?P<encoding>[qb]) # either a "q" or a "b", case insensitive
\? # literal ?
(?P<atom>.*?) # non-greedy up to the next ?= is the atom
\?= # literal ?=
''', re.VERBOSE | re.IGNORECASE)
def _format_timetuple_and_zone(timetuple, zone):
return '%s, %02d %s %04d %02d:%02d:%02d %s' % (
['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'][timetuple[6]],
timetuple[2],
['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'][timetuple[1] - 1],
timetuple[0], timetuple[3], timetuple[4], timetuple[5],
zone)
def formatdate(timeval=None, localtime=False, usegmt=False):
"""Returns a date string as specified by RFC 2822, e.g.:
Fri, 09 Nov 2001 01:08:47 -0000
Optional timeval if given is a floating point time value as accepted by
gmtime() and localtime(), otherwise the current time is used.
Optional localtime is a flag that when True, interprets timeval, and
returns a date relative to the local timezone instead of UTC, properly
taking daylight savings time into account.
Optional argument usegmt means that the timezone is written out as
an ascii string, not numeric one (so "GMT" instead of "+0000"). This
is needed for HTTP, and is only used when localtime==False.
"""
# Note: we cannot use strftime() because that honors the locale and RFC
# 2822 requires that day and month names be the English abbreviations.
if timeval is None:
timeval = time.time()
if localtime:
now = time.localtime(timeval)
# Calculate timezone offset, based on whether the local zone has
# daylight savings time, and whether DST is in effect.
if time.daylight and now[-1]:
offset = time.altzone
else:
offset = time.timezone
hours, minutes = divmod(abs(offset), 3600)
# Remember offset is in seconds west of UTC, but the timezone is in
# minutes east of UTC, so the signs differ.
if offset > 0:
sign = '-'
else:
sign = '+'
zone = '%s%02d%02d' % (sign, hours, minutes // 60)
else:
now = time.gmtime(timeval)
# Timezone offset is always -0000
if usegmt:
zone = 'GMT'
else:
zone = '-0000'
return _format_timetuple_and_zone(now, zone)
def format_datetime(dt, usegmt=False):
"""Turn a datetime into a date string as specified in RFC 2822.
If usegmt is True, dt must be an aware datetime with an offset of zero. In
this case 'GMT' will be rendered instead of the normal +0000 required by
RFC2822. This is to support HTTP headers involving date stamps.
"""
now = dt.timetuple()
if usegmt:
if dt.tzinfo is None or dt.tzinfo != datetime.timezone.utc:
raise ValueError("usegmt option requires a UTC datetime")
zone = 'GMT'
elif dt.tzinfo is None:
zone = '-0000'
else:
zone = dt.strftime("%z")
return _format_timetuple_and_zone(now, zone)
def make_msgid(idstring=None, domain=None):
"""Returns a string suitable for RFC 2822 compliant Message-ID, e.g:
<20020201195627.33539.96671@nightshade.la.mastaler.com>
Optional idstring if given is a string used to strengthen the
uniqueness of the message id. Optional domain if given provides the
portion of the message id after the '@'. It defaults to the locally
defined hostname.
"""
timeval = time.time()
utcdate = time.strftime('%Y%m%d%H%M%S', time.gmtime(timeval))
pid = os.getpid()
randint = random.randrange(100000)
if idstring is None:
idstring = ''
else:
idstring = '.' + idstring
if domain is None:
domain = socket.getfqdn()
msgid = '<%s.%s.%s%s@%s>' % (utcdate, pid, randint, idstring, domain)
return msgid
def parsedate_to_datetime(data):
_3to2list = list(_parsedate_tz(data))
dtuple, tz, = [_3to2list[:-1]] + _3to2list[-1:]
if tz is None:
return datetime.datetime(*dtuple[:6])
return datetime.datetime(*dtuple[:6],
tzinfo=datetime.timezone(datetime.timedelta(seconds=tz)))
def parseaddr(addr):
addrs = _AddressList(addr).addresslist
if not addrs:
return '', ''
return addrs[0]
# rfc822.unquote() doesn't properly de-backslash-ify in Python pre-2.3.
def unquote(str):
"""Remove quotes from a string."""
if len(str) > 1:
if str.startswith('"') and str.endswith('"'):
return str[1:-1].replace('\\\\', '\\').replace('\\"', '"')
if str.startswith('<') and str.endswith('>'):
return str[1:-1]
return str
# RFC2231-related functions - parameter encoding and decoding
def decode_rfc2231(s):
"""Decode string according to RFC 2231"""
parts = s.split(TICK, 2)
if len(parts) <= 2:
return None, None, s
return parts
def encode_rfc2231(s, charset=None, language=None):
"""Encode string according to RFC 2231.
If neither charset nor language is given, then s is returned as-is. If
charset is given but not language, the string is encoded using the empty
string for language.
"""
s = url_quote(s, safe='', encoding=charset or 'ascii')
if charset is None and language is None:
return s
if language is None:
language = ''
return "%s'%s'%s" % (charset, language, s)
rfc2231_continuation = re.compile(r'^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$',
re.ASCII)
def decode_params(params):
"""Decode parameters list according to RFC 2231.
params is a sequence of 2-tuples containing (param name, string value).
"""
# Copy params so we don't mess with the original
params = params[:]
new_params = []
# Map parameter's name to a list of continuations. The values are a
# 3-tuple of the continuation number, the string value, and a flag
# specifying whether a particular segment is %-encoded.
rfc2231_params = {}
name, value = params.pop(0)
new_params.append((name, value))
while params:
name, value = params.pop(0)
if name.endswith('*'):
encoded = True
else:
encoded = False
value = unquote(value)
mo = rfc2231_continuation.match(name)
if mo:
name, num = mo.group('name', 'num')
if num is not None:
num = int(num)
rfc2231_params.setdefault(name, []).append((num, value, encoded))
else:
new_params.append((name, '"%s"' % quote(value)))
if rfc2231_params:
for name, continuations in rfc2231_params.items():
value = []
extended = False
# Sort by number
continuations.sort()
# And now append all values in numerical order, converting
# %-encodings for the encoded segments. If any of the
# continuation names ends in a *, then the entire string, after
# decoding segments and concatenating, must have the charset and
# language specifiers at the beginning of the string.
for num, s, encoded in continuations:
if encoded:
# Decode as "latin-1", so the characters in s directly
# represent the percent-encoded octet values.
# collapse_rfc2231_value treats this as an octet sequence.
s = url_unquote(s, encoding="latin-1")
extended = True
value.append(s)
value = quote(EMPTYSTRING.join(value))
if extended:
charset, language, value = decode_rfc2231(value)
new_params.append((name, (charset, language, '"%s"' % value)))
else:
new_params.append((name, '"%s"' % value))
return new_params
def collapse_rfc2231_value(value, errors='replace',
fallback_charset='us-ascii'):
if not isinstance(value, tuple) or len(value) != 3:
return unquote(value)
# While value comes to us as a unicode string, we need it to be a bytes
# object. We do not want bytes() normal utf-8 decoder, we want a straight
# interpretation of the string as character bytes.
charset, language, text = value
rawbytes = bytes(text, 'raw-unicode-escape')
try:
return str(rawbytes, charset, errors)
except LookupError:
# charset is not a known codec.
return unquote(text)
#
# datetime doesn't provide a localtime function yet, so provide one. Code
# adapted from the patch in issue 9527. This may not be perfect, but it is
# better than not having it.
#
def localtime(dt=None, isdst=-1):
"""Return local time as an aware datetime object.
If called without arguments, return current time. Otherwise *dt*
argument should be a datetime instance, and it is converted to the
local time zone according to the system time zone database. If *dt* is
naive (that is, dt.tzinfo is None), it is assumed to be in local time.
In this case, a positive or zero value for *isdst* causes localtime to
presume initially that summer time (for example, Daylight Saving Time)
is or is not (respectively) in effect for the specified time. A
negative value for *isdst* causes the localtime() function to attempt
to divine whether summer time is in effect for the specified time.
"""
if dt is None:
return datetime.datetime.now(datetime.timezone.utc).astimezone()
if dt.tzinfo is not None:
return dt.astimezone()
# We have a naive datetime. Convert to a (localtime) timetuple and pass to
# system mktime together with the isdst hint. System mktime will return
# seconds since epoch.
tm = dt.timetuple()[:-1] + (isdst,)
seconds = time.mktime(tm)
localtm = time.localtime(seconds)
try:
delta = datetime.timedelta(seconds=localtm.tm_gmtoff)
tz = datetime.timezone(delta, localtm.tm_zone)
except AttributeError:
# Compute UTC offset and compare with the value implied by tm_isdst.
# If the values match, use the zone name implied by tm_isdst.
delta = dt - datetime.datetime(*time.gmtime(seconds)[:6])
dst = time.daylight and localtm.tm_isdst > 0
gmtoff = -(time.altzone if dst else time.timezone)
if delta == datetime.timedelta(seconds=gmtoff):
tz = datetime.timezone(delta, time.tzname[dst])
else:
tz = datetime.timezone(delta)
return dt.replace(tzinfo=tz)
PK Eu\!��{` ` future/backports/email/errors.pynu �[��� # Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org
"""email package exception classes."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
class MessageError(Exception):
"""Base class for errors in the email package."""
class MessageParseError(MessageError):
"""Base class for message parsing errors."""
class HeaderParseError(MessageParseError):
"""Error while parsing headers."""
class BoundaryError(MessageParseError):
"""Couldn't find terminating boundary."""
class MultipartConversionError(MessageError, TypeError):
"""Conversion to a multipart is prohibited."""
class CharsetError(MessageError):
"""An illegal charset was given."""
# These are parsing defects which the parser was able to work around.
class MessageDefect(ValueError):
"""Base class for a message defect."""
def __init__(self, line=None):
if line is not None:
super().__init__(line)
self.line = line
class NoBoundaryInMultipartDefect(MessageDefect):
"""A message claimed to be a multipart but had no boundary parameter."""
class StartBoundaryNotFoundDefect(MessageDefect):
"""The claimed start boundary was never found."""
class CloseBoundaryNotFoundDefect(MessageDefect):
"""A start boundary was found, but not the corresponding close boundary."""
class FirstHeaderLineIsContinuationDefect(MessageDefect):
"""A message had a continuation line as its first header line."""
class MisplacedEnvelopeHeaderDefect(MessageDefect):
"""A 'Unix-from' header was found in the middle of a header block."""
class MissingHeaderBodySeparatorDefect(MessageDefect):
"""Found line with no leading whitespace and no colon before blank line."""
# XXX: backward compatibility, just in case (it was never emitted).
MalformedHeaderDefect = MissingHeaderBodySeparatorDefect
class MultipartInvariantViolationDefect(MessageDefect):
"""A message claimed to be a multipart but no subparts were found."""
class InvalidMultipartContentTransferEncodingDefect(MessageDefect):
"""An invalid content transfer encoding was set on the multipart itself."""
class UndecodableBytesDefect(MessageDefect):
"""Header contained bytes that could not be decoded"""
class InvalidBase64PaddingDefect(MessageDefect):
"""base64 encoded sequence had an incorrect length"""
class InvalidBase64CharactersDefect(MessageDefect):
"""base64 encoded sequence had characters not in base64 alphabet"""
# These errors are specific to header parsing.
class HeaderDefect(MessageDefect):
"""Base class for a header defect."""
def __init__(self, *args, **kw):
super().__init__(*args, **kw)
class InvalidHeaderDefect(HeaderDefect):
"""Header is not valid, message gives details."""
class HeaderMissingRequiredValue(HeaderDefect):
"""A header that must have a value had none"""
class NonPrintableDefect(HeaderDefect):
"""ASCII characters outside the ascii-printable range found"""
def __init__(self, non_printables):
super().__init__(non_printables)
self.non_printables = non_printables
def __str__(self):
return ("the following ASCII non-printables found in header: "
"{}".format(self.non_printables))
class ObsoleteHeaderDefect(HeaderDefect):
"""Header uses syntax declared obsolete by RFC 5322"""
class NonASCIILocalPartDefect(HeaderDefect):
"""local_part contains non-ASCII characters"""
# This defect only occurs during unicode parsing, not when
# parsing messages decoded from binary.
PK Eu\ӥ�w" w" future/backports/email/policy.pynu �[��� """This will be the home for the policy that hooks in the new
code that adds all the email6 features.
"""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import
from future.builtins import super
from future.standard_library.email._policybase import (Policy, Compat32,
compat32, _extend_docstrings)
from future.standard_library.email.utils import _has_surrogates
from future.standard_library.email.headerregistry import HeaderRegistry as HeaderRegistry
__all__ = [
'Compat32',
'compat32',
'Policy',
'EmailPolicy',
'default',
'strict',
'SMTP',
'HTTP',
]
@_extend_docstrings
class EmailPolicy(Policy):
"""+
PROVISIONAL
The API extensions enabled by this policy are currently provisional.
Refer to the documentation for details.
This policy adds new header parsing and folding algorithms. Instead of
simple strings, headers are custom objects with custom attributes
depending on the type of the field. The folding algorithm fully
implements RFCs 2047 and 5322.
In addition to the settable attributes listed above that apply to
all Policies, this policy adds the following additional attributes:
refold_source -- if the value for a header in the Message object
came from the parsing of some source, this attribute
indicates whether or not a generator should refold
that value when transforming the message back into
stream form. The possible values are:
none -- all source values use original folding
long -- source values that have any line that is
longer than max_line_length will be
refolded
all -- all values are refolded.
The default is 'long'.
header_factory -- a callable that takes two arguments, 'name' and
'value', where 'name' is a header field name and
'value' is an unfolded header field value, and
returns a string-like object that represents that
header. A default header_factory is provided that
understands some of the RFC5322 header field types.
(Currently address fields and date fields have
special treatment, while all other fields are
treated as unstructured. This list will be
completed before the extension is marked stable.)
"""
refold_source = 'long'
header_factory = HeaderRegistry()
def __init__(self, **kw):
# Ensure that each new instance gets a unique header factory
# (as opposed to clones, which share the factory).
if 'header_factory' not in kw:
object.__setattr__(self, 'header_factory', HeaderRegistry())
super().__init__(**kw)
def header_max_count(self, name):
"""+
The implementation for this class returns the max_count attribute from
the specialized header class that would be used to construct a header
of type 'name'.
"""
return self.header_factory[name].max_count
# The logic of the next three methods is chosen such that it is possible to
# switch a Message object between a Compat32 policy and a policy derived
# from this class and have the results stay consistent. This allows a
# Message object constructed with this policy to be passed to a library
# that only handles Compat32 objects, or to receive such an object and
# convert it to use the newer style by just changing its policy. It is
# also chosen because it postpones the relatively expensive full rfc5322
# parse until as late as possible when parsing from source, since in many
# applications only a few headers will actually be inspected.
def header_source_parse(self, sourcelines):
"""+
The name is parsed as everything up to the ':' and returned unmodified.
The value is determined by stripping leading whitespace off the
remainder of the first line, joining all subsequent lines together, and
stripping any trailing carriage return or linefeed characters. (This
is the same as Compat32).
"""
name, value = sourcelines[0].split(':', 1)
value = value.lstrip(' \t') + ''.join(sourcelines[1:])
return (name, value.rstrip('\r\n'))
def header_store_parse(self, name, value):
"""+
The name is returned unchanged. If the input value has a 'name'
attribute and it matches the name ignoring case, the value is returned
unchanged. Otherwise the name and value are passed to header_factory
method, and the resulting custom header object is returned as the
value. In this case a ValueError is raised if the input value contains
CR or LF characters.
"""
if hasattr(value, 'name') and value.name.lower() == name.lower():
return (name, value)
if isinstance(value, str) and len(value.splitlines())>1:
raise ValueError("Header values may not contain linefeed "
"or carriage return characters")
return (name, self.header_factory(name, value))
def header_fetch_parse(self, name, value):
"""+
If the value has a 'name' attribute, it is returned to unmodified.
Otherwise the name and the value with any linesep characters removed
are passed to the header_factory method, and the resulting custom
header object is returned. Any surrogateescaped bytes get turned
into the unicode unknown-character glyph.
"""
if hasattr(value, 'name'):
return value
return self.header_factory(name, ''.join(value.splitlines()))
def fold(self, name, value):
"""+
Header folding is controlled by the refold_source policy setting. A
value is considered to be a 'source value' if and only if it does not
have a 'name' attribute (having a 'name' attribute means it is a header
object of some sort). If a source value needs to be refolded according
to the policy, it is converted into a custom header object by passing
the name and the value with any linesep characters removed to the
header_factory method. Folding of a custom header object is done by
calling its fold method with the current policy.
Source values are split into lines using splitlines. If the value is
not to be refolded, the lines are rejoined using the linesep from the
policy and returned. The exception is lines containing non-ascii
binary data. In that case the value is refolded regardless of the
refold_source setting, which causes the binary data to be CTE encoded
using the unknown-8bit charset.
"""
return self._fold(name, value, refold_binary=True)
def fold_binary(self, name, value):
"""+
The same as fold if cte_type is 7bit, except that the returned value is
bytes.
If cte_type is 8bit, non-ASCII binary data is converted back into
bytes. Headers with binary data are not refolded, regardless of the
refold_header setting, since there is no way to know whether the binary
data consists of single byte characters or multibyte characters.
"""
folded = self._fold(name, value, refold_binary=self.cte_type=='7bit')
return folded.encode('ascii', 'surrogateescape')
def _fold(self, name, value, refold_binary=False):
if hasattr(value, 'name'):
return value.fold(policy=self)
maxlen = self.max_line_length if self.max_line_length else float('inf')
lines = value.splitlines()
refold = (self.refold_source == 'all' or
self.refold_source == 'long' and
(lines and len(lines[0])+len(name)+2 > maxlen or
any(len(x) > maxlen for x in lines[1:])))
if refold or refold_binary and _has_surrogates(value):
return self.header_factory(name, ''.join(lines)).fold(policy=self)
return name + ': ' + self.linesep.join(lines) + self.linesep
default = EmailPolicy()
# Make the default policy use the class default header_factory
del default.header_factory
strict = default.clone(raise_on_defect=True)
SMTP = default.clone(linesep='\r\n')
HTTP = default.clone(linesep='\r\n', max_line_length=None)
PK Eu\:���U �U future/utils/__init__.pynu �[��� """
A selection of cross-compatible functions for Python 2 and 3.
This module exports useful functions for 2/3 compatible code:
* bind_method: binds functions to classes
* ``native_str_to_bytes`` and ``bytes_to_native_str``
* ``native_str``: always equal to the native platform string object (because
this may be shadowed by imports from future.builtins)
* lists: lrange(), lmap(), lzip(), lfilter()
* iterable method compatibility:
- iteritems, iterkeys, itervalues
- viewitems, viewkeys, viewvalues
These use the original method if available, otherwise they use items,
keys, values.
* types:
* text_type: unicode in Python 2, str in Python 3
* string_types: basestring in Python 2, str in Python 3
* binary_type: str in Python 2, bytes in Python 3
* integer_types: (int, long) in Python 2, int in Python 3
* class_types: (type, types.ClassType) in Python 2, type in Python 3
* bchr(c):
Take an integer and make a 1-character byte string
* bord(c)
Take the result of indexing on a byte string and make an integer
* tobytes(s)
Take a text string, a byte string, or a sequence of characters taken
from a byte string, and make a byte string.
* raise_from()
* raise_with_traceback()
This module also defines these decorators:
* ``python_2_unicode_compatible``
* ``with_metaclass``
* ``implements_iterator``
Some of the functions in this module come from the following sources:
* Jinja2 (BSD licensed: see
https://github.com/mitsuhiko/jinja2/blob/master/LICENSE)
* Pandas compatibility module pandas.compat
* six.py by Benjamin Peterson
* Django
"""
import types
import sys
import numbers
import functools
import copy
import inspect
PY3 = sys.version_info[0] >= 3
PY34_PLUS = sys.version_info[0:2] >= (3, 4)
PY35_PLUS = sys.version_info[0:2] >= (3, 5)
PY36_PLUS = sys.version_info[0:2] >= (3, 6)
PY37_PLUS = sys.version_info[0:2] >= (3, 7)
PY38_PLUS = sys.version_info[0:2] >= (3, 8)
PY39_PLUS = sys.version_info[0:2] >= (3, 9)
PY2 = sys.version_info[0] == 2
PY26 = sys.version_info[0:2] == (2, 6)
PY27 = sys.version_info[0:2] == (2, 7)
PYPY = hasattr(sys, 'pypy_translation_info')
def python_2_unicode_compatible(cls):
"""
A decorator that defines __unicode__ and __str__ methods under Python
2. Under Python 3, this decorator is a no-op.
To support Python 2 and 3 with a single code base, define a __str__
method returning unicode text and apply this decorator to the class, like
this::
>>> from future.utils import python_2_unicode_compatible
>>> @python_2_unicode_compatible
... class MyClass(object):
... def __str__(self):
... return u'Unicode string: \u5b54\u5b50'
>>> a = MyClass()
Then, after this import:
>>> from future.builtins import str
the following is ``True`` on both Python 3 and 2::
>>> str(a) == a.encode('utf-8').decode('utf-8')
True
and, on a Unicode-enabled terminal with the right fonts, these both print the
Chinese characters for Confucius::
>>> print(a)
>>> print(str(a))
The implementation comes from django.utils.encoding.
"""
if not PY3:
cls.__unicode__ = cls.__str__
cls.__str__ = lambda self: self.__unicode__().encode('utf-8')
return cls
def with_metaclass(meta, *bases):
"""
Function from jinja2/_compat.py. License: BSD.
Use it like this::
class BaseForm(object):
pass
class FormType(type):
pass
class Form(with_metaclass(FormType, BaseForm)):
pass
This requires a bit of explanation: the basic idea is to make a
dummy metaclass for one level of class instantiation that replaces
itself with the actual metaclass. Because of internal type checks
we also need to make sure that we downgrade the custom metaclass
for one level to something closer to type (that's why __call__ and
__init__ comes back from type etc.).
This has the advantage over six.with_metaclass of not introducing
dummy classes into the final MRO.
"""
class metaclass(meta):
__call__ = type.__call__
__init__ = type.__init__
def __new__(cls, name, this_bases, d):
if this_bases is None:
return type.__new__(cls, name, (), d)
return meta(name, bases, d)
return metaclass('temporary_class', None, {})
# Definitions from pandas.compat and six.py follow:
if PY3:
def bchr(s):
return bytes([s])
def bstr(s):
if isinstance(s, str):
return bytes(s, 'latin-1')
else:
return bytes(s)
def bord(s):
return s
string_types = str,
integer_types = int,
class_types = type,
text_type = str
binary_type = bytes
else:
# Python 2
def bchr(s):
return chr(s)
def bstr(s):
return str(s)
def bord(s):
return ord(s)
string_types = basestring,
integer_types = (int, long)
class_types = (type, types.ClassType)
text_type = unicode
binary_type = str
###
if PY3:
def tobytes(s):
if isinstance(s, bytes):
return s
else:
if isinstance(s, str):
return s.encode('latin-1')
else:
return bytes(s)
else:
# Python 2
def tobytes(s):
if isinstance(s, unicode):
return s.encode('latin-1')
else:
return ''.join(s)
tobytes.__doc__ = """
Encodes to latin-1 (where the first 256 chars are the same as
ASCII.)
"""
if PY3:
def native_str_to_bytes(s, encoding='utf-8'):
return s.encode(encoding)
def bytes_to_native_str(b, encoding='utf-8'):
return b.decode(encoding)
def text_to_native_str(t, encoding=None):
return t
else:
# Python 2
def native_str_to_bytes(s, encoding=None):
from future.types import newbytes # to avoid a circular import
return newbytes(s)
def bytes_to_native_str(b, encoding=None):
return native(b)
def text_to_native_str(t, encoding='ascii'):
"""
Use this to create a Py2 native string when "from __future__ import
unicode_literals" is in effect.
"""
return unicode(t).encode(encoding)
native_str_to_bytes.__doc__ = """
On Py3, returns an encoded string.
On Py2, returns a newbytes type, ignoring the ``encoding`` argument.
"""
if PY3:
# list-producing versions of the major Python iterating functions
def lrange(*args, **kwargs):
return list(range(*args, **kwargs))
def lzip(*args, **kwargs):
return list(zip(*args, **kwargs))
def lmap(*args, **kwargs):
return list(map(*args, **kwargs))
def lfilter(*args, **kwargs):
return list(filter(*args, **kwargs))
else:
import __builtin__
# Python 2-builtin ranges produce lists
lrange = __builtin__.range
lzip = __builtin__.zip
lmap = __builtin__.map
lfilter = __builtin__.filter
def isidentifier(s, dotted=False):
'''
A function equivalent to the str.isidentifier method on Py3
'''
if dotted:
return all(isidentifier(a) for a in s.split('.'))
if PY3:
return s.isidentifier()
else:
import re
_name_re = re.compile(r"[a-zA-Z_][a-zA-Z0-9_]*$")
return bool(_name_re.match(s))
def viewitems(obj, **kwargs):
"""
Function for iterating over dictionary items with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method."""
func = getattr(obj, "viewitems", None)
if not func:
func = obj.items
return func(**kwargs)
def viewkeys(obj, **kwargs):
"""
Function for iterating over dictionary keys with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method."""
func = getattr(obj, "viewkeys", None)
if not func:
func = obj.keys
return func(**kwargs)
def viewvalues(obj, **kwargs):
"""
Function for iterating over dictionary values with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method."""
func = getattr(obj, "viewvalues", None)
if not func:
func = obj.values
return func(**kwargs)
def iteritems(obj, **kwargs):
"""Use this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewitems().
"""
func = getattr(obj, "iteritems", None)
if not func:
func = obj.items
return func(**kwargs)
def iterkeys(obj, **kwargs):
"""Use this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewkeys().
"""
func = getattr(obj, "iterkeys", None)
if not func:
func = obj.keys
return func(**kwargs)
def itervalues(obj, **kwargs):
"""Use this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewvalues().
"""
func = getattr(obj, "itervalues", None)
if not func:
func = obj.values
return func(**kwargs)
def bind_method(cls, name, func):
"""Bind a method to class, python 2 and python 3 compatible.
Parameters
----------
cls : type
class to receive bound method
name : basestring
name of method on class instance
func : function
function to be bound as method
Returns
-------
None
"""
# only python 2 has an issue with bound/unbound methods
if not PY3:
setattr(cls, name, types.MethodType(func, None, cls))
else:
setattr(cls, name, func)
def getexception():
return sys.exc_info()[1]
def _get_caller_globals_and_locals():
"""
Returns the globals and locals of the calling frame.
Is there an alternative to frame hacking here?
"""
caller_frame = inspect.stack()[2]
myglobals = caller_frame[0].f_globals
mylocals = caller_frame[0].f_locals
return myglobals, mylocals
def _repr_strip(mystring):
"""
Returns the string without any initial or final quotes.
"""
r = repr(mystring)
if r.startswith("'") and r.endswith("'"):
return r[1:-1]
else:
return r
if PY3:
def raise_from(exc, cause):
"""
Equivalent to:
raise EXCEPTION from CAUSE
on Python 3. (See PEP 3134).
"""
myglobals, mylocals = _get_caller_globals_and_locals()
# We pass the exception and cause along with other globals
# when we exec():
myglobals = myglobals.copy()
myglobals['__python_future_raise_from_exc'] = exc
myglobals['__python_future_raise_from_cause'] = cause
execstr = "raise __python_future_raise_from_exc from __python_future_raise_from_cause"
exec(execstr, myglobals, mylocals)
def raise_(tp, value=None, tb=None):
"""
A function that matches the Python 2.x ``raise`` statement. This
allows re-raising exceptions with the cls value and traceback on
Python 2 and 3.
"""
if isinstance(tp, BaseException):
# If the first object is an instance, the type of the exception
# is the class of the instance, the instance itself is the value,
# and the second object must be None.
if value is not None:
raise TypeError("instance exception may not have a separate value")
exc = tp
elif isinstance(tp, type) and not issubclass(tp, BaseException):
# If the first object is a class, it becomes the type of the
# exception.
raise TypeError("class must derive from BaseException, not %s" % tp.__name__)
else:
# The second object is used to determine the exception value: If it
# is an instance of the class, the instance becomes the exception
# value. If the second object is a tuple, it is used as the argument
# list for the class constructor; if it is None, an empty argument
# list is used, and any other object is treated as a single argument
# to the constructor. The instance so created by calling the
# constructor is used as the exception value.
if isinstance(value, tp):
exc = value
elif isinstance(value, tuple):
exc = tp(*value)
elif value is None:
exc = tp()
else:
exc = tp(value)
if exc.__traceback__ is not tb:
raise exc.with_traceback(tb)
raise exc
def raise_with_traceback(exc, traceback=Ellipsis):
if traceback == Ellipsis:
_, _, traceback = sys.exc_info()
raise exc.with_traceback(traceback)
else:
def raise_from(exc, cause):
"""
Equivalent to:
raise EXCEPTION from CAUSE
on Python 3. (See PEP 3134).
"""
# Is either arg an exception class (e.g. IndexError) rather than
# instance (e.g. IndexError('my message here')? If so, pass the
# name of the class undisturbed through to "raise ... from ...".
if isinstance(exc, type) and issubclass(exc, Exception):
e = exc()
# exc = exc.__name__
# execstr = "e = " + _repr_strip(exc) + "()"
# myglobals, mylocals = _get_caller_globals_and_locals()
# exec(execstr, myglobals, mylocals)
else:
e = exc
e.__suppress_context__ = False
if isinstance(cause, type) and issubclass(cause, Exception):
e.__cause__ = cause()
e.__cause__.__traceback__ = sys.exc_info()[2]
e.__suppress_context__ = True
elif cause is None:
e.__cause__ = None
e.__suppress_context__ = True
elif isinstance(cause, BaseException):
e.__cause__ = cause
object.__setattr__(e.__cause__, '__traceback__', sys.exc_info()[2])
e.__suppress_context__ = True
else:
raise TypeError("exception causes must derive from BaseException")
e.__context__ = sys.exc_info()[1]
raise e
exec('''
def raise_(tp, value=None, tb=None):
raise tp, value, tb
def raise_with_traceback(exc, traceback=Ellipsis):
if traceback == Ellipsis:
_, _, traceback = sys.exc_info()
raise exc, None, traceback
'''.strip())
raise_with_traceback.__doc__ = (
"""Raise exception with existing traceback.
If traceback is not passed, uses sys.exc_info() to get traceback."""
)
# Deprecated alias for backward compatibility with ``future`` versions < 0.11:
reraise = raise_
def implements_iterator(cls):
'''
From jinja2/_compat.py. License: BSD.
Use as a decorator like this::
@implements_iterator
class UppercasingIterator(object):
def __init__(self, iterable):
self._iter = iter(iterable)
def __iter__(self):
return self
def __next__(self):
return next(self._iter).upper()
'''
if PY3:
return cls
else:
cls.next = cls.__next__
del cls.__next__
return cls
if PY3:
get_next = lambda x: x.__next__
else:
get_next = lambda x: x.next
def encode_filename(filename):
if PY3:
return filename
else:
if isinstance(filename, unicode):
return filename.encode('utf-8')
return filename
def is_new_style(cls):
"""
Python 2.7 has both new-style and old-style classes. Old-style classes can
be pesky in some circumstances, such as when using inheritance. Use this
function to test for whether a class is new-style. (Python 3 only has
new-style classes.)
"""
return hasattr(cls, '__class__') and ('__dict__' in dir(cls)
or hasattr(cls, '__slots__'))
# The native platform string and bytes types. Useful because ``str`` and
# ``bytes`` are redefined on Py2 by ``from future.builtins import *``.
native_str = str
native_bytes = bytes
def istext(obj):
"""
Deprecated. Use::
>>> isinstance(obj, str)
after this import:
>>> from future.builtins import str
"""
return isinstance(obj, type(u''))
def isbytes(obj):
"""
Deprecated. Use::
>>> isinstance(obj, bytes)
after this import:
>>> from future.builtins import bytes
"""
return isinstance(obj, type(b''))
def isnewbytes(obj):
"""
Equivalent to the result of ``type(obj) == type(newbytes)``
in other words, it is REALLY a newbytes instance, not a Py2 native str
object?
Note that this does not cover subclasses of newbytes, and it is not
equivalent to ininstance(obj, newbytes)
"""
return type(obj).__name__ == 'newbytes'
def isint(obj):
"""
Deprecated. Tests whether an object is a Py3 ``int`` or either a Py2 ``int`` or
``long``.
Instead of using this function, you can use:
>>> from future.builtins import int
>>> isinstance(obj, int)
The following idiom is equivalent:
>>> from numbers import Integral
>>> isinstance(obj, Integral)
"""
return isinstance(obj, numbers.Integral)
def native(obj):
"""
On Py3, this is a no-op: native(obj) -> obj
On Py2, returns the corresponding native Py2 types that are
superclasses for backported objects from Py3:
>>> from builtins import str, bytes, int
>>> native(str(u'ABC'))
u'ABC'
>>> type(native(str(u'ABC')))
unicode
>>> native(bytes(b'ABC'))
b'ABC'
>>> type(native(bytes(b'ABC')))
bytes
>>> native(int(10**20))
100000000000000000000L
>>> type(native(int(10**20)))
long
Existing native types on Py2 will be returned unchanged:
>>> type(native(u'ABC'))
unicode
"""
if hasattr(obj, '__native__'):
return obj.__native__()
else:
return obj
# Implementation of exec_ is from ``six``:
if PY3:
import builtins
exec_ = getattr(builtins, "exec")
else:
def exec_(code, globs=None, locs=None):
"""Execute code in a namespace."""
if globs is None:
frame = sys._getframe(1)
globs = frame.f_globals
if locs is None:
locs = frame.f_locals
del frame
elif locs is None:
locs = globs
exec("""exec code in globs, locs""")
# Defined here for backward compatibility:
def old_div(a, b):
"""
DEPRECATED: import ``old_div`` from ``past.utils`` instead.
Equivalent to ``a / b`` on Python 2 without ``from __future__ import
division``.
TODO: generalize this to other objects (like arrays etc.)
"""
if isinstance(a, numbers.Integral) and isinstance(b, numbers.Integral):
return a // b
else:
return a / b
def as_native_str(encoding='utf-8'):
'''
A decorator to turn a function or method call that returns text, i.e.
unicode, into one that returns a native platform str.
Use it as a decorator like this::
from __future__ import unicode_literals
class MyClass(object):
@as_native_str(encoding='ascii')
def __repr__(self):
return next(self._iter).upper()
'''
if PY3:
return lambda f: f
else:
def encoder(f):
@functools.wraps(f)
def wrapper(*args, **kwargs):
return f(*args, **kwargs).encode(encoding=encoding)
return wrapper
return encoder
# listvalues and listitems definitions from Nick Coghlan's (withdrawn)
# PEP 496:
try:
dict.iteritems
except AttributeError:
# Python 3
def listvalues(d):
return list(d.values())
def listitems(d):
return list(d.items())
else:
# Python 2
def listvalues(d):
return d.values()
def listitems(d):
return d.items()
if PY3:
def ensure_new_type(obj):
return obj
else:
def ensure_new_type(obj):
from future.types.newbytes import newbytes
from future.types.newstr import newstr
from future.types.newint import newint
from future.types.newdict import newdict
native_type = type(native(obj))
# Upcast only if the type is already a native (non-future) type
if issubclass(native_type, type(obj)):
# Upcast
if native_type == str: # i.e. Py2 8-bit str
return newbytes(obj)
elif native_type == unicode:
return newstr(obj)
elif native_type == int:
return newint(obj)
elif native_type == long:
return newint(obj)
elif native_type == dict:
return newdict(obj)
else:
return obj
else:
# Already a new type
assert type(obj) in [newbytes, newstr]
return obj
__all__ = ['PY2', 'PY26', 'PY3', 'PYPY',
'as_native_str', 'binary_type', 'bind_method', 'bord', 'bstr',
'bytes_to_native_str', 'class_types', 'encode_filename',
'ensure_new_type', 'exec_', 'get_next', 'getexception',
'implements_iterator', 'integer_types', 'is_new_style', 'isbytes',
'isidentifier', 'isint', 'isnewbytes', 'istext', 'iteritems',
'iterkeys', 'itervalues', 'lfilter', 'listitems', 'listvalues',
'lmap', 'lrange', 'lzip', 'native', 'native_bytes', 'native_str',
'native_str_to_bytes', 'old_div',
'python_2_unicode_compatible', 'raise_',
'raise_with_traceback', 'reraise', 'string_types',
'text_to_native_str', 'text_type', 'tobytes', 'viewitems',
'viewkeys', 'viewvalues', 'with_metaclass'
]
PK Eu\��ާO �O 0 future/utils/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h�U � @ s� d Z ddlZddlZddlZddlZddlZddlZejd dkZejdd� dkZ ejdd� dkZ
ejdd� dkZ ejdd� dkZ ejdd� d kZ
ejdd� d
kZejd dkZejdd� d kZejdd� d kZeed
�Zdd� Zdd� Ze�r4dd� Zdd� Zdd� ZefZefZ e fZ eZ e Z!n8dd� Zdd� Zdd� Ze"fZee#fZ e ej$fZ e%Z eZ!e�r|dd � Z&nd d � Z&d e&_ e�r�dwd d!�Z'dxd"d#�Z(dyd$d%�Z)n dzd&d!�Z'd{d'd#�Z(d|d)d%�Z)d*e'_ e�r�d+d,� Z*d-d.� Z+d/d0� Z,d1d2� Z-n ddl.Z.e.j/Z*e.j0Z+e.j1Z,e.j2Z-d}d4d5�Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z:dDdE� Z;dFdG� Z<dHdI� Z=e�r�dJdK� Z>d~dLdM�Z?e@fdNdO�ZAndPdK� Z>eBdQ�C� � dReA_ e?ZDdSdT� ZEe�r�dUdV� ZFndWdV� ZFdXdY� ZGdZd[� ZHeZIe ZJd\d]� ZKd^d_� ZLd`da� ZMdbdc� ZNddde� ZOe�r4ddlPZPeQePdf�ZRn
ddgdh�ZRdidj� ZSd�dkdl�ZTz
eUj7 W n$ eV�y~ dmdn� ZWdodp� ZXY n0 dqdn� ZWdrdp� ZXe�r�dsdt� ZYndudt� ZYg dv�ZZdS )�a�
A selection of cross-compatible functions for Python 2 and 3.
This module exports useful functions for 2/3 compatible code:
* bind_method: binds functions to classes
* ``native_str_to_bytes`` and ``bytes_to_native_str``
* ``native_str``: always equal to the native platform string object (because
this may be shadowed by imports from future.builtins)
* lists: lrange(), lmap(), lzip(), lfilter()
* iterable method compatibility:
- iteritems, iterkeys, itervalues
- viewitems, viewkeys, viewvalues
These use the original method if available, otherwise they use items,
keys, values.
* types:
* text_type: unicode in Python 2, str in Python 3
* string_types: basestring in Python 2, str in Python 3
* binary_type: str in Python 2, bytes in Python 3
* integer_types: (int, long) in Python 2, int in Python 3
* class_types: (type, types.ClassType) in Python 2, type in Python 3
* bchr(c):
Take an integer and make a 1-character byte string
* bord(c)
Take the result of indexing on a byte string and make an integer
* tobytes(s)
Take a text string, a byte string, or a sequence of characters taken
from a byte string, and make a byte string.
* raise_from()
* raise_with_traceback()
This module also defines these decorators:
* ``python_2_unicode_compatible``
* ``with_metaclass``
* ``implements_iterator``
Some of the functions in this module come from the following sources:
* Jinja2 (BSD licensed: see
https://github.com/mitsuhiko/jinja2/blob/master/LICENSE)
* Pandas compatibility module pandas.compat
* six.py by Benjamin Peterson
* Django
� N� � )r � )r � )r � )r � )r � )r � )r r )r r Zpypy_translation_infoc C s t s| j| _dd� | _| S )u�
A decorator that defines __unicode__ and __str__ methods under Python
2. Under Python 3, this decorator is a no-op.
To support Python 2 and 3 with a single code base, define a __str__
method returning unicode text and apply this decorator to the class, like
this::
>>> from future.utils import python_2_unicode_compatible
>>> @python_2_unicode_compatible
... class MyClass(object):
... def __str__(self):
... return u'Unicode string: 孔子'
>>> a = MyClass()
Then, after this import:
>>> from future.builtins import str
the following is ``True`` on both Python 3 and 2::
>>> str(a) == a.encode('utf-8').decode('utf-8')
True
and, on a Unicode-enabled terminal with the right fonts, these both print the
Chinese characters for Confucius::
>>> print(a)
>>> print(str(a))
The implementation comes from django.utils.encoding.
c S s | � � �d�S �N�utf-8)� __unicode__�encode)�self� r �?/usr/local/lib/python3.9/site-packages/future/utils/__init__.py�<lambda>n � z-python_2_unicode_compatible.<locals>.<lambda>)�PY3�__str__r ��clsr r r �python_2_unicode_compatibleI s #
r c s" G � �fdd�d��}|ddi �S )a�
Function from jinja2/_compat.py. License: BSD.
Use it like this::
class BaseForm(object):
pass
class FormType(type):
pass
class Form(with_metaclass(FormType, BaseForm)):
pass
This requires a bit of explanation: the basic idea is to make a
dummy metaclass for one level of class instantiation that replaces
itself with the actual metaclass. Because of internal type checks
we also need to make sure that we downgrade the custom metaclass
for one level to something closer to type (that's why __call__ and
__init__ comes back from type etc.).
This has the advantage over six.with_metaclass of not introducing
dummy classes into the final MRO.
c s& e Zd ZejZejZ� �fdd�ZdS )z!with_metaclass.<locals>.metaclassc s$ |d u rt �| |d|�S �|� |�S )Nr )�type�__new__)r �name�
this_bases�d��bases�metar r r � s z)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__� __qualname__r �__call__�__init__r r r r r � metaclass� s r% �temporary_classNr )r r r% r r r �with_metaclassr s r' c C s
t | g�S �N)�bytes��sr r r �bchr� s r, c C s t | t�rt| d�S t| �S d S �N�latin-1)�
isinstance�strr) r* r r r �bstr� s
r1 c C s | S r( r r* r r r �bord� s r2 c C s t | �S r( )�chrr* r r r r, � s c C s t | �S r( )r0 r* r r r r1 � s c C s t | �S r( )�ordr* r r r r2 � s c C s. t | t�r| S t | t�r"| �d�S t| �S d S r- )r/ r) r0 r
r* r r r �tobytes� s
r5 c C s" t | t�r| �d�S d�| �S d S )Nr. � )r/ �unicoder
�joinr* r r r r5 � s
zS
Encodes to latin-1 (where the first 256 chars are the same as
ASCII.)
r c C s
| � |�S r( �r
)r+ �encodingr r r �native_str_to_bytes� s r; c C s
| � |�S r( )�decode��br: r r r �bytes_to_native_str� s r? c C s | S r( r ��tr: r r r �text_to_native_str� s rB c C s ddl m} || �S )Nr ��newbytes)Z future.typesrD )r+ r: rD r r r r; � s c C s t | �S r( )�nativer= r r r r? � s �asciic C s t | ��|�S )z}
Use this to create a Py2 native string when "from __future__ import
unicode_literals" is in effect.
)r7 r
r@ r r r rB � s zu
On Py3, returns an encoded string.
On Py2, returns a newbytes type, ignoring the ``encoding`` argument.
c O s t t| i |���S r( )�list�range��args�kwargsr r r �lrange� s rL c O s t t| i |���S r( )rG �ziprI r r r �lzip� s rN c O s t t| i |���S r( )rG �maprI r r r �lmap� s rP c O s t t| i |���S r( )rG �filterrI r r r �lfilter� s rR Fc C sL |r t dd� | �d�D ��S tr(| �� S ddl}|�d�}t|�| ��S dS )zE
A function equivalent to the str.isidentifier method on Py3
c s s | ]}t |�V qd S r( )� isidentifier)�.0�ar r r � <genexpr> r z isidentifier.<locals>.<genexpr>�.r Nz[a-zA-Z_][a-zA-Z0-9_]*$)�all�splitr rS �re�compile�bool�match)r+ ZdottedrZ Z_name_rer r r rS s
rS c K s$ t | dd�}|s| j}|f i |��S )z�
Function for iterating over dictionary items with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method.� viewitemsN��getattr�items��objrK �funcr r r r^ s r^ c K s$ t | dd�}|s| j}|f i |��S )z�
Function for iterating over dictionary keys with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method.�viewkeysN�r` �keysrb r r r re s re c K s$ t | dd�}|s| j}|f i |��S )z�
Function for iterating over dictionary values with the same set-like
behaviour on Py2.7 as on Py3.
Passes kwargs to method.�
viewvaluesN�r` �valuesrb r r r rh ( s rh c K s$ t | dd�}|s| j}|f i |��S )zsUse this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewitems().
� iteritemsNr_ rb r r r rk 4 s rk c K s$ t | dd�}|s| j}|f i |��S )zrUse this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewkeys().
�iterkeysNrf rb r r r rl > s rl c K s$ t | dd�}|s| j}|f i |��S )ztUse this only if compatibility with Python versions before 2.7 is
required. Otherwise, prefer viewvalues().
�
itervaluesNri rb r r r rm H s rm c C s, t s t| |t�|d| �� n t| ||� dS )a/ Bind a method to class, python 2 and python 3 compatible.
Parameters
----------
cls : type
class to receive bound method
name : basestring
name of method on class instance
func : function
function to be bound as method
Returns
-------
None
N)r �setattr�types�
MethodType)r r rd r r r � bind_methodR s rq c C s t �� d S )N� )�sys�exc_infor r r r � getexceptionj s ru c C s( t �� d } | d j}| d j}||fS )zr
Returns the globals and locals of the calling frame.
Is there an alternative to frame hacking here?
r r )�inspect�stack� f_globals�f_locals)Z caller_frame� myglobals�mylocalsr r r � _get_caller_globals_and_localsn s
r| c C s0 t | �}|�d�r(|�d�r(|dd� S |S dS )zA
Returns the string without any initial or final quotes.
�'rr ���N)�repr�
startswith�endswith)Zmystring�rr r r � _repr_stripz s r� c C s6 t � \}}|�� }| |d< ||d< d}t|||� dS )�n
Equivalent to:
raise EXCEPTION from CAUSE
on Python 3. (See PEP 3134).
Z __python_future_raise_from_excZ __python_future_raise_from_causezJraise __python_future_raise_from_exc from __python_future_raise_from_causeN)r| �copy�exec)�exc�causerz r{ Zexecstrr r r �
raise_from� s
r� c C s� t | t�r |durtd��| }n`t | t�rDt| t�sDtd| j ��n<t || �rT|}n,t |t�rh| |� }n|du rx| � }n| |�}|j|ur�|�|��|�dS )z�
A function that matches the Python 2.x ``raise`` statement. This
allows re-raising exceptions with the cls value and traceback on
Python 2 and 3.
Nz0instance exception may not have a separate valuez,class must derive from BaseException, not %s) r/ �
BaseException� TypeErrorr �
issubclassr �tuple�
__traceback__�with_traceback)�tp�value�tbr� r r r �raise_� s
r� c C s$ |t krt�� \}}}| �|��d S r( )�Ellipsisrs rt r� )r� � traceback�_r r r �raise_with_traceback� s r� c C s� t | t�r t| t�r | � }n| }d|_t |t�rZt|t�rZ|� |_t�� d |j_d|_nN|du rpd|_d|_n8t |t �r�||_t
� |jdt�� d � d|_nt d��t�� d |_
|�dS )r� Fr TNr� z/exception causes must derive from BaseExceptionrr )r/ r r� � Exception�__suppress_context__� __cause__rs rt r� r� �object� __setattr__r� � __context__)r� r� �er r r r� � s$
z�
def raise_(tp, value=None, tb=None):
raise tp, value, tb
def raise_with_traceback(exc, traceback=Ellipsis):
if traceback == Ellipsis:
_, _, traceback = sys.exc_info()
raise exc, None, traceback
zjRaise exception with existing traceback.
If traceback is not passed, uses sys.exc_info() to get traceback.c C s t r| S | j| _| `| S dS )a
From jinja2/_compat.py. License: BSD.
Use as a decorator like this::
@implements_iterator
class UppercasingIterator(object):
def __init__(self, iterable):
self._iter = iter(iterable)
def __iter__(self):
return self
def __next__(self):
return next(self._iter).upper()
N)r �__next__�nextr r r r �implements_iterator� s
r� c C s | j S r( )r� ��xr r r r r r c C s | j S r( )r� r� r r r r r c C s$ t r| S t| t�r | �d�S | S d S r
)r r/ r7 r
)�filenamer r r �encode_filename s
r� c C s t | d�o dt| �v p t | d�S )a
Python 2.7 has both new-style and old-style classes. Old-style classes can
be pesky in some circumstances, such as when using inheritance. Use this
function to test for whether a class is new-style. (Python 3 only has
new-style classes.)
� __class__�__dict__� __slots__)�hasattr�dirr r r r � is_new_style# s �r� c C s t | td��S )z
Deprecated. Use::
>>> isinstance(obj, str)
after this import:
>>> from future.builtins import str
r6 �r/ r �rc r r r �istext3 s r� c C s t | td��S )z�
Deprecated. Use::
>>> isinstance(obj, bytes)
after this import:
>>> from future.builtins import bytes
r r� r� r r r �isbytes= s r� c C s t | �jdkS )a
Equivalent to the result of ``type(obj) == type(newbytes)``
in other words, it is REALLY a newbytes instance, not a Py2 native str
object?
Note that this does not cover subclasses of newbytes, and it is not
equivalent to ininstance(obj, newbytes)
rD )r r r� r r r �
isnewbytesG s r� c C s t | tj�S )a_
Deprecated. Tests whether an object is a Py3 ``int`` or either a Py2 ``int`` or
``long``.
Instead of using this function, you can use:
>>> from future.builtins import int
>>> isinstance(obj, int)
The following idiom is equivalent:
>>> from numbers import Integral
>>> isinstance(obj, Integral)
�r/ �numbers�Integralr� r r r �isintS s r� c C s t | d�r| �� S | S dS )aO
On Py3, this is a no-op: native(obj) -> obj
On Py2, returns the corresponding native Py2 types that are
superclasses for backported objects from Py3:
>>> from builtins import str, bytes, int
>>> native(str(u'ABC'))
u'ABC'
>>> type(native(str(u'ABC')))
unicode
>>> native(bytes(b'ABC'))
b'ABC'
>>> type(native(bytes(b'ABC')))
bytes
>>> native(int(10**20))
100000000000000000000L
>>> type(native(int(10**20)))
long
Existing native types on Py2 will be returned unchanged:
>>> type(native(u'ABC'))
unicode
�
__native__N)r� r� r� r r r rE f s
rE r� c C sB |du r*t �d�}|j}|du r&|j}~n |du r6|}td� dS )z Execute code in a namespace.Nrr zexec code in globs, locs)rs � _getframerx ry r� )�codeZglobsZlocs�framer r r �exec_� s
r� c C s, t | tj�r t |tj�r | | S | | S dS )z�
DEPRECATED: import ``old_div`` from ``past.utils`` instead.
Equivalent to ``a / b`` on Python 2 without ``from __future__ import
division``.
TODO: generalize this to other objects (like arrays etc.)
Nr� )rU r> r r r �old_div� s r� c s t r dd� S � fdd�}|S dS )a~
A decorator to turn a function or method call that returns text, i.e.
unicode, into one that returns a native platform str.
Use it as a decorator like this::
from __future__ import unicode_literals
class MyClass(object):
@as_native_str(encoding='ascii')
def __repr__(self):
return next(self._iter).upper()
c S s | S r( r ��fr r r r � r z as_native_str.<locals>.<lambda>c s t �� ��� fdd��}|S )Nc s �| i |��j � d�S )N�r: r9 rI )r: r� r r �wrapper� s z/as_native_str.<locals>.encoder.<locals>.wrapper)� functools�wraps)r� r� r� r� r �encoder� s z as_native_str.<locals>.encoderN)r )r: r� r r� r �
as_native_str� s r� c C s t | �� �S r( )rG rj �r r r r �
listvalues� s r� c C s t | �� �S r( )rG ra r� r r r � listitems� s r� c C s | � � S r( )rj r� r r r r� � s c C s | � � S r( )ra r� r r r r� � s c C s | S r( r r� r r r �ensure_new_type� s r� c C s� ddl m} ddlm} ddlm} ddlm} tt | ��}t
|t| ��r�|t krZ|| �S |t krj|| �S |t
krz|| �S |tkr�|| �S |tkr�|| �S | S nt| �||fv s�J �| S d S )Nr rC )�newstr)�newint)�newdict)Zfuture.types.newbytesrD Zfuture.types.newstrr� Zfuture.types.newintr� Zfuture.types.newdictr� r rE r� r0 r7 �int�long�dict)rc rD r� r� r� Z native_typer r r r� � s& )2�PY2�PY26r �PYPYr� � binary_typerq r2 r1 r? � class_typesr� r� r� �get_nextru r� �
integer_typesr� r� rS r� r� r� rk rl rm rR r� r� rP rL rN rE � native_bytes�
native_strr; r� r r� r� �reraise� string_typesrB � text_typer5 r^ re rh r' )r )r )N)N)N)rF )F)NN)NN)r )[�__doc__ro rs r� r� r� rv � version_infor Z PY34_PLUSZ PY35_PLUSZ PY36_PLUSZ PY37_PLUSZ PY38_PLUSZ PY39_PLUSr� r� ZPY27r� r� r r' r, r1 r2 r0 r� r� r� r r� r� r) r� �
basestringr� Z ClassTyper7 r5 r; r? rB rL rN rP rR � __builtin__rH rM rO rQ rS r^ re rh rk rl rm rq ru r| r� r� r� r� r� r� �stripr� r� r� r� r� r� r� r� r� r� r� rE �builtinsr` r� r� r� r� �AttributeErrorr� r� r� �__all__r r r r �<module> s� 3
)$
&$ �
$
PK Eu\0��� � 7 future/utils/__pycache__/surrogateescape.cpython-39.pycnu �[��� a
��?h� � @ s� d Z ddlZddlZddlmZ dZdd� Zdd� ZejrHe Z
d d
� Z ne Z
e Z d d � Z
G d
d� de�Zdd� Zdd� Zdd� Zdd� ZdZed�Zed�Ze�e�jZdd� Zed kr�dS ) z�
This is Victor Stinner's pure-Python implementation of PEP 383: the "surrogateescape" error
handler of Python 3.
Source: misc/python/surrogateescape.py in https://bitbucket.org/haypo/misc
� N)�utils�surrogateescapec C s t jr
| S | �d�S d S )N�unicode_escape)r �PY3�decode)�text� r �F/usr/local/lib/python3.9/site-packages/future/utils/surrogateescape.py�u s r
c C s t jr| �d�S | S d S )N�latin1)r r �encode)�datar r r �b s
r c C s
t | f�S �N)�bytes)�coder r r �<lambda># � r c C sd | j | j| j� }z0t| t�r(t|�}nt| t�r<t|�}n| �W n tyX | �Y n0 || jfS )z�
Pure Python implementation of the PEP 383: the "surrogateescape" error
handler of Python 3. Undecodable bytes will be replaced by a Unicode
character U+DCxx on decoding, and these are translated into the
original bytes on encoding.
) �object�start�end�
isinstance�UnicodeDecodeError�replace_surrogate_decode�UnicodeEncodeError�replace_surrogate_encode�NotASurrogateError)�exc�mystring�decodedr r r �surrogateescape_handler( s
r c @ s e Zd ZdS )r N)�__name__�
__module__� __qualname__r r r r r C s r c C s� g }| D ]r}t |�}d| kr(dks.n t�d| krBdkrZn n|�t|d �� q|dkrv|�t|d �� qt�qt� �|�S )z�
Returns a (unicode) string, not the more logical bytes, because the codecs
register_error functionality expects this.
� � �� � � i� )�ordr �append�_unichr�str�join)r r �chr r r r r G s r c C sz g }| D ]d}t |t�r |}nt|�}d| kr8dkrPn n|�td| �� q|dkrh|�t|�� qt�qt� �|�S )z$
Returns a (unicode) string
� � r& � )r �intr' r( r) r r* r+ )Zmybytesr r, r r r r r d s
r c C s@ t dkr�g }t| �D ]f\}}t|�}|dk r6t|�}n:d| krJdkr\n nt|d �}ntt | ||d d��|�|� qt� �|�S t dk�r0g }t| �D ]�\}}t|�}d | kr�d
k�rn nFd| kr�dkr�n nt|d �}|�|� ntt | ||d d ��q�|�d�}|�|� q�t� �|�S | �t t �S d S ) N�asciir- i�� r% r& � zordinal not in range(128)zutf-8r$ i�� zsurrogates not allowed)
� FS_ENCODING� enumerater' � bytes_chrr r( r r+ r � FS_ERRORS)�fn�encoded�indexr, r Zch_utf8r r r �encodefilename} s<
�
�
r: c C s | � tt�S r )r r3 r6 )r7 r r r �decodefilename� s r; r1 u [abcÿ]u [abc�]c C s< t jr
dS zt�t� W n ty6 t�tt� Y n0 dS )zH
Registers the surrogateescape error handler on Python 2 (only)
N)r r �codecs� lookup_errorr6 � LookupError�register_errorr r r r r �register_surrogateescape� s r@ �__main__)�__doc__r< �sys�futurer r6 r
r r �chrr) r5 �unichrr � Exceptionr r r r: r; r3 r7 r8 �lookup�namer@ r! r r r r �<module> s,
' PK Eu\
�Z� � future/utils/surrogateescape.pynu �[��� """
This is Victor Stinner's pure-Python implementation of PEP 383: the "surrogateescape" error
handler of Python 3.
Source: misc/python/surrogateescape.py in https://bitbucket.org/haypo/misc
"""
# This code is released under the Python license and the BSD 2-clause license
import codecs
import sys
from future import utils
FS_ERRORS = 'surrogateescape'
# # -- Python 2/3 compatibility -------------------------------------
# FS_ERRORS = 'my_surrogateescape'
def u(text):
if utils.PY3:
return text
else:
return text.decode('unicode_escape')
def b(data):
if utils.PY3:
return data.encode('latin1')
else:
return data
if utils.PY3:
_unichr = chr
bytes_chr = lambda code: bytes((code,))
else:
_unichr = unichr
bytes_chr = chr
def surrogateescape_handler(exc):
"""
Pure Python implementation of the PEP 383: the "surrogateescape" error
handler of Python 3. Undecodable bytes will be replaced by a Unicode
character U+DCxx on decoding, and these are translated into the
original bytes on encoding.
"""
mystring = exc.object[exc.start:exc.end]
try:
if isinstance(exc, UnicodeDecodeError):
# mystring is a byte-string in this case
decoded = replace_surrogate_decode(mystring)
elif isinstance(exc, UnicodeEncodeError):
# In the case of u'\udcc3'.encode('ascii',
# 'this_surrogateescape_handler'), both Python 2.x and 3.x raise an
# exception anyway after this function is called, even though I think
# it's doing what it should. It seems that the strict encoder is called
# to encode the unicode string that this function returns ...
decoded = replace_surrogate_encode(mystring)
else:
raise exc
except NotASurrogateError:
raise exc
return (decoded, exc.end)
class NotASurrogateError(Exception):
pass
def replace_surrogate_encode(mystring):
"""
Returns a (unicode) string, not the more logical bytes, because the codecs
register_error functionality expects this.
"""
decoded = []
for ch in mystring:
# if utils.PY3:
# code = ch
# else:
code = ord(ch)
# The following magic comes from Py3.3's Python/codecs.c file:
if not 0xD800 <= code <= 0xDCFF:
# Not a surrogate. Fail with the original exception.
raise NotASurrogateError
# mybytes = [0xe0 | (code >> 12),
# 0x80 | ((code >> 6) & 0x3f),
# 0x80 | (code & 0x3f)]
# Is this a good idea?
if 0xDC00 <= code <= 0xDC7F:
decoded.append(_unichr(code - 0xDC00))
elif code <= 0xDCFF:
decoded.append(_unichr(code - 0xDC00))
else:
raise NotASurrogateError
return str().join(decoded)
def replace_surrogate_decode(mybytes):
"""
Returns a (unicode) string
"""
decoded = []
for ch in mybytes:
# We may be parsing newbytes (in which case ch is an int) or a native
# str on Py2
if isinstance(ch, int):
code = ch
else:
code = ord(ch)
if 0x80 <= code <= 0xFF:
decoded.append(_unichr(0xDC00 + code))
elif code <= 0x7F:
decoded.append(_unichr(code))
else:
# # It may be a bad byte
# # Try swallowing it.
# continue
# print("RAISE!")
raise NotASurrogateError
return str().join(decoded)
def encodefilename(fn):
if FS_ENCODING == 'ascii':
# ASCII encoder of Python 2 expects that the error handler returns a
# Unicode string encodable to ASCII, whereas our surrogateescape error
# handler has to return bytes in 0x80-0xFF range.
encoded = []
for index, ch in enumerate(fn):
code = ord(ch)
if code < 128:
ch = bytes_chr(code)
elif 0xDC80 <= code <= 0xDCFF:
ch = bytes_chr(code - 0xDC00)
else:
raise UnicodeEncodeError(FS_ENCODING,
fn, index, index+1,
'ordinal not in range(128)')
encoded.append(ch)
return bytes().join(encoded)
elif FS_ENCODING == 'utf-8':
# UTF-8 encoder of Python 2 encodes surrogates, so U+DC80-U+DCFF
# doesn't go through our error handler
encoded = []
for index, ch in enumerate(fn):
code = ord(ch)
if 0xD800 <= code <= 0xDFFF:
if 0xDC80 <= code <= 0xDCFF:
ch = bytes_chr(code - 0xDC00)
encoded.append(ch)
else:
raise UnicodeEncodeError(
FS_ENCODING,
fn, index, index+1, 'surrogates not allowed')
else:
ch_utf8 = ch.encode('utf-8')
encoded.append(ch_utf8)
return bytes().join(encoded)
else:
return fn.encode(FS_ENCODING, FS_ERRORS)
def decodefilename(fn):
return fn.decode(FS_ENCODING, FS_ERRORS)
FS_ENCODING = 'ascii'; fn = b('[abc\xff]'); encoded = u('[abc\udcff]')
# FS_ENCODING = 'cp932'; fn = b('[abc\x81\x00]'); encoded = u('[abc\udc81\x00]')
# FS_ENCODING = 'UTF-8'; fn = b('[abc\xff]'); encoded = u('[abc\udcff]')
# normalize the filesystem encoding name.
# For example, we expect "utf-8", not "UTF8".
FS_ENCODING = codecs.lookup(FS_ENCODING).name
def register_surrogateescape():
"""
Registers the surrogateescape error handler on Python 2 (only)
"""
if utils.PY3:
return
try:
codecs.lookup_error(FS_ERRORS)
except LookupError:
codecs.register_error(FS_ERRORS, surrogateescape_handler)
if __name__ == '__main__':
pass
# # Tests:
# register_surrogateescape()
# b = decodefilename(fn)
# assert b == encoded, "%r != %r" % (b, encoded)
# c = encodefilename(b)
# assert c == fn, '%r != %r' % (c, fn)
# # print("ok")
PK #Eu\ distro/py.typednu �[��� PK #Eu\�`p�� � distro/__init__.pynu �[��� from .distro import (
NORMALIZED_DISTRO_ID,
NORMALIZED_LSB_ID,
NORMALIZED_OS_ID,
LinuxDistribution,
__version__,
build_number,
codename,
distro_release_attr,
distro_release_info,
id,
info,
like,
linux_distribution,
lsb_release_attr,
lsb_release_info,
major_version,
minor_version,
name,
os_release_attr,
os_release_info,
uname_attr,
uname_info,
version,
version_parts,
)
__all__ = [
"NORMALIZED_DISTRO_ID",
"NORMALIZED_LSB_ID",
"NORMALIZED_OS_ID",
"LinuxDistribution",
"build_number",
"codename",
"distro_release_attr",
"distro_release_info",
"id",
"info",
"like",
"linux_distribution",
"lsb_release_attr",
"lsb_release_info",
"major_version",
"minor_version",
"name",
"os_release_attr",
"os_release_info",
"uname_attr",
"uname_info",
"version",
"version_parts",
]
__version__ = __version__
PK %Eu\ T�i@ @ distro/__main__.pynu �[��� from .distro import main
if __name__ == "__main__":
main()
PK +Eu\�n$i i * distro/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ sx d dl mZmZmZmZmZmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZ g d�ZeZdS )� )�NORMALIZED_DISTRO_ID�NORMALIZED_LSB_ID�NORMALIZED_OS_ID�LinuxDistribution� __version__� build_number�codename�distro_release_attr�distro_release_info�id�info�like�linux_distribution�lsb_release_attr�lsb_release_info�
major_version�
minor_version�name�os_release_attr�os_release_info�
uname_attr�
uname_info�version�
version_parts)r r r r r r r r
r r r
r r r r r r r r r r r r N)�distror r r r r r r r r
r r r
r r r r r r r r r r r r �__all__� r r �9/usr/local/lib/python3.9/site-packages/distro/__init__.py�<module> s hPK .Eu\y�
P� P� ( distro/__pycache__/distro.cpython-39.pycnu �[��� a
��?h� � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z m Z m
Z
mZmZmZmZmZmZ zddl
mZ W n ey� eZY n0 dZG dd� de�ZG dd � d e�Zej�d
d �Z ej�d d
�Z dZ ddd�Z dddddd�Z ddiZ!e�"d�Z#e�"d�Z$g d�Z%ddde dd d d d f Z&dVe'ee(e(e(f d!�d"d#�Z)e(d$�d%d&�Z*dWe'e(d(�d)d*�Z+dXe'e'e(d+�d,d-�Z,dYe'ee(e(e(f d.�d/d0�Z-dZe'e(d.�d1d2�Z.d[e'e(d.�d3d4�Z/d\e'e(d.�d5d6�Z0e(d$�d7d8�Z1e(d$�d9d:�Z2d]e'e'ed+�d;d<�Z3e
e(e(f d$�d=d>�Z4e
e(e(f d$�d?d@�Z5e
e(e(f d$�dAdB�Z6e
e(e(f d$�dCdD�Z7e(e(dE�dFdG�Z8e(e(dE�dHdI�Z9e(e(dE�dJdK�Z:e(e(dE�dLdM�Z;zddNl<m=Z= W n" e�y� G dOdP� dP�Z=Y n0 G dQdR� dR�Z>e>� Z?dd$�dSdT�Z@eAdUk�re@� dS )^a�
The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.
It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 removed it altogether. Its
predecessor function :py:func:`platform.dist` was already deprecated since
Python 2.6 and removed in Python 3.8. Still, there are many cases in which
access to OS distribution information is needed. See `Python issue 1322
<https://bugs.python.org/issue1322>`_ for more information.
� N) �Any�Callable�Dict�Iterable�Optional�Sequence�TextIO�Tuple�Type)� TypedDictz1.9.0c @ s& e Zd ZU eed< eed< eed< dS )� VersionDict�major�minor� build_numberN)�__name__�
__module__� __qualname__�str�__annotations__� r r �7/usr/local/lib/python3.9/site-packages/distro/distro.pyr = s
r c @ s6 e Zd ZU eed< eed< eed< eed< eed< dS )�InfoDict�id�version�
version_parts�like�codenameN)r r r r r r r r r r r C s
r Z UNIXCONFDIRz/etcZ
UNIXUSRLIBDIRz/usr/libz
os-release�oracleZopensuse)�olz
opensuse-leap�rhel)�enterpriseenterpriseas�enterpriseenterpriseserver�redhatenterpriseworkstation�redhatenterpriseserver�redhatenterprisecomputenode�redhatzA(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)z(\w+)[-_](release|version)$)z SuSE-releasezaltlinux-releasez arch-releasez base-releasezcentos-releasezfedora-releasezgentoo-releasezmageia-releasezmandrake-releasezmandriva-releasezmandrivalinux-releasezmanjaro-releasezoracle-releasezredhat-releasez
rocky-releasez
sl-releasezslackware-version�debian_versionz lsb-releasez oem-releasezsystem-releasez
plesk-releaseziredmail-releasez
board-releaseZ ec2_versionT��full_distribution_name�returnc C s t jdtdd� t�| �S )a�
.. deprecated:: 1.6.0
:func:`distro.linux_distribution()` is deprecated. It should only be
used as a compatibility shim with Python's
:py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
:func:`distro.version` and :func:`distro.name` instead.
Return information about the current OS distribution as a tuple
``(id_name, version, codename)`` with items as follows:
* ``id_name``: If *full_distribution_name* is false, the result of
:func:`distro.id`. Otherwise, the result of :func:`distro.name`.
* ``version``: The result of :func:`distro.version`.
* ``codename``: The extra item (usually in parentheses) after the
os-release version number, or the result of :func:`distro.codename`.
The interface of this function is compatible with the original
:py:func:`platform.linux_distribution` function, supporting a subset of
its parameters.
The data it returns may not exactly be the same, because it uses more data
sources than the original function, and that may lead to different data if
the OS distribution is not consistent across multiple data sources it
provides (there are indeed such distributions ...).
Another reason for differences is the fact that the :func:`distro.id`
method normalizes the distro ID string to a reliable machine-readable value
for a number of popular OS distributions.
z�distro.linux_distribution() is deprecated. It should only be used as a compatibility shim with Python's platform.linux_distribution(). Please use distro.id(), distro.version() and distro.name() instead.� )�
stacklevel)�warnings�warn�DeprecationWarning�_distro�linux_distribution)r( r r r r0 � s !�r0 �r) c C s t �� S )a�
Return the distro ID of the current distribution, as a
machine-readable string.
For a number of OS distributions, the returned distro ID value is
*reliable*, in the sense that it is documented and that it does not change
across releases of the distribution.
This package maintains the following reliable distro ID values:
============== =========================================
Distro ID Distribution
============== =========================================
"ubuntu" Ubuntu
"debian" Debian
"rhel" RedHat Enterprise Linux
"centos" CentOS
"fedora" Fedora
"sles" SUSE Linux Enterprise Server
"opensuse" openSUSE
"amzn" Amazon Linux
"arch" Arch Linux
"buildroot" Buildroot
"cloudlinux" CloudLinux OS
"exherbo" Exherbo Linux
"gentoo" GenToo Linux
"ibm_powerkvm" IBM PowerKVM
"kvmibm" KVM for IBM z Systems
"linuxmint" Linux Mint
"mageia" Mageia
"mandriva" Mandriva Linux
"parallels" Parallels
"pidora" Pidora
"raspbian" Raspbian
"oracle" Oracle Linux (and Oracle Enterprise Linux)
"scientific" Scientific Linux
"slackware" Slackware
"xenserver" XenServer
"openbsd" OpenBSD
"netbsd" NetBSD
"freebsd" FreeBSD
"midnightbsd" MidnightBSD
"rocky" Rocky Linux
"aix" AIX
"guix" Guix System
"altlinux" ALT Linux
============== =========================================
If you have a need to get distros for reliable IDs added into this set,
or if you find that the :func:`distro.id` function returns a different
distro ID for one of the listed distros, please create an issue in the
`distro issue tracker`_.
**Lookup hierarchy and transformations:**
First, the ID is obtained from the following sources, in the specified
order. The first available and non-empty value is used:
* the value of the "ID" attribute of the os-release file,
* the value of the "Distributor ID" attribute returned by the lsb_release
command,
* the first part of the file name of the distro release file,
The so determined ID value then passes the following transformations,
before it is returned by this method:
* it is translated to lower case,
* blanks (which should not be there anyway) are translated to underscores,
* a normalization of the ID is performed, based upon
`normalization tables`_. The purpose of this normalization is to ensure
that the ID is as reliable as possible, even across incompatible changes
in the OS distributions. A common reason for an incompatible change is
the addition of an os-release file, or the addition of the lsb_release
command, with ID values that differ from what was previously determined
from the distro release file name.
)r/ r r r r r r � s Qr F��prettyr) c C s
t �| �S )ak
Return the name of the current OS distribution, as a human-readable
string.
If *pretty* is false, the name is returned without version or codename.
(e.g. "CentOS Linux")
If *pretty* is true, the version and codename are appended.
(e.g. "CentOS Linux 7.1.1503 (Core)")
**Lookup hierarchy:**
The name is obtained from the following sources, in the specified order.
The first available and non-empty value is used:
* If *pretty* is false:
- the value of the "NAME" attribute of the os-release file,
- the value of the "Distributor ID" attribute returned by the lsb_release
command,
- the value of the "<name>" field of the distro release file.
* If *pretty* is true:
- the value of the "PRETTY_NAME" attribute of the os-release file,
- the value of the "Description" attribute returned by the lsb_release
command,
- the value of the "<name>" field of the distro release file, appended
with the value of the pretty version ("<version_id>" and "<codename>"
fields) of the distro release file, if available.
)r/ �name�r3 r r r r4 s $r4 �r3 �bestr) c C s t �| |�S )aN
Return the version of the current OS distribution, as a human-readable
string.
If *pretty* is false, the version is returned without codename (e.g.
"7.0").
If *pretty* is true, the codename in parenthesis is appended, if the
codename is non-empty (e.g. "7.0 (Maipo)").
Some distributions provide version numbers with different precisions in
the different sources of distribution information. Examining the different
sources in a fixed priority order does not always yield the most precise
version (e.g. for Debian 8.2, or CentOS 7.1).
Some other distributions may not provide this kind of information. In these
cases, an empty string would be returned. This behavior can be observed
with rolling releases distributions (e.g. Arch Linux).
The *best* parameter can be used to control the approach for the returned
version:
If *best* is false, the first non-empty version number in priority order of
the examined sources is returned.
If *best* is true, the most precise version number out of all examined
sources is returned.
**Lookup hierarchy:**
In all cases, the version number is obtained from the following sources.
If *best* is false, this order represents the priority order:
* the value of the "VERSION_ID" attribute of the os-release file,
* the value of the "Release" attribute returned by the lsb_release
command,
* the version number parsed from the "<version_id>" field of the first line
of the distro release file,
* the version number parsed from the "PRETTY_NAME" attribute of the
os-release file, if it follows the format of the distro release files.
* the version number parsed from the "Description" attribute returned by
the lsb_release command, if it follows the format of the distro release
files.
)r/ r �r3 r7 r r r r F s -r �r7 r) c C s
t �| �S )a�
Return the version of the current OS distribution as a tuple
``(major, minor, build_number)`` with items as follows:
* ``major``: The result of :func:`distro.major_version`.
* ``minor``: The result of :func:`distro.minor_version`.
* ``build_number``: The result of :func:`distro.build_number`.
For a description of the *best* parameter, see the :func:`distro.version`
method.
)r/ r �r7 r r r r v s r c C s
t �| �S )a5
Return the major version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The major version is the first
part of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
)r/ �
major_versionr: r r r r; � s
r; c C s
t �| �S )a6
Return the minor version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The minor version is the second
part of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
)r/ �
minor_versionr: r r r r< � s
r< c C s
t �| �S )a3
Return the build number of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The build number is the third part
of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
)r/ r r: r r r r � s
r c C s t �� S )a
Return a space-separated list of distro IDs of distributions that are
closely related to the current OS distribution in regards to packaging
and programming interfaces, for example distributions the current
distribution is a derivative from.
**Lookup hierarchy:**
This information item is only provided by the os-release file.
For details, see the description of the "ID_LIKE" attribute in the
`os-release man page
<http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
)r/ r r r r r r � s r c C s t �� S )a�
Return the codename for the release of the current OS distribution,
as a string.
If the distribution does not have a codename, an empty string is returned.
Note that the returned codename is not always really a codename. For
example, openSUSE returns "x86_64". This function does not handle such
cases in any special way and just returns the string it finds, if any.
**Lookup hierarchy:**
* the codename within the "VERSION" attribute of the os-release file, if
provided,
* the value of the "Codename" attribute returned by the lsb_release
command,
* the value of the "<codename>" field of the distro release file.
)r/ r r r r r r � s r c C s t �| |�S )a�
Return certain machine-readable information items about the current OS
distribution in a dictionary, as shown in the following example:
.. sourcecode:: python
{
'id': 'rhel',
'version': '7.0',
'version_parts': {
'major': '7',
'minor': '0',
'build_number': ''
},
'like': 'fedora',
'codename': 'Maipo'
}
The dictionary structure and keys are always the same, regardless of which
information items are available in the underlying data sources. The values
for the various keys are as follows:
* ``id``: The result of :func:`distro.id`.
* ``version``: The result of :func:`distro.version`.
* ``version_parts -> major``: The result of :func:`distro.major_version`.
* ``version_parts -> minor``: The result of :func:`distro.minor_version`.
* ``version_parts -> build_number``: The result of
:func:`distro.build_number`.
* ``like``: The result of :func:`distro.like`.
* ``codename``: The result of :func:`distro.codename`.
For a description of the *pretty* and *best* parameters, see the
:func:`distro.version` method.
)r/ �infor8 r r r r= � s )r= c C s t �� S )z�
Return a dictionary containing key-value pairs for the information items
from the os-release file data source of the current OS distribution.
See `os-release file`_ for details about these information items.
)r/ �os_release_infor r r r r> s r> c C s t �� S )z�
Return a dictionary containing key-value pairs for the information items
from the lsb_release command data source of the current OS distribution.
See `lsb_release command output`_ for details about these information
items.
)r/ �lsb_release_infor r r r r?
s r? c C s t �� S )z�
Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.
See `distro release file`_ for details about these information items.
)r/ �distro_release_infor r r r r@ s r@ c C s t �� S )z�
Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.
)r/ �
uname_infor r r r rA " s rA �� attributer) c C s
t �| �S )a�
Return a single named information item from the os-release file data source
of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `os-release file`_ for details about these information items.
)r/ �os_release_attr�rC r r r rD * s rD c C s
t �| �S )a�
Return a single named information item from the lsb_release command output
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `lsb_release command output`_ for details about these information
items.
)r/ �lsb_release_attrrE r r r rF = s rF c C s
t �| �S )a�
Return a single named information item from the distro release file
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `distro release file`_ for details about these information items.
)r/ �distro_release_attrrE r r r rG Q s rG c C s
t �| �S )aZ
Return a single named information item from the distro release file
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
)r/ �
uname_attrrE r r r rH d s rH )�cached_propertyc @ s@ e Zd ZdZeegef dd�dd�Zeee ed�dd�ZdS ) rI z�A version of @property which caches the value. On access, it calls the
underlying function and sets the value in `__dict__` so future accesses
will not re-call the property.
N)�fr) c C s |j | _|| _d S �N)r �_fname�_f)�selfrJ r r r �__init__ s zcached_property.__init__)�obj�ownerr) c C s4 |d usJ d| j � d���| �|� }|j| j < |S )Nzcall z on an instance)rL rM �__dict__)rN rP rQ �retr r r �__get__� s zcached_property.__get__) r r r �__doc__r r rO r
rT r r r r rI y s rI c @ s� e Zd ZdZdUee eeee ee ee dd�dd�Zed�dd �ZdVee eeef d �d d
�Z
ed�dd�Z dWeed�dd�Z dXeeed�dd�Z
dYee eeef d�dd�ZdZeed�dd�Zd[eed�d d �Zd\eed�d d �Zed�d d!�Zed�d"d#�Zd]eeed�d$d%�Zeeef d�d&d'�Zeeef d�d(d)�Zeeef d�d*d+�Zeeef d�d,d-�Zed�d.d/�Zeed0�d1d2�Z eed0�d3d4�Z eed0�d5d6�Z eed0�d7d8�Z e eeef d�d9d:��Z!e"e#eeef d;�d<d=��Z$e eeef d�d>d?��Z%e"e&e eeef d;�d@dA��Z'e eeef d�dBdC��Z(e ed�dDdE��Z)e ed�dFdG��Z*e"e+e eeef d;�dHdI��Z,e"e-edJ�dKdL��Z.e eeef d�dMdN��Z/eeeef dO�dPdQ�Z0e"eeeef dR�dSdT��Z1dS )^�LinuxDistributiona
Provides information about a OS distribution.
This package creates a private module-global instance of this class with
default initialization arguments, that is used by the
`consolidated accessor functions`_ and `single source accessor functions`_.
By using default initialization arguments, that module-global instance
returns data about the current OS distribution (i.e. the distro this
package runs on).
Normally, it is not necessary to create additional instances of this class.
However, in situations where control is needed over the exact data sources
that are used, instances of this class can be created with a specific
distro release file, or a specific os-release file, or without invoking the
lsb_release command.
N� )� include_lsb�os_release_file�distro_release_file�
include_uname�root_dir�include_oslevelr) c
C s� || _ |rtj�|d�nt| _|r0tj�|d�nt| _|rB|| _nFtj�| jt �}tj�| jt �}tj�
|�sztj�
|�s�|| _n|| _|p�d| _ |du} | r�|s�|s�|r�t d��|dur�|n| | _
|dur�|n| | _|dur�|n| | _dS )ah
The initialization method of this class gathers information from the
available data sources, and stores that in private instance attributes.
Subsequent access to the information items uses these private instance
attributes, so that the data sources are read only once.
Parameters:
* ``include_lsb`` (bool): Controls whether the
`lsb_release command output`_ is included as a data source.
If the lsb_release command is not available in the program execution
path, the data source for the lsb_release command will be empty.
* ``os_release_file`` (string): The path name of the
`os-release file`_ that is to be used as a data source.
An empty string (the default) will cause the default path name to
be used (see `os-release file`_ for details).
If the specified or defaulted os-release file does not exist, the
data source for the os-release file will be empty.
* ``distro_release_file`` (string): The path name of the
`distro release file`_ that is to be used as a data source.
An empty string (the default) will cause a default search algorithm
to be used (see `distro release file`_ for details).
If the specified distro release file does not exist, or if no default
distro release file can be found, the data source for the distro
release file will be empty.
* ``include_uname`` (bool): Controls whether uname command output is
included as a data source. If the uname command is not available in
the program execution path the data source for the uname command will
be empty.
* ``root_dir`` (string): The absolute path to the root directory to use
to find distro-related information files. Note that ``include_*``
parameters must not be enabled in combination with ``root_dir``.
* ``include_oslevel`` (bool): Controls whether (AIX) oslevel command
output is included as a data source. If the oslevel command is not
available in the program execution path the data source will be
empty.
Public instance attributes:
* ``os_release_file`` (string): The path name of the
`os-release file`_ that is actually used as a data source. The
empty string if no distro release file is used as a data source.
* ``distro_release_file`` (string): The path name of the
`distro release file`_ that is actually used as a data source. The
empty string if no distro release file is used as a data source.
* ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
This controls whether the lsb information will be loaded.
* ``include_uname`` (bool): The result of the ``include_uname``
parameter. This controls whether the uname information will
be loaded.
* ``include_oslevel`` (bool): The result of the ``include_oslevel``
parameter. This controls whether (AIX) oslevel information will be
loaded.
* ``root_dir`` (string): The result of the ``root_dir`` parameter.
The absolute path to the root directory to use to find distro-related
information files.
Raises:
* :py:exc:`ValueError`: Initialization parameters combination is not
supported.
* :py:exc:`OSError`: Some I/O issue with an os-release file or distro
release file.
* :py:exc:`UnicodeError`: A data source has unexpected characters or
uses an unexpected encoding.
�etczusr/librW NzcIncluding subprocess data sources from specific root_dir is disallowed to prevent false information)r\ �os�path�join� _UNIXCONFDIR�etc_dir�_UNIXUSRLIBDIR� usr_lib_dirrY �_OS_RELEASE_BASENAME�isfilerZ �
ValueErrorrX r[ r] )
rN rX rY rZ r[ r\ r] �etc_dir_os_release_file�usr_lib_os_release_fileZis_root_dir_definedr r r rO � s6 \���
����zLinuxDistribution.__init__r1 c C s dj | d�S )zReturn repr of all infoa� LinuxDistribution(os_release_file={self.os_release_file!r}, distro_release_file={self.distro_release_file!r}, include_lsb={self.include_lsb!r}, include_uname={self.include_uname!r}, include_oslevel={self.include_oslevel!r}, root_dir={self.root_dir!r}, _os_release_info={self._os_release_info!r}, _lsb_release_info={self._lsb_release_info!r}, _distro_release_info={self._distro_release_info!r}, _uname_info={self._uname_info!r}, _oslevel_info={self._oslevel_info!r})�rN )�formatrk r r r �__repr__ s ��zLinuxDistribution.__repr__Tr' c C s. |r | � � n| �� | �� | j�d�p*| �� fS )z�
Return information about the OS distribution that is compatible
with Python's :func:`platform.linux_distribution`, supporting a subset
of its parameters.
For details, see :func:`distro.linux_distribution`.
�release_codename)r4 r r �_os_release_info�getr )rN r( r r r r0 1 s �z$LinuxDistribution.linux_distributionc C s~ t tt t f t d�dd�}| �d�}|r2||t�S | �d�}|rJ||t�S | �d�}|rb||t�S | �d�}|rz||t�S dS )zoReturn the distro ID of the OS distribution, as a string.
For details, see :func:`distro.id`.
)� distro_id�tabler) c S s | � � �dd�} |�| | �S )N� �_)�lower�replacerp )rq rr r r r � normalizeG s z'LinuxDistribution.id.<locals>.normalizer �distributor_idrW ) r r rD �NORMALIZED_OS_IDrF �NORMALIZED_LSB_IDrG �NORMALIZED_DISTRO_IDrH )rN rw rq r r r r A s
zLinuxDistribution.idFr2 c C s~ | � d�p&| �d�p&| �d�p&| �d�}|rv| � d�p>| �d�}|sv| �d�pV| �d�}| jdd�}|rv|� d|� �}|p|dS ) zu
Return the name of the OS distribution, as a string.
For details, see :func:`distro.name`.
r4 rx � pretty_name� descriptionTr5 rs rW )rD rF rG rH r )rN r3 r4 r r r r r4 ] s"
���� zLinuxDistribution.namer6 c C s | � d�| �d�| �d�| �| � d���dd�| �| �d���dd�| �d�g}| �d��d�rr|�d| �� � n(| � � d ks�d | �
� � � v r�|� | j
� d}|r�|D ]$}|�d
�|�d
�ks�|dkr�|}q�n|D ]}|dkr�|} q�q�|�r|�r| �� �r|� d | �� � d �}|S )
z{
Return the version of the OS distribution, as a string.
For details, see :func:`distro.version`.
�
version_id�releaser| rW r} r �aixr Zdebian�.z (�))rD rF rG � _parse_distro_release_contentrp rH �
startswith�insert� oslevel_infor r �split�append�_debian_version�countr )rN r3 r7 �versionsr �vr r r r t s: ���� zLinuxDistribution.versionr9 c C sL | j |d�}|rHt�d�}|�|�}|rH|�� \}}}||p>d|pDdfS dS )z�
Return the version of the OS distribution, as a tuple of version
numbers.
For details, see :func:`distro.version_parts`.
r: z(\d+)\.?(\d+)?\.?(\d+)?rW )rW rW rW )r �re�compile�match�groups)rN r7 � version_str�
version_regex�matchesr
r r r r r r � s
z LinuxDistribution.version_partsc C s | � |�d S )z�
Return the major version number of the current distribution.
For details, see :func:`distro.major_version`.
r �r �rN r7 r r r r; � s z LinuxDistribution.major_versionc C s | � |�d S )z�
Return the minor version number of the current distribution.
For details, see :func:`distro.minor_version`.
� r� r� r r r r< � s z LinuxDistribution.minor_versionc C s | � |�d S )z}
Return the build number of the current distribution.
For details, see :func:`distro.build_number`.
r* r� r� r r r r � s z LinuxDistribution.build_numberc C s | � d�p dS )z�
Return the IDs of distributions that are like the OS distribution.
For details, see :func:`distro.like`.
�id_likerW )rD rk r r r r � s zLinuxDistribution.likec C s< z | j d W S ty6 | �d�p0| �d�p0d Y S 0 dS )zp
Return the codename of the OS distribution.
For details, see :func:`distro.codename`.
r rW N)ro �KeyErrorrF rG rk r r r r � s
��zLinuxDistribution.codenamec C sB t | �� | �||�t| �|�| �|�| �|�d�| �� | �� d�S )z�
Return certain machine-readable information about the OS
distribution.
For details, see :func:`distro.info`.
)r
r r )r r r r r ) r r r r r; r< r r r )rN r3 r7 r r r r= � s
��zLinuxDistribution.infoc C s | j S )z�
Return a dictionary containing key-value pairs for the information
items from the os-release file data source of the OS distribution.
For details, see :func:`distro.os_release_info`.
)ro rk r r r r> � s z!LinuxDistribution.os_release_infoc C s | j S )z�
Return a dictionary containing key-value pairs for the information
items from the lsb_release command data source of the OS
distribution.
For details, see :func:`distro.lsb_release_info`.
)�_lsb_release_infork r r r r? � s z"LinuxDistribution.lsb_release_infoc C s | j S )z�
Return a dictionary containing key-value pairs for the information
items from the distro release file data source of the OS
distribution.
For details, see :func:`distro.distro_release_info`.
)�_distro_release_infork r r r r@ s z%LinuxDistribution.distro_release_infoc C s | j S )z�
Return a dictionary containing key-value pairs for the information
items from the uname command data source of the OS distribution.
For details, see :func:`distro.uname_info`.
)� _uname_infork r r r rA s z LinuxDistribution.uname_infoc C s | j S )z5
Return AIX' oslevel command output.
)�
_oslevel_infork r r r r� s z LinuxDistribution.oslevel_inforB c C s | j �|d�S )z�
Return a single named information item from the os-release file data
source of the OS distribution.
For details, see :func:`distro.os_release_attr`.
rW )ro rp �rN rC r r r rD s z!LinuxDistribution.os_release_attrc C s | j �|d�S )z�
Return a single named information item from the lsb_release command
output data source of the OS distribution.
For details, see :func:`distro.lsb_release_attr`.
rW )r� rp r� r r r rF ' s z"LinuxDistribution.lsb_release_attrc C s | j �|d�S )z�
Return a single named information item from the distro release file
data source of the OS distribution.
For details, see :func:`distro.distro_release_attr`.
rW )r� rp r� r r r rG 0 s z%LinuxDistribution.distro_release_attrc C s | j �|d�S )z�
Return a single named information item from the uname command
output data source of the OS distribution.
For details, see :func:`distro.uname_attr`.
rW )r� rp r� r r r rH 9 s z LinuxDistribution.uname_attrc C sJ t j�| j�rFt| jdd��}| �|�W d � S 1 s<0 Y i S )z�
Get the information items from the specified os-release file.
Returns:
A dictionary containing all information items.
�utf-8��encodingN)r_ r` rg rY �open�_parse_os_release_content)rN � release_filer r r ro B s (z"LinuxDistribution._os_release_info)�linesr) c C s� i }t j | dd�}d|_t|�}|D ](}d|v r$|�dd�\}}|||�� < q$d|v r�t�d|d �}|r�|�d�p||�d�}| |d< |d < d
|v r�|d
|d< nd |v r�|d |d< |S ) aD
Parse the lines of an os-release file.
Parameters:
* lines: Iterable through the lines in the os-release file.
Each line must be a unicode string or a UTF-8 encoded byte
string.
Returns:
A dictionary containing all information items.
T)�posix�=r� r z\((\D+)\)|,\s*(\D+)r* r rn �version_codename�ubuntu_codename)�shlex�whitespace_split�listr� ru r� �search�group) r� �props�lexer�tokens�token�kr� r� rn r r r r� O s$ z+LinuxDistribution._parse_os_release_contentc C sX | j s
i S zd}tj|tjd�}W n ttjfy> i Y S 0 | �|��� }| �|�S )z�
Get the information items from the lsb_release command output.
Returns:
A dictionary containing all information items.
)� lsb_releasez-a��stderr) rX �
subprocess� check_output�DEVNULL�OSError�CalledProcessError�_to_str�
splitlines�_parse_lsb_release_content�rN �cmd�stdout�contentr r r r� � s
z#LinuxDistribution._lsb_release_infoc C sX i }| D ]J}|� d��dd�}t|�dkr,q|\}}|�|�dd��� |� � i� q|S )aM
Parse the output of the lsb_release command.
Parameters:
* lines: Iterable through the lines of the lsb_release output.
Each line must be a unicode string or a UTF-8 encoded byte
string.
Returns:
A dictionary containing all information items.
�
�:r� r* rs rt )�stripr� �len�updaterv ru )r� r� �line�kvr� r� r r r r� � s z,LinuxDistribution._parse_lsb_release_contentc C sR | j s
i S zd}tj|tjd�}W n ty8 i Y S 0 | �|��� }| �|�S )N)�unamez-rsr� )r[ r� r� r� r� r� r� �_parse_uname_contentr� r r r r� � s
z LinuxDistribution._uname_infoc C sH | j s
dS ztjdtjd�}W n ttjfy8 Y dS 0 | �|��� S )NrW Zoslevelr� )r] r� r� r� r� r� r� r� )rN r� r r r r� � s z LinuxDistribution._oslevel_infoc C sd zJt tj�| jd�dd�� }|�� �� W d � W S 1 s>0 Y W n ty^ Y dS 0 d S )Nr& �asciir� rW )r� r_ r` ra rc �readline�rstrip�FileNotFoundError)rN �fpr r r r� � s �0 z!LinuxDistribution._debian_versionc C s\ | si S i }t �d| d �� �}|rX|�� \}}|dkr<i S |�� |d< ||d< ||d< |S )Nz^([^\s]+)\s+([\d\.]+)r �Linuxr r4 r )r� r� r� r� ru )r� r� r� r4 r r r r r� � s z&LinuxDistribution._parse_uname_content)�
bytestringr) c C s t �� }| �|�S rK )�sys�getfilesystemencoding�decode)r� r� r r r r� � s zLinuxDistribution._to_strc s� � j r,� �� j �}tj�� j �}t�|�}n�z&� fdd�t�� j�D �}|� � W n t
yh t }Y n0 |D ]F}t�|�}|du r�qntj� � j|�}� �|�}d|vr�qn|� _ q�qni S |dur�|�
d�|d< d|�dd��� v r�d|d< |S ) z�
Get the information items from the specified distro release file.
Returns:
A dictionary containing all information items.
c s0 g | ](}|t vrtj�tj�� j|��r|�qS r )� _DISTRO_RELEASE_IGNORE_BASENAMESr_ r` rg ra rc )�.0�basenamerk r r �
<listcomp>� s �z:LinuxDistribution._distro_release_info.<locals>.<listcomp>Nr4 r� r �
cloudlinuxrW )rZ �_parse_distro_release_filer_ r` r� � _DISTRO_RELEASE_BASENAME_PATTERNr� �listdirrc �sortr� �_DISTRO_RELEASE_BASENAMESra r� rp ru )rN � distro_infor� r� � basenames�filepathr rk r r� � s6
�
z&LinuxDistribution._distro_release_info)r� r) c C s\ z@t |dd�� }| �|�� �W d � W S 1 s40 Y W n tyV i Y S 0 dS )z�
Parse a distro release file.
Parameters:
* filepath: Path name of the distro release file.
Returns:
A dictionary containing all information items.
r� r� N)r� r� r� r� )rN r� r� r r r r� s
2 z,LinuxDistribution._parse_distro_release_file)r� r) c C s� t �| �� ddd� �}i }|r~|�d�ddd� |d< |�d�rZ|�d�ddd� |d< |�d�r�|�d�ddd� |d< n| r�| �� |d< |S ) a
Parse a line from a distro release file.
Parameters:
* line: Line from the distro release file. Must be a unicode string
or a UTF-8 encoded byte string.
Returns:
A dictionary containing all information items.
N���� r4 r* r~ r� r )�(_DISTRO_RELEASE_CONTENT_REVERSED_PATTERNr� r� r� )r� r� r� r r r r� 5 s
z/LinuxDistribution._parse_distro_release_content)NrW rW NNN)T)F)FF)F)F)F)F)FF)2r r r rU r �boolr rO rm r r0 r r4 r r r; r< r r r r r= r r> r? r@ rA r� rD rF rG rH rI ro � staticmethodr r� r� r r� r� r� r� r r� �bytesr� r� r� r� r r r r rV � s� �� � � *
1 :rV c C s� t �t�} | �t j� | �t �tj�� t j
dd�}|j ddddd� |j dd t d
d d � |�
� }|jr|td
d
d
|jd�}nt}|jr�| �tj|�� ddd�� n@| �d|jdd�� |jdd�}| �d|� |�� }| �d|� d S )NzOS distro info tool)r} z--jsonz-jz!Output in machine readable format�
store_true)�help�actionz
--root-dirz-rr\ z5Path to the root filesystem directory (defaults to /))�type�destr� F)rX r[ r] r\ � T)�indent� sort_keyszName: %sr5 z Version: %sz Codename: %s)�logging� getLoggerr �setLevel�DEBUG�
addHandler�
StreamHandlerr� r� �argparse�ArgumentParser� add_argumentr �
parse_argsr\ rV r/ �jsonr= �dumpsr4 r r )�logger�parser�args�dist�distribution_version�distribution_codenamer r r �mainR s<
��� r �__main__)T)F)FF)F)F)F)F)FF)BrU r� r� r� r_ r� r� r� r� r, �typingr r r r r r r r r
r � ImportError�dict� __version__r r �environrp rb rd rf ry rz r{ r� r� r� r� r� r� r r0 r r4 r r r; r< r r r r= r> r? r@ rA rD rF rG rH � functoolsrI rV r/ r r r r r r �<module> s� ,
�
���
�
+T'0
,
K(
PK 0Eu\�2�� � * distro/__pycache__/__main__.cpython-39.pycnu �[��� a
��?h@ � @ s d dl mZ edkre� dS )� )�main�__main__N)�distror �__name__� r r �9/usr/local/lib/python3.9/site-packages/distro/__main__.py�<module> s PK 3Eu\J:mk� � distro/distro.pynu �[��� #!/usr/bin/env python
# Copyright 2015-2021 Nir Cohen
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.
It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 removed it altogether. Its
predecessor function :py:func:`platform.dist` was already deprecated since
Python 2.6 and removed in Python 3.8. Still, there are many cases in which
access to OS distribution information is needed. See `Python issue 1322
<https://bugs.python.org/issue1322>`_ for more information.
"""
import argparse
import json
import logging
import os
import re
import shlex
import subprocess
import sys
import warnings
from typing import (
Any,
Callable,
Dict,
Iterable,
Optional,
Sequence,
TextIO,
Tuple,
Type,
)
try:
from typing import TypedDict
except ImportError:
# Python 3.7
TypedDict = dict
__version__ = "1.9.0"
class VersionDict(TypedDict):
major: str
minor: str
build_number: str
class InfoDict(TypedDict):
id: str
version: str
version_parts: VersionDict
like: str
codename: str
_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc")
_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib")
_OS_RELEASE_BASENAME = "os-release"
#: Translation table for normalizing the "ID" attribute defined in os-release
#: files, for use by the :func:`distro.id` method.
#:
#: * Key: Value as defined in the os-release file, translated to lower case,
#: with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_OS_ID = {
"ol": "oracle", # Oracle Linux
"opensuse-leap": "opensuse", # Newer versions of OpenSuSE report as opensuse-leap
}
#: Translation table for normalizing the "Distributor ID" attribute returned by
#: the lsb_release command, for use by the :func:`distro.id` method.
#:
#: * Key: Value as returned by the lsb_release command, translated to lower
#: case, with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_LSB_ID = {
"enterpriseenterpriseas": "oracle", # Oracle Enterprise Linux 4
"enterpriseenterpriseserver": "oracle", # Oracle Linux 5
"redhatenterpriseworkstation": "rhel", # RHEL 6, 7 Workstation
"redhatenterpriseserver": "rhel", # RHEL 6, 7 Server
"redhatenterprisecomputenode": "rhel", # RHEL 6 ComputeNode
}
#: Translation table for normalizing the distro ID derived from the file name
#: of distro release files, for use by the :func:`distro.id` method.
#:
#: * Key: Value as derived from the file name of a distro release file,
#: translated to lower case, with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_DISTRO_ID = {
"redhat": "rhel", # RHEL 6.x, 7.x
}
# Pattern for content of distro release file (reversed)
_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
r"(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)"
)
# Pattern for base file name of distro release file
_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")
# Base file names to be looked up for if _UNIXCONFDIR is not readable.
_DISTRO_RELEASE_BASENAMES = [
"SuSE-release",
"altlinux-release",
"arch-release",
"base-release",
"centos-release",
"fedora-release",
"gentoo-release",
"mageia-release",
"mandrake-release",
"mandriva-release",
"mandrivalinux-release",
"manjaro-release",
"oracle-release",
"redhat-release",
"rocky-release",
"sl-release",
"slackware-version",
]
# Base file names to be ignored when searching for distro release file
_DISTRO_RELEASE_IGNORE_BASENAMES = (
"debian_version",
"lsb-release",
"oem-release",
_OS_RELEASE_BASENAME,
"system-release",
"plesk-release",
"iredmail-release",
"board-release",
"ec2_version",
)
def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]:
"""
.. deprecated:: 1.6.0
:func:`distro.linux_distribution()` is deprecated. It should only be
used as a compatibility shim with Python's
:py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
:func:`distro.version` and :func:`distro.name` instead.
Return information about the current OS distribution as a tuple
``(id_name, version, codename)`` with items as follows:
* ``id_name``: If *full_distribution_name* is false, the result of
:func:`distro.id`. Otherwise, the result of :func:`distro.name`.
* ``version``: The result of :func:`distro.version`.
* ``codename``: The extra item (usually in parentheses) after the
os-release version number, or the result of :func:`distro.codename`.
The interface of this function is compatible with the original
:py:func:`platform.linux_distribution` function, supporting a subset of
its parameters.
The data it returns may not exactly be the same, because it uses more data
sources than the original function, and that may lead to different data if
the OS distribution is not consistent across multiple data sources it
provides (there are indeed such distributions ...).
Another reason for differences is the fact that the :func:`distro.id`
method normalizes the distro ID string to a reliable machine-readable value
for a number of popular OS distributions.
"""
warnings.warn(
"distro.linux_distribution() is deprecated. It should only be used as a "
"compatibility shim with Python's platform.linux_distribution(). Please use "
"distro.id(), distro.version() and distro.name() instead.",
DeprecationWarning,
stacklevel=2,
)
return _distro.linux_distribution(full_distribution_name)
def id() -> str:
"""
Return the distro ID of the current distribution, as a
machine-readable string.
For a number of OS distributions, the returned distro ID value is
*reliable*, in the sense that it is documented and that it does not change
across releases of the distribution.
This package maintains the following reliable distro ID values:
============== =========================================
Distro ID Distribution
============== =========================================
"ubuntu" Ubuntu
"debian" Debian
"rhel" RedHat Enterprise Linux
"centos" CentOS
"fedora" Fedora
"sles" SUSE Linux Enterprise Server
"opensuse" openSUSE
"amzn" Amazon Linux
"arch" Arch Linux
"buildroot" Buildroot
"cloudlinux" CloudLinux OS
"exherbo" Exherbo Linux
"gentoo" GenToo Linux
"ibm_powerkvm" IBM PowerKVM
"kvmibm" KVM for IBM z Systems
"linuxmint" Linux Mint
"mageia" Mageia
"mandriva" Mandriva Linux
"parallels" Parallels
"pidora" Pidora
"raspbian" Raspbian
"oracle" Oracle Linux (and Oracle Enterprise Linux)
"scientific" Scientific Linux
"slackware" Slackware
"xenserver" XenServer
"openbsd" OpenBSD
"netbsd" NetBSD
"freebsd" FreeBSD
"midnightbsd" MidnightBSD
"rocky" Rocky Linux
"aix" AIX
"guix" Guix System
"altlinux" ALT Linux
============== =========================================
If you have a need to get distros for reliable IDs added into this set,
or if you find that the :func:`distro.id` function returns a different
distro ID for one of the listed distros, please create an issue in the
`distro issue tracker`_.
**Lookup hierarchy and transformations:**
First, the ID is obtained from the following sources, in the specified
order. The first available and non-empty value is used:
* the value of the "ID" attribute of the os-release file,
* the value of the "Distributor ID" attribute returned by the lsb_release
command,
* the first part of the file name of the distro release file,
The so determined ID value then passes the following transformations,
before it is returned by this method:
* it is translated to lower case,
* blanks (which should not be there anyway) are translated to underscores,
* a normalization of the ID is performed, based upon
`normalization tables`_. The purpose of this normalization is to ensure
that the ID is as reliable as possible, even across incompatible changes
in the OS distributions. A common reason for an incompatible change is
the addition of an os-release file, or the addition of the lsb_release
command, with ID values that differ from what was previously determined
from the distro release file name.
"""
return _distro.id()
def name(pretty: bool = False) -> str:
"""
Return the name of the current OS distribution, as a human-readable
string.
If *pretty* is false, the name is returned without version or codename.
(e.g. "CentOS Linux")
If *pretty* is true, the version and codename are appended.
(e.g. "CentOS Linux 7.1.1503 (Core)")
**Lookup hierarchy:**
The name is obtained from the following sources, in the specified order.
The first available and non-empty value is used:
* If *pretty* is false:
- the value of the "NAME" attribute of the os-release file,
- the value of the "Distributor ID" attribute returned by the lsb_release
command,
- the value of the "<name>" field of the distro release file.
* If *pretty* is true:
- the value of the "PRETTY_NAME" attribute of the os-release file,
- the value of the "Description" attribute returned by the lsb_release
command,
- the value of the "<name>" field of the distro release file, appended
with the value of the pretty version ("<version_id>" and "<codename>"
fields) of the distro release file, if available.
"""
return _distro.name(pretty)
def version(pretty: bool = False, best: bool = False) -> str:
"""
Return the version of the current OS distribution, as a human-readable
string.
If *pretty* is false, the version is returned without codename (e.g.
"7.0").
If *pretty* is true, the codename in parenthesis is appended, if the
codename is non-empty (e.g. "7.0 (Maipo)").
Some distributions provide version numbers with different precisions in
the different sources of distribution information. Examining the different
sources in a fixed priority order does not always yield the most precise
version (e.g. for Debian 8.2, or CentOS 7.1).
Some other distributions may not provide this kind of information. In these
cases, an empty string would be returned. This behavior can be observed
with rolling releases distributions (e.g. Arch Linux).
The *best* parameter can be used to control the approach for the returned
version:
If *best* is false, the first non-empty version number in priority order of
the examined sources is returned.
If *best* is true, the most precise version number out of all examined
sources is returned.
**Lookup hierarchy:**
In all cases, the version number is obtained from the following sources.
If *best* is false, this order represents the priority order:
* the value of the "VERSION_ID" attribute of the os-release file,
* the value of the "Release" attribute returned by the lsb_release
command,
* the version number parsed from the "<version_id>" field of the first line
of the distro release file,
* the version number parsed from the "PRETTY_NAME" attribute of the
os-release file, if it follows the format of the distro release files.
* the version number parsed from the "Description" attribute returned by
the lsb_release command, if it follows the format of the distro release
files.
"""
return _distro.version(pretty, best)
def version_parts(best: bool = False) -> Tuple[str, str, str]:
"""
Return the version of the current OS distribution as a tuple
``(major, minor, build_number)`` with items as follows:
* ``major``: The result of :func:`distro.major_version`.
* ``minor``: The result of :func:`distro.minor_version`.
* ``build_number``: The result of :func:`distro.build_number`.
For a description of the *best* parameter, see the :func:`distro.version`
method.
"""
return _distro.version_parts(best)
def major_version(best: bool = False) -> str:
"""
Return the major version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The major version is the first
part of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
"""
return _distro.major_version(best)
def minor_version(best: bool = False) -> str:
"""
Return the minor version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The minor version is the second
part of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
"""
return _distro.minor_version(best)
def build_number(best: bool = False) -> str:
"""
Return the build number of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The build number is the third part
of the dot-separated version string.
For a description of the *best* parameter, see the :func:`distro.version`
method.
"""
return _distro.build_number(best)
def like() -> str:
"""
Return a space-separated list of distro IDs of distributions that are
closely related to the current OS distribution in regards to packaging
and programming interfaces, for example distributions the current
distribution is a derivative from.
**Lookup hierarchy:**
This information item is only provided by the os-release file.
For details, see the description of the "ID_LIKE" attribute in the
`os-release man page
<http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
"""
return _distro.like()
def codename() -> str:
"""
Return the codename for the release of the current OS distribution,
as a string.
If the distribution does not have a codename, an empty string is returned.
Note that the returned codename is not always really a codename. For
example, openSUSE returns "x86_64". This function does not handle such
cases in any special way and just returns the string it finds, if any.
**Lookup hierarchy:**
* the codename within the "VERSION" attribute of the os-release file, if
provided,
* the value of the "Codename" attribute returned by the lsb_release
command,
* the value of the "<codename>" field of the distro release file.
"""
return _distro.codename()
def info(pretty: bool = False, best: bool = False) -> InfoDict:
"""
Return certain machine-readable information items about the current OS
distribution in a dictionary, as shown in the following example:
.. sourcecode:: python
{
'id': 'rhel',
'version': '7.0',
'version_parts': {
'major': '7',
'minor': '0',
'build_number': ''
},
'like': 'fedora',
'codename': 'Maipo'
}
The dictionary structure and keys are always the same, regardless of which
information items are available in the underlying data sources. The values
for the various keys are as follows:
* ``id``: The result of :func:`distro.id`.
* ``version``: The result of :func:`distro.version`.
* ``version_parts -> major``: The result of :func:`distro.major_version`.
* ``version_parts -> minor``: The result of :func:`distro.minor_version`.
* ``version_parts -> build_number``: The result of
:func:`distro.build_number`.
* ``like``: The result of :func:`distro.like`.
* ``codename``: The result of :func:`distro.codename`.
For a description of the *pretty* and *best* parameters, see the
:func:`distro.version` method.
"""
return _distro.info(pretty, best)
def os_release_info() -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information items
from the os-release file data source of the current OS distribution.
See `os-release file`_ for details about these information items.
"""
return _distro.os_release_info()
def lsb_release_info() -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information items
from the lsb_release command data source of the current OS distribution.
See `lsb_release command output`_ for details about these information
items.
"""
return _distro.lsb_release_info()
def distro_release_info() -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.
See `distro release file`_ for details about these information items.
"""
return _distro.distro_release_info()
def uname_info() -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.
"""
return _distro.uname_info()
def os_release_attr(attribute: str) -> str:
"""
Return a single named information item from the os-release file data source
of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `os-release file`_ for details about these information items.
"""
return _distro.os_release_attr(attribute)
def lsb_release_attr(attribute: str) -> str:
"""
Return a single named information item from the lsb_release command output
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `lsb_release command output`_ for details about these information
items.
"""
return _distro.lsb_release_attr(attribute)
def distro_release_attr(attribute: str) -> str:
"""
Return a single named information item from the distro release file
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
See `distro release file`_ for details about these information items.
"""
return _distro.distro_release_attr(attribute)
def uname_attr(attribute: str) -> str:
"""
Return a single named information item from the distro release file
data source of the current OS distribution.
Parameters:
* ``attribute`` (string): Key of the information item.
Returns:
* (string): Value of the information item, if the item exists.
The empty string, if the item does not exist.
"""
return _distro.uname_attr(attribute)
try:
from functools import cached_property
except ImportError:
# Python < 3.8
class cached_property: # type: ignore
"""A version of @property which caches the value. On access, it calls the
underlying function and sets the value in `__dict__` so future accesses
will not re-call the property.
"""
def __init__(self, f: Callable[[Any], Any]) -> None:
self._fname = f.__name__
self._f = f
def __get__(self, obj: Any, owner: Type[Any]) -> Any:
assert obj is not None, f"call {self._fname} on an instance"
ret = obj.__dict__[self._fname] = self._f(obj)
return ret
class LinuxDistribution:
"""
Provides information about a OS distribution.
This package creates a private module-global instance of this class with
default initialization arguments, that is used by the
`consolidated accessor functions`_ and `single source accessor functions`_.
By using default initialization arguments, that module-global instance
returns data about the current OS distribution (i.e. the distro this
package runs on).
Normally, it is not necessary to create additional instances of this class.
However, in situations where control is needed over the exact data sources
that are used, instances of this class can be created with a specific
distro release file, or a specific os-release file, or without invoking the
lsb_release command.
"""
def __init__(
self,
include_lsb: Optional[bool] = None,
os_release_file: str = "",
distro_release_file: str = "",
include_uname: Optional[bool] = None,
root_dir: Optional[str] = None,
include_oslevel: Optional[bool] = None,
) -> None:
"""
The initialization method of this class gathers information from the
available data sources, and stores that in private instance attributes.
Subsequent access to the information items uses these private instance
attributes, so that the data sources are read only once.
Parameters:
* ``include_lsb`` (bool): Controls whether the
`lsb_release command output`_ is included as a data source.
If the lsb_release command is not available in the program execution
path, the data source for the lsb_release command will be empty.
* ``os_release_file`` (string): The path name of the
`os-release file`_ that is to be used as a data source.
An empty string (the default) will cause the default path name to
be used (see `os-release file`_ for details).
If the specified or defaulted os-release file does not exist, the
data source for the os-release file will be empty.
* ``distro_release_file`` (string): The path name of the
`distro release file`_ that is to be used as a data source.
An empty string (the default) will cause a default search algorithm
to be used (see `distro release file`_ for details).
If the specified distro release file does not exist, or if no default
distro release file can be found, the data source for the distro
release file will be empty.
* ``include_uname`` (bool): Controls whether uname command output is
included as a data source. If the uname command is not available in
the program execution path the data source for the uname command will
be empty.
* ``root_dir`` (string): The absolute path to the root directory to use
to find distro-related information files. Note that ``include_*``
parameters must not be enabled in combination with ``root_dir``.
* ``include_oslevel`` (bool): Controls whether (AIX) oslevel command
output is included as a data source. If the oslevel command is not
available in the program execution path the data source will be
empty.
Public instance attributes:
* ``os_release_file`` (string): The path name of the
`os-release file`_ that is actually used as a data source. The
empty string if no distro release file is used as a data source.
* ``distro_release_file`` (string): The path name of the
`distro release file`_ that is actually used as a data source. The
empty string if no distro release file is used as a data source.
* ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
This controls whether the lsb information will be loaded.
* ``include_uname`` (bool): The result of the ``include_uname``
parameter. This controls whether the uname information will
be loaded.
* ``include_oslevel`` (bool): The result of the ``include_oslevel``
parameter. This controls whether (AIX) oslevel information will be
loaded.
* ``root_dir`` (string): The result of the ``root_dir`` parameter.
The absolute path to the root directory to use to find distro-related
information files.
Raises:
* :py:exc:`ValueError`: Initialization parameters combination is not
supported.
* :py:exc:`OSError`: Some I/O issue with an os-release file or distro
release file.
* :py:exc:`UnicodeError`: A data source has unexpected characters or
uses an unexpected encoding.
"""
self.root_dir = root_dir
self.etc_dir = os.path.join(root_dir, "etc") if root_dir else _UNIXCONFDIR
self.usr_lib_dir = (
os.path.join(root_dir, "usr/lib") if root_dir else _UNIXUSRLIBDIR
)
if os_release_file:
self.os_release_file = os_release_file
else:
etc_dir_os_release_file = os.path.join(self.etc_dir, _OS_RELEASE_BASENAME)
usr_lib_os_release_file = os.path.join(
self.usr_lib_dir, _OS_RELEASE_BASENAME
)
# NOTE: The idea is to respect order **and** have it set
# at all times for API backwards compatibility.
if os.path.isfile(etc_dir_os_release_file) or not os.path.isfile(
usr_lib_os_release_file
):
self.os_release_file = etc_dir_os_release_file
else:
self.os_release_file = usr_lib_os_release_file
self.distro_release_file = distro_release_file or "" # updated later
is_root_dir_defined = root_dir is not None
if is_root_dir_defined and (include_lsb or include_uname or include_oslevel):
raise ValueError(
"Including subprocess data sources from specific root_dir is disallowed"
" to prevent false information"
)
self.include_lsb = (
include_lsb if include_lsb is not None else not is_root_dir_defined
)
self.include_uname = (
include_uname if include_uname is not None else not is_root_dir_defined
)
self.include_oslevel = (
include_oslevel if include_oslevel is not None else not is_root_dir_defined
)
def __repr__(self) -> str:
"""Return repr of all info"""
return (
"LinuxDistribution("
"os_release_file={self.os_release_file!r}, "
"distro_release_file={self.distro_release_file!r}, "
"include_lsb={self.include_lsb!r}, "
"include_uname={self.include_uname!r}, "
"include_oslevel={self.include_oslevel!r}, "
"root_dir={self.root_dir!r}, "
"_os_release_info={self._os_release_info!r}, "
"_lsb_release_info={self._lsb_release_info!r}, "
"_distro_release_info={self._distro_release_info!r}, "
"_uname_info={self._uname_info!r}, "
"_oslevel_info={self._oslevel_info!r})".format(self=self)
)
def linux_distribution(
self, full_distribution_name: bool = True
) -> Tuple[str, str, str]:
"""
Return information about the OS distribution that is compatible
with Python's :func:`platform.linux_distribution`, supporting a subset
of its parameters.
For details, see :func:`distro.linux_distribution`.
"""
return (
self.name() if full_distribution_name else self.id(),
self.version(),
self._os_release_info.get("release_codename") or self.codename(),
)
def id(self) -> str:
"""Return the distro ID of the OS distribution, as a string.
For details, see :func:`distro.id`.
"""
def normalize(distro_id: str, table: Dict[str, str]) -> str:
distro_id = distro_id.lower().replace(" ", "_")
return table.get(distro_id, distro_id)
distro_id = self.os_release_attr("id")
if distro_id:
return normalize(distro_id, NORMALIZED_OS_ID)
distro_id = self.lsb_release_attr("distributor_id")
if distro_id:
return normalize(distro_id, NORMALIZED_LSB_ID)
distro_id = self.distro_release_attr("id")
if distro_id:
return normalize(distro_id, NORMALIZED_DISTRO_ID)
distro_id = self.uname_attr("id")
if distro_id:
return normalize(distro_id, NORMALIZED_DISTRO_ID)
return ""
def name(self, pretty: bool = False) -> str:
"""
Return the name of the OS distribution, as a string.
For details, see :func:`distro.name`.
"""
name = (
self.os_release_attr("name")
or self.lsb_release_attr("distributor_id")
or self.distro_release_attr("name")
or self.uname_attr("name")
)
if pretty:
name = self.os_release_attr("pretty_name") or self.lsb_release_attr(
"description"
)
if not name:
name = self.distro_release_attr("name") or self.uname_attr("name")
version = self.version(pretty=True)
if version:
name = f"{name} {version}"
return name or ""
def version(self, pretty: bool = False, best: bool = False) -> str:
"""
Return the version of the OS distribution, as a string.
For details, see :func:`distro.version`.
"""
versions = [
self.os_release_attr("version_id"),
self.lsb_release_attr("release"),
self.distro_release_attr("version_id"),
self._parse_distro_release_content(self.os_release_attr("pretty_name")).get(
"version_id", ""
),
self._parse_distro_release_content(
self.lsb_release_attr("description")
).get("version_id", ""),
self.uname_attr("release"),
]
if self.uname_attr("id").startswith("aix"):
# On AIX platforms, prefer oslevel command output.
versions.insert(0, self.oslevel_info())
elif self.id() == "debian" or "debian" in self.like().split():
# On Debian-like, add debian_version file content to candidates list.
versions.append(self._debian_version)
version = ""
if best:
# This algorithm uses the last version in priority order that has
# the best precision. If the versions are not in conflict, that
# does not matter; otherwise, using the last one instead of the
# first one might be considered a surprise.
for v in versions:
if v.count(".") > version.count(".") or version == "":
version = v
else:
for v in versions:
if v != "":
version = v
break
if pretty and version and self.codename():
version = f"{version} ({self.codename()})"
return version
def version_parts(self, best: bool = False) -> Tuple[str, str, str]:
"""
Return the version of the OS distribution, as a tuple of version
numbers.
For details, see :func:`distro.version_parts`.
"""
version_str = self.version(best=best)
if version_str:
version_regex = re.compile(r"(\d+)\.?(\d+)?\.?(\d+)?")
matches = version_regex.match(version_str)
if matches:
major, minor, build_number = matches.groups()
return major, minor or "", build_number or ""
return "", "", ""
def major_version(self, best: bool = False) -> str:
"""
Return the major version number of the current distribution.
For details, see :func:`distro.major_version`.
"""
return self.version_parts(best)[0]
def minor_version(self, best: bool = False) -> str:
"""
Return the minor version number of the current distribution.
For details, see :func:`distro.minor_version`.
"""
return self.version_parts(best)[1]
def build_number(self, best: bool = False) -> str:
"""
Return the build number of the current distribution.
For details, see :func:`distro.build_number`.
"""
return self.version_parts(best)[2]
def like(self) -> str:
"""
Return the IDs of distributions that are like the OS distribution.
For details, see :func:`distro.like`.
"""
return self.os_release_attr("id_like") or ""
def codename(self) -> str:
"""
Return the codename of the OS distribution.
For details, see :func:`distro.codename`.
"""
try:
# Handle os_release specially since distros might purposefully set
# this to empty string to have no codename
return self._os_release_info["codename"]
except KeyError:
return (
self.lsb_release_attr("codename")
or self.distro_release_attr("codename")
or ""
)
def info(self, pretty: bool = False, best: bool = False) -> InfoDict:
"""
Return certain machine-readable information about the OS
distribution.
For details, see :func:`distro.info`.
"""
return InfoDict(
id=self.id(),
version=self.version(pretty, best),
version_parts=VersionDict(
major=self.major_version(best),
minor=self.minor_version(best),
build_number=self.build_number(best),
),
like=self.like(),
codename=self.codename(),
)
def os_release_info(self) -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information
items from the os-release file data source of the OS distribution.
For details, see :func:`distro.os_release_info`.
"""
return self._os_release_info
def lsb_release_info(self) -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information
items from the lsb_release command data source of the OS
distribution.
For details, see :func:`distro.lsb_release_info`.
"""
return self._lsb_release_info
def distro_release_info(self) -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information
items from the distro release file data source of the OS
distribution.
For details, see :func:`distro.distro_release_info`.
"""
return self._distro_release_info
def uname_info(self) -> Dict[str, str]:
"""
Return a dictionary containing key-value pairs for the information
items from the uname command data source of the OS distribution.
For details, see :func:`distro.uname_info`.
"""
return self._uname_info
def oslevel_info(self) -> str:
"""
Return AIX' oslevel command output.
"""
return self._oslevel_info
def os_release_attr(self, attribute: str) -> str:
"""
Return a single named information item from the os-release file data
source of the OS distribution.
For details, see :func:`distro.os_release_attr`.
"""
return self._os_release_info.get(attribute, "")
def lsb_release_attr(self, attribute: str) -> str:
"""
Return a single named information item from the lsb_release command
output data source of the OS distribution.
For details, see :func:`distro.lsb_release_attr`.
"""
return self._lsb_release_info.get(attribute, "")
def distro_release_attr(self, attribute: str) -> str:
"""
Return a single named information item from the distro release file
data source of the OS distribution.
For details, see :func:`distro.distro_release_attr`.
"""
return self._distro_release_info.get(attribute, "")
def uname_attr(self, attribute: str) -> str:
"""
Return a single named information item from the uname command
output data source of the OS distribution.
For details, see :func:`distro.uname_attr`.
"""
return self._uname_info.get(attribute, "")
@cached_property
def _os_release_info(self) -> Dict[str, str]:
"""
Get the information items from the specified os-release file.
Returns:
A dictionary containing all information items.
"""
if os.path.isfile(self.os_release_file):
with open(self.os_release_file, encoding="utf-8") as release_file:
return self._parse_os_release_content(release_file)
return {}
@staticmethod
def _parse_os_release_content(lines: TextIO) -> Dict[str, str]:
"""
Parse the lines of an os-release file.
Parameters:
* lines: Iterable through the lines in the os-release file.
Each line must be a unicode string or a UTF-8 encoded byte
string.
Returns:
A dictionary containing all information items.
"""
props = {}
lexer = shlex.shlex(lines, posix=True)
lexer.whitespace_split = True
tokens = list(lexer)
for token in tokens:
# At this point, all shell-like parsing has been done (i.e.
# comments processed, quotes and backslash escape sequences
# processed, multi-line values assembled, trailing newlines
# stripped, etc.), so the tokens are now either:
# * variable assignments: var=value
# * commands or their arguments (not allowed in os-release)
# Ignore any tokens that are not variable assignments
if "=" in token:
k, v = token.split("=", 1)
props[k.lower()] = v
if "version" in props:
# extract release codename (if any) from version attribute
match = re.search(r"\((\D+)\)|,\s*(\D+)", props["version"])
if match:
release_codename = match.group(1) or match.group(2)
props["codename"] = props["release_codename"] = release_codename
if "version_codename" in props:
# os-release added a version_codename field. Use that in
# preference to anything else Note that some distros purposefully
# do not have code names. They should be setting
# version_codename=""
props["codename"] = props["version_codename"]
elif "ubuntu_codename" in props:
# Same as above but a non-standard field name used on older Ubuntus
props["codename"] = props["ubuntu_codename"]
return props
@cached_property
def _lsb_release_info(self) -> Dict[str, str]:
"""
Get the information items from the lsb_release command output.
Returns:
A dictionary containing all information items.
"""
if not self.include_lsb:
return {}
try:
cmd = ("lsb_release", "-a")
stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
# Command not found or lsb_release returned error
except (OSError, subprocess.CalledProcessError):
return {}
content = self._to_str(stdout).splitlines()
return self._parse_lsb_release_content(content)
@staticmethod
def _parse_lsb_release_content(lines: Iterable[str]) -> Dict[str, str]:
"""
Parse the output of the lsb_release command.
Parameters:
* lines: Iterable through the lines of the lsb_release output.
Each line must be a unicode string or a UTF-8 encoded byte
string.
Returns:
A dictionary containing all information items.
"""
props = {}
for line in lines:
kv = line.strip("\n").split(":", 1)
if len(kv) != 2:
# Ignore lines without colon.
continue
k, v = kv
props.update({k.replace(" ", "_").lower(): v.strip()})
return props
@cached_property
def _uname_info(self) -> Dict[str, str]:
if not self.include_uname:
return {}
try:
cmd = ("uname", "-rs")
stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
except OSError:
return {}
content = self._to_str(stdout).splitlines()
return self._parse_uname_content(content)
@cached_property
def _oslevel_info(self) -> str:
if not self.include_oslevel:
return ""
try:
stdout = subprocess.check_output("oslevel", stderr=subprocess.DEVNULL)
except (OSError, subprocess.CalledProcessError):
return ""
return self._to_str(stdout).strip()
@cached_property
def _debian_version(self) -> str:
try:
with open(
os.path.join(self.etc_dir, "debian_version"), encoding="ascii"
) as fp:
return fp.readline().rstrip()
except FileNotFoundError:
return ""
@staticmethod
def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]:
if not lines:
return {}
props = {}
match = re.search(r"^([^\s]+)\s+([\d\.]+)", lines[0].strip())
if match:
name, version = match.groups()
# This is to prevent the Linux kernel version from
# appearing as the 'best' version on otherwise
# identifiable distributions.
if name == "Linux":
return {}
props["id"] = name.lower()
props["name"] = name
props["release"] = version
return props
@staticmethod
def _to_str(bytestring: bytes) -> str:
encoding = sys.getfilesystemencoding()
return bytestring.decode(encoding)
@cached_property
def _distro_release_info(self) -> Dict[str, str]:
"""
Get the information items from the specified distro release file.
Returns:
A dictionary containing all information items.
"""
if self.distro_release_file:
# If it was specified, we use it and parse what we can, even if
# its file name or content does not match the expected pattern.
distro_info = self._parse_distro_release_file(self.distro_release_file)
basename = os.path.basename(self.distro_release_file)
# The file name pattern for user-specified distro release files
# is somewhat more tolerant (compared to when searching for the
# file), because we want to use what was specified as best as
# possible.
match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
else:
try:
basenames = [
basename
for basename in os.listdir(self.etc_dir)
if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES
and os.path.isfile(os.path.join(self.etc_dir, basename))
]
# We sort for repeatability in cases where there are multiple
# distro specific files; e.g. CentOS, Oracle, Enterprise all
# containing `redhat-release` on top of their own.
basenames.sort()
except OSError:
# This may occur when /etc is not readable but we can't be
# sure about the *-release files. Check common entries of
# /etc for information. If they turn out to not be there the
# error is handled in `_parse_distro_release_file()`.
basenames = _DISTRO_RELEASE_BASENAMES
for basename in basenames:
match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
if match is None:
continue
filepath = os.path.join(self.etc_dir, basename)
distro_info = self._parse_distro_release_file(filepath)
# The name is always present if the pattern matches.
if "name" not in distro_info:
continue
self.distro_release_file = filepath
break
else: # the loop didn't "break": no candidate.
return {}
if match is not None:
distro_info["id"] = match.group(1)
# CloudLinux < 7: manually enrich info with proper id.
if "cloudlinux" in distro_info.get("name", "").lower():
distro_info["id"] = "cloudlinux"
return distro_info
def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]:
"""
Parse a distro release file.
Parameters:
* filepath: Path name of the distro release file.
Returns:
A dictionary containing all information items.
"""
try:
with open(filepath, encoding="utf-8") as fp:
# Only parse the first line. For instance, on SLES there
# are multiple lines. We don't want them...
return self._parse_distro_release_content(fp.readline())
except OSError:
# Ignore not being able to read a specific, seemingly version
# related file.
# See https://github.com/python-distro/distro/issues/162
return {}
@staticmethod
def _parse_distro_release_content(line: str) -> Dict[str, str]:
"""
Parse a line from a distro release file.
Parameters:
* line: Line from the distro release file. Must be a unicode string
or a UTF-8 encoded byte string.
Returns:
A dictionary containing all information items.
"""
matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(line.strip()[::-1])
distro_info = {}
if matches:
# regexp ensures non-None
distro_info["name"] = matches.group(3)[::-1]
if matches.group(2):
distro_info["version_id"] = matches.group(2)[::-1]
if matches.group(1):
distro_info["codename"] = matches.group(1)[::-1]
elif line:
distro_info["name"] = line.strip()
return distro_info
_distro = LinuxDistribution()
def main() -> None:
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
logger.addHandler(logging.StreamHandler(sys.stdout))
parser = argparse.ArgumentParser(description="OS distro info tool")
parser.add_argument(
"--json", "-j", help="Output in machine readable format", action="store_true"
)
parser.add_argument(
"--root-dir",
"-r",
type=str,
dest="root_dir",
help="Path to the root filesystem directory (defaults to /)",
)
args = parser.parse_args()
if args.root_dir:
dist = LinuxDistribution(
include_lsb=False,
include_uname=False,
include_oslevel=False,
root_dir=args.root_dir,
)
else:
dist = _distro
if args.json:
logger.info(json.dumps(dist.info(), indent=4, sort_keys=True))
else:
logger.info("Name: %s", dist.name(pretty=True))
distribution_version = dist.version(pretty=True)
logger.info("Version: %s", distribution_version)
distribution_codename = dist.codename()
logger.info("Codename: %s", distribution_codename)
if __name__ == "__main__":
main()
PK 8Eu\� +[ [ agent360-1.3.1.dist-info/WHEELnu �[��� Wheel-Version: 1.0
Generator: setuptools (75.3.0)
Root-Is-Purelib: true
Tag: py3-none-any
PK ;Eu\�fc�3 3 agent360-1.3.1.dist-info/LICENSEnu �[��� BSD Simplified License
Copyright (c) 2021, Plesk International GmbH <vincent.vanmegen@webpros.com>
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
PK =Eu\#X�D& D& agent360-1.3.1.dist-info/RECORDnu �[��� ../../../bin/agent360,sha256=B0m6tR1wlh0Q_6RtwWYVU_xP27jdSWtguEq_0ynISEQ,216
../../../bin/hello360,sha256=RI0JCeyIXruYtOrG2QikB76dKCbpkJq_vI_uH9jL23g,218
../../../share/doc/agent360/LICENSE,sha256=rlX8l535b1VXIQ6lk-YDSV5nFQ-pkftddB61x8XTR68,1587
../../../share/doc/agent360/README.md,sha256=AVkUGuQF4v0ehLkj-fQk6XEQzhDgWBUENZBAhnDdfs8,3494
../../../share/doc/agent360/agent360-example.ini,sha256=RPmnYns6aQ0vh_QwxGmSqaFrotMD4ySW4LVf1QZWPZE,1558
agent360-1.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
agent360-1.3.1.dist-info/LICENSE,sha256=rlX8l535b1VXIQ6lk-YDSV5nFQ-pkftddB61x8XTR68,1587
agent360-1.3.1.dist-info/METADATA,sha256=Yy214Zx_1J_qw5noeQH5fh3g1gsYWoeyKjgQZYMrjKc,4524
agent360-1.3.1.dist-info/RECORD,,
agent360-1.3.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
agent360-1.3.1.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
agent360-1.3.1.dist-info/entry_points.txt,sha256=fm63-mUwnvIDDP9D0uK8usm7CFmIKMxZ_-OnVgMtvPs,87
agent360-1.3.1.dist-info/top_level.txt,sha256=nEiBZhAn7vjXpeOJoErGJwWdcxFTRWLKCV9erQ3uNhQ,9
agent360/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
agent360/__pycache__/__init__.cpython-39.pyc,,
agent360/__pycache__/agent360.cpython-39.pyc,,
agent360/agent360.py,sha256=7E2G_f_3_Dl0NQ-QHvj_9wusCXIu4-Yjk5p9_KjOtrI,28651
agent360/plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
agent360/plugins/__pycache__/__init__.cpython-39.pyc,,
agent360/plugins/__pycache__/apt-updates.cpython-39.pyc,,
agent360/plugins/__pycache__/asterisk.cpython-39.pyc,,
agent360/plugins/__pycache__/bind.cpython-39.pyc,,
agent360/plugins/__pycache__/bird.cpython-39.pyc,,
agent360/plugins/__pycache__/bitninja.cpython-39.pyc,,
agent360/plugins/__pycache__/cloudlinux-dbgov.cpython-39.pyc,,
agent360/plugins/__pycache__/cloudlinux.cpython-39.pyc,,
agent360/plugins/__pycache__/cpanel.cpython-39.pyc,,
agent360/plugins/__pycache__/cpu.cpython-39.pyc,,
agent360/plugins/__pycache__/cpu_freq.cpython-39.pyc,,
agent360/plugins/__pycache__/dirsize.cpython-39.pyc,,
agent360/plugins/__pycache__/diskinodes.cpython-39.pyc,,
agent360/plugins/__pycache__/diskstatus-nvme.cpython-39.pyc,,
agent360/plugins/__pycache__/diskstatus.cpython-39.pyc,,
agent360/plugins/__pycache__/diskusage.cpython-39.pyc,,
agent360/plugins/__pycache__/docker.cpython-39.pyc,,
agent360/plugins/__pycache__/dovecot.cpython-39.pyc,,
agent360/plugins/__pycache__/elasticsearch.cpython-39.pyc,,
agent360/plugins/__pycache__/exim.cpython-39.pyc,,
agent360/plugins/__pycache__/fail2ban.cpython-39.pyc,,
agent360/plugins/__pycache__/gpu.cpython-39.pyc,,
agent360/plugins/__pycache__/haproxy.cpython-39.pyc,,
agent360/plugins/__pycache__/httpd.cpython-39.pyc,,
agent360/plugins/__pycache__/iostat.cpython-39.pyc,,
agent360/plugins/__pycache__/janus.cpython-39.pyc,,
agent360/plugins/__pycache__/kamailio.cpython-39.pyc,,
agent360/plugins/__pycache__/litespeed.cpython-39.pyc,,
agent360/plugins/__pycache__/loadavg.cpython-39.pyc,,
agent360/plugins/__pycache__/loggedin.cpython-39.pyc,,
agent360/plugins/__pycache__/mailq.cpython-39.pyc,,
agent360/plugins/__pycache__/mdstat.cpython-39.pyc,,
agent360/plugins/__pycache__/megacli.cpython-39.pyc,,
agent360/plugins/__pycache__/memcached.cpython-39.pyc,,
agent360/plugins/__pycache__/memory.cpython-39.pyc,,
agent360/plugins/__pycache__/minecraft.cpython-39.pyc,,
agent360/plugins/__pycache__/mongodb.cpython-39.pyc,,
agent360/plugins/__pycache__/mysql.cpython-39.pyc,,
agent360/plugins/__pycache__/network.cpython-39.pyc,,
agent360/plugins/__pycache__/nginx.cpython-39.pyc,,
agent360/plugins/__pycache__/openvpn.cpython-39.pyc,,
agent360/plugins/__pycache__/phpfpm.cpython-39.pyc,,
agent360/plugins/__pycache__/ping.cpython-39.pyc,,
agent360/plugins/__pycache__/plesk-cgroups.cpython-39.pyc,,
agent360/plugins/__pycache__/plugins.cpython-39.pyc,,
agent360/plugins/__pycache__/postfix.cpython-39.pyc,,
agent360/plugins/__pycache__/powerdns.cpython-39.pyc,,
agent360/plugins/__pycache__/process.cpython-39.pyc,,
agent360/plugins/__pycache__/proftpd.cpython-39.pyc,,
agent360/plugins/__pycache__/rabbitmq.cpython-39.pyc,,
agent360/plugins/__pycache__/redis_stat.cpython-39.pyc,,
agent360/plugins/__pycache__/sleeper.cpython-39.pyc,,
agent360/plugins/__pycache__/swap.cpython-39.pyc,,
agent360/plugins/__pycache__/system.cpython-39.pyc,,
agent360/plugins/__pycache__/tcpports.cpython-39.pyc,,
agent360/plugins/__pycache__/temp.cpython-39.pyc,,
agent360/plugins/__pycache__/unbound.cpython-39.pyc,,
agent360/plugins/__pycache__/vms.cpython-39.pyc,,
agent360/plugins/__pycache__/wp-toolkit.cpython-39.pyc,,
agent360/plugins/__pycache__/yum-updates.cpython-39.pyc,,
agent360/plugins/apt-updates.py,sha256=J_GHiJa1hIZ_Kz1EL6fU8d52uUWpMgtbrJewu8sft3I,1260
agent360/plugins/asterisk.py,sha256=ZjWqeDwvjYVeTI3siUDVh_IpNHND249aJHGRQFeDQnE,1012
agent360/plugins/bind.py,sha256=5Nrkvb5ZWWtNHLT4NitUQghad7uTZEIvXShBEZIbpQc,732
agent360/plugins/bird.py,sha256=sTfJVI1x0GuaDX2MmVgTtx9ZGjjAvEZT-yUywvDTYl4,841
agent360/plugins/bitninja.py,sha256=hJGFYFLI0GoC6t9r09FxSJKA0duw9KIYuvXLNYA2cos,1302
agent360/plugins/cloudlinux-dbgov.py,sha256=z-54qxZeDuWuFlaRZzPb6Y7KTIba4GndBpqz1OZg8ic,1066
agent360/plugins/cloudlinux.py,sha256=lVsMoGhvaxCZQ9syZ4fR8SLB2lpEH-iCHpjyHtyWGuE,1020
agent360/plugins/cpanel.py,sha256=9ZjWYyo8OO9SlLaCyiur0cVS4r8kt5ip550qB-BJVTE,1441
agent360/plugins/cpu.py,sha256=2wH_xaqxzgHPKRe0iiNBao6Xu6sWI0O6z4xDrAEAEak,2020
agent360/plugins/cpu_freq.py,sha256=PSO0Sn_u5OgesWhJ2yA1577uni8I1xxa6R9ItMPSrko,583
agent360/plugins/dirsize.py,sha256=hmlhIcdhFls-E2qqvB_-f8679pJcnftQn_6qDcGvIE4,617
agent360/plugins/diskinodes.py,sha256=0QB930_72RSETzZFyZo52eXABnv0cvVHajRZmz2-wWc,652
agent360/plugins/diskstatus-nvme.py,sha256=3yf4H33PDZGIpVz8xq3ELmHgH5eVWlOhAEuvt9EJkQg,1618
agent360/plugins/diskstatus.py,sha256=iFG4eHOLYr2ajUrvhPnqj-d64nEfQTXGbvreIBEZLbA,2005
agent360/plugins/diskusage.py,sha256=hXjAWw4OH8kXtgkLn-RjFfdUE6fJS4xi0lD9ABRupAQ,4140
agent360/plugins/docker.py,sha256=C2J8gpqfpZezd-AqgchEwW3PL1f_B2H2OhGfJJJcSn0,3442
agent360/plugins/dovecot.py,sha256=Q2eOrA2fKOcAi-YS8Fk4dGZG5Id_5P-UEijNBRLmP-c,1304
agent360/plugins/elasticsearch.py,sha256=FKhwWAgnS5w5mbmMIegwOQjFmLm4uexv7aKyHbJt4FE,4342
agent360/plugins/exim.py,sha256=G29PLSuvZJnsSH-SgpfVpjWG_xiu4mAXXbV37QelIKY,484
agent360/plugins/fail2ban.py,sha256=zWZtBGt3s5J41ap0VvjuLJiYN8S_-pou9ewIdokf7E4,831
agent360/plugins/gpu.py,sha256=skd5NVE5CSNPemgp_VQOC4zh32kAhjlTX6PD8TlnzfU,959
agent360/plugins/haproxy.py,sha256=A3jfTp3XrtARDWNhULZX237LVBRLioyPpDS9eGayaY4,4274
agent360/plugins/httpd.py,sha256=rOXffo8oourMfWhTbSiyqvkP6Y66AzaJXkNrMRgF-vM,2800
agent360/plugins/iostat.py,sha256=06vIVDraZhs1_KSSmO7M9CqY_d02wiXT3ihBbe4zVfk,5227
agent360/plugins/janus.py,sha256=kEx750HYckpq2ytOM20HxFlVWgXkUetPh3Db4Btku_0,705
agent360/plugins/kamailio.py,sha256=pdVEqCjK5un1KxaRl7o4as5LdhGQvltO7hunt1us3LU,556
agent360/plugins/litespeed.py,sha256=BPkc6IQWqn1kNn--I-m3z2SBscBIgmMbH--BRsRWPaM,3114
agent360/plugins/loadavg.py,sha256=RUcVOW0ARuWdu1z1quiEadCyhA_f1cqw0i6Qz0hCjKE,332
agent360/plugins/loggedin.py,sha256=b75Ytq4pI009wngG1TvR613vbRp6rWAFVg0leWR63wI,400
agent360/plugins/mailq.py,sha256=E8A_RxVVoQZtFW8TuRegX4mSC9SkBNnsaBCDGl9JFIo,528
agent360/plugins/mdstat.py,sha256=JsgShooY7H9gFsUHnXtNAuC88IIPFG5RtY1LRaTkTN0,1388
agent360/plugins/megacli.py,sha256=OicA97qoISTlIoqUIVh2Q713u3iVt4rBkzSxgNardc0,2787
agent360/plugins/memcached.py,sha256=GG7baBI6lyUf9ayltTj0b3bnbI1S-tlHFCLbiWbZ7l0,3165
agent360/plugins/memory.py,sha256=j7opFfwpxIlklSepaO19PEkSErWv5N20bK_0qOVBzK4,932
agent360/plugins/minecraft.py,sha256=H47Sz4b5mecv1A8Qe9DJTffSD8cwkk0afROnrZL_qEs,2410
agent360/plugins/mongodb.py,sha256=hiJC04IxeB3JeMB3vU81XJms8f43JlZQK7MLaeJcFa4,5766
agent360/plugins/mysql.py,sha256=zA7N0s0cZr2-x3Z_x0n2KhiNPzdiaGAlu_QX7ojGKvo,5256
agent360/plugins/network.py,sha256=9AwWtLKIiQvBgoVRf1Bqn77g6h-7rlzqbhtk5l18D1E,2786
agent360/plugins/nginx.py,sha256=5N813PVo4Pq55Qgyf9nPWNJwyv5Cz1KEB_RpVQ3I148,3275
agent360/plugins/openvpn.py,sha256=GnK_mBggxVugVcf0fYdmO625cYXrh9FNbWYTCa1D6jk,2223
agent360/plugins/phpfpm.py,sha256=2vAKevVETekmINjx4IUI3eeWOJuH0Vh_0LNgsh45sa0,2781
agent360/plugins/ping.py,sha256=Gcv7OTNMz0zSQG_jmuMWNQkG4Y8mSfn4tcAd8K4wWgc,3165
agent360/plugins/plesk-cgroups.py,sha256=O-sfLzwxcLVvs3k7NTmomHDj30Y60FwWsxokIDr-xjw,6330
agent360/plugins/plugins.py,sha256=uqAfswqOxJ4W3S2O29al_cc2lUw-riihkOgeiy2WhrU,2538
agent360/plugins/postfix.py,sha256=Cwt1YHi4ck17rKHPUhUvgHxi06x-ewQpuslBC91fCrU,1774
agent360/plugins/powerdns.py,sha256=eFsyyvMCfjj056DlP0ZEX72vC8zDAOauX88jQcQoYz4,4669
agent360/plugins/process.py,sha256=GlAg2MRsLn9Zhadxl6oCmHLfu7dWEGHyxuV51bSHEPg,4365
agent360/plugins/proftpd.py,sha256=E0PPEaOQxPCAZi2wkMXQdx0Mc7ud2k0zfYPxkGdzWA0,1130
agent360/plugins/rabbitmq.py,sha256=LXlhROb8MgzsJBUdbxtOTJ9wvQenk_MZOh6iQzQIOoo,3569
agent360/plugins/redis_stat.py,sha256=VwdCK8Qba0DShBpoH1it_GmRoCz7Cap3uubhQiU0FgI,5615
agent360/plugins/sleeper.py,sha256=eu1Hh1Ut95PIUVn9e80IX9HPiQZ7J5Xki05nr7Jig8g,244
agent360/plugins/swap.py,sha256=dM2tMUevsg5z427xVq3GqOofGls9UhO__nZ8ieuDuMw,364
agent360/plugins/system.py,sha256=kVNxjnEsqrHW-qYTNCHY6d11RdeqJ8RXPp1a-lXPehs,5811
agent360/plugins/tcpports.py,sha256=j1K94S3y40M8W8pAjX0JAswax8xvgTqgmr-ZzG1XSEM,1110
agent360/plugins/temp.py,sha256=tEdkXbq4J8Po6YfwJtjVgnXaaVfKv0norua4Kcr1kaw,1480
agent360/plugins/unbound.py,sha256=4uwzh5R0vdcQIsmq6xrQrU007svcKAGo6C7AwBQa1Lw,3316
agent360/plugins/vms.py,sha256=ybUqoznYgxtCTcFCifhwiTWpzBZb9e0PuaFR1qOLNjc,6352
agent360/plugins/wp-toolkit.py,sha256=3ZPaD1q_K2gD_VziTvnqhVV39VrlaP10XaC9UQF5mvY,1845
agent360/plugins/yum-updates.py,sha256=5U22i0LIa6FfXJnhJK1u3FpM4VQQbmfTLQi6MntSrug,810
PK BEu\��� � ! agent360-1.3.1.dist-info/METADATAnu �[��� Metadata-Version: 2.1
Name: agent360
Version: 1.3.1
Summary: 360 agent
Home-page: https://github.com/plesk/agent360
Author: 360
Author-email: 360support@webpros.com
Maintainer: 360
Maintainer-email: 360support@webpros.com
License: BSD-3-Clause
Keywords: 360 system monitoring agent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Monitoring
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: psutil
Requires-Dist: netifaces
Requires-Dist: configparser
Requires-Dist: future
Requires-Dist: distro
Requires-Dist: certifi
# Agent360
360 Monitoring ([360monitoring.com](https://360monitoring.com)) is a web service that monitors and displays statistics of
your server performance.
Agent360 is OS agnostic software compatible with Python 3.7 and 3.8.
It's been optimized to have low CPU consumption and comes with an
extendable set of useful plugins.
[](https://github.com/plesk/agent360/actions/workflows/test-and-deploy.yml)
## Documentation
You can find the full documentation including the feature complete REST API at [docs.360monitoring.com](https://docs.360monitoring.com/docs) and [docs.360monitoring.com/docs/api](https://docs.360monitoring.com/docs/api).
## Automatic Installation (All Linux Distributions)
You can install the default configuration of Agent360 on all Linux distributions with just one click.
1. Connect to your server via SSH.
2. Find your USERTOKEN. To do so, [go to the servers page](https://monitoring.platform360.io/servers/overview) and then click the "Add server" button.
3. Run the following command:
```sh
wget -q -N https://monitoring.platform360.io/agent360.sh && bash agent360.sh USERTOKEN
```
## Automatic Installation (Windows)
Download the [setup](https://github.com/plesk/agent360/releases) and install it on your Windows server.
The installer will ask for your USERTOKEN which you can get [from the servers page](https://monitoring.platform360.io/servers/overview).
## Manual Installation
To customize installation options, install Agent360 manually.
1. Connect to your server via SSH.
2. Run the following command, which differs depending on your server platform:
- Debian GNU/Linux:
```sh
apt-get install python3-dev python3-setuptools python3-pip
pip3 install agent360
wget -O /etc/agent360.ini https://monitoring.platform360.io/agent360.ini
```
- Fedora/CentOS version 6 or earlier (python 2.7):
```sh
yum install python-devel python-setuptools gcc
easy_install agent360 netifaces psutil
wget -O /etc/agent360.ini https://monitoring.platform360.io/agent360.ini
```
- Fedora/CentOS version 7 and later (python 3):
```sh
yum install python36-devel python36 gcc
pip3 install agent360
wget -O /etc/agent360.ini https://monitoring.platform360.io/agent360.ini
```
3. Find your USERTOKEN. To do so, [go to the servers page](https://monitoring.platform360.io/servers/overview) and then click the "Add server" button. You need this to generate a serverid.
4. Run the following command (USERTOKEN is the one you got during the previous step):
```sh
agent360 hello USERTOKEN /etc/agent360-token.ini
```
5. Create a systemd service at `/etc/systemd/system/agent360.service` by adding the following:
```ini
[Unit]
Description=Agent360
[Service]
ExecStart=/usr/local/bin/agent360
User=agent360
[Install]
WantedBy=multi-user.target
```
6. Run the following command:
```sh
chmod 644 /etc/systemd/system/agent360.service
systemctl daemon-reload
systemctl enable agent360
systemctl start agent360
```
## Building Windows setup
Prerequisite: [InnoSetup](https://jrsoftware.org/isdl.php) is used as the installer, build script assumes that it is installed in the default location.
Run `php windows/build.php` to create setup file.
PK DEu\ " agent360-1.3.1.dist-info/REQUESTEDnu �[��� PK DEu\ r�m & agent360-1.3.1.dist-info/top_level.txtnu �[��� agent360
PK GEu\ ��W W ) agent360-1.3.1.dist-info/entry_points.txtnu �[��� [console_scripts]
agent360 = agent360.agent360:main
hello360 = agent360.agent360:hello
PK IEu\� �� " agent360-1.3.1.dist-info/INSTALLERnu �[��� pip
PK NEu\�e@�o �o agent360/agent360.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8; tab-width: 4; indent-tabs: nil; -*-
# by Al Nikolov <roottoorfieuorg@gmail.com>
from __future__ import print_function
import bz2
import sys
if sys.version_info >= (3,):
try:
from past.builtins import basestring
except ImportError:
basestring = str
import configparser
import http.client
from queue import Queue, Empty
import io
else:
import ConfigParser
import httplib
import StringIO
from Queue import Queue, Empty
if sys.version_info >= (3,4):
import importlib.util
else:
import imp
import glob
import certifi
import ssl
try:
import json
except ImportError:
import simplejson as json
import logging
import os
import pickle
import signal
import socket
import subprocess
import threading
import time
import types
from optparse import OptionParser
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
__version__ = '1.3.1'
__FILEABSDIRNAME__ = os.path.dirname(os.path.abspath(__file__))
ini_files = (
os.path.join('/etc', 'agent360.ini'),
os.path.join('/etc', 'agent360-custom.ini'),
os.path.join('/etc', 'agent360-token.ini'),
os.path.join(os.path.dirname(__FILEABSDIRNAME__), 'agent360.ini'),
os.path.join(os.path.dirname(__FILEABSDIRNAME__), 'agent360-custom.ini'),
os.path.join(os.path.dirname(__FILEABSDIRNAME__), 'agent360-token.ini'),
os.path.abspath('agent360.ini'),
os.path.abspath('agent360-custom.ini'),
os.path.abspath('agent360-token.ini'),
)
if os.name == 'nt':
ini_files = (
os.path.join(__FILEABSDIRNAME__, '..', 'config', 'agent360.ini'),
os.path.join(__FILEABSDIRNAME__, '..', 'config', 'agent360-custom.ini'),
os.path.join(__FILEABSDIRNAME__, '..', 'config', 'agent360-token.ini'),
)
def info():
'''
Return string with info about agent360:
- version
- plugins enabled
- absolute path to plugin directory
- server id from configuration file
'''
agent = Agent(dry_instance=True)
plugins_path = agent._get_plugins_path()
plugins_enabled = agent._get_plugins(state='enabled')
return '\n'.join((
'Version: %s' % __version__,
'Plugins enabled: %s' % ', '.join(plugins_enabled),
'Plugins directory: %s' % plugins_path,
'Server: %s' % agent.config.get('agent', 'server'),
))
def hello(proto='https'):
parser = OptionParser()
parser.add_option("-t", "--tags", help="Comma-separated list of tags")
parser.add_option("-a", "--automon", type=int, default=0, help="Enable/disable automatic monitoring of hosted websites")
(options, args) = parser.parse_args()
user_id = args[0]
agent = Agent(dry_instance=True)
if len(args) > 1:
token_filename = args[1]
else:
token_filename = os.path.join(__FILEABSDIRNAME__, 'agent360-token.ini')
if len(args) > 2:
unique_id = args[2]
else:
unique_id = ''
if options.tags is None:
tags = ''
else:
tags = options.tags
if options.automon == 1:
domains = ','.join(_get_domains())
else:
domains = ''
if '_' in user_id:
server_id = user_id.split('_')[1]
user_id = user_id.split('_')[0]
else:
try:
hostname = os.uname()[1]
except AttributeError:
hostname = socket.getfqdn()
server_id = urlopen(
proto + '://' + agent.config.get('data', 'hello_api_host') + '/hello',
data=urlencode({
'user': user_id,
'hostname': hostname,
'unique_id': unique_id,
'tags': tags,
'domains': domains,
}).encode("utf-8")
).read().decode()
if len(server_id) == 24:
print('Got server_id: %s' % server_id)
open(token_filename, 'w').\
write('[DEFAULT]\nuser=%s\nserver=%s\n' % (user_id, server_id))
else:
print('Could not retrieve server_id: %s' % server_id)
def _get_apache_domains():
domains = []
try:
output = subprocess.check_output(['apachectl', '-S'])
for line in output.decode().splitlines():
if 'namevhost' not in line:
continue
cols = line.strip().split(' ')
domains.append(cols[3])
except FileNotFoundError:
pass
return domains
def _get_nginx_domains():
domains = []
try:
output = subprocess.check_output(['nginx', '-T'])
for line in output.decode().splitlines():
if 'server_name' not in line:
continue
cols = line.strip().split(' ')
if len(cols) == 2:
domain = cols[1].replace(';', '').replace('"', '')
domains.append(domain)
except FileNotFoundError:
pass
return domains
def _get_domains():
domains = []
try:
json_str = subprocess.check_output(['whmapi1', '--output=jsonpretty', 'get_domain_info'])
response = json.loads(json_str)
for domain in response['data']['domains']:
domains.append(domain['domain'])
except FileNotFoundError:
try:
str = subprocess.check_output(['plesk', 'bin', 'domain', '--list'])
for domain in str.decode().splitlines():
domains.append(domain)
except FileNotFoundError:
for domain in list(set(_get_apache_domains() + _get_nginx_domains())):
if '.' not in domain:
continue
if domain.endswith('.localdomain'):
continue
if domain.endswith('.localhost'):
continue
if domain.endswith('.local'):
continue
domains.append(domain)
return domains
def count_domains():
print(len(_get_domains()))
def _plugin_name(plugin):
if isinstance(plugin, basestring):
basename = os.path.basename(plugin)
return os.path.splitext(basename)[0]
else:
return plugin.__name__
def test_plugins(plugins=[]):
'''
Test specified plugins and print their data output after single check.
If plugins list is empty test all enabled plugins.
'''
agent = Agent(dry_instance=True)
plugins_path = agent._get_plugins_path()
if plugins_path not in sys.path:
sys.path.insert(0, plugins_path)
if not plugins:
plugins = agent._get_plugins(state='enabled')
print('Check all enabled plugins: %s' % ', '.join(plugins))
for plugin_name in plugins:
print('%s:' % plugin_name)
try:
if sys.version_info >= (3,4):
spec = importlib.util.find_spec(plugin_name)
else:
fp, pathname, description = imp.find_module(plugin_name)
except Exception as e:
print('Find error:', e)
continue
try:
if sys.version_info >= (3,4):
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
else:
module = imp.load_module(plugin_name, fp, pathname, description)
except Exception as e:
print('Load error:', e)
continue
finally:
if sys.version_info < (3,4):
# Since we may exit via an exception, close fp explicitly.
if fp:
fp.close()
try:
payload = module.Plugin().run(agent.config)
print(json.dumps(payload, indent=4, sort_keys=True))
except Exception as e:
print('Execution error:', e)
class Agent:
execute = Queue()
metrics = Queue()
data = Queue()
cemetery = Queue()
shutdown = False
def __init__(self, dry_instance=False):
'''
Initialize internal strictures
'''
self._config_init()
# Cache for plugins so they can store values related to previous checks
self.plugins_cache = {}
if dry_instance:
return
self._logging_init()
self._plugins_init()
self._data_worker_init()
self._dump_config()
def _get_plugins_path(self):
if os.name == 'nt':
return os.path.expandvars(self.config.get('agent', 'plugins'))
else:
return self.config.get('agent', 'plugins')
def _config_init(self):
'''
Initialize configuration object
'''
defaults = {
'max_data_span': 60,
'max_data_age': 60 * 10,
'logging_level': logging.INFO,
'threads': 100,
'ttl': 60,
'interval': 60,
'plugins': os.path.join(__FILEABSDIRNAME__, 'plugins'),
'enabled': 'no',
'subprocess': 'no',
'user': '',
'server': '',
'api_host': 'ingest.monitoring360.io',
'hello_api_host': 'api.monitoring360.io',
'api_path': '/v2/server/poll',
'log_file': '/var/log/agent360.log',
'log_file_mode': 'a',
'max_cached_collections': 10,
}
sections = [
'agent',
'execution',
'data',
]
if sys.version_info >= (3,):
config = configparser.RawConfigParser(defaults)
else:
config = ConfigParser.RawConfigParser(defaults)
config.read(ini_files)
self.config = config
for section in sections:
self._config_section_create(section)
if section == 'data':
self.config.set(section, 'interval', 1)
if section == 'agent':
self.config.set(section, 'interval', .5)
def _config_section_create(self, section):
'''
Create an addition section in the configuration object
if it's not exists
'''
if not self.config.has_section(section):
self.config.add_section(section)
def _logging_init(self):
'''
Initialize logging faculty
'''
level = self.config.getint('agent', 'logging_level')
if os.name == 'nt':
log_file = os.path.expandvars(self.config.get('agent', 'log_file'))
else:
log_file = self.config.get('agent', 'log_file')
log_file_mode = self.config.get('agent', 'log_file_mode')
if log_file_mode in ('w', 'a'):
pass
elif log_file_mode == 'truncate':
log_file_mode = 'w'
elif log_file_mode == 'append':
log_file_mode = 'a'
else:
log_file_mode = 'a'
if log_file == '-':
logging.basicConfig(level=level) # Log to sys.stderr by default
else:
try:
logging.basicConfig(filename=log_file, filemode=log_file_mode, level=level, format="%(asctime)-15s %(levelname)s %(message)s")
except IOError as e:
logging.basicConfig(level=level)
logging.info('IOError: %s', e)
logging.info('Drop logging to stderr')
logging.info('Agent logging_level %i', level)
def _plugins_init(self):
'''
Discover the plugins
'''
logging.info('_plugins_init')
plugins_path = self._get_plugins_path()
filenames = glob.glob(os.path.join(plugins_path, '*.py'))
if plugins_path not in sys.path:
sys.path.insert(0, plugins_path)
self.schedule = {}
for filename in filenames:
name = _plugin_name(filename)
if name == 'plugins':
continue
self._config_section_create(name)
if self.config.getboolean(name, 'enabled'):
if self.config.getboolean(name, 'subprocess'):
self.schedule[filename] = 0
else:
if sys.version_info >= (3,4):
spec = importlib.util.find_spec(name)
else:
fp, pathname, description = imp.find_module(name)
try:
if sys.version_info >= (3,4):
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
else:
module = imp.load_module(name, fp, pathname, description)
except Exception:
module = None
logging.error('import_plugin_exception:%s', str(sys.exc_info()[0]))
finally:
if sys.version_info < (3,4):
# Since we may exit via an exception, close fp explicitly.
if fp:
fp.close()
if module:
self.schedule[module] = 0
else:
logging.error('import_plugin:%s', name)
def _subprocess_execution(self, task):
'''
Execute /task/ in a subprocess
'''
process = subprocess.Popen((sys.executable, task),
stdout=subprocess.PIPE, stderr=subprocess.PIPE,
universal_newlines=True)
logging.debug('%s:process:%i', threading.currentThread(), process.pid)
interval = self.config.getint('execution', 'interval')
name = _plugin_name(task)
ttl = self.config.getint(name, 'ttl')
ticks = ttl / interval or 1
process.poll()
while process.returncode is None and ticks > 0:
logging.debug('%s:tick:%i', threading.currentThread(), ticks)
time.sleep(interval)
ticks -= 1
process.poll()
if process.returncode is None:
logging.error('%s:kill:%i', threading.currentThread(), process.pid)
os.kill(process.pid, signal.SIGTERM)
stdout, stderr = process.communicate()
if process.returncode != 0 or stderr:
logging.error('%s:%s:%s:%s', threading.currentThread(),
task, process.returncode, stderr)
if stdout:
ret = pickle.loads(stdout)
else:
ret = None
return ret
def _execution(self):
'''
Take queued execution requests, execute plugins and queue the results
'''
while True:
if self.shutdown:
logging.info('%s:shutdown', threading.currentThread())
break
logging.debug('%s:exec_queue:%i', threading.currentThread(), self.execute.qsize())
try:
task = self.execute.get_nowait()
except Empty:
break
logging.debug('%s:task:%s', threading.currentThread(), task)
name = _plugin_name(task)
try:
interval = self.config.get(name, 'interval')
except:
interval = 60
ts = time.time()
if isinstance(task, basestring):
payload = self._subprocess_execution(task)
else:
try:
# Setup cache for plugin instance
# if name not in self.plugins_cache.iterkeys():
# self.plugins_cache[name] = []
self.plugins_cache.update({
name: self.plugins_cache.get(name, [])
})
plugin = task.Plugin(agent_cache=self.plugins_cache[name])
payload = plugin.run(self.config)
except Exception:
logging.exception('plugin_exception')
payload = {'exception': str(sys.exc_info()[0])}
self.metrics.put({
'ts': ts,
'task': task,
'name': name,
'interval': interval,
'payload': payload,
})
self.cemetery.put(threading.currentThread())
self.hire.release()
def _data(self):
'''
Take and collect data, send and clean if needed
'''
logging.info('%s', threading.currentThread())
api_host = self.config.get('data', 'api_host')
api_path = self.config.get('data', 'api_path')
max_age = self.config.getint('agent', 'max_data_age')
max_span = self.config.getint('agent', 'max_data_span')
server = self.config.get('agent', 'server')
user = self.config.get('agent', 'user')
interval = self.config.getint('data', 'interval')
max_cached_collections = self.config.get('agent', 'max_cached_collections')
cached_collections = []
collection = []
initial_data = True
while True:
if initial_data:
max_span = 10
else:
max_span = self.config.getint('agent', 'max_data_span')
loop_ts = time.time()
if self.shutdown:
logging.info('%s:shutdown', threading.currentThread())
break
logging.debug('%s:data_queue:%i:collection:%i',
threading.currentThread(), self.data.qsize(), len(collection))
while self.data.qsize():
try:
collection.append(self.data.get_nowait())
except Exception as e:
logging.error('Data queue error: %s' % e)
if collection:
first_ts = min((e['ts'] for e in collection))
last_ts = max((e['ts'] for e in collection))
now = time.time()
send = False
if last_ts - first_ts >= max_span:
logging.debug('Max data span')
send = True
clean = False
elif now - first_ts >= max_age:
logging.warning('Max data age')
send = True
clean = True
if send:
initial_data = False
headers = {
"Content-type": "application/json",
"Authorization": "ApiKey %s:%s" % (user, server),
}
logging.debug('collection: %s',
json.dumps(collection, indent=2, sort_keys=True))
if not (server and user):
logging.warning('Empty server or user, nowhere to send.')
clean = True
else:
try:
ctx = ssl.create_default_context(cafile=certifi.where())
if sys.version_info >= (3,):
connection = http.client.HTTPSConnection(api_host, context=ctx, timeout=15)
else:
connection = httplib.HTTPSConnection(api_host, context=ctx, timeout=15)
# Trying to send cached collections if any
if cached_collections:
logging.info('Sending cached collections: %i', len(cached_collections))
while cached_collections:
connection.request('PUT', '%s?version=%s' % (api_path, __version__),
cached_collections[0],
headers=headers)
response = connection.getresponse()
response.read()
if response.status == 200:
del cached_collections[0] # Remove just sent collection
logging.debug('Successful response: %s', response.status)
else:
raise ValueError('Unsuccessful response: %s' % response.status)
logging.info('All cached collections sent')
# Send recent collection (reuse existing connection)
connection.request('PUT', '%s?version=%s' % (api_path, __version__),
bz2.compress(str(json.dumps(collection)+"\n").encode()),
headers=headers)
response = connection.getresponse()
response.read()
if response.status == 200:
logging.debug('Successful response: %s', response.status)
clean = True
else:
raise ValueError('Unsuccessful response: %s' % response.status)
except Exception as e:
logging.error('Failed to submit collection: %s' % e)
# Store recent collection in cached_collections if send failed
if max_cached_collections > 0:
if len(cached_collections) >= max_cached_collections:
del cached_collections[0] # Remove oldest collection
logging.info('Reach max_cached_collections (%s): oldest cached collection dropped',
max_cached_collections)
logging.info('Cache current collection to resend next time')
cached_collections.append(bz2.compress(str(json.dumps(collection)+"\n").encode()))
collection = []
finally:
connection.close()
if clean:
collection = []
sleep_interval = interval - (time.time() - loop_ts)
if sleep_interval > 0:
time.sleep(sleep_interval)
def _data_worker_init(self):
'''
Initialize data worker thread
'''
logging.info('_data_worker_init')
threading.Thread(target=self._data).start()
def _dump_config(self):
'''
Dumps configuration object
'''
if sys.version_info >= (3,):
buf = io.StringIO()
else:
buf = StringIO.StringIO()
self.config.write(buf)
logging.info('Config: %s', buf.getvalue())
def _get_plugins(self, state='enabled'):
'''
Return list with plugins names
'''
plugins_path = self._get_plugins_path()
plugins = []
for filename in glob.glob(os.path.join(plugins_path, '*.py')):
plugin_name = _plugin_name(filename)
if plugin_name == 'plugins':
continue
self._config_section_create(plugin_name)
if state == 'enabled':
if self.config.getboolean(plugin_name, 'enabled'):
plugins.append(plugin_name)
elif state == 'disabled':
if not self.config.getboolean(plugin_name, 'enabled'):
plugins.append(plugin_name)
return plugins
def _rip(self):
'''
Join with dead workers
Workaround for https://bugs.python.org/issue37788
'''
logging.debug('cemetery:%i', self.cemetery.qsize())
while True:
try:
thread = self.cemetery.get_nowait()
except Empty:
break
logging.debug('joining:%s', thread)
thread.join()
def run(self):
'''
Start all the worker threads
'''
logging.info('Agent main loop')
interval = self.config.getfloat('agent', 'interval')
self.hire = threading.Semaphore(
self.config.getint('execution', 'threads'))
try:
while True:
self._rip()
now = time.time()
logging.debug('%i threads', threading.activeCount())
while self.metrics.qsize():
metrics = self.metrics.get_nowait()
name = metrics['name']
logging.debug('metrics:%s', name)
plugin = metrics.get('task')
if plugin:
self.schedule[plugin] = \
int(now) + self.config.getint(name, 'interval')
if isinstance(plugin, types.ModuleType):
metrics['task'] = plugin.__file__
self.data.put(metrics)
execute = [
what
for what, when in self.schedule.items()
if when <= now
]
for name in execute:
logging.debug('scheduling:%s', name)
del self.schedule[name]
self.execute.put(name)
if self.hire.acquire(False):
try:
thread = threading.Thread(target=self._execution)
thread.start()
logging.debug('new_execution_worker_thread:%s', thread)
except Exception as e:
logging.warning('Can not start new thread: %s', e)
else:
logging.warning('threads_capped')
self.metrics.put({
'ts': now,
'name': 'agent_internal',
'payload': {
'threads_capping':
self.config.getint('execution', 'threads')}
})
sleep_interval = .5-(time.time()-now)
if sleep_interval > 0:
time.sleep(sleep_interval)
else:
logging.warning('not enough time to start worker threads')
time.sleep(.1)
except KeyboardInterrupt:
logging.warning(sys.exc_info()[0])
logging.info('Shutting down')
self._rip()
wait_for = True
while wait_for:
all_threads = threading.enumerate()
logging.info('Remaining threads: %s', all_threads)
wait_for = [
thread for thread in all_threads
if not thread.isDaemon() and
not isinstance(thread, threading._MainThread)
]
if not wait_for:
logging.info('Bye!')
sys.exit(0)
self.shutdown = True
logging.info('Waiting for %i threads to exit', len(wait_for))
for thread in wait_for:
logging.info('Joining with %s/%f', thread, interval)
thread.join(interval)
except Exception as e:
logging.error('Worker error: %s' % e)
def main():
if len(sys.argv) > 1:
if sys.argv[1].startswith('--'):
sys.argv[1] = sys.argv[1][2:]
if sys.argv[1] == 'help':
print('\n'.join((
'Run without options to run agent.',
'Acceptable options (leading -- is optional):',
' help, info, version, hello, insecure-hello, test',
)))
sys.exit()
elif sys.argv[1] == 'info':
print(info())
sys.exit()
elif sys.argv[1] == 'version':
print(__version__)
sys.exit()
elif sys.argv[1] == 'hello':
del sys.argv[1]
sys.exit(hello())
elif sys.argv[1] == 'count-domains':
del sys.argv[1]
sys.exit(count_domains())
elif sys.argv[1] == 'insecure-hello':
del sys.argv[1]
sys.exit(hello(proto='http'))
elif sys.argv[1] == 'test':
sys.exit(test_plugins(sys.argv[2:]))
else:
print('Invalid option:', sys.argv[1], file=sys.stderr)
sys.exit(1)
else:
Agent().run()
if __name__ == '__main__':
main()
PK QEu\ agent360/__init__.pynu �[��� PK TEu\�ǎ] ] agent360/plugins/ping.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import re
from subprocess import Popen, PIPE, CalledProcessError
import sys
import plugins
def _get_match_groups(ping_output, regex):
match = regex.search(ping_output)
if not match:
return False
else:
return match.groups()
def system_command(Command, newlines=True):
Output = ""
Error = ""
try:
proc = Popen(Command.split(), stdout=PIPE)
Output = proc.communicate()[0]
except Exception:
pass
if Output:
if newlines is True:
Stdout = Output.split("\\n")
else:
Stdout = Output
else:
Stdout = []
if Error:
Stderr = Error.split("\n")
else:
Stderr = []
return (Stdout, Stderr)
def collect_ping(hostname):
if sys.platform.startswith('linux') or sys.platform.startswith('freebsd'):
#if sys.platform == "linux" or sys.platform == "linux2":
response = str(system_command("ping -W 5 -c 1 " + hostname, False)[0])
try:
matcher = re.compile(r'(\d+.\d+)/(\d+.\d+)/(\d+.\d+)/(\d+.\d+)')
minping, avgping, maxping, jitter = _get_match_groups(response, matcher)
response = avgping
except Exception:
#response = 9999
response = -1
elif sys.platform == "darwin":
response = str(system_command("ping -c 1 " + hostname, False)[0])
# matcher = re.compile(r'min/avg/max/stddev = (\d+)/(\d+)/(\d+)/(\d+) ms')
# min, avg, max, stddev = _get_match_groups(response, matcher)
matcher = re.compile(r'(\d+.\d+)/(\d+.\d+)/(\d+.\d+)/(\d+.\d+)')
matched = _get_match_groups(response, matcher)
if matched is False:
#response = 0
response = -1
else:
minping, avgping, maxping, jitter = matched
response = avgping
elif sys.platform == "win32":
#response = 0
response = -1
try:
ping = Popen(["ping", "-n", "1 ", hostname], stdout=PIPE, stderr=PIPE)
out, error = ping.communicate()
if out:
try:
response = int(re.findall(r"Average = (\d+)", out)[0])
except Exception:
pass
else:
#response = 0
response = -1
except CalledProcessError:
pass
if response == -1:
try:
rxresponse = re.findall(br" + .+ = [0-9]{1,9}ms, .+ = [0-9]{1,9}ms, .+ = (\d+){1,9}ms", out)
response = rxresponse[0].decode()
except Exception:
pass
else:
#response = float(system_command("ping -W -c 1 " + hostname))
response = -1
return {'avgping': response, 'host': hostname}
class Plugin(plugins.BasePlugin):
__name__ = 'ping'
def run(self, config):
data = {}
my_hosts = config.get('ping', 'hosts').split(',')
data['ping'] = []
for host in my_hosts:
data['ping'].append(collect_ping(host))
return data['ping']
if __name__ == '__main__':
Plugin().execute()
PK VEu\z8� � agent360/plugins/redis_stat.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import redis
### Uncomment/Comment the Attribute Names to be monitored
METRICS = {
# Server section
#"redis_version": "redis version",
#"redis_git_sha1": "redis git sha1",
#"redis_git_dirty": "redis git dirty",
#"redis_build_id": "redis build id",
#"redis_mode": "redis mode",
#"os": "os",
#"arch_bits": "arch bits",
#"multiplexing_api": "multiplexing api",
#"gcc_version": "gcc version",
#"process_id": "process id",
#"run_id": "run id",
#"tcp_port": "tcp port",
"uptime_in_seconds": "uptime",
#"uptime_in_days": "uptime in days",
#"hz": "hz",
#"lru_clock": "lru clock",
#"executable": "redis path",
#"config_file": "config file",
# Clients section
"connected_clients": "connected clients",
#"client_longest_output_list": "client longest output list",
#"client_biggest_input_buf": "client biggest input buf",
#"blocked_clients": "blocked clients",
# Memory section
"used_memory": "used memory",
#"used_memory_human": "used memory human",
#"used_memory_rss": "used memory rss",
#"used_memory_rss_human": "used memory rss human",
#"used_memory_peak": "used memory peak",
"used_memory_peak_human": "used memory peak human",
#"total_system_memory": "total system memory",
#"total_system_memory_human": "total system memory human",
#"used_memory_lua": "used memory lua",
#"used_memory_lua_human": "used memory lua human",
"maxmemory": "maxmemory",
#"maxmemory_human": "maxmemory human",
"maxmemory_policy": "maxmemory policy",
#"mem_fragmentation_ratio": "mem fragmentation ratio",
#"mem_allocator": "mem allocator",
# Persistence section
#"loading": "loading",
#"rdb_changes_since_last_save": "rdb changes since last save",
#"rdb_bgsave_in_progress": "rdb bgsave in progress",
#"rdb_last_save_time": "rdb last save time",
#"rdb_last_bgsave_status": "rdb last bgsave status",
#"rdb_last_bgsave_time_sec": "rdb last bgsave time sec",
#"rdb_current_bgsave_time_sec": "rdb current bgsave time sec",
#"aof_enabled": "aof enabled",
#"aof_rewrite_in_progress": "aof rewrite in progress",
#"aof_rewrite_scheduled": "aof rewrite scheduled",
#"aof_last_rewrite_time_sec": "aof last rewrite time",
#"aof_current_rewrite_time_sec": "aof current rewrite time",
#"aof_last_bgrewrite_status": "aof last bgrewrite status",
#"aof_last_write_status": "aof last write status",
#"aof_current_size": "aof current size",
#"aof_base_size": "aof base size",
#"aof_pending_rewrite": "aof pending rewrite",
#"aof_buffer_length": "aof buffer length",
#"aof_rewrite_buffer_length": "aof rewrite buffer length",
#"aof_pending_bio_fsync": "aof pending bio fsync",
#"aof_delayed_fsync": "aof delayed fsync",
# Stats section
#"total_connections_received": "total connections received",
"total_commands_processed": "total commands processed",
#"instantaneous_ops_per_sec": "instantaneous ops per sec",
"total_net_input_bytes": "total net input bytes",
"total_net_output_bytes": "total net output bytes",
#"instantaneous_input_kbps": "instantaneous input kbps",
#"instantaneous_output_kbps": "instantaneous output kbps",
#"rejected_connections": "rejected connections",
#"sync_full": "sync full",
#"sync_partial_ok": "sync partial ok",
#"sync_partial_err": "sync partial err",
"expired_keys": "expired keys",
"evicted_keys": "evicted keys",
"keyspace_hits": "keyspace hits",
"keyspace_misses": "keyspace misses",
#"pubsub_channels": "pubsub channels",
#"pubsub_patterns": "pubsub patterns",
#"latest_fork_usec": "latest fork usec",
#"migrate_cached_sockets": "migrate cached sockets",
# Replication section
#"role": "role",
#"connected_slaves": "connected slaves",
#"master_repl_offset": "master repl offset",
#"repl_backlog_active": "repl backlog active",
#"repl_backlog_size": "repl backlog size",
#"repl_backlog_first_byte_offset": "repl backlog first byte offset",
#"repl_backlog_histlen": "repl backlog histlen",
# CPU section
#"used_cpu_sys": "used cpu sys",
#"used_cpu_user": "used cpu user",
#"used_cpu_sys_children": "used cpu sys children",
#"used_cpu_user_children": "used cpu user children",
# Cluster section
"cluster_enabled": "cluster enabled"
}
class Plugin(plugins.BasePlugin):
__name__ = 'redis_stat'
def run(self, config):
data = {}
stats = None
try:
redis_host = (config.get(__name__, 'host'))
except:
redis_host = '127.0.0.1'
try:
redis_port = (config.get(__name__, 'port'))
except:
redis_port = '6379'
try:
redis_db = (config.get(__name__, 'db'))
except:
redis_db = '0'
try:
redis_password = (config.get(__name__, 'password'))
except:
redis_password = ''
try:
redis_connection = redis.StrictRedis(host=redis_host,port=redis_port,db=redis_db,password=redis_password)
stats = redis_connection.info()
except Exception as e:
data['status']=0
data['msg']='Connection Error'
if not stats:
return data
for name, value in stats.items():
if name in METRICS.keys() :
data[METRICS[name]] = value
return data
if __name__ == '__main__':
Plugin().execute()PK YEu\gԒr
r
agent360/plugins/docker.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import time
class Plugin(plugins.BasePlugin):
__name__ = 'docker'
def run(self, config):
'''
Docker monitoring, needs sudo access!
Instructions at:
https://docs.360monitoring.com/docs/docker-plugin
'''
containers = {}
last_value = {}
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
lines = [s.split(' / ') for s in os.popen('sudo docker stats --no-stream --no-trunc --format "{{.CPUPerc}} / {{.Name}} / {{.ID}} / {{.MemUsage}} / {{.NetIO}} / {{.BlockIO}} / {{.MemPerc}}"').read().splitlines()]
for row in lines:
container = {}
container['cpu'] = row[0].strip('%')
name = row[1]
container_id = row[2]
container['mem_usage_bytes'] = self.computerReadable(row[3])
container['mem_total_bytes'] = self.computerReadable(row[4])
container['net_in_bytes'] = self.absolute_to_per_second('%s_%s' % (name, 'net_in_bytes'), self.computerReadable(row[5]), prev_cache)
container['net_out_bytes'] = self.absolute_to_per_second('%s_%s' % (name, 'net_out_bytes'), self.computerReadable(row[6]), prev_cache)
container['disk_in_bytes'] = self.absolute_to_per_second('%s_%s' % (name, 'disk_in_bytes'), self.computerReadable(row[7]), prev_cache)
container['disk_out_bytes'] = self.absolute_to_per_second('%s_%s' % (name, 'disk_out_bytes'), self.computerReadable(row[8]), prev_cache)
container['mem_pct'] = row[9].strip('%')
last_value['%s_%s' % (name, 'mem_usage_bytes')] = self.computerReadable(row[3])
last_value['%s_%s' % (name, 'net_in_bytes')] = self.computerReadable(row[5])
last_value['%s_%s' % (name, 'net_out_bytes')] = self.computerReadable(row[6])
last_value['%s_%s' % (name, 'disk_in_bytes')] = self.computerReadable(row[7])
last_value['%s_%s' % (name, 'disk_out_bytes')] = self.computerReadable(row[8])
containers[name] = container
except Exception as e:
return e.message
containers['containers'] = len(containers)
last_value['ts'] = time.time()
self.set_agent_cache(last_value)
return containers
def computerReadable(self, value):
if value[-3:] == 'KiB':
return float(value[:-3])*1024
elif value[-3:] == 'MiB':
return float(value[:-3])*1024*1024
elif value[-3:] == 'GiB':
return float(value[:-3])*1024*1024*1024
elif value[-3:] == 'TiB':
return float(value[:-3])*1024*1024*1024*1024
elif value[-3:] == 'PiB':
return float(value[:-3])*1024*1024*1024*1024*1024
elif value[-2:] == 'kB':
return float(value[:-2])*1024
elif value[-2:] == 'MB':
return float(value[:-2])*1024*1024
elif value[-2:] == 'GB':
return float(value[:-2])*1024*1024*1024
elif value[-2:] == 'TB':
return float(value[:-2])*1024*1024*1024*1024
elif value[-2:] == 'PB':
return float(value[:-2])*1024*1024*1024*1024*1024
elif value[-1:] == 'B':
return float(value[:-1])
if __name__ == '__main__':
Plugin().execute()
PK [Eu\���I�
�
agent360/plugins/phpfpm.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
#from past.builtins import basestring # pip install future
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
import sys
import time
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'phpfpm'
def run(self, config):
'''
php-fpm status page metrics
'''
def ascii_encode_dict(data):
ascii_encode = lambda x: x.encode('ascii') if isinstance(x, unicode) else x
return dict(map(ascii_encode, pair) for pair in data.items())
results = dict()
next_cache = dict()
my_pools = config.get(__name__, 'status_page_url').split(',')
prev_cache = self.get_agent_cache() # Get absolute values from previous check
for pool in my_pools:
request = Request(pool)
raw_response = urlopen(request)
try:
data = raw_response.read().decode('utf-8')
# pprint.pprint(data)
if sys.version_info >= (3,):
j = json.loads(data)
else:
j = json.loads(data, object_hook=ascii_encode_dict)
results[j['pool']] = {}
next_cache['%s_ts' % j['pool']] = time.time()
for k, v in j.items():
results[j['pool']][k.replace(" ", "_")] = v
next_cache['%s_accepted_conn' % j['pool']] = int(results[j['pool']]['accepted_conn'])
except Exception as e:
return e
try:
if next_cache['%s_accepted_conn' % j['pool']] >= prev_cache['%s_accepted_conn' % j['pool']]:
results[j['pool']]['accepted_conn_per_second'] = \
(next_cache['%s_accepted_conn' % j['pool']] - prev_cache['%s_accepted_conn' % j['pool']]) / \
(next_cache['%s_ts' % j['pool']] - prev_cache['%s_ts' % j['pool']])
else: # Was restarted after previous caching
results[j['pool']]['accepted_conn_per_second'] = \
next_cache['%s_accepted_conn' % j['pool']] / \
(next_cache['%s_ts' % j['pool']] - prev_cache['%s_ts' % j['pool']])
except KeyError: # No cache yet, can't calculate
results[j['pool']]['accepted_conn_per_second'] = 0.0
# Cache absolute values for next check calculations
self.set_agent_cache(next_cache)
return results
if __name__ == '__main__':
Plugin().execute()
PK `Eu\��p_� � agent360/plugins/asterisk.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import subprocess
class Plugin(plugins.BasePlugin):
__name__ = 'asterisk'
def run(self, config):
ip = config.get(__name__, 'sbcip')
p = subprocess.Popen("sudo asterisk -rx 'core show calls' | grep 'active' | cut -f1 -d ' '", stdout=subprocess.PIPE, shell=True)
p = p.communicate()[0].decode('utf-8').replace("\n", "")
incoming = subprocess.Popen("sudo asterisk -rx 'core show channels verbose' | cut -c1-15 | grep 'pstn_' | wc -l", stdout=subprocess.PIPE, shell=True)
incoming = incoming.communicate()[0].decode('utf-8').replace("\n", "")
devices = subprocess.Popen("sudo asterisk -rx 'sip show peers' | grep '%s' | wc -l" % (ip), stdout=subprocess.PIPE, shell=True)
devices = devices.communicate()[0].decode('utf-8').replace("\n", "")
res = { "calls": p, "incomingcalls": incoming, "devices": devices }
return res
if __name__ == '__main__':
Plugin().execute()
PK bEu\�� #, , agent360/plugins/kamailio.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import subprocess
### You need to add `agent360 ALL=(ALL) NOPASSWD: /usr/sbin/kamctl` to /etc/sudoers in order for this to work
class Plugin(plugins.BasePlugin):
__name__ = 'asterisk'
def run(self, *unused):
p = subprocess.Popen("sudo kamctl ul show | grep AOR | wc -l", stdout=subprocess.PIPE, shell=True)
p = p.communicate()[0].decode('utf-8').replace("\n", "")
p = { "devices_online": p }
return p
if __name__ == '__main__':
Plugin().execute()
PK eEu\�q�� � agent360/plugins/plugins.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import pickle
import time
import sys
if sys.version_info >= (3,):
import configparser
else:
import ConfigParser
class BasePlugin:
'''
Abstract class for plugins
'''
__name__ = ''
def __init__(self, agent_cache=[]):
if isinstance(agent_cache, list):
self.agent_cache = agent_cache
else:
raise TypeError('Type of agent_cache have to be list')
# if not self.__name__:
# self.__name__ = os.path.splitext(os.path.basename(__file__))[0]
def run(self, config=None):
'''
Virtual method for running the plugin
'''
pass
def execute(self):
'''
Execution wrapper for the plugin
argv[1]: ini_file
'''
config = None
if len(sys.argv) > 1:
if sys.version_info >= (3,):
config = configparser.RawConfigParser(defaults)
else:
config = ConfigParser.RawConfigParser(defaults)
config.read(sys.argv[1])
pickle.dump(self.run(config), sys.stdout.buffer)
def get_agent_cache(self):
'''
Return agent cached value for this specific plugin.
'''
try:
return self.agent_cache[0]
except Exception:
return {}
def set_agent_cache(self, cache):
'''
Set agent cache value previously passed to this plugin instance.
To enable caching existing agent_cache list have to be passed
to Plugin on initialization.
Minimally it should be list().
Agent will be able to see only changes in zero element of agent_cache, so
do not manually override self.agent_cache, othervice cache will not be saved!
If self.agent_cache is not a list appropriate exception will be raised.
'''
try:
self.agent_cache[0] = cache
except IndexError:
self.agent_cache.append(cache)
def absolute_to_per_second(self, key, val, prev_cache):
try:
if val >= prev_cache[key]:
value = \
(val - prev_cache[key]) / \
(time.time() - prev_cache['ts'])
else: # previous cached value should not be higher than current value (service was restarted?)
value = val / \
(time.time() - prev_cache['ts'])
except Exception: # No cache yet, can't calculate
value = 0
return value
PK hEu\<'�
�
agent360/plugins/network.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
import time
class Plugin(plugins.BasePlugin):
__name__ = 'network'
def run(self, config):
'''
Network monitoring plugin.
To only enable certain interfaces add below [network]:
interfaces = eth1,eth3,...
'''
absolute = dict()
absolute['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
enabled_interfaces = config.get('network', 'interfaces').split(',')
except:
enabled_interfaces = False
returndata = {}
interfaces = psutil.net_io_counters(pernic=True)
for interface, stats in interfaces.items():
if enabled_interfaces is not False:
if interface not in enabled_interfaces:
continue
try:
prev_cache[interface]
except:
prev_cache[interface] = {}
absolute[interface] = {}
absolute[interface]['ts'] = time.time()
absolute[interface]['bytes_sent'] = stats.bytes_sent
absolute[interface]['bytes_recv'] = stats.bytes_recv
absolute[interface]['packets_sent'] = stats.packets_sent
absolute[interface]['packets_recv'] = stats.packets_recv
absolute[interface]['errin'] = stats.errin
absolute[interface]['errout'] = stats.errout
absolute[interface]['dropin'] = stats.dropin
absolute[interface]['dropout'] = stats.dropout
returndata[interface] = {}
returndata[interface]['bytes_sent'] = self.absolute_to_per_second('bytes_sent', stats.bytes_sent, prev_cache[interface])
returndata[interface]['bytes_recv'] = self.absolute_to_per_second('bytes_recv', stats.bytes_recv, prev_cache[interface])
returndata[interface]['packets_sent'] = self.absolute_to_per_second('packets_sent', stats.packets_sent, prev_cache[interface])
returndata[interface]['packets_recv'] = self.absolute_to_per_second('packets_recv', stats.packets_recv, prev_cache[interface])
returndata[interface]['errin'] = self.absolute_to_per_second('errin', stats.errin, prev_cache[interface])
returndata[interface]['errout'] = self.absolute_to_per_second('errout', stats.errout, prev_cache[interface])
returndata[interface]['dropin'] = self.absolute_to_per_second('dropin', stats.dropin, prev_cache[interface])
returndata[interface]['dropout'] = self.absolute_to_per_second('dropout', stats.dropout, prev_cache[interface])
self.set_agent_cache(absolute)
return returndata
if __name__ == '__main__':
Plugin().execute()
PK kEu\9�� agent360/plugins/dovecot.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import re
class Plugin(plugins.BasePlugin):
__name__ = 'dovecot'
def run(self, config):
'''
Returns active dovecot IMAP and POP3 session and the current version.
Sudo permission to acces doveadm and dovecot commands are required.
Exampel config for /etc/agent360.ini:
[dovecot]
enabled = yes
'''
data = {}
output = os.popen('sudo doveadm who').read()
output2 = os.popen('sudo dovecot --version').read()
output3 = os.popen('sudo dovecot --hostdomain').read()
imapsum = 0
pop3sum = 0
for row in output.split("\n"):
if re.search(r'.*(imap|pop3).*', row):
imapr = re.search(r' +([0-9]+) +imap +', row, re.IGNORECASE)
popr = re.search(r' +([0-9]+) +pop3 +', row, re.IGNORECASE)
if imapr is not None: imapsum = imapsum + int(imapr.group(1))
if popr is not None: pop3sum = pop3sum + int(popr.group(1))
data['imap'] = imapsum
data['pop3'] = pop3sum
data['meta'] = {'version': output2.strip(), 'hostdomain': output3.strip()}
return data
if __name__ == '__main__':
Plugin().execute()
PK mEu\4�<�� � ! agent360/plugins/plesk-cgroups.pynu �[��� #!/usr/bin/env python3
# -*- coding: utf-8 -*-
import glob
import pathlib
import pwd
import re
import time
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'plesk-cgroups'
def run(self, *unused):
accounting = {}
cache = self.get_agent_cache()
uid_re = re.compile('\d+')
# This silently depends on cgroup mounted virtual file systems
# and SystemD user slices
sysfs_prefix = '/sys/fs/cgroup/'
sysfs_suffix = 'user.slice/user-*.slice'
for user_slice in (
glob.glob(sysfs_prefix + sysfs_suffix) + # cgroup v2
glob.glob(sysfs_prefix + 'systemd/' + sysfs_suffix) # cgroup v1
):
accounting[user_slice] = {}
if not user_slice in cache:
cache[user_slice] = {}
accounting[user_slice]['uid'] = uid = \
int(uid_re.search(user_slice).group())
# Resolve uid to username
try:
accounting[user_slice]['username'] = pwd.getpwuid(uid).pw_name
except KeyError:
# There's no guarantee that the uid has a name
pass
# This silently depends on the corresponding CGroup controllers
# being individually enabled
# Memory accounting
try:
# cgroup v2
with pathlib.Path(user_slice, 'memory.current').open() as f:
accounting[user_slice]['memory.current'] = \
int(f.read().strip())
except FileNotFoundError:
try:
# cgroup v1
with pathlib.Path(
sysfs_prefix,
'memory',
'user.slice',
'user-{}.slice'.format(uid),
'memory.usage_in_bytes'
).open() as f:
accounting[user_slice]['memory.usage_in_bytes'] = \
int(f.read().strip())
except FileNotFoundError:
pass
# IO accounting
try:
# cgroup v2
with pathlib.Path(user_slice, 'io.stat').open() as f:
accounting[user_slice]['io.stat'] = a = {}
if not 'io.stat' in cache[user_slice]:
cache[user_slice]['io.stat'] = c = {}
for line in f.readlines():
devnum, metrics = line.split(maxsplit=1)
if not devnum in a:
a[devnum] = {}
a[devnum]['ts'] = time.time()
if not devnum in c:
c[devnum] = {}
for kv in metrics.split():
k, v = kv.split('=')
a[devnum][k] = self.absolute_to_per_second(
k, int(v), c[devnum]
)
c[devnum][k] = int(v)
except FileNotFoundError:
try:
# cgroup v1
with pathlib.Path(
sysfs_prefix,
'blkio',
'user.slice',
'user-{}.slice'.format(uid),
'blkio.throttle.io_service_bytes'
).open() as f:
accounting[user_slice]\
['blkio.throttle.io_service_bytes'] = a = {}
if not 'blkio.throttle.io_service_bytes' \
in cache[user_slice]:
cache[user_slice]\
['blkio.throttle.io_service_bytes'] = c = {}
for line in f.readlines():
try:
devnum, k, v = line.split()
except ValueError:
# The last line is "Total",
# it has only 2 values and is ignored
pass
if not devnum in a:
a[devnum] = {}
a[devnum]['ts'] = time.time()
if not devnum in c:
c[devnum] = {}
a[devnum][k] = self.absolute_to_per_second(
k, int(v), c[devnum]
)
c[devnum][k] = int(v)
except FileNotFoundError:
pass
# CPU accounting
try:
# cgroup v2
with pathlib.Path(user_slice, 'cpu.stat').open() as f:
accounting[user_slice]['cpu.stat'] = a = {}
if not 'cpu.stat' in cache[user_slice]:
cache[user_slice]['cpu.stat'] = c = {}
a['ts'] = time.time()
for line in f.readlines():
k, v = line.split()
a[k] = self.absolute_to_per_second(k, int(v), c)
c[k] = int(v)
except FileNotFoundError:
try:
# cgroup v1
with pathlib.Path(
sysfs_prefix,
'cpu',
'user.slice',
'user-{}.slice'.format(uid),
'cpuacct.stat'
).open() as f:
accounting[user_slice]['cpuacct.stat'] = a = {}
if not 'cpuacct.stat' in cache[user_slice]:
cache[user_slice]['cpuacct.stat'] = c = {}
a['ts'] = time.time()
for line in f.readlines():
k, v = line.split()
a[k] = self.absolute_to_per_second(k, int(v), c)
c[k] = int(v)
except FileNotFoundError:
pass
self.set_agent_cache(cache)
return accounting
if __name__ == '__main__':
Plugin().execute()
PK pEu\�ܓ� � agent360/plugins/gpu.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import sys
class Plugin(plugins.BasePlugin):
__name__ = 'gpu'
def run(self, *unused):
'''
expirimental plugin used to collect GPU load from OpenHardWareMonitor (Windows)
'''
data = {}
if sys.platform == "win32":
try:
import wmi
except:
return 'wmi module not installed.'
try:
w = wmi.WMI(namespace="root\OpenHardwareMonitor")
temperature_infos = w.Sensor()
for sensor in temperature_infos:
if sensor.SensorType==u'Load' and sensor.Name==u'GPU Core':
data[sensor.Parent.replace('/','-').strip('-')] = sensor.Value
except:
return 'Could not fetch GPU Load data from OpenHardwareMonitor.'
return data
if __name__ == '__main__':
Plugin().execute()
PK rEu\a� � agent360/plugins/unbound.pynu �[��� #!/usr/bin/env python
import plugins
import subprocess
# Needs: agent360 ALL=(ALL) NOPASSWD: /usr/sbin/unbound-control
class Plugin(plugins.BasePlugin):
__name__ = 'unbound'
floatKeys = [ '.avg', '.median', '.now', '.up', '.elapsed' ]
rate_metrics = [
"num.answer.bogus",
"num.answer.rcode",
"num.answer.secure",
"num.cachehits",
"num.cachemiss",
"num.dnscrypt.cert",
"num.dnscrypt.cleartext",
"num.dnscrypt.crypted",
"num.dnscrypt.malformed",
"num.prefetch",
"num.queries",
"num.queries_ip_ratelimited",
"num.query.aggressive",
"num.query.authzone.down",
"num.query.authzone.up",
"num.query.class",
"num.query.dnscrypt.replay",
"num.query.dnscrypt.shared_secret.cachemiss",
"num.query.edns",
"num.query.flags",
"num.query.ipv6",
"num.query.opcode",
"num.query.ratelimited",
"num.query.subnet",
"num.query.subnet_cache",
"num.query.tcp",
"num.query.tcpout",
"num.query.tls",
"num.query.tls.resume",
"num.query.type",
"num.recursivereplies",
"num.rrset.bogus",
"num.zero_ttl",
"requestlist.exceeded",
"requestlist.overwritten",
"unwanted.queries",
"unwanted.replies",
]
gauge_metrics = [
"dnscrypt_nonce.cache.count",
"dnscrypt_shared_secret.cache.count",
"infra.cache.count",
"key.cache.count",
"mem.cache.dnscrypt_nonce",
"mem.cache.dnscrypt_shared_secret",
"mem.cache.message",
"mem.cache.rrset",
"mem.mod.iterator",
"mem.mod.validator",
"mem.streamwait",
"msg.cache.count",
"recursion.time.avg",
"recursion.time.median",
"requestlist.avg",
"requestlist.current.all",
"requestlist.current.user",
"requestlist.max",
"rrset.cache.count",
"tcpusage",
"time.elapsed",
"time.now",
"time.up",
]
by_tag_labels = [
"num.answer.rcode",
"num.query.aggressive",
"num.query.class",
"num.query.edns",
"num.query.flags",
"num.query.opcode",
"num.query.type",
]
def get_stats(self):
cmd = 'sudo /usr/sbin/unbound-control stats'
try:
output = subprocess.check_output(cmd, stderr=subprocess.STDOUT, shell=True)
except subprocess.CalledProcessError as e:
error_msg = 'ERROR CALLING {0}: {1} {2}'.format(cmd, e, e.output)
return None
return output
def parse_stat(self, stat):
stats = {t[0]: t[2] for line in stat.splitlines() for t in [line.partition('=')]}
for key, value in stats.items():
if key.endswith(tuple(self.floatKeys)):
stats[key] = float(value)
else:
stats[key] = int(value)
return stats
def run(self, *unused):
resdata = self.get_stats()
final = {}
if resdata is None:
return False
else:
final = self.parse_stat(resdata)
return final
if __name__ == '__main__':
Plugin().execute()
PK uEu\��.= = agent360/plugins/powerdns.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
try:
from urllib.request import urlopen, Request
except ImportError:
from urllib2 import urlopen, Request
import time
import plugins
import urllib2
import json
class Plugin(plugins.BasePlugin):
__name__ = 'powerdns'
def run(self, config):
'''
Experimental plugin for PowerDNS authoritative server. Might also work with PowerDNS recursor,
but it may need extra delta_keys / absolute_keys.
Add to /etc/agent360.ini:
[powerdns]
enabled=yes
statistics_url=http://localhost:8081/api/v1/servers/localhost/statistics
api_key=changeme
;ca_file=
;ca_path=
;timeout=10
'''
# Create request to configured URL
request = urllib2.Request(config.get(__name__, 'statistics_url'), headers={'X-API-Key': '%s' % config.get(__name__, 'api_key')})
# defaults
timeout = 10
results = dict()
raw_response = None
# next / previous cached metrics (for calculating deltas)
next_cache = dict()
prev_cache = self.get_agent_cache()
# use timeout from config if specified
if config.has_option(__name__, 'timeout'):
timeout = int(config.get(__name__, 'timeout'))
# create response based on configuration
if config.has_option(__name__, 'ca_file'):
raw_response = urllib2.urlopen(request, timeout=timeout, cafile=config.get(__name__, 'ca_file'))
elif config.has_option(__name__, 'ca_path'):
raw_response = urllib2.urlopen(request, timeout=timeout, capath=config.get(__name__, 'ca_path'))
else:
raw_response = urllib2.urlopen(request, timeout=timeout)
# set next_cache timestamp
next_cache['ts'] = time.time()
# parse raw response as JSON
try:
stats = json.loads(raw_response.read())
except Exception:
return False
# keys for which we should calculate the delta
delta_keys = (
'corrupt-packets',
'deferred-cache-inserts',
'deferred-cache-lookup',
'deferred-packetcache-inserts',
'deferred-packetcache-lookup',
'dnsupdate-answers',
'dnsupdate-changes',
'dnsupdate-queries',
'dnsupdate-refused',
'incoming-notifications',
'overload-drops',
'packetcache-hit',
'packetcache-miss',
'query-cache-hit',
'query-cache-miss',
'rd-queries',
'recursing-answers',
'recursing-questions',
'recursion-unanswered',
'servfail-packets',
'signatures',
'sys-msec',
'tcp-answers',
'tcp-answers-bytes',
'tcp-queries',
'tcp4-answers',
'tcp4-answers-bytes',
'tcp4-queries',
'tcp6-answers',
'tcp6-answers-bytes',
'tcp6-queries',
'timedout-packets',
'udp-answers',
'udp-answers-bytes',
'udp-do-queries',
'udp-in-errors',
'udp-noport-errors',
'udp-queries',
'udp-recvbuf-errors',
'udp-sndbuf-errors',
'udp4-answers',
'udp4-answers-bytes',
'udp4-queries',
'udp6-answers',
'udp6-answers-bytes',
'udp6-queries',
'user-msec'
)
# keys for which we should store the absolute value:
absolute_keys = (
'key-cache-size',
'latency',
'fd-usage',
'meta-cache-size',
'open-tcp-connections',
'packetcache-size',
'qsize-q',
'query-cache-size',
'real-memory-usage',
'security-status',
'signature-cache-size',
'uptime'
)
data = dict()
for stat in stats:
if 'name' in stat and 'value' in stat and 'type' in stat:
if stat['type'] == 'StatisticItem':
if stat['name'] in delta_keys:
results[stat['name']] = self.absolute_to_per_second(stat['name'], float(stat['value']), prev_cache)
data[stat['name']] = float(stat['value'])
elif stat['name'] in absolute_keys:
results[stat['name']] = float(stat['value'])
data['ts'] = time.time()
self.set_agent_cache(data)
return results
if __name__ == '__main__':
Plugin().execute()
PK xEu\�h)pj j agent360/plugins/proftpd.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'proftpd'
def run(self, config):
'''
Current acitive ProFTPD sessions
'''
data = {}
result = os.popen('/bin/ftpwho -o json').read()
cnt = 0
uploading = 0
idle = 0
rawdata=json.loads(result)
for item in rawdata['connections']:
if item['pid']: cnt += 1
try:
if item['uploading'] == True: uploading += 1
except Exception:
pass
try:
if item['idling'] == True: idle += 1
except Exception:
pass
data['connections'] = cnt
data['uploading'] = uploading
data['idle'] = idle
data['server_type'] = rawdata['server']['server_type']
data['pid'] = "PID " + str(rawdata['server']['pid'])
updt = rawdata['server']['started_ms']
data['uptime'] = {'ms': updt}
return data
if __name__ == '__main__':
Plugin().execute()
PK zEu\�M�l l agent360/plugins/swap.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'swap'
def run(self, *unused):
swap = {}
mem = psutil.swap_memory()
for name in mem._fields:
swap[name] = getattr(mem, name)
return swap
if __name__ == '__main__':
Plugin().execute()
PK }Eu\�%�* * $ agent360/plugins/cloudlinux-dbgov.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'cloudlinux-dbgov'
def run(self, config):
'''
Beta plugin to monitor cloudlinux db governor users
Requires sudo access to lveinfo (whereis lveinfo) add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /REPLACE/PATH/TO/lveinfo
To enable add to /etc/agent360.ini:
[cloudlinux-dbgov]
enabled = yes
'''
data = os.popen('sudo lveinfo --dbgov --period 5m -o cpu --limit 20 --json').read()
results = {}
try:
data = json.loads(data)
except Exception:
return "Could not load lveinfo dbgov data"
if data['success'] is not 1:
return "Failed to load lveinfo dbgov"
results = {}
for line in data['data']:
username = line['USER']
del line['USER']
results[username] = line
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\����
�
agent360/plugins/rabbitmq.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
import time
import plugins
import json
import requests
from requests.auth import HTTPBasicAuth
import sys
class Plugin(plugins.BasePlugin):
__name__ = 'rabbitmq'
def run(self, config):
'''
rabbitmq status page metrics
'''
def ascii_encode_dict(data):
ascii_encode = lambda x: x.encode('ascii') if isinstance(x, unicode) else x
return dict(map(ascii_encode, pair) for pair in data.items())
results = dict()
next_cache = dict()
try:
username = config.get('rabbitmq', 'username')
password = config.get('rabbitmq', 'password')
user_pass = (username, password)
except:
user_pass = False
request = requests.get(config.get('rabbitmq', 'status_page_url'), auth=user_pass)
if request.status_code == 401:
request = requests.get(config.get('rabbitmq', 'status_page_url'), auth=HTTPBasicAuth(username, password))
if request.status_code is 200:
try:
j = request.json()
except Exception as e:
return e
else:
return "Could not load status page: {}".format(request.text)
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
prev_cache['message_stats']
except:
prev_cache['message_stats'] = {}
next_cache['message_stats'] = j
next_cache['message_stats']['ts'] = time.time();
results['published'] = self.absolute_to_per_second('published', j['message_stats']['publish'], prev_cache['message_stats'])
results['published_total'] = j['message_stats']['publish']
results['ack'] = self.absolute_to_per_second('ack', j['message_stats']['ack'], prev_cache['message_stats'])
results['ack_total'] = j['message_stats']['ack']
results['deliver_get'] = self.absolute_to_per_second('deliver_get', j['message_stats']['deliver_get'], prev_cache['message_stats'])
results['deliver_get_total'] = j['message_stats']['deliver_get']
results['redeliver'] = self.absolute_to_per_second('redeliver', j['message_stats']['redeliver'], prev_cache['message_stats'])
results['redeliver_total'] = j['message_stats']['redeliver']
results['deliver'] = self.absolute_to_per_second('deliver', j['message_stats']['deliver'], prev_cache['message_stats'])
results['deliver_total'] = j['message_stats']['deliver']
results['messages'] = j['queue_totals']['messages']
results['messages_ready'] = j['queue_totals']['messages_ready']
results['messages_unacknowledged'] = j['queue_totals']['messages_unacknowledged']
results['listeners'] = len(j['listeners'])
results['consumers'] = j['object_totals']['consumers']
results['queues'] = j['object_totals']['queues']
results['exchanges'] = j['object_totals']['exchanges']
results['connections'] = j['object_totals']['connections']
results['channels'] = j['object_totals']['channels']
self.set_agent_cache(next_cache)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\ agent360/plugins/__init__.pynu �[��� PK �Eu\�h��� � agent360/plugins/bind.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'bind'
def run(self, config):
'''
Monitoring bind nameserver
You must have the bind statistics-channels configured
and you must have jq installed for json processing.
Usage for /etc/agent360.ini:
[bind]
enabled = yes
port = 8053
'''
bport = config.get('bind', 'port')
result = os.popen('curl -j http://localhost:' + str(bport) + '/json 2>/dev/null | jq ".qtypes * .rcodes * .nsstats"').read()
data=json.loads(result)
return data
if __name__ == '__main__':
Plugin().execute()
PK �Eu\&:0�G G agent360/plugins/cpu_freq.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'cpu_freq'
def run(self, *unused):
results = {}
data = psutil.cpu_freq(percpu=True)
cpu_number = -1
for cpu in data:
core = {}
cpu_number = cpu_number+1
results[cpu_number] = {}
for key in cpu._fields:
core[key] = getattr(cpu, key)
results[cpu_number] = core['current']
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\��3] ] agent360/plugins/memcached.pynu �[��� import plugins
import struct
import time
import memcache
class Plugin(plugins.BasePlugin):
__name__ = 'memcached'
def run(self, config):
'''
pip install python-memcached
add to /etc/agent360.ini
[memcached]
enabled=yes
host=127.0.0.1
port=11211
'''
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
socket = config.get('memcached', 'socket')
except:
socket = False
try:
# Connect
if socket is False:
mc = memcache.Client(['%s:%s' % (config.get('memcached', 'host'), config.get('memcached', 'port'))], debug=0)
else:
mc = memcache.Client(['unix:/%s' % socket], debug=0)
except:
return "Could not connect to memcached"
non_delta = (
'accepting_conns',
'bytes',
'uptime',
'total_items',
'total_connections',
'time_in_listen_disabled_us',
'threads',
'rusage_user',
'rusage_system',
'reserved_fds',
'pointer_size',
'malloc_fails',
'lrutail_reflocked',
'listen_disabled_num',
'limit_maxbytes',
'hash_power_level',
'hash_bytes',
'curr_items',
'curr_connections',
'connection_structures',
'conn_yields',
'reclaimed'
)
delta_keys = (
'auth_cmds',
'auth_errors',
'bytes_read',
'bytes_written',
'touch_misses',
'touch_hits',
'incr_misses',
'incr_hits',
'cas_misses',
'cas_badval',
'incr_hits',
'get_misses',
'get_hits',
'expired_unfetched',
'evictions',
'evicted_unfetched',
'delete_misses',
'delete_hits',
'decr_misses',
'decr_hits',
'crawler_reclaimed',
'crawler_items_checked',
'cmd_touch',
'cmd_get',
'cmd_set',
'cmd_flush',
'cmd_misses',
'cmd_badval',
'cmd_hits'
)
results = {}
data = {}
try:
result = mc.get_stats()
for key, key_value in enumerate(result[0][1]):
value = result[0][1][key_value]
key = key_value.lower().strip()
if key in non_delta:
results[key] = float(value)
elif key in delta_keys:
value = float(value)
results[key] = self.absolute_to_per_second(key, float(value), prev_cache)
data[key] = float(value)
else:
pass
except:
return 'Could not fetch memcached stats'
data['ts'] = time.time()
self.set_agent_cache(data)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\�F�?
agent360/plugins/process.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
import sys
import re
class Plugin(plugins.BasePlugin):
__name__ = 'process'
def sanitize_command_line(self, cmdline):
# Check if cmdline starts with a file path and separate it
match = re.match(r'^(\S+)(\s+.*)?$', cmdline)
if match:
initial_path = match.group(1)
remaining_cmdline = match.group(2) or ""
else:
initial_path = ""
remaining_cmdline = cmdline
# Redact sensitive information in the remaining command line (case-insensitive)
remaining_cmdline = re.sub(r'(/[^ ]+)+', '/***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'(--(?:password|pass|pwd|token|secret|key|api-key|access-key|secret-key|client-secret|auth-key|auth-token)\s+\S+)', '--***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'(-p\s+\S+)', '-p ***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:password|pass|pwd|token|secret|key|api_key|access_key|client_secret|auth_key|auth_token)=\S+', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:[a-fA-F0-9:]+:+)+[a-fA-F0-9]+\b', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'(--port\s+\d+)', '--port ***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:DB_PASS|DB_USER|AWS_SECRET_ACCESS_KEY|AWS_ACCESS_KEY_ID|SECRET_KEY|TOKEN|PASSWORD|USERNAME|API_KEY|PRIVATE_KEY|SSH_KEY|SSL_CERTIFICATE|SSL_KEY)\b=\S+', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(root|admin|cpanelsolr|user\d*)\b', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'(\S+\.(pem|crt|key|cert|csr|pfx|p12|ovpn|enc|asc|gpg))', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:id_rsa|id_dsa|id_ecdsa|id_ed25519|known_hosts|authorized_keys|credentials|.env|docker-compose.yml)\b', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:jdbc|mysql|postgres|mongodb|redis|amqp|http|https|ftp|sftp|s3):\/\/\S+', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b(?:https?|ftp):\/\/(?:\S+\:\S+@)?(?:[a-zA-Z0-9.-]+\.\S+)', '***', remaining_cmdline, flags=re.IGNORECASE)
remaining_cmdline = re.sub(r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b', '***', remaining_cmdline, flags=re.IGNORECASE)
# Combine the initial path and the sanitized command line, then limit length
sanitized_cmdline = (initial_path + remaining_cmdline).strip()
if len(sanitized_cmdline) > 256:
sanitized_cmdline = sanitized_cmdline[:253] + '...'
return sanitized_cmdline
def run(self, *unused):
process = []
for proc in psutil.process_iter():
try:
pinfo = proc.as_dict(attrs=[
'pid', 'name', 'ppid', 'exe', 'cmdline', 'username',
'cpu_percent', 'memory_percent', 'io_counters'
])
try:
# Sanitize and format the command line
pinfo['cmdline'] = self.sanitize_command_line(' '.join(pinfo['cmdline']).strip())
except:
pass
if sys.version_info < (3,):
pinfo['cmdline'] = unicode(pinfo['cmdline'], sys.getdefaultencoding(), errors="replace").strip()
pinfo['name'] = unicode(pinfo['name'], sys.getdefaultencoding(), errors="replace")
pinfo['username'] = unicode(pinfo['username'], sys.getdefaultencoding(), errors="replace")
try:
pinfo['exe'] = unicode(pinfo['exe'], sys.getdefaultencoding(), errors="replace")
except:
pass
except psutil.NoSuchProcess:
pass
except psutil.AccessDenied:
pass
except:
pass
else:
process.append(pinfo)
return process
if __name__ == '__main__':
Plugin().execute()
PK �Eu\ϣYi� � agent360/plugins/postfix.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import re
class Plugin(plugins.BasePlugin):
__name__ = 'postfix'
def run(self, config):
'''
Monitoring of the Postfix MTA log and optionally the Postfix version and the mailqueue
Dependency: Pflogsumm log analyzer, sudo access
Exampel config for /etc/agent360.ini:
[postfix]
enabled = yes
log = /var/log/mail.log
pflogsumm = /usr/sbin/pflogsumm
version = true
queue = true
'''
data = {}
maillog = config.get('postfix', 'log')
pflbin = config.get('postfix', 'pflogsumm')
pversion = config.get('postfix', 'version')
mqueue = config.get('postfix', 'queue')
output = os.popen('sudo ' + pflbin + ' -d today --detail 0 ' + maillog).read()
for row in output.split("\n"):
if re.search(r' +[0-9]+ +[a-z]{1}[a-z- ]+[a-z]', row):
stat = re.findall(r'[a-z]{1}[a-z- ]+[a-z]', row)[0]
num = re.findall(r'\b[0-9]*\b', row)[0]
data[stat] = int(num)
if pversion == "true":
data['meta'] = {'version': 'Postfix ' + os.popen('sudo postconf -d | grep mail_version -m 1 | egrep -o "[0-9.]+"').read().rstrip()}
if mqueue == "true":
mqcommand = os.popen('sudo mailq | tail -n 1').read()
if "empty" in mqcommand:
data['queue'] = {'mails': 0 , 'size': 0 }
else:
data['queue'] = {'mails': re.findall(r'[0-9]+ Request', mqcommand)[0].replace(" Request", ""), 'size': re.findall(r'-- [0-9]+', mqcommand)[0].replace("-- ", "") }
return data
if __name__ == '__main__':
Plugin().execute()
PK �Eu\���� � agent360/plugins/memory.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
import os
class Plugin(plugins.BasePlugin):
__name__ = 'memory'
def run(self, *unused):
memory = {}
memory['buffers'] = 0
mem = psutil.virtual_memory()
for name in mem._fields:
memory[name] = getattr(mem, name)
if (memory['available'] == 0 or memory['buffers'] == 0) and os.name != 'nt':
tot_m, used_m, free_m, sha_m, buf_m, cac_m, ava_m = map(int, os.popen('free -b -w').readlines()[1].split(':', 1)[1].split())
memory['percent'] = 100-(((free_m+buf_m+cac_m)*100)/tot_m)
memory['available'] = ava_m
memory['buffers'] = buf_m
memory['cached'] = cac_m
memory['total'] = tot_m
memory['used'] = used_m
memory['shared'] = sha_m
return memory
if __name__ == '__main__':
Plugin().execute()
PK �Eu\�;��� � agent360/plugins/haproxy.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import time
import plugins
import csv
import requests
class Plugin(plugins.BasePlugin):
__name__ = 'haproxy'
def run(self, config):
results = dict()
next_cache = dict()
try:
username = config.get('haproxy', 'username')
password = config.get('haproxy', 'password')
user_pass = (username, password)
except:
user_pass = False
status_page_url = config.get('haproxy', 'status_page_url')
if not ";csv" in status_page_url:
status_page_url = status_page_url + ";csv"
request = requests.get(status_page_url, auth=user_pass)
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
if request.status_code is 200:
response = request.text.split("\n")
else:
return "Could not load haproxy status page: {}".format(request.text)
non_delta = (
'qcur',
'qmax',
'scur',
'smax',
'slim',
'stot',
'weight',
# 'act',
# 'bck',
# 'chkfail',
# 'chkdown',
# 'lastchg',
# 'downtime',
'qlimit',
# 'pid',
# 'iid',
# 'sid',
'throttle',
'lbtot',
'tracked',
# 'type',
'rate',
'rate_lim',
'rate_max',
# 'check_status',
# 'check_code',
# 'check_duration',
'hanafail',
'req_rate',
'req_rate_max',
'req_tot',
# 'lastsess',
# 'last_chk',
# 'last_agt',
# 'qtime',
# 'ctime',
# 'rtime',
# 'ttime',
# 'agent_status',
# 'agent_code',
# 'agent_duration',
# 'agent_health',
'conn_rate',
'conn_rate_max',
'conn_tot',
# 'intercepted'
)
delta = (
'bin',
'bout',
'cli_abrt',
'srv_abrt',
'intercepted',
'hrsp_1xx',
'hrsp_2xx',
'hrsp_3xx',
'hrsp_4xx',
'check_rise',
'check_fall',
'check_health',
'agent_rise',
'agent_fall',
'hrsp_5xx',
'comp_in',
'comp_out',
'comp_byp',
'comp_rsp',
'hrsp_other',
'dcon',
'dreq',
'dresp',
'ereq',
'econ',
'eresp',
'wretr',
'wredis',
'dses'
)
csv_reader = csv.DictReader(response)
data = dict()
constructors = [str, float]
for row in csv_reader:
results[row["# pxname"]+"/"+row["svname"]] = {}
data[row["# pxname"]+"/"+row["svname"]] = {}
try:
prev_cache[row["# pxname"]+"/"+row["svname"]]['ts'] = prev_cache['ts']
except KeyError:
prev_cache[row["# pxname"]+"/"+row["svname"]] = {}
for k, v in row.items():
for c in constructors:
try:
v = c(v)
except ValueError:
pass
if k in non_delta:
results[row["# pxname"]+"/"+row["svname"]][k] = v
elif k in delta and type(v) is not str:
results[row["# pxname"]+"/"+row["svname"]][k] = self.absolute_to_per_second(k, float(v), prev_cache[row["# pxname"]+"/"+row["svname"]])
data[row["# pxname"]+"/"+row["svname"]][k] = float(v)
else:
pass
data['ts'] = time.time()
self.set_agent_cache(data)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\`�4� � agent360/plugins/cloudlinux.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'cloudlinux'
def run(self, config):
'''
Beta plugin to monitor cloudlinux users
Requires sudo access to lveinfo (whereis lveinfo) add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /REPLACE/PATH/TO/lveinfo
To enable add to /etc/agent360.ini:
[cloudlinux]
enabled = yes
'''
data = os.popen('sudo lveinfo -d --period 5m -o cpu_avg -l 20 --json').read()
results = {}
try:
data = json.loads(data)
except Exception:
return "Could not load lveinfo data"
if data['success'] is not 1:
return "Failed to load lveinfo"
results = {}
for line in data['data']:
username = line['ID']
del line['ID']
results[username] = line
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\;l� � � agent360/plugins/vms.pynu �[��� from __future__ import print_function
import re, sys, os
import libvirt
import libxml2
import time
import plugins
import psutil
class Plugin(plugins.BasePlugin):
__name__ = 'vms'
def run(self, config):
'''
Using the libvirt API to fetch statistics from guests
running KVM, QEMU, Xen, Virtuozzo, VMWare ESX, LXC,
BHyve and more
'''
results = {}
last_value = {}
prev_cache = self.get_agent_cache() # Get absolute values from previous check
uri = os.getenv("uri", "qemu:///system")
values = self.fetch_values(uri)
deltas = {}
for key, value in values.items():
deltas[key] = {}
for subkey, subvalue in value.items():
if subkey == 'mem_bytes' or subkey == 'soft_limit_bytes' or subkey == 'min_guarantee_bytes' or subkey == 'hard_limit_bytes':
deltas[key][subkey] = value[subkey]
else:
deltas[key][subkey] = self.absolute_to_per_second('%s_%s' % (key, subkey), float(subvalue), prev_cache)
last_value['%s_%s' % (key, subkey)] = float(value[subkey])
last_value['ts'] = time.time()
self.set_agent_cache(last_value)
return deltas
def canon(self, name):
return re.sub(r"[^a-zA-Z0-9_]", "_", name)
def get_ifaces(self, dom):
xml = dom.XMLDesc(0)
doc = None
try:
doc = libxml2.parseDoc(xml)
except:
return []
ctx = doc.xpathNewContext()
ifaces = []
try:
ret = ctx.xpathEval("/domain/devices/interface")
for node in ret:
devdst = None
for child in node.children:
if child.name == "target":
devdst = child.prop("dev")
if devdst == None:
continue
ifaces.append(devdst)
finally:
if ctx != None:
ctx.xpathFreeContext()
if doc != None:
doc.freeDoc()
return ifaces
def get_memtune(self, dom):
memtune = { 'min_guarantee': 0, 'soft_limit': 0, 'hard_limit': 0 }
xml = dom.XMLDesc(0)
try:
doc = libxml2.parseDoc(xml)
except:
return []
ctx = doc.xpathNewContext()
try:
for key in memtune:
ret = ctx.xpathEval("/domain/memtune/%s" % key)
try:
for child in ret[0].children:
memtune[key] = int(child.content)
break
except IndexError:
# key not found in xml
pass
finally:
if ctx != None:
ctx.xpathFreeContext()
if doc != None:
doc.freeDoc()
return memtune
def fetch_values(self, uri):
conn = libvirt.openReadOnly(uri)
ids = conn.listDomainsID()
results = {}
for id in ids:
data = {}
data['net_rx_bytes'] = 0
data['net_tx_bytes'] = 0
try:
dom = conn.lookupByID(id)
name = dom.name()
except libvirt.libvirtError as err:
print("Id: %s: %s" % (id, err), file=sys.stderr)
continue
if name == "Domain-0":
continue
ifaces = self.get_ifaces(dom)
for iface in ifaces:
try:
stats = dom.interfaceStats(iface)
data['net_rx_bytes'] += stats[0]
data['net_tx_bytes'] += stats[4]
except:
print >>sys.stderr, "Cannot get ifstats for '%s' on '%s'" % (iface, name)
cputime = float(dom.info()[4])
cputime_percentage = 1.0e-7 * cputime
data['cpu'] = cputime_percentage
try:
data['cpu_percentage'] = cputime_percentage / psutil.cpu_count()
except Exception as e:
pass
maxmem, mem = dom.info()[1:3]
mem *= 1024
maxmem *= 1024
data['mem_bytes'] = mem
memtune = self.get_memtune(dom)
data['min_guarantee_bytes'] = memtune['min_guarantee'] * 1024
data['hard_limit_bytes'] = memtune['hard_limit'] * 1024
data['soft_limit_bytes'] = memtune['soft_limit'] * 1024
data['disk_rd_bytes'] = 0
data['disk_wr_bytes'] = 0
data['disk_wr_req'] = 0
data['disk_rd_req'] = 0
try:
dom = conn.lookupByID(id)
name = dom.name()
except libvirt.libvirtError as err:
print("Id: %s: %s" % (id, err), file=sys.stderr)
continue
if name == "Domain-0":
continue
disks = self.get_disks(dom)
for disk in disks:
try:
rd_req, rd_bytes, wr_req, wr_bytes, errs = dom.blockStats(disk)
data['disk_rd_bytes'] += rd_bytes
data['disk_wr_bytes'] += wr_bytes
data['disk_rd_req'] += rd_req
data['disk_wr_req'] += wr_req
except TypeError:
print >>sys.stderr, "Cannot get blockstats for '%s' on '%s'" % (disk, name)
results[self.canon(name)] = data
return results
def get_disks(self, dom):
xml = dom.XMLDesc(0)
doc = None
try:
doc = libxml2.parseDoc(xml)
except:
return []
ctx = doc.xpathNewContext()
disks = []
try:
ret = ctx.xpathEval("/domain/devices/disk")
for node in ret:
devdst = None
for child in node.children:
if child.name == "target":
devdst = child.prop("dev")
if devdst == None:
continue
disks.append(devdst)
finally:
if ctx != None:
ctx.xpathFreeContext()
if doc != None:
doc.freeDoc()
return disks
if __name__ == '__main__':
Plugin().execute()
PK �Eu\Y/@G� � agent360/plugins/diskinodes.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'diskinodes'
def run(self, config):
disk = {}
try:
df_output_lines = [s.split() for s in os.popen("df -Pli").read().splitlines()]
del df_output_lines[0]
for row in df_output_lines:
if row[0] == 'tmpfs':
continue
disk[row[0]] = {'total': int(row[1]), 'used': int(row[2]), 'free': int(row[3]), 'percent': row[4][:-1]}
except:
pass
return disk
if __name__ == '__main__':
Plugin().execute()
PK �Eu\���˯ � agent360/plugins/openvpn.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import time
from openvpn_status import parse_status
class Plugin(plugins.BasePlugin):
__name__ = 'openvpn'
def run(self, config):
'''
OpenVPN monitoring, needs access to openvpn-status.log file.
pip install openvpn-status
or
pip3 install openvpn-status
In /etc/agent360.ini to enable put:
[openvpn]
enabled = yes
status_path = /etc/openvpn/openvpn-status.log
test the plugin by running: sudo -u agent360 agent360 test OpenVPN
If you are having permission issues try to run the agent as root user:
https://docs.360monitoring.com/docs/run-the-monitoring-agent-as-the-root-user
'''
openvpn_clients = {}
last_value = {}
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
with open(config.get('openvpn', 'status_path')) as logfile:
status = parse_status(logfile.read())
except Exception as e:
return e
try:
openvpn_clients['containers'] = len(status.client_list.items())
for key, client in status.client_list.items():
client.common_name = client.common_name.replace('.', '-')
openvpn_clients[client.common_name] = {}
bytes_out = int(client.bytes_sent)
bytes_in = int(client.bytes_received)
openvpn_clients[client.common_name]['net_out_bytes'] = self.absolute_to_per_second('%s_%s' % (client.common_name, 'net_out_bytes'), bytes_out, prev_cache)
openvpn_clients[client.common_name]['net_in_bytes'] = self.absolute_to_per_second('%s_%s' % (client.common_name, 'net_in_bytes'), bytes_in, prev_cache)
last_value['%s_%s' % (client.common_name, 'net_in_bytes')] = bytes_in
last_value['%s_%s' % (client.common_name, 'net_out_bytes')] = bytes_out
except Exception as e:
return e
last_value['ts'] = time.time()
self.set_agent_cache(last_value)
return openvpn_clients
if __name__ == '__main__':
Plugin().execute()
PK �Eu\�\��� � agent360/plugins/nginx.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
# import psutil
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
import time
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'nginx'
def run(self, config):
'''
Provides the following metrics (example):
"accepts": 588462,
"accepts_per_second": 0.0,
"active_connections": 192,
"handled": 588462,
"handled_per_second": 0.0,
"reading": 0,
"requests": 9637106,
"requests_per_second": 0.0,
"waiting": 189,
"writing": 3
requests, accepts, handled are values since the start of nginx.
*_per_second values calculated from them using cached values from previous call.
'''
try:
results = dict()
next_cache = dict()
# request = urllib2.Request(config.get('nginx', 'status_page_url'))
# raw_response = urllib2.urlopen(request)
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
# response = raw_response.readlines()
request = Request(config.get('nginx', 'status_page_url'))
response = urlopen(request).read().decode('utf-8').split("\n")
# Active connections: N
# active_connections = response[0].split(':')[1].strip()
active_connections = response[0].split()[-1]
results['active_connections'] = int(active_connections)
# server accepts handled requests
keys = response[1].split()[1:]
values = response[2].split()
for key, value in zip(keys, values):
next_cache[key] = int(value)
results[key] = next_cache[key] # Keep absolute values in results
try:
if next_cache[key] >= prev_cache[key]:
results['%s_per_second' % key] = \
(next_cache[key] - prev_cache[key]) / \
(next_cache['ts'] - prev_cache['ts'])
else: # Nginx was restarted after previous caching
results['%s_per_second' % key] = \
next_cache[key] / \
(next_cache['ts'] - prev_cache['ts'])
except KeyError: # No cache yet, can't calculate
results['%s_per_second' % key] = 0.0
# Reading: X Writing: Y Waiting: Z
keys = response[3].split()[0::2]
keys = [entry.strip(':').lower() for entry in keys]
values = response[3].split()[1::2]
for key, value in zip(keys, values):
results[key] = int(value)
# Cache absolute values for next check calculations
self.set_agent_cache(next_cache)
return results
except Exception:
return False
if __name__ == '__main__':
Plugin().execute()
PK �Eu\����l l agent360/plugins/mdstat.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'mdstat'
def run(self, config):
'''
Monitor software raid status using mdadm:
pip install mdstat
Requires sudo access to mdjson add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /usr/local/bin/mdjson
'''
data = os.popen('mdjson').read()
results = {}
try:
data = json.loads(data)
except Exception:
return "Could not load mdstat data"
for key, value in data['devices'].items():
device = {}
if(value['active'] is not True):
device['active'] = 0
else:
device['active'] = 1
if(value['read_only'] is not False):
device['read_only'] = 1
else:
device['read_only'] = 0
if(value['resync'] is not None):
device['resync'] = 1
else:
device['resync'] = 0
device['faulty'] = 0
for disk, diskvalue in value['disks'].items():
if diskvalue['faulty'] is not False:
device['faulty'] = device['faulty'] + 1
results[key] = device
return results
if __name__ == '__main__':
Plugin().execute()
PK �Eu\��? ? agent360/plugins/fail2ban.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'fail2ban'
def run(self, config):
'''
Monitor currently banned IP's, specify the fail2ban jail you want to monitor in /etc/agent360.ini
Example:
[fail2ban]
enabled = yes
jail = sshd
Nota bene: agent360 requires sudo permission to access fail2ban-client
'''
data = {}
jail = config.get('fail2ban', 'jail').split(',')
for nom in jail:
data[nom] = {'count': os.popen('sudo /bin/fail2ban-client status '+ nom +' | egrep -i "Currently banned:.*" | egrep -o "[0-9.]+"').read().rstrip()}
return data
if __name__ == '__main__':
Plugin().execute()
PK �Eu\ "22� � 3 agent360/plugins/__pycache__/megacli.cpython-39.pycnu �[��� a
��?h�
� @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZmegaclic
C s� i }�z�t �d��� �� }i }|D �]�}|�d�rb|�d�}|�d�}t||d |� �� �|d< |�d�r�|�d�}||d d � �� |d< q"|�d �r�|�d�}||d d � �� |d
< q"|�d �r�|�d�}||d d � �� |d < q"|�d
��r |�d�}||d d � �� |d< q"|�d��rV|�d�}|�d�}||d |� �� |d< q"|�d��r�|�d�}t||d d � �� �|d< q"|�d��r�|�d�}t||d d � �� �|d< q"|�d��r�|�d�}||d d � �� |d< q"|�d��r |�d�}||d d � �� |d< q"|�d��rN|�d�}||d d � �� |d< q"|�d ��r~|�d�}||d d � �� |d < q"|�d �r"|�d�}||d d � �� |d < q"|||d < W n* t�y� } z|W Y d }~S d }~0 0 |S ) Nzmegacli -LDInfo -Lall -aALLz
Virtual Drive�(�:� Zvirtualdisk_id�Name�namez
RAID LevelZ
raid_level�Size�size�State�statez
Strip Sizez KBZ stripe_sizezNumber Of DrivesZnumber_of_drivesz
Span DepthZ
span_depthzDefault Cache PolicyZdefault_cache_policyzCurrent Cache PolicyZcurrent_cache_policyzCurrent Access PolicyZ
access_policyzDisk Cache PolicyZdisk_cache_policyZ
EncryptionZ
encryption) �os�popen�read�
splitlines�
startswith�find�int�strip� Exception) �self�configZdiskZdf_output_lines�data�line�delim�offset�e� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/megacli.py�run sd
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zplugins�jsonZ
BasePluginr r �executer r r r �<module> s
;PK �Eu\1oF F 2 agent360/plugins/__pycache__/iostat.cpython-39.pycnu �[��� a
��?hk � @ sj d dl Z d dlZd dlZd dlZd dlZd dlZd dlZddd�ZG dd� dej�Z e
dkrfe � � � dS )� Nc
C s~ d}i }t j�d�sdS g d�}g d�}g d�}g d�}t|d��� }|D �],}|dkrZqJ|�� } t| �t|�krx|}
nDt| �t|�kr�|}
n.t| �t|�kr�|}
nt| �t|�krJ|}
nqJtt|
| ��} | d d d
� d kr�| d d d
� dkr�n | d d
d � � � du �rqJd| d v sJd| d v �r,qJ| d u�rF| | d k�rFqJ| D ] } | d k�rJt
| | �| | < �qJ| || d < qJ|S )Nz/proc/diskstatsF)�m�mm�dev�reads�rd_mrg�
rd_sectors�
ms_reading�writes�wr_mrg�
wr_sectors�
ms_writing�cur_ios� ms_doing_io� ms_weighted)r r r r r r r r r
r r r
r r �discards�discards_merged�discarded_sectors�discarded_time)r r r r r r r r r
r r r
r r r r r r �flush�
flush_time)r r r r r r r �r� r � Znvm�������nT�loopZram) �os�path�isfile�open� readlines�split�len�dict�zip�isdigit�int)
r � file_path�resultZ columns_diskZcolumns_disk_418Zcolumns_disk_55Zcolumns_partition�lines�liner" �columns�data�key� r/ �A/usr/local/lib/python3.9/site-packages/agent360/plugins/iostat.py�diskstats_parse
sH
(
r1 c @ s e Zd ZdZ dd� ZdS )�PluginZiostatc
G s d}i }t � � |d< | �� }t� }|r.|du r�i }zHtjdd�}|�� D ].\}} i }
| jD ]} t| | �|
| < qZ|
||< qHW n* ty� } z| j }W Y d } ~ n
d } ~ 0 0 �ndi }|�� D �]T\}} i }
i ||< t � � || d< z || W n i ||< Y n0 | �� D ]R\} }
| |v �rNz| �
| |
|| �|
| < W n Y n0 |
|| | < n|
|
| < �qz(|
d |
d |
d |
d |
d
< W n d |
d
< Y n0 z|
d |
d |
d < W n d |
d < Y n0 z(d
|
d d|d |d |
d< W n d |
d< Y n0 |
||< q�| � |� |S )N)r r r r r r r
r r r r r r r r �tsFT)Zperdiskr r r r zavgrq-szr Ztps�d r i� �usage) �timeZget_agent_cacher1 �psutilZdisk_io_counters�items�_fields�getattr� Exception�messageZabsolute_to_per_secondZset_agent_cache)�selfZunusedZ
delta_keysZ
next_cacheZ
prev_cache�disks�resultsZdiskdataZdevice�valuesZ device_stats� key_value�e�valuer/ r/ r0 �runO s`
((
z
Plugin.runN)�__name__�
__module__� __qualname__rD r/ r/ r/ r0 r2 L s r2 �__main__)N) r �signal�
subprocess�sysr7 Zpluginsr6 r1 Z
BasePluginr2 rE �executer/ r/ r/ r0 �<module> s
?JPK �Eu\ ��/{ { 2 agent360/plugins/__pycache__/phpfpm.cpython-39.pycnu �[��� a
��?h�
� @ s� z0d dl mZmZ d dlmZmZ d dlmZ W n> eyn d dlmZ d dl mZ d dl
mZmZmZ Y n0 d dl Z d dl Z d dl
Z
d dlZG dd � d e
j�Zed
kr�e� �� dS ) � )�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r r r Nc @ s e Zd ZdZ dd� ZdS )�PluginZphpfpmc C s� dd� }t � }t � }|�td��d�}| �� }|D �]�}t|�}t|�} z�| �� �d�}
t j
dkrnt � |
�} nt j |
|d�} i || d < t
�
� |d | d < | �� D ] \} }
|
|| d | �d
d �< q�t|| d d �|d
| d < W n. t�y } z|W Y d}~ S d}~0 0 z�|d
| d |d
| d k�r�|d
| d |d
| d |d | d |d | d || d d< n<|d
| d |d | d |d | d || d d< W q2 t�y� d|| d d< Y q20 q2| �|� |S )z-
php-fpm status page metrics
c s" dd� � t � fdd�| �� D ��S )Nc S s t | t�r| �d�S | S )N�ascii)�
isinstance�unicode�encode)�x� r
�A/usr/local/lib/python3.9/site-packages/agent360/plugins/phpfpm.py�<lambda> � z7Plugin.run.<locals>.ascii_encode_dict.<locals>.<lambda>c 3 s | ]}t � |�V qd S )N)�map)�.0�pair�� ascii_encoder
r � <genexpr> r z8Plugin.run.<locals>.ascii_encode_dict.<locals>.<genexpr>)�dict�items)�datar
r r �ascii_encode_dict s z%Plugin.run.<locals>.ascii_encode_dictZstatus_page_url�,zutf-8)� )� object_hook�poolz%s_ts� �_Z
accepted_connz%s_accepted_connNZaccepted_conn_per_secondg )r �get�__name__�splitZget_agent_cacher r �read�decode�sys� version_info�json�loads�timer �replace�int� Exception�KeyErrorZset_agent_cache)�self�configr �resultsZ
next_cacheZmy_poolsZ
prev_cacher �requestZ raw_responser �j�k�v�er
r
r �run sD
$ " �� ��
z
Plugin.runN)r" �
__module__� __qualname__r7 r
r
r
r r s r �__main__)� urllib.parser r �urllib.requestr r � urllib.errorr � ImportError�urllib�urllib2r& r* Zpluginsr( Z
BasePluginr r" �executer
r
r
r �<module> s 5PK �Eu\3�c�` ` 3 agent360/plugins/__pycache__/haproxy.cpython-39.pycnu �[��� a
��?h� � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�haproxyc C sN t � }t � }z$|�dd�}|�dd�}||f}W n d}Y n0 |�dd�}d|vr^|d }tj||d�}t�� |d< | �� } |jd u r�|j�d
�}
n d �|j�S d } d
} t �
|
�}
t � }t t g}|
D �]h}i ||d d |d < i ||d d |d < z$| d | |d d |d d< W n, t
�yN i | |d d |d < Y n0 |�� D ]�\}}|D ](}z ||�}W n t�y� Y n0 �qd|| v �r�|||d d |d |< nx|| v �rXt|�t u�rX| �|t |�| |d d |d �||d d |d |< t |�||d d |d |< n �qXq�t�� |d< | �|� |S )Nr �username�passwordF�status_page_urlz;csv)�auth�ts�� �
z&Could not load haproxy status page: {})ZqcurZqmaxZscurZsmaxZslimZstotZweightZqlimitZthrottleZlbtotZtrackedZrateZrate_limZrate_maxZhanafailZreq_rateZ req_rate_maxZreq_totZ conn_rateZ
conn_rate_maxZconn_tot) �binZboutZcli_abrtZsrv_abrtZ interceptedZhrsp_1xxZhrsp_2xxZhrsp_3xxZhrsp_4xxZ
check_riseZ
check_fallZ check_healthZ
agent_riseZ
agent_fallZhrsp_5xxZcomp_inZcomp_outZcomp_bypZcomp_rspZ
hrsp_otherZdconZdreqZdrespZereqZeconZerespZwretrZwredisZdsesz# pxname�/Zsvname)�dict�get�requests�timeZget_agent_cache� status_code�text�split�format�csv�
DictReader�str�float�KeyError�items�
ValueError�typeZabsolute_to_per_secondZset_agent_cache)�self�config�resultsZ
next_cacher r � user_passr �requestZ
prev_cache�responseZ non_delta�deltaZ
csv_reader�data� constructors�row�k�v�c� r* �B/usr/local/lib/python3.9/site-packages/agent360/plugins/haproxy.py�run sX
1
$
>"
z
Plugin.runN)�__name__�
__module__� __qualname__r, r* r* r* r+ r s r �__main__)r Zpluginsr r Z
BasePluginr r- �executer* r* r* r+ �<module> s PK �Eu\���� � 6 agent360/plugins/__pycache__/diskinodes.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZ
diskinodesc C s� i }zxdd� t �d��� �� D �}|d= |D ]L}|d dkr>q,t|d �t|d �t|d �|d d d
� d �||d < q,W n Y n0 |S ) Nc S s g | ] }|� � �qS � )�split)�.0�sr r �E/usr/local/lib/python3.9/site-packages/agent360/plugins/diskinodes.py�
<listcomp> � z Plugin.run.<locals>.<listcomp>zdf -Plir Ztmpfs� � � � ���)�total�used�free�percent)�os�popen�read�
splitlines�int)�self�configZdiskZdf_output_lines�rowr r r �run s @z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s PK �Eu\�YL�^ ^ 6 agent360/plugins/__pycache__/wp-toolkit.cpython-39.pycnu �[��� a
��?h5 � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dZdZdd� ZdS )�Plugin�
wp-toolkitz
WP ToolkitzPUnified plugin for gathering metrics for WP Toolkit servers on cPanel and Plesk.c C s� d}t j�d�rd}nt j�d�r&d}i }|dkr�tt �d| d ��� �|d< tt �d| d ��� �|d
< tt �d| d ��� �|d < tt �d| d
��� �|d< tt �d| d ��� �|d< |S dS dS )a�
Grabbing some basic information from your cPanel or Plesk server
If you are using Plesk:
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/plesk
For cPanel:
agent360 ALL=(ALL) NOPASSWD: /usr/local/bin/wp-toolkit
test by running:
sudo -u agent360 agent360 test wp-toolkit
Add to /etc/agent360.ini:
[wp-toolkit]
enabled = yes
interval = 3600
� z/var/cpanel/usersr z
/opt/pleskzplesk ext wp-toolkitzsudo -n z3 --list | grep -v "Main Domain ID" | grep . | wc -lzWordPress Websitesz --list | grep "Working" | wc -lzWordPress Websites - Alivez% --list | grep "Outdated WP" | wc -lz WordPress Websites - Outdatedz& --list | grep "Outdated PHP" | wc -lz!WordPress Websites - Outdated PHPz --list | grep "Broken" | wc -lzWordPress Websites - Brokenz!Neither cPanel nor Plesk detectedN)�os�path�isdir�int�popen�read)�self�config�command�data� r �E/usr/local/lib/python3.9/site-packages/agent360/plugins/wp-toolkit.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__� __title__�__description__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s )PK �Eu\��r�m m 1 agent360/plugins/__pycache__/mysql.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�mysqlc
C s� | � � }i }zt|�dd��|d< W n ty> d|d< Y n0 z|�dd�|d< W n d|d< Y n0 z|�dd�|d< W n d |d< Y n0 z|�dd
�|d
< W n |�dd �|d < Y n0 z|�dd
�|d< W n d|d< Y n0 tjf i |��}|�� }|�d� |�� }d}d}t � } t � }
t
t g} |D ]�\} }
| � � �
� } | D ](}z ||
�}
W n t�yv Y n0 �qR| |v �r�|
| | < n<| |v �r:t|
�t
u�r:| �| t |
�|�| | < t |
�|
| < n �q:|�tjj�}|�d� |�� }d}|du �rt � }|�� D ]�\} }
| � � �
� } | dk�r<|
dk�r8dnd}
| dk�rX|
dk�rTdnd}
| D ](}z ||
�}
W n t�y� Y n0 �q\| |v �r t|
�t
u�r |
| | < n �q |�� t�� |
d< | �|
� | S )z&
MySQL metrics plugin
r �porti� �username�user�root�password�passwd� �host�socketZ unix_socketZdatabase�dbzSHOW GLOBAL STATUS;) �max_used_connections�
open_files� open_tables�qcache_free_blocks�qcache_free_memory�qcache_total_blocks�slave_open_temp_tables�threads_cached�threads_connected�threads_runningZuptime)7Zaborted_clientsZaborted_connectsZbinlog_cache_disk_useZbinlog_cache_useZbytes_receivedZ
bytes_sentZ
com_deleteZcom_delete_multiZ
com_insertZcom_insert_selectZcom_loadZ com_replaceZcom_replace_selectZ
com_selectZ
com_updateZcom_update_multi� connectionsZcreated_tmp_disk_tablesZcreated_tmp_filesZcreated_tmp_tablesZ key_readsZkey_read_requestsZ
key_writesZkey_write_requestsr r r Z
opened_tablesr r Z qcache_hitsZqcache_insertsZqcache_lowmem_prunesZqcache_not_cachedZqcache_queries_in_cacher Z questionsZselect_full_joinZselect_full_range_joinZ select_rangeZselect_range_checkZ select_scanr Zslave_retried_transactionsZslow_launch_threadsZ slow_queriesZ
sort_rangeZ sort_rowsZ sort_scanZtable_locks_immediateZtable_locks_waitedr r Zthreads_createdr zSHOW SLAVE STATUS) Zslave_io_stateZ master_hostZseconds_behind_masterZread_master_log_posZ
relay_log_pos�slave_io_running�slave_sql_runningZ
last_errorZexec_master_log_posZrelay_log_spaceZslave_sql_running_stateZmaster_retry_countNr ZYes� r r �ts)Zget_agent_cache�int�get�
ValueError�MySQLdb�connect�cursor�executeZfetchall�dict�str�float�lower�strip�typeZabsolute_to_per_secondZcursorsZ
DictCursorZfetchone�items�close�timeZset_agent_cache)�self�configZ
prev_cache�authr
r" Z query_resultZ non_deltaZ
delta_keys�results�data� constructors�key�value�cZquery_result_slaveZnon_delta_slave� r6 �@/usr/local/lib/python3.9/site-packages/agent360/plugins/mysql.py�run
s�
:
z
Plugin.runN)�__name__�
__module__� __qualname__r8 r6 r6 r6 r7 r s r �__main__)r, r ZpluginsZ
BasePluginr r9 r# r6 r6 r6 r7 �<module> s 'PK �Eu\tlT� � 4 agent360/plugins/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/__init__.py�<module> � PK �Eu\�d�= = 1 agent360/plugins/__pycache__/nginx.cpython-39.pycnu �[��� a
��?h� � @ s� z0d dl mZmZ d dlmZmZ d dlmZ W n> eyn d dlmZ d dl mZ d dl
mZmZmZ Y n0 d dl Z d dl Z G dd � d e j
�Zed
kr�e� �� dS ) � )�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r r r Nc @ s e Zd ZdZ dd� ZdS )�Plugin�nginxc C s� �z�t � }t � }t�� |d< | �� }t|�dd��}t|��� �d��d�}|d �� d }t |�|d< |d �� d d
� }|d �� } t
|| �D ]�\}
} t | �||
< ||
||
< z^||
||
kr�||
||
|d |d |d |
< n ||
|d |d |d |
< W q� t �y0 d
|d |
< Y q�0 q�|d �� dd
d � }dd� |D �}|d �� d d
d � } t
|| �D ]\}
} t | �||
< �qx| � |� |W S t
�y� Y dS 0 d
S )a(
Provides the following metrics (example):
"accepts": 588462,
"accepts_per_second": 0.0,
"active_connections": 192,
"handled": 588462,
"handled_per_second": 0.0,
"reading": 0,
"requests": 9637106,
"requests_per_second": 0.0,
"waiting": 189,
"writing": 3
requests, accepts, handled are values since the start of nginx.
*_per_second values calculated from them using cached values from previous call.
�tsr Zstatus_page_urlzutf-8�
r ����active_connections� N� z
%s_per_secondg � c S s g | ]}|� d ��� �qS )�:)�strip�lower)�.0�entry� r �@/usr/local/lib/python3.9/site-packages/agent360/plugins/nginx.py�
<listcomp>H � z Plugin.run.<locals>.<listcomp>F)�dict�timeZget_agent_cacher �getr �read�decode�split�int�zip�KeyErrorZset_agent_cache� Exception) �self�config�resultsZ
next_cacheZ
prev_cache�request�responser �keys�values�key�valuer r r �run sF �� ��
z
Plugin.runN)�__name__�
__module__� __qualname__r, r r r r r s r �__main__)� urllib.parser r �urllib.requestr r � urllib.errorr � ImportError�urllib�urllib2r ZpluginsZ
BasePluginr r- �executer r r r �<module> s EPK �Eu\(ʠ�a a 4 agent360/plugins/__pycache__/tcpports.cpython-39.pycnu �[��� a
��?hV � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZtcpportsc C sh dd� }t � }|�td��d�}t|�td��}|D ].}|�d�\}}t|�}d||||�i||< q4|S )z/
Checks if TCP ports are open.
c S sR t � t jt j�}|�|� z |�| |f� |�� W dS t jyL Y dS 0 d S )N� r )�socket�AF_INET� SOCK_STREAM�
settimeout�connect�close�error)�host�port�timeout�sock� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/tcpports.py� is_port_open s
z Plugin.run.<locals>.is_port_open�
host_ports�,r
�:� available)�dict�get�__name__�split�float�int) �self�configr �resultsr r
� host_portr r r r r �run
s
z
Plugin.runN)r �
__module__� __qualname__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s PK �Eu\#��} } 3 agent360/plugins/__pycache__/openvpn.cpython-39.pycnu �[��� a
��?h� � @ sL d dl Z d dlZd dlZd dlmZ G dd� dej�ZedkrHe� �� dS )� N)� parse_statusc @ s e Zd ZdZ dd� ZdS )�Plugin�openvpnc
C s� i }i }| � � }z@t|�dd��� }t|�� �}W d � n1 sD0 Y W n( tyx } z|W Y d}~S d}~0 0 z�t|j�� �|d< |j�� D ]�\}} | j �
dd�| _ i || j < t | j �}
t | j
�} | �d| j df |
|�|| j d< | �d| j d f | |�|| j d < | |d| j d f < |
|d| j df < q�W n* t�yd } z|W Y d}~S d}~0 0 t�� |d
< | �|� |S ) a
OpenVPN monitoring, needs access to openvpn-status.log file.
pip install openvpn-status
or
pip3 install openvpn-status
In /etc/agent360.ini to enable put:
[openvpn]
enabled = yes
status_path = /etc/openvpn/openvpn-status.log
test the plugin by running: sudo -u agent360 agent360 test OpenVPN
If you are having permission issues try to run the agent as root user:
https://docs.360monitoring.com/docs/run-the-monitoring-agent-as-the-root-user
r Z status_pathNZ
containers�.�-z%s_%sZ
net_out_bytesZ net_in_bytes�ts)Zget_agent_cache�open�getr �read� Exception�lenZ client_list�itemsZ common_name�replace�intZ
bytes_sentZbytes_receivedZabsolute_to_per_second�timeZset_agent_cache) �self�configZopenvpn_clients�
last_valueZ
prev_cache�logfile�status�e�key�clientZ bytes_outZbytes_in� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/openvpn.py�run s0 .
""
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__) �osZpluginsr Zopenvpn_statusr Z
BasePluginr r �executer r r r �<module> s 2PK �Eu\%�I? ? 4 agent360/plugins/__pycache__/asterisk.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� de j�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZasteriskc C s� |� td�}tjdtjdd�}|�� d �d��dd�}tjd tjdd�}|�� d �d��dd�}tjd
| tjdd�}|�� d �d��dd�}|||d �}|S ) NZsbcipzDsudo asterisk -rx 'core show calls' | grep 'active' | cut -f1 -d ' 'T)�stdout�shellr zutf-8�
� zRsudo asterisk -rx 'core show channels verbose' | cut -c1-15 | grep 'pstn_' | wc -lz6sudo asterisk -rx 'sip show peers' | grep '%s' | wc -l)ZcallsZ
incomingcalls�devices)�get�__name__�
subprocess�Popen�PIPE� communicate�decode�replace)�self�config�ip�p�incomingr �res� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/asterisk.py�run
s z
Plugin.runN)r �
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr
Z
BasePluginr r �executer r r r �<module> s PK �Eu\��
�� � 1 agent360/plugins/__pycache__/janus.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� de j�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�janusc C sL |� dd�}tjd| d tjdd�}|�� d �d��d d
�}d |i}|S ) Nr �adminpwz�curl -s -H "Accept: application/json" -H "Content-type: application/json" -X POST -d '{ "janus": "list_sessions", "transaction": "324", "admin_secret": "zC" }' http://localhost:7088/admin | awk 'NR>=5' | head -n -2 | wc -lT)�stdout�shellr zutf-8�
� Zjanus_sessions)�get�
subprocess�Popen�PIPE� communicate�decode�replace)�self�configr �p�res� r �@/usr/local/lib/python3.9/site-packages/agent360/plugins/janus.py�run
s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr
Z
BasePluginr r �executer r r r �<module> s
PK �Eu\��f� � 6 agent360/plugins/__pycache__/cloudlinux.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�
cloudlinuxc C sr t �d��� }i }zt�|�}W n ty4 Y dS 0 |d durFdS i }|d D ]}|d }|d= |||< qR|S )a
Beta plugin to monitor cloudlinux users
Requires sudo access to lveinfo (whereis lveinfo) add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /REPLACE/PATH/TO/lveinfo
To enable add to /etc/agent360.ini:
[cloudlinux]
enabled = yes
z3sudo lveinfo -d --period 5m -o cpu_avg -l 20 --jsonzCould not load lveinfo data�success� zFailed to load lveinfo�dataZID)�os�popen�read�json�loads� Exception)�self�configr �results�line�username� r �E/usr/local/lib/python3.9/site-packages/agent360/plugins/cloudlinux.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr
Z
BasePluginr r �executer r r r �<module> s
!PK �Eu\=ߘ�Q Q 2 agent360/plugins/__pycache__/cpanel.cpython-39.pycnu �[��� a
��?h� � @ sH d dl Z d dlZd dlZd dlZG dd� de j�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� Zdd� ZdS )�PluginZcpanelc C s\ |� � }dddddd�}t�d|�s2t�dd |�}d
d � |�� D �\}}tt|�|| �S ) N� i i i @l )�B�K�M�G�T� z([KMGT])z \1c S s g | ] }|� � �qS � )�strip)�.0�stringr
r
�A/usr/local/lib/python3.9/site-packages/agent360/plugins/cpanel.py�
<listcomp> � z#Plugin.to_bytes.<locals>.<listcomp>)�upper�re�match�sub�split�int�float)�self�sizeZunits�number�unitr
r
r �to_bytes s zPlugin.to_bytesc C sp t �g d��}i }t�|�}|d d D ]B}| �|d �|d |d |d |d |d |d
d �||d < q(|S )
z�
Plugin to collect cpanel user accounts
To enable add to /etc/agent360.ini:
[cpanel]
enabled = yes
)Zwhmapi1z--output=jsonprettyZ listaccts�dataZacctZdiskused�
inodesused� is_locked�
has_backup�outgoing_mail_hold�outgoing_mail_suspended� suspended)Zdiskused_bytesr r r r! r" r# �user)�
subprocess� check_output�json�loadsr )r �configr �resultsZaccounts�accountr
r
r �run s
� z
Plugin.runN)�__name__�
__module__� __qualname__r r, r
r
r
r r s r �__main__)Zpluginsr% r' r Z
BasePluginr r- �executer
r
r
r �<module> s %PK �Eu\��?�} } 3 agent360/plugins/__pycache__/dirsize.cpython-39.pycnu �[��� a
��?hi � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�dirsizec C sL i }|� dd��d�}|D ],}dt�d�|���� �dd��� i||< q|S )zq
Monitor total directory sizes, specify the directories you want to monitor in /etc/agent360.ini
r �dirs�,�byteszdu -sbc {} | grep total�total� )�get�split�os�popen�format�read�replace�rstrip)�self�config�dataZmy_dirs�dir� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/dirsize.py�run s
*z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r �
subprocessZplugins�jsonZ
BasePluginr r �executer r r r �<module> s PK �Eu\�5ۛr r 0 agent360/plugins/__pycache__/temp.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� de j�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�tempc G s� i }t jdkr�z ddl}W n Y dS 0 zH|jdd�}|�� }|D ](}|jdkrD|j||j�dd �� d �< qD|W S Y d
S 0 t
t d �s�d S z t � � }W n Y d
S 0 |�
� D ]6\}} | D ](}
|
d } |
d dkr�|} |
d || < q�q�|S )z�
expirimental plugin used to collect temperature from system sensors
plugin can be tested by running agent360 test temp
�win32r Nzwmi module not installed.zroot\OpenHardwareMonitor)� namespaceZ Temperature�/�-z:Could not fetch temperature data from OpenHardwareMonitor.�sensors_temperatureszplatform not supportedzcan't read any temperature� � )�sys�platform�wmiZWMIZSensorZ
SensorType�ValueZParent�replace�strip�hasattr�psutilr �items) �selfZunused�datar
�wZtemperature_infosZsensorZtempsZdevicer �value�type� r �?/usr/local/lib/python3.9/site-packages/agent360/plugins/temp.py�run
s8
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr r Z
BasePluginr r �executer r r r �<module> s
*PK �Eu\�߷
� � 4 agent360/plugins/__pycache__/kamailio.cpython-39.pycnu �[��� a
��?h, � @ s8 d dl Z d dlZG dd� de j�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZasteriskc G s8 t jdt jdd�}|�� d �d��dd�}d|i}|S ) Nz&sudo kamctl ul show | grep AOR | wc -lT)�stdout�shellr zutf-8�
� Zdevices_online)�
subprocess�Popen�PIPE� communicate�decode�replace)�selfZunused�p� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/kamailio.py�run
s z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr Z
BasePluginr r �executer r r r �<module> s PK �Eu\�!X�� � 0 agent360/plugins/__pycache__/bind.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�bindc C s4 |� dd�}t�dt|� d ��� }t�|�}|S )a
Monitoring bind nameserver
You must have the bind statistics-channels configured
and you must have jq installed for json processing.
Usage for /etc/agent360.ini:
[bind]
enabled = yes
port = 8053
r �portzcurl -j http://localhost:z5/json 2>/dev/null | jq ".qtypes * .rcodes * .nsstats")�get�os�popen�str�read�json�loads)�self�configZbport�result�data� r �?/usr/local/lib/python3.9/site-packages/agent360/plugins/bind.py�run
s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr
Z
BasePluginr r �executer r r r �<module> s
PK �Eu\��|�� � 1 agent360/plugins/__pycache__/mailq.cpython-39.pycnu �[��� a
��?h � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZmailqc G sD dd l }|�d�}|�� }i }t|�dkr4d|d< n t|�|d< |S )Nr zDsudo /usr/bin/mailq | /usr/bin/tail -n1 | /usr/bin/gawk '{print $5}'� Z
queue_size)�os�popen�read�len�int)�selfZunusedr �stream�retval�results� r
�@/usr/local/lib/python3.9/site-packages/agent360/plugins/mailq.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r
r
r
r r s r �__main__)r ZpluginsZ
BasePluginr r �executer
r
r
r �<module> s
PK �Eu\�o�^� � 4 agent360/plugins/__pycache__/powerdns.cpython-39.pycnu �[��� a
��?h= � @ s� zd dl mZmZ W n" ey6 d dlmZmZ Y n0 d dlZd dlZd dlZd dlZG dd� dej�Z e
dkr|e � � � dS )� )�urlopen�RequestNc @ s e Zd ZdZ dd� ZdS )�PluginZpowerdnsc
C s� t j|�td�dd|�td� id�}d}t� }d}t� }| �� }|�td�r^t|�td��}|�td �r�t j|||�td �d
�}n4|�td �r�t j|||�td �d �}nt j||d
�}t � � |d< zt
� |� � �}W n t
y� Y dS 0 d} d}
t� } |D ]�} d| v � r�d| v � r�d| v � r�| d dk� r�| d | v �rt| �| d t| d �|�|| d < t| d �| | d < n"| d |
v � r�t| d �|| d < � q�t � � | d< | �| � |S )a�
Experimental plugin for PowerDNS authoritative server. Might also work with PowerDNS recursor,
but it may need extra delta_keys / absolute_keys.
Add to /etc/agent360.ini:
[powerdns]
enabled=yes
statistics_url=http://localhost:8081/api/v1/servers/localhost/statistics
api_key=changeme
;ca_file=
;ca_path=
;timeout=10
Zstatistics_urlz X-API-Keyz%sZapi_key)�headers�
N�timeoutZca_file)r �cafileZca_path)r �capath)r �tsF)/zcorrupt-packetszdeferred-cache-insertszdeferred-cache-lookupz deferred-packetcache-insertszdeferred-packetcache-lookupzdnsupdate-answerszdnsupdate-changeszdnsupdate-querieszdnsupdate-refusedzincoming-notificationszoverload-dropszpacketcache-hitzpacketcache-misszquery-cache-hitzquery-cache-missz
rd-querieszrecursing-answerszrecursing-questionszrecursion-unansweredzservfail-packetsZ
signatureszsys-msecz tcp-answersztcp-answers-bytesz tcp-queriesz tcp4-answersztcp4-answers-bytesz tcp4-queriesz tcp6-answersztcp6-answers-bytesz tcp6-queriesztimedout-packetsz udp-answerszudp-answers-byteszudp-do-queriesz
udp-in-errorszudp-noport-errorsz udp-querieszudp-recvbuf-errorszudp-sndbuf-errorsz udp4-answerszudp4-answers-bytesz udp4-queriesz udp6-answerszudp6-answers-bytesz udp6-queriesz user-msec) zkey-cache-sizeZlatencyzfd-usagezmeta-cache-sizezopen-tcp-connectionszpacketcache-sizezqsize-qzquery-cache-sizezreal-memory-usagezsecurity-statuszsignature-cache-sizeZuptime�name�value�typeZ
StatisticItem)�urllib2r �get�__name__�dictZget_agent_cache�
has_option�intr �time�json�loads�read� ExceptionZabsolute_to_per_second�floatZset_agent_cache)
�self�config�requestr �resultsZ raw_responseZ
next_cacheZ
prev_cache�statsZ
delta_keysZ
absolute_keys�data�stat� r! �C/usr/local/lib/python3.9/site-packages/agent360/plugins/powerdns.py�run s@ & 3 "
z
Plugin.runN)r �
__module__� __qualname__r# r! r! r! r" r s r �__main__) �urllib.requestr r � ImportErrorr r Zpluginsr Z
BasePluginr r �executer! r! r! r" �<module> s yPK �Eu\��z`� � 6 agent360/plugins/__pycache__/diskstatus.cpython-39.pycnu �[��� a
��?h� � @ sP d dl Z d dlZd dlZd dlZd dlZG dd� dej�ZedkrLe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZ
diskstatusc C s� i }z.t jdt jt jdd��� d �� �� }d}W n* ty\ } zd}W Y d}~dS d}~0 0 |du �r�|D �] }z�|�d�d �d �d
}t� d �
|�d�d ��� � �� }d} |d �d
�d dkr�d} i ||< d}
|D ]p} | dd� dk� r�d}
q�|
du �rq�t �
dd| ��� } | �d�} t| �dkr�| d || | d �� �dd�< q�| || d< W ql t�y� } zt|� W Y d}~qld}~0 0 ql|S )a
Monitor nvme or smart disk status.
For NVME drives use the diskstatus-nvme plugin
for smart status install smartmontools (apt-get/yum install smartmontools)
This plugin requires the agent to be run under the root user.
zsmartctl --scanT)�stdout�stderr�shellr FNz+Could not fetch smartctl status information� �/� zsmartctl -A -H {}� z: � ZPASSED� zID#z +� Z_celsius� �status)�
subprocess�Popen�PIPE� communicate�decode�
splitlines� Exception�split�os�popen�format�read�re�sub�strip�len�lower�replace�print) �self�config�resultsZdevlistZsmartctl�e�rowZdisk_idZ
disk_statsZ smart_status�start�stats� r) �E/usr/local/lib/python3.9/site-packages/agent360/plugins/diskstatus.py�run s> &
"
" z
Plugin.runN)�__name__�
__module__� __qualname__r+ r) r) r) r* r s r �__main__) r r Zplugins�jsonr Z
BasePluginr r, �executer) r) r) r* �<module> s -PK �Eu\ �+�} } 7 agent360/plugins/__pycache__/apt-updates.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin� apt-updatesc C s� i }t t�d��� �|d< t t�d��� �|d< z>|�dd�}tj�d�r\|dkr\d |d
< n|dkrld |d
< W n ty� Y n0 |S ) a�
ubuntu/debian updates available from apt-get
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/bin/apt-get
test by running:
sudo -u agent360 agent360 test apt-updates
Add to /etc/agent360.ini:
[apt-updates]
enabled = yes
interval = 3600
Optionally check if a reboot is required:
checkreboot = true
z>sudo -n apt-get upgrade -s | grep Inst | grep security | wc -l�securityzAsudo -n apt-get upgrade -s | grep Inst | grep -v security | wc -l�otherr � checkrebootz/var/run/reboot-required�trueZYeszReboot RequiredZNo)�int�os�popen�read�get�path�exists� Exception)�self�config�datar � r �F/usr/local/lib/python3.9/site-packages/agent360/plugins/apt-updates.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s !PK �Eu\�Nr / agent360/plugins/__pycache__/cpu.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�cpuc G s� | � � }i }t�� |d< i }t�� }z |d W np ty� tjdd�}d}t�� |d< |D ]2}|d }i ||< |jD ]} t|| �|| | < qxq^t�d� Y n0 tjdd�}d}|D ]�}|d }i ||< i ||< |jD ]�} t|| �|| | < zt�� |d }
W n Y q�Y n0 |
dk�r q�t|| �|| | } | dk �rDd} | |
d || | < || | dk�rvd|| | < || | dk r�d|| | < q�q�| � |� |S ) N�tsT)Zpercpu���� g �?r �d )
Zget_agent_cache�time�psutilZ cpu_stats�KeyErrorZ cpu_times�_fields�getattr�sleepZset_agent_cache) �selfZunusedZ
prev_cacheZ
next_cache�resultsZ
data_stats�data�
cpu_numberr �keyZ
time_deltaZcpu_time_delta� r �>/usr/local/lib/python3.9/site-packages/agent360/plugins/cpu.py�run
sR
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr Z
BasePluginr r �executer r r r �<module> s
3PK �Eu\z`�3t
t
2 agent360/plugins/__pycache__/docker.cpython-39.pycnu �[��� a
��?hr
� @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� Zdd� ZdS )�PluginZdockerc
C s i }i }| � � }�z�dd� t�d��� �� D �}|D �]z}i }|d �d�|d< |d }|d } | �|d �|d
< | �|d �|d < | �d
|df | �|d �|�|d< | �d
|df | �|d �|�|d< | �d
|df | �|d �|�|d< | �d
|df | �|d �|�|d< |d �d�|d< | �|d �|d
|d
f < | �|d �|d
|df < | �|d �|d
|df < | �|d �|d
|df < | �|d �|d
|df < |||< q4W n, t�y� }
z|
j W Y d}
~
S d}
~
0 0 t
|�|d< t � � |d< | � |� |S )z�
Docker monitoring, needs sudo access!
Instructions at:
https://docs.360monitoring.com/docs/docker-plugin
c S s g | ]}|� d ��qS )z / )�split)�.0�s� r �A/usr/local/lib/python3.9/site-packages/agent360/plugins/docker.py�
<listcomp> � z Plugin.run.<locals>.<listcomp>z�sudo docker stats --no-stream --no-trunc --format "{{.CPUPerc}} / {{.Name}} / {{.ID}} / {{.MemUsage}} / {{.NetIO}} / {{.BlockIO}} / {{.MemPerc}}"r �%�cpu� � � Zmem_usage_bytes� Zmem_total_bytesz%s_%sZ net_in_bytes� Z
net_out_bytes� Z
disk_in_bytes� Zdisk_out_bytes� � Zmem_pctN�
containers�ts)
Zget_agent_cache�os�popen�read�
splitlines�strip�computerReadableZabsolute_to_per_second� Exception�message�len�timeZset_agent_cache) �self�configr �
last_valueZ
prev_cache�lines�row� container�nameZ container_id�er r r �run s:
$$$$
z
Plugin.runc C s� |dd � dkr$t |d d� �d S |dd � dkrLt |d d� �d d S |dd � dkrxt |d d� �d d d S |dd � dkr�t |d d� �d d d d S |dd � dkr�t |d d� �d d d d d S |dd � d k�rt |d d� �d S |dd � d
k�r,t |d d� �d d S |dd � d k�rZt |d d� �d d d S |dd � d k�r�t |d d� �d d d d S |dd � d
k�r�t |d d� �d d d d d S |dd � dk�r�t |d d� �S d S )N���ZKiBi ZMiBZGiBZTiBZPiB���ZkBZMBZGBZTBZPB����B)�float)r! �valuer r r r 1 s, $ $zPlugin.computerReadableN)�__name__�
__module__� __qualname__r) r r r r r r s &r �__main__)r Zpluginsr Z
BasePluginr r0 �executer r r r �<module> s
APK �Eu\��X��
�
5 agent360/plugins/__pycache__/diskusage.cpython-39.pycnu �[��� a
��?h, � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin� diskusagec
C s. i }g |d< t �d�D ]�}d}g d�}|D ]&}||jv sL||jv sL||jv r*d}q*|dkr\qtjdkr|d|jv s|jdkr|qzDt �|j�}i }||d< |j D ]} t
|| �|| < q�|d � |� W q Y q0 qz|� d d
�}
W n d }
Y n0 t
|d �d k�s|
d
k�r�z�g |d< dd� t�d��� �� D �} | d = | D ]r} | d dk�rT�q>|d � | d | d ddgt| d �d t| d �d t| d �d | d d d� d�� �q>W n Y n0 z|� d d�}
W n d }
Y n0 |
d
k�r�z�dd� t�d ��� �� D �}|D ]�} i }| d |d < t| d d d� �|d < t| d d d� �|d < t|d |d �|d!< |d! t|d � d" |d#< |d � |d |d ddg|d |d! |d |d# d�� �qW n, t�y� } z|jW Y d }~S d }~0 0 z|� d d$�}W n d }Y n0 |d
k�r*z�d%d� t�d&��� �� D �}|D ]�} i }| d |d < t| d d d� �|d < t| d d d� �|d < t|d |d �|d!< |d! t|d � d" |d#< |d � |d |d d$dg|d |d! |d |d# d�� �qDW n, t�y( } z|jW Y d }~S d }~0 0 |S )'Nz df-psutilFT)z/loopz/snapZsquashfszcagefs-skeleton�ntZcdrom� �infor �force_df�nor �yesc S s g | ] }|� � �qS � ��split��.0�sr
r
�D/usr/local/lib/python3.9/site-packages/agent360/plugins/diskusage.py�
<listcomp>3 � z Plugin.run.<locals>.<listcomp>zdf -PlZtmpfs� � i � � � ���)r �total�used�free�percentZzfsc S s g | ]}|� d ��qS �z, r r
r
r
r r C r zzfs list -Hp -t volumeZvg_nameZvg_size� Zvg_freeZvg_used�d Z
vg_percentageZlvmc S s g | ]}|� d ��qS r r r
r
r
r r [ r z6sudo vgs --all --units b --noheadings --separator ', ')�psutilZdisk_partitionsZdeviceZ
mountpointZfstype�os�name�opts�
disk_usage�_fields�getattr�append�get�len�popen�read�
splitlines�int�float� Exception�message)�self�configZdisk�partZ
valid_partZignored_partitions�ignore�usageZdiskdata�keyr Zdf_output_lines�rowZ zfs_stats�lines�v�eZ lvm_statsr
r
r �run
s�
b
B
B z
Plugin.runN)�__name__�
__module__� __qualname__r; r
r
r
r r s r �__main__)r! r Zplugins�jsonZ
BasePluginr r< �executer
r
r
r �<module> s bPK �Eu\ �H� 2 agent360/plugins/__pycache__/memory.cpython-39.pycnu �[��� a
��?h� � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�memoryc G s� i }d|d< t �� }|jD ]}t||�||< q|d dksF|d dkr�tjdkr�ttt�d�� � d �
dd�d �
� �\}}}}} }
} d|| |
d | |d < | |d< | |d< |
|d
< ||d < ||d < ||d
< |S )Nr �buffers� available�ntz
free -b -w� �:�d �percent�cached�total�usedZshared) �psutilZvirtual_memory�_fields�getattr�os�name�map�int�popen� readlines�split) �selfZunusedr Zmemr Ztot_mZused_mZfree_mZsha_mZbuf_mZcac_mZava_m� r �A/usr/local/lib/python3.9/site-packages/agent360/plugins/memory.py�run
s
"6 z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr Z
BasePluginr r �executer r r r �<module> s
PK �Eu\_���, , 3 agent360/plugins/__pycache__/sleeper.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZsleeperc G s t �d� d S )Ni�Q )�time�sleep)�selfZunused� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/sleeper.py�run
s z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r r r r r r �<module> s PK �Eu\� ��� � / agent360/plugins/__pycache__/vms.cpython-39.pycnu �[��� a
��?h� � @ st d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z G dd� dej
�Z e dkrpe � �
� dS )� )�print_functionNc @ s@ e Zd ZdZ dd� Zdd� Zdd� Zdd � Zd
d � Zd d
� ZdS )�PluginZvmsc C s� i }i }| � � }t�dd�}| �|�}i }|�� D ]�\}} i ||< | �� D ]t\}
} |
dksr|
dksr|
dksr|
dkr�| |
|| |
< qJ| �d||
f t| �|�|| |
< t| |
�|d||
f < qJq2t�� |d< | �|� |S ) z�
Using the libvirt API to fetch statistics from guests
running KVM, QEMU, Xen, Virtuozzo, VMWare ESX, LXC,
BHyve and more
�urizqemu:///system� mem_bytes�soft_limit_bytes�min_guarantee_bytes�hard_limit_bytesz%s_%s�ts) Zget_agent_cache�os�getenv� fetch_values�itemsZabsolute_to_per_second�float�timeZset_agent_cache) �self�config�results�
last_valueZ
prev_cacher �valuesZdeltas�key�value�subkeyZsubvalue� r �>/usr/local/lib/python3.9/site-packages/agent360/plugins/vms.py�run s
"
z
Plugin.runc C s t �dd|�S )Nz
[^a-zA-Z0-9_]�_)�re�sub)r �namer r r �canon% s z Plugin.canonc
C s� |� d�}d }zt�|�}W n g Y S 0 |�� }g }zp|�d�}|D ]<}d }|jD ]} | jdkrX| �d�}qX|d kr|qJ|�|� qJW |d kr�|� � |d kr�|�
� n"|d kr�|� � |d kr�|�
� 0 |S )Nr z/domain/devices/interface�target�dev� �XMLDesc�libxml2�parseDoc�xpathNewContext� xpathEval�childrenr �prop�append�xpathFreeContext�freeDoc)
r �dom�xml�doc�ctx�ifaces�ret�node�devdst�childr r r �
get_ifaces( s6
�
zPlugin.get_ifacesc C s� dddd�}|� d�}zt�|�}W n g Y S 0 |�� }zv|D ]L}|�d| �}z&|d jD ]}t|j�||< qzqbW qD ty� Y qD0 qDW |d kr�|� � |d kr�|�
� n"|d kr�|� � |d kr�|�
� 0 |S )Nr )�
min_guarantee�
soft_limit�
hard_limitz/domain/memtune/%s) r# r$ r% r& r' r( �int�content�
IndexErrorr+ r, ) r r- �memtuner. r/ r0 r r2 r5 r r r � get_memtuneB s2
�
zPlugin.get_memtunec C s
t �|�}|�� }i }|D �]�}i }d|d< d|d< z|�|�}|�� }W nH t jy� } z.td|| f tjd� W Y d } ~ qW Y d } ~ n
d } ~ 0 0 |dkr�q| � |�}
|
D ]^} z6|�
| �} |d | d 7 < |d | d 7 < W q� ttj? d| |f f Y q�0 q�t |� � d �}
d |
}||d
< z|t
�� |d < W n& t�yf } z W Y d }~n
d }~0 0 |� � d d
� \}}|d9 }|d9 }||d< | �|�}|d d |d< |d d |d< |d d |d< d|d< d|d< d|d< d|d< z|�|�}|�� }W nJ t j�yN } z.td|| f tjd� W Y d } ~ qW Y d } ~ n
d } ~ 0 0 |dk�r\q| �|�}|D ]�}zX|�|�\}}}}}|d |7 < |d |7 < |d |7 < |d |7 < W n* t�y� ttj? d||f f Y n0 �qj||| �|�< q|S )Nr Z net_rx_bytesZ net_tx_bytesz
Id: %s: %s)�filezDomain-0� z#Cannot get ifstats for '%s' on '%s'gH�����z>�cpuZcpu_percentage� � i r r7 r r9 r r8 r Z
disk_rd_bytesZ
disk_wr_bytesZ disk_wr_reqZ disk_rd_reqz&Cannot get blockstats for '%s' on '%s')�libvirtZ openReadOnlyZ
listDomainsIDZ
lookupByIDr Z libvirtError�print�sys�stderrr6 ZinterfaceStatsr �info�psutil� cpu_count� Exceptionr> � get_disksZ
blockStats� TypeErrorr )r r �conn�idsr �id�datar- r �errr1 Ziface�statsZcputimeZcputime_percentage�eZmaxmemZmemr= �disksZdiskZrd_reqZrd_bytesZwr_reqZwr_bytesZerrsr r r r ] s|
"
"
zPlugin.fetch_valuesc
C s� |� d�}d }zt�|�}W n g Y S 0 |�� }g }zp|�d�}|D ]<}d }|jD ]} | jdkrX| �d�}qX|d kr|qJ|�|� qJW |d kr�|� � |d kr�|�
� n"|d kr�|� � |d kr�|�
� 0 |S )Nr z/domain/devices/diskr r! r" )
r r- r. r/ r0 rU r2 r3 r4 r5 r r r rL � s6
�
zPlugin.get_disksN) �__name__�
__module__� __qualname__r r r6 r> r rL r r r r r s Dr �__main__)�
__future__r r rF r
rD r$ r ZpluginsrI Z
BasePluginr rV �executer r r r �<module> s 4PK Fu\��|�� � 2 agent360/plugins/__pycache__/mdstat.cpython-39.pycnu �[��� a
��?hl � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZmdstatc C s� t �d��� }i }zt�|�}W n ty4 Y dS 0 |d �� D ]�\}}i }|d durdd|d< nd|d< |d d ur�d|d< nd|d< |d
d ur�d|d
< nd|d
< d|d < |d
�� D ]$\}}|d d ur�|d d |d < q�|||< qB|S )z�
Monitor software raid status using mdadm:
pip install mdstat
Requires sudo access to mdjson add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /usr/local/bin/mdjson
ZmdjsonzCould not load mdstat dataZdevices�activeTr � Z read_onlyFZresyncNZfaulty�disks)�os�popen�read�json�loads� Exception�items) �self�config�data�results�key�valueZdeviceZdiskZ diskvalue� r �A/usr/local/lib/python3.9/site-packages/agent360/plugins/mdstat.py�run s.
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr Z
BasePluginr r �executer r r r �<module> s
(PK Fu\�p
2 0 agent360/plugins/__pycache__/exim.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZeximc C s i }t t�d��� �|d< |S )z�
exim mail queue monitoring, needs sudo access!
Instructions at:
https://docs.360monitoring.com/docs/exim-queue-size-plugin
zsudo exim -bpcZ
queue_size)�int�os�popen�read)�self�config�data� r
�?/usr/local/lib/python3.9/site-packages/agent360/plugins/exim.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__r r
r
r
r r s r �__main__)r ZpluginsZ
BasePluginr r
�executer
r
r
r �<module> s
PK Fu\0s s 0 agent360/plugins/__pycache__/swap.cpython-39.pycnu �[��� a
��?hl � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�swapc G s* i }t �� }|jD ]}t||�||< q|S )N)�psutilZ swap_memory�_fields�getattr)�selfZunusedr Zmem�name� r �?/usr/local/lib/python3.9/site-packages/agent360/plugins/swap.py�run
s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r
r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r
�<module> s PK Fu\(��B& & 0 agent360/plugins/__pycache__/bird.cpython-39.pycnu �[��� a
��?hI � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZbirdc C sv i }t t�d��� �|d< t t�d��� �|d< t t�d��� �|d< t t�d��� �|d< t t�d ��� �|d
< |S ) z;
Monitor status of bgp sessions using bird
z0sudo birdc show proto | /bin/grep -c EstablishedZ establishedz,sudo birdc show proto | /bin/grep -c Connect�connectz+sudo birdc show proto | /bin/grep -c Active�activez?sudo birdc show proto | /bin/grep -c "Connection reset by peer"Z
conn_reset_bpz9sudo birdc show proto | /bin/grep -c "Hold timer expired"Z
hold_timer)�int�os�popen�read)�self�config�data� r �?/usr/local/lib/python3.9/site-packages/agent360/plugins/bird.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r
r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r
�<module> s PK
Fu\�CPo o 3 agent360/plugins/__pycache__/network.cpython-39.pycnu �[��� a
��?h�
� @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�networkc C s t � }t�� |d< | �� }z|�dd��d�}W n d}Y n0 i }tjdd�}|�� D �]�\}}|durv||vrvqZz || W n i ||< Y n0 i ||< t�� || d< |j|| d< |j || d < |j
|| d
< |j || d < |j || d < |j
|| d
< |j|| d< |j|| d< i ||< | �d|j|| �|| d< | �d |j || �|| d < | �d
|j
|| �|| d
< | �d |j || �|| d < | �d |j || �|| d < | �d
|j
|| �|| d
< | �d|j|| �|| d< | �d|j|| �|| d< qZ| �|� |S )z�
Network monitoring plugin.
To only enable certain interfaces add below [network]:
interfaces = eth1,eth3,...
�tsr �
interfaces�,FT)Zpernic�
bytes_sent�
bytes_recv� packets_sent� packets_recv�errin�errout�dropin�dropout)�dict�timeZget_agent_cache�get�split�psutilZnet_io_counters�itemsr r r r
r r r
r Zabsolute_to_per_secondZset_agent_cache) �self�config�absoluteZ
prev_cacheZenabled_interfacesZ
returndatar Z interface�stats� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/network.py�run
sL
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr Z
BasePluginr r �executer r r r �<module> s
4PK Fu\] �
�
9 agent360/plugins/__pycache__/plesk-cgroups.cpython-39.pycnu �[��� a
��?h� � @ sX d dl Z d dlZd dlZd dlZd dlZd dlZG dd� dej�ZedkrTe� � � dS )� Nc @ s e Zd ZdZ dd� ZdS )�Pluginz
plesk-cgroupsc G s\ i }| � � }t�d�}d}d}t�|| �t�|d | � D �] }i ||< ||vr\i ||< t|�|��� � || d< }zt�|�j || d< W n t
y� Y n0 zLt � |d��
� �(} t| �� �� �|| d< W d � n1 s�0 Y W n� t�yv zZt � |dd d
�|�d ��
� �(} t| �� �� �|| d < W d � n1 �sP0 Y W n t�yp Y n0 Y n0 �zt � |d ��
� ��} i || d < }
d || v�r�i || d < } | �� D ]�} | jd
d�\}
}|
|
v�r�i |
|
< t�� |
|
d< |
| v�r i | |
< |�� D ]B}|�d�\}}| �|t|�| |
�|
|
|< t|�| |
|< �q�q�W d � n1 �sr0 Y W �n6 t�y� �z
t � |dd d
�|�d��
� ��} i || d< }
d|| v�r�i || d< } | �� D ]�} z| �� \}
}}W n t�y Y n0 |
|
v�r6i |
|
< t�� |
|
d< |
| v�rHi | |
< | �|t|�| |
�|
|
|< t|�| |
|< �q�W d � n1 �s�0 Y W n t�y� Y n0 Y n0 z�t � |d��
� ��} i || d< }
d|| v�r�i || d< } t�� |
d< | �� D ]4} | �� \}}| �|t|�| �|
|< t|�| |< �qW d � n1 �sZ0 Y W q> t�yJ z�t � |dd d
�|�d��
� ��} i || d< }
d|| v�r�i || d< } t�� |
d< | �� D ]4} | �� \}}| �|t|�| �|
|< t|�| |< �q�W d � n1 �s$0 Y W n t�yD Y n0 Y q>0 q>| �|� |S )Nz\d+z/sys/fs/cgroup/zuser.slice/user-*.slicezsystemd/�uid�usernamezmemory.currentZmemoryz
user.slicez
user-{}.slicezmemory.usage_in_byteszio.stat� )�maxsplit�ts�=Zblkioz blkio.throttle.io_service_byteszcpu.stat�cpuz cpuacct.stat)Zget_agent_cache�re�compile�glob�int�search�group�pwd�getpwuid�pw_name�KeyError�pathlib�Path�open�read�strip�FileNotFoundError�format� readlines�split�timeZabsolute_to_per_second�
ValueErrorZset_agent_cache)�selfZunusedZ
accounting�cacheZuid_reZ sysfs_prefixZ sysfs_suffixZ
user_slicer �f�a�c�lineZdevnumZmetrics�kv�k�v� r( �H/usr/local/lib/python3.9/site-packages/agent360/plugins/plesk-cgroups.py�run s�
��� �,��.
� >������
� 8 4� 4
z
Plugin.runN)�__name__�
__module__� __qualname__r* r( r( r( r) r
s r �__main__)
r r r r
r ZpluginsZ
BasePluginr r+ �executer( r( r( r) �<module> s PK Fu\ 8�c� � 9 agent360/plugins/__pycache__/elasticsearch.cpython-39.pycnu �[��� a
��?h� � @ s� z0d dl mZmZ d dlmZmZ d dlmZ W n> eyn d dlmZ d dl mZ d dl
mZmZmZ Y n0 d dl Z d dl Z d dl
Z
d dlZG dd � d e j�Zed
kr�e� �� dS ) � )�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r r r Nc @ s e Zd ZdZ dd� ZdS )�Plugin�
elasticsearchc
s4 dd� }t � }t � }t�|�dd��}t�|�}t�� |d< | �� }d� fdd � � z"� tj|� � |d
�d d �}W n t
y� Y d
S 0 d} i }
t t g} |�
� D ]v\} }
| �� �� } | D ]$}z ||
�}
W q� ty� Y q�0 q�| | v r�t|
�t ur�| �| t |
�|�|| < t |
�|
| < q�q�t�� |
d< | �|
� |S )z�
experimental monitoring plugin for elasticsearch
Add to /etc/agent360.ini:
[elasticsearch]
enabled = yes
status_page_url = http://127.0.0.1:9200/_stats
c s" dd� � t � fdd�| �� D ��S )Nc S s t | t�r| �d�S | S )N�ascii)�
isinstance�unicode�encode)�x� r �H/usr/local/lib/python3.9/site-packages/agent360/plugins/elasticsearch.py�<lambda> � z7Plugin.run.<locals>.ascii_encode_dict.<locals>.<lambda>c 3 s | ]}t � |�V qd S )N)�map)�.0�pair�� ascii_encoder r � <genexpr> r z8Plugin.run.<locals>.ascii_encode_dict.<locals>.<genexpr>)�dict�items)�datar r r �ascii_encode_dict s z%Plugin.run.<locals>.ascii_encode_dictr Zstatus_page_url�ts� �_c sf g }| � � D ]P\}}|r$|| | n|}t|tj�rN|�� |||d�� � � q |�||f� q t|�S )N)�sep)r r
� collections�MutableMapping�extend�appendr )�dZ
parent_keyr r �k�vZnew_key��flattenr r r( ' s zPlugin.run.<locals>.flatten)� object_hookZ_all�totalF)/Zget_time_in_millis� indexing_index_time_in_millisZflush_total_time_in_millisZ indexing_delete_time_in_millisr+ Z indexing_throttle_time_in_millisZ#merges_total_stopped_time_in_millisZ%merges_total_throttled_time_in_millisZmerges_total_time_in_millisZ recovery_throttle_time_in_millisZ refresh_total_time_in_millisZsearch_fetch_time_in_millisZsearch_query_time_in_millisZ search_scroll_time_in_millisZ search_suggest_time_in_millisZwarmer_total_time_in_millisZ
docs_countZ docs_deletedZ flush_totalZget_exists_totalZget_missing_totalZ get_totalZindexing_delete_totalZindexing_index_totalZindexing_noop_update_totalZ merges_totalZmerges_total_docsZ#merges_total_auto_throttle_in_bytesZquery_cache_cache_countZquery_cache_cache_sizeZquery_cache_evictionsZquery_cache_hit_countZquery_cache_miss_countZquery_cache_total_countZ
refresh_totalZrequest_cache_hit_countZrequest_cache_miss_countZsearch_fetch_totalZsearch_open_contextsZsearch_query_totalZsearch_scroll_totalZsearch_suggest_totalZsegments_countZ%segments_max_unsafe_auto_id_timestampZ warmer_totalZget_exists_time_in_millisZget_missing_time_in_millis)r r )r �urllib2r �getr �timeZget_agent_cache�json�loads�read� Exception�str�floatr �lower�strip�
ValueError�typeZabsolute_to_per_secondZset_agent_cache)�self�configr �resultsZ
next_cache�requestZ raw_responseZ
prev_cache�jZ
delta_keysr � constructors�key�value�cr r' r �run s:
" 2
z
Plugin.runN)�__name__�
__module__� __qualname__rB r r r r r s r �__main__)� urllib.parser r �urllib.requestr r � urllib.errorr � ImportError�urllibr, r. Zpluginsr/ r Z
BasePluginr rC �executer r r r �<module> s mPK Fu\=B��B B 7 agent360/plugins/__pycache__/yum-updates.cpython-39.pycnu �[��� a
��?h* � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Pluginz yum-updatesc C s4 i }t t�d��� �|d< t t�d��� �|d< |S )aT
updates for RHEL-based OS available from yum
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/bin/yum
test by running:
sudo -u agent360 agent360 test yum-updates
Add to /etc/agent360.ini:
[yum-updates]
enabled = yes
interval = 3600
z:yum -q list updates --security | grep -v Available | wc -l�securityz/yum -q list updates | grep -v Available | wc -l�all)�int�os�popen�read)�self�config�data� r �F/usr/local/lib/python3.9/site-packages/agent360/plugins/yum-updates.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r
r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r
�<module> s PK Fu\�7z�� � 5 agent360/plugins/__pycache__/minecraft.cpython-39.pycnu �[��� a
��?hj � @ sH d dl Z d dlZd dlZd dlZG dd� de j�ZedkrDe� �� dS )� Nc @ s8 e Zd ZdZ dd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�Plugin� minecraftc C sh |� dd��d�}i }|D �]F}z�t�tjtj�}|�d�d }t|�d�d �}|�||f� |�| �d| �|� d�� | �
|� d �� |�| �d
�� | � |� | � |� | � |�}d } t | �|k r�| |�
d �7 } q�|�� W n Y n0 i }
z8t�| �d��d
} t| d �|
d< t| d �|
d< W n d|
d< d|
d< Y n0 |
|t|�dd��< q|S )z�
Fetch the amount of active and max players
add to /etc/agent360.ini
[minecraft]
enabled=yes
hosts=127.0.0.1:8000,127.0.0.2:8000...
r �hosts�,�:r � z �utf8�� � i �playersZonline�max�.�-)�get�split�socket�AF_INET� SOCK_STREAM�int�connect�send� pack_data�encode� pack_port�
unpack_varint�len�recv�close�json�loads�decode�str�replace) �self�configZmy_hosts�resultZconnection_string�s�hostname�port�l�d�resultsr � r- �D/usr/local/lib/python3.9/site-packages/agent360/plugins/minecraft.py�run s:
.
z
Plugin.runc C sD d}t d�D ]2}t|�d��}||d@ d| > O }|d@ s q@q |S )Nr � r � � � )�range�ordr )r$ r' r+ �i�br- r- r. r < s zPlugin.unpack_varintc C sD d}|d@ }|dL }|t �d||dkr*dndB �7 }|dkrq@q|S )Nr r1 r2 �Br r3 ��struct�pack)r$ r+ �or7 r- r- r. � pack_varintE s zPlugin.pack_varintc C s | � t|��| S )N)r= r )r$ r+ r- r- r. r O s zPlugin.pack_datac C s t �d|�S )Nz>Hr9 )r$ r6 r- r- r. r R s zPlugin.pack_portN)�__name__�
__module__� __qualname__r/ r r= r r r- r- r- r. r s 3
r �__main__)Zpluginsr r: r Z
BasePluginr r> �executer- r- r- r. �<module> s OPK Fu\y��� � < agent360/plugins/__pycache__/cloudlinux-dbgov.cpython-39.pycnu �[��� a
��?h* � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Pluginzcloudlinux-dbgovc C sr t �d��� }i }zt�|�}W n ty4 Y dS 0 |d durFdS i }|d D ]}|d }|d= |||< qR|S )a0
Beta plugin to monitor cloudlinux db governor users
Requires sudo access to lveinfo (whereis lveinfo) add to /etc/sudoers:
agent360 ALL=(ALL) NOPASSWD: /REPLACE/PATH/TO/lveinfo
To enable add to /etc/agent360.ini:
[cloudlinux-dbgov]
enabled = yes
z9sudo lveinfo --dbgov --period 5m -o cpu --limit 20 --jsonz!Could not load lveinfo dbgov data�success� z Failed to load lveinfo dbgov�data�USER)�os�popen�read�json�loads� Exception)�self�configr �results�line�username� r �K/usr/local/lib/python3.9/site-packages/agent360/plugins/cloudlinux-dbgov.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r Zpluginsr
Z
BasePluginr r �executer r r r �<module> s
!PK Fu\�
��f f 1 agent360/plugins/__pycache__/httpd.cpython-39.pycnu �[��� a
��?h�
� @ s� z0d dl mZmZ d dlmZmZ d dlmZ W n> eyn d dlmZ d dl mZ d dl
mZmZmZ Y n0 d dl Z d dl Z d dl
Z
G dd � d e j�Zed
kr�e� �� dS ) � )�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r r r Nc @ s e Zd ZdZ dd� ZdS )�Plugin�httpdc
C s� i }t � }t�� |d< | �� }z&t|�dd��}t|��� �d�}W n& tyj } zW Y d}~dS d}~0 0 t �
d�}i }dd � } |� d
�D � ]�}
|
r�|� |
�} | r�| �
d �} | �
d �}
| d
ks�| dks�| dks�| dks�| dks�| dks�| dks�| dks�| dks�| dks�| dks�| dk�r q�| dk�rH| �| t|
�|�|d< t|
�|d< | dk�rt| |
�D ]}|d ||d < �qZq�|
|| < q�| �|� |S ) z2
Apache/httpd status page metrics
�tsr Zstatus_page_urlzutf-8NFz^([A-Za-z ]+):\s+(.+)$c S s� g }|� d| �d�f� |� d| �d�f� |� d| �d�f� |� d| �d�f� |� d | �d
�f� |� d | �d �f� |� d
| �d�f� |� d| �d�f� |� d| �d�f� |S )N� IdleWorkers�_ZReadingWorkers�RZWritingWorkers�WZKeepaliveWorkers�KZ
DnsWorkers�DZClosingWorkers�CZLoggingWorkers�LZFinishingWorkers�GZCleanupWorkers�I)�append�count)Zsb�ret� r �@/usr/local/lib/python3.9/site-packages/agent360/plugins/httpd.py�parse_score_board% s z%Plugin.run.<locals>.parse_score_board�
� � r
z Server BuiltZ CurrentTimeZ RestartTimeZ ServerUptimeZCPULoadZCPUUserZ CPUSystemZCPUChildrenUserZCPUChildrenSystemZ ReqPerSeczTotal AccessesZrequests_per_secondZ
Scoreboardr )�dict�timeZget_agent_cacher �getr �read�decode� Exception�re�compile�split�match�groupZabsolute_to_per_second�intZset_agent_cache)�self�configZ
prev_cacheZ
next_cache�request�data�e�exp�resultsr �line�m�k�vZsb_kvr r r �run s^
���������
z
Plugin.runN)�__name__�
__module__� __qualname__r4 r r r r r s r �__main__)� urllib.parser r �urllib.requestr r � urllib.errorr � ImportError�urllib�urllib2r Zpluginsr# Z
BasePluginr r5 �executer r r r �<module> s ?PK Fu\z=�S S 4 agent360/plugins/__pycache__/fail2ban.cpython-39.pycnu �[��� a
��?h? � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�fail2banc C sF i }|� dd��d�}|D ]&}dt�d| d ��� �� i||< q|S )a#
Monitor currently banned IP's, specify the fail2ban jail you want to monitor in /etc/agent360.ini
Example:
[fail2ban]
enabled = yes
jail = sshd
Nota bene: agent360 requires sudo permission to access fail2ban-client
r �jail�,�countz!sudo /bin/fail2ban-client status z7 | egrep -i "Currently banned:.*" | egrep -o "[0-9.]+")�get�split�os�popen�read�rstrip)�self�config�datar Znom� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/fail2ban.py�run s
$z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r �
subprocessZplugins�jsonZ
BasePluginr r �executer r r r �<module> s PK Fu\�+|�Z Z 3 agent360/plugins/__pycache__/dovecot.cpython-39.pycnu �[��� a
��?h � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZdovecotc C s� i }t �d��� }t �d��� }t �d��� }d}d}|�d�D ]d}t�d|�r@t�d|tj�} t�d|tj�}
| d ur�|t| �d
�� }|
d ur@|t|
�d
�� }q@||d < ||d < |� � |� � d
�|d< |S )z�
Returns active dovecot IMAP and POP3 session and the current version.
Sudo permission to acces doveadm and dovecot commands are required.
Exampel config for /etc/agent360.ini:
[dovecot]
enabled = yes
zsudo doveadm whozsudo dovecot --versionzsudo dovecot --hostdomainr �
z.*(imap|pop3).*z +([0-9]+) +imap +z +([0-9]+) +pop3 +N� �imapZpop3)�versionZ
hostdomain�meta)
�os�popen�read�split�re�search�
IGNORECASE�int�group�strip) �self�config�data�outputZoutput2Zoutput3ZimapsumZpop3sum�rowZimaprZpopr� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/dovecot.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r �
subprocessZpluginsr Z
BasePluginr r �executer r r r �<module> s "PK #Fu\^e�& 0 agent360/plugins/__pycache__/ping.cpython-39.pycnu �[��� a
��?h] � @ sn d dl Z d dlmZmZmZ d dlZd dlZdd� Zd
dd�Zdd � Z G d
d � d ej
�Z e d krje � �
� dS )� N)�Popen�PIPE�CalledProcessErrorc C s |� | �}|sdS |�� S d S )NF)�search�groups)Z ping_output�regex�match� r �?/usr/local/lib/python3.9/site-packages/agent360/plugins/ping.py�_get_match_groups s
r Tc C sz d}d}z t | �� td�}|�� d }W n ty: Y n0 |rZ|du rT|�d�}q^|}ng }|rn|�d�}ng }||fS )N� )�stdoutr Tz\n�
)r �splitr � communicate� Exception)�Command�newlinesZOutput�Error�procZStdoutZStderrr r r
�system_command s r c C s� t j�d�st j�d�rnttd| d�d �}z$t�d�}t||�\}}}}|}W n tyh d}Y n0 �n t jdkr�ttd | d�d �}t�d�}t||�}|du r�d}n|\}}}}|}n�t jd
k�r�d}z`t d d d
| gt
t
d�}|� � \} }
| �r,zt t�
d| �d �}W n t�y( Y n0 nd}W n t�yF Y n0 |dk�r�z t�
d| �} | d �� }W n t�y� Y n0 nd}|| d�S )N�linuxZfreebsdzping -W 5 -c 1 Fr z'(\d+.\d+)/(\d+.\d+)/(\d+.\d+)/(\d+.\d+)����darwinz
ping -c 1 �win32�pingz-nz1 )r
�stderrzAverage = (\d+)s: + .+ = [0-9]{1,9}ms, .+ = [0-9]{1,9}ms, .+ = (\d+){1,9}ms)�avgping�host)�sys�platform�
startswith�strr �re�compiler r r r r �int�findallr �decode) �hostname�responseZmatcherZminpingr ZmaxpingZjitter�matchedr �out�errorZ
rxresponser r r
� collect_ping) sJ
r- c @ s e Zd ZdZ dd� ZdS )�Pluginr c C sB i }|� dd��d�}g |d< |D ]}|d �t|�� q"|d S )Nr �hosts�,)�getr �appendr- )�self�config�dataZmy_hostsr r r r
�run_ s z
Plugin.runN)�__name__�
__module__� __qualname__r6 r r r r
r. \ s r. �__main__)T)r# �
subprocessr r r r Zpluginsr r r- Z
BasePluginr. r7 �executer r r r
�<module> s
3 PK %Fu\ź[J� � 3 agent360/plugins/__pycache__/postfix.cpython-39.pycnu �[��� a
��?h� � @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�postfixc C s& i }|� dd�}|� dd�}|� dd�}|� dd�}t�d| d | ��� }|�d�D ]<}t�d |�rXt�d
|�d } t�d |�d }
t|
�|| < qX|d
kr�ddt�d��� � � i|d< |d
k�r"t�d��� } d| v r�d d d�|d< n6t�d| �d �
dd�t�d| �d �
dd�d�|d< |S )ak
Monitoring of the Postfix MTA log and optionally the Postfix version and the mailqueue
Dependency: Pflogsumm log analyzer, sudo access
Exampel config for /etc/agent360.ini:
[postfix]
enabled = yes
log = /var/log/mail.log
pflogsumm = /usr/sbin/pflogsumm
version = true
queue = true
r �logZ pflogsumm�version�queuezsudo z -d today --detail 0 �
z +[0-9]+ +[a-z]{1}[a-z- ]+[a-z]z[a-z]{1}[a-z- ]+[a-z]r z
\b[0-9]*\b�truezPostfix z>sudo postconf -d | grep mail_version -m 1 | egrep -o "[0-9.]+"�metazsudo mailq | tail -n 1�empty)Zmails�sizez[0-9]+ Requestz Request� z -- [0-9]+z-- ) �get�os�popen�read�split�re�search�findall�int�rstrip�replace) �self�config�dataZmaillogZpflbinZpversionZmqueue�output�row�stat�numZ mqcommand� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/postfix.py�run s&
6z
Plugin.runN)�__name__�
__module__� __qualname__r! r r r r r s r �__main__)r �
subprocessZpluginsr Z
BasePluginr r" �executer r r r �<module> s +PK (Fu\(�؟X X 3 agent360/plugins/__pycache__/proftpd.cpython-39.pycnu �[��� a
��?hj � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZproftpdc
C s� i }t �d��� }d}d}d}t�|�}|d D ]l}|d rD|d7 }z|d dkrZ|d7 }W n tyn Y n0 z|d dkr�|d7 }W q0 ty� Y q00 q0||d< ||d< ||d < |d
d |d < d t|d
d � |d< |d
d
} d| i|d< |S )z2
Current acitive ProFTPD sessions
z/bin/ftpwho -o jsonr � connections�pid� � uploadingTZidling�idle�serverZ server_typezPID Z
started_ms�msZuptime)�os�popen�read�json�loads� Exception�str)
�self�config�data�resultZcntr r �rawdata�itemZupdt� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/proftpd.py�run
s0
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r
Zpluginsr
Z
BasePluginr r �executer r r r �<module> s
PK +Fu\� -�� � 4 agent360/plugins/__pycache__/bitninja.cpython-39.pycnu �[��� a
��?h � @ sD d dl Z d dlZd dlZdZG dd� de j�Zedkr@e� �� dS )� Nz&/usr/sbin/bitninjacli --stats --minifyc @ s e Zd ZdZ dd� ZdS )�PluginZbitninjac C sp z|� td�}W n t}Y n0 t�d| �}|�� }|d }|�d�}|dkrlt�||d� � dd��S dS )aj
Collects metrics from the BitNinja Linux Agent.
For this plugin to work, at least BitNinja version 2.38.8 is required, and
the following configurations must be applied to it:
/etc/bitninja/System/config.ini:
```ini
[statistics]
enableIntegration = 1
```
This will allow agent360 to access the statistics.
Then after a BitNinja restart, the plugin can be tested by running:
sudo -u agent360 agent360 test bitninja
Add to /etc/agent360.ini:
```ini
[bitninja]
enabled = true
```
Z statCommandzsudo r �{N�
� )
�get�__name__�DEFAULT_STAT_COMMAND�os�popen� readlines�find�json�loads�replace)�self�config�command�stream�resultZ firstLineZ
startIndex� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/bitninja.py�run s
z
Plugin.runN)r �
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr r
r Z
BasePluginr r �executer r r r �<module> s )PK -Fu\Efo� � 3 agent360/plugins/__pycache__/mongodb.cpython-39.pycnu �[��� a
��?h� � @ sD d dl Z d dlZd dlmZ G dd� dej�Zedkr@e� �� dS )� N)� MongoClientc @ s e Zd ZdZ dd� ZdS )�Plugin�mongodbc
C s� t |�dd��}|j}|�d�}| �� }i }i }z4|d d du rFdnd|d < t|d d
�|d < W n Y n0 z�|d d
|d< |d d |d< |d d |d< |d d |d< |d d |d< |d d |d< |d d |d< |d d |d < |d d |d < W n Y n0 |d d |d!< |d d" |d#< |d d$ |d%< |d& d' |d(< |d& d) |d*< |d& d+ |d,< |d& d- |d.< |d& d/ |d0< |d& d1 |d2< |d3 d4 d5 |d6< |d3 d4 d7 |d8< |d3 d9 d5 |d:< |d3 d9 d7 |d;< |d3 d< d5 |d=< |d3 d< d7 |d>< |d? d@ dA |dB< |d? d@ dC |dD< |d? d@ dE |dF< |d? dG dA |dH< |d? dG dC |dI< |d? dG dE |dJ< |dK dL |dM< |dK dN |dO< |dK dP |dQ< |dK dR |dS< |dK dT |dU< zZ|dV �� D ]H\}} | �� D ]4\}
} | �� D ] \} }
|
|dW�|�� |
| �< �q�q�q�W n Y n0 zd|dX d' |dY< |dX d) |dZ< |dX d+ |d[< |dX d- |d\< |dX d/ |d]< |dX d1 |d^< W n t �y� Y n0 |�� D ] \}} | �
|| |�||< �q�z@|d6 |d8 |d_< |d= |d> |d`< |d: |d; |da< W n Y n0 |}t � � |db< | � |� |dc dd |de< |dc df |dg< |dc dh |di< |dc dj du �r�dnd|dk< |S )lz$
Mongodb monitoring
r Zconnection_stringZ serverStatus�replZismasterFr � Z isprimary�hosts�membersZ transactionsZretriedCommandsCountz!transactions-retriedCommandsCountZretriedStatementsCountz#transactions-retriedStatementsCountZ transactionsCollectionWriteCountz-transactions-transactionsCollectionWriteCountZ totalAbortedztransactions-totalAbortedZtotalCommittedztransactions-totalCommittedZ totalStartedztransactions-totalStartedZ
currentActiveztransactions-currentActiveZcurrentInactivez transactions-currentInactiveZ currentOpenztransactions-currentOpen� connectionsZ totalCreatedzconnections.totalCreated� availablezconnections.available�currentzconnections.currentZ
opcounters�commandzopcounters.command�deletezopcounters.deleteZgetmorezopcounters.getmore�insertzopcounters.insert�queryzopcounters.query�updatezopcounters.updateZ opLatencies�commandsZlatencyz opLatencies.commands.latency�opszopLatencies.commands.opsZreadszopLatencies.reads.latencyzopLatencies.reads.opsZwriteszopLatencies.writes.latencyzopLatencies.writes.opsZ
globalLockZ currentQueue�totalz globalLock.currentQueue.totalZreadersz globalLock.currentQueue.readersZwritersz globalLock.currentQueue.writersZ
activeClientsz globalLock.activeClients.totalz globalLock.activeClients.readersz globalLock.activeClients.writersZasserts�msgz asserts.msgZregularzasserts.regularZ rolloverszasserts.rollovers�userz asserts.user�warningzasserts.warning�lockszlocks-{}-{}-{}ZopcountersReplzopcountersRepl.commandzopcountersRepl.deletezopcountersRepl.getmorezopcountersRepl.insertzopcountersRepl.queryzopcountersRepl.updatezopLatencies.commandszopLatencies.writeszopLatencies.reads�tsZmemZresidentz mem.resident�bitszmem.bitsZvirtualz mem.virtual� supportedz
mem.supported)
r �getZadminr Zget_agent_cache�len�items�format�lower�KeyErrorZabsolute_to_per_second�timeZset_agent_cache)�self�config�client�db�
statisticsZ
prev_cache�data�results�key�val�key2Zval2Zkey3Zval3Z
next_cache� r, �B/usr/local/lib/python3.9/site-packages/agent360/plugins/mongodb.py�run
s�
&
z
Plugin.runN)�__name__�
__module__� __qualname__r. r, r, r, r- r s r �__main__)r! ZpluginsZpymongor Z
BasePluginr r/ �executer, r, r, r- �<module> s
kPK 0Fu\ZJPnc c 3 agent360/plugins/__pycache__/loadavg.cpython-39.pycnu �[��� a
��?hL � @ s@ d dl Z d dlZd dlZG dd� dej�Zedkr<e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZloadavgc G s t jdkrd S t�� S d S )N�win32)�sys�platform�os�
getloadavg)�selfZunused� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/loadavg.py�run
s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r
r s r �__main__)r Zpluginsr Z
BasePluginr r �executer r r r
�<module> s
PK 2Fu\8�+�� � 5 agent360/plugins/__pycache__/litespeed.cpython-39.pycnu �[��� a
��?h* � @ sP d dl Z d dlZd dlZd dlZd dlZG dd� de j�ZedkrLe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin� litespeedc
C s~ i }i }d}| � � }t�d|�dd�|�dd�|�dd�|�dd�f ��� }|�� D ]�}t�d|�}|d urV|�d �rVd
}z||�d � W n t y� i ||�d �< Y n0 |�
d d ��
|�d
�d �� d�} | D ]v}|� d�� � � d�}
z*||�d � |
d
t
|
d �7 < W q� t �yH t
|
d �||�d � |
d
< Y q�0 q�qVd} |d
u �rd|�� D ]�\} }
z|d || d< W n t �y� i || < Y n0 i || < |
�� D ]�\}}|dk�r�| �|||| �|| d< |dk�r�| �|||| �|| d< |dk�r"| �|||| �|| d< |dk�rF| �|||| �|| d< || v �r�||| |< �q��qdt�� |d< | �|� |S )NFz9curl -s -i -k -u %s:%s 'https://%s:%s/status?rpt=summary'r �username�password�host�portzREQ_RATE \[(.*)\]� T�
� r z, �:) Z
SSL_BPS_INZBPS_OUTZ MAXSSL_CONNZ PLAINCONNZBPS_INZSSLCONNZAVAILSSLZIDLECONNZ SSL_BPS_OUTZ AVAILCONNZMAXCONNZREQ_PROCESSING�tsZTOT_REQSZRPSZTOTAL_STATIC_HITSZ
STATIC_RPSZTOTAL_PUB_CACHE_HITSZ
PUB_CACHE_RPSZTOTAL_PRIVATE_CACHE_HITSZPRIVATE_CACHE_RPS)Zget_agent_cache�os�popen�get�read�
splitlines�re�search�group�KeyError�replace�split�strip�float�itemsZabsolute_to_per_second�timeZset_agent_cache)�self�config�result�results�dataZ
prev_cache�response�line�test�lines�keyvalZmetricsZvhost�
statistics�key�value� r) �D/usr/local/lib/python3.9/site-packages/agent360/plugins/litespeed.py�run sT : *(
z
Plugin.runN)�__name__�
__module__� __qualname__r+ r) r) r) r* r s
r �__main__) Zpluginsr
r r �base64Z
BasePluginr r, �executer) r) r) r* �<module> s LPK 5Fu\F�u[� � 5 agent360/plugins/__pycache__/memcached.cpython-39.pycnu �[��� a
��?h] � @ sH d dl Z d dlZd dlZd dlZG dd� de j�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin� memcachedc
C sJ | � � }z|�dd�}W n d}Y n0 zJ|du r^tjd|�dd�|�dd�f gdd�}ntjd | gdd�}W n Y d
S 0 d }d }i }i }z�|�� } t| d d
�D ]n\}
} | d d
| } | �� �� }
|
|v r�t| �||
< q�|
|v r�t| �} | � |
t| �|�||
< t| �||
< q�q�W n Y dS 0 t
�
� |d< | � |� |S )z�
pip install python-memcached
add to /etc/agent360.ini
[memcached]
enabled=yes
host=127.0.0.1
port=11211
r �socketFz%s:%s�host�portr )�debugzunix:/%sz Could not connect to memcached)Zaccepting_conns�bytesZuptimeZ total_itemsZtotal_connectionsZtime_in_listen_disabled_us�threadsZ rusage_userZ
rusage_systemZ reserved_fdsZ pointer_sizeZ malloc_failsZlrutail_reflockedZlisten_disabled_numZlimit_maxbytesZhash_power_levelZ
hash_bytesZ
curr_itemsZcurr_connectionsZconnection_structuresZ conn_yieldsZ reclaimed) Z auth_cmdsZ auth_errors�
bytes_readZ
bytes_writtenZ touch_missesZ
touch_hitsZ incr_misses� incr_hitsZ
cas_missesZ
cas_badvalr Z
get_missesZget_hitsZexpired_unfetchedZ evictionsZevicted_unfetchedZ
delete_missesZ delete_hitsZ decr_missesZ decr_hitsZcrawler_reclaimedZcrawler_items_checkedZ cmd_touchZcmd_getZcmd_setZ cmd_flushZ
cmd_missesZ
cmd_badvalZcmd_hits� z Could not fetch memcached stats�ts) Zget_agent_cache�get�memcacheZClientZ get_stats� enumerate�lower�strip�floatZabsolute_to_per_second�timeZset_agent_cache)
�self�configZ
prev_cacher ZmcZ non_deltaZ
delta_keys�results�data�result�key� key_value�value� r �D/usr/local/lib/python3.9/site-packages/agent360/plugins/memcached.py�run s@
*
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)Zplugins�structr r Z
BasePluginr r �executer r r r �<module> s iPK 7Fu\q *�$
$
3 agent360/plugins/__pycache__/plugins.cpython-39.pycnu �[��� a
��?h� � @ sF d dl Z d dlZd dlZejdkr,d dlZnd dlZG dd� d�ZdS )� N�� c @ sJ e Zd ZdZdZ g fdd�Zddd�Zdd � Zd
d � Zd d
� Zdd� Z dS )�
BasePluginz$
Abstract class for plugins
� c C s t |t�r|| _ntd��d S )Nz#Type of agent_cache have to be list)�
isinstance�list� agent_cache� TypeError)�selfr � r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/plugins.py�__init__ s
zBasePlugin.__init__Nc C s dS )z7
Virtual method for running the plugin
Nr �r
�configr r r �run s zBasePlugin.runc C s\ d}t tj�dkrBtjdkr(t�t�}n
t�t�}|�tjd � t �
| � |�tj j
� dS )zL
Execution wrapper for the plugin
argv[1]: ini_file
N� r )�len�sys�argv� version_info� configparser�RawConfigParser�defaults� ConfigParser�read�pickle�dumpr �stdout�bufferr r r r �execute! s
zBasePlugin.executec C s( z | j d W S ty" i Y S 0 dS )zE
Return agent cached value for this specific plugin.
r N)r � Exception)r
r r r �get_agent_cache/ s zBasePlugin.get_agent_cachec C s2 z|| j d< W n ty, | j �|� Y n0 dS )a�
Set agent cache value previously passed to this plugin instance.
To enable caching existing agent_cache list have to be passed
to Plugin on initialization.
Minimally it should be list().
Agent will be able to see only changes in zero element of agent_cache, so
do not manually override self.agent_cache, othervice cache will not be saved!
If self.agent_cache is not a list appropriate exception will be raised.
r N)r �
IndexError�append)r
�cacher r r �set_agent_cache8 s zBasePlugin.set_agent_cachec C s^ zB||| kr,||| t � � |d }n|t � � |d }W n tyX d}Y n0 |S )N�tsr )�timer )r
�key�valZ
prev_cache�valuer r r �absolute_to_per_secondH s
���
z!BasePlugin.absolute_to_per_second)N)
�__name__�
__module__� __qualname__�__doc__r
r r r! r% r+ r r r r r s
r )r r' r r r r r r r r r �<module> s
PK :Fu\���� � ; agent360/plugins/__pycache__/diskstatus-nvme.cpython-39.pycnu �[��� a
��?hR � @ sP d dl Z d dlZd dlZd dlZd dlZG dd� dej�ZedkrLe� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Pluginzdiskstatus-nvmec C s i }z>t jdt jt jdd��� d }t�|�d��}|d d}W n tyZ d}Y dS 0 |du � r�|d D ]�}i }t� d �
|d
��� � }zt�|�}W n ty� Y n0 |� � D ].\} }
| �
d �r�t|
d d�|| < q�|
|| < q�|||d
�d
d�< qn|S )z�
Monitor nvme disk status
For NVME drives install nvme-cli (https://github.com/linux-nvme/nvme-cli#distro-support)
This plugin requires the agent to be run under the root user.
z nvme --list --output-format=jsonT)�stdout�stderr�shellr zutf-8ZDevicesFz'Could not fetch nvme status informationz&nvme smart-log {} --output-format=jsonZ
DevicePathZ temperaturegfffffq@z/dev/� )�
subprocess�Popen�PIPE� communicate�json�loads�decode� Exception�os�popen�format�read�items�
startswith�round�replace) �self�config�results�dataZnvme�valueZdeviceZ disk_dataZ data_diskZdisk_keyZ
disk_value� r �J/usr/local/lib/python3.9/site-packages/agent360/plugins/diskstatus-nvme.py�run s.
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__) r r Zpluginsr �reZ
BasePluginr r �executer r r r �<module> s %PK <Fu\�C�� 3 agent360/plugins/__pycache__/unbound.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� de j�Zedkr4e� �� dS )� Nc @ sH e Zd ZdZ g d�Zg d�Zg d�Zg d�Zdd� Zdd � Zd
d � Z d S )
�Plugin�unbound)z.avgz.medianz.nowz.upz.elapsed)%znum.answer.bogus�num.answer.rcodeznum.answer.securez
num.cachehitsz
num.cachemissznum.dnscrypt.certznum.dnscrypt.cleartextznum.dnscrypt.cryptedznum.dnscrypt.malformedz num.prefetchz num.queriesznum.queries_ip_ratelimited�num.query.aggressiveznum.query.authzone.downznum.query.authzone.up�num.query.classznum.query.dnscrypt.replayz*num.query.dnscrypt.shared_secret.cachemiss�num.query.edns�num.query.flagsznum.query.ipv6�num.query.opcodeznum.query.ratelimitedznum.query.subnetznum.query.subnet_cachez
num.query.tcpznum.query.tcpoutz
num.query.tlsznum.query.tls.resume�num.query.typeznum.recursiverepliesznum.rrset.bogusz num.zero_ttlzrequestlist.exceededzrequestlist.overwrittenzunwanted.querieszunwanted.replies)zdnscrypt_nonce.cache.countz"dnscrypt_shared_secret.cache.countzinfra.cache.countzkey.cache.countzmem.cache.dnscrypt_noncez mem.cache.dnscrypt_shared_secretzmem.cache.messagezmem.cache.rrsetzmem.mod.iteratorzmem.mod.validatorzmem.streamwaitzmsg.cache.countzrecursion.time.avgzrecursion.time.medianzrequestlist.avgzrequestlist.current.allzrequestlist.current.userzrequestlist.maxzrrset.cache.countZtcpusagez time.elapsedztime.nowztime.up)r r r r r r r
c
C sX d}zt j|t jdd�}W n8 t jyR } z d�|||j�}W Y d }~d S d }~0 0 |S )Nz$sudo /usr/sbin/unbound-control statsT)�stderr�shellzERROR CALLING {0}: {1} {2})�
subprocess� check_output�STDOUT�CalledProcessError�format�output)�self�cmdr �e� error_msg� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/unbound.py� get_statsZ s zPlugin.get_statsc C sR dd� |� � D �}|�� D ]2\}}|�t| j��r@t|�||< qt|�||< q|S )Nc S s$ i | ] }|� d �}|d |d �qS )�=r � )� partition)�.0�line�tr r r �
<dictcomp>g � z%Plugin.parse_stat.<locals>.<dictcomp>)�
splitlines�items�endswith�tuple� floatKeys�float�int)r �stat�stats�key�valuer r r �
parse_state s zPlugin.parse_statc G s& | � � }i }|d u rdS | �|�}|S )NF)r r- )r ZunusedZresdata�finalr r r �runo s
z
Plugin.runN)
�__name__�
__module__� __qualname__r& Z rate_metricsZ
gauge_metricsZ
by_tag_labelsr r- r/ r r r r r s (
r �__main__)Zpluginsr
Z
BasePluginr r0 �executer r r r �<module> s sPK DFu\"��
�
3 agent360/plugins/__pycache__/process.cpython-39.pycnu �[��� a
��?h
� @ sH d dl Z d dlZd dlZd dlZG dd� dej�ZedkrDe� �� dS )� Nc @ s e Zd ZdZ dd� Zdd� ZdS )�Plugin�processc C sx t �d|�}|r*|�d�}|�d�p&d}nd}|}t jdd|t jd�}t jdd |t jd�}t jd
d |t jd�}t jd d
|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd
|t jd�}t jdd
|t jd�}|| �� }t|�dk�rt|d d� d }|S ) Nz^(\S+)(\s+.*)?$� � � z (/[^ ]+)+z/***)�flagszp(--(?:password|pass|pwd|token|secret|key|api-key|access-key|secret-key|client-secret|auth-key|auth-token)\s+\S+)z--***z
(-p\s+\S+)z-p ***za\b(?:password|pass|pwd|token|secret|key|api_key|access_key|client_secret|auth_key|auth_token)=\S+z***z!\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\bz$\b(?:[a-fA-F0-9:]+:+)+[a-fA-F0-9]+\bz(--port\s+\d+)z
--port ***z�\b(?:DB_PASS|DB_USER|AWS_SECRET_ACCESS_KEY|AWS_ACCESS_KEY_ID|SECRET_KEY|TOKEN|PASSWORD|USERNAME|API_KEY|PRIVATE_KEY|SSH_KEY|SSL_CERTIFICATE|SSL_KEY)\b=\S+z#\b(root|admin|cpanelsolr|user\d*)\bz6(\S+\.(pem|crt|key|cert|csr|pfx|p12|ovpn|enc|asc|gpg))zi\b(?:id_rsa|id_dsa|id_ecdsa|id_ed25519|known_hosts|authorized_keys|credentials|.env|docker-compose.yml)\bzK\b(?:jdbc|mysql|postgres|mongodb|redis|amqp|http|https|ftp|sftp|s3):\/\/\S+z:\b(?:https?|ftp):\/\/(?:\S+\:\S+@)?(?:[a-zA-Z0-9.-]+\.\S+)z2\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b� � z...)�re�match�group�sub�
IGNORECASE�strip�len)�self�cmdliner Z initial_pathZremaining_cmdlineZsanitized_cmdline� r �B/usr/local/lib/python3.9/site-packages/agent360/plugins/process.py�sanitize_command_line s0
z Plugin.sanitize_command_linec G s g }t �� D �] }z�|jg d�d�}z | �d�|d ��� �|d< W n Y n0 tjdk r�t|d t� � dd��� |d< t|d t� � dd�|d< t|d t� � dd�|d < z t|d
t� � dd�|d
< W n Y n0 W n2 t j
y� Y q t j �y Y q Y q 0 |� |� q |S ) N) �pid�nameZppid�exer �usernameZ cpu_percentZmemory_percentZ io_counters)�attrs� r )� �replace)�errorsr r r )
�psutilZ process_iterZas_dictr �joinr �sys� version_info�unicode�getdefaultencodingZ
NoSuchProcessZ AccessDenied�append)r Zunusedr �procZpinfor r r �run, s0
z
Plugin.runN)�__name__�
__module__� __qualname__r r' r r r r r s !r �__main__)r Zpluginsr! r
Z
BasePluginr r( �executer r r r �<module> s DPK FFu\�e3 3 2 agent360/plugins/__pycache__/system.cpython-39.pycnu �[��� a
��?h� � @ s� z d dl Z W n ey" dZ Y n0 d dlZd dlZd dlmZmZ d dlZd dlZd dl Z d dl
Z
z d dl Z W n ey� dZ Y n0 d
dd�Z dd� Z
dd � ZG d
d � d e
j�Zed kr�e� �� dS )� N)�Popen�PIPETc C sz d}d}z t | �� td�}|�� d }W n ty: Y n0 |rZ|du rT|�d�}q^|}ng }|rn|�d�}ng }||fS )N� )�stdoutr T�
)r �splitr � communicate� Exception)�Command�newlinesZOutput�Error�procZStdoutZStderr� r �A/usr/local/lib/python3.9/site-packages/agent360/plugins/system.py�
systemCommand s r c
C s d} z�t dd��"}t|�� �� d�} W d � n1 s80 Y d}t�d���}|D ]j}|j�d�shqVt |jd d��8}d|�� �� kr�W d � qVn|| 7 }W d � qV1 s�0 Y qVW d � n1 s�0 Y |W S t � y� Y dS 0 d S ) Nr z+/sys/devices/system/memory/block_size_bytes�r� z/sys/devices/system/memory/�memoryz/stateZonline)
�open�int�readline�strip�os�scandir�name�
startswith�pathr )�
block_size�fr �it�entryr r r �linux_hardware_memory+ s 0 Fr! c C s� i } i | d< i | d< t d u r | S t �� D ]�}t �|�}t j|v rp|| d vrXg | d |< | d | �|t j � t j|v r(|| d vr�g | d |< | d | �|t j � q(| S )NZv4Zv6)� netifacesZ
interfacesZ ifaddresses�AF_INET�append�AF_INET6)Zip_listZ interface�linkr r r � ip_addressesA s
r' c @ s e Zd ZdZ dd� ZdS )�Plugin�systemc G s� i }i }d|d< d|d< t j�d�r�td�}|r�|D ]�}|�� r4d|�d��d�d �� krx|�d��d�d �� |d< d
|�d��d�d �� kr�|�d��d�d �� |d< d |�d��d�d �� kr4|�d��d�d �� |d< q4|d dk�r�t �d ��� �d�}|�r�|D ]�}|�� �rd
|�d��d�d �� k�r^|�d��d�d �� |d< d
|�d��d�d �� k�r�|�d��d�d �� |d< d|�d��d�d �� k�r|�d��d�d �� |d< �qt �
� j }t j
dk�s�t j
dk�rJt� }|dk�r |}td u �r.td�t
�� ��|d< ntd�tjdd���|d< n�t j
dk�r�dt
�� d |d< ttdd�d ��d�d |d< n�t j
dk�s�t j
dk�r�d t
�� |d< ttd d�d ��d�d |d< td �|d< nVt j
d k�r8t �� jd k�rd!�t
�� d d"�|d< n d!�t
�� d t
�� d# �|d< |d |d$< |d |d%< ||d&< d'�ttt j��|d(< t j |d)< t
�
� |d*< t t � � t � � �|d+< t � |d,< t
�!� |d-< |S ).Nz Unknown CPUZbrandr �countz
/proc/cpuinfoz
model namer �:� Z Processor� processorZlscpuz
Model namezCPU(s)�linuxZlinux2� r T)�full_distribution_name�darwinz Mac OS %sz sysctl machdep.cpu.brand_stringFz: Z freebsd10Z freebsd11z
FreeBSD %szsysctl hw.modelzsysctl hw.ncpu�win32i�U z{} {}� � �cpuZcoresr �.�psutil�python_version�platformZuptimer' �hostname)"r r �isfiler r �rstripr �popen�readr7 Zvirtual_memory�total�sysr9 r! �distro�str�join�linux_distribution�mac_verr �release�getwindowsversion�build�format�uname�map� version_info�versionr �timeZ boot_timer' �node)�selfZunusedZ
systeminfor5 r �lineZmemZhw_memr r r �runW sn
"
z
Plugin.runN)�__name__�
__module__� __qualname__rR r r r r r( T s r( �__main__)T)r" � ImportErrorr r9 �
subprocessr r r@ rN r7 ZpluginsrA r r! r' Z
BasePluginr( rS �executer r r r �<module> s(
GPK IFu\� �^ ^ 4 agent360/plugins/__pycache__/rabbitmq.cpython-39.pycnu �[��� a
��?h�
� @ s� z0d dl mZmZ d dlmZmZ d dlmZ W n> eyn d dlmZ d dl mZ d dl
mZmZmZ Y n0 d dl Z d dl Z d dl
Z
d dlZd dlmZ d dlZG d d
� d
e j�Zed kr�e� �� dS ) � )�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r r r N)�
HTTPBasicAuthc @ s e Zd ZdZ dd� ZdS )�Plugin�rabbitmqc
C s� dd� }t � }t � }z$|�dd�}|�dd�}||f}W n d}Y n0 tj|�dd�|d�}|jd kr�tj|�dd�t||�d�}|jd
u r�z |�� } W q� ty� }
z|
W Y d }
~
S d }
~
0 0 n d �|j�S t � � |d
< | �
� } z | d W n i | d< Y n0 | |d< t � � |d d
< | � d| d d | d �|d< | d d |d< | � d| d d | d �|d< | d d |d< | � d| d d | d �|d< | d d |d< | � d| d d | d �|d< | d d |d< | � d| d d | d �|d< | d d |d< | d d |d< | d d |d < | d d |d < t | d �|d < | d d |d < | d d! |d!< | d d" |d"< | d d# |d#< | d d$ |d$< | �
|� |S )%z.
rabbitmq status page metrics
c s" dd� � t � fdd�| �� D ��S )Nc S s t | t�r| �d�S | S )N�ascii)�
isinstance�unicode�encode)�x� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/rabbitmq.py�<lambda> � z7Plugin.run.<locals>.ascii_encode_dict.<locals>.<lambda>c 3 s | ]}t � |�V qd S )N)�map)�.0�pair�� ascii_encoder r � <genexpr> r z8Plugin.run.<locals>.ascii_encode_dict.<locals>.<genexpr>)�dict�items)�datar r r �ascii_encode_dict s z%Plugin.run.<locals>.ascii_encode_dictr �username�passwordFZstatus_page_url)�authi� �� Nz Could not load status page: {}�tsZ
message_statsZ published�publishZpublished_totalZackZ ack_totalZ deliver_getZdeliver_get_totalZ redeliverZredeliver_totalZdeliverZ
deliver_totalZ queue_totals�messagesZmessages_readyZmessages_unacknowledgedZ listenersZ
object_totalsZ consumers�queuesZ exchanges� connectionsZchannels)r �get�requests� status_coder �json� Exception�format�text�timeZget_agent_cacheZabsolute_to_per_second�lenZset_agent_cache) �self�configr �resultsZ
next_cacher r � user_pass�request�j�eZ
prev_cacher r r �run s^
z
Plugin.runN)�__name__�
__module__� __qualname__r6 r r r r r s r �__main__)� urllib.parser r �urllib.requestr r � urllib.errorr � ImportError�urllib�urllib2r- Zpluginsr) r' Z
requests.authr �sysZ
BasePluginr r7 �executer r r r �<module> s FPK KFu\+��ױ � 4 agent360/plugins/__pycache__/loggedin.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZloggedinc C s i }t t�d��� �|d< |S )zB
Returns the number of users currently logged in.
z/bin/users | wc -w�sessions)�int�os�popen�read)�self�config�data� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/loggedin.py�run s z
Plugin.runN)�__name__�
__module__� __qualname__r
r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s PK NFu\�4�� � 6 agent360/plugins/__pycache__/redis_stat.cpython-39.pycnu �[��� a
��?h� � @ sZ d dl Z d dlZdddddddd d
d d d
ddd�ZG dd� de j�ZedkrVe� �� dS )� NZuptimezconnected clientsz used memoryzused memory peak human� maxmemoryzmaxmemory policyztotal commands processedztotal net input bytesztotal net output bytesz expired keysz evicted keysz
keyspace hitszkeyspace misseszcluster enabled)Zuptime_in_secondsZconnected_clientsZ used_memoryZused_memory_peak_humanr Zmaxmemory_policyZtotal_commands_processedZtotal_net_input_bytesZtotal_net_output_bytesZ expired_keysZ evicted_keysZ
keyspace_hitsZkeyspace_missesZcluster_enabledc @ s e Zd ZdZ dd� ZdS )�PluginZ
redis_statc
C s* i }d }z|� td�}W n d}Y n0 z|� td�}W n d}Y n0 z|� td�}W n d}Y n0 z|� td�}W n d}Y n0 z tj||||d �}|�� }W nH ty� } z0d
|d < d |d
< |s�|W Y d } ~ S W Y d } ~ n
d } ~ 0 0 |�� D ]$\}
} |
t�� v �r | |t|
< �q |S )N�hostz 127.0.0.1�portZ6379�db�0�password� )r r r r r �statuszConnection Error�msg) �get�__name__�redisZ StrictRedis�info� Exception�items�METRICS�keys) �self�config�data�statsZ
redis_hostZ
redis_portZredis_dbZredis_passwordZredis_connection�e�name�value� r �E/usr/local/lib/python3.9/site-packages/agent360/plugins/redis_stat.py�runu s<
&z
Plugin.runN)r
�
__module__� __qualname__r r r r r r r s r �__main__)Zpluginsr r Z
BasePluginr r
�executer r r r �<module> s& �k%PK PFu\�7�� � 4 agent360/plugins/__pycache__/cpu_freq.cpython-39.pycnu �[��� a
��?hG � @ s8 d dl Z d dlZG dd� dej�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�Plugin�cpu_freqc G s\ i }t jdd�}d}|D ]>}i }|d }i ||< |jD ]}t||�||< q6|d ||< q|S )NT)Zpercpu���� �current)�psutilr �_fields�getattr)�selfZunused�results�data�
cpu_number�cpu�core�key� r �C/usr/local/lib/python3.9/site-packages/agent360/plugins/cpu_freq.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)r ZpluginsZ
BasePluginr r �executer r r r �<module> s PK SFu\}5�- - / agent360/plugins/__pycache__/gpu.cpython-39.pycnu �[��� a
��?h� � @ s8 d dl Z d dlZG dd� de j�Zedkr4e� �� dS )� Nc @ s e Zd ZdZ dd� ZdS )�PluginZgpuc G s� i }t jdkr�z ddl}W n Y dS 0 zP|jdd�}|�� }|D ]2}|jdkrD|jdkrD|j||j� d d
��
d
�< qDW n Y d S 0 |S ) za
expirimental plugin used to collect GPU load from OpenHardWareMonitor (Windows)
�win32r Nzwmi module not installed.zroot\OpenHardwareMonitor)� namespace�LoadzGPU Core�/�-z7Could not fetch GPU Load data from OpenHardwareMonitor.) �sys�platform�wmiZWMIZSensorZ
SensorType�Name�ValueZParent�replace�strip)�selfZunused�datar
�wZtemperature_infosZsensor� r �>/usr/local/lib/python3.9/site-packages/agent360/plugins/gpu.py�run s
z
Plugin.runN)�__name__�
__module__� __qualname__r r r r r r s r �__main__)Zpluginsr Z
BasePluginr r �executer r r r �<module> s PK XFu\��G!, , agent360/plugins/diskusage.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import psutil
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'diskusage'
def run(self, config):
disk = {}
disk['df-psutil'] = []
for part in psutil.disk_partitions(False):
valid_part = True
ignored_partitions = ['/loop', '/snap', 'squashfs', 'cagefs-skeleton']
for ignore in ignored_partitions:
if ignore in part.device or ignore in part.mountpoint or ignore in part.fstype:
valid_part = False
if valid_part == False:
continue
if os.name == 'nt':
if 'cdrom' in part.opts or part.fstype == '':
# skip cd-rom drives with no disk in it; they may raise
# ENOENT, pop-up a Windows GUI error for a non-ready
# partition or just hang.
continue
try:
usage = psutil.disk_usage(part.mountpoint)
diskdata = {}
diskdata['info'] = part
for key in usage._fields:
diskdata[key] = getattr(usage, key)
disk['df-psutil'].append(diskdata)
except:
pass
try:
force_df = config.get('diskusage', 'force_df')
except:
force_df = 'no'
if len(disk['df-psutil']) == 0 or force_df == 'yes':
try:
disk['df-psutil'] = []
df_output_lines = [s.split() for s in os.popen("df -Pl").read().splitlines()]
del df_output_lines[0]
for row in df_output_lines:
if row[0] == 'tmpfs':
continue
disk['df-psutil'].append({'info': [row[0], row[5],'',''], 'total': int(row[1])*1024, 'used': int(row[2])*1024, 'free': int(row[3])*1024, 'percent': row[4][:-1]})
except:
pass
try:
zfs_stats = config.get('diskusage', 'zfs')
except:
zfs_stats = 'no'
if zfs_stats == 'yes':
try:
lines = [s.split(', ') for s in os.popen("zfs list -Hp -t volume").read().splitlines()]
for row in lines:
v = {}
v['vg_name'] = row[0]
v['vg_size'] = int(row[5][:-1])
v['vg_free'] = int(row[6][:-1])
v['vg_used'] = int(v['vg_size']-v['vg_free'])
v['vg_percentage'] = (v['vg_used']/float(v['vg_size']))*100
disk['df-psutil'].append({'info': [v['vg_name'], v['vg_name'], 'zfs', False], 'total': v['vg_size'], 'used': v['vg_used'], 'free': v['vg_free'], 'percent': v['vg_percentage']})
except Exception as e:
return e.message
try:
lvm_stats = config.get('diskusage', 'lvm')
except:
lvm_stats = 'no'
# For LVM volume group monitoring, requires sudo access to vgs
# add vgs to /etc/sudoers
# agent360 ALL=(ALL) NOPASSWD: /usr/sbin/vgs
# set lvm = yes right under enabled = yes in /etc/agent360.ini
if lvm_stats == 'yes':
try:
lines = [s.split(', ') for s in os.popen("sudo vgs --all --units b --noheadings --separator ', '").read().splitlines()]
for row in lines:
v = {}
v['vg_name'] = row[0]
v['vg_size'] = int(row[5][:-1])
v['vg_free'] = int(row[6][:-1])
v['vg_used'] = int(v['vg_size']-v['vg_free'])
v['vg_percentage'] = (v['vg_used']/float(v['vg_size']))*100
disk['df-psutil'].append({'info': [v['vg_name'], v['vg_name'], 'lvm', False], 'total': v['vg_size'], 'used': v['vg_used'], 'free': v['vg_free'], 'percent': v['vg_percentage']})
except Exception as e:
return e.message
return disk
if __name__ == '__main__':
Plugin().execute()
PK [Fu\�����
�
agent360/plugins/megacli.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'megacli'
def run(self, config):
disk = {}
try:
df_output_lines = os.popen("megacli -LDInfo -Lall -aALL").read().splitlines()
data = {}
for line in df_output_lines:
if line.startswith('Virtual Drive'):
delim = line.find('(')
offset = line.find(':')
data['virtualdisk_id'] = int(line[offset+1:delim].strip())
if line.startswith('Name'):
offset = line.find(':')
data['name'] = line[offset+1:].strip()
elif line.startswith('RAID Level'):
offset = line.find(':')
data['raid_level'] = line[offset+1:].strip()
elif line.startswith('Size'):
offset = line.find(':')
data['size'] = line[offset+1:].strip()
elif line.startswith('State'):
offset = line.find(':')
data['state'] = line[offset+1:].strip()
elif line.startswith('Strip Size'):
delim = line.find(' KB')
offset = line.find(':')
data['stripe_size'] = line[offset+1:delim].strip()
elif line.startswith('Number Of Drives'):
offset = line.find(':')
data['number_of_drives'] = int(line[offset+1:].strip())
elif line.startswith('Span Depth'):
offset = line.find(':')
data['span_depth'] = int(line[offset+1:].strip())
elif line.startswith('Default Cache Policy'):
offset = line.find(':')
data['default_cache_policy'] = line[offset+1:].strip()
elif line.startswith('Current Cache Policy'):
offset = line.find(':')
data['current_cache_policy'] = line[offset+1:].strip()
elif line.startswith('Current Access Policy'):
offset = line.find(':')
data['access_policy'] = line[offset+1:].strip()
elif line.startswith('Disk Cache Policy'):
offset = line.find(':')
data['disk_cache_policy'] = line[offset+1:].strip()
elif line.startswith('Encryption'):
offset = line.find(':')
data['encryption'] = line[offset+1:].strip()
disk[data['virtualdisk_id']] = data
except Exception as e:
return e
return disk
if __name__ == '__main__':
Plugin().execute()
PK ]Fu\u��I I agent360/plugins/bird.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'bird'
def run(self, config):
'''
Monitor status of bgp sessions using bird
'''
data = {}
data['established'] = int(os.popen('sudo birdc show proto | /bin/grep -c Established').read())
data['connect'] = int(os.popen('sudo birdc show proto | /bin/grep -c Connect').read())
data['active'] = int(os.popen('sudo birdc show proto | /bin/grep -c Active').read())
data['conn_reset_bp'] = int(os.popen('sudo birdc show proto | /bin/grep -c "Connection reset by peer"').read())
data['hold_timer'] = int(os.popen('sudo birdc show proto | /bin/grep -c "Hold timer expired"').read())
return data
if __name__ == '__main__':
Plugin().execute()
PK bFu\wQ=�L L agent360/plugins/loadavg.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
import sys
class Plugin(plugins.BasePlugin):
__name__ = 'loadavg'
def run(self, *unused):
if sys.platform == 'win32':
return None
else:
return os.getloadavg()
if __name__ == '__main__':
Plugin().execute()
PK dFu\3���� � agent360/plugins/apt-updates.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'apt-updates'
def run(self, config):
'''
ubuntu/debian updates available from apt-get
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/bin/apt-get
test by running:
sudo -u agent360 agent360 test apt-updates
Add to /etc/agent360.ini:
[apt-updates]
enabled = yes
interval = 3600
Optionally check if a reboot is required:
checkreboot = true
'''
data = {}
data['security'] = int(os.popen('sudo -n apt-get upgrade -s | grep Inst | grep security | wc -l').read())
data['other'] = int(os.popen('sudo -n apt-get upgrade -s | grep Inst | grep -v security | wc -l').read())
try:
checkreboot = config.get('apt-updates', 'checkreboot')
if os.path.exists('/var/run/reboot-required') and checkreboot == "true":
data['Reboot Required'] = 'Yes'
elif checkreboot == "true":
data['Reboot Required'] = 'No'
except Exception:
pass
return data
if __name__ == '__main__':
Plugin().execute()
PK gFu\QfF'� � agent360/plugins/loggedin.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'loggedin'
def run(self, config):
'''
Returns the number of users currently logged in.
'''
data = {}
data['sessions'] = int(os.popen('/bin/users | wc -w').read())
return data
if __name__ == '__main__':
Plugin().execute()
PK iFu\�� (j j agent360/plugins/minecraft.pynu �[��� import plugins
import socket
import struct
import json
class Plugin(plugins.BasePlugin):
__name__ = 'minecraft'
def run(self, config):
'''
Fetch the amount of active and max players
add to /etc/agent360.ini
[minecraft]
enabled=yes
hosts=127.0.0.1:8000,127.0.0.2:8000...
'''
my_hosts = config.get('minecraft', 'hosts').split(',')
result = {}
for connection_string in my_hosts:
try:
# Connect
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
hostname = connection_string.split(':')[0]
port = int(connection_string.split(':')[1])
s.connect((hostname, port))
# Send handshake + status request
s.send(self.pack_data("\x00\x00" + self.pack_data(hostname.encode('utf8')) + self.pack_port(port) + "\x01"))
s.send(self.pack_data("\x00"))
# Read response
self.unpack_varint(s) # Packet length
self.unpack_varint(s) # Packet ID
l = self.unpack_varint(s) # String length
d = ""
while len(d) < l:
d += s.recv(1024)
# Close our socket
s.close()
except:
pass
results = {}
try:
players = json.loads(d.decode('utf8'))['players']
results['online'] = int(players['online'])
results['max'] = int(players['max'])
except:
results['online'] = 0
results['max'] = 0
result[str(connection_string.replace('.', '-'))] = results
return result
def unpack_varint(self, s):
d = 0
for i in range(5):
b = ord(s.recv(1))
d |= (b & 0x7F) << 7*i
if not b & 0x80:
break
return d
def pack_varint(self, d):
o = ""
while True:
b = d & 0x7F
d >>= 7
o += struct.pack("B", b | (0x80 if d > 0 else 0))
if d == 0:
break
return o
def pack_data(self, d):
return self.pack_varint(len(d)) + d
def pack_port(self, i):
return struct.pack('>H', i)
if __name__ == '__main__':
Plugin().execute()
PK lFu\?���
�
agent360/plugins/httpd.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
import time
import plugins
import re
class Plugin(plugins.BasePlugin):
__name__ = 'httpd'
def run(self, config):
'''
Apache/httpd status page metrics
'''
prev_cache = {}
next_cache = dict()
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
try:
request = Request(config.get('httpd', 'status_page_url'))
data = urlopen(request).read().decode('utf-8')
except Exception as e:
return False
exp = re.compile('^([A-Za-z ]+):\s+(.+)$')
results = {}
def parse_score_board(sb):
ret = []
ret.append(('IdleWorkers', sb.count('_')))
ret.append(('ReadingWorkers', sb.count('R')))
ret.append(('WritingWorkers', sb.count('W')))
ret.append(('KeepaliveWorkers', sb.count('K')))
ret.append(('DnsWorkers', sb.count('D')))
ret.append(('ClosingWorkers', sb.count('C')))
ret.append(('LoggingWorkers', sb.count('L')))
ret.append(('FinishingWorkers', sb.count('G')))
ret.append(('CleanupWorkers', sb.count('I')))
return ret
for line in data.split('\n'):
if line:
m = exp.match(line)
if m:
k = m.group(1)
v = m.group(2)
# Ignore the following values
if k == 'IdleWorkers' or k == 'Server Built' or k == 'Server Built' \
or k == 'CurrentTime' or k == 'RestartTime' or k == 'ServerUptime' \
or k == 'CPULoad' or k == 'CPUUser' or k == 'CPUSystem' \
or k == 'CPUChildrenUser' or k == 'CPUChildrenSystem' \
or k == 'ReqPerSec':
continue
if k == 'Total Accesses':
results['requests_per_second'] = self.absolute_to_per_second(k, int(v), prev_cache)
next_cache['Total Accesses'] = int(v)
if k == 'Scoreboard':
for sb_kv in parse_score_board(v):
results[sb_kv[0]] = sb_kv[1]
else:
results[k] = v
self.set_agent_cache(next_cache)
return results
if __name__ == '__main__':
Plugin().execute()
PK oFu\��a� agent360/plugins/mailq.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'mailq'
def run(self, *unused):
import os
stream = os.popen("sudo /usr/bin/mailq | /usr/bin/tail -n1 | /usr/bin/gawk '{print $5}'")
retval = stream.read()
results = {}
if len(retval) == 1:
results['queue_size'] = 0
else:
results['queue_size'] = int(retval)
return results
if __name__ == '__main__':
Plugin().execute()
PK qFu\[�H � � ! agent360/plugins/elasticsearch.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
try:
from urllib.parse import urlparse, urlencode
from urllib.request import urlopen, Request
from urllib.error import HTTPError
except ImportError:
from urlparse import urlparse
from urllib import urlencode
from urllib2 import urlopen, Request, HTTPError
import time
import plugins
import json
import collections
class Plugin(plugins.BasePlugin):
__name__ = 'elasticsearch'
def run(self, config):
'''
experimental monitoring plugin for elasticsearch
Add to /etc/agent360.ini:
[elasticsearch]
enabled = yes
status_page_url = http://127.0.0.1:9200/_stats
'''
def ascii_encode_dict(data):
ascii_encode = lambda x: x.encode('ascii') if isinstance(x, unicode) else x
return dict(map(ascii_encode, pair) for pair in data.items())
results = dict()
next_cache = dict()
request = urllib2.Request(config.get('elasticsearch', 'status_page_url'))
raw_response = urllib2.urlopen(request)
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
def flatten(d, parent_key='', sep='_'):
items = []
for k, v in d.items():
new_key = parent_key + sep + k if parent_key else k
if isinstance(v, collections.MutableMapping):
items.extend(flatten(v, new_key, sep=sep).items())
else:
items.append((new_key, v))
return dict(items)
try:
j = flatten(json.loads(raw_response.read(), object_hook=ascii_encode_dict)['_all']['total'])
except Exception:
return False
delta_keys = (
'get_time_in_millis',
'indexing_index_time_in_millis',
'flush_total_time_in_millis',
'indexing_delete_time_in_millis',
'indexing_index_time_in_millis',
'indexing_throttle_time_in_millis',
'merges_total_stopped_time_in_millis',
'merges_total_throttled_time_in_millis',
'merges_total_time_in_millis',
'recovery_throttle_time_in_millis',
'refresh_total_time_in_millis',
'search_fetch_time_in_millis',
'search_query_time_in_millis',
'search_scroll_time_in_millis',
'search_suggest_time_in_millis',
'warmer_total_time_in_millis',
'docs_count',
'docs_deleted',
'flush_total',
'get_exists_total',
'get_missing_total',
'get_total',
'indexing_delete_total',
'indexing_index_total',
'indexing_noop_update_total',
'merges_total',
'merges_total_docs',
'merges_total_auto_throttle_in_bytes',
'query_cache_cache_count',
'query_cache_cache_size',
'query_cache_evictions',
'query_cache_hit_count',
'query_cache_miss_count',
'query_cache_total_count',
'refresh_total',
'request_cache_hit_count',
'request_cache_miss_count',
'search_fetch_total',
'search_open_contexts',
'search_query_total',
'search_scroll_total',
'search_suggest_total',
'segments_count',
'segments_max_unsafe_auto_id_timestamp',
'warmer_total',
'get_exists_time_in_millis',
'get_missing_time_in_millis'
)
data = {}
constructors = [str, float]
for key, value in j.items():
key = key.lower().strip()
for c in constructors:
try:
value = c(value)
except ValueError:
pass
if key in delta_keys and type(value) is not str:
j[key] = self.absolute_to_per_second(key, float(value), prev_cache)
data[key] = float(value)
else:
pass
data['ts'] = time.time()
# Cache absolute values for next check calculations
self.set_agent_cache(data)
return j
if __name__ == '__main__':
Plugin().execute()
PK tFu\L�̆ agent360/plugins/bitninja.pynu �[��� #!/usr/bin/env python
import plugins
import os
import json
DEFAULT_STAT_COMMAND = "/usr/sbin/bitninjacli --stats --minify"
class Plugin(plugins.BasePlugin):
__name__ = 'bitninja'
def run(self, config):
'''
Collects metrics from the BitNinja Linux Agent.
For this plugin to work, at least BitNinja version 2.38.8 is required, and
the following configurations must be applied to it:
/etc/bitninja/System/config.ini:
```ini
[statistics]
enableIntegration = 1
```
This will allow agent360 to access the statistics.
Then after a BitNinja restart, the plugin can be tested by running:
sudo -u agent360 agent360 test bitninja
Add to /etc/agent360.ini:
```ini
[bitninja]
enabled = true
```
'''
try:
command = config.get(__name__, "statCommand")
except:
command = DEFAULT_STAT_COMMAND
stream = os.popen("sudo " + command)
result = stream.readlines()
firstLine = result[0]
startIndex = firstLine.find('{')
if startIndex >= 0:
return json.loads(firstLine[startIndex::].replace("\n", ""))
return None
if __name__ == '__main__':
Plugin().execute()
PK vFu\蔱_� � agent360/plugins/mysql.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import time
import MySQLdb
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'mysql'
def run(self, config):
'''
MySQL metrics plugin
'''
prev_cache = self.get_agent_cache() # Get absolute values from previous check
auth = {}
try:
auth['port'] = int(config.get('mysql', 'port'))
except ValueError:
auth['port'] = 3306
try:
auth['user'] = config.get('mysql', 'username')
except:
auth['user'] = 'root'
try:
auth['passwd'] = config.get('mysql', 'password')
except:
auth['passwd'] = ''
try:
auth['host'] = config.get('mysql', 'host')
except:
auth['unix_socket'] = config.get('mysql', 'socket')
try:
auth['db'] = config.get('mysql', 'database')
except:
auth['db'] = 'mysql'
db = MySQLdb.connect(**auth)
cursor = db.cursor()
cursor.execute("SHOW GLOBAL STATUS;")
query_result = cursor.fetchall()
non_delta = (
'max_used_connections',
'open_files',
'open_tables',
'qcache_free_blocks',
'qcache_free_memory',
'qcache_total_blocks',
'slave_open_temp_tables',
'threads_cached',
'threads_connected',
'threads_running',
'uptime'
)
delta_keys = (
'aborted_clients',
'aborted_connects',
'binlog_cache_disk_use',
'binlog_cache_use',
'bytes_received',
'bytes_sent',
'com_delete',
'com_delete_multi',
'com_insert',
'com_insert_select',
'com_load',
'com_replace',
'com_replace_select',
'com_select',
'com_update',
'com_update_multi',
'connections',
'created_tmp_disk_tables',
'created_tmp_files',
'created_tmp_tables',
'key_reads',
'key_read_requests',
'key_writes',
'key_write_requests',
'max_used_connections',
'open_files',
'open_tables',
'opened_tables',
'qcache_free_blocks',
'qcache_free_memory',
'qcache_hits',
'qcache_inserts',
'qcache_lowmem_prunes',
'qcache_not_cached',
'qcache_queries_in_cache',
'qcache_total_blocks',
'questions',
'select_full_join',
'select_full_range_join',
'select_range',
'select_range_check',
'select_scan',
'slave_open_temp_tables',
'slave_retried_transactions',
'slow_launch_threads',
'slow_queries',
'sort_range',
'sort_rows',
'sort_scan',
'table_locks_immediate',
'table_locks_waited',
'threads_cached',
'threads_connected',
'threads_created',
'threads_running'
)
results = dict()
data = dict()
constructors = [str, float]
for key, value in query_result:
key = key.lower().strip()
for c in constructors:
try:
value = c(value)
except ValueError:
pass
if key in non_delta:
results[key] = value
elif key in delta_keys and type(value) is not str:
results[key] = self.absolute_to_per_second(key, float(value), prev_cache)
data[key] = float(value)
else:
pass
cursor = db.cursor(MySQLdb.cursors.DictCursor)
cursor.execute('SHOW SLAVE STATUS')
query_result_slave = cursor.fetchone()
non_delta_slave = (
'slave_io_state',
'master_host',
'seconds_behind_master',
'read_master_log_pos',
'relay_log_pos',
'slave_io_running',
'slave_sql_running',
'last_error',
'exec_master_log_pos',
'relay_log_space',
'slave_sql_running_state',
'master_retry_count'
)
if query_result_slave is None:
query_result_slave = dict()
for key, value in query_result_slave.items():
key = key.lower().strip()
if key == 'slave_sql_running':
value = 1 if value == 'Yes' else 0
if key == 'slave_io_running':
value = 1 if value == 'Yes' else 0
for c in constructors:
try:
value = c(value)
except ValueError:
pass
if key in non_delta_slave and type(value) is not str:
results[key] = value
else:
pass
db.close()
data['ts'] = time.time()
self.set_agent_cache(data)
return results
if __name__ == '__main__':
Plugin().execute()
PK yFu\��`�� � agent360/plugins/system.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
try:
import netifaces
except ImportError:
netifaces = None
import os
import platform
from subprocess import Popen, PIPE
import sys
import time
import psutil
import plugins
try:
import distro
except ImportError:
distro = None
def systemCommand(Command, newlines=True):
Output = ""
Error = ""
try:
proc = Popen(Command.split(), stdout=PIPE)
Output = proc.communicate()[0]
except Exception:
pass
if Output:
if newlines is True:
Stdout = Output.split("\n")
else:
Stdout = Output
else:
Stdout = []
if Error:
Stderr = Error.split("\n")
else:
Stderr = []
return (Stdout, Stderr)
def linux_hardware_memory():
block_size = 0
try:
with open("/sys/devices/system/memory/block_size_bytes", "r") as f:
block_size = int(f.readline().strip(), 16)
memory = 0
with os.scandir("/sys/devices/system/memory/") as it:
for entry in it:
if not entry.name.startswith("memory"):
continue
with open(entry.path + "/state", "r") as f:
if "online" != f.readline().strip():
continue
else:
memory += block_size
return memory
except Exception:
return 0
def ip_addresses():
ip_list = {}
ip_list['v4'] = {}
ip_list['v6'] = {}
if netifaces is None:
return ip_list
for interface in netifaces.interfaces():
link = netifaces.ifaddresses(interface)
if netifaces.AF_INET in link:
if interface not in ip_list['v4']:
ip_list['v4'][interface] = []
ip_list['v4'][interface].append(link[netifaces.AF_INET])
if netifaces.AF_INET6 in link:
if interface not in ip_list['v6']:
ip_list['v6'][interface] = []
ip_list['v6'][interface].append(link[netifaces.AF_INET6])
return ip_list
class Plugin(plugins.BasePlugin):
__name__ = 'system'
def run(self, *unused):
systeminfo = {}
cpu = {}
cpu['brand'] = "Unknown CPU"
cpu['count'] = 0
if(os.path.isfile("/proc/cpuinfo")):
f = open('/proc/cpuinfo')
if f:
for line in f:
# Ignore the blank line separating the information between
# details about two processing units
if line.strip():
if "model name" == line.rstrip('\n').split(':')[0].strip():
cpu['brand'] = line.rstrip('\n').split(':')[1].strip()
if "Processor" == line.rstrip('\n').split(':')[0].strip():
cpu['brand'] = line.rstrip('\n').split(':')[1].strip()
if "processor" == line.rstrip('\n').split(':')[0].strip():
cpu['count'] = line.rstrip('\n').split(':')[1].strip()
if cpu['brand'] == "Unknown CPU":
f = os.popen('lscpu').read().split('\n')
if f:
for line in f:
# Ignore the blank line separating the information between
# details about two processing units
if line.strip():
if "Model name" == line.rstrip('\n').split(':')[0].strip():
cpu['brand'] = line.rstrip('\n').split(':')[1].strip()
if "Processor" == line.rstrip('\n').split(':')[0].strip():
cpu['brand'] = line.rstrip('\n').split(':')[1].strip()
if "CPU(s)" == line.rstrip('\n').split(':')[0].strip():
cpu['count'] = line.rstrip('\n').split(':')[1].strip()
mem = psutil.virtual_memory().total
if sys.platform == "linux" or sys.platform == "linux2":
hw_mem = linux_hardware_memory()
if hw_mem != 0:
mem = hw_mem
if distro is None:
systeminfo['os'] = str(' '.join(platform.linux_distribution()))
else:
systeminfo['os'] = str(' '.join(distro.linux_distribution(full_distribution_name=True)))
elif sys.platform == "darwin":
systeminfo['os'] = "Mac OS %s" % platform.mac_ver()[0]
cpu['brand'] = str(systemCommand('sysctl machdep.cpu.brand_string', False)[0]).split(': ')[1]
#cpu['count'] = systemCommand('sysctl hw.ncpu')
elif sys.platform == "freebsd10" or sys.platform == "freebsd11":
systeminfo['os'] = "FreeBSD %s" % platform.release()
cpu['brand'] = str(systemCommand('sysctl hw.model', False)[0]).split(': ')[1]
cpu['count'] = systemCommand('sysctl hw.ncpu')
elif sys.platform == "win32":
# https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information
if sys.getwindowsversion().build >= 22000:
systeminfo['os'] = "{} {}".format(platform.uname()[0], 11)
else:
systeminfo['os'] = "{} {}".format(platform.uname()[0], platform.uname()[2])
systeminfo['cpu'] = cpu['brand']
systeminfo['cores'] = cpu['count']
systeminfo['memory'] = mem
systeminfo['psutil'] = '.'.join(map(str, psutil.version_info))
systeminfo['python_version'] = sys.version
systeminfo['platform'] = platform.platform()
systeminfo['uptime'] = int(time.time()-psutil.boot_time())
systeminfo['ip_addresses'] = ip_addresses()
systeminfo['hostname'] = platform.node()
return systeminfo
if __name__ == '__main__':
Plugin().execute()
PK {Fu\���i i agent360/plugins/dirsize.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import json
class Plugin(plugins.BasePlugin):
__name__ = 'dirsize'
def run(self, config):
'''
Monitor total directory sizes, specify the directories you want to monitor in /etc/agent360.ini
'''
data = {}
my_dirs = config.get('dirsize', 'dirs').split(',')
for dir in my_dirs:
data[dir] = {'bytes': os.popen('du -sbc {} | grep total'.format(dir)).read().replace('total', '').rstrip()}
return data
if __name__ == '__main__':
Plugin().execute()
PK �Fu\�=�* * agent360/plugins/yum-updates.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'yum-updates'
def run(self, config):
'''
updates for RHEL-based OS available from yum
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/bin/yum
test by running:
sudo -u agent360 agent360 test yum-updates
Add to /etc/agent360.ini:
[yum-updates]
enabled = yes
interval = 3600
'''
data = {}
data['security'] = int(os.popen('yum -q list updates --security | grep -v Available | wc -l').read())
data['all'] = int(os.popen('yum -q list updates | grep -v Available | wc -l').read())
return data
if __name__ == '__main__':
Plugin().execute()PK �Fu\��Ԭ� � agent360/plugins/cpanel.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import subprocess
import json
import re
class Plugin(plugins.BasePlugin):
__name__ = 'cpanel'
def to_bytes(self, size):
size = size.upper()
units = {"B": 1, "K": 2 ** 10, "M": 2 ** 20, "G": 2 ** 30, "T": 2 ** 40}
if not re.match(r' ', size):
size = re.sub(r'([KMGT])', r' \1', size)
number, unit = [string.strip() for string in size.split()]
return int(float(number) * units[unit])
def run(self, config):
'''
Plugin to collect cpanel user accounts
To enable add to /etc/agent360.ini:
[cpanel]
enabled = yes
'''
data = subprocess.check_output(['whmapi1', '--output=jsonpretty', 'listaccts'])
results = {}
accounts = json.loads(data)
for account in accounts['data']['acct']:
results[account['user']] = {
'diskused_bytes': self.to_bytes(account['diskused']),
'inodesused': account['inodesused'],
'is_locked': account['is_locked'],
'has_backup': account['has_backup'],
'outgoing_mail_hold': account['outgoing_mail_hold'],
'outgoing_mail_suspended': account['outgoing_mail_suspended'],
'suspended': account['suspended'],
}
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\(.�* * agent360/plugins/litespeed.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import os
import time
import re
import base64
class Plugin(plugins.BasePlugin):
__name__ = 'litespeed'
'''
Litespeed monitoring plugin. Add the following section to /etc/agent360.ini
[litespeed]
enabled=yes
host=localhost
port=7080
username=admin
password=pass
'''
def run(self, config):
result = {}
results = {}
data = False
prev_cache = self.get_agent_cache() # Get absolute values from previous check
response = os.popen("curl -s -i -k -u %s:%s 'https://%s:%s/status?rpt=summary'"% (config.get('litespeed', 'username'), config.get('litespeed', 'password'), config.get('litespeed', 'host'),config.get('litespeed', 'port'))).read()
for line in response.splitlines():
test = re.search('REQ_RATE \[(.*)\]', line)
if test is not None and test.group(1):
data = True
try:
result[test.group(1)]
except KeyError:
result[test.group(1)] = {}
lines = line.replace('\n', '').replace(test.group(0), '').split(', ')
for line in lines:
keyval = line.strip(':').strip().split(':')
try:
result[test.group(1)][keyval[0]] += float(keyval[1])
except KeyError:
result[test.group(1)][keyval[0]] = float(keyval[1])
metrics = (
'SSL_BPS_IN',
'BPS_OUT',
'MAXSSL_CONN',
'PLAINCONN',
'BPS_IN',
'SSLCONN',
'AVAILSSL',
'IDLECONN',
'SSL_BPS_OUT',
'AVAILCONN',
'MAXCONN',
'REQ_PROCESSING'
)
if data is True:
for vhost, statistics in result.items():
try:
prev_cache[vhost]['ts'] = prev_cache['ts']
except KeyError:
prev_cache[vhost] = {}
results[vhost] = {}
for key, value in statistics.items():
if key == 'TOT_REQS':
results[vhost]['RPS'] = self.absolute_to_per_second(key, value, prev_cache[vhost])
if key == 'TOTAL_STATIC_HITS':
results[vhost]['STATIC_RPS'] = self.absolute_to_per_second(key, value, prev_cache[vhost])
if key == 'TOTAL_PUB_CACHE_HITS':
results[vhost]['PUB_CACHE_RPS'] = self.absolute_to_per_second(key, value, prev_cache[vhost])
if key == 'TOTAL_PRIVATE_CACHE_HITS':
results[vhost]['PRIVATE_CACHE_RPS'] = self.absolute_to_per_second(key, value, prev_cache[vhost])
if key in metrics:
results[vhost][key] = value
result['ts'] = time.time()
self.set_agent_cache(result)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\Q}2~� � agent360/plugins/temp.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import psutil
import sys
class Plugin(plugins.BasePlugin):
__name__ = 'temp'
def run(self, *unused):
'''
expirimental plugin used to collect temperature from system sensors
plugin can be tested by running agent360 test temp
'''
data = {}
if sys.platform == "win32":
try:
import wmi
except:
return 'wmi module not installed.'
try:
w = wmi.WMI(namespace="root\OpenHardwareMonitor")
temperature_infos = w.Sensor()
for sensor in temperature_infos:
if sensor.SensorType==u'Temperature':
data[sensor.Parent.replace('/','-').strip('-')] = sensor.Value
return data
except:
return 'Could not fetch temperature data from OpenHardwareMonitor.'
if not hasattr(psutil, "sensors_temperatures"):
return "platform not supported"
try:
temps = psutil.sensors_temperatures()
except:
return "can't read any temperature"
for device, temp in temps.items():
for value in temp:
type = value[0]
if value[0] == '':
type = device
data[type] = value[1]
return data
if __name__ == '__main__':
Plugin().execute()
PK �Fu\�S�bk k agent360/plugins/iostat.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
#
import os
import signal
import subprocess
import sys
import psutil
import plugins
import time
def diskstats_parse(dev=None):
file_path = '/proc/diskstats'
result = {}
if not os.path.isfile("/proc/diskstats"):
return False
# ref: http://lxr.osuosl.org/source/Documentation/iostats.txt
columns_disk = ['m', 'mm', 'dev', 'reads', 'rd_mrg', 'rd_sectors',
'ms_reading', 'writes', 'wr_mrg', 'wr_sectors',
'ms_writing', 'cur_ios', 'ms_doing_io', 'ms_weighted']
# For kernel 4.18+
columns_disk_418 = ['m', 'mm', 'dev', 'reads', 'rd_mrg', 'rd_sectors',
'ms_reading', 'writes', 'wr_mrg', 'wr_sectors',
'ms_writing', 'cur_ios', 'ms_doing_io', 'ms_weighted',
'discards', 'discards_merged', 'discarded_sectors',
'discarded_time']
# for kernel 5.5+
columns_disk_55 = ['m', 'mm', 'dev', 'reads', 'rd_mrg', 'rd_sectors',
'ms_reading', 'writes', 'wr_mrg', 'wr_sectors',
'ms_writing', 'cur_ios', 'ms_doing_io', 'ms_weighted',
'discards', 'discards_merged', 'discarded_sectors',
'discarded_time', 'flush', 'flush_time']
columns_partition = ['m', 'mm', 'dev', 'reads', 'rd_sectors', 'writes', 'wr_sectors']
lines = open(file_path, 'r').readlines()
for line in lines:
if line == '':
continue
split = line.split()
if len(split) == len(columns_disk_55):
columns = columns_disk_55
elif len(split) == len(columns_disk_418):
columns = columns_disk_418
elif len(split) == len(columns_disk):
columns = columns_disk
elif len(split) == len(columns_partition):
columns = columns_partition
else:
# No match
continue
data = dict(zip(columns, split))
if data['dev'][:3] == 'nvm' and data['dev'][-2:-1] == 'n':
pass
elif data['dev'][-1:].isdigit() is True:
continue
if "loop" in data['dev'] or "ram" in data['dev']:
continue
if dev is not None and dev != data['dev']:
continue
for key in data:
if key != 'dev':
data[key] = int(data[key])
result[data['dev']] = data
return result
class Plugin(plugins.BasePlugin):
__name__ = 'iostat'
def run(self, *unused):
delta_keys = (
'reads',
'writes',
'wr_sectors',
'rd_sectors',
'ms_reading',
'rd_mrg',
'wr_mrg',
'ms_weighted',
'ms_doing_io',
'ms_writing',
'discarded_sectors',
'discarded_time',
'flush',
'flush_time',
'discards'
)
next_cache = {}
next_cache['ts'] = time.time()
prev_cache = self.get_agent_cache() # Get absolute values from previous check
disks = diskstats_parse()
if not disks or disks is False:
results = {}
try:
diskdata = psutil.disk_io_counters(perdisk=True)
for device, values in diskdata.items():
device_stats = {}
for key_value in values._fields:
device_stats[key_value] = getattr(values, key_value)
results[device] = device_stats
except Exception as e:
results = e.message
else:
results = {}
for device, values in disks.items():
device_stats = {}
next_cache[device] = {}
next_cache[device]['ts'] = time.time()
try:
prev_cache[device]
except:
prev_cache[device] = {}
for key_value, value in values.items():
if key_value in delta_keys:
try:
device_stats[key_value] = self.absolute_to_per_second(key_value, value, prev_cache[device])
except:
pass
next_cache[device][key_value] = value
else:
device_stats[key_value] = value
try:
device_stats['avgrq-sz'] = (device_stats['wr_sectors']+device_stats['rd_sectors']) / (device_stats['reads']+device_stats['writes'])
except:
device_stats['avgrq-sz'] = 0
try:
device_stats['tps'] = device_stats['reads']+device_stats['writes']
except:
device_stats['tps'] = 0
try:
device_stats['usage'] = (100 * device_stats['ms_doing_io']) / (1000 * (next_cache['ts'] - prev_cache['ts']))
except:
device_stats['usage'] = 0
results[device] = device_stats
self.set_agent_cache(next_cache)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\ݢ�M� � agent360/plugins/mongodb.pynu �[��� #!/usr/bin/env python
import time
import plugins
from pymongo import MongoClient
class Plugin(plugins.BasePlugin):
__name__ = 'mongodb'
def run(self, config):
"""
Mongodb monitoring
"""
client = MongoClient(config.get('mongodb', 'connection_string'))
db = client.admin
statistics = db.command("serverStatus")
prev_cache = self.get_agent_cache() # Get absolute values from previous check
data = {}
results = {}
# replication status
try:
results['isprimary'] = 0 if statistics['repl']['ismaster'] is False else 1
results['members'] = len(statistics['repl']['hosts'])
except:
pass
# transactions stats, available in v3.6.3 and up
try:
data['transactions-retriedCommandsCount'] = statistics['transactions']['retriedCommandsCount']
data['transactions-retriedStatementsCount'] = statistics['transactions']['retriedStatementsCount']
data['transactions-transactionsCollectionWriteCount'] = statistics['transactions']['transactionsCollectionWriteCount']
data['transactions-totalAborted'] = statistics['transactions']['totalAborted']
data['transactions-totalCommitted'] = statistics['transactions']['totalCommitted']
data['transactions-totalStarted'] = statistics['transactions']['totalStarted']
results['transactions-currentActive'] = statistics['transactions']['currentActive']
results['transactions-currentInactive'] = statistics['transactions']['currentInactive']
results['transactions-currentOpen'] = statistics['transactions']['currentOpen']
except:
pass
data['connections.totalCreated'] = statistics['connections']['totalCreated']
results['connections.available'] = statistics['connections']['available']
results['connections.current'] = statistics['connections']['current']
data['opcounters.command'] = statistics['opcounters']['command']
data['opcounters.delete'] = statistics['opcounters']['delete']
data['opcounters.getmore'] = statistics['opcounters']['getmore']
data['opcounters.insert'] = statistics['opcounters']['insert']
data['opcounters.query'] = statistics['opcounters']['query']
data['opcounters.update'] = statistics['opcounters']['update']
data['opLatencies.commands.latency'] = statistics['opLatencies']['commands']['latency']
data['opLatencies.commands.ops'] = statistics['opLatencies']['commands']['ops']
data['opLatencies.reads.latency'] = statistics['opLatencies']['reads']['latency']
data['opLatencies.reads.ops'] = statistics['opLatencies']['reads']['ops']
data['opLatencies.writes.latency'] = statistics['opLatencies']['writes']['latency']
data['opLatencies.writes.ops'] = statistics['opLatencies']['writes']['ops']
data['globalLock.currentQueue.total'] = statistics['globalLock']['currentQueue']['total']
data['globalLock.currentQueue.readers'] = statistics['globalLock']['currentQueue']['readers']
data['globalLock.currentQueue.writers'] = statistics['globalLock']['currentQueue']['writers']
data['globalLock.activeClients.total'] = statistics['globalLock']['activeClients']['total']
data['globalLock.activeClients.readers'] = statistics['globalLock']['activeClients']['readers']
data['globalLock.activeClients.writers'] = statistics['globalLock']['activeClients']['writers']
data['asserts.msg'] = statistics['asserts']['msg']
data['asserts.regular'] = statistics['asserts']['regular']
data['asserts.rollovers'] = statistics['asserts']['rollovers']
data['asserts.user'] = statistics['asserts']['user']
data['asserts.warning'] = statistics['asserts']['warning']
#deadlock stats
try:
for key, val in statistics['locks'].items():
for key2, val2 in val.items():
for key3, val3 in val2.items():
data['locks-{}-{}-{}'.format(key.lower(), key2, key3)] = val3
except:
pass
try:
data['opcountersRepl.command'] = statistics['opcountersRepl']['command']
data['opcountersRepl.delete'] = statistics['opcountersRepl']['delete']
data['opcountersRepl.getmore'] = statistics['opcountersRepl']['getmore']
data['opcountersRepl.insert'] = statistics['opcountersRepl']['insert']
data['opcountersRepl.query'] = statistics['opcountersRepl']['query']
data['opcountersRepl.update'] = statistics['opcountersRepl']['update']
except KeyError:
pass
for key, val in data.items():
results[key] = self.absolute_to_per_second(key, val, prev_cache)
try:
results['opLatencies.commands'] = results['opLatencies.commands.latency']/results['opLatencies.commands.ops']
results['opLatencies.writes'] = results['opLatencies.writes.latency']/results['opLatencies.writes.ops']
results['opLatencies.reads'] = results['opLatencies.reads.latency']/results['opLatencies.reads.ops']
except:
pass
next_cache = data
next_cache['ts'] = time.time()
self.set_agent_cache(next_cache)
results['mem.resident'] = statistics['mem']['resident']
results['mem.bits'] = statistics['mem']['bits']
results['mem.virtual'] = statistics['mem']['virtual']
results['mem.supported'] = 0 if statistics['mem']['supported'] is False else 1
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\�Q� V V agent360/plugins/tcpports.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import socket
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'tcpports'
def run(self, config):
'''
Checks if TCP ports are open.
'''
def is_port_open(host, port, timeout):
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.settimeout(timeout) # Timeout for the connection attempt
try:
sock.connect((host, port))
sock.close()
return 1
except socket.error:
return 0
results = dict()
# Parse the config for the host-port pairs to check
host_ports = config.get(__name__, 'host_ports').split(',')
timeout = float(config.get(__name__, 'timeout')) # Timeout for the connection attempt
for host_port in host_ports:
host, port = host_port.split(':')
port = int(port)
results[host_port] = {'available': is_port_open(host, port, timeout)}
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\BE�� � agent360/plugins/janus.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import plugins
import subprocess
class Plugin(plugins.BasePlugin):
__name__ = 'janus'
def run(self, config):
adminpw = config.get('janus', 'adminpw')
p = subprocess.Popen("curl -s -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST -d '{ \"janus\": \"list_sessions\", \"transaction\": \"324\", \"admin_secret\": \""+adminpw+"\" }' http://localhost:7088/admin | awk 'NR>=5' | head -n -2 | wc -l", stdout=subprocess.PIPE, shell=True)
p = p.communicate()[0].decode('utf-8').replace("\n", "")
res = { "janus_sessions": p }
return res
if __name__ == '__main__':
Plugin().execute()
PK �Fu\��3�R R # agent360/plugins/diskstatus-nvme.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import json
import re
class Plugin(plugins.BasePlugin):
__name__ = 'diskstatus-nvme'
def run(self, config):
'''
Monitor nvme disk status
For NVME drives install nvme-cli (https://github.com/linux-nvme/nvme-cli#distro-support)
This plugin requires the agent to be run under the root user.
'''
results = {}
try:
data = subprocess.Popen('nvme --list --output-format=json', stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True).communicate()[0]
data = json.loads(data.decode('utf-8'))
data['Devices']
nvme = True
except Exception:
nvme = False
return "Could not fetch nvme status information"
if nvme is True:
for value in data['Devices']:
device = {}
disk_data = os.popen('nvme smart-log {} --output-format=json'.format(value['DevicePath'])).read()
try:
data_disk = json.loads(disk_data)
except Exception:
pass
for disk_key, disk_value in data_disk.items():
if disk_key.startswith('temperature'):
device[disk_key] = round(disk_value-273.15, 0) # kelvin to celsius
else:
device[disk_key] = disk_value
results[value['DevicePath'].replace('/dev/', '')] = device
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\6��5 5 agent360/plugins/wp-toolkit.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'wp-toolkit'
__title__ = 'WP Toolkit'
__description__ = 'Unified plugin for gathering metrics for WP Toolkit servers on cPanel and Plesk.'
def run(self, config):
'''
Grabbing some basic information from your cPanel or Plesk server
If you are using Plesk:
add to /etc/sudoers the following line:
agent360 ALL=(ALL) NOPASSWD: /usr/sbin/plesk
For cPanel:
agent360 ALL=(ALL) NOPASSWD: /usr/local/bin/wp-toolkit
test by running:
sudo -u agent360 agent360 test wp-toolkit
Add to /etc/agent360.ini:
[wp-toolkit]
enabled = yes
interval = 3600
'''
command = ''
if os.path.isdir("/var/cpanel/users"):
command = 'wp-toolkit'
elif os.path.isdir("/opt/plesk"):
command = 'plesk ext wp-toolkit'
data = {}
if command != '':
data['WordPress Websites'] = int(os.popen('sudo -n ' + command + ' --list | grep -v "Main Domain ID" | grep . | wc -l').read())
data['WordPress Websites - Alive'] = int(os.popen('sudo -n ' + command + ' --list | grep "Working" | wc -l').read())
data['WordPress Websites - Outdated'] = int(os.popen('sudo -n ' + command + ' --list | grep "Outdated WP" | wc -l').read())
data['WordPress Websites - Outdated PHP'] = int(os.popen('sudo -n ' + command + ' --list | grep "Outdated PHP" | wc -l').read())
data['WordPress Websites - Broken'] = int(os.popen('sudo -n ' + command + ' --list | grep "Broken" | wc -l').read())
return data
else:
return "Neither cPanel nor Plesk detected"
if __name__ == '__main__':
Plugin().execute()
PK �Fu\S�@� � agent360/plugins/sleeper.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import time
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'sleeper'
def run(self, *unused):
time.sleep(60 * 60 * 24)
if __name__ == '__main__':
Plugin().run()
PK �Fu\El� � � agent360/plugins/exim.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import plugins
class Plugin(plugins.BasePlugin):
__name__ = 'exim'
def run(self, config):
'''
exim mail queue monitoring, needs sudo access!
Instructions at:
https://docs.360monitoring.com/docs/exim-queue-size-plugin
'''
data = {}
data['queue_size'] = int(os.popen('sudo exim -bpc').read())
return data
if __name__ == '__main__':
Plugin().execute()
PK �Fu\?'�b� � agent360/plugins/diskstatus.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import os
import subprocess
import plugins
import json
import re
class Plugin(plugins.BasePlugin):
__name__ = 'diskstatus'
def run(self, config):
'''
Monitor nvme or smart disk status.
For NVME drives use the diskstatus-nvme plugin
for smart status install smartmontools (apt-get/yum install smartmontools)
This plugin requires the agent to be run under the root user.
'''
results = {}
try:
devlist = subprocess.Popen('smartctl --scan', stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True).communicate()[0].decode().splitlines()
smartctl = True
except Exception as e:
smartctl = False
return "Could not fetch smartctl status information"
if smartctl is True:
for row in devlist:
try:
disk_id = row.split(' ')[0].split('/')[2]
disk_stats = os.popen('smartctl -A -H {}'.format(row.split(' ')[0])).read().splitlines()
smart_status = 0
if disk_stats[4].split(': ')[1] == 'PASSED':
smart_status = 1
results[disk_id] = {}
start = False
for stats in disk_stats:
if stats[0:3] == 'ID#':
start = True
continue
if start is False:
continue
stats = re.sub(' +', ' ', stats).strip()
stats = stats.split(' ')
if len(stats) > 9:
results[disk_id][stats[1].lower().replace('_celsius','')] = stats[9]
results[disk_id]["status"] = smart_status
except Exception as e:
print(e)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\�$��� � agent360/plugins/cpu.pynu �[��� #!/usr/bin/env python
# -*- coding: utf-8 -*-
import psutil
import plugins
import time
class Plugin(plugins.BasePlugin):
__name__ = 'cpu'
def run(self, *unused):
prev_cache = self.get_agent_cache() # Get absolute values from previous check
next_cache = {}
next_cache['ts'] = time.time()
results = {}
data_stats = psutil.cpu_stats()
# if there's no previous cache, build the first baseline value
# so we don't have all 0% values, should happen only the first time
try:
prev_cache['ts']
except KeyError:
data = psutil.cpu_times(percpu=True)
cpu_number = -1
prev_cache['ts'] = time.time()
for cpu in data:
cpu_number = cpu_number+1
prev_cache[cpu_number] = {}
for key in cpu._fields:
prev_cache[cpu_number][key] = getattr(cpu, key)
time.sleep(0.5)
data = psutil.cpu_times(percpu=True)
cpu_number = -1
for cpu in data:
cpu_number = cpu_number+1
results[cpu_number] = {}
next_cache[cpu_number] = {}
for key in cpu._fields:
next_cache[cpu_number][key] = getattr(cpu, key)
try:
time_delta = time.time() - prev_cache['ts']
except:
continue
if time_delta <= 0:
continue
cpu_time_delta = getattr(cpu, key) - prev_cache[cpu_number][key]
if cpu_time_delta < 0:
cpu_time_delta = 0
results[cpu_number][key] = cpu_time_delta / time_delta * 100
if results[cpu_number][key] > 100:
results[cpu_number][key] = 100
if results[cpu_number][key] < 0:
results[cpu_number][key] = 0
self.set_agent_cache(next_cache)
return results
if __name__ == '__main__':
Plugin().execute()
PK �Fu\G�c�� � , agent360/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �;/usr/local/lib/python3.9/site-packages/agent360/__init__.py�<module> � PK �Fu\��S@�I �I , agent360/__pycache__/agent360.cpython-39.pycnu �[��� a
��?h�o � @ s d dl mZ d dlZd dlZejdkrxzd dlmZ W n eyL eZY n0 d dl Z d dl
Z d dl m
Z
mZ d dlZn(d dlZd dlZd dlZd dl
m
Z
mZ ejdkr�d dlZnd dlZd dlZd dlZd dlZz d dlZW n ey� d dlZY n0 d dlZd dl Z d dl Z d dl Z d dl Z d dl Z d dl!Z!d dl"Z"d dl#Z#d dl$m%Z% z0d dl&m'Z'm(Z( d d l)m*Z*m+Z+ d d
l,m-Z- W n@ e�y� d d l'm'Z' d d l.m(Z( d d
l/m*Z*m+Z+m-Z- Y n0 dZ0e j1�2e j1�3e4��Z5e j1�6dd�e j1�6dd�e j1�6dd�e j1�6e j1�2e5�d�e j1�6e j1�2e5�d�e j1�6e j1�2e5�d�e j1�3d�e j1�3d�e j1�3d�f Z7e j8dk�r�e j1�6e5ddd�e j1�6e5ddd�e j1�6e5ddd�fZ7dd� Z9d,dd�Z:dd � Z;d d � Z<d d � Z=d!d"� Z>d#d$� Z?g fd%d&�Z@G d'd(� d(�ZAd)d*� ZBeCd+k�reB� dS )-� )�print_functionN�� )�
basestring)�Queue�Empty�r � )� OptionParser)�urlparse� urlencode)�urlopen�Request)� HTTPError)r )r )r
r r z1.3.1z/etcz agent360.inizagent360-custom.ini�agent360-token.ini�ntz..�configc
C sP t dd�} | �� }| jdd�}d�dt dd�|� d | d
| j�d d � f�S )
z�
Return string with info about agent360:
- version
- plugins enabled
- absolute path to plugin directory
- server id from configuration file
T�� dry_instance�enabled��state�
z Version: %szPlugins enabled: %s�, zPlugins directory: %sz
Server: %s�agent�server)�Agent�_get_plugins_path� _get_plugins�join� __version__r �get)r � plugins_pathZplugins_enabled� r# �;/usr/local/lib/python3.9/site-packages/agent360/agent360.py�infoM s
�r% �httpsc C s� t � }|jdddd� |jddtddd � |�� \}}|d }td
d �}t|�d kr^|d }ntj�t d
�}t|�dkr�|d }nd}|j
d u r�d}n|j
}|j d kr�d�t � �} nd} d|v r�|�
d�d }
|�
d�d }nnzt�� d } W n t�y
t�� } Y n0 t| d |j�dd� d t|| ||| d���d�d��� �� }
t|
�dk�r�td|
� t|d��d ||
f � n td |
� d S ) Nz-tz--tagsz Comma-separated list of tags)�helpz-az --automonr z6Enable/disable automatic monitoring of hosted websites)�type�defaultr' Tr � r � � �,�_z://�data�hello_api_hostz/hello)�user�hostname� unique_id�tags�domainszutf-8)r/ � zGot server_id: %s�wz [DEFAULT]
user=%s
server=%s
z Could not retrieve server_id: %s) r
�
add_option�int�
parse_argsr �len�os�pathr �__FILEABSDIRNAME__r4 Zautomon� _get_domains�split�uname�AttributeError�socket�getfqdnr
r r! r �encode�read�decode�print�open�write) �proto�parser�options�argsZuser_idr Ztoken_filenamer3 r4 r5 Z server_idr2 r# r# r$ �hellob sV
���
�rO c C sf g } zJt �ddg�}|�� �� D ]*}d|vr.q |�� �d�}| �|d � q W n ty` Y n0 | S )NZ apachectlz-SZ namevhost� r )�
subprocess� check_outputrG �
splitlines�stripr@ �append�FileNotFoundError)r5 �output�line�colsr# r# r$ �_get_apache_domains� s rZ c C s� g } zjt �ddg�}|�� �� D ]J}d|vr.q |�� �d�}t|�dkr |d �dd��d d�}| �|� q W n t y� Y n0 | S )
NZnginxz-TZ server_namerP r+ r* �;r, �")
rQ rR rG rS rT r@ r; �replacerU rV )r5 rW rX rY �domainr# r# r$ �_get_nginx_domains� s r_ c C s� g } z<t �g d��}t�|�}|d d D ]}| �|d � q*W n� ty� z.t �g d��}|�� �� D ]}| �|� qjW nd ty� tt t
� t � ��D ]<}d|vr�q�|� d�r�q�|� d�r�q�|� d �r�q�| �|� q�Y n0 Y n0 | S )
N)Zwhmapi1z--output=jsonprettyZget_domain_infor/ r5 r^ )Zplesk�binr^ z--list�.z .localdomainz
.localhostz.local)
rQ rR �json�loadsrU rV rG rS �list�setrZ r_ �endswith)r5 Zjson_str�responser^ �strr# r# r$ r? � s.
r? c C s t tt� �� d S )N)rH r; r? r# r# r# r$ �
count_domains� s ri c C s0 t | t�r&tj�| �}tj�|�d S | jS d S )Nr )�
isinstancer r< r= �basename�splitext�__name__)�pluginrk r# r# r$ � _plugin_name� s
ro c C s� t dd�}|�� }|tjvr*tj�d|� | sL|jdd�} tdd�| � � | D �]�}td| � z,tjd kr|t j
� |�}nt �
|�\}}}W n: ty� } z"td
|� W Y d }~qPW Y d }~n
d }~0 0 z�z8tjd kr�t j
�|�} |j�| � nt �||||�} W nT t�yX } z:td |� W Y d }~W tjd k rP|rP|�� qPW Y d }~n
d }~0 0 W tjd k �r�|�r�|�� n tjd k �r�|�r�|�� 0 z(| �� �|j�}
ttj|
d
dd�� W qP t�y� } ztd|� W Y d }~qPd }~0 0 qPd S )z�
Test specified plugins and print their data output after single check.
If plugins list is empty test all enabled plugins.
Tr r r r z Check all enabled plugins: %sr z%s:r z Find error:Nz Load error:r ��indent� sort_keyszExecution error:)r r �sysr= �insertr rH r � version_info� importlib�util� find_spec�imp� find_module� Exception�module_from_spec�loader� exec_module� load_module�close�Plugin�runr rb �dumps) �pluginsr r" � plugin_name�spec�fp�pathname� description�e�module�payloadr# r# r$ � test_plugins� sN
"
�
�
r� c @ s� e Zd Ze� Ze� Ze� Ze� ZdZd dd�Z dd� Z
dd� Z dd � Z d
d � Z
d d
� Zdd� Zdd� Zdd� Zdd� Zdd� Zd!dd�Zdd � Zd d � Zd S )"r Fc C s: | � � i | _|rdS | �� | �� | �� | �� dS )z0
Initialize internal strictures
N)� _config_init�
plugins_cache�
_logging_init�
_plugins_init�_data_worker_init� _dump_config)�selfr r# r# r$ �__init__" s zAgent.__init__c C s2 t jdkr t j�| j�dd��S | j�dd�S d S )Nr r r� )r< �namer= �
expandvarsr r! �r� r# r# r$ r 3 s
zAgent._get_plugins_pathc C s� ddt jdddtj�td�ddddddd d
d d d
�}g d�}tjdkrRt� |�}n
t
� |�}|� t � || _
|D ]>}| �|� |dkr�| j
�|dd� |dkrp| j
�|dd� qpdS )z1
Initialize configuration object
�< iX �d r� �nor, zingest.monitoring360.iozapi.monitoring360.ioz/v2/server/pollz/var/log/agent360.log�a�
)�
max_data_span� max_data_age�
logging_level�threads�ttl�intervalr� r rQ r1 r �api_hostr0 �api_path�log_file�
log_file_mode�max_cached_collections)r � executionr/ r r/ r� r* r � �?N)�logging�INFOr< r= r r> rs ru � configparser�RawConfigParser� ConfigParserrF � ini_filesr �_config_section_createre )r� �defaults�sectionsr �sectionr# r# r$ r� : s< �
zAgent._config_initc C s | j �|�s| j �|� dS )zc
Create an addition section in the configuration object
if it's not exists
N)r � has_section� add_section)r� r� r# r# r$ r� c s z Agent._config_section_createc
C s� | j �dd�}tjdkr0tj�| j �dd��}n| j �dd�}| j �dd�}|dv rVn |dkrdd}n|d krrd
}nd
}|d kr�tj|d � n^ztj|||d
d� W nF t y� } z.tj|d � t�
d|� t�
d� W Y d}~n
d}~0 0 t�
d|� dS )z,
Initialize logging faculty
r r� r r� r� )r7 r� �truncater7 rU r� �-)�levelz,%(asctime)-15s %(levelname)s %(message)s)�filename�filemoder� �formatz IOError: %szDrop logging to stderrNzAgent logging_level %i) r �getintr< r� r= r� r! r� � basicConfig�IOErrorr% )r� r� r� r� r� r# r# r$ r� k s*
zAgent._logging_initc
C s� t �d� | �� }t�tj�|d��}|tjvr>tj�d|� i | _ |D �]4}t
|�}|dkr`qH| � |� | j �
|d�rH| j �
|d�r�d| j |< qHtjdkr�tj�|�}nt�|�\}}}z�z8tjdkr�tj�|�} |j�| � nt�||||�} W n0 t�y$ d} t �d tt�� d �� Y n0 W tjdk �r`|�r`|� � n tjdk �r^|�r^|� � 0 | �rrd| j | < qHt �d
|� qHdS ) z&
Discover the plugins
r� �*.pyr r� r rQ r Nzimport_plugin_exception:%szimport_plugin:%s) r� r% r �globr< r= r rs rt �schedulero r� r �
getbooleanru rv rw rx ry rz r| r} r~ r r{ �errorrh �exc_infor� )
r� r" � filenamesr� r� r� r� r� r� r� r# r# r$ r� � sD
�
zAgent._plugins_initc
C s$ t jtj|ft jt jdd�}t�dt�� |j � | j
� dd�}t |�}| j
� |d�}|| p^d}|�
� |jdu r�|d kr�t�d
t�� |� t�|� |d8 }|�
� qh|jdu r�t�d t�� |j � t�|j tj� |�� \}}|jd ks�|�r
t�d t�� ||j|� |�r t�|�} nd} | S )
z0
Execute /task/ in a subprocess
T)�stdout�stderr�universal_newlinesz
%s:process:%ir� r� r� r* Nr z
%s:tick:%iz
%s:kill:%iz %s:%s:%s:%s)rQ �Popenrs �
executable�PIPEr� �debug� threading�
currentThread�pidr r� ro �poll�
returncode�time�sleepr� r< �kill�signal�SIGTERM� communicate�picklerc )
r� �task�processr� r� r� Zticksr� r� �retr# r# r$ �_subprocess_execution� s6 �
� zAgent._subprocess_executionc C s^ | j rt�dt�� � �q@t�dt�� | j�� � z| j�� }W n t yX Y �q@Y n0 t�dt�� |� t
|�}z| j � |d�}W n d}Y n0 t
�
� }t|t�r�| �|�}npz<| j�|| j� |g �i� |j| j| d�}|�| j �}W n2 t�y$ t�d� dtt�� d �i}Y n0 | j�|||||d
�� q | j �t�� � | j � � d S ) zW
Take queued execution requests, execute plugins and queue the results
� %s:shutdownz%s:exec_queue:%iz
%s:task:%sr� r� )Z agent_cacheZplugin_exception� exceptionr )�tsr� r� r� r� N) �shutdownr� r% r� r� r� �execute�qsize�
get_nowaitr ro r r! r� rj r r� r� �updater� r� r{ r� rh rs r� �metrics�put�cemetery�hire�release)r� r� r� r� r� r� rn r# r# r$ �
_execution� sF
�
�
zAgent._executionc C s t �dt�� � | j�dd�}| j�dd�}| j�dd�}| j�dd�}| j�dd�}| j�dd �}| j�dd
�}| j�dd �}g } g }
d } | r�d
}n| j�dd�}t�� } | jr�t �dt�� � �q t � dt�� | j
� � t |
�� | j
� � �r<z|
�
| j
�� � W q� t�y8 }
zt �d|
� W Y d}
~
q�d}
~
0 0 q�|
�r�tdd� |
D ��}tdd� |
D ��}t�� }d}|| |k�r�t � d� d }d}n || |k�r�t �d� d }d }|�r�d} dd||f d�}t � dtj|
d d d �� |�r�|�st �d � d }�n�zڐz<tjt�� d �}tjd k�r>t j j ||d!d"�}nt j ||d!d"�}| �r�t �d#t | �� | �r�|j d$d%|t!f | d& |d'� |�"� }|�#� |j$d(k�r�| d&= t � d)|j$� nt%d*|j$ ���qdt �d+� |j d$d%|t!f t&�'t(t�|
�d, ��)� �|d'� |�"� }|�#� |j$d(k�r8t � d)|j$� d }nt%d*|j$ ��W n� t�y� }
ztt �d-|
� |d&k�r�t | �|k�r�| d&= t �d.|� t �d/� | �
t&�'t(t�|
�d, ��)� �� g }
W Y d}
~
n
d}
~
0 0 W |�*� n
|�*� 0 |�r�g }
|t�� | }|d&kr�t�+|� q�dS )0zA
Take and collect data, send and clean if needed
z%sr/ r� r� r r� r� r r1 r� r� Tr� r� z %s:data_queue:%i:collection:%izData queue error: %sNc s s | ]}|d V qdS �r� Nr# ��.0r� r# r# r$ � <genexpr>' � z Agent._data.<locals>.<genexpr>c s s | ]}|d V qdS r� r# r� r# r# r$ r� ( r� Fz
Max data spanz Max data agezapplication/jsonz ApiKey %s:%s)z Content-type�
Authorizationzcollection: %sr+ rp z&Empty server or user, nowhere to send.)�cafiler � )�context�timeoutz Sending cached collections: %i�PUTz
%s?version=%sr )�headers�� zSuccessful response: %szUnsuccessful response: %szAll cached collections sentr z Failed to submit collection: %szCReach max_cached_collections (%s): oldest cached collection droppedz,Cache current collection to resend next time),r� r% r� r� r r! r� r� r� r� r/ r� r; rU r� r{ r� �min�max�warningrb r� �ssl�create_default_context�certifi�wherers ru �http�client�HTTPSConnection�httplib�requestr � getresponserF �status�
ValueError�bz2�compressrh rE r� r� )r� r� r� Zmax_ageZmax_spanr r1 r� r� Zcached_collectionsZ
collectionZ initial_dataZloop_tsr� Zfirst_tsZlast_ts�now�send�cleanr� �ctx�
connectionrg �sleep_intervalr# r# r$ �_data s� � &
��
�
�
�
" z Agent._datac C s t �d� tj| jd��� dS )z/
Initialize data worker thread
r� ��targetN)r� r% r� �Threadr �startr� r# r# r$ r� x s
zAgent._data_worker_initc C s< t jdkrt�� }nt�� }| j�|� t�d|�� � dS )z,
Dumps configuration object
r z
Config: %sN) rs ru �io�StringIOr rJ r� r% �getvalue)r� �bufr# r# r$ r� s
zAgent._dump_configr c C s� | � � }g }t�tj�|d��D ]b}t|�}|dkr6q | �|� |dkrb| j�|d�r�|� |� q |dkr | j�|d�s |� |� q |S )z0
Return list with plugins names
r� r� r �disabled)
r r� r< r= r ro r� r r� rU )r� r r" r� r� r� r# r# r$ r � s
zAgent._get_pluginsc C sR t �d| j�� � z| j�� }W n ty6 Y qNY n0 t �d|� |�� qdS )zb
Join with dead workers
Workaround for https://bugs.python.org/issue37788
z cemetery:%iz
joining:%sN)r� r� r� r� r� r r )r� �threadr# r# r$ �_rip� s
z
Agent._ripc s� t �d� | j�dd�}t�| j�dd��| _�z�| �� t � � � t �
dt� � � | j �
� r�| j �� }|d }t �
d|� |�d �}|r�t� �| j�|d� | j|< t|tj�r�|j|d < | j�|� qR� fd
d �| j�� D �}|D ]�}t �
d |� | j|= | j�|� | j�d
��rrz&tj| j d�}|� � t �
d|� W n2 t �yn } zt � d|� W Y d}~n
d}~0 0 q�t � d� | j �� dd| j�dd�id�� q�dt � � � }|dk�r�t � |� q2t � d� t � d� q2W n� t!�y� t � t"�#� d � t �d� | �� d} | �r�t�$� }
t �d |
� d d � |
D �} | �sXt �d � t"�%d� d| _&t �d t'| �� | D ] }t �d ||� |�(|� �qr�qY n4 t �y� } zt �)d!| � W Y d}~n
d}~0 0 dS )"z.
Start all the worker threads
zAgent main loopr r� r� r� z
%i threadsr� z
metrics:%sr� c s g | ]\}}|� kr|�qS r# r# )r� �what�when�r
r# r$ �
<listcomp>� s �z Agent.run.<locals>.<listcomp>z
scheduling:%sFr z new_execution_worker_thread:%sz Can not start new thread: %sNZthreads_cappedZagent_internalZthreads_capping)r� r� r� r� r z'not enough time to start worker threadsg�������?z
Shutting downTzRemaining threads: %sc S s$ g | ] }|� � st|tj�s|�qS r# )�isDaemonrj r� � _MainThread)r� r r# r# r$ r � s �zBye!z Waiting for %i threads to exitzJoining with %s/%fzWorker error: %s)*r� r% r �getfloatr� � Semaphorer� r� r r� r� � activeCountr� r� r� r! r9 r� rj �types�
ModuleType�__file__r/ r� �itemsr� �acquirer r� r r{ r� r� �KeyboardInterruptrs r� � enumerate�exitr� r; r r� ) r� r� r� r� rn r� r r� r �wait_forZ all_threadsr# r r$ r� � s�
�
�
� $
��
�
z Agent.runN)F)r )rm �
__module__� __qualname__r r� r� r/ r� r� r� r r� r� r� r� r� r� r r� r� r r r� r# r# r# r$ r s&
)!, /r
r c C sl t tj�dk�r^tjd �d�r8tjd dd � tjd< tjd dkr^td�d�� t�� n�tjd dkr�tt� � t�� n�tjd dkr�tt� t�� n�tjd d kr�tjd= t�t � � n�tjd d
kr�tjd= t�t
� � nttjd d k�rtjd= t�t d d
�� nJtjd dk�r<t�t tjdd � �� n tdtjd tj d� t�d� n
t
� �� d S )Nr* z--r+ r' r )z!Run without options to run agent.z,Acceptable options (leading -- is optional):z4 help, info, version, hello, insecure-hello, testr% �versionrO z
count-domainszinsecure-hellor )rK �testzInvalid option:)�file)r; rs �argv�
startswithrH r r, r% r rO ri r� r� r r� r# r# r# r$ �main s4
r5 �__main__)r& )D�
__future__r r rs ru Z
past.builtinsr � ImportErrorrh r� � http.clientr �queuer r r r� r r �importlib.utilrv ry r� r� r� rb Z
simplejsonr� r< r� r� rC rQ r� r� r% �optparser
� urllib.parser r �urllib.requestr
r � urllib.errorr �urllib�urllib2r r= �dirname�abspathr' r> r r� r� r% rO rZ r_ r? ri ro r� r r5 rm r# r# r# r$ �<module> s�
� �
8! 0 i$
PK �Fu\��IR� � $ libpasteurize/fixes/fix_unpacking.pynu �[��� u"""
Fixer for:
(a,)* *b (,c)* [,] = s
for (a,)* *b (,c)* [,] in d: ...
"""
from lib2to3 import fixer_base
from itertools import count
from lib2to3.fixer_util import (Assign, Comma, Call, Newline, Name,
Number, token, syms, Node, Leaf)
from libfuturize.fixer_util import indentation, suitify, commatize
# from libfuturize.fixer_util import Assign, Comma, Call, Newline, Name, Number, indentation, suitify, commatize, token, syms, Node, Leaf
def assignment_source(num_pre, num_post, LISTNAME, ITERNAME):
u"""
Accepts num_pre and num_post, which are counts of values
before and after the starg (not including the starg)
Returns a source fit for Assign() from fixer_util
"""
children = []
try:
pre = unicode(num_pre)
post = unicode(num_post)
except NameError:
pre = str(num_pre)
post = str(num_post)
# This code builds the assignment source from lib2to3 tree primitives.
# It's not very readable, but it seems like the most correct way to do it.
if num_pre > 0:
pre_part = Node(syms.power, [Name(LISTNAME), Node(syms.trailer, [Leaf(token.LSQB, u"["), Node(syms.subscript, [Leaf(token.COLON, u":"), Number(pre)]), Leaf(token.RSQB, u"]")])])
children.append(pre_part)
children.append(Leaf(token.PLUS, u"+", prefix=u" "))
main_part = Node(syms.power, [Leaf(token.LSQB, u"[", prefix=u" "), Name(LISTNAME), Node(syms.trailer, [Leaf(token.LSQB, u"["), Node(syms.subscript, [Number(pre) if num_pre > 0 else Leaf(1, u""), Leaf(token.COLON, u":"), Node(syms.factor, [Leaf(token.MINUS, u"-"), Number(post)]) if num_post > 0 else Leaf(1, u"")]), Leaf(token.RSQB, u"]"), Leaf(token.RSQB, u"]")])])
children.append(main_part)
if num_post > 0:
children.append(Leaf(token.PLUS, u"+", prefix=u" "))
post_part = Node(syms.power, [Name(LISTNAME, prefix=u" "), Node(syms.trailer, [Leaf(token.LSQB, u"["), Node(syms.subscript, [Node(syms.factor, [Leaf(token.MINUS, u"-"), Number(post)]), Leaf(token.COLON, u":")]), Leaf(token.RSQB, u"]")])])
children.append(post_part)
source = Node(syms.arith_expr, children)
return source
class FixUnpacking(fixer_base.BaseFix):
PATTERN = u"""
expl=expr_stmt< testlist_star_expr<
pre=(any ',')*
star_expr< '*' name=NAME >
post=(',' any)* [','] > '=' source=any > |
impl=for_stmt< 'for' lst=exprlist<
pre=(any ',')*
star_expr< '*' name=NAME >
post=(',' any)* [','] > 'in' it=any ':' suite=any>"""
def fix_explicit_context(self, node, results):
pre, name, post, source = (results.get(n) for n in (u"pre", u"name", u"post", u"source"))
pre = [n.clone() for n in pre if n.type == token.NAME]
name.prefix = u" "
post = [n.clone() for n in post if n.type == token.NAME]
target = [n.clone() for n in commatize(pre + [name.clone()] + post)]
# to make the special-case fix for "*z, = ..." correct with the least
# amount of modification, make the left-side into a guaranteed tuple
target.append(Comma())
source.prefix = u""
setup_line = Assign(Name(self.LISTNAME), Call(Name(u"list"), [source.clone()]))
power_line = Assign(target, assignment_source(len(pre), len(post), self.LISTNAME, self.ITERNAME))
return setup_line, power_line
def fix_implicit_context(self, node, results):
u"""
Only example of the implicit context is
a for loop, so only fix that.
"""
pre, name, post, it = (results.get(n) for n in (u"pre", u"name", u"post", u"it"))
pre = [n.clone() for n in pre if n.type == token.NAME]
name.prefix = u" "
post = [n.clone() for n in post if n.type == token.NAME]
target = [n.clone() for n in commatize(pre + [name.clone()] + post)]
# to make the special-case fix for "*z, = ..." correct with the least
# amount of modification, make the left-side into a guaranteed tuple
target.append(Comma())
source = it.clone()
source.prefix = u""
setup_line = Assign(Name(self.LISTNAME), Call(Name(u"list"), [Name(self.ITERNAME)]))
power_line = Assign(target, assignment_source(len(pre), len(post), self.LISTNAME, self.ITERNAME))
return setup_line, power_line
def transform(self, node, results):
u"""
a,b,c,d,e,f,*g,h,i = range(100) changes to
_3to2list = list(range(100))
a,b,c,d,e,f,g,h,i, = _3to2list[:6] + [_3to2list[6:-2]] + _3to2list[-2:]
and
for a,b,*c,d,e in iter_of_iters: do_stuff changes to
for _3to2iter in iter_of_iters:
_3to2list = list(_3to2iter)
a,b,c,d,e, = _3to2list[:2] + [_3to2list[2:-2]] + _3to2list[-2:]
do_stuff
"""
self.LISTNAME = self.new_name(u"_3to2list")
self.ITERNAME = self.new_name(u"_3to2iter")
expl, impl = results.get(u"expl"), results.get(u"impl")
if expl is not None:
setup_line, power_line = self.fix_explicit_context(node, results)
setup_line.prefix = expl.prefix
power_line.prefix = indentation(expl.parent)
setup_line.append_child(Newline())
parent = node.parent
i = node.remove()
parent.insert_child(i, power_line)
parent.insert_child(i, setup_line)
elif impl is not None:
setup_line, power_line = self.fix_implicit_context(node, results)
suitify(node)
suite = [k for k in node.children if k.type == syms.suite][0]
setup_line.prefix = u""
power_line.prefix = suite.children[1].value
suite.children[2].prefix = indentation(suite.children[2])
suite.insert_child(2, Newline())
suite.insert_child(2, power_line)
suite.insert_child(2, Newline())
suite.insert_child(2, setup_line)
results.get(u"lst").replace(Name(self.ITERNAME, prefix=u" "))
PK �Fu\�{�� � # libpasteurize/fixes/fix_division.pynu �[��� u"""
Fixer for division: from __future__ import division if needed
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import token, future_import
def match_division(node):
u"""
__future__.division redefines the meaning of a single slash for division,
so we match that and only that.
"""
slash = token.SLASH
return node.type == slash and not node.next_sibling.type == slash and \
not node.prev_sibling.type == slash
class FixDivision(fixer_base.BaseFix):
run_order = 4 # this seems to be ignored?
def match(self, node):
u"""
Since the tree needs to be fixed once and only once if and only if it
matches, then we can start discarding matches after we make the first.
"""
return match_division(node)
def transform(self, node, results):
future_import(u"division", node)
PK �Fu\�g � � ( libpasteurize/fixes/fix_printfunction.pynu �[��� u"""
Fixer for print: from __future__ import print_function.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import future_import
class FixPrintfunction(fixer_base.BaseFix):
# explicit = True
PATTERN = u"""
power< 'print' trailer < '(' any* ')' > any* >
"""
def transform(self, node, results):
future_import(u"print_function", node)
PK �Fu\�}'�s
s
# libpasteurize/fixes/fix_features.pynu �[��� u"""
Warn about features that are not present in Python 2.5, giving a message that
points to the earliest version of Python 2.x (or 3.x, if none) that supports it
"""
from .feature_base import Feature, Features
from lib2to3 import fixer_base
FEATURES = [
#(FeatureName,
# FeaturePattern,
# FeatureMinVersion,
#),
(u"memoryview",
u"power < 'memoryview' trailer < '(' any* ')' > any* >",
u"2.7",
),
(u"numbers",
u"""import_from< 'from' 'numbers' 'import' any* > |
import_name< 'import' ('numbers' dotted_as_names< any* 'numbers' any* >) >""",
u"2.6",
),
(u"abc",
u"""import_name< 'import' ('abc' dotted_as_names< any* 'abc' any* >) > |
import_from< 'from' 'abc' 'import' any* >""",
u"2.6",
),
(u"io",
u"""import_name< 'import' ('io' dotted_as_names< any* 'io' any* >) > |
import_from< 'from' 'io' 'import' any* >""",
u"2.6",
),
(u"bin",
u"power< 'bin' trailer< '(' any* ')' > any* >",
u"2.6",
),
(u"formatting",
u"power< any trailer< '.' 'format' > trailer< '(' any* ')' > >",
u"2.6",
),
(u"nonlocal",
u"global_stmt< 'nonlocal' any* >",
u"3.0",
),
(u"with_traceback",
u"trailer< '.' 'with_traceback' >",
u"3.0",
),
]
class FixFeatures(fixer_base.BaseFix):
run_order = 9 # Wait until all other fixers have run to check for these
# To avoid spamming, we only want to warn for each feature once.
features_warned = set()
# Build features from the list above
features = Features([Feature(name, pattern, version) for \
name, pattern, version in FEATURES])
PATTERN = features.PATTERN
def match(self, node):
to_ret = super(FixFeatures, self).match(node)
# We want the mapping only to tell us the node's specific information.
try:
del to_ret[u'node']
except Exception:
# We want it to delete the 'node' from the results
# if it's there, so we don't care if it fails for normal reasons.
pass
return to_ret
def transform(self, node, results):
for feature_name in results:
if feature_name in self.features_warned:
continue
else:
curr_feature = self.features[feature_name]
if curr_feature.version >= u"3":
fail = self.cannot_convert
else:
fail = self.warning
fail(node, reason=curr_feature.message_text())
self.features_warned.add(feature_name)
PK �Fu\�5�i i ! libpasteurize/fixes/fix_getcwd.pynu �[��� u"""
Fixer for os.getcwd() -> os.getcwdu().
Also warns about "from os import getcwd", suggesting the above form.
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name
class FixGetcwd(fixer_base.BaseFix):
PATTERN = u"""
power< 'os' trailer< dot='.' name='getcwd' > any* >
|
import_from< 'from' 'os' 'import' bad='getcwd' >
"""
def transform(self, node, results):
if u"name" in results:
name = results[u"name"]
name.replace(Name(u"getcwdu", prefix=name.prefix))
elif u"bad" in results:
# Can't convert to getcwdu and then expect to catch every use.
self.cannot_convert(node, u"import os, use os.getcwd() instead.")
return
else:
raise ValueError(u"For some reason, the pattern matcher failed.")
PK �Fu\a ��� � 3 libpasteurize/fixes/fix_add_all__future__imports.pynu �[��� """
Fixer for adding:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
This is done when converting from Py3 to both Py3/Py2.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import future_import
class FixAddAllFutureImports(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 1
def transform(self, node, results):
future_import(u"absolute_import", node)
future_import(u"division", node)
future_import(u"print_function", node)
future_import(u"unicode_literals", node)
PK �Fu\ k�4� � libpasteurize/fixes/__init__.pynu �[��� import sys
from lib2to3 import refactor
# The original set of these fixes comes from lib3to2 (https://bitbucket.org/amentajo/lib3to2):
fix_names = set([
'libpasteurize.fixes.fix_add_all__future__imports', # from __future__ import absolute_import etc. on separate lines
'libpasteurize.fixes.fix_add_future_standard_library_import', # we force adding this import for now, even if it doesn't seem necessary to the fix_future_standard_library fixer, for ease of testing
# 'libfuturize.fixes.fix_order___future__imports', # consolidates to a single line to simplify testing -- UNFINISHED
'libpasteurize.fixes.fix_future_builtins', # adds "from future.builtins import *"
'libfuturize.fixes.fix_future_standard_library', # adds "from future import standard_library"
'libpasteurize.fixes.fix_annotations',
# 'libpasteurize.fixes.fix_bitlength', # ints have this in Py2.7
# 'libpasteurize.fixes.fix_bool', # need a decorator or Mixin
# 'libpasteurize.fixes.fix_bytes', # leave bytes as bytes
# 'libpasteurize.fixes.fix_classdecorator', # available in
# Py2.6+
# 'libpasteurize.fixes.fix_collections', hmmm ...
# 'libpasteurize.fixes.fix_dctsetcomp', # avail in Py27
'libpasteurize.fixes.fix_division', # yes
# 'libpasteurize.fixes.fix_except', # avail in Py2.6+
# 'libpasteurize.fixes.fix_features', # ?
'libpasteurize.fixes.fix_fullargspec',
# 'libpasteurize.fixes.fix_funcattrs',
'libpasteurize.fixes.fix_getcwd',
'libpasteurize.fixes.fix_imports', # adds "from future import standard_library"
'libpasteurize.fixes.fix_imports2',
# 'libpasteurize.fixes.fix_input',
# 'libpasteurize.fixes.fix_int',
# 'libpasteurize.fixes.fix_intern',
# 'libpasteurize.fixes.fix_itertools',
'libpasteurize.fixes.fix_kwargs', # yes, we want this
# 'libpasteurize.fixes.fix_memoryview',
# 'libpasteurize.fixes.fix_metaclass', # write a custom handler for
# this
# 'libpasteurize.fixes.fix_methodattrs', # __func__ and __self__ seem to be defined on Py2.7 already
'libpasteurize.fixes.fix_newstyle', # yes, we want this: explicit inheritance from object. Without new-style classes in Py2, super() will break etc.
# 'libpasteurize.fixes.fix_next', # use a decorator for this
# 'libpasteurize.fixes.fix_numliterals', # prob not
# 'libpasteurize.fixes.fix_open', # huh?
# 'libpasteurize.fixes.fix_print', # no way
'libpasteurize.fixes.fix_printfunction', # adds __future__ import print_function
# 'libpasteurize.fixes.fix_raise_', # TODO: get this working!
# 'libpasteurize.fixes.fix_range', # nope
# 'libpasteurize.fixes.fix_reduce',
# 'libpasteurize.fixes.fix_setliteral',
# 'libpasteurize.fixes.fix_str',
# 'libpasteurize.fixes.fix_super', # maybe, if our magic super() isn't robust enough
'libpasteurize.fixes.fix_throw', # yes, if Py3 supports it
# 'libpasteurize.fixes.fix_unittest',
'libpasteurize.fixes.fix_unpacking', # yes, this is useful
# 'libpasteurize.fixes.fix_with' # way out of date
])
PK �Fu\mg_K K libpasteurize/fixes/fix_raise.pynu �[��� u"""Fixer for 'raise E(V).with_traceback(T)' -> 'raise E, V, T'"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Comma, Node, Leaf, token, syms
class FixRaise(fixer_base.BaseFix):
PATTERN = u"""
raise_stmt< 'raise' (power< name=any [trailer< '(' val=any* ')' >]
[trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' >] > | any) ['from' chain=any] >"""
def transform(self, node, results):
name, val, trc = (results.get(u"name"), results.get(u"val"), results.get(u"trc"))
chain = results.get(u"chain")
if chain is not None:
self.warning(node, u"explicit exception chaining is not supported in Python 2")
chain.prev_sibling.remove()
chain.remove()
if trc is not None:
val = val[0] if val else Leaf(token.NAME, u"None")
val.prefix = trc.prefix = u" "
kids = [Leaf(token.NAME, u"raise"), name.clone(), Comma(),
val.clone(), Comma(), trc.clone()]
raise_stmt = Node(syms.raise_stmt, kids)
node.replace(raise_stmt)
PK �Fu\�x x # libpasteurize/fixes/fix_newstyle.pynu �[��� u"""
Fixer for "class Foo: ..." -> "class Foo(object): ..."
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import LParen, RParen, Name
from libfuturize.fixer_util import touch_import_top
def insert_object(node, idx):
node.insert_child(idx, RParen())
node.insert_child(idx, Name(u"object"))
node.insert_child(idx, LParen())
class FixNewstyle(fixer_base.BaseFix):
# Match:
# class Blah:
# and:
# class Blah():
PATTERN = u"classdef< 'class' NAME ['(' ')'] colon=':' any >"
def transform(self, node, results):
colon = results[u"colon"]
idx = node.children.index(colon)
if (node.children[idx-2].value == '(' and
node.children[idx-1].value == ')'):
del node.children[idx-2:idx]
idx -= 2
insert_object(node, idx)
touch_import_top(u'builtins', 'object', node)
PK �Fu\ ��C C libpasteurize/fixes/fix_throw.pynu �[��� u"""Fixer for 'g.throw(E(V).with_traceback(T))' -> 'g.throw(E, V, T)'"""
from lib2to3 import fixer_base
from lib2to3.pytree import Node, Leaf
from lib2to3.pgen2 import token
from lib2to3.fixer_util import Comma
class FixThrow(fixer_base.BaseFix):
PATTERN = u"""
power< any trailer< '.' 'throw' >
trailer< '(' args=power< exc=any trailer< '(' val=any* ')' >
trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' > > ')' > >
"""
def transform(self, node, results):
syms = self.syms
exc, val, trc = (results[u"exc"], results[u"val"], results[u"trc"])
val = val[0] if val else Leaf(token.NAME, u"None")
val.prefix = trc.prefix = u" "
kids = [exc.clone(), Comma(), val.clone(), Comma(), trc.clone()]
args = results[u"args"]
args.children = kids
PK �Fu\T�� � � B libpasteurize/fixes/__pycache__/fix_future_builtins.cpython-39.pycnu �[��� a
��?h� � @ sz d Z ddlmZ ddlmZ ddlmZ ddlm Z m
Z
m Z ddl m
Z
d�� Zd�d d
� eD ��ZG d d � d ej�Zd
S )zq
Adds this import line:
from builtins import XYZ
for each of the functions XYZ that is used in the module.
� )�unicode_literals)�
fixer_base)�python_symbols)�Name�Call�in_special_context)�touch_import_topz�filter map zip
ascii chr hex input next oct open round super
bytes dict int range str�|c C s g | ]}d � |��qS )z
name='{0}')�format)�.0�name� r
�Q/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_future_builtins.py�
<listcomp> � r c @ s& e Zd ZdZdZd�e�Zdd� ZdS )�FixFutureBuiltinsT� zs
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
c C s |d }t d|j|� d S )Nr �builtins)r �value)�self�node�resultsr r
r
r � transform+ s zFixFutureBuiltins.transformN) �__name__�
__module__� __qualname__Z
BM_compatibleZ run_orderr
�
expressionZPATTERNr r
r
r
r r s �r N)�__doc__�
__future__r Zlib2to3r Zlib2to3.pygramr ZsymsZlib2to3.fixer_utilr r r Zlibfuturize.fixer_utilr �splitZreplaced_builtins�joinr ZBaseFixr r
r
r
r �<module> s PK �Fu\C��� � 9 libpasteurize/fixes/__pycache__/fix_raise_.cpython-39.pycnu �[��� a
��?h� � @ sB d Z ddlmZ ddlmZmZmZmZmZ G dd� dej �Z
dS )z�Fixer for
raise E(V).with_traceback(T)
to:
from future.utils import raise_
...
raise_(E, V, T)
TODO: FIXME!!
� )�
fixer_base)�Comma�Node�Leaf�token�symsc @ s e Zd ZdZdd� ZdS )�FixRaisez�
raise_stmt< 'raise' (power< name=any [trailer< '(' val=any* ')' >]
[trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' >] > | any) ['from' chain=any] >c C s� t |�d�|�d�|�d� }}}|�d�}|d urV| �|d� |j�� |�� |d ur�|rj|d n
ttjd�}d |_|_ttjd �|� � t
� |� � t
� |� � g}t t j
|�}|�|� d S )
N�name�val�trc�chainz8explicit exception chaining is not supported in Python 2r �None� �raise)ZFIXME�get�warningZ prev_sibling�remover r �NAME�prefix�cloner r r �
raise_stmt�replace) �self�node�resultsr r
r r Zkidsr � r �H/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_raise_.py� transform s "
� zFixRaise.transformN)�__name__�
__module__� __qualname__ZPATTERNr r r r r r s r N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r r ZBaseFixr r r r r �<module> s PK �Fu\`��+� � ; libpasteurize/fixes/__pycache__/fix_features.cpython-39.pycnu �[��� a
��?hs
� @ s> d Z ddlmZmZ ddlmZ g d�ZG dd� dej�ZdS ) z�
Warn about features that are not present in Python 2.5, giving a message that
points to the earliest version of Python 2.x (or 3.x, if none) that supports it
� )�Feature�Features� )�
fixer_base))�
memoryviewz4power < 'memoryview' trailer < '(' any* ')' > any* >z2.7)Znumbersz�import_from< 'from' 'numbers' 'import' any* > |
import_name< 'import' ('numbers' dotted_as_names< any* 'numbers' any* >) >�2.6)�abczyimport_name< 'import' ('abc' dotted_as_names< any* 'abc' any* >) > |
import_from< 'from' 'abc' 'import' any* >r )�iozvimport_name< 'import' ('io' dotted_as_names< any* 'io' any* >) > |
import_from< 'from' 'io' 'import' any* >r )�binz+power< 'bin' trailer< '(' any* ')' > any* >r )Z
formattingz<power< any trailer< '.' 'format' > trailer< '(' any* ')' > >r )�nonlocalz global_stmt< 'nonlocal' any* >�3.0)�with_tracebackz trailer< '.' 'with_traceback' >r c sF e Zd ZdZe� Zedd� eD ��Zej Z � fdd�Z
dd� Z � Z S )� FixFeatures� c C s g | ]\}}}t |||��qS � )r )�.0�name�pattern�versionr r �J/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_features.py�
<listcomp>; s �zFixFeatures.<listcomp>c s2 t t| ��|�}z
|d= W n ty, Y n0 |S )N�node)�superr �match� Exception)�selfr Zto_ret�� __class__r r r @ s
zFixFeatures.matchc C sZ |D ]P}|| j v rqq| j| }|jdkr2| j}n| j}|||�� d� | j �|� qd S )N�3)�reason)�features_warned�featuresr Zcannot_convert�warningZ message_text�add)r r �resultsZ feature_nameZ curr_featureZfailr r r � transformK s
zFixFeatures.transform)
�__name__�
__module__� __qualname__Z run_order�setr r �FEATURESr! ZPATTERNr r% �
__classcell__r r r r r 3 s � r N) �__doc__Z feature_baser r Zlib2to3r r* ZBaseFixr r r r r �<module> s *PK �Fu\Y��. K libpasteurize/fixes/__pycache__/fix_add_all__future__imports.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )z�
Fixer for adding:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
This is done when converting from Py3 to both Py3/Py2.
� )�
fixer_base��
future_importc @ s e Zd ZdZdZdZdd� ZdS )�FixAddAllFutureImportsTZ
file_input� c C s, t d|� t d|� t d|� t d|� d S )N�absolute_import�division�print_function�unicode_literalsr )�self�node�results� r �Z/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_add_all__future__imports.py� transform s
z FixAddAllFutureImports.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr r r r r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r r r r �<module> s PK �Fu\�6u�8 8 7 libpasteurize/fixes/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h� � @ s$ d dl Z d dlmZ eg d��ZdS )� N)�refactor)z0libpasteurize.fixes.fix_add_all__future__importsz:libpasteurize.fixes.fix_add_future_standard_library_importz'libpasteurize.fixes.fix_future_builtinsz-libfuturize.fixes.fix_future_standard_libraryz#libpasteurize.fixes.fix_annotationsz libpasteurize.fixes.fix_divisionz#libpasteurize.fixes.fix_fullargspecz libpasteurize.fixes.fix_getcwdz libpasteurize.fixes.fix_importsz libpasteurize.fixes.fix_imports2z libpasteurize.fixes.fix_kwargsz libpasteurize.fixes.fix_newstylez%libpasteurize.fixes.fix_printfunctionz libpasteurize.fixes.fix_throwz!libpasteurize.fixes.fix_unpacking)�sysZlib2to3r �setZ fix_names� r r �F/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/__init__.py�<module> s PK �Fu\��<9 9 ; libpasteurize/fixes/__pycache__/fix_division.cpython-39.pycnu �[��� a
��?h� � @ s> d Z ddlmZ ddlmZmZ dd� ZG dd� dej�ZdS ) z?
Fixer for division: from __future__ import division if needed
� )�
fixer_base)�token�
future_importc C s, t j}| j|ko*| jj|k o*| jj|k S )zw
__future__.division redefines the meaning of a single slash for division,
so we match that and only that.
)r �SLASH�typeZ next_siblingZ prev_sibling)�nodeZslash� r �J/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_division.py�match_division s �r
c @ s e Zd ZdZdd� Zdd� ZdS )� FixDivision� c C s t |�S )z�
Since the tree needs to be fixed once and only once if and only if it
matches, then we can start discarding matches after we make the first.
)r
)�selfr r r r �match s zFixDivision.matchc C s t d|� d S )N�division)r )r
r �resultsr r r � transform s zFixDivision.transformN)�__name__�
__module__� __qualname__Z run_orderr r r r r r r s r N) �__doc__Zlib2to3r Zlibfuturize.fixer_utilr r r
ZBaseFixr r r r r �<module> s PK �Fu\���=� � J libpasteurize/fixes/__pycache__/fix_add_all_future_builtins.cpython-39.pycnu �[��� a
��?h� � @ s> d Z ddlmZ ddlmZ ddlmZ G dd� dej�ZdS )a�
For the ``future`` package.
Adds this import line::
from builtins import (ascii, bytes, chr, dict, filter, hex, input,
int, list, map, next, object, oct, open, pow,
range, round, str, super, zip)
to a module, irrespective of whether each definition is used.
Adds these imports after any other imports (in an initial block of them).
� )�unicode_literals)�
fixer_base��touch_import_topc @ s e Zd ZdZdZdZdd� ZdS )�FixAddAllFutureBuiltinsTZ
file_input� c C s t dd|� d S )N�builtins�*r )�self�node�results� r
�Y/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_add_all_future_builtins.py� transform s z!FixAddAllFutureBuiltins.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr r
r
r
r r s r N) �__doc__�
__future__r Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK �Fu\$�J J : libpasteurize/fixes/__pycache__/fix_imports.cpython-39.pycnu �[��� a
��?h� � # @ s� d Z ddlmZ ddlmZmZmZmZ ddlm Z
ddl m Z ddl
mZmZ ddlmZ dd d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*�"Zd+Zd,Zd-Zd.Zd/Zd0Zd1Zd2Zd3Zd4Z d5d6� Z G d7d8� d8ej �Z d9S ):z8
Fixer for standard library imports renamed in Python 3
� )�
fixer_base)�Name�is_probably_builtin�Newline�does_tree_import)�python_symbols)�token)�Node�Leaf��touch_import_top�repr�_winreg� ConfigParser�copy_regz"multiprocessing.queues.SimpleQueue�Queue� SocketServer�
markupbaseztest.test_support�dbhash�dbm�dumbdbm�gdbm�
HTMLParser�htmlentitydefs�httplib�Cookie� cookielib�DialogZFixTk� ScrolledText�Tix� Tkconstants�Tkdnd�Tkinter�tkColorChooser�tkCommonDialog�tkFont�ttk� tkMessageBoxZturtle� robotparser� xmlrpclib� __builtin__)"�reprlib�winreg� configparser�copyregzmultiprocessing.SimpleQueue�queue� socketserver� _markupbasez test.supportzdbm.bsdzdbm.ndbmzdbm.dumbzdbm.gnuz html.parserz
html.entitiesz http.clientz http.cookieszhttp.cookiejarztkinter.dialogz tkinter._fixztkinter.scrolledtextz tkinter.tixztkinter.constantsz tkinter.dndztkinter.__init__ztkinter.colorchooserztkinter.commondialogz tkinter.fontz tkinter.ttkztkinter.messageboxztkinter.turtlezurllib.robotparserz
xmlrpc.client�builtinsz name='%s'z attr='%s'z$dotted_name=dotted_name< %s '.' %s >z%sz"power< %s trailer< '.' %s > any* >zpower< %s any* >z:from_import=import_from< 'from' %s 'import' imported=any >z�from_import_submod=import_from< 'from' %s 'import' (%s | import_as_name< %s 'as' renamed=any > | import_as_names< any* (%s | import_as_name< %s 'as' renamed=any >) any* > ) >zrname_import=import_name< 'import' %s > | name_import=import_name< 'import' dotted_as_name< %s 'as' renamed=any > >zAname_import=import_name< 'import' dotted_as_names< names=any* > >c
C s� d| v r�| � dd�\} }t| }t| }t||f }t| }t|||||f }t||f }t||f }t| } d� ||||| f�S t| }t||f }t| }t
| }d� |||f�S dS )z�
Accepts a string and returns a pattern of possible patterns involving that name
Called by simple_mapping_to_pattern for each name in the mapping it receives.
�.� � |
N) �split�simple_name_match�
subname_match�dotted_name_match�from_import_match�from_import_submod_match�name_import_match�power_twoname_match�power_subname_match�join�power_onename_match)
�name�attrZ simple_nameZ simple_attrZ dotted_nameZi_fromZ
i_from_submodZi_nameZu_nameZ u_subname� rC �I/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_imports.py� all_patternsP s rE c @ s6 e Zd Zd�dd� eD ��Zd�eef�Zdd� ZdS )�
FixImportsr5 c C s g | ] }t |��qS rC )rE )�.0rA rC rC rD �
<listcomp>m � zFixImports.<listcomp>c C s t dd|� d S )N�futureZstandard_libraryr )�self�node�resultsrC rC rD � transformp s zFixImports.transformN)�__name__�
__module__� __qualname__r? �MAPPINGZPATTERN�multiple_name_import_matchrN rC rC rC rD rF k s rF N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r Zlib2to3.pygramr ZsymsZ
lib2to3.pgen2r Zlib2to3.pytreer r
Zlibfuturize.fixer_utilr rR r7 r8 r9 r@ r= r> r: r; r< rS rE ZBaseFixrF rC rC rC rD �<module> sj �-PK �Fu\WY�� � ; libpasteurize/fixes/__pycache__/fix_newstyle.cpython-39.pycnu �[��� a
��?hx � @ sN d Z ddlmZ ddlmZmZmZ ddlmZ dd� Z G dd� dej
�Z d S )
z8
Fixer for "class Foo: ..." -> "class Foo(object): ..."
� )�
fixer_base)�LParen�RParen�Name)�touch_import_topc C s0 | � |t� � | � |td�� | � |t� � d S )N�object)Z insert_childr r r )�node�idx� r
�J/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_newstyle.py�
insert_object s r c @ s e Zd ZdZdd� ZdS )� FixNewstylez0classdef< 'class' NAME ['(' ')'] colon=':' any >c C sn |d }|j �|�}|j |d jdkrT|j |d jdkrT|j |d |�= |d8 }t||� tdd|� d S )N�colon� �(� �)�builtinsr )�children�index�valuer r )�selfr �resultsr r r
r
r � transform s �
zFixNewstyle.transformN)�__name__�
__module__� __qualname__ZPATTERNr r
r
r
r r
s r
N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r r Zlibfuturize.fixer_utilr r ZBaseFixr
r
r
r
r �<module> s
PK �Fu\�`��� � 8 libpasteurize/fixes/__pycache__/fix_throw.cpython-39.pycnu �[��� a
��?hC � @ sN d Z ddlmZ ddlmZmZ ddlmZ ddlm Z G dd� dej
�Z dS ) zAFixer for 'g.throw(E(V).with_traceback(T))' -> 'g.throw(E, V, T)'� )�
fixer_base)�Node�Leaf)�token)�Commac @ s e Zd ZdZdd� ZdS )�FixThrowz�
power< any trailer< '.' 'throw' >
trailer< '(' args=power< exc=any trailer< '(' val=any* ')' >
trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' > > ')' > >
c C sv | j }|d |d |d }}}|r.|d n
ttjd�}d |_|_|�� t� |�� t� |�� g}|d }||_d S )N�exc�val�trcr �None� �args)�symsr r �NAME�prefix�cloner �children) �self�node�resultsr r r r
Zkidsr
� r �G/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_throw.py� transform s zFixThrow.transformN)�__name__�
__module__� __qualname__ZPATTERNr r r r r r s r N) �__doc__Zlib2to3r Zlib2to3.pytreer r Z
lib2to3.pgen2r Zlib2to3.fixer_utilr ZBaseFixr r r r r �<module> s
PK �Fu\�!� @ libpasteurize/fixes/__pycache__/fix_printfunction.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )z9
Fixer for print: from __future__ import print_function.
� )�
fixer_base��
future_importc @ s e Zd ZdZdd� ZdS )�FixPrintfunctionzL
power< 'print' trailer < '(' any* ')' > any* >
c C s t d|� d S )N�print_functionr )�self�node�results� r
�O/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_printfunction.py� transform s zFixPrintfunction.transformN)�__name__�
__module__� __qualname__ZPATTERNr r
r
r
r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK �Fu\��LY� � 7 libpasteurize/fixes/__pycache__/fix_next.cpython-39.pycnu �[��� a
��?h� � @ sZ d Z ddlmZ ddlmZ ddlmZ ddlm Z m
Z
m Z m Z dZ
G dd� dej�Zd S )
z?
Fixer for:
it.__next__() -> it.next().
next(it) -> it.next().
� )�token)�python_symbols)�
fixer_base)�Name�Call� find_binding�Attrz;Calls to builtin next() possibly shadowed by global bindingc @ s e Zd ZdZdd� ZdS )�FixNextas
power< base=any+ trailer< '.' attr='__next__' > any* >
|
power< head='next' trailer< '(' arg=any ')' > any* >
|
classdef< 'class' base=any+ ':'
suite< any*
funcdef< 'def'
attr='__next__'
parameters< '(' NAME ')' > any+ >
any* > >
c C s� |sJ �|� d�}|� d�}|� d�}|� d�}|rh|�� }|�ttt|�|jd�td��� |�� n|r�|�td|jd�� d S )N�base�attr�head�arg)�prefix�next)�get�clone�replacer r �unicoder �remove)�self�node�resultsr
r r Zarg_r
� r �F/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_next.py� transform s
�
zFixNext.transformN)�__name__�
__module__� __qualname__ZPATTERNr r r r r r s
r N)�__doc__Z
lib2to3.pgen2r Zlib2to3.pygramr ZsymsZlib2to3r Zlib2to3.fixer_utilr r r r Z bind_warningZBaseFixr r r r r �<module> s PK �Fu\�BE. . 8 libpasteurize/fixes/__pycache__/fix_raise.cpython-39.pycnu �[��� a
��?hK � @ sB d Z ddlmZ ddlmZmZmZmZmZ G dd� dej �Z
dS )z;Fixer for 'raise E(V).with_traceback(T)' -> 'raise E, V, T'� )�
fixer_base)�Comma�Node�Leaf�token�symsc @ s e Zd ZdZdd� ZdS )�FixRaisez�
raise_stmt< 'raise' (power< name=any [trailer< '(' val=any* ')' >]
[trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' >] > | any) ['from' chain=any] >c C s� |� d�|� d�|� d� }}}|� d�}|d urR| �|d� |j�� |�� |d ur�|rf|d n
ttjd�}d |_|_ttjd �|�� t � |�� t � |�� g}t
t j |�}|�
|� d S )
N�name�val�trc�chainz8explicit exception chaining is not supported in Python 2r �None� �raise)�get�warningZ prev_sibling�remover r �NAME�prefix�cloner r r �
raise_stmt�replace) �self�node�resultsr r
r r Zkidsr � r �G/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_raise.py� transform s "
� zFixRaise.transformN)�__name__�
__module__� __qualname__ZPATTERNr r r r r r s r N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r r ZBaseFixr r r r r �<module> s PK Gu\��k� � > libpasteurize/fixes/__pycache__/fix_annotations.cpython-39.pycnu �[��� a
��?h- � @ sJ d Z ddlmZ ddlmZ ddlmZ dZdd� ZG dd � d ej �Z
d
S ) z&
Fixer to remove function annotations
� )�
fixer_base)�token)�symsz)Removing function annotations completely.c C s
| j d S )Nr )�children)�node� r �M/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_annotations.py�param_without_annotations s r c @ s$ e Zd ZdZdd� ZdZdd� ZdS )�FixAnnotationsFc C s | j sd| _ | j||d� d S )NT��reason)�warned�warning)�selfr r r r r � warn_once s zFixAnnotations.warn_oncezm
funcdef< 'def' any parameters< '(' [params=any] ')' > ['->' ret=any] ':' any* >
c C s� |� d�}|� d�}|durR|jjtjks2J d��| j|td� |j�� |�� |du r^dS |jtj kr�|j
D ],}|jtj krp| j|td� |� t
|�� qpn(|jtj kr�| j|td� |� t
|�� dS )zK
This just strips annotations from the funcdef completely.
�params�retNzInvalid return annotationr )�getZ prev_sibling�typer �RARROWr � warning_text�remover Z
typedargslistr Ztname�replacer )r r �resultsr r �paramr r r � transform s
zFixAnnotations.transformN)�__name__�
__module__� __qualname__r
r ZPATTERNr r r r r r
s r
N) �__doc__Zlib2to3r Z
lib2to3.pgen2r Zlib2to3.fixer_utilr r r ZBaseFixr
r r r r �<module> s PK Gu\ �Ʊ� � 9 libpasteurize/fixes/__pycache__/fix_kwargs.cpython-39.pycnu �[��� a
��?hg � @ s� d Z ddlmZ ddlmZmZmZmZmZ ddl m
Z
m Z m Z dZ
dZdZdZd d
� Zefd d �Zefd
d�ZG dd� dej�ZdS )zg
Fixer for Python 3 function parameter syntax
This fixer is rather sensitive to incorrect py3k syntax.
� )�
fixer_base)�token�String�Newline�Comma�Name)� indentation�suitify�
DoubleStarz=%(name)s = %(kwargs)s['%(name)s']; del %(kwargs)s['%(name)s']z'if '%(name)s' in %(kwargs)s: %(assign)sz else: %(name)s = %(default)sZ _3to2kwargsc c s� | d j tjkr t| �dks J �d}t| �}||k r�| | }|j}|j tjkrX|d7 }q,|durn|j tjkrnq�|j}|j}|dur�|j tj kr�|j}|d7 }nd}||fV |d7 }q,dS )z�
Generator that yields tuples of (name, default_value) for each parameter in the list
If no default is given, then it is default_value is None (not Leaf(token.NAME, 'None'))
r � � N)
�typer �STAR�lenZ prev_sibling�NAME�
DOUBLESTAR�valueZ next_sibling�EQUAL)�
raw_paramsZcurr_idxZmax_idxZ curr_itemZ prev_item�nameZnxt�
default_value� r �H/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_kwargs.py�
gen_params s&
r c C s� | d j tjksJ �| d j tjkrJ| d �� | d �� | dd� }n | dd� }|D ] }|j tjkrt|�� qZ dS qZdS )z�
Removes all keyword-only args from the params list and a bare star, if any.
Does not add the kwargs dict if needed.
Returns True if more action is needed, False if not
(more action is needed if no kwargs dict exists)
r r r N� FT)r
r r �COMMA�remover )r �kwargs_defaultZ kw_params�paramr r r �
remove_params+ s
r c C s~ d}d}| dd� D ]\}|j tjkr(qq|j tjkr>|s>d}q|j tjkr`|r`|rX|jnd S |j tjkrd}q|rz|S dS )z�
Returns string with the name of the kwargs dict if the params after the first star need fixing
Otherwise returns empty string
Fr NT� )r
r r r r r )r r Z found_kwargsZ needs_fix�tr r r � needs_fixingA s r" c @ s e Zd ZdZdZdd� ZdS )� FixKwargs� z^funcdef< 'def' NAME parameters< '(' arglist=typedargslist< params=any* > ')' > ':' suite=any >c
C s� |d }t |�D ]$\}}|jtjkr||d � } q:qd S t|�}|sJd S t|� |jd }|jd }t|�} t|�D ]�\}
} | d u r�|� dt
� � |� dt t |
|d� | d�� qv|� dt
� � |� dt t
|
| d� | d�� |� dt
� � |� dt tt |
|d� |
|d� | d�� qv| |_d|jd _t|�} | �r�|d }
t|
j�d
k�rr|
jd jtjk�rr|
�t� � |
�td d�� |
�t|�� d S )
N�params� r )r �kwargs)�prefix)r �default)Zassignr r' r �arglistr ���� )� enumerater
r r r" r �childrenr r Z insert_childr r �_assign_template�_else_template� _if_templater( r r r Z append_childr r
r )�self�node�resultsZparams_rawlist�i�itemZ
new_kwargsZsuiteZ
first_stmt�identr r Zmust_add_kwargsr* r r r � transform` s<
, $ zFixKwargs.transformN)�__name__�
__module__� __qualname__Z run_orderZPATTERNr8 r r r r r# Z s r# N)�__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r r Zlibfuturize.fixer_utilr r r
r/ r1 r0 Z_kwargs_default_namer r r" ZBaseFixr# r r r r �<module> s PK Gu\����� � U libpasteurize/fixes/__pycache__/fix_add_future_standard_library_import.cpython-39.pycnu �[��� a
��?h� � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )z�
For the ``future`` package.
Adds this import line:
from future import standard_library
after any __future__ imports but before any other imports. Doesn't actually
change the imports to Py3 style.
� )�
fixer_base��touch_import_topc @ s e Zd ZdZdZdZdd� ZdS )�!FixAddFutureStandardLibraryImportTZ
file_input� c C s t dd|� d S )N�futureZstandard_libraryr )�self�node�results� r �d/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_add_future_standard_library_import.py� transform s z+FixAddFutureStandardLibraryImport.transformN)�__name__�
__module__� __qualname__Z
BM_compatibleZPATTERNZ run_orderr
r r r r r s r N)�__doc__Zlib2to3r Zlibfuturize.fixer_utilr ZBaseFixr r r r r �<module> s PK Gu\�ƹ P P 9 libpasteurize/fixes/__pycache__/fix_getcwd.cpython-39.pycnu �[��� a
��?hi � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )zm
Fixer for os.getcwd() -> os.getcwdu().
Also warns about "from os import getcwd", suggesting the above form.
� )�
fixer_base)�Namec @ s e Zd ZdZdd� ZdS )� FixGetcwdz�
power< 'os' trailer< dot='.' name='getcwd' > any* >
|
import_from< 'from' 'os' 'import' bad='getcwd' >
c C sJ d|v r&|d }|� td|jd�� n d|v r>| �|d� d S td��d S )N�nameZgetcwdu)�prefix�badz#import os, use os.getcwd() instead.z,For some reason, the pattern matcher failed.)�replacer r Zcannot_convert�
ValueError)�self�node�resultsr � r
�H/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_getcwd.py� transform s zFixGetcwd.transformN)�__name__�
__module__� __qualname__ZPATTERNr r
r
r
r r s r N)�__doc__Zlib2to3r Zlib2to3.fixer_utilr ZBaseFixr r
r
r
r �<module> s PK Gu\$�@
@
; libpasteurize/fixes/__pycache__/feature_base.cpython-39.pycnu �[��� a
��?h� � @ s0 d Z dZdZG dd� de�ZG dd� de�ZdS )z�
Base classes for features that are backwards-incompatible.
Usage:
features = Features()
features.add(Feature("py3k_feature", "power< 'py3k' any* >", "2.7"))
PATTERN = features.PATTERN
z%s=%sz-
%s is only supported in Python %s and above.c @ s e Zd ZdZdd� Zdd� ZdS )�Featurez�
A feature has a name, a pattern, and a minimum version of Python 2.x
required to use the feature (or 3.x if there is no backwards-compatible
version of 2.x)
c C s || _ || _|| _d S )N)�name�_pattern�version)�selfr �PATTERNr � r �J/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/feature_base.py�__init__ s zFeature.__init__c C s t | j| jf S )zS
Format the above text with the name and minimum version required.
)�message_unformattedr r �r r r r � message_text s zFeature.message_textN)�__name__�
__module__� __qualname__�__doc__r r r r r r r s r c @ s0 e Zd ZdZi Zdd� Zedd� �Zdd� ZdS ) �Featuresz�
A set of features that generates a pattern for the features it contains.
This set will act like a mapping in that we map names to patterns.
c C s t dd� t| �D ��| _dS )zS
Called every time we care about the mapping of names to features.
c S s g | ]}|j |f�qS r )r ��.0�fr r r �
<listcomp>* � z+Features.update_mapping.<locals>.<listcomp>N)�dict�iter�mappingr r r r �update_mapping& s zFeatures.update_mappingc C s | � � d�dd� t| �D ��S )z{
Uses the mapping of names to features to return a PATTERN suitable
for using the lib2to3 patcomp.
z |
c S s g | ]}t |j|jf �qS r )�pattern_unformattedr r r r r r r 3 r z$Features.PATTERN.<locals>.<listcomp>)r �joinr r r r r r , s zFeatures.PATTERNc C s
| j | S )zH
Implement a simple mapping to get patterns from names.
)r )r �keyr r r � __getitem__5 s zFeatures.__getitem__N) r
r r r r r �propertyr r r r r r r s
r N)r r r
�objectr �setr r r r r �<module> s PK
Gu\�h?� � = libpasteurize/fixes/__pycache__/fix_memoryview.cpython-39.pycnu �[��� a
��?h' � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )zo
Fixer for memoryview(s) -> buffer(s).
Explicit because some memoryview methods are invalid on buffer objects.
� )�
fixer_base)�Namec @ s e Zd ZdZdZdd� ZdS )�
FixMemoryviewTzi
power< name='memoryview' trailer< '(' [any] ')' >
rest=any* >
c C s |d }|� td|jd�� d S )N�name�buffer)�prefix)�replacer r )�self�node�resultsr � r �L/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_memoryview.py� transform s zFixMemoryview.transformN)�__name__�
__module__� __qualname__�explicitZPATTERNr r r r r
r
s r N)�__doc__Zlib2to3r Zlib2to3.fixer_utilr ZBaseFixr r r r r
�<module> s PK Gu\Z�q�� � < libpasteurize/fixes/__pycache__/fix_metaclass.cpython-39.pycnu �[��� a
��?h� � @ sj d Z ddlmZ ddlmZmZmZmZmZm Z ddl
m Z ddl m
Z
mZ dd� ZG dd � d ej�Zd
S ) zn
Fixer for (metaclass=X) -> __metaclass__ = X
Some semantics (see PEP 3115) may be altered in the translation.� )�
fixer_base)�Name�syms�Node�Leaf�Newline� find_root)�token)� indentation�suitifyc
C s d }| j D � ]�}|j }|jtjkrd|d ttjd�krb|d ttjd�krb|d rb|g| } �qq
|jtjkr
|j D ]�}|r� q
|jtj kr�|}qvt|�t
krvd } }}|j D ]P} | ttjd�kr�| }q�|r�| ttjd�kr�| }q�|r�|r�| }||||f} qvq�qvq
|S )Nr � metaclass� �=� ) �children�typer �argumentr r �NAME�EQUALZarglist�COMMAr )
�parent�results�nodeZkids�child�comma�meta�equal�name�arg� r �K/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_metaclass.py�
has_metaclass s8 ��
r! c @ s e Zd ZdZdd� ZdS )� FixMetaclassz
classdef<any*>
c
C s� t |�}|sd S |D ] }|�� qttjd�}ttjddd�}|}d|_ttj |||g�}t
|� |j D ]p} | j tj
krh| j D ]X}
|
j tjkr~| j �|
�d } ttj|
j�} | �| | � | �| t� � | �| |� qhq~qhd S )N�
__metaclass__r � )�prefixr
)r! �remover r r r r% r r Zatomr r r Zsuite�INDENT�index�valueZ insert_childr )
�selfr r Z meta_resultsr �targetr r Z stmt_node�item�stmt�loc�identr r r � transform5 s(
zFixMetaclass.transformN)�__name__�
__module__� __qualname__ZPATTERNr0 r r r r r" / s r" N)�__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r r r Zlib2to3.pygramr Zlibfuturize.fixer_utilr
r r! ZBaseFixr" r r r r �<module> s $PK Gu\@7]�O O < libpasteurize/fixes/__pycache__/fix_unpacking.cpython-39.pycnu �[��� a
��?h� � @ s~ d Z ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
mZmZ ddlmZmZmZ dd� ZG dd � d ej�Zd
S ) zD
Fixer for:
(a,)* *b (,c)* [,] = s
for (a,)* *b (,c)* [,] in d: ...
� )�
fixer_base)�count)
�Assign�Comma�Call�Newline�Name�Number�token�syms�Node�Leaf)� indentation�suitify� commatizec C s� g }zt | �}t |�}W n" ty: t| �}t|�}Y n0 | dkr�ttjt|�ttjtt j
d�ttj tt j d�t
|�g�tt jd�g�g�}|�|� |�tt jddd�� ttjtt j
ddd�t|�ttjtt j
d�ttj | dkr�t
|�ntdd �tt j d�|dk�r&ttjtt jd
�t
|�g�ntdd �g�tt jd�tt jd�g�g�}|�|� |dk�r�|�tt jddd�� ttjt|dd�ttjtt j
d�ttj ttjtt jd
�t
|�g�tt j d�g�tt jd�g�g�} |�| � ttj|�}
|
S ) z�
Accepts num_pre and num_post, which are counts of values
before and after the starg (not including the starg)
Returns a source fit for Assign() from fixer_util
r �[�:�]�+� ��prefix� � �-)�unicode� NameError�strr r �powerr �trailerr
r
�LSQBZ subscript�COLONr �RSQB�append�PLUSZfactor�MINUSZ
arith_expr) Znum_preZnum_post�LISTNAME�ITERNAME�children�pre�postZpre_partZ main_partZ post_part�source� r, �K/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_unpacking.py�assignment_source s& J
�
b
r. c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � FixUnpackinga9
expl=expr_stmt< testlist_star_expr<
pre=(any ',')*
star_expr< '*' name=NAME >
post=(',' any)* [','] > '=' source=any > |
impl=for_stmt< 'for' lst=exprlist<
pre=(any ',')*
star_expr< '*' name=NAME >
post=(',' any)* [','] > 'in' it=any ':' suite=any>c
s� � fdd�dD �\}}}}dd� |D �}d|_ dd� |D �}dd� t||�� g | �D �}|�t� � d |_ tt| j�ttd
�|�� g��}t|t t
|�t
|�| j| j ��} || fS ) Nc 3 s | ]}� � |�V qd S �N��get��.0�n��resultsr, r- � <genexpr>7 � z4FixUnpacking.fix_explicit_context.<locals>.<genexpr>)r) �namer* r+ c S s g | ]}|j tjkr|�� �qS r, ��typer
�NAME�cloner3 r, r, r- �
<listcomp>8 r9 z5FixUnpacking.fix_explicit_context.<locals>.<listcomp>r c S s g | ]}|j tjkr|�� �qS r, r; r3 r, r, r- r? : r9 c S s g | ] }|� � �qS r, �r> r3 r, r, r- r? ; r9 r �list) r r r> r# r r r r& r r. �lenr' )
�self�noder7 r) r: r* r+ �target�
setup_line�
power_liner, r6 r- �fix_explicit_context6 s z!FixUnpacking.fix_explicit_contextc s� � fdd�dD �\}}}}dd� |D �}d|_ dd� |D �}dd� t||�� g | �D �}|�t� � |�� }d |_ tt| j�ttd
�t| j �g��} t|t
t |�t |�| j| j ��}
| |
fS ) z_
Only example of the implicit context is
a for loop, so only fix that.
c 3 s | ]}� � |�V qd S r0 r1 r3 r6 r, r- r8 I r9 z4FixUnpacking.fix_implicit_context.<locals>.<genexpr>)r) r: r* �itc S s g | ]}|j tjkr|�� �qS r, r; r3 r, r, r- r? J r9 z5FixUnpacking.fix_implicit_context.<locals>.<listcomp>r c S s g | ]}|j tjkr|�� �qS r, r; r3 r, r, r- r? L r9 c S s g | ] }|� � �qS r, r@ r3 r, r, r- r? M r9 r rA ) r r r> r# r r r r& r r' r. rB ) rC rD r7 r) r: r* rI rE r+ rF rG r, r6 r- �fix_implicit_contextD s " z!FixUnpacking.fix_implicit_contextc
C s@ | � d�| _| � d�| _|�d�|�d� }}|dur�| �||�\}}|j|_t|j�|_|�t � � |j}|�
� }|� ||� |� ||� n�|du�r<| � ||�\}}t
|� dd� |jD �d } d |_| jd
j|_t| jd �| jd _| � d t � � | � d |� | � d t � � | � d |� |�d ��t| jd
d�� dS )a�
a,b,c,d,e,f,*g,h,i = range(100) changes to
_3to2list = list(range(100))
a,b,c,d,e,f,g,h,i, = _3to2list[:6] + [_3to2list[6:-2]] + _3to2list[-2:]
and
for a,b,*c,d,e in iter_of_iters: do_stuff changes to
for _3to2iter in iter_of_iters:
_3to2list = list(_3to2iter)
a,b,c,d,e, = _3to2list[:2] + [_3to2list[2:-2]] + _3to2list[-2:]
do_stuff
Z _3to2listZ _3to2iter�expl�implNc S s g | ]}|j tjkr|�qS r, )r< r �suite)r4 �kr, r, r- r? t r9 z*FixUnpacking.transform.<locals>.<listcomp>r r r � �lstr r )�new_namer& r' r2 rH r r �parentZ append_childr �removeZ insert_childrJ r r( �value�replacer )
rC rD r7 rK rL rF rG rR �irM r, r, r- � transformW s0
zFixUnpacking.transformN)�__name__�
__module__� __qualname__ZPATTERNrH rJ rW r, r, r, r- r/ * s
r/ N)�__doc__Zlib2to3r � itertoolsr Zlib2to3.fixer_utilr r r r r r r
r r r
Zlibfuturize.fixer_utilr r r r. ZBaseFixr/ r, r, r, r- �<module> s 0 PK Gu\�oƺq q ; libpasteurize/fixes/__pycache__/fix_imports2.cpython-39.pycnu �[��� a
��?h�! � @ s� d Z ddlmZ ddlmZmZmZmZmZ ddl m
Z
dZ dddd d
d d d
de d de d e d ddd�Z dddddddd d �Z
d Zd Zd Zd!Zd"Zd#Zd$Zd%Zd&Zd'Zd(d)� Zd*d+� ZG d,d-� d-ej�Zd.S )/z
Fixer for complicated imports
� )�
fixer_base)�Name�String�
FromImport�Newline�Comma��touch_import_top)TZACTIVE�ALLZANCHORZARCZBASELINEZBEVELZBOTHZBOTTOMZBROWSEZBUTTZCASCADEZCENTERZCHARZ CHECKBUTTONZCHORDZCOMMANDZCURRENTZDISABLEDZDOTBOX�EZENDZEWZ EXCEPTIONZEXTENDED�FALSEZFIRSTZFLATZGROOVEZHIDDENZ
HORIZONTALZINSERTZINSIDEZLAST�LEFTZMITERZMOVETOZMULTIPLE�NZNE�NO�NONE�NORMALZNSZNSEWZNUMERICZNWZOFF�ONZOUTSIDEZPAGESZPIESLICEZ
PROJECTINGZ RADIOBUTTONZRAISEDZREADABLEZRIDGE�RIGHTZROUND�SZSCROLLZSEZSELZ SEL_FIRSTZSEL_LASTZ SEPARATORZSINGLEZSOLIDZSUNKENZSWZ StringTypesZTOP�TRUEZ
TclVersionZ TkVersionZ UNDERLINE�UNITSZVERTICAL�WZWORDZWRITABLE�X�YZYESZ wantobjects)"�AbstractBasicAuthHandler�AbstractDigestAuthHandler�AbstractHTTPHandler� BaseHandler�CacheFTPHandler�
FTPHandler� FileHandler�HTTPBasicAuthHandler�HTTPCookieProcessor�HTTPDefaultErrorHandler�HTTPDigestAuthHandler� HTTPError�HTTPErrorProcessor� HTTPHandler�HTTPPasswordMgr� HTTPPasswordMgrWithDefaultRealm�HTTPRedirectHandler� HTTPSHandler�OpenerDirector�ProxyBasicAuthHandler�ProxyDigestAuthHandler� ProxyHandler�Request�StringIO�URLError�UnknownHandler�
addinfourl� build_opener�install_opener�parse_http_list�parse_keqv_listZ randombytes� request_host�urlopen) �ContentTooShortError�FancyURLopener� URLopenerZbasejoin� ftperrors�
getproxies�getproxies_environment� localhost� pathname2url�quote�
quote_plus� splitattr� splithost�
splitnport� splitpasswd� splitport�
splitquery�splittag� splittype� splituser�
splitvalue�thishost�unquote� unquote_plus�unwrap� url2pathname�
urlcleanup� urlencoder: � urlretrieve)�parse_qs� parse_qsl� urldefrag�urljoin�urlparse�urlsplit�
urlunparse�
urlunsplit)ZndbmZgnuZdumb)�error�open)�whichdb)ZBaseHTTPRequestHandlerZ
HTTPServer)�CGIHTTPRequestHandler)�SimpleHTTPRequestHandler)�
FileDialog�LoadFileDialog�SaveFileDialogZ dialogstates�test) Z DirectoryZOpenZSaveAsZ_DialogZ askdirectoryZ askopenfileZaskopenfilenameZaskopenfilenamesZ askopenfilesZ
asksaveasfileZasksaveasfilename)� SimpleDialog)ZaskfloatZ
askintegerZ askstring�Dialog)ZCGIXMLRPCRequestHandlerZSimpleXMLRPCDispatcherZSimpleXMLRPCRequestHandler�SimpleXMLRPCServerZlist_public_methodsZremove_duplicatesZresolve_dotted_attribute)�DocCGIXMLRPCRequestHandler�DocXMLRPCRequestHandler�DocXMLRPCServer�
ServerHTMLDoc�XMLRPCDocGenerator)�urllib2�urllibr[ �dbm�anydbmra �BaseHTTPServer�
CGIHTTPServer�SimpleHTTPServerrd � tkFileDialogrh �tkSimpleDialogrj rm )rp rq )rp rq r[ )rs ra )ru rv rt )rw rd )rx rh )rm rj )zurllib.requestz urllib.errorz urllib.parsez dbm.__init__z http.serverztkinter.filedialogztkinter.simpledialogz
xmlrpc.serverz name='%s'z attr='%s'z
using='%s'z$dotted_name=dotted_name< %s '.' %s >z?pow=power< %s trailer< '.' %s > trailer< '.' using=any > any* >z-pow=power< %s trailer< '.' using=any > any* >z�from_import=import_from< 'from' %s 'import' (import_as_name< using=any 'as' renamed=any> | in_list=import_as_names< using=any* > | using='*' | using=NAME) >zSname_import=import_name< 'import' (%s | in_list=dotted_as_names< imp_list=any* >) >z8name_import_rename=dotted_as_name< %s 'as' renamed=any >z�from_import_rename=import_from< 'from' %s 'import' (%s | import_as_name< %s 'as' renamed=any > | in_list=import_as_names< any* (%s | import_as_name< %s 'as' renamed=any >) any* >) >c C sN dd� t D �} dd�dd� | D �� }|d7 }|d�dd� | D ��d 7 }|S )zI
Builds a pattern for all toplevel names
(urllib, http, etc)
c S s g | ]}|� d ��qS )�.)�split��.0�mod� r~ �J/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_imports2.py�
<listcomp>� � z*all_modules_subpattern.<locals>.<listcomp>z( z | c S s( g | ] }t t|d t|d f �qS )r � )� dotted_name� simple_name� simple_attrr{ r~ r~ r r� � s �
�c S s$ g | ] }|d dkrt |d �qS )r� �__init__r )r� r{ r~ r~ r r� � r� z ))�MAPPING�join)Znames_dot_attrs�retr~ r~ r �all_modules_subpattern� s �
r� c c s� t t� V | �� D ]�\}}|�d�\}}t| }t| }t||f }t| V t||f V |dkrzt| V t | V t
| V t |||||f V qdS )z�
mapping1: A dict mapping py3k modules to all possible py2k replacements
mapping2: A dict mapping py2k modules to the things they do
This builds a HUGE pattern to match all ways that things can be imported
ry r� N) � from_importr� �itemsrz r� r� r� � name_import�
power_twoname�
power_onename�name_import_rename�from_import_rename) Zmapping1Zmapping2Zpy3kZpy2k�name�attrZs_nameZs_attrZd_namer~ r~ r �build_import_pattern� s
r� c @ s( e Zd ZdZd�eee��Zdd� Z dS )� FixImports2� z |
c C s t dd|� d S )N�futureZstandard_libraryr )�self�node�resultsr~ r~ r � transform� s zFixImports2.transformN)
�__name__�
__module__� __qualname__Z run_orderr� r� r� �
PY2MODULESZPATTERNr� r~ r~ r~ r r� � s r� N) �__doc__Zlib2to3r Zlib2to3.fixer_utilr r r r r Zlibfuturize.fixer_utilr Z
TK_BASE_NAMESr� r� r� r� Z simple_usingr� r� r� r� r� r� r� r� r� ZBaseFixr� r~ r~ r~ r �<module> sT
�=�
PK Gu\���J J > libpasteurize/fixes/__pycache__/fix_fullargspec.cpython-39.pycnu �[��� a
��?h� � @ s6 d Z ddlmZ ddlmZ dZG dd� dej�ZdS )z(
Fixer for getfullargspec -> getargspec
� )�
fixer_base)�Namez_some of the values returned by getfullargspec are not valid in Python 2 and have no equivalent.c @ s e Zd ZdZdd� ZdS )�FixFullargspecz'getfullargspec'c C s | � |t� td|jd�S )N�
getargspec)�prefix)�warning�warn_msgr r )�self�node�results� r �M/usr/local/lib/python3.9/site-packages/libpasteurize/fixes/fix_fullargspec.py� transform s zFixFullargspec.transformN)�__name__�
__module__� __qualname__ZPATTERNr r r r r
r
s r N)�__doc__Zlib2to3r Zlib2to3.fixer_utilr r ZBaseFixr r r r r
�<module> s PK Gu\ -�B� � $ libpasteurize/fixes/fix_metaclass.pynu �[��� u"""
Fixer for (metaclass=X) -> __metaclass__ = X
Some semantics (see PEP 3115) may be altered in the translation."""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, syms, Node, Leaf, Newline, find_root
from lib2to3.pygram import token
from libfuturize.fixer_util import indentation, suitify
# from ..fixer_util import Name, syms, Node, Leaf, Newline, find_root, indentation, suitify
def has_metaclass(parent):
results = None
for node in parent.children:
kids = node.children
if node.type == syms.argument:
if kids[0] == Leaf(token.NAME, u"metaclass") and \
kids[1] == Leaf(token.EQUAL, u"=") and \
kids[2]:
#Hack to avoid "class X(=):" with this case.
results = [node] + kids
break
elif node.type == syms.arglist:
# Argument list... loop through it looking for:
# Node(*, [*, Leaf(token.NAME, u"metaclass"), Leaf(token.EQUAL, u"="), Leaf(*, *)]
for child in node.children:
if results: break
if child.type == token.COMMA:
#Store the last comma, which precedes the metaclass
comma = child
elif type(child) == Node:
meta = equal = name = None
for arg in child.children:
if arg == Leaf(token.NAME, u"metaclass"):
#We have the (metaclass) part
meta = arg
elif meta and arg == Leaf(token.EQUAL, u"="):
#We have the (metaclass=) part
equal = arg
elif meta and equal:
#Here we go, we have (metaclass=X)
name = arg
results = (comma, meta, equal, name)
break
return results
class FixMetaclass(fixer_base.BaseFix):
PATTERN = u"""
classdef<any*>
"""
def transform(self, node, results):
meta_results = has_metaclass(node)
if not meta_results: return
for meta in meta_results:
meta.remove()
target = Leaf(token.NAME, u"__metaclass__")
equal = Leaf(token.EQUAL, u"=", prefix=u" ")
# meta is the last item in what was returned by has_metaclass(): name
name = meta
name.prefix = u" "
stmt_node = Node(syms.atom, [target, equal, name])
suitify(node)
for item in node.children:
if item.type == syms.suite:
for stmt in item.children:
if stmt.type == token.INDENT:
# Insert, in reverse order, the statement, a newline,
# and an indent right after the first indented line
loc = item.children.index(stmt) + 1
# Keep consistent indentation form
ident = Leaf(token.INDENT, stmt.value)
item.insert_child(loc, ident)
item.insert_child(loc, Newline())
item.insert_child(loc, stmt_node)
break
PK !Gu\j�hS�! �! # libpasteurize/fixes/fix_imports2.pynu �[��� u"""
Fixer for complicated imports
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, String, FromImport, Newline, Comma
from libfuturize.fixer_util import touch_import_top
TK_BASE_NAMES = (u'ACTIVE', u'ALL', u'ANCHOR', u'ARC',u'BASELINE', u'BEVEL', u'BOTH',
u'BOTTOM', u'BROWSE', u'BUTT', u'CASCADE', u'CENTER', u'CHAR',
u'CHECKBUTTON', u'CHORD', u'COMMAND', u'CURRENT', u'DISABLED',
u'DOTBOX', u'E', u'END', u'EW', u'EXCEPTION', u'EXTENDED', u'FALSE',
u'FIRST', u'FLAT', u'GROOVE', u'HIDDEN', u'HORIZONTAL', u'INSERT',
u'INSIDE', u'LAST', u'LEFT', u'MITER', u'MOVETO', u'MULTIPLE', u'N',
u'NE', u'NO', u'NONE', u'NORMAL', u'NS', u'NSEW', u'NUMERIC', u'NW',
u'OFF', u'ON', u'OUTSIDE', u'PAGES', u'PIESLICE', u'PROJECTING',
u'RADIOBUTTON', u'RAISED', u'READABLE', u'RIDGE', u'RIGHT',
u'ROUND', u'S', u'SCROLL', u'SE', u'SEL', u'SEL_FIRST', u'SEL_LAST',
u'SEPARATOR', u'SINGLE', u'SOLID', u'SUNKEN', u'SW', u'StringTypes',
u'TOP', u'TRUE', u'TclVersion', u'TkVersion', u'UNDERLINE',
u'UNITS', u'VERTICAL', u'W', u'WORD', u'WRITABLE', u'X', u'Y', u'YES',
u'wantobjects')
PY2MODULES = {
u'urllib2' : (
u'AbstractBasicAuthHandler', u'AbstractDigestAuthHandler',
u'AbstractHTTPHandler', u'BaseHandler', u'CacheFTPHandler',
u'FTPHandler', u'FileHandler', u'HTTPBasicAuthHandler',
u'HTTPCookieProcessor', u'HTTPDefaultErrorHandler',
u'HTTPDigestAuthHandler', u'HTTPError', u'HTTPErrorProcessor',
u'HTTPHandler', u'HTTPPasswordMgr',
u'HTTPPasswordMgrWithDefaultRealm', u'HTTPRedirectHandler',
u'HTTPSHandler', u'OpenerDirector', u'ProxyBasicAuthHandler',
u'ProxyDigestAuthHandler', u'ProxyHandler', u'Request',
u'StringIO', u'URLError', u'UnknownHandler', u'addinfourl',
u'build_opener', u'install_opener', u'parse_http_list',
u'parse_keqv_list', u'randombytes', u'request_host', u'urlopen'),
u'urllib' : (
u'ContentTooShortError', u'FancyURLopener',u'URLopener',
u'basejoin', u'ftperrors', u'getproxies',
u'getproxies_environment', u'localhost', u'pathname2url',
u'quote', u'quote_plus', u'splitattr', u'splithost',
u'splitnport', u'splitpasswd', u'splitport', u'splitquery',
u'splittag', u'splittype', u'splituser', u'splitvalue',
u'thishost', u'unquote', u'unquote_plus', u'unwrap',
u'url2pathname', u'urlcleanup', u'urlencode', u'urlopen',
u'urlretrieve',),
u'urlparse' : (
u'parse_qs', u'parse_qsl', u'urldefrag', u'urljoin',
u'urlparse', u'urlsplit', u'urlunparse', u'urlunsplit'),
u'dbm' : (
u'ndbm', u'gnu', u'dumb'),
u'anydbm' : (
u'error', u'open'),
u'whichdb' : (
u'whichdb',),
u'BaseHTTPServer' : (
u'BaseHTTPRequestHandler', u'HTTPServer'),
u'CGIHTTPServer' : (
u'CGIHTTPRequestHandler',),
u'SimpleHTTPServer' : (
u'SimpleHTTPRequestHandler',),
u'FileDialog' : TK_BASE_NAMES + (
u'FileDialog', u'LoadFileDialog', u'SaveFileDialog',
u'dialogstates', u'test'),
u'tkFileDialog' : (
u'Directory', u'Open', u'SaveAs', u'_Dialog', u'askdirectory',
u'askopenfile', u'askopenfilename', u'askopenfilenames',
u'askopenfiles', u'asksaveasfile', u'asksaveasfilename'),
u'SimpleDialog' : TK_BASE_NAMES + (
u'SimpleDialog',),
u'tkSimpleDialog' : TK_BASE_NAMES + (
u'askfloat', u'askinteger', u'askstring', u'Dialog'),
u'SimpleXMLRPCServer' : (
u'CGIXMLRPCRequestHandler', u'SimpleXMLRPCDispatcher',
u'SimpleXMLRPCRequestHandler', u'SimpleXMLRPCServer',
u'list_public_methods', u'remove_duplicates',
u'resolve_dotted_attribute'),
u'DocXMLRPCServer' : (
u'DocCGIXMLRPCRequestHandler', u'DocXMLRPCRequestHandler',
u'DocXMLRPCServer', u'ServerHTMLDoc',u'XMLRPCDocGenerator'),
}
MAPPING = { u'urllib.request' :
(u'urllib2', u'urllib'),
u'urllib.error' :
(u'urllib2', u'urllib'),
u'urllib.parse' :
(u'urllib2', u'urllib', u'urlparse'),
u'dbm.__init__' :
(u'anydbm', u'whichdb'),
u'http.server' :
(u'CGIHTTPServer', u'SimpleHTTPServer', u'BaseHTTPServer'),
u'tkinter.filedialog' :
(u'tkFileDialog', u'FileDialog'),
u'tkinter.simpledialog' :
(u'tkSimpleDialog', u'SimpleDialog'),
u'xmlrpc.server' :
(u'DocXMLRPCServer', u'SimpleXMLRPCServer'),
}
# helps match 'http', as in 'from http.server import ...'
simple_name = u"name='%s'"
# helps match 'server', as in 'from http.server import ...'
simple_attr = u"attr='%s'"
# helps match 'HTTPServer', as in 'from http.server import HTTPServer'
simple_using = u"using='%s'"
# helps match 'urllib.request', as in 'import urllib.request'
dotted_name = u"dotted_name=dotted_name< %s '.' %s >"
# helps match 'http.server', as in 'http.server.HTTPServer(...)'
power_twoname = u"pow=power< %s trailer< '.' %s > trailer< '.' using=any > any* >"
# helps match 'dbm.whichdb', as in 'dbm.whichdb(...)'
power_onename = u"pow=power< %s trailer< '.' using=any > any* >"
# helps match 'from http.server import HTTPServer'
# also helps match 'from http.server import HTTPServer, SimpleHTTPRequestHandler'
# also helps match 'from http.server import *'
from_import = u"from_import=import_from< 'from' %s 'import' (import_as_name< using=any 'as' renamed=any> | in_list=import_as_names< using=any* > | using='*' | using=NAME) >"
# helps match 'import urllib.request'
name_import = u"name_import=import_name< 'import' (%s | in_list=dotted_as_names< imp_list=any* >) >"
#############
# WON'T FIX #
#############
# helps match 'import urllib.request as name'
name_import_rename = u"name_import_rename=dotted_as_name< %s 'as' renamed=any >"
# helps match 'from http import server'
from_import_rename = u"from_import_rename=import_from< 'from' %s 'import' (%s | import_as_name< %s 'as' renamed=any > | in_list=import_as_names< any* (%s | import_as_name< %s 'as' renamed=any >) any* >) >"
def all_modules_subpattern():
u"""
Builds a pattern for all toplevel names
(urllib, http, etc)
"""
names_dot_attrs = [mod.split(u".") for mod in MAPPING]
ret = u"( " + u" | ".join([dotted_name % (simple_name % (mod[0]),
simple_attr % (mod[1])) for mod in names_dot_attrs])
ret += u" | "
ret += u" | ".join([simple_name % (mod[0]) for mod in names_dot_attrs if mod[1] == u"__init__"]) + u" )"
return ret
def build_import_pattern(mapping1, mapping2):
u"""
mapping1: A dict mapping py3k modules to all possible py2k replacements
mapping2: A dict mapping py2k modules to the things they do
This builds a HUGE pattern to match all ways that things can be imported
"""
# py3k: urllib.request, py2k: ('urllib2', 'urllib')
yield from_import % (all_modules_subpattern())
for py3k, py2k in mapping1.items():
name, attr = py3k.split(u'.')
s_name = simple_name % (name)
s_attr = simple_attr % (attr)
d_name = dotted_name % (s_name, s_attr)
yield name_import % (d_name)
yield power_twoname % (s_name, s_attr)
if attr == u'__init__':
yield name_import % (s_name)
yield power_onename % (s_name)
yield name_import_rename % (d_name)
yield from_import_rename % (s_name, s_attr, s_attr, s_attr, s_attr)
class FixImports2(fixer_base.BaseFix):
run_order = 4
PATTERN = u" | \n".join(build_import_pattern(MAPPING, PY2MODULES))
def transform(self, node, results):
touch_import_top(u'future', u'standard_library', node)
PK $Gu\C7YV� � " libpasteurize/fixes/fix_imports.pynu �[��� u"""
Fixer for standard library imports renamed in Python 3
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, is_probably_builtin, Newline, does_tree_import
from lib2to3.pygram import python_symbols as syms
from lib2to3.pgen2 import token
from lib2to3.pytree import Node, Leaf
from libfuturize.fixer_util import touch_import_top
# from ..fixer_util import NameImport
# used in simple_mapping_to_pattern()
MAPPING = {u"reprlib": u"repr",
u"winreg": u"_winreg",
u"configparser": u"ConfigParser",
u"copyreg": u"copy_reg",
u"multiprocessing.SimpleQueue": u"multiprocessing.queues.SimpleQueue",
u"queue": u"Queue",
u"socketserver": u"SocketServer",
u"_markupbase": u"markupbase",
u"test.support": u"test.test_support",
u"dbm.bsd": u"dbhash",
u"dbm.ndbm": u"dbm",
u"dbm.dumb": u"dumbdbm",
u"dbm.gnu": u"gdbm",
u"html.parser": u"HTMLParser",
u"html.entities": u"htmlentitydefs",
u"http.client": u"httplib",
u"http.cookies": u"Cookie",
u"http.cookiejar": u"cookielib",
# "tkinter": "Tkinter",
u"tkinter.dialog": u"Dialog",
u"tkinter._fix": u"FixTk",
u"tkinter.scrolledtext": u"ScrolledText",
u"tkinter.tix": u"Tix",
u"tkinter.constants": u"Tkconstants",
u"tkinter.dnd": u"Tkdnd",
u"tkinter.__init__": u"Tkinter",
u"tkinter.colorchooser": u"tkColorChooser",
u"tkinter.commondialog": u"tkCommonDialog",
u"tkinter.font": u"tkFont",
u"tkinter.ttk": u"ttk",
u"tkinter.messagebox": u"tkMessageBox",
u"tkinter.turtle": u"turtle",
u"urllib.robotparser": u"robotparser",
u"xmlrpc.client": u"xmlrpclib",
u"builtins": u"__builtin__",
}
# generic strings to help build patterns
# these variables mean (with http.client.HTTPConnection as an example):
# name = http
# attr = client
# used = HTTPConnection
# fmt_name is a formatted subpattern (simple_name_match or dotted_name_match)
# helps match 'queue', as in 'from queue import ...'
simple_name_match = u"name='%s'"
# helps match 'client', to be used if client has been imported from http
subname_match = u"attr='%s'"
# helps match 'http.client', as in 'import urllib.request'
dotted_name_match = u"dotted_name=dotted_name< %s '.' %s >"
# helps match 'queue', as in 'queue.Queue(...)'
power_onename_match = u"%s"
# helps match 'http.client', as in 'http.client.HTTPConnection(...)'
power_twoname_match = u"power< %s trailer< '.' %s > any* >"
# helps match 'client.HTTPConnection', if 'client' has been imported from http
power_subname_match = u"power< %s any* >"
# helps match 'from http.client import HTTPConnection'
from_import_match = u"from_import=import_from< 'from' %s 'import' imported=any >"
# helps match 'from http import client'
from_import_submod_match = u"from_import_submod=import_from< 'from' %s 'import' (%s | import_as_name< %s 'as' renamed=any > | import_as_names< any* (%s | import_as_name< %s 'as' renamed=any >) any* > ) >"
# helps match 'import urllib.request'
name_import_match = u"name_import=import_name< 'import' %s > | name_import=import_name< 'import' dotted_as_name< %s 'as' renamed=any > >"
# helps match 'import http.client, winreg'
multiple_name_import_match = u"name_import=import_name< 'import' dotted_as_names< names=any* > >"
def all_patterns(name):
u"""
Accepts a string and returns a pattern of possible patterns involving that name
Called by simple_mapping_to_pattern for each name in the mapping it receives.
"""
# i_ denotes an import-like node
# u_ denotes a node that appears to be a usage of the name
if u'.' in name:
name, attr = name.split(u'.', 1)
simple_name = simple_name_match % (name)
simple_attr = subname_match % (attr)
dotted_name = dotted_name_match % (simple_name, simple_attr)
i_from = from_import_match % (dotted_name)
i_from_submod = from_import_submod_match % (simple_name, simple_attr, simple_attr, simple_attr, simple_attr)
i_name = name_import_match % (dotted_name, dotted_name)
u_name = power_twoname_match % (simple_name, simple_attr)
u_subname = power_subname_match % (simple_attr)
return u' | \n'.join((i_name, i_from, i_from_submod, u_name, u_subname))
else:
simple_name = simple_name_match % (name)
i_name = name_import_match % (simple_name, simple_name)
i_from = from_import_match % (simple_name)
u_name = power_onename_match % (simple_name)
return u' | \n'.join((i_name, i_from, u_name))
class FixImports(fixer_base.BaseFix):
PATTERN = u' | \n'.join([all_patterns(name) for name in MAPPING])
PATTERN = u' | \n'.join((PATTERN, multiple_name_import_match))
def transform(self, node, results):
touch_import_top(u'future', u'standard_library', node)
PK 'Gu\4<ǻ� � & libpasteurize/fixes/fix_fullargspec.pynu �[��� u"""
Fixer for getfullargspec -> getargspec
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name
warn_msg = u"some of the values returned by getfullargspec are not valid in Python 2 and have no equivalent."
class FixFullargspec(fixer_base.BaseFix):
PATTERN = u"'getfullargspec'"
def transform(self, node, results):
self.warning(node, warn_msg)
return Name(u"getargspec", prefix=node.prefix)
PK )Gu\��1�- - & libpasteurize/fixes/fix_annotations.pynu �[��� u"""
Fixer to remove function annotations
"""
from lib2to3 import fixer_base
from lib2to3.pgen2 import token
from lib2to3.fixer_util import syms
warning_text = u"Removing function annotations completely."
def param_without_annotations(node):
return node.children[0]
class FixAnnotations(fixer_base.BaseFix):
warned = False
def warn_once(self, node, reason):
if not self.warned:
self.warned = True
self.warning(node, reason=reason)
PATTERN = u"""
funcdef< 'def' any parameters< '(' [params=any] ')' > ['->' ret=any] ':' any* >
"""
def transform(self, node, results):
u"""
This just strips annotations from the funcdef completely.
"""
params = results.get(u"params")
ret = results.get(u"ret")
if ret is not None:
assert ret.prev_sibling.type == token.RARROW, u"Invalid return annotation"
self.warn_once(node, reason=warning_text)
ret.prev_sibling.remove()
ret.remove()
if params is None: return
if params.type == syms.typedargslist:
# more than one param in a typedargslist
for param in params.children:
if param.type == syms.tname:
self.warn_once(node, reason=warning_text)
param.replace(param_without_annotations(param))
elif params.type == syms.tname:
# one param
self.warn_once(node, reason=warning_text)
params.replace(param_without_annotations(params))
PK ,Gu\VX@�g g ! libpasteurize/fixes/fix_kwargs.pynu �[��� u"""
Fixer for Python 3 function parameter syntax
This fixer is rather sensitive to incorrect py3k syntax.
"""
# Note: "relevant" parameters are parameters following the first STAR in the list.
from lib2to3 import fixer_base
from lib2to3.fixer_util import token, String, Newline, Comma, Name
from libfuturize.fixer_util import indentation, suitify, DoubleStar
_assign_template = u"%(name)s = %(kwargs)s['%(name)s']; del %(kwargs)s['%(name)s']"
_if_template = u"if '%(name)s' in %(kwargs)s: %(assign)s"
_else_template = u"else: %(name)s = %(default)s"
_kwargs_default_name = u"_3to2kwargs"
def gen_params(raw_params):
u"""
Generator that yields tuples of (name, default_value) for each parameter in the list
If no default is given, then it is default_value is None (not Leaf(token.NAME, 'None'))
"""
assert raw_params[0].type == token.STAR and len(raw_params) > 2
curr_idx = 2 # the first place a keyword-only parameter name can be is index 2
max_idx = len(raw_params)
while curr_idx < max_idx:
curr_item = raw_params[curr_idx]
prev_item = curr_item.prev_sibling
if curr_item.type != token.NAME:
curr_idx += 1
continue
if prev_item is not None and prev_item.type == token.DOUBLESTAR:
break
name = curr_item.value
nxt = curr_item.next_sibling
if nxt is not None and nxt.type == token.EQUAL:
default_value = nxt.next_sibling
curr_idx += 2
else:
default_value = None
yield (name, default_value)
curr_idx += 1
def remove_params(raw_params, kwargs_default=_kwargs_default_name):
u"""
Removes all keyword-only args from the params list and a bare star, if any.
Does not add the kwargs dict if needed.
Returns True if more action is needed, False if not
(more action is needed if no kwargs dict exists)
"""
assert raw_params[0].type == token.STAR
if raw_params[1].type == token.COMMA:
raw_params[0].remove()
raw_params[1].remove()
kw_params = raw_params[2:]
else:
kw_params = raw_params[3:]
for param in kw_params:
if param.type != token.DOUBLESTAR:
param.remove()
else:
return False
else:
return True
def needs_fixing(raw_params, kwargs_default=_kwargs_default_name):
u"""
Returns string with the name of the kwargs dict if the params after the first star need fixing
Otherwise returns empty string
"""
found_kwargs = False
needs_fix = False
for t in raw_params[2:]:
if t.type == token.COMMA:
# Commas are irrelevant at this stage.
continue
elif t.type == token.NAME and not found_kwargs:
# Keyword-only argument: definitely need to fix.
needs_fix = True
elif t.type == token.NAME and found_kwargs:
# Return 'foobar' of **foobar, if needed.
return t.value if needs_fix else u''
elif t.type == token.DOUBLESTAR:
# Found either '*' from **foobar.
found_kwargs = True
else:
# Never found **foobar. Return a synthetic name, if needed.
return kwargs_default if needs_fix else u''
class FixKwargs(fixer_base.BaseFix):
run_order = 7 # Run after function annotations are removed
PATTERN = u"funcdef< 'def' NAME parameters< '(' arglist=typedargslist< params=any* > ')' > ':' suite=any >"
def transform(self, node, results):
params_rawlist = results[u"params"]
for i, item in enumerate(params_rawlist):
if item.type == token.STAR:
params_rawlist = params_rawlist[i:]
break
else:
return
# params is guaranteed to be a list starting with *.
# if fixing is needed, there will be at least 3 items in this list:
# [STAR, COMMA, NAME] is the minimum that we need to worry about.
new_kwargs = needs_fixing(params_rawlist)
# new_kwargs is the name of the kwargs dictionary.
if not new_kwargs:
return
suitify(node)
# At this point, params_rawlist is guaranteed to be a list
# beginning with a star that includes at least one keyword-only param
# e.g., [STAR, NAME, COMMA, NAME, COMMA, DOUBLESTAR, NAME] or
# [STAR, COMMA, NAME], or [STAR, COMMA, NAME, COMMA, DOUBLESTAR, NAME]
# Anatomy of a funcdef: ['def', 'name', parameters, ':', suite]
# Anatomy of that suite: [NEWLINE, INDENT, first_stmt, all_other_stmts]
# We need to insert our new stuff before the first_stmt and change the
# first_stmt's prefix.
suite = node.children[4]
first_stmt = suite.children[2]
ident = indentation(first_stmt)
for name, default_value in gen_params(params_rawlist):
if default_value is None:
suite.insert_child(2, Newline())
suite.insert_child(2, String(_assign_template %{u'name':name, u'kwargs':new_kwargs}, prefix=ident))
else:
suite.insert_child(2, Newline())
suite.insert_child(2, String(_else_template %{u'name':name, u'default':default_value}, prefix=ident))
suite.insert_child(2, Newline())
suite.insert_child(2, String(_if_template %{u'assign':_assign_template %{u'name':name, u'kwargs':new_kwargs}, u'name':name, u'kwargs':new_kwargs}, prefix=ident))
first_stmt.prefix = ident
suite.children[2].prefix = u""
# Now, we need to fix up the list of params.
must_add_kwargs = remove_params(params_rawlist)
if must_add_kwargs:
arglist = results[u'arglist']
if len(arglist.children) > 0 and arglist.children[-1].type != token.COMMA:
arglist.append_child(Comma())
arglist.append_child(DoubleStar(prefix=u" "))
arglist.append_child(Name(new_kwargs))
PK .Gu\n`��� � 2 libpasteurize/fixes/fix_add_all_future_builtins.pynu �[��� """
For the ``future`` package.
Adds this import line::
from builtins import (ascii, bytes, chr, dict, filter, hex, input,
int, list, map, next, object, oct, open, pow,
range, round, str, super, zip)
to a module, irrespective of whether each definition is used.
Adds these imports after any other imports (in an initial block of them).
"""
from __future__ import unicode_literals
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
class FixAddAllFutureBuiltins(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 1
def transform(self, node, results):
# import_str = """(ascii, bytes, chr, dict, filter, hex, input,
# int, list, map, next, object, oct, open, pow,
# range, round, str, super, zip)"""
touch_import_top(u'builtins', '*', node)
# builtins = """ascii bytes chr dict filter hex input
# int list map next object oct open pow
# range round str super zip"""
# for builtin in sorted(builtins.split(), reverse=True):
# touch_import_top(u'builtins', builtin, node)
PK 1Gu\# �' ' % libpasteurize/fixes/fix_memoryview.pynu �[��� u"""
Fixer for memoryview(s) -> buffer(s).
Explicit because some memoryview methods are invalid on buffer objects.
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name
class FixMemoryview(fixer_base.BaseFix):
explicit = True # User must specify that they want this.
PATTERN = u"""
power< name='memoryview' trailer< '(' [any] ')' >
rest=any* >
"""
def transform(self, node, results):
name = results[u"name"]
name.replace(Name(u"buffer", prefix=name.prefix))
PK 3Gu\�� � libpasteurize/fixes/fix_next.pynu �[��� u"""
Fixer for:
it.__next__() -> it.next().
next(it) -> it.next().
"""
from lib2to3.pgen2 import token
from lib2to3.pygram import python_symbols as syms
from lib2to3 import fixer_base
from lib2to3.fixer_util import Name, Call, find_binding, Attr
bind_warning = u"Calls to builtin next() possibly shadowed by global binding"
class FixNext(fixer_base.BaseFix):
PATTERN = u"""
power< base=any+ trailer< '.' attr='__next__' > any* >
|
power< head='next' trailer< '(' arg=any ')' > any* >
|
classdef< 'class' base=any+ ':'
suite< any*
funcdef< 'def'
attr='__next__'
parameters< '(' NAME ')' > any+ >
any* > >
"""
def transform(self, node, results):
assert results
base = results.get(u"base")
attr = results.get(u"attr")
head = results.get(u"head")
arg_ = results.get(u"arg")
if arg_:
arg = arg_.clone()
head.replace(Attr(Name(unicode(arg),prefix=head.prefix),
Name(u"next")))
arg_.remove()
elif base:
attr.replace(Name(u"next", prefix=attr.prefix))
PK 6Gu\%P�� � * libpasteurize/fixes/fix_future_builtins.pynu �[��� """
Adds this import line:
from builtins import XYZ
for each of the functions XYZ that is used in the module.
"""
from __future__ import unicode_literals
from lib2to3 import fixer_base
from lib2to3.pygram import python_symbols as syms
from lib2to3.fixer_util import Name, Call, in_special_context
from libfuturize.fixer_util import touch_import_top
# All builtins are:
# from future.builtins.iterators import (filter, map, zip)
# from future.builtins.misc import (ascii, chr, hex, input, isinstance, oct, open, round, super)
# from future.types import (bytes, dict, int, range, str)
# We don't need isinstance any more.
replaced_builtins = '''filter map zip
ascii chr hex input next oct open round super
bytes dict int range str'''.split()
expression = '|'.join(["name='{0}'".format(name) for name in replaced_builtins])
class FixFutureBuiltins(fixer_base.BaseFix):
BM_compatible = True
run_order = 9
# Currently we only match uses as a function. This doesn't match e.g.:
# if isinstance(s, str):
# ...
PATTERN = """
power<
({0}) trailer< '(' args=[any] ')' >
rest=any* >
""".format(expression)
def transform(self, node, results):
name = results["name"]
touch_import_top(u'builtins', name.value, node)
# name.replace(Name(u"input", prefix=name.prefix))
PK 8Gu\w�y� � ! libpasteurize/fixes/fix_raise_.pynu �[��� u"""Fixer for
raise E(V).with_traceback(T)
to:
from future.utils import raise_
...
raise_(E, V, T)
TODO: FIXME!!
"""
from lib2to3 import fixer_base
from lib2to3.fixer_util import Comma, Node, Leaf, token, syms
class FixRaise(fixer_base.BaseFix):
PATTERN = u"""
raise_stmt< 'raise' (power< name=any [trailer< '(' val=any* ')' >]
[trailer< '.' 'with_traceback' > trailer< '(' trc=any ')' >] > | any) ['from' chain=any] >"""
def transform(self, node, results):
FIXME
name, val, trc = (results.get(u"name"), results.get(u"val"), results.get(u"trc"))
chain = results.get(u"chain")
if chain is not None:
self.warning(node, u"explicit exception chaining is not supported in Python 2")
chain.prev_sibling.remove()
chain.remove()
if trc is not None:
val = val[0] if val else Leaf(token.NAME, u"None")
val.prefix = trc.prefix = u" "
kids = [Leaf(token.NAME, u"raise"), name.clone(), Comma(),
val.clone(), Comma(), trc.clone()]
raise_stmt = Node(syms.raise_stmt, kids)
node.replace(raise_stmt)
PK ;Gu\F1}� � # libpasteurize/fixes/feature_base.pynu �[��� u"""
Base classes for features that are backwards-incompatible.
Usage:
features = Features()
features.add(Feature("py3k_feature", "power< 'py3k' any* >", "2.7"))
PATTERN = features.PATTERN
"""
pattern_unformatted = u"%s=%s" # name=pattern, for dict lookups
message_unformatted = u"""
%s is only supported in Python %s and above."""
class Feature(object):
u"""
A feature has a name, a pattern, and a minimum version of Python 2.x
required to use the feature (or 3.x if there is no backwards-compatible
version of 2.x)
"""
def __init__(self, name, PATTERN, version):
self.name = name
self._pattern = PATTERN
self.version = version
def message_text(self):
u"""
Format the above text with the name and minimum version required.
"""
return message_unformatted % (self.name, self.version)
class Features(set):
u"""
A set of features that generates a pattern for the features it contains.
This set will act like a mapping in that we map names to patterns.
"""
mapping = {}
def update_mapping(self):
u"""
Called every time we care about the mapping of names to features.
"""
self.mapping = dict([(f.name, f) for f in iter(self)])
@property
def PATTERN(self):
u"""
Uses the mapping of names to features to return a PATTERN suitable
for using the lib2to3 patcomp.
"""
self.update_mapping()
return u" |\n".join([pattern_unformatted % (f.name, f._pattern) for f in iter(self)])
def __getitem__(self, key):
u"""
Implement a simple mapping to get patterns from names.
"""
return self.mapping[key]
PK @Gu\�bXї � = libpasteurize/fixes/fix_add_future_standard_library_import.pynu �[��� """
For the ``future`` package.
Adds this import line:
from future import standard_library
after any __future__ imports but before any other imports. Doesn't actually
change the imports to Py3 style.
"""
from lib2to3 import fixer_base
from libfuturize.fixer_util import touch_import_top
class FixAddFutureStandardLibraryImport(fixer_base.BaseFix):
BM_compatible = True
PATTERN = "file_input"
run_order = 8
def transform(self, node, results):
# TODO: add a blank line between any __future__ imports and this?
touch_import_top(u'future', u'standard_library', node)
# TODO: also add standard_library.install_hooks()
PK EGu\ 4R libpasteurize/__init__.pynu �[��� # empty to make this a package
PK JGu\!A� � 1 libpasteurize/__pycache__/__init__.cpython-39.pycnu �[��� a
��?h � @ s d S )N� r r r �@/usr/local/lib/python3.9/site-packages/libpasteurize/__init__.py�<module> � PK LGu\��^a� � - libpasteurize/__pycache__/main.cpython-39.pycnu �[��� a
��?h� � @ sv d Z ddlmZmZmZ ddlZddlZddlZddlm Z m
Z
m Z ddl m
Z
ddlmZ ddlmZ d
dd �Z dS ) a�
pasteurize: automatic conversion of Python 3 code to clean 2/3 code
===================================================================
``pasteurize`` attempts to convert existing Python 3 code into source-compatible
Python 2 and 3 code.
Use it like this on Python 3 code:
$ pasteurize --verbose mypython3script.py
This removes any Py3-only syntax (e.g. new metaclasses) and adds these
import lines:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
from future import standard_library
standard_library.install_hooks()
from builtins import *
To write changes to the files, use the -w flag.
It also adds any other wrappers needed for Py2/3 compatibility.
Note that separate stages are not available (or needed) when converting from
Python 3 with ``pasteurize`` as they are when converting from Python 2 with
``futurize``.
The --all-imports option forces adding all ``__future__`` imports,
``builtins`` imports, and standard library aliases, even if they don't
seem necessary for the current state of each module. (This can simplify
testing, and can reduce the need to think about Py2 compatibility when editing
the code further.)
� )�absolute_import�print_function�unicode_literalsN)�main�warn�StdoutRefactoringTool)�refactor)� __version__)� fix_namesc st t jdd�}|jddddd� |jdd dd
d� |jd d d
g dd� |jddddddd� |jddd
g dd� |jdddd d� |jd d dd d� |jd dd!d� |jd"d#dd$d� |jd%d&dd'd(d� d'}i }|�| �\}} d)}t}d*|d+< |j�s|j�rtd,� |j�s |j�r |� d-� |j
�r4t t � d.S |j
�rft d/� t|�D ]}t |� �qL| �sfd.S | �s�t d0tjd1� t d2tjd1� d3S d4| v �r�d*}|j�r�t d5tjd1� d3S |j�r�tjntj}tjd6|d7� t� } |jD ]�� d8� v �r�| �� � nx� fd9d:�|D �}
t|
�dk�rDt d;d<�d=d>� |
D �� tjd1� d3S t|
�d.k�rft d?tjd1� d3S | �|
d. � �q�t� } |j�r�d@} | �| dA � | �| dB � | �| dC � t� }
|j �r�d'}|j D ]�� � dDk�r�d*}n�d8� v �r�|
�� � nx� fdEd:�|D �}
t|
�dk�r>t d;d<�dFd>� |
D �� tjd1� d3S t|
�d.k�r`t d?tjd1� d3S |
�|
d. � �q�t|
| @ �d.k�r�t dGd<�dHd>� |
| @ D �� tjd1� d3S |�r�|� |
�n|
}n
|� |
�}|| | B }t t|�|t� |j|j �}|j �sf|�r|� � nPz|�!| |jdI|j"� W n6 t!j#�y\ |j"dk�sHJ �t dJtjd1� Y dS 0 |�$� t%t&|j ��S )KzBMain program.
Returns a suggested exit status (0, 1, 2).
z!pasteurize [options] file|dir ...)�usagez-Vz --version�
store_truez'Report the version number of pasteurize)�action�helpz-az
--all-importsz5Adds all __future__ and future imports to each modulez-fz--fix�appendz1Each FIX specifies a transformation; default: all)r
�defaultr z-jz --processes�store� �intzRun 2to3 concurrently)r
r �typer z-xz--nofixz Prevent a fixer from being run.z-lz --list-fixesz List available transformationsz-vz --verbosezMore verbose loggingz
--no-diffsz#Don't show diffs of the refactoringz-wz--writezWrite back modified filesz-nz --nobackupsFz'Don't write backups for modified files.zlibpasteurize.fixesTr z@not writing files and not printing diffs; that's not very usefulzCan't use -n without -wr z2Available transformations for the -f/--fix option:z1At least one file or directory argument required.)�filezUse --help to show usage.� �-zCan't write to stdin.z%(name)s: %(message)s)�format�levelz.fix_c s g | ]}|� d �� ��r|�qS �zfix_{0}��endswithr ��.0�f��fix� �</usr/local/lib/python3.9/site-packages/libpasteurize/main.py�
<listcomp>} s �zmain.<locals>.<listcomp>zOAmbiguous fixer name. Choose a fully qualified module name instead from these:
�
c s s | ]}d | V qdS �z Nr" �r Zmyfr" r" r# � <genexpr>� � zmain.<locals>.<genexpr>z1Unknown fixer. Use --list-fixes or -l for a list.zlibpasteurize.fixes.Z fix_add_all__future__importsZ&fix_add_future_standard_library_importZfix_add_all_future_builtins�allc s g | ]}|� d �� ��r|�qS r r r r r" r# r$ � s �c s s | ]}d | V qdS r& r" r' r" r" r# r( � r) z[Conflicting usage: the following fixers have been simultaneously requested and disallowed:
c s s | ]}d | V qdS r& r" r' r" r" r# r( � r) Nz+Sorry, -j isn't supported on this platform.)'�optparse� OptionParser�
add_option�
parse_argsr
�writeZno_diffsr Z nobackups�error�version�printr Z
list_fixes�sorted�sys�stderr�verbose�logging�DEBUG�INFO� basicConfig�setZnofix�add�len�joinZ all_importsr! �unionr �errors�refactor_stdinr Z processesZMultiprocessingUnsupportedZ summarizer �bool)�args�parserrA �flags�optionsZ fixer_pkgZ avail_fixesZfixnamer Zunwanted_fixes�foundZ extra_fixes�prefix�explicitZ all_present� requested� fixer_names�rtr" r r# r 3 s
�
� � � �
�
��
� �
�
���
�����
�
��r )N)�__doc__�
__future__r r r r4 r7 r+ Z lib2to3.mainr r r Zlib2to3r �futurer Zlibpasteurize.fixesr
r" r" r" r# �<module> s & PK OGu\^�� � libpasteurize/main.pynu �[��� """
pasteurize: automatic conversion of Python 3 code to clean 2/3 code
===================================================================
``pasteurize`` attempts to convert existing Python 3 code into source-compatible
Python 2 and 3 code.
Use it like this on Python 3 code:
$ pasteurize --verbose mypython3script.py
This removes any Py3-only syntax (e.g. new metaclasses) and adds these
import lines:
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
from future import standard_library
standard_library.install_hooks()
from builtins import *
To write changes to the files, use the -w flag.
It also adds any other wrappers needed for Py2/3 compatibility.
Note that separate stages are not available (or needed) when converting from
Python 3 with ``pasteurize`` as they are when converting from Python 2 with
``futurize``.
The --all-imports option forces adding all ``__future__`` imports,
``builtins`` imports, and standard library aliases, even if they don't
seem necessary for the current state of each module. (This can simplify
testing, and can reduce the need to think about Py2 compatibility when editing
the code further.)
"""
from __future__ import (absolute_import, print_function, unicode_literals)
import sys
import logging
import optparse
from lib2to3.main import main, warn, StdoutRefactoringTool
from lib2to3 import refactor
from future import __version__
from libpasteurize.fixes import fix_names
def main(args=None):
"""Main program.
Returns a suggested exit status (0, 1, 2).
"""
# Set up option parser
parser = optparse.OptionParser(usage="pasteurize [options] file|dir ...")
parser.add_option("-V", "--version", action="store_true",
help="Report the version number of pasteurize")
parser.add_option("-a", "--all-imports", action="store_true",
help="Adds all __future__ and future imports to each module")
parser.add_option("-f", "--fix", action="append", default=[],
help="Each FIX specifies a transformation; default: all")
parser.add_option("-j", "--processes", action="store", default=1,
type="int", help="Run 2to3 concurrently")
parser.add_option("-x", "--nofix", action="append", default=[],
help="Prevent a fixer from being run.")
parser.add_option("-l", "--list-fixes", action="store_true",
help="List available transformations")
# parser.add_option("-p", "--print-function", action="store_true",
# help="Modify the grammar so that print() is a function")
parser.add_option("-v", "--verbose", action="store_true",
help="More verbose logging")
parser.add_option("--no-diffs", action="store_true",
help="Don't show diffs of the refactoring")
parser.add_option("-w", "--write", action="store_true",
help="Write back modified files")
parser.add_option("-n", "--nobackups", action="store_true", default=False,
help="Don't write backups for modified files.")
# Parse command line arguments
refactor_stdin = False
flags = {}
options, args = parser.parse_args(args)
fixer_pkg = 'libpasteurize.fixes'
avail_fixes = fix_names
flags["print_function"] = True
if not options.write and options.no_diffs:
warn("not writing files and not printing diffs; that's not very useful")
if not options.write and options.nobackups:
parser.error("Can't use -n without -w")
if options.version:
print(__version__)
return 0
if options.list_fixes:
print("Available transformations for the -f/--fix option:")
for fixname in sorted(avail_fixes):
print(fixname)
if not args:
return 0
if not args:
print("At least one file or directory argument required.",
file=sys.stderr)
print("Use --help to show usage.", file=sys.stderr)
return 2
if "-" in args:
refactor_stdin = True
if options.write:
print("Can't write to stdin.", file=sys.stderr)
return 2
# Set up logging handler
level = logging.DEBUG if options.verbose else logging.INFO
logging.basicConfig(format='%(name)s: %(message)s', level=level)
unwanted_fixes = set()
for fix in options.nofix:
if ".fix_" in fix:
unwanted_fixes.add(fix)
else:
# Infer the full module name for the fixer.
# First ensure that no names clash (e.g.
# lib2to3.fixes.fix_blah and libfuturize.fixes.fix_blah):
found = [f for f in avail_fixes
if f.endswith('fix_{0}'.format(fix))]
if len(found) > 1:
print("Ambiguous fixer name. Choose a fully qualified "
"module name instead from these:\n" +
"\n".join(" " + myf for myf in found),
file=sys.stderr)
return 2
elif len(found) == 0:
print("Unknown fixer. Use --list-fixes or -l for a list.",
file=sys.stderr)
return 2
unwanted_fixes.add(found[0])
extra_fixes = set()
if options.all_imports:
prefix = 'libpasteurize.fixes.'
extra_fixes.add(prefix + 'fix_add_all__future__imports')
extra_fixes.add(prefix + 'fix_add_future_standard_library_import')
extra_fixes.add(prefix + 'fix_add_all_future_builtins')
explicit = set()
if options.fix:
all_present = False
for fix in options.fix:
if fix == 'all':
all_present = True
else:
if ".fix_" in fix:
explicit.add(fix)
else:
# Infer the full module name for the fixer.
# First ensure that no names clash (e.g.
# lib2to3.fixes.fix_blah and libpasteurize.fixes.fix_blah):
found = [f for f in avail_fixes
if f.endswith('fix_{0}'.format(fix))]
if len(found) > 1:
print("Ambiguous fixer name. Choose a fully qualified "
"module name instead from these:\n" +
"\n".join(" " + myf for myf in found),
file=sys.stderr)
return 2
elif len(found) == 0:
print("Unknown fixer. Use --list-fixes or -l for a list.",
file=sys.stderr)
return 2
explicit.add(found[0])
if len(explicit & unwanted_fixes) > 0:
print("Conflicting usage: the following fixers have been "
"simultaneously requested and disallowed:\n" +
"\n".join(" " + myf for myf in (explicit & unwanted_fixes)),
file=sys.stderr)
return 2
requested = avail_fixes.union(explicit) if all_present else explicit
else:
requested = avail_fixes.union(explicit)
fixer_names = requested | extra_fixes - unwanted_fixes
# Initialize the refactoring tool
rt = StdoutRefactoringTool(sorted(fixer_names), flags, set(),
options.nobackups, not options.no_diffs)
# Refactor all files and directories passed as arguments
if not rt.errors:
if refactor_stdin:
rt.refactor_stdin()
else:
try:
rt.refactor(args, options.write, None,
options.processes)
except refactor.MultiprocessingUnsupported:
assert options.processes > 1
print("Sorry, -j isn't " \
"supported on this platform.", file=sys.stderr)
return 1
rt.summarize()
# Return error status (0 if rt.errors is zero)
return int(bool(rt.errors))
PK ok\%M�m m ( netifaces.cpython-39-x86_64-linux-gnu.sonu ȯ�� PK ok\�Ï�; �; � psutil/_compat.pynu �[��� PK ok\͔���� �� �B psutil/tests/test_misc.pynu �[��� PK ok\X���N �N k� psutil/tests/test_bsd.pynu �[��� PK ok\�;�3< 3< � psutil/tests/test_memleaks.pynu �[��� PK ok\���H!1 !1 1[ psutil/tests/test_contracts.pynu �[��� PK ok\ ��c�H �H �� psutil/tests/test_process_all.pynu �[��� PK ok\Z��� � �� psutil/tests/__init__.pynu �[��� PK ok\V�a�S S x� psutil/tests/test_connections.pynu �[��� PK ok\�TZn� n� �- psutil/tests/test_process.pynu �[��� PK ok\��� O� O� �$ psutil/tests/test_system.pynu �[��� PK ok\ 3�
� � � psutil/tests/test_osx.pynu �[��� PK ok\
�u5 5 ]� psutil/tests/__main__.pynu �[��� PK ok\��k� � 0 �� psutil/tests/__pycache__/test_aix.cpython-39.pycnu �[��� PK ok\�*ejX jX 6 '� psutil/tests/__pycache__/test_testutils.cpython-39.pycnu �[��� PK ok\���Sh� h� 0 �1 psutil/tests/__pycache__/__init__.cpython-39.pycnu �[��� PK ok\�����\ �\ 5 �
psutil/tests/__pycache__/test_memleaks.cpython-39.pycnu �[��� PK ok\�đ�&> &> 8 �j psutil/tests/__pycache__/test_connections.cpython-39.pycnu �[��� PK ok\����7 �7 2 g� psutil/tests/__pycache__/test_posix.cpython-39.pycnu �[��� PK ok\v�b�? �? 8 �� psutil/tests/__pycache__/test_process_all.cpython-39.pycnu �[��� PK ok\+��N �N 0
" psutil/tests/__pycache__/test_bsd.cpython-39.pycnu �[��� PK ok\{��
y
y 4 +q psutil/tests/__pycache__/test_windows.cpython-39.pycnu �[��� PK ok\�n�E 0 �� psutil/tests/__pycache__/test_osx.cpython-39.pycnu �[��� PK ok\�J�>C) C) 2 psutil/tests/__pycache__/test_linux.cpython-39.pycnu �[��� PK ok\ r.�}� }� 4 �.
psutil/tests/__pycache__/test_process.cpython-39.pycnu �[��� PK ok\��yZ5 5 6 ��
psutil/tests/__pycache__/test_contracts.cpython-39.pycnu �[��� PK ok\R4�(| | 1 0 psutil/tests/__pycache__/test_misc.cpython-39.pycnu �[��� PK ok\�6�r �r 3 �� psutil/tests/__pycache__/test_system.cpython-39.pycnu �[��� PK ok\}��} } 2 � psutil/tests/__pycache__/test_sunos.cpython-39.pycnu �[��� PK ok\豍B B 0 �% psutil/tests/__pycache__/__main__.cpython-39.pycnu �[��� PK ok\ށ�, , 4 f' psutil/tests/__pycache__/test_unicode.cpython-39.pycnu �[��� PK ok\7 �S psutil/tests/test_windows.pynu �[��� PK ok\�P�
�H �H �� psutil/tests/test_testutils.pynu �[��� PK ok\�c�;1 ;1 �!
psutil/tests/test_unicode.pynu �[��� PK ok\�μ[d [d ^S
psutil/tests/test_linux.pynu �[��� PK ok\�u�� � � psutil/tests/test_sunos.pynu �[��� PK ok\0�� D D �� psutil/tests/test_posix.pynu �[��� PK ok\���� � ? psutil/tests/test_aix.pynu �[��� PK ok\�$�B\ B\ J psutil/__init__.pynu �[��� PK ok\0T;+ + �m psutil/_psposix.pynu �[��� PK ok\t�|�Z Z ;� psutil/_pslinux.pynu �[��� PK ok\�#�!x� x� �� psutil/_psutil_linux.abi3.sonu ȯ�� PK ok\��G��r �r , S� psutil/__pycache__/_pswindows.cpython-39.pycnu �[��� PK ok\ �U� � * � psutil/__pycache__/__init__.cpython-39.pycnu �[��� PK ok\E�� 5 5 ( psutil/__pycache__/_psosx.cpython-39.pycnu �[��� PK ok\�DB�g[ g[ ) �S psutil/__pycache__/_common.cpython-39.pycnu �[��� PK ok\]2�مG �G * C� psutil/__pycache__/_pssunos.cpython-39.pycnu �[��� PK ok\1}:p�; �; ( "� psutil/__pycache__/_psaix.cpython-39.pycnu �[��� PK ok\+����� �� * 3 psutil/__pycache__/_pslinux.cpython-39.pycnu �[��� PK ok\�Dˤ� � * a psutil/__pycache__/_psposix.cpython-39.pycnu �[��� PK ok\q�-��- �- ) � psutil/__pycache__/_compat.cpython-39.pycnu �[��� PK ok\<�R R ( �E psutil/__pycache__/_psbsd.cpython-39.pycnu �[��� PK ok\ s�L+t +t � psutil/_common.pynu �[��� PK ok\�*Ǘ�H �H � psutil/_psaix.pynu �[��� PK ok\,��S? ? �U psutil/_psosx.pynu �[��� PK ok\݄� � �� psutil/_psutil_posix.abi3.sonu ȯ�� PK ok\ػ�هc �c � psutil/_pssunos.pynu �[��� PK ok\;�`�} �} � psutil/_psbsd.pynu �[��� PK ok\w�]�� � � psutil/_pswindows.pynu �[��� PK ok\�ɞ1� � $ netifaces-0.11.0.dist-info/WHEELnu �[��� PK ok\���* * " �$ netifaces-0.11.0.dist-info/LICENSEnu �[��� PK ok\�zb�
! {) netifaces-0.11.0.dist-info/RECORDnu �[��� PK ok\t��/�" �" # �, netifaces-0.11.0.dist-info/METADATAnu �[��� PK ok\ $ P netifaces-0.11.0.dist-info/REQUESTEDnu �[��� PK ok\�.�
( tP netifaces-0.11.0.dist-info/top_level.txtnu �[��� PK ok\��2 # �P netifaces-0.11.0.dist-info/zip-safenu �[��� PK ok\� �� $ *Q netifaces-0.11.0.dist-info/INSTALLERnu �[��� PK ok\� 94� � �Q psutil-6.1.0.dist-info/WHEELnu �[��� PK ok\٘q� �R psutil-6.1.0.dist-info/LICENSEnu �[��� PK ok\W��� � Y psutil-6.1.0.dist-info/RECORDnu �[��� PK ok\t�c�W W �j psutil-6.1.0.dist-info/METADATAnu �[��� PK ok\ @� psutil-6.1.0.dist-info/REQUESTEDnu �[��� PK ok\TFG $ �� psutil-6.1.0.dist-info/top_level.txtnu �[��� PK ok\� �� �� psutil-6.1.0.dist-info/INSTALLERnu �[��� PK @u\ ?� certifi/py.typednu �[��� PK @u\���^ ^ � certifi/__init__.pynu �[��� PK @u\ ���� � � certifi/__main__.pynu �[��� PK
@u\b�H + V� certifi/__pycache__/__init__.cpython-39.pycnu �[��� PK @u\�5�!( ( ' �� certifi/__pycache__/core.cpython-39.pycnu �[��� PK @u\x��� � + 6� certifi/__pycache__/__main__.cpython-39.pycnu �[��� PK @u\!�AJ J � certifi/core.pynu �[��� PK @u\l�Hڣ� �� �� certifi/cacert.pemnu �[��� PK @u\o��4\ \ �t distro-1.9.0.dist-info/WHEELnu �[��� PK !@u\�[�=, =, 5u distro-1.9.0.dist-info/LICENSEnu �[��� PK #@u\�e _� � �� distro-1.9.0.dist-info/RECORDnu �[��� PK &@u\�û�� � �� distro-1.9.0.dist-info/METADATAnu �[��� PK (@u\ l� distro-1.9.0.dist-info/REQUESTEDnu �[��� PK (@u\�f�� $ �� distro-1.9.0.dist-info/top_level.txtnu �[��� PK ,@u\���. . ' � distro-1.9.0.dist-info/entry_points.txtnu �[��� PK .@u\� �� �� distro-1.9.0.dist-info/INSTALLERnu �[��� PK 3@u\ I��\ \ �� future-1.0.0.dist-info/WHEELnu �[��� PK 6@u\�E+��z �z �� future-1.0.0.dist-info/RECORDnu �[��� PK 9@u\���w w �>! future-1.0.0.dist-info/METADATAnu �[��� PK ;@u\�l�3 3 " |N! future-1.0.0.dist-info/LICENSE.txtnu �[��� PK @@u\ S! future-1.0.0.dist-info/REQUESTEDnu �[��� PK @@u\Z�w�& & $ QS! future-1.0.0.dist-info/top_level.txtnu �[��� PK B@u\}
�=X X ' �S! future-1.0.0.dist-info/entry_points.txtnu �[��� PK E@u\� �� zT! future-1.0.0.dist-info/INSTALLERnu �[��� PK J@u\E���
�T! configparser.pynu �[��� PK P@u\�9J�� � ' [! __pycache__/configparser.cpython-39.pycnu �[��� PK U@u\�P2�\ \ " L`! configparser-5.2.0.dist-info/WHEELnu �[��� PK W@u\�Yď $ �`! configparser-5.2.0.dist-info/LICENSEnu �[��� PK Z@u\��� � # he! configparser-5.2.0.dist-info/RECORDnu �[��� PK \@u\�J��-+ -+ % �i! configparser-5.2.0.dist-info/METADATAnu �[��� PK a@u\ & <�! configparser-5.2.0.dist-info/REQUESTEDnu �[��� PK a@u\� * ��! configparser-5.2.0.dist-info/top_level.txtnu �[��� PK c@u\� �� & �! configparser-5.2.0.dist-info/INSTALLERnu �[��� PK i@u\h��[ [ ! ]�! certifi-2024.8.30.dist-info/WHEELnu �[��� PK k@u\�+2� � # �! certifi-2024.8.30.dist-info/LICENSEnu �[��� PK n@u\���%O O " 9�! certifi-2024.8.30.dist-info/RECORDnu �[��� PK p@u\�AϺ� � $ ڟ! certifi-2024.8.30.dist-info/METADATAnu �[��� PK s@u\ % ܨ! certifi-2024.8.30.dist-info/REQUESTEDnu �[��� PK s@u\]�� ) 1�! certifi-2024.8.30.dist-info/top_level.txtnu �[��� PK u@u\� �� % ��! certifi-2024.8.30.dist-info/INSTALLERnu �[��� PK {@u\
^��L L �! past/__init__.pynu �[��� PK �@u\8�p�B: B: w�! past/translation/__init__.pynu �[��� PK �@u\��!��+ �+ 4 �! past/translation/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\zD�� � W " past/builtins/misc.pynu �[��� PK �@u\J�< �$ �$ z2" past/builtins/noniterators.pynu �[��� PK �@u\�Q�|
aW" past/builtins/__init__.pynu �[��� PK �@u\�5� D D 1 �^" past/builtins/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\��Z�� � - \e" past/builtins/__pycache__/misc.cpython-39.pycnu �[��� PK �@u\93]�� � 5 Xu" past/builtins/__pycache__/noniterators.cpython-39.pycnu �[��� PK �@u\���$� � ( r�" past/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\ZF2 ��" past/types/basestring.pynu �[��� PK �@u\� Wo o �" past/types/__init__.pynu �[��� PK �@u\�
��
�
ĕ" past/types/olddict.pynu �[��� PK �@u\,#l� � ��" past/types/oldstr.pynu �[��� PK �@u\��ջc c . ۱" past/types/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\�g�T T , ��" past/types/__pycache__/oldstr.cpython-39.pycnu �[��� PK �@u\Y�ױ1 1 - L�" past/types/__pycache__/olddict.cpython-39.pycnu �[��� PK �@u\�3L` ` 0 ��" past/types/__pycache__/basestring.cpython-39.pycnu �[��� PK �@u\�ߵ�I
I
��" past/utils/__init__.pynu �[��� PK �@u\���� � . )�" past/utils/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\�졀� � " a�" backports/configparser/__init__.pynu �[��� PK �@u\���� � 8 2�# backports/configparser/__pycache__/compat.cpython-39.pycnu �[��� PK �@u\HEʷ�� �� : 2�# backports/configparser/__pycache__/__init__.cpython-39.pycnu �[��� PK �@u\�($K� � �t$ backports/configparser/compat.pynu �[��� PK �@u\�V� � E zv$ libfuturize/fixes/fix_add__future__imports_except_unicode_literals.pynu �[��� PK �@u\Ʉf � � ! �y$ libfuturize/fixes/fix_division.pynu �[��� PK �@u\�:�{� � �z$ libfuturize/fixes/fix_bytes.pynu �[��� PK �@u\C��V V " �}$ libfuturize/fixes/fix_next_call.pynu �[��� PK �@u\D�;� ! ]�$ libfuturize/fixes/fix_UserDict.pynu �[��� PK �@u\;�"4t t ��$ libfuturize/fixes/__init__.pynu �[��� PK �@u\����� � + o�$ libfuturize/fixes/fix_xrange_with_import.pynu �[��� PK �@u\Fy �� � ! ��$ libfuturize/fixes/fix_execfile.pynu �[��� PK �@u\���@ @ ��$ libfuturize/fixes/fix_raise.pynu �[��� PK Au\�H{l� � !�$ libfuturize/fixes/fix_input.pynu �[��� PK Au\�rؑ� � �$ libfuturize/fixes/fix_cmp.pynu �[��� PK Au\��z� � : '�$ libfuturize/fixes/__pycache__/fix_next_call.cpython-39.pycnu �[��� PK Au\���� � @ `�$ libfuturize/fixes/__pycache__/fix_future_builtins.cpython-39.pycnu �[��� PK
Au\�#�j j O ��$ libfuturize/fixes/__pycache__/fix_future_standard_library_urllib.cpython-39.pycnu �[��� PK Au\�ڌ�� � 5 s�$ libfuturize/fixes/__pycache__/__init__.cpython-39.pycnu �[��� PK Au\��� � 9 ��$ libfuturize/fixes/__pycache__/fix_division.cpython-39.pycnu �[��� PK Au\;�ě� � ? ��$ libfuturize/fixes/__pycache__/fix_unicode_keep_u.cpython-39.pycnu �[��� PK Au\uj4E H u�$ libfuturize/fixes/__pycache__/fix_order___future__imports.cpython-39.pycnu �[��� PK Au\;�� 9 �$ libfuturize/fixes/__pycache__/fix_execfile.cpython-39.pycnu �[��� PK Au\�� � 6 s�$ libfuturize/fixes/__pycache__/fix_raise.cpython-39.pycnu �[��� PK $Au\v�OC 7 �% libfuturize/fixes/__pycache__/fix_object.cpython-39.pycnu �[��� PK 'Au\�&D�3 3 4 % libfuturize/fixes/__pycache__/fix_cmp.cpython-39.pycnu �[��� PK *Au\�#N� 6 �
% libfuturize/fixes/__pycache__/fix_bytes.cpython-39.pycnu �[��� PK ,Au\�o��e
e
6 % libfuturize/fixes/__pycache__/fix_print.cpython-39.pycnu �[��� PK /Au\���� � : � % libfuturize/fixes/__pycache__/fix_metaclass.cpython-39.pycnu �[��� PK 1Au\�"8�� � 9 �3% libfuturize/fixes/__pycache__/fix_UserDict.cpython-39.pycnu �[��� PK 4Au\�+�( ( H �<% libfuturize/fixes/__pycache__/fix_future_standard_library.cpython-39.pycnu �[��� PK 7Au\�ú�k k C �A% libfuturize/fixes/__pycache__/fix_xrange_with_import.cpython-39.pycnu �[��� PK :Au\�h�, , 6 hE% libfuturize/fixes/__pycache__/fix_input.cpython-39.pycnu �[��� PK =Au\X�Xeb b < �I% libfuturize/fixes/__pycache__/fix_oldstr_wrap.cpython-39.pycnu �[��� PK AAu\�JD;� � @ �O% libfuturize/fixes/__pycache__/fix_absolute_import.cpython-39.pycnu �[��� PK DAu\Iڭ ; �Y% libfuturize/fixes/__pycache__/fix_basestring.cpython-39.pycnu �[��� PK FAu\�&�˰ � B a]% libfuturize/fixes/__pycache__/fix_print_with_import.cpython-39.pycnu �[��� PK IAu\H�aU) ) ] �a% libfuturize/fixes/__pycache__/fix_add__future__imports_except_unicode_literals.cpython-39.pycnu �[��� PK KAu\ Yu � � > 9f% libfuturize/fixes/__pycache__/fix_division_safe.cpython-39.pycnu �[��� PK NAu\;ɧ�� � L �r% libfuturize/fixes/__pycache__/fix_remove_old__future__imports.cpython-39.pycnu �[��� PK PAu\�ވ H �w% libfuturize/fixes/__pycache__/fix_unicode_literals_import.cpython-39.pycnu �[��� PK VAu\*�� � $ {% libfuturize/fixes/fix_oldstr_wrap.pynu �[��� PK XAu\�S��b% b% " ��% libfuturize/fixes/fix_metaclass.pynu �[��� PK [Au\9�k0� � # E�% libfuturize/fixes/fix_basestring.pynu �[��� PK ]Au\C5��) ) "�% libfuturize/fixes/fix_print.pynu �[��� PK bAu\��em� � 7 ��% libfuturize/fixes/fix_future_standard_library_urllib.pynu �[��� PK dAu\6<��� � 0 �% libfuturize/fixes/fix_future_standard_library.pynu �[��� PK gAu\�䭫� � * &�% libfuturize/fixes/fix_print_with_import.pynu �[��� PK jAu\/�D�S S 4 _�% libfuturize/fixes/fix_remove_old__future__imports.pynu �[��� PK lAu\]�md/ / & �% libfuturize/fixes/fix_division_safe.pynu �[��� PK oAu\��� ' ��% libfuturize/fixes/fix_unicode_keep_u.pynu �[��� PK qAu\ 5�Io o 0 ��% libfuturize/fixes/fix_unicode_literals_import.pynu �[��� PK tAu\H�(�� � ( ��% libfuturize/fixes/fix_future_builtins.pynu �[��� PK vAu\:m�� � �% libfuturize/fixes/fix_object.pynu �[��� PK yAu\���/D D ( ��% libfuturize/fixes/fix_absolute_import.pynu �[��� PK {Au\ �h= = 0 ��% libfuturize/fixes/fix_order___future__imports.pynu �[��� PK �Au\ 4R .�% libfuturize/__init__.pynu �[��� PK �Au\��D� � / ��% libfuturize/__pycache__/__init__.cpython-39.pycnu �[��� PK �Au\i{< ;% ;% + ��% libfuturize/__pycache__/main.cpython-39.pycnu �[��� PK �Au\� �QQ. Q. 1 "& libfuturize/__pycache__/fixer_util.cpython-39.pycnu �[��� PK �Au\j��/�C �C �I& libfuturize/fixer_util.pynu �[��� PK �Au\�BPs�5 �5 �& libfuturize/main.pynu �[��� PK �Au\ ��& future/tests/__init__.pynu �[��� PK �Au\�:�x� � 0 �& future/tests/__pycache__/__init__.cpython-39.pycnu �[��� PK �Au\�o�A A , �& future/tests/__pycache__/base.cpython-39.pycnu �[��� PK �Au\t�{��M �M �' future/tests/base.pynu �[��� PK �Au\fa�z z �T' future/__init__.pynu �[��� PK �Au\n�� � � v`' future/builtins/misc.pynu �[��� PK �Au\���� � �r' future/builtins/new_min_max.pynu �[��� PK �Au\6���= = �y' future/builtins/disabled.pynu �[��� PK �Au\�C � � 6�' future/builtins/__init__.pynu �[��� PK �Au\�& t t �' future/builtins/iterators.pynu �[��� PK �Au\�Kh � � َ' future/builtins/newnext.pynu �[��� PK �Au\g��}� � 3 ��' future/builtins/__pycache__/__init__.cpython-39.pycnu �[��� PK �Au\�^ �� � 4 )�' future/builtins/__pycache__/iterators.cpython-39.pycnu �[��� PK �Au\0D � � 3 g�' future/builtins/__pycache__/newsuper.cpython-39.pycnu �[��� PK �Au\���V 3 ��' future/builtins/__pycache__/disabled.cpython-39.pycnu �[��� PK �Au\��]+� � / !�' future/builtins/__pycache__/misc.cpython-39.pycnu �[��� PK �Au\~"=,�
�
3 i�' future/builtins/__pycache__/newround.cpython-39.pycnu �[��� PK �Au\5��� � 2 ��' future/builtins/__pycache__/newnext.cpython-39.pycnu �[��� PK �Au\��Ï 6 ��' future/builtins/__pycache__/new_min_max.cpython-39.pycnu �[��� PK �Au\�� � p�' future/builtins/newsuper.pynu �[��� PK �Au\�H��v v ��' future/builtins/newround.pynu �[��� PK �Au\�D�� � * ��' future/__pycache__/__init__.cpython-39.pycnu �[��� PK �Au\Nw��* * �( future/types/newopen.pynu �[��� PK �Au\l��9�= �= E
( future/types/newstr.pynu �[��� PK �Au\��]� � H( future/types/__init__.pynu �[��� PK �Au\#6�� � c( future/types/newrange.pynu �[��� PK �Au\�� �� � x( future/types/newmemoryview.pynu �[��� PK �Au\���� � {( future/types/newlist.pynu �[��� PK �Au\�pU�^4 ^4 P�( future/types/newint.pynu �[��� PK �Au\E[�]� � �( future/types/newdict.pynu �[��� PK Bu\�
P^ ^ 0 �( future/types/__pycache__/__init__.cpython-39.pycnu �[��� PK Bu\��r�) ) / ��( future/types/__pycache__/newopen.cpython-39.pycnu �[��� PK Bu\�<� � / \�( future/types/__pycache__/newlist.cpython-39.pycnu �[��� PK Bu\^�Ty1 1 . ��( future/types/__pycache__/newint.cpython-39.pycnu �[��� PK Bu\h/�P
P
1 0 ) future/types/__pycache__/newobject.cpython-39.pycnu �[��� PK Bu\ %��� � 5 �') future/types/__pycache__/newmemoryview.cpython-39.pycnu �[��� PK Bu\�7�d� � / ,) future/types/__pycache__/newdict.cpython-39.pycnu �[��� PK Bu\�U`� � 0 6) future/types/__pycache__/newrange.cpython-39.pycnu �[��� PK Bu\w��/�8 �8 . SN) future/types/__pycache__/newstr.cpython-39.pycnu �[��� PK Bu\�JB�7 �7 0 w�) future/types/__pycache__/newbytes.cpython-39.pycnu �[��� PK Bu\ ���? �? ¿) future/types/newbytes.pynu �[��� PK Bu\��l�
��) future/types/newobject.pynu �[��� PK %Bu\��>��m �m #
* future/standard_library/__init__.pynu �[��� PK *Bu\��um�H �H ; {* future/standard_library/__pycache__/__init__.cpython-39.pycnu �[��� PK 1Bu\�W��� � �* future/moves/_markupbase.pynu �[��� PK 7Bu\���Q� � ��* future/moves/http/client.pynu �[��� PK 9Bu\�h�� � ��* future/moves/http/cookiejar.pynu �[��� PK <Bu\+�͉G G ��* future/moves/http/__init__.pynu �[��� PK CBu\�=�P P 6 z�* future/moves/http/__pycache__/cookiejar.cpython-39.pycnu �[��� PK EBu\C^Dl� � 5 0�* future/moves/http/__pycache__/__init__.cpython-39.pycnu �[��� PK HBu\��8 8 3 |�* future/moves/http/__pycache__/client.cpython-39.pycnu �[��� PK JBu\NPLf f 4 �* future/moves/http/__pycache__/cookies.cpython-39.pycnu �[��� PK MBu\)�R�# # 3 ��* future/moves/http/__pycache__/server.cpython-39.pycnu �[��� PK PBu\���� � g�* future/moves/http/cookies.pynu �[��� PK RBu\m�[�^ ^ ��* future/moves/http/server.pynu �[��� PK UBu\��Q � � E�* future/moves/copyreg.pynu �[��� PK ZBu\��NƱ � B�* future/moves/html/entities.pynu �[��� PK \Bu\�ù�� � @�* future/moves/html/__init__.pynu �[��� PK cBu\�|�WC C 5 ��* future/moves/html/__pycache__/__init__.cpython-39.pycnu �[��� PK fBu\�� �S S 5 -�* future/moves/html/__pycache__/entities.cpython-39.pycnu �[��� PK iBu\ \��K K 3 ��* future/moves/html/__pycache__/parser.cpython-39.pycnu �[��� PK kBu\^�R@� � ��* future/moves/html/parser.pynu �[��� PK pBu\+<b�D D ! ��* future/moves/tkinter/constants.pynu �[��� PK sBu\�U��5 5 �* future/moves/tkinter/font.pynu �[��� PK uBu\�3�G G " ��* future/moves/tkinter/messagebox.pynu �[��� PK xBu\%{0v2 2 4�* future/moves/tkinter/dnd.pynu �[��� PK {Bu\9� �. . ��* future/moves/tkinter/ttk.pynu �[��� PK }Bu\���l l *�* future/moves/tkinter/__init__.pynu �[��� PK �Bu\���7 7 ��* future/moves/tkinter/dialog.pynu �[��� PK �Bu\ ǚ� � 6 k�* future/moves/tkinter/__pycache__/dialog.cpython-39.pycnu �[��� PK �Bu\�"`� � < ��* future/moves/tkinter/__pycache__/commondialog.cpython-39.pycnu �[��� PK �Bu\��,� � 8 ��* future/moves/tkinter/__pycache__/__init__.cpython-39.pycnu �[��� PK �Bu\���� � 4 �* future/moves/tkinter/__pycache__/font.cpython-39.pycnu �[��� PK �Bu\dtO�� � : �* future/moves/tkinter/__pycache__/messagebox.cpython-39.pycnu �[��� PK �Bu\���c� � < �* future/moves/tkinter/__pycache__/colorchooser.cpython-39.pycnu �[��� PK �Bu\���� � 3 I�* future/moves/tkinter/__pycache__/tix.cpython-39.pycnu �[��� PK �Bu\�5��� � 3 Q�* future/moves/tkinter/__pycache__/ttk.cpython-39.pycnu �[��� PK �Bu\�&�P P : Y+ future/moves/tkinter/__pycache__/filedialog.cpython-39.pycnu �[��� PK �Bu\��� � 3 + future/moves/tkinter/__pycache__/dnd.cpython-39.pycnu �[��� PK �Bu\5þ� � 9 + future/moves/tkinter/__pycache__/constants.cpython-39.pycnu �[��� PK �Bu\� ml� � < I+ future/moves/tkinter/__pycache__/scrolledtext.cpython-39.pycnu �[��� PK �Bu\P�[$� � < ~
+ future/moves/tkinter/__pycache__/simpledialog.cpython-39.pycnu �[��� PK �Bu\�Ka;I I $ � + future/moves/tkinter/scrolledtext.pynu �[��� PK �Bu\�"��I I $ P+ future/moves/tkinter/simpledialog.pynu �[��� PK �Bu\�ޝM M $ �+ future/moves/tkinter/commondialog.pynu �[��� PK �Bu\hu'%. . �+ future/moves/tkinter/tix.pynu �[��� PK �Bu\ްs " + future/moves/tkinter/filedialog.pynu �[��� PK �Bu\{<N\M M $ o+ future/moves/tkinter/colorchooser.pynu �[��� PK �Bu\) � � � + future/moves/queue.pynu �[��� PK �Bu\5�K� � �+ future/moves/subprocess.pynu �[��� PK �Bu\]�)� :+ future/moves/builtins.pynu �[��� PK �Bu\'���� � �+ future/moves/__init__.pynu �[��� PK �Bu\�b�� � �+ future/moves/dbm/gnu.pynu �[��� PK �Bu\��Y�� � � + future/moves/dbm/ndbm.pynu �[��� PK �Bu\���� � � + future/moves/dbm/__init__.pynu �[��� PK �Bu\�k�� � 4 � + future/moves/dbm/__pycache__/__init__.cpython-39.pycnu �[��� PK �Bu\�|Eu> > 0 �!+ future/moves/dbm/__pycache__/ndbm.cpython-39.pycnu �[��� PK �Bu\��)�= = / �#+ future/moves/dbm/__pycache__/gnu.cpython-39.pycnu �[��� PK �Bu\ �'�B B 0 )%+ future/moves/dbm/__pycache__/dumb.cpython-39.pycnu �[��� PK �Bu\]
E�� � �&+ future/moves/dbm/dumb.pynu �[��� PK �Bu\���6� � �'+ future/moves/winreg.pynu �[��� PK �Bu\^CZے � �(+ future/moves/configparser.pynu �[��� PK �Bu\��3N� � �)+ future/moves/pickle.pynu �[��� PK �Bu\�=�� � 2 �*+ future/moves/__pycache__/subprocess.cpython-39.pycnu �[��� PK �Bu\�8 n? ? / �,+ future/moves/__pycache__/_thread.cpython-39.pycnu �[��� PK �Bu\�L��` ` 3 o.+ future/moves/__pycache__/collections.cpython-39.pycnu �[��� PK �Bu\�I�h h 0 21+ future/moves/__pycache__/__init__.cpython-39.pycnu �[��� PK �Bu\���À � 5 �2+ future/moves/__pycache__/_dummy_thread.cpython-39.pycnu �[��� PK �Bu\֙/�R R 1 �4+ future/moves/__pycache__/itertools.cpython-39.pycnu �[��� PK �Bu\&��n3 3 + �6+ future/moves/__pycache__/sys.cpython-39.pycnu �[��� PK Cu\���: : - 8+ future/moves/__pycache__/queue.cpython-39.pycnu �[��� PK Cu\�L��O O 4 �9+ future/moves/__pycache__/socketserver.cpython-39.pycnu �[��� PK Cu\ ���K K 3 j;+ future/moves/__pycache__/_markupbase.cpython-39.pycnu �[��� PK Cu\; �E= = / =+ future/moves/__pycache__/reprlib.cpython-39.pycnu �[��� PK
Cu\�ok5 5 4 �>+ future/moves/__pycache__/configparser.cpython-39.pycnu �[��� PK
Cu\���> > . M@+ future/moves/__pycache__/winreg.cpython-39.pycnu �[��� PK Cu\��@u u 7 �A+ future/moves/__pycache__/multiprocessing.cpython-39.pycnu �[��� PK Cu\�S�{a a 0 �C+ future/moves/__pycache__/builtins.cpython-39.pycnu �[��� PK Cu\^,�q q . �E+ future/moves/__pycache__/pickle.cpython-39.pycnu �[��� PK Cu\��n�y y / UG+ future/moves/__pycache__/copyreg.cpython-39.pycnu �[��� PK !Cu\w�
�� � -I+ future/moves/multiprocessing.pynu �[��� PK #Cu\�,�� � ;J+ future/moves/collections.pynu �[��� PK &Cu\��\ \ 'L+ future/moves/_dummy_thread.pynu �[��� PK +Cu\�
� � �M+ future/moves/xmlrpc/client.pynu �[��� PK /Cu\ �N+ future/moves/xmlrpc/__init__.pynu �[��� PK 2Cu\@֟�� � 7 �N+ future/moves/xmlrpc/__pycache__/__init__.cpython-39.pycnu �[��� PK 4Cu\�ז4 4 5 P+ future/moves/xmlrpc/__pycache__/client.cpython-39.pycnu �[��� PK 7Cu\���n4 4 5 �Q+ future/moves/xmlrpc/__pycache__/server.cpython-39.pycnu �[��� PK 9Cu\k\�!� � 5S+ future/moves/xmlrpc/server.pynu �[��� PK <Cu\��
� � T+ future/moves/sys.pynu �[��� PK CCu\�} �V V �T+ future/moves/urllib/response.pynu �[��� PK ECu\�U�jn n }V+ future/moves/urllib/__init__.pynu �[��� PK KCu\>�$ $ 6 :W+ future/moves/urllib/__pycache__/request.cpython-39.pycnu �[��� PK MCu\�`�g 4 �[+ future/moves/urllib/__pycache__/error.cpython-39.pycnu �[��� PK PCu\���BZ Z : 3^+ future/moves/urllib/__pycache__/robotparser.cpython-39.pycnu �[��� PK RCu\�V". 7 �_+ future/moves/urllib/__pycache__/__init__.cpython-39.pycnu �[��� PK UCu\�g�9� � 4 ya+ future/moves/urllib/__pycache__/parse.cpython-39.pycnu �[��� PK WCu\9<��� � 7 �d+ future/moves/urllib/__pycache__/response.cpython-39.pycnu �[��� PK ZCu\7�<�� � g+ future/moves/urllib/error.pynu �[��� PK ]Cu\�s6� Bi+ future/moves/urllib/parse.pynu �[��� PK aCu\���
�
�m+ future/moves/urllib/request.pynu �[��� PK dCu\|�� � " �{+ future/moves/urllib/robotparser.pynu �[��� PK fCu\�_�� � �|+ future/moves/itertools.pynu �[��� PK kCu\�U�jn n �}+ future/moves/test/__init__.pynu �[��� PK nCu\���� � @~+ future/moves/test/support.pynu �[��� PK sCu\��H� 5 p�+ future/moves/test/__pycache__/__init__.cpython-39.pycnu �[��� PK vCu\d�5a� � 4 �+ future/moves/test/__pycache__/support.cpython-39.pycnu �[��� PK yCu\Z9�p� � �+ future/moves/socketserver.pynu �[��� PK {Cu\ ��>� � ݅+ future/moves/_thread.pynu �[��� PK �Cu\�65�� � dž+ future/moves/reprlib.pynu �[��� PK �Cu\"vDW? W? ��+ future/backports/_markupbase.pynu �[��� PK �Cu\Sq"l'� '� U�+ future/backports/misc.pynu �[��� PK �Cu\2�� � �H, future/backports/http/client.pynu �[��� PK �Cu\3�2�@+ @+ " - future/backports/http/cookiejar.pynu �[��� PK �Cu\ ! �.. future/backports/http/__init__.pynu �[��� PK �Cu\af��z� z� : �.. future/backports/http/__pycache__/cookiejar.cpython-39.pycnu �[��� PK �Cu\�NTs� � 9 �/ future/backports/http/__pycache__/__init__.cpython-39.pycnu �[��� PK �Cu\ Ko�
x
x 7 �/ future/backports/http/__pycache__/client.cpython-39.pycnu �[��� PK �Cu\C��.�? �? 8 I{/ future/backports/http/__pycache__/cookies.cpython-39.pycnu �[��� PK �Cu\#@ACz� z� 7 e�/ future/backports/http/__pycache__/server.cpython-39.pycnu �[��� PK �Cu\���2MT MT FB0 future/backports/http/cookies.pynu �[��� PK �Cu\��Vӱ ӱ �0 future/backports/http/server.pynu �[��� PK �Cu\\�m�& �& ! I1 future/backports/html/entities.pynu �[��� PK �Cu\Qޅ� � ! �o2 future/backports/html/__init__.pynu �[��� PK �Cu\���e� � 9 �s2 future/backports/html/__pycache__/__init__.cpython-39.pycnu �[��� PK �Cu\�L��(� (� 9 Mx2 future/backports/html/__pycache__/entities.cpython-39.pycnu �[��� PK �Cu\Q *5 *5 7 �>3 future/backports/html/__pycache__/parser.cpython-39.pycnu �[��� PK �Cu\�FS�:M :M ot3 future/backports/html/parser.pynu �[��� PK �Cu\�H�g ��3 future/backports/__init__.pynu �[��� PK �Cu\X�h~/= /= V�3 future/backports/socket.pynu �[��� PK �Cu\'( g g 4 �4 future/backports/__pycache__/__init__.cpython-39.pycnu �[��� PK �Cu\lu1� �� 4 �4 future/backports/__pycache__/datetime.cpython-39.pycnu �[��� PK �Cu\�{�7 �7 2 ��4 future/backports/__pycache__/socket.cpython-39.pycnu �[��� PK �Cu\�]��p �p 0 ��4 future/backports/__pycache__/misc.cpython-39.pycnu �[��� PK �Cu\��lr�V �V 8 �n5 future/backports/__pycache__/socketserver.cpython-39.pycnu �[��� PK �Cu\B��u�$ �$ 7 ^�5 future/backports/__pycache__/_markupbase.cpython-39.pycnu �[��� PK �Cu\��-L� � : ��5 future/backports/__pycache__/total_ordering.cpython-39.pycnu �[��� PK �Cu\+&<<� � " ��5 future/backports/total_ordering.pynu �[��� PK �Cu\���J/� /� ! ��5 future/backports/xmlrpc/client.pynu �[��� PK �Cu\���I& & # 4�6 future/backports/xmlrpc/__init__.pynu �[��� PK �Cu\���C� � ; ��6 future/backports/xmlrpc/__pycache__/__init__.cpython-39.pycnu �[��� PK �Cu\>�D�� � 9 ��6 future/backports/xmlrpc/__pycache__/client.cpython-39.pycnu �[��� PK �Cu\���t �t 9 ?7 future/backports/xmlrpc/__pycache__/server.cpython-39.pycnu �[��� PK �Cu\ �_��� �� ! �7 future/backports/xmlrpc/server.pynu �[��� PK �Cu\����l l # F8 future/backports/urllib/response.pynu �[��� PK �Cu\ # �R8 future/backports/urllib/__init__.pynu �[��� PK Du\���c c : $S8 future/backports/urllib/__pycache__/request.cpython-39.pycnu �[��� PK Du\_S}�e
e
8 �c9 future/backports/urllib/__pycache__/error.cpython-39.pycnu �[��� PK Du\^��� � > �n9 future/backports/urllib/__pycache__/robotparser.cpython-39.pycnu �[��� PK Du\���ڥ � ; �9 future/backports/urllib/__pycache__/__init__.cpython-39.pycnu �[��� PK
Du\���!�p �p 8 �9 future/backports/urllib/__pycache__/parse.cpython-39.pycnu �[��� PK
Du\�U�@ @ ; -�9 future/backports/urllib/__pycache__/response.cpython-39.pycnu �[��� PK Du\+ ܓ�
�
�: future/backports/urllib/error.pynu �[��� PK Du\~LD�Ћ Ћ �: future/backports/urllib/parse.pynu �[��� PK Du\�Px x " �: future/backports/urllib/request.pynu �[��� PK Du\� �� � & I< future/backports/urllib/robotparser.pynu �[��� PK Du\P� �!' !' p3< future/backports/datetime.pynu �[��� PK #Du\��� " �Z= future/backports/test/keycert2.pemnu �[��� PK &Du\��g� � 2b= future/backports/test/dh512.pemnu �[��� PK (Du\���� ! d= future/backports/test/__init__.pynu �[��� PK +Du\��2�c c " le= future/backports/test/ssl_cert.pemnu �[��� PK .Du\̺v
3 !i= future/backports/test/https_svn_python_org_root.pemnu �[��� PK 0Du\���;� � ! �s= future/backports/test/ssl_key.pemnu �[��� PK 3Du\�C � � rw= future/backports/test/support.pynu �[��� PK 5Du\��� ��> future/backports/test/pystone.pynu �[��� PK :Du\d�|� � 9 �> future/backports/test/__pycache__/__init__.cpython-39.pycnu �[��� PK =Du\#( �S S 8 %�> future/backports/test/__pycache__/pystone.cpython-39.pycnu �[��� PK ADu\����� �� 8 �> future/backports/test/__pycache__/support.cpython-39.pycnu �[��� PK DDu\��E�� � < �? future/backports/test/__pycache__/ssl_servers.cpython-39.pycnu �[��� PK IDu\��|() ) $ *�? future/backports/test/ssl_servers.pynu �[��� PK LDu\'�q � � ��? future/backports/test/sha256.pemnu �[��� PK NDu\���; ; & ��? future/backports/test/nullbytecert.pemnu �[��� PK QDu\��|G� � @ future/backports/test/nokia.pemnu �[��� PK SDu\�,\� � ! �@ future/backports/test/keycert.pemnu �[��� PK VDu\ " :@ future/backports/test/nullcert.pemnu �[��� PK VDu\<�& & ( �@ future/backports/test/keycert.passwd.pemnu �[��� PK YDu\�<��� � (
@ future/backports/test/ssl_key.passwd.pemnu �[��� PK [Du\0,5� � ! %"@ future/backports/test/badcert.pemnu �[��� PK `Du\�
��r r �)@ future/backports/test/badkey.pemnu �[��� PK bDu\��t�^ �^ �2@ future/backports/socketserver.pynu �[��� PK gDu\dd��� � . �@ future/backports/email/_header_value_parser.pynu �[��� PK jDu\7L�� D D ! @+B future/backports/email/charset.pynu �[��� PK lDu\髠��X �X $ �oB future/backports/email/feedparser.pynu �[��� PK oDu\��@L @L # ��B future/backports/email/generator.pynu �[��� PK rDu\����� � " gC future/backports/email/__init__.pynu �[��� PK tDu\�'�79 79 % � C future/backports/email/_policybase.pynu �[��� PK wDu\��0�, , # "XC future/backports/email/iterators.pynu �[��� PK yDu\)��� � ( �aC future/backports/email/_encoded_words.pynu �[��� PK |Du\���C �C $ �C future/backports/email/_parseaddr.pynu �[��� PK �Du\P�U�
�
" 5�C future/backports/email/encoders.pynu �[��� PK �Du\���fB fB 8 w�C future/backports/email/__pycache__/header.cpython-39.pycnu �[��� PK �Du\��� � � : ED future/backports/email/__pycache__/__init__.cpython-39.pycnu �[��� PK �Du\+��m m ; � D future/backports/email/__pycache__/iterators.cpython-39.pycnu �[��� PK �Du\y�
��R �R @ l&D future/backports/email/__pycache__/headerregistry.cpython-39.pycnu �[��� PK �Du\�yI� � @ �yD future/backports/email/__pycache__/_encoded_words.cpython-39.pycnu �[��� PK �Du\=ި� 9 9 = �D future/backports/email/__pycache__/_policybase.cpython-39.pycnu �[��� PK �Du\�L�
� � 8 ��D future/backports/email/__pycache__/policy.cpython-39.pycnu �[��� PK �Du\UKj^�) �) < ��D future/backports/email/__pycache__/feedparser.cpython-39.pycnu �[��� PK �Du\�{�/�
�
< �E future/backports/email/__pycache__/base64mime.cpython-39.pycnu �[��� PK �Du\4t_N$ N$ < �$E future/backports/email/__pycache__/quoprimime.cpython-39.pycnu �[��� PK �Du\����- �- ; cIE future/backports/email/__pycache__/generator.cpython-39.pycnu �[��� PK �Du\��g��o �o 9 �wE future/backports/email/__pycache__/message.cpython-39.pycnu �[��� PK �Du\�� �X. X. 9 ��E future/backports/email/__pycache__/charset.cpython-39.pycnu �[��� PK �Du\�H�rj j : �F future/backports/email/__pycache__/encoders.cpython-39.pycnu �[��� PK �Du\��N�x( x( 7 w F future/backports/email/__pycache__/utils.cpython-39.pycnu �[��� PK �Du\�ɐ� � 8 VHF future/backports/email/__pycache__/parser.cpython-39.pycnu �[��� PK �Du\�m}^1 1 < l`F future/backports/email/__pycache__/_parseaddr.cpython-39.pycnu �[��� PK �Du\�n^r 8 �F future/backports/email/__pycache__/errors.cpython-39.pycnu �[��� PK �Du\ �}�8 �8 F j�F future/backports/email/__pycache__/_header_value_parser.cpython-39.pycnu �[��� PK �Du\)��!�* �* $ ��G future/backports/email/quoprimime.pynu �[��� PK �Du\Wxl� � �
H future/backports/email/parser.pynu �[��� PK �Du\�';�P �P ( �"H future/backports/email/headerregistry.pynu �[��� PK �Du\ӌ��_ �_ �sH future/backports/email/header.pynu �[��� PK �Du\��Ա � $ ��H future/backports/email/base64mime.pynu �[��� PK �Du\6ޜ�@ @ + ��H future/backports/email/mime/nonmultipart.pynu �[��� PK �Du\ ' &�H future/backports/email/mime/__init__.pynu �[��� PK �Du\ԁy y * }�H future/backports/email/mime/application.pynu �[��� PK �Du\� �?�
�
< P�H future/backports/email/mime/__pycache__/audio.cpython-39.pycnu �[��� PK �Du\��a;� � ? ��H future/backports/email/mime/__pycache__/__init__.cpython-39.pycnu �[��� PK �Du\��~j j @ ��H future/backports/email/mime/__pycache__/multipart.cpython-39.pycnu �[��� PK �Du\�d�L L B ��H future/backports/email/mime/__pycache__/application.cpython-39.pycnu �[��� PK �Du\�X�M M ; EI future/backports/email/mime/__pycache__/base.cpython-39.pycnu �[��� PK �Du\^th� � C �
I future/backports/email/mime/__pycache__/nonmultipart.cpython-39.pycnu �[��� PK �Du\��q � � > )I future/backports/email/mime/__pycache__/message.cpython-39.pycnu �[��� PK �Du\,��� < :I future/backports/email/mime/__pycache__/image.cpython-39.pycnu �[��� PK �Du\�[��� � ; � I future/backports/email/mime/__pycache__/text.cpython-39.pycnu �[��� PK �Du\v�� # �#I future/backports/email/mime/text.pynu �[��� PK �Du\R�t� � ( :*I future/backports/email/mime/multipart.pynu �[��� PK �Du\�� ֕ � & 51I future/backports/email/mime/message.pynu �[��� PK �Du\�s ��
�
$ 7I future/backports/email/mime/audio.pynu �[��� PK �Du\�G�k k # sBI future/backports/email/mime/base.pynu �[��� PK �Du\�6�s s $ 1FI future/backports/email/mime/image.pynu �[��� PK �Du\��d��� �� ! �MI future/backports/email/message.pynu �[��� PK �Du\-��/�7 �7 ��I future/backports/email/utils.pynu �[��� PK Eu\!��{` ` �J future/backports/email/errors.pynu �[��� PK Eu\ӥ�w" w" � J future/backports/email/policy.pynu �[��� PK Eu\:���U �U rAJ future/utils/__init__.pynu �[��� PK Eu\��ާO �O 0 ��J future/utils/__pycache__/__init__.cpython-39.pycnu �[��� PK Eu\0��� � 7 ��J future/utils/__pycache__/surrogateescape.cpython-39.pycnu �[��� PK Eu\
�Z� � �J future/utils/surrogateescape.pynu �[��� PK #Eu\ �K distro/py.typednu �[��� PK #Eu\�`p�� � 7K distro/__init__.pynu �[��� PK %Eu\ T�i@ @ NK distro/__main__.pynu �[��� PK +Eu\�n$i i * �K distro/__pycache__/__init__.cpython-39.pycnu �[��� PK .Eu\y�
P� P� ( �K distro/__pycache__/distro.cpython-39.pycnu �[��� PK 0Eu\�2�� � * ;�K distro/__pycache__/__main__.cpython-39.pycnu �[��� PK 3Eu\J:mk� � r�K distro/distro.pynu �[��� PK 8Eu\� +[ [ �L agent360-1.3.1.dist-info/WHEELnu �[��� PK ;Eu\�fc�3 3 q�L agent360-1.3.1.dist-info/LICENSEnu �[��� PK =Eu\#X�D& D& �L agent360-1.3.1.dist-info/RECORDnu �[��� PK BEu\��� � ! ��L agent360-1.3.1.dist-info/METADATAnu �[��� PK DEu\ " ��L agent360-1.3.1.dist-info/REQUESTEDnu �[��� PK DEu\ r�m & ֿL agent360-1.3.1.dist-info/top_level.txtnu �[��� PK GEu\ ��W W ) 5�L agent360-1.3.1.dist-info/entry_points.txtnu �[��� PK IEu\� �� " �L agent360-1.3.1.dist-info/INSTALLERnu �[��� PK NEu\�e@�o �o ;�L agent360/agent360.pynu �[��� PK QEu\ j1M agent360/__init__.pynu �[��� PK TEu\�ǎ] ] �1M agent360/plugins/ping.pynu �[��� PK VEu\z8� � S>M agent360/plugins/redis_stat.pynu �[��� PK YEu\gԒr
r
�TM agent360/plugins/docker.pynu �[��� PK [Eu\���I�
�
LbM agent360/plugins/phpfpm.pynu �[��� PK `Eu\��p_� � smM agent360/plugins/asterisk.pynu �[��� PK bEu\�� #, , �qM agent360/plugins/kamailio.pynu �[��� PK eEu\�q�� � +tM agent360/plugins/plugins.pynu �[��� PK hEu\<'�
�
`~M agent360/plugins/network.pynu �[��� PK kEu\9�� ��M agent360/plugins/dovecot.pynu �[��� PK mEu\4�<�� � ! �M agent360/plugins/plesk-cgroups.pynu �[��� PK pEu\�ܓ� � ��M agent360/plugins/gpu.pynu �[��� PK rEu\a� � �M agent360/plugins/unbound.pynu �[��� PK uEu\��.= = @�M agent360/plugins/powerdns.pynu �[��� PK xEu\�h)pj j ��M agent360/plugins/proftpd.pynu �[��� PK zEu\�M�l l ~�M agent360/plugins/swap.pynu �[��� PK }Eu\�%�* * $ 2�M agent360/plugins/cloudlinux-dbgov.pynu �[��� PK �Eu\����
�
��M agent360/plugins/rabbitmq.pynu �[��� PK �Eu\ ��M agent360/plugins/__init__.pynu �[��� PK �Eu\�h��� � 9�M agent360/plugins/bind.pynu �[��� PK �Eu\&:0�G G ]�M agent360/plugins/cpu_freq.pynu �[��� PK �Eu\��3] ] ��M agent360/plugins/memcached.pynu �[��� PK �Eu\�F�?
��M agent360/plugins/process.pynu �[��� PK �Eu\ϣYi� � �N agent360/plugins/postfix.pynu �[��� PK �Eu\���� � +N agent360/plugins/memory.pynu �[��� PK �Eu\�;��� � N agent360/plugins/haproxy.pynu �[��� PK �Eu\`�4� � %N agent360/plugins/cloudlinux.pynu �[��� PK �Eu\;l� � � `)N agent360/plugins/vms.pynu �[��� PK �Eu\Y/@G� � wBN agent360/plugins/diskinodes.pynu �[��� PK �Eu\���˯ � QEN agent360/plugins/openvpn.pynu �[��� PK �Eu\�\��� � KNN agent360/plugins/nginx.pynu �[��� PK �Eu\����l l _[N agent360/plugins/mdstat.pynu �[��� PK �Eu\��? ? aN agent360/plugins/fail2ban.pynu �[��� PK �Eu\ "22� � 3 �dN agent360/plugins/__pycache__/megacli.cpython-39.pycnu �[��� PK �Eu\1oF F 2 �lN agent360/plugins/__pycache__/iostat.cpython-39.pycnu �[��� PK �Eu\ ��/{ { 2 -xN agent360/plugins/__pycache__/phpfpm.cpython-39.pycnu �[��� PK �Eu\3�c�` ` 3
�N agent360/plugins/__pycache__/haproxy.cpython-39.pycnu �[��� PK �Eu\���� � 6 ͊N agent360/plugins/__pycache__/diskinodes.cpython-39.pycnu �[��� PK �Eu\�YL�^ ^ 6 �N agent360/plugins/__pycache__/wp-toolkit.cpython-39.pycnu �[��� PK �Eu\��r�m m 1 ƖN agent360/plugins/__pycache__/mysql.cpython-39.pycnu �[��� PK �Eu\tlT� � 4 ��N agent360/plugins/__pycache__/__init__.cpython-39.pycnu �[��� PK �Eu\�d�= = 1 ��N agent360/plugins/__pycache__/nginx.cpython-39.pycnu �[��� PK �Eu\(ʠ�a a 4 4�N agent360/plugins/__pycache__/tcpports.cpython-39.pycnu �[��� PK �Eu\#��} } 3 ��N agent360/plugins/__pycache__/openvpn.cpython-39.pycnu �[��� PK �Eu\%�I? ? 4 ٺN agent360/plugins/__pycache__/asterisk.cpython-39.pycnu �[��� PK �Eu\��
�� � 1 |�N agent360/plugins/__pycache__/janus.cpython-39.pycnu �[��� PK �Eu\��f� � 6 ��N agent360/plugins/__pycache__/cloudlinux.cpython-39.pycnu �[��� PK �Eu\=ߘ�Q Q 2 ��N agent360/plugins/__pycache__/cpanel.cpython-39.pycnu �[��� PK �Eu\��?�} } 3 \�N agent360/plugins/__pycache__/dirsize.cpython-39.pycnu �[��� PK �Eu\�5ۛr r 0 <�N agent360/plugins/__pycache__/temp.cpython-39.pycnu �[��� PK �Eu\�߷
� � 4 �N agent360/plugins/__pycache__/kamailio.cpython-39.pycnu �[��� PK �Eu\�!X�� � 0 W�N agent360/plugins/__pycache__/bind.cpython-39.pycnu �[��� PK �Eu\��|�� � 1 ��N agent360/plugins/__pycache__/mailq.cpython-39.pycnu �[��� PK �Eu\�o�^� � 4
�N agent360/plugins/__pycache__/powerdns.cpython-39.pycnu �[��� PK �Eu\��z`� � 6 <�N agent360/plugins/__pycache__/diskstatus.cpython-39.pycnu �[��� PK �Eu\ �+�} } 7 \�N agent360/plugins/__pycache__/apt-updates.cpython-39.pycnu �[��� PK �Eu\�Nr / @�N agent360/plugins/__pycache__/cpu.cpython-39.pycnu �[��� PK �Eu\z`�3t
t
2 �O agent360/plugins/__pycache__/docker.cpython-39.pycnu �[��� PK �Eu\��X��
�
5 z
O agent360/plugins/__pycache__/diskusage.cpython-39.pycnu �[��� PK �Eu\ �H� 2 �O agent360/plugins/__pycache__/memory.cpython-39.pycnu �[��� PK �Eu\_���, , 3 O agent360/plugins/__pycache__/sleeper.cpython-39.pycnu �[��� PK �Eu\� ��� � / � O agent360/plugins/__pycache__/vms.cpython-39.pycnu �[��� PK Fu\��|�� � 2 �2O agent360/plugins/__pycache__/mdstat.cpython-39.pycnu �[��� PK Fu\�p
2 0 �7O agent360/plugins/__pycache__/exim.cpython-39.pycnu �[��� PK Fu\0s s 0 !;O agent360/plugins/__pycache__/swap.cpython-39.pycnu �[��� PK Fu\(��B& & 0 �=O agent360/plugins/__pycache__/bird.cpython-39.pycnu �[��� PK
Fu\�CPo o 3 zBO agent360/plugins/__pycache__/network.cpython-39.pycnu �[��� PK Fu\] �
�
9 LIO agent360/plugins/__pycache__/plesk-cgroups.cpython-39.pycnu �[��� PK Fu\ 8�c� � 9 �TO agent360/plugins/__pycache__/elasticsearch.cpython-39.pycnu �[��� PK Fu\=B��B B 7 �cO agent360/plugins/__pycache__/yum-updates.cpython-39.pycnu �[��� PK Fu\�7z�� � 5 �hO agent360/plugins/__pycache__/minecraft.cpython-39.pycnu �[��� PK Fu\y��� � < �qO agent360/plugins/__pycache__/cloudlinux-dbgov.cpython-39.pycnu �[��� PK Fu\�
��f f 1
wO agent360/plugins/__pycache__/httpd.cpython-39.pycnu �[��� PK Fu\z=�S S 4 рO agent360/plugins/__pycache__/fail2ban.cpython-39.pycnu �[��� PK Fu\�+|�Z Z 3 ��O agent360/plugins/__pycache__/dovecot.cpython-39.pycnu �[��� PK #Fu\^e�& 0 E�O agent360/plugins/__pycache__/ping.cpython-39.pycnu �[��� PK %Fu\ź[J� � 3 ��O agent360/plugins/__pycache__/postfix.cpython-39.pycnu �[��� PK (Fu\(�؟X X 3 �O agent360/plugins/__pycache__/proftpd.cpython-39.pycnu �[��� PK +Fu\� -�� � 4 ��O agent360/plugins/__pycache__/bitninja.cpython-39.pycnu �[��� PK -Fu\Efo� � 3 �O agent360/plugins/__pycache__/mongodb.cpython-39.pycnu �[��� PK 0Fu\ZJPnc c 3 ζO agent360/plugins/__pycache__/loadavg.cpython-39.pycnu �[��� PK 2Fu\8�+�� � 5 ��O agent360/plugins/__pycache__/litespeed.cpython-39.pycnu �[��� PK 5Fu\F�u[� � 5 ��O agent360/plugins/__pycache__/memcached.cpython-39.pycnu �[��� PK 7Fu\q *�$
$
3 ��O agent360/plugins/__pycache__/plugins.cpython-39.pycnu �[��� PK :Fu\���� � ; "�O agent360/plugins/__pycache__/diskstatus-nvme.cpython-39.pycnu �[��� PK <Fu\�C�� 3 y�O agent360/plugins/__pycache__/unbound.cpython-39.pycnu �[��� PK DFu\"��
�
3 ��O agent360/plugins/__pycache__/process.cpython-39.pycnu �[��� PK FFu\�e3 3 2 M�O agent360/plugins/__pycache__/system.cpython-39.pycnu �[��� PK IFu\� �^ ^ 4 �P agent360/plugins/__pycache__/rabbitmq.cpython-39.pycnu �[��� PK KFu\+��ױ � 4 �
P agent360/plugins/__pycache__/loggedin.cpython-39.pycnu �[��� PK NFu\�4�� � 6 �P agent360/plugins/__pycache__/redis_stat.cpython-39.pycnu �[��� PK PFu\�7�� � 4 �P agent360/plugins/__pycache__/cpu_freq.cpython-39.pycnu �[��� PK SFu\}5�- - / )P agent360/plugins/__pycache__/gpu.cpython-39.pycnu �[��� PK XFu\��G!, , � P agent360/plugins/diskusage.pynu �[��� PK [Fu\�����
�
.0P agent360/plugins/megacli.pynu �[��� PK ]Fu\u��I I \;P agent360/plugins/bird.pynu �[��� PK bFu\wQ=�L L �>P agent360/plugins/loadavg.pynu �[��� PK dFu\3���� � �@P agent360/plugins/apt-updates.pynu �[��� PK gFu\QfF'� � �EP agent360/plugins/loggedin.pynu �[��� PK iFu\�� (j j �GP agent360/plugins/minecraft.pynu �[��� PK lFu\?���
�
RQP agent360/plugins/httpd.pynu �[��� PK oFu\��a� �\P agent360/plugins/mailq.pynu �[��� PK qFu\[�H � � ! �^P agent360/plugins/elasticsearch.pynu �[��� PK tFu\L�̆ +pP agent360/plugins/bitninja.pynu �[��� PK vFu\蔱_� � �uP agent360/plugins/mysql.pynu �[��� PK yFu\��`�� � ^�P agent360/plugins/system.pynu �[��� PK {Fu\���i i [�P agent360/plugins/dirsize.pynu �[��� PK �Fu\�=�* * �P agent360/plugins/yum-updates.pynu �[��� PK �Fu\��Ԭ� � ��P agent360/plugins/cpanel.pynu �[��� PK �Fu\(.�* * s�P agent360/plugins/litespeed.pynu �[��� PK �Fu\Q}2~� � �P agent360/plugins/temp.pynu �[��� PK �Fu\�S�bk k ��P agent360/plugins/iostat.pynu �[��� PK �Fu\ݢ�M� � ��P agent360/plugins/mongodb.pynu �[��� PK �Fu\�Q� V V ��P agent360/plugins/tcpports.pynu �[��� PK �Fu\BE�� � "�P agent360/plugins/janus.pynu �[��� PK �Fu\��3�R R # ,�P agent360/plugins/diskstatus-nvme.pynu �[��� PK �Fu\6��5 5 �P agent360/plugins/wp-toolkit.pynu �[��� PK �Fu\S�@� � TQ agent360/plugins/sleeper.pynu �[��� PK �Fu\El� � � �Q agent360/plugins/exim.pynu �[��� PK �Fu\?'�b� � �Q agent360/plugins/diskstatus.pynu �[��� PK �Fu\�$��� � � Q agent360/plugins/cpu.pynu �[��� PK �Fu\G�c�� � ,
Q agent360/__pycache__/__init__.cpython-39.pycnu �[��� PK �Fu\��S@�I �I , �Q agent360/__pycache__/agent360.cpython-39.pycnu �[��� PK �Fu\��IR� � $ 9`Q libpasteurize/fixes/fix_unpacking.pynu �[��� PK �Fu\�{�� � # &xQ libpasteurize/fixes/fix_division.pynu �[��� PK �Fu\�g � � ( |Q libpasteurize/fixes/fix_printfunction.pynu �[��� PK �Fu\�}'�s
s
# �}Q libpasteurize/fixes/fix_features.pynu �[��� PK �Fu\�5�i i ! ��Q libpasteurize/fixes/fix_getcwd.pynu �[��� PK �Fu\a ��� � 3 j�Q libpasteurize/fixes/fix_add_all__future__imports.pynu �[��� PK �Fu\ k�4� � q�Q libpasteurize/fixes/__init__.pynu �[��� PK �Fu\mg_K K G�Q libpasteurize/fixes/fix_raise.pynu �[��� PK �Fu\�x x # �Q libpasteurize/fixes/fix_newstyle.pynu �[��� PK �Fu\ ��C C ��Q libpasteurize/fixes/fix_throw.pynu �[��� PK �Fu\T�� � � B @�Q libpasteurize/fixes/__pycache__/fix_future_builtins.cpython-39.pycnu �[��� PK �Fu\C��� � 9 ��Q libpasteurize/fixes/__pycache__/fix_raise_.cpython-39.pycnu �[��� PK �Fu\`��+� � ; ��Q libpasteurize/fixes/__pycache__/fix_features.cpython-39.pycnu �[��� PK �Fu\Y��. K �Q libpasteurize/fixes/__pycache__/fix_add_all__future__imports.cpython-39.pycnu �[��� PK �Fu\�6u�8 8 7 z�Q libpasteurize/fixes/__pycache__/__init__.cpython-39.pycnu �[��� PK �Fu\��<9 9 ; �Q libpasteurize/fixes/__pycache__/fix_division.cpython-39.pycnu �[��� PK �Fu\���=� � J ��Q libpasteurize/fixes/__pycache__/fix_add_all_future_builtins.cpython-39.pycnu �[��� PK �Fu\$�J J : ��Q libpasteurize/fixes/__pycache__/fix_imports.cpython-39.pycnu �[��� PK �Fu\WY�� � ; ��Q libpasteurize/fixes/__pycache__/fix_newstyle.cpython-39.pycnu �[��� PK �Fu\�`��� � 8 ��Q libpasteurize/fixes/__pycache__/fix_throw.cpython-39.pycnu �[��� PK �Fu\�!� @ ��Q libpasteurize/fixes/__pycache__/fix_printfunction.cpython-39.pycnu �[��� PK �Fu\��LY� � 7 %�Q libpasteurize/fixes/__pycache__/fix_next.cpython-39.pycnu �[��� PK �Fu\�BE. . 8 ��Q libpasteurize/fixes/__pycache__/fix_raise.cpython-39.pycnu �[��� PK Gu\��k� � > �Q libpasteurize/fixes/__pycache__/fix_annotations.cpython-39.pycnu �[��� PK Gu\ �Ʊ� � 9 R libpasteurize/fixes/__pycache__/fix_kwargs.cpython-39.pycnu �[��� PK Gu\����� � U R libpasteurize/fixes/__pycache__/fix_add_future_standard_library_import.cpython-39.pycnu �[��� PK Gu\�ƹ P P 9 rR libpasteurize/fixes/__pycache__/fix_getcwd.cpython-39.pycnu �[��� PK Gu\$�@
@
; +R libpasteurize/fixes/__pycache__/feature_base.cpython-39.pycnu �[��� PK
Gu\�h?� � = �$R libpasteurize/fixes/__pycache__/fix_memoryview.cpython-39.pycnu �[��� PK Gu\Z�q�� � < �(R libpasteurize/fixes/__pycache__/fix_metaclass.cpython-39.pycnu �[��� PK Gu\@7]�O O < 1R libpasteurize/fixes/__pycache__/fix_unpacking.cpython-39.pycnu �[��� PK Gu\�oƺq q ; �GR libpasteurize/fixes/__pycache__/fix_imports2.cpython-39.pycnu �[��� PK Gu\���J J > �_R libpasteurize/fixes/__pycache__/fix_fullargspec.cpython-39.pycnu �[��� PK Gu\ -�B� � $ `cR libpasteurize/fixes/fix_metaclass.pynu �[��� PK !Gu\j�hS�! �! # ppR libpasteurize/fixes/fix_imports2.pynu �[��� PK $Gu\C7YV� � " G�R libpasteurize/fixes/fix_imports.pynu �[��� PK 'Gu\4<ǻ� � & ;�R libpasteurize/fixes/fix_fullargspec.pynu �[��� PK )Gu\��1�- - & G�R libpasteurize/fixes/fix_annotations.pynu �[��� PK ,Gu\VX@�g g ! ʮR libpasteurize/fixes/fix_kwargs.pynu �[��� PK .Gu\n`��� � 2 ��R libpasteurize/fixes/fix_add_all_future_builtins.pynu �[��� PK 1Gu\# �' ' % ��R libpasteurize/fixes/fix_memoryview.pynu �[��� PK 3Gu\�� � U�R libpasteurize/fixes/fix_next.pynu �[��� PK 6Gu\%P�� � * u�R libpasteurize/fixes/fix_future_builtins.pynu �[��� PK 8Gu\w�y� � ! y�R libpasteurize/fixes/fix_raise_.pynu �[��� PK ;Gu\F1}� � # ��R libpasteurize/fixes/feature_base.pynu �[��� PK @Gu\�bXї � = ��R libpasteurize/fixes/fix_add_future_standard_library_import.pynu �[��� PK EGu\ 4R ��R libpasteurize/__init__.pynu �[��� PK JGu\!A� � 1
�R libpasteurize/__pycache__/__init__.cpython-39.pycnu �[��� PK LGu\��^a� � - �R libpasteurize/__pycache__/main.cpython-39.pycnu �[��� PK OGu\^�� � `S libpasteurize/main.pynu �[��� PK ��� �!S