python-gnupg-0.4.8/0000775000175000017500000000000014147404120014457 5ustar vinayvinay00000000000000python-gnupg-0.4.8/test_secring.gpg0000644000175000017500000001510413464745246017670 0ustar vinayvinay00000000000000S=3vDd4OKbm8x>>MP`p [%"Rh뼿gf%7$ӟ1`гvy3/qӆw[.X1Lׁ ԶGr'(sS*ޜ>qM)%.^3}9r1ىxKk2P(vS\}Au@ۂ4=yRtpk;Wem75Ys e*&bBʱ)cZ`as !^jq NޥMOr}y?'pQ5&QNտt~Bg℥p t.4 <(HZ5F1G|dM7jRΧd3Zlz;`KjؠDw1`DSeneF+%(A9OXD4xsu-F-tֳc $PFgk܏iDF}=nACEН $JK"![A2f%Hj\aϙOm-٭zIq$Gіy hkda?zqE$LU{/]//}G~{cASU{Uvkn>Ga=Ѣ#=̛ɢ\=s+tk;'vw/T5xX17$Z BYϣIQHZʩ]jtͽȸ F63EHXhCv>BrԸ D8NM;^Jr W,cRt/!0)l{˷*WtA$gkPEQ)T\acIe *Yw]}n1Andrew Able (A test user) 8"S/   ЮLw?av=dmEK9S QdlO]g8WJPNA,cnm6>TI\ w7|@^^#o0طs;Юx}.җ>$4P[cdbSr\Cܻ=A2yL,\/UA1{TQ2l?r?ev[ fWVE5=Ά51 ?lON:zx|qbtVcS=|,Րa'~I|-^/ZP,|NEP-י1U r^wkH rU}b4 H*2kCt!>YŠ|O+Rj env#G\טws;: '/+пJ/B9)}"Zd.M#k׶Mik;RykGYjazJ57ֆ>.咱2T1~7%汘QUrC i]PvױB J _$Pd.!Em,W׀rD^fGum}>5wFvbA spˮBX%S#Uّ: &$%3?챒̙ $ Jլ=Dg#^ Go9ڶW#Kc)CRmy/~_3gv` JZ`xX  v85swߥ','_f@6ؼMJ/!ek>b %t;|d S ЮLw-E?ǧR_ B'מ%ua؄~mo3JG_R}ikj2Kb#Z{ԅ^XrvBU)t4:dj6?%ߣ[yK*2w*03B&ڒl α(uQWXC4F̸t0ꈢz-3RP!O2Bu :cA nA!phˠOzxSyХb޹ a֡ ^۱J]ǟH {<+P:ZvMyS!);TϫcpsV tyGޤsA͔Jrn]ˏ<՟m>7 >^qd9cO'{'q?aZ ^O΂S)N찀8"S/   )gOԸh$AIvc45\ =`mLp;[A Bho3+[/g^ < 0澶d1:Zd1B"hh!ݮ'1"\]. j 2i:>$i5G':8hX%{J׃xc5SrGҜkcUԲL)Nx NRZenD|ȼdm{*u 9Һ&ZJE cSw%P_}i @#Lxh,[Y^Tu<]uލX8T}6,W% ߚ}ia6W?Ҙ.<~1 yj;V9%vt[W-:Q^@ -$z JM=hy {(ȚŚb6󠈵% k=]yɭ2Ѭɖt}2@~ɨGS+㒄?!ɖ }WPLsǙ%+7&w!oj3mjî븸>ʚ+q{Y c[A4Kz|^|mD8e?P>/G::>"YV=^M#C8̰c}S(ɐ`0qEzsW=ֿf*" ,,_RJMN*7ZM#fI:Bm81Ëm) S )gOԸ 2ĝ3X1^?FāE"cLWMG4U؛x0MC_4F\"͛XaέTD֨n ںڕCz7 Μ C)!+{mڷitu7u@䝒jӑ15rߟU$6“qV>TH@PG2aѠ6sAY#u[g o\pAh<~gF@%an.ܞ;W̟]&X`@xy9 ^SJ6:ר5Et_hGJP3w ũUJg(T9#fDg(i9%uWT[yLI8܍xaf!՟P,)͛pZE[P_ HiE.ΓpZz}Nz?GH'. 'fyn fPtXs*7T?#^>8AdY-V0~n{*!a?TгfG{sNU_uMr'/hPted`aJLImdd)loKZb,/0R0W%p9 7PFfzD+"S5Charlie Clark (A test user) 8"S/   sƷ؋Qa"7׌:a`-;.ݛ6K|G{W  IG*:~/jɩAߏIna__P^ OJ4]- 螨[~J6yRag'nj ,Ur["bH"W.Z"+qFi{a?y$*2vG2G v L̪Ȯ)N8 fSXRBDH.6ۓIb6cSgH7

4nca+YS]&rd'U zT\@;uxꎐB?YG/IH2uB"Bhʨu]$HOd?mc6Z?jąt֋ lIyLd&Vz}@/E bPQyM=.Ѿ9Ĩު3ry[dCLF A`Ȕ;7;VsyN~ `)Ylu &.l$!?k qe>*p8v`7NÉ S sƷ؋QPZMvEfFi(Lg͋: F8aa:8/ux]Nu O[Tw\D8? -(vBH"r6okgt=ƼGܼHvܢ_=+0*,zI瓗xt)RLv3Nq J䤊6aBIW(?f%_Paڥx/f>{.j]/=8v.k72Z2#4⅀python-gnupg-0.4.8/python_gnupg.egg-info/0000775000175000017500000000000014147404120020672 5ustar vinayvinay00000000000000python-gnupg-0.4.8/python_gnupg.egg-info/SOURCES.txt0000644000175000017500000000041414147404117022561 0ustar vinayvinay00000000000000LICENSE.txt MANIFEST.in README.rst gnupg.py messages.json setup.cfg setup.py test_gnupg.py test_pubring.gpg test_secring.gpg python_gnupg.egg-info/PKG-INFO python_gnupg.egg-info/SOURCES.txt python_gnupg.egg-info/dependency_links.txt python_gnupg.egg-info/top_level.txtpython-gnupg-0.4.8/python_gnupg.egg-info/top_level.txt0000644000175000017500000000000614147404117023424 0ustar vinayvinay00000000000000gnupg python-gnupg-0.4.8/python_gnupg.egg-info/PKG-INFO0000644000175000017500000000346214147404117022000 0ustar vinayvinay00000000000000Metadata-Version: 1.2 Name: python-gnupg Version: 0.4.8 Summary: A wrapper for the Gnu Privacy Guard (GPG or GnuPG) Home-page: https://docs.red-dove.com/python-gnupg/ Author: Vinay Sajip Author-email: vinay_sajip@yahoo.co.uk Maintainer: Vinay Sajip Maintainer-email: vinay_sajip@yahoo.co.uk License: Copyright (C) 2008-2021 by Vinay Sajip. All Rights Reserved. See LICENSE.txt for license. Download-URL: https://pypi.io/packages/source/p/python-gnupg/python-gnupg-0.4.8.tar.gz Description: This module allows easy access to GnuPG's key management, encryption and signature functionality from Python programs. It is intended for use with Python 2.4 or greater. Releases are normally signed using a GnuPG key with the user id vinay_sajip@yahoo.co.uk and the following fingerprint: CA74 9061 914E AC13 8E66 EADB 9147 B477 339A 9B86 As PyPI no longer shows signatures, you should be able to download release archives and signatures from https://bitbucket.org/vinay.sajip/python-gnupg/downloads/ The archives should be the same as those uploaded to PyPI. Platform: No particular restrictions Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: BSD License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 2.7 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: Operating System :: OS Independent Classifier: Topic :: Software Development :: Libraries :: Python Modules python-gnupg-0.4.8/python_gnupg.egg-info/dependency_links.txt0000644000175000017500000000000114147404117024744 0ustar vinayvinay00000000000000 python-gnupg-0.4.8/setup.cfg0000664000175000017500000000010314147404120016272 0ustar vinayvinay00000000000000[bdist_wheel] universal = 1 [egg_info] tag_build = tag_date = 0 python-gnupg-0.4.8/test_gnupg.py0000664000175000017500000016742514147401141017227 0ustar vinayvinay00000000000000# -*- coding: utf-8 -*- """ A test harness for gnupg.py. Copyright (C) 2008-2021 Vinay Sajip. All rights reserved. """ import doctest import io import json import logging import os.path import os import re import shutil import stat import sys import tempfile import unittest try: from unittest import skipIf except ImportError: # For now, for Python < 2.7 def skipIf(condition, message): if not condition: return lambda x: x else: return lambda x: None import gnupg __author__ = "Vinay Sajip" __date__ = "$24-Nov-2021 09:14:09$" ALL_TESTS = True logger = logging.getLogger(__name__) GPGBINARY = os.environ.get('GPGBINARY', 'gpg') KEYS_TO_IMPORT = """-----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.4.9 (MingW32) mQGiBEiH4QERBACm48JJsg2XGzWfL7f/fjp3wtrY+JIz6P07s7smr35kve+wl605 nqHtgjnIVpUVsbI9+xhIAPIkFIR6ZcQ7gRDhoT0bWKGkfdQ7YzXedVRPlQLdbpmR K2pKKySpF35pJsPAYa73EVaxu2KrII4CyBxVQgNWfGwEbtL5FfzuHhVOZwCg6JF7 bgOMPmEwBLEHLmgiXbb5K48D/2xsXtWMkvgRp/ubcLxzbNjaHH6gSb2IfDi1+W/o Bmfua6FksPnEDn7PWnBhCEO9rf1tV0FcrvkR9m2FGfx38tjssxDdLvX511gbfc/Q DJxZ00A63BxI3xav8RiXlqpfQGXpLJmCLdeCh5DXOsVMCfepqRbWyJF0St7LDcq9 SmuXA/47dzb8puo9dNxA5Nj48I5g4ke3dg6nPn7aiBUQ35PfXjIktXB6/sQJtWWx XNFX/GVUxqMM0/aCMPdtaoDkFtz1C6b80ngEz94vXzmON7PCgDY6LqZP1B1xbrkr 4jGSr68iq7ERT+7E/iF9xp+Ynl91KK7h8llY6zFw+yIe6vGlcLQvR2FyeSBHcm9z cyAoQSB0ZXN0IHVzZXIpIDxnYXJ5Lmdyb3NzQGdhbW1hLmNvbT6IYAQTEQIAIAUC SIfhAQIbAwYLCQgHAwIEFQIIAwQWAgMBAh4BAheAAAoJEJZ2Ekdc7S4UtEcAoJIA iZurfuzIUE9Dtn86o6vC14qoAJ9P79mxR88wRr/ac9h5/BIf5cZKMbkCDQRIh+EB EAgAyYCvtS43J/OfuGHPGPZT0q8C+Y15YLItSQ3H6IMZWFY+sX+ZocaIiM4noVRG +mrEqzO9JNh4KP1OdFju1ZC8HZXpPVur48XlTNSm0yjmvvfmi+aGSuyQ0NkfLyi1 aBeRvB4na/oFUgl908l7vpSYWYn4EY3xpvwJdyTWHTh4o7+zvrR1fByDt49k2b3z yTACoxYPVQfknt8gxqLqHZsbgn02Ml7HS17bSWr5Z7PlWqDlmsdqUikVU9d2RvIq R+YIJbOdHSklbVQQDhr+xgHPi39e7nXMxR/rMjMbz7E5vSNkge45n8Pzim8iyqy+ MTMW8psV/OyrHUJzBEA7M6hA1wADBwgAnB0HzI1iyiQmIymO0Hj0BgqU6/avFw9R ggBuE2v7KsvuLP6ohXDEhYopjw5hgeotobpg6tS15ynch+6L8uWsJ0rcY2X9dsJy O8/5mjrNDHwCKiYRuZfmRZjzW03vO/9+rjtZ0NzoWYMP3UR8lUTVp2LTygefBA88 Zgw6dWBVzn+/c0vdwcF4Y3njYKE7eq4VrfcwqRgD0hDyIJd1OpqzHfXXnTtLlAsm UwtdONzlwu7KkgafMo4vzKY6dCtUkR6pXAE/rLQfCTonwl9SnyusoYZgjDoj4Pvw ePxIl2q05dcn96NJGS+SfS/5B4H4irbfaEYmCfKps+45sjncYGhZ/ohJBBgRAgAJ BQJIh+EBAhsMAAoJEJZ2Ekdc7S4U2lkAoIwZLMHVldC0v9wse53xU0NsNIskAKDc Ft0XWUJ9yajOEUqCVHNs3F99t5kBogRIh+FVEQQAhk/ROtJ5/O+YERl4tZZBEhGH JendDBDfzmfRO9GIDcZI20nx5KJ1M/zGguqgKiVRlBy32NS/IRqwSI158npWYLfJ rYCWrC2duMK2i/8prOEfaktnqZXVCHudGtP4mTqNSs+867LnGhQ4w3HmB09zCIpD eIhhhPOb5H19H8UlojsAoLwsq5BACqUKoiz8lUufpTTFMbaDA/4v1fWmprYAxGq9 cZ9svae772ymN/RRPDb/D+UJoJCCJSjE8m4MukVchyJVT8GmpJM2+dlt62eYwtz8 bGNt+Yzzxr0N8rLutsSks7RaM16MaqiAlM20gAXEovxBiocgP/p5bO3FGKOBbrfd h47BZDEqLvfJefXjZEsElbZ9oL2zDgP9EsoDS9mbfesHDsagE5jCZRTY1C/FRLBO zhGgP2IlqBdOX8BYBYZiIlLM+pN5fU0Hcu3VOZY1Hnj6r3VbK1bOScQzqrZ7qgmw TRgyxUQalaOhMb5rUD0+dUFxa/mhTerx5POrX6zOWmmK0ldYTZO4/+nWr4FwmU8R 41nYYYdi0yS0MURhbm55IERhdmlzIChBIHRlc3QgdXNlcikgPGRhbm55LmRhdmlz QGRlbHRhLmNvbT6IYAQTEQIAIAUCSIfhVQIbAwYLCQgHAwIEFQIIAwQWAgMBAh4B AheAAAoJEG7bKmS7rMYAEt8An2jxsmsE1MZVZc4Ev8RB9Gu1zbsCAJ9G5kkYIIf0 OoDqCjkDMDJcpd4MqLkCDQRIh+FVEAgAgHQ+EyseLw6A3BS2EUz6U1ZGzuJ5CXxY BY8xaQtE+9AJ0WHyzKeptnlnY1x9et3ny1BcVC5aR1OgsDiuVRvSFwpFfVxMKbRT kvERWADfB0N5EyWwyE0E4BT5hyEhW7fS0bucJL6UK5PKvfE5wexWlUI3yV4K1z6W 2gSNL60o3kmoGn9K5ICWO/jbi6MkPptSoDu/laCJHv/aid6Gf94ckDClQQyLsccj 0ibynm6rI3cIzpPMbimKIsKT1smAqZEBsTucBlOjIuIROANTZUN3reGIRh/kVNyg YTrkUnIqVS9FnbHa2wxeb6F/cO33fPiVfiCmZuKI1Uh4PMGaaSCh0wADBQf/SaXN WcuD0mrEnxqgEJRx67ZeFZjZM53Obu3JYQ++lqsthf8MxE7K4J/67xDpOh6waK0G 6GCLwEm3Z7wjCaz1DYg2uJp/3pispWxZio3PLVe7WrMY+oEBHEsiJXicS5dV620a uoaBnnc0aQWT/DREE5s35IrZCh4WDQgO9rl0i/qcIITm77TmQbq2Xdj5vt6s0cx7 oHKRaFBpQ8DBsCQ+D8Xz7i1oUygNp4Z5xPhItWeCfE9YoCoem4jSB4HGwmMOEicp VSpY43k01cd0Yfb1OMhA5C8OBwcwn3zvQB7nbxyxyQ9qphfwhMookIL4+tKKBIQL CnOGhApkAGbjRwuLi4hJBBgRAgAJBQJIh+FVAhsMAAoJEG7bKmS7rMYA+JQAn0E2 WdPQjKEfKnr+bW4yubwMUYKyAJ4uiE8Rv/oEED1oM3xeJqa+MJ9V1w== =sqld -----END PGP PUBLIC KEY BLOCK-----""" SIGNED_KEYS="""-----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2 mI0EVcnKUQEEAKWazmfM0kbvDdw7Kos2NARaX67c8iJ3GOBimUvYLj4VR3Mqrm34 ZdLlS8jCmid+qoisefvGW5uw5Q3gIs0mdEdUpFKlXNiIja/Dg/FHjjJPPCjfzDTh Q03EYA7QvOnXZXhYPBqK7NitsNXW4lPnIJdanLx7yMuL+2Xb+tF39mwnABEBAAG0 LUpvc2h1YSBDYWx2ZXJ0IChBIHRlc3QgdXNlcikgPGpjQGV4YW1wbGUuY29tPoi3 BBMBCAAhBQJVycpRAhsDBQsJCAcCBhUICQoLAgQWAgMBAh4BAheAAAoJELxvNQ+z 0EB2jcED/0lHKaEkyd6cj0Zckf9luIkZ4Hno/vRCquTI7c3aPjS3qmE8mOvKSBCV +SamPdRM7DdjkdBrrKy2HtiDqbM+1/CdXuQka2SlJWyLCJe48+KWfBpqlY3N4t53 JjHRitDB+hC8njWTV5prli6EgsBPAF+ZkO0iZhlsMmWdDWgqDpGRiJwEEAEIAAYF AlXJym8ACgkQBXzPZYwHT9oiiQQAvPF8ubwRopnXIMDQgSxKyFDM1MI1w/wb4Okd /MkMeZSmdcHJ6pEymp5bYciCBuLW+jw0vZWza3YloO/HtuppnF6A9a1UvYcp/diI O5qkQqYPlui1PJl7hQ014ioniMfOcC4X/r6PDbC78Pczje0Yh9AOqNGeCyNyNdlc pjaHb0m4jQRVycpRAQQAo9JjW75F5wTVVO552cGCZWqZvDyBt9+IkoK9Bc+ggdn5 6R8QVCihYuaSzcSEN84zHaR3MmGKHraCmCSlfe7w0d41Dlns0P03KMdIZOGrm045 F8TXdSSPQOv5tA4bz3k2lGD0zB8l4NUWFaZ5fzw2i73FF4O/FwCU8xd/JCKVPkkA EQEAAYifBBgBCAAJBQJVycpRAhsMAAoJELxvNQ+z0EB2xLYD/i3tKirQlVB+32WP wggstqDp1BlUBmDb+4Gndpg4l7omJTTyOsF26SbYgXZqAdEd5T/UfpEla0DKiBYh 2/CFYXadkgX/ME+GTetTmD4hHoBNmdXau92buXsIXkwh+JR+RC3cl2U6tWb/MIRd zvJiok8W8/FT/QrEjIa2etN2d+KR =nNBX -----END PGP PUBLIC KEY BLOCK----- -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2 mI0EVcnKNgEEANIVlIUyRXWHP/ljdMEA8B5NxecRCKusUIPxeapk2do5UCZgR1q8 5wOP4K/+W3Uj85ylOOCNTFYKRozAHsPMAmQ38W93DZYqFbG6d7rwMvz4pVe0wUtj SBINoKnoEDZwx3erxFKOkp/5fF3NoYSIx9a0Ds21ESk0TAuH5Tg934YhABEBAAG0 MVdpbnN0b24gU21pdGggKEEgdGVzdCB1c2VyKSA8d2luc3RvbkBleGFtcGxlLmNv bT6ItwQTAQgAIQUCVcnKNgIbAwULCQgHAgYVCAkKCwIEFgIDAQIeAQIXgAAKCRAF fM9ljAdP2h05A/4vmnxV1MwcOhJTHZys5g2/j5UoZG7V7lPGpJaojSAIVzYXZtwT 5A7OY8Nl21kIY6gnZlgbTRpHN8Qq2wRKAyW5o6wQvuN16CW4bmGjoHYRGPqkeM0w G40W/v88JXrYDNNe/68g4pnPsZ3J0oMLbRvCaDQQHXBuZNJrT1sOxl9Of7iNBFXJ yjYBBACmHbs0PdOF8NEGc+fEtmdKOSKOkrcvg1wTu1KFFTBFEbseHOCNpx+R6lfO ZiZmHGdKeJhTherfjHaY5jmvyDWq5TLZXK61quNsWxmY2zJ0SRwrIG/CWi4bMi5t JNc23vMumkz4X5g7x0Ea7xEWkcYBn0H6sZDAtb8d8mrlWkMekQARAQABiJ8EGAEI AAkFAlXJyjYCGwwACgkQBXzPZYwHT9pQIwP8D9/VroykSE2J3gy0S6HC287jXqXF 0zWejUAQtWUSSRx4esqfLE8lfae6+LDHO8D0Bf6YUJmu7ATOZP2/TIas7JrNvXWc NKWl2MHEAGUYq8utCjZ3dKKhaV7UvcY4PyLIpFteNkOz4wFe6C0Mm+1NYwokIFyh zPBq9eFk7Xx9Wrc= =HT6N -----END PGP PUBLIC KEY BLOCK----- """ SECRET_KEY = """ -----BEGIN PGP PRIVATE KEY BLOCK----- lQPGBFztd1UBCACiHhlEJIGfXNEiUX4GwamgdLOkJ3mbn5OyV4M/Ie3YvvHxveq/ TFYbuV63iuDVhNXpDUNmGsTq4vFaMsseLl7eESw8UTa3XklHHjh56kw0AVkJA75A Xq/VshFobLNxYZdtlOVkKe1a3uJVKs+BqFjhavEjQyhkpWvBY51OzCSc2AN/aQZA F3AltZ8luIHZPs8zVbgH90WIpze+vzAd9FyXD0wV6gylGSifHj8zIhac80evQgD9 50De7EPnSdgZSNwnlrhQtAIB5UnTETxXk34/W0Rq+BKn6SuchtaP7hXIHC0+B0C7 zBzPYKMQ7vXc/hceNwSGtgovhaQPCcv1byFBABEBAAH+BwMCUNdAVY/RMdJg1q5n FQOyVZl2tvd3krExjGYvhabwijbPz+TrVkPhKqdkp4Hbf3oXV/bcbQhG2dld4Ooc +xtEpTqYw08bNDuk4NEAvggasUkgssHZccDmHySGfA9U8C7B0Hj8xT4SifnuVNL+ xp9iv1BS03s+UIEVZ2rGjDQy7/G/U6/ZpLqFg+C113VQs6yz0VMsnnAQOMgN0+gQ aZb6VNPR7nZ5+/hRlx0DgXu++lei9HTmHRz+ZvbbYjeU9nj10eANhO0lEvlgtyXa v4Y5ERwk86gbkSRGtN88qVK/+GXK60Q33EoGMlwPZrfFGx+N5QuPEnCjT1vvz7E3 HhCpe4u5Idusgui+tDkxq8BEz6iTGMO1hcb75MDdIQBhJzeJ7OIxyBfqLReF4+Ut eNwy0wpN3xuEeYvP4ZIe7hj74WWIuKq2+lesPm4eWRPoaQ5MZXmEwbjr29e++V7D EkHgCYio6TVwrHA0LRSNfm8VVBV2cdsqFOLLutudHoC8BnjetEetmYaA99u0Pevz NscYwfaWLNW/d5FGyPUb+GQFYzmQWUfUzpg9hu7U79uA0kOwC+4nK6LEalILtoHn YO3PvvcCEnpWBlDhCR3n0zkNQCulvQKS/ww5q/MDNqvibKiMJHJ1xP89tEU3lnHl qgwHVmleqUR+yzdg5lo96Yey5yaDdhK5ZR1TFC4qK4Igcn2+WG109659bJUGpEre Vktu530JutX38ZoyKdHO0uPs/ft/hgBhNd6MKmh7eejo84Wn6/lxkfMydkfKm5QY dMHF3Ew+l7aACAs3l95V0YDNzA0FyOFkb/tqxyx8dP+O2NdZQZSvG+yxDav05bCq kwz+7H7sJnUj1JJtUgPTL9yVH+LyUhL8AU13UKVjBFJ4VL5+KDD9KwPkk6aN7zDW Qv0g8Cc7A8H0tB5BdXRvZ2VuZXJhdGVkIEtleSA8dXNlcjFAdGVzdD6JATgEEwEI ACIFAlztd1UCGy8GCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEGP32fXSIJgg IXgH/3o1rUzbjjz1sMoBwRv4qLmgeqlB2YJSVzLWOn4AcrHbxup5O9nJkqG+YFwH OFmytuiPDKmA4ZXww8f+2rHXdDuwI5SWnfhuPpV863BulIhtjwiwqD9eIzQ9LX79 K7hXRJ4I0AkYEbDHOWlLHZCrjul/ZaS10QRVR21EYICha2I8tvxsRMPp0I93XnuB T+z7ykRxRjpMv6MfhWVcw5B0s7lPedLhcx657HfY49t36/CIZ9/zMKsduX7cTOAh tO8f06R3yfjxLRD8y89frVP3+tGMvt2yGOd5TT0zht5yYcG6QkiHlfdgXqeE8nsU 2392Xn/RETq6xCj3kG6K3wbWqh0= =2A5s -----END PGP PRIVATE KEY BLOCK----- """ def is_list_with_len(o, n): return isinstance(o, list) and len(o) == n BASE64_PATTERN = re.compile(r'^(?:[A-Z0-9+/]{4})*(?:[A-Z0-9+/]{2}==|[A-Z0-9+/]{3}=)?$', re.I) def get_key_data(s): lines = s.split('\n') result = '' for line in lines: m = BASE64_PATTERN.match(line) if m: result += line return result def compare_keys(k1, k2): "Compare ASCII keys" # See issue #57: we need to compare only the actual key data, # ignoring things like spurious blank lines return get_key_data(k1) != get_key_data(k2) AGENT_CONFIG = '''allow-loopback-pinentry log-file socket:///tmp/S.my-gnupg-log verbose debug ipc ''' ENABLE_TOFU = 'ENABLE_TOFU' in os.environ if ENABLE_TOFU: GPG_CONFIG = 'trust-model tofu+pgp\ntofu-default-policy unknown\n' def prepare_homedir(hd): if not os.path.isdir(hd): os.makedirs(hd) os.chmod(hd, 0x1C0) fn = os.path.join(hd, 'gpg-agent.conf') with open(fn, 'w') as f: f.write(AGENT_CONFIG) if ENABLE_TOFU: fn = os.path.join(hd, 'gpg.conf') with open(fn, 'w') as f: f.write(GPG_CONFIG) class GPGTestCase(unittest.TestCase): def setUp(self): if 'STATIC_TEST_HOMEDIR' not in os.environ: hd = tempfile.mkdtemp(prefix='keys-') else: hd = os.path.join(os.getcwd(), 'keys') if os.path.exists(hd): self.assertTrue(os.path.isdir(hd), "Not a directory: %s" % hd) shutil.rmtree(hd, ignore_errors=True) prepare_homedir(hd) self.homedir = hd self.gpg = gpg = gnupg.GPG(gnupghome=hd, gpgbinary=GPGBINARY) v = gpg.version if v: if v >= (2,): # pragma: no cover gpg.options = ['--debug-quick-random'] else: gpg.options = ['--quick-random'] self.test_fn = test_fn = 'random_binary_data' if not os.path.exists(test_fn): # pragma: no cover data_file = open(test_fn, 'wb') data_file.write(os.urandom(5120 * 1024)) data_file.close() def tearDown(self): if 'STATIC_TEST_HOMEDIR' not in os.environ: shutil.rmtree(self.homedir, ignore_errors=True) def test_environment(self): "Test the environment by ensuring that setup worked" hd = self.homedir self.assertTrue(os.path.exists(hd) and os.path.isdir(hd), "Not an existing directory: %s" % hd) def test_list_keys_initial(self): "Test that initially there are no keys" logger.debug("test_list_keys_initial begins") public_keys = self.gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 0), "Empty list expected") private_keys = self.gpg.list_keys(secret=True) self.assertTrue(is_list_with_len(private_keys, 0), "Empty list expected") logger.debug("test_list_keys_initial ends") def generate_key(self, first_name, last_name, domain, passphrase=None): "Generate a key" params = { 'Key-Type': 'DSA', 'Key-Length': 1024, 'Subkey-Type': 'ELG-E', 'Subkey-Length': 2048, 'Name-Comment': 'A test user', 'Expire-Date': 0, } options = self.gpg.options or [] if '--debug-quick-random' in options or '--quick-random' in options: # If using the fake RNG, a key isn't regarded as valid # unless its comment has the text (insecure!) in it. params['Name-Comment'] = 'A test user (insecure!)' params['Name-Real'] = '%s %s' % (first_name, last_name) params['Name-Email'] = ("%s.%s@%s" % (first_name, last_name, domain)).lower() if passphrase is None: passphrase = ("%s%s" % (first_name[0], last_name)).lower() params['Passphrase'] = passphrase cmd = self.gpg.gen_key_input(**params) return self.gpg.gen_key(cmd) def do_key_generation(self): "Test that key generation succeeds" result = self.generate_key("Barbara", "Brown", "beta.com") self.assertNotEqual(None, result, "Non-null result") return result def test_key_generation_with_invalid_key_type(self): "Test that key generation handles invalid key type" params = { 'Key-Type': 'INVALID', 'Key-Length': 1024, 'Subkey-Type': 'ELG-E', 'Subkey-Length': 2048, 'Name-Comment': 'A test user', 'Expire-Date': 0, 'Name-Real': 'Test Name', 'Name-Email': 'test.name@example.com', } cmd = self.gpg.gen_key_input(**params) result = self.gpg.gen_key(cmd) self.assertFalse(result.data, 'Null data result') self.assertEqual(None, result.fingerprint, 'Null fingerprint result') self.assertEqual(2, result.returncode, "Unexpected return code") def test_key_generation_with_colons(self): "Test that key generation handles colons in key fields" params = { 'key_type': 'RSA', 'name_real': 'urn:uuid:731c22c4-830f-422f-80dc-14a9fdae8c19', 'name_comment': 'dummy comment', 'name_email': 'test.name@example.com', } if self.gpg.version >= (2, 1): params['passphrase'] = 'foo' cmd = self.gpg.gen_key_input(**params) result = self.gpg.gen_key(cmd) self.assertEqual(0, result.returncode, "Non-zero return code") keys = self.gpg.list_keys() self.assertEqual(0, keys.returncode, "Non-zero return code") self.assertEqual(len(keys), 1) key = keys[0] uids = key['uids'] self.assertEqual(len(uids), 1) uid = uids[0] self.assertEqual(uid, 'urn:uuid:731c22c4-830f-422f-80dc-14a9fdae8c19 ' '(dummy comment) ') def test_key_generation_with_escapes(self): "Test that key generation handles escape characters" params = { 'name_real': 'Test Name', 'name_comment': 'Funny chars: \\r\\n\\f\\v\\0\\b', 'name_email': 'test.name@example.com', } if self.gpg.version >= (2, 1): params['passphrase'] = 'foo' cmd = self.gpg.gen_key_input(**params) result = self.gpg.gen_key(cmd) self.assertEqual(0, result.returncode, "Non-zero return code") keys = self.gpg.list_keys() self.assertEqual(0, keys.returncode, "Non-zero return code") self.assertEqual(len(keys), 1) key = keys[0] uids = key['uids'] self.assertEqual(len(uids), 1) uid = uids[0] self.assertEqual(uid, 'Test Name (Funny chars: ' '\r\n\x0c\x0b\x00\x08) ') def test_key_generation_input(self): "Test that key generation input handles empty values, curves etc." params = { 'key_type': ' ', 'key_length': 2048, } cmd = self.gpg.gen_key_input(**params) self.assertTrue('Key-Type: RSA\n' in cmd) params['key_type'] = 'DSA' cmd = self.gpg.gen_key_input(**params) self.assertTrue('Key-Type: DSA\n' in cmd) params = { 'key_type': 'ECDSA', 'key_curve': 'nistp384', 'subkey_type': 'ECDH', 'subkey_curve': 'nistp384', 'name_comment': 'NIST P-384', } cmd = self.gpg.gen_key_input(**params) for s in ('Key-Type: ECDSA', 'Key-Curve: nistp384', 'Subkey-Type: ECDH', 'Subkey-Curve: nistp384', 'Name-Comment: NIST P-384'): self.assertTrue('%s\n' %s in cmd) self.assertFalse('Key-Length: ' in cmd) def test_list_keys_after_generation(self): "Test that after key generation, the generated key is available" self.test_list_keys_initial() self.do_key_generation() public_keys = self.gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 1), "1-element list expected") key_info = public_keys[0] fp = key_info['fingerprint'] self.assertTrue(fp in public_keys.key_map) self.assertTrue(public_keys.key_map[fp] is key_info) self.assertTrue('subkey_info' in key_info) skinfo = key_info['subkey_info'] for skid, _, sfp in key_info['subkeys']: self.assertTrue(skid in skinfo) info = skinfo[skid] self.assertEqual(info['keyid'], skid) self.assertEqual(info['type'], 'sub') self.assertTrue(sfp in public_keys.key_map) self.assertTrue(public_keys.key_map[sfp] is key_info) # now test with sigs=True public_keys_sigs = self.gpg.list_keys(sigs=True) self.assertEqual(0, public_keys_sigs.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys_sigs, 1), "1-element list expected") key_info = public_keys_sigs[0] fp = key_info['fingerprint'] self.assertTrue(fp in public_keys_sigs.key_map) self.assertTrue(public_keys_sigs.key_map[fp] is key_info) self.assertTrue(is_list_with_len(key_info['sigs'], 2)) self.assertTrue('subkey_info' in key_info) skinfo = key_info['subkey_info'] for siginfo in key_info['sigs']: self.assertTrue(len(siginfo), 3) for skid, _, sfp in key_info['subkeys']: self.assertTrue(skid in skinfo) info = skinfo[skid] self.assertEqual(info['keyid'], skid) self.assertEqual(info['type'], 'sub') self.assertTrue(sfp in public_keys_sigs.key_map) self.assertTrue(public_keys_sigs.key_map[sfp] is key_info) private_keys = self.gpg.list_keys(secret=True) self.assertEqual(0, private_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(private_keys, 1), "1-element list expected") self.assertEqual(len(private_keys.fingerprints), 1) key_info = private_keys[0] self.assertTrue('subkey_info' in key_info) skinfo = key_info['subkey_info'] self.assertTrue(skid in skinfo) info = skinfo[skid] self.assertEqual(info['keyid'], skid) self.assertEqual(info['type'], 'ssb') # Now do the same test, but using keyring and secret_keyring arguments if self.gpg.version < (2, 1): pkn = 'pubring.gpg' skn = 'secring.gpg' else: # On GnuPG >= 2.1, --secret-keyring is obsolete and ignored, # and the keyring file name has changed. pkn = 'pubring.kbx' skn = None hd = self.homedir if os.name == 'posix': pkn = os.path.join(hd, pkn) if skn: skn = os.path.join(hd, skn) gpg = gnupg.GPG(gnupghome=hd, gpgbinary=GPGBINARY, keyring=pkn, secret_keyring=skn) logger.debug('Using keyring and secret_keyring arguments') public_keys_2 = gpg.list_keys() self.assertEqual(0, public_keys_2.returncode, "Non-zero return code") self.assertEqual(public_keys_2, public_keys) private_keys_2 = gpg.list_keys(secret=True) self.assertEqual(0, private_keys_2.returncode, "Non-zero return code") self.assertEqual(private_keys_2, private_keys) # generate additional keys so that we can test listing a subset of # keys def get_names(key_map): result = set() for info in key_map.values(): for uid in info['uids']: uid = uid.replace(' (A test user (insecure!))', '') result.add(uid) return result result = self.generate_key("Charlie", "Clark", "gamma.com") self.assertNotEqual(None, result, "Non-null result") self.assertEqual(0, result.returncode, "Non-zero return code") result = self.generate_key("Donna", "Davis", "delta.com") self.assertNotEqual(None, result, "Non-null result") self.assertEqual(0, result.returncode, "Non-zero return code") public_keys = gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertEqual(len(public_keys), 3) actual = get_names(public_keys.key_map) expected = set(['Barbara Brown ', 'Charlie Clark ', 'Donna Davis ']) self.assertEqual(actual, expected) # specify a single key as a string public_keys = gpg.list_keys(keys='Donna Davis') self.assertEqual(0, public_keys.returncode, "Non-zero return code") actual = get_names(public_keys.key_map) expected = set(['Donna Davis ']) self.assertEqual(actual, expected) # specify multiple keys public_keys = gpg.list_keys(keys=['Donna', 'Barbara']) self.assertEqual(0, public_keys.returncode, "Non-zero return code") actual = get_names(public_keys.key_map) expected = set(['Barbara Brown ', 'Donna Davis ']) self.assertEqual(actual, expected) def test_key_trust(self): "Test that trusting keys works" gpg = self.gpg result = gpg.import_keys(KEYS_TO_IMPORT) self.assertEqual(0, result.returncode, "Non-zero return code") keys = gpg.list_keys() self.assertEqual(0, keys.returncode, "Non-zero return code") fingerprints = [] for key in keys: self.assertEqual(key['ownertrust'], '-') fingerprints.append(key['fingerprint']) cases = ( ('TRUST_NEVER', 'n'), ('TRUST_MARGINAL', 'm'), ('TRUST_FULLY', 'f'), ('TRUST_ULTIMATE', 'u'), ('TRUST_UNDEFINED', 'q'), ) for param, expected in cases: gpg.trust_keys(fingerprints, param) keys = gpg.list_keys(keys=fingerprints) for key in keys: self.assertEqual(key['ownertrust'], expected) self.assertRaises(ValueError, gpg.trust_keys, fingerprints, 'TRUST_FOOBAR') self.assertRaises(ValueError, gpg.trust_keys, 'NO_SUCH_FINGERPRINT', 'TRUST_NEVER') # gpg should raise an error for the following - but it doesn't! # self.assertRaises(ValueError, gpg.trust_keys, # 'BADF00DBADF00DBADF00DBADF00DBADF00DBADF0', # 'TRUST_NEVER') def test_list_signatures(self): logger.debug("test_list_signatures begins") imported = self.gpg.import_keys(SIGNED_KEYS) self.assertEqual(0, imported.returncode, "Non-zero return code") keys = self.gpg.list_keys(keys=["18897CA2"]) self.assertEqual(0, keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(keys, 1), "importing test signed key") sigs = self.gpg.list_keys(keys=["18897CA2"], sigs=True)[0]['sigs'] logger.debug("testing self-signature") self.assertTrue(('BC6F350FB3D04076', 'Joshua Calvert (A test user) ', '13x') in sigs) logger.debug("testing subkey self-signature") self.assertTrue(('BC6F350FB3D04076', 'Joshua Calvert (A test user) ', '18x') in sigs) logger.debug("testing other signature") self.assertTrue(('057CCF658C074FDA', 'Winston Smith (A test user) ', '10x') in sigs) logger.debug("test_list_signatures ends") def test_scan_keys(self): "Test that external key files can be scanned" # Don't use SkipTest for now, as not available for Python < 2.7 if self.gpg.version < (2, 1): expected = set([ 'Andrew Able (A test user) ', 'Barbara Brown (A test user) ', 'Charlie Clark (A test user) ', ]) for fn in ('test_pubring.gpg', 'test_secring.gpg'): logger.debug('scanning keys in %s', fn) data = self.gpg.scan_keys(fn) self.assertEqual(0, data.returncode, "Non-zero return code") uids = set() for d in data: uids.add(d['uids'][0]) self.assertEqual(uids, expected) def test_encryption_and_decryption(self): "Test that encryption and decryption works" logger.debug("test_encryption_and_decryption begins") key = self.generate_key("Andrew", "Able", "alpha.com", passphrase="andy") self.assertEqual(0, key.returncode, "Non-zero return code") andrew = key.fingerprint key = self.generate_key("Barbara", "Brown", "beta.com") self.assertEqual(0, key.returncode, "Non-zero return code") barbara = key.fingerprint gpg = self.gpg if gnupg._py3k: data = 'Hello, André!' else: data = unicode('Hello, André', gpg.encoding) data = data.encode(gpg.encoding) result = gpg.encrypt(data, barbara) self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) self.assertNotEqual(data, edata, "Data must have changed") self.assertRaises(ValueError, gpg.decrypt, edata, passphrase="bbr\x00own") self.assertRaises(ValueError, gpg.decrypt, edata, passphrase="bbr\rown") self.assertRaises(ValueError, gpg.decrypt, edata, passphrase="bbr\nown") ddata = gpg.decrypt(edata, passphrase="bbrown") self.assertEqual(0, ddata.returncode, "Non-zero return code") if data != ddata.data: # pragma: no cover logger.debug("was: %r", data) logger.debug("new: %r", ddata.data) self.assertEqual(data, ddata.data, "Round-trip must work") result = gpg.encrypt(data, [andrew, barbara]) self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) self.assertNotEqual(data, edata, "Data must have changed") ddata = gpg.decrypt(edata, passphrase="andy") self.assertEqual(0, ddata.returncode, "Non-zero return code") self.assertEqual(data, ddata.data, "Round-trip must work") ddata = gpg.decrypt(edata, passphrase="bbrown") self.assertEqual(data, ddata.data, "Round-trip must work") # Test symmetric encryption data = "chippy was here" self.assertRaises(ValueError, gpg.encrypt, data, None, passphrase='bbr\x00own', symmetric=True) self.assertRaises(ValueError, gpg.encrypt, data, None, passphrase='bbr\rown', symmetric=True) self.assertRaises(ValueError, gpg.encrypt, data, None, passphrase='bbr\nown', symmetric=True) result = gpg.encrypt(data, None, passphrase='bbrown', symmetric=True) self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) ddata = gpg.decrypt(edata, passphrase='bbrown') self.assertEqual(0, ddata.returncode, "Non-zero return code") self.assertEqual(data, str(ddata)) # Test symmetric encryption with non-default cipher result = gpg.encrypt(data, None, passphrase='bbrown', symmetric='AES256') self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) ddata = gpg.decrypt(edata, passphrase='bbrown') self.assertEqual(0, ddata.returncode, "Non-zero return code") self.assertEqual(data, str(ddata)) # Test that you can't encrypt with no recipients self.assertRaises(ValueError, self.gpg.encrypt, data, []) # Test extra_args parameter result = gpg.encrypt(data, barbara, extra_args=['-z', '0']) self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) ddata = gpg.decrypt(edata, passphrase='bbrown') self.assertEqual(data.encode('ascii'), ddata.data, 'Round-trip must work') # Test on_data functionality chunks = [] def collector(data): chunks.append(data) gpg.on_data = collector result = gpg.encrypt(data, barbara) self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) self.assertTrue(chunks) expected = type(chunks[0])().join(chunks) self.assertEqual(expected.decode('ascii'), edata) chunks = [] ddata = gpg.decrypt(edata, passphrase='bbrown') self.assertEqual(0, ddata.returncode, "Non-zero return code") self.assertEqual(data.encode('ascii'), ddata.data, 'Round-trip must work') expected = type(chunks[0])().join(chunks) self.assertEqual(expected.decode('ascii'), data) # test signing with encryption and verification during decryption logger.debug('encrypting with signature') gpg.on_data = None result = gpg.encrypt(data, barbara, sign=andrew, passphrase='andy') self.assertEqual(0, result.returncode, "Non-zero return code") edata = str(result) logger.debug('decrypting with verification') ddata = gpg.decrypt(edata, passphrase='bbrown') self.assertEqual(0, ddata.returncode, "Non-zero return code") self.assertEqual(data.encode('ascii'), ddata.data, 'Round-trip must work') sig_values = list(ddata.sig_info.values()) self.assertTrue(sig_values) sig_info = sig_values[0] self.assertEqual(sig_info['fingerprint'], andrew) logger.debug('decrypting with verification succeeded') logger.debug("test_encryption_and_decryption ends") def test_import_and_export(self): "Test that key import and export works" logger.debug("test_import_and_export begins") self.test_list_keys_initial() gpg = self.gpg result = gpg.import_keys(KEYS_TO_IMPORT) self.assertEqual(0, result.returncode, "Non-zero return code") self.assertEqual(result.summary(), '2 imported') public_keys = gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 2), "2-element list expected") private_keys = gpg.list_keys(secret=True) self.assertEqual(0, private_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(private_keys, 0), "Empty list expected") ascii = gpg.export_keys([k['keyid'] for k in public_keys]) self.assertTrue(ascii.find("PGP PUBLIC KEY BLOCK") >= 0, "Exported key should be public") ascii = ascii.replace("\r", "").strip() match = compare_keys(ascii, KEYS_TO_IMPORT) if match: # pragma: no cover logger.debug("was: %r", KEYS_TO_IMPORT) logger.debug("now: %r", ascii) self.assertEqual(0, match, "Keys must match") #Generate a key so we can test exporting private keys key = self.do_key_generation() if self.gpg.version < (2, 1): passphrase = None else: passphrase = 'bbrown' ascii = gpg.export_keys(key.fingerprint, True, passphrase=passphrase) self.assertTrue(isinstance(ascii, gnupg.text_type)) self.assertTrue(ascii.find("PGP PRIVATE KEY BLOCK") >= 0, "Exported key should be private") binary = gpg.export_keys(key.fingerprint, True, armor=False, passphrase=passphrase) self.assertFalse(isinstance(binary, gnupg.text_type)) # import a secret key, and confirm that it's found in the list of # secret keys. result = gpg.import_keys(SECRET_KEY) self.assertEqual(0, result.returncode, "Non-zero return code") self.assertEqual(result.summary(), '1 imported') private_keys = gpg.list_keys(secret=True) self.assertTrue(is_list_with_len(private_keys, 2)) found = False for pk in private_keys: if pk['keyid'].endswith('D2209820'): found = True break self.assertTrue(found) self.assertEqual(pk['uids'][0], 'Autogenerated Key ') logger.debug("test_import_and_export ends") def test_import_only(self): "Test that key import works" logger.debug("test_import_only begins") self.test_list_keys_initial() result = self.gpg.import_keys(KEYS_TO_IMPORT) self.assertEqual(0, result.returncode, "Non-zero return code") public_keys = self.gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 2), "2-element list expected") private_keys = self.gpg.list_keys(secret=True) self.assertEqual(0, private_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(private_keys, 0), "Empty list expected") ascii = self.gpg.export_keys([k['keyid'] for k in public_keys]) self.assertTrue(ascii.find("PGP PUBLIC KEY BLOCK") >= 0, "Exported key should be public") ascii = ascii.replace("\r", "").strip() match = compare_keys(ascii, KEYS_TO_IMPORT) if match: # pragma: no cover logger.debug("was: %r", KEYS_TO_IMPORT) logger.debug("now: %r", ascii) self.assertEqual(0, match, "Keys must match") logger.debug("test_import_only ends") def test_signature_verification(self): "Test that signing and verification works" logger.debug("test_signature_verification begins") key = self.generate_key("Andrew", "Able", "alpha.com") if gnupg._py3k: data = 'Hello, André!' else: data = unicode('Hello, André', self.gpg.encoding) data = data.encode(self.gpg.encoding) self.assertRaises(ValueError, self.gpg.sign, data, keyid=key.fingerprint, passphrase="bbr\x00own") self.assertRaises(ValueError, self.gpg.sign, data, keyid=key.fingerprint, passphrase="bbr\rown") self.assertRaises(ValueError, self.gpg.sign, data, keyid=key.fingerprint, passphrase="bbr\nown") sig = self.gpg.sign(data, keyid=key.fingerprint, passphrase='bbrown') self.assertFalse(sig, "Bad passphrase should fail") sig = self.gpg.sign(data, keyid=key.fingerprint, passphrase='aable') self.assertEqual(0, sig.returncode, "Non-zero return code") self.assertTrue(sig, "Good passphrase should succeed") if sig.username: # not set in recent versions of GnuPG e.g. 2.2.5 self.assertTrue(sig.username.startswith('Andrew Able')) if sig.key_id: self.assertTrue(key.fingerprint.endswith(sig.key_id)) self.assertTrue(sig.hash_algo) logger.debug('verification start') verified = self.gpg.verify(sig.data) self.assertEqual(0, verified.returncode, "Non-zero return code") logger.debug('verification end') if key.fingerprint != verified.fingerprint: # pragma: no cover logger.debug("key: %r", key.fingerprint) logger.debug("ver: %r", verified.fingerprint) self.assertEqual(key.fingerprint, verified.fingerprint, "Fingerprints must match") self.assertEqual(verified.trust_level, verified.TRUST_ULTIMATE) self.assertEqual(verified.trust_text, 'TRUST_ULTIMATE') data_file = open(self.test_fn, 'rb') sig = self.gpg.sign_file(data_file, keyid=key.fingerprint, passphrase='aable') self.assertEqual(0, sig.returncode, "Non-zero return code") data_file.close() self.assertTrue(sig, "File signing should succeed") self.assertTrue(sig.hash_algo) try: file = gnupg._make_binary_stream(sig.data, self.gpg.encoding) verified = self.gpg.verify_file(file) except UnicodeDecodeError: # pragma: no cover # sometimes happens in Python 2.6 from io import BytesIO verified = self.gpg.verify_file(BytesIO(sig.data)) self.assertEqual(0, verified.returncode, "Non-zero return code") if key.fingerprint != verified.fingerprint: # pragma: no cover logger.debug("key: %r", key.fingerprint) logger.debug("ver: %r", verified.fingerprint) self.assertEqual(key.fingerprint, verified.fingerprint, "Fingerprints must match") data_file = open(self.test_fn, 'rb') sig = self.gpg.sign_file(data_file, keyid=key.fingerprint, passphrase='aable', detach=True) self.assertEqual(0, sig.returncode, "Non-zero return code") data_file.close() self.assertTrue(sig, "File signing should succeed") self.assertTrue(sig.hash_algo) try: file = gnupg._make_binary_stream(sig.data, self.gpg.encoding) verified = self.gpg.verify_file(file, self.test_fn) except UnicodeDecodeError: # pragma: no cover # sometimes happens in Python 2.6 from io import BytesIO verified = self.gpg.verify_file(BytesIO(sig.data)) self.assertEqual(0, verified.returncode, "Non-zero return code") if key.fingerprint != verified.fingerprint: # pragma: no cover logger.debug("key: %r", key.fingerprint) logger.debug("ver: %r", verified.fingerprint) self.assertEqual(key.fingerprint, verified.fingerprint, "Fingerprints must match") # Test in-memory verification data_file = open(self.test_fn, 'rb') data = data_file.read() data_file.close() fd, fn = tempfile.mkstemp() os.write(fd, sig.data) os.close(fd) try: verified = self.gpg.verify_data(fn, data) finally: os.unlink(fn) self.assertEqual(0, verified.returncode, "Non-zero return code") if key.fingerprint != verified.fingerprint: # pragma: no cover logger.debug("key: %r", key.fingerprint) logger.debug("ver: %r", verified.fingerprint) self.assertEqual(key.fingerprint, verified.fingerprint, "Fingerprints must match") logger.debug("test_signature_verification ends") def test_signature_file(self): "Test that signing and verification works via the GPG output" logger.debug("test_signature_file begins") key = self.generate_key("Andrew", "Able", "alpha.com") data_file = open(self.test_fn, 'rb') sig_file = self.test_fn + '.asc' sig = self.gpg.sign_file(data_file, keyid=key.fingerprint, passphrase='aable', detach=True, output=sig_file) self.assertEqual(0, sig.returncode, "Non-zero return code") data_file.close() self.assertTrue(sig, "File signing should succeed") self.assertTrue(sig.hash_algo) self.assertTrue(os.path.exists(sig_file)) # Test in-memory verification data_file = open(self.test_fn, 'rb') data = data_file.read() data_file.close() try: verified = self.gpg.verify_data(sig_file, data) self.assertTrue(verified.username.startswith('Andrew Able')) self.assertTrue(key.fingerprint.endswith(verified.key_id)) finally: os.unlink(sig_file) self.assertEqual(0, verified.returncode, "Non-zero return code") if key.fingerprint != verified.fingerprint: logger.debug("key: %r", key.fingerprint) logger.debug("ver: %r", verified.fingerprint) self.assertEqual(key.fingerprint, verified.fingerprint, "Fingerprints must match") logger.debug("test_signature_file ends") def test_deletion(self): "Test that key deletion works" logger.debug("test_deletion begins") result = self.gpg.import_keys(KEYS_TO_IMPORT) self.assertEqual(0, result.returncode, "Non-zero return code") public_keys = self.gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 2), "2-element list expected") result = self.gpg.delete_keys(public_keys[0]['fingerprint']) self.assertEqual(0, result.returncode, "Non-zero return code") public_keys = self.gpg.list_keys() self.assertEqual(0, public_keys.returncode, "Non-zero return code") self.assertTrue(is_list_with_len(public_keys, 1), "1-element list expected") logger.debug("test_deletion ends") def test_nogpg(self): "Test that absence of gpg is handled correctly" with self.assertRaises(OSError) as ar: gnupg.GPG(gnupghome=self.homedir, gpgbinary='frob') self.assertIn('frob', str(ar.exception)) def test_invalid_home(self): "Test that any specified gnupghome directory actually is one" hd = tempfile.mkdtemp(prefix='keys-') shutil.rmtree(hd) # make sure it isn't there anymore with self.assertRaises(ValueError) as ar: gnupg.GPG(gnupghome=hd) self.assertTrue('gnupghome should be a directory' in str(ar.exception)) def test_make_args(self): "Test argument line construction" self.gpg.options = ['--foo', '--bar'] args = self.gpg.make_args(['a', 'b'], False) self.assertTrue(len(args) > 4) self.assertEqual(args[-4:], ['--foo', '--bar', 'a', 'b']) def do_file_encryption_and_decryption(self, encfname, decfname): "Do the actual encryption/decryption test using given filenames" mode = None if os.name == 'posix': # pick a mode that won't be already in effect via umask if os.path.exists(encfname) and os.path.exists(decfname): mode = os.stat(encfname).st_mode | stat.S_IXUSR os.chmod(encfname, mode) # assume same for decfname os.chmod(decfname, mode) logger.debug('Encrypting to: %r', encfname) logger.debug('Decrypting to: %r', decfname) try: key = self.generate_key("Andrew", "Able", "alpha.com", passphrase="andy") self.assertEqual(0, key.returncode, "Non-zero return code") andrew = key.fingerprint key = self.generate_key("Barbara", "Brown", "beta.com") self.assertEqual(0, key.returncode, "Non-zero return code") barbara = key.fingerprint data = "Hello, world!" file = gnupg._make_binary_stream(data, self.gpg.encoding) edata = self.gpg.encrypt_file(file, barbara, armor=False, output=encfname) self.assertEqual(0, edata.returncode, "Non-zero return code") efile = open(encfname, 'rb') ddata = self.gpg.decrypt_file(efile, passphrase="bbrown", output=decfname) self.assertEqual(0, ddata.returncode, "Non-zero return code") efile.seek(0, 0) # can't use os.SEEK_SET in 2.4 edata = efile.read() efile.close() self.assertTrue(os.path.exists(decfname)) dfile = open(decfname, 'rb') ddata = dfile.read() dfile.close() data = data.encode(self.gpg.encoding) if ddata != data: # pragma: no cover logger.debug("was: %r", data) logger.debug("new: %r", ddata) self.assertEqual(data, ddata, "Round-trip must work") # Try opening the encrypted file in text mode (Issue #39) # this doesn't fail in 2.x if gnupg._py3k: efile = open(encfname, 'r') ddata = self.gpg.decrypt_file(efile, passphrase="bbrown", output=decfname) self.assertEqual(2, ddata.returncode, "Unexpected return code") self.assertFalse(ddata) self.assertEqual(ddata.status, "no data was provided") efile.close() finally: for fn in (encfname, decfname): if os.name == 'posix' and mode is not None: # Check that the file wasn't deleted, and that the # mode bits we set are still in effect self.assertEqual(os.stat(fn).st_mode, mode) if os.path.exists(fn): os.remove(fn) def test_file_encryption_and_decryption(self): "Test that encryption/decryption to/from file works" logger.debug("test_file_encryption_and_decryption begins") encfno, encfname = tempfile.mkstemp() decfno, decfname = tempfile.mkstemp() # On Windows, if the handles aren't closed, the files can't be deleted os.close(encfno) os.close(decfno) self.do_file_encryption_and_decryption(encfname, decfname) logger.debug("test_file_encryption_and_decryption ends") @skipIf(os.name == 'nt', 'Test not suitable for Windows') def test_invalid_outputs(self): "Test encrypting to invalid output files" encfno, encfname = tempfile.mkstemp() os.close(encfno) os.chmod(encfname, 0o400) cases = ( ('/dev/null/foo', 'encrypt: not a directory'), (encfname, 'encrypt: permission denied'), ) key = self.generate_key("Barbara", "Brown", "beta.com") barbara = key.fingerprint data = "Hello, world!" for badout, message in cases: stream = gnupg._make_binary_stream(data, self.gpg.encoding) edata = self.gpg.encrypt_file(stream, barbara, armor=False, output=badout) self.assertEqual(2, edata.returncode, "Unexpecteds return code") # on GnuPG 1.4, you sometimes don't get any FAILURE messages, in # which case status will not be set if edata.status: self.assertEqual(edata.status, message) # now try with custom error map, if available if os.path.exists('messages.json'): with open('messages.json') as f: mdata = json.load(f) messages = {} for k, v in mdata.items(): messages[int(k, 16)] = v self.gpg.error_map = messages encfno, encfname = tempfile.mkstemp() os.close(encfno) os.chmod(encfname, 0o400) try: cases = ( ('/dev/null/foo', 'encrypt: Not a directory'), (encfname, 'encrypt: Permission denied'), ) for badout, message in cases: stream = gnupg._make_binary_stream(data, self.gpg.encoding) edata = self.gpg.encrypt_file(stream, barbara, armor=False, output=badout) self.assertEqual(2, edata.returncode, "Unexpected return code") # on GnuPG 1.4, you sometimes don't get any FAILURE messages, in # which case status will not be set if edata.status: self.assertEqual(edata.status, message) finally: os.chmod(encfname, 0o700) os.remove(encfname) def test_filenames_with_spaces(self): # See Issue #16 "Test that filenames with spaces are correctly handled" logger.debug("test_filename_with_spaces begins") d = tempfile.mkdtemp() try: encfname = os.path.join(d, 'encrypted file') decfname = os.path.join(d, 'decrypted file') self.do_file_encryption_and_decryption(encfname, decfname) finally: shutil.rmtree(d, ignore_errors=True) logger.debug("test_filename_with_spaces ends") #@skipIf(os.name == 'nt', 'Test not suitable for Windows') def test_search_keys(self): "Test that searching for keys works" if 'NO_EXTERNAL_TESTS' not in os.environ: r = self.gpg.search_keys('') self.assertEqual(0, r.returncode, "Non-zero return code") self.assertTrue(r) self.assertTrue('Vinay Sajip ' in r[0]['uids']) r = self.gpg.search_keys('92905378') self.assertEqual(0, r.returncode, "Non-zero return code") self.assertTrue(r) self.assertTrue('Vinay Sajip ' in r[0]['uids']) def test_quote_with_shell(self): "Test shell quoting with a real shell" if os.name != 'posix': return from subprocess import PIPE, Popen workdir = tempfile.mkdtemp() try: s = "'\\\"; touch %s/foo #'" % workdir cmd = 'echo %s' % gnupg.shell_quote(s) p = Popen(cmd, shell=True, stdout=PIPE, stderr=PIPE) p.communicate() self.assertEqual(p.returncode, 0) files = os.listdir(workdir) self.assertEqual(files, []) fn = "'ab?'" cmd = 'touch %s/%s' % (workdir, gnupg.shell_quote(fn)) p = Popen(cmd, shell=True, stdout=PIPE, stderr=PIPE) p.communicate() self.assertEqual(p.returncode, 0) files = os.listdir(workdir) self.assertEqual(files, ["'ab?'"]) finally: shutil.rmtree(workdir, ignore_errors=True) def disabled_test_signing_with_uid(self): # pragma: no cover "Test that signing with uids works. On hold for now." logger.debug("test_signing_with_uid begins") key = self.generate_key("Andrew", "Able", "alpha.com") uid = self.gpg.list_keys(True)[-1]['uids'][0] try: signfile = open(self.test_fn,'rb') signed = self.gpg.sign_file(signfile, keyid=uid, passphrase='aable', detach=True) finally: signfile.close() self.assertEqual(0, signed.returncode, "Non-zero return code") self.assertTrue(signed.data) logger.debug("test_signing_with_uid ends") def test_doctest_import_keys(self): """ Because GnuPG 2.1 requires passphrases for exporting and deleting secret keys, and because console-mode passphrase entry requires configuration changes, doctests can't always be used. This test replicates the original doctest for import_keys as a regular test. >>> import shutil >>> shutil.rmtree("keys", ignore_errors=True) >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome="keys") >>> input = gpg.gen_key_input(name_email='user1@test', passphrase='pp1') >>> result = gpg.gen_key(input) >>> fp1 = result.fingerprint >>> result = gpg.gen_key(input) >>> fp2 = result.fingerprint >>> pubkey1 = gpg.export_keys(fp1) >>> seckey1 = gpg.export_keys(fp1, secret=True, passphrase='pp1') >>> seckeys = gpg.list_keys(secret=True) >>> pubkeys = gpg.list_keys() >>> assert fp1 in seckeys.fingerprints >>> assert fp1 in pubkeys.fingerprints >>> str(gpg.delete_keys(fp1)) 'Must delete secret key first' >>> str(gpg.delete_keys(fp1, secret=True, passphrase='pp1')) 'ok' >>> str(gpg.delete_keys(fp1)) 'ok' >>> str(gpg.delete_keys("nosuchkey")) 'No such key' >>> seckeys = gpg.list_keys(secret=True) >>> pubkeys = gpg.list_keys() >>> assert not fp1 in seckeys.fingerprints >>> assert not fp1 in pubkeys.fingerprints >>> result = gpg.import_keys('foo') >>> assert not result >>> result = gpg.import_keys(pubkey1) >>> pubkeys = gpg.list_keys() >>> seckeys = gpg.list_keys(secret=True) >>> assert not fp1 in seckeys.fingerprints >>> assert fp1 in pubkeys.fingerprints >>> result = gpg.import_keys(seckey1) >>> assert result >>> seckeys = gpg.list_keys(secret=True) >>> pubkeys = gpg.list_keys() >>> assert fp1 in seckeys.fingerprints >>> assert fp1 in pubkeys.fingerprints >>> assert fp2 in pubkeys.fingerprints """ logger.debug("test_doctest_import_keys begins") gpg = self.gpg inp = gpg.gen_key_input(name_email='user1@test', passphrase='pp1') result = gpg.gen_key(inp) fp1 = result.fingerprint inp = gpg.gen_key_input(name_email='user2@test', passphrase='pp2') result = gpg.gen_key(inp) self.assertEqual(0, result.returncode, "Non-zero return code") fp2 = result.fingerprint pubkey1 = gpg.export_keys(fp1) if gpg.version >= (2, 1): passphrase = 'pp1' else: passphrase = None seckey1 = gpg.export_keys(fp1, secret=True, passphrase=passphrase) seckeys = gpg.list_keys(secret=True) self.assertEqual(0, seckeys.returncode, "Non-zero return code") pubkeys = gpg.list_keys() self.assertEqual(0, pubkeys.returncode, "Non-zero return code") # avoid assertIn, etc. as absent in older Python versions self.assertTrue(fp1 in seckeys.fingerprints) self.assertTrue(fp1 in pubkeys.fingerprints) result = gpg.delete_keys(fp1) self.assertEqual(2, result.returncode, "Unexpected return code") self.assertEqual(str(result), 'Must delete secret key first') if gpg.version < (2, 1): # Doesn't work on 2.1, and can't use SkipTest due to having # to support older Pythons result = gpg.delete_keys(fp1, secret=True, passphrase=passphrase) self.assertEqual(0, result.returncode, "Non-zero return code") self.assertEqual(str(result), 'ok') result = gpg.delete_keys(fp1) self.assertEqual(0, result.returncode, "Non-zero return code") self.assertEqual(str(result), 'ok') result = gpg.delete_keys('nosuchkey') self.assertEqual(2, result.returncode, "Unexpected return code") self.assertEqual(str(result), 'No such key') seckeys = gpg.list_keys(secret=True) self.assertEqual(0, seckeys.returncode, "Non-zero return code") pubkeys = gpg.list_keys() self.assertEqual(0, pubkeys.returncode, "Non-zero return code") self.assertFalse(fp1 in seckeys.fingerprints) self.assertFalse(fp1 in pubkeys.fingerprints) result = gpg.import_keys('foo') self.assertFalse(result) logger.debug("test_doctest_import_keys ends") def test_recv_keys_no_server(self): result = self.gpg.recv_keys('foo.bar.baz', '92905378') self.assertEqual(2, result.returncode, "Unexpected return code") self.assertEqual(result.summary(), '0 imported') def test_invalid_fileobject(self): # accidentally on purpose pass in a filename rather than the file itself with self.assertRaises(TypeError) as ec: self.gpg.decrypt_file('foobar.txt', passphrase='', output='/tmp/decrypted.txt') self.assertEqual(str(ec.exception), 'Not a valid file: foobar.txt') def remove_all_existing_keys(self): for root, dirs, files in os.walk(self.homedir): for d in dirs: p = os.path.join(root, d) shutil.rmtree(p) for f in files: if f.endswith('.conf'): continue p = os.path.join(root, f) os.remove(p) def test_no_such_key(self): logger.debug("test_no_such_key begins") key = self.generate_key("Barbara", "Brown", "beta.com") barbara = key.fingerprint gpg = self.gpg if gnupg._py3k: data = 'Hello, André!' else: data = unicode('Hello, André', gpg.encoding) try: data = data.encode(gpg.encoding) encrypted = gpg.encrypt(data, barbara) self.remove_all_existing_keys() decrypted = gpg.decrypt(str(encrypted), passphrase='bbrown') self.assertFalse(decrypted.ok) expected = {'decryption failed', 'no secret key', 'no data was provided'} self.assertIn(decrypted.status, expected) finally: logger.debug("test_no_such_key ends") def test_get_recipients(self): logger.debug("test_get_recipients begins") try: gpg = self.gpg inp = gpg.gen_key_input(name_email='user1@test', passphrase='pp1') key1 = gpg.gen_key(inp) inp = gpg.gen_key_input(name_email='user2@test', passphrase='pp2') key2 = gpg.gen_key(inp) data = 'super secret'.encode(gpg.encoding) edata = gpg.encrypt(data, (key1.fingerprint, key2.fingerprint)) logger.debug('Getting recipients') ids = gpg.get_recipients(edata.data.decode(gpg.encoding)) self.assertGreater(len(ids), 0) idlen = len(ids[0]) ids = set(ids) expected = set((key1.fingerprint[-idlen:], key2.fingerprint[-idlen:])) self.assertEqual(expected, ids) finally: logger.debug("test_get_recipients ends") TEST_GROUPS = { 'sign' : set(['test_signature_verification', 'test_signature_file']), 'crypt' : set(['test_encryption_and_decryption', 'test_file_encryption_and_decryption', 'test_filenames_with_spaces', 'test_invalid_outputs', 'test_no_such_key']), 'key' : set(['test_deletion', 'test_import_and_export', 'test_list_keys_after_generation', 'test_list_signatures', 'test_key_generation_with_invalid_key_type', 'test_key_generation_with_escapes', 'test_key_generation_input', 'test_key_generation_with_colons', 'test_search_keys', 'test_scan_keys', 'test_key_trust']), 'import' : set(['test_import_only', 'test_doctest_import_keys']), 'basic' : set(['test_environment', 'test_list_keys_initial', 'test_nogpg', 'test_make_args', 'test_quote_with_shell']), 'test': set(['test_get_recipients']), } def suite(args=None): if args is None: args = sys.argv[1:] if not args or args == ['--no-doctests']: result = unittest.TestLoader().loadTestsFromTestCase(GPGTestCase) want_doctests = not args else: # pragma: no cover tests = set() want_doctests = False for arg in args: if arg in TEST_GROUPS: tests.update(TEST_GROUPS[arg]) elif arg == "doc": want_doctests = True else: print("Ignoring unknown test group %r" % arg) result = unittest.TestSuite(list(map(GPGTestCase, tests))) if want_doctests: result.addTest(doctest.DocTestSuite(gnupg)) return result def init_logging(): logging.basicConfig(level=logging.DEBUG, filename="test_gnupg.log", filemode="w", format="%(asctime)s %(levelname)-5s %(name)-10s %(threadName)-10s %(lineno)4d %(message)s") def main(): init_logging() logger.debug('Python version: %s', sys.version.replace('\n', ' ')) tests = suite() results = unittest.TextTestRunner(verbosity=1).run(tests) failed = not results.wasSuccessful() if failed and 'TOXENV' in os.environ and os.name != 'posix': os.system('type test_gnupg.log') return failed if __name__ == "__main__": sys.exit(main()) python-gnupg-0.4.8/gnupg.py0000664000175000017500000017404414147401075016171 0ustar vinayvinay00000000000000""" A wrapper for the 'gpg' command:: Portions of this module are derived from A.M. Kuchling's well-designed GPG.py, using Richard Jones' updated version 1.3, which can be found in the pycrypto CVS repository on Sourceforge: http://pycrypto.cvs.sourceforge.net/viewvc/pycrypto/gpg/GPG.py This module is *not* forward-compatible with amk's; some of the old interface has changed. For instance, since I've added decrypt functionality, I elected to initialize with a 'gnupghome' argument instead of 'keyring', so that gpg can find both the public and secret keyrings. I've also altered some of the returned objects in order for the caller to not have to know as much about the internals of the result classes. While the rest of ISconf is released under the GPL, I am releasing this single file under the same terms that A.M. Kuchling used for pycrypto. Steve Traugott, stevegt@terraluna.org Thu Jun 23 21:27:20 PDT 2005 This version of the module has been modified from Steve Traugott's version (see http://trac.t7a.org/isconf/browser/trunk/lib/python/isconf/GPG.py) by Vinay Sajip to make use of the subprocess module (Steve's version uses os.fork() and so does not work on Windows). Renamed to gnupg.py to avoid confusion with the previous versions. Modifications Copyright (C) 2008-2021 Vinay Sajip. All rights reserved. A unittest harness (test_gnupg.py) has also been added. """ __version__ = "0.4.8" __author__ = "Vinay Sajip" __date__ = "$24-Nov-2021 09:13:33$" try: from io import StringIO except ImportError: # pragma: no cover from cStringIO import StringIO import codecs import locale import logging import os import re import socket from subprocess import Popen from subprocess import PIPE import sys import threading STARTUPINFO = None if os.name == 'nt': # pragma: no cover try: from subprocess import STARTUPINFO, STARTF_USESHOWWINDOW, SW_HIDE except ImportError: STARTUPINFO = None try: import logging.NullHandler as NullHandler except ImportError: class NullHandler(logging.Handler): def handle(self, record): pass try: unicode _py3k = False string_types = basestring text_type = unicode except NameError: _py3k = True string_types = str text_type = str logger = logging.getLogger(__name__) if not logger.handlers: logger.addHandler(NullHandler()) # We use the test below because it works for Jython as well as CPython if os.path.__name__ == 'ntpath': # pragma: no cover # On Windows, we don't need shell quoting, other than worrying about # paths with spaces in them. def shell_quote(s): return '"%s"' % s else: # Section copied from sarge # This regex determines which shell input needs quoting # because it may be unsafe UNSAFE = re.compile(r'[^\w%+,./:=@-]') def shell_quote(s): """ Quote text so that it is safe for Posix command shells. For example, "*.py" would be converted to "'*.py'". If the text is considered safe it is returned unquoted. :param s: The value to quote :type s: str (or unicode on 2.x) :return: A safe version of the input, from the point of view of Posix command shells :rtype: The passed-in type """ if not isinstance(s, string_types): # pragma: no cover raise TypeError('Expected string type, got %s' % type(s)) if not s: result = "''" elif not UNSAFE.search(s): result = s else: result = "'%s'" % s.replace("'", r"'\''") return result # end of sarge code # Now that we use shell=False, we shouldn't need to quote arguments. # Use no_quote instead of shell_quote to remind us of where quoting # was needed. However, note that we still need, on 2.x, to encode any # Unicode argument with the file system encoding - see Issue #41 and # Python issue #1759845 ("subprocess.call fails with unicode strings in # command line"). # Allows the encoding used to be overridden in special cases by setting # this module attribute appropriately. fsencoding = sys.getfilesystemencoding() def no_quote(s): if not _py3k and isinstance(s, text_type): s = s.encode(fsencoding) return s def _copy_data(instream, outstream): # Copy one stream to another sent = 0 if hasattr(sys.stdin, 'encoding'): enc = sys.stdin.encoding else: # pragma: no cover enc = 'ascii' while True: # See issue #39: read can fail when e.g. a text stream is provided # for what is actually a binary file try: data = instream.read(1024) except UnicodeError: logger.warning('Exception occurred while reading', exc_info=1) break if not data: break sent += len(data) # logger.debug("sending chunk (%d): %r", sent, data[:256]) try: outstream.write(data) except UnicodeError: # pragma: no cover outstream.write(data.encode(enc)) except: # Can sometimes get 'broken pipe' errors even when the data has all # been sent logger.exception('Error sending data') break try: outstream.close() except IOError: # pragma: no cover logger.warning('Exception occurred while closing: ignored', exc_info=1) logger.debug("closed output, %d bytes sent", sent) def _threaded_copy_data(instream, outstream): wr = threading.Thread(target=_copy_data, args=(instream, outstream)) wr.setDaemon(True) logger.debug('data copier: %r, %r, %r', wr, instream, outstream) wr.start() return wr def _write_passphrase(stream, passphrase, encoding): passphrase = '%s\n' % passphrase passphrase = passphrase.encode(encoding) stream.write(passphrase) logger.debug('Wrote passphrase') def _is_sequence(instance): return isinstance(instance, (list, tuple, set, frozenset)) def _make_memory_stream(s): try: from io import BytesIO rv = BytesIO(s) except ImportError: # pragma: no cover rv = StringIO(s) return rv def _make_binary_stream(s, encoding): if _py3k: if isinstance(s, str): s = s.encode(encoding) else: if type(s) is not str: s = s.encode(encoding) return _make_memory_stream(s) class Verify(object): "Handle status messages for --verify" TRUST_UNDEFINED = 0 TRUST_NEVER = 1 TRUST_MARGINAL = 2 TRUST_FULLY = 3 TRUST_ULTIMATE = 4 TRUST_LEVELS = { "TRUST_UNDEFINED" : TRUST_UNDEFINED, "TRUST_NEVER" : TRUST_NEVER, "TRUST_MARGINAL" : TRUST_MARGINAL, "TRUST_FULLY" : TRUST_FULLY, "TRUST_ULTIMATE" : TRUST_ULTIMATE, } # for now, just the most common error codes. This can be expanded as and # when reports come in of other errors. GPG_SYSTEM_ERROR_CODES = { 1: 'permission denied', 35: 'file exists', 81: 'file not found', 97: 'not a directory', } GPG_ERROR_CODES = { 11: 'incorrect passphrase', } returncode = None def __init__(self, gpg): self.gpg = gpg self.valid = False self.fingerprint = self.creation_date = self.timestamp = None self.signature_id = self.key_id = None self.username = None self.key_id = None self.key_status = None self.status = None self.pubkey_fingerprint = None self.expire_timestamp = None self.sig_timestamp = None self.trust_text = None self.trust_level = None self.sig_info = {} def __nonzero__(self): return self.valid __bool__ = __nonzero__ def handle_status(self, key, value): def update_sig_info(**kwargs): sig_id = self.signature_id if sig_id: info = self.sig_info[sig_id] info.update(kwargs) if key in self.TRUST_LEVELS: self.trust_text = key self.trust_level = self.TRUST_LEVELS[key] update_sig_info(trust_level=self.trust_level, trust_text=self.trust_text) elif key in ("WARNING", "ERROR"): logger.warning('potential problem: %s: %s', key, value) elif key == "BADSIG": # pragma: no cover self.valid = False self.status = 'signature bad' self.key_id, self.username = value.split(None, 1) update_sig_info(keyid=self.key_id, username=self.username, status=self.status) elif key == "ERRSIG": # pragma: no cover self.valid = False parts = value.split() (self.key_id, algo, hash_algo, cls, self.timestamp) = parts[:5] # Since GnuPG 2.2.7, a fingerprint is tacked on if len(parts) >= 7: self.fingerprint = parts[6] self.status = 'signature error' update_sig_info(keyid=self.key_id, timestamp=self.timestamp, fingerprint=self.fingerprint, status=self.status) elif key == "EXPSIG": # pragma: no cover self.valid = False self.status = 'signature expired' self.key_id, self.username = value.split(None, 1) update_sig_info(keyid=self.key_id, username=self.username, status=self.status) elif key == "GOODSIG": self.valid = True self.status = 'signature good' self.key_id, self.username = value.split(None, 1) update_sig_info(keyid=self.key_id, username=self.username, status=self.status) elif key == "VALIDSIG": fingerprint, creation_date, sig_ts, expire_ts = value.split()[:4] (self.fingerprint, self.creation_date, self.sig_timestamp, self.expire_timestamp) = (fingerprint, creation_date, sig_ts, expire_ts) # may be different if signature is made with a subkey self.pubkey_fingerprint = value.split()[-1] self.status = 'signature valid' update_sig_info(fingerprint=fingerprint, creation_date=creation_date, timestamp=sig_ts, expiry=expire_ts, pubkey_fingerprint=self.pubkey_fingerprint, status=self.status) elif key == "SIG_ID": sig_id, creation_date, timestamp = value.split() self.sig_info[sig_id] = {'creation_date': creation_date, 'timestamp': timestamp} (self.signature_id, self.creation_date, self.timestamp) = (sig_id, creation_date, timestamp) elif key == "DECRYPTION_FAILED": # pragma: no cover self.valid = False self.key_id = value self.status = 'decryption failed' elif key == "NO_PUBKEY": # pragma: no cover self.valid = False self.key_id = value self.status = 'no public key' elif key == "NO_SECKEY": # pragma: no cover self.valid = False self.key_id = value self.status = 'no secret key' elif key in ("EXPKEYSIG", "REVKEYSIG"): # pragma: no cover # signed with expired or revoked key self.valid = False self.key_id = value.split()[0] if key == "EXPKEYSIG": self.key_status = 'signing key has expired' else: self.key_status = 'signing key was revoked' self.status = self.key_status update_sig_info(status=self.status, keyid=self.key_id) elif key in ("UNEXPECTED", "FAILURE"): # pragma: no cover self.valid = False self.key_id = value if key == "UNEXPECTED": self.status = 'unexpected data' else: # N.B. there might be other reasons. For example, if an output # file can't be created - /dev/null/foo will lead to a # "not a directory" error, but which is not sent as a status # message with the [GNUPG:] prefix. Similarly if you try to # write to "/etc/foo" as a non-root user, a "permission denied" # error will be sent as a non-status message. message = 'error - %s' % value operation, code = value.rsplit(' ', 1) if code.isdigit(): code = int(code) & 0xFFFFFF # lose the error source if self.gpg.error_map and code in self.gpg.error_map: message = '%s: %s' % (operation, self.gpg.error_map[code]) else: system_error = bool(code & 0x8000) code = code & 0x7FFF if system_error: mapping = self.GPG_SYSTEM_ERROR_CODES else: mapping = self.GPG_ERROR_CODES if code in mapping: message = '%s: %s' % (operation, mapping[code]) if not self.status: self.status = message elif key in ("DECRYPTION_INFO", "PLAINTEXT", "PLAINTEXT_LENGTH", "BEGIN_SIGNING"): pass else: # pragma: no cover logger.debug('message ignored: %s, %s', key, value) class ImportResult(object): "Handle status messages for --import" counts = '''count no_user_id imported imported_rsa unchanged n_uids n_subk n_sigs n_revoc sec_read sec_imported sec_dups not_imported'''.split() returncode = None def __init__(self, gpg): self.gpg = gpg self.results = [] self.fingerprints = [] for result in self.counts: setattr(self, result, 0) def __nonzero__(self): if self.not_imported: return False if not self.fingerprints: return False return True __bool__ = __nonzero__ ok_reason = { '0': 'Not actually changed', '1': 'Entirely new key', '2': 'New user IDs', '4': 'New signatures', '8': 'New subkeys', '16': 'Contains private key', } problem_reason = { '0': 'No specific reason given', '1': 'Invalid Certificate', '2': 'Issuer Certificate missing', '3': 'Certificate Chain too long', '4': 'Error storing certificate', } def handle_status(self, key, value): if key in ("WARNING", "ERROR"): logger.warning('potential problem: %s: %s', key, value) elif key in ("IMPORTED", "KEY_CONSIDERED"): # this duplicates info we already see in import_ok & import_problem pass elif key == "NODATA": # pragma: no cover self.results.append({'fingerprint': None, 'problem': '0', 'text': 'No valid data found'}) elif key == "IMPORT_OK": reason, fingerprint = value.split() reasons = [] for code, text in list(self.ok_reason.items()): if int(reason) | int(code) == int(reason): reasons.append(text) reasontext = '\n'.join(reasons) + "\n" self.results.append({'fingerprint': fingerprint, 'ok': reason, 'text': reasontext}) self.fingerprints.append(fingerprint) elif key == "IMPORT_PROBLEM": # pragma: no cover try: reason, fingerprint = value.split() except: reason = value fingerprint = '' self.results.append({'fingerprint': fingerprint, 'problem': reason, 'text': self.problem_reason[reason]}) elif key == "IMPORT_RES": import_res = value.split() for i, count in enumerate(self.counts): setattr(self, count, int(import_res[i])) elif key == "KEYEXPIRED": # pragma: no cover self.results.append({'fingerprint': None, 'problem': '0', 'text': 'Key expired'}) elif key == "SIGEXPIRED": # pragma: no cover self.results.append({'fingerprint': None, 'problem': '0', 'text': 'Signature expired'}) elif key == "FAILURE": # pragma: no cover self.results.append({'fingerprint': None, 'problem': '0', 'text': 'Other failure'}) else: # pragma: no cover logger.debug('message ignored: %s, %s', key, value) def summary(self): result = [] result.append('%d imported' % self.imported) if self.not_imported: # pragma: no cover result.append('%d not imported' % self.not_imported) return ', '.join(result) ESCAPE_PATTERN = re.compile(r'\\x([0-9a-f][0-9a-f])', re.I) BASIC_ESCAPES = { r'\n': '\n', r'\r': '\r', r'\f': '\f', r'\v': '\v', r'\b': '\b', r'\0': '\0', } class SendResult(object): returncode = None def __init__(self, gpg): self.gpg = gpg def handle_status(self, key, value): logger.debug('SendResult: %s: %s', key, value) def _set_fields(target, fieldnames, args): for i, var in enumerate(fieldnames): if i < len(args): target[var] = args[i] else: target[var] = 'unavailable' class SearchKeys(list): ''' Handle status messages for --search-keys. Handle pub and uid (relating the latter to the former). Don't care about the rest ''' UID_INDEX = 1 FIELDS = 'type keyid algo length date expires'.split() returncode = None def __init__(self, gpg): self.gpg = gpg self.curkey = None self.fingerprints = [] self.uids = [] def get_fields(self, args): result = {} _set_fields(result, self.FIELDS, args) result['uids'] = [] result['sigs'] = [] return result def pub(self, args): self.curkey = curkey = self.get_fields(args) self.append(curkey) def uid(self, args): uid = args[self.UID_INDEX] uid = ESCAPE_PATTERN.sub(lambda m: chr(int(m.group(1), 16)), uid) for k, v in BASIC_ESCAPES.items(): uid = uid.replace(k, v) self.curkey['uids'].append(uid) self.uids.append(uid) def handle_status(self, key, value): # pragma: no cover pass class ListKeys(SearchKeys): ''' Handle status messages for --list-keys, --list-sigs. Handle pub and uid (relating the latter to the former). Don't care about (info from src/DETAILS): crt = X.509 certificate crs = X.509 certificate and private key available uat = user attribute (same as user id except for field 10). sig = signature rev = revocation signature pkd = public key data (special field format, see below) grp = reserved for gpgsm rvk = revocation key ''' UID_INDEX = 9 FIELDS = 'type trust length algo keyid date expires dummy ownertrust uid sig cap issuer flag token hash curve compliance updated origin'.split() def __init__(self, gpg): super(ListKeys, self).__init__(gpg) self.in_subkey = False self.key_map = {} def key(self, args): self.curkey = curkey = self.get_fields(args) if curkey['uid']: curkey['uids'].append(curkey['uid']) del curkey['uid'] curkey['subkeys'] = [] self.append(curkey) self.in_subkey = False pub = sec = key def fpr(self, args): fp = args[9] if fp in self.key_map and self.gpg.check_fingerprint_collisions: # pragma: no cover raise ValueError('Unexpected fingerprint collision: %s' % fp) if not self.in_subkey: self.curkey['fingerprint'] = fp self.fingerprints.append(fp) self.key_map[fp] = self.curkey else: self.curkey['subkeys'][-1].append(fp) self.key_map[fp] = self.curkey def _collect_subkey_info(self, curkey, args): info_map = curkey.setdefault('subkey_info', {}) info = {} _set_fields(info, self.FIELDS, args) info_map[args[4]] = info def sub(self, args): # See issue #81. We create a dict with more information about # subkeys, but for backward compatibility reason, have to add it in # as a separate entry 'subkey_info' subkey = [args[4], args[11]] # keyid, type self.curkey['subkeys'].append(subkey) self._collect_subkey_info(self.curkey, args) self.in_subkey = True def ssb(self, args): subkey = [args[4], None] # keyid, type self.curkey['subkeys'].append(subkey) self._collect_subkey_info(self.curkey, args) self.in_subkey = True def sig(self, args): # keyid, uid, sigclass self.curkey['sigs'].append((args[4], args[9], args[10])) class ScanKeys(ListKeys): ''' Handle status messages for --with-fingerprint.''' def sub(self, args): # --with-fingerprint --with-colons somehow outputs fewer colons, # use the last value args[-1] instead of args[11] subkey = [args[4], args[-1]] self.curkey['subkeys'].append(subkey) self._collect_subkey_info(self.curkey, args) self.in_subkey = True class TextHandler(object): def _as_text(self): return self.data.decode(self.gpg.encoding, self.gpg.decode_errors) if _py3k: __str__ = _as_text else: __unicode__ = _as_text def __str__(self): return self.data class Crypt(Verify, TextHandler): "Handle status messages for --encrypt and --decrypt" def __init__(self, gpg): Verify.__init__(self, gpg) self.data = '' self.ok = False self.status = '' self.key_id = None def __nonzero__(self): if self.ok: return True return False __bool__ = __nonzero__ def handle_status(self, key, value): if key in ("WARNING", "ERROR"): logger.warning('potential problem: %s: %s', key, value) elif key == "NODATA": if self.status not in ("decryption failed",): self.status = "no data was provided" elif key in ("NEED_PASSPHRASE", "BAD_PASSPHRASE", "GOOD_PASSPHRASE", "MISSING_PASSPHRASE", "KEY_NOT_CREATED", "NEED_PASSPHRASE_PIN"): self.status = key.replace("_", " ").lower() elif key == "DECRYPTION_FAILED": if self.status != 'no secret key': # don't overwrite more useful message self.status = 'decryption failed' elif key == "NEED_PASSPHRASE_SYM": self.status = 'need symmetric passphrase' elif key == "BEGIN_DECRYPTION": if self.status != 'no secret key': # don't overwrite more useful message self.status = 'decryption incomplete' elif key == "BEGIN_ENCRYPTION": self.status = 'encryption incomplete' elif key == "DECRYPTION_OKAY": self.status = 'decryption ok' self.ok = True elif key == "END_ENCRYPTION": self.status = 'encryption ok' self.ok = True elif key == "INV_RECP": # pragma: no cover self.status = 'invalid recipient' elif key == "KEYEXPIRED": # pragma: no cover self.status = 'key expired' elif key == "SIG_CREATED": # pragma: no cover self.status = 'sig created' elif key == "SIGEXPIRED": # pragma: no cover self.status = 'sig expired' elif key == "ENC_TO": # pragma: no cover # ENC_TO self.key_id = value.split(' ', 1)[0] elif key in ("USERID_HINT", "GOODMDC", "END_DECRYPTION", "CARDCTRL", "BADMDC", "SC_OP_FAILURE", "SC_OP_SUCCESS", "PINENTRY_LAUNCHED", "KEY_CONSIDERED"): pass else: Verify.handle_status(self, key, value) class GenKey(object): "Handle status messages for --gen-key" returncode = None def __init__(self, gpg): self.gpg = gpg self.type = None self.fingerprint = None def __nonzero__(self): if self.fingerprint: return True return False __bool__ = __nonzero__ def __str__(self): return self.fingerprint or '' def handle_status(self, key, value): if key in ("WARNING", "ERROR"): # pragma: no cover logger.warning('potential problem: %s: %s', key, value) elif key == "KEY_CREATED": (self.type,self.fingerprint) = value.split() elif key in ("PROGRESS", "GOOD_PASSPHRASE", "KEY_NOT_CREATED"): pass else: # pragma: no cover logger.debug('message ignored: %s, %s', key, value) class ExportResult(GenKey): """Handle status messages for --export[-secret-key]. For now, just use an existing class to base it on - if needed, we can override handle_status for more specific message handling. """ def handle_status(self, key, value): if key in ("EXPORTED", "EXPORT_RES"): pass else: super(ExportResult, self).handle_status(key, value) class DeleteResult(object): "Handle status messages for --delete-key and --delete-secret-key" returncode = None def __init__(self, gpg): self.gpg = gpg self.status = 'ok' def __str__(self): return self.status problem_reason = { '1': 'No such key', '2': 'Must delete secret key first', '3': 'Ambiguous specification', } def handle_status(self, key, value): if key == "DELETE_PROBLEM": # pragma: no cover self.status = self.problem_reason.get(value, "Unknown error: %r" % value) else: # pragma: no cover logger.debug('message ignored: %s, %s', key, value) def __nonzero__(self): return self.status == 'ok' __bool__ = __nonzero__ class TrustResult(DeleteResult): pass class Sign(TextHandler): "Handle status messages for --sign" returncode = None def __init__(self, gpg): self.gpg = gpg self.type = None self.hash_algo = None self.fingerprint = None self.status = None self.key_id = None self.username = None def __nonzero__(self): return self.fingerprint is not None __bool__ = __nonzero__ def handle_status(self, key, value): if key in ("WARNING", "ERROR", "FAILURE"): # pragma: no cover logger.warning('potential problem: %s: %s', key, value) elif key in ("KEYEXPIRED", "SIGEXPIRED"): # pragma: no cover self.status = 'key expired' elif key == "KEYREVOKED": # pragma: no cover self.status = 'key revoked' elif key == "SIG_CREATED": (self.type, algo, self.hash_algo, cls, self.timestamp, self.fingerprint ) = value.split() self.status = 'signature created' elif key == "USERID_HINT": # pragma: no cover self.key_id, self.username = value.split(' ', 1) elif key == "BAD_PASSPHRASE": self.status = 'bad passphrase' elif key in ("NEED_PASSPHRASE", "GOOD_PASSPHRASE", "BEGIN_SIGNING"): pass else: # pragma: no cover logger.debug('message ignored: %s, %s', key, value) VERSION_RE = re.compile(r'gpg \(GnuPG(?:/MacGPG2)?\) (\d+(\.\d+)*)'.encode('ascii'), re.I) HEX_DIGITS_RE = re.compile(r'[0-9a-f]+$', re.I) PUBLIC_KEY_RE = re.compile(r'gpg: public key is (\w+)') class GPG(object): error_map = None decode_errors = 'strict' result_map = { 'crypt': Crypt, 'delete': DeleteResult, 'generate': GenKey, 'import': ImportResult, 'send': SendResult, 'list': ListKeys, 'scan': ScanKeys, 'search': SearchKeys, 'sign': Sign, 'trust': TrustResult, 'verify': Verify, 'export': ExportResult, } "Encapsulate access to the gpg executable" def __init__(self, gpgbinary='gpg', gnupghome=None, verbose=False, use_agent=False, keyring=None, options=None, secret_keyring=None): """Initialize a GPG process wrapper. Options are: gpgbinary -- full pathname for GPG binary. gnupghome -- full pathname to where we can find the public and private keyrings. Default is whatever gpg defaults to. keyring -- name of alternative keyring file to use, or list of such keyrings. If specified, the default keyring is not used. options =-- a list of additional options to pass to the GPG binary. secret_keyring -- name of alternative secret keyring file to use, or list of such keyrings. """ self.gpgbinary = gpgbinary self.gnupghome = gnupghome # issue 112: fail if the specified value isn't a directory if gnupghome and not os.path.isdir(gnupghome): raise ValueError('gnupghome should be a directory (it isn\'t): %s' % gnupghome) if keyring: # Allow passing a string or another iterable. Make it uniformly # a list of keyring filenames if isinstance(keyring, string_types): keyring = [keyring] self.keyring = keyring if secret_keyring: # Allow passing a string or another iterable. Make it uniformly # a list of keyring filenames if isinstance(secret_keyring, string_types): secret_keyring = [secret_keyring] self.secret_keyring = secret_keyring self.verbose = verbose self.use_agent = use_agent if isinstance(options, str): # pragma: no cover options = [options] self.options = options self.on_data = None # or a callable - will be called with data chunks # Changed in 0.3.7 to use Latin-1 encoding rather than # locale.getpreferredencoding falling back to sys.stdin.encoding # falling back to utf-8, because gpg itself uses latin-1 as the default # encoding. self.encoding = 'latin-1' if gnupghome and not os.path.isdir(self.gnupghome): os.makedirs(self.gnupghome,0x1C0) try: p = self._open_subprocess(["--version"]) except OSError: msg = 'Unable to run gpg (%s) - it may not be available.' % self.gpgbinary logger.exception(msg) raise OSError(msg) result = self.result_map['verify'](self) # any result will do for this self._collect_output(p, result, stdin=p.stdin) if p.returncode != 0: # pragma: no cover raise ValueError("Error invoking gpg: %s: %s" % (p.returncode, result.stderr)) m = VERSION_RE.match(result.data) if not m: # pragma: no cover self.version = None else: dot = '.'.encode('ascii') self.version = tuple([int(s) for s in m.groups()[0].split(dot)]) # See issue #97. It seems gpg allow duplicate keys in keyrings, so we # can't be too strict. self.check_fingerprint_collisions = False def make_args(self, args, passphrase): """ Make a list of command line elements for GPG. The value of ``args`` will be appended. The ``passphrase`` argument needs to be True if a passphrase will be sent to GPG, else False. """ cmd = [self.gpgbinary, '--status-fd', '2', '--no-tty', '--no-verbose'] if 'DEBUG_IPC' in os.environ: cmd.extend(['--debug', 'ipc']) if passphrase and hasattr(self, 'version'): if self.version >= (2, 1): cmd[1:1] = ['--pinentry-mode', 'loopback'] cmd.extend(['--fixed-list-mode', '--batch', '--with-colons']) if self.gnupghome: cmd.extend(['--homedir', no_quote(self.gnupghome)]) if self.keyring: cmd.append('--no-default-keyring') for fn in self.keyring: cmd.extend(['--keyring', no_quote(fn)]) if self.secret_keyring: for fn in self.secret_keyring: cmd.extend(['--secret-keyring', no_quote(fn)]) if passphrase: cmd.extend(['--passphrase-fd', '0']) if self.use_agent: # pragma: no cover cmd.append('--use-agent') if self.options: cmd.extend(self.options) cmd.extend(args) return cmd def _open_subprocess(self, args, passphrase=False): # Internal method: open a pipe to a GPG subprocess and return # the file objects for communicating with it. # def debug_print(cmd): # result = [] # for c in cmd: # if ' ' not in c: # result.append(c) # else: # if '"' not in c: # result.append('"%s"' % c) # elif "'" not in c: # result.append("'%s'" % c) # else: # result.append(c) # give up # return ' '.join(cmd) from subprocess import list2cmdline as debug_print cmd = self.make_args(args, passphrase) if self.verbose: # pragma: no cover print(debug_print(cmd)) if not STARTUPINFO: si = None else: # pragma: no cover si = STARTUPINFO() si.dwFlags = STARTF_USESHOWWINDOW si.wShowWindow = SW_HIDE result = Popen(cmd, shell=False, stdin=PIPE, stdout=PIPE, stderr=PIPE, startupinfo=si) logger.debug("%s: %s", result.pid, debug_print(cmd)) return result def _read_response(self, stream, result): # Internal method: reads all the stderr output from GPG, taking notice # only of lines that begin with the magic [GNUPG:] prefix. # # Calls methods on the response object for each valid token found, # with the arg being the remainder of the status line. lines = [] while True: line = stream.readline() if len(line) == 0: break lines.append(line) line = line.rstrip() if self.verbose: # pragma: no cover print(line) logger.debug("%s", line) if line[0:9] == '[GNUPG:] ': # Chop off the prefix line = line[9:] L = line.split(None, 1) keyword = L[0] if len(L) > 1: value = L[1] else: value = "" result.handle_status(keyword, value) result.stderr = ''.join(lines) def _read_data(self, stream, result, on_data=None): # Read the contents of the file from GPG's stdout chunks = [] while True: data = stream.read(1024) if len(data) == 0: if on_data: on_data(data) break logger.debug("chunk: %r" % data[:256]) append = True if on_data: append = on_data(data) != False if append: chunks.append(data) if _py3k: # Join using b'' or '', as appropriate result.data = type(data)().join(chunks) else: result.data = ''.join(chunks) def _collect_output(self, process, result, writer=None, stdin=None): """ Drain the subprocesses output streams, writing the collected output to the result. If a writer thread (writing to the subprocess) is given, make sure it's joined before returning. If a stdin stream is given, close it before returning. """ stderr = codecs.getreader(self.encoding)(process.stderr) rr = threading.Thread(target=self._read_response, args=(stderr, result)) rr.setDaemon(True) logger.debug('stderr reader: %r', rr) rr.start() stdout = process.stdout dr = threading.Thread(target=self._read_data, args=(stdout, result, self.on_data)) dr.setDaemon(True) logger.debug('stdout reader: %r', dr) dr.start() dr.join() rr.join() if writer is not None: writer.join() process.wait() result.returncode = rc = process.returncode if rc != 0: logger.warning('gpg returned a non-zero error code: %d', rc) if stdin is not None: try: stdin.close() except IOError: # pragma: no cover pass stderr.close() stdout.close() return rc def is_valid_file(self, fileobj): """ Simplistic check for a file object """ return hasattr(fileobj, 'read') def _handle_io(self, args, fileobj, result, passphrase=None, binary=False): "Handle a call to GPG - pass input data, collect output data" # Handle a basic data call - pass data to GPG, handle the output # including status information. Garbage In, Garbage Out :) if not self.is_valid_file(fileobj): raise TypeError('Not a valid file: %s' % fileobj) p = self._open_subprocess(args, passphrase is not None) if not binary: # pragma: no cover stdin = codecs.getwriter(self.encoding)(p.stdin) else: stdin = p.stdin if passphrase: _write_passphrase(stdin, passphrase, self.encoding) writer = _threaded_copy_data(fileobj, stdin) self._collect_output(p, result, writer, stdin) return result # # SIGNATURE METHODS # def sign(self, message, **kwargs): """sign message""" f = _make_binary_stream(message, self.encoding) result = self.sign_file(f, **kwargs) f.close() return result def set_output_without_confirmation(self, args, output): "If writing to a file which exists, avoid a confirmation message." if os.path.exists(output): # We need to avoid an overwrite confirmation message args.extend(['--yes']) args.extend(['--output', no_quote(output)]) def is_valid_passphrase(self, passphrase): """ Confirm that the passphrase doesn't contain newline-type characters - it is passed in a pipe to gpg, and so not checking could lead to spoofing attacks by passing arbitrary text after passphrase and newline. """ return ('\n' not in passphrase and '\r' not in passphrase and '\x00' not in passphrase) def sign_file(self, file, keyid=None, passphrase=None, clearsign=True, detach=False, binary=False, output=None, extra_args=None): """sign file""" if passphrase and not self.is_valid_passphrase(passphrase): raise ValueError('Invalid passphrase') logger.debug("sign_file: %s", file) if binary: # pragma: no cover args = ['-s'] else: args = ['-sa'] # You can't specify detach-sign and clearsign together: gpg ignores # the detach-sign in that case. if detach: args.append("--detach-sign") elif clearsign: args.append("--clearsign") if keyid: args.extend(['--default-key', no_quote(keyid)]) if output: # write the output to a file with the specified name self.set_output_without_confirmation(args, output) if extra_args: args.extend(extra_args) result = self.result_map['sign'](self) #We could use _handle_io here except for the fact that if the #passphrase is bad, gpg bails and you can't write the message. p = self._open_subprocess(args, passphrase is not None) try: stdin = p.stdin if passphrase: _write_passphrase(stdin, passphrase, self.encoding) writer = _threaded_copy_data(file, stdin) except IOError: # pragma: no cover logging.exception("error writing message") writer = None self._collect_output(p, result, writer, stdin) return result def verify(self, data, **kwargs): """Verify the signature on the contents of the string 'data' >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> input = gpg.gen_key_input(passphrase='foo') >>> key = gpg.gen_key(input) >>> assert key >>> sig = gpg.sign('hello',keyid=key.fingerprint,passphrase='bar') >>> assert not sig >>> sig = gpg.sign('hello',keyid=key.fingerprint,passphrase='foo') >>> assert sig >>> verify = gpg.verify(sig.data) >>> assert verify """ f = _make_binary_stream(data, self.encoding) result = self.verify_file(f, **kwargs) f.close() return result def verify_file(self, file, data_filename=None, close_file=True, extra_args=None): "Verify the signature on the contents of the file-like object 'file'" logger.debug('verify_file: %r, %r', file, data_filename) result = self.result_map['verify'](self) args = ['--verify'] if extra_args: args.extend(extra_args) if data_filename is None: self._handle_io(args, file, result, binary=True) else: logger.debug('Handling detached verification') import tempfile fd, fn = tempfile.mkstemp(prefix='pygpg') s = file.read() if close_file: file.close() logger.debug('Wrote to temp file: %r', s) os.write(fd, s) os.close(fd) args.append(no_quote(fn)) args.append(no_quote(data_filename)) try: p = self._open_subprocess(args) self._collect_output(p, result, stdin=p.stdin) finally: os.unlink(fn) return result def verify_data(self, sig_filename, data, extra_args=None): "Verify the signature in sig_filename against data in memory" logger.debug('verify_data: %r, %r ...', sig_filename, data[:16]) result = self.result_map['verify'](self) args = ['--verify'] if extra_args: args.extend(extra_args) args.extend([no_quote(sig_filename), '-']) stream = _make_memory_stream(data) self._handle_io(args, stream, result, binary=True) return result # # KEY MANAGEMENT # def import_keys(self, key_data, extra_args=None, passphrase=None): """ Import the key_data into our keyring. """ result = self.result_map['import'](self) logger.debug('import_keys: %r', key_data[:256]) data = _make_binary_stream(key_data, self.encoding) args = ['--import'] if extra_args: args.extend(extra_args) self._handle_io(args, data, result, passphrase=passphrase, binary=True) logger.debug('import_keys result: %r', result.__dict__) data.close() return result def recv_keys(self, keyserver, *keyids): """Import a key from a keyserver >>> import shutil >>> shutil.rmtree("keys", ignore_errors=True) >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> os.chmod('keys', 0x1C0) >>> result = gpg.recv_keys('pgp.mit.edu', '92905378') >>> if 'NO_EXTERNAL_TESTS' not in os.environ: assert result """ result = self.result_map['import'](self) logger.debug('recv_keys: %r', keyids) data = _make_binary_stream("", self.encoding) #data = "" args = ['--keyserver', no_quote(keyserver), '--recv-keys'] args.extend([no_quote(k) for k in keyids]) self._handle_io(args, data, result, binary=True) logger.debug('recv_keys result: %r', result.__dict__) data.close() return result def send_keys(self, keyserver, *keyids): """Send a key to a keyserver. Note: it's not practical to test this function without sending arbitrary data to live keyservers. """ result = self.result_map['send'](self) logger.debug('send_keys: %r', keyids) data = _make_binary_stream('', self.encoding) #data = "" args = ['--keyserver', no_quote(keyserver), '--send-keys'] args.extend([no_quote(k) for k in keyids]) self._handle_io(args, data, result, binary=True) logger.debug('send_keys result: %r', result.__dict__) data.close() return result def delete_keys(self, fingerprints, secret=False, passphrase=None, expect_passphrase=True): """ Delete the indicated keys. Since GnuPG 2.1, you can't delete secret keys without providing a passphrase. However, if you're expecting the passphrase to go to gpg via pinentry, you should specify expect_passphrase=False. (It's only checked for GnuPG >= 2.1). """ if passphrase and not self.is_valid_passphrase(passphrase): raise ValueError('Invalid passphrase') which='key' if secret: # pragma: no cover if (self.version >= (2, 1) and passphrase is None and expect_passphrase): raise ValueError('For GnuPG >= 2.1, deleting secret keys ' 'needs a passphrase to be provided') which='secret-key' if _is_sequence(fingerprints): # pragma: no cover fingerprints = [no_quote(s) for s in fingerprints] else: fingerprints = [no_quote(fingerprints)] args = ['--delete-%s' % which] if secret and self.version >= (2, 1): args.insert(0, '--yes') args.extend(fingerprints) result = self.result_map['delete'](self) if not secret or self.version < (2, 1): p = self._open_subprocess(args) self._collect_output(p, result, stdin=p.stdin) else: # Need to send in a passphrase. f = _make_binary_stream('', self.encoding) try: self._handle_io(args, f, result, passphrase=passphrase, binary=True) finally: f.close() return result def export_keys(self, keyids, secret=False, armor=True, minimal=False, passphrase=None, expect_passphrase=True): """ Export the indicated keys. A 'keyid' is anything gpg accepts. Since GnuPG 2.1, you can't export secret keys without providing a passphrase. However, if you're expecting the passphrase to go to gpg via pinentry, you should specify expect_passphrase=False. (It's only checked for GnuPG >= 2.1). """ if passphrase and not self.is_valid_passphrase(passphrase): raise ValueError('Invalid passphrase') which='' if secret: which='-secret-key' if (self.version >= (2, 1) and passphrase is None and expect_passphrase): raise ValueError('For GnuPG >= 2.1, exporting secret keys ' 'needs a passphrase to be provided') if _is_sequence(keyids): keyids = [no_quote(k) for k in keyids] else: keyids = [no_quote(keyids)] args = ['--export%s' % which] if armor: args.append('--armor') if minimal: # pragma: no cover args.extend(['--export-options','export-minimal']) args.extend(keyids) # gpg --export produces no status-fd output; stdout will be # empty in case of failure #stdout, stderr = p.communicate() result = self.result_map['export'](self) if not secret or self.version < (2, 1): p = self._open_subprocess(args) self._collect_output(p, result, stdin=p.stdin) else: # Need to send in a passphrase. f = _make_binary_stream('', self.encoding) try: self._handle_io(args, f, result, passphrase=passphrase, binary=True) finally: f.close() logger.debug('export_keys result[:100]: %r', result.data[:100]) # Issue #49: Return bytes if armor not specified, else text result = result.data if armor: result = result.decode(self.encoding, self.decode_errors) return result def _get_list_output(self, p, kind): # Get the response information result = self.result_map[kind](self) self._collect_output(p, result, stdin=p.stdin) lines = result.data.decode(self.encoding, self.decode_errors).splitlines() valid_keywords = 'pub uid sec fpr sub ssb sig'.split() for line in lines: if self.verbose: # pragma: no cover print(line) logger.debug("line: %r", line.rstrip()) if not line: # pragma: no cover break L = line.strip().split(':') if not L: # pragma: no cover continue keyword = L[0] if keyword in valid_keywords: getattr(result, keyword)(L) return result def list_keys(self, secret=False, keys=None, sigs=False): """ list the keys currently in the keyring >>> import shutil >>> shutil.rmtree("keys", ignore_errors=True) >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> input = gpg.gen_key_input(passphrase='foo') >>> result = gpg.gen_key(input) >>> fp1 = result.fingerprint >>> result = gpg.gen_key(input) >>> fp2 = result.fingerprint >>> pubkeys = gpg.list_keys() >>> assert fp1 in pubkeys.fingerprints >>> assert fp2 in pubkeys.fingerprints """ if sigs: which = 'sigs' else: which = 'keys' if secret: which='secret-keys' args = ['--list-%s' % which, '--fingerprint', '--fingerprint'] # get subkey FPs, too if keys: if isinstance(keys, string_types): keys = [keys] args.extend(keys) p = self._open_subprocess(args) return self._get_list_output(p, 'list') def scan_keys(self, filename): """ List details of an ascii armored or binary key file without first importing it to the local keyring. The function achieves this on modern GnuPG by running: $ gpg --dry-run --import-options import-show --import On older versions, it does the *much* riskier: $ gpg --with-fingerprint --with-colons filename """ if self.version >= (2, 1): args = ['--dry-run', '--import-options', 'import-show', '--import'] else: logger.warning('Trying to list packets, but if the file is not a ' 'keyring, might accidentally decrypt') args = ['--with-fingerprint', '--with-colons', '--fixed-list-mode'] args.append(no_quote(filename)) p = self._open_subprocess(args) return self._get_list_output(p, 'scan') def search_keys(self, query, keyserver='pgp.mit.edu'): """ search keyserver by query (using --search-keys option) >>> import shutil >>> shutil.rmtree('keys', ignore_errors=True) >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> os.chmod('keys', 0x1C0) >>> result = gpg.search_keys('') >>> if 'NO_EXTERNAL_TESTS' not in os.environ: assert result, 'Failed using default keyserver' >>> #keyserver = 'keyserver.ubuntu.com' >>> #result = gpg.search_keys('', keyserver) >>> #assert result, 'Failed using keyserver.ubuntu.com' """ query = query.strip() if HEX_DIGITS_RE.match(query): query = '0x' + query args = ['--fingerprint', '--keyserver', no_quote(keyserver), '--search-keys', no_quote(query)] p = self._open_subprocess(args) # Get the response information result = self.result_map['search'](self) self._collect_output(p, result, stdin=p.stdin) lines = result.data.decode(self.encoding, self.decode_errors).splitlines() valid_keywords = ['pub', 'uid'] for line in lines: if self.verbose: # pragma: no cover print(line) logger.debug('line: %r', line.rstrip()) if not line: # sometimes get blank lines on Windows continue L = line.strip().split(':') if not L: # pragma: no cover continue keyword = L[0] if keyword in valid_keywords: getattr(result, keyword)(L) return result def gen_key(self, input): """Generate a key; you might use gen_key_input() to create the control input. >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> input = gpg.gen_key_input(passphrase='foo') >>> result = gpg.gen_key(input) >>> assert result >>> result = gpg.gen_key('foo') >>> assert not result """ args = ["--gen-key"] result = self.result_map['generate'](self) f = _make_binary_stream(input, self.encoding) self._handle_io(args, f, result, binary=True) f.close() return result def gen_key_input(self, **kwargs): """ Generate --gen-key input per gpg doc/DETAILS """ parms = {} no_protection = kwargs.pop('no_protection', False) for key, val in list(kwargs.items()): key = key.replace('_','-').title() if str(val).strip(): # skip empty strings parms[key] = val parms.setdefault('Key-Type','RSA') if 'key_curve' not in kwargs: parms.setdefault('Key-Length',2048) parms.setdefault('Name-Real', "Autogenerated Key") logname = (os.environ.get('LOGNAME') or os.environ.get('USERNAME') or 'unspecified') hostname = socket.gethostname() parms.setdefault('Name-Email', "%s@%s" % (logname.replace(' ', '_'), hostname)) out = "Key-Type: %s\n" % parms.pop('Key-Type') for key, val in list(parms.items()): out += "%s: %s\n" % (key, val) if no_protection: out += '%no-protection\n' out += "%commit\n" return out # Key-Type: RSA # Key-Length: 1024 # Name-Real: ISdlink Server on %s # Name-Comment: Created by %s # Name-Email: isdlink@%s # Expire-Date: 0 # %commit # # # Key-Type: DSA # Key-Length: 1024 # Subkey-Type: ELG-E # Subkey-Length: 1024 # Name-Real: Joe Tester # Name-Comment: with stupid passphrase # Name-Email: joe@foo.bar # Expire-Date: 0 # Passphrase: abc # %pubring foo.pub # %secring foo.sec # %commit # # ENCRYPTION # def encrypt_file(self, file, recipients, sign=None, always_trust=False, passphrase=None, armor=True, output=None, symmetric=False, extra_args=None): "Encrypt the message read from the file-like object 'file'" if passphrase and not self.is_valid_passphrase(passphrase): raise ValueError('Invalid passphrase') args = ['--encrypt'] if symmetric: # can't be False or None - could be True or a cipher algo value # such as AES256 args = ['--symmetric'] if symmetric is not True: args.extend(['--cipher-algo', no_quote(symmetric)]) # else use the default, currently CAST5 else: if not recipients: raise ValueError('No recipients specified with asymmetric ' 'encryption') if not _is_sequence(recipients): recipients = (recipients,) for recipient in recipients: args.extend(['--recipient', no_quote(recipient)]) if armor: # create ascii-armored output - False for binary output args.append('--armor') if output: # write the output to a file with the specified name self.set_output_without_confirmation(args, output) if sign is True: # pragma: no cover args.append('--sign') elif sign: # pragma: no cover args.extend(['--sign', '--default-key', no_quote(sign)]) if always_trust: # pragma: no cover args.append('--always-trust') if extra_args: args.extend(extra_args) result = self.result_map['crypt'](self) self._handle_io(args, file, result, passphrase=passphrase, binary=True) logger.debug('encrypt result[:100]: %r', result.data[:100]) return result def encrypt(self, data, recipients, **kwargs): """Encrypt the message contained in the string 'data' >>> import shutil >>> if os.path.exists("keys"): ... shutil.rmtree("keys", ignore_errors=True) >>> GPGBINARY = os.environ.get('GPGBINARY', 'gpg') >>> if not os.path.isdir('keys'): os.mkdir('keys') >>> gpg = GPG(gpgbinary=GPGBINARY, gnupghome='keys') >>> input = gpg.gen_key_input(name_email='user1@test', passphrase='pp1') >>> result = gpg.gen_key(input) >>> fp1 = result.fingerprint >>> input = gpg.gen_key_input(name_email='user2@test', passphrase='pp2') >>> result = gpg.gen_key(input) >>> fp2 = result.fingerprint >>> result = gpg.encrypt("hello",fp2) >>> message = str(result) >>> assert message != 'hello' >>> result = gpg.decrypt(message, passphrase='pp2') >>> assert result >>> str(result) 'hello' >>> result = gpg.encrypt("hello again", fp1) >>> message = str(result) >>> result = gpg.decrypt(message, passphrase='bar') >>> result.status in ('decryption failed', 'bad passphrase') True >>> assert not result >>> result = gpg.decrypt(message, passphrase='pp1') >>> result.status == 'decryption ok' True >>> str(result) 'hello again' >>> result = gpg.encrypt("signed hello", fp2, sign=fp1, passphrase='pp1') >>> result.status == 'encryption ok' True >>> message = str(result) >>> result = gpg.decrypt(message, passphrase='pp2') >>> result.status == 'decryption ok' True >>> assert result.fingerprint == fp1 """ data = _make_binary_stream(data, self.encoding) result = self.encrypt_file(data, recipients, **kwargs) data.close() return result def decrypt(self, message, **kwargs): data = _make_binary_stream(message, self.encoding) result = self.decrypt_file(data, **kwargs) data.close() return result def decrypt_file(self, file, always_trust=False, passphrase=None, output=None, extra_args=None): if passphrase and not self.is_valid_passphrase(passphrase): raise ValueError('Invalid passphrase') args = ["--decrypt"] if output: # write the output to a file with the specified name self.set_output_without_confirmation(args, output) if always_trust: # pragma: no cover args.append("--always-trust") if extra_args: args.extend(extra_args) result = self.result_map['crypt'](self) self._handle_io(args, file, result, passphrase, binary=True) logger.debug('decrypt result[:100]: %r', result.data[:100]) return result def get_recipients(self, message, **kwargs): data = _make_binary_stream(message, self.encoding) result = self.get_recipients_file(data, **kwargs) data.close() return result def get_recipients_file(self, file, extra_args=None): args = ['--decrypt', '--list-only', '-v'] if extra_args: args.extend(extra_args) result = self.result_map['crypt'](self) self._handle_io(args, file, result, binary=True) ids = [] for m in PUBLIC_KEY_RE.finditer(result.stderr): ids.append(m.group(1)) return ids def trust_keys(self, fingerprints, trustlevel): levels = Verify.TRUST_LEVELS if trustlevel not in levels: poss = ', '.join(sorted(levels)) raise ValueError('Invalid trust level: "%s" (must be one of %s)' % (trustlevel, poss)) trustlevel = levels[trustlevel] + 2 import tempfile try: fd, fn = tempfile.mkstemp() lines = [] if isinstance(fingerprints, string_types): fingerprints = [fingerprints] for f in fingerprints: lines.append('%s:%s:' % (f, trustlevel)) # The trailing newline is required! s = os.linesep.join(lines) + os.linesep logger.debug('writing ownertrust info: %s', s); os.write(fd, s.encode(self.encoding)) os.close(fd) result = self.result_map['trust'](self) p = self._open_subprocess(['--import-ownertrust', fn]) self._collect_output(p, result, stdin=p.stdin) if p.returncode != 0: raise ValueError('gpg returned an error - return code %d' % p.returncode) finally: os.remove(fn) return result python-gnupg-0.4.8/LICENSE.txt0000664000175000017500000000267414057645134016327 0ustar vinayvinay00000000000000Copyright (c) 2008-2014 by Vinay Sajip. 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. * The name(s) of the copyright holder(s) may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) "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 HOLDER(S) 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. python-gnupg-0.4.8/messages.json0000644000175000017500000004703013646243160017173 0ustar vinayvinay00000000000000{ "0000": "Success", "0001": "General error", "0002": "Unknown packet", "0003": "Unknown version in packet", "0004": "Invalid public key algorithm", "0005": "Invalid digest algorithm", "0006": "Bad public key", "0007": "Bad secret key", "0008": "Bad signature", "0009": "No public key", "000A": "Checksum error", "000B": "Bad passphrase", "000C": "Invalid cipher algorithm", "000D": "Cannot open keyring", "000E": "Invalid packet", "000F": "Invalid armor", "0010": "No user ID", "0011": "No secret key", "0012": "Wrong secret key used", "0013": "Bad session key", "0014": "Unknown compression algorithm", "0015": "Number is not prime", "0016": "Invalid encoding method", "0017": "Invalid encryption scheme", "0018": "Invalid signature scheme", "0019": "Invalid attribute", "001A": "No value", "001B": "Not found", "001C": "Value not found", "001D": "Syntax error", "001E": "Bad MPI value", "001F": "Invalid passphrase", "0020": "Invalid signature class", "0021": "Resources exhausted", "0022": "Invalid keyring", "0023": "Trust DB error", "0024": "Bad certificate", "0025": "Invalid user ID", "0026": "Unexpected error", "0027": "Time conflict", "0028": "Keyserver error", "0029": "Wrong public key algorithm", "002A": "Tribute to D. A.", "002B": "Weak encryption key", "002C": "Invalid key length", "002D": "Invalid argument", "002E": "Syntax error in URI", "002F": "Invalid URI", "0030": "Network error", "0031": "Unknown host", "0032": "Selftest failed", "0033": "Data not encrypted", "0034": "Data not processed", "0035": "Unusable public key", "0036": "Unusable secret key", "0037": "Invalid value", "0038": "Bad certificate chain", "0039": "Missing certificate", "003A": "No data", "003B": "Bug", "003C": "Not supported", "003D": "Invalid operation code", "003E": "Timeout", "003F": "Internal error", "0040": "EOF (gcrypt)", "0041": "Invalid object", "0042": "Provided object is too short", "0043": "Provided object is too large", "0044": "Missing item in object", "0045": "Not implemented", "0046": "Conflicting use", "0047": "Invalid cipher mode", "0048": "Invalid flag", "0049": "Invalid handle", "004A": "Result truncated", "004B": "Incomplete line", "004C": "Invalid response", "004D": "No agent running", "004E": "Agent error", "004F": "Invalid data", "0050": "Unspecific Assuan server fault", "0051": "General Assuan error", "0052": "Invalid session key", "0053": "Invalid S-expression", "0054": "Unsupported algorithm", "0055": "No pinentry", "0056": "pinentry error", "0057": "Bad PIN", "0058": "Invalid name", "0059": "Bad data", "005A": "Invalid parameter", "005B": "Wrong card", "005C": "No dirmngr", "005D": "dirmngr error", "005E": "Certificate revoked", "005F": "No CRL known", "0060": "CRL too old", "0061": "Line too long", "0062": "Not trusted", "0063": "Operation cancelled", "0064": "Bad CA certificate", "0065": "Certificate expired", "0066": "Certificate too young", "0067": "Unsupported certificate", "0068": "Unknown S-expression", "0069": "Unsupported protection", "006A": "Corrupted protection", "006B": "Ambiguous name", "006C": "Card error", "006D": "Card reset required", "006E": "Card removed", "006F": "Invalid card", "0070": "Card not present", "0071": "No PKCS15 application", "0072": "Not confirmed", "0073": "Configuration error", "0074": "No policy match", "0075": "Invalid index", "0076": "Invalid ID", "0077": "No SmartCard daemon", "0078": "SmartCard daemon error", "0079": "Unsupported protocol", "007A": "Bad PIN method", "007B": "Card not initialized", "007C": "Unsupported operation", "007D": "Wrong key usage", "007E": "Nothing found", "007F": "Wrong blob type", "0080": "Missing value", "0081": "Hardware problem", "0082": "PIN blocked", "0083": "Conditions of use not satisfied", "0084": "PINs are not synced", "0085": "Invalid CRL", "0086": "BER error", "0087": "Invalid BER", "0088": "Element not found", "0089": "Identifier not found", "008A": "Invalid tag", "008B": "Invalid length", "008C": "Invalid key info", "008D": "Unexpected tag", "008E": "Not DER encoded", "008F": "No CMS object", "0090": "Invalid CMS object", "0091": "Unknown CMS object", "0092": "Unsupported CMS object", "0093": "Unsupported encoding", "0094": "Unsupported CMS version", "0095": "Unknown algorithm", "0096": "Invalid crypto engine", "0097": "Public key not trusted", "0098": "Decryption failed", "0099": "Key expired", "009A": "Signature expired", "009B": "Encoding problem", "009C": "Invalid state", "009D": "Duplicated value", "009E": "Missing action", "009F": "ASN.1 module not found", "00A0": "Invalid OID string", "00A1": "Invalid time", "00A2": "Invalid CRL object", "00A3": "Unsupported CRL version", "00A4": "Invalid certificate object", "00A5": "Unknown name", "00A6": "A locale function failed", "00A7": "Not locked", "00A8": "Protocol violation", "00A9": "Invalid MAC", "00AA": "Invalid request", "00AB": "Unknown extension", "00AC": "Unknown critical extension", "00AD": "Locked", "00AE": "Unknown option", "00AF": "Unknown command", "00B0": "Not operational", "00B1": "No passphrase given", "00B2": "No PIN given", "00B3": "Not enabled", "00B4": "No crypto engine", "00B5": "Missing key", "00B6": "Too many objects", "00B7": "Limit reached", "00B8": "Not initialized", "00B9": "Missing issuer certificate", "00BA": "No keyserver available", "00BB": "Invalid elliptic curve", "00BC": "Unknown elliptic curve", "00BD": "Duplicated key", "00BE": "Ambiguous result", "00BF": "No crypto context", "00C0": "Wrong crypto context", "00C1": "Bad crypto context", "00C2": "Conflict in the crypto context", "00C3": "Broken public key", "00C4": "Broken secret key", "00C5": "Invalid MAC algorithm", "00C6": "Operation fully cancelled", "00C7": "Operation not yet finished", "00C8": "Buffer too short", "00C9": "Invalid length specifier in S-expression", "00CA": "String too long in S-expression", "00CB": "Unmatched parentheses in S-expression", "00CC": "S-expression not canonical", "00CD": "Bad character in S-expression", "00CE": "Bad quotation in S-expression", "00CF": "Zero prefix in S-expression", "00D0": "Nested display hints in S-expression", "00D1": "Unmatched display hints", "00D2": "Unexpected reserved punctuation in S-expression", "00D3": "Bad hexadecimal character in S-expression", "00D4": "Odd hexadecimal numbers in S-expression", "00D5": "Bad octal character in S-expression", "00D9": "All subkeys are expired or revoked", "00DA": "Database is corrupted", "00DB": "Server indicated a failure", "00DC": "No name", "00DD": "No key", "00DE": "Legacy key", "00DF": "Request too short", "00E0": "Request too long", "00E1": "Object is in termination state", "00E2": "No certificate chain", "00E3": "Certificate is too large", "00E4": "Invalid record", "00E5": "The MAC does not verify", "00E6": "Unexpected message", "00E7": "Compression or decompression failed", "00E8": "A counter would wrap", "00E9": "Fatal alert message received", "00EA": "No cipher algorithm", "00EB": "Missing client certificate", "00EC": "Close notification received", "00ED": "Ticket expired", "00EE": "Bad ticket", "00EF": "Unknown identity", "00F0": "Bad certificate message in handshake", "00F1": "Bad certificate request message in handshake", "00F2": "Bad certificate verify message in handshake", "00F3": "Bad change cipher message in handshake", "00F4": "Bad client hello message in handshake", "00F5": "Bad server hello message in handshake", "00F6": "Bad server hello done message in handshake", "00F7": "Bad finished message in handshake", "00F8": "Bad server key exchange message in handshake", "00F9": "Bad client key exchange message in handshake", "00FA": "Bogus string", "00FB": "Forbidden", "00FC": "Key disabled", "00FD": "Not possible with a card based key", "00FE": "Invalid lock object", "00FF": "True", "0100": "False", "0101": "General IPC error", "0102": "IPC accept call failed", "0103": "IPC connect call failed", "0104": "Invalid IPC response", "0105": "Invalid value passed to IPC", "0106": "Incomplete line passed to IPC", "0107": "Line passed to IPC too long", "0108": "Nested IPC commands", "0109": "No data callback in IPC", "010A": "No inquire callback in IPC", "010B": "Not an IPC server", "010C": "Not an IPC client", "010D": "Problem starting IPC server", "010E": "IPC read error", "010F": "IPC write error", "0111": "Too much data for IPC layer", "0112": "Unexpected IPC command", "0113": "Unknown IPC command", "0114": "IPC syntax error", "0115": "IPC call has been cancelled", "0116": "No input source for IPC", "0117": "No output source for IPC", "0118": "IPC parameter error", "0119": "Unknown IPC inquire", "012C": "Crypto engine too old", "012D": "Screen or window too small", "012E": "Screen or window too large", "012F": "Required environment variable not set", "0130": "User ID already exists", "0131": "Name already exists", "0132": "Duplicated name", "0133": "Object is too young", "0134": "Object is too old", "0135": "Unknown flag", "0136": "Invalid execution order", "0137": "Already fetched", "0138": "Try again later", "0139": "Wrong name", "013A": "Not authenticated", "013B": "Bad authentication", "013C": "No Keybox daemon running", "013D": "Keybox daemon error", "013E": "Service is not running", "013F": "Service error", "029A": "System bug detected", "02C7": "Unknown DNS error", "02C8": "Invalid DNS section", "02C9": "Invalid textual address form", "02CA": "Missing DNS query packet", "02CB": "Missing DNS answer packet", "02CC": "Connection closed in DNS", "02CD": "Verification failed in DNS", "02CE": "DNS Timeout", "02D1": "General LDAP error", "02D2": "General LDAP attribute error", "02D3": "General LDAP name error", "02D4": "General LDAP security error", "02D5": "General LDAP service error", "02D6": "General LDAP update error", "02D7": "Experimental LDAP error code", "02D8": "Private LDAP error code", "02D9": "Other general LDAP error", "02EE": "LDAP connecting failed (X)", "02EF": "LDAP referral limit exceeded", "02F0": "LDAP client loop", "02F2": "No LDAP results returned", "02F3": "LDAP control not found", "02F4": "Not supported by LDAP", "02F5": "LDAP connect error", "02F6": "Out of memory in LDAP", "02F7": "Bad parameter to an LDAP routine", "02F8": "User cancelled LDAP operation", "02F9": "Bad LDAP search filter", "02FA": "Unknown LDAP authentication method", "02FB": "Timeout in LDAP", "02FC": "LDAP decoding error", "02FD": "LDAP encoding error", "02FE": "LDAP local error", "02FF": "Cannot contact LDAP server", "0300": "LDAP success", "0301": "LDAP operations error", "0302": "LDAP protocol error", "0303": "Time limit exceeded in LDAP", "0304": "Size limit exceeded in LDAP", "0305": "LDAP compare false", "0306": "LDAP compare true", "0307": "LDAP authentication method not supported", "0308": "Strong(er) LDAP authentication required", "0309": "Partial LDAP results+referral received", "030A": "LDAP referral", "030B": "Administrative LDAP limit exceeded", "030C": "Critical LDAP extension is unavailable", "030D": "Confidentiality required by LDAP", "030E": "LDAP SASL bind in progress", "0310": "No such LDAP attribute", "0311": "Undefined LDAP attribute type", "0312": "Inappropriate matching in LDAP", "0313": "Constraint violation in LDAP", "0314": "LDAP type or value exists", "0315": "Invalid syntax in LDAP", "0320": "No such LDAP object", "0321": "LDAP alias problem", "0322": "Invalid DN syntax in LDAP", "0323": "LDAP entry is a leaf", "0324": "LDAP alias dereferencing problem", "032F": "LDAP proxy authorization failure (X)", "0330": "Inappropriate LDAP authentication", "0331": "Invalid LDAP credentials", "0332": "Insufficient access for LDAP", "0333": "LDAP server is busy", "0334": "LDAP server is unavailable", "0335": "LDAP server is unwilling to perform", "0336": "Loop detected by LDAP", "0340": "LDAP naming violation", "0341": "LDAP object class violation", "0342": "LDAP operation not allowed on non-leaf", "0343": "LDAP operation not allowed on RDN", "0344": "Already exists (LDAP)", "0345": "Cannot modify LDAP object class", "0346": "LDAP results too large", "0347": "LDAP operation affects multiple DSAs", "034C": "Virtual LDAP list view error", "0350": "Other LDAP error", "0371": "Resources exhausted in LCUP", "0372": "Security violation in LCUP", "0373": "Invalid data in LCUP", "0374": "Unsupported scheme in LCUP", "0375": "Reload required in LCUP", "0376": "LDAP cancelled", "0377": "No LDAP operation to cancel", "0378": "Too late to cancel LDAP", "0379": "Cannot cancel LDAP", "037A": "LDAP assertion failed", "037B": "Proxied authorization denied by LDAP", "0400": "User defined error code 1", "0401": "User defined error code 2", "0402": "User defined error code 3", "0403": "User defined error code 4", "0404": "User defined error code 5", "0405": "User defined error code 6", "0406": "User defined error code 7", "0407": "User defined error code 8", "0408": "User defined error code 9", "0409": "User defined error code 10", "040A": "User defined error code 11", "040B": "User defined error code 12", "040C": "User defined error code 13", "040D": "User defined error code 14", "040E": "User defined error code 15", "040F": "User defined error code 16", "05DC": "SQL success", "05DD": "SQL error", "05DE": "Internal logic error in SQL library", "05DF": "Access permission denied (SQL)", "05E0": "SQL abort was requested", "05E1": "SQL database file is locked", "05E2": "An SQL table in the database is locked", "05E3": "SQL library ran out of core", "05E4": "Attempt to write a readonly SQL database", "05E5": "SQL operation terminated by interrupt", "05E6": "I/O error during SQL operation", "05E7": "SQL database disk image is malformed", "05E8": "Unknown opcode in SQL file control", "05E9": "Insertion failed because SQL database is full", "05EA": "Unable to open the SQL database file", "05EB": "SQL database lock protocol error", "05EC": "(internal SQL code: empty)", "05ED": "SQL database schema changed", "05EE": "String or blob exceeds size limit (SQL)", "05EF": "SQL abort due to constraint violation", "05F0": "Data type mismatch (SQL)", "05F1": "SQL library used incorrectly", "05F2": "SQL library uses unsupported OS features", "05F3": "Authorization denied (SQL)", "05F4": "(unused SQL code: format)", "05F5": "SQL bind parameter out of range", "05F6": "File opened that is not an SQL database file", "05F7": "Notifications from SQL logger", "05F8": "Warnings from SQL logger", "0640": "SQL has another row ready", "0641": "SQL has finished executing", "3FFD": "System error w/o errno", "3FFF": "End of file", "8000": "Argument list too long", "8001": "Permission denied", "8002": "Address already in use", "8003": "Cannot assign requested address", "8004": "Advertise error", "8005": "Address family not supported by protocol", "8006": "Resource temporarily unavailable", "8007": "Operation already in progress", "800A": "Invalid exchange", "800B": "Bad file descriptor", "800C": "File descriptor in bad state", "800D": "Bad message", "800E": "Invalid request descriptor", "8010": "Invalid request code", "8011": "Invalid slot", "8012": "Bad font file format", "8013": "Device or resource busy", "8014": "Operation canceled", "8015": "No child processes", "8016": "Channel number out of range", "8017": "Communication error on send", "8018": "Software caused connection abort", "8019": "Connection refused", "801A": "Connection reset by peer", "801C": "Resource deadlock avoided", "801D": "Resource deadlock avoided", "801E": "Destination address required", "8020": "Numerical argument out of domain", "8021": "RFS specific error", "8022": "Disk quota exceeded", "8023": "File exists", "8024": "Bad address", "8025": "File too large", "8029": "Host is down", "802A": "No route to host", "802B": "Identifier removed", "802D": "Invalid or incomplete multibyte or wide character", "802E": "Operation now in progress", "802F": "Interrupted system call", "8030": "Invalid argument", "8031": "Input/output error", "8032": "Transport endpoint is already connected", "8033": "Is a directory", "8034": "Is a named type file", "8035": "Level 2 halted", "8036": "Level 2 not synchronized", "8037": "Level 3 halted", "8038": "Level 3 reset", "8039": "Can not access a needed shared library", "803A": "Accessing a corrupted shared library", "803B": "Cannot exec a shared library directly", "803C": "Attempting to link in too many shared libraries", "803D": ".lib section in a.out corrupted", "803E": "Link number out of range", "803F": "Too many levels of symbolic links", "8040": "Wrong medium type", "8041": "Too many open files", "8042": "Too many links", "8043": "Message too long", "8044": "Multihop attempted", "8045": "File name too long", "8046": "No XENIX semaphores available", "8048": "Network is down", "8049": "Network dropped connection on reset", "804A": "Network is unreachable", "804B": "Too many open files in system", "804C": "No anode", "804D": "No buffer space available", "804E": "No CSI structure available", "804F": "No data available", "8050": "No such device", "8051": "No such file or directory", "8052": "Exec format error", "8053": "No locks available", "8054": "Link has been severed", "8055": "No medium found", "8056": "Cannot allocate memory", "8057": "No message of desired type", "8058": "Machine is not on the network", "8059": "Package not installed", "805A": "Protocol not available", "805B": "No space left on device", "805C": "Out of streams resources", "805D": "Device not a stream", "805E": "Function not implemented", "805F": "Block device required", "8060": "Transport endpoint is not connected", "8061": "Not a directory", "8062": "Directory not empty", "8063": "Not a XENIX named type file", "8064": "Socket operation on non-socket", "8065": "Operation not supported", "8066": "Inappropriate ioctl for device", "8067": "Name not unique on network", "8068": "No such device or address", "8069": "Operation not supported", "806A": "Value too large for defined data type", "806B": "Operation not permitted", "806C": "Protocol family not supported", "806D": "Broken pipe", "8072": "Protocol error", "8073": "Protocol not supported", "8074": "Protocol wrong type for socket", "8075": "Numerical result out of range", "8076": "Remote address changed", "8077": "Object is remote", "8078": "Remote I/O error", "8079": "Interrupted system call should be restarted", "807A": "Read-only file system", "807C": "Cannot send after transport endpoint shutdown", "807D": "Socket type not supported", "807E": "Illegal seek", "807F": "No such process", "8080": "Srmount error", "8081": "Stale file handle", "8082": "Streams pipe error", "8083": "Timer expired", "8084": "Connection timed out", "8085": "Too many references: cannot splice", "8086": "Text file busy", "8087": "Structure needs cleaning", "8088": "Protocol driver not attached", "8089": "Too many users", "808A": "Resource temporarily unavailable", "808B": "Invalid cross-device link", "808C": "Exchange full" } python-gnupg-0.4.8/setup.py0000664000175000017500000000363313777412010016203 0ustar vinayvinay00000000000000from setuptools import setup from gnupg import __version__ as version setup(name = "python-gnupg", description="A wrapper for the Gnu Privacy Guard (GPG or GnuPG)", long_description = """This module allows easy access to GnuPG's key \ management, encryption and signature functionality from Python programs. \ It is intended for use with Python 2.4 or greater. Releases are normally signed using a GnuPG key with the user id \ vinay_sajip@yahoo.co.uk and the following fingerprint: CA74 9061 914E AC13 8E66 EADB 9147 B477 339A 9B86 As PyPI no longer shows signatures, you should be able to download release archives \ and signatures from https://bitbucket.org/vinay.sajip/python-gnupg/downloads/ The archives should be the same as those uploaded to PyPI. """, license="""Copyright (C) 2008-2021 by Vinay Sajip. All Rights Reserved. See LICENSE.txt for license.""", version=version, author="Vinay Sajip", author_email="vinay_sajip@yahoo.co.uk", maintainer="Vinay Sajip", maintainer_email="vinay_sajip@yahoo.co.uk", url="https://docs.red-dove.com/python-gnupg/", py_modules=["gnupg"], platforms="No particular restrictions", download_url="https://pypi.io/packages/source/p/python-gnupg/python-gnupg-%s.tar.gz" % version, classifiers=[ 'Development Status :: 5 - Production/Stable', "Intended Audience :: Developers", 'License :: OSI Approved :: BSD License', "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Operating System :: OS Independent", "Topic :: Software Development :: Libraries :: Python Modules" ] ) python-gnupg-0.4.8/PKG-INFO0000664000175000017500000000346214147404120015561 0ustar vinayvinay00000000000000Metadata-Version: 1.2 Name: python-gnupg Version: 0.4.8 Summary: A wrapper for the Gnu Privacy Guard (GPG or GnuPG) Home-page: https://docs.red-dove.com/python-gnupg/ Author: Vinay Sajip Author-email: vinay_sajip@yahoo.co.uk Maintainer: Vinay Sajip Maintainer-email: vinay_sajip@yahoo.co.uk License: Copyright (C) 2008-2021 by Vinay Sajip. All Rights Reserved. See LICENSE.txt for license. Download-URL: https://pypi.io/packages/source/p/python-gnupg/python-gnupg-0.4.8.tar.gz Description: This module allows easy access to GnuPG's key management, encryption and signature functionality from Python programs. It is intended for use with Python 2.4 or greater. Releases are normally signed using a GnuPG key with the user id vinay_sajip@yahoo.co.uk and the following fingerprint: CA74 9061 914E AC13 8E66 EADB 9147 B477 339A 9B86 As PyPI no longer shows signatures, you should be able to download release archives and signatures from https://bitbucket.org/vinay.sajip/python-gnupg/downloads/ The archives should be the same as those uploaded to PyPI. Platform: No particular restrictions Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: BSD License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 2.7 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: Operating System :: OS Independent Classifier: Topic :: Software Development :: Libraries :: Python Modules python-gnupg-0.4.8/MANIFEST.in0000644000175000017500000000015313646250642016225 0ustar vinayvinay00000000000000include LICENSE.txt include README.rst include test_gnupg.py include messages.json include test_*ring.gpg python-gnupg-0.4.8/test_pubring.gpg0000644000175000017500000001045713464745246017712 0ustar vinayvinay00000000000000 S=3vDd4OKbm8x>>MP`p [%"Rh뼿gf%7$ӟ1`гvy3/qӆw[.X1Lׁ ԶGr'(sS*ޜ>qM)%.^3}9r1ىxKk2P(vS\}Au@ۂ4=yRtpk;Wem75Ys e*&bBʱ)c1Andrew Able (A test user) 8"S/   ЮLw?av=dmEK9S QdlO]g8WJPNA,cnm6>TI\ w7|@^^#o0طs;Юx}.җ>$4P[cdbSr\Cܻ=A2yL,\/UA1{TQ2l?r?ev[ fWVE5=Ά51 ?lON:zx|qbtV S=|,Րa'~I|-^/ZP,|NEP-י1U r^wkH rU}b4 H*2kCt!>YŠ|O+Rj env#G\טws;: '/+пJ/B9)}"Zd.M#k׶Mik;RykGYjazJ57ֆ>.咱2T1~7%汘QUrC i]PvױB J _$Pd.!Em,W׀rD^fGum}>5wFvbA spˮBX%S#Uّ: &$%3?챒̙ $ Jլ=Dg#^ Go9ڶW#Kc)CRmy/~_3gv` J S ЮLw-E?ǧR_ B'מ%ua؄~mo3JG_R}ikj2Kb#Z{ԅ^XrvBU)t4:dj6?%ߣ[yK*2w*03B&ڒl α(uQWXC4F̸t0ꈢz-3RP!O2Bu :cA nA!phˠOzxSyХb޹ a֡ ^۱J]ǟH {<+P:ZvMy S!);TϫcpsV tyGޤsA͔Jrn]ˏ<՟m>7 >^qd9cO'{'q?aZ ^O΂S)N찀8"S/   )gOԸh$AIvc45\ =`mLp;[A Bho3+[/g^ < 0澶d1:Zd1B"hh!ݮ'1"\]. j 2i:>$i5G':8hX%{J׃xc5SrGҜkcUԲL)Nx NRZenD|ȼdm{*u 9Һ&ZJE  Sw%P_}i @#Lxh,[Y^Tu<]uލX8T}6,W% ߚ}ia6W?Ҙ.<~1 yj;V9%vt[W-:Q^@ -$z JM=hy {(ȚŚb6󠈵% k=]yɭ2Ѭɖt}2@~ɨGS+㒄?!ɖ }WPLsǙ%+7&w!oj3mjî븸>ʚ+q{Y c[A4Kz|^|mD8e?P>/G::>"YV=^M#C8̰c} S )gOԸ 2ĝ3X1^?FāE"cLWMG4U؛x0MC_4F\"͛XaέTD֨n ںڕCz7 Μ C)!+{mڷitu7u@䝒jӑ15rߟU$6“qV>TH@PG2aѠ6sAY#u[g o\pAh<~gF@%an.ܞ;W̟]&X`@xy9 ^ SJ6:ר5Et_hGJP3w ũUJg(T9#fDg(i9%uWT[yLI8܍xaf!՟P,)͛pZE[P_ HiE.ΓpZz}Nz?GH'. 'fyn fPtXs8"S/   sƷ؋Qa"7׌:a`-;.ݛ6K|G{W  IG*:~/jɩAߏIna__P^ OJ4]- 螨[~J6yRag'nj ,Ur["bH"W.Z"+qFi{a?y$*2vG2G v L̪Ȯ)N8 fSXRBDH.6ۓIb6 SgH7

4nca+YS]&rd'U zT\@;uxꎐB?YG/IH2uB"Bhʨu]$HOd?mc6Z?jąt֋ lIyLd&Vz}@/E bPQyM=.Ѿ9Ĩު3ry[dCLF A`Ȕ;7;Vsy S sƷ؋QPZMvEfFi(Lg͋: F8aa:8/ux]Nu O[Tw\D8? -(vBH"r6okgt=ƼGܼHvܢ_=+0*,zI瓗xt)RLv3Nq J䤊6aBIW(?f%_Paڥx/f>{.j]/=8v.k72Z2#4⅀python-gnupg-0.4.8/README.rst0000644000175000017500000004145714147400717016167 0ustar vinayvinay00000000000000.. image:: https://travis-ci.org/vsajip/python-gnupg.svg :target: https://travis-ci.org/vsajip/python-gnupg .. image:: https://coveralls.io/repos/vsajip/python-gnupg/badge.svg :target: https://coveralls.io/github/vsajip/python-gnupg What is it? =========== The GNU Privacy Guard (gpg, or gpg.exe on Windows) is a command-line program which provides support for programmatic access via spawning a separate process to run it and then communicating with that process from your program. This project, ``python-gnupg``, implements a Python library which takes care of the internal details and allows its users to generate and manage keys, encrypt and decrypt data, and sign and verify messages. Installation ============ Installing from PyPI -------------------- You can install this package from the Python Package Index (pyPI) by running:: pip install python-gnupg .. important:: There is at least one fork of this project, which was apparently created because an earlier version of this software used the ``subprocess`` module with ``shell=True``, making it vulnerable to shell injection. **This is no longer the case**. Forks may not be drop-in compatible with this software, so take care to use the correct version, as indicated in the ``pip install`` command above. Installing from a source distribution archive --------------------------------------------- To install this package from a source distribution archive, do the following: 1. Extract all the files in the distribution archive to some directory on your system. 2. In that directory, run ``python setup.py install``. 3. Optionally, run ``python test_gnupg.py`` to ensure that the package is working as expected. Credits ======= * The developers of the GNU Privacy Guard. * The original version of this module was developed by Andrew Kuchling. * It was improved by Richard Jones. * It was further improved by Steve Traugott. The present incarnation, based on the earlier versions, uses the ``subprocess`` module and so works on Windows as well as Unix/Linux platforms. It's not, however, 100% backwards-compatible with earlier incarnations. Change log ========== .. note:: GCnn refers to an issue nn on Google Code. 0.4.9 (future) -------------- Released: Not yet. 0.4.8 ----- Released: 2021-11-24 * Fixed #147: Return gpg's return code in all result instances. * Fixed #152: Add check for invalid file objects. * Fixed #157: Provide more useful status message when a secret key is absent. * Fixed #158: Added a get_recipients() API to find the recipients of an encrypted message without decrypting it. 0.4.7 ----- Released: 2021-03-11 * Fixed #129, #141: Added support for no passphrase during key generation. * Fixed #143: Improved permission-denied test. Thanks to Elliot Cameron for the patch. * Fixed #144: Updated logging to only show partial results. * Fixed #146: Allowed a passphrase to be passed to import_keys(). Thanks to Chris de Graaf for the patch. 0.4.6 ----- Released: 2020-04-17 * Fixed #122: Updated documentation about gnupghome needing to be an existing directory. * Fixed #123: Handled error conditions from gpg when calling trust_keys(). * Fixed #124: Avoided an exception being raised when ImportResult.summary() was called after a failed recv_keys(). * Fixed #128: Added ECC support by changing key generation parameters. (The Key-Length value isn't added if a curve is specified.) * Fixed #130: Provided a mechanism to provide more complete error messages. Support for Python versions 3.5 and under is discontinued, except for Python 2.7. 0.4.5 ----- Released: 2019-08-12 * Fixed #107: Improved documentation. * Fixed #112: Raised a ValueError if a gnupghome is specified which is not an existing directory. * Fixed #113: Corrected stale link in the documentation. * Fixed #116: Updated documentation to clarify when spurious key-expired/ signature-expired messages might be seen. * Fixed #119: Added --yes to avoid pinentry when deleting secret keys with GnuPG >= 2.1. * A warning is logged if gpg returns a non-zero return code. * Added ``extra_args`` to ``import_keys``. * Added support for CI using AppVeyor. 0.4.4 ----- Released: 2019-01-24 * Fixed #108: Changed how any return value from the ``on_data`` callable is processed. In earlier versions, the return value was ignored. In this version, if the return value is ``False``, the data received from ``gpg`` is not buffered. Otherwise (if the value is ``None`` or ``True``, for example), the data is buffered as normal. This functionality can be used to do your own buffering, or to prevent buffering altogether. The ``on_data`` callable is also called once with an empty byte-string to signal the end of data from ``gpg``. * Fixed #97: Added an additional attribute ``check_fingerprint_collisions`` to ``GPG`` instances, which defaults to ``False``. It seems that ``gpg`` is happy to have duplicate keys and fingerprints in a keyring, so we can't be too strict. A user can set this attribute of an instance to ``True`` to trigger a check for collisions. * Fixed #111: With GnuPG 2.2.7 or later, provide the fingerprint of a signing key for a failed signature verification, if available. * Fixed #21: For verification where multiple signatures are involved, a mapping of signature_ids to fingerprint, keyid, username, creation date, creation timestamp and expiry timestamp is provided. * Added a check to disallow certain control characters ('\r', '\n', NUL) in passphrases. 0.4.3 ----- Released: 2018-06-13 * Added --no-verbose to the gpg command line, in case verbose is specified in gpg.conf - we don't need verbose output. 0.4.2 ----- Released: 2018-03-28 * Fixed #81: Subkey information is now collected and returned in a ``subkey_info`` dictionary keyed by the subkey's ID. * Fixed #84: GPG2 version is now correctly detected on OS X. * Fixed #94: Added ``expect_passphrase`` password for use on GnuPG >= 2.1 when passing passphrase to ``gpg`` via pinentry. * Fixed #95: Provided a ``trust_keys`` method to allow setting the trust level for keys. Thanks to William Foster for a suggested implementation. * Made the exception message when the gpg executable is not found contain the path of the executable that was tried. Thanks to Kostis Anagnostopoulos for the suggestion. * Fixed #100: Made the error message less categorical in the case of a failure with an unspecified reason, adding some information from gpg error codes when available. 0.4.1 ----- Released: 2017-07-06 * Updated message handling logic to no longer raise exceptions when a message isn't recognised. Thanks to Daniel Kahn Gillmor for the patch. * Always use always use ``--fixed-list-mode``, ``--batch`` and ``--with-colons``. Thanks to Daniel Kahn Gillmor for the patch. * Improved ``scan_keys()`` handling on GnuPG >= 2.1. Thanks to Daniel Kahn Gillmor for the patch. * Improved test behaviour with GnuPG >= 2.1. Failures when deleting test directory trees are now ignored. Thanks to Daniel Kahn Gillmor for the patch. * Added ``close_file`` keyword argument to verify_file to allow the file closing to be made optional. Current behaviour is maintained - ``close_file=False`` can be passed to skip closing the file being verified. * Added the ``extra_args`` keyword parameter to allow custom arguments to be passed to the ``gpg`` executable. * Instances of the ``GPG`` class now have an additional ``on_data`` attribute, which defaults to ``None``. It can be set to a callable which will be called with a single argument - a binary chunk of data received from the ``gpg`` executable. The callable can do whatever it likes with the chunks passed to it - e.g. write them to a separate stream. The callable should not raise any exceptions (unless it wants the current operation to fail). 0.4.0 ----- Released: 2017-01-29 * Added support for ``KEY_CONSIDERED`` in more places - encryption / decryption, signing, key generation and key import. * Partial fix for #32 (GPG 2.1 compatibility). Unfortunately, better support cannot be provided at this point, unless there are certain changes (relating to pinentry popups) in how GPG 2.1 works. * Fixed #60: An IndexError was being thrown by ``scan_keys()``. * Ensured that utf-8 encoding is used when the ``--with-column`` mode is used. Thanks to Yann Leboulanger for the patch. * ``list_keys()`` now uses ``--fixed-list-mode``. Thanks to Werner Koch for the pointer. 0.3.9 ----- Released: 2016-09-10 * Fixed #38: You can now request information about signatures against keys. Thanks to SunDwarf for the suggestion and patch, which was used as a basis for this change. * Fixed #49: When exporting keys, no attempt is made to decode the output when armor=False is specified. * Fixed #53: A ``FAILURE`` message caused by passing an incorrect passphrase is handled. * Handled ``EXPORTED`` and ``EXPORT_RES`` messages while exporting keys. Thanks to Marcel Pörner for the patch. * Fixed #54: Improved error message shown when gpg is not available. * Fixed #55: Added support for ``KEY_CONSIDERED`` while verifying. * Avoided encoding problems with filenames under Windows. Thanks to Kévin Bernard-Allies for the patch. * Fixed #57: Used a better mechanism for comparing keys. 0.3.8 ----- Released: 2015-09-24 * Fixed #22: handled ``PROGRESS`` messages during verification and signing. * Fixed #26: handled ``PINENTRY_LAUNCHED`` messages during verification, decryption and key generation. * Fixed #28: Allowed a default Name-Email to be computed even when neither of ``LOGNAME`` and ``USERNAME`` are in the environment. * Fixed #29: Included test files missing from the tarball in previous versions. * Fixed #39: On Python 3.x, passing a text instead of a binary stream caused file decryption to hang due to a ``UnicodeDecodeError``. This has now been correctly handled: The decryption fails with a "no data" status. * Fixed #41: Handled Unicode filenames correctly by encoding them on 2.x using the file system encoding. * Fixed #43: handled ``PINENTRY_LAUNCHED`` messages during key export. Thanks to Ian Denhardt for looking into this. * Hide the console window which appears on Windows when gpg is spawned. Thanks to Kévin Bernard-Allies for the patch. * Subkey fingerprints are now captured. * The returned value from the ``list_keys`` method now has a new attribute, ``key_map``, which is a dictionary mapping key and subkey fingerprints to the corresponding key's dictionary. With this change, you don't need to iterate over the (potentially large) returned list to search for a key with a given fingerprint - the ``key_map`` dict will take you straight to the key info, whether the fingerprint you have is for a key or a subkey. Thanks to Nick Daly for the initial suggestion. 0.3.7 ----- Released: 2014-12-07 Signed with PGP key: Vinay Sajip (CODE SIGNING KEY) Key Fingerprint : CA74 9061 914E AC13 8E66 EADB 9147 B477 339A 9B86 * Added an ``output`` keyword parameter to the ``sign`` and ``sign_file`` methods, to allow writing the signature to a file. Thanks to Jannis Leidel for the patch. * Allowed specifying ``True`` for the ``sign`` keyword parameter, which allows use of the default key for signing and avoids having to specify a key id when it's desired to use the default. Thanks to Fabian Beutel for the patch. * Used a uniform approach with subprocess on Windows and POSIX: shell=True is not used on either. * When signing/verifying, the status is updated to reflect any expired or revoked keys or signatures. * Handled 'NOTATION_NAME' and 'NOTATION_DATA' during verification. * Fixed #1, #16, #18, #20: Quoting approach changed, since now shell=False. * Fixed #14: Handled 'NEED_PASSPHRASE_PIN' message. * Fixed #8: Added a scan_keys method to allow scanning of keys without the need to import into a keyring. Thanks to Venzen Khaosan for the suggestion. * Fixed #5: Added '0x' prefix when searching for keys. Thanks to Aaron Toponce for the report. * Fixed #4: Handled 'PROGRESS' message during encryption. Thanks to Daniel Mills for the report. * Fixed #3: Changed default encoding to Latin-1. * Fixed #2: Raised ValueError if no recipients were specified for an asymmetric encryption request. * Handled 'UNEXPECTED' message during verification. Thanks to David Andersen for the patch. * Replaced old range(len(X)) idiom with enumerate(). * Refactored ``ListKeys`` / ``SearchKeys`` classes to maximise use of common functions. * Fixed GC94: Added ``export-minimal`` and ``armor`` options when exporting keys. This addition was inadvertently left out of 0.3.6. 0.3.6 ----- Released: 2014-02-05 * Fixed GC82: Enabled fast random tests on gpg as well as gpg2. * Fixed GC85: Avoided deleting temporary file to preserve its permissions. * Fixed GC87: Avoided writing passphrase to log. * Fixed GC95: Added ``verify_data()`` method to allow verification of signatures in memory. * Fixed GC96: Regularised end-of-line characters. * Fixed GC98: Rectified problems with earlier fix for shell injection. 0.3.5 ----- Released: 2013-08-30 * Added improved shell quoting to guard against shell injection. * Fixed GC76: Added ``search_keys()`` and ``send_keys()`` methods. * Fixed GC77: Allowed specifying a symmetric cipher algorithm. * Fixed GC78: Fell back to utf-8 encoding when no other could be determined. * Fixed GC79: Default key length is now 2048 bits. * Fixed GC80: Removed the Name-Comment default in key generation. 0.3.4 ----- Released: 2013-06-05 * Fixed GC65: Fixed encoding exception when getting version. * Fixed GC66: Now accepts sets and frozensets where appropriate. * Fixed GC67: Hash algorithm now captured in sign result. * Fixed GC68: Added support for ``--secret-keyring``. * Fixed GC70: Added support for multiple keyrings. 0.3.3 ----- Released: 2013-03-11 * Fixed GC57: Handled control characters in ``list_keys()``. * Fixed GC61: Enabled fast random for testing. * Fixed GC62: Handled ``KEYEXPIRED`` status. * Fixed GC63: Handled ``NO_SGNR`` status. 0.3.2 ----- Released: 2013-01-17 * Fixed GC56: Disallowed blank values in key generation. * Fixed GC57: Handled colons and other characters in ``list_keys()``. * Fixed GC59/GC60: Handled ``INV_SGNR`` status during verification and removed calls requiring interactive password input from doctests. 0.3.1 ----- Released: 2012-09-01 * Fixed GC45: Allowed additional arguments to gpg executable. * Fixed GC50: Used latin-1 encoding in tests when it's known to be required. * Fixed GC51: Test now returns non-zero exit status on test failure. * Fixed GC53: Now handles ``INV_SGNR`` and ``KEY_NOT_CREATED`` statuses. * Fixed GC55: Verification and decryption now return trust level of signer in integer and text form. 0.3.0 ----- Released: 2012-05-12 * Fixed GC49: Reinstated Yann Leboulanger's change to support subkeys (accidentally left out in 0.2.7). 0.2.9 ----- Released: 2012-03-29 * Fixed GC36: Now handles ``CARDCTRL`` and ``POLICY_URL`` messages. * Fixed GC40: Now handles ``DECRYPTION_INFO``, ``DECRYPTION_FAILED`` and ``DECRYPTION_OKAY`` messages. * The ``random_binary_data file`` is no longer shipped, but constructed by the test suite if needed. 0.2.8 ----- Released: 2011-09-02 * Fixed GC29: Now handles ``IMPORT_RES`` while verifying. * Fixed GC30: Fixed an encoding problem. * Fixed GC33: Quoted arguments for added safety. 0.2.7 ----- Released: 2011-04-10 * Fixed GC24: License is clarified as BSD. * Fixed GC25: Incorporated Daniel Folkinshteyn's changes. * Fixed GC26: Incorporated Yann Leboulanger's subkey change. * Fixed GC27: Incorporated hysterix's support for symmetric encryption. * Did some internal cleanups of Unicode handling. 0.2.6 ----- Released: 2011-01-25 * Fixed GC14: Should be able to accept passphrases from GPG-Agent. * Fixed GC19: Should be able to create a detached signature. * Fixed GC21/GC23: Better handling of less common responses from GPG. 0.2.5 ----- Released: 2010-10-13 * Fixed GC11/GC16: Detached signatures can now be created. * Fixed GC3: Detached signatures can be verified. * Fixed GC12: Better support for RSA and IDEA. * Fixed GC15/GC17: Better support for non-ASCII input. 0.2.4 ----- Released: 2010-03-01 * Fixed GC9: Now allows encryption without armor and the ability to encrypt and decrypt directly to/from files. 0.2.3 ----- Released: 2010-01-07 * Fixed GC7: Made sending data to process threaded and added a test case. With a test data file used by the test case, the archive size has gone up to 5MB (the size of the test file). 0.2.2 ----- Released: 2009-10-06 * Fixed GC5/GC6: Added ``--batch`` when specifying ``--passphrase-fd`` and changed the name of the distribution file to add the ``python-`` prefix. 0.2.1 ----- Released: 2009-08-07 * Fixed GC2: Added ``handle_status()`` method to the ``ListKeys`` class. 0.2.0 ----- Released: 2009-07-16 * Various changes made to support Python 3.0. 0.1.0 ----- Released: 2009-07-04 * Initial release.